claude-cook 1.11.2 → 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.2",
+  "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)"