@jmtrin/opencode-kevin 0.4.0 → 0.6.0

package/dist/plugin/Materializer.d.ts

@@ -0,0 +1,59 @@
+import type { ArtifactWriter, WriteOutcome } from "./ArtifactWriter.js";
+import type { Store } from "./Store.js";
+/**
+ * K6-017 — v0.6.0 pull — topic bundles for the pull channels (plan §5.6).
+ *
+ * Writes `~/.opencode-kevin/refs/<topic>.md` (one file per topic) and
+ * `~/.opencode-kevin/skills/project-knowledge.md` (one file). Both go
+ * through the `ArtifactWriter` — marker-scoped, atomic, hash-audited.
+ * There is no direct raw file-write anywhere in this module (D6-01).
+ *
+ * Topic derivation is deterministic and semantic (D6-14): a topic is
+ * `<type>-<dominant token>`, where the dominant token is the
+ * highest-frequency non-stop-word token of the fingerprint-normalized
+ * content across the memories in the group, ties broken lexicographically.
+ * Topics are NEVER derived from a fingerprint prefix, and hash-like tokens
+ * (hex-only, length >= 8) are excluded from the race entirely.
+ *
+ * Output ordering within each bundle is by memory id, matching §5.4.
+ * Regeneration with unchanged inputs is a `noop` at the ArtifactWriter
+ * level, so the "run twice, compare bytes" criterion holds for every
+ * bundle.
+ */
+export interface MaterializedBundle {
+    readonly topic: string;
+    readonly path: string;
+    readonly outcome: WriteOutcome;
+}
+export interface BundleTarget {
+    readonly topic: string;
+    readonly path: string;
+}
+export declare const SKILL_TOPIC = "project-knowledge";
+export declare class Materializer {
+    private readonly store;
+    /** `root` is injectable for tests; production defaults to ~/.opencode-kevin. */
+    private readonly root;
+    constructor(store: Store, options?: {
+        root?: string;
+    });
+    /** The curated, active memories — the knowledge the pull channels publish. */
+    private curatedRows;
+    /** The rendered skill body over all curated memories; "" when empty. */
+    skillBody(): string;
+    /** Group rows by type, deriving each type's topic from its own content. */
+    private groupByTopic;
+    /**
+     * The pull-channel targets: the skill file plus one ref file per topic.
+     * The order is deterministic (skill first, refs by topic).
+     */
+    bundleTargets(): BundleTarget[];
+    /**
+     * Regenerate every bundle through the ArtifactWriter (plan + apply).
+     * The only call site of `apply()` outside `kevin_approve` — D6-01's
+     * single write FUNCTION with two constrained targets: `kevin_approve`
+     * reaches `agents_md_path`, this module reaches `~/.opencode-kevin`
+     * only (D6-07; enforced by K6-020).
+     */
+    materialize(writer: ArtifactWriter): MaterializedBundle[];
+}

package/dist/plugin/Materializer.js

@@ -0,0 +1,237 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { firstSentence } from "./Curator.js";
+import { normalize } from "./fingerprint.js";
+export const SKILL_TOPIC = "project-knowledge";
+/** Hash-like noise: FNV-1a output is 16 lowercase hex chars; an 8+ hex
+ * token is indistinguishable from a fingerprint prefix and must never
+ * become a topic (D6-14). */
+const HEX_LIKE_RE = /^[0-9a-f]{8,}$/;
+const TOKEN_RE = /[^a-z0-9]+/;
+/** Conservative English function words; code-adjacent meaning-bearing
+ * words (npm, ts2304, cargo...) are deliberately NOT stop-words. */
+const STOP_WORDS = new Set([
+    "a",
+    "about",
+    "after",
+    "again",
+    "all",
+    "also",
+    "an",
+    "and",
+    "any",
+    "are",
+    "as",
+    "at",
+    "be",
+    "been",
+    "before",
+    "being",
+    "but",
+    "by",
+    "can",
+    "could",
+    "did",
+    "do",
+    "does",
+    "for",
+    "from",
+    "had",
+    "has",
+    "have",
+    "he",
+    "her",
+    "his",
+    "if",
+    "in",
+    "into",
+    "is",
+    "it",
+    "its",
+    "may",
+    "might",
+    "more",
+    "most",
+    "must",
+    "not",
+    "of",
+    "on",
+    "one",
+    "or",
+    "our",
+    "per",
+    "shall",
+    "she",
+    "so",
+    "than",
+    "that",
+    "the",
+    "their",
+    "them",
+    "then",
+    "there",
+    "these",
+    "they",
+    "this",
+    "those",
+    "through",
+    "to",
+    "too",
+    "under",
+    "up",
+    "us",
+    "via",
+    "was",
+    "we",
+    "were",
+    "what",
+    "when",
+    "where",
+    "which",
+    "while",
+    "who",
+    "will",
+    "with",
+    "would",
+    "you",
+    "your",
+]);
+/** Sanitize a memory type into a filesystem-safe topic prefix. */
+function sanitizeType(type) {
+    const cleaned = type
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return cleaned === "" ? "memory" : cleaned;
+}
+function tokensOf(content) {
+    return normalize(content)
+        .split(TOKEN_RE)
+        .filter((t) => t !== "" && !STOP_WORDS.has(t) && !HEX_LIKE_RE.test(t));
+}
+/** Highest-frequency non-stop-word token, ties broken lexicographically
+ * (smallest wins) so the result is stable. "" when every token is a
+ * stop-word or hash-like noise. */
+function dominantToken(rows) {
+    const counts = new Map();
+    for (const row of rows) {
+        for (const token of tokensOf(row.content)) {
+            counts.set(token, (counts.get(token) ?? 0) + 1);
+        }
+    }
+    let best = "";
+    let bestCount = 0;
+    for (const [token, count] of counts) {
+        if (count > bestCount || (count === bestCount && token < best)) {
+            best = token;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+function renderRows(rows) {
+    const sorted = [...rows].sort((a, b) => a.id.localeCompare(b.id));
+    const lines = sorted
+        .map((row) => `- ${firstSentence(row.content)}`)
+        .filter((line) => line !== "- ");
+    return lines.length === 0 ? "" : `${lines.join("\n")}\n`;
+}
+export class Materializer {
+    store;
+    /** `root` is injectable for tests; production defaults to ~/.opencode-kevin. */
+    root;
+    constructor(store, options = {}) {
+        this.store = store;
+        this.root = options.root ?? join(homedir(), ".opencode-kevin");
+    }
+    /** The curated, active memories — the knowledge the pull channels publish. */
+    curatedRows() {
+        return this.store
+            .prepare(`SELECT id, type, content FROM memories
+				 WHERE status = 'active' AND curated = 1`)
+            .all();
+    }
+    /** The rendered skill body over all curated memories; "" when empty. */
+    skillBody() {
+        return renderRows(this.curatedRows());
+    }
+    /** Group rows by type, deriving each type's topic from its own content. */
+    groupByTopic(rows) {
+        const byType = new Map();
+        for (const row of rows) {
+            const list = byType.get(row.type) ?? [];
+            list.push(row);
+            byType.set(row.type, list);
+        }
+        const groups = [];
+        for (const [type, typeRows] of byType) {
+            const token = dominantToken(typeRows);
+            if (token === "")
+                continue;
+            groups.push({
+                topic: `${sanitizeType(type)}-${token}`,
+                rows: typeRows,
+            });
+        }
+        return groups.sort((a, b) => a.topic.localeCompare(b.topic));
+    }
+    /**
+     * The pull-channel targets: the skill file plus one ref file per topic.
+     * The order is deterministic (skill first, refs by topic).
+     */
+    bundleTargets() {
+        const rows = this.curatedRows();
+        const targets = [];
+        if (rows.length > 0 && renderRows(rows) !== "") {
+            targets.push({
+                topic: SKILL_TOPIC,
+                path: join(this.root, "skills", "project-knowledge.md"),
+            });
+        }
+        for (const group of this.groupByTopic(rows)) {
+            if (renderRows(group.rows) === "")
+                continue;
+            targets.push({
+                topic: group.topic,
+                path: join(this.root, "refs", `${group.topic}.md`),
+            });
+        }
+        return targets;
+    }
+    /**
+     * Regenerate every bundle through the ArtifactWriter (plan + apply).
+     * The only call site of `apply()` outside `kevin_approve` — D6-01's
+     * single write FUNCTION with two constrained targets: `kevin_approve`
+     * reaches `agents_md_path`, this module reaches `~/.opencode-kevin`
+     * only (D6-07; enforced by K6-020).
+     */
+    materialize(writer) {
+        const pending = [];
+        const rows = this.curatedRows();
+        const skillBody = renderRows(rows);
+        if (skillBody !== "") {
+            pending.push({
+                topic: SKILL_TOPIC,
+                path: join(this.root, "skills", "project-knowledge.md"),
+                body: skillBody,
+            });
+        }
+        for (const group of this.groupByTopic(rows)) {
+            const body = renderRows(group.rows);
+            if (body === "")
+                continue;
+            pending.push({
+                topic: group.topic,
+                path: join(this.root, "refs", `${group.topic}.md`),
+                body,
+            });
+        }
+        return pending.map((bundle) => ({
+            topic: bundle.topic,
+            path: bundle.path,
+            outcome: writer.apply(writer.plan(bundle.path, bundle.body)),
+        }));
+    }
+}
+//# sourceMappingURL=Materializer.js.map

package/dist/plugin/Materializer.js.map

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

package/dist/plugin/MemoryService.d.ts

@@ -34,6 +34,26 @@ export interface Memory {
     /** v0.4.0 (BUG-008/010) — negative evidence: how many times the
      * fingerprint recurred after injection (demotes confidence). */
     recurrenceCount?: number | null;
+    /** v0.5.0 (K5-009 / plan §5.3, D5-07) — human verdict: ignored memories
+     * are excluded from retrieval and injection. */
+    ignored?: boolean;
+    /** v0.5.0 (K5-009 / plan §5.3) — id of the memory that superseded this
+     * one (decision/rule replacement, K3-014). Null when active. */
+    supersedes?: string | null;
+    /** v0.5.0 (K5-010 / plan §5.3, D5-02) — human judgement counters,
+     * folded into confidence by computeConfidence. */
+    feedbackPositive?: number;
+    /** v0.6.0 (K6-011 / plan §5.4) — curation state: curated memories have
+     * been written to AGENTS.md and are excluded from new candidates. */
+    curated?: boolean;
+    /** v0.6.0 (K6-011 / plan §5.4) — when the memory was curated (ISO time). */
+    curatedAt?: string | null;
+    /** v0.6.0 (K6-011 / plan §5.3) — deterministic inferability verdict from
+     * `inferability.classify()`; `null` = unknown, never collapsed. */
+    inferable?: "inferable" | "non_inferable" | null;
+    /** v0.5.0 (K5-010 / plan §5.3, D5-02) — human judgement counters,
+     * folded into confidence by computeConfidence. */
+    feedbackNegative?: number;
 }
 export interface SaveInput {
     type: MemoryType;
@@ -113,14 +133,32 @@ export interface GetRelevantInput {
      * by the fetch that actually produces the injected block.
      */
     bump?: boolean;
+    /**
+     * v0.5.0 (K5-008 / plan §5.6, D5-10) — injectable clock. Defaults to
+     * `new Date()` at the top of the method and is the ONLY time source
+     * for recency decay: replay and tests can freeze time. Never call
+     * `Date.now()` again inside the method.
+     */
+    now?: Date;
 }
+export declare const DATE_NOW = "2099-01-01T00:00:00.000Z";
 export declare class MemoryService {
     private readonly metrics;
     constructor(store: Store, metrics?: Metrics | null);
     private store;
     private hasRecurrenceColumn;
     private _hasRecurrenceColumn;
+    private hasIgnoredColumn;
+    private hasCuratedColumn;
     save(input: SaveInput): string;
+    /**
+     * v0.6.0 (K6-011 / plan §5.4) — mark memories as curated. Batch in a
+     * single statement with an `IN` clause; do not loop. Returns the number
+     * of rows matched by the statement (not only rows whose value changed):
+     * a second call with the same ids re-matches them, so the caller must
+     * re-filter the id list (e.g. by `curated = 0`) to observe 0.
+     */
+    markCurated(ids: readonly string[], at: string): number;
     getById(id: string): Memory | null;
     /**
      * v0.4.0 (K4-016) — most recent ACTIVE memory for a fingerprint,