@jmtrin/opencode-kevin 0.7.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

@@ -1,4 +1,5 @@
 import type { Plugin } from "@opencode-ai/plugin";
+import { Store } from "./Store.js";
 export interface KevinPluginOptions {
     dbPath?: string;
     migrationsDir?: string;
@@ -15,7 +16,35 @@ 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"];
+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.9.0";
+export interface RekeyCounts {
+    memories: number;
+    shared_entries: number;
+    okf_imports: number;
+}
+export interface RekeyResult {
+    action: "rekey";
+    ok: boolean;
+    reason?: string;
+    /** Present on a dry run (no `confirm`): nothing was mutated. */
+    dry_run?: boolean;
+    /** The resolved id the corpus would move to. */
+    to_repo_id?: string;
+    /** Per source repo_id, the rows that would move (from-value → counts). */
+    from?: Record<string, RekeyCounts>;
+    /** Total rows that would move, per table. */
+    rows?: RekeyCounts;
+    /** A monorepo collision was detected (refused unless `force`). */
+    collision?: boolean;
+    /** Present on a successful confirmed run. */
+    rekeyed?: boolean;
+}
+export declare function performRekey(store: Store, toRepoId: string, opts: {
+    confirm: boolean;
+    force?: boolean;
+}): RekeyResult;
 export declare const KevinPlugin: Plugin;
 export default KevinPlugin;