@jmtrin/opencode-kevin 0.1.4 → 0.2.0

package/README.md

@@ -30,7 +30,7 @@ For a **single project**, put the same `plugin` array in `./opencode.json` or `.
 
 ### 2. Restart OpenCode
 
-Config is loaded once at startup and is **not hot-reloaded** — quit and reopen OpenCode after editing. On start, OpenCode resolves the npm spec, caches the plugin in `~/.cache/opencode/packages/@jmtrin/opencode-kevin/`, and exposes five tools: `kevin_save`, `kevin_query`, `kevin_recall`, `kevin_status`, `kevin_retrospective`.
+Config is loaded once at startup and is **not hot-reloaded** — quit and reopen OpenCode after editing. On start, OpenCode resolves the npm spec, caches the plugin in `~/.cache/opencode/packages/@jmtrin/opencode-kevin/`, and exposes six tools: `kevin_save`, `kevin_query`, `kevin_get`, `kevin_recall`, `kevin_status`, `kevin_retrospective`.
 
 ### 3. Where data lives
 
@@ -90,31 +90,40 @@ Use `:memory:` for `dbPath` in tests.
   ┌─────────────────┐
   │   OBSERVE        │  ToolCallObserver records every call
   │  ToolCallObserver│  (tool, args redacted, success, duration, error_type)
+  │                  │  + stripPrivate blocks + opt-in dedup (v0.2.0)
   └────────┬────────┘
            │ on failure
            ▼
   ┌─────────────────┐
   │   LEARN          │  Reflector generates a heuristic lesson
-  │   Reflector      │  redacts paths/secrets, throttled 1/min,
-  └────────┬────────┘  persists type:error memory
+  │   Reflector      │  per-error-code code table (v0.2.0 lesson v2),
+  │                  │  per-fingerprint throttle, origin='reflector',
+  │                  │  fingerprint=FNV-1a 64-bit
+  └────────┬────────┘
            │
            ▼
   ┌─────────────────┐
   │   SHARE          │  ContextInjector injects relevant lessons
   │ ContextInjector  │  pre-prompt (1500 tokens) and on compacting (2000 tokens)
+  │                  │  + <protect> wrapper + id: line (v0.2.0)
+  │                  │  + origin-aware rank (v0.2.0)
+  │                  │  + conditional budget (v0.2.0)
   └────────┬────────┘
            │ session.idle
            ▼
   ┌─────────────────┐
   │  RETROSPECTIVE   │  Retrospective generates ~/.opencode-kevin/retrospectives/<session>.md
-  └─────────────────┘  with summary of failures and lessons
+  │                  │  with origin labels, false-positive recap, metrics snapshot (v0.2.0)
+  │                  │  + boostPositiveReflectors (v0.2.0)
+  │                  │  + PatternMiner.mine (opt-in, v0.2.0)
+  └─────────────────┘
 ```
 
 ---
 
 ## Tools
 
-Kevin exposes 5 tools callable by the agent:
+Kevin exposes 6 tools callable by the agent:
 
 ### `kevin_save`
 
@@ -129,13 +138,27 @@ kevin_save({ type: "decision", content: "We use vitest for tests", scope: "proje
 
 ### `kevin_query`
 
-Searches memories by text (FTS5 + bm25).
+Searches memories by text (FTS5 + bm25). Returns a **slim** payload by default (v0.2.0). Pass `full: true` for the v0.1.x full content body.
 
 ```
 kevin_query({ query: "typecheck", type: "error", limit: 5 })
+// → [{ "id": "...", "type": "error", "scope": "project", "score": -0.87, "snippet": "When bash fails with typecheck:..." }, ...]
+
+kevin_query({ query: "typecheck", type: "error", limit: 5, full: true })
 // → [{ "id": "...", "type": "error", "content": "...", "scope": "project" }, ...]
 ```
 
+### `kevin_get`
+
+Fetches a **single full memory** by id (v0.2.0 — progressive disclosure). Use when `kevin_query` returns a slim snippet and you need the complete content.
+
+```
+kevin_get({ id: "0195a3b2-..." })
+// → { "id": "...", "type": "error", "content": "...", "scope": "project",
+//      "relevanceScore": 0.55, "origin": "reflector", "fingerprint": "cbf29ce484222325",
+//      "projectId": null, "metadata": null }
+```
+
 ### `kevin_recall`
 
 Retrieves relevant memories (greedy fill by relevance). Without `query`, returns all memories in scope.
@@ -147,11 +170,15 @@ kevin_recall({ query: "auth", limit: 3 })
 
 ### `kevin_status`
 
-Global counts.
+Global counts and metrics (v0.2.0 adds `memories_reflector`, `memories_agent`, `memories_pattern`, and a `metrics` object with 6 seeded counters).
 
 ```
 kevin_status({})
-// → { "memories": 42, "tool_calls": 318, "retrospectives": 7 }
+// → { "memories": 42, "memories_reflector": 12, "memories_agent": 30, "memories_pattern": 0,
+//      "tool_calls": 318, "retrospectives": 7,
+//      "metrics": { "tokens_injected_pre_prompt": 51, "tokens_injected_compacting": 0,
+//                   "reflections_throttled": 3, "duplicate_suppressions": 2,
+//                   "tool_calls_deduped": 0, "patterns_mined": 0 } }
 ```
 
 ### `kevin_retrospective`
@@ -179,9 +206,9 @@ Kevin subscribes to 6 OpenCode hooks:
 | `event` (`session.created`) | Captures current `sessionID` |
 | `event` (`session.idle`) | Generates retrospective.md for the session |
 
-**Redaction**: absolute paths (`C:\Users\...`, `/home/...`) → `<path>` and secrets (`API_KEY=`, `Bearer`, `token`) → `<redacted>` before persisting anything.
+**Redaction**: absolute paths (`C:\Users\...`, `/home/...`) → `<path>` and secrets (`API_KEY=`, `Bearer`, `token`) → `<redacted>` before persisting anything. v0.2.0 adds `<private>…</private>` block redaction: sweeps tool call args and output before persistence, replaces with `<private: redacted N chars>`.
 
-**Throttle**: Reflector generates at most 1 lesson per minute (configurable via `throttleMs`).
+**Throttle**: Reflector generates at most 1 lesson per minute per unique fingerprint (v0.2.0: per-fingerprint, not global). Configurable via `throttleMs`.
 
 **Truncation**: content > 4KB keeps the lesson searchable; only the additional context is truncated (`metadata.truncated = true`).
 
@@ -232,15 +259,22 @@ npm publish --access public
 plugin/
   index.ts              # Entry point: KevinPlugin
   Store.ts              # Wrapper SQLite (node:sqlite / bun:sqlite / better-sqlite3 fallback)
-  Migrate.ts            # Idempotent migrations
-  MemoryService.ts      # save/query/getRelevant (FTS5 + bm25)
-  ToolCallObserver.ts   # onBefore/onAfter + redact + inferErrorType
-  Reflector.ts          # Heuristic lessons + throttle + truncation
-  ContextInjector.ts    # deriveQuery + pre-prompt/compacting injection
-  Retrospective.ts      # Generates retrospective.md + table insert
+  Migrate.ts            # Idempotent migrations + post-apply hooks
+  MemoryService.ts      # save/query/getRelevant (FTS5 + bm25 + origin-aware rank)
+  ToolCallObserver.ts   # onBefore/onAfter + redact + inferErrorType + dedup (opt-in)
+  Reflector.ts          # Heuristic lessons + per-fingerprint throttle + lesson v2
+  ContextInjector.ts    # deriveQuery + pre-prompt/compacting injection + conditional budget
+  Retrospective.ts      # Generates retrospective.md + FP recap + metrics snapshot
+  fingerprint.ts        # FNV-1a 64-bit (in-house, no node:crypto)
+  metrics.ts            # In-memory counters + debounced flush to kevin_metrics
+  PatternMiner.ts       # Opt-in deterministic 2-gram/3-gram miner
+  memory-format.ts      # escapeInjectedText, formatMemories, <protect> + id: line wrappers
+  redact.ts             # redactPaths + stripPrivate
+  uuid.ts               # UUIDv7
 migrations/
   001_initial.sql       # schema: memories, tool_calls, retrospectives
   002_indexes.sql       # FTS5 + indexes
+  003_v02_signal.sql    # v0.2.0 Signal Quality: fingerprint, origin, metrics, dedup indexes
 tests/{unit,integration,e2e}/
 scripts/
   copy-migrations.mjs   # build step: copies *.sql to dist/migrations

package/dist/migrations/003_v02_signal.sql

@@ -0,0 +1,58 @@
+-- ============================================================
+-- Kevin 0.2.0 — Migration 003: Signal Quality (additive)
+-- ============================================================
+-- Backward-compatible, additive only. All new columns are
+-- nullable or carry a NOT NULL DEFAULT so legacy rows keep
+-- working without a destructive rebuild. The partial UNIQUE
+-- index excludes NULL fingerprints so legacy error memories
+-- do not collide. The schema_version table (created by 001)
+-- guarantees this file runs at most once per DB.
+-- ============================================================
+
+-- 1. memories: Signal Quality columns.
+--    project_id — first-class scoping dimension (D2-11).
+--    fingerprint — stable hash of normalized error content, salted by project_id (D2-14).
+--    origin — distinguishes reflector-sourced vs agent-sourced memories (D2-06),
+--             with a CHECK enum and DEFAULT 'agent' so legacy rows backfill cleanly.
+ALTER TABLE memories ADD COLUMN project_id  TEXT;
+ALTER TABLE memories ADD COLUMN fingerprint TEXT;
+ALTER TABLE memories ADD COLUMN origin      TEXT NOT NULL DEFAULT 'agent'
+  CHECK(origin IN ('reflector', 'agent', 'pattern', 'retrospective'));
+
+-- 2. tool_calls: same scoping/fingerprint columns for dedup and PatternMiner.
+ALTER TABLE tool_calls ADD COLUMN project_id  TEXT;
+ALTER TABLE tool_calls ADD COLUMN fingerprint TEXT;
+
+-- 3. Partial UNIQUE: one reflector-sourced error memory per (project_id, fingerprint).
+--    NULL fingerprints are excluded (no dedup for non-error memories or legacy rows).
+CREATE UNIQUE INDEX IF NOT EXISTS uq_memories_error_fp
+  ON memories (project_id, fingerprint)
+  WHERE type = 'error' AND fingerprint IS NOT NULL AND origin = 'reflector';
+
+-- 4. kevin_metrics: seeded counters surfaced by kevin_status (D2-07 / K2-004).
+CREATE TABLE IF NOT EXISTS kevin_metrics (
+  key        TEXT PRIMARY KEY,
+  value      INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+INSERT OR IGNORE INTO kevin_metrics (key, value) VALUES
+  ('tokens_injected_pre_prompt', 0),
+  ('tokens_injected_compacting',  0),
+  ('reflections_throttled',       0),
+  ('duplicate_suppressions',      0),
+  ('tool_calls_deduped',          0),
+  ('patterns_mined',              0);
+
+-- 5. kevin_settings: opt-in feature flags (PatternMiner off, tool_calls dedup off).
+CREATE TABLE IF NOT EXISTS kevin_settings (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+INSERT OR IGNORE INTO kevin_settings (key, value) VALUES
+  ('patternminer_enabled',     '0'),
+  ('tool_calls_dedup_enabled', '0');
+
+-- 6. Seed version 003.
+INSERT OR IGNORE INTO schema_version (version) VALUES ('003');

package/dist/plugin/ContextInjector.d.ts

@@ -1,4 +1,5 @@
 import type { MemoryService } from "./MemoryService.js";
+import { type Metrics } from "./metrics.js";
 export interface ChatMessage {
     role: string;
     content: string;
@@ -19,9 +20,19 @@ export interface CompactingOutput {
 }
 export declare class ContextInjector {
     private memoryService;
-    constructor(memoryService: MemoryService);
+    private metrics;
+    constructor(memoryService: MemoryService, metrics?: Metrics | null);
+    /**
+     * v0.2.0 (K2-024): origin-aware ranking at injection time is delegated
+     * to `MemoryService.getRelevant()` (K2-023, D2-13). The injector does
+     * NOT re-rank on its own — it consumes the already-ranked slice and
+     * applies the conditional-budget guard for opt-out (`protect: false`)
+     * callers. Plan §B6.5: "apply the same multiplier as
+     * MemoryService.recall so reflector lessons outrank agent-saved notes
+     * at injection time" — satisfied transitively via the getRelevant call.
+     */
+    private inject;
     deriveQuery(messages: ChatMessage[]): string;
     onSystemTransform(input: SystemTransformInput, output: SystemTransformOutput): void;
     onCompacting(input: CompactingInput, output: CompactingOutput): void;
-    private formatMemories;
 }

package/dist/plugin/ContextInjector.js

@@ -1,3 +1,5 @@
+import { formatMemories } from "./memory-format.js";
+import { estimateTokens } from "./metrics.js";
 const SYSTEM_TRANSFORM_TOKENS = 1500;
 const COMPACTING_TOKENS = 2000;
 const STOP_WORDS = new Set([
@@ -68,8 +70,41 @@ function isWordChar(ch) {
 }
 export class ContextInjector {
     memoryService;
-    constructor(memoryService) {
+    metrics;
+    constructor(memoryService, metrics = null) {
         this.memoryService = memoryService;
+        this.metrics = metrics;
+    }
+    /**
+     * v0.2.0 (K2-024): origin-aware ranking at injection time is delegated
+     * to `MemoryService.getRelevant()` (K2-023, D2-13). The injector does
+     * NOT re-rank on its own — it consumes the already-ranked slice and
+     * applies the conditional-budget guard for opt-out (`protect: false`)
+     * callers. Plan §B6.5: "apply the same multiplier as
+     * MemoryService.recall so reflector lessons outrank agent-saved notes
+     * at injection time" — satisfied transitively via the getRelevant call.
+     */
+    inject(query, tag, cap, metricKey) {
+        let memories = this.memoryService.getRelevant({ query, maxTokens: cap });
+        if (memories.length === 0)
+            return "";
+        const firstBlock = formatMemories(memories, tag);
+        const aggregateTokens = estimateTokens(firstBlock);
+        const firstRowProtect = memories[0]
+            ?.protect;
+        const noProtectAboveTheFold = firstRowProtect === false;
+        if (aggregateTokens > 0.8 * cap && noProtectAboveTheFold) {
+            const lowerCap = Math.max(1, Math.round(0.8 * cap));
+            memories = this.memoryService.getRelevant({
+                query,
+                maxTokens: lowerCap,
+            });
+            if (memories.length === 0)
+                return "";
+        }
+        const block = formatMemories(memories, tag);
+        this.metrics?.incr(metricKey, estimateTokens(block));
+        return block;
     }
     deriveQuery(messages) {
         let lastUserContent = "";
@@ -99,33 +134,17 @@ export class ContextInjector {
         const query = this.deriveQuery(input.messages);
         if (!query)
             return;
-        const memories = this.memoryService.getRelevant({
-            query,
-            maxTokens: SYSTEM_TRANSFORM_TOKENS,
-        });
-        if (memories.length === 0)
-            return;
-        output.system.push(this.formatMemories(memories, "context"));
+        const block = this.inject(query, "context", SYSTEM_TRANSFORM_TOKENS, "tokens_injected_pre_prompt");
+        if (block)
+            output.system.push(block);
     }
     onCompacting(input, output) {
         const query = this.deriveQuery(input.messages);
         if (!query)
             return;
-        const memories = this.memoryService.getRelevant({
-            query,
-            maxTokens: COMPACTING_TOKENS,
-        });
-        if (memories.length === 0)
-            return;
-        output.context.push(this.formatMemories(memories, "memory"));
-    }
-    formatMemories(memories, format) {
-        const lines = memories.map((m) => `[${m.type}] ${m.content}`);
-        const body = lines.join("\n");
-        if (format === "context") {
-            return `<kevin-context>Lecciones relevantes:\n${body}\n</kevin-context>`;
-        }
-        return `<kevin-memory>\n${body}\n</kevin-memory>`;
+        const block = this.inject(query, "memory", COMPACTING_TOKENS, "tokens_injected_compacting");
+        if (block)
+            output.context.push(block);
     }
 }
 //# sourceMappingURL=ContextInjector.js.map

package/dist/plugin/ContextInjector.js.map

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

package/dist/plugin/MemoryService.d.ts

@@ -1,6 +1,8 @@
 import type { Store } from "./Store.js";
+import type { Metrics } from "./metrics.js";
 export type MemoryType = "error" | "pattern" | "decision" | "context";
 export type MemoryScope = "project" | "session";
+export type MemoryOrigin = "reflector" | "agent" | "pattern" | "retrospective";
 export interface Memory {
     id: string;
     type: MemoryType;
@@ -13,6 +15,12 @@ export interface Memory {
     createdAt: string;
     updatedAt: string;
     expiresAt?: string | null;
+    /** v0.2.0 — project the memory belongs to (nullable for legacy rows). */
+    projectId?: string | null;
+    /** v0.2.0 — content fingerprint for dedup (only set for `type='error'`). */
+    fingerprint?: string | null;
+    /** v0.2.0 — origin of the memory. */
+    origin?: MemoryOrigin | null;
 }
 export interface SaveInput {
     type: MemoryType;
@@ -23,12 +31,33 @@ export interface SaveInput {
     sourceSession?: string;
     metadata?: Record<string, unknown>;
     expiresAt?: string;
+    /** v0.2.0 — project id. When absent, the memory is cross-project (NULL project_id). */
+    projectId?: string;
+    /** v0.2.0 — origin. Defaults to `'agent'` when omitted. */
+    origin?: MemoryOrigin;
+    /** v0.2.0 — explicit fingerprint. Auto-derived for `type='error'` if absent. */
+    fingerprint?: string;
 }
 export interface QueryInput {
     text: string;
     type?: string;
     scope?: MemoryScope | "all";
     limit?: number;
+    /** v0.2.0 — when true, returns full `Memory` rows (v0.1.x behavior).
+     * When `false` or absent, returns `SlimMemory` rows (default v0.2.0
+     * behavior, per plan §B6.3 / K2-010).
+     */
+    full?: boolean;
+}
+/** v0.2.0 — slim query payload (K2-010). Snippet is a short content prefix;
+ * `score` is the FTS5 BM25 score when available, falling back to
+ * `relevanceScore` for non-FTS callers. */
+export interface SlimMemory {
+    id: string;
+    type: MemoryType;
+    scope: MemoryScope;
+    score: number;
+    snippet: string;
 }
 export interface GetRelevantInput {
     query?: string;
@@ -36,14 +65,32 @@ export interface GetRelevantInput {
     scope?: MemoryScope | "all";
 }
 export declare class MemoryService {
+    private readonly metrics;
+    constructor(store: Store, metrics?: Metrics | null);
     private store;
-    constructor(store: Store);
     save(input: SaveInput): string;
     getById(id: string): Memory | null;
     update(id: string, fields: Partial<Memory>): void;
     delete(id: string): void;
-    query(input: QueryInput): Memory[];
+    /** v0.1.x behavior — returns full `Memory` rows. */
+    query(input: QueryInput & {
+        full: true;
+    }): Memory[];
+    /** v0.2.0 default — returns `SlimMemory` rows. */
+    query(input: QueryInput): SlimMemory[];
     private loadAll;
     private queryRelevant;
     getRelevant(input: GetRelevantInput): Memory[];
+    /**
+     * v0.2.0 (K2-026) — Feedback loop positive half (plan §B6.10 / D2-10).
+     *
+     * For each reflector-sourced error memory emitted during the given session
+     * whose fingerprint did NOT recur as a failing `tool_call` within the same
+     * project, bump `relevance_score` by `RELEVANCE_BUMP` (capped at
+     * `RELEVANCE_MAX`). Agent-saved memories are NEVER auto-boosted by this
+     * loop (anti-gaming guarantee, D2-06).
+     *
+     * Returns the number of memories that received a positive boost.
+     */
+    boostPositiveReflectors(sessionId: string): number;
 }