@jmtrin/opencode-kevin 0.4.0 → 0.6.0

package/dist/plugin/kevin_why.js

@@ -1,6 +1,24 @@
 import { TS_CODE_RULES } from "./Reflector.js";
 import { computeConfidence } from "./confidence.js";
 import { toMatchClause, tokenizeQuery } from "./query-tokenizer.js";
+// v0.5.0 (K5-010 / plan §5.3) — pre-006 DBs lack the feedback columns;
+// kevin_why must not reference them (it degrades via the try/catch below,
+// which is for missing ROWS, not missing COLUMNS). Probe once per store.
+const feedbackColumnCache = new WeakMap();
+function hasFeedbackColumns(store) {
+    const cached = feedbackColumnCache.get(store);
+    if (cached !== undefined)
+        return cached;
+    try {
+        store.prepare("SELECT feedback_positive FROM memories LIMIT 1").get();
+        feedbackColumnCache.set(store, true);
+        return true;
+    }
+    catch {
+        feedbackColumnCache.set(store, false);
+        return false;
+    }
+}
 export function kevinWhy(store, query) {
     // v0.3.0 fix (bug #7) — the old code wrapped the WHOLE query in a
     // single quoted phrase, so it only matched the exact full-string
@@ -17,7 +35,9 @@ export function kevinWhy(store, query) {
     try {
         patternRows = store
             .prepare(`SELECT m.id, m.content, m.fingerprint, m.evidence_count,
-				        m.recurrence_count, m.fix_args, m.last_verified_at, m.created_at
+				        m.recurrence_count, m.fix_args, m.last_verified_at, m.created_at${hasFeedbackColumns(store)
+            ? ", m.feedback_positive, m.feedback_negative"
+            : ""}
 				 FROM memories_fts
 				 JOIN memories m ON m.rowid = memories_fts.rowid
 				 WHERE memories_fts MATCH ?
@@ -36,7 +56,8 @@ export function kevinWhy(store, query) {
     const pattern = patternRows[0];
     const fp = pattern.fingerprint;
     // v0.4.0 (K4-010) — two-sided confidence shared with promoteToPattern.
-    const confidence = computeConfidence(pattern.evidence_count ?? 0, pattern.recurrence_count ?? 0);
+    // v0.5.0 (K5-010) — human feedback terms nudge it (D5-02).
+    const confidence = computeConfidence(pattern.evidence_count ?? 0, pattern.recurrence_count ?? 0, pattern.feedback_positive ?? 0, pattern.feedback_negative ?? 0);
     // BUG-007 — the trace is built from the error-memory sessions below;
     // the legacy `traceRows` probe (executed but unused, with a
     // never-matching `tc.fingerprint LIKE '%<8-hex>%'` branch against the

package/dist/plugin/kevin_why.js.map

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

package/dist/plugin/metrics.d.ts

@@ -6,7 +6,7 @@ import type { Store } from "./Store.js";
  * underlying table is empty (e.g., before 003 is applied, on a fresh
  * :memory: test DB, or after a manual wipe).
  */
-export declare const METRIC_KEYS: readonly ["tokens_injected_pre_prompt", "tokens_injected_compacting", "reflections_throttled", "duplicate_suppressions", "tool_calls_deduped", "patterns_mined", "patterns_causal", "causal_links", "memories_superseded", "injections_total", "injections_effective", "injections_ineffective", "patterns_promoted_new"];
+export declare const METRIC_KEYS: readonly ["tokens_injected_pre_prompt", "tokens_injected_compacting", "reflections_throttled", "duplicate_suppressions", "tool_calls_deduped", "patterns_mined", "patterns_causal", "causal_links", "memories_superseded", "injections_total", "injections_effective", "injections_ineffective", "patterns_promoted_new", "injections_inconclusive", "injections_blocked_seen", "injections_blocked_weak", "injections_blocked_recurrence", "injections_blocked_stale", "injections_blocked_ignored", "feedback_positive_total", "feedback_negative_total", "memories_archived", "proposals_created", "proposals_approved", "proposals_rejected", "artifact_writes_total", "artifact_writes_noop", "injections_blocked_confidence"];
 export type MetricKey = (typeof METRIC_KEYS)[number];
 /**
  * Cheap token estimate used when bumping the `tokens_injected_*` counters.
@@ -35,6 +35,15 @@ export declare class Metrics {
     constructor(store: Store, flushMs?: number);
     private loadFromDb;
     incr(key: MetricKey, by?: number): void;
+    /**
+     * v0.6.0 (K6-018/019 / plan §5.8) — the pull-channel registration
+     * counters. These live OUTSIDE `METRIC_KEYS`, which is frozen at 28
+     * (K6-004 acceptance, the verified cumulative ladder), but persist to
+     * the same `kevin_metrics` table so `kevin_audit`'s channels block can
+     * read them by SQL (K6-023). They are written immediately (no debounce):
+     * they change at most twice per process, on session start.
+     */
+    incrRegistered(key: "skills_registered" | "references_registered", by?: number): void;
     /**
      * Returns a snapshot of the cache. The returned object always contains all
      * METRIC_KEYS, even if the DB has no rows yet. Does NOT flush.
@@ -48,8 +57,30 @@ export declare class Metrics {
      * v0.4.0 (K4-008): injection precision = effective / total settled
      * injections. 0 when the ledger has no entries yet (no division by zero).
      * Computed from the cached counters — does NOT flush.
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the denominator is now
+     * `effective + ineffective` only. `inconclusive` (the new majority
+     * bucket) must not inflate precision: absence of recurrence is not
+     * evidence of effect. An idle session therefore no longer drives
+     * precision toward 1.0 — expect the reported rate to fall sharply on
+     * real databases; that is the intended result.
      */
     precisionRate(): number;
+    /**
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the share of injections that
+     * were actually measured (effective + ineffective) of all injections.
+     * Reported alongside `precisionRate` so a low measurable fraction is
+     * visible rather than hidden behind a large `total`. 0 when the ledger
+     * is empty. Computed from the cached counters — does NOT flush.
+     */
+    coverageRate(): number;
+    /**
+     * v0.5.0 (K5-004 / plan §5.2, D5-02) — the five `injections_blocked_*`
+     * counters keyed by their short names. Consumed by `kevin_audit`.
+     * v0.6.0 (K6-004 / plan §8.3) — sixth member keyed `confidence`
+     * (the low_confidence gate branch, K6-022).
+     * Computed from the cached counters — does NOT flush.
+     */
+    blockedSnapshot(): Record<string, number>;
     /** True iff a debounced flush is scheduled. Useful for tests. */
     isFlushScheduled(): boolean;
     /**

package/dist/plugin/metrics.js

@@ -19,6 +19,25 @@ export const METRIC_KEYS = [
     "injections_effective",
     "injections_ineffective",
     "patterns_promoted_new",
+    // v0.5.0 (K5-004 / plan §8.3) — order matches migration 006's seed block.
+    "injections_inconclusive",
+    "injections_blocked_seen",
+    "injections_blocked_weak",
+    "injections_blocked_recurrence",
+    "injections_blocked_stale",
+    "injections_blocked_ignored",
+    "feedback_positive_total",
+    "feedback_negative_total",
+    "memories_archived",
+    // v0.6.0 (K6-004 / plan §8.3) — order matches migration 007's seed block.
+    // injections_blocked_confidence is the sixth member of the blocked
+    // family and MUST be counted like the other five (Principle 16).
+    "proposals_created",
+    "proposals_approved",
+    "proposals_rejected",
+    "artifact_writes_total",
+    "artifact_writes_noop",
+    "injections_blocked_confidence",
 ];
 const DEFAULT_FLUSH_MS = 1000;
 function zeroCache() {
@@ -86,6 +105,33 @@ export class Metrics {
         this.dirty.add(key);
         this.scheduleFlush();
     }
+    /**
+     * v0.6.0 (K6-018/019 / plan §5.8) — the pull-channel registration
+     * counters. These live OUTSIDE `METRIC_KEYS`, which is frozen at 28
+     * (K6-004 acceptance, the verified cumulative ladder), but persist to
+     * the same `kevin_metrics` table so `kevin_audit`'s channels block can
+     * read them by SQL (K6-023). They are written immediately (no debounce):
+     * they change at most twice per process, on session start.
+     */
+    incrRegistered(key, by = 1) {
+        if (this.closed)
+            return;
+        const store = this.store;
+        store.transaction(() => {
+            store.exec(`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'))
+			          )`);
+            store
+                .prepare(`INSERT INTO kevin_metrics (key, value, updated_at)
+			         VALUES (?, ?, datetime('now'))
+			         ON CONFLICT(key) DO UPDATE SET
+			           value = value + excluded.value,
+			           updated_at = datetime('now')`)
+                .run(key, by);
+        });
+    }
     /**
      * Returns a snapshot of the cache. The returned object always contains all
      * METRIC_KEYS, even if the DB has no rows yet. Does NOT flush.
@@ -106,13 +152,51 @@ export class Metrics {
      * v0.4.0 (K4-008): injection precision = effective / total settled
      * injections. 0 when the ledger has no entries yet (no division by zero).
      * Computed from the cached counters — does NOT flush.
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the denominator is now
+     * `effective + ineffective` only. `inconclusive` (the new majority
+     * bucket) must not inflate precision: absence of recurrence is not
+     * evidence of effect. An idle session therefore no longer drives
+     * precision toward 1.0 — expect the reported rate to fall sharply on
+     * real databases; that is the intended result.
      */
     precisionRate() {
+        const effective = this.cache.get("injections_effective") ?? 0;
+        const measured = effective + (this.cache.get("injections_ineffective") ?? 0);
+        if (measured <= 0)
+            return 0;
+        return Math.min(1, effective / measured);
+    }
+    /**
+     * v0.5.0 (K5-004 / plan §5.1, D5-02) — the share of injections that
+     * were actually measured (effective + ineffective) of all injections.
+     * Reported alongside `precisionRate` so a low measurable fraction is
+     * visible rather than hidden behind a large `total`. 0 when the ledger
+     * is empty. Computed from the cached counters — does NOT flush.
+     */
+    coverageRate() {
         const total = this.cache.get("injections_total") ?? 0;
         if (total <= 0)
             return 0;
-        const effective = this.cache.get("injections_effective") ?? 0;
-        return Math.min(1, effective / total);
+        const measured = (this.cache.get("injections_effective") ?? 0) +
+            (this.cache.get("injections_ineffective") ?? 0);
+        return Math.min(1, measured / total);
+    }
+    /**
+     * v0.5.0 (K5-004 / plan §5.2, D5-02) — the five `injections_blocked_*`
+     * counters keyed by their short names. Consumed by `kevin_audit`.
+     * v0.6.0 (K6-004 / plan §8.3) — sixth member keyed `confidence`
+     * (the low_confidence gate branch, K6-022).
+     * Computed from the cached counters — does NOT flush.
+     */
+    blockedSnapshot() {
+        return {
+            seen: this.cache.get("injections_blocked_seen") ?? 0,
+            weak: this.cache.get("injections_blocked_weak") ?? 0,
+            recurrence: this.cache.get("injections_blocked_recurrence") ?? 0,
+            stale: this.cache.get("injections_blocked_stale") ?? 0,
+            ignored: this.cache.get("injections_blocked_ignored") ?? 0,
+            confidence: this.cache.get("injections_blocked_confidence") ?? 0,
+        };
     }
     /** True iff a debounced flush is scheduled. Useful for tests. */
     isFlushScheduled() {

package/dist/plugin/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../plugin/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../plugin/metrics.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,4BAA4B;IAC5B,4BAA4B;IAC5B,uBAAuB;IACvB,wBAAwB;IACxB,oBAAoB;IACpB,gBAAgB;IAChB,iBAAiB;IACjB,cAAc;IACd,qBAAqB;IACrB,kBAAkB;IAClB,sBAAsB;IACtB,wBAAwB;IACxB,uBAAuB;IACvB,0EAA0E;IAC1E,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,+BAA+B;IAC/B,0BAA0B;IAC1B,4BAA4B;IAC5B,yBAAyB;IACzB,yBAAyB;IACzB,mBAAmB;IACnB,0EAA0E;IAC1E,mEAAmE;IACnE,iEAAiE;IACjE,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,uBAAuB;IACvB,sBAAsB;IACtB,+BAA+B;CACtB,CAAC;AAIX,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,SAAS,SAAS;IACjB,MAAM,CAAC,GAAG,IAAI,GAAG,EAAqB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,WAAW;QAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC;AACV,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,OAAO;IAQD;IAPD,KAAK,CAAyB;IAC9B,KAAK,GAAmB,IAAI,GAAG,EAAE,CAAC;IAC3C,UAAU,GAAyC,IAAI,CAAC;IAC/C,OAAO,CAAS;IACzB,MAAM,GAAG,KAAK,CAAC;IAEvB,YACkB,KAAY,EAC7B,UAAkB,gBAAgB;QADjB,UAAK,GAAL,KAAK,CAAO;QAG7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;IAEO,UAAU;QACjB,uEAAuE;QACvE,qEAAqE;QACrE,+DAA+D;QAC/D,IAAI,IAAI,GAAqC,EAAE,CAAC;QAChD,IAAI,CAAC;YACJ,IAAI,GAAG,IAAI,CAAC,KAAK;iBACf,OAAO,CAAC,sCAAsC,CAAC;iBAC/C,GAAG,EAAsC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAgB,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAgB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC,GAAc,EAAE,EAAE,GAAG,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CACb,GAAkD,EAClD,EAAE,GAAG,CAAC;QAEN,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;YACtB,KAAK,CAAC,IAAI,CACT;;;;eAIW,CACX,CAAC;YACF,KAAK;iBACH,OAAO,CACP;;;;2CAIsC,CACtC;iBACA,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,QAAQ;QACP,MAAM,GAAG,GAAG,EAA+B,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,WAAW;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,GAAG,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAc;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,QAAQ,GACb,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,YAAY;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACzB,MAAM,QAAQ,GACb,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC7C,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,eAAe;QACd,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC;YACpD,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC;YACpD,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,IAAI,CAAC;YAChE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,IAAI,CAAC;YAC1D,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,IAAI,CAAC;SAChE,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,gBAAgB;QACf,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,KAAK;QACJ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;YACtB,KAAK,CAAC,IAAI,CACT;;;;eAIW,CACX,CAAC;YACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAC3B;;;;2CAIuC,CACvC,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;IAEO,aAAa;QACpB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACd,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjB,kEAAkE;QAClE,MAAM,CAAC,GAAG,IAAI,CAAC,UAEd,CAAC;QACF,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACb,CAAC;IAEO,UAAU;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC9B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACxB,CAAC;IACF,CAAC;CACD"}

package/dist/plugin/replay-types.d.ts

@@ -0,0 +1,327 @@
+import { z } from "zod";
+/**
+ * v0.5.0 (K5-018 / plan §5.8) — replay transcript format.
+ *
+ * A hermetic, deterministic way to run a recorded session through the
+ * 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.
+ */
+export declare const replayEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"session.created">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    kind: "session.created";
+}, {
+    at: string;
+    sessionId: string;
+    kind: "session.created";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"chat.message">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    kind: "chat.message";
+    text: string;
+}, {
+    at: string;
+    sessionId: string;
+    kind: "chat.message";
+    text: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"tool.before">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+    callId: z.ZodString;
+    tool: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    tool: string;
+    kind: "tool.before";
+    callId: string;
+    args: Record<string, unknown>;
+}, {
+    at: string;
+    sessionId: string;
+    tool: string;
+    kind: "tool.before";
+    callId: string;
+    args: Record<string, unknown>;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"tool.after">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+    callId: z.ZodString;
+    success: z.ZodBoolean;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    success: boolean;
+    kind: "tool.after";
+    callId: string;
+    exitCode?: number | undefined;
+    stderr?: string | undefined;
+    stdout?: string | undefined;
+}, {
+    at: string;
+    sessionId: string;
+    success: boolean;
+    kind: "tool.after";
+    callId: string;
+    exitCode?: number | undefined;
+    stderr?: string | undefined;
+    stdout?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"system.transform">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    kind: "system.transform";
+}, {
+    at: string;
+    sessionId: string;
+    kind: "system.transform";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"compacting">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    kind: "compacting";
+}, {
+    at: string;
+    sessionId: string;
+    kind: "compacting";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"session.idle">;
+    at: z.ZodString;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    sessionId: string;
+    kind: "session.idle";
+}, {
+    at: string;
+    sessionId: string;
+    kind: "session.idle";
+}>]>;
+export type ReplayEvent = z.infer<typeof replayEventSchema>;
+export declare const replayTranscriptSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    name: z.ZodString;
+    events: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"session.created">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        kind: "session.created";
+    }, {
+        at: string;
+        sessionId: string;
+        kind: "session.created";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"chat.message">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        kind: "chat.message";
+        text: string;
+    }, {
+        at: string;
+        sessionId: string;
+        kind: "chat.message";
+        text: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"tool.before">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+        callId: z.ZodString;
+        tool: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        tool: string;
+        kind: "tool.before";
+        callId: string;
+        args: Record<string, unknown>;
+    }, {
+        at: string;
+        sessionId: string;
+        tool: string;
+        kind: "tool.before";
+        callId: string;
+        args: Record<string, unknown>;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"tool.after">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+        callId: z.ZodString;
+        success: z.ZodBoolean;
+        stdout: z.ZodOptional<z.ZodString>;
+        stderr: z.ZodOptional<z.ZodString>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        success: boolean;
+        kind: "tool.after";
+        callId: string;
+        exitCode?: number | undefined;
+        stderr?: string | undefined;
+        stdout?: string | undefined;
+    }, {
+        at: string;
+        sessionId: string;
+        success: boolean;
+        kind: "tool.after";
+        callId: string;
+        exitCode?: number | undefined;
+        stderr?: string | undefined;
+        stdout?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"system.transform">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        kind: "system.transform";
+    }, {
+        at: string;
+        sessionId: string;
+        kind: "system.transform";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"compacting">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        kind: "compacting";
+    }, {
+        at: string;
+        sessionId: string;
+        kind: "compacting";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"session.idle">;
+        at: z.ZodString;
+        sessionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        sessionId: string;
+        kind: "session.idle";
+    }, {
+        at: string;
+        sessionId: string;
+        kind: "session.idle";
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    name: string;
+    events: ({
+        at: string;
+        sessionId: string;
+        kind: "session.created";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "chat.message";
+        text: string;
+    } | {
+        at: string;
+        sessionId: string;
+        tool: string;
+        kind: "tool.before";
+        callId: string;
+        args: Record<string, unknown>;
+    } | {
+        at: string;
+        sessionId: string;
+        success: boolean;
+        kind: "tool.after";
+        callId: string;
+        exitCode?: number | undefined;
+        stderr?: string | undefined;
+        stdout?: string | undefined;
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "system.transform";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "compacting";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "session.idle";
+    })[];
+}, {
+    version: 1;
+    name: string;
+    events: ({
+        at: string;
+        sessionId: string;
+        kind: "session.created";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "chat.message";
+        text: string;
+    } | {
+        at: string;
+        sessionId: string;
+        tool: string;
+        kind: "tool.before";
+        callId: string;
+        args: Record<string, unknown>;
+    } | {
+        at: string;
+        sessionId: string;
+        success: boolean;
+        kind: "tool.after";
+        callId: string;
+        exitCode?: number | undefined;
+        stderr?: string | undefined;
+        stdout?: string | undefined;
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "system.transform";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "compacting";
+    } | {
+        at: string;
+        sessionId: string;
+        kind: "session.idle";
+    })[];
+}>;
+export interface ReplayTranscript {
+    readonly version: 1;
+    readonly name: string;
+    readonly events: readonly ReplayEvent[];
+}
+/** Validates an unknown payload (e.g. a parsed JSON file) as a transcript. */
+export declare function parseTranscript(json: unknown): ReplayTranscript;

package/dist/plugin/replay-types.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+/**
+ * v0.5.0 (K5-018 / plan §5.8) — replay transcript format.
+ *
+ * A hermetic, deterministic way to run a recorded session through the
+ * 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.
+ */
+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),
+});
+/** Validates an unknown payload (e.g. a parsed JSON file) as a transcript. */
+export function parseTranscript(json) {
+    return replayTranscriptSchema.parse(json);
+}
+//# sourceMappingURL=replay-types.js.map

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

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