@jmtrin/opencode-kevin 0.8.0 → 0.9.0

package/dist/plugin/host.js

@@ -0,0 +1,251 @@
+/**
+ * K9-004 — v0.9.0 native — host probe (plan §5.1, D9-12).
+ *
+ * Kevin stops assuming the host and asks it instead. `probeHost()` inspects the
+ * plugin input and the resolved `@opencode-ai/plugin` package and answers four
+ * questions once per process: what plugin version is actually installed, which
+ * v1+v2 surface exists, what project context the host already knows, and
+ * whether a shell was handed over.
+ *
+ * Contract (plan §5.1 / §4 traps 24-26):
+ * - Never throws: every read is guarded, every failure appends to `notes` and
+ *   yields a conservative `false`. A throw during construction takes down the
+ *   host's plugin load — strictly worse than any missing feature.
+ * - Duck-typed: only `typeof` and `in` checks, never `instanceof`, never a cast
+ *   to a host class.
+ * - The v2 probe is a dynamic `await import()` of the v2/promise subpath inside
+ *   a try. Rejection is the answer (a pre-v2 package). When it resolves we record
+ *   which domains are actually exposed rather than assuming both — the promise
+ *   subpath exports `define` at runtime and its `skill`/`reference` domains are
+ *   compile-time types, so domain availability is verified against the resolved
+ *   package's own declaration files.
+ * - Runs once: the result is cached and frozen. A capability that appears
+ *   mid-session is indistinguishable from a bug (D9-12).
+ * - `pluginVersion` comes from the resolved package's `package.json` — never
+ *   from the declared range, which plan §3.4 showed to be untrustworthy.
+ * - The v2 subpath string itself lives in native.ts (K9-013 containment): this
+ *   module only ever names it through the imported symbol.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// v0.9.0 (K9-013 / plan §5.4, D9-11) — the only file allowed to name the v2
+// subpath is plugin/native.ts; this module uses the exported symbol.
+import { V2_SPECIFIER } from "./native.js";
+let cachedSurface = null;
+/**
+ * v0.9.0 (K9-004 / plan §5.1, D9-12)
+ * `importV2` is a test seam; production callers omit it and the real
+ * `await import()` runs inside the try.
+ */
+export async function probeHost(input, options) {
+    if (cachedSurface !== null) {
+        return cachedSurface;
+    }
+    const notes = [];
+    const project = readProject(input, notes);
+    const hasShell = readShell(input, notes);
+    const v2 = await probeV2(notes, options?.importV2);
+    const pluginVersion = readPluginVersion(notes);
+    const surface = Object.freeze({
+        pluginVersion,
+        flavour: v2 === null ? "v1-only" : "v1+v2",
+        project: Object.freeze(project),
+        hasShell,
+        v2: Object.freeze({
+            skill: v2?.skill ?? false,
+            reference: v2?.reference ?? false,
+        }),
+        notes: Object.freeze(notes),
+    });
+    cachedSurface = surface;
+    return surface;
+}
+/**
+ * v0.9.0 (K9-004) — test hook. probeHost caches its result (probe once, freeze,
+ * restart to re-probe); tests reset between cases.
+ */
+export function resetHostProbeCache() {
+    cachedSurface = null;
+}
+/**
+ * v0.9.0 (K9-004 / plan §5.1) — one stable paragraph: version, flavour and the
+ * domain flags. No paths, no identifiers; safe to paste into an issue report.
+ */
+export function summarize(s) {
+    const version = s.pluginVersion ?? "unknown";
+    const shell = s.hasShell ? "yes" : "no";
+    const skill = s.v2.skill ? "yes" : "no";
+    const reference = s.v2.reference ? "yes" : "no";
+    return `host plugin ${version}, flavour ${s.flavour}, shell ${shell}, v2 skill ${skill}, v2 reference ${reference}`;
+}
+function readProject(input, notes) {
+    let id = null;
+    let worktree = null;
+    let directory = null;
+    if (typeof input === "object" && input !== null) {
+        const record = input;
+        const project = record.project;
+        if (typeof project === "object" && project !== null) {
+            const p = project;
+            id = typeof p.id === "string" ? p.id : null;
+            worktree = typeof p.worktree === "string" ? p.worktree : null;
+            directory =
+                typeof p.directory === "string" ? p.directory : null;
+        }
+        // PluginInput also carries top-level worktree/directory; fall back to
+        // them when the project object does not.
+        if (worktree === null && typeof record.worktree === "string") {
+            worktree = record.worktree;
+        }
+        if (directory === null && typeof record.directory === "string") {
+            directory = record.directory;
+        }
+        if (id === null && worktree === null && directory === null) {
+            notes.push("no project context on the plugin input (D9-12)");
+        }
+    }
+    else {
+        notes.push("plugin input is not an object — host fields unavailable (D9-12)");
+    }
+    return { id, worktree, directory };
+}
+function readShell(input, notes) {
+    if (typeof input !== "object" || input === null) {
+        return false;
+    }
+    const shell = input.$;
+    const present = (typeof shell === "object" && shell !== null) ||
+        typeof shell === "function";
+    if (!present) {
+        notes.push("no shell ($) handed over — zero process-launching stays a decision (D9-12)");
+    }
+    return present;
+}
+/**
+ * v0.9.0 (K9-004 / plan §5.1, D9-11/D9-12)
+ * Returns null when the v2 surface is absent; otherwise the domain flags
+ * verified against the resolved package's own declaration files.
+ */
+async function probeV2(notes, importV2) {
+    let mod;
+    try {
+        mod = importV2
+            ? await importV2()
+            : await import(/* @vite-ignore */ V2_SPECIFIER);
+    }
+    catch {
+        notes.push(`${V2_SPECIFIER} import rejected — this host package predates the v2 subpath (D9-11)`);
+        return null;
+    }
+    if (typeof mod !== "object" || mod === null) {
+        notes.push("v2/promise resolved to a non-object module — treated as v1-only (D9-12)");
+        return null;
+    }
+    if (typeof mod.define !== "function") {
+        notes.push("v2/promise resolved but exposes no define — treated as v1-only (D9-12)");
+        return null;
+    }
+    const root = resolvePluginRoot(notes);
+    if (root === null) {
+        notes.push("v2/promise resolved but the package root is unreachable — v2 domains unverified (D9-12)");
+        return { skill: false, reference: false };
+    }
+    // The promise subpath ships skill/reference as declaration files; record
+    // what is actually there rather than assuming both (plan §5.1).
+    return {
+        skill: existsSync(join(root, "dist", "v2", "promise", "skill.d.ts")),
+        reference: existsSync(join(root, "dist", "v2", "promise", "reference.d.ts")),
+    };
+}
+function readPluginVersion(notes) {
+    const root = resolvePluginRoot(notes);
+    if (root === null) {
+        return null;
+    }
+    try {
+        const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+        if (typeof pkg.version === "string" && pkg.version.length > 0) {
+            return pkg.version;
+        }
+        notes.push("resolved plugin package.json declares no version (K9-004)");
+        return null;
+    }
+    catch {
+        notes.push("resolved plugin package.json unreadable (K9-004)");
+        return null;
+    }
+}
+/**
+ * v0.9.0 (K9-004 / plan §5.1) — the installed package's directory, found by
+ * the most reliable strategy that works in this runtime. Never throws.
+ */
+function resolvePluginRoot(notes) {
+    // 1. import.meta.resolve: the true resolved copy (Node >= 20.6, Bun).
+    const resolveMeta = import.meta.resolve;
+    if (typeof resolveMeta === "function") {
+        try {
+            const url = resolveMeta("@opencode-ai/plugin");
+            const root = packageRootOf(url, notes);
+            if (root !== null) {
+                return root;
+            }
+        }
+        catch {
+            // unsupported in this runtime — next strategy
+        }
+    }
+    // 2. createRequire: hosts that ship a "require" condition (this package
+    //    exports only "import", so this is a forward-compat strategy).
+    try {
+        const resolve = createRequire(import.meta.url).resolve(`${V2_SPECIFIER}/index.js`);
+        const root = packageRootOf(resolve, notes);
+        if (root !== null) {
+            return root;
+        }
+    }
+    catch {
+        // not resolvable via require — next strategy
+    }
+    // 3. Walk up from cwd looking for a node_modules copy (works in the repo
+    //    and in typical host layouts; best effort, guarded).
+    let dir = process.cwd();
+    for (let depth = 0; depth < 10; depth += 1) {
+        const candidate = join(dir, "node_modules", "@opencode-ai", "plugin");
+        if (existsSync(join(candidate, "package.json"))) {
+            return candidate;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    notes.push("resolved plugin package root not reachable (K9-004)");
+    return null;
+}
+/** Accepts a file URL or a plain path to a file inside the package. */
+function packageRootOf(file, notes) {
+    try {
+        const path = file.startsWith("file:")
+            ? fileURLToPath(file)
+            : file.replace(/\\/g, "/");
+        // dist/index.js → dist → root; dist/v2/promise/index.js → three levels.
+        const candidates = [
+            dirname(path),
+            dirname(dirname(path)),
+            dirname(dirname(dirname(path))),
+        ];
+        for (const candidate of candidates) {
+            if (existsSync(join(candidate, "package.json"))) {
+                return candidate;
+            }
+        }
+    }
+    catch {
+        notes.push("could not map the resolved plugin file to its package root (K9-004)");
+    }
+    return null;
+}
+//# sourceMappingURL=host.js.map

package/dist/plugin/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../plugin/host.ts"],"names":[],"mappings":"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"}

package/dist/plugin/index.d.ts

@@ -16,10 +16,10 @@ 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"];
+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"];
 export declare const ERROR_LESSON_MODE_VALUES: readonly ["all", "triage_only"];
 /** Plugin release version — stamped into generated files (K8-021/027). */
-export declare const KEVIN_VERSION = "0.8.0";
+export declare const KEVIN_VERSION = "0.9.0";
 export interface RekeyCounts {
     memories: number;
     shared_entries: number;

package/dist/plugin/index.js

@@ -11,6 +11,7 @@ import { ContextInjector } from "./ContextInjector.js";
 import { ConventionMiner } from "./ConventionMiner.js";
 import { Curator } from "./Curator.js";
 import { Feedback } from "./Feedback.js";
+import { HookLiveness } from "./HookLiveness.js";
 import { InjectionLedger } from "./InjectionLedger.js";
 import { Materializer, SKILL_TOPIC } from "./Materializer.js";
 import { MemoryService, hasRepoIdColumn, } from "./MemoryService.js";
@@ -25,16 +26,21 @@ import { Store } from "./Store.js";
 import { ToolCallObserver } from "./ToolCallObserver.js";
 import { probe } from "./capabilities.js";
 import { computeConfidence } from "./confidence.js";
+import { probeHost, summarize } from "./host.js";
 import { kevinApprove } from "./kevin_approve.js";
 import { buildAudit } from "./kevin_audit.js";
 import { executeKevinConflicts } from "./kevin_conflicts.js";
+import { buildDoctor } from "./kevin_doctor.js";
 import { buildKevinFacts } from "./kevin_facts.js";
+import { handleNative } from "./kevin_native.js";
 import { kevinPropose } from "./kevin_propose.js";
 import { kevinPublish } from "./kevin_publish.js";
 import { kevinWhy } from "./kevin_why.js";
 import { Metrics } from "./metrics.js";
+import { attachNative } from "./native.js";
 import { exportMarkdown, exportOkf } from "./okf-export.js";
 import { importOkf } from "./okf-import.js";
+import { uuidv7 } from "./uuid.js";
 // v0.6.0 (K6-019) — process-global set of reference topics already
 // registered with the host this process. Keeps re-registration idempotent
 // across sessions within one process: a topic registered once is never
@@ -84,6 +90,17 @@ export const KEVIN_CONFIG_KEYS = [
     "share_requires_approval",
     "author_identity_mode",
     "shared_confidence_floor",
+    // v0.9.0 (K9-003 / plan §8.10) — the four keys seeded by migration 010
+    // section 5. Omitting these makes `kevin_config set` return
+    // { error: "unknown_key" } while `kevin_config list` still shows them.
+    // hook_liveness_enabled and the two registration/history flags must be
+    // compared with === "1" (they are TEXT, and '0' is truthy);
+    // dead_hook_report_threshold is a string read with Number.parseInt and
+    // clamped to [1, 1000], NaN defaulting to 3 (conventions, §2; D9-09).
+    "hook_liveness_enabled",
+    "native_registration_enabled",
+    "host_probe_history_enabled",
+    "dead_hook_report_threshold",
 ];
 // 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
@@ -93,7 +110,7 @@ export const KEVIN_CONFIG_KEYS = [
 // behaviour on the next reflection.
 export const ERROR_LESSON_MODE_VALUES = ["all", "triage_only"];
 /** Plugin release version — stamped into generated files (K8-021/027). */
-export const KEVIN_VERSION = "0.8.0";
+export const KEVIN_VERSION = "0.9.0";
 function resolveMigrationsDir() {
     const here = dirname(fileURLToPath(import.meta.url));
     return join(here, "..", "migrations");
@@ -235,7 +252,12 @@ export const KevinPlugin = async (input, options) => {
     // (plan §5.7 fallback; D2-11 project scoping wired into the live path).
     // v0.8.0 (K8-006 / plan §5.1): the repository identity resolves once at
     // init, next to the project id, and never on a hot path.
-    const identity = RepoIdentity.resolve(process.cwd());
+    // v0.9.0 (K9-004/K9-006 / plan §5.1-5.2, D9-12/D9-13): the host surface
+    // is probed once at construction — frozen, never re-probed — and feeds
+    // the identity chain as the third source, above `path` and below
+    // `declared`/`remote`.
+    const host = await probeHost(input);
+    const identity = RepoIdentity.resolve(process.cwd(), host);
     const projectId = identity.projectId;
     const repoId = identity.repoId;
     const identitySource = identity.source;
@@ -249,6 +271,27 @@ export const KevinPlugin = async (input, options) => {
     // not what the session is scoped on.
     let sessionIdentity = identity;
     const memoryService = new MemoryService(store, metrics, repoId);
+    // v0.9.0 (K9-008 / plan §5.1, D9-08) — host probe history: one
+    // host_probes row per construction when host_probe_history_enabled
+    // is explicitly '1' (TEXT comparison — truthiness would fire on
+    // '0'). Append-only and unbounded by design: off by default, one
+    // row per process start, no retention policy.
+    if (memoryService.getSetting("host_probe_history_enabled", "0") === "1") {
+        store
+            .prepare(`INSERT INTO host_probes
+				 (id, plugin_version, flavour, has_shell, v2_skill, v2_reference, notes)
+				 VALUES (?, ?, ?, ?, ?, ?, ?)`)
+            .run(uuidv7(), host.pluginVersion, host.flavour, host.hasShell ? 1 : 0, host.v2.skill ? 1 : 0, host.v2.reference ? 1 : 0, host.notes.join("\n"));
+    }
+    // v0.9.0 (K9-009 / plan §5.3, D9-07/D9-08) — hook liveness. Wraps every
+    // hook with a success-path recorder; counters persist on the
+    // metrics.flush() cadence. Explicit === "1" TEXT comparison
+    // (kevin_settings.value is TEXT).
+    const liveness = new HookLiveness(store, {
+        enabled: memoryService.getSetting("hook_liveness_enabled", "1") === "1",
+        thresholdText: memoryService.getSetting("dead_hook_report_threshold", "3"),
+        pluginVersion: host.pluginVersion,
+    });
     // v0.7.0 (K7-009 / plan §5.1, D7-13) — the repository truth scanner reads
     // the JSON project files. Runs once at init, gated by repo_truth_enabled.
     const projectRoot = opts.projectRoot ?? process.cwd();
@@ -334,6 +377,24 @@ export const KevinPlugin = async (input, options) => {
     mkdirSync(join(materializerRoot, "refs"), { recursive: true });
     const capabilities = probe(input);
     const materializer = new Materializer(store, { root: materializerRoot });
+    // v0.9.0 (K9-016 / plan §5.4, D9-10) — native registration replaces
+    // file emission. When attachNative returns a registration for a
+    // surface, the corresponding *_emission_enabled path is skipped for
+    // that surface only. The guard lives in Materializer.
+    try {
+        const nativeReg = await attachNative(host, {
+            materializer,
+            settings: memoryService,
+            store,
+        });
+        if (nativeReg) {
+            materializer.markNativeRegistered("skill", nativeReg.registered.skill);
+            materializer.markNativeRegistered("reference", nativeReg.registered.reference);
+        }
+    }
+    catch {
+        // attachNative never throws (D9-12) — guard against unexpected rejection.
+    }
     // v0.6.0 (K6-018 / plan §8.14, D6-13) — skill emission at session
     // start, behind the capability probe AND `skill_emission_enabled`
     // (default '0'). Both no-op paths are silent: "unavailable" (v1 host)
@@ -445,7 +506,11 @@ export const KevinPlugin = async (input, options) => {
             projectId,
         }));
     }
-    return {
+    // v0.9.0 (K9-009 / plan §5.3) — the hooks object is wrapped here at the
+    // point of return: transparent (identical keys/arity/returns/errors),
+    // recording fires on the success path only. With hook_liveness_enabled
+    // '0' the wrapper returns this same object untouched.
+    return liveness.wrap({
         tool: {
             kevin_save: tool({
                 description: "Guarda una memoria en el conocimiento persistente de Kevin (error, pattern, decision o context).",
@@ -783,8 +848,8 @@ export const KevinPlugin = async (input, options) => {
                             // monotone across releases; K6-024 extends this
                             // block with the remaining v0.6 fields. v0.8.0
                             // (K8-025) — 18 v0.7 + kevin_project +
-                            // kevin_share + kevin_sync = 21.
-                            tool_count: 21,
+                            // kevin_native = 23.
+                            tool_count: 23,
                             v07,
                             memories_reflector: memoriesReflector,
                             memories_agent: memoriesAgent,
@@ -819,6 +884,10 @@ export const KevinPlugin = async (input, options) => {
                             v06,
                             // v0.8.0 (K8-025) — omitted on pre-009 DBs.
                             v08,
+                            // v0.9.0 (K9-008 / plan §5.1) — one-line host
+                            // summary: version, flavour, shell, v2 flags;
+                            // no paths, no ids (charset-safe for log lines).
+                            host_summary: summarize(host),
                         }),
                     };
                 },
@@ -846,7 +915,7 @@ export const KevinPlugin = async (input, options) => {
                                     path: res.path,
                                     id: res.id,
                                     created_at: res.createdAt,
-                                    generator: "opencode-kevin/0.8.0",
+                                    generator: "opencode-kevin/0.9.0",
                                 }
                                 : {
                                     action: "init",
@@ -968,6 +1037,48 @@ export const KevinPlugin = async (input, options) => {
                     };
                 },
             }),
+            // v0.9.0 (K9-018 / plan §5.5, D9-09) — kevin_doctor: pure
+            // reads, no writes, no probe re-run, no model call. The host
+            // block comes from the frozen init-time probe, hooks from the
+            // persisted hook_liveness table, native from the last
+            // registration per surface, verdict from reduceVerdict.
+            kevin_doctor: tool({
+                description: "Doctor de Kevin (v0.9.0): salud del host, hooks, dependencias y registros nativos. Solo lectura, sin LLM ni writes, invocable en cualquier momento. Devuelve host (version, flavour, shell, v2), hooks ordenados dead primero, dependencies (zod_copies), native (enabled, registered/verified por surface), verdict (healthy|degraded|unknown) y reason. Output pensado para pegar en un issue: sin filesystem paths ni session ids.",
+                args: {},
+                async execute() {
+                    const report = buildDoctor(store, host, memoryService);
+                    return {
+                        title: "Doctor de Kevin",
+                        output: JSON.stringify(report),
+                    };
+                },
+            }),
+            // v0.9.0 (K9-019 / plan §5.5, D9-12) — kevin_native: inspect
+            // and toggle native_registration_enabled. enable/disable write
+            // kevin_settings only and never re-attach — the probe is
+            // frozen for the process lifetime, so a restart is the
+            // requirement for the change to take effect. `enable` on a
+            // host without the v2 subpath succeeds and reports the
+            // registration as inert: the setting is a statement of intent.
+            kevin_native: tool({
+                description: "Registros nativos v2 (v0.9.0): show reporta el setting native_registration_enabled, si el host resuelto expone el subpath v2 (effective) y las ultimas filas de native_registrations por surface; enable/disable escriben el setting ('1'/'0' TEXT) y NO re-adjuntan — el probe es frozen para la vida del proceso, un restart del host es el requisito para que el cambio tenga efecto; enable en un host sin subpath v2 exito con registration inert.",
+                args: {
+                    action: tool.schema
+                        .enum(["show", "enable", "disable"])
+                        .default("show"),
+                },
+                async execute(args) {
+                    const report = handleNative(args.action, {
+                        host,
+                        store,
+                        settings: memoryService,
+                    });
+                    return {
+                        title: "Kevin native",
+                        output: JSON.stringify(report),
+                    };
+                },
+            }),
             kevin_retrospective: tool({
                 description: "Genera un retrospective markdown para una sesion (resume tools que fallaron y lecciones aprendidas).",
                 args: {
@@ -1418,6 +1529,13 @@ export const KevinPlugin = async (input, options) => {
             }, {});
         },
         "tool.execute.after": async (hookInput, output) => {
+            // v0.9.0 (K9-010 / plan §5.3) — checkpoint: the session reached a
+            // model turn, so the system prompt was assembled and
+            // `experimental.chat.system.transform` MUST have been offered.
+            // Deduped per session inside HookLiveness.expect.
+            if (hookInput.sessionID) {
+                liveness.expect("experimental.chat.system.transform", hookInput.sessionID);
+            }
             const meta = (output.metadata ?? {});
             const outputText = String(output.output ?? "");
             const stderr = String(meta.stderr ?? "");
@@ -1637,6 +1755,9 @@ export const KevinPlugin = async (input, options) => {
                     }
                 }
                 metrics.flush();
+                // v0.9.0 (K9-009 / plan §5.3) — liveness counters persist on
+                // the same cadence as the metrics.
+                liveness.flush();
             }
             else if (type === "session.next.tool.failed") {
                 const callID = props.callID;
@@ -1654,10 +1775,11 @@ export const KevinPlugin = async (input, options) => {
         },
         dispose: async () => {
             await Promise.allSettled([...pending]);
+            liveness.flush();
             metrics.close();
             store.close();
         },
-    };
+    });
 };
 export default KevinPlugin;
 //# sourceMappingURL=index.js.map