opensquid 0.5.441 → 0.5.447

package/dist/hooks/drift-catalog.js

@@ -1,184 +0,0 @@
-/**
- * Drift catalog — automated SessionEnd scan that surfaces this session's
- * drift signals (0.7.22 / drift D10).
- *
- * D10 in the catalog: previously the agent only catalogued its drifts
- * AFTER the user prompted "please put in all the drifting issues found
- * recently." The whole project is anti-drift; the agent should be
- * cataloguing its own drifts continuously as the dogfood proof.
- *
- * This module scans the session's JSONL transcript at SessionEnd for
- * three classes of drift markers:
- *
- *   1. User-correction phrases in user messages ("you drifted",
- *      "stop X-ing", "no not that", "wrong")
- *   2. Locked-rule citations in user OR assistant messages
- *      (feedback_*, mem-*, drift D\d+)
- *   3. Agent mea-culpa phrases in assistant messages ("I should
- *      have", "my mistake", "I drifted", "I false-stopped")
- *
- * Hits are appended to `<dataRoot>/projects/<uuid>/drift-catalog.jsonl`.
- * One JSON record per line: `{timestamp, session_id, kind, evidence}`.
- *
- * If the project UUID can't be resolved (no `.opensquid/project.json`
- * card in any ancestor of cwd), entries fall back to
- * `<dataRoot>/sessions/<session_id>/drift-catalog.jsonl` so the data
- * isn't lost.
- *
- * Fail-open: any error (missing transcript, bad JSONL, write failure)
- * is swallowed with a stderr warning. SessionEnd is cleanup, not
- * blocking.
- */
-import { promises as fs } from "node:fs";
-import * as path from "node:path";
-import { resolveDataRoot } from "../codex/store.js";
-import { findProjectCard } from "../project.js";
-import { readTranscriptLines } from "./transcript.js";
-/**
- * Locked-rule citation pattern. Matches:
- *   - `feedback_xxx` style memory file names
- *   - `mem-<hex>` style memory ids
- *   - `drift D1` through `drift D99` (the in-session catalog)
- */
-const RULE_CITATION_REGEX = /\b(feedback_\w+|mem-[a-f0-9]+|drift\s+D\d+)\b/i;
-/**
- * User-correction phrases. Conservative on purpose — false-positives in
- * the catalog are tolerable (it's a dogfood log, not user-facing) but
- * we don't want to flood with every "wrong" in unrelated prose.
- */
-const USER_CORRECTION_REGEX = /\b(you drifted|you're drifting|that'?s wrong|that'?s drift|stop (asking|doing|that|it)|don'?t (ask|do|repeat|forget)|no,? not that|you keep (drifting|doing))\b/i;
-/**
- * Agent mea-culpa phrases. Catches the patterns the agent uses when
- * acknowledging it drifted — useful retroactive signal.
- */
-const MEA_CULPA_REGEX = /\b(I should have|I drifted|sorry,? I (drifted|missed)|that was a drift|I false-?stopped|I false-?started|I keep drifting|my (mistake|drift))\b/i;
-/**
- * Scan a transcript and return all detected drift markers. Pure
- * function; exported for direct testing.
- */
-export function scanTranscriptForDrift(lines, sessionId, now = () => new Date()) {
-    const entries = [];
-    for (const line of lines) {
-        const event = safeParseLine(line);
-        if (!event)
-            continue;
-        if (event.type === "user") {
-            const text = extractUserText(event);
-            if (!text)
-                continue;
-            pushIfMatch(entries, text, USER_CORRECTION_REGEX, "user_correction", sessionId, now);
-            pushIfMatch(entries, text, RULE_CITATION_REGEX, "rule_citation", sessionId, now);
-        }
-        else if (event.type === "assistant") {
-            const text = extractAssistantText(event);
-            if (!text)
-                continue;
-            pushIfMatch(entries, text, MEA_CULPA_REGEX, "mea_culpa", sessionId, now);
-            pushIfMatch(entries, text, RULE_CITATION_REGEX, "rule_citation", sessionId, now);
-        }
-    }
-    return entries;
-}
-function pushIfMatch(entries, text, regex, kind, sessionId, now) {
-    const match = text.match(regex);
-    if (!match)
-        return;
-    const evidence = match[0].slice(0, 200);
-    const idx = text.indexOf(match[0]);
-    const start = Math.max(0, idx - 100);
-    const end = Math.min(text.length, idx + match[0].length + 100);
-    const context = text.slice(start, end);
-    entries.push({
-        timestamp: now().toISOString(),
-        session_id: sessionId,
-        kind,
-        evidence,
-        context,
-    });
-}
-/**
- * Run the SessionEnd drift-catalog scan + persist results. Returns
- * the number of entries written (0 if nothing matched OR write failed).
- */
-export async function runDriftCatalogScan(input) {
-    if (!input.transcriptPath)
-        return 0;
-    let lines;
-    try {
-        lines = await readTranscriptLines(input.transcriptPath);
-    }
-    catch {
-        return 0;
-    }
-    const entries = scanTranscriptForDrift(lines, input.sessionId, input.now);
-    if (entries.length === 0)
-        return 0;
-    const targetPath = await resolveCatalogPath(input.cwd, input.sessionId, input.dataRoot);
-    try {
-        await fs.mkdir(path.dirname(targetPath), { recursive: true });
-        const serialized = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-        await fs.appendFile(targetPath, serialized, "utf8");
-        return entries.length;
-    }
-    catch {
-        return 0;
-    }
-}
-/**
- * Decide where to write the catalog: project-scoped if we can resolve
- * a project UUID from cwd; session-scoped fallback otherwise.
- *
- * Exported for testing.
- */
-export async function resolveCatalogPath(cwd, sessionId, dataRoot) {
-    const root = resolveDataRoot(dataRoot);
-    if (cwd) {
-        try {
-            const found = await findProjectCard(cwd);
-            if (found) {
-                return path.join(root, "projects", found.card.uuid, "drift-catalog.jsonl");
-            }
-        }
-        catch {
-            // fall through to session-scoped fallback
-        }
-    }
-    return path.join(root, "sessions", sessionId, "drift-catalog.jsonl");
-}
-// ---------------------------------------------------------------------
-// Local duck-typed transcript parsing (mirrors transcript.ts patterns
-// to avoid widening the public surface of that module).
-// ---------------------------------------------------------------------
-function safeParseLine(line) {
-    if (!line.trim())
-        return null;
-    try {
-        return JSON.parse(line);
-    }
-    catch {
-        return null;
-    }
-}
-function extractUserText(event) {
-    const content = event.message?.content;
-    if (typeof content === "string")
-        return content;
-    return "";
-}
-function extractAssistantText(event) {
-    const content = event.message?.content;
-    if (typeof content === "string")
-        return content;
-    if (!Array.isArray(content))
-        return "";
-    const parts = [];
-    for (const block of content) {
-        if (block && typeof block === "object" && "type" in block && block.type === "text") {
-            const text = block.text;
-            if (typeof text === "string")
-                parts.push(text);
-        }
-    }
-    return parts.join("\n");
-}
-//# sourceMappingURL=drift-catalog.js.map

package/dist/hooks/drift-catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"drift-catalog.js","sourceRoot":"","sources":["../../src.legacy/hooks/drift-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAiBtD;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,gDAAgD,CAAC;AAE7E;;;;GAIG;AACH,MAAM,qBAAqB,GACzB,kKAAkK,CAAC;AAErK;;;GAGG;AACH,MAAM,eAAe,GACnB,iJAAiJ,CAAC;AAUpJ;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAe,EACf,SAAiB,EACjB,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IAElC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;YACrF,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;YACzE,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAClB,OAA4B,EAC5B,IAAY,EACZ,KAAa,EACb,IAAqB,EACrB,SAAiB,EACjB,GAAe;IAEf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC;QACX,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QAC9B,UAAU,EAAE,SAAS;QACrB,IAAI;QACJ,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAMzC;IACC,IAAI,CAAC,KAAK,CAAC,cAAc;QAAE,OAAO,CAAC,CAAC;IAEpC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEnC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC3E,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAuB,EACvB,SAAiB,EACjB,QAAiB;IAEjB,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;AACvE,CAAC;AAED,wEAAwE;AACxE,sEAAsE;AACtE,wDAAwD;AACxD,wEAAwE;AAExE,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAsB;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAsB;IAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnF,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;YAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/hooks/drift-catalog.test.js

@@ -1,154 +0,0 @@
-/**
- * Tests for drift-catalog (0.7.22 / drift D10).
- *
- * Covers scanTranscriptForDrift pure function. End-to-end persistence
- * exercised in resolveCatalogPath tests (no project card) — full
- * project-card flow needs fs fixtures and is left to integration.
- */
-import { promises as fs } from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { resolveCatalogPath, scanTranscriptForDrift } from "./drift-catalog.js";
-const FIXED_NOW = () => new Date("2026-05-18T06:00:00.000Z");
-const SESSION_ID = "test-session-abc";
-function userLine(text) {
-    return JSON.stringify({ type: "user", message: { role: "user", content: text } });
-}
-function assistantLine(text) {
-    return JSON.stringify({
-        type: "assistant",
-        message: { role: "assistant", content: [{ type: "text", text }] },
-    });
-}
-describe("scanTranscriptForDrift — user correction patterns", () => {
-    it("catches 'you drifted'", () => {
-        const entries = scanTranscriptForDrift([userLine("hey you drifted again")], SESSION_ID, FIXED_NOW);
-        expect(entries.length).toBeGreaterThanOrEqual(1);
-        expect(entries.some((e) => e.kind === "user_correction")).toBe(true);
-    });
-    it("catches 'stop asking'", () => {
-        const entries = scanTranscriptForDrift([userLine("please stop asking me to confirm every step")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "user_correction")).toBe(true);
-    });
-    it("catches 'don't repeat'", () => {
-        const entries = scanTranscriptForDrift([userLine("don't repeat the same false-stop pattern")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "user_correction")).toBe(true);
-    });
-    it("does NOT catch 'wrong' on its own", () => {
-        const entries = scanTranscriptForDrift([userLine("the answer was wrong")], SESSION_ID, FIXED_NOW);
-        expect(entries.filter((e) => e.kind === "user_correction")).toEqual([]);
-    });
-    it("ignores tool_result-shaped user events (array content)", () => {
-        const line = JSON.stringify({
-            type: "user",
-            message: { role: "user", content: [{ type: "tool_result", content: "you drifted" }] },
-        });
-        const entries = scanTranscriptForDrift([line], SESSION_ID, FIXED_NOW);
-        expect(entries).toEqual([]);
-    });
-});
-describe("scanTranscriptForDrift — rule citations", () => {
-    it("catches feedback_* references in user text", () => {
-        const entries = scanTranscriptForDrift([userLine("re-read feedback_full_automation_mode")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "rule_citation" && e.evidence.startsWith("feedback_"))).toBe(true);
-    });
-    it("catches mem-<hex> references in assistant text", () => {
-        const entries = scanTranscriptForDrift([assistantLine("per mem-3cf66f39 we don't apologize")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "rule_citation" && e.evidence.startsWith("mem-"))).toBe(true);
-    });
-    it("catches drift D-number references", () => {
-        const entries = scanTranscriptForDrift([userLine("you're hitting drift D9 again")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "rule_citation" && /drift\s+D9/i.test(e.evidence))).toBe(true);
-    });
-});
-describe("scanTranscriptForDrift — mea-culpa patterns", () => {
-    it("catches 'I drifted' in assistant text", () => {
-        const entries = scanTranscriptForDrift([assistantLine("you're right, I drifted from the locked rule")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "mea_culpa")).toBe(true);
-    });
-    it("catches 'I should have' in assistant text", () => {
-        const entries = scanTranscriptForDrift([assistantLine("I should have called recall before answering")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "mea_culpa")).toBe(true);
-    });
-    it("catches 'I false-stopped'", () => {
-        const entries = scanTranscriptForDrift([assistantLine("I false-stopped at the end of last turn")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "mea_culpa")).toBe(true);
-    });
-    it("does NOT fire on assistant claim that's just a quote of the user", () => {
-        // The user said "I drifted" → assistant repeated it. Mea-culpa pattern still fires
-        // — accepted noise per the conservative-on-purpose stance. This test documents
-        // current behavior, not perfection.
-        const entries = scanTranscriptForDrift([assistantLine('the user said "I drifted" but that wasn\'t about me')], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "mea_culpa")).toBe(true);
-    });
-});
-describe("scanTranscriptForDrift — entry shape", () => {
-    it("populates timestamp, session_id, kind, evidence, context", () => {
-        const entries = scanTranscriptForDrift([userLine("you drifted again right after I locked the rule")], SESSION_ID, FIXED_NOW);
-        const correction = entries.find((e) => e.kind === "user_correction");
-        expect(correction).toBeDefined();
-        expect(correction.timestamp).toBe("2026-05-18T06:00:00.000Z");
-        expect(correction.session_id).toBe(SESSION_ID);
-        expect(correction.evidence).toBe("you drifted");
-        expect(correction.context).toContain("you drifted");
-    });
-    it("handles multiple turns and accumulates entries", () => {
-        const entries = scanTranscriptForDrift([
-            userLine("you drifted yesterday"),
-            assistantLine("I should have noticed sooner"),
-            userLine("feedback_full_automation_mode applies here"),
-        ], SESSION_ID, FIXED_NOW);
-        expect(entries.length).toBeGreaterThanOrEqual(3);
-        const kinds = new Set(entries.map((e) => e.kind));
-        expect(kinds.has("user_correction")).toBe(true);
-        expect(kinds.has("mea_culpa")).toBe(true);
-        expect(kinds.has("rule_citation")).toBe(true);
-    });
-    it("skips malformed JSONL lines silently", () => {
-        const entries = scanTranscriptForDrift(["not valid json", "", userLine("you drifted")], SESSION_ID, FIXED_NOW);
-        expect(entries.some((e) => e.kind === "user_correction")).toBe(true);
-    });
-});
-describe("resolveCatalogPath — session fallback when no project card", () => {
-    let tmpDir;
-    beforeEach(async () => {
-        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "drift-catalog-test-"));
-    });
-    afterEach(async () => {
-        await fs.rm(tmpDir, { recursive: true, force: true });
-    });
-    it("returns session-scoped path when no project card exists in cwd ancestry", async () => {
-        // Use a fresh tmpdir as both cwd and dataRoot — guaranteed no .opensquid/ card up the tree.
-        const noCardDir = await fs.mkdtemp(path.join(os.tmpdir(), "no-card-"));
-        try {
-            const got = await resolveCatalogPath(noCardDir, "sess-xyz", tmpDir);
-            expect(got).toBe(path.join(tmpDir, "sessions", "sess-xyz", "drift-catalog.jsonl"));
-        }
-        finally {
-            await fs.rm(noCardDir, { recursive: true, force: true });
-        }
-    });
-    it("returns session-scoped path when cwd is undefined", async () => {
-        const got = await resolveCatalogPath(undefined, "sess-xyz", tmpDir);
-        expect(got).toBe(path.join(tmpDir, "sessions", "sess-xyz", "drift-catalog.jsonl"));
-    });
-    it("returns project-scoped path when cwd has a .opensquid/project.json card", async () => {
-        // Create a project card in the cwd
-        const projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), "with-card-"));
-        try {
-            await fs.mkdir(path.join(projectRoot, ".opensquid"), { recursive: true });
-            await fs.writeFile(path.join(projectRoot, ".opensquid", "project.json"), JSON.stringify({
-                version: 1,
-                id: "test-project",
-                uuid: "abc-uuid-123",
-                created_at: "2026-05-18T00:00:00.000Z",
-            }));
-            const got = await resolveCatalogPath(projectRoot, "sess-xyz", tmpDir);
-            expect(got).toBe(path.join(tmpDir, "projects", "abc-uuid-123", "drift-catalog.jsonl"));
-        }
-        finally {
-            await fs.rm(projectRoot, { recursive: true, force: true });
-        }
-    });
-});

package/dist/hooks/drift-patterns.d.ts

@@ -1,110 +0,0 @@
-/**
- * Drift pattern catalog — known anti-patterns opensquid intercepts at
- * the Claude Code PreToolUse hook before the agent commits the action.
- *
- * Each pattern has:
- *  - `id` — stable identifier for the rule
- *  - `trigger` — matcher against tool call input
- *  - `lesson` — short reference to the lesson that owns this rule
- *  - `message` — what the agent sees in stderr when intercepted
- *  - `severity` — "block" (exit 2 stops the call) or "warn" (stderr
- *    only, call proceeds)
- *
- * Patterns are CONSERVATIVE on purpose: we'd rather miss a drift than
- * spam false positives. The catalog grows lesson-by-lesson as new
- * drifts are observed and the user endorses the rule.
- */
-export type DriftSeverity = "block" | "warn";
-export interface DriftPattern {
-    id: string;
-    /** Tool name to match. "*" matches any tool; specific names match
-     * one exact tool. 0.7.24 / D2: broadened from a fixed union to
-     * `string` so MCP tool names like `mcp__plugin_telegram_telegram__reply`
-     * can be matched directly. */
-    tool: string;
-    /** Matcher applied to the relevant tool input field. */
-    trigger: DriftTrigger;
-    /** Lesson id (in the workflow codex) that owns this rule. */
-    lesson: string;
-    /** Short, agent-facing explanation surfaced when triggered. */
-    message: string;
-    severity: DriftSeverity;
-}
-export type DriftTrigger = {
-    kind: "bash_contains";
-    needle: string;
-    strip_quotes?: boolean;
-} | {
-    kind: "bash_regex";
-    pattern: string;
-    strip_quotes?: boolean;
-} | {
-    kind: "text_regex";
-    pattern: string;
-    field: string;
-};
-export declare const DRIFT_PATTERNS: DriftPattern[];
-export interface ToolCallInput {
-    tool: string;
-    input: Record<string, unknown>;
-}
-export interface DriftHit {
-    pattern: DriftPattern;
-}
-/**
- * Run the catalog against a tool call. Returns every matching pattern;
- * caller decides block-vs-warn based on highest severity.
- */
-export declare function findDrifts(call: ToolCallInput): DriftHit[];
-/**
- * Strip HEREDOC bodies (`<<DELIM ... DELIM` and variants) from a
- * shell command.
- *
- * Recognizes:
- *   <<EOF ... \nEOF        (unquoted delimiter, expansion-allowing)
- *   <<'EOF' ... \nEOF      (single-quoted, literal body)
- *   <<"EOF" ... \nEOF      (double-quoted, literal body)
- *   <<-EOF ... \nEOF       (tab-stripping mode)
- *   <<-'EOF' ... \nEOF     (combined)
- *
- * Delimiter is any word-char sequence (EOF, END, HERE, MARKER, etc.).
- * Lazy `[\s\S]*?` matches across newlines; `\b` after the backref
- * ensures `EOFX` doesn't close an `<<EOF` block.
- *
- * If a HEREDOC has no closing delimiter (truncated input), regex
- * doesn't match and the body stays intact — fail-open behavior.
- *
- * Exported for direct unit testing.
- */
-export declare function stripHeredocBodies(s: string): string;
-/**
- * Decide the final exit code + message from a list of hits.
- *
- * - Any "block" hit → exit 2 with all blocking messages
- * - Only "warn" hits → exit 0, print warnings to stderr
- * - No hits → exit 0 silently
- *
- * Emergency bypass: `OPENSQUID_SKIP_DRIFT=1` downgrades every block to
- * an audit-trail warning (exit 0, stderr explains the bypass). Two ways
- * to set it:
- *
- *   1. Parent process env — useful for whole-session bypass (e.g. set
- *      before launching Claude Code).
- *   2. Inline command prefix — e.g. `OPENSQUID_SKIP_DRIFT=1 git push`.
- *      The hook reads the COMMAND STRING from the Bash tool input and
- *      sees the prefix even though the env var never reaches the hook's
- *      own process.env (the hook is a sibling subprocess spawned by
- *      Claude Code, not a child of the would-be Bash subprocess).
- *
- * Matches the shape of the version-gate (`OPENSQUID_SKIP_VERSION_GATE=1`)
- * and workflow-gate (`OPENSQUID_SKIP_WORKFLOW_GATE=1`) bypasses so the
- * operator only has one mental model — except those two only check
- * process.env (their hooks happen before any command runs); drift-
- * patterns additionally checks the command-string prefix so the bypass
- * can be requested per-command from within an existing session.
- */
-export declare function decide(hits: DriftHit[], call?: ToolCallInput): {
-    exit: 0 | 2;
-    stderr: string;
-};
-//# sourceMappingURL=drift-patterns.d.ts.map

package/dist/hooks/drift-patterns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"drift-patterns.d.ts","sourceRoot":"","sources":["../../src.legacy/hooks/drift-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX;;;kCAG8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,OAAO,EAAE,YAAY,CAAC;IACtB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAM3D,eAAO,MAAM,cAAc,EAAE,YAAY,EA4GxC,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,EAAE,CAS1D;AA4DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpD;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,QAAQ,EAAE,EAChB,IAAI,CAAC,EAAE,aAAa,GACnB;IACD,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAsBA"}