@jmtrin/opencode-kevin 0.2.0 → 0.4.0

package/dist/plugin/kevin_why.js

@@ -0,0 +1,108 @@
+import { TS_CODE_RULES } from "./Reflector.js";
+import { computeConfidence } from "./confidence.js";
+import { toMatchClause, tokenizeQuery } from "./query-tokenizer.js";
+export function kevinWhy(store, query) {
+    // v0.3.0 fix (bug #7) — the old code wrapped the WHOLE query in a
+    // single quoted phrase, so it only matched the exact full-string
+    // sequence. Tokenize like MemoryService.queryRelevant: quote each
+    // word (escaping inner quotes) and AND them together, so partial or
+    // multi-word queries still hit the FTS index.
+    const tokens = tokenizeQuery(query);
+    if (tokens.length === 0)
+        return null;
+    const match = toMatchClause(tokens, " AND ");
+    // Best-effort (v0.4.0): DBs pre-005 lack `recurrence_count`; degrade
+    // to "no explanation" instead of crashing the calling session.
+    let patternRows;
+    try {
+        patternRows = store
+            .prepare(`SELECT m.id, m.content, m.fingerprint, m.evidence_count,
+				        m.recurrence_count, m.fix_args, m.last_verified_at, m.created_at
+				 FROM memories_fts
+				 JOIN memories m ON m.rowid = memories_fts.rowid
+				 WHERE memories_fts MATCH ?
+				   AND m.type = 'pattern'
+				   AND m.origin IN ('causal', 'pattern')
+				   AND m.status = 'active'
+				 ORDER BY m.evidence_count DESC, m.created_at DESC
+				 LIMIT 1`)
+            .all(match);
+    }
+    catch {
+        return null;
+    }
+    if (patternRows.length === 0)
+        return null;
+    const pattern = patternRows[0];
+    const fp = pattern.fingerprint;
+    // v0.4.0 (K4-010) — two-sided confidence shared with promoteToPattern.
+    const confidence = computeConfidence(pattern.evidence_count ?? 0, pattern.recurrence_count ?? 0);
+    // BUG-007 — the trace is built from the error-memory sessions below;
+    // the legacy `traceRows` probe (executed but unused, with a
+    // never-matching `tc.fingerprint LIKE '%<8-hex>%'` branch against the
+    // tool|args|success hash) was deleted.
+    const trace = [];
+    const errorSessions = store
+        .prepare(`SELECT DISTINCT source_session, fingerprint, created_at
+			 FROM memories
+			 WHERE fingerprint = ? AND type = 'error' AND origin = 'reflector'
+			 ORDER BY created_at ASC`)
+        .all(fp);
+    for (const err of errorSessions) {
+        trace.push({
+            event: "failure",
+            fingerprint: err.fingerprint,
+            session: err.source_session ?? "unknown",
+            ts: err.created_at,
+        });
+        const fixRow = store
+            .prepare(`SELECT session_id, ts FROM tool_calls
+				 WHERE fix_for_fingerprint = ?
+				   AND session_id = ?
+				 ORDER BY ts ASC LIMIT 1`)
+            .get(fp, err.source_session);
+        if (fixRow) {
+            trace.push({
+                event: "fix",
+                fingerprint: fp,
+                session: fixRow.session_id,
+                ts: fixRow.ts,
+            });
+        }
+    }
+    const relatedRules = [];
+    const tsCodeMatch = query.match(/TS(\d{4,5})/);
+    if (tsCodeMatch) {
+        const hint = TS_CODE_RULES[tsCodeMatch[1]] ?? `review TS${tsCodeMatch[1]}`;
+        relatedRules.push(hint);
+    }
+    // v0.4.0 (K4-020) — honest summary (plan §5.3 / D4-11): with
+    // recurrences the pattern is NOT consistently resolved, so the
+    // phrasing reports the real success ratio ("resolved in N of M
+    // attempts") instead of "consistently resolved".
+    const evidenceCount = pattern.evidence_count ?? 0;
+    const recurrence = pattern.recurrence_count ?? 0;
+    let summary;
+    if (recurrence > 0) {
+        const fix = pattern.fix_args
+            ? `fixing ${pattern.fix_args}`
+            : `fixing ${relatedRules.length > 0
+                ? relatedRules.join(", ")
+                : "the underlying issue"}`;
+        summary = `When tool fails with ${query}: resolved in ${evidenceCount} of ${evidenceCount + recurrence} attempts by ${fix}.`;
+    }
+    else {
+        summary = `When tool fails with ${query}: ${confidence >= 0.7 ? "consistently" : "often"} resolved by fixing ${relatedRules.length > 0 ? relatedRules.join(", ") : "the underlying issue"}.`;
+    }
+    return {
+        summary,
+        confidence,
+        evidence_count: evidenceCount,
+        recurrence_count: recurrence,
+        fix_args: pattern.fix_args ?? null,
+        last_verified: pattern.last_verified_at ?? null,
+        trace,
+        related_rules: relatedRules,
+    };
+}
+//# sourceMappingURL=kevin_why.js.map

package/dist/plugin/kevin_why.js.map

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

package/dist/plugin/memory-format.d.ts

@@ -3,6 +3,18 @@ export interface MemoryBlockItem {
     type: string;
     content: string;
     protect?: boolean;
+    /** v0.4.0 (K4-023) — weak lesson admitted in debug mode: the row is
+     * rendered with a `(low confidence)` marker line. */
+    weak?: boolean;
 }
 export declare function escapeInjectedText(text: string): string;
+/**
+ * v0.4.0 (K4-012) — progressive disclosure for injection: a short
+ * snippet row instead of the full body. Row = `id:` line + `[type]`
+ * prefix + the first 2 non-empty lines of content, wrapped in
+ * `<protect>` unless the memory opted out (`protect: false`). The
+ * full body stays available via `kevin_get`.
+ */
+export declare function formatSnippet(m: MemoryBlockItem): string;
 export declare function formatMemories(memories: MemoryBlockItem[], tag: "context" | "memory"): string;
+export declare function formatMemorySnippets(memories: MemoryBlockItem[], tag: "context" | "memory"): string;

package/dist/plugin/memory-format.js

@@ -4,17 +4,57 @@ export function escapeInjectedText(text) {
         .replace(/</g, "&lt;")
         .replace(/>/g, "&gt;");
 }
+function typePrefix(m) {
+    const t = escapeInjectedText(String(m.type));
+    return m.weak ? `[${t}] (low confidence)` : `[${t}]`;
+}
 function formatRow(m) {
     const idLine = m.id ? `id: ${escapeInjectedText(m.id)}\n` : "";
-    const body = `${idLine}[${escapeInjectedText(String(m.type))}] ${escapeInjectedText(m.content)}`;
+    const body = `${idLine}${typePrefix(m)} ${escapeInjectedText(m.content)}`;
     return m.protect === false ? body : `<protect>\n${body}\n</protect>`;
 }
-export function formatMemories(memories, tag) {
-    if (memories.length === 0)
-        return "";
-    const body = memories.map(formatRow).join("\n");
+/**
+ * v0.4.0 (K4-012) — progressive disclosure for injection: a short
+ * snippet row instead of the full body. Row = `id:` line + `[type]`
+ * prefix + the first 2 non-empty lines of content, wrapped in
+ * `<protect>` unless the memory opted out (`protect: false`). The
+ * full body stays available via `kevin_get`.
+ */
+export function formatSnippet(m) {
+    const lines = m.content
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0)
+        .slice(0, 2);
+    // v0.4.0 (K4-025) — a pattern's `Fixed by:` line is the highest-value
+    // payload (plan §5.4 / D4-07); surface it in the snippet even though
+    // it sits below the 2-line cut. Only patterns carry the line.
+    const fixLine = lines
+        .map((l) => l)
+        .concat(m.content
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("Fixed by:")))[2];
+    const idLine = m.id ? `id: ${escapeInjectedText(m.id)}\n` : "";
+    const bodyLines = fixLine ? [...lines, fixLine] : lines;
+    const body = bodyLines.length === 0
+        ? ""
+        : `${idLine}${typePrefix(m)} ${escapeInjectedText(bodyLines.join("\n"))}`;
+    return m.protect === false ? body : `<protect>\n${body}\n</protect>`;
+}
+function wrapBlock(body, tag) {
     return tag === "context"
         ? `<kevin-context>Lecciones relevantes:\n${body}\n</kevin-context>`
         : `<kevin-memory>\n${body}\n</kevin-memory>`;
 }
+export function formatMemories(memories, tag) {
+    if (memories.length === 0)
+        return "";
+    return wrapBlock(memories.map(formatRow).join("\n"), tag);
+}
+export function formatMemorySnippets(memories, tag) {
+    if (memories.length === 0)
+        return "";
+    return wrapBlock(memories.map(formatSnippet).join("\n"), tag);
+}
 //# sourceMappingURL=memory-format.js.map

package/dist/plugin/memory-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-format.js","sourceRoot":"","sources":["../../plugin/memory-format.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC9C,OAAO,IAAI;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,SAAS,CAAC,CAAkB;IACpC,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,kBAAkB,CAClF,CAAC,CAAC,OAAO,CACT,EAAE,CAAC;IACJ,OAAO,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,cAAc,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,QAA2B,EAC3B,GAAyB;IAEzB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,GAAG,KAAK,SAAS;QACvB,CAAC,CAAC,yCAAyC,IAAI,oBAAoB;QACnE,CAAC,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"memory-format.js","sourceRoot":"","sources":["../../plugin/memory-format.ts"],"names":[],"mappings":"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"}

package/dist/plugin/metrics.d.ts

@@ -6,7 +6,7 @@ import type { Store } from "./Store.js";
  * underlying table is empty (e.g., before 003 is applied, on a fresh
  * :memory: test DB, or after a manual wipe).
  */
-export declare const METRIC_KEYS: readonly ["tokens_injected_pre_prompt", "tokens_injected_compacting", "reflections_throttled", "duplicate_suppressions", "tool_calls_deduped", "patterns_mined"];
+export declare const METRIC_KEYS: readonly ["tokens_injected_pre_prompt", "tokens_injected_compacting", "reflections_throttled", "duplicate_suppressions", "tool_calls_deduped", "patterns_mined", "patterns_causal", "causal_links", "memories_superseded", "injections_total", "injections_effective", "injections_ineffective", "patterns_promoted_new"];
 export type MetricKey = (typeof METRIC_KEYS)[number];
 /**
  * Cheap token estimate used when bumping the `tokens_injected_*` counters.
@@ -44,6 +44,12 @@ export declare class Metrics {
      * Returns the cached value for a single key. Does NOT flush.
      */
     get(key: MetricKey): number;
+    /**
+     * v0.4.0 (K4-008): injection precision = effective / total settled
+     * injections. 0 when the ledger has no entries yet (no division by zero).
+     * Computed from the cached counters — does NOT flush.
+     */
+    precisionRate(): number;
     /** True iff a debounced flush is scheduled. Useful for tests. */
     isFlushScheduled(): boolean;
     /**

package/dist/plugin/metrics.js

@@ -12,6 +12,13 @@ export const METRIC_KEYS = [
     "duplicate_suppressions",
     "tool_calls_deduped",
     "patterns_mined",
+    "patterns_causal",
+    "causal_links",
+    "memories_superseded",
+    "injections_total",
+    "injections_effective",
+    "injections_ineffective",
+    "patterns_promoted_new",
 ];
 const DEFAULT_FLUSH_MS = 1000;
 function zeroCache() {
@@ -95,6 +102,18 @@ export class Metrics {
     get(key) {
         return this.cache.get(key) ?? 0;
     }
+    /**
+     * v0.4.0 (K4-008): injection precision = effective / total settled
+     * injections. 0 when the ledger has no entries yet (no division by zero).
+     * Computed from the cached counters — does NOT flush.
+     */
+    precisionRate() {
+        const total = this.cache.get("injections_total") ?? 0;
+        if (total <= 0)
+            return 0;
+        const effective = this.cache.get("injections_effective") ?? 0;
+        return Math.min(1, effective / total);
+    }
     /** True iff a debounced flush is scheduled. Useful for tests. */
     isFlushScheduled() {
         return this.flushTimer !== null;

package/dist/plugin/metrics.js.map

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

package/dist/plugin/okf-export.d.ts

@@ -0,0 +1,3 @@
+import type { Store } from "./Store.js";
+export declare function exportOkf(store: Store): string;
+export declare function exportMarkdown(store: Store): string;

package/dist/plugin/okf-export.js

@@ -0,0 +1,127 @@
+import { computeConfidence } from "./confidence.js";
+const EXPORT_TYPES = new Set(["decision", "rule", "pattern"]);
+function formatTimestamp(ts) {
+    try {
+        // SQLite `datetime('now')` is UTC without a zone suffix; parse as
+        // UTC so a round-trip never shifts the value by the local offset.
+        const iso = ts.includes("T") ? ts : `${ts.replace(" ", "T")}Z`;
+        return new Date(iso).toISOString().replace("T", " ").slice(0, 19);
+    }
+    catch {
+        return ts;
+    }
+}
+/**
+ * BUG-008 — select export rows including `recurrence_count` (the v0.4.0
+ * demotion signal, column from migration 005). DBs that predate 005 have
+ * no such column; the SELECT is retried without it and recurrences
+ * degrade to 0 (legacy confidence formula applies — see below).
+ */
+function selectExportRows(store) {
+    try {
+        return {
+            hasRecurrence: true,
+            rows: store
+                .prepare(`SELECT id, type, content, scope, relevance_score, fingerprint,
+					        evidence_count, recurrence_count, last_verified_at, status,
+					        source_tool, source_session, created_at, updated_at
+					 FROM memories
+					 WHERE status = 'active'
+					 ORDER BY type, created_at DESC`)
+                .all(),
+        };
+    }
+    catch {
+        const legacy = store
+            .prepare(`SELECT id, type, content, scope, relevance_score, fingerprint,
+				        evidence_count, last_verified_at, status,
+				        source_tool, source_session, created_at, updated_at
+				 FROM memories
+				 WHERE status = 'active'
+				 ORDER BY type, created_at DESC`)
+            .all();
+        return {
+            hasRecurrence: false,
+            rows: legacy.map((r) => ({ ...r, recurrence_count: 0 })),
+        };
+    }
+}
+/**
+ * BUG-008 — the exported confidence must match the two-sided v0.4.0
+ * formula (K4-010), demoting lessons with recurrences. Pre-005 DBs (no
+ * `recurrence_count` column) keep the legacy one-sided formula.
+ */
+function exportConfidence(row, hasRecurrence) {
+    const confidence = hasRecurrence
+        ? computeConfidence(row.evidence_count, row.recurrence_count)
+        : Math.min(1, 0.5 + 0.1 * row.evidence_count);
+    return confidence.toFixed(2);
+}
+export function exportOkf(store) {
+    const { rows: allRows, hasRecurrence } = selectExportRows(store);
+    const filtered = allRows.filter((r) => EXPORT_TYPES.has(r.type));
+    if (filtered.length === 0)
+        return "<!-- No exportable memories found. -->\n";
+    const blocks = [];
+    for (const m of filtered) {
+        const fm = [];
+        fm.push("---");
+        fm.push(`id: ${m.id}`);
+        fm.push(`type: ${m.type}`);
+        fm.push(`confidence: ${exportConfidence(m, hasRecurrence)}`);
+        fm.push(`evidence_count: ${m.evidence_count}`);
+        if (m.recurrence_count > 0) {
+            fm.push(`recurrence_count: ${m.recurrence_count}`);
+        }
+        if (m.last_verified_at) {
+            fm.push(`last_verified_at: ${formatTimestamp(m.last_verified_at)}`);
+        }
+        if (m.fingerprint) {
+            fm.push(`fingerprint: ${m.fingerprint}`);
+        }
+        fm.push(`created: ${formatTimestamp(m.created_at)}`);
+        fm.push(`scope: ${m.scope}`);
+        fm.push("---");
+        fm.push("");
+        fm.push(m.content);
+        blocks.push(fm.join("\n"));
+    }
+    return `${blocks.join("\n\n")}\n`;
+}
+export function exportMarkdown(store) {
+    const { rows: allRows, hasRecurrence } = selectExportRows(store);
+    const filtered = allRows.filter((r) => EXPORT_TYPES.has(r.type));
+    if (filtered.length === 0)
+        return "# Kevin Knowledge Export\n\n_No exportable memories found._\n";
+    const lines = [];
+    lines.push("# Kevin Knowledge Export");
+    lines.push("");
+    lines.push(`Exported: ${new Date().toISOString().replace("T", " ").slice(0, 19)}`);
+    lines.push(`Total entries: ${filtered.length}`);
+    lines.push("");
+    for (const m of filtered) {
+        lines.push(`## ${m.type}: \`${m.fingerprint ?? m.id.slice(0, 8)}\``);
+        lines.push("");
+        lines.push(`- **ID:** \`${m.id}\``);
+        lines.push(`- **Confidence:** ${exportConfidence(m, hasRecurrence)}`);
+        lines.push(`- **Evidence count:** ${m.evidence_count}`);
+        if (m.recurrence_count > 0) {
+            lines.push(`- **Recurrence count:** ${m.recurrence_count}`);
+        }
+        if (m.last_verified_at) {
+            lines.push(`- **Last verified:** ${formatTimestamp(m.last_verified_at)}`);
+        }
+        if (m.fingerprint) {
+            lines.push(`- **Fingerprint:** \`${m.fingerprint}\``);
+        }
+        lines.push(`- **Scope:** ${m.scope}`);
+        lines.push(`- **Created:** ${formatTimestamp(m.created_at)}`);
+        lines.push("");
+        lines.push(m.content);
+        lines.push("");
+        lines.push("---");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=okf-export.js.map

package/dist/plugin/okf-export.js.map

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

package/dist/plugin/okf-import.d.ts

@@ -0,0 +1,76 @@
+import type { MemoryService } from "./MemoryService.js";
+/**
+ * v0.3.0 fix — A single parsed bundle entry. `evidence_count` and
+ * `last_verified_at` are preserved across round-trips (export → import)
+ * so causal confidence is not lost when knowledge is shared between
+ * projects. v0.4.0 (BUG-008) — `recurrence_count` too, so the two-sided
+ * v0.4.0 confidence demotion survives the round-trip.
+ */
+export interface ParsedEntry {
+    id: string;
+    type: string;
+    content: string;
+    fingerprint: string | null;
+    evidence_count: number;
+    /** v0.4.0 (BUG-008) — recurrence demotion, 0 when absent. */
+    recurrence_count: number;
+    last_verified_at: string | null;
+}
+/**
+ * v0.3.0 fix — Clean state-machine parser for the frontmatter bundle
+ * format produced by `okf-export.ts::exportOkf`. Each entry is:
+ *
+ *   ---
+ *   id: <uuid>
+ *   type: <decision|rule|pattern>
+ *   confidence: 0.70
+ *   evidence_count: 2
+ *   last_verified_at: 2026-07-25 12:34:56
+ *   fingerprint: <hex>
+ *   created: 2026-07-25 12:00:00
+ *   scope: project
+ *   ---
+ *
+ *   <content body, may span multiple lines, may include `---` lines
+ *    within — the body terminator is the NEXT top-level `---` followed
+ *    by an `id:` line, or EOF>
+ *
+ * The previous implementation only ever flagged `inFm = true` once and
+ * never reset `contentStarted` between entries, so 2..N entries were
+ * silently dropped (bug #1). This rewrite handles arbitrary numbers of
+ * consecutive frontmatter sections.
+ */
+export declare function parseMarkdownBundle(text: string): ParsedEntry[];
+/**
+ * v0.3.0 fix — Fallback parser for the markdown-style `##` heading
+ * format produced by `okf-export.ts::exportMarkdown`. The previous
+ * version extracted `fingerprint: null` for every entry (regex was
+ * pinned to 16 hex chars while actual fingerprints are variable
+ * length) and contaminated `content` with the heading line and
+ * metadata bullets. This version cleanly separates metadata bullets
+ * (looking for `**ID:**`, `**Fingerprint:**`, `**Evidence count:**`,
+ * `**Last verified:**`, `**Scope:**` prefixes) from the content
+ * body, which starts after the first blank line following the bullet
+ * block and runs until the trailing `---` separator (or EOF).
+ */
+export declare function parseMarkdownHeadings(text: string): ParsedEntry[];
+export interface ImportResult {
+    imported: number;
+    superseded: number;
+}
+/**
+ * v0.3.0 fix — Ingest a bundle (frontmatter OR markdown) into the
+ * local SQLite store as `context` memories with `origin='imported'`.
+ *
+ * Fixes over the v0.3.0 baseline:
+ *   * Multi-entry bundles now produce N imports instead of N=1 — the
+ *     parser bug is closed.
+ *   * `ParsedEntry.evidence_count` and `last_verified_at` are
+ *     threaded through so causal confidence survives a round-trip.
+ *   * `ImportResult.superseded` is populated using
+ *     `countSupersedeCandidates`, which mirrors the supersede logic
+ *     in `MemoryService.save()`. Previously it was hard-coded to 0.
+ *   * Generated ids use `uuidv7()` (the project's id generator)
+ *     instead of `crypto.randomUUID()` for consistency.
+ */
+export declare function importOkf(bundle: string, memoryService: MemoryService): ImportResult;