@pmelab/gtd 2.0.0 → 2.1.0

package/README.md

@@ -67,6 +67,9 @@ gtd next --json            # ask who's up and what they should do
 See [The reference loop driver](#the-reference-loop-driver) for a full script
 implementing this protocol, and [`skills/loop/SKILL.md`](skills/loop/SKILL.md)
 for the agent-facing instructions that follow the same pinned contract.
+`gtd-loop`, installed alongside `gtd` (see below), is the packaged, ready-to-run
+implementation of that same script for anyone who doesn't want to drive the loop
+by hand.
 
 ## Installation
 
@@ -397,6 +400,26 @@ side can drive — agent rests and agent-driven checkpoints — reports
 cycles, a force-approved package close) chain without human involvement until an
 actual human gate is hit.
 
+`bin/gtd-loop`, installed as the `gtd-loop` binary, is the packaged
+implementation of this exact script — kept in sync with it the same way
+`skills/loop/SKILL.md` is. It additionally attempts `gtd step` (not just
+`gtd step-agent`) every iteration, so a plain rerun after you've edited a file
+at a human gate (no commit needed) picks up your edit and keeps going, and it
+halts with a diagnostic if the same state and prompt repeat with no progress
+(see `skills/loop/SKILL.md`'s "Stall detection").
+
+### Using a different agent
+
+`gtd-loop` defaults to
+`claude -p "$GTD_LOOP_PROMPT" --dangerously-skip-permissions`, but the agent
+invocation is swappable: set `GTD_LOOP_AGENT_CMD` to any shell command, and it
+runs with the prompt available as `$GTD_LOOP_PROMPT` in its environment. For
+example, to drive a different agent CLI:
+
+```bash
+GTD_LOOP_AGENT_CMD='my-agent-cli --prompt "$GTD_LOOP_PROMPT"' gtd-loop
+```
+
 ## States & subjects overview
 
 `resolve()` lands on exactly one of **16 states**: `grilling`, `grilled`,

package/bin/gtd-loop

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Drives the two-beat protocol (README.md "The reference loop driver") to a
+# human gate. Both mutators are attempted every iteration, refusal-tolerant:
+# whichever actor is actually awaited claims the turn (captures the human's
+# uncommitted edit after a halt, or the agent's own edit from the previous
+# iteration), the other refuses harmlessly.
+prev_state=""
+prev_prompt=""
+
+while true; do
+  gtd step --json >/dev/null 2>&1 || true
+  gtd step-agent --json >/dev/null 2>&1 || true
+
+  if ! next_json="$(gtd next --json 2>&1)"; then
+    echo "gtd-loop: could not determine the next step:" >&2
+    echo "$next_json" >&2
+    echo "Run \`gtd status\` to inspect the repo." >&2
+    exit 1
+  fi
+
+  actor="$(jq -r .actor <<<"$next_json")"
+  pending="$(jq -r .pending <<<"$next_json")"
+  state="$(jq -r .state <<<"$next_json")"
+  prompt="$(jq -r .prompt <<<"$next_json")"
+
+  if [[ "$actor" != "agent" ]]; then
+    echo "--- Your turn ($state) ---"
+    gtd next
+    exit 0
+  fi
+
+  if [[ "$pending" == "true" ]]; then
+    prev_state=""
+    prev_prompt=""
+    continue
+  fi
+
+  # Stall detection (skills/loop/SKILL.md): the same agent-owned state and
+  # prompt repeating means the last dispatch made no progress — stop rather
+  # than spin on it.
+  if [[ "$state" == "$prev_state" && "$prompt" == "$prev_prompt" ]]; then
+    echo "gtd-loop: no progress at '$state' — the agent's last turn changed nothing. Stopping to avoid spinning." >&2
+    gtd next >&2
+    exit 1
+  fi
+  prev_state="$state"
+  prev_prompt="$prompt"
+
+  # Swappable agent adapter: GTD_LOOP_AGENT_CMD lets any coding agent CLI
+  # stand in for the default, receiving the prompt via $GTD_LOOP_PROMPT.
+  cmd="${GTD_LOOP_AGENT_CMD:-}"
+  if [[ -z "$cmd" ]]; then
+    cmd='claude -p "$GTD_LOOP_PROMPT" --dangerously-skip-permissions'
+  fi
+  GTD_LOOP_PROMPT="$prompt" bash -c "$cmd"
+done

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@pmelab/gtd",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {
-    "gtd": "dist/gtd.bundle.mjs"
+    "gtd": "dist/gtd.bundle.mjs",
+    "gtd-loop": "bin/gtd-loop"
   },
   "files": [
     "dist/",
+    "bin/",
     "README.md",
     "LICENSE",
     "schema.json"