@jmtrin/kevin-core 1.3.0

package/dist/metrics.d.ts

@@ -0,0 +1,97 @@
+import type { Store } from "./Store.js";
+/**
+ * Seeded metric keys defined by migration 003_v02_signal.sql.
+ * The order here MUST match the migration's INSERT OR IGNORE block, since
+ * snapshot() relies on those keys being present in the cache even when the
+ * 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", "patterns_causal", "causal_links", "memories_superseded", "injections_total", "injections_effective", "injections_ineffective", "patterns_promoted_new", "injections_inconclusive", "injections_blocked_seen", "injections_blocked_weak", "injections_blocked_recurrence", "injections_blocked_stale", "injections_blocked_ignored", "feedback_positive_total", "feedback_negative_total", "memories_archived", "proposals_created", "proposals_approved", "proposals_rejected", "artifact_writes_total", "artifact_writes_noop", "injections_blocked_confidence", "repo_facts_scanned", "memories_contradicted", "conventions_mined", "conflicts_detected", "error_lessons_suppressed", "shared_entries_total", "shared_entries_imported", "shared_entries_exported", "okf_merge_folds", "rekey_events", "injections_from_shared", "bench_regression_failures", "forget_requests_total", "forget_tombstones_published", "tui_snapshots_flushed", "tui_actions_invoked"];
+export type MetricKey = (typeof METRIC_KEYS)[number];
+/**
+ * Cheap token estimate used when bumping the `tokens_injected_*` counters.
+ * Per plan §B6.2: heuristic = block.length / 4, floored to 1 so empty strings
+ * don't contribute zero tokens (avoids losing signal on whitespace-only
+ * blocks).
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * In-memory mirror of the `kevin_metrics` table with debounced writes.
+ *
+ * The cache is seeded from `kevin_metrics` on construction (or zeros if the
+ * table is missing — graceful degradation for unit tests and pre-003 DBs).
+ * `incr()` updates the cache and schedules a debounced `flush()` (1 s by
+ * default). `flush()` writes every dirty key in a single transaction and
+ * clears the timer, so the call site can also force a flush on `session.idle`
+ * and on plugin dispose.
+ */
+export declare class Metrics {
+    private readonly store;
+    private readonly cache;
+    private readonly dirty;
+    private flushTimer;
+    private readonly flushMs;
+    private closed;
+    constructor(store: Store, flushMs?: number);
+    private loadFromDb;
+    incr(key: MetricKey, by?: number): void;
+    /**
+     * v0.6.0 (K6-018/019 / plan §5.8) — the pull-channel registration
+     * counters. These live OUTSIDE `METRIC_KEYS`, which is frozen at 33
+     * (K7-004 acceptance, the verified cumulative ladder), but persist to
+     * the same `kevin_metrics` table so `kevin_audit`'s channels block can
+     * read them by SQL (K6-023). They are written immediately (no debounce):
+     * they change at most twice per process, on session start.
+     */
+    incrRegistered(key: "skills_registered" | "references_registered", by?: number): void;
+    /**
+     * Returns a snapshot of the cache. The returned object always contains all
+     * METRIC_KEYS, even if the DB has no rows yet. Does NOT flush.
+     */
+    snapshot(): Record<MetricKey, number>;
+    /**
+     * 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.
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the denominator is now
+     * `effective + ineffective` only. `inconclusive` (the new majority
+     * bucket) must not inflate precision: absence of recurrence is not
+     * evidence of effect. An idle session therefore no longer drives
+     * precision toward 1.0 — expect the reported rate to fall sharply on
+     * real databases; that is the intended result.
+     */
+    precisionRate(): number;
+    /**
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the share of injections that
+     * were actually measured (effective + ineffective) of all injections.
+     * Reported alongside `precisionRate` so a low measurable fraction is
+     * visible rather than hidden behind a large `total`. 0 when the ledger
+     * is empty. Computed from the cached counters — does NOT flush.
+     */
+    coverageRate(): number;
+    /**
+     * v0.5.0 (K5-004 / plan §5.2, D5-02) — the five `injections_blocked_*`
+     * counters keyed by their short names. Consumed by `kevin_audit`.
+     * v0.6.0 (K6-004 / plan §8.3) — sixth member keyed `confidence`
+     * (the low_confidence gate branch, K6-022).
+     * Computed from the cached counters — does NOT flush.
+     */
+    blockedSnapshot(): Record<string, number>;
+    /** True iff a debounced flush is scheduled. Useful for tests. */
+    isFlushScheduled(): boolean;
+    /**
+     * Writes every dirty key to `kevin_metrics` in one transaction. Clears
+     * the debounce timer. Safe to call repeatedly; no-op when nothing is
+     * dirty or when the object is closed. Missing rows are inserted, present
+     * rows are updated. The table is created lazily on first flush so this
+     * works against pre-003 DBs too.
+     */
+    flush(): void;
+    close(): void;
+    private scheduleFlush;
+    private clearTimer;
+}

package/dist/metrics.js

@@ -0,0 +1,288 @@
+/**
+ * Seeded metric keys defined by migration 003_v02_signal.sql.
+ * The order here MUST match the migration's INSERT OR IGNORE block, since
+ * snapshot() relies on those keys being present in the cache even when the
+ * underlying table is empty (e.g., before 003 is applied, on a fresh
+ * :memory: test DB, or after a manual wipe).
+ */
+export const METRIC_KEYS = [
+    "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",
+    // v0.5.0 (K5-004 / plan §8.3) — order matches migration 006's seed block.
+    "injections_inconclusive",
+    "injections_blocked_seen",
+    "injections_blocked_weak",
+    "injections_blocked_recurrence",
+    "injections_blocked_stale",
+    "injections_blocked_ignored",
+    "feedback_positive_total",
+    "feedback_negative_total",
+    "memories_archived",
+    // v0.6.0 (K6-004 / plan §8.3) — order matches migration 007's seed block.
+    // injections_blocked_confidence is the sixth member of the blocked
+    // family and MUST be counted like the other five (Principle 16).
+    "proposals_created",
+    "proposals_approved",
+    "proposals_rejected",
+    "artifact_writes_total",
+    "artifact_writes_noop",
+    "injections_blocked_confidence",
+    // v0.7.0 (K7-004 / plan §8.3) — order matches migration 008's seed block.
+    // These are the Project Truth counters. No per-type precision helper is
+    // exported here: the per-type split of plan §5.6 lives in `kevin_audit`
+    // as pure SQL, not as a `Metrics` method, so there is never a second
+    // definition of precision to drift from the first (D7-14).
+    "repo_facts_scanned",
+    "memories_contradicted",
+    "conventions_mined",
+    "conflicts_detected",
+    "error_lessons_suppressed",
+    // v0.8.0 (K8-003 / plan §8.3) — order matches migration 009's seed block.
+    // These are the Team counters. shared_entries_total is re-derived from
+    // the table by the 009 post-apply hook, never trusted from increments.
+    "shared_entries_total",
+    "shared_entries_imported",
+    "shared_entries_exported",
+    "okf_merge_folds",
+    "rekey_events",
+    "injections_from_shared",
+    // v1.1.0 (K11-001 / plan §4, D11-01) — drift metrics; order matches 012 seed.
+    "bench_regression_failures",
+    "forget_requests_total",
+    "forget_tombstones_published",
+    // v1.2.0 (K12-001 / plan §4) — surface metrics; no migration this
+    // release — rows are created on first incr via upsert (K12-001).
+    "tui_snapshots_flushed",
+    "tui_actions_invoked",
+];
+const DEFAULT_FLUSH_MS = 1000;
+function zeroCache() {
+    const m = new Map();
+    for (const k of METRIC_KEYS)
+        m.set(k, 0);
+    return m;
+}
+/**
+ * Cheap token estimate used when bumping the `tokens_injected_*` counters.
+ * Per plan §B6.2: heuristic = block.length / 4, floored to 1 so empty strings
+ * don't contribute zero tokens (avoids losing signal on whitespace-only
+ * blocks).
+ */
+export function estimateTokens(text) {
+    return Math.max(1, Math.round(text.length / 4));
+}
+/**
+ * In-memory mirror of the `kevin_metrics` table with debounced writes.
+ *
+ * The cache is seeded from `kevin_metrics` on construction (or zeros if the
+ * table is missing — graceful degradation for unit tests and pre-003 DBs).
+ * `incr()` updates the cache and schedules a debounced `flush()` (1 s by
+ * default). `flush()` writes every dirty key in a single transaction and
+ * clears the timer, so the call site can also force a flush on `session.idle`
+ * and on plugin dispose.
+ */
+export class Metrics {
+    store;
+    cache;
+    dirty = new Set();
+    flushTimer = null;
+    flushMs;
+    closed = false;
+    constructor(store, flushMs = DEFAULT_FLUSH_MS) {
+        this.store = store;
+        this.flushMs = flushMs;
+        this.cache = zeroCache();
+        this.loadFromDb();
+    }
+    loadFromDb() {
+        // Graceful: kevin_metrics only exists after migration 003. If a caller
+        // instantiates Metrics against a fresh / pre-003 DB, leave the zeros
+        // seeded in memory; the eventual flush() will create the rows.
+        let rows = [];
+        try {
+            rows = this.store
+                .prepare("SELECT key, value FROM kevin_metrics")
+                .all();
+        }
+        catch {
+            rows = [];
+        }
+        for (const row of rows) {
+            if (this.cache.has(row.key)) {
+                this.cache.set(row.key, row.value);
+            }
+        }
+    }
+    incr(key, by = 1) {
+        if (this.closed)
+            return;
+        const current = this.cache.get(key) ?? 0;
+        this.cache.set(key, current + by);
+        this.dirty.add(key);
+        this.scheduleFlush();
+    }
+    /**
+     * v0.6.0 (K6-018/019 / plan §5.8) — the pull-channel registration
+     * counters. These live OUTSIDE `METRIC_KEYS`, which is frozen at 33
+     * (K7-004 acceptance, the verified cumulative ladder), but persist to
+     * the same `kevin_metrics` table so `kevin_audit`'s channels block can
+     * read them by SQL (K6-023). They are written immediately (no debounce):
+     * they change at most twice per process, on session start.
+     */
+    incrRegistered(key, by = 1) {
+        if (this.closed)
+            return;
+        const store = this.store;
+        store.transaction(() => {
+            store.exec(`CREATE TABLE IF NOT EXISTS kevin_metrics (
+			            key        TEXT PRIMARY KEY,
+			            value      INTEGER NOT NULL DEFAULT 0,
+			            updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+			          )`);
+            store
+                .prepare(`INSERT INTO kevin_metrics (key, value, updated_at)
+			         VALUES (?, ?, datetime('now'))
+			         ON CONFLICT(key) DO UPDATE SET
+			           value = value + excluded.value,
+			           updated_at = datetime('now')`)
+                .run(key, by);
+        });
+    }
+    /**
+     * Returns a snapshot of the cache. The returned object always contains all
+     * METRIC_KEYS, even if the DB has no rows yet. Does NOT flush.
+     */
+    snapshot() {
+        const out = {};
+        for (const k of METRIC_KEYS)
+            out[k] = this.cache.get(k) ?? 0;
+        return out;
+    }
+    /**
+     * Returns the cached value for a single key. Does NOT flush.
+     */
+    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.
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the denominator is now
+     * `effective + ineffective` only. `inconclusive` (the new majority
+     * bucket) must not inflate precision: absence of recurrence is not
+     * evidence of effect. An idle session therefore no longer drives
+     * precision toward 1.0 — expect the reported rate to fall sharply on
+     * real databases; that is the intended result.
+     */
+    precisionRate() {
+        const effective = this.cache.get("injections_effective") ?? 0;
+        const measured = effective + (this.cache.get("injections_ineffective") ?? 0);
+        if (measured <= 0)
+            return 0;
+        return Math.min(1, effective / measured);
+    }
+    /**
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the share of injections that
+     * were actually measured (effective + ineffective) of all injections.
+     * Reported alongside `precisionRate` so a low measurable fraction is
+     * visible rather than hidden behind a large `total`. 0 when the ledger
+     * is empty. Computed from the cached counters — does NOT flush.
+     */
+    coverageRate() {
+        const total = this.cache.get("injections_total") ?? 0;
+        if (total <= 0)
+            return 0;
+        const measured = (this.cache.get("injections_effective") ?? 0) +
+            (this.cache.get("injections_ineffective") ?? 0);
+        return Math.min(1, measured / total);
+    }
+    /**
+     * v0.5.0 (K5-004 / plan §5.2, D5-02) — the five `injections_blocked_*`
+     * counters keyed by their short names. Consumed by `kevin_audit`.
+     * v0.6.0 (K6-004 / plan §8.3) — sixth member keyed `confidence`
+     * (the low_confidence gate branch, K6-022).
+     * Computed from the cached counters — does NOT flush.
+     */
+    blockedSnapshot() {
+        return {
+            seen: this.cache.get("injections_blocked_seen") ?? 0,
+            weak: this.cache.get("injections_blocked_weak") ?? 0,
+            recurrence: this.cache.get("injections_blocked_recurrence") ?? 0,
+            stale: this.cache.get("injections_blocked_stale") ?? 0,
+            ignored: this.cache.get("injections_blocked_ignored") ?? 0,
+            confidence: this.cache.get("injections_blocked_confidence") ?? 0,
+        };
+    }
+    /** True iff a debounced flush is scheduled. Useful for tests. */
+    isFlushScheduled() {
+        return this.flushTimer !== null;
+    }
+    /**
+     * Writes every dirty key to `kevin_metrics` in one transaction. Clears
+     * the debounce timer. Safe to call repeatedly; no-op when nothing is
+     * dirty or when the object is closed. Missing rows are inserted, present
+     * rows are updated. The table is created lazily on first flush so this
+     * works against pre-003 DBs too.
+     */
+    flush() {
+        if (this.closed || this.dirty.size === 0) {
+            this.clearTimer();
+            return;
+        }
+        this.clearTimer();
+        const dirtyKeys = Array.from(this.dirty);
+        this.dirty.clear();
+        const store = this.store;
+        store.transaction(() => {
+            store.exec(`CREATE TABLE IF NOT EXISTS kevin_metrics (
+			            key        TEXT PRIMARY KEY,
+			            value      INTEGER NOT NULL DEFAULT 0,
+			            updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+			          )`);
+            const upsert = store.prepare(`INSERT INTO kevin_metrics (key, value, updated_at)
+			         VALUES (?, ?, datetime('now'))
+			         ON CONFLICT(key) DO UPDATE SET
+			           value = excluded.value,
+			           updated_at = datetime('now')`);
+            for (const k of dirtyKeys) {
+                upsert.run(k, this.cache.get(k) ?? 0);
+            }
+        });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.flush();
+        this.closed = true;
+        this.clearTimer();
+    }
+    scheduleFlush() {
+        if (this.flushTimer !== null)
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this.flush();
+        }, this.flushMs);
+        // unref so the timer never keeps a Node process alive on its own.
+        const t = this.flushTimer;
+        t.unref?.();
+    }
+    clearTimer() {
+        if (this.flushTimer !== null) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+}

package/dist/migrations/001_initial.sql

@@ -0,0 +1,92 @@
+-- ============================================================
+-- Kevin 0.1.0 — Schema inicial
+-- ============================================================
+
+-- Tabla de versiones para migraciones
+CREATE TABLE IF NOT EXISTS schema_version (
+  version TEXT PRIMARY KEY,
+  applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ============================================================
+-- memories: lecciones aprendidas
+-- ============================================================
+CREATE TABLE IF NOT EXISTS memories (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK(type IN ('error', 'pattern', 'decision', 'context')),
+  content TEXT NOT NULL,
+  scope TEXT NOT NULL DEFAULT 'project' CHECK(scope IN ('project', 'session')),
+  relevance_score REAL DEFAULT 0.5,
+  source_tool TEXT,
+  source_session TEXT,
+  metadata TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+CREATE INDEX IF NOT EXISTS idx_memories_scope ON memories(scope);
+CREATE INDEX IF NOT EXISTS idx_memories_relevance ON memories(relevance_score DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
+
+-- FTS5: búsqueda full-text con remoción de diacríticos (mejor para español)
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+  content,
+  content='memories',
+  tokenize='unicode61 remove_diacritics 1'
+);
+
+-- Triggers para mantener FTS5 sincronizado (FTS5 external-content se indexa por rowid)
+CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+  INSERT INTO memories_fts(rowid, content) VALUES (new.rowid, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
+  INSERT INTO memories_fts(rowid, content) VALUES (new.rowid, new.content);
+END;
+
+-- ============================================================
+-- tool_calls: observación de tool calls del agente
+-- ============================================================
+CREATE TABLE IF NOT EXISTS tool_calls (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  ts TEXT NOT NULL DEFAULT (datetime('now')),
+  tool TEXT NOT NULL,
+  args_summary TEXT,
+  success INTEGER NOT NULL CHECK(success IN (0,1)),
+  duration_ms INTEGER,
+  agent TEXT,
+  error_type TEXT,
+  metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_session ON tool_calls(session_id);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_tool ON tool_calls(tool);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_ts ON tool_calls(ts);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_success ON tool_calls(success);
+
+-- ============================================================
+-- retrospectives: resúmenes de sesión
+-- ============================================================
+CREATE TABLE IF NOT EXISTS retrospectives (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  ts TEXT NOT NULL DEFAULT (datetime('now')),
+  failure_count INTEGER DEFAULT 0,
+  success_count INTEGER DEFAULT 0,
+  lessons_count INTEGER DEFAULT 0,
+  file_path TEXT,
+  metadata TEXT
+);
+
+-- ============================================================
+-- Seed: versión inicial
+-- ============================================================
+INSERT OR IGNORE INTO schema_version (version) VALUES ('001');

package/dist/migrations/002_indexes.sql

@@ -0,0 +1,14 @@
+-- ============================================================
+-- Kevin 0.1.1 — Migration 002: indexes adicionales
+-- ============================================================
+
+-- F#29: uniqueness on retrospectives.session_id
+-- Prevents duplicate retrospective rows under concurrent session.idle events.
+CREATE UNIQUE INDEX IF NOT EXISTS idx_retrospectives_session
+  ON retrospectives(session_id);
+
+-- F#31: index on memories.expires_at
+-- Every query/queryRelevant/loadAll filters WHERE (expires_at IS NULL OR expires_at > datetime('now')).
+-- Without this index the filter is a linear scan on large tables.
+CREATE INDEX IF NOT EXISTS idx_memories_expires
+  ON memories(expires_at);

package/dist/migrations/003_v02_signal.sql

@@ -0,0 +1,58 @@
+-- ============================================================
+-- Kevin 0.2.0 — Migration 003: Signal Quality (additive)
+-- ============================================================
+-- Backward-compatible, additive only. All new columns are
+-- nullable or carry a NOT NULL DEFAULT so legacy rows keep
+-- working without a destructive rebuild. The partial UNIQUE
+-- index excludes NULL fingerprints so legacy error memories
+-- do not collide. The schema_version table (created by 001)
+-- guarantees this file runs at most once per DB.
+-- ============================================================
+
+-- 1. memories: Signal Quality columns.
+--    project_id — first-class scoping dimension (D2-11).
+--    fingerprint — stable hash of normalized error content, salted by project_id (D2-14).
+--    origin — distinguishes reflector-sourced vs agent-sourced memories (D2-06),
+--             with a CHECK enum and DEFAULT 'agent' so legacy rows backfill cleanly.
+ALTER TABLE memories ADD COLUMN project_id  TEXT;
+ALTER TABLE memories ADD COLUMN fingerprint TEXT;
+ALTER TABLE memories ADD COLUMN origin      TEXT NOT NULL DEFAULT 'agent'
+  CHECK(origin IN ('reflector', 'agent', 'pattern', 'retrospective'));
+
+-- 2. tool_calls: same scoping/fingerprint columns for dedup and PatternMiner.
+ALTER TABLE tool_calls ADD COLUMN project_id  TEXT;
+ALTER TABLE tool_calls ADD COLUMN fingerprint TEXT;
+
+-- 3. Partial UNIQUE: one reflector-sourced error memory per (project_id, fingerprint).
+--    NULL fingerprints are excluded (no dedup for non-error memories or legacy rows).
+CREATE UNIQUE INDEX IF NOT EXISTS uq_memories_error_fp
+  ON memories (project_id, fingerprint)
+  WHERE type = 'error' AND fingerprint IS NOT NULL AND origin = 'reflector';
+
+-- 4. kevin_metrics: seeded counters surfaced by kevin_status (D2-07 / K2-004).
+CREATE TABLE IF NOT EXISTS kevin_metrics (
+  key        TEXT PRIMARY KEY,
+  value      INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES
+  ('tokens_injected_pre_prompt', 0),
+  ('tokens_injected_compacting',  0),
+  ('reflections_throttled',       0),
+  ('duplicate_suppressions',      0),
+  ('tool_calls_deduped',          0),
+  ('patterns_mined',              0);
+
+-- 5. kevin_settings: opt-in feature flags (PatternMiner off, tool_calls dedup off).
+CREATE TABLE IF NOT EXISTS kevin_settings (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES
+  ('patternminer_enabled',     '0'),
+  ('tool_calls_dedup_enabled', '0');
+
+-- 6. Seed version 003.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('003');