claude-cook 1.11.0 → 1.11.2

package/agents/cook-pm.md

@@ -107,6 +107,10 @@ When running under `/cook:pm-start` and `pm-loop.sh`, you MUST avoid asking the
 - If a choice is required, pick a safe default and **log the choice** in PM-LOG.md.
 - Only ask the user if a **critical, irreversible** decision cannot be made safely.
 
+## PM Loop Launch is MANDATORY
+
+When spawned by `/cook:pm-start`, you MUST launch `pm-loop.sh` via Bash after executing the first cycle. The only exception is when `--manual` flag is explicitly set. Without the loop, the PM does one cycle and stops — defeating the purpose of autonomous operation. Always launch it in background with `nohup ... &`.
+
 </philosophy>
 
 <never_do>
@@ -117,6 +121,7 @@ When running under `/cook:pm-start` and `pm-loop.sh`, you MUST avoid asking the
 - Dispatch wave N+1 before wave N is fully done
 - Replan more than max_replan_attempts times without escalating to human
 - Run its own code reviewer — delegate review to Vibe Kanban's review agent
+- Skip launching pm-loop.sh after first cycle (unless --manual is set)
 </never_do>
 
 <tools_usage>

package/commands/cook/pm-start.md

@@ -138,28 +138,44 @@ Follow the action for the detected state as defined in `pm-cycle.md`:
 - NEEDS_DISPATCH → dispatch workers
 - MONITORING → poll and react
 
-## 5. Launch PM Loop
+## 5. Launch PM Loop (MANDATORY)
 
-### Autonomous Mode (default) — BACKGROUND
+**You MUST launch pm-loop.sh unless `--manual` flag is explicitly set.** This is not optional. The loop is what makes the PM autonomous — without it, the PM does one cycle and stops.
 
-Build the pm-loop.sh command with all detected parameters:
+**If `--manual` is NOT set**, run this command via Bash tool immediately after the first cycle completes:
 
 ```bash
-~/.claude/scripts/pm-loop.sh \
+nohup ~/.claude/scripts/pm-loop.sh \
   --phase={X} \
   --interval={poll_interval} \
   --max-iterations={max_iterations} \
   --background \
-  ${prd_flag}
+  ${init_flag} \
+  ${prd_flag} \
+  > /dev/null 2>&1 &
 ```
 
-Where `${prd_flag}` is `--prd=<file>` if provided.
+Where:
+- `${init_flag}` is `--init` if the `--init` flag was provided
+- `${prd_flag}` is `--prd=<file>` if provided
+- Phase is auto-detected or from arguments
 
-Stop with: `touch .planning/.pm-stop` | `/cook:pm-stop`
+After launching, confirm to user:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ PM ► LOOP STARTED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-### Manual Mode (--manual)
+PM loop running in background (PID: {pid})
+Polling every {interval}s
+
+Stop with: /cook:pm-stop
+Status:    /cook:pm-status
+```
+
+Stop with: `touch .planning/.pm-stop` | `/cook:pm-stop`
 
-Present:
+**If `--manual` IS set**, do NOT launch the loop. Present:
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  PM ► MANUAL MODE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-cook",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode and Gemini by TÂCHES.",
   "bin": {
     "claude-cook": "bin/install.js"

package/scripts/pm-loop.sh

@@ -524,24 +524,25 @@ while true; do
       update_status "running" "completed_cycle" "$(cat "$CALL_COUNT_FILE" 2>/dev/null || echo 0)"
       print_progress
 
-      # Exit if all tickets are done
+      # Check if all tickets in current phase are done
+      # DON'T exit — let pm-cycle handle phase advancement.
+      # pm-cycle will detect PHASE_COMPLETE and advance to next phase,
+      # or detect MILESTONE_COMPLETE and exit with code 42.
       if all_tickets_done; then
         TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo " PM ► ALL TICKETS DONE"
+        echo " PM ► PHASE TICKETS DONE — advancing..."
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
         echo ""
-        echo "  All tickets complete after $CYCLE cycles."
+        echo "  All current phase tickets complete. Next cycle will advance."
         echo ""
         echo "" >> "$LOG_FILE"
-        echo "## [$TIMESTAMP] LOOP_EXIT" >> "$LOG_FILE"
+        echo "## [$TIMESTAMP] PHASE_TICKETS_DONE" >> "$LOG_FILE"
         echo "" >> "$LOG_FILE"
-        echo "- All tickets done after $CYCLE cycles" >> "$LOG_FILE"
-        update_status "completed" "all_tickets_done" "$(cat "$CALL_COUNT_FILE" 2>/dev/null || echo 0)"
-        rm -f "$PID_FILE"
-        notify "COOK PM" "All tickets done! Phase complete after $CYCLE cycles."
-        exit 0
+        echo "- All tickets done in current phase after $CYCLE cycles" >> "$LOG_FILE"
+        echo "- Continuing loop — pm-cycle will advance to next phase" >> "$LOG_FILE"
+        notify "COOK PM" "Phase tickets done! Advancing to next phase..."
       fi
 
       echo ""