@jmtrin/opencode-kevin 0.7.0 → 0.9.0

package/dist/plugin/SharedLayer.js

@@ -0,0 +1,463 @@
+// ============================================================
+// Kevin 0.8.0 — SharedLayer (F3, K8-016 … K8-020)
+// ============================================================
+// The two-directional bridge between the OKF file and the local
+// store. Import may retire a memory — but only on an explicit
+// committed tombstone. Export may write a file — but only through
+// the one write path that has existed since v0.6.0 (D8-08).
+//
+// Every statement filters on `repo_id` (D8-02): there is no
+// unscoped read or write of `shared_entries` or `okf_imports`.
+// ============================================================
+import { readFileSync } from "node:fs";
+import { computeConfidence } from "./confidence.js";
+import { fnv1a64 } from "./fingerprint.js";
+import { MAX_ENTRIES, MAX_LINE_BYTES, OKF_VERSION, canonicalize, computeEntryId, deriveConfidence, merge, parse, serialize, } from "./okf.js";
+import { uuidv7 } from "./uuid.js";
+/**
+ * Project a local memory into its OKF candidate (K8-020): the
+ * identifying triple (type, statement, scope) determines the
+ * entry_id, so a re-export of the same memory is byte-identical.
+ * created_at is normalized from SQLite's "YYYY-MM-DD HH:MM:SS" to
+ * the file's ISO-8601 form, keeping join()'s min from flipping
+ * formats across exports.
+ */
+function memoryToEntry(row) {
+    return {
+        entry_id: computeEntryId(row.type, row.content, row.scope),
+        type: row.type,
+        statement: row.content,
+        scope: row.scope,
+        evidence: row.evidence_count ?? 0,
+        recurrence: row.recurrence_count ?? 0,
+        origin: row.origin ?? "pattern",
+        author_hash: null,
+        op: "assert",
+        created_at: `${(row.created_at ?? "").replace(" ", "T")}Z`,
+        supersedes: null,
+    };
+}
+export class SharedLayer {
+    store;
+    repoId;
+    projectId;
+    version;
+    writer;
+    constructor(deps) {
+        this.store = deps.store;
+        this.repoId = deps.repoId;
+        this.projectId = deps.projectId;
+        this.version = deps.version;
+        this.writer = deps.writer;
+    }
+    /**
+     * The single whole-file (mode `whole`) construction site in
+     * SharedLayer (K8-019 / K8-020, D8-08, asserted by
+     * tests/unit/single_write_path.test.ts): the OKF file is written
+     * through the ArtifactWriter's write funnel like every other file
+     * Kevin owns — there is no second write path.
+     */
+    wholeRequest(path, content, refusal) {
+        return {
+            path,
+            mode: "whole",
+            content,
+            ...(refusal !== undefined ? { refusal } : {}),
+        };
+    }
+    /**
+     * Pure export planner (K8-020 / plan §5.5): reads the current file
+     * and merges the given local memories' projections into the corpus,
+     * producing a {@link WritePlan} — but writes nothing. Refusals are
+     * audited like any other write: `after === before`, both hashes
+     * recorded (D6-04). The refusal ladder, in the order the code
+     * evaluates it — file-side refusals first (not_okf, version_ahead,
+     * repo_mismatch), then candidate-side refusals in the loop order
+     * (line_too_long, below_floor, not_curated, unknown_entry), then
+     * too_many_entries and finally parse_damaged.
+     */
+    planExport(memoryIds, path) {
+        const { exists, parsed } = this.readWithFlag(path);
+        if (exists && parsed.version === 0) {
+            return this.refused(path, "not_okf");
+        }
+        if (exists && parsed.version > OKF_VERSION) {
+            return this.refused(path, "version_ahead");
+        }
+        if (parsed.repoId !== null && parsed.repoId !== this.repoId) {
+            return this.refused(path, "repo_mismatch");
+        }
+        const candidates = this.candidateEntries(memoryIds);
+        if (candidates.refusal !== null) {
+            return this.refused(path, candidates.refusal);
+        }
+        const merged = merge(parsed.entries, candidates.entries);
+        if (merged.length > MAX_ENTRIES) {
+            return this.refused(path, "too_many_entries");
+        }
+        if (exists && parsed.rejected.length > 0) {
+            return this.refused(path, "parse_damaged");
+        }
+        const content = serialize(merged, this.repoId, this.version);
+        const existing = new Set(parsed.entries.map((e) => e.entry_id));
+        const entriesAdded = merged.filter((e) => !existing.has(e.entry_id)).length;
+        const request = this.wholeRequest(path, content);
+        return { path, request, write: this.writer.plan(request), entriesAdded };
+    }
+    /**
+     * Tombstone-append planner (K8-020 / D8-09): emits one `tombstone`
+     * line per entry id, never deletes a line. The identifying triple is
+     * reconstructed from the local projection (a memory with
+     * `shared_entry_id`) so the line still passes parse's
+     * tamper-evident entry_id check; an id with no local projection is
+     * refused rather than emitting an invalid line.
+     */
+    planTombstone(entryIds, path) {
+        const { exists, parsed } = this.readWithFlag(path);
+        if (exists && parsed.version === 0) {
+            return this.refused(path, "not_okf");
+        }
+        if (exists && parsed.version > OKF_VERSION) {
+            return this.refused(path, "version_ahead");
+        }
+        if (parsed.repoId !== null && parsed.repoId !== this.repoId) {
+            return this.refused(path, "repo_mismatch");
+        }
+        if (exists && parsed.rejected.length > 0) {
+            return this.refused(path, "parse_damaged");
+        }
+        if (entryIds.length === 0) {
+            const content = serialize(parsed.entries, this.repoId, this.version);
+            const request = this.wholeRequest(path, content);
+            return {
+                path,
+                request,
+                write: this.writer.plan(request),
+                entriesAdded: 0,
+            };
+        }
+        const unique = [...new Set(entryIds)];
+        const placeholders = unique.map(() => "?").join(", ");
+        const rows = this.store
+            .prepare(`SELECT type, content, scope, evidence_count, recurrence_count,
+				        origin, created_at
+				 FROM memories
+				 WHERE shared_entry_id IN (${placeholders}) AND repo_id = ?`)
+            .all(...unique, this.repoId);
+        if (rows.length !== entryIds.length) {
+            return this.refused(path, "unknown_entry");
+        }
+        const tombstones = rows.map((row) => ({
+            ...memoryToEntry(row),
+            op: "tombstone",
+        }));
+        const merged = merge(parsed.entries, tombstones);
+        if (merged.length > MAX_ENTRIES) {
+            return this.refused(path, "too_many_entries");
+        }
+        const content = serialize(merged, this.repoId, this.version);
+        const existing = new Set(parsed.entries.map((e) => e.entry_id));
+        const entriesAdded = merged.filter((e) => !existing.has(e.entry_id)).length;
+        const request = this.wholeRequest(path, content);
+        return { path, request, write: this.writer.plan(request), entriesAdded };
+    }
+    /**
+     * v0.8.0 (BUG-003) — heal a stale `#repo` header after a rekey.
+     * Rekey changes the scope the file is written under; a stale first
+     * line would make every later planExport/planTombstone refuse with
+     * repo_mismatch forever. Only the header line is replaced; the entry
+     * bytes, line endings and trailing newline are preserved. The write
+     * goes through the single funnel (D8-08). Returns true when the
+     * header was rewritten. Never throws: a missing or unreadable file
+     * is nothing to heal.
+     */
+    healHeader(path, newRepoId) {
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+        }
+        catch {
+            return false;
+        }
+        const eol = text.includes("\r\n") ? "\r\n" : "\n";
+        const lines = text.split(/\r?\n/);
+        const header = `#repo ${newRepoId}`;
+        const repoLine = lines.findIndex((l) => l.startsWith("#repo "));
+        if (repoLine === -1 || lines[repoLine] === header)
+            return false;
+        lines[repoLine] = header;
+        this.writer.write(this.wholeRequest(path, lines.join(eol)));
+        return true;
+    }
+    /**
+     * Apply a previously planned export: the write goes through the
+     * single write funnel (re-planning against the file's current state),
+     * and the outcome is recorded on the returned plan (K8-020).
+     */
+    applyExport(plan) {
+        return { ...plan, applied: this.writer.write(plan.request) };
+    }
+    /** Refusal plans are audited with both hashes (after === before). */
+    refused(path, reason) {
+        const request = this.wholeRequest(path, "", reason);
+        return {
+            path,
+            request,
+            write: this.writer.plan(request),
+            entriesAdded: 0,
+        };
+    }
+    /**
+     * Convert the requested local memories into OKF candidates and run
+     * the candidate-side refusals — line_too_long, below_floor,
+     * not_curated — in plan §5.5 order.
+     */
+    candidateEntries(memoryIds) {
+        if (memoryIds.length === 0) {
+            return { entries: [], refusal: null };
+        }
+        const placeholders = memoryIds.map(() => "?").join(", ");
+        const rows = this.store
+            .prepare(`SELECT type, content, scope, evidence_count, recurrence_count,
+				        origin, created_at, curated
+				 FROM memories WHERE id IN (${placeholders}) AND repo_id = ?`)
+            .all(...memoryIds, this.repoId);
+        // v0.8.0 (BUG-006) — every requested id must have a local
+        // projection, exactly like planTombstone: a typo'd or foreign id
+        // is refused instead of silently sharing the matching subset.
+        if (rows.length !== memoryIds.length) {
+            return { entries: [], refusal: "unknown_entry" };
+        }
+        const requiresApproval = this.setting("share_requires_approval", "1") === "1";
+        const floor = Number.parseFloat(this.setting("shared_confidence_floor", "0.7"));
+        const clampedFloor = Number.isNaN(floor)
+            ? 0.7
+            : Math.min(1, Math.max(0, floor));
+        const entries = [];
+        for (const row of rows) {
+            const entry = memoryToEntry(row);
+            if (Buffer.byteLength(canonicalize(entry), "utf8") > MAX_LINE_BYTES) {
+                return { entries: [], refusal: "line_too_long" };
+            }
+            if (computeConfidence(entry.evidence, entry.recurrence) < clampedFloor) {
+                return { entries: [], refusal: "below_floor" };
+            }
+            if (requiresApproval && row.curated !== 1) {
+                return { entries: [], refusal: "not_curated" };
+            }
+            entries.push(entry);
+        }
+        return { entries, refusal: null };
+    }
+    setting(key, fallback) {
+        const row = this.store
+            .prepare("SELECT value FROM kevin_settings WHERE key = ?")
+            .get(key);
+        return row?.value ?? fallback;
+    }
+    readWithFlag(path) {
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+        }
+        catch {
+            return {
+                exists: false,
+                parsed: {
+                    version: 0,
+                    repoId: null,
+                    entries: [],
+                    rejected: [],
+                    folded: 0,
+                },
+            };
+        }
+        return { exists: true, parsed: parse(text) };
+    }
+    /**
+     * Read and parse the shared file. Total: a missing or unreadable
+     * file yields an empty ParseResult, never a throw (D8-14).
+     */
+    read(path) {
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+        }
+        catch {
+            return {
+                version: 0,
+                repoId: null,
+                entries: [],
+                rejected: [],
+                folded: 0,
+            };
+        }
+        return parse(text);
+    }
+    /**
+     * Idempotent and cheap to call (K8-016 / plan §5.5): hash the file
+     * first and return `{ skipped: true }` when the hash matches the
+     * most recent `okf_imports` row for this repo_id — the session.idle
+     * path costs one readFileSync plus one hash on an unchanged
+     * repository. A missing file is not an error: it returns
+     * `fileHash: null`, `parsed: 0`, and still writes an audit row.
+     */
+    import(path) {
+        let fileHash = null;
+        let text;
+        try {
+            text = readFileSync(path, "utf8");
+            fileHash = fnv1a64(text);
+        }
+        catch {
+            fileHash = null;
+            this.writeImportRow(path, null, 0, 0, 0, 0);
+            return {
+                path,
+                fileHash: null,
+                parsed: 0,
+                folded: 0,
+                rejected: 0,
+                imported: 0,
+                tombstoned: 0,
+                skipped: false,
+            };
+        }
+        const last = this.store
+            .prepare(`SELECT file_hash FROM okf_imports
+				 WHERE repo_id = ? ORDER BY imported_at DESC, rowid DESC LIMIT 1`)
+            .get(this.repoId);
+        if (last !== undefined && last.file_hash === fileHash) {
+            this.writeImportRow(path, fileHash, 0, 0, 0, 1);
+            return {
+                path,
+                fileHash,
+                parsed: 0,
+                folded: 0,
+                rejected: 0,
+                imported: 0,
+                tombstoned: 0,
+                skipped: true,
+            };
+        }
+        const result = parse(text);
+        const imported = this.upsertEntries(result.entries);
+        const tombstoned = this.projectEntries(result.entries);
+        if (result.folded > 0) {
+            // A persistently non-zero value is signal, not error: the team
+            // is editing the same entries concurrently and the lattice is
+            // absorbing it (K8-016).
+            this.store
+                .prepare(`INSERT INTO kevin_metrics (key, value, updated_at)
+					 VALUES ('okf_merge_folds', ?, datetime('now'))
+					 ON CONFLICT(key) DO UPDATE SET
+					   value = value + excluded.value,
+					   updated_at = datetime('now')`)
+                .run(result.folded);
+        }
+        this.writeImportRow(path, fileHash, result.entries.length, result.folded, result.rejected.length, 0);
+        return {
+            path,
+            fileHash,
+            parsed: result.entries.length,
+            folded: result.folded,
+            rejected: result.rejected.length,
+            imported,
+            tombstoned,
+            skipped: false,
+        };
+    }
+    writeImportRow(path, fileHash, parsed, folded, rejected, skipped) {
+        this.store
+            .prepare(`INSERT INTO okf_imports
+				 (id, repo_id, path, file_hash, entries_parsed, entries_folded,
+				  entries_rejected, skipped)
+				 VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(uuidv7(), this.repoId, path, fileHash, parsed, folded, rejected, skipped);
+    }
+    /**
+     * Project every imported entry into memories (K8-017 / plan §5.5,
+     * D8-10): a shared memory IS a memory, so getRelevant(), rankScore(),
+     * the five gates, truth_penalty, ConflictDetector and every audit
+     * rollup keep working unchanged.
+     *
+     * - assert entries: inserted once, never updated — re-importing an
+     *   unchanged file must not create duplicates, bump evidence_count or
+     *   move updated_at. `fingerprint` is deliberately left NULL: it is a
+     *   different identity dimension (plan §3.3) and conflating it with
+     *   `shared_entry_id` would make the v0.4.0 supersede path fire on
+     *   unrelated entries (K8-017 acceptance).
+     * - tombstone entries: the ONE place in this codebase where the shared
+     *   layer may write memories.status. This is NOT a v0.7.0 Principle 24
+     *   violation: that principle forbids *contradiction* — a fuzzy
+     *   inference — from writing status, and a tombstone is the opposite:
+     *   an explicit, committed, human-reviewed decision that arrived
+     *   through a pull request (D8-09, plan §5.5).
+     *
+     * Returns the number of memories archived by tombstones.
+     */
+    projectEntries(entries) {
+        const findMemory = this.store.prepare(`SELECT id FROM memories
+		 WHERE shared_entry_id = ? AND repo_id = ? LIMIT 1`);
+        const insertMemory = this.store.prepare(`INSERT INTO memories
+		 (id, type, content, scope, relevance_score, project_id, origin,
+		  evidence_count, recurrence_count, created_at, updated_at, status,
+		  curated, inferable, layer, repo_id, shared_entry_id)
+		 VALUES (?, ?, ?, ?, ?, ?, 'imported', ?, ?, datetime('now'),
+		  datetime('now'), 'active', 1, 1, 'shared', ?, ?)`);
+        const tombstone = this.store.prepare(`UPDATE memories SET status = 'archived'
+		 WHERE shared_entry_id = ? AND repo_id = ? AND layer = 'shared'
+		   AND status = 'active'`);
+        const lastChanges = this.store.prepare("SELECT changes() AS c");
+        let archived = 0;
+        for (const e of entries) {
+            if (e.op === "tombstone") {
+                // Explicit committed decision — see the class comment above.
+                tombstone.run(e.entry_id, this.repoId);
+                archived += lastChanges.get().c;
+                continue;
+            }
+            const existing = findMemory.get(e.entry_id, this.repoId);
+            if (existing)
+                continue;
+            insertMemory.run(uuidv7(), e.type, e.statement, 
+            // memories.scope is CHECK-constrained to project/session; a
+            // path-prefix scope from the file degrades to 'project'.
+            e.scope === "project" || e.scope === "session" ? e.scope : "project", deriveConfidence(e), this.projectId, e.evidence, e.recurrence, this.repoId, e.entry_id);
+        }
+        return archived;
+    }
+    /**
+     * Upsert every entry into shared_entries keyed on (repo_id,
+     * entry_id) — the UNIQUE index from migration 009 makes this an
+     * upsert rather than an append. `confidence` is the DERIVED value
+     * (deriveConfidence), never a transported float (plan §5.3).
+     * Returns the number of rows inserted or updated.
+     */
+    upsertEntries(entries) {
+        const upsert = this.store.prepare(`INSERT INTO shared_entries
+			 (id, repo_id, entry_id, type, statement, scope, confidence,
+			  evidence, origin, author_hash, op, supersedes, created_at,
+			  imported_at)
+			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))
+			 ON CONFLICT(repo_id, entry_id) DO UPDATE SET
+			   type = excluded.type,
+			   statement = excluded.statement,
+			   scope = excluded.scope,
+			   confidence = excluded.confidence,
+			   evidence = excluded.evidence,
+			   origin = excluded.origin,
+			   author_hash = excluded.author_hash,
+			   op = excluded.op,
+			   supersedes = excluded.supersedes,
+			   created_at = excluded.created_at,
+			   imported_at = datetime('now')`);
+        let n = 0;
+        for (const e of entries) {
+            upsert.run(uuidv7(), this.repoId, e.entry_id, e.type, e.statement, e.scope, deriveConfidence(e), e.evidence, e.origin, e.author_hash, e.op, e.supersedes, e.created_at);
+            n++;
+        }
+        return n;
+    }
+}
+//# sourceMappingURL=SharedLayer.js.map

package/dist/plugin/SharedLayer.js.map

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

package/dist/plugin/host.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ */
+/** v0.9.0 (K9-004 / plan §5.1, D9-12) */
+export type HostFlavour = "v1-only" | "v1+v2";
+/** v0.9.0 (K9-004 / plan §5.1) */
+export interface HostProject {
+    readonly id: string | null;
+    readonly worktree: string | null;
+    readonly directory: string | null;
+}
+/** v0.9.0 (K9-004 / plan §5.1) */
+export interface HostSurface {
+    /** Resolved `version` from the installed package's package.json, or null. */
+    readonly pluginVersion: string | null;
+    readonly flavour: HostFlavour;
+    readonly project: HostProject;
+    /** The host handed over `input.$` (BunShell). Zero-spawn remains a choice. */
+    readonly hasShell: boolean;
+    /** Which v2 domains the resolved package actually exposes. */
+    readonly v2: {
+        readonly skill: boolean;
+        readonly reference: boolean;
+    };
+    /** Every degraded read is explained here; never empty on a degraded probe. */
+    readonly notes: readonly string[];
+}
+/**
+ * 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 declare function probeHost(input: unknown, options?: {
+    importV2?: () => Promise<unknown>;
+}): Promise<HostSurface>;
+/**
+ * v0.9.0 (K9-004) — test hook. probeHost caches its result (probe once, freeze,
+ * restart to re-probe); tests reset between cases.
+ */
+export declare function resetHostProbeCache(): void;
+/**
+ * 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 declare function summarize(s: HostSurface): string;