@jmtrin/opencode-kevin 0.8.0 → 0.9.0

package/dist/plugin/kevin_doctor.js.map

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

package/dist/plugin/kevin_native.d.ts

@@ -0,0 +1,29 @@
+import type { Store } from "./Store.js";
+import type { HostSurface } from "./host.js";
+import type { SettingsReader } from "./native.js";
+export type NativeAction = "show" | "enable" | "disable";
+export interface NativeRegistrationRow {
+    readonly surface: "skill" | "reference";
+    readonly registered: boolean;
+    readonly verified: boolean;
+    readonly attached_at: string | null;
+}
+export interface NativeReport {
+    readonly action: NativeAction;
+    /** The setting value: '1' or '0' as stored (TEXT). */
+    readonly value: "1" | "0";
+    /** Whether registration would be effective on THIS host (v2 subpath present). */
+    readonly effective: boolean;
+    /** Present when `effective` is false: why the intent is inert. */
+    readonly reason?: string;
+    /** The latest persisted outcome per surface (show only). */
+    readonly registrations?: NativeRegistrationRow[];
+    /** The restart note (enable/disable only). */
+    readonly note?: string;
+}
+export interface NativeDeps {
+    readonly host: HostSurface;
+    readonly store: Store;
+    readonly settings: SettingsReader;
+}
+export declare function handleNative(action: NativeAction, deps: NativeDeps): NativeReport;

package/dist/plugin/kevin_native.js

@@ -0,0 +1,80 @@
+// v0.9.0 (K9-019 / plan §5.5, D9-12) — `kevin_native`: inspect and toggle
+// `native_registration_enabled`.
+//
+// Pure in the sense that matters: `show` reads only; `enable`/`disable`
+// write `kevin_settings` and nothing else. Neither action re-attaches —
+// the probe is frozen for the process lifetime (D9-12) — and the response
+// says so explicitly, naming a restart as the requirement. `enable` on a
+// host without the v2 subpath succeeds and reports the registration as
+// inert: the setting is a statement of intent that becomes effective when
+// the host catches up, and refusing would make it untestable on the
+// majority of installations.
+//
+// The stored value is TEXT `'1'` or `'0'` — never a boolean, never
+// `'true'` (kevin_settings.value is TEXT; compare with `=== "1"`).
+function lastRows(store) {
+    try {
+        return store
+            .prepare(`SELECT surface, registered, verified, attached_at
+				 FROM native_registrations
+				 ORDER BY attached_at DESC, id DESC
+				 LIMIT 20`)
+            .all()
+            .map((row) => {
+            const r = row;
+            return {
+                surface: r.surface,
+                registered: r.registered === 1,
+                verified: r.verified === 1,
+                attached_at: r.attached_at,
+            };
+        });
+    }
+    catch {
+        // pre-010 database: the table does not exist yet — no rows to
+        // report, and that is the truth.
+        return [];
+    }
+}
+/** v0.9.0 (K9-019 / plan §5.5, D9-12) — the pure decision: the probe is
+ * frozen for the process lifetime, so "effective" is derived from the
+ * resolved host surface, never from a fresh probe call. */
+function effectiveOn(host) {
+    return host.v2.skill || host.v2.reference;
+}
+export function handleNative(action, deps) {
+    const current = deps.settings.getSetting("native_registration_enabled", "0");
+    const value = current === "1" ? "1" : "0";
+    if (action === "show") {
+        const report = {
+            action,
+            value,
+            effective: effectiveOn(deps.host),
+            registrations: lastRows(deps.store),
+            ...(effectiveOn(deps.host)
+                ? {}
+                : {
+                    reason: "v2 subpath absent from the resolved host package — registration would be inert",
+                }),
+        };
+        return report;
+    }
+    const next = action === "enable" ? "1" : "0";
+    deps.store
+        .prepare(`INSERT INTO kevin_settings (key, value) VALUES (?, ?)
+			 ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+        .run("native_registration_enabled", next);
+    const report = {
+        action,
+        value: next,
+        effective: effectiveOn(deps.host),
+        note: "the probe is frozen for the process lifetime — restart the host for the change to take effect",
+        ...(effectiveOn(deps.host)
+            ? {}
+            : {
+                reason: "v2 subpath absent from the resolved host package — registration would be inert",
+            }),
+    };
+    return report;
+}
+//# sourceMappingURL=kevin_native.js.map

package/dist/plugin/kevin_native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kevin_native.js","sourceRoot":"","sources":["../../plugin/kevin_native.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,0EAA0E;AAC1E,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,oEAAoE;AACpE,6BAA6B;AAC7B,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AAmCnE,SAAS,QAAQ,CAAC,KAAY;IAC7B,IAAI,CAAC;QACJ,OAAO,KAAK;aACV,OAAO,CACP;;;cAGU,CACV;aACA,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,MAAM,CAAC,GAAG,GAKT,CAAC;YACF,OAAO;gBACN,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,CAAC;gBAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ,KAAK,CAAC;gBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;aAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACR,8DAA8D;QAC9D,iCAAiC;QACjC,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED;;2DAE2D;AAC3D,SAAS,WAAW,CAAC,IAAiB;IACrC,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,MAAoB,EACpB,IAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAc,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAErD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,MAAM,GAAiB;YAC5B,MAAM;YACN,KAAK;YACL,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACnC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACA,MAAM,EACL,gFAAgF;iBACjF,CAAC;SACJ,CAAC;QACF,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAc,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,IAAI,CAAC,KAAK;SACR,OAAO,CACP;0DACuD,CACvD;SACA,GAAG,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAiB;QAC5B,MAAM;QACN,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,+FAA+F;QACrG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACA,MAAM,EACL,gFAAgF;aACjF,CAAC;KACJ,CAAC;IACF,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/plugin/native.d.ts

@@ -0,0 +1,92 @@
+import { type Materializer } from "./Materializer.js";
+import type { Store } from "./Store.js";
+import type { HostSurface } from "./host.js";
+/** The surface `attachNative()` returned. `verified` is filled by the
+ * read-back checks (K9-014/015) once the host ran `setup()`. */
+export interface NativeRegistration {
+    registered: {
+        skill: boolean;
+        reference: boolean;
+    };
+    verified: {
+        skill: boolean;
+        reference: boolean;
+    };
+    notes: string[];
+}
+/** Minimal settings reader — matches MemoryService.getSetting(key, fallback). */
+export interface SettingsReader {
+    getSetting(key: string, fallback?: string): string | null;
+}
+export interface NativeDeps {
+    materializer: Materializer;
+    settings: SettingsReader;
+    /**
+     * v0.9.0 (K9-014 / plan §5.4) — reports the outcome of each surface
+     * registration once the host ran `setup()`. `registered` reflects
+     * whether the transform completed; `verified` whether the read-back
+     * (`draft.list()`) contained the provided source. The host's own
+     * `setup()` runs asynchronously, so this callback may fire after
+     * `attachNative()` resolved.
+     */
+    onVerified?: (surface: "skill" | "reference", registered: boolean, verified: boolean) => void;
+    /**
+     * v0.9.0 (K9-017 / plan §6.2) — the persistence sink. When present,
+     * every surface outcome is appended to `native_registrations` and the
+     * two live counters are bumped. Attach time is construction, not a
+     * hot path, so a direct write is correct here and the
+     * `metrics.flush()` cadence does not apply.
+     */
+    store?: Store;
+}
+/** The only place in the repository allowed to name the v2 subpath. */
+export declare const V2_SPECIFIER = "@opencode-ai/plugin/v2/promise";
+/**
+ * Duck-typed mirror of the host's v2 PluginContext. The host's own
+ * compile-time types (dist/v2/promise/context.d.ts) are not importable
+ * here — a static type import would name the specifier outside a dynamic
+ * `import()` and break the containment scan.
+ */
+export interface KevinNativeContext {
+    readonly skill: {
+        transform(hook: (draft: unknown) => Promise<void> | void): Promise<void> | void;
+    };
+    readonly reference: {
+        transform(hook: (draft: unknown) => Promise<void> | void): Promise<void> | void;
+    };
+}
+/**
+ * Duck-typed mirror of the v2 `Plugin` contract
+ * (dist/v2/promise/plugin.d.ts). `define()` is the identity function —
+ * 54 bytes, `return plugin` — so adopting it is neither a framework nor
+ * a commitment (D9-02); the object literal below already satisfies the
+ * contract.
+ */
+export interface KevinNativePlugin {
+    readonly id: string;
+    readonly setup: (context: KevinNativeContext) => Promise<void> | void;
+}
+/** The skill body Kevin registers through `skill.transform`. */
+export declare function kevinSkillSource(materializer: Materializer): string;
+/**
+ * Build the v2 plugin. Registration replaces emission (D9-10): when the
+ * host runs `setup()`, the skill/reference surfaces are registered
+ * natively and the Materializer's `*_emission_enabled` file path is
+ * skipped for those surfaces (guard in K9-016).
+ */
+export declare function buildNativePlugin(deps: NativeDeps): KevinNativePlugin;
+export interface AttachOptions {
+    /** Injectable v2 loader for tests; defaults to the real dynamic import. */
+    importV2?: () => Promise<unknown>;
+    /** Collects notes for the caller when the result is null. */
+    notes?: string[];
+}
+/**
+ * Attach the native surface when the host exposes it AND the user asked
+ * for it. Returns `null` — cleanly, with a `note` — whenever the host
+ * lacks the subpath or `native_registration_enabled` is not `'1'`; that
+ * is the default on every existing installation, so the default
+ * behaviour of this release is byte-identical to v0.8.0. Never throws
+ * (D9-12): every failure path is a `null` plus a `note`.
+ */
+export declare function attachNative(host: HostSurface, deps: NativeDeps, options?: AttachOptions): Promise<NativeRegistration | null>;

package/dist/plugin/native.js

@@ -0,0 +1,191 @@
+import { SKILL_TOPIC } from "./Materializer.js";
+import { uuidv7 } from "./uuid.js";
+/** The only place in the repository allowed to name the v2 subpath. */
+export const V2_SPECIFIER = "@opencode-ai/plugin/v2/promise";
+/** The skill body Kevin registers through `skill.transform`. */
+export function kevinSkillSource(materializer) {
+    return materializer.skillBody();
+}
+/**
+ * Build the v2 plugin. Registration replaces emission (D9-10): when the
+ * host runs `setup()`, the skill/reference surfaces are registered
+ * natively and the Materializer's `*_emission_enabled` file path is
+ * skipped for those surfaces (guard in K9-016).
+ */
+export function buildNativePlugin(deps) {
+    return {
+        id: "opencode-kevin",
+        setup: async (ctx) => {
+            try {
+                await ctx.skill.transform(async (draft) => {
+                    const source = kevinSkillSource(deps.materializer);
+                    // The draft is a mutable builder valid only for the
+                    // duration of this callback; it never escapes (D9-10
+                    // property 3). K9-014's source scan asserts that.
+                    const draftApi = draft;
+                    if (typeof draftApi.source !== "function") {
+                        deps.onVerified?.("skill", false, false);
+                        return;
+                    }
+                    draftApi.source(source);
+                    // v0.9.0 (K9-014 / plan §5.4 property 2) — verification is a
+                    // read-back: the registered source must show up in the
+                    // draft's own list(). An unverified registration is a note
+                    // (and a metric in K9-017), never a throw.
+                    const verified = typeof draftApi.list === "function" &&
+                        draftApi.list().some((entry) => entry === source);
+                    deps.onVerified?.("skill", true, verified);
+                });
+            }
+            catch {
+                // A rejecting transform still reports, never throws (K9-014).
+                deps.onVerified?.("skill", false, false);
+            }
+            try {
+                await ctx.reference.transform(async (draft) => {
+                    // v0.9.0 (K9-015 / plan §5.4, D6-14) — one add() per
+                    // materialized ref target (topic !== SKILL_TOPIC), named
+                    // `@kevin/<topic>`. Topics follow the v0.6.0 rule
+                    // `<type>-<dominant token>`; dominantToken already
+                    // excludes hex-like tokens, so a fingerprint prefix can
+                    // never become a reference name. Sources use the v2
+                    // `{ type: "local", path }` shape (read from the
+                    // resolved SDK's ReferenceLocalSource, duck-typed).
+                    const draftApi = draft;
+                    if (typeof draftApi.add !== "function") {
+                        deps.onVerified?.("reference", false, false);
+                        return;
+                    }
+                    const added = [];
+                    for (const target of deps.materializer.bundleTargets()) {
+                        if (target.topic === SKILL_TOPIC)
+                            continue;
+                        const name = `@kevin/${target.topic}`;
+                        draftApi.add(name, {
+                            type: "local",
+                            path: target.path,
+                        });
+                        added.push(name);
+                    }
+                    // Verification is the same read-back as K9-014: every
+                    // name we added must show up in the draft's own list().
+                    const listed = typeof draftApi.list === "function" ? draftApi.list() : [];
+                    const listedNames = new Set(listed.map((entry) => {
+                        const tuple = entry;
+                        return tuple[0];
+                    }));
+                    const verified = added.every((name) => listedNames.has(name));
+                    deps.onVerified?.("reference", true, verified);
+                });
+            }
+            catch {
+                deps.onVerified?.("reference", false, false);
+            }
+        },
+    };
+}
+/**
+ * Attach the native surface when the host exposes it AND the user asked
+ * for it. Returns `null` — cleanly, with a `note` — whenever the host
+ * lacks the subpath or `native_registration_enabled` is not `'1'`; that
+ * is the default on every existing installation, so the default
+ * behaviour of this release is byte-identical to v0.8.0. Never throws
+ * (D9-12): every failure path is a `null` plus a `note`.
+ */
+export async function attachNative(host, deps, options = {}) {
+    const notes = options.notes ?? [];
+    const enabled = deps.settings.getSetting("native_registration_enabled", "0") === "1";
+    if (!enabled)
+        return null;
+    if (!host.v2.skill && !host.v2.reference) {
+        notes.push("v2 subpath absent from the resolved host package — native registration skipped");
+        return null;
+    }
+    let mod;
+    try {
+        mod = await (options.importV2 ?? (() => import(/* @vite-ignore */ V2_SPECIFIER)))();
+    }
+    catch {
+        notes.push("v2 subpath import rejected — native registration skipped");
+        return null;
+    }
+    const record = mod;
+    const define = typeof record.define === "function"
+        ? record.define
+        : null;
+    if (define === null) {
+        notes.push("v2 module exposes no define() — native registration skipped");
+        return null;
+    }
+    // `define()` is the identity function (D9-02): passing the built
+    // plugin through it validates the contract without adding a framework.
+    // v0.9.0 (K9-014 / plan §5.4 property 2) — the collector for the
+    // read-back results: `verified` is filled by the host running setup()
+    // (draft.list()), reported back through onVerified. The setup callback
+    // may fire after this function resolved; the caller keeps the returned
+    // registration as the final word.
+    const registered = { skill: host.v2.skill, reference: host.v2.reference };
+    const verified = { skill: false, reference: false };
+    const plugin = buildNativePlugin({
+        ...deps,
+        onVerified: (surface, didRegister, isVerified) => {
+            if (!didRegister)
+                registered[surface] = false;
+            verified[surface] = isVerified;
+            if (!isVerified) {
+                notes.push(`${surface} read-back does not contain the provided source — unverified registration`);
+            }
+            // v0.9.0 (K9-017 / plan §6.2) — append the outcome row at attach
+            // time (construction, not a hot path; a direct write is correct,
+            // the flush cadence does not apply). Only surfaces the host
+            // actually exposes are persisted: a surface the host cannot
+            // serve is not an outcome to record.
+            if (deps.store && host.v2[surface]) {
+                const note = !isVerified
+                    ? `${surface} read-back does not contain the provided source — unverified registration`
+                    : null;
+                persistRegistration(deps.store, surface, didRegister, isVerified, note);
+            }
+        },
+    });
+    define(plugin);
+    return {
+        registered,
+        verified,
+        notes,
+    };
+}
+/**
+ * v0.9.0 (K9-017 / plan §6.2) — one `native_registrations` row per
+ * surface per attach attempt, plus the two live counters. The counters
+ * live OUTSIDE the frozen `METRIC_KEYS` ladder (K7-004) but persist to
+ * the same `kevin_metrics` table, following the v0.6.0 `incrRegistered`
+ * precedent (K6-018/019): written immediately, never debounced. The
+ * `surface` CHECK lives in the schema (migration 010), so a bad surface
+ * fails loudly at the constraint rather than being coerced — the closed
+ * enumeration is deliberate (plan §6.2).
+ */
+function persistRegistration(store, surface, registered, verified, note) {
+    store
+        .prepare(`INSERT INTO native_registrations (id, surface, registered, verified, note)
+			 VALUES (?, ?, ?, ?, ?)`)
+        .run(uuidv7(), surface, registered ? 1 : 0, verified ? 1 : 0, note);
+    if (verified) {
+        bumpNativeCounter(store, "native_registrations_total");
+    }
+    else if (registered) {
+        // "Registered but unverified": the host accepted the call and did
+        // not honour it — the interesting state (K9-017).
+        bumpNativeCounter(store, "native_registration_failures");
+    }
+}
+function bumpNativeCounter(store, key) {
+    store
+        .prepare(`INSERT INTO kevin_metrics (key, value, updated_at)
+			 VALUES (?, 1, datetime('now'))
+			 ON CONFLICT(key) DO UPDATE SET
+			   value = value + excluded.value,
+			   updated_at = datetime('now')`)
+        .run(key);
+}
+//# sourceMappingURL=native.js.map

package/dist/plugin/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../plugin/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAanE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAyCnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAiC7D,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,YAA0B;IAC1D,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IACjD,OAAO;QACN,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,IAAI,CAAC;gBACJ,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBACnD,oDAAoD;oBACpD,qDAAqD;oBACrD,kDAAkD;oBAClD,MAAM,QAAQ,GAAG,KAGhB,CAAC;oBACF,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBAC3C,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;wBACzC,OAAO;oBACR,CAAC;oBACD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACxB,6DAA6D;oBAC7D,uDAAuD;oBACvD,2DAA2D;oBAC3D,2CAA2C;oBAC3C,MAAM,QAAQ,GACb,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU;wBACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;oBAC5D,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC5C,CAAC,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACR,8DAA8D;gBAC9D,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBAC7C,qDAAqD;oBACrD,yDAAyD;oBACzD,kDAAkD;oBAClD,mDAAmD;oBACnD,wDAAwD;oBACxD,oDAAoD;oBACpD,iDAAiD;oBACjD,oDAAoD;oBACpD,MAAM,QAAQ,GAAG,KAIhB,CAAC;oBACF,IAAI,OAAO,QAAQ,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;wBACxC,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;wBAC7C,OAAO;oBACR,CAAC;oBACD,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,EAAE,CAAC;wBACxD,IAAI,MAAM,CAAC,KAAK,KAAK,WAAW;4BAAE,SAAS;wBAC3C,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;wBACtC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;4BAClB,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,MAAM,CAAC,IAAI;yBACjB,CAAC,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAClB,CAAC;oBACD,sDAAsD;oBACtD,wDAAwD;oBACxD,MAAM,MAAM,GACX,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAc,EAAE,EAAE;wBAC7B,MAAM,KAAK,GAAG,KAAmC,CAAC;wBAClD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,CAAC,CAAC,CACF,CAAC;oBACF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC9D,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAChD,CAAC,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACR,IAAI,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,IAAiB,EACjB,IAAgB,EAChB,UAAyB,EAAE;IAE3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,OAAO,GACZ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,6BAA6B,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CACT,gFAAgF,CAChF,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACJ,GAAG,GAAG,MAAM,CACX,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CACnE,EAAE,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACR,KAAK,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,MAAM,MAAM,GACX,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU;QAClC,CAAC,CAAE,MAAM,CAAC,MAAuC;QACjD,CAAC,CAAC,IAAI,CAAC;IACT,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACb,CAAC;IAED,iEAAiE;IACjE,uEAAuE;IACvE,iEAAiE;IACjE,sEAAsE;IACtE,uEAAuE;IACvE,uEAAuE;IACvE,kCAAkC;IAClC,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAChC,GAAG,IAAI;QACP,UAAU,EAAE,CACX,OAA8B,EAC9B,WAAoB,EACpB,UAAmB,EAClB,EAAE;YACH,IAAI,CAAC,WAAW;gBAAE,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;YAC9C,QAAQ,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;YAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CACT,GAAG,OAAO,2EAA2E,CACrF,CAAC;YACH,CAAC;YACD,iEAAiE;YACjE,iEAAiE;YACjE,4DAA4D;YAC5D,4DAA4D;YAC5D,qCAAqC;YACrC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,CAAC,UAAU;oBACvB,CAAC,CAAC,GAAG,OAAO,2EAA2E;oBACvF,CAAC,CAAC,IAAI,CAAC;gBACR,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YACzE,CAAC;QACF,CAAC;KACD,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,CAAC,CAAC;IAEf,OAAO;QACN,UAAU;QACV,QAAQ;QACR,KAAK;KACL,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,mBAAmB,CAC3B,KAAY,EACZ,OAA8B,EAC9B,UAAmB,EACnB,QAAiB,EACjB,IAAmB;IAEnB,KAAK;SACH,OAAO,CACP;2BACwB,CACxB;SACA,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,QAAQ,EAAE,CAAC;QACd,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACvB,kEAAkE;QAClE,kDAAkD;QAClD,iBAAiB,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAY,EAAE,GAAW;IACnD,KAAK;SACH,OAAO,CACP;;;;mCAIgC,CAChC;SACA,GAAG,CAAC,GAAG,CAAC,CAAC;AACZ,CAAC"}

package/migrations/010_v09_native.sql

@@ -0,0 +1,78 @@
+-- ============================================================
+-- Kevin v0.9.0 "Native" — host surface and hook liveness
+-- Migration 010. Additive only. No table rebuild.
+-- ============================================================
+
+-- 1. Hook liveness. Deliberately NOT project-scoped: a hook is a
+--    property of the host binary, not of a checkout. One row per
+--    hook name, updated in place. See D9-08.
+CREATE TABLE IF NOT EXISTS hook_liveness (
+	hook            TEXT PRIMARY KEY,
+	experimental    INTEGER NOT NULL DEFAULT 0,
+	fire_count      INTEGER NOT NULL DEFAULT 0,
+	error_count     INTEGER NOT NULL DEFAULT 0,
+	expected_count  INTEGER NOT NULL DEFAULT 0,
+	first_seen_at   TEXT,
+	last_seen_at    TEXT,
+	dead_since      TEXT,
+	plugin_version  TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_hook_liveness_dead
+	ON hook_liveness(dead_since);
+
+-- 2. Host probe history. Append-only. Off by default; exists so a
+--    user chasing an intermittent fault can turn it on and get a
+--    timeline instead of a single current value.
+CREATE TABLE IF NOT EXISTS host_probes (
+	id              TEXT PRIMARY KEY,
+	probed_at       TEXT NOT NULL DEFAULT (datetime('now')),
+	plugin_version  TEXT,
+	flavour         TEXT NOT NULL,
+	has_shell       INTEGER NOT NULL DEFAULT 0,
+	v2_skill        INTEGER NOT NULL DEFAULT 0,
+	v2_reference    INTEGER NOT NULL DEFAULT 0,
+	notes           TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_host_probes_at
+	ON host_probes(probed_at);
+
+-- 3. Native registration outcomes. One row per attach attempt, so
+--    "registered but unverified" is a queryable state rather than a
+--    log line.
+CREATE TABLE IF NOT EXISTS native_registrations (
+	id              TEXT PRIMARY KEY,
+	attached_at     TEXT NOT NULL DEFAULT (datetime('now')),
+	surface         TEXT NOT NULL CHECK (surface IN ('skill', 'reference')),
+	registered      INTEGER NOT NULL DEFAULT 0,
+	verified        INTEGER NOT NULL DEFAULT 0,
+	note            TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_native_registrations_surface
+	ON native_registrations(surface, attached_at);
+
+-- 4. Metric seeds (39 -> 45).
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES
+	('hook_fires_total',                0),
+	('hook_errors_total',               0),
+	('hooks_dead_total',                0),
+	('injections_suppressed_dead_hook', 0),
+	('native_registrations_total',      0),
+	('native_registration_failures',    0);
+
+-- 5. Setting seeds (23 -> 27).
+--    hook_liveness_enabled defaults ON: it is a read-only instrument
+--    on the success path, and an instrument nobody switches on is an
+--    instrument nobody has.
+--    native_registration_enabled defaults OFF: it changes where a
+--    curated skill comes from, and that is a change a user opts into.
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES
+	('hook_liveness_enabled',       '1'),
+	('native_registration_enabled', '0'),
+	('host_probe_history_enabled',  '0'),
+	('dead_hook_report_threshold',  '3');
+
+-- 6. Version marker.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('010');

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jmtrin/opencode-kevin",
-	"version": "0.8.0",
+	"version": "0.9.0",
 	"description": "Kevin — Observa y aprende: capa de aprendizaje para OpenCode",
 	"type": "module",
 	"main": "dist/plugin/index.js",
@@ -26,7 +26,7 @@
 		"measure:mix": "node --import tsx scripts/measure-mix.ts"
 	},
 	"dependencies": {
-		"@opencode-ai/plugin": "^1.17.6"
+		"@opencode-ai/plugin": "^1.18.16"
 	},
 	"optionalDependencies": {
 		"better-sqlite3": "^12.11.0"