opensquid 0.5.395

package/dist/hooks/inline-report-check.test.js

@@ -0,0 +1,96 @@
+/**
+ * Tests for inline-report-check (0.7.30 / D3 inline variant).
+ *
+ * Covers checkInlineReportFormat + the count helpers. Stop-hook
+ * integration left to integration tests (it composes the existing
+ * BrokenPromise pipeline which already has its own coverage).
+ */
+import { describe, expect, it } from "vitest";
+import { checkInlineReportFormat, countCommitHashes, countVersionRefs, hasPhasesBlock, } from "./inline-report-check.js";
+describe("countVersionRefs", () => {
+    it("counts distinct 0.X.Y refs", () => {
+        expect(countVersionRefs("shipped 0.7.20 then 0.7.21 and 0.7.22")).toBe(3);
+    });
+    it("dedupes repeated mentions", () => {
+        expect(countVersionRefs("0.7.20 fixed in 0.7.20 again")).toBe(1);
+    });
+    it("returns 0 on plain prose with no version", () => {
+        expect(countVersionRefs("hello world, no versions here")).toBe(0);
+    });
+    it("does NOT count partial versions like '0.7'", () => {
+        expect(countVersionRefs("the 0.7 series")).toBe(0);
+    });
+});
+describe("countCommitHashes", () => {
+    it("counts distinct 7-char hashes", () => {
+        expect(countCommitHashes("see 92fe415 and 0e59ba3 and 40342e3")).toBe(3);
+    });
+    it("requires at least one a-f letter (excludes pure decimal)", () => {
+        // 7-digit decimals like timestamps shouldn't trigger.
+        expect(countCommitHashes("count is 1234567 and 9876543")).toBe(0);
+    });
+    it("counts full 40-char shas", () => {
+        expect(countCommitHashes("4eaf39d2d21f0540342e3e881d2c47cde6d4ab39 abc")).toBe(1);
+    });
+    it("dedupes repeated hashes", () => {
+        expect(countCommitHashes("92fe415 ... revisit 92fe415")).toBe(1);
+    });
+});
+describe("hasPhasesBlock", () => {
+    it("true for 'PHASES:' uppercase block", () => {
+        expect(hasPhasesBlock("\nPHASES:\n- pre_research: ...")).toBe(true);
+    });
+    it("true for 'phases:' lowercase", () => {
+        expect(hasPhasesBlock("phases:\n- x")).toBe(true);
+    });
+    it("true when 'PHASES' is followed by a newline", () => {
+        expect(hasPhasesBlock("PHASES\n- pre_research")).toBe(true);
+    });
+    it("false when 'phases' appears in unrelated prose", () => {
+        expect(hasPhasesBlock("we have three phases of testing")).toBe(false);
+    });
+});
+describe("checkInlineReportFormat", () => {
+    it("flags multi-version status report without PHASES", () => {
+        const text = `Shipped 0.7.20, 0.7.21, 0.7.22 today. All tests green.`;
+        const v = checkInlineReportFormat(text);
+        expect(v).not.toBeNull();
+        expect(v.signals.version_refs).toBe(3);
+    });
+    it("flags multi-commit chain-ship without PHASES", () => {
+        const text = `Commits: 92fe415, 0e59ba3, 40342e3, d6275a1 all pushed.`;
+        const v = checkInlineReportFormat(text);
+        expect(v).not.toBeNull();
+        expect(v.signals.hash_refs).toBeGreaterThanOrEqual(2);
+    });
+    it("does NOT flag when PHASES block is present", () => {
+        const text = `🦑 #7 shipped 0.7.20, 0.7.21, 0.7.22.\n\nPHASES:\n- pre_research: ...\n- learn: ...\n- code: ...\n- test: ...\n- audit: ...\n- post_research: ...\n- fix: ...`;
+        expect(checkInlineReportFormat(text)).toBeNull();
+    });
+    it("does NOT flag a single-version prose mention (signal too weak)", () => {
+        const text = `I bumped opensquid to 0.7.30 in package.json.`;
+        expect(checkInlineReportFormat(text)).toBeNull();
+    });
+    it("does NOT flag a single-commit-hash prose mention", () => {
+        const text = `The commit 92fe415 introduced the D9 guard.`;
+        expect(checkInlineReportFormat(text)).toBeNull();
+    });
+    it("does NOT flag empty input", () => {
+        expect(checkInlineReportFormat("")).toBeNull();
+    });
+    it("matched_text condenses to <=120 chars + trims whitespace", () => {
+        const long = "Shipped 0.7.20 and 0.7.21 today.\n\n".repeat(10);
+        const v = checkInlineReportFormat(long);
+        expect(v).not.toBeNull();
+        expect(v.matched_text.length).toBeLessThanOrEqual(120);
+    });
+    it("dogfood: catches the 'where are my 7 phases' incident shape", () => {
+        // The user's complaint was the summary table I posted with 10
+        // versions and 10 commit hashes but no PHASES heading.
+        const text = `Final tally: 0.7.20 92fe415, 0.7.21 0e59ba3, 0.7.22 40342e3, 0.7.23 d6275a1, 0.7.24 e881d2c, 0.7.25 e47b65c, 0.7.26 2d21f05, 0.7.27 4ab3977, 0.7.28 47cde6d, 0.7.29 4eaf39d.`;
+        const v = checkInlineReportFormat(text);
+        expect(v).not.toBeNull();
+        expect(v.signals.version_refs).toBe(10);
+        expect(v.signals.hash_refs).toBe(10);
+    });
+});

package/dist/hooks/pre-tool-use.d.ts

@@ -0,0 +1,62 @@
+/**
+ * `opensquid hook pre-tool-use` — Claude Code PreToolUse hook handler.
+ *
+ * Wired in `~/.claude/settings.json`:
+ *
+ *   {
+ *     "hooks": {
+ *       "PreToolUse": [
+ *         {
+ *           "matcher": "Bash",
+ *           "hooks": [
+ *             { "type": "command",
+ *               "command": "node /path/to/opensquid/dist/index.js hook pre-tool-use" }
+ *           ]
+ *         }
+ *       ]
+ *     }
+ *   }
+ *
+ * Stdin: JSON describing the planned tool call (Claude Code's hook
+ * input schema). Stdout: empty on no-op. Stderr: drift findings.
+ * Exit code: 0 to proceed, 2 to block the call.
+ *
+ * The catalog of intercepts lives in src/hooks/drift-patterns.ts and
+ * grows lesson-by-lesson as drifts are observed and the user endorses
+ * the rule.
+ */
+import { type ToolCallInput } from "./drift-patterns.js";
+/**
+ * #173 — return a warning string when an active-task-gated MCP tool is
+ * about to be called without an in_progress TodoWrite task in the
+ * transcript. Returns `null` when the tool isn't gated, no transcript
+ * path is available, or an active task is detected.
+ *
+ * Transcript-read failures (missing file, malformed JSONL) swallow to
+ * null — the hook must never block a legitimate call on its own bug.
+ * The workflow-gate fail-opens silently in this case
+ * (workflow-gate.ts:97-100); this surface makes that fail-open
+ * observable from the call site.
+ *
+ * Exported for direct testing.
+ */
+export declare function checkActiveTaskRequirement(call: ToolCallInput, transcriptPath: string | undefined): Promise<string | null>;
+/**
+ * 0.7.25 / D3 — when `chat_send` is called with a body that looks like
+ * a task-completion report (starts with the agent's `🦑 #<N>` marker),
+ * verify the body includes a `PHASES` heading + at least 7 phase
+ * lines per `[[feedback_telegram_reports]]`. Returns a non-blocking
+ * warning string when the format is missing, null otherwise.
+ *
+ * Catches D3: paragraph summary sent instead of the locked 7-phase
+ * format. Detection is heuristic (the agent could write a real
+ * non-report message starting with `🦑 #N` — accepted noise).
+ *
+ * Exported for direct testing.
+ */
+export declare function checkChatSendReportFormat(call: ToolCallInput): string | null;
+/**
+ * Read JSON from stdin, evaluate drifts, exit with the appropriate code.
+ */
+export declare function runPreToolUseHook(): Promise<void>;
+//# sourceMappingURL=pre-tool-use.d.ts.map

package/dist/hooks/pre-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.d.ts","sourceRoot":"","sources":["../../src.legacy/hooks/pre-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsB7E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,aAAa,EACnB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAkB5E;AAoBD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2KvD"}

package/dist/hooks/pre-tool-use.js

@@ -0,0 +1,342 @@
+/**
+ * `opensquid hook pre-tool-use` — Claude Code PreToolUse hook handler.
+ *
+ * Wired in `~/.claude/settings.json`:
+ *
+ *   {
+ *     "hooks": {
+ *       "PreToolUse": [
+ *         {
+ *           "matcher": "Bash",
+ *           "hooks": [
+ *             { "type": "command",
+ *               "command": "node /path/to/opensquid/dist/index.js hook pre-tool-use" }
+ *           ]
+ *         }
+ *       ]
+ *     }
+ *   }
+ *
+ * Stdin: JSON describing the planned tool call (Claude Code's hook
+ * input schema). Stdout: empty on no-op. Stderr: drift findings.
+ * Exit code: 0 to proceed, 2 to block the call.
+ *
+ * The catalog of intercepts lives in src/hooks/drift-patterns.ts and
+ * grows lesson-by-lesson as drifts are observed and the user endorses
+ * the rule.
+ */
+import { decide, findDrifts } from "./drift-patterns.js";
+import { evaluateEngineVocabGate } from "./engine-vocab-gate.js";
+import { clearRecallRequired, isRecallRequired } from "./heartbeat.js";
+import { recordToolCall } from "./honesty-ledger.js";
+import { readActiveTaskId } from "./transcript.js";
+import { evaluateVersioningGate } from "./versioning-gate.js";
+import { evaluateWorkflowGate } from "./workflow-gate.js";
+/**
+ * MCP tools that participate in the drift-protection track. When any
+ * of these is called WITHOUT an in_progress TodoWrite task in the
+ * transcript, the workflow-gate / chat-routing signals end up writing
+ * to a ledger that no gate validates against. We can't BLOCK these
+ * calls (legitimate ad-hoc usage exists), but emit a loud stderr
+ * warning so the gap is visible. #173 / drift D1 structural fix
+ * (locked 2026-05-17).
+ */
+const ACTIVE_TASK_GATED_MCP_TOOLS = new Set([
+    "mcp__opensquid__log_phase",
+    "mcp__opensquid__chat_send",
+]);
+/**
+ * #173 — return a warning string when an active-task-gated MCP tool is
+ * about to be called without an in_progress TodoWrite task in the
+ * transcript. Returns `null` when the tool isn't gated, no transcript
+ * path is available, or an active task is detected.
+ *
+ * Transcript-read failures (missing file, malformed JSONL) swallow to
+ * null — the hook must never block a legitimate call on its own bug.
+ * The workflow-gate fail-opens silently in this case
+ * (workflow-gate.ts:97-100); this surface makes that fail-open
+ * observable from the call site.
+ *
+ * Exported for direct testing.
+ */
+export async function checkActiveTaskRequirement(call, transcriptPath) {
+    if (!ACTIVE_TASK_GATED_MCP_TOOLS.has(call.tool))
+        return null;
+    if (!transcriptPath)
+        return null;
+    try {
+        const activeTaskId = await readActiveTaskId(transcriptPath);
+        if (activeTaskId)
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return (`🦑 [opensquid] ${call.tool} called without an in_progress TodoWrite task — ` +
+        `the entries it writes WON'T be validated by the workflow-gate. ` +
+        `Call TaskCreate (and set in_progress) first so the gate has an active task to enforce against.\n`);
+}
+/**
+ * 0.7.25 / D3 — when `chat_send` is called with a body that looks like
+ * a task-completion report (starts with the agent's `🦑 #<N>` marker),
+ * verify the body includes a `PHASES` heading + at least 7 phase
+ * lines per `[[feedback_telegram_reports]]`. Returns a non-blocking
+ * warning string when the format is missing, null otherwise.
+ *
+ * Catches D3: paragraph summary sent instead of the locked 7-phase
+ * format. Detection is heuristic (the agent could write a real
+ * non-report message starting with `🦑 #N` — accepted noise).
+ *
+ * Exported for direct testing.
+ */
+export function checkChatSendReportFormat(call) {
+    if (call.tool !== "mcp__opensquid__chat_send")
+        return null;
+    const text = call.input.text;
+    if (typeof text !== "string")
+        return null;
+    // Trigger: message starts with the report marker `🦑 #N`.
+    if (!/^\s*🦑\s+#\d/.test(text))
+        return null;
+    // Format requirement: must include a PHASES heading and the 7 phase
+    // names. The phase names match the codex's default workflow.
+    if (!/\bPHASES\b/.test(text)) {
+        return (`🦑 [opensquid] chat_send body looks like a task-completion report ` +
+            `(starts with \`🦑 #N\`) but is missing the \`PHASES\` block. ` +
+            `Per [[feedback_telegram_reports]] reports must list each phase ` +
+            `(pre_research, learn, code, test, audit, post_research, fix) ` +
+            `with a concrete one-line finding — not just ✅. Catches drift D3.\n`);
+    }
+    return null;
+}
+/**
+ * Read JSON from stdin, evaluate drifts, exit with the appropriate code.
+ */
+export async function runPreToolUseHook() {
+    let raw = "";
+    for await (const chunk of process.stdin) {
+        raw += chunk;
+    }
+    // Empty stdin → nothing to evaluate. Some hook configurations may
+    // pipe nothing during tests; bail gracefully.
+    if (!raw.trim()) {
+        process.exit(0);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(raw);
+    }
+    catch {
+        // Malformed input — don't block on opensquid's own bug.
+        process.stderr.write("[opensquid hook] malformed PreToolUse input — proceeding\n");
+        process.exit(0);
+    }
+    if (!payload.tool_name || typeof payload.tool_name !== "string") {
+        process.exit(0);
+    }
+    const call = {
+        tool: payload.tool_name,
+        input: payload.tool_input ?? {},
+    };
+    // #173 / 0.7.29 — D1 BLOCK upgrade. When an active-task-gated MCP
+    // tool is called without an in_progress TodoWrite task in the
+    // transcript, BLOCK (was: WARN). The design doc rule #1 says BLOCK
+    // is the right semantic: log_phase / chat_send without an active
+    // task is exactly the failure mode the workflow-gate exists to
+    // prevent, and a soft warning was empirically ignored every time.
+    // Bypass: OPENSQUID_SKIP_ACTIVE_TASK_GATE=1 for legitimate
+    // non-task-scoped calls.
+    const taskWarning = await checkActiveTaskRequirement(call, payload.transcript_path);
+    if (taskWarning) {
+        process.stderr.write(taskWarning);
+        if (!checkActiveTaskBypassEnv()) {
+            process.stderr.write(`  This is a BLOCK (was WARN through 0.7.28). Call TaskCreate first.\n` +
+                `  Override (genuine non-task-scoped call): set OPENSQUID_SKIP_ACTIVE_TASK_GATE=1.\n`);
+            process.exit(2);
+        }
+        process.stderr.write(`  🦑 [opensquid active-task-gate] BYPASSED via OPENSQUID_SKIP_ACTIVE_TASK_GATE=1\n`);
+    }
+    // 0.7.25 / D3 — when chat_send body looks like a report but is missing
+    // the 7-phase format, warn. Non-blocking.
+    const formatWarning = checkChatSendReportFormat(call);
+    if (formatWarning) {
+        process.stderr.write(formatWarning);
+    }
+    // 0.7.26 / D7 — heartbeat-recall enforcement. When UPS surfaced a
+    // heartbeat nudge this turn, the recall-required flag is set; block
+    // any mcp__opensquid__* tool other than `recall` until the agent
+    // actually calls recall. On a recall call, clear the flag.
+    if (payload.session_id) {
+        try {
+            if (call.tool === "mcp__opensquid__recall" && (await isRecallRequired(payload.session_id))) {
+                await clearRecallRequired(payload.session_id);
+            }
+            else if (call.tool.startsWith("mcp__opensquid__") &&
+                !checkRecallBypassEnv() &&
+                (await isRecallRequired(payload.session_id))) {
+                process.stderr.write(buildRecallRequiredBlockMessage(call.tool));
+                process.exit(2);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[opensquid hook] recall-required check failed (proceeding): ${err instanceof Error ? err.message : err}\n`);
+        }
+    }
+    // v0.4: append to the honesty ledger so the Stop hook can reconcile
+    // assistant claims against tool calls. Best-effort — never block the
+    // call on a ledger write failure.
+    if (payload.session_id) {
+        try {
+            const inputSummary = summarizeInput(call.tool, call.input);
+            await recordToolCall(payload.session_id, call.tool, inputSummary);
+        }
+        catch (err) {
+            process.stderr.write(`[opensquid hook] honesty-ledger write failed (non-fatal): ${err instanceof Error ? err.message : err}\n`);
+        }
+    }
+    const hits = findDrifts(call);
+    const { exit, stderr } = decide(hits, call);
+    if (stderr)
+        process.stderr.write(stderr);
+    if (exit !== 0) {
+        // Existing drift gate already blocking; don't spend RPC budget on
+        // the workflow gate.
+        process.exit(exit);
+    }
+    // v0.6.1 workflow gate — when the tool call is `git commit` (not
+    // --amend, which has its own gate), check that the active task's
+    // phase ledger has the required phases logged. Engine-RPC-backed,
+    // so only fires when the engine binary is reachable. Fail-open on
+    // any error (per [[honesty-ledger]] precedent — never block on
+    // opensquid's own bug). Spawning the engine just for this check is
+    // expensive (~hundreds of ms per hook), so it's scoped tightly to
+    // commit commands.
+    if (looksLikeGitCommit(call)) {
+        try {
+            const gateResult = await evaluateWorkflowGate({
+                transcriptPath: payload.transcript_path,
+            });
+            if (gateResult.block) {
+                process.stderr.write(gateResult.stderr);
+                process.exit(2);
+            }
+            else if (gateResult.stderr) {
+                // Warning only — proceed.
+                process.stderr.write(gateResult.stderr);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[opensquid hook] workflow-gate failed (proceeding): ${err instanceof Error ? err.message : err}\n`);
+        }
+        // v0.6.3 versioning gate — enforce per-commit patch bumps. Local
+        // git diff inspection only (no RPC), so cheap. Same fail-open
+        // invariant as the workflow gate.
+        try {
+            const versionResult = await evaluateVersioningGate({ cwd: payload.cwd });
+            if (versionResult.block) {
+                process.stderr.write(versionResult.stderr);
+                process.exit(2);
+            }
+            else if (versionResult.stderr) {
+                process.stderr.write(versionResult.stderr);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[opensquid hook] versioning-gate failed (proceeding): ${err instanceof Error ? err.message : err}\n`);
+        }
+        // 0.7.21 / D6 — engine vocabulary gate. Blocks engine commits whose
+        // -m message OR staged diff content references consumer-product
+        // names (opensquid, claude code, etc.). Early-exits on non-engine
+        // cwd; cheap when not applicable.
+        try {
+            const bashCmd = stringField(call.input, "command");
+            const vocabResult = await evaluateEngineVocabGate({
+                cwd: payload.cwd,
+                bashCommand: bashCmd ?? undefined,
+            });
+            if (vocabResult.block) {
+                process.stderr.write(vocabResult.stderr);
+                process.exit(2);
+            }
+            else if (vocabResult.stderr) {
+                process.stderr.write(vocabResult.stderr);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[opensquid hook] engine-vocab-gate failed (proceeding): ${err instanceof Error ? err.message : err}\n`);
+        }
+    }
+    process.exit(0);
+}
+function stringField(input, field) {
+    const v = input[field];
+    return typeof v === "string" ? v : null;
+}
+/**
+ * 0.7.26 / D7 — emergency bypass for the recall-required block. For
+ * cases where the engine is unreachable and the agent can't call
+ * recall through normal channels.
+ */
+function checkRecallBypassEnv() {
+    return process.env.OPENSQUID_SKIP_RECALL_GATE === "1";
+}
+/**
+ * 0.7.29 / D1 BLOCK upgrade — emergency bypass for the active-task
+ * requirement. For legitimate non-task-scoped log_phase / chat_send
+ * calls (e.g. an ad-hoc one-shot ping to the user).
+ */
+function checkActiveTaskBypassEnv() {
+    return process.env.OPENSQUID_SKIP_ACTIVE_TASK_GATE === "1";
+}
+function buildRecallRequiredBlockMessage(tool) {
+    return (`🦑 [opensquid recall-gate] ${tool} blocked — heartbeat was surfaced ` +
+        `this turn but recall hasn't been called yet.\n` +
+        `Call \`mcp__opensquid__recall\` first to re-anchor on the active task, ` +
+        `then retry. Drift D7.\n` +
+        `Override (genuine emergency, e.g. engine unreachable): set ` +
+        `OPENSQUID_SKIP_RECALL_GATE=1 for this command.\n`);
+}
+function looksLikeGitCommit(call) {
+    if (call.tool !== "Bash")
+        return false;
+    const cmd = call.input.command;
+    if (typeof cmd !== "string")
+        return false;
+    // Match `git commit ...` but NOT `git commit --amend` (handled by
+    // existing drift pattern). Also skip cases where the command is
+    // clearly a comment or inside quotes (drift-patterns.ts uses the
+    // same quote-stripping; we duplicate the minimal version here).
+    const stripped = cmd.replace(/"[^"]*"/g, "").replace(/'[^']*'/g, "");
+    if (!/\bgit\s+commit\b/.test(stripped))
+        return false;
+    if (/\bgit\s+commit\b[^|;&]*--amend/.test(stripped))
+        return false;
+    return true;
+}
+/**
+ * Tight summary of tool input for the ledger. We keep just enough to
+ * reconcile claims (e.g. "did the agent run npm test?") without writing
+ * the whole tool_input blob.
+ */
+function summarizeInput(tool, input) {
+    if (tool === "Bash") {
+        const cmd = input.command;
+        return typeof cmd === "string" ? cmd.slice(0, 500) : "";
+    }
+    if (tool === "Edit" || tool === "Write" || tool === "Read") {
+        const fp = input.file_path;
+        return typeof fp === "string" ? fp : "";
+    }
+    if (tool === "Agent") {
+        const desc = input.description ?? input.subagent_type ?? "";
+        return typeof desc === "string" ? desc.slice(0, 200) : "";
+    }
+    // Default — short JSON peek for unknown tools.
+    try {
+        return JSON.stringify(input).slice(0, 200);
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=pre-tool-use.js.map

package/dist/hooks/pre-tool-use.js.map

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

package/dist/hooks/pre-tool-use.test.js

@@ -0,0 +1,134 @@
+/**
+ * Pre-tool-use hook tests — focused on the #173 (drift D1) active-task
+ * requirement check. Runs against a synthetic transcript file with
+ * controllable TodoWrite shape.
+ */
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import * as crypto from "node:crypto";
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { checkActiveTaskRequirement, checkChatSendReportFormat } from "./pre-tool-use.js";
+let tmpDir;
+let transcriptPath;
+beforeEach(async () => {
+    tmpDir = path.join(os.tmpdir(), `opensquid-ptu-${crypto.randomUUID()}`);
+    await fs.mkdir(tmpDir, { recursive: true });
+    transcriptPath = path.join(tmpDir, "transcript.jsonl");
+});
+afterEach(async () => {
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});
+async function writeTranscriptWithActiveTask(taskId) {
+    const event = {
+        type: "assistant",
+        message: {
+            role: "assistant",
+            content: [
+                {
+                    type: "tool_use",
+                    name: "TodoWrite",
+                    input: {
+                        todos: [{ id: taskId, status: "in_progress", content: "active thing" }],
+                    },
+                },
+            ],
+        },
+    };
+    await fs.writeFile(transcriptPath, JSON.stringify(event) + "\n", "utf8");
+}
+describe("checkActiveTaskRequirement — #173 / drift D1 fix", () => {
+    it("returns null for tools that aren't active-task-gated", async () => {
+        const result = await checkActiveTaskRequirement({ tool: "Bash", input: { command: "ls" } }, transcriptPath);
+        expect(result).toBeNull();
+    });
+    it("returns null when no transcript path is provided", async () => {
+        const result = await checkActiveTaskRequirement({ tool: "mcp__opensquid__log_phase", input: {} }, undefined);
+        expect(result).toBeNull();
+    });
+    it("returns null when an in_progress task exists in the transcript", async () => {
+        await writeTranscriptWithActiveTask("42");
+        const result = await checkActiveTaskRequirement({ tool: "mcp__opensquid__log_phase", input: { task_id: "42", phase: "code" } }, transcriptPath);
+        expect(result).toBeNull();
+    });
+    it("returns a warning when log_phase is called with no in_progress task", async () => {
+        await fs.writeFile(transcriptPath, "", "utf8"); // empty transcript = no tasks
+        const result = await checkActiveTaskRequirement({ tool: "mcp__opensquid__log_phase", input: { task_id: "42", phase: "code" } }, transcriptPath);
+        expect(result).not.toBeNull();
+        expect(result).toContain("mcp__opensquid__log_phase called without an in_progress");
+        expect(result).toContain("TaskCreate");
+    });
+    it("returns a warning when chat_send is called with no in_progress task", async () => {
+        await fs.writeFile(transcriptPath, "", "utf8");
+        const result = await checkActiveTaskRequirement({ tool: "mcp__opensquid__chat_send", input: { channel: "telegram:1", text: "hi" } }, transcriptPath);
+        expect(result).not.toBeNull();
+        expect(result).toContain("mcp__opensquid__chat_send called without an in_progress");
+    });
+    it("emits the warning even when the transcript file is missing (readActiveTaskId returns null gracefully)", async () => {
+        // readActiveTaskId handles missing files internally and returns
+        // null. The D1 check treats null-active-task as "no in_progress
+        // signal" regardless of cause, which is the right semantic — the
+        // agent skipped TaskCreate is the failure mode either way.
+        const result = await checkActiveTaskRequirement({ tool: "mcp__opensquid__log_phase", input: {} }, path.join(tmpDir, "nonexistent.jsonl"));
+        expect(result).not.toBeNull();
+        expect(result).toContain("called without an in_progress");
+    });
+});
+describe("checkChatSendReportFormat — 0.7.25 / drift D3", () => {
+    it("returns null for tools other than chat_send", () => {
+        const result = checkChatSendReportFormat({
+            tool: "Bash",
+            input: { command: "🦑 #4 fake bash" },
+        });
+        expect(result).toBeNull();
+    });
+    it("returns null when text doesn't start with the 🦑 #N marker", () => {
+        const result = checkChatSendReportFormat({
+            tool: "mcp__opensquid__chat_send",
+            input: { text: "just a regular ping" },
+        });
+        expect(result).toBeNull();
+    });
+    it("returns null when text starts with the marker AND has PHASES heading", () => {
+        const result = checkChatSendReportFormat({
+            tool: "mcp__opensquid__chat_send",
+            input: {
+                text: "🦑 #170 — engine-client startupAck fix\n\n" +
+                    "PHASES:\n" +
+                    "- pre_research: surveyed engine-client.ts and engine-client.test.ts\n" +
+                    "- learn: bug localized to startupAck memoization\n" +
+                    "- code: 3-LOC fix in src/engine-client.ts:103-110\n" +
+                    "- test: 2 new tests for respawn-after-exit\n" +
+                    "- audit: reviewed for regressions; none found\n" +
+                    "- post_research: docs note on resume behavior\n" +
+                    "- fix: applied + committed\n",
+            },
+        });
+        expect(result).toBeNull();
+    });
+    it("WARNS when text starts with marker but PHASES heading missing", () => {
+        const result = checkChatSendReportFormat({
+            tool: "mcp__opensquid__chat_send",
+            input: {
+                text: "🦑 #170 — engine-client startupAck fix\n\nshipped, all green",
+            },
+        });
+        expect(result).not.toBeNull();
+        expect(result).toContain("missing the `PHASES` block");
+        expect(result).toContain("drift D3");
+    });
+    it("respects leading whitespace before the marker", () => {
+        const result = checkChatSendReportFormat({
+            tool: "mcp__opensquid__chat_send",
+            input: { text: "   🦑 #4 cleanup\n\nno phases here" },
+        });
+        expect(result).not.toBeNull();
+    });
+    it("returns null when text input is missing entirely", () => {
+        const result = checkChatSendReportFormat({
+            tool: "mcp__opensquid__chat_send",
+            input: { channel: "telegram:1" },
+        });
+        expect(result).toBeNull();
+    });
+});

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `opensquid hook session-end` — Claude Code SessionEnd hook handler.
+ *
+ * Fires when a Claude Code session terminates. Wipes the session's
+ * honesty-ledger state (turn-ledger.jsonl + broken-promises.jsonl) so
+ * the ledger doesn't grow unbounded across all-time sessions.
+ *
+ * Without this hook, every Claude Code session creates a
+ * <data-root>/sessions/<id>/ directory with two JSONL files that
+ * never get cleaned up. Disk usage grows linearly with session count.
+ *
+ * Exit 0 always — SessionEnd is cleanup, not blocking.
+ */
+export declare function runSessionEndHook(): Promise<void>;
+//# sourceMappingURL=session-end.d.ts.map