@jmtrin/opencode-kevin 1.2.0 → 1.4.0

package/dist/plugin/metrics.d.ts

@@ -1,97 +0,0 @@
-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/plugin/metrics.js

@@ -1,288 +0,0 @@
-/**
- * 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/plugin/okf-export.d.ts

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

package/dist/plugin/okf-export.js

@@ -1,134 +0,0 @@
-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).
- *
- * v0.8.0 (K8-027) — the v1 export is scoped to one project: the global
- * database may hold several projects' memories, and once an export lands
- * in a committed file a cross-project leak becomes permanent history.
- * A `project_id` of null keeps the legacy unscoped behaviour for direct
- * callers that predate the fix; the kevin_export tool always threads it.
- */
-function selectExportRows(store, projectId) {
-    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'
-					   AND project_id = ?
-					 ORDER BY type, created_at DESC`)
-                .all(projectId),
-        };
-    }
-    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'
-				   AND project_id = ?
-				 ORDER BY type, created_at DESC`)
-            .all(projectId);
-        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, projectId = null) {
-    const { rows: allRows, hasRecurrence } = selectExportRows(store, projectId);
-    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, projectId = null) {
-    const { rows: allRows, hasRecurrence } = selectExportRows(store, projectId);
-    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");
-}

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

@@ -1,76 +0,0 @@
-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;