@jmtrin/opencode-kevin 1.4.0 → 2.0.0

package/dist/plugin/index.d.ts

@@ -17,7 +17,13 @@ export interface KevinPluginOptions {
  * v0.4.0 (K4-021) — settings surfaced by `kevin_config` (plan §8.8).
  * Unknown keys are rejected on `set` unless `strict: false`.
  */
-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"];
+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 REMOVED_SETTINGS: {
+    readonly import_host_memory: {
+        readonly since: "2.0.0";
+        readonly replacement: "sources_enabled + source_claude_memory/source_codex_memories";
+    };
+};
 export declare const ERROR_LESSON_MODE_VALUES: readonly ["all", "triage_only"];
 /** Plugin release version — single source is @jmtrin/kevin-core (B-003 drift fix). */
 export { KEVIN_VERSION };

package/dist/plugin/index.js

@@ -128,7 +128,25 @@ export const KEVIN_CONFIG_KEYS = [
     "mcp_write_enabled",
     "mcp_approve_enabled",
     "mcp_repo_override",
+    // v1.5.0 (K15-001 / plan §4) — the four Diaspora settings (no migration this release)
+    // skills_canonical_dir is a path, others are TEXT flags compared with === "1".
+    "skills_canonical_dir",
+    "skills_mirror_claude",
+    "skills_mirror_cursor",
+    // v2.0.0 (K16-013 / plan §4.4) — Commonwealth settings (retirement of import_host_memory handled via removals)
+    "sources_enabled",
+    "source_claude_memory",
+    "source_codex_memories",
+    "source_opencode_native",
+    "okf_write_version",
 ];
+// v2.0.0 (K16-004 / plan §5.1) — removed settings contract
+export const REMOVED_SETTINGS = {
+    import_host_memory: {
+        since: "2.0.0",
+        replacement: "sources_enabled + source_claude_memory/source_codex_memories",
+    },
+};
 // v1.1.0 (K11-007 / D11-08) — no new settings in 1.1.0; thresholds are constants (D11-03)
 // v0.7.0 (K7-003 / plan §5.6, D7-12) — the explicit VALUE domain for
 // `error_lesson_mode`. The setting is TEXT and must be compared with
@@ -175,6 +193,8 @@ function resolveMigrationsDir() {
 }
 const REKEY_TABLES = ["memories", "shared_entries", "okf_imports"];
 export function performRekey(store, toRepoId, opts) {
+    if (!/^[0-9a-f]{16}$/.test(toRepoId))
+        return { action: "rekey", ok: false, reason: "invalid repo_id" };
     // The 009 migration carries the repo_id column AND the shared-layer
     // tables; without it there is nothing to re-key.
     if (!hasRepoIdColumn(store)) {
@@ -315,6 +335,17 @@ export const KevinPlugin = async (input, options) => {
     catch {
         // pre-003 DB without kevin_settings — nothing to seed
     }
+    // v1.5.0 (K15-001) — Diaspora settings: ensure defaults on existing DBs.
+    // v2.0.0: import_host_memory retired — seeded via 014 translation then deleted; no longer seeded here.
+    try {
+        const ins = store.prepare("INSERT OR IGNORE INTO kevin_settings (key, value) VALUES (?, ?)");
+        ins.run("skills_canonical_dir", ".agents/skills");
+        ins.run("skills_mirror_claude", "0");
+        ins.run("skills_mirror_cursor", "0");
+    }
+    catch {
+        // pre-003 DB without kevin_settings — nothing to seed
+    }
     const metrics = new Metrics(store);
     // v0.4.0 (K4-019): the plugin hooks expose no project field, so the
     // project id is derived once from the plugin host's working directory
@@ -1344,18 +1375,28 @@ export const KevinPlugin = async (input, options) => {
                 },
             }),
             kevin_export: tool({
-                description: "Exporta memorias curadas (decision, rule, pattern) como markdown o formato OKF. v0.3.0.",
+                description: "Exporta memorias curadas (decision, rule, pattern) como markdown, OKF o MIF (v1.5.0). v0.3.0.",
                 args: {
                     format: tool.schema
-                        .enum(["okf", "markdown"])
+                        .enum(["okf", "markdown", "mif"])
                         .default("okf")
-                        .describe("okf | markdown"),
+                        .describe("okf | markdown | mif"),
+                    redact_pii: tool.schema.boolean().optional().default(false).describe("Cuando true, aplica redaccion SECRET_PATTERNS sobre el contenido (MIF honour-when-flagged, defecto false para preservar 1.x)"),
                 },
                 async execute(args) {
-                    // v0.8.0 (K8-027) — the v1 export is scoped to this
-                    // plugin's project: the global database holds several
-                    // projects' memories, and a committed export must not
-                    // leak another project's knowledge.
+                    // v1.5.0 (K15-009) — MIF branch
+                    if (args.format === "mif") {
+                        const { toMif } = await import("@jmtrin/kevin-core");
+                        const rows = store.prepare("SELECT * FROM memories WHERE status='active'").all();
+                        // scope filter to projectId like okf-export does? Use same as exportOkf: filter by project_id = ?
+                        const scoped = projectId ? rows.filter((r) => r.project_id === projectId || r.project_id === projectId) : rows;
+                        const envelope = toMif(scoped, { redactPii: args.redact_pii === true });
+                        try {
+                            metrics.incr("mif_exports_total", 1);
+                        }
+                        catch { }
+                        return { title: "Export completado", output: JSON.stringify(envelope, null, 2) };
+                    }
                     const output = args.format === "markdown"
                         ? exportMarkdown(store, projectId)
                         : exportOkf(store, projectId);
@@ -1366,11 +1407,53 @@ export const KevinPlugin = async (input, options) => {
                 },
             }),
             kevin_import: tool({
-                description: "Importa un bundle markdown de conocimiento (v0.3.0). Cada entrada se guarda como context con origin='imported'.",
+                description: "Importa un bundle markdown de conocimiento (v0.3.0) o MIF / host memories (v2.0.0 retira import_host_memory; requiere sources_enabled=1 + source_claude_memory/codex-memories=1).",
                 args: {
-                    bundle: tool.schema.string().min(1),
+                    bundle: tool.schema.string().optional(),
+                    format: tool.schema.enum(["okf", "markdown", "mif"]).optional().describe("okf | markdown | mif (mif requiere bundle JSON)"),
+                    source: tool.schema.enum(["bundle", "claude-memory", "codex-memories"]).optional().describe("bundle (default) | claude-memory | codex-memories (requiere gate)"),
                 },
                 async execute(args) {
+                    const src = args.source ?? "bundle";
+                    if (src === "claude-memory" || src === "codex-memories") {
+                        const { importHostMemories } = await import("@jmtrin/kevin-core");
+                        const report = importHostMemories({ store, memoryService, metrics: metrics, env: kevinEnv, source: src });
+                        if (report.error === "disabled") {
+                            return { title: "Import no realizado (gate deshabilitado)", output: JSON.stringify({ error: "disabled", hint: report.hint }) };
+                        }
+                        return { title: "Import completado", output: JSON.stringify(report) };
+                    }
+                    if (args.format === "mif") {
+                        if (!args.bundle)
+                            return { title: "Import error", output: JSON.stringify({ error: "missing_bundle", hint: "bundle requerido para formato mif" }) };
+                        try {
+                            const env = JSON.parse(args.bundle);
+                            const { fromMif } = await import("@jmtrin/kevin-core");
+                            const { candidates } = fromMif(env);
+                            let imported = 0;
+                            let duplicates = 0;
+                            for (const c of candidates) {
+                                const fp = c.content ? (await import("@jmtrin/kevin-core")).fingerprint(c.content) : "";
+                                const exists = store.prepare("SELECT 1 FROM memories WHERE fingerprint = ? LIMIT 1").get(fp);
+                                if (exists) {
+                                    duplicates++;
+                                    continue;
+                                }
+                                memoryService.save({ type: c.type ?? "context", content: c.content, scope: "project", origin: "imported", fingerprint: fp, metadata: c.metadata });
+                                imported++;
+                            }
+                            try {
+                                metrics.incr("mif_imports_total", 1);
+                            }
+                            catch { }
+                            return { title: "Import completado", output: JSON.stringify({ imported, duplicates, unknownFieldsPreserved: candidates[0]?.unknownFields ? Object.keys(candidates[0].unknownFields) : [] }) };
+                        }
+                        catch (e) {
+                            return { title: "Import error", output: JSON.stringify({ error: "bad_json", message: e.message }) };
+                        }
+                    }
+                    if (!args.bundle)
+                        return { title: "Import error", output: JSON.stringify({ error: "missing_bundle" }) };
                     const result = importOkf(args.bundle, memoryService);
                     return {
                         title: "Import completado",
@@ -1378,6 +1461,56 @@ export const KevinPlugin = async (input, options) => {
                     };
                 },
             }),
+            kevin_sources: tool({
+                description: "Fuentes de memoria (v2.0.0): lista estado de cada MemorySource (enabled, precedence, last_sync). Solo lectura.",
+                args: {
+                    action: tool.schema.enum(["list"]).default("list").describe("list"),
+                },
+                async execute(_args) {
+                    const settings = {};
+                    try {
+                        const rows = store
+                            .prepare("SELECT key, value FROM kevin_settings WHERE key LIKE 'source%' OR key='sources_enabled' OR key='okf_write_version'")
+                            .all();
+                        for (const r of rows)
+                            settings[r.key] = r.value;
+                    }
+                    catch { }
+                    let sources = [];
+                    try {
+                        sources = store
+                            .prepare("SELECT name, enabled, precedence FROM memory_sources ORDER BY precedence")
+                            .all();
+                    }
+                    catch {
+                        sources = [
+                            { name: "opencode-plugin", enabled: 1, precedence: 10 },
+                            {
+                                name: "claude-memory",
+                                enabled: Number(settings["source_claude_memory"] === "1" ? 1 : 0),
+                                precedence: 20,
+                            },
+                            {
+                                name: "codex-memories",
+                                enabled: Number(settings["source_codex_memories"] === "1" ? 1 : 0),
+                                precedence: 30,
+                            },
+                            {
+                                name: "opencode-native",
+                                enabled: Number(settings["source_opencode_native"] === "1" ? 1 : 0),
+                                precedence: 40,
+                            },
+                        ];
+                    }
+                    return {
+                        title: "Fuentes de memoria",
+                        output: JSON.stringify({
+                            sources_enabled: settings["sources_enabled"] ?? "1",
+                            sources,
+                        }),
+                    };
+                },
+            }),
             kevin_config: tool({
                 description: "Lee o modifica settings de Kevin sin SQL (v0.4.0). list: todas las settings de kevin_settings. set: upsert de una key conocida (rechaza keys desconocidas salvo strict:false).",
                 args: {
@@ -1418,6 +1551,19 @@ export const KevinPlugin = async (input, options) => {
                             }),
                         };
                     }
+                    // v2.0.0 (K16-004) — removed keys return structured removed_in_2.0.0 before unknown_key
+                    if (args.key in REMOVED_SETTINGS) {
+                        const meta = REMOVED_SETTINGS[args.key];
+                        return {
+                            title: "kevin_config",
+                            output: JSON.stringify({
+                                error: "removed_in_2.0.0",
+                                key: args.key,
+                                replacement: meta.replacement,
+                                since: meta.since,
+                            }),
+                        };
+                    }
                     const known = KEVIN_CONFIG_KEYS.includes(args.key);
                     if (!known && args.strict !== false) {
                         return {
@@ -2148,6 +2294,28 @@ export const KevinPlugin = async (input, options) => {
                         catch {
                             // best-effort — snapshot failure must not break idle
                         }
+                        // v1.5.0 (K15-007) — skill bundle refresh after snapshots flush
+                        try {
+                            const manifestPath = join(materializerRoot, "skills-manifest.json");
+                            const shouldRefresh = memoryService.getSetting("skills_mirror_claude", "0") === "1" || memoryService.getSetting("skills_mirror_cursor", "0") === "1" || memoryService.getSetting("skills_canonical_dir", ".agents/skills") !== "" || existsSync(manifestPath);
+                            // spec: run when ANY skill setting is on OR manifest exists; canonical_dir always set so we check manifest existence as primary gate plus mirror flags
+                            const hasManifest = existsSync(manifestPath);
+                            const mirrorActive = memoryService.getSetting("skills_mirror_claude", "0") === "1" || memoryService.getSetting("skills_mirror_cursor", "0") === "1";
+                            if (hasManifest || mirrorActive) {
+                                const { refreshSkillBundle } = await import("@jmtrin/kevin-core");
+                                const bundles = materializer.topicBundles();
+                                const canonicalDir = memoryService.getSetting("skills_canonical_dir", ".agents/skills");
+                                const mirrors = [];
+                                if (memoryService.getSetting("skills_mirror_claude", "0") === "1")
+                                    mirrors.push("claude");
+                                if (memoryService.getSetting("skills_mirror_cursor", "0") === "1")
+                                    mirrors.push("cursor");
+                                refreshSkillBundle({ projectRoot, canonicalDir, mirrors, topics: bundles, repoId: sessionIdentity.repoId, manifestPath, metrics: metrics });
+                            }
+                        }
+                        catch {
+                            // best-effort
+                        }
                         // v1.0.0 (K10-013 / D10-08) — the session recorded work:
                         // arm the deferred dispose settlement. The ISO timestamp
                         // lets the next session.start compare it against

package/package.json

@@ -1,58 +1,50 @@
 {
-  "name": "@jmtrin/opencode-kevin",
-  "version": "1.4.0",
-  "description": "Kevin — Observa y aprende: capa de aprendizaje para OpenCode",
-  "type": "module",
-  "main": "dist/plugin/index.js",
-  "types": "dist/plugin/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/plugin/index.d.ts",
-      "import": "./dist/plugin/index.js"
-    },
-    "./tui": {
-      "types": "@jmtrin/opencode-kevin-tui/dist/index.d.ts",
-      "import": "@jmtrin/opencode-kevin-tui/dist/index.js"
-    }
-  },
-  "files": [
-    "dist/plugin"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@opencode-ai/plugin": "^1.18.16",
-    "@jmtrin/kevin-core": "1.4.0",
-    "@jmtrin/opencode-kevin-tui": "1.4.0"
-  },
-  "optionalDependencies": {
-    "better-sqlite3": "^12.11.0"
-  },
-  "engines": {
-    "node": ">=22.5.0",
-    "opencode": "^1.18.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/jmtrin/opencode-kevin.git"
-  },
-  "homepage": "https://github.com/jmtrin/opencode-kevin#readme",
-  "bugs": {
-    "url": "https://github.com/jmtrin/opencode-kevin/issues"
-  },
-  "keywords": [
-    "opencode",
-    "plugin",
-    "memory",
-    "learning",
-    "ai"
-  ],
-  "author": "jmtrin",
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT"
+	"name": "@jmtrin/opencode-kevin",
+	"version": "2.0.0",
+	"description": "Kevin — Observa y aprende: capa de aprendizaje para OpenCode",
+	"type": "module",
+	"main": "dist/plugin/index.js",
+	"types": "dist/plugin/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/plugin/index.d.ts",
+			"import": "./dist/plugin/index.js"
+		},
+		"./tui": {
+			"types": "@jmtrin/opencode-kevin-tui/dist/index.d.ts",
+			"import": "@jmtrin/opencode-kevin-tui/dist/index.js"
+		}
+	},
+	"files": ["dist/plugin"],
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"prepublishOnly": "npm run build",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@opencode-ai/plugin": "^1.18.16",
+		"@jmtrin/kevin-core": "2.0.0",
+		"@jmtrin/opencode-kevin-tui": "2.0.0"
+	},
+	"optionalDependencies": {
+		"better-sqlite3": "^12.11.0"
+	},
+	"engines": {
+		"node": ">=22.5.0",
+		"opencode": "^1.18.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/jmtrin/opencode-kevin.git"
+	},
+	"homepage": "https://github.com/jmtrin/opencode-kevin#readme",
+	"bugs": {
+		"url": "https://github.com/jmtrin/opencode-kevin/issues"
+	},
+	"keywords": ["opencode", "plugin", "memory", "learning", "ai"],
+	"author": "jmtrin",
+	"publishConfig": {
+		"access": "public"
+	},
+	"license": "MIT"
 }