@jmtrin/kevin-core 2.0.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

@@ -95,6 +95,8 @@ export const METRIC_KEY_LABELS = {
     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.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";
@@ -122,7 +122,12 @@ 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"],
+    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
@@ -220,6 +225,7 @@ export const CONTRACT_METRIC_ADDITIONS = [
     { 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,
@@ -240,6 +246,7 @@ export const CONTRACT_CONFIG_ADDITIONS = [
     { 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)
@@ -378,7 +385,7 @@ export function describeContract(_input) {
             stability: "forward-only",
             since: "0.1.0",
             value: {
-                schema_version: "014",
+                schema_version: "015",
                 migrations_forward_only: true,
             },
         },
@@ -417,7 +424,9 @@ export function describeContract(_input) {
             title: "Core public exports",
             stability: "frozen",
             since: "1.3.0",
-            value: { exports: [...CONTRACT_CORE_EXPORTS].sort((a, b) => a.name.localeCompare(b.name)) },
+            value: {
+                exports: [...CONTRACT_CORE_EXPORTS].sort((a, b) => a.name.localeCompare(b.name)),
+            },
         },
         {
             id: "C-11",

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";
@@ -73,7 +73,8 @@ 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", "sources_enabled", "source_claude_memory", "source_codex_memories", "source_opencode_native", "okf_write_version"];
+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 = "2.0.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";
@@ -75,6 +75,7 @@ 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";
@@ -122,6 +123,7 @@ export const KEVIN_CONFIG_KEYS = [
     "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 = "2.0.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", "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"];
+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

@@ -93,6 +93,8 @@ export const METRIC_KEYS = [
     "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() {

package/dist/migrations/015_v21_relay.sql

@@ -0,0 +1,20 @@
+-- ============================================================
+-- Kevin v2.1.0 "Relay" — Source deletion + Relay metrics
+-- Migration 015. Forward-only. Additive only.
+-- ============================================================
+
+-- 1. Add source provenance column to memories (K21-005)
+-- Stores the MemorySource name (opencode-plugin, claude-memory, codex-memories, opencode-native)
+-- Nullable for legacy rows; new source-inserted rows populate it.
+ALTER TABLE memories ADD COLUMN source TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_memories_source ON memories(source) WHERE source IS NOT NULL;
+
+-- 2. New metric: source_deletions_total (K21-005)
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES ('source_deletions_total', 0);
+
+-- 3. New settings seed (K21-005, D21-03: opt-in default 0)
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES ('source_deletion_sync', '0');
+
+-- 4. Version marker
+INSERT OR IGNORE INTO schema_version (version) VALUES ('015');

package/dist/okf-shards.d.ts

@@ -1,4 +1,4 @@
-import { parse, type OkfEntry } from "./okf.js";
+import { type OkfEntry, parse } from "./okf.js";
 export declare const SHARD_CAP = 2000;
 export declare const PRIMARY = "knowledge.okf";
 export interface ReadResult {

package/dist/okf-shards.js

@@ -1,5 +1,5 @@
 // K16-008 — Shard reader/writer (minimal stub, satisfies typecheck and tests for 1999/2000/2001/4500)
-import { existsSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from "node:fs";
 import { join } from "node:path";
 import { MAX_ENTRIES, parse, serialize } from "./okf.js";
 export const SHARD_CAP = MAX_ENTRIES; // 2000
@@ -15,7 +15,11 @@ export function readShards(dir) {
     if (existsSync(primaryPath))
         files.push(primaryPath);
     // lexicographic shards excluding primary
-    const all = existsSync(dir) ? readdirSync(dir).filter(f => f.startsWith("knowledge-") && f.endsWith(".okf")).sort() : [];
+    const all = existsSync(dir)
+        ? readdirSync(dir)
+            .filter((f) => f.startsWith("knowledge-") && f.endsWith(".okf"))
+            .sort()
+        : [];
     for (const f of all) {
         const p = join(dir, f);
         if (!files.includes(p))
@@ -42,6 +46,7 @@ export function readShards(dir) {
     return { entries, files, rejected };
 }
 export function writeShards(dir, entries, repoId, version, okfVersion = 2) {
+    mkdirSync(dir, { recursive: true });
     // idempotent: pack primary to SHARD_CAP, overflow to shards, collapse sparse gaps, delete empty trailing
     const sorted = [...entries].sort((a, b) => a.entry_id < b.entry_id ? -1 : a.entry_id > b.entry_id ? 1 : 0);
     if (okfVersion === 2) {
@@ -50,7 +55,7 @@ export function writeShards(dir, entries, repoId, version, okfVersion = 2) {
         writeFileSync(join(dir, PRIMARY), txt, "utf8");
         // delete any stray shards
         if (existsSync(dir)) {
-            for (const f of readdirSync(dir).filter(x => x.startsWith("knowledge-") && x.endsWith(".okf"))) {
+            for (const f of readdirSync(dir).filter((x) => x.startsWith("knowledge-") && x.endsWith(".okf"))) {
                 try {
                     unlinkSync(join(dir, f));
                 }
@@ -86,7 +91,7 @@ export function writeShards(dir, entries, repoId, version, okfVersion = 2) {
     }
     // delete any shards beyond kept (sparse gaps)
     if (existsSync(dir)) {
-        for (const f of readdirSync(dir).filter(x => x.startsWith("knowledge-") && x.endsWith(".okf"))) {
+        for (const f of readdirSync(dir).filter((x) => x.startsWith("knowledge-") && x.endsWith(".okf"))) {
             const p = join(dir, f);
             if (!toKeep.includes(p) && existsSync(p))
                 try {

package/dist/okf.js

@@ -175,9 +175,8 @@ export function parse(text) {
         };
     }
     if (version !== OKF_VERSION && version !== OKF_V3) {
-        // Unknown version below ahead — treat as not_okf for safety
-        // But keep version_ahead semantics for future-proofing
-        // For K16-007, only 2 and 3 are valid
+        reject(1, "not_okf");
+        return { version, repoId: null, entries: [], rejected, folded: 0 };
     }
     if (lines[1]?.startsWith("#repo ")) {
         repoId = lines[1].slice(6) || null;

package/dist/sources/ClaudeMemorySource.js

@@ -1,7 +1,7 @@
 // K16-014 — ClaudeMemorySource (read-only mirror of ~/.claude/memory)
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { homedir } from "node:os";
+import { join } from "node:path";
 export class ClaudeMemorySource {
     enabledFlag;
     root;
@@ -11,26 +11,52 @@ export class ClaudeMemorySource {
         this.enabledFlag = enabledFlag;
         this.root = root;
     }
-    enabled() { return this.enabledFlag(); }
+    enabled() {
+        return this.enabledFlag();
+    }
     async fetch() {
         if (!this.enabled())
             return [];
         const memPath = join(this.root, "memory");
-        // Could be directory of markdown files or single file — best-effort
         if (!existsSync(memPath))
             return [];
+        const out = [];
         try {
-            const txt = readFileSync(memPath, "utf8");
-            // naive: split lines non-empty as statements
-            return txt.split("\n").map(s => s.trim()).filter(Boolean).slice(0, 100).map(statement => ({
-                statement,
-                type: "rule",
-                scope: null,
-                source: this.name,
-            }));
+            const st = statSync(memPath);
+            if (st.isDirectory()) {
+                for (const f of readdirSync(memPath)) {
+                    if (!f.endsWith(".md") && !f.endsWith(".txt"))
+                        continue;
+                    try {
+                        const txt = readFileSync(join(memPath, f), "utf8");
+                        for (const line of txt.split("\n").map((s) => s.trim()).filter(Boolean).slice(0, 50)) {
+                            if (out.length >= 100)
+                                break;
+                            out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                        }
+                    }
+                    catch { }
+                }
+                return out;
+            }
+            if (st.isFile()) {
+                const txt = readFileSync(memPath, "utf8");
+                return txt
+                    .split("\n")
+                    .map((s) => s.trim())
+                    .filter(Boolean)
+                    .slice(0, 100)
+                    .map((statement) => ({
+                    statement,
+                    type: "rule",
+                    scope: null,
+                    source: this.name,
+                }));
+            }
         }
         catch {
-            return [];
+            return out;
         }
+        return out;
     }
 }

package/dist/sources/CodexMemoriesSource.js

@@ -1,7 +1,7 @@
 // K16-015 — CodexMemoriesSource (mirror of ~/.codex/memories)
 import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { join } from "node:path";
 import { homedir } from "node:os";
+import { join } from "node:path";
 export class CodexMemoriesSource {
     enabledFlag;
     root;
@@ -11,7 +11,9 @@ export class CodexMemoriesSource {
         this.enabledFlag = enabledFlag;
         this.root = root;
     }
-    enabled() { return this.enabledFlag(); }
+    enabled() {
+        return this.enabledFlag();
+    }
     async fetch() {
         if (!this.enabled())
             return [];
@@ -24,8 +26,17 @@ export class CodexMemoriesSource {
                     continue;
                 try {
                     const txt = readFileSync(join(this.root, f), "utf8");
-                    for (const line of txt.split("\n").map(s => s.trim()).filter(Boolean).slice(0, 50)) {
-                        out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                    for (const line of txt
+                        .split("\n")
+                        .map((s) => s.trim())
+                        .filter(Boolean)
+                        .slice(0, 50)) {
+                        out.push({
+                            statement: line,
+                            type: "rule",
+                            scope: null,
+                            source: this.name,
+                        });
                     }
                 }
                 catch { }

package/dist/sources/IdleSync.d.ts

@@ -1,3 +1,4 @@
+import type { SharedLayer } from "../SharedLayer.js";
 import type { Store } from "../Store.js";
 import type { MemorySource, SourceSyncResult } from "./MemorySource.js";
 export interface SyncDeps {
@@ -6,5 +7,7 @@ export interface SyncDeps {
     metrics?: {
         incr(key: string, by?: number): void;
     };
+    sharedLayer?: SharedLayer;
+    okfPath?: string;
 }
 export declare function idleSync(deps: SyncDeps): Promise<SourceSyncResult[]>;

package/dist/sources/IdleSync.js

@@ -1,14 +1,28 @@
 import { fingerprint } from "../fingerprint.js";
+import { collectDeletions } from "./deletion.js";
 function dedupKey(e) {
     // lower precedence wins attribution: fingerprint over normalized statement + scope
     return fingerprint(`${e.type}\0${e.statement}\0${e.scope ?? ""}`);
 }
+function isDeletionSyncEnabled(store) {
+    try {
+        const row = store
+            .prepare("SELECT value FROM kevin_settings WHERE key = 'source_deletion_sync'")
+            .get();
+        return row?.value === "1";
+    }
+    catch {
+        return false;
+    }
+}
 export async function idleSync(deps) {
     const results = [];
     const seen = new Set();
     // Pre-populate dedup with existing memories fingerprints (lowest precedence already wins)
     try {
-        const rows = deps.store.prepare("SELECT fingerprint FROM memories").all();
+        const rows = deps.store
+            .prepare("SELECT fingerprint FROM memories")
+            .all();
         for (const r of rows)
             if (r.fingerprint)
                 seen.add(r.fingerprint);
@@ -16,10 +30,27 @@ export async function idleSync(deps) {
     catch { }
     for (const src of deps.sources.sort((a, b) => a.precedence - b.precedence)) {
         if (!src.enabled()) {
-            results.push({ source: src.name, fetched: 0, dedupSkipped: 0, inserted: 0 });
+            results.push({
+                source: src.name,
+                fetched: 0,
+                dedupSkipped: 0,
+                inserted: 0,
+            });
             continue;
         }
-        const entries = await src.fetch().catch(() => []);
+        let entries = [];
+        let fetchOk = true;
+        try {
+            entries = await src.fetch();
+        }
+        catch {
+            fetchOk = false;
+            entries = [];
+        }
+        // current fingerprints for deletion diff (raw, before dedup)
+        const currentFps = new Set();
+        for (const e of entries)
+            currentFps.add(dedupKey(e));
         let dedupSkipped = 0;
         let inserted = 0;
         for (const e of entries) {
@@ -29,10 +60,24 @@ export async function idleSync(deps) {
                 continue;
             }
             seen.add(fp);
-            // Insert as memory with source provenance (simplified)
+            // Insert as memory with source provenance (K21-005: source column)
+            // Use relevance_score (not confidence) per schema; source col added in 015.
+            // Normalize scope: null → 'project' (schema CHECK)
+            const normScope = e.scope ?? "project";
             try {
-                deps.store.prepare(`INSERT OR IGNORE INTO memories (id, project_id, type, content, scope, fingerprint, confidence, origin, source, created_at)
-           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`).run(`src-${fp.slice(0, 12)}-${src.name}`, "default", e.type, e.statement, e.scope, fp, 0.5, src.name, src.name);
+                try {
+                    deps.store
+                        .prepare(`INSERT OR IGNORE INTO memories (id, project_id, type, content, scope, fingerprint, relevance_score, origin, source, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`)
+                        .run(`src-${fp.slice(0, 12)}-${src.name}`, "default", e.type, e.statement, normScope, fp, 0.5, "agent", src.name);
+                }
+                catch {
+                    // pre-015 DB without source column: store source in source_tool as fallback
+                    deps.store
+                        .prepare(`INSERT OR IGNORE INTO memories (id, project_id, type, content, scope, fingerprint, relevance_score, origin, source_tool, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))`)
+                        .run(`src-${fp.slice(0, 12)}-${src.name}`, "default", e.type, e.statement, normScope, fp, 0.5, "agent", src.name);
+                }
                 inserted++;
             }
             catch {
@@ -43,7 +88,110 @@ export async function idleSync(deps) {
             deps.metrics?.incr("source_dedup_skips_total", dedupSkipped);
         if (inserted > 0)
             deps.metrics?.incr("source_syncs_total", 1);
-        results.push({ source: src.name, fetched: entries.length, dedupSkipped, inserted });
+        // K21-005 — deletion sync: if a previously-saved memory from this source
+        // is no longer in the current fetch, archive it (+ tombstone if exported).
+        // Gated by source_deletion_sync='1' (opt-in in 2.1.0, D21-03).
+        // Only run when fetch succeeded; transient errors must not mass-archive.
+        if (fetchOk && isDeletionSyncEnabled(deps.store)) {
+            try {
+                let prevRows = [];
+                try {
+                    prevRows = deps.store
+                        .prepare("SELECT id, fingerprint, shared_entry_id, layer FROM memories WHERE source = ? AND status != 'archived' AND fingerprint IS NOT NULL")
+                        .all(src.name);
+                }
+                catch {
+                    // pre-015 DB: source column missing → use source_tool as provenance
+                    try {
+                        prevRows = deps.store
+                            .prepare("SELECT id, fingerprint, shared_entry_id, layer FROM memories WHERE source_tool = ? AND status != 'archived' AND fingerprint IS NOT NULL")
+                            .all(src.name);
+                    }
+                    catch {
+                        prevRows = [];
+                    }
+                }
+                const prevFps = new Set();
+                const rowByFp = new Map();
+                for (const r of prevRows) {
+                    if (!r.fingerprint)
+                        continue;
+                    prevFps.add(r.fingerprint);
+                    // keep first id per fingerprint
+                    if (!rowByFp.has(r.fingerprint))
+                        rowByFp.set(r.fingerprint, { id: r.id, shared_entry_id: r.shared_entry_id, layer: r.layer });
+                }
+                const deletions = collectDeletions(prevFps, currentFps, src.name);
+                for (const d of deletions) {
+                    const info = rowByFp.get(d.fingerprint);
+                    if (!info)
+                        continue;
+                    // archive locally
+                    try {
+                        deps.store
+                            .prepare("UPDATE memories SET status='archived', archived_at=datetime('now'), updated_at=datetime('now') WHERE id=? AND status!='archived'")
+                            .run(info.id);
+                        const ch = deps.store.prepare("SELECT changes() AS c").get();
+                        if (ch.c === 0)
+                            continue;
+                    }
+                    catch {
+                        continue;
+                    }
+                    // tombstone if ever exported (shared layer)
+                    const isShared = info.layer === "shared" || info.shared_entry_id !== null;
+                    if (isShared && deps.sharedLayer && deps.okfPath) {
+                        try {
+                            const entryId = info.shared_entry_id;
+                            if (entryId) {
+                                const plan = deps.sharedLayer.planTombstone([entryId], deps.okfPath);
+                                if (plan.write.outcome !== "refused") {
+                                    deps.sharedLayer.applyExport(plan);
+                                }
+                            }
+                        }
+                        catch {
+                            // best-effort, never throw
+                        }
+                    }
+                    else if (!isShared && deps.sharedLayer && deps.okfPath) {
+                        // For non-shared memories that were previously exported via shared_entries check
+                        // we attempt tombstone via content-derived entry_id only if a shared entry exists
+                        try {
+                            const row = deps.store
+                                .prepare("SELECT entry_id FROM shared_entries WHERE statement = (SELECT content FROM memories WHERE id=?) LIMIT 1")
+                                .get(info.id);
+                            if (row?.entry_id) {
+                                const plan = deps.sharedLayer.planTombstone([row.entry_id], deps.okfPath);
+                                if (plan.write.outcome !== "refused")
+                                    deps.sharedLayer.applyExport(plan);
+                            }
+                        }
+                        catch { }
+                    }
+                    try {
+                        if (deps.metrics) {
+                            deps.metrics.incr("source_deletions_total", 1);
+                        }
+                        else {
+                            deps.store
+                                .prepare(`INSERT INTO kevin_metrics (key, value, updated_at) VALUES ('source_deletions_total', 1, datetime('now')) ON CONFLICT(key) DO UPDATE SET value = value + 1, updated_at = datetime('now')`)
+                                .run();
+                        }
+                    }
+                    catch { }
+                }
+            }
+            catch {
+                // best-effort, never break sync
+            }
+        }
+        results.push({
+            source: src.name,
+            fetched: entries.length,
+            dedupSkipped,
+            inserted,
+        });
     }
     return results;
 }

package/dist/sources/OpencodeNativeSource.d.ts

@@ -1,4 +1,5 @@
 import type { MemorySource, SourceEntry } from "./MemorySource.js";
+export declare const NATIVE_CANDIDATE_PATHS: readonly [".opencode/memory/*.md", ".opencode/MEMORY.md"];
 export declare class OpencodeNativeSource implements MemorySource {
     private enabledFlag;
     private projectRoot;
@@ -7,4 +8,8 @@ export declare class OpencodeNativeSource implements MemorySource {
     constructor(enabledFlag: () => boolean, projectRoot?: string);
     enabled(): boolean;
     fetch(): Promise<SourceEntry[]>;
+    health(): {
+        status: "ok" | "absent";
+        detail: string;
+    };
 }

package/dist/sources/OpencodeNativeSource.js

@@ -1,6 +1,20 @@
 // K16-016 — OpencodeNativeSource (native opencode memories, e.g. .opencode/memory)
-import { existsSync, readFileSync } from "node:fs";
+// K21-006 — Relay probe activation: single-source location list, absent-safe
+import { readdirSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
+export const NATIVE_CANDIDATE_PATHS = [
+    ".opencode/memory/*.md",
+    ".opencode/MEMORY.md",
+];
+function globMdFiles(dir) {
+    try {
+        const entries = readdirSync(dir);
+        return entries.filter((f) => f.endsWith(".md")).map((f) => join(dir, f));
+    }
+    catch {
+        return [];
+    }
+}
 export class OpencodeNativeSource {
     enabledFlag;
     projectRoot;
@@ -10,24 +24,112 @@ export class OpencodeNativeSource {
         this.enabledFlag = enabledFlag;
         this.projectRoot = projectRoot;
     }
-    enabled() { return this.enabledFlag(); }
+    enabled() {
+        return this.enabledFlag();
+    }
     async fetch() {
         if (!this.enabled())
             return [];
-        const p = join(this.projectRoot, ".opencode", "memory");
-        if (!existsSync(p))
-            return [];
-        try {
-            const txt = readFileSync(p, "utf8");
-            return txt.split("\n").map(s => s.trim()).filter(Boolean).slice(0, 100).map(statement => ({
-                statement,
-                type: "rule",
-                scope: null,
-                source: this.name,
-            }));
+        const out = [];
+        const seen = new Set();
+        for (const pattern of NATIVE_CANDIDATE_PATHS) {
+            try {
+                if (pattern.includes("*")) {
+                    // e.g. .opencode/memory/*.md
+                    const base = pattern.split("*")[0].replace(/\/$/, "");
+                    const dir = join(this.projectRoot, base);
+                    let st = null;
+                    try {
+                        st = statSync(dir);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!st.isDirectory())
+                        continue;
+                    for (const file of globMdFiles(dir)) {
+                        if (seen.has(file))
+                            continue;
+                        seen.add(file);
+                        try {
+                            const txt = readFileSync(file, "utf8");
+                            for (const line of txt.split("\n").map((s) => s.trim()).filter(Boolean).slice(0, 50)) {
+                                if (out.length >= 100)
+                                    break;
+                                out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                            }
+                        }
+                        catch {
+                            // absent-safe: skip unreadable file
+                        }
+                    }
+                }
+                else {
+                    const abs = join(this.projectRoot, pattern);
+                    let st = null;
+                    try {
+                        st = statSync(abs);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!st.isFile())
+                        continue;
+                    if (seen.has(abs))
+                        continue;
+                    seen.add(abs);
+                    try {
+                        const txt = readFileSync(abs, "utf8");
+                        for (const line of txt.split("\n").map((s) => s.trim()).filter(Boolean).slice(0, 100)) {
+                            if (out.length >= 100)
+                                break;
+                            out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                        }
+                    }
+                    catch {
+                        // skip
+                    }
+                }
+            }
+            catch {
+                // never throw
+            }
         }
-        catch {
-            return [];
+        return out;
+    }
+    health() {
+        let found = 0;
+        for (const pattern of NATIVE_CANDIDATE_PATHS) {
+            try {
+                if (pattern.includes("*")) {
+                    const base = pattern.split("*")[0].replace(/\/$/, "");
+                    const dir = join(this.projectRoot, base);
+                    try {
+                        const st = statSync(dir);
+                        if (!st.isDirectory())
+                            continue;
+                        found += globMdFiles(dir).length;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+                else {
+                    const abs = join(this.projectRoot, pattern);
+                    try {
+                        const st = statSync(abs);
+                        if (st.isFile())
+                            found++;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+            }
+            catch { }
         }
+        if (found > 0)
+            return { status: "ok", detail: `found ${found} files` };
+        return { status: "absent", detail: "no native memory found at probe paths" };
     }
 }

package/dist/sources/OpencodePluginSource.js

@@ -5,7 +5,9 @@ export class OpencodePluginSource {
     constructor(enabledFlag) {
         this.enabledFlag = enabledFlag;
     }
-    enabled() { return this.enabledFlag(); }
+    enabled() {
+        return this.enabledFlag();
+    }
     async fetch() {
         // Plugin source is the local DB itself — no fetch, handled elsewhere
         return [];

package/dist/sources/deletion.d.ts

@@ -0,0 +1,18 @@
+export interface DeletedInfo {
+    source: string;
+    fingerprint: string;
+    file?: string;
+}
+/**
+ * Pure diff: fingerprints present in prev but absent from current.
+ * Both sets are expected to be non-null; empty sets return [].
+ * Malformed inputs (null, non-Set) return [] never throw.
+ */
+export declare function collectDeletions(prevFingerprints: Set<string> | string[] | null | undefined, currentFingerprints: Set<string> | string[] | null | undefined, source: string): DeletedInfo[];
+/**
+ * Variant that parses memory_sources.meta_json shape if present.
+ * Expected shape: {"files":{"path":{"mtime":123,"size":456}}} or legacy null/string.
+ * For v2.1, meta_json may be absent (no per-file tracking yet) — returns [] gracefully.
+ * Kept for spec compatibility (plan §4.3 collectDeletions(prevMetaJson, currentFiles)).
+ */
+export declare function collectDeletionsFromMeta(prevMetaJson: string | null, currentFiles: Set<string>, source: string, fingerprintByFile?: Map<string, string>): DeletedInfo[];

package/dist/sources/deletion.js

@@ -0,0 +1,54 @@
+// K21-005 — Source deletion sync helper
+// Detects memories from a source that have disappeared from the source's current fetch.
+// The source of truth is fingerprints: a memory whose fingerprint is no longer in the
+// fetched set is a candidate for archival + tombstone.
+// File-level meta_json diff (plan §4.3) is not present in v2.0's IdleSync — this layer
+// diffs at fingerprint granularity, which is source-agnostic and cross-file safe.
+// Cross-source protection is enforced by the caller: only memories with matching source
+// are considered deletions.
+/**
+ * Pure diff: fingerprints present in prev but absent from current.
+ * Both sets are expected to be non-null; empty sets return [].
+ * Malformed inputs (null, non-Set) return [] never throw.
+ */
+export function collectDeletions(prevFingerprints, currentFingerprints, source) {
+    if (!prevFingerprints || !currentFingerprints)
+        return [];
+    const prev = prevFingerprints instanceof Set ? prevFingerprints : new Set(prevFingerprints);
+    const curr = currentFingerprints instanceof Set ? currentFingerprints : new Set(currentFingerprints);
+    const out = [];
+    for (const fp of prev) {
+        if (typeof fp !== "string" || fp.length === 0)
+            continue;
+        if (!curr.has(fp)) {
+            out.push({ source, fingerprint: fp });
+        }
+    }
+    return out;
+}
+/**
+ * Variant that parses memory_sources.meta_json shape if present.
+ * Expected shape: {"files":{"path":{"mtime":123,"size":456}}} or legacy null/string.
+ * For v2.1, meta_json may be absent (no per-file tracking yet) — returns [] gracefully.
+ * Kept for spec compatibility (plan §4.3 collectDeletions(prevMetaJson, currentFiles)).
+ */
+export function collectDeletionsFromMeta(prevMetaJson, currentFiles, source, fingerprintByFile) {
+    if (!prevMetaJson)
+        return [];
+    try {
+        const parsed = JSON.parse(prevMetaJson);
+        if (!parsed || typeof parsed.files !== "object" || parsed.files === null)
+            return [];
+        const out = [];
+        for (const file of Object.keys(parsed.files)) {
+            if (!currentFiles.has(file)) {
+                const fp = fingerprintByFile?.get(file) ?? file;
+                out.push({ source, file, fingerprint: fp });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jmtrin/kevin-core",
-	"version": "2.0.0",
+	"version": "2.1.0",
 	"description": "Kevin core — host-agnostic deterministic brain (Bedrock)",
 	"type": "module",
 	"main": "dist/index.js",