seed-promote

$seed promote <id>

Move a triggered seed into the CocoBrew planning cycle by writing it to lifecycle/spec.md under a "Backlog Items" section. Marks the seed as promoted.

Preconditions

• .cocoplus/ must be initialized
• Seed <id> must exist and have status: triggered (not pending, promoted, or discarded)
• lifecycle/spec.md should exist (creates Backlog Items section if file exists; warns if spec.md does not yet exist)

Arguments

• <id> (required): The seed ID to promote (e.g., seed-20260505-143200)

Step-by-Step Behavior

1. Verify initialization: Check .cocoplus/ exists. If not, output: "CocoPlus not initialized. Run $pod init first." and exit.

2. Validate seed ID: Read .cocoplus/seeds/[id].yaml.

   • If file does not exist, output: "No seed with ID [id]. Run $seed list to see available seeds." and exit.
   • If status is pending, output: "Seed [id] has not triggered yet. Trigger condition: [condition]. Use $seed list to check status." and exit.
   • If status is promoted, output: "Seed [id] was already promoted on [promoted_date]." and exit.
   • If status is discarded, output: "Seed [id] was discarded. If you want to re-activate it, add it again with $seed add." and exit.

3. Read idea and metadata: Extract from YAML: idea, trigger, captured_phase, captured_date, triggered_date.

4. Write to spec.md: Open .cocoplus/lifecycle/spec.md.

   • If spec.md does not exist, output: "Warning: spec.md not found. Run $spec first to create the specification. Seed saved as triggered — promote again after completing $spec." and exit.
   • If spec.md exists: check if a ## Backlog Items section already exists.
     • If yes: append the idea as a new bullet under that section.
     • If no: append a new ## Backlog Items section at the end of the file with the idea as the first bullet.

   Backlog item format:

   ## Backlog Items
   
   - **[seed-id]:** [idea text]
     _(Captured during [captured_phase] phase — triggered: [trigger condition] on [triggered_date])_