Skip to content

Latest commit

 

History

History
57 lines (43 loc) · 1.9 KB

fest_promote.md

File metadata and controls

57 lines (43 loc) · 1.9 KB

fest promote

Promote a festival to the next lifecycle status

Synopsis

Promote moves a festival through the lifecycle: planning → ready → active → completed.

On completion, fest creates festival-replay.gif and embeds it in FESTIVAL_OVERVIEW.md before auto-committing. Replay failures are reported without undoing completion; retry with fest gif --embed inside the festival.

Each transition validates readiness: planning → ready: Festival goal must be defined ready → active: Festival is ready to begin execution active → completed: All tasks must be completed

By default, promotes the festival you are currently inside. From elsewhere in a camp, pass a festival name or run promote interactively to pick one:

  fest promote my-feature       Promote a festival by name (tab completion)
  fest promote                  Pick a festival from a fuzzy picker (in a terminal)

Use --dungeon to send a festival directly to a dungeon status:

  fest promote --dungeon someday     Shelve for later
  fest promote --dungeon archived    Archive the festival
  fest promote --dungeon completed   Mark as completed (skips task validation)
fest promote [festival] [flags]

Options

      --dungeon string   send to dungeon status (completed, archived, someday)
      --force            skip readiness validation
  -h, --help             help for promote
      --json             output as JSON
      --no-commit        skip auto-commit after promotion (rejected when agent.require_auto_commit is enabled)

Options inherited from parent commands

      --config string   config file (default: ~/.obey/fest/config.json)
      --debug           enable debug logging
      --no-color        disable colored output
      --verbose         enable verbose output

SEE ALSO

  • fest - Festival Methodology CLI - goal-oriented project management for AI agents