claude-cook 1.11.1 → 1.11.3

package/agents/cook-pm.md

@@ -109,7 +109,7 @@ When running under `/cook:pm-start` and `pm-loop.sh`, you MUST avoid asking the
 
 ## 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 ... &`.
+When spawned by `/cook:pm-start`, you MUST launch `pm-loop.sh --background` 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. Do NOT wrap in `nohup` or append `&` — the `--background` flag handles detaching internally via `setsid`/`disown`. The script prints the PID and exits immediately.
 
 </philosophy>
 

package/commands/cook/pm-start.md

@@ -145,16 +145,17 @@ Follow the action for the detected state as defined in `pm-cycle.md`:
 **If `--manual` is NOT set**, run this command via Bash tool immediately after the first cycle completes:
 
 ```bash
-nohup ~/.claude/scripts/pm-loop.sh \
+~/.claude/scripts/pm-loop.sh \
   --phase={X} \
   --interval={poll_interval} \
   --max-iterations={max_iterations} \
   --background \
   ${init_flag} \
-  ${prd_flag} \
-  > /dev/null 2>&1 &
+  ${prd_flag}
 ```
 
+**IMPORTANT:** Do NOT wrap this in `nohup` or append `&`. The `--background` flag makes `pm-loop.sh` handle its own detaching internally (via `setsid` or `nohup+disown`). The script prints the PID, writes the pid file, and exits immediately — the loop continues in a fully detached process.
+
 Where:
 - `${init_flag}` is `--init` if the `--init` flag was provided
 - `${prd_flag}` is `--prd=<file>` if provided

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-cook",
-  "version": "1.11.1",
+  "version": "1.11.3",
   "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

@@ -138,12 +138,19 @@ fi
 # ─── Background mode: re-exec detached ───────────────────────────
 
 if [ "$BACKGROUND" = true ]; then
-  # Strip --background from args, re-exec with nohup
+  # Strip --background from args, re-exec fully detached
   ARGS=()
   for arg in "$@"; do
     [ "$arg" != "--background" ] && ARGS+=("$arg")
   done
-  nohup "$0" "${ARGS[@]}" > .planning/pm-loop.log 2>&1 &
+  # Use setsid to create a new session — survives parent shell death
+  # Falls back to nohup+disown if setsid not available
+  if command -v setsid >/dev/null 2>&1; then
+    setsid "$0" "${ARGS[@]}" > .planning/pm-loop.log 2>&1 &
+  else
+    nohup "$0" "${ARGS[@]}" > .planning/pm-loop.log 2>&1 &
+    disown $! 2>/dev/null || true
+  fi
   BG_PID=$!
   echo "$BG_PID" > .planning/.pm-loop-pid
   echo "PM loop launched in background (PID: $BG_PID)"
@@ -524,24 +531,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 ""