@jmtrin/kevin-core 1.5.0 → 2.1.0

package/dist/sources/OpencodeNativeSource.js

@@ -0,0 +1,135 @@
+// K16-016 — OpencodeNativeSource (native opencode memories, e.g. .opencode/memory)
+// K21-006 — Relay probe activation: single-source location list, absent-safe
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+export const NATIVE_CANDIDATE_PATHS = [
+    ".opencode/memory/*.md",
+    ".opencode/MEMORY.md",
+];
+function globMdFiles(dir) {
+    try {
+        const entries = readdirSync(dir);
+        return entries.filter((f) => f.endsWith(".md")).map((f) => join(dir, f));
+    }
+    catch {
+        return [];
+    }
+}
+export class OpencodeNativeSource {
+    enabledFlag;
+    projectRoot;
+    name = "opencode-native";
+    precedence = 40;
+    constructor(enabledFlag, projectRoot = process.cwd()) {
+        this.enabledFlag = enabledFlag;
+        this.projectRoot = projectRoot;
+    }
+    enabled() {
+        return this.enabledFlag();
+    }
+    async fetch() {
+        if (!this.enabled())
+            return [];
+        const out = [];
+        const seen = new Set();
+        for (const pattern of NATIVE_CANDIDATE_PATHS) {
+            try {
+                if (pattern.includes("*")) {
+                    // e.g. .opencode/memory/*.md
+                    const base = pattern.split("*")[0].replace(/\/$/, "");
+                    const dir = join(this.projectRoot, base);
+                    let st = null;
+                    try {
+                        st = statSync(dir);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!st.isDirectory())
+                        continue;
+                    for (const file of globMdFiles(dir)) {
+                        if (seen.has(file))
+                            continue;
+                        seen.add(file);
+                        try {
+                            const txt = readFileSync(file, "utf8");
+                            for (const line of txt.split("\n").map((s) => s.trim()).filter(Boolean).slice(0, 50)) {
+                                if (out.length >= 100)
+                                    break;
+                                out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                            }
+                        }
+                        catch {
+                            // absent-safe: skip unreadable file
+                        }
+                    }
+                }
+                else {
+                    const abs = join(this.projectRoot, pattern);
+                    let st = null;
+                    try {
+                        st = statSync(abs);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!st.isFile())
+                        continue;
+                    if (seen.has(abs))
+                        continue;
+                    seen.add(abs);
+                    try {
+                        const txt = readFileSync(abs, "utf8");
+                        for (const line of txt.split("\n").map((s) => s.trim()).filter(Boolean).slice(0, 100)) {
+                            if (out.length >= 100)
+                                break;
+                            out.push({ statement: line, type: "rule", scope: null, source: this.name });
+                        }
+                    }
+                    catch {
+                        // skip
+                    }
+                }
+            }
+            catch {
+                // never throw
+            }
+        }
+        return out;
+    }
+    health() {
+        let found = 0;
+        for (const pattern of NATIVE_CANDIDATE_PATHS) {
+            try {
+                if (pattern.includes("*")) {
+                    const base = pattern.split("*")[0].replace(/\/$/, "");
+                    const dir = join(this.projectRoot, base);
+                    try {
+                        const st = statSync(dir);
+                        if (!st.isDirectory())
+                            continue;
+                        found += globMdFiles(dir).length;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+                else {
+                    const abs = join(this.projectRoot, pattern);
+                    try {
+                        const st = statSync(abs);
+                        if (st.isFile())
+                            found++;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+            }
+            catch { }
+        }
+        if (found > 0)
+            return { status: "ok", detail: `found ${found} files` };
+        return { status: "absent", detail: "no native memory found at probe paths" };
+    }
+}

package/dist/sources/OpencodePluginSource.d.ts

@@ -0,0 +1,9 @@
+import type { MemorySource, SourceEntry } from "./MemorySource.js";
+export declare class OpencodePluginSource implements MemorySource {
+    private enabledFlag;
+    name: string;
+    precedence: number;
+    constructor(enabledFlag: () => boolean);
+    enabled(): boolean;
+    fetch(): Promise<SourceEntry[]>;
+}

package/dist/sources/OpencodePluginSource.js

@@ -0,0 +1,15 @@
+export class OpencodePluginSource {
+    enabledFlag;
+    name = "opencode-plugin";
+    precedence = 10;
+    constructor(enabledFlag) {
+        this.enabledFlag = enabledFlag;
+    }
+    enabled() {
+        return this.enabledFlag();
+    }
+    async fetch() {
+        // Plugin source is the local DB itself — no fetch, handled elsewhere
+        return [];
+    }
+}

package/dist/sources/deletion.d.ts

@@ -0,0 +1,18 @@
+export interface DeletedInfo {
+    source: string;
+    fingerprint: string;
+    file?: string;
+}
+/**
+ * Pure diff: fingerprints present in prev but absent from current.
+ * Both sets are expected to be non-null; empty sets return [].
+ * Malformed inputs (null, non-Set) return [] never throw.
+ */
+export declare function collectDeletions(prevFingerprints: Set<string> | string[] | null | undefined, currentFingerprints: Set<string> | string[] | null | undefined, source: string): DeletedInfo[];
+/**
+ * Variant that parses memory_sources.meta_json shape if present.
+ * Expected shape: {"files":{"path":{"mtime":123,"size":456}}} or legacy null/string.
+ * For v2.1, meta_json may be absent (no per-file tracking yet) — returns [] gracefully.
+ * Kept for spec compatibility (plan §4.3 collectDeletions(prevMetaJson, currentFiles)).
+ */
+export declare function collectDeletionsFromMeta(prevMetaJson: string | null, currentFiles: Set<string>, source: string, fingerprintByFile?: Map<string, string>): DeletedInfo[];

package/dist/sources/deletion.js

@@ -0,0 +1,54 @@
+// K21-005 — Source deletion sync helper
+// Detects memories from a source that have disappeared from the source's current fetch.
+// The source of truth is fingerprints: a memory whose fingerprint is no longer in the
+// fetched set is a candidate for archival + tombstone.
+// File-level meta_json diff (plan §4.3) is not present in v2.0's IdleSync — this layer
+// diffs at fingerprint granularity, which is source-agnostic and cross-file safe.
+// Cross-source protection is enforced by the caller: only memories with matching source
+// are considered deletions.
+/**
+ * Pure diff: fingerprints present in prev but absent from current.
+ * Both sets are expected to be non-null; empty sets return [].
+ * Malformed inputs (null, non-Set) return [] never throw.
+ */
+export function collectDeletions(prevFingerprints, currentFingerprints, source) {
+    if (!prevFingerprints || !currentFingerprints)
+        return [];
+    const prev = prevFingerprints instanceof Set ? prevFingerprints : new Set(prevFingerprints);
+    const curr = currentFingerprints instanceof Set ? currentFingerprints : new Set(currentFingerprints);
+    const out = [];
+    for (const fp of prev) {
+        if (typeof fp !== "string" || fp.length === 0)
+            continue;
+        if (!curr.has(fp)) {
+            out.push({ source, fingerprint: fp });
+        }
+    }
+    return out;
+}
+/**
+ * Variant that parses memory_sources.meta_json shape if present.
+ * Expected shape: {"files":{"path":{"mtime":123,"size":456}}} or legacy null/string.
+ * For v2.1, meta_json may be absent (no per-file tracking yet) — returns [] gracefully.
+ * Kept for spec compatibility (plan §4.3 collectDeletions(prevMetaJson, currentFiles)).
+ */
+export function collectDeletionsFromMeta(prevMetaJson, currentFiles, source, fingerprintByFile) {
+    if (!prevMetaJson)
+        return [];
+    try {
+        const parsed = JSON.parse(prevMetaJson);
+        if (!parsed || typeof parsed.files !== "object" || parsed.files === null)
+            return [];
+        const out = [];
+        for (const file of Object.keys(parsed.files)) {
+            if (!currentFiles.has(file)) {
+                const fp = fingerprintByFile?.get(file) ?? file;
+                out.push({ source, file, fingerprint: fp });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}

package/package.json

@@ -1,28 +1,26 @@
 {
-  "name": "@jmtrin/kevin-core",
-  "version": "1.5.0",
-  "description": "Kevin core — host-agnostic deterministic brain (Bedrock)",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json && node ./scripts/copy-migrations.mjs",
-    "typecheck": "tsc --noEmit"
-  },
-  "engines": {
-    "node": ">=22.5.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT"
+	"name": "@jmtrin/kevin-core",
+	"version": "2.1.0",
+	"description": "Kevin core — host-agnostic deterministic brain (Bedrock)",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsc -p tsconfig.json && node ./scripts/copy-migrations.mjs",
+		"typecheck": "tsc --noEmit"
+	},
+	"engines": {
+		"node": ">=22.5.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"license": "MIT"
 }