opensquid 0.5.395

package/dist/functions/verdict.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Verdict + action-descriptor primitives.
+ *
+ * Four primitives, registered as one batch via `registerVerdictFunctions`:
+ *
+ *   verdict                  — terminal rule output. The evaluator (Task 1.3)
+ *                              special-cases `step.call === 'verdict'` and
+ *                              treats `ok({ level, message })` as the rule's
+ *                              final RuleResult. This primitive is the only
+ *                              way a rule produces a `Verdict`.
+ *   halt_task                — emits a `{ kind: 'halt', reason }` action
+ *                              descriptor. The hook layer (Task 1.7) reads
+ *                              the descriptor and actually halts the host
+ *                              session — this primitive never side-effects.
+ *   restart_workflow         — emits `{ kind: 'restart', entrySkill }`.
+ *                              snake-case YAML arg `entry_skill` → camelCase
+ *                              field `entrySkill` (opensquid convention).
+ *   set_active_task_state    — emits `{ kind: 'state_set', state }`. Does
+ *                              NOT write to disk — that requires composing
+ *                              `write_state` (Task 1.4) in a separate step.
+ *                              Splitting "declare intent" from "do the write"
+ *                              keeps the audit trail explicit.
+ *
+ * `require-await` disable: same rationale as `event.ts`. The
+ * `FunctionDef.execute` contract is `Promise<Result<...>>` but these four
+ * primitives are pure — no awaitable work. `async` wraps the return value
+ * in a Promise to satisfy the contract.
+ *
+ * Per `docs/opensquid-real-design.md` §"Required runtime primitives".
+ * `auto_correct` and `escalate` policies are deferred per Task 1.6 spec —
+ * they need primitives that don't ship in Phase 1 (auto-correction loop +
+ * escalation routing).
+ *
+ * Imports from: zod, ../runtime/result.js, ./registry.js.
+ * Imported by: src/functions/index.ts (registry wiring).
+ */
+import type { FunctionRegistry } from './registry.js';
+export declare function registerVerdictFunctions(registry: FunctionRegistry): void;
+//# sourceMappingURL=verdict.d.ts.map

package/dist/functions/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/functions/verdict.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA4BtD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CA6CzE"}

package/dist/functions/verdict.js

@@ -0,0 +1,105 @@
+/* eslint-disable @typescript-eslint/require-await */
+/**
+ * Verdict + action-descriptor primitives.
+ *
+ * Four primitives, registered as one batch via `registerVerdictFunctions`:
+ *
+ *   verdict                  — terminal rule output. The evaluator (Task 1.3)
+ *                              special-cases `step.call === 'verdict'` and
+ *                              treats `ok({ level, message })` as the rule's
+ *                              final RuleResult. This primitive is the only
+ *                              way a rule produces a `Verdict`.
+ *   halt_task                — emits a `{ kind: 'halt', reason }` action
+ *                              descriptor. The hook layer (Task 1.7) reads
+ *                              the descriptor and actually halts the host
+ *                              session — this primitive never side-effects.
+ *   restart_workflow         — emits `{ kind: 'restart', entrySkill }`.
+ *                              snake-case YAML arg `entry_skill` → camelCase
+ *                              field `entrySkill` (opensquid convention).
+ *   set_active_task_state    — emits `{ kind: 'state_set', state }`. Does
+ *                              NOT write to disk — that requires composing
+ *                              `write_state` (Task 1.4) in a separate step.
+ *                              Splitting "declare intent" from "do the write"
+ *                              keeps the audit trail explicit.
+ *
+ * `require-await` disable: same rationale as `event.ts`. The
+ * `FunctionDef.execute` contract is `Promise<Result<...>>` but these four
+ * primitives are pure — no awaitable work. `async` wraps the return value
+ * in a Promise to satisfy the contract.
+ *
+ * Per `docs/opensquid-real-design.md` §"Required runtime primitives".
+ * `auto_correct` and `escalate` policies are deferred per Task 1.6 spec —
+ * they need primitives that don't ship in Phase 1 (auto-correction loop +
+ * escalation routing).
+ *
+ * Imports from: zod, ../runtime/result.js, ./registry.js.
+ * Imported by: src/functions/index.ts (registry wiring).
+ */
+import { z } from 'zod';
+import { ok } from '../runtime/result.js';
+// ---------------------------------------------------------------------------
+// Zod arg schemas — `.strict()` rejects unexpected YAML keys at registry-call
+// time so typos surface as `arg_invalid` instead of silently dropping fields.
+//
+// T-ASC ASC.3: VerdictArgs becomes a discriminated union on `level` mirroring
+// the runtime Verdict schema (runtime/types.ts). The 4 message-bearing
+// levels keep `message: string`; the new `directive` level carries
+// `next_action: NextAction` instead. The shape stays in sync with
+// runtime/types.ts's Verdict via the imported NextAction schema — both
+// definitions parse the same wire representation.
+// ---------------------------------------------------------------------------
+import { NextAction } from '../runtime/types.js';
+const VerdictArgs = z.discriminatedUnion('level', [
+    z.object({ level: z.literal('pass'), message: z.string() }).strict(),
+    z.object({ level: z.literal('block'), message: z.string() }).strict(),
+    z.object({ level: z.literal('warn'), message: z.string() }).strict(),
+    z.object({ level: z.literal('surface'), message: z.string() }).strict(),
+    z.object({ level: z.literal('directive'), next_action: NextAction }).strict(),
+]);
+const HaltTaskArgs = z.object({ reason: z.string() }).strict();
+const RestartWorkflowArgs = z.object({ entry_skill: z.string() }).strict();
+const SetActiveTaskStateArgs = z.object({ state: z.string() }).strict();
+export function registerVerdictFunctions(registry) {
+    // DURABLE.2 — every primitive in this file is a pure object builder (no
+    // I/O, no LLM, no shell). Sub-microsecond cost; checkpointing them would
+    // be a net loss. None are memoizable because the input → output mapping
+    // is so trivial there's nothing to cache that wouldn't be re-computed
+    // faster than a cache lookup.
+    registry.register({
+        name: 'verdict',
+        argSchema: VerdictArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 0.1,
+        // T-ASC ASC.3: re-emit the parsed args as-is. The evaluator's verdict-
+        // primitive special-case (evaluator.ts) routes by `level`: directive
+        // values become a `kind: 'directive'` RuleResult, every other level
+        // becomes a `kind: 'verdict'` RuleResult.
+        execute: async (args) => ok(args),
+    });
+    registry.register({
+        name: 'halt_task',
+        argSchema: HaltTaskArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 0.1,
+        execute: async ({ reason }) => ok({ kind: 'halt', reason }),
+    });
+    registry.register({
+        name: 'restart_workflow',
+        argSchema: RestartWorkflowArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 0.1,
+        execute: async ({ entry_skill }) => ok({ kind: 'restart', entrySkill: entry_skill }),
+    });
+    registry.register({
+        name: 'set_active_task_state',
+        argSchema: SetActiveTaskStateArgs,
+        durable: false,
+        memoizable: false,
+        costEstimateMs: 0.1,
+        execute: async ({ state }) => ok({ kind: 'state_set', state }),
+    });
+}
+//# sourceMappingURL=verdict.js.map

package/dist/functions/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/functions/verdict.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAI1C,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,mEAAmE;AACnE,kEAAkE;AAClE,uEAAuE;AACvE,kDAAkD;AAClD,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IAChD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACpE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACrE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACpE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACvE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CAC9E,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC/D,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3E,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAExE,MAAM,UAAU,wBAAwB,CAAC,QAA0B;IACjE,wEAAwE;IACxE,yEAAyE;IACzE,wEAAwE;IACxE,sEAAsE;IACtE,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG;QACnB,uEAAuE;QACvE,qEAAqE;QACrE,oEAAoE;QACpE,0CAA0C;QAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;KAClC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,YAAY;QACvB,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,CAAC;KACrE,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,mBAAmB;QAC9B,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;KAC9F,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,IAAI,EAAE,uBAAuB;QAC7B,SAAS,EAAE,sBAAsB;QACjC,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,KAAK,EAAE,CAAC;KACxE,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,68 @@
+/**
+ * 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.
+ */
+export type DriftMarkerKind = "user_correction" | "rule_citation" | "mea_culpa";
+export interface DriftCatalogEntry {
+    /** ISO timestamp the entry was recorded. */
+    timestamp: string;
+    /** Claude Code session id. */
+    session_id: string;
+    /** Which class of marker fired. */
+    kind: DriftMarkerKind;
+    /** The matched substring (capped at 200 chars). */
+    evidence: string;
+    /** Optional surrounding context (up to 200 chars on either side). */
+    context?: string;
+}
+/**
+ * Scan a transcript and return all detected drift markers. Pure
+ * function; exported for direct testing.
+ */
+export declare function scanTranscriptForDrift(lines: string[], sessionId: string, now?: () => Date): DriftCatalogEntry[];
+/**
+ * Run the SessionEnd drift-catalog scan + persist results. Returns
+ * the number of entries written (0 if nothing matched OR write failed).
+ */
+export declare function runDriftCatalogScan(input: {
+    sessionId: string;
+    transcriptPath?: string;
+    cwd?: string;
+    dataRoot?: string;
+    now?: () => Date;
+}): Promise<number>;
+/**
+ * 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 declare function resolveCatalogPath(cwd: string | undefined, sessionId: string, dataRoot?: string): Promise<string>;
+//# sourceMappingURL=drift-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift-catalog.d.ts","sourceRoot":"","sources":["../../src.legacy/hooks/drift-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,eAAe,GAAG,WAAW,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiCD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,IAAuB,GACjC,iBAAiB,EAAE,CAmBrB;AA0BD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBlB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/hooks/drift-catalog.js

@@ -0,0 +1,184 @@
+/**
+ * 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

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

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

@@ -0,0 +1,154 @@
+/**
+ * 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 });
+        }
+    });
+});