@threadbase-sh/streamer 1.63.0 → 1.65.0

package/dist/codex-pty-runner.d.ts

@@ -0,0 +1,90 @@
+import type { ManagedSession, PTYManagerOptions, SessionRunner, StartForkSessionOptions, StartFreshSessionOptions, StartSessionOptions, UserMessage } from "./types";
+export declare class CodexPtyRunner implements SessionRunner {
+    private sessions;
+    private onOutput;
+    private onStatusChange;
+    private onPhaseChange;
+    private onReady;
+    private onPermissionChange;
+    private onUserMessage;
+    private log;
+    private pendingReady;
+    private queuedInputs;
+    private openGate;
+    private gateActioned;
+    private quietCheckers;
+    private readyFallbackTimers;
+    private submitWatchTimers;
+    private lastChunkAt;
+    private turnBusy;
+    private openBlockingPrompt;
+    private openCommandApproval;
+    private lastScreenLog;
+    private startPromises;
+    constructor(options?: PTYManagerOptions);
+    start(sessionId: string, options: StartSessionOptions): Promise<ManagedSession>;
+    private doStart;
+    private launch;
+    startFresh(options: StartFreshSessionOptions): Promise<ManagedSession>;
+    /**
+     * Fork an existing Codex conversation into a new, independently-owned one
+     * (`codex fork <session-id>`).
+     *
+     * This is the recovery path for a rollout Codex will not let us resume: fork
+     * starts a *new* rollout seeded from the source's history and never touches
+     * the source's writer, so the terminal / VS Code / desktop client that owns
+     * it keeps running untouched. Like a fresh start, Codex assigns the new
+     * rollout id itself — the returned session is keyed by a local placeholder
+     * until watchForCodexRollout binds the real id.
+     */
+    startFork(options: StartForkSessionOptions): Promise<ManagedSession>;
+    private armReadyFallback;
+    private tryReadyFallback;
+    sendKeys(sessionId: string, keys: string): void;
+    private resolveGateAnswer;
+    sendInput(sessionId: string, input: string): number;
+    private writeSubmit;
+    private armSubmitWatch;
+    private trySubmitStaleRecovery;
+    private flushQueuedInputs;
+    cancel(sessionId: string): void;
+    killPid(pid: number): void;
+    putOnHold(sessionId: string): void;
+    private clearSessionDetectors;
+    getOutput(sessionId: string): string;
+    getOutputLines(sessionId: string, maxLines: number): Promise<string[]>;
+    getInputHistory(sessionId: string): UserMessage[];
+    getPid(sessionId: string): number | null;
+    private recordUserMessage;
+    getSession(sessionId: string): ManagedSession | null;
+    hasSession(sessionId: string): boolean;
+    listSessions(): ManagedSession[];
+    dispose(): void;
+    private handleOutput;
+    private detectScreenState;
+    private handleBlockingPrompt;
+    private handleCommandApproval;
+    private handleGate;
+    /**
+     * Record the agent's phase and notify only on a real change. The guard is
+     * load-bearing, not an optimisation: detectScreenState runs on every chunk,
+     * so an unguarded setter would fire the WS frame behind this several times a
+     * second for a whole turn while reporting the same value. Same contract as
+     * PTYManager.setPhase — the two runners deliberately stay separate classes.
+     */
+    private setPhase;
+    private markReady;
+    /**
+     * Tear down a session that failed before it ever became usable, and report
+     * the reason in machine-readable form.
+     *
+     * Deliberately NOT markReady + exit: the caller must be able to tell a
+     * never-started session from a live one, `onReady` must not fire (no
+     * `session_ready` for a failed start), and every piece of per-session state —
+     * queue, timers, quiet-checker, gate cards, screen — has to go, since the
+     * session is removed from the map and nothing will collect it later.
+     */
+    private failStartup;
+    private handleExit;
+}
+//# sourceMappingURL=codex-pty-runner.d.ts.map

package/dist/codex-pty-runner.d.ts.map

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

package/dist/config/update-config.d.ts

@@ -0,0 +1,13 @@
+import { type UpdateConfig } from "../schemas/updateConfig.schema";
+declare const DEFAULT_CONFIG_PATH: string;
+export interface LoadUpdateConfigOptions {
+    path?: string;
+}
+/**
+ * Loads ~/.threadbase/update.yaml. Returns null when the file does not exist
+ * (auto-update disabled). Throws on malformed YAML or schema-invalid content
+ * so misconfiguration is loud rather than silently disabling updates.
+ */
+export declare function loadUpdateConfig(opts?: LoadUpdateConfigOptions): UpdateConfig | null;
+export { DEFAULT_CONFIG_PATH as UPDATE_CONFIG_PATH };
+//# sourceMappingURL=update-config.d.ts.map

package/dist/config/update-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-config.d.ts","sourceRoot":"","sources":["../../src/config/update-config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,gCAAgC,CAAC;AAEvF,QAAA,MAAM,mBAAmB,QAAgD,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,YAAY,GAAG,IAAI,CAiBxF;AAED,OAAO,EAAE,mBAAmB,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/conversation-cache.d.ts

@@ -0,0 +1,336 @@
+import { type ConversationMessage, type ConversationMeta, type FileStatEntry } from "@threadbase-sh/scanner";
+import Database from "better-sqlite3";
+import { type Stats } from "fs";
+import { type LineSpan } from "./utils/fileIdentity";
+export interface ConversationCacheOptions {
+    filterAgentConversations?: boolean;
+    agentEntrypoints?: ReadonlySet<string>;
+    onAgentFileDetected?: (filePath: string) => void;
+}
+export interface ConversationListItem {
+    id: string;
+    filePath: string;
+    projectId: string | null;
+    projectPath: string | null;
+    projectName: string | null;
+    title: string | null;
+    model: string | null;
+    account: string | null;
+    branch: string | null;
+    messageCount: number;
+    lastActivity: string;
+    firstMessage: string | null;
+    lastMessage: string | null;
+    preview: string | null;
+    source: string | null;
+    provider: "claude-code" | "codex-cli";
+}
+export interface CachedTailMessage {
+    role: string;
+    timestamp: string;
+    text: string;
+    content?: unknown[];
+}
+export interface CachedTail {
+    conversationId: string;
+    messages: CachedTailMessage[];
+    tailSize: number;
+}
+/** A row of `conversation_file_state` — per-file offset-index resume state. */
+export interface FileStateRow {
+    path: string;
+    identity: string;
+    size: number;
+    mtime_ms: number;
+    byte_offset: number;
+    last_message_index: number;
+}
+/** A row of `conversation_message_index` — one indexed message's byte span. */
+export interface MessageIndexRow {
+    conversation_id: string;
+    message_index: number;
+    byte_offset: number;
+    byte_length: number;
+    uuid: string | null;
+    role: string | null;
+    ts: number | null;
+}
+export interface ScannerMeta {
+    id: string;
+    sessionId?: string;
+    filePath: string;
+    projectPath?: string;
+    projectName?: string;
+    title?: string;
+    sessionName?: string;
+    model?: string;
+    account?: string;
+    gitBranch?: string;
+    messageCount?: number;
+    timestamp?: string;
+    firstMessage?: unknown;
+    lastMessage?: unknown;
+    preview?: string;
+    provider?: "claude-code" | "codex-cli";
+}
+export declare class ConversationCache {
+    private db;
+    private tailSize;
+    private fileIndex;
+    private fileIndexLoaded;
+    private indexParseState;
+    private backfillInFlight;
+    private tailSeq;
+    private nameSeq;
+    private stmts;
+    private migrationsDir?;
+    private filterAgentConversations;
+    private agentEntrypoints;
+    private onAgentFileDetected?;
+    private constructor();
+    /**
+     * Expose the underlying handle so projects/cache_metadata repositories can
+     * share the same connection. Internal API; not part of the public surface.
+     */
+    getDatabase(): Database.Database;
+    getFileState(path: string): FileStateRow | null;
+    upsertFileState(row: FileStateRow): void;
+    /** Drop a file's index rows + file_state (truncation / identity change). */
+    deleteFileIndex(path: string, conversationId: string): void;
+    /** Append/replace index rows in one transaction. */
+    appendMessageIndexRows(rows: MessageIndexRow[]): void;
+    /** Rows for message_index in [fromIndex, toIndex), ordered ascending. */
+    getMessageIndexWindow(conversationId: string, fromIndex: number, toIndex: number): MessageIndexRow[];
+    getIndexedMessageCount(conversationId: string): number;
+    /**
+     * Conversation id for a JSONL path — the filename stem (matches the pseudo-id
+     * updateFromLine derives and the uuid the detail read path resolves). The
+     * offset index keys on this so the window select and the cursor agree.
+     */
+    static conversationIdForFile(filePath: string): string;
+    private isIndexableFile;
+    /**
+     * Incremental offset-index writer: extend the index for a burst of appended
+     * lines (one watcher read) using their byte spans. Each line is classified
+     * with the scanner's parseJsonlLine (a running per-file reducer state), so the
+     * message ordering can never drift from the scanner's. Message lines get an
+     * index row at the next message_index; non-message lines (summary/sidecar)
+     * get no row but still advance byte_offset. file_state is updated to the end
+     * of the last consumed span.
+     *
+     * Requires an up-to-date `stat` (identity/size/mtime) for the file so the read
+     * path can detect truncation/replacement.
+     *
+     * `readFrom` is the absolute byte offset the watcher read started at, and
+     * `endOffset` is where it ended (readFrom + consumed, i.e. the watcher's new
+     * entry.offset). CONTIGUITY GUARD: the read must begin exactly where the index
+     * left off (`readFrom === existing.byte_offset`, or 0 with no state). If it
+     * doesn't — the watcher attached at EOF after the server was down, or an
+     * append raced an in-flight backfill — extending would assign wrong
+     * message_index values over a hole. In that case this writes nothing and
+     * returns null so the caller drops the index and backfills.
+     *
+     * On success returns the message_index assigned to each input span (null for a
+     * non-message line) so the caller can stamp WS `seq`. Empty array when spans
+     * is empty. `endOffset` is stored verbatim as byte_offset so the watcher's
+     * offset and file_state.byte_offset are the same number by construction.
+     */
+    extendMessageIndex(filePath: string, spans: LineSpan[], stat: Stats, readFrom: number, endOffset: number): (number | null)[] | null;
+    clearIndexParseState(filePath: string): void;
+    /**
+     * On-demand full backfill of the offset index for a file with no/stale
+     * file_state (cold conversation, or after a truncation/replacement). Rebuilds
+     * from byte 0: drops any existing rows, walks the whole file in chunks with a
+     * running parse state, yields to the event loop every ~1000 lines so a large
+     * file never blocks, and writes index rows + file_state.
+     *
+     * Single-flighted per path: concurrent callers await the same walk. The
+     * triggering detail request is served by the scanner fallback while this runs.
+     */
+    backfillIndex(filePath: string): Promise<void>;
+    private runBackfill;
+    /**
+     * Windowed detail read straight from the offset index — the hot path.
+     * Returns the parsed messages for message_index in [fromIndex, toIndex) plus
+     * the total indexed count, or null when the index can't serve this file (no
+     * file_state, identity/size mismatch = truncation/replacement, or cold index)
+     * so the caller falls back to the scanner and enqueues a backfill.
+     *
+     * On a match it SQL-selects the window's byte ranges and preads exactly those
+     * ranges from the JSONL (never the whole file), parsing only the sliced lines.
+     * Returns messages in the same ConversationMessage shape parseJsonlLine
+     * produces during a scan, so the payload is identical to the scanner path.
+     */
+    readMessageWindow(filePath: string, fromIndex: number, toIndex: number): {
+        messages: ConversationMessage[];
+        total: number;
+        fromIndex: number;
+    } | null;
+    private agentEntrypointsKey;
+    private classifyAgentFile;
+    isAgentFileCached(filePath: string): boolean;
+    static open(dbPath: string, tailSize?: number, migrationsDir?: string, options?: ConversationCacheOptions): ConversationCache;
+    close(): void;
+    getPopularProjects(limit: number): Array<{
+        path: string;
+        name: string;
+        sessionCount: number;
+    }>;
+    /** Every project with at least one cached conversation, most recently active
+     *  first. Paths are the raw `project_path` values, which is what
+     *  /api/conversations?project= matches on exactly — so a summary row is
+     *  always joinable against the page it describes. */
+    listProjectSummaries(opts: {
+        limit: number;
+        offset: number;
+    }): {
+        projects: Array<{
+            path: string;
+            name: string;
+            conversationCount: number;
+            lastActivity: string;
+        }>;
+        total: number;
+    };
+    private ensureFileIndex;
+    updateFromLine(filePath: string, rawLine: string): void;
+    /**
+     * Batched form of updateFromLine: applies a burst of newly-appended lines
+     * (one chokidar read) in a single transaction with one message_count bump,
+     * one meta write, and one tail read/write — instead of 2-4 synchronous
+     * writes per line. Semantics are identical to replaying each line through
+     * updateFromLine in order: the agent filter short-circuits the whole batch,
+     * project context is backfilled last-wins, message_count increases by the
+     * number of surviving message lines, and last_activity/last_message reflect
+     * the newest message line by timestamp (a monotonic guard keeps them from
+     * moving backward when an interleaved writer appends an older line — P0.3).
+     */
+    updateFromLines(filePath: string, rawLines: string[]): void;
+    upsertFromScannerMeta(metas: ScannerMeta[]): string[];
+    deleteByFilePath(filePath: string): boolean;
+    populateTailFromFile(convId: string, filePath: string): boolean;
+    listConversations(opts: {
+        project?: string;
+        provider?: string;
+        limit: number;
+        offset: number;
+    }): {
+        conversations: ConversationListItem[];
+        total: number;
+    };
+    /** Returns a map of filePath → { mtimeMs, size } for all rows that have
+     *  stat data stored. Used by the server to build the statCache passed to
+     *  ConversationScanner.scan() so unchanged files are skipped. */
+    getFileStats(): Map<string, {
+        mtimeMs: number;
+        size: number;
+    }>;
+    getScannerStatCache(): Map<string, {
+        stat: FileStatEntry;
+        meta: ConversationMeta;
+    }>;
+    /**
+     * Conversation id for a JSONL path, or null when no row exists yet. Resolves
+     * by file_path (NOT conversationIdForFile) so codex rollout files — named
+     * rollout-<ts>-<uuid>.jsonl, whose stem is not the row id — resolve correctly.
+     */
+    getIdByFilePath(filePath: string): string | null;
+    getMetaById(id: string): ConversationListItem | null;
+    setConversationProjectId(conversationId: string, projectId: string): void;
+    markAsStreamer(id: string): void;
+    getLatestConversation(): {
+        id: string;
+        lastActivity: string | null;
+    } | null;
+    hasOrphanProjectId(): boolean;
+    listConversationsForProjectBackfill(): Array<{
+        id: string;
+        projectPath: string | null;
+        projectId: string | null;
+        lastActivity: string | null;
+    }>;
+    getConversationTail(id: string): CachedTail | null;
+    hasConversation(id: string): boolean;
+    upsertSessionName(sessionId: string, name: string): void;
+    getSessionName(sessionId: string): string | null;
+    listSessionNames(): Record<string, string>;
+    invalidate(id?: string): void;
+    /**
+     * Drop the cached row for a file. Two callers with opposite intent:
+     *  - a directory-watch "change" event (the file was appended to) — pass
+     *    `skipIfTailed: true`, which NEVER deletes (upsert-or-leave). A change
+     *    event fires on every external append; deleting here flickers the
+     *    conversation out of /api/conversations — whether it's a live-tailed row
+     *    the updateFromLines/warm-up path just wrote (CRITICAL #2; both watchers
+     *    fire on the same append with no ordering guarantee) OR a refresh-created
+     *    untailed row (a ?refresh=1 upsert never populates a tail, so the old
+     *    "delete when untailed" behavior made it vanish on its next append with no
+     *    client action). The live-tail path owns the row's content and the
+     *    debounced rescan re-derives metadata, so leaving the row loses nothing.
+     *  - a genuine unlink (the file is gone) — leave `skipIfTailed` false so the
+     *    row is always removed, otherwise a deleted session ghosts in the cache.
+     */
+    invalidateByFilePath(filePath: string, opts?: {
+        skipIfTailed?: boolean;
+    }): string | null;
+    /**
+     * Drop rows whose `file_path` no longer exists on disk AND which have no
+     * cached tail to fall back to. Rows with a tail are left alone so
+     * `handleGetConversation` can still serve the cached tail even when the
+     * JSONL has been deleted.
+     */
+    pruneGhostFiles(exists?: (filePath: string) => boolean): string[];
+    /**
+     * Reconcile the cache against the authoritative set of conversation file
+     * paths a fresh scan surfaced: drop any cached row whose `file_path` is not
+     * in `livePaths` (removed from disk, or now filtered out — e.g. became an
+     * agent JSONL). This is the "removed conversations" half of a ?refresh=1
+     * reconcile; the additions/updates half is upsertFromScannerMeta.
+     *
+     * Skip semantics depend on whether the file still exists on disk:
+     *  - File GONE from disk → always removed, tail or not. This matches the old
+     *    invalidate()+rebuild behavior (a deleted conversation must disappear on
+     *    refresh) and keeps refresh=1 truthful about removals. NOTE: this is an
+     *    INTENTIONAL divergence from pruneGhostFiles(), which KEEPS tailed ghosts
+     *    so their cached history stays viewable on a background prune. refresh=1
+     *    has the opposite contract (mobile relies on removals being reflected), so
+     *    do not "unify" the two — they serve different purposes.
+     *  - File STILL on disk but absent from `livePaths` → the CRITICAL #2 race:
+     *    the scan snapshot predates a just-created (and now live-tailed) file.
+     *    A tailed row here is actively maintained from real content, so it is
+     *    kept — dropping it would flicker the active conversation out of
+     *    /api/conversations. An untailed on-disk row not in the snapshot is a
+     *    transient scan/discovery gap; it is left alone (not removed) and the
+     *    next reconcile picks it up, rather than risk removing a real file the
+     *    scan simply hasn't surfaced yet.
+     * Returns the removed IDs.
+     */
+    reconcileDeletions(livePaths: Set<string>, opts?: {
+        exists?: (filePath: string) => boolean;
+    }): string[];
+    /**
+     * Read-only: list cached rows whose `file_path` no longer exists on disk.
+     * Unlike pruneGhostFiles/reconcileDeletions this mutates nothing — it just
+     * reports drift for the CacheIntegrityMonitor to classify. `tailed` flags
+     * rows that still have cached history (which pruneGhostFiles would keep).
+     */
+    listMissingFiles(exists?: (filePath: string) => boolean): {
+        id: string;
+        filePath: string;
+        title: string | null;
+        tailed: boolean;
+    }[];
+    /**
+     * Drop the given conversation ids outright — main row, tail, and message
+     * index — regardless of whether they have a tail. Used by the cache-integrity
+     * resolution actions (prune_all / prune_selected). Returns the count dropped.
+     */
+    dropRowsById(ids: string[]): number;
+    /**
+     * Wipe all cached conversation state — meta, tails, and message index — and
+     * reset the in-memory file index. Only called by the `reset_rescan`
+     * resolution action, which repopulates from a fresh disk scan afterward.
+     */
+    clearAll(): void;
+}
+//# sourceMappingURL=conversation-cache.d.ts.map

package/dist/conversation-cache.d.ts.map

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

package/dist/db/config.d.ts

@@ -0,0 +1,11 @@
+export interface DbConfig {
+    connectionString: string;
+    max: number;
+    ssl?: string;
+    statementTimeout?: number;
+    instanceId: string;
+}
+export declare function isDbEnabled(): boolean;
+export declare function getInstanceId(): string;
+export declare function getDbConfig(): DbConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/db/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/db/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,WAAW,IAAI,OAAO,CAGrC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,WAAW,IAAI,QAAQ,GAAG,IAAI,CAkB7C"}

package/dist/db/index.d.ts

@@ -0,0 +1,5 @@
+export type { DbConfig } from "./config";
+export { getDbConfig, isDbEnabled } from "./config";
+export { runMigrations } from "./migrations";
+export { createPool, maskConnectionString } from "./pool";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/db/migrations.d.ts

@@ -0,0 +1,3 @@
+import type pg from "pg";
+export declare function runMigrations(pool: pg.Pool, migrationsDir?: string): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/db/migrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAYzB,wBAAsB,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BxF"}

package/dist/db/pool.d.ts

@@ -0,0 +1,5 @@
+import type { Pool as PoolType } from "pg";
+import type { DbConfig } from "./config";
+export declare function maskConnectionString(url: string): string;
+export declare function createPool(config: DbConfig): Promise<PoolType>;
+//# sourceMappingURL=pool.d.ts.map

package/dist/db/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/db/pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBpE"}

package/dist/db/query-timing.d.ts

@@ -0,0 +1,52 @@
+import type Database from "better-sqlite3";
+/**
+ * Slow-query threshold, in milliseconds.
+ *
+ * Measured, not guessed. Against the live 22 MB `cache.db` on this machine
+ * (583 conversations, 38 717 index rows, warm page cache), 3 600 read samples
+ * across the twelve statements the hot paths actually run gave p50 0.03 ms,
+ * p99 0.87 ms, p99.9 1.43 ms, max 1.83 ms; 1 200 write samples gave p99
+ * 0.09 ms with rare WAL-checkpoint spikes to 4.37 ms. So *every* healthy query
+ * on this machine finishes inside ~4.4 ms, and the checkpoint spikes are the
+ * only thing anywhere near that.
+ *
+ * 35 ms sits two anchors above that: it is 8x the slowest healthy operation
+ * ever observed, so checkpoint spikes can never page anyone, and it is more
+ * than the 34 ms *end-to-end* time of the fastest complete conversation fetch
+ * measured on this box. A query crossing it therefore cost more on its own
+ * than an entire healthy request — which is the point at which a warn line is
+ * worth the bytes it occupies in the log.
+ *
+ * Override with `THREADBASE_DB_SLOW_QUERY_MS`; <= 0 disables slow logging.
+ */
+export declare const DEFAULT_SLOW_QUERY_MS = 35;
+/**
+ * Time every `.get()` / `.all()` / `.run()` on every statement this connection
+ * prepares.
+ *
+ * Wrapping `prepare` is what makes this one edit per database instead of one
+ * per query: `better-sqlite3` is synchronous, so a call's wall time *is* its
+ * cost, and every statement in the process — the 45 in ConversationCache, the
+ * 4 in RuntimeStore, and the ~40 more inside the repositories that share these
+ * handles — is created here. Measured overhead is +0.09 µs on an 8.9 µs call
+ * (~1%), which is why it is always on rather than behind a flag.
+ *
+ * Only the three terminal methods are replaced, as own properties; `iterate`,
+ * `pluck`, `raw`, `columns` and `bind` keep resolving to the prototype
+ * untouched. A statement that throws is not recorded — the error surfaces on
+ * its own path.
+ */
+export declare function instrumentDatabase(db: Database.Database, options?: {
+    slowMs?: number;
+}): Database.Database;
+/**
+ * Name the statements in a `{ name: Statement }` bag after their keys, so a
+ * slow-query line reads `getMessageIndexWindow` rather than
+ * `select:conversation_message_index`.
+ *
+ * Separate from `instrumentDatabase` because `prepare` cannot know the key its
+ * result is about to be assigned to. Statements from a connection that was
+ * never instrumented are skipped.
+ */
+export declare function labelStatements(statements: object): void;
+//# sourceMappingURL=query-timing.d.ts.map

package/dist/db/query-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-timing.d.ts","sourceRoot":"","sources":["../../src/db/query-timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AA+DxC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,QAAQ,CAAC,QAAQ,CA0BnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKxD"}

package/dist/db/repositories/cacheMetadata.repository.d.ts

@@ -0,0 +1,12 @@
+import type Database from "better-sqlite3";
+export type CacheMetadataKey = "last_conversation_id" | "last_conversation_created_at" | "projects_last_indexed_at" | "conversations_last_indexed_at" | "conversations_dirty";
+export declare class CacheMetadataRepository {
+    private get;
+    private upsert;
+    private del;
+    constructor(db: Database.Database);
+    getCacheMetadata(key: CacheMetadataKey): string | null;
+    setCacheMetadata(key: CacheMetadataKey, value: string): void;
+    deleteCacheMetadata(key: CacheMetadataKey): void;
+}
+//# sourceMappingURL=cacheMetadata.repository.d.ts.map

package/dist/db/repositories/cacheMetadata.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheMetadata.repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/cacheMetadata.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GACxB,sBAAsB,GACtB,8BAA8B,GAC9B,0BAA0B,GAC1B,+BAA+B,GAC/B,qBAAqB,CAAC;AAE1B,qBAAa,uBAAuB;IAClC,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,GAAG,CAAqB;IAEhC,YAAY,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAUhC;IAED,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAGrD;IAED,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAE/C;CACF"}

package/dist/db/repositories/conversations.repository.d.ts

@@ -0,0 +1,27 @@
+import type { ConversationCache } from "../../conversation-cache";
+/**
+ * Thin repository wrapper around ConversationCache for the project-id flow.
+ * The cache is the source of truth for conversation rows; this just exposes
+ * a stable, repo-style API for services that don't want to know about the
+ * cache class directly.
+ */
+export declare class ConversationsRepository {
+    private cache;
+    constructor(cache: ConversationCache);
+    updateConversationProjectId(args: {
+        conversationId: string;
+        projectId: string;
+    }): void;
+    listConversationsForProjectBackfill(): {
+        id: string;
+        projectPath: string | null;
+        projectId: string | null;
+        lastActivity: string | null;
+    }[];
+    getLatestConversation(): {
+        id: string;
+        lastActivity: string | null;
+    } | null;
+    hasOrphanRows(): boolean;
+}
+//# sourceMappingURL=conversations.repository.d.ts.map

package/dist/db/repositories/conversations.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.repository.d.ts","sourceRoot":"","sources":["../../../src/db/repositories/conversations.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,KAAK;IAAzB,YAAoB,KAAK,EAAE,iBAAiB,EAAI;IAEhD,2BAA2B,CAAC,IAAI,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAErF;IAED,mCAAmC;;;;;QAElC;IAED,qBAAqB;;;aAEpB;IAED,aAAa,IAAI,OAAO,CAEvB;CACF"}