@jmtrin/opencode-kevin 0.1.5 → 0.3.0

package/dist/plugin/Migrate.js

@@ -1,11 +1,47 @@
 import { readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+// Built-in post-apply hooks, keyed by migration version. Each hook runs inside
+// the same transaction as the migration's DDL, so a hook failure rolls back the
+// whole migration. Hooks are only invoked when their version is being applied
+// (i.e., not already present in schema_version).
+const DEFAULT_POST_APPLY_HOOKS = {
+    // v0.2.0 Signal Quality: defensive backfill of memories.origin for legacy
+    // rows. The column is NOT NULL DEFAULT 'agent', so SQLite already populates
+    // pre-existing rows with 'agent' on ALTER TABLE. This hook is a belt-and-
+    // braces UPDATE that coerces any NULL/empty stragglers (which would only
+    // exist if a partial DB skipped the DEFAULT) back to 'agent'.
+    "003": (store) => {
+        store
+            .prepare("UPDATE memories SET origin = 'agent' WHERE origin IS NULL OR origin = ''")
+            .run();
+    },
+    // v0.3.0 Knowledge + Causality: backfill evidence_count and status for
+    // legacy rows. Columns have NOT NULL DEFAULT, so SQLite already populates
+    // pre-existing rows. This hook is belt-and-braces in case a partial DB
+    // skipped the defaults.
+    "004": (store) => {
+        store
+            .prepare("UPDATE memories SET evidence_count = 0 WHERE evidence_count IS NULL")
+            .run();
+        store
+            .prepare("UPDATE memories SET status = 'active' WHERE status IS NULL OR status = ''")
+            .run();
+    },
+};
 export class Migrate {
     store;
     migrationsDir;
-    constructor(store, migrationsDir) {
+    postApplyHooks;
+    constructor(store, migrationsDir, postApplyHooks) {
         this.store = store;
         this.migrationsDir = migrationsDir;
+        this.postApplyHooks = new Map(Object.entries({
+            ...DEFAULT_POST_APPLY_HOOKS,
+            ...(postApplyHooks ?? {}),
+        }));
+    }
+    registerPostApply(version, hook) {
+        this.postApplyHooks.set(version, hook);
     }
     async run() {
         this.store.exec(`CREATE TABLE IF NOT EXISTS schema_version (
@@ -25,6 +61,9 @@ export class Migrate {
             const sql = readFileSync(join(this.migrationsDir, migration.file), "utf8");
             this.store.transaction(() => {
                 this.store.exec(sql);
+                const hook = this.postApplyHooks.get(migration.version);
+                if (hook)
+                    hook(this.store);
                 insertVersion.run(migration.version);
             });
         }

package/dist/plugin/Migrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"Migrate.js","sourceRoot":"","sources":["../../plugin/Migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,OAAO,OAAO;IAEV;IACA;IAFT,YACS,KAAY,EACZ,aAAqB;QADrB,UAAK,GAAL,KAAK,CAAO;QACZ,kBAAa,GAAb,aAAa,CAAQ;IAC3B,CAAC;IAEJ,KAAK,CAAC,GAAG;QACR,IAAI,CAAC,KAAK,CAAC,IAAI,CACd;;;UAGO,CACP,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK;aAC3B,OAAO,CACP,kEAAkE,CAClE;aACA,GAAG,EAAqC,CAAC;QAE3C,MAAM,IAAI,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CACvC,2DAA2D,CAC3D,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,YAAY,CACvB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,EACxC,MAAM,CACN,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO;YACN,IAAI;YACJ,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO;YACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACtC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAe;QAClC,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACJ,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,KAAK;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC,CAAC;aACD,MAAM,CACN,CAAC,CAAC,EAA0C,EAAE,CAC7C,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAClC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"Migrate.js","sourceRoot":"","sources":["../../plugin/Migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,iDAAiD;AACjD,MAAM,wBAAwB,GAAkC;IAC/D,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,8DAA8D;IAC9D,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QAChB,KAAK;aACH,OAAO,CACP,0EAA0E,CAC1E;aACA,GAAG,EAAE,CAAC;IACT,CAAC;IACD,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,wBAAwB;IACxB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QAChB,KAAK;aACH,OAAO,CACP,qEAAqE,CACrE;aACA,GAAG,EAAE,CAAC;QACR,KAAK;aACH,OAAO,CACP,2EAA2E,CAC3E;aACA,GAAG,EAAE,CAAC;IACT,CAAC;CACD,CAAC;AAEF,MAAM,OAAO,OAAO;IAIV;IACA;IAJQ,cAAc,CAA6B;IAE5D,YACS,KAAY,EACZ,aAAqB,EAC7B,cAA8C;QAFtC,UAAK,GAAL,KAAK,CAAO;QACZ,kBAAa,GAAb,aAAa,CAAQ;QAG7B,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAC5B,MAAM,CAAC,OAAO,CAAC;YACd,GAAG,wBAAwB;YAC3B,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;SACzB,CAAC,CACF,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,OAAe,EAAE,IAAmB;QACrD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG;QACR,IAAI,CAAC,KAAK,CAAC,IAAI,CACd;;;UAGO,CACP,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK;aAC3B,OAAO,CACP,kEAAkE,CAClE;aACA,GAAG,EAAqC,CAAC;QAE3C,MAAM,IAAI,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CACvC,2DAA2D,CAC3D,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,YAAY,CACvB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,EACxC,MAAM,CACN,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACxD,IAAI,IAAI;oBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO;YACN,IAAI;YACJ,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO;YACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACtC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAe;QAClC,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACJ,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,KAAK;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC,CAAC;aACD,MAAM,CACN,CAAC,CAAC,EAA0C,EAAE,CAC7C,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAClC,CAAC;IACJ,CAAC;CACD"}

package/dist/plugin/PatternMiner.d.ts

@@ -0,0 +1,49 @@
+import type { MemoryService } from "./MemoryService.js";
+import type { Store } from "./Store.js";
+import type { Metrics } from "./metrics.js";
+/**
+ * v0.2.0 PatternMiner (K2-021, plan §B6.10 / D2-08).
+ *
+ * Opt-in deterministic pattern miner. Reads recent `tool_calls` for a given
+ * project, groups consecutive ordered 2-grams of `(tool_name)` and 3-grams
+ * where the *middle* tool was a failure, and when a group reaches the
+ * threshold (default `N ≥ 5` distinct sessions), emits a single
+ * `type='pattern'`, `origin='pattern'` memory describing the pattern.
+ *
+ * Default OFF — must be enabled by setting `kevin_settings.patternminer_enabled`
+ * to `'1'`. Idempotent via SELECT-before-INSERT keyed on
+ * `(project_id, fingerprint, type='pattern', origin='pattern')`. Migration 003's
+ * partial UNIQUE index only covers `type='error' AND origin='reflector'`, so
+ * pattern memories cannot rely on a database uniqueness constraint — the
+ * SELECT check inside `mine()` is the single idempotency mechanism.
+ *
+ * NO LLM hop (D2-08). The emitted suggestion is a deterministic template built
+ * from the captured tool names.
+ */
+export interface PatternMinerOptions {
+    /** Minimum distinct sessions a pattern must appear in before emission.
+     * Default 5 (D2-08). */
+    threshold?: number;
+}
+export declare class PatternMiner {
+    private readonly store;
+    private readonly memoryService;
+    private readonly metrics;
+    private readonly threshold;
+    constructor(store: Store, memoryService: MemoryService, metrics?: Metrics | null, options?: PatternMinerOptions);
+    /**
+     * Mine patterns observed in `tool_calls` for the given project. Returns the
+     * number of NEW `pattern` memories emitted this cycle.
+     *
+     * When the opt-in flag `kevin_settings.patternminer_enabled` is not set to
+     * `'1'` (default), this is a no-op and returns 0.
+     *
+     * When `projectId` is null/undefined, mines tool_calls whose `project_id`
+     * IS NULL (legacy / opt-out flow). When `projectId` is a string, mines
+     * tool_calls scoped to that project only.
+     */
+    mine(projectId?: string | null): number;
+    private isEnabled;
+    private fetchToolCalls;
+    private collectCandidates;
+}

package/dist/plugin/PatternMiner.js

@@ -0,0 +1,133 @@
+import { fingerprint as computeFingerprint } from "./fingerprint.js";
+const DEFAULT_THRESHOLD = 5;
+const SETTING_KEY = "patternminer_enabled";
+export class PatternMiner {
+    store;
+    memoryService;
+    metrics;
+    threshold;
+    constructor(store, memoryService, metrics, options) {
+        this.store = store;
+        this.memoryService = memoryService;
+        this.metrics = metrics ?? null;
+        this.threshold = options?.threshold ?? DEFAULT_THRESHOLD;
+    }
+    /**
+     * Mine patterns observed in `tool_calls` for the given project. Returns the
+     * number of NEW `pattern` memories emitted this cycle.
+     *
+     * When the opt-in flag `kevin_settings.patternminer_enabled` is not set to
+     * `'1'` (default), this is a no-op and returns 0.
+     *
+     * When `projectId` is null/undefined, mines tool_calls whose `project_id`
+     * IS NULL (legacy / opt-out flow). When `projectId` is a string, mines
+     * tool_calls scoped to that project only.
+     */
+    mine(projectId) {
+        if (!this.isEnabled())
+            return 0;
+        const rows = this.fetchToolCalls(projectId ?? null);
+        if (rows.length === 0)
+            return 0;
+        const candidates = this.collectCandidates(rows);
+        if (candidates.length === 0)
+            return 0;
+        let emitted = 0;
+        for (const c of candidates) {
+            if (c.sessions.size < this.threshold)
+                continue;
+            const fp = computeFingerprint(c.content, projectId ?? undefined);
+            // Idempotency: migration 003's partial unique only covers
+            // (type='error', origin='reflector'). For pattern memories we
+            // SELECT to detect a prior emission with the same
+            // (project_id, fingerprint, type='pattern', origin='pattern').
+            const existing = this.store
+                .prepare(`SELECT id FROM memories
+					 WHERE type = 'pattern' AND origin = 'pattern'
+					   AND fingerprint = ?
+					   AND (project_id IS ? OR (project_id IS NULL AND ? IS NULL))
+					 LIMIT 1`)
+                .get(fp, projectId ?? null, projectId ?? null);
+            if (existing)
+                continue;
+            this.memoryService.save({
+                type: "pattern",
+                origin: "pattern",
+                fingerprint: fp,
+                content: c.content,
+                scope: "project",
+                projectId: projectId ?? undefined,
+                relevanceScore: 0.5,
+                sourceTool: "PatternMiner",
+            });
+            this.metrics?.incr("patterns_mined", 1);
+            emitted += 1;
+        }
+        return emitted;
+    }
+    isEnabled() {
+        const row = this.store
+            .prepare("SELECT value FROM kevin_settings WHERE key = ?")
+            .get(SETTING_KEY);
+        return row?.value === "1";
+    }
+    fetchToolCalls(projectId) {
+        const nullPid = projectId === null || projectId === undefined;
+        const sql = nullPid
+            ? `SELECT id, session_id, ts, tool, success FROM tool_calls
+			   WHERE project_id IS NULL
+			   ORDER BY session_id ASC, ts ASC`
+            : `SELECT id, session_id, ts, tool, success FROM tool_calls
+			   WHERE project_id = ?
+			   ORDER BY session_id ASC, ts ASC`;
+        const stmt = this.store.prepare(sql);
+        const rows = (nullPid ? stmt.all() : stmt.all(projectId));
+        return rows;
+    }
+    collectCandidates(rows) {
+        // Group rows by session_id preserving arrival order. The SQL already
+        // orders by (session_id ASC, ts ASC), so a sequential scan yields each
+        // session's tool_calls in execution order.
+        const bySession = new Map();
+        for (const r of rows) {
+            let list = bySession.get(r.session_id);
+            if (!list) {
+                list = [];
+                bySession.set(r.session_id, list);
+            }
+            list.push(r);
+        }
+        // 2-grams: ordered pair (a, b) of consecutive tool names per session.
+        // 3-grams: ordered triple (a, b, c) where the middle tool b failed
+        // (success = 0). These capture the "X→Y fails then Z" lifecycle that
+        // the plan §B6.10 calls out.
+        const map = new Map();
+        const record = (key, content, sessionId) => {
+            let cand = map.get(key);
+            if (!cand) {
+                cand = { key, content, sessions: new Set() };
+                map.set(key, cand);
+            }
+            cand.sessions.add(sessionId);
+        };
+        for (const [sessionId, list] of bySession) {
+            for (let i = 0; i < list.length - 1; i++) {
+                const a = list[i];
+                const b = list[i + 1];
+                const key2 = `2g::${a.tool}::${b.tool}`;
+                const content2 = `Pattern: tool "${a.tool}" followed by tool "${b.tool}". Review the ${a.tool}→${b.tool} contract before retrying.`;
+                record(key2, content2, sessionId);
+                if (i + 2 < list.length) {
+                    const c = list[i + 2];
+                    if (b.success === 0) {
+                        const key3 = `3g::${a.tool}::${b.tool}::${c.tool}`;
+                        const content3 = `Pattern: tool "${a.tool}" followed by failing tool "${b.tool}" then tool "${c.tool}". Review the ${a.tool}→${b.tool}(failed)→${c.tool} contract before retrying.`;
+                        record(key3, content3, sessionId);
+                    }
+                }
+            }
+        }
+        return Array.from(map.values());
+    }
+}
+//# sourceMappingURL=PatternMiner.js.map

package/dist/plugin/PatternMiner.js.map

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

package/dist/plugin/Reflector.d.ts

@@ -1,4 +1,5 @@
 import type { MemoryService } from "./MemoryService.js";
+import type { Metrics } from "./metrics.js";
 export interface ReflectionInput {
     toolName: string;
     argsSummary: string;
@@ -7,24 +8,66 @@ export interface ReflectionInput {
     exitCode?: number;
     errorType: string;
     sessionId: string;
+    /** Optional project scope for v0.2.0 dedup + per-fingerprint throttle. */
+    projectId?: string | null;
+    /** v0.3.0 fix — callID of the failing tool_call. Used by onLinkError
+     * (see ReflectorOptions) to stamp tool_calls.error_fingerprint so the
+     * feedback loop can match recurrences by the SAME identity dimension
+     * the error memory uses. */
+    callID?: string;
 }
 export interface ReflectorOptions {
     throttleMs?: number;
+    /** v0.3.0 (K3-018) — optional LLM enrichment callback. Default no-op. */
+    enrich?: (lesson: string, stderr: string, stdout: string) => Promise<string | null>;
+    /** v0.3.0 fix — link a failing tool_call to the stderr-based fingerprint
+     * the matching error memory uses. Default no-op. The caller (index.ts)
+     * provides an implementation that UPDATEs tool_calls.error_fingerprint
+     * for the given callID, so boost/penalize feedback queries stop missing
+     * recurrences by fingerprint mismatch. */
+    onLinkError?: (callID: string, fingerprint: string) => void;
 }
 export interface HeuristicLessonInput {
     toolName: string;
     errorType: string;
     firstErrorLine: string;
+    /** v0.2.0 (K2-018) — optional pre-computed dispatch result. When absent,
+     * dispatch is performed on `firstErrorLine` alone. */
+    dispatched?: DispatchedLesson | null;
+}
+/** Result of the per-error-code deterministic rule dispatch (K2-018 / D2-09). */
+export interface DispatchedLesson {
+    /** Stable short code captured from the source output (e.g. `TS2304`,
+     * `EADDRINUSE`, `F401`, the captured `Error: <Name>` class, the failing
+     * command string). `null` when no rule matches (fallback path). */
+    code: string | null;
+    /** Short deterministic hint, e.g. `import or typo`, `review syscall:
+     * EADDRINUSE`. `null` when `code` is null (the v0.1.x fallback path). */
+    hint: string | null;
 }
 export declare const ERROR_LINE_RE: RegExp;
 export declare const STRONG_ERROR_RE: RegExp;
+export declare const TS_CODE_RULES: Record<string, string>;
 export declare class Reflector {
     private memoryService;
-    private lastReflectionTs;
+    private lastReflectionByFp;
     private throttleMs;
-    constructor(memoryService: MemoryService, options?: ReflectorOptions);
+    private metrics;
+    private enrichFn;
+    private onLinkErrorFn;
+    constructor(memoryService: MemoryService, options?: ReflectorOptions, metrics?: Metrics | null);
     invoke(input: ReflectionInput): Promise<string | null>;
     generateHeuristicLesson(input: HeuristicLessonInput): string;
+    /**
+     * v0.2.0 (K2-018 / D2-09) — deterministic per-error-code rule dispatch.
+     * Pure regex sweep over `stderr + '\n' + stdout` with NO LLM hop. Returns
+     * a short stable `code` + `hint` pair when a known rule matches, or
+     * `{ code: null, hint: null }` for the v0.1.x fallback path (which keeps
+     * the v0.1.x `SUGGESTIONS[errorType]` suggestion verbatim).
+     *
+     * Exported for unit testing (K2-019).
+     */
+    dispatchLesson(stderr: string, stdout: string, errorType: string): DispatchedLesson;
     redactPaths(text: string): string;
     redactSecrets(text: string): string;
     private extractFirstErrorLine;

package/dist/plugin/Reflector.js

@@ -1,3 +1,4 @@
+import { fingerprint as computeFingerprint } from "./fingerprint.js";
 import { redactPaths as redactPathsText } from "./redact.js";
 const DEFAULT_THROTTLE_MS = 60_000;
 const MAX_CONTENT_CHARS = 4096;
@@ -6,6 +7,12 @@ const TRUNC_SUFFIX = "... [truncated]";
 const CONTEXT_PREFIX = "\n\nContext:\n";
 export const ERROR_LINE_RE = /\b(error|failed|fail|cannot find|cannot resolve|TS\d{4,}|exception|traceback|panic|fatal|referenceerror|typeerror|syntaxerror|command failed|non-zero exit)\b/i;
 export const STRONG_ERROR_RE = /\b(cannot find|cannot resolve|TS\d{4,}|error TS\d|command failed|non-zero exit|exit code [1-9]\d*|traceback|referenceerror|typeerror|syntaxerror|fatal error|exception|failed to compile|build failed|compilation failed)\b/i;
+/** v0.1.x fallback table — keyed by `errorType`. RETAINED in v0.2.0 as the
+ * fallback for memos whose output does not match a deterministic code rule.
+ * The v0.2.0 per-error-code rule table below layers ON TOP of this fallback:
+ * when a code is matched, the hint is appended to the v0.1.x suggestion as a
+ * 'Likely cause:' line; when no code is matched, output is identical to v0.1.x.
+ */
 const SUGGESTIONS = {
     typecheck: "Verify types and imports before running.",
     lint: "Run linter and fix warnings before committing.",
@@ -14,6 +21,25 @@ const SUGGESTIONS = {
     timeout: "Check for infinite loops or long-running operations.",
     unknown: "Review the error output for details.",
 };
+// --- v0.2.0 (K2-018) lesson v2 — per-error-code deterministic dispatch (D2-09).
+// Pure TS, NO LLM hop. Order of dispatch matches the plan §B6.4 priority list:
+// (1) TS\d{4,5} > (2) Python lint > (3) syscall > (4) generic `Error: <Name>` >
+// (5) `Command "<cmd>" failed` > (6) v0.1.x SUGGESTIONS fallback.
+// v0.2.0 (K2-018) — shared per-error-code rule table. Exported so
+// kevin_why.ts reuses the SAME hints instead of duplicating them
+// (bug #6).
+export const TS_CODE_RULES = {
+    "2304": "import or typo",
+    "2322": "type mismatch",
+    "2740": "missing or wrong property",
+    "2552": "undefined identifier",
+    "18047": "possibly null",
+};
+const TS_CODE_RE = /\bTS(\d{4,5})\b/;
+const PY_LINT_RE = /\b(ELIF\d{0,4})\b|\b(F\d{3,4})\b|flake8:\s+(\S+)/;
+const SYSCALL_RE = /\b(EADDRINUSE|ENOENT|EACCES|EPERM)\b/;
+const GENERIC_ERROR_RE = /\bError:\s+(\w+)/;
+const COMMAND_FAILED_RE = /Command\s+"([^"]+)"\s+failed/;
 const SECRET_PATTERNS = [
     /(API_KEY|SECRET|PASSWORD|TOKEN)\s*[=:]\s*\S+/gi,
     /\bBearer\s+\S+/gi,
@@ -23,18 +49,20 @@ const SECRET_VALUE_PATTERN = /\s*=\s*\S+(.*)$/;
 const PATH_PATTERNS_DEPRECATED = null;
 export class Reflector {
     memoryService;
-    lastReflectionTs = 0;
+    lastReflectionByFp = new Map();
     throttleMs;
-    constructor(memoryService, options) {
+    metrics;
+    enrichFn;
+    onLinkErrorFn;
+    constructor(memoryService, options, metrics) {
         this.memoryService = memoryService;
         this.throttleMs = options?.throttleMs ?? DEFAULT_THROTTLE_MS;
+        this.metrics = metrics ?? null;
+        this.enrichFn = options?.enrich ?? (async () => null);
+        this.onLinkErrorFn = options?.onLinkError ?? (() => { });
     }
     async invoke(input) {
         const now = Date.now();
-        if (now - this.lastReflectionTs < this.throttleMs) {
-            return null;
-        }
-        this.lastReflectionTs = now;
         const redactedStderr = this.redactSecrets(this.redactPaths(input.stderr));
         const redactedStdout = this.redactSecrets(this.redactPaths(input.stdout));
         const sourceOutput = redactedStderr.length > 0 ? redactedStderr : redactedStdout;
@@ -43,27 +71,60 @@ export class Reflector {
             toolName: input.toolName,
             errorType: input.errorType,
             firstErrorLine,
+            dispatched: this.dispatchLesson(redactedStderr, redactedStdout, input.errorType),
         });
+        // v0.3.0 fix (bug #5) — the per-fingerprint throttle check runs
+        // BEFORE the optional LLM enrichment, so throttled repeats never
+        // waste an LLM call. The fingerprint is computed from the source
+        // output when present, otherwise from the PRE-enrichment lesson,
+        // keeping the identity stable and identical to the saved memory's.
+        const projectId = input.projectId ?? null;
+        const fpContent = sourceOutput.length > 0 ? sourceOutput : lesson;
+        const fp = computeFingerprint(fpContent, projectId ?? undefined);
+        const last = this.lastReflectionByFp.get(fp) ?? 0;
+        if (now - last < this.throttleMs) {
+            this.metrics?.incr("reflections_throttled", 1);
+            return null;
+        }
+        this.lastReflectionByFp.set(fp, now);
+        // v0.3.0 (K3-018): optional LLM enrichment opt-in. Runs only when
+        // the throttle check passed (bug #5).
+        let enrichedLesson = lesson;
+        try {
+            const enrichment = await this.enrichFn(lesson, redactedStderr, redactedStdout);
+            if (enrichment) {
+                enrichedLesson = `${lesson}\n${enrichment}`;
+            }
+        }
+        catch {
+            // enrichment failures are non-blocking
+        }
         const metadata = {};
+        if (input.callID) {
+            metadata.origin_call_id = input.callID;
+        }
         let finalContent;
         if (sourceOutput.length > 0) {
-            const fullLen = lesson.length + CONTEXT_PREFIX.length + sourceOutput.length;
+            const fullLen = enrichedLesson.length + CONTEXT_PREFIX.length + sourceOutput.length;
             if (fullLen <= MAX_CONTENT_CHARS) {
-                finalContent = `${lesson}${CONTEXT_PREFIX}${sourceOutput}`;
+                finalContent = `${enrichedLesson}${CONTEXT_PREFIX}${sourceOutput}`;
             }
             else {
                 const budget = MAX_CONTENT_CHARS -
-                    lesson.length -
+                    enrichedLesson.length -
                     CONTEXT_PREFIX.length -
                     TRUNC_SUFFIX.length;
                 const truncated = sourceOutput.slice(0, Math.max(0, budget));
-                finalContent = `${lesson}${CONTEXT_PREFIX}${truncated}${TRUNC_SUFFIX}`;
+                finalContent = `${enrichedLesson}${CONTEXT_PREFIX}${truncated}${TRUNC_SUFFIX}`;
                 metadata.truncated = true;
             }
         }
         else {
-            finalContent = lesson;
+            finalContent = enrichedLesson;
         }
+        // K2-007: the per-fingerprint throttle check ran above (before
+        // enrichment); `fp` is reused here so dedup/throttle and the saved
+        // memory agree on identity.
         const id = this.memoryService.save({
             type: "error",
             content: finalContent,
@@ -71,15 +132,76 @@ export class Reflector {
             sourceTool: input.toolName,
             sourceSession: input.sessionId,
             metadata,
+            origin: "reflector",
+            projectId: projectId ?? undefined,
+            fingerprint: fp,
         });
+        // v0.3.0 fix — stamp the failing tool_call with the stderr-based
+        // fingerprint so the feedback loop's recurrence queries can match
+        // it (closes the fingerprint-mismatch bug). Fires even after the
+        // dedup path returned an existing memory id, since the current
+        // call IS a new occurrence of the same error.
+        if (input.callID && this.onLinkErrorFn) {
+            try {
+                this.onLinkErrorFn(input.callID, fp);
+            }
+            catch {
+                // linking failure is non-blocking
+            }
+        }
         return id;
     }
     generateHeuristicLesson(input) {
+        const dispatched = input.dispatched ??
+            this.dispatchLesson(input.firstErrorLine, "", input.errorType);
         const suggestion = SUGGESTIONS[input.errorType] ?? SUGGESTIONS.unknown;
         const line = input.firstErrorLine.length > MAX_ERROR_LINE_CHARS
             ? `${input.firstErrorLine.slice(0, MAX_ERROR_LINE_CHARS)}...`
             : input.firstErrorLine;
-        return `When ${input.toolName} fails with ${input.errorType}: ${line}\nSuggestion: ${suggestion}`;
+        let lesson = `When ${input.toolName} fails with ${input.errorType}: ${line}\nSuggestion: ${suggestion}`;
+        if (dispatched.code && dispatched.hint) {
+            lesson += `\nLikely cause: ${dispatched.hint} (code ${dispatched.code})`;
+        }
+        return lesson;
+    }
+    /**
+     * v0.2.0 (K2-018 / D2-09) — deterministic per-error-code rule dispatch.
+     * Pure regex sweep over `stderr + '\n' + stdout` with NO LLM hop. Returns
+     * a short stable `code` + `hint` pair when a known rule matches, or
+     * `{ code: null, hint: null }` for the v0.1.x fallback path (which keeps
+     * the v0.1.x `SUGGESTIONS[errorType]` suggestion verbatim).
+     *
+     * Exported for unit testing (K2-019).
+     */
+    dispatchLesson(stderr, stdout, errorType) {
+        const combined = `${stderr}\n${stdout}`;
+        const tsMatch = combined.match(TS_CODE_RE);
+        if (tsMatch) {
+            const num = tsMatch[1];
+            const hint = TS_CODE_RULES[num] ?? `review TS${num}`;
+            return { code: `TS${num}`, hint };
+        }
+        const pyMatch = combined.match(PY_LINT_RE);
+        if (pyMatch) {
+            const rule = pyMatch[1] || pyMatch[2] || pyMatch[3] || "unknown";
+            return { code: rule, hint: `review python lint: ${rule}` };
+        }
+        const sysMatch = combined.match(SYSCALL_RE);
+        if (sysMatch) {
+            const code = sysMatch[1];
+            return { code, hint: `review syscall: ${code}` };
+        }
+        const errMatch = combined.match(GENERIC_ERROR_RE);
+        if (errMatch) {
+            const name = errMatch[1];
+            return { code: name, hint: `review error class: ${name}` };
+        }
+        const cmdMatch = combined.match(COMMAND_FAILED_RE);
+        if (cmdMatch) {
+            const cmd = cmdMatch[1];
+            return { code: cmd, hint: `review failing command: ${cmd}` };
+        }
+        return { code: null, hint: null };
     }
     redactPaths(text) {
         return redactPathsText(text);

package/dist/plugin/Reflector.js.map

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

package/dist/plugin/Retrospective.d.ts

@@ -1,5 +1,6 @@
 import type { MemoryService } from "./MemoryService.js";
 import type { Store } from "./Store.js";
+import type { Metrics } from "./metrics.js";
 export interface RetrospectiveOptions {
     dir?: string;
 }
@@ -7,7 +8,9 @@ export declare class Retrospective {
     private store;
     private memoryService;
     private retrospectivesDir;
-    constructor(store: Store, memoryService: MemoryService, options?: RetrospectiveOptions);
+    private metrics;
+    constructor(store: Store, memoryService: MemoryService, options?: RetrospectiveOptions, metrics?: Metrics | null);
     generate(sessionId: string): Promise<string | null>;
+    private collectFalsePositives;
     private buildMarkdown;
 }