@jigyasudham/veto 2.9.0 → 3.0.0

package/dist/transcripts/schema.d.ts

@@ -0,0 +1,69 @@
+export declare const TRANSCRIPTS_SCHEMA_VERSION = 3;
+export declare const EVENT_KINDS: readonly ["user_message", "assistant_message", "tool_call", "tool_result", "reasoning", "meta", "unknown"];
+export type EventKind = (typeof EVENT_KINDS)[number];
+export type Migration = {
+    version: number;
+    up: string;
+};
+export declare const MIGRATIONS: Migration[];
+export declare const SEARCHABLE_KINDS: EventKind[];
+export type ArchiveRow = {
+    id: string;
+    source: string;
+    source_session_id: string;
+    project_dir: string | null;
+    veto_session_id: string | null;
+    archive_path: string;
+    content_sha256: string;
+    source_bytes: number;
+    archive_bytes: number;
+    source_format_hint: string | null;
+    parser_version: number;
+    indexed_through_seq: number;
+    captured_at: string;
+    updated_at: string;
+};
+export type SessionMapRow = {
+    source: string;
+    source_session_id: string;
+    transcript_path: string;
+    project_dir: string | null;
+    last_seen_at: string;
+};
+export type SearchDocRow = {
+    id: number;
+    event_id: string;
+    archive_id: string;
+    source_session_id: string;
+    project_dir: string | null;
+    seq: number;
+    kind: EventKind;
+    len: number;
+};
+export type SearchPostingRow = {
+    term_id: number;
+    doc_id: number;
+    tf: number;
+};
+export type EventRow = {
+    id: string;
+    archive_id: string;
+    source_session_id: string;
+    seq: number;
+    line_index: number;
+    block_index: number;
+    kind: EventKind;
+    source_type: string | null;
+    role: string | null;
+    tool_name: string | null;
+    text: string | null;
+    secret_count: number;
+    event_uuid: string | null;
+    parent_uuid: string | null;
+    is_sidechain: number;
+    ts_source: string | null;
+    ts_utc: string | null;
+    raw_offset: number;
+    raw_length: number;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/transcripts/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/transcripts/schema.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAG5C,eAAO,MAAM,WAAW,4GAEd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,eAAO,MAAM,UAAU,EAAE,SAAS,EA+HjC,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,SAAS,EAAsE,CAAC;AAE/G,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/transcripts/schema.js

@@ -0,0 +1,146 @@
+// Sidecar transcripts.db — schema & additive migrations (VERSION-3 item 6, Step 2).
+//
+// A SEPARATE database file from veto.db. The HUD / veto-vscode read-contract
+// lives entirely in veto.db and is never touched by transcript capture — that
+// isolation is the whole point of the sidecar. Migrations are additive and
+// versioned via `PRAGMA user_version`: each later step APPENDS a migration
+// rather than editing an existing one, so the schema grows without churn and
+// re-open is idempotent.
+// Highest migration version defined below.
+export const TRANSCRIPTS_SCHEMA_VERSION = 3;
+// The common vocabulary every source normalizes into.
+export const EVENT_KINDS = [
+    'user_message', 'assistant_message', 'tool_call', 'tool_result', 'reasoning', 'meta', 'unknown',
+];
+export const MIGRATIONS = [
+    {
+        // v1 — the two foundational anchor tables. Events / segments / FTS get their
+        // own later migrations (Steps 6/9/10) so we don't big-bang the schema.
+        version: 1,
+        up: `
+      -- L0 archive index: one row per captured source-CLI session.
+      CREATE TABLE IF NOT EXISTS archives (
+        id                  TEXT PRIMARY KEY,
+        source              TEXT NOT NULL DEFAULT 'claude',   -- claude|codex|gemini
+        source_session_id   TEXT NOT NULL,
+        project_dir         TEXT,                              -- normalized (lowercase drive)
+        veto_session_id     TEXT,                              -- link to veto.db sessions.id when known
+        archive_path        TEXT NOT NULL,                     -- absolute path to the .gz on disk
+        content_sha256      TEXT NOT NULL,                     -- of raw source bytes (dedup key)
+        source_bytes        INTEGER NOT NULL DEFAULT 0,        -- uncompressed size
+        archive_bytes       INTEGER NOT NULL DEFAULT 0,        -- gz size on disk
+        source_format_hint  TEXT,                              -- e.g. 'claude-jsonl'
+        parser_version      INTEGER NOT NULL DEFAULT 0,
+        indexed_through_seq INTEGER NOT NULL DEFAULT 0,        -- lazy-index watermark
+        captured_at         TEXT NOT NULL,
+        updated_at          TEXT NOT NULL,
+        UNIQUE(source, source_session_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_archives_project ON archives(project_dir);
+      CREATE INDEX IF NOT EXISTS idx_archives_sha     ON archives(content_sha256);
+
+      -- Live host-session -> transcript-file mapping, UPSERTed fire-and-forget by
+      -- the statusline (Step 4) so save-time capture knows which file to read.
+      CREATE TABLE IF NOT EXISTS session_map (
+        source            TEXT NOT NULL DEFAULT 'claude',
+        source_session_id TEXT NOT NULL,
+        transcript_path   TEXT NOT NULL,
+        project_dir       TEXT,
+        last_seen_at      TEXT NOT NULL,
+        PRIMARY KEY (source, source_session_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_session_map_project ON session_map(project_dir);
+    `,
+    },
+    {
+        // v2 — normalized events, one row per conversational unit derived from L0.
+        // text is ALWAYS masked (Step 3). raw_offset/raw_length point into the
+        // UNCOMPRESSED L0 bytes for exact expansion (Step 11). Unknown/unparsed lines
+        // are stored+ordered (kind='unknown') so format drift never loses data.
+        version: 2,
+        up: `
+      CREATE TABLE IF NOT EXISTS events (
+        id                TEXT PRIMARY KEY,
+        archive_id        TEXT NOT NULL,
+        source_session_id TEXT NOT NULL,
+        seq               INTEGER NOT NULL,        -- monotonic per archive, per event
+        line_index        INTEGER NOT NULL,        -- source JSONL line (0-based)
+        block_index       INTEGER NOT NULL DEFAULT 0,
+        kind              TEXT NOT NULL,           -- EVENT_KINDS
+        source_type       TEXT,                    -- verbatim source 'type' (user/assistant/system/…)
+        role              TEXT,
+        tool_name         TEXT,                    -- for tool_call/tool_result
+        text              TEXT,                    -- normalized + MASKED content for FTS
+        secret_count      INTEGER NOT NULL DEFAULT 0,
+        event_uuid        TEXT,                    -- native uuid (Claude)
+        parent_uuid       TEXT,                    -- native parentUuid (tree)
+        is_sidechain      INTEGER NOT NULL DEFAULT 0,
+        ts_source         TEXT,                    -- verbatim timestamp string
+        ts_utc            TEXT,                    -- normalized ISO
+        raw_offset        INTEGER NOT NULL DEFAULT 0,
+        raw_length        INTEGER NOT NULL DEFAULT 0,
+        UNIQUE(archive_id, seq),
+        FOREIGN KEY (archive_id) REFERENCES archives(id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_events_archive ON events(archive_id, seq);
+      CREATE INDEX IF NOT EXISTS idx_events_session ON events(source_session_id);
+      CREATE INDEX IF NOT EXISTS idx_events_kind    ON events(kind);
+    `,
+    },
+    {
+        // v3 — portable lexical index: plain tables + JS scoring (B2, redone).
+        // The FTS5 version of this migration never shipped: PR #28 died on
+        // `no such module: fts5` because node:sqlite bundles SQLite with NODE's
+        // build flags, so ANY compile-time feature (FTS5, even math functions)
+        // is a version lottery. Rule: core SQL only. BM25 is scored in JS.
+        //
+        // Postings carry no positions — the query path ANDs independent terms and
+        // never phrase-matches, so positions are pure cost. Snippets are rebuilt
+        // in JS from events.text for the few returned rows. No stored df: purge /
+        // re-ingest would have to decrement it transactionally or IDF drifts;
+        // COUNT(*) on the postings PK answers it per query term instead.
+        //
+        // NOTE: never CREATE or DROP events_fts here — touching a virtual table
+        // loads its module, which throws on exactly the Nodes this redo supports.
+        // Databases that ran the old dev-only v3 keep an inert orphan table.
+        version: 3,
+        up: `
+      -- One row per indexed event. project_dir/session denormalized so the
+      -- hot query is a single join (same shape events_fts had). The INTEGER id
+      -- exists so postings never carry a 36-char uuid — measured, that uuid
+      -- (stored twice per posting: PK + purge index) was ~3x the entire
+      -- index's justified size.
+      CREATE TABLE IF NOT EXISTS search_docs (
+        id                INTEGER PRIMARY KEY,
+        event_id          TEXT NOT NULL UNIQUE,
+        archive_id        TEXT NOT NULL,
+        source_session_id TEXT NOT NULL,
+        project_dir       TEXT,
+        seq               INTEGER NOT NULL,
+        kind              TEXT NOT NULL,
+        len               INTEGER NOT NULL   -- token count, for BM25 length norm
+      );
+      CREATE INDEX IF NOT EXISTS idx_search_docs_archive ON search_docs(archive_id);
+      CREATE INDEX IF NOT EXISTS idx_search_docs_scope
+        ON search_docs(project_dir, source_session_id);
+
+      -- Term dictionary: term text stored once, compact integer join key.
+      CREATE TABLE IF NOT EXISTS search_terms (
+        id   INTEGER PRIMARY KEY,
+        term TEXT NOT NULL UNIQUE
+      );
+
+      CREATE TABLE IF NOT EXISTS search_postings (
+        term_id INTEGER NOT NULL,
+        doc_id  INTEGER NOT NULL,
+        tf      INTEGER NOT NULL,
+        PRIMARY KEY (term_id, doc_id)
+      ) WITHOUT ROWID;
+      CREATE INDEX IF NOT EXISTS idx_postings_doc ON search_postings(doc_id);
+    `,
+    },
+];
+// Event kinds worth indexing for recall — spine + tool digests. Reasoning
+// (verbose thinking) and meta/unknown are excluded.
+export const SEARCHABLE_KINDS = ['user_message', 'assistant_message', 'tool_call', 'tool_result'];
+//# sourceMappingURL=schema.js.map

package/dist/transcripts/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/transcripts/schema.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,2EAA2E;AAC3E,6EAA6E;AAC7E,yBAAyB;AAEzB,2CAA2C;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS;CACvF,CAAC;AAKX,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC;QACE,6EAA6E;QAC7E,uEAAuE;QACvE,OAAO,EAAE,CAAC;QACV,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCH;KACF;IACD;QACE,2EAA2E;QAC3E,uEAAuE;QACvE,8EAA8E;QAC9E,wEAAwE;QACxE,OAAO,EAAE,CAAC;QACV,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2BH;KACF;IACD;QACE,uEAAuE;QACvE,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,mEAAmE;QACnE,EAAE;QACF,0EAA0E;QAC1E,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,iEAAiE;QACjE,EAAE;QACF,wEAAwE;QACxE,0EAA0E;QAC1E,qEAAqE;QACrE,OAAO,EAAE,CAAC;QACV,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCH;KACF;CACF,CAAC;AAEF,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAgB,CAAC,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC"}

package/dist/transcripts/search.d.ts

@@ -0,0 +1,22 @@
+export type SearchHit = {
+    eventId: string;
+    archiveId: string;
+    sourceSessionId: string;
+    seq: number;
+    kind: string;
+    snippet: string;
+    score: number;
+};
+export type SearchOptions = {
+    projectDir?: string;
+    sourceSessionId?: string;
+    limit?: number;
+};
+/**
+ * Build a highlighted excerpt in JS — the moral equivalent of FTS5's
+ * snippet(…, '[', ']', '…', 12): the SNIPPET_TOKENS-token window containing
+ * the most matched terms, matches wrapped in [ ], ellipses when clipped.
+ */
+export declare function buildSnippet(text: string, terms: Set<string>): string;
+export declare function searchEvents(query: string, opts?: SearchOptions): SearchHit[];
+//# sourceMappingURL=search.d.ts.map

package/dist/transcripts/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/transcripts/search.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAiBF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAiCrE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,SAAS,EAAE,CAiEjF"}

package/dist/transcripts/search.js

@@ -0,0 +1,134 @@
+// Portable BM25 search over indexed events (VERSION-3 item 6, Step 10 — redone).
+//
+// Plain-SQLite inverted index (search_docs / search_terms / search_postings),
+// scored in JS. Core SQL only — no FTS5, no math functions, nothing behind a
+// compile-time flag; that is the lesson of PR #28 (`no such module: fts5`).
+// Query terms are bound parameters resolved against the term dictionary, so
+// there is no query language and no injection surface at all.
+//
+// Contract change vs the FTS5 version: score is positive, HIGHER is better
+// (FTS5's bm25() was negative-lower-is-better). Snippets are built in JS from
+// events.text for the returned rows only.
+import { getTranscriptsDb } from './store.js';
+import { normalizeProjectDir } from '../memory/local.js';
+import { tokenize } from './tokenize.js';
+const K1 = 1.2;
+const B = 0.75;
+// Terms present in more than half the corpus carry ~no signal but force
+// materializing huge posting lists (there is no LIMIT that is safe before
+// ranking). Dropped at the dictionary, before any postings are read — unless
+// every query term is that common, in which case they are all kept.
+const DF_CAP_RATIO = 0.5;
+const SNIPPET_TOKENS = 12;
+/** BM25, scored in JS because log() in SQL is a compile-time lottery. */
+function bm25(tf, df, n, len, avgdl) {
+    const idf = Math.log(1 + (n - df + 0.5) / (df + 0.5));
+    return idf * (tf * (K1 + 1)) / (tf + K1 * (1 - B + B * (avgdl > 0 ? len / avgdl : 1)));
+}
+/**
+ * Build a highlighted excerpt in JS — the moral equivalent of FTS5's
+ * snippet(…, '[', ']', '…', 12): the SNIPPET_TOKENS-token window containing
+ * the most matched terms, matches wrapped in [ ], ellipses when clipped.
+ */
+export function buildSnippet(text, terms) {
+    const re = /[\p{L}\p{N}_\-./@+]+/gu;
+    const tokens = [];
+    for (const m of text.matchAll(re)) {
+        const raw = m[0];
+        const matched = tokenize(raw).some(t => terms.has(t));
+        tokens.push({ start: m.index, end: m.index + raw.length, matched });
+    }
+    if (tokens.length === 0)
+        return text.slice(0, 120);
+    // Best SNIPPET_TOKENS-token window = most matches, earliest wins ties.
+    let best = 0;
+    let bestCount = -1;
+    for (let i = 0; i < tokens.length; i += 1) {
+        const windowEnd = Math.min(i + SNIPPET_TOKENS, tokens.length);
+        let count = 0;
+        for (let j = i; j < windowEnd; j += 1)
+            if (tokens[j].matched)
+                count += 1;
+        if (count > bestCount) {
+            bestCount = count;
+            best = i;
+        }
+        if (windowEnd === tokens.length)
+            break;
+    }
+    const windowEnd = Math.min(best + SNIPPET_TOKENS, tokens.length);
+    let out = '';
+    let pos = tokens[best].start;
+    for (let j = best; j < windowEnd; j += 1) {
+        const t = tokens[j];
+        out += text.slice(pos, t.start);
+        out += t.matched ? `[${text.slice(t.start, t.end)}]` : text.slice(t.start, t.end);
+        pos = t.end;
+    }
+    const prefix = tokens[best].start > 0 ? '…' : '';
+    const suffix = windowEnd < tokens.length || tokens[windowEnd - 1].end < text.length ? '…' : '';
+    return (prefix + out.replace(/\s+/g, ' ').trim() + suffix);
+}
+export function searchEvents(query, opts = {}) {
+    const db = getTranscriptsDb();
+    const terms = [...new Set(tokenize(query))];
+    if (terms.length === 0)
+        return [];
+    const stats = db.prepare(`SELECT COUNT(*) AS n, COALESCE(AVG(len), 0) AS avgdl FROM search_docs`).get();
+    if (stats.n === 0)
+        return [];
+    // Resolve terms against the dictionary in one round trip.
+    const marks = terms.map(() => '?').join(', ');
+    const found = db.prepare(`SELECT id, term FROM search_terms WHERE term IN (${marks})`).all(...terms);
+    if (found.length === 0)
+        return [];
+    // df per term — an index-only range count on the postings PK.
+    const dfStmt = db.prepare(`SELECT COUNT(*) AS n FROM search_postings WHERE term_id = ?`);
+    const withDf = found.map(t => ({ ...t, df: dfStmt.get(t.id).n }));
+    let kept = withDf.filter(t => t.df / stats.n <= DF_CAP_RATIO);
+    if (kept.length === 0)
+        kept = withDf; // every term is that common — keep them all
+    const where = [`p.term_id IN (${kept.map(() => '?').join(', ')})`];
+    const params = kept.map(t => t.id);
+    if (opts.projectDir) {
+        where.push('d.project_dir = ?');
+        params.push(normalizeProjectDir(opts.projectDir));
+    }
+    if (opts.sourceSessionId) {
+        where.push('d.source_session_id = ?');
+        params.push(opts.sourceSessionId);
+    }
+    const rows = db.prepare(`SELECT p.term_id, p.tf, d.event_id, d.archive_id, d.source_session_id, d.project_dir, d.seq, d.kind, d.len
+       FROM search_postings p JOIN search_docs d ON d.id = p.doc_id
+      WHERE ${where.join(' AND ')}`).all(...params);
+    if (rows.length === 0)
+        return [];
+    const dfById = new Map(kept.map(t => [t.id, t.df]));
+    const acc = new Map();
+    for (const r of rows) {
+        const df = dfById.get(r.term_id) ?? 1;
+        const prev = acc.get(r.event_id);
+        const inc = bm25(r.tf, df, stats.n, r.len, stats.avgdl);
+        if (prev)
+            prev.score += inc;
+        else
+            acc.set(r.event_id, { doc: r, score: inc });
+    }
+    const limit = Math.min(Math.max(opts.limit ?? 10, 1), 50);
+    const top = [...acc.values()].sort((a, b) => b.score - a.score).slice(0, limit);
+    // Snippets: fetch text for the returned rows only.
+    const ids = top.map(t => t.doc.event_id);
+    const textRows = db.prepare(`SELECT id, text FROM events WHERE id IN (${ids.map(() => '?').join(', ')})`).all(...ids);
+    const textById = new Map(textRows.map(r => [r.id, r.text ?? '']));
+    const termSet = new Set(kept.map(t => t.term));
+    return top.map(({ doc, score }) => ({
+        eventId: doc.event_id,
+        archiveId: doc.archive_id,
+        sourceSessionId: doc.source_session_id,
+        seq: doc.seq,
+        kind: doc.kind,
+        snippet: buildSnippet(textById.get(doc.event_id) ?? '', termSet),
+        score,
+    }));
+}
+//# sourceMappingURL=search.js.map

package/dist/transcripts/search.js.map

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

package/dist/transcripts/store.d.ts

@@ -0,0 +1,21 @@
+import type { DatabaseSync } from 'node:sqlite';
+import { TRANSCRIPTS_SCHEMA_VERSION } from './schema.js';
+/** True when node:sqlite can be loaded — capture is silently unavailable otherwise. */
+export declare function transcriptsAvailable(): boolean;
+/** Root dir for all transcript data (archives + sidecar DB). Env override for tests. */
+export declare function transcriptsRoot(): string;
+/** Path to the sidecar index DB. Env override for tests (mirrors VETO_TEST_DB). */
+export declare function transcriptsDbPath(): string;
+/** Dir holding the L0 .gz archive files (populated in Step 5). */
+export declare function archiveDir(): string;
+export declare function resetTranscriptsDb(): void;
+export declare function getTranscriptsDb(): DatabaseSync;
+/**
+ * Apply every migration newer than the DB's current user_version, each in its
+ * own transaction. Idempotent: re-running is a no-op once caught up. Returns the
+ * resulting schema version.
+ */
+export declare function runMigrations(db: DatabaseSync): number;
+export declare function schemaVersion(db?: DatabaseSync): number;
+export { TRANSCRIPTS_SCHEMA_VERSION };
+//# sourceMappingURL=store.d.ts.map

package/dist/transcripts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/transcripts/store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,EAAc,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAYrE,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wFAAwF;AACxF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAc/C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAiBtD;AAOD,wBAAgB,aAAa,CAAC,EAAE,GAAE,YAAiC,GAAG,MAAM,CAE3E;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/transcripts/store.js

@@ -0,0 +1,105 @@
+// Sidecar transcripts.db connection + additive migration runner
+// (VERSION-3 item 6, Step 2).
+//
+// Opened lazily (node:sqlite is a Node 22.5+ built-in; loaded via createRequire
+// so bundlers skip it and older runtimes degrade gracefully). WAL + busy_timeout
+// let the HUD keep reading veto.db while capture writes here without lock
+// contention. This module NEVER opens veto.db — the two DBs stay isolated.
+import { createRequire } from 'node:module';
+import { join, dirname } from 'node:path';
+import { mkdirSync } from 'node:fs';
+import { effectiveTranscriptsDir } from './config.js';
+import { MIGRATIONS, TRANSCRIPTS_SCHEMA_VERSION } from './schema.js';
+const _require = createRequire(import.meta.url);
+let _DbSync = null;
+function requireDbSync() {
+    if (!_DbSync) {
+        _DbSync = _require('node:sqlite').DatabaseSync;
+    }
+    return _DbSync;
+}
+/** True when node:sqlite can be loaded — capture is silently unavailable otherwise. */
+export function transcriptsAvailable() {
+    try {
+        requireDbSync();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Root dir for all transcript data (archives + sidecar DB). Env override for tests. */
+export function transcriptsRoot() {
+    return process.env.VETO_TRANSCRIPTS_DIR ?? effectiveTranscriptsDir();
+}
+/** Path to the sidecar index DB. Env override for tests (mirrors VETO_TEST_DB). */
+export function transcriptsDbPath() {
+    return process.env.VETO_TRANSCRIPTS_DB ?? join(transcriptsRoot(), 'index.db');
+}
+/** Dir holding the L0 .gz archive files (populated in Step 5). */
+export function archiveDir() {
+    return join(transcriptsRoot(), 'archives');
+}
+let _db = null;
+let _openedPath = null;
+export function resetTranscriptsDb() {
+    if (_db) {
+        try {
+            _db.close();
+        }
+        catch { /* ignore */ }
+        _db = null;
+        _openedPath = null;
+    }
+}
+export function getTranscriptsDb() {
+    const path = transcriptsDbPath();
+    if (_db && _openedPath === path)
+        return _db;
+    if (_db)
+        resetTranscriptsDb();
+    const DbSync = requireDbSync();
+    if (path !== ':memory:')
+        mkdirSync(dirname(path), { recursive: true });
+    const db = new DbSync(path);
+    db.exec('PRAGMA journal_mode = WAL');
+    db.exec('PRAGMA busy_timeout = 5000');
+    db.exec('PRAGMA foreign_keys = ON');
+    runMigrations(db);
+    _db = db;
+    _openedPath = path;
+    return db;
+}
+/**
+ * Apply every migration newer than the DB's current user_version, each in its
+ * own transaction. Idempotent: re-running is a no-op once caught up. Returns the
+ * resulting schema version.
+ */
+export function runMigrations(db) {
+    let applied = readUserVersion(db);
+    for (const m of MIGRATIONS) {
+        if (m.version > applied) {
+            db.exec('BEGIN');
+            try {
+                db.exec(m.up);
+                db.exec(`PRAGMA user_version = ${m.version}`);
+                db.exec('COMMIT');
+                applied = m.version;
+            }
+            catch (e) {
+                db.exec('ROLLBACK');
+                throw e;
+            }
+        }
+    }
+    return applied;
+}
+function readUserVersion(db) {
+    const row = db.prepare('PRAGMA user_version').get();
+    return row?.user_version ?? 0;
+}
+export function schemaVersion(db = getTranscriptsDb()) {
+    return readUserVersion(db);
+}
+export { TRANSCRIPTS_SCHEMA_VERSION };
+//# sourceMappingURL=store.js.map

package/dist/transcripts/store.js.map

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

package/dist/transcripts/toc.d.ts

@@ -0,0 +1,18 @@
+export type Segment = {
+    index: number;
+    fromSeq: number;
+    toSeq: number;
+    firstTs: string | null;
+    lastTs: string | null;
+    title: string;
+    userMessages: number;
+    assistantMessages: number;
+    toolCalls: number;
+    files: string[];
+    tools: string[];
+    hasError: boolean;
+};
+export declare function buildTOC(archiveId: string): Segment[];
+/** Compact one-line-per-segment rendering for the recall tool's first response. */
+export declare function renderTOC(segments: Segment[]): string;
+//# sourceMappingURL=toc.d.ts.map

package/dist/transcripts/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/transcripts/toc.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AASF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAkDrD;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAQrD"}

package/dist/transcripts/toc.js

@@ -0,0 +1,96 @@
+// Metadata table-of-contents / phase segmentation (VERSION-3 item 6, Step 9).
+//
+// B1 of the vectorless-retrieval pipeline: split a session into phases so the
+// recall tool can hand the host AI a compact map to navigate BEFORE any text
+// search. Boundaries are deterministic — a new segment begins at each real user
+// message (a user prompt + the assistant's response + tool activity until the
+// next prompt). Events before the first user prompt form a preamble segment.
+// Computed on demand from the events table (no extra storage).
+import { getTranscriptsDb } from './store.js';
+import { EDIT_TOOLS, FILE_RE, ERROR_RE } from './pyramid.js';
+const TITLE_MAX = 80;
+function preview(text) {
+    const t = text.replace(/\s+/g, ' ').trim();
+    return t.length > TITLE_MAX ? t.slice(0, TITLE_MAX - 1) + '…' : t;
+}
+export function buildTOC(archiveId) {
+    const db = getTranscriptsDb();
+    const rows = db.prepare(`SELECT seq, kind, tool_name, text, ts_utc FROM events WHERE archive_id = ? ORDER BY seq`).all(archiveId);
+    if (rows.length === 0)
+        return [];
+    const segments = [];
+    let cur = null;
+    const open = (first, title) => {
+        cur = {
+            index: segments.length, fromSeq: first.seq, toSeq: first.seq,
+            firstTs: first.ts_utc, lastTs: first.ts_utc, title,
+            userMessages: 0, assistantMessages: 0, toolCalls: 0, files: [], tools: [], hasError: false,
+            _files: new Set(), _tools: new Set(),
+        };
+        segments.push(cur);
+    };
+    const close = () => {
+        if (cur) {
+            cur.files = [...cur._files];
+            cur.tools = [...cur._tools];
+        }
+    };
+    for (const r of rows) {
+        if (r.kind === 'user_message') {
+            close();
+            open(r, preview(r.text ?? '') || `segment ${segments.length + 1}`);
+        }
+        else if (!cur) {
+            // Preamble: events before the first user message.
+            open(r, '(session start)');
+        }
+        const c = cur;
+        c.toSeq = r.seq;
+        if (r.ts_utc) {
+            if (!c.firstTs || r.ts_utc < c.firstTs)
+                c.firstTs = r.ts_utc;
+            if (!c.lastTs || r.ts_utc > c.lastTs)
+                c.lastTs = r.ts_utc;
+        }
+        switch (r.kind) {
+            case 'user_message':
+                c.userMessages++;
+                break;
+            case 'assistant_message':
+                c.assistantMessages++;
+                break;
+            case 'tool_call': {
+                c.toolCalls++;
+                const name = r.tool_name ?? 'tool';
+                c._tools.add(name);
+                if (r.text && EDIT_TOOLS.has(name)) {
+                    const m = r.text.match(FILE_RE);
+                    if (m)
+                        c._files.add(m[1]);
+                }
+                break;
+            }
+            case 'tool_result':
+                if (r.text && ERROR_RE.test(r.text))
+                    c.hasError = true;
+                break;
+            default: break;
+        }
+    }
+    close();
+    return segments;
+}
+/** Compact one-line-per-segment rendering for the recall tool's first response. */
+export function renderTOC(segments) {
+    return segments.map(s => {
+        const bits = [`#${s.index} [${s.fromSeq}-${s.toSeq}]`];
+        if (s.hasError)
+            bits.push('⚠err');
+        if (s.files.length)
+            bits.push(`files:${s.files.slice(0, 4).join(',')}`);
+        if (s.tools.length)
+            bits.push(`tools:${s.tools.slice(0, 4).join(',')}`);
+        return `${bits.join(' ')}  ${s.title}`;
+    }).join('\n');
+}
+//# sourceMappingURL=toc.js.map