@jmtrin/opencode-kevin 0.6.0 → 0.8.0

package/dist/plugin/replay-types.js

@@ -1,4 +1,3 @@
-import { z } from "zod";
 /**
  * v0.5.0 (K5-018 / plan §5.8) — replay transcript format.
  *
@@ -6,60 +5,153 @@ import { z } from "zod";
  * plugin's components and read the outcome distribution. `at` is an
  * ISO-8601 string and is the ONLY source of time during replay:
  * `Date.now()` must not be called anywhere in the replay path.
+ *
+ * v0.7.0 — hand-rolled validation: the zod dependency was removed
+ * (docs/Kevin_v0.9.0_Plan.md D9-05). This module has no zod import.
  */
-export const replayEventSchema = z.discriminatedUnion("kind", [
-    z.object({
-        kind: z.literal("session.created"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-    }),
-    z.object({
-        kind: z.literal("chat.message"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-        text: z.string().min(1),
-    }),
-    z.object({
-        kind: z.literal("tool.before"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-        callId: z.string().min(1),
-        tool: z.string().min(1),
-        args: z.record(z.string(), z.unknown()),
-    }),
-    z.object({
-        kind: z.literal("tool.after"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-        callId: z.string().min(1),
-        success: z.boolean(),
-        stdout: z.string().optional(),
-        stderr: z.string().optional(),
-        exitCode: z.number().int().optional(),
-    }),
-    z.object({
-        kind: z.literal("system.transform"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-    }),
-    z.object({
-        kind: z.literal("compacting"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-    }),
-    z.object({
-        kind: z.literal("session.idle"),
-        at: z.string().datetime(),
-        sessionId: z.string().min(1),
-    }),
-]);
-export const replayTranscriptSchema = z.object({
-    version: z.literal(1),
-    name: z.string().min(1),
-    events: z.array(replayEventSchema).min(1),
-});
+const EVENT_KINDS = [
+    "session.created",
+    "chat.message",
+    "tool.before",
+    "tool.after",
+    "system.transform",
+    "compacting",
+    "session.idle",
+];
+const ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isIsoDatetime(value) {
+    return (typeof value === "string" &&
+        ISO_DATETIME_RE.test(value) &&
+        !Number.isNaN(Date.parse(value)));
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isInteger(value) {
+    return typeof value === "number" && Number.isInteger(value);
+}
+function parseEvent(value) {
+    if (!isObject(value)) {
+        throw new Error("replay event must be an object");
+    }
+    const kind = value.kind;
+    if (typeof kind !== "string" ||
+        !EVENT_KINDS.includes(kind)) {
+        throw new Error(`unknown replay event kind: ${String(kind)}`);
+    }
+    const at = value.at;
+    if (!isIsoDatetime(at)) {
+        throw new Error("replay event `at` must be an ISO-8601 datetime string");
+    }
+    const sessionId = value.sessionId;
+    if (!isNonEmptyString(sessionId)) {
+        throw new Error("replay event `sessionId` must be a non-empty string");
+    }
+    switch (kind) {
+        case "session.created":
+        case "system.transform":
+        case "compacting":
+        case "session.idle":
+            return { kind, at, sessionId };
+        case "chat.message": {
+            const text = value.text;
+            if (!isNonEmptyString(text)) {
+                throw new Error("chat.message `text` must be a non-empty string");
+            }
+            return { kind, at, sessionId, text };
+        }
+        case "tool.before": {
+            const callId = value.callId;
+            if (!isNonEmptyString(callId)) {
+                throw new Error("tool.before `callId` must be a non-empty string");
+            }
+            const tool = value.tool;
+            if (!isNonEmptyString(tool)) {
+                throw new Error("tool.before `tool` must be a non-empty string");
+            }
+            if (!isObject(value.args)) {
+                throw new Error("tool.before `args` must be an object");
+            }
+            return { kind, at, sessionId, callId, tool, args: value.args };
+        }
+        case "tool.after": {
+            const callId = value.callId;
+            if (!isNonEmptyString(callId)) {
+                throw new Error("tool.after `callId` must be a non-empty string");
+            }
+            if (typeof value.success !== "boolean") {
+                throw new Error("tool.after `success` must be a boolean");
+            }
+            const event = {
+                kind,
+                at,
+                sessionId,
+                callId,
+                success: value.success,
+            };
+            if (value.stdout !== undefined) {
+                if (!isNonEmptyString(value.stdout)) {
+                    throw new Error("tool.after `stdout` must be a non-empty string");
+                }
+                event.stdout = value.stdout;
+            }
+            if (value.stderr !== undefined) {
+                if (!isNonEmptyString(value.stderr)) {
+                    throw new Error("tool.after `stderr` must be a non-empty string");
+                }
+                event.stderr = value.stderr;
+            }
+            if (value.exitCode !== undefined) {
+                if (!isInteger(value.exitCode)) {
+                    throw new Error("tool.after `exitCode` must be an integer");
+                }
+                event.exitCode = value.exitCode;
+            }
+            return event;
+        }
+    }
+    throw new Error(`unhandled replay event kind: ${String(kind)}`);
+}
 /** Validates an unknown payload (e.g. a parsed JSON file) as a transcript. */
 export function parseTranscript(json) {
-    return replayTranscriptSchema.parse(json);
+    if (!isObject(json)) {
+        throw new Error("replay transcript must be an object");
+    }
+    if (json.version !== 1) {
+        throw new Error("replay transcript `version` must be 1");
+    }
+    const name = json.name;
+    if (!isNonEmptyString(name)) {
+        throw new Error("replay transcript `name` must be a non-empty string");
+    }
+    if (!Array.isArray(json.events) || json.events.length === 0) {
+        throw new Error("replay transcript `events` must be a non-empty array");
+    }
+    return {
+        version: 1,
+        name,
+        events: json.events.map(parseEvent),
+    };
+}
+function toSchema(parse) {
+    return {
+        parse,
+        safeParse(value) {
+            try {
+                return { success: true, data: parse(value) };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                };
+            }
+        },
+    };
 }
+export const replayEventSchema = toSchema(parseEvent);
+export const replayTranscriptSchema = toSchema(parseTranscript);
 //# sourceMappingURL=replay-types.js.map

package/dist/plugin/replay-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"replay-types.js","sourceRoot":"","sources":["../../plugin/replay-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replay-types.js","sourceRoot":"","sources":["../../plugin/replay-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,GAAG;IACnB,iBAAiB;IACjB,cAAc;IACd,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,cAAc;CACL,CAAC;AAmCX,MAAM,eAAe,GACpB,kEAAkE,CAAC;AAEpE,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACpC,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3B,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAChC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IACC,OAAO,IAAI,KAAK,QAAQ;QACxB,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,EACjD,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IACpB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxE,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,iBAAiB,CAAC;QACvB,KAAK,kBAAkB,CAAC;QACxB,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc;YAClB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;QAChC,KAAK,cAAc,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC3D,CAAC;YACD,MAAM,KAAK,GAAgB;gBAC1B,IAAI;gBACJ,EAAE;gBACF,SAAS;gBACT,MAAM;gBACN,OAAO,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACnE,CAAC;gBACD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC7B,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACnE,CAAC;gBACD,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC7B,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC7D,CAAC;gBACD,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YACjC,CAAC;YACD,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,IAAa;IAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO;QACN,OAAO,EAAE,CAAC;QACV,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;KACnC,CAAC;AACH,CAAC;AASD,SAAS,QAAQ,CAAI,KAA4B;IAChD,OAAO;QACN,KAAK;QACL,SAAS,CAAC,KAAc;YACvB,IAAI,CAAC;gBACJ,OAAO,EAAE,OAAO,EAAE,IAAa,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO;oBACN,OAAO,EAAE,KAAc;oBACvB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;iBAChE,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAc,UAAU,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GAClC,QAAQ,CAAmB,eAAe,CAAC,CAAC"}

package/migrations/001_initial.sql

@@ -1,92 +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
--- ============================================================
+-- ============================================================
+-- 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/migrations/003_v02_signal.sql

@@ -1,58 +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.
+-- ============================================================
+-- 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');