@cleocode/cleo-os 2026.5.130 → 2026.5.132

package/dist/harnesses/goal-stop-hook.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Claude Code Stop-hook — goal-continuation loop adapter (E4-GOAL-LOOP).
+ *
+ * ## What this does
+ *
+ * Claude Code fires the `Stop` event every time Claude finishes a response
+ * turn. When a CLEO goal is active, this hook advances the goal one turn
+ * (via `cleo goal advance <goalId>`) and — if the goal is not yet terminal —
+ * emits a `{ decision: "block", reason: "<continuation>" }` JSON response that
+ * Claude Code interprets as "do NOT stop; inject this message instead". This
+ * re-nudges Claude to keep working toward the goal, closing the
+ * self-renudging loop (AC2).
+ *
+ * ## Decision protocol (Claude Code Stop-hook contract)
+ *
+ * - Output `{ "decision": "block", "reason": "<user message>" }` → Claude Code
+ *   does not stop; it injects `reason` as a fresh user message and continues.
+ * - Output nothing (or anything not parseable as `{ decision: "block" }`) →
+ *   Claude Code stops normally.
+ *
+ * ## Safety
+ *
+ * - Best-effort: any error exits 0 (Claude Code stops normally — no crash loop).
+ * - Terminal goals (satisfied/abandoned/impossible) emit nothing → stop.
+ * - Missing/no active goal → stop normally.
+ *
+ * ## Installation
+ *
+ * This script is registered as a Claude Code Stop hook via
+ * `ClaudeCodeHookProvider.registerGoalLoopHook()` or by running
+ * `cleo goal arm` (AC3). The hook entry in `~/.claude/settings.json`:
+ *
+ * ```json
+ * {
+ *   "Stop": [{
+ *     "matcher": "",
+ *     "hooks": [{
+ *       "type": "command",
+ *       "command": "node /path/to/goal-stop-hook.js # cleo-goal-loop"
+ *     }]
+ *   }]
+ * }
+ * ```
+ *
+ * @module @cleocode/cleo-os/harnesses/goal-stop-hook
+ *
+ * @task T11496 E4-GOAL-LOOP
+ * @epic T11492 SG-AUTOPILOT
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ * @adr ADR-051
+ */
+export {};
+//# sourceMappingURL=goal-stop-hook.d.ts.map

package/dist/harnesses/goal-stop-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-stop-hook.d.ts","sourceRoot":"","sources":["../../src/harnesses/goal-stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG"}

package/dist/harnesses/goal-stop-hook.js

@@ -0,0 +1,121 @@
+/**
+ * Claude Code Stop-hook — goal-continuation loop adapter (E4-GOAL-LOOP).
+ *
+ * ## What this does
+ *
+ * Claude Code fires the `Stop` event every time Claude finishes a response
+ * turn. When a CLEO goal is active, this hook advances the goal one turn
+ * (via `cleo goal advance <goalId>`) and — if the goal is not yet terminal —
+ * emits a `{ decision: "block", reason: "<continuation>" }` JSON response that
+ * Claude Code interprets as "do NOT stop; inject this message instead". This
+ * re-nudges Claude to keep working toward the goal, closing the
+ * self-renudging loop (AC2).
+ *
+ * ## Decision protocol (Claude Code Stop-hook contract)
+ *
+ * - Output `{ "decision": "block", "reason": "<user message>" }` → Claude Code
+ *   does not stop; it injects `reason` as a fresh user message and continues.
+ * - Output nothing (or anything not parseable as `{ decision: "block" }`) →
+ *   Claude Code stops normally.
+ *
+ * ## Safety
+ *
+ * - Best-effort: any error exits 0 (Claude Code stops normally — no crash loop).
+ * - Terminal goals (satisfied/abandoned/impossible) emit nothing → stop.
+ * - Missing/no active goal → stop normally.
+ *
+ * ## Installation
+ *
+ * This script is registered as a Claude Code Stop hook via
+ * `ClaudeCodeHookProvider.registerGoalLoopHook()` or by running
+ * `cleo goal arm` (AC3). The hook entry in `~/.claude/settings.json`:
+ *
+ * ```json
+ * {
+ *   "Stop": [{
+ *     "matcher": "",
+ *     "hooks": [{
+ *       "type": "command",
+ *       "command": "node /path/to/goal-stop-hook.js # cleo-goal-loop"
+ *     }]
+ *   }]
+ * }
+ * ```
+ *
+ * @module @cleocode/cleo-os/harnesses/goal-stop-hook
+ *
+ * @task T11496 E4-GOAL-LOOP
+ * @epic T11492 SG-AUTOPILOT
+ * @saga T11283 SG-COGNITIVE-SUBSTRATE
+ * @adr ADR-051
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+/**
+ * Run the goal-loop Stop-hook logic.
+ *
+ * 1. Query `cleo goal status` to find the active goal.
+ * 2. If no active goal → stop normally (no output).
+ * 3. Call `cleo goal advance <goalId>` to advance one turn.
+ * 4. If the advance result carries a continuation (goal still active) →
+ *    emit a `{ decision: "block", reason: content }` JSON block to stdout.
+ * 5. If terminal (satisfied/abandoned/impossible) → stop normally.
+ */
+async function main() {
+    // 1. Resolve the active goal (per-agent scoped).
+    let statusEnvelope;
+    try {
+        const { stdout } = await execFileAsync('cleo', ['goal', 'status'], {
+            timeout: 10_000,
+            env: process.env,
+        });
+        statusEnvelope = JSON.parse(stdout.trim());
+    }
+    catch {
+        // cleo unavailable or no project — stop normally.
+        return;
+    }
+    const goalData = statusEnvelope?.data;
+    // `active: null` means no active goal; an absent or null `id` similarly.
+    if (!goalData || 'active' in goalData || !goalData.id) {
+        // No active goal — stop normally.
+        return;
+    }
+    const goalId = goalData.id;
+    // 2. Advance one turn.
+    let advanceEnvelope;
+    try {
+        const { stdout } = await execFileAsync('cleo', ['goal', 'advance', goalId], {
+            timeout: 30_000,
+            env: process.env,
+        });
+        advanceEnvelope = JSON.parse(stdout.trim());
+    }
+    catch {
+        // Advance failed — stop normally rather than crashing.
+        return;
+    }
+    if (!advanceEnvelope?.success) {
+        // Advance returned an error envelope — stop normally.
+        return;
+    }
+    const continuation = advanceEnvelope?.data?.continuation;
+    // 3. If there is a continuation nudge, emit the block decision.
+    if (continuation && typeof continuation.content === 'string') {
+        const decision = {
+            decision: 'block',
+            reason: continuation.content,
+        };
+        process.stdout.write(JSON.stringify(decision) + '\n'); // stdout-discipline-allowed: Stop-hook contract — Claude Code reads decision JSON from stdout to determine whether to continue // stdout-write-allowed: Stop-hook protocol output (not render layer — Claude Code reads raw stdout)
+    }
+    // Otherwise (terminal goal) — no output → Claude Code stops normally.
+}
+// Run and exit cleanly on any error (never crash the hook).
+main().catch(() => {
+    process.exit(0);
+});
+//# sourceMappingURL=goal-stop-hook.js.map

package/dist/harnesses/goal-stop-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-stop-hook.js","sourceRoot":"","sources":["../../src/harnesses/goal-stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAoC1C,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,KAAK,UAAU,IAAI;IACjB,iDAAiD;IACjD,IAAI,cAAkC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;YACjE,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAuB,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,EAAE,IAAI,CAAC;IACtC,yEAAyE;IACzE,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACtD,kCAAkC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;IAE3B,uBAAuB;IACvB,IAAI,eAAoC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;YAC1E,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAwB,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC;QAC9B,sDAAsD;QACtD,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC;IAEzD,gEAAgE;IAChE,IAAI,YAAY,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAiB;YAC7B,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,YAAY,CAAC,OAAO;SAC7B,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,oOAAoO;IAC7R,CAAC;IACD,sEAAsE;AACxE,CAAC;AAED,4DAA4D;AAC5D,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/cleo-os",
-  "version": "2026.5.130",
+  "version": "2026.5.132",
   "description": "CleoOS — the batteries-included agentic development environment wrapping Pi",
   "type": "module",
   "main": "./dist/cli.js",
@@ -11,11 +11,11 @@
     "@mariozechner/pi-coding-agent": ">=0.60.0",
     "@sinclair/typebox": "^0.34.49",
     "env-paths": "^4.0.0",
-    "@cleocode/agents": "2026.5.130",
-    "@cleocode/cant": "2026.5.130",
-    "@cleocode/paths": "2026.5.130",
-    "@cleocode/core": "2026.5.130",
-    "@cleocode/contracts": "2026.5.130"
+    "@cleocode/agents": "2026.5.132",
+    "@cleocode/cant": "2026.5.132",
+    "@cleocode/contracts": "2026.5.132",
+    "@cleocode/paths": "2026.5.132",
+    "@cleocode/core": "2026.5.132"
   },
   "devDependencies": {
     "typescript": "^6.0.2",