opensquid 0.5.441 → 0.5.449

package/dist/hooks/engine-vocab-gate.d.ts

@@ -1,108 +0,0 @@
-/**
- * Engine vocabulary gate — pre-commit check enforcing substrate purity
- * in engine repos (0.7.21 / drift D6).
- *
- * Wired into the PreToolUse hook for `git commit` commands when the
- * cwd is detected as an engine repo. Catches commit messages AND
- * staged content (CHANGELOG.md, code comments, etc.) that reference
- * consumer-product names like `opensquid` or `claude code` — engine
- * is general substrate and must not name specific consumers per
- * `[[feedback_engine_vocabulary_discipline]]`.
- *
- * Why this gate exists: the existing `substrate-purity` pattern in
- * drift-patterns.ts only matched commit messages where the bash
- * command itself contained the path `loop/engine`. Real engine work
- * happens in cwd /Users/slee/projects/loop/engine/ with the command
- * just `git commit -m "..."` — the path isn't in the command. This
- * gate uses cwd directly + scans both the -m message AND the staged
- * diff content.
- *
- * Detection:
- *   1. Skip silently if cwd doesn't look like an engine repo.
- *   2. Parse the -m message text from the bash command; check for
- *      consumer names.
- *   3. Run `git diff --cached` and scan added lines for consumer
- *      names, excluding `src/host/claude_code/**` paths and lines
- *      that look like MIT attribution comments.
- *   4. Block with an actionable message if any leak found.
- *
- * Fail-open invariant: any error parsing the command, running git, or
- * scanning the diff → allow with stderr warning. Mirrors the
- * workflow-gate / versioning-gate precedent.
- *
- * Override: `OPENSQUID_SKIP_ENGINE_VOCAB_GATE=1` bypasses with loud
- * stderr warning. For genuine emergencies where naming the consumer
- * is unavoidable (e.g. a migration-note commit explicitly tracking
- * cross-product impact).
- */
-export interface EngineVocabGateInput {
-    /** Working directory — used to detect if this is an engine repo and
-     * as the cwd for the git diff subprocess. */
-    cwd?: string;
-    /** The full bash command text — scanned for `-m "..."` message content. */
-    bashCommand?: string;
-}
-export interface EngineVocabGateResult {
-    block: boolean;
-    stderr: string;
-}
-/**
- * Evaluate the gate against a planned `git commit` invocation.
- *
- * Exported for direct unit testing.
- */
-export declare function evaluateEngineVocabGate(input: EngineVocabGateInput): Promise<EngineVocabGateResult>;
-/**
- * Heuristic: is this cwd an engine repo?
- *
- * Catches:
- *   - /any/path/engine (engine repo as a directory inside a monorepo)
- *   - /any/path/loop-engine (standalone engine repo)
- *   - /any/path/<anything>-engine
- *
- * False-positives risk: a `/Users/foo/projects/build-engine/` Vue.js
- * project would match. Acceptable — this gate runs only on `git commit`
- * in that dir, and the regex would not match any of its content. Net
- * cost: one git-diff subprocess call. Cheap.
- *
- * Exported for direct unit testing.
- */
-export declare function isEngineRepoCwd(cwd: string): boolean;
-/**
- * Parse a `git commit -m "..."` (or `-m '...'`) message from a bash
- * command and check for consumer names. Returns the first matched
- * consumer-name substring, or null if clean.
- *
- * Handles common shells: -m followed by a quoted string, OR -m
- * followed by a HEREDOC (`-m "$(cat <<'EOF' ... EOF)"`). For HEREDOC
- * the regex below catches the body since it's embedded in the bash
- * command string.
- *
- * Exported for direct unit testing.
- */
-export declare function scanCommitMessage(bashCommand: string): string | null;
-interface DiffHit {
-    file: string;
-    match: string;
-}
-/**
- * Run `git diff --cached` and scan added lines for consumer names.
- * Excludes structurally-allowed paths and MIT attribution comments.
- *
- * Returns the list of hits (empty if clean).
- *
- * Exported for direct unit testing.
- */
-export declare function scanStagedDiff(cwd: string): Promise<DiffHit[]>;
-/**
- * Parse a unified diff text and return consumer-name hits on added
- * lines, with path-prefix and attribution-comment exclusions applied.
- *
- * Exported for direct unit testing (avoids needing a git subprocess
- * in unit tests).
- */
-export declare function parseDiffForConsumerNames(diff: string): DiffHit[];
-/** Exported for the test suite. */
-export declare function checkOverrideEnv(): boolean;
-export {};
-//# sourceMappingURL=engine-vocab-gate.d.ts.map

package/dist/hooks/engine-vocab-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-vocab-gate.d.ts","sourceRoot":"","sources":["../../src.legacy/hooks/engine-vocab-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AA4BH,MAAM,WAAW,oBAAoB;IACnC;iDAC6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA6ChC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWpE;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAMpE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CA8BjE;AAoBD,mCAAmC;AACnC,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}

package/dist/hooks/engine-vocab-gate.js

@@ -1,225 +0,0 @@
-/**
- * Engine vocabulary gate — pre-commit check enforcing substrate purity
- * in engine repos (0.7.21 / drift D6).
- *
- * Wired into the PreToolUse hook for `git commit` commands when the
- * cwd is detected as an engine repo. Catches commit messages AND
- * staged content (CHANGELOG.md, code comments, etc.) that reference
- * consumer-product names like `opensquid` or `claude code` — engine
- * is general substrate and must not name specific consumers per
- * `[[feedback_engine_vocabulary_discipline]]`.
- *
- * Why this gate exists: the existing `substrate-purity` pattern in
- * drift-patterns.ts only matched commit messages where the bash
- * command itself contained the path `loop/engine`. Real engine work
- * happens in cwd /Users/slee/projects/loop/engine/ with the command
- * just `git commit -m "..."` — the path isn't in the command. This
- * gate uses cwd directly + scans both the -m message AND the staged
- * diff content.
- *
- * Detection:
- *   1. Skip silently if cwd doesn't look like an engine repo.
- *   2. Parse the -m message text from the bash command; check for
- *      consumer names.
- *   3. Run `git diff --cached` and scan added lines for consumer
- *      names, excluding `src/host/claude_code/**` paths and lines
- *      that look like MIT attribution comments.
- *   4. Block with an actionable message if any leak found.
- *
- * Fail-open invariant: any error parsing the command, running git, or
- * scanning the diff → allow with stderr warning. Mirrors the
- * workflow-gate / versioning-gate precedent.
- *
- * Override: `OPENSQUID_SKIP_ENGINE_VOCAB_GATE=1` bypasses with loud
- * stderr warning. For genuine emergencies where naming the consumer
- * is unavoidable (e.g. a migration-note commit explicitly tracking
- * cross-product impact).
- */
-import { exec as execCb } from "node:child_process";
-import { promisify } from "node:util";
-const exec = promisify(execCb);
-/**
- * Consumer product names that may not appear in engine artifacts.
- * Case-insensitive. Word-boundary-ish so substrings like
- * "openssquidly" don't false-fire — but tight enough to catch
- * "opensquid's", "claude_code", "open squid", etc.
- */
-const CONSUMER_NAME_REGEX = /\b(opensquid|claude[._\- ]code|open[._\- ]squid)\b/i;
-/**
- * File path prefix that's allowed to name consumer products structurally
- * (engine's per-host adapter directories). Adding more here as new host
- * adapters land is fine.
- */
-const STRUCTURALLY_ALLOWED_PATH_PREFIXES = ["src/host/claude_code/"];
-/**
- * Lines starting with comment syntax that mention MIT attribution are
- * allowed — they're licence headers for cherry-picked code.
- */
-const MIT_ATTRIBUTION_REGEX = /(\/\/|#|\*).*\b(MIT|Copyright|License)\b/i;
-/**
- * Evaluate the gate against a planned `git commit` invocation.
- *
- * Exported for direct unit testing.
- */
-export async function evaluateEngineVocabGate(input) {
-    if (checkOverrideEnv()) {
-        return {
-            block: false,
-            stderr: "🦑 [opensquid engine-vocab-gate] BYPASSED via OPENSQUID_SKIP_ENGINE_VOCAB_GATE=1\n",
-        };
-    }
-    const cwd = input.cwd;
-    if (!cwd || !isEngineRepoCwd(cwd)) {
-        // Not an engine repo — gate doesn't apply. Silent allow.
-        return { block: false, stderr: "" };
-    }
-    const violations = [];
-    // Scan 1: the -m message text from the bash command.
-    if (input.bashCommand) {
-        const messageHit = scanCommitMessage(input.bashCommand);
-        if (messageHit) {
-            violations.push(`  - commit message references "${messageHit}"`);
-        }
-    }
-    // Scan 2: staged file content (CHANGELOG.md edits, code comments, etc.).
-    try {
-        const stagedHits = await scanStagedDiff(cwd);
-        for (const hit of stagedHits) {
-            violations.push(`  - ${hit.file}: "${hit.match}" on added line`);
-        }
-    }
-    catch (err) {
-        return {
-            block: false,
-            stderr: `[opensquid engine-vocab-gate] git diff failed (proceeding): ${err instanceof Error ? err.message : err}\n`,
-        };
-    }
-    if (violations.length === 0) {
-        return { block: false, stderr: "" };
-    }
-    return {
-        block: true,
-        stderr: buildBlockMessage(violations),
-    };
-}
-/**
- * Heuristic: is this cwd an engine repo?
- *
- * Catches:
- *   - /any/path/engine (engine repo as a directory inside a monorepo)
- *   - /any/path/loop-engine (standalone engine repo)
- *   - /any/path/<anything>-engine
- *
- * False-positives risk: a `/Users/foo/projects/build-engine/` Vue.js
- * project would match. Acceptable — this gate runs only on `git commit`
- * in that dir, and the regex would not match any of its content. Net
- * cost: one git-diff subprocess call. Cheap.
- *
- * Exported for direct unit testing.
- */
-export function isEngineRepoCwd(cwd) {
-    // Normalize trailing slash.
-    const normalized = cwd.replace(/\/+$/, "");
-    // Match: ends with `/engine` OR ends with `*-engine`
-    return /\/engine$|-engine$/.test(normalized);
-}
-/**
- * Parse a `git commit -m "..."` (or `-m '...'`) message from a bash
- * command and check for consumer names. Returns the first matched
- * consumer-name substring, or null if clean.
- *
- * Handles common shells: -m followed by a quoted string, OR -m
- * followed by a HEREDOC (`-m "$(cat <<'EOF' ... EOF)"`). For HEREDOC
- * the regex below catches the body since it's embedded in the bash
- * command string.
- *
- * Exported for direct unit testing.
- */
-export function scanCommitMessage(bashCommand) {
-    // Look for -m followed by a quoted string. Match both `-m "..."` and
-    // `-m '...'` forms, including HEREDOC bodies that get interpolated.
-    // Simple approach: scan the ENTIRE command for consumer names that
-    // appear after a `-m`. False-positives if the command has unrelated
-    // `-m` content followed by consumer names — acceptable for D6.
-    const dashMIndex = bashCommand.search(/\s-m\b/);
-    if (dashMIndex === -1)
-        return null;
-    const afterDashM = bashCommand.slice(dashMIndex);
-    const match = afterDashM.match(CONSUMER_NAME_REGEX);
-    return match ? match[0] : null;
-}
-/**
- * Run `git diff --cached` and scan added lines for consumer names.
- * Excludes structurally-allowed paths and MIT attribution comments.
- *
- * Returns the list of hits (empty if clean).
- *
- * Exported for direct unit testing.
- */
-export async function scanStagedDiff(cwd) {
-    const { stdout } = await exec("git diff --cached --unified=0 --no-color", {
-        cwd,
-        maxBuffer: 4 * 1024 * 1024,
-    });
-    return parseDiffForConsumerNames(stdout);
-}
-/**
- * Parse a unified diff text and return consumer-name hits on added
- * lines, with path-prefix and attribution-comment exclusions applied.
- *
- * Exported for direct unit testing (avoids needing a git subprocess
- * in unit tests).
- */
-export function parseDiffForConsumerNames(diff) {
-    const hits = [];
-    let currentFile = null;
-    for (const line of diff.split("\n")) {
-        // Track file context. Unified diff: `+++ b/path/to/file`
-        if (line.startsWith("+++ ")) {
-            const path = line.slice(4).replace(/^b\//, "").trim();
-            currentFile = path === "/dev/null" ? null : path;
-            continue;
-        }
-        if (line.startsWith("--- "))
-            continue;
-        if (line.startsWith("@@"))
-            continue;
-        // Only scan added lines.
-        if (!line.startsWith("+"))
-            continue;
-        // Skip the `+++` header (caught above) and pure `+` lines.
-        if (line.length === 1)
-            continue;
-        const content = line.slice(1);
-        if (currentFile === null)
-            continue;
-        if (isStructurallyAllowedPath(currentFile))
-            continue;
-        if (MIT_ATTRIBUTION_REGEX.test(content))
-            continue;
-        const match = content.match(CONSUMER_NAME_REGEX);
-        if (match) {
-            hits.push({ file: currentFile, match: match[0] });
-        }
-    }
-    return hits;
-}
-function isStructurallyAllowedPath(path) {
-    return STRUCTURALLY_ALLOWED_PATH_PREFIXES.some((prefix) => path.startsWith(prefix));
-}
-function buildBlockMessage(violations) {
-    return (`🦑 [opensquid engine-vocab-gate] engine commit blocked — consumer-product names detected\n` +
-        `${violations.join("\n")}\n` +
-        `\n` +
-        `Engine is general substrate per [[feedback_engine_vocabulary_discipline]].\n` +
-        `Re-word using engine-domain terminology (e.g. "the RPC writer" / "the consumer",\n` +
-        `not "opensquid"; "claude_session_id" → neutral identifier). For per-host adapter\n` +
-        `code that is structurally consumer-specific, place under src/host/claude_code/**.\n` +
-        `\n` +
-        `Override (genuine emergency): set OPENSQUID_SKIP_ENGINE_VOCAB_GATE=1 for this command.\n`);
-}
-/** Exported for the test suite. */
-export function checkOverrideEnv() {
-    return process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE === "1";
-}
-//# sourceMappingURL=engine-vocab-gate.js.map

package/dist/hooks/engine-vocab-gate.js.map

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

package/dist/hooks/engine-vocab-gate.test.js

@@ -1,170 +0,0 @@
-/**
- * Tests for engine-vocab-gate (0.7.21 / drift D6).
- *
- * Covers the pure-function decomposition (isEngineRepoCwd,
- * scanCommitMessage, parseDiffForConsumerNames) so we don't need to
- * set up a git fixture for every assertion. End-to-end coverage via
- * the existing pre-tool-use integration tests is left as a follow-up.
- */
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { checkOverrideEnv, isEngineRepoCwd, parseDiffForConsumerNames, scanCommitMessage, } from "./engine-vocab-gate.js";
-describe("isEngineRepoCwd", () => {
-    it("matches monorepo engine subdir", () => {
-        expect(isEngineRepoCwd("/Users/slee/projects/loop/engine")).toBe(true);
-    });
-    it("matches monorepo engine subdir with trailing slash", () => {
-        expect(isEngineRepoCwd("/Users/slee/projects/loop/engine/")).toBe(true);
-    });
-    it("matches standalone loop-engine repo", () => {
-        expect(isEngineRepoCwd("/Users/slee/projects/loop-engine")).toBe(true);
-    });
-    it("matches any other -engine repo", () => {
-        expect(isEngineRepoCwd("/home/alice/work/search-engine")).toBe(true);
-    });
-    it("does NOT match an unrelated subdir", () => {
-        expect(isEngineRepoCwd("/Users/slee/projects/loop/opensquid")).toBe(false);
-    });
-    it("does NOT match a path that just contains 'engine' in the middle", () => {
-        expect(isEngineRepoCwd("/Users/slee/engine-tutorials/lesson1")).toBe(false);
-    });
-    it("does NOT match the repo parent (loop monorepo root)", () => {
-        expect(isEngineRepoCwd("/Users/slee/projects/loop")).toBe(false);
-    });
-});
-describe("scanCommitMessage", () => {
-    it("flags 'opensquid' in a -m message", () => {
-        expect(scanCommitMessage('git commit -m "ships in lockstep with opensquid 0.7.11"')).toBe("opensquid");
-    });
-    it("flags 'opensquid' in a HEREDOC -m body", () => {
-        const cmd = `git commit -m "$(cat <<'EOF'
-fix something
-ships alongside opensquid 0.7.x
-EOF
-)"`;
-        expect(scanCommitMessage(cmd)).toBe("opensquid");
-    });
-    it("flags 'claude code' with various separators", () => {
-        expect(scanCommitMessage('git commit -m "tested against Claude Code session UUID"')).toBe("Claude Code");
-        expect(scanCommitMessage('git commit -m "claude_code adapter update"')).toBe("claude_code");
-        expect(scanCommitMessage('git commit -m "claude-code session"')).toBe("claude-code");
-    });
-    it("returns null on a clean engine commit message", () => {
-        expect(scanCommitMessage('git commit -m "fix(phase_ledger): drop session_id from storage scheme"')).toBeNull();
-    });
-    it("returns null when there is no -m flag at all", () => {
-        expect(scanCommitMessage("git status")).toBeNull();
-        expect(scanCommitMessage("git commit")).toBeNull();
-    });
-    it("does NOT false-fire on substrings like 'openssquidly'", () => {
-        // CONSUMER_NAME_REGEX uses \b word boundaries so partial matches don't trip.
-        expect(scanCommitMessage('git commit -m "openssquidly is not a real word"')).toBeNull();
-    });
-});
-describe("parseDiffForConsumerNames", () => {
-    it("flags an added line in CHANGELOG.md that mentions opensquid", () => {
-        const diff = `diff --git a/CHANGELOG.md b/CHANGELOG.md
-index abc..def 100644
---- a/CHANGELOG.md
-+++ b/CHANGELOG.md
-@@ -1,3 +1,4 @@
-+ships in lockstep with opensquid 0.7.11
- existing line
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(1);
-        expect(hits[0].file).toBe("CHANGELOG.md");
-        expect(hits[0].match).toBe("opensquid");
-    });
-    it("flags an added comment in src/lib.rs that mentions 'Claude Code'", () => {
-        const diff = `diff --git a/src/lib.rs b/src/lib.rs
---- a/src/lib.rs
-+++ b/src/lib.rs
-@@ -10,0 +11 @@
-+    // Tested against Claude Code session UUID format.
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(1);
-        expect(hits[0].file).toBe("src/lib.rs");
-    });
-    it("does NOT flag added lines under src/host/claude_code/", () => {
-        const diff = `diff --git a/src/host/claude_code/adapter.rs b/src/host/claude_code/adapter.rs
---- a/src/host/claude_code/adapter.rs
-+++ b/src/host/claude_code/adapter.rs
-@@ -0,0 +1 @@
-+// Claude Code-specific adapter logic — opensquid is the consumer.
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(0);
-    });
-    it("does NOT flag MIT attribution comment lines", () => {
-        const diff = `diff --git a/src/engine/buffer.rs b/src/engine/buffer.rs
---- a/src/engine/buffer.rs
-+++ b/src/engine/buffer.rs
-@@ -0,0 +1 @@
-+// MIT-licensed code cherry-picked from claude_code's transcript reader.
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(0);
-    });
-    it("does NOT flag removed lines (we only care about additions)", () => {
-        const diff = `diff --git a/CHANGELOG.md b/CHANGELOG.md
---- a/CHANGELOG.md
-+++ b/CHANGELOG.md
-@@ -1,2 +1,1 @@
--old line that mentioned opensquid
- kept line
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(0);
-    });
-    it("returns empty array on a fully clean engine diff", () => {
-        const diff = `diff --git a/src/engine/mod.rs b/src/engine/mod.rs
---- a/src/engine/mod.rs
-+++ b/src/engine/mod.rs
-@@ -10,0 +11 @@
-+    let task_id = ctx.task_id();
-`;
-        expect(parseDiffForConsumerNames(diff)).toEqual([]);
-    });
-    it("collects multiple hits across multiple files", () => {
-        const diff = `diff --git a/CHANGELOG.md b/CHANGELOG.md
---- a/CHANGELOG.md
-+++ b/CHANGELOG.md
-@@ -1,0 +1 @@
-+now compatible with opensquid 0.7.x
-diff --git a/src/serve.rs b/src/serve.rs
---- a/src/serve.rs
-+++ b/src/serve.rs
-@@ -10,0 +11 @@
-+    // The opensquid MCP server expects this format.
-`;
-        const hits = parseDiffForConsumerNames(diff);
-        expect(hits).toHaveLength(2);
-        expect(hits.map((h) => h.file)).toEqual(["CHANGELOG.md", "src/serve.rs"]);
-    });
-});
-describe("checkOverrideEnv", () => {
-    const previousValue = process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE;
-    beforeEach(() => {
-        delete process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE;
-    });
-    afterEach(() => {
-        if (previousValue === undefined) {
-            delete process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE;
-        }
-        else {
-            process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE = previousValue;
-        }
-    });
-    it("returns true when the env var is exactly '1'", () => {
-        process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE = "1";
-        expect(checkOverrideEnv()).toBe(true);
-    });
-    it("returns false when the env var is unset", () => {
-        expect(checkOverrideEnv()).toBe(false);
-    });
-    it("returns false when the env var is some other value", () => {
-        process.env.OPENSQUID_SKIP_ENGINE_VOCAB_GATE = "true";
-        expect(checkOverrideEnv()).toBe(false);
-    });
-});

package/dist/hooks/heartbeat.d.ts

@@ -1,107 +0,0 @@
-/**
- * Token-threshold heartbeat — opensquid's in-ecosystem replacement for
- * the auto-classifier subprocess.
- *
- * The agent (Claude Code itself) is the LLM in the loop and is already
- * authenticated. There is no reason to spawn a second LLM subprocess
- * to classify what the user said — the agent can do that work inline
- * per the CLAUDE.md classify-and-act block.
- *
- * What the agent IS bad at: noticing when its in-context understanding
- * has drifted enough that it should re-anchor via `recall`. That's a
- * timing problem opensquid can solve cleanly: count tokens in the
- * transcript, compare to a checkpoint, and if the delta crosses a
- * threshold, drop a one-line nudge into the next turn's UserPromptSubmit
- * stdout so the agent sees it at the top of its system context.
- *
- * Flow:
- *   Stop hook (every turn) → `checkAndMaybeArm(sessionId, transcriptPath)`
- *     - Estimates total transcript tokens (char count / 4)
- *     - Loads last checkpoint from `<data-root>/sessions/<sid>/heartbeat-checkpoint.json`
- *     - If (current - last) >= threshold, writes a marker at
- *       `<data-root>/sessions/<sid>/heartbeat-pending.txt` AND updates
- *       the checkpoint to the current count
- *   UserPromptSubmit hook (next turn) → `consumePendingHeartbeat(sessionId)`
- *     - Reads marker if present, returns its contents (for stdout injection)
- *     - Deletes the marker so the nudge fires exactly once per crossing
- *
- * Threshold: `OPENSQUID_HEARTBEAT_TOKENS` env, default 20000.
- *   Calibrated against the existing CLAUDE.md "drifts after ~10 unrelated
- *   turns" observation (~2000 tokens per turn typical).
- *
- * Zero subprocess. Zero external LLM. Zero new dependency. The agent
- * (which already exists in the loop) does the actual recall + classify
- * work inline after seeing the nudge.
- */
-/** Default threshold — see file docstring for rationale. */
-export declare const DEFAULT_HEARTBEAT_TOKENS = 20000;
-/**
- * Resolve the configured heartbeat threshold. Env var `OPENSQUID_HEARTBEAT_TOKENS`
- * overrides; values <= 0 or non-numeric fall back to the default. Returning a
- * sentinel `Infinity` would let callers disable cheaply, but we keep the
- * contract simple: any positive integer is honored.
- */
-export declare function heartbeatThresholdTokens(): number;
-/**
- * Rough token estimate from raw text — char-count / 4. Cheap, dependency-
- * free, and accurate enough for "did the conversation grow by 20K tokens
- * since last checkpoint" decisions. Real tokenizers (tiktoken,
- * @anthropic-ai/tokenizer) would be more accurate but add a runtime dep
- * for marginal gain on a threshold comparison.
- */
-export declare function estimateTokens(text: string): number;
-export declare function estimateTranscriptTokens(transcriptPath: string): Promise<number>;
-interface Checkpoint {
-    last_token_count: number;
-    last_checkpoint_at: string;
-}
-export declare function readCheckpoint(sessionId: string, options?: {
-    dataRoot?: string;
-}): Promise<Checkpoint | null>;
-export declare function writeCheckpoint(sessionId: string, checkpoint: Checkpoint, options?: {
-    dataRoot?: string;
-}): Promise<void>;
-/**
- * Build the one-line nudge that gets injected into the agent's next-
- * turn system context. Kept short — the agent's existing system prompt
- * (CLAUDE.md classify-and-act + the user-is-god promoted lesson)
- * already tells it what to do with classification work.
- */
-export declare function formatHeartbeatNudge(delta: number, threshold: number): string;
-/**
- * Stop-hook entrypoint: check whether the transcript has grown past
- * the threshold since the last checkpoint. If so, arm a pending
- * heartbeat marker for UserPromptSubmit to surface on the next turn,
- * and bump the checkpoint to the current count.
- *
- * Returns the nudge text written (or null if no arming happened) for
- * test introspection and Stop-hook stderr surfacing.
- */
-export declare function checkAndMaybeArm(sessionId: string, transcriptPath: string, options?: {
-    dataRoot?: string;
-    thresholdTokens?: number;
-}): Promise<string | null>;
-/**
- * UserPromptSubmit-hook entrypoint: consume any armed heartbeat marker
- * and return its text. Caller injects via stdout. Marker is removed so
- * the nudge fires exactly once per threshold crossing.
- */
-export declare function consumePendingHeartbeat(sessionId: string, options?: {
-    dataRoot?: string;
-}): Promise<string | null>;
-/** Test/SessionEnd helper — paths the cleanup phase removes. */
-export declare function heartbeatSessionFiles(sessionId: string, dataRoot?: string): string[];
-/** Set the flag — called after the heartbeat nudge is surfaced. */
-export declare function markRecallRequired(sessionId: string, options?: {
-    dataRoot?: string;
-}): Promise<void>;
-/** Check whether the flag is set for this session. */
-export declare function isRecallRequired(sessionId: string, options?: {
-    dataRoot?: string;
-}): Promise<boolean>;
-/** Clear the flag — called after the agent calls recall. */
-export declare function clearRecallRequired(sessionId: string, options?: {
-    dataRoot?: string;
-}): Promise<void>;
-export {};
-//# sourceMappingURL=heartbeat.d.ts.map

package/dist/hooks/heartbeat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src.legacy/hooks/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAOH,4DAA4D;AAC5D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAMjD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAyCD,wBAAsB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBtF;AAwCD,UAAU,UAAU;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAUD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAe5B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BxB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpF;AA2BD,mEAAmE;AACnE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,sDAAsD;AACtD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,4DAA4D;AAC5D,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAOf"}