@jmtrin/opencode-kevin 0.1.1

package/README.md

@@ -0,0 +1,248 @@
+# Kevin
+
+> Observe and learn: the learning layer OpenCode was missing.
+
+Kevin is an [OpenCode](https://opencode.ai) plugin that **observes** every agent tool call, **learns** from failures by generating lessons, and **shares** what it learned proactively in future sessions. It does not plan, orchestrate, or compete with the plugin ecosystem. It only learns.
+
+- **Local-first**: SQLite + FTS5, no external services, no network calls.
+- **Global memory**: a single `~/.opencode-kevin/kevin.db` shared across all your projects (WAL mode → safe for concurrent sessions). No per-project folders.
+- **Standalone**: works without any other plugin. With the ecosystem, it learns more richly.
+
+---
+
+## Installation
+
+### 1. Declare the plugin
+
+Add Kevin to your OpenCode config. For **all projects** (global):
+
+```jsonc
+// ~/.config/opencode/opencode.jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "@jmtrin/opencode-kevin@latest"
+  ]
+}
+```
+
+For a **single project**, put the same `plugin` array in `./opencode.json` or `.opencode/opencode.json` at the project root.
+
+### 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`.
+
+### 3. Where data lives
+
+Kevin stores everything in a single **global, shared** location under your home directory — no per-project `.kevin/` folders:
+
+| Path | Content |
+|---|---|
+| `~/.opencode-kevin/kevin.db` | SQLite database (memories, tool calls, retrospectives). WAL mode → safe for concurrent OpenCode sessions across projects. |
+| `~/.opencode-kevin/retrospectives/<session>.md` | Per-session retrospective markdown. |
+
+Migrations run automatically on startup.
+
+### Requirements
+
+- Node.js >= 20
+- OpenCode with plugin support (`@opencode-ai/plugin` >= 1.17)
+
+### Verification
+
+```bash
+npm run verify
+```
+
+Checks Node version, SQLite, migration, MemoryService save/query, Reflector, ContextInjector, and TypeScript strict mode.
+
+### Advanced (optional)
+
+Override defaults via the plugin tuple form:
+
+```jsonc
+{
+  "plugin": [
+    ["@jmtrin/opencode-kevin", {
+      "dbPath": "/custom/path/kevin.db",
+      "retrospectivesDir": "/custom/path/retrospectives",
+      "throttleMs": 120000
+    }]
+  ]
+}
+```
+
+Use `:memory:` for `dbPath` in tests.
+
+---
+
+## Cycle: Observe → Learn → Share
+
+```
+  Tool call (success or failure)
+         │
+         ▼
+  ┌─────────────────┐
+  │   OBSERVE        │  ToolCallObserver records every call
+  │  ToolCallObserver│  (tool, args redacted, success, duration, error_type)
+  └────────┬────────┘
+           │ on failure
+           ▼
+  ┌─────────────────┐
+  │   LEARN          │  Reflector generates a heuristic lesson
+  │   Reflector      │  redacts paths/secrets, throttled 1/min,
+  └────────┬────────┘  persists type:error memory
+           │
+           ▼
+  ┌─────────────────┐
+  │   SHARE          │  ContextInjector injects relevant lessons
+  │ ContextInjector  │  pre-prompt (1500 tokens) and on compacting (2000 tokens)
+  └────────┬────────┘
+           │ session.idle
+           ▼
+  ┌─────────────────┐
+  │  RETROSPECTIVE   │  Retrospective generates ~/.opencode-kevin/retrospectives/<session>.md
+  └─────────────────┘  with summary of failures and lessons
+```
+
+---
+
+## Tools
+
+Kevin exposes 5 tools callable by the agent:
+
+### `kevin_save`
+
+Saves an explicit memory.
+
+```
+kevin_save({ type: "decision", content: "We use vitest for tests", scope: "project" })
+// → { "id": "0195a3b2-..." }
+```
+
+`type`: `error` | `pattern` | `decision` | `context`. `scope`: `project` (persists) | `session` (TTL 24h).
+
+### `kevin_query`
+
+Searches memories by text (FTS5 + bm25).
+
+```
+kevin_query({ query: "typecheck", type: "error", limit: 5 })
+// → [{ "id": "...", "type": "error", "content": "...", "scope": "project" }, ...]
+```
+
+### `kevin_recall`
+
+Retrieves relevant memories (greedy fill by relevance). Without `query`, returns all memories in scope.
+
+```
+kevin_recall({ query: "auth", limit: 3 })
+// → [{ "id": "...", "type": "decision", ... }, ...]
+```
+
+### `kevin_status`
+
+Global counts.
+
+```
+kevin_status({})
+// → { "memories": 42, "tool_calls": 318, "retrospectives": 7 }
+```
+
+### `kevin_retrospective`
+
+Generates a retrospective for a session (uses current session if `session_id` is omitted).
+
+```
+kevin_retrospective({ session_id: "sess-abc" })
+// → { "file_path": "~/.opencode-kevin/retrospectives/sess-abc.md" }
+// or → { "message": "No failures in session sess-abc." }
+```
+
+---
+
+## Hooks
+
+Kevin subscribes to 6 OpenCode hooks:
+
+| Hook | What Kevin does |
+|---|---|
+| `tool.execute.before` | Records tool call start (callID + redacted args) |
+| `tool.execute.after` | Records result; on failure → Reflector.invoke async (throttled) |
+| `experimental.chat.system.transform` | Injects relevant lessons in `<kevin-context>` (1500 tokens) |
+| `experimental.session.compacting` | Re-injects lessons in `<kevin-memory>` after compacting (2000 tokens) |
+| `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.
+
+**Throttle**: Reflector generates at most 1 lesson per minute (configurable via `throttleMs`).
+
+**Truncation**: content > 4KB keeps the lesson searchable; only the additional context is truncated (`metadata.truncated = true`).
+
+---
+
+## Configuration
+
+Kevin accepts options via the plugin's tuple form (see Installation → Advanced). Programmatic defaults:
+
+```ts
+import { KevinPlugin } from "@jmtrin/opencode-kevin";
+
+// defaults
+KevinPlugin(input, {
+  dbPath: "~/.opencode-kevin/kevin.db",            // or ":memory:" for tests
+  migrationsDir: "<package>/dist/migrations",       // resolved automatically
+  retrospectivesDir: "~/.opencode-kevin/retrospectives",
+  throttleMs: 60_000,
+});
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/jmtrin/opencode-kevin.git
+cd opencode-kevin
+npm install
+npm run typecheck   # tsc --noEmit (strict)
+npm run lint        # biome check .
+npm test            # vitest run (unit + integration + e2e)
+npm run verify      # post-install verification
+```
+
+### Publishing (maintainer)
+
+```bash
+npm login              # as the jmtrin account that owns the @jmtrin scope
+npm publish --access public
+```
+
+`prepublishOnly` runs `npm run build` (tsc + copy migrations) automatically. The `files` field ships only `dist/plugin`, `dist/migrations`, and `migrations`. `dist/` is gitignored and rebuilt on publish.
+
+### Structure
+
+```
+plugin/
+  index.ts              # Entry point: KevinPlugin
+  Store.ts              # Wrapper better-sqlite3 (WAL, FK, transactions)
+  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
+migrations/
+  001_initial.sql       # schema: memories, tool_calls, retrospectives
+  002_indexes.sql       # FTS5 + indexes
+tests/{unit,integration,e2e}/
+scripts/
+  copy-migrations.mjs   # build step: copies *.sql to dist/migrations
+  verify-install.ts     # npm run verify
+```
+
+---
+## License
+
+MIT

package/dist/migrations/001_initial.sql

@@ -0,0 +1,92 @@
+-- ============================================================
+-- Kevin 0.1.0 — Schema inicial
+-- ============================================================
+
+-- Tabla de versiones para migraciones
+CREATE TABLE IF NOT EXISTS schema_version (
+  version TEXT PRIMARY KEY,
+  applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ============================================================
+-- memories: lecciones aprendidas
+-- ============================================================
+CREATE TABLE IF NOT EXISTS memories (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK(type IN ('error', 'pattern', 'decision', 'context')),
+  content TEXT NOT NULL,
+  scope TEXT NOT NULL DEFAULT 'project' CHECK(scope IN ('project', 'session')),
+  relevance_score REAL DEFAULT 0.5,
+  source_tool TEXT,
+  source_session TEXT,
+  metadata TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+CREATE INDEX IF NOT EXISTS idx_memories_scope ON memories(scope);
+CREATE INDEX IF NOT EXISTS idx_memories_relevance ON memories(relevance_score DESC);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
+
+-- FTS5: búsqueda full-text con remoción de diacríticos (mejor para español)
+CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+  content,
+  content='memories',
+  tokenize='unicode61 remove_diacritics 1'
+);
+
+-- Triggers para mantener FTS5 sincronizado (FTS5 external-content se indexa por rowid)
+CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+  INSERT INTO memories_fts(rowid, content) VALUES (new.rowid, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
+  INSERT INTO memories_fts(memories_fts, rowid, content) VALUES ('delete', old.rowid, old.content);
+  INSERT INTO memories_fts(rowid, content) VALUES (new.rowid, new.content);
+END;
+
+-- ============================================================
+-- tool_calls: observación de tool calls del agente
+-- ============================================================
+CREATE TABLE IF NOT EXISTS tool_calls (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  ts TEXT NOT NULL DEFAULT (datetime('now')),
+  tool TEXT NOT NULL,
+  args_summary TEXT,
+  success INTEGER NOT NULL CHECK(success IN (0,1)),
+  duration_ms INTEGER,
+  agent TEXT,
+  error_type TEXT,
+  metadata TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_session ON tool_calls(session_id);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_tool ON tool_calls(tool);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_ts ON tool_calls(ts);
+CREATE INDEX IF NOT EXISTS idx_tool_calls_success ON tool_calls(success);
+
+-- ============================================================
+-- retrospectives: resúmenes de sesión
+-- ============================================================
+CREATE TABLE IF NOT EXISTS retrospectives (
+  id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  ts TEXT NOT NULL DEFAULT (datetime('now')),
+  failure_count INTEGER DEFAULT 0,
+  success_count INTEGER DEFAULT 0,
+  lessons_count INTEGER DEFAULT 0,
+  file_path TEXT,
+  metadata TEXT
+);
+
+-- ============================================================
+-- Seed: versión inicial
+-- ============================================================
+INSERT OR IGNORE INTO schema_version (version) VALUES ('001');

package/dist/migrations/002_indexes.sql

@@ -0,0 +1,14 @@
+-- ============================================================
+-- Kevin 0.1.1 — Migration 002: indexes adicionales
+-- ============================================================
+
+-- F#29: uniqueness on retrospectives.session_id
+-- Prevents duplicate retrospective rows under concurrent session.idle events.
+CREATE UNIQUE INDEX IF NOT EXISTS idx_retrospectives_session
+  ON retrospectives(session_id);
+
+-- F#31: index on memories.expires_at
+-- Every query/queryRelevant/loadAll filters WHERE (expires_at IS NULL OR expires_at > datetime('now')).
+-- Without this index the filter is a linear scan on large tables.
+CREATE INDEX IF NOT EXISTS idx_memories_expires
+  ON memories(expires_at);

package/dist/plugin/ContextInjector.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryService } from "./MemoryService.js";
+export interface ChatMessage {
+    role: string;
+    content: string;
+}
+export interface SystemTransformInput {
+    sessionID?: string;
+    messages: ChatMessage[];
+}
+export interface SystemTransformOutput {
+    system: string[];
+}
+export interface CompactingInput {
+    sessionID: string;
+    messages: ChatMessage[];
+}
+export interface CompactingOutput {
+    context: string[];
+}
+export declare class ContextInjector {
+    private memoryService;
+    constructor(memoryService: MemoryService);
+    deriveQuery(messages: ChatMessage[]): string;
+    onSystemTransform(input: SystemTransformInput, output: SystemTransformOutput): void;
+    onCompacting(input: CompactingInput, output: CompactingOutput): void;
+    private formatMemories;
+}

package/dist/plugin/ContextInjector.js

@@ -0,0 +1,131 @@
+const SYSTEM_TRANSFORM_TOKENS = 1500;
+const COMPACTING_TOKENS = 2000;
+const STOP_WORDS = new Set([
+    "a",
+    "an",
+    "and",
+    "are",
+    "at",
+    "be",
+    "been",
+    "but",
+    "by",
+    "did",
+    "do",
+    "does",
+    "el",
+    "eso",
+    "for",
+    "how",
+    "i",
+    "if",
+    "in",
+    "is",
+    "it",
+    "la",
+    "las",
+    "los",
+    "mi",
+    "my",
+    "o",
+    "of",
+    "on",
+    "or",
+    "para",
+    "por",
+    "que",
+    "she",
+    "su",
+    "that",
+    "the",
+    "this",
+    "to",
+    "tu",
+    "un",
+    "una",
+    "we",
+    "were",
+    "what",
+    "when",
+    "where",
+    "which",
+    "who",
+    "why",
+    "with",
+    "y",
+    "you",
+    "como",
+    "con",
+    "de",
+    "en",
+    "he",
+    "they",
+    "was",
+    "sin",
+]);
+function isWordChar(ch) {
+    return /[a-z0-9áéíóúüñ]/i.test(ch);
+}
+export class ContextInjector {
+    memoryService;
+    constructor(memoryService) {
+        this.memoryService = memoryService;
+    }
+    deriveQuery(messages) {
+        let lastUserContent = "";
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === "user") {
+                lastUserContent = messages[i].content;
+                break;
+            }
+        }
+        if (!lastUserContent)
+            return "";
+        const tokens = lastUserContent
+            .toLowerCase()
+            .split(/\s+/)
+            .map((t) => {
+            let out = "";
+            for (const ch of t) {
+                if (isWordChar(ch))
+                    out += ch;
+            }
+            return out;
+        })
+            .filter((t) => t.length > 0 && !STOP_WORDS.has(t));
+        return tokens.join(" ");
+    }
+    onSystemTransform(input, output) {
+        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"));
+    }
+    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>`;
+    }
+}
+//# sourceMappingURL=ContextInjector.js.map

package/dist/plugin/ContextInjector.js.map

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

package/dist/plugin/MemoryService.d.ts

@@ -0,0 +1,49 @@
+import type { Store } from "./Store.js";
+export type MemoryType = "error" | "pattern" | "decision" | "context";
+export type MemoryScope = "project" | "session";
+export interface Memory {
+    id: string;
+    type: MemoryType;
+    content: string;
+    scope: MemoryScope;
+    relevanceScore: number;
+    sourceTool?: string | null;
+    sourceSession?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt?: string | null;
+}
+export interface SaveInput {
+    type: MemoryType;
+    content: string;
+    scope?: MemoryScope;
+    relevanceScore?: number;
+    sourceTool?: string;
+    sourceSession?: string;
+    metadata?: Record<string, unknown>;
+    expiresAt?: string;
+}
+export interface QueryInput {
+    text: string;
+    type?: string;
+    scope?: MemoryScope | "all";
+    limit?: number;
+}
+export interface GetRelevantInput {
+    query?: string;
+    maxTokens?: number;
+    scope?: MemoryScope | "all";
+}
+export declare class MemoryService {
+    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[];
+    private loadAll;
+    private queryRelevant;
+    getRelevant(input: GetRelevantInput): Memory[];
+}