@isaacriehm/cairn-core 0.13.3 → 0.14.1

package/dist/hooks/post-tool-use/ask-user-blocked.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PostToolUse hook on `AskUserQuestion` — auto-stamps the current active
+ * task with `blocked_on: operator` in `.cairn/tasks/active/<id>/status.yaml`
+ * so the Stop hook's stalled-task scanner skips it (the work can't
+ * progress until the operator answers).
+ *
+ * Wired into `bug-mine 0.13.8` / Phase 5. Producer pair for the
+ * existing `blocked_on: operator` skip rule in
+ * `runners/stop.ts:scanStalledRunningTasks`.
+ *
+ * No-op when:
+ *   - `tool_name !== "AskUserQuestion"` (manifest matcher narrows but
+ *     defense-in-depth).
+ *   - No active task in `.cairn/tasks/active/`.
+ *   - status.yaml missing or unparseable.
+ *   - `blocked_on: operator` already present (idempotent).
+ */
+export declare function runAskUserBlockedHook(): Promise<void>;

package/dist/hooks/post-tool-use/ask-user-blocked.js

@@ -0,0 +1,113 @@
+/**
+ * PostToolUse hook on `AskUserQuestion` — auto-stamps the current active
+ * task with `blocked_on: operator` in `.cairn/tasks/active/<id>/status.yaml`
+ * so the Stop hook's stalled-task scanner skips it (the work can't
+ * progress until the operator answers).
+ *
+ * Wired into `bug-mine 0.13.8` / Phase 5. Producer pair for the
+ * existing `blocked_on: operator` skip rule in
+ * `runners/stop.ts:scanStalledRunningTasks`.
+ *
+ * No-op when:
+ *   - `tool_name !== "AskUserQuestion"` (manifest matcher narrows but
+ *     defense-in-depth).
+ *   - No active task in `.cairn/tasks/active/`.
+ *   - status.yaml missing or unparseable.
+ *   - `blocked_on: operator` already present (idempotent).
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { resolveRepoRoot } from "../../session-start/index.js";
+import { findCurrentActiveTask } from "../../tasks/index.js";
+import { readHookStdin } from "../runners/payload.js";
+import { logger } from "../../logger.js";
+const log = logger("hooks.post-tool-use.ask-user-blocked");
+const PayloadSchema = z
+    .object({
+    session_id: z.string().optional(),
+    transcript_path: z.string().optional(),
+    cwd: z.string().optional(),
+    tool_name: z.string().optional(),
+})
+    .passthrough();
+function parsePayload(text) {
+    if (text.trim().length === 0)
+        return {};
+    try {
+        const raw = JSON.parse(text);
+        const result = PayloadSchema.safeParse(raw);
+        return result.success ? result.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+function emitShapeB(additionalContext) {
+    const out = {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: "PostToolUse",
+            additionalContext,
+        },
+    };
+    process.stdout.write(JSON.stringify(out));
+    process.stdout.write("\n");
+}
+export async function runAskUserBlockedHook() {
+    try {
+        const raw = await readHookStdin();
+        const payload = parsePayload(raw);
+        if (payload.tool_name !== "AskUserQuestion") {
+            emitShapeB("");
+            return;
+        }
+        const cwd = payload.cwd ?? process.cwd();
+        const repoRoot = resolveRepoRoot(cwd);
+        if (repoRoot === null) {
+            emitShapeB("");
+            return;
+        }
+        const taskId = findCurrentActiveTask(repoRoot);
+        if (taskId === null) {
+            emitShapeB("");
+            return;
+        }
+        const statusPath = join(repoRoot, ".cairn", "tasks", "active", taskId, "status.yaml");
+        if (!existsSync(statusPath)) {
+            emitShapeB("");
+            return;
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(readFileSync(statusPath, "utf8"));
+        }
+        catch {
+            emitShapeB("");
+            return;
+        }
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            emitShapeB("");
+            return;
+        }
+        const status = parsed;
+        if (status["blocked_on"] === "operator") {
+            emitShapeB("");
+            return;
+        }
+        status["blocked_on"] = "operator";
+        try {
+            writeFileSync(statusPath, stringifyYaml(status), "utf8");
+        }
+        catch (err) {
+            log.warn({ err: err instanceof Error ? err.message : String(err), taskId }, "ask-user-blocked: write to status.yaml failed");
+        }
+        emitShapeB("");
+    }
+    catch (err) {
+        log.warn({ err: err instanceof Error ? err.message : String(err) }, "ask-user-blocked hook failed; degrading to no-op");
+        emitShapeB("");
+    }
+}
+//# sourceMappingURL=ask-user-blocked.js.map

package/dist/hooks/post-tool-use/ask-user-blocked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-blocked.js","sourceRoot":"","sources":["../../../src/hooks/post-tool-use/ask-user-blocked.ts"],"names":[],"mappings":"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"}

package/dist/hooks/post-tool-use/index.d.ts

@@ -18,4 +18,5 @@ export type { CopySafetyConfig } from "./allowlist-reader.js";
 export { alignFile, runSotAlign, executeSotAlign } from "./sot-align.js";
 export type { AlignFileArgs, AlignFileResult, CreationVerdict, DedupVerdict, } from "./sot-align.js";
 export { runPostWriteHook } from "./post-write.js";
+export { runAskUserBlockedHook } from "./ask-user-blocked.js";
 export { containsEssayClassShape, isMarkdownPath } from "../sot-align-common.js";

package/dist/hooks/post-tool-use/index.js

@@ -13,5 +13,6 @@ export { scanForCopyLeakage } from "./copy-scanner.js";
 export { readCopySafetyConfig } from "./allowlist-reader.js";
 export { alignFile, runSotAlign, executeSotAlign } from "./sot-align.js";
 export { runPostWriteHook } from "./post-write.js";
+export { runAskUserBlockedHook } from "./ask-user-blocked.js";
 export { containsEssayClassShape, isMarkdownPath } from "../sot-align-common.js";
 //# sourceMappingURL=index.js.map

package/dist/hooks/post-tool-use/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/post-tool-use/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/post-tool-use/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/runners/context-threshold.js

@@ -139,7 +139,7 @@ export function renderContextThresholdHint(hit, taskId) {
             ...header,
             "No active task — context climbed through general work, or the active task just graduated this tick. Nothing to resume from.",
             "",
-            "Render this question via the `AskUserQuestion` tool — do not skip:",
+            "When you reach a stopping point, surface to operator (e.g. via `AskUserQuestion`); if mid-flow, finish first:",
             "",
             "> Context at " + hit.pct + "% of window. Pick:",
             "> ",
@@ -153,7 +153,7 @@ export function renderContextThresholdHint(hit, taskId) {
         ...header,
         `Active task: \`${taskId}\`.`,
         "",
-        "Render this question via the `AskUserQuestion` tool — do not skip:",
+        "When you reach a stopping point, surface to operator (e.g. via `AskUserQuestion`); if mid-flow, finish first:",
         "",
         "> Context at " + hit.pct + "% of window. Pick:",
         "> ",

package/dist/hooks/runners/context-threshold.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-threshold.js","sourceRoot":"","sources":["../../../src/hooks/runners/context-threshold.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-threshold.js","sourceRoot":"","sources":["../../../src/hooks/runners/context-threshold.ts"],"names":[],"mappings":"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"}

package/dist/hooks/runners/gc-autotrigger.d.ts

@@ -8,10 +8,13 @@
  * wait for the spawned process — it stamps the marker, fires the spawn,
  * unrefs, and returns.
  *
- * `cairn gc sweep` is sweep-only (no commit). The findings flow through
- * `cairn-attention` for operator triage. `cairn gc run --apply-classes`
- * stays operator-driven until the autotrigger is proven safe in the
- * field.
+ * The spawned `cairn gc sweep` surfaces all detection passes through
+ * `cairn-attention` for operator triage (no commit). Because the spawn
+ * carries `CAIRN_GC_AUTOTRIGGERED=1`, that same process additionally
+ * auto-retires the SAFE entity-orphan subset (`runEntityRetire({ apply })`,
+ * canary-gated, rolled back on failure) — the one autonomous mutation in
+ * the daily tick. Every other pass's proposals stay operator-driven via
+ * `cairn gc run --apply-classes` until proven safe in the field.
  */
 export interface GcAutotriggerOptions {
     repoRoot: string;

package/dist/hooks/runners/gc-autotrigger.js

@@ -8,10 +8,13 @@
  * wait for the spawned process — it stamps the marker, fires the spawn,
  * unrefs, and returns.
  *
- * `cairn gc sweep` is sweep-only (no commit). The findings flow through
- * `cairn-attention` for operator triage. `cairn gc run --apply-classes`
- * stays operator-driven until the autotrigger is proven safe in the
- * field.
+ * The spawned `cairn gc sweep` surfaces all detection passes through
+ * `cairn-attention` for operator triage (no commit). Because the spawn
+ * carries `CAIRN_GC_AUTOTRIGGERED=1`, that same process additionally
+ * auto-retires the SAFE entity-orphan subset (`runEntityRetire({ apply })`,
+ * canary-gated, rolled back on failure) — the one autonomous mutation in
+ * the daily tick. Every other pass's proposals stay operator-driven via
+ * `cairn gc run --apply-classes` until proven safe in the field.
  */
 import { spawn } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";

package/dist/hooks/runners/gc-autotrigger.js.map

@@ -1 +1 @@
-{"version":3,"file":"gc-autotrigger.js","sourceRoot":"","sources":["../../../src/hooks/runners/gc-autotrigger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gc-autotrigger.js","sourceRoot":"","sources":["../../../src/hooks/runners/gc-autotrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,UAAU,GAAG,qBAAqB,CAAC;AACzC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AA4CnC,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,uBAAuB,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,MAA2B,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,GAAG,WAAW,CAAC;IACvB,CAAC;SAAM,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,cAAc,GAAG,SAAS,EAAE,CAAC;QACzE,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,GAAG,kBAAkB,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,KAAK,CAAC;QAClB,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;IAEzE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACxE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;IACnF,CAAC;IAED,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAsB;QAC9B,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC5D,GAAG,EAAE,IAAI,CAAC,QAAQ;KACnB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAiB,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE;YACrD,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE;SACrD,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/hooks/runners/stop.js

@@ -22,7 +22,7 @@ import { isDeferActive, readDeferState } from "../defer.js";
 import { resolveRepoRoot } from "../../session-start/index.js";
 import { readEventsMarker, stampEventsPoll, } from "../../session/index.js";
 import { writeStatusJson } from "../../status-line/index.js";
-import { completeTask, findCurrentActiveTask, readTaskAttestationState, transitionTaskPhase, } from "../../tasks/index.js";
+import { completeTask, findCurrentActiveTask, readTaskAttestationState, } from "../../tasks/index.js";
 import { effectivePhaseExitGate, findActiveMission, readMissionState, readRoadmap, } from "@isaacriehm/cairn-state";
 import { checkContextThreshold, renderContextThresholdHint, } from "./context-threshold.js";
 import { writePhaseReadyPending, } from "./phase-ready-surface.js";
@@ -66,7 +66,7 @@ const MAX_REASON_CHARS = 4_000;
  * CC convention, not a failure signal. One short line keeps the chat
  * tidy without dropping the cue entirely.
  */
-const REASON_PREAMBLE = "↳ Cairn cue — render any choice via `AskUserQuestion`.\n\n";
+const REASON_PREAMBLE = "↳ Cairn hint — surface to operator at a natural stopping point. Don't interrupt productive work; quote / `AskUserQuestion` only when there's no obvious continuation.\n\n";
 function clampReason(body) {
     if (body.length === 0)
         return body;
@@ -85,6 +85,96 @@ function clampReason(body) {
  * the window or whenever the payload hash changes.
  */
 const CUE_DEBOUNCE_WINDOW_MS = 60 * 60 * 1000;
+/**
+ * Bug-mine 0.13.8 — Phase 5 stall-cue tuning.
+ *
+ * `SESSION_ACTIVITY_WINDOW_MS` — when the transcript records any
+ * `tool_use` within this window, the AI is actively working; suppress
+ * the stalled-task surface so the cue doesn't interrupt productive
+ * flow. Mining showed stall cues firing while an Agent subagent was
+ * mid-dispatch and a research run was committing.
+ *
+ * `SESSION_STALLED_CUE_WINDOW_MS` — at most one stalled cue per
+ * session per hour, total (not per-task). Per-task throttle
+ * (`STALLED_FIRE_WINDOW_MS`) remains as a floor on top.
+ */
+const SESSION_ACTIVITY_WINDOW_MS = 5 * 60 * 1000;
+const SESSION_STALLED_CUE_WINDOW_MS = 60 * 60 * 1000;
+/**
+ * Walk the transcript tail and return the millisecond age of the most
+ * recent `tool_use` entry whose timestamp parses, or `null` when no
+ * such entry is found. Best-effort — any read / parse failure returns
+ * `null` and the caller falls through to the threshold check.
+ *
+ * Claude Code transcript entries are JSONL; assistant messages with
+ * tool calls carry `type: "tool_use"` on a content block. We scan
+ * backwards from the tail and stop at the first matching line.
+ */
+function lastToolUseAgeMs(transcriptPath, nowMs) {
+    if (transcriptPath === null || transcriptPath.length === 0)
+        return null;
+    if (!existsSync(transcriptPath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(transcriptPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const lines = raw.split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (line === undefined || line.length === 0)
+            continue;
+        if (!line.includes('"tool_use"'))
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry === null || typeof entry !== "object")
+            continue;
+        const ts = entry["timestamp"]
+            ?? entry["ts"];
+        if (typeof ts !== "string")
+            continue;
+        const parsed = Date.parse(ts);
+        if (Number.isNaN(parsed))
+            continue;
+        return nowMs - parsed;
+    }
+    return null;
+}
+function lastSessionStalledCuePath(repoRoot, sessionId) {
+    return join(repoRoot, ".cairn", "sessions", sessionId, "last-stalled-cue.iso");
+}
+function lastSessionStalledCueMs(repoRoot, sessionId) {
+    const path = lastSessionStalledCuePath(repoRoot, sessionId);
+    if (!existsSync(path))
+        return null;
+    try {
+        const raw = readFileSync(path, "utf8").trim();
+        const ms = Date.parse(raw);
+        return Number.isNaN(ms) ? null : ms;
+    }
+    catch {
+        return null;
+    }
+}
+function stampSessionStalledCue(repoRoot, sessionId) {
+    const path = lastSessionStalledCuePath(repoRoot, sessionId);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, new Date().toISOString(), "utf8");
+    }
+    catch {
+        // best-effort
+    }
+}
 function priorCuePath(repoRoot, sessionId) {
     return join(repoRoot, ".cairn", "sessions", sessionId, "last-stop-cue.json");
 }
@@ -121,6 +211,7 @@ export async function runStopHook() {
     const payload = parseHookPayload(raw);
     const sessionId = typeof payload.session_id === "string" ? payload.session_id : null;
     const cwdInput = typeof payload.cwd === "string" ? payload.cwd : process.cwd();
+    const transcriptPath = typeof payload.transcript_path === "string" ? payload.transcript_path : null;
     const repoRoot = resolveRepoRoot(cwdInput);
     const warnings = [];
     let drained = [];
@@ -176,9 +267,6 @@ export async function runStopHook() {
                     const hint = `## Cairn — ${grad.completed.length} ${noun} graduated\n\n✓ ${ids} → done. Final attestation written.`;
                     reason = reason.length > 0 ? `${reason}\n\n${hint}` : hint;
                 }
-                if (grad.transitioned.length > 0) {
-                    warnings.push(`auto_graduated_review_ready:${grad.transitioned.length}`);
-                }
             }
             catch (err) {
                 warnings.push(`auto_graduate_failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -204,45 +292,73 @@ export async function runStopHook() {
                 warnings.push(`pending_review_scan_failed: ${err instanceof Error ? err.message : String(err)}`);
             }
             // Stalled-task scanner — surfaces tasks stuck in phase=running
-            // with no attestation for 30min+. Catches the failure mode where
-            // the autonomous flow finished the work but skipped spawning the
-            // reviewer subagent (no attestation → auto-graduator never fires
-            // → task accumulates as orphaned). Only fires when no other
-            // higher-priority surface (reviewer hint, ctx threshold) already
-            // owns the reason channel — stalled-task triage is informational
-            // catch-up, not blocking.
+            // with no attestation for 2h+ (raised from 30 min in bug-mine
+            // 0.13.8 / Phase 5 — see CONTEXT.md §2.4 for false-fire mining).
+            // Catches the failure mode where the autonomous flow finished
+            // the work but skipped spawning the reviewer subagent (no
+            // attestation → auto-graduator never fires → task accumulates
+            // as orphaned). Only fires when no other higher-priority surface
+            // (reviewer hint, ctx threshold) already owns the reason channel
+            // — stalled-task triage is informational catch-up, not blocking.
+            //
+            // Three additional gates layered on top of the per-task window:
             //
-            // Per-task suppression window: once a stalled hint fires for a
-            // given task id, suppress re-fires on the same id for 60 min so
-            // the operator isn't asked the same triage question every Stop
-            // tick (bug-mine report #9 — same task flagged 3× in 90s).
+            //   1. Session-activity gate — when the transcript carries a
+            //      `tool_use` event within the last 5 minutes, the AI is
+            //      actively working; suppress entirely.
+            //   2. Per-session rate limit — at most one stalled cue per
+            //      session per hour, total (not per-task). Bug-mine showed
+            //      three active tasks idle = three prompts per hour without
+            //      a global cap.
+            //   3. Per-task throttle — 60 minute suppression window per
+            //      task id so the operator isn't asked the same triage
+            //      question every Stop tick (bug-mine report #9 — same
+            //      task flagged 3× in 90s).
             if (reason.length === 0 && !isFirstTurnWarmup) {
                 try {
                     gcStalledWarnedMarkers(repoRoot);
-                    const stalled = scanStalledRunningTasks(repoRoot, Date.now(), {
-                        currentSessionId: sessionId,
-                    });
-                    const surfaced = stalled.filter((t) => !isStalledFireSuppressed(repoRoot, t.task_id));
-                    if (surfaced.length > 0) {
-                        const reviewDefer = readDeferState(repoRoot, "review");
-                        const suppressed = reviewDefer !== null &&
-                            isDeferActive(reviewDefer, new Date(), {
-                                kind: "task_ids",
-                                values: surfaced.map((t) => t.task_id),
-                            });
-                        if (suppressed) {
-                            warnings.push(`stalled_suppressed_until:${reviewDefer.deferred_at}`);
+                    const lastSessionCue = sessionId !== null
+                        ? lastSessionStalledCueMs(repoRoot, sessionId)
+                        : null;
+                    if (lastSessionCue !== null &&
+                        Date.now() - lastSessionCue < SESSION_STALLED_CUE_WINDOW_MS) {
+                        warnings.push(`stalled_session_rate_limited:${new Date(lastSessionCue).toISOString()}`);
+                    }
+                    else {
+                        const recentToolUseAge = lastToolUseAgeMs(transcriptPath, Date.now());
+                        const sessionActive = recentToolUseAge !== null && recentToolUseAge < SESSION_ACTIVITY_WINDOW_MS;
+                        if (sessionActive) {
+                            warnings.push(`stalled_session_active:${recentToolUseAge}`);
                         }
                         else {
-                            reason = renderStalledTasksHint(surfaced);
-                            for (const t of surfaced)
-                                stampStalledFire(repoRoot, t.task_id);
-                            warnings.push(`stalled_running_tasks:${surfaced.length}`);
+                            const stalled = scanStalledRunningTasks(repoRoot, Date.now(), {
+                                currentSessionId: sessionId,
+                            });
+                            const surfaced = stalled.filter((t) => !isStalledFireSuppressed(repoRoot, t.task_id));
+                            if (surfaced.length > 0) {
+                                const reviewDefer = readDeferState(repoRoot, "review");
+                                const suppressed = reviewDefer !== null &&
+                                    isDeferActive(reviewDefer, new Date(), {
+                                        kind: "task_ids",
+                                        values: surfaced.map((t) => t.task_id),
+                                    });
+                                if (suppressed) {
+                                    warnings.push(`stalled_suppressed_until:${reviewDefer.deferred_at}`);
+                                }
+                                else {
+                                    reason = renderStalledTasksHint(surfaced);
+                                    for (const t of surfaced)
+                                        stampStalledFire(repoRoot, t.task_id);
+                                    if (sessionId !== null)
+                                        stampSessionStalledCue(repoRoot, sessionId);
+                                    warnings.push(`stalled_running_tasks:${surfaced.length}`);
+                                }
+                            }
+                            else if (stalled.length > 0) {
+                                warnings.push(`stalled_window_suppressed:${stalled.length}`);
+                            }
                         }
                     }
-                    else if (stalled.length > 0) {
-                        warnings.push(`stalled_window_suppressed:${stalled.length}`);
-                    }
                 }
                 catch (err) {
                     warnings.push(`stalled_scan_failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -455,22 +571,6 @@ function readTaskPhase(taskDir) {
     }
     return null;
 }
-function checkNeedsReview(specPath) {
-    try {
-        const raw = readFileSync(specPath, "utf8");
-        const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\n---/);
-        if (!fmMatch)
-            return true;
-        const fm = fmMatch[1] ?? "";
-        const m = fm.match(/^needs_review:\s*(true|false)/m);
-        if (m && m[1] === "false")
-            return false;
-        return true;
-    }
-    catch {
-        return true;
-    }
-}
 function scanPendingReviews(repoRoot) {
     const activeDir = join(repoRoot, ".cairn", "tasks", "active");
     if (!existsSync(activeDir))
@@ -495,10 +595,10 @@ function scanPendingReviews(repoRoot) {
         const attestation = join(taskDir, "attestation.yaml");
         if (existsSync(attestation))
             continue;
-        // Finding 4: Opt-in reviewer. Default to true, skip if explicitly false.
-        if (!checkNeedsReview(tightenedSpec))
-            continue;
         // Phase gate — `running` / `tightening` / etc. are not review-ready.
+        // Reviewer is now opt-in (bug-mine 0.13.5); this surface only fires
+        // when an explicit reviewer subagent set phase=ready_for_review and
+        // ended its turn before writing attestation.yaml.
         const phase = readTaskPhase(taskDir);
         if (phase !== null && !REVIEW_READY_PHASES.has(phase))
             continue;
@@ -591,7 +691,7 @@ function scanStalledRunningTasks(repoRoot, nowMs = Date.now(), opts = { currentS
     if (!existsSync(activeDir))
         return [];
     const out = [];
-    const idleThresholdMs = 30 * 60 * 1000;
+    const idleThresholdMs = 2 * 60 * 60 * 1000;
     const upperBoundMs = 7 * 24 * 60 * 60 * 1000;
     // When a task's last journal write came from a DIFFERENT live session
     // within this window, treat it as "owned by that session" and don't
@@ -727,9 +827,9 @@ function renderStalledTasksHint(stalled) {
     const lines = [
         `## Cairn — ${stalled.length} stalled ${noun}`,
         ``,
-        `${stalled.length} active ${noun} idle 30min+ with no attestation. ` +
+        `${stalled.length} active ${noun} idle 2h+ with no attestation. ` +
             `Either the autonomous flow skipped the reviewer-spawn step, or the ` +
-            `session was interrupted mid-task. Triage before continuing:`,
+            `session was interrupted mid-task.`,
         ``,
     ];
     for (const t of stalled) {
@@ -737,7 +837,7 @@ function renderStalledTasksHint(stalled) {
         lines.push(`- \`${t.task_id}\` — ${t.title}${mod} (idle ${t.idle_minutes}m)`);
     }
     lines.push("");
-    lines.push("Render this question via `AskUserQuestion` — do not skip:");
+    lines.push("If you reach a stopping point with no obvious continuation, surface to operator (e.g. via `AskUserQuestion`):");
     lines.push("");
     lines.push(`> ${stalled.length} stalled ${noun}. Pick once for all (or address one at a time after):`);
     lines.push(`>`);
@@ -747,26 +847,30 @@ function renderStalledTasksHint(stalled) {
     lines.push(``);
     lines.push("On [a], call `cairn_task_complete({task_id, outcome: \"succeeded\", summary: \"closing stalled task — work landed via prior session\"})` for each id above.");
     lines.push("On [b], dispatch the `reviewer` subagent for each task in turn (one task brief per Task call).");
-    lines.push("On [c], end the turn — the prompt re-fires only when status.yaml stays idle past the next 30min mark.");
+    lines.push("On [c], end the turn — the prompt re-fires only when status.yaml stays idle past the next 2h mark.");
+    lines.push("");
+    lines.push("If you're actively working (Agent dispatch in flight, edits queued), ignore this hint and keep going — it will re-evaluate on the next Stop tick.");
     return lines.join("\n");
 }
 /**
  * Auto-graduate active tasks based on attestation presence.
  *
+ * Self-attest is the default path (bug-mine 0.13.5): the AI calls
+ * `cairn_task_complete({outcome, summary})` and the tool moves the
+ * directory itself. This auto-graduator is the fallback for the rare
+ * case where an opt-in reviewer subagent wrote attestation.yaml but
+ * ended its turn before the explicit close call.
+ *
  * Rules (only acts on tasks with phase=running):
- *   1. Task-root `attestation.yaml` exists                     → succeeded → tasks/done/
- *      (reviewer subagent attested; nothing more to do)
- *   2. ≥1 subagents/<id>/attestation.yaml AND needs_review=false → succeeded → tasks/done/
- *      (trivial task, no reviewer scheduled)
- *   3. ≥1 subagents/<id>/attestation.yaml AND needs_review=true  → ready_for_review
- *      (reviewer hasn't run yet — `scanPendingReviews` will surface a hint)
+ *   1. Task-root `attestation.yaml` exists       → succeeded → tasks/done/
+ *   2. ≥1 subagents/<id>/attestation.yaml        → succeeded → tasks/done/
  *
  * Tasks with no attestation activity stay `running` — they're either
- * still in flight or stalled (Q4 surfaces stall detection separately).
+ * still in flight or stalled (stall detection runs separately).
  */
 function autoGraduateTasks(repoRoot) {
     const activeDir = join(repoRoot, ".cairn", "tasks", "active");
-    const result = { completed: [], transitioned: [] };
+    const result = { completed: [] };
     if (!existsSync(activeDir))
         return result;
     let entries;
@@ -785,7 +889,7 @@ function autoGraduateTasks(repoRoot) {
             continue;
         if (state.phase !== "running")
             continue;
-        if (state.rootAttestation) {
+        if (state.rootAttestation || state.subagentAttestations > 0) {
             const r = completeTask({
                 repoRoot,
                 taskId,
@@ -794,27 +898,6 @@ function autoGraduateTasks(repoRoot) {
             });
             if (r.ok)
                 result.completed.push(taskId);
-            continue;
-        }
-        if (state.subagentAttestations > 0) {
-            if (!state.needsReview) {
-                const r = completeTask({
-                    repoRoot,
-                    taskId,
-                    outcome: "succeeded",
-                    source: "cairn_stop_auto_graduate",
-                });
-                if (r.ok)
-                    result.completed.push(taskId);
-                continue;
-            }
-            const ok = transitionTaskPhase({
-                repoRoot,
-                taskId,
-                newPhase: "ready_for_review",
-            });
-            if (ok)
-                result.transitioned.push(taskId);
         }
     }
     return result;