@jmtrin/kevin-core 1.5.0 → 2.1.0

package/dist/RepoTruth.js

@@ -393,7 +393,12 @@ export class RepoTruth {
         for (const file of ["package.json", "tsconfig.json"]) {
             try {
                 const st = statSync(join(this.projectRoot, file));
-                out[file] = String(st.mtimeMs);
+                // Include size alongside mtime so a same-tick rewrite with
+                // different bytes is still detected on Windows where mtime
+                // granularity is ~15ms. The stored string is compared as an
+                // opaque token, so legacy rows (bare mtime) will mismatch once
+                // and trigger a re-parse.
+                out[file] = `${String(st.mtimeMs)}:${String(st.size)}`;
             }
             catch {
                 out[file] = null;

package/dist/Retrospective.d.ts

@@ -1,6 +1,6 @@
-import { type KevinEnv } from "./env.js";
 import type { MemoryService } from "./MemoryService.js";
 import type { Store } from "./Store.js";
+import { type KevinEnv } from "./env.js";
 import type { Metrics } from "./metrics.js";
 export interface RetrospectiveOptions {
     dir?: string;

package/dist/Retrospective.js

@@ -91,6 +91,12 @@ export const METRIC_KEY_LABELS = {
     skills_emitted_total: "Skills emitidos (total)",
     mif_exports_total: "Exportaciones MIF totales",
     mif_imports_total: "Importaciones MIF totales",
+    // v2.0.0 (K16-012 / plan §4.4) — Commonwealth metrics
+    source_syncs_total: "Sincronizaciones de fuentes (total)",
+    source_dedup_skips_total: "Skips por dedup de fuentes (total)",
+    okf_v3_files_written: "Archivos OKF v3 escritos",
+    // v2.1.0 (K21-005) — Relay deletion metric
+    source_deletions_total: "Borrados de fuente sincronizados (total)",
 };
 function originLabel(origin) {
     if (origin === "reflector")

package/dist/contract.d.ts

@@ -8,7 +8,54 @@ import { type KevinEnv } from "./env.js";
  * core file allowed to call process cwd.
  */
 export declare function resolveScanRoots(env?: KevinEnv): string[];
-export declare const CONTRACT_VERSION = 1;
+export declare const CONTRACT_VERSION = 2;
+export declare const CONTRACT_CORE_EXPORTS: readonly {
+    name: string;
+    kind: string;
+}[];
+export declare const CONTRACT_MCP_TOOLS: readonly string[];
+export declare const CONTRACT_MCP_REFUSALS: readonly string[];
+export declare const CONTRACT_SKILLS_LAYOUT: {
+    readonly canonical_dir: ".agents/skills";
+    readonly skill_dir: "kevin-knowledge";
+    readonly files: readonly ["SKILL.md", "references/*.md"];
+    readonly frontmatter_fields: readonly ["name", "description", "metadata.generator", "metadata.repo_id"];
+    readonly mirror_policy: "copy (not symlink) to .claude/skills and .cursor/skills when enabled";
+};
+export declare const CONTRACT_MIF_PROFILE: {
+    readonly envelope_version: 1;
+    readonly format: "mif";
+    readonly field_mapping: {
+        readonly entry_id: "id";
+        readonly statement: "content";
+        readonly type: "type";
+        readonly scope: "metadata.scope";
+        readonly fingerprint: "metadata.fingerprint";
+        readonly confidence: "metadata.confidence";
+        readonly created_at: "timestamp";
+    };
+    readonly redaction: "SECRET_PATTERNS (PII)";
+    readonly dedup: "content-hash (fingerprint)";
+    readonly vendor_extensions_preserved: true;
+};
+export declare const CONTRACT_MEMORY_SOURCES: {
+    readonly sources: readonly [{
+        readonly name: "opencode-plugin";
+        readonly precedence: 10;
+    }, {
+        readonly name: "claude-memory";
+        readonly precedence: 20;
+    }, {
+        readonly name: "codex-memories";
+        readonly precedence: 30;
+    }, {
+        readonly name: "opencode-native";
+        readonly precedence: 40;
+    }];
+    readonly dedup_rule: "lower precedence wins attribution; losers counted in source_dedup_skips_total";
+    readonly conflict_kind: "source_pair";
+    readonly precedence_order: readonly [10, 20, 30, 40];
+};
 export type Stability = "frozen" | "forward-only";
 export interface ContractClause {
     readonly id: string;
@@ -58,6 +105,16 @@ export declare const CONTRACT_CONFIG_ADDITIONS: readonly {
     name: string;
     since: string;
 }[];
+/**
+ * v2.0.0 (K16-004 / plan §5.1) — removed settings (retirements)
+ * Each entry carries `since` 2.0.0 and optional replacement pointer.
+ * Succession test treats these as LEGITIMATE removals via `removed` annotation.
+ */
+export declare const CONTRACT_REMOVED_CONFIG_KEYS: readonly {
+    name: string;
+    since: string;
+    replacement?: string;
+}[];
 /**
  * v1.0.0 (K10-027 / plan §5.7) — the C-09 boundary addition. Stored is
  * not trusted: anything reaching an artifact or a prompt is escaped at

package/dist/contract.js

@@ -3,8 +3,8 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { MARKER_BEGIN, MARKER_END } from "./ArtifactWriter.js";
-import { resolveEnv } from "./env.js";
 import { METRIC_KEY_LABELS } from "./Retrospective.js";
+import { resolveEnv } from "./env.js";
 import { fnv1a64 } from "./fingerprint.js";
 import { KEVIN_CONFIG_KEYS } from "./index.js";
 import { MAX_ENTRIES, MAX_LINE_BYTES } from "./okf.js";
@@ -45,7 +45,120 @@ export function resolveScanRoots(env) {
     // Fallback to monorepo relative (even if not yet built)
     return [monorepoPlugin, monorepoCore];
 }
-export const CONTRACT_VERSION = 1;
+export const CONTRACT_VERSION = 2;
+// v2.0.0 (K16-001 / plan §4.1) — C-10 core exports (names + kinds, since 1.3.0)
+// Explicit export list at packages/core/src/index.ts — keep minimal.
+export const CONTRACT_CORE_EXPORTS = [
+    { name: "Archiver", kind: "class" },
+    { name: "ArtifactWriter", kind: "class" },
+    { name: "CausalChain", kind: "class" },
+    { name: "ChatBridge", kind: "module" },
+    { name: "ConflictDetector", kind: "class" },
+    { name: "ContextInjector", kind: "class" },
+    { name: "ConventionMiner", kind: "class" },
+    { name: "Curator", kind: "class" },
+    { name: "DashboardHtml", kind: "module" },
+    { name: "Feedback", kind: "class" },
+    { name: "HookLiveness", kind: "class" },
+    { name: "InjectionLedger", kind: "class" },
+    { name: "LessonFixer", kind: "module" },
+    { name: "Materializer", kind: "class" },
+    { name: "MemoryService", kind: "class" },
+    { name: "Migrate", kind: "class" },
+    { name: "PatternMiner", kind: "class" },
+    { name: "QualityGate", kind: "class" },
+    { name: "Reflector", kind: "class" },
+    { name: "RepoIdentity", kind: "module" },
+    { name: "RepoTruth", kind: "class" },
+    { name: "Retrospective", kind: "class" },
+    { name: "SharedLayer", kind: "class" },
+    { name: "Store", kind: "class" },
+    { name: "ToolCallObserver", kind: "class" },
+    { name: "TuiSnapshots", kind: "module" },
+    { name: "buildAudit", kind: "function" },
+    { name: "buildDoctor", kind: "function" },
+    { name: "buildKevinContract", kind: "function" },
+    { name: "computeConfidence", kind: "function" },
+    { name: "describeContract", kind: "function" },
+    { name: "escapeForFence", kind: "function" },
+    { name: "escapeForMarkerBlock", kind: "function" },
+    { name: "fingerprint", kind: "function" },
+    { name: "fnv1a64", kind: "function" },
+    { name: "kevin_approve", kind: "function" },
+    { name: "kevin_bench", kind: "function" },
+    { name: "kevin_forget", kind: "function" },
+    { name: "kevin_why", kind: "function" },
+    { name: "resolveEnv", kind: "function" },
+    { name: "uuidv7", kind: "function" },
+];
+// v2.0.0 (K16-001) — C-11 MCP tool names/shapes + refusal vocabulary, since 1.4.0
+export const CONTRACT_MCP_TOOLS = [
+    "approve",
+    "feedback",
+    "get",
+    "ping",
+    "query",
+    "recall",
+    "save",
+    "share",
+    "status",
+    "trace",
+    "why",
+];
+export const CONTRACT_MCP_REFUSALS = [
+    "disabled",
+    "repo_mismatch",
+    "not_okf",
+    "version_ahead",
+    "unknown_entry",
+    "parse_damaged",
+    "line_too_long",
+    "below_floor",
+    "not_curated",
+    "too_many_entries",
+];
+// v2.0.0 (K16-001) — C-12 emitted skills layout, since 1.5.0
+export const CONTRACT_SKILLS_LAYOUT = {
+    canonical_dir: ".agents/skills",
+    skill_dir: "kevin-knowledge",
+    files: ["SKILL.md", "references/*.md"],
+    frontmatter_fields: [
+        "name",
+        "description",
+        "metadata.generator",
+        "metadata.repo_id",
+    ],
+    mirror_policy: "copy (not symlink) to .claude/skills and .cursor/skills when enabled",
+};
+// v2.0.0 (K16-001) — C-13 MIF profile, since 1.5.0
+export const CONTRACT_MIF_PROFILE = {
+    envelope_version: 1,
+    format: "mif",
+    field_mapping: {
+        entry_id: "id",
+        statement: "content",
+        type: "type",
+        scope: "metadata.scope",
+        fingerprint: "metadata.fingerprint",
+        confidence: "metadata.confidence",
+        created_at: "timestamp",
+    },
+    redaction: "SECRET_PATTERNS (PII)",
+    dedup: "content-hash (fingerprint)",
+    vendor_extensions_preserved: true,
+};
+// v2.0.0 (K16-001) — C-14 MemorySources, since 2.0.0
+export const CONTRACT_MEMORY_SOURCES = {
+    sources: [
+        { name: "opencode-plugin", precedence: 10 },
+        { name: "claude-memory", precedence: 20 },
+        { name: "codex-memories", precedence: 30 },
+        { name: "opencode-native", precedence: 40 },
+    ],
+    dedup_rule: "lower precedence wins attribution; losers counted in source_dedup_skips_total",
+    conflict_kind: "source_pair",
+    precedence_order: [10, 20, 30, 40],
+};
 // Tool names — the live source of truth for C-03. Any rename here must
 // flow to the contract (K10-006 AC: renaming a tool changes C-03).
 // Keep this array adjacent to the actual tool registrations in index.ts
@@ -85,6 +198,7 @@ export const CONTRACT_TOOL_ADDITIONS = [
     { name: "kevin_bench", since: "1.0.0" },
     { name: "kevin_contract", since: "1.0.0" },
     { name: "kevin_forget", since: "1.1.0" },
+    { name: "kevin_sources", since: "2.0.0" },
 ];
 /**
  * v1.1.0 (K11-007 / plan §5.1, D11-01) — metric keys added after the freeze,
@@ -107,6 +221,11 @@ export const CONTRACT_METRIC_ADDITIONS = [
     { name: "mif_exports_total", since: "1.5.0" },
     { name: "mif_imports_total", since: "1.5.0" },
     { name: "skills_emitted_total", since: "1.5.0" },
+    // v2.0.0 (K16-012 / plan §4.4) — Commonwealth metrics
+    { name: "source_syncs_total", since: "2.0.0" },
+    { name: "source_dedup_skips_total", since: "2.0.0" },
+    { name: "okf_v3_files_written", since: "2.0.0" },
+    { name: "source_deletions_total", since: "2.1.0" },
 ];
 /**
  * v1.4.0 (K14-006 / plan §4.3) — config keys added after the freeze,
@@ -121,6 +240,25 @@ export const CONTRACT_CONFIG_ADDITIONS = [
     { name: "skills_canonical_dir", since: "1.5.0" },
     { name: "skills_mirror_claude", since: "1.5.0" },
     { name: "skills_mirror_cursor", since: "1.5.0" },
+    // v2.0.0 (K16-013 / plan §4.4) — Commonwealth settings (retirement of import_host_memory handled via removals)
+    { name: "okf_write_version", since: "2.0.0" },
+    { name: "source_claude_memory", since: "2.0.0" },
+    { name: "source_codex_memories", since: "2.0.0" },
+    { name: "source_opencode_native", since: "2.0.0" },
+    { name: "sources_enabled", since: "2.0.0" },
+    { name: "source_deletion_sync", since: "2.1.0" },
+];
+/**
+ * v2.0.0 (K16-004 / plan §5.1) — removed settings (retirements)
+ * Each entry carries `since` 2.0.0 and optional replacement pointer.
+ * Succession test treats these as LEGITIMATE removals via `removed` annotation.
+ */
+export const CONTRACT_REMOVED_CONFIG_KEYS = [
+    {
+        name: "import_host_memory",
+        since: "2.0.0",
+        replacement: "sources_enabled + source_claude_memory/source_codex_memories",
+    },
 ];
 /**
  * v1.0.0 (K10-027 / plan §5.7) — the C-09 boundary addition. Stored is
@@ -166,7 +304,14 @@ export function describeContract(_input) {
     const baseConfigKeys = [...KEVIN_CONFIG_KEYS]
         .filter((k) => !configAdditions.some((a) => a.name === k))
         .sort();
-    const settingValue = { keys: [...baseConfigKeys, ...configAdditions].flat() };
+    // v2.0.0 (K16-004/005) — removed keys are filtered from `keys` and surfaced via `removed` annotation with since 2.0.0
+    const removedConfig = [...CONTRACT_REMOVED_CONFIG_KEYS].sort((a, b) => a.name.localeCompare(b.name));
+    const filteredConfigAdditions = configAdditions.filter((a) => !removedConfig.some((r) => r.name === a.name));
+    const settingValue = {
+        keys: [...baseConfigKeys, ...filteredConfigAdditions].flat(),
+    };
+    if (removedConfig.length > 0)
+        settingValue.removed = removedConfig;
     // v1.1.0 — metric keys added after freeze carry `since` (C-05)
     const metricAdditions = [...CONTRACT_METRIC_ADDITIONS].sort((a, b) => a.name.localeCompare(b.name));
     const baseMetricKeys = Object.keys(METRIC_KEY_LABELS)
@@ -240,7 +385,7 @@ export function describeContract(_input) {
             stability: "forward-only",
             since: "0.1.0",
             value: {
-                schema_version: "013",
+                schema_version: "015",
                 migrations_forward_only: true,
             },
         },
@@ -274,6 +419,46 @@ export function describeContract(_input) {
                 boundary: [{ name: BOUNDARY_INVARIANT, since: "1.0.0" }],
             },
         },
+        {
+            id: "C-10",
+            title: "Core public exports",
+            stability: "frozen",
+            since: "1.3.0",
+            value: {
+                exports: [...CONTRACT_CORE_EXPORTS].sort((a, b) => a.name.localeCompare(b.name)),
+            },
+        },
+        {
+            id: "C-11",
+            title: "MCP tool names and refusal vocabulary",
+            stability: "frozen",
+            since: "1.4.0",
+            value: {
+                tools: [...CONTRACT_MCP_TOOLS].sort(),
+                refusals: [...CONTRACT_MCP_REFUSALS].sort(),
+            },
+        },
+        {
+            id: "C-12",
+            title: "Emitted skills layout",
+            stability: "frozen",
+            since: "1.5.0",
+            value: CONTRACT_SKILLS_LAYOUT,
+        },
+        {
+            id: "C-13",
+            title: "MIF profile",
+            stability: "frozen",
+            since: "1.5.0",
+            value: CONTRACT_MIF_PROFILE,
+        },
+        {
+            id: "C-14",
+            title: "MemorySources",
+            stability: "frozen",
+            since: "2.0.0",
+            value: CONTRACT_MEMORY_SOURCES,
+        },
     ];
     return { contractVersion: CONTRACT_VERSION, clauses };
 }
@@ -377,6 +562,33 @@ export function diffContract(golden, live) {
         // Normalize members: for arrays we care about set equality
         for (const [mem, _gv] of gMembers) {
             if (!lMembers.has(mem)) {
+                // v2.0.0 (K16-005) — allow removals that are annotated via `removed` array with since (e.g. import_host_memory)
+                const liveVal = l.value;
+                if (Array.isArray(liveVal.removed)) {
+                    const entry = liveVal.removed.find((e) => {
+                        if (typeof e === "string")
+                            return e === mem;
+                        if (e !== null &&
+                            typeof e === "object" &&
+                            "name" in e)
+                            return e.name === mem;
+                        return false;
+                    });
+                    const hasSince = entry !== null &&
+                        typeof entry === "object" &&
+                        typeof entry.since === "string" &&
+                        entry.since !== "";
+                    if (entry !== undefined && hasSince) {
+                        // Annotated removal — treat as allowed (like added_ok). Do not flag as confusing.
+                        diffs.push({
+                            clauseId: g.id,
+                            path: `${g.id}.${mem}`,
+                            kind: "added_ok",
+                            remedy: `Member ${mem} in ${g.id} was removed with since. Allowed in 2.0.0.`,
+                        });
+                        continue;
+                    }
+                }
                 diffs.push({
                     clauseId: g.id,
                     path: `${g.id}.${mem}`,

package/dist/import-host.d.ts

@@ -1,6 +1,6 @@
-import { type KevinEnv } from "./env.js";
 import type { MemoryService } from "./MemoryService.js";
 import type { Store } from "./Store.js";
+import { type KevinEnv } from "./env.js";
 import type { Metrics } from "./metrics.js";
 export interface HostImportReport {
     files_scanned: number;

package/dist/import-host.js

@@ -1,10 +1,10 @@
 // K15-011/012/013 — Host importers (plan §4.5)
 // Defensive markdown parsers, no YAML lib, same naive parser as validator.
-import { existsSync, lstatSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+import { QualityGate } from "./QualityGate.js";
 import { resolveEnv } from "./env.js";
 import { fingerprint as computeFingerprint } from "./fingerprint.js";
-import { QualityGate } from "./QualityGate.js";
 const MAX_FILE_BYTES = 1 * 1024 * 1024;
 const MAX_CANDIDATES = 5000;
 const CLAUDE_TYPE_MAP = {
@@ -134,7 +134,9 @@ export function parseClaudeMemory(dataRoot, env) {
                 }
                 // if frontmatter exists but type missing, map to context
             }
-            const mapped = rawType ? (CLAUDE_TYPE_MAP[rawType.toLowerCase()] ?? "context") : "context";
+            const mapped = rawType
+                ? (CLAUDE_TYPE_MAP[rawType.toLowerCase()] ?? "context")
+                : "context";
             // bullets
             const bullets = extractBullets(content);
             if (bullets.length === 0) {
@@ -201,18 +203,31 @@ export function parseCodexMemories(dataRoot, env) {
 }
 export function importHostMemories(opts) {
     const dataRoot = opts.dataRoot ?? resolveEnv(opts.env).dataRoot;
-    // gate
-    const gate = opts.memoryService.getSetting("import_host_memory", "0");
-    if (gate !== "1") {
-        return {
-            files_scanned: 0,
-            candidates: 0,
-            saved: 0,
-            duplicates: 0,
-            skipped_weak: 0,
-            error: "disabled",
-            hint: "Enable with kevin_config set import_host_memory 1",
-        };
+    // gate — v2.0.0 retired import_host_memory (K16-005); check sources framework.
+    // Legacy fallback kept for pre-014 DBs that still carry the key before migration 014 deletes it.
+    const legacy = opts.memoryService.getSetting("import_host_memory", "0");
+    if (legacy === "1") {
+        // translated by 014; allow but hint new path
+    }
+    else {
+        const master = opts.memoryService.getSetting("sources_enabled", "0") === "1";
+        const perKey = opts.source === "claude-memory"
+            ? "source_claude_memory"
+            : "source_codex_memories";
+        const per = opts.memoryService.getSetting(perKey, "0") === "1";
+        if (!master || !per) {
+            return {
+                files_scanned: 0,
+                candidates: 0,
+                saved: 0,
+                duplicates: 0,
+                skipped_weak: 0,
+                error: "disabled",
+                hint: opts.source === "claude-memory"
+                    ? "Enable with kevin_config set sources_enabled 1 and kevin_config set source_claude_memory 1"
+                    : "Enable with kevin_config set sources_enabled 1 and kevin_config set source_codex_memories 1",
+            };
+        }
     }
     let parsed;
     if (opts.source === "claude-memory") {
@@ -233,7 +248,9 @@ export function importHostMemories(opts) {
     // dedup intra-run via fingerprint set
     const seenFingerprints = new Set();
     // existing fingerprints from DB
-    const existingRows = opts.store.prepare("SELECT fingerprint FROM memories WHERE fingerprint IS NOT NULL").all();
+    const existingRows = opts.store
+        .prepare("SELECT fingerprint FROM memories WHERE fingerprint IS NOT NULL")
+        .all();
     for (const r of existingRows)
         seenFingerprints.add(r.fingerprint);
     for (const c of candidates) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from "./Store.js";
 export * from "./Migrate.js";
-export { MemoryService, DATE_NOW, mapRow, readOriginCallId, countSupersedeCandidates, hasRepoIdColumn } from "./MemoryService.js";
-export type { Memory, SlimMemory, SlimMemoryWithEvidence, SaveInput, QueryInput, GetRelevantInput, MemoryType, MemoryScope, MemoryOrigin, MemoryUpdateResult } from "./MemoryService.js";
+export { MemoryService, DATE_NOW, mapRow, readOriginCallId, countSupersedeCandidates, hasRepoIdColumn, } from "./MemoryService.js";
+export type { Memory, SlimMemory, SlimMemoryWithEvidence, SaveInput, QueryInput, GetRelevantInput, MemoryType, MemoryScope, MemoryOrigin, MemoryUpdateResult, } from "./MemoryService.js";
 export * from "./ToolCallObserver.js";
 export * from "./Reflector.js";
 export * from "./ContextInjector.js";
@@ -38,23 +38,23 @@ export * from "./memory-format.js";
 export * from "./redact.js";
 export * from "./uuid.js";
 export * from "./sqlite-adapter.js";
-export { hasColumn, hasIgnoredColumn, hasCuratedColumn, hasTruthColumns, hasLayerColumn, hasRecurrenceColumn, hasArchivedColumn, hasFeedbackColumns, hasFeedbackTable } from "./columns.js";
+export { hasColumn, hasIgnoredColumn, hasCuratedColumn, hasTruthColumns, hasLayerColumn, hasRecurrenceColumn, hasArchivedColumn, hasFeedbackColumns, hasFeedbackTable, } from "./columns.js";
 export * from "./time-ms.js";
 export * from "./idle-pipeline.js";
 export * from "./replay.js";
 export * from "./replay-types.js";
 export * from "./ChatBridge.js";
 export * from "./DashboardHtml.js";
-export { deleteMailbox, processActions, readMailbox, writeResults, verifyFresh, consumeMailbox } from "./TuiActions.js";
-export type { MailboxReadResult, PendingProposal, ProcessDeps, ActionStatus } from "./TuiActions.js";
+export { deleteMailbox, processActions, readMailbox, writeResults, verifyFresh, consumeMailbox, } from "./TuiActions.js";
+export type { MailboxReadResult, PendingProposal, ProcessDeps, ActionStatus, } from "./TuiActions.js";
 export * from "./TuiSnapshots.js";
-export type { ProposalView, ConflictView, HealthView, TuiSnapshotSet, TuiAction, ActionResult } from "./tui-types.js";
+export type { ProposalView, ConflictView, HealthView, TuiSnapshotSet, TuiAction, ActionResult, } from "./tui-types.js";
 export * from "./capabilities.js";
 export * from "./host.js";
 export { V2_SPECIFIER } from "./native.js";
-export type { NativeDeps, NativeRegistration, SettingsReader } from "./native.js";
+export type { NativeDeps, NativeRegistration, SettingsReader, } from "./native.js";
 export * from "./kevin_approve.js";
-export { buildAudit, type AuditReport, type ChannelReport, type CurationReport, type TruthReport, type EmissionState } from "./kevin_audit.js";
+export { buildAudit, type AuditReport, type ChannelReport, type CurationReport, type TruthReport, type EmissionState, } from "./kevin_audit.js";
 export * from "./kevin_bench.js";
 export * from "./kevin_conflicts.js";
 export * from "./kevin_contract.js";
@@ -70,7 +70,11 @@ export * from "./skills-validate.js";
 export * from "./skills-emit.js";
 export * from "./mif.js";
 export * from "./import-host.js";
+export * from "./okf-shards.js";
+export * from "./sources/MemorySource.js";
+export * from "./sources/IdleSync.js";
+export * from "./sources/deletion.js";
 export * from "./env.js";
-export declare const KEVIN_CONFIG_KEYS: readonly ["quality_gate_enabled", "lesson_snippet_injection", "patternminer_enabled", "cross_project_enabled", "llm_reflection_enabled", "tool_calls_dedup_enabled", "deterministic_retrieval", "pre_prompt_budget_tokens", "archive_after_days", "curation_enabled", "agents_md_path", "skill_emission_enabled", "reference_emission_enabled", "injection_confidence_floor", "repo_truth_enabled", "convention_mining_enabled", "conflict_detection_enabled", "error_lesson_mode", "shared_layer_enabled", "okf_path", "share_requires_approval", "author_identity_mode", "shared_confidence_floor", "hook_liveness_enabled", "native_registration_enabled", "host_probe_history_enabled", "dead_hook_report_threshold", "perf_enabled", "perf_ring_capacity", "perf_flush_on_idle", "contract_report_enabled", "tui_snapshots_enabled", "mcp_write_enabled", "mcp_approve_enabled", "mcp_repo_override", "skills_canonical_dir", "skills_mirror_claude", "skills_mirror_cursor", "import_host_memory"];
+export declare const KEVIN_CONFIG_KEYS: readonly ["quality_gate_enabled", "lesson_snippet_injection", "patternminer_enabled", "cross_project_enabled", "llm_reflection_enabled", "tool_calls_dedup_enabled", "deterministic_retrieval", "pre_prompt_budget_tokens", "archive_after_days", "curation_enabled", "agents_md_path", "skill_emission_enabled", "reference_emission_enabled", "injection_confidence_floor", "repo_truth_enabled", "convention_mining_enabled", "conflict_detection_enabled", "error_lesson_mode", "shared_layer_enabled", "okf_path", "share_requires_approval", "author_identity_mode", "shared_confidence_floor", "hook_liveness_enabled", "native_registration_enabled", "host_probe_history_enabled", "dead_hook_report_threshold", "perf_enabled", "perf_ring_capacity", "perf_flush_on_idle", "contract_report_enabled", "tui_snapshots_enabled", "mcp_write_enabled", "mcp_approve_enabled", "mcp_repo_override", "skills_canonical_dir", "skills_mirror_claude", "skills_mirror_cursor", "sources_enabled", "source_claude_memory", "source_codex_memories", "source_opencode_native", "okf_write_version", "source_deletion_sync"];
 export declare const ERROR_LESSON_MODE_VALUES: readonly ["all", "triage_only"];
-export declare const KEVIN_VERSION = "1.5.0";
+export declare const KEVIN_VERSION = "2.1.0";

package/dist/index.js

@@ -3,7 +3,7 @@
 export * from "./Store.js";
 export * from "./Migrate.js";
 // MemoryService has duplicate hasRepoIdColumn with columns.ts — export selectively (keep MemoryService's hasRepoIdColumn, columns provides other helpers)
-export { MemoryService, DATE_NOW, mapRow, readOriginCallId, countSupersedeCandidates, hasRepoIdColumn } from "./MemoryService.js";
+export { MemoryService, DATE_NOW, mapRow, readOriginCallId, countSupersedeCandidates, hasRepoIdColumn, } from "./MemoryService.js";
 export * from "./ToolCallObserver.js";
 export * from "./Reflector.js";
 export * from "./ContextInjector.js";
@@ -41,7 +41,7 @@ export * from "./redact.js";
 export * from "./uuid.js";
 export * from "./sqlite-adapter.js";
 // columns has duplicate hasRepoIdColumn with MemoryService — export without that function (MemoryService's version is canonical via index)
-export { hasColumn, hasIgnoredColumn, hasCuratedColumn, hasTruthColumns, hasLayerColumn, hasRecurrenceColumn, hasArchivedColumn, hasFeedbackColumns, hasFeedbackTable } from "./columns.js";
+export { hasColumn, hasIgnoredColumn, hasCuratedColumn, hasTruthColumns, hasLayerColumn, hasRecurrenceColumn, hasArchivedColumn, hasFeedbackColumns, hasFeedbackTable, } from "./columns.js";
 export * from "./time-ms.js";
 export * from "./idle-pipeline.js";
 export * from "./replay.js";
@@ -49,7 +49,7 @@ export * from "./replay-types.js";
 export * from "./ChatBridge.js";
 export * from "./DashboardHtml.js";
 // TuiActions duplicates proposalToken with DashboardHtml — export selectively (exclude proposalToken)
-export { deleteMailbox, processActions, readMailbox, writeResults, verifyFresh, consumeMailbox } from "./TuiActions.js";
+export { deleteMailbox, processActions, readMailbox, writeResults, verifyFresh, consumeMailbox, } from "./TuiActions.js";
 export * from "./TuiSnapshots.js";
 // shims for isolation
 export * from "./capabilities.js";
@@ -57,7 +57,7 @@ export * from "./host.js";
 export { V2_SPECIFIER } from "./native.js";
 // kevin_* handlers — avoid duplicate EmissionState / NativeDeps
 export * from "./kevin_approve.js";
-export { buildAudit } from "./kevin_audit.js";
+export { buildAudit, } from "./kevin_audit.js";
 export * from "./kevin_bench.js";
 export * from "./kevin_conflicts.js";
 export * from "./kevin_contract.js";
@@ -72,6 +72,10 @@ export * from "./skills-validate.js";
 export * from "./skills-emit.js";
 export * from "./mif.js";
 export * from "./import-host.js";
+export * from "./okf-shards.js";
+export * from "./sources/MemorySource.js";
+export * from "./sources/IdleSync.js";
+export * from "./sources/deletion.js";
 // KEVIN_CONFIG_KEYS and related constants — moved from adapter index so core owns the source of truth (C-04).
 // Duplicated here to allow adapter to import from core; adapter will re-export them.
 export * from "./env.js";
@@ -114,7 +118,12 @@ export const KEVIN_CONFIG_KEYS = [
     "skills_canonical_dir",
     "skills_mirror_claude",
     "skills_mirror_cursor",
-    "import_host_memory",
+    "sources_enabled",
+    "source_claude_memory",
+    "source_codex_memories",
+    "source_opencode_native",
+    "okf_write_version",
+    "source_deletion_sync",
 ];
 export const ERROR_LESSON_MODE_VALUES = ["all", "triage_only"];
-export const KEVIN_VERSION = "1.5.0";
+export const KEVIN_VERSION = "2.1.0";

package/dist/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", "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", "mcp_requests_total", "mcp_reads_served", "mcp_writes_accepted", "mcp_writes_refused", "mcp_errors_total", "skills_emitted_total", "mif_exports_total", "mif_imports_total"];
+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", "hook_fires_total", "hook_errors_total", "hooks_dead_total", "injections_suppressed_dead_hook", "native_registrations_total", "native_registration_failures", "perf_samples_recorded", "perf_budget_breaches", "dispose_fires_total", "dispose_misses_total", "contract_digest_changes", "bench_runs_total", "bench_regression_failures", "forget_requests_total", "forget_tombstones_published", "tui_snapshots_flushed", "tui_actions_invoked", "mcp_requests_total", "mcp_reads_served", "mcp_writes_accepted", "mcp_writes_refused", "mcp_errors_total", "skills_emitted_total", "mif_exports_total", "mif_imports_total", "source_syncs_total", "source_dedup_skips_total", "okf_v3_files_written", "source_deletions_total"];
 export type MetricKey = (typeof METRIC_KEYS)[number];
 /**
  * Cheap token estimate used when bumping the `tokens_injected_*` counters.

package/dist/metrics.js

@@ -57,6 +57,20 @@ export const METRIC_KEYS = [
     "okf_merge_folds",
     "rekey_events",
     "injections_from_shared",
+    // v0.9.0 (K9-003 / plan §8.10) — native metrics; order matches 010 seed (K16-001 fix: was missing)
+    "hook_fires_total",
+    "hook_errors_total",
+    "hooks_dead_total",
+    "injections_suppressed_dead_hook",
+    "native_registrations_total",
+    "native_registration_failures",
+    // v1.0.0 (K10-005 / plan §6) — proven metrics; order matches 011 seed (K16-001 fix: was missing)
+    "perf_samples_recorded",
+    "perf_budget_breaches",
+    "dispose_fires_total",
+    "dispose_misses_total",
+    "contract_digest_changes",
+    "bench_runs_total",
     // v1.1.0 (K11-001 / plan §4, D11-01) — drift metrics; order matches 012 seed.
     "bench_regression_failures",
     "forget_requests_total",
@@ -75,6 +89,12 @@ export const METRIC_KEYS = [
     "skills_emitted_total",
     "mif_exports_total",
     "mif_imports_total",
+    // v2.0.0 (K16-012 / plan §4.4) — Commonwealth metrics
+    "source_syncs_total",
+    "source_dedup_skips_total",
+    "okf_v3_files_written",
+    // v2.1.0 (K21-005 / plan §4.3) — Relay deletion metric (opt-in, default 0)
+    "source_deletions_total",
 ];
 const DEFAULT_FLUSH_MS = 1000;
 function zeroCache() {