@jmtrin/kevin-core 1.3.0

package/dist/migrations/009_v08_team.sql

@@ -0,0 +1,100 @@
+-- ============================================================
+-- Kevin 0.8.0 - Migration 009: Team (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.
+--
+-- Scope note: this migration introduces `repo_id`, a SECOND
+-- scoping dimension. `project_id` is retained on every table,
+-- unchanged, as local-path provenance (D8-02). Nothing that
+-- reads `project_id` today stops working.
+-- ============================================================
+
+-- 1. shared_entries: the local projection of the committed OKF file.
+--    One row per (repo_id, entry_id). Rewritten by SharedLayer.import(),
+--    never edited by hand, never the source of truth - the file is.
+--    No REFERENCES to memories: an entry may arrive from a teammate
+--    before any local memory corresponds to it (D8-12).
+CREATE TABLE IF NOT EXISTS shared_entries (
+  id           TEXT PRIMARY KEY,
+  repo_id      TEXT NOT NULL,
+  entry_id     TEXT NOT NULL,
+  type         TEXT NOT NULL CHECK (type IN ('decision', 'rule', 'pattern', 'solution')),
+  statement    TEXT NOT NULL,
+  scope        TEXT,
+  confidence   REAL NOT NULL DEFAULT 0.0,
+  evidence     INTEGER NOT NULL DEFAULT 0,
+  origin       TEXT NOT NULL DEFAULT 'shared',
+  author_hash  TEXT,
+  op           TEXT NOT NULL CHECK (op IN ('assert', 'tombstone')) DEFAULT 'assert',
+  supersedes   TEXT,
+  created_at   TEXT NOT NULL,
+  imported_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- 1b. Identity is (repo_id, entry_id). The UNIQUE index is what makes
+--     import() an idempotent upsert instead of an append.
+CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_entries
+  ON shared_entries(repo_id, entry_id);
+CREATE INDEX IF NOT EXISTS idx_shared_entries_op
+  ON shared_entries(op);
+CREATE INDEX IF NOT EXISTS idx_shared_entries_type
+  ON shared_entries(type);
+
+-- 2. okf_imports: append-only audit of every read of the shared file,
+--    including no-op reads and refusals. `file_hash` drives the skip
+--    path in SharedLayer.import() (D8-14).
+CREATE TABLE IF NOT EXISTS okf_imports (
+  id               TEXT PRIMARY KEY,
+  repo_id          TEXT NOT NULL,
+  path             TEXT NOT NULL,
+  file_hash        TEXT,
+  entries_parsed   INTEGER NOT NULL DEFAULT 0,
+  entries_folded   INTEGER NOT NULL DEFAULT 0,
+  entries_rejected INTEGER NOT NULL DEFAULT 0,
+  skipped          INTEGER NOT NULL DEFAULT 0,
+  imported_at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_okf_imports_repo
+  ON okf_imports(repo_id, imported_at);
+
+-- 3. memories: the second scoping dimension and the layer marker.
+--    repo_id is NULLABLE and back-filled by the post-apply hook, not by
+--    a DEFAULT: the value depends on the row's existing project_id and
+--    SQLite cannot express that in a column default.
+--    layer carries NO CHECK constraint - widening it later would force
+--    the migration-004 rebuild path (D8-07). Enforced in TypeScript.
+ALTER TABLE memories ADD COLUMN repo_id TEXT;
+ALTER TABLE memories ADD COLUMN layer TEXT NOT NULL DEFAULT 'local';
+ALTER TABLE memories ADD COLUMN shared_entry_id TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_memories_repo_id
+  ON memories(repo_id, status);
+CREATE INDEX IF NOT EXISTS idx_memories_layer
+  ON memories(layer);
+
+-- 4. kevin_metrics: seed the six v0.8 counters (33 -> 39).
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES
+  ('shared_entries_total',    0),
+  ('shared_entries_imported', 0),
+  ('shared_entries_exported', 0),
+  ('okf_merge_folds',         0),
+  ('rekey_events',            0),
+  ('injections_from_shared',  0);
+
+-- 5. kevin_settings: seed the five v0.8 flags (18 -> 23).
+--    shared_layer_enabled defaults OFF: this release must be opted into,
+--    because its first side effect is a new file in the user's repository.
+--    shared_confidence_floor (0.7) is deliberately STRICTER than
+--    injection_confidence_floor (0.6) - see 5.7.
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES
+  ('shared_layer_enabled',     '0'),
+  ('okf_path',                 '.kevin/knowledge.okf'),
+  ('share_requires_approval',  '1'),
+  ('author_identity_mode',     'hashed'),
+  ('shared_confidence_floor',  '0.7');
+
+-- 6. Seed version 009.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('009');

package/dist/migrations/010_v09_native.sql

@@ -0,0 +1,78 @@
+-- ============================================================
+-- Kevin v0.9.0 "Native" — host surface and hook liveness
+-- Migration 010. Additive only. No table rebuild.
+-- ============================================================
+
+-- 1. Hook liveness. Deliberately NOT project-scoped: a hook is a
+--    property of the host binary, not of a checkout. One row per
+--    hook name, updated in place. See D9-08.
+CREATE TABLE IF NOT EXISTS hook_liveness (
+	hook            TEXT PRIMARY KEY,
+	experimental    INTEGER NOT NULL DEFAULT 0,
+	fire_count      INTEGER NOT NULL DEFAULT 0,
+	error_count     INTEGER NOT NULL DEFAULT 0,
+	expected_count  INTEGER NOT NULL DEFAULT 0,
+	first_seen_at   TEXT,
+	last_seen_at    TEXT,
+	dead_since      TEXT,
+	plugin_version  TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_hook_liveness_dead
+	ON hook_liveness(dead_since);
+
+-- 2. Host probe history. Append-only. Off by default; exists so a
+--    user chasing an intermittent fault can turn it on and get a
+--    timeline instead of a single current value.
+CREATE TABLE IF NOT EXISTS host_probes (
+	id              TEXT PRIMARY KEY,
+	probed_at       TEXT NOT NULL DEFAULT (datetime('now')),
+	plugin_version  TEXT,
+	flavour         TEXT NOT NULL,
+	has_shell       INTEGER NOT NULL DEFAULT 0,
+	v2_skill        INTEGER NOT NULL DEFAULT 0,
+	v2_reference    INTEGER NOT NULL DEFAULT 0,
+	notes           TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_host_probes_at
+	ON host_probes(probed_at);
+
+-- 3. Native registration outcomes. One row per attach attempt, so
+--    "registered but unverified" is a queryable state rather than a
+--    log line.
+CREATE TABLE IF NOT EXISTS native_registrations (
+	id              TEXT PRIMARY KEY,
+	attached_at     TEXT NOT NULL DEFAULT (datetime('now')),
+	surface         TEXT NOT NULL CHECK (surface IN ('skill', 'reference')),
+	registered      INTEGER NOT NULL DEFAULT 0,
+	verified        INTEGER NOT NULL DEFAULT 0,
+	note            TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_native_registrations_surface
+	ON native_registrations(surface, attached_at);
+
+-- 4. Metric seeds (39 -> 45).
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES
+	('hook_fires_total',                0),
+	('hook_errors_total',               0),
+	('hooks_dead_total',                0),
+	('injections_suppressed_dead_hook', 0),
+	('native_registrations_total',      0),
+	('native_registration_failures',    0);
+
+-- 5. Setting seeds (23 -> 27).
+--    hook_liveness_enabled defaults ON: it is a read-only instrument
+--    on the success path, and an instrument nobody switches on is an
+--    instrument nobody has.
+--    native_registration_enabled defaults OFF: it changes where a
+--    curated skill comes from, and that is a change a user opts into.
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES
+	('hook_liveness_enabled',       '1'),
+	('native_registration_enabled', '0'),
+	('host_probe_history_enabled',  '0'),
+	('dead_hook_report_threshold',  '3');
+
+-- 6. Version marker.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('010');

package/dist/migrations/011_v10_proven.sql

@@ -0,0 +1,69 @@
+-- =============================================================
+-- Kevin v1.0.0 "Proven" — migration 011
+-- Adds: perf sampling, benchmark results.
+-- No ALTER TABLE (second release running); no column is retyped.
+-- =============================================================
+
+-- 1. Per-scope latency aggregates, flushed at session.idle.
+--    Machine-scoped: no project_id, for the same reason hook_liveness
+--    has none (v0.9.0 D9-08) — latency is a property of the install.
+CREATE TABLE IF NOT EXISTS perf_samples (
+    id             INTEGER PRIMARY KEY AUTOINCREMENT,
+    scope          TEXT    NOT NULL,
+    sample_count   INTEGER NOT NULL,
+    p50_ms         REAL    NOT NULL,
+    p95_ms         REAL    NOT NULL,
+    max_ms         REAL    NOT NULL,
+    budget_p95_ms  REAL    NOT NULL,
+    within_budget  INTEGER NOT NULL DEFAULT 1,
+    recorded_at    TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_perf_samples_scope
+    ON perf_samples(scope, recorded_at DESC);
+CREATE INDEX IF NOT EXISTS idx_perf_samples_breach
+    ON perf_samples(within_budget) WHERE within_budget = 0;
+
+-- 2. Benchmark results. Append-only. One row per arm per run.
+--    arm CHECK is closed by the plan; widening requires a table rebuild (intentional friction).
+--    scope CHECK is intentionally absent: the scope union may gain members in a 1.x minor.
+CREATE TABLE IF NOT EXISTS bench_runs (
+    id               INTEGER PRIMARY KEY AUTOINCREMENT,
+    corpus_digest    TEXT    NOT NULL,
+    contract_digest  TEXT    NOT NULL,
+    package_version  TEXT    NOT NULL,
+    runtime          TEXT    NOT NULL,
+    arm              TEXT    NOT NULL,
+    k                INTEGER NOT NULL,
+    precision_at_k   REAL    NOT NULL,
+    recall_at_k      REAL    NOT NULL,
+    mrr              REAL    NOT NULL,
+    ran_at           TEXT    NOT NULL DEFAULT (datetime('now')),
+    CHECK (arm IN ('none', 'recent-k', 'random-k', 'kevin'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_bench_runs_corpus
+    ON bench_runs(corpus_digest, ran_at DESC);
+CREATE INDEX IF NOT EXISTS idx_bench_runs_arm
+    ON bench_runs(arm, ran_at DESC);
+
+-- 3. Metric seeds (45 -> 51).
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('perf_samples_recorded', 0);
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('perf_budget_breaches', 0);
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('dispose_fires_total', 0);
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('dispose_misses_total', 0);
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('contract_digest_changes', 0);
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('bench_runs_total', 0);
+
+-- 4. Setting seeds (27 -> 31). All TEXT; '0'/'1' are strings.
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES ('perf_enabled', '1');
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES ('perf_ring_capacity', '512');
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES ('perf_flush_on_idle', '1');
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES ('contract_report_enabled', '1');
+
+-- 5. `dispose` becomes the seventh instrumented hook (v0.9.0 migration 010
+--    seeded six rows; this is a data seed, not a schema change).
+INSERT OR IGNORE INTO hook_liveness (hook) VALUES ('dispose');
+
+-- 6. Schema version.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('011');

package/dist/migrations/012_v11_drift.sql

@@ -0,0 +1,24 @@
+-- millisecond companions for the two tables whose ORDERING decides outcomes.
+ALTER TABLE tool_calls       ADD COLUMN ts_ms           INTEGER;
+ALTER TABLE kevin_injections ADD COLUMN injected_at_ms  INTEGER;
+
+-- conservative backfill: seconds -> ms (x1000). Rows keep their original
+-- second-granularity value in the old column; nothing is rewritten there.
+UPDATE tool_calls SET ts_ms =
+  CAST(strftime('%s', ts) AS INTEGER) * 1000
+WHERE ts_ms IS NULL AND ts IS NOT NULL;
+
+UPDATE kevin_injections SET injected_at_ms =
+  CAST(strftime('%s', injected_at) AS INTEGER) * 1000
+WHERE injected_at_ms IS NULL AND injected_at IS NOT NULL;
+
+CREATE INDEX idx_tool_calls_ts_ms        ON tool_calls(ts_ms);
+CREATE INDEX idx_injections_injected_ms  ON kevin_injections(injected_at_ms);
+
+-- metric seeds (C-05 additions carry since=1.1.0 in contract)
+INSERT INTO kevin_metrics (key, value, updated_at) VALUES
+  ('bench_regression_failures',    0, datetime('now')),
+  ('forget_requests_total',        0, datetime('now')),
+  ('forget_tombstones_published',  0, datetime('now'));
+
+INSERT INTO schema_version (version) VALUES ('012');

package/dist/native.d.ts

@@ -0,0 +1,23 @@
+import type { Store } from "./Store.js";
+import type { Materializer } from "./Materializer.js";
+export interface NativeRegistration {
+    registered: {
+        skill: boolean;
+        reference: boolean;
+    };
+    verified: {
+        skill: boolean;
+        reference: boolean;
+    };
+    notes: string[];
+}
+export interface SettingsReader {
+    getSetting(key: string, fallback?: string): string | null;
+}
+export interface NativeDeps {
+    materializer: Materializer;
+    settings: SettingsReader;
+    onVerified?: (surface: "skill" | "reference", registered: boolean, verified: boolean) => void;
+    store?: Store;
+}
+export declare const V2_SPECIFIER = "@opencode-ai/plugin/v2/promise";

package/dist/native.js

@@ -0,0 +1 @@
+export const V2_SPECIFIER = "@opencode-ai/plugin/v2/promise";

package/dist/okf-export.d.ts

@@ -0,0 +1,3 @@
+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/okf-export.js

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