@getrift/rift 0.0.0 → 0.1.0-beta.1

package/dist/src/storage/rebuild.js

@@ -0,0 +1,353 @@
+/**
+ * Shared full-rebuild logic — used by both the online reindex handler
+ * (POST /reindex { rebuild: true }) and the offline CLI path
+ * (rift rebuild --offline).
+ *
+ * Scans ALL Source Recoverability Contract locations and rebuilds
+ * all four tables via shadow-table swap.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { CONVERSATION_SOURCES } from "../providers/types.js";
+import { walkDirectory } from "../ingestion/scanner.js";
+import { isSupported } from "../ingestion/extractor.js";
+import { buildIgnoredPaths } from "../ingestion/ignored-paths.js";
+import { fileId } from "../ingestion/indexer.js";
+import { createShadowSwap } from "./shadow-swap.js";
+const ALL_CONV_SOURCES = [...CONVERSATION_SOURCES, "inbox"];
+/**
+ * Full rebuild from raw disk state via shadow-table swap.
+ * Creates shadow tables for all four tables, populates them from
+ * Source Recoverability Contract locations, then atomically swaps.
+ */
+export async function fullRebuild(deps) {
+    const swap = createShadowSwap(deps.dataDir);
+    const report = { tables_rebuilt: [], rows_reindexed: 0 };
+    const swaps = new Map();
+    await populateStructuredDocsShadows(deps, swap, swaps, report);
+    await populateConversationShadows(deps, swap, swaps, report);
+    await populateDigestShadow(deps, swap, swaps, report);
+    await swap.commitAllSwaps(swaps);
+    report.tables_rebuilt.push("structured_docs", "structured_docs_local", "conversations_hot", "conversations_cold", "digests");
+    return report;
+}
+// ---------------------------------------------------------------------------
+// Populate shadow tables from raw state
+// ---------------------------------------------------------------------------
+async function populateStructuredDocsShadows(deps, swap, swaps, report) {
+    const cloudShadow = await swap.createShadow("structured_docs");
+    const localShadow = await swap.createShadow("structured_docs_local");
+    swaps.set("structured_docs", cloudShadow);
+    swaps.set("structured_docs_local", localShadow);
+    // Track processed file IDs to avoid duplicates when source roots
+    // overlap or nest (e.g., cloud=/docs + local=/docs/private).
+    const seen = new Set();
+    for (const source of deps.config.sources) {
+        // Honor the same ignore policy as live watcher/scanner/reconcile so
+        // a full rebuild cannot re-pollute the index with content the user
+        // has per-source-excluded (e.g. `repos/`, `comms/`) or blocked via
+        // the universal junk list.
+        const files = walkDirectory(source.path, {
+            ignoredPaths: buildIgnoredPaths(source, deps.config.data_paths),
+        });
+        for (const rawPath of files) {
+            if (!isSupported(rawPath))
+                continue;
+            let canonical;
+            try {
+                canonical = fs.realpathSync(rawPath);
+            }
+            catch {
+                continue;
+            }
+            const id = fileId(canonical);
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            // Resolve provider via longest-prefix match so nested local
+            // roots are correctly attributed even when walked from a
+            // parent cloud root.
+            const owner = findOwningSource(canonical, deps.config) ?? source;
+            const isLocal = owner.extraction === "local" && !!deps.localEmbeddingProvider;
+            const provider = isLocal
+                ? deps.localEmbeddingProvider
+                : deps.embeddingProvider;
+            const targetShadow = isLocal ? localShadow : cloudShadow;
+            try {
+                const content = fs.readFileSync(canonical, "utf-8");
+                const embedding = await provider.embed(content);
+                const row = {
+                    id,
+                    source_path: canonical,
+                    content,
+                    embedding,
+                    source_type: owner.mode === "watch"
+                        ? "filesystem_watched"
+                        : "filesystem_scheduled_scan",
+                    source_scope: owner.scope,
+                    client_name: owner.client_name ?? "",
+                    indexed_at: new Date().toISOString(),
+                    metadata: "{}",
+                };
+                await targetShadow.add([row]);
+                report.rows_reindexed++;
+            }
+            catch (err) {
+                process.stderr.write(`rebuild: failed to index ${canonical}: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+    }
+}
+async function populateConversationShadows(deps, swap, swaps, report) {
+    const hotShadow = await swap.createShadow("conversations_hot");
+    const coldShadow = await swap.createShadow("conversations_cold");
+    swaps.set("conversations_hot", hotShadow);
+    swaps.set("conversations_cold", coldShadow);
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - (deps.config.compaction.age_threshold_days ?? 30));
+    for (const source of ALL_CONV_SOURCES) {
+        const rawDir = path.join(deps.dataDir, "raw", "conversations", source);
+        if (!fs.existsSync(rawDir))
+            continue;
+        const files = fs.readdirSync(rawDir).filter((f) => f.endsWith(".json"));
+        for (const file of files) {
+            const id = extractIdFromFilename(file);
+            if (!id)
+                continue;
+            const rawPath = path.join(rawDir, file);
+            try {
+                const raw = JSON.parse(fs.readFileSync(rawPath, "utf-8"));
+                const summary = raw.summary ?? "";
+                const content = raw.content ?? summary;
+                const vec = await deps.embeddingProvider.embed(content || summary);
+                const row = {
+                    id,
+                    content,
+                    summary,
+                    embedding: vec,
+                    source: raw.source ?? "claude_code",
+                    domain: raw.domain ?? "tech",
+                    intent: raw.intent ?? "build",
+                    quality: raw.quality ?? "medium",
+                    topics: JSON.stringify(raw.topics ?? []),
+                    decisions: JSON.stringify(raw.decisions ?? []),
+                    key_outputs: JSON.stringify(raw.key_outputs ?? []),
+                    indexed_at: new Date().toISOString(),
+                    idempotency_key: raw.idempotency_key ?? "",
+                };
+                const filenameTime = extractTimestampFromFilename(file);
+                const rowTime = filenameTime ?? fs.statSync(rawPath).mtime;
+                if (rowTime >= cutoff) {
+                    await hotShadow.add([row]);
+                }
+                else {
+                    await coldShadow.add([row]);
+                }
+                report.rows_reindexed++;
+            }
+            catch (err) {
+                process.stderr.write(`rebuild: failed to index conversation ${id}: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+    }
+}
+async function populateDigestShadow(deps, swap, swaps, report) {
+    const shadow = await swap.createShadow("digests");
+    swaps.set("digests", shadow);
+    const digestDir = path.join(deps.dataDir, "raw", "digests");
+    if (fs.existsSync(digestDir)) {
+        const files = fs.readdirSync(digestDir).filter((f) => f.endsWith(".json"));
+        for (const file of files) {
+            const rawPath = path.join(digestDir, file);
+            try {
+                const raw = JSON.parse(fs.readFileSync(rawPath, "utf-8"));
+                if (typeof raw.id !== "string" || !raw.id)
+                    continue;
+                const summary = raw.summary ?? raw.content ?? "";
+                const vec = await deps.embeddingProvider.embed(summary);
+                const row = {
+                    id: raw.id,
+                    content: raw.content ?? "",
+                    summary: raw.summary ?? "",
+                    embedding: vec,
+                    period_start: raw.period_start ?? "",
+                    period_end: raw.period_end ?? "",
+                    digest_type: raw.digest_type ?? "weekly",
+                    created_at: raw.created_at ?? new Date().toISOString(),
+                };
+                await shadow.add([row]);
+                report.rows_reindexed++;
+            }
+            catch (err) {
+                process.stderr.write(`rebuild: failed to index digest from ${file}: ${err instanceof Error ? err.message : String(err)}\n`);
+            }
+        }
+    }
+}
+export async function reembed(embeddingProvider, scope, config, localEmbeddingProvider) {
+    let count = 0;
+    if (scope === "all" || scope === "structured_docs" || scope === "documents") {
+        count += await reembedStructuredDocs(embeddingProvider, config, localEmbeddingProvider);
+        if (localEmbeddingProvider) {
+            count += await reembedLocalStructuredDocs(localEmbeddingProvider);
+        }
+    }
+    if (scope === "all" || scope === "conversations") {
+        count += await reembedTable("conversations_hot", embeddingProvider, (r) => r.content || r.summary, "indexed_at");
+        count += await reembedTable("conversations_cold", embeddingProvider, (r) => r.content || r.summary, "indexed_at");
+        count += await reembedTable("digests", embeddingProvider, (r) => r.summary || r.content, "created_at");
+    }
+    return count;
+}
+/**
+ * Re-embed structured_docs with per-source provider routing.
+ * Rows whose source_path falls under a local-extraction source use
+ * localEmbeddingProvider; everything else uses the cloud provider.
+ */
+async function reembedStructuredDocs(cloudProvider, config, localProvider) {
+    const { getTable } = await import("./tables.js");
+    const table = getTable("structured_docs");
+    const allRows = (await table.query().toArray());
+    let count = 0;
+    for (const row of allRows) {
+        try {
+            const provider = resolveProviderForPath(row.source_path, cloudProvider, config, localProvider);
+            const newEmbedding = await provider.embed(row.content);
+            const oldTimestamp = row.indexed_at;
+            const newTimestamp = new Date().toISOString();
+            await table.add([{ ...row, embedding: newEmbedding, indexed_at: newTimestamp }]);
+            try {
+                await table.delete(`id = '${row.id}' AND indexed_at = '${oldTimestamp}'`);
+                count++;
+            }
+            catch {
+                try {
+                    await table.delete(`id = '${row.id}' AND indexed_at = '${newTimestamp}'`);
+                }
+                catch { /* duplicate remains — reconcile will repair */ }
+            }
+        }
+        catch (err) {
+            process.stderr.write(`reindex: failed to re-embed ${row.id} in structured_docs: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    return count;
+}
+/**
+ * Re-embed all rows in structured_docs_local using the local provider.
+ * Simpler than the cloud path: all rows use the same provider.
+ */
+async function reembedLocalStructuredDocs(localProvider) {
+    const { getTable } = await import("./tables.js");
+    const table = getTable("structured_docs_local");
+    const allRows = (await table.query().toArray());
+    let count = 0;
+    for (const row of allRows) {
+        try {
+            const newEmbedding = await localProvider.embed(row.content);
+            const oldTimestamp = row.indexed_at;
+            const newTimestamp = new Date().toISOString();
+            await table.add([{ ...row, embedding: newEmbedding, indexed_at: newTimestamp }]);
+            try {
+                await table.delete(`id = '${row.id}' AND indexed_at = '${oldTimestamp}'`);
+                count++;
+            }
+            catch {
+                try {
+                    await table.delete(`id = '${row.id}' AND indexed_at = '${newTimestamp}'`);
+                }
+                catch { /* duplicate remains — reconcile will repair */ }
+            }
+        }
+        catch (err) {
+            process.stderr.write(`reindex: failed to re-embed ${row.id} in structured_docs_local: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    return count;
+}
+/**
+ * Pick the right embedding provider for a file's source path.
+ * Uses longest-prefix match so nested roots resolve correctly:
+ * cloud=/docs + local=/docs/private → file under /docs/private gets local.
+ */
+function resolveProviderForPath(sourcePath, cloudProvider, config, localProvider) {
+    if (!config || !localProvider)
+        return cloudProvider;
+    const source = findOwningSource(sourcePath, config);
+    if (source?.extraction === "local")
+        return localProvider;
+    return cloudProvider;
+}
+/**
+ * Find the most-specific source root that owns a given file path.
+ * Longest prefix wins, so nested roots are correctly attributed.
+ */
+function findOwningSource(filePath, config) {
+    let best;
+    let bestLen = 0;
+    for (const s of config.sources) {
+        if (filePath.startsWith(s.path) && s.path.length > bestLen) {
+            best = s;
+            bestLen = s.path.length;
+        }
+    }
+    return best;
+}
+async function reembedTable(tableName, embeddingProvider, getText, timestampField) {
+    const { getTable } = await import("./tables.js");
+    const table = getTable(tableName);
+    const allRows = (await table.query().toArray());
+    let count = 0;
+    for (const row of allRows) {
+        try {
+            const text = getText(row);
+            const newEmbedding = await embeddingProvider.embed(text);
+            const oldTimestamp = row[timestampField];
+            const newTimestamp = new Date().toISOString();
+            await table.add([{ ...row, embedding: newEmbedding, [timestampField]: newTimestamp }]);
+            try {
+                await table.delete(`id = '${row.id}' AND ${timestampField} = '${oldTimestamp}'`);
+                count++;
+            }
+            catch {
+                try {
+                    await table.delete(`id = '${row.id}' AND ${timestampField} = '${newTimestamp}'`);
+                }
+                catch { /* duplicate remains — reconcile will repair */ }
+            }
+        }
+        catch (err) {
+            process.stderr.write(`reindex: failed to re-embed ${row.id} in ${tableName}: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function extractIdFromFilename(filename) {
+    const match = filename.match(/^[^_]+_(.+)\.json$/);
+    return match?.[1];
+}
+/**
+ * Extract the ISO timestamp from a raw conversation filename.
+ * Format: `{timestamp}_{id}.json` where timestamp is ISO with colons/dots
+ * replaced by hyphens (e.g. `2024-01-01T00-00-00-000Z_conv-1.json`).
+ */
+export function extractTimestampFromFilename(filename) {
+    const match = filename.match(/^(\d{4}-\d{2}-\d{2}T[\d-]+Z)_/);
+    if (!match?.[1])
+        return undefined;
+    const raw = match[1];
+    const parts = raw.split("T");
+    if (parts.length !== 2)
+        return undefined;
+    const timePart = parts[1];
+    const segments = timePart.replace("Z", "").split("-");
+    if (segments.length < 3)
+        return undefined;
+    const restored = `${parts[0]}T${segments[0]}:${segments[1]}:${segments[2]}${segments.length > 3 ? "." + segments[3] : ""}Z`;
+    const d = new Date(restored);
+    return isNaN(d.getTime()) ? undefined : d;
+}
+//# sourceMappingURL=rebuild.js.map

package/dist/src/storage/rebuild.js.map

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

package/dist/src/storage/shadow-swap.d.ts

@@ -0,0 +1,20 @@
+import type { Table } from "./db.js";
+import type { TableName } from "./tables.js";
+export interface ShadowSwap {
+    /** Create a shadow (temporary) table for writing rebuilt data. */
+    createShadow(tableName: TableName): Promise<Table>;
+    /**
+     * Commit all pending shadow swaps atomically.
+     * Closes all handles, renames shadow dirs to live, reopens connection,
+     * and updates the table handle cache.
+     *
+     * @param swaps - Map of tableName -> shadowTable handle to commit.
+     */
+    commitAllSwaps(swaps: Map<TableName, Table>): Promise<void>;
+}
+/**
+ * Create a ShadowSwap bound to a specific data directory.
+ * The dbPath is derived as `<dataDir>/lancedb`.
+ */
+export declare function createShadowSwap(dataDir: string): ShadowSwap;
+//# sourceMappingURL=shadow-swap.d.ts.map

package/dist/src/storage/shadow-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-swap.d.ts","sourceRoot":"","sources":["../../../src/storage/shadow-swap.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnD;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA0H5D"}

package/dist/src/storage/shadow-swap.js

@@ -0,0 +1,163 @@
+/**
+ * Shadow-table swap — Slice 15 implementation.
+ *
+ * Used by reindex/rebuild: build a new table in the background,
+ * then swap it in place of the current table.
+ *
+ * ## Two-phase swap pattern
+ *
+ * To ensure four-table coherence (all tables reflect the same generation),
+ * the swap uses a two-phase approach with rollback:
+ *
+ * 1. `conn.createTable("_shadow_" + name, seedData)` — create shadow table
+ * 2. Populate shadow with rebuilt data
+ * 3. Close all handles and the connection
+ * 4. **Phase A (Evacuate):** rename all `live.lance` → `_old_live.lance`
+ *    If this fails, rollback restores any already-evacuated dirs.
+ * 5. **Phase B (Install):** rename all `_shadow_live.lance` → `live.lance`
+ *    If this fails, rollback removes installed shadows and restores `_old_`.
+ * 6. **Phase C (Cleanup):** delete all `_old_` dirs (harmless if it fails).
+ * 7. Reopen connection and all tables.
+ *
+ * This guarantees that on any failure, ALL tables revert to the pre-swap
+ * generation — no mixed old/new state.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { getConnection, closeConnection, resetConnectionRef } from "./db.js";
+import { SEED_ID, seedForTable, setTable, setSwapInProgress, closeAllHandles, TABLE_NAMES } from "./tables.js";
+function shadowName(tableName) {
+    return `_shadow_${tableName}`;
+}
+/**
+ * Create a ShadowSwap bound to a specific data directory.
+ * The dbPath is derived as `<dataDir>/lancedb`.
+ */
+export function createShadowSwap(dataDir) {
+    const dbPath = path.join(dataDir, "lancedb");
+    return {
+        async createShadow(tableName) {
+            const conn = await getConnection(dbPath);
+            const sName = shadowName(tableName);
+            // Clean up any leftover shadow from a previous failed attempt.
+            const existing = new Set(await conn.tableNames());
+            if (existing.has(sName)) {
+                await conn.dropTable(sName);
+            }
+            const seed = seedForTable(tableName);
+            const table = await conn.createTable(sName, seed);
+            await table.delete(`id = '${SEED_ID}'`);
+            return table;
+        },
+        async commitAllSwaps(swaps) {
+            // Acquire swap lock — readers will get a clear error during this window.
+            setSwapInProgress(true);
+            try {
+                // Step 1: Close all shadow handles (flush writes to disk).
+                for (const shadowTable of swaps.values()) {
+                    shadowTable.close();
+                }
+                // Step 2: Close all live table handles (bypass swap lock via closeAllHandles).
+                closeAllHandles();
+                // Step 3: Close the connection (clear LanceDB internal state).
+                closeConnection();
+                resetConnectionRef();
+                // Step 4: Two-phase filesystem swap for four-table coherence.
+                const tableNames = [...swaps.keys()];
+                const oldDirs = new Map();
+                // Phase A: Evacuate — rename all live dirs to _old_ (backup).
+                try {
+                    for (const tableName of tableNames) {
+                        const liveDir = path.join(dbPath, `${tableName}.lance`);
+                        const oldDir = path.join(dbPath, `_old_${tableName}.lance`);
+                        if (fs.existsSync(liveDir)) {
+                            fs.renameSync(liveDir, oldDir);
+                            oldDirs.set(tableName, oldDir);
+                        }
+                    }
+                }
+                catch {
+                    // Evacuate failed — restore any already-evacuated tables.
+                    for (const [tn, od] of oldDirs) {
+                        try {
+                            fs.renameSync(od, path.join(dbPath, `${tn}.lance`));
+                        }
+                        catch { /* best effort */ }
+                    }
+                    throw new Error("shadow-swap: evacuate phase failed");
+                }
+                // Phase B: Install — rename all shadow dirs to live names.
+                try {
+                    for (const tableName of tableNames) {
+                        const liveDir = path.join(dbPath, `${tableName}.lance`);
+                        const sDir = path.join(dbPath, `${shadowName(tableName)}.lance`);
+                        fs.renameSync(sDir, liveDir);
+                    }
+                }
+                catch {
+                    // Install failed — rollback: remove installed shadows, restore _old_.
+                    for (const tableName of tableNames) {
+                        const liveDir = path.join(dbPath, `${tableName}.lance`);
+                        try {
+                            if (fs.existsSync(liveDir))
+                                fs.rmSync(liveDir, { recursive: true, force: true });
+                        }
+                        catch { /* best effort */ }
+                    }
+                    for (const [tn, od] of oldDirs) {
+                        try {
+                            fs.renameSync(od, path.join(dbPath, `${tn}.lance`));
+                        }
+                        catch { /* best effort */ }
+                    }
+                    throw new Error("shadow-swap: install phase failed, rolled back to previous state");
+                }
+                // Phase C: Cleanup — remove _old_ dirs (harmless if this fails).
+                for (const od of oldDirs.values()) {
+                    try {
+                        fs.rmSync(od, { recursive: true, force: true });
+                    }
+                    catch { /* stale cruft */ }
+                }
+            }
+            finally {
+                // Step 5: Safety net — if rollback itself partially failed, ensure
+                // every table has a live directory from whatever source remains.
+                for (const tableName of swaps.keys()) {
+                    const liveDir = path.join(dbPath, `${tableName}.lance`);
+                    const oldDir = path.join(dbPath, `_old_${tableName}.lance`);
+                    const sDir = path.join(dbPath, `${shadowName(tableName)}.lance`);
+                    try {
+                        if (!fs.existsSync(liveDir)) {
+                            if (fs.existsSync(oldDir))
+                                fs.renameSync(oldDir, liveDir);
+                            else if (fs.existsSync(sDir))
+                                fs.renameSync(sDir, liveDir);
+                        }
+                        if (fs.existsSync(oldDir))
+                            fs.rmSync(oldDir, { recursive: true, force: true });
+                        if (fs.existsSync(sDir))
+                            fs.rmSync(sDir, { recursive: true, force: true });
+                    }
+                    catch { /* integrity check will catch remaining damage */ }
+                }
+                // Step 6: Reopen connection and all tables from whatever survived.
+                try {
+                    const conn = await getConnection(dbPath);
+                    const existing = new Set(await conn.tableNames());
+                    for (const tableName of TABLE_NAMES) {
+                        if (existing.has(tableName)) {
+                            setTable(tableName, await conn.openTable(tableName));
+                        }
+                    }
+                }
+                catch (err) {
+                    process.stderr.write(`shadow-swap: recovery reopen failed: ${err instanceof Error ? err.message : String(err)}\n`);
+                }
+                // Release swap lock — readers can proceed again.
+                setSwapInProgress(false);
+            }
+        },
+    };
+}
+//# sourceMappingURL=shadow-swap.js.map

package/dist/src/storage/shadow-swap.js.map

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

package/dist/src/storage/tables.d.ts

@@ -0,0 +1,77 @@
+import type { Table } from "./db.js";
+import { type ConversationSource, type Domain, type Intent, type ConversationQuality, type SourceType, type SourceScope } from "../providers/types.js";
+/** Core tables that must exist after first boot. */
+export declare const CORE_TABLE_NAMES: readonly ["structured_docs", "conversations_hot", "conversations_cold", "digests"];
+/** All tables including optional ones created by initTables. */
+export declare const TABLE_NAMES: readonly ["structured_docs", "conversations_hot", "conversations_cold", "digests", "structured_docs_local"];
+export type TableName = (typeof TABLE_NAMES)[number];
+export interface StructuredDocRow {
+    [key: string]: unknown;
+    id: string;
+    source_path: string;
+    content: string;
+    embedding: number[];
+    source_type: SourceType;
+    source_scope: SourceScope;
+    client_name: string;
+    indexed_at: string;
+    metadata: string;
+}
+export interface ConversationRow {
+    [key: string]: unknown;
+    id: string;
+    content: string;
+    summary: string;
+    embedding: number[];
+    source: ConversationSource;
+    domain: Domain;
+    intent: Intent;
+    quality: ConversationQuality;
+    topics: string;
+    decisions: string;
+    key_outputs: string;
+    indexed_at: string;
+    idempotency_key: string;
+}
+export interface DigestRow {
+    [key: string]: unknown;
+    id: string;
+    content: string;
+    summary: string;
+    embedding: number[];
+    period_start: string;
+    period_end: string;
+    digest_type: string;
+    created_at: string;
+}
+export declare const SEED_ID = "__seed__";
+export declare function setSwapInProgress(v: boolean): void;
+export declare function isSwapInProgress(): boolean;
+/**
+ * Initialize all four LanceDB tables. Idempotent — safe to call on every startup.
+ * Creates tables that don't exist; opens tables that already do.
+ */
+export declare function initTables(dataDir: string): Promise<void>;
+/**
+ * Get a typed table handle. Throws if tables haven't been initialized
+ * or if a shadow swap is in progress.
+ */
+export declare function getTable(name: TableName): Table;
+/** Replace the cached handle for a table (used by shadow-swap after commit). */
+export declare function setTable(name: TableName, table: Table): void;
+/**
+ * Close all live table handles without checking the swap lock.
+ * Used internally by shadow-swap during commitAllSwaps.
+ */
+export declare function closeAllHandles(): void;
+/**
+ * Refresh all cached table handles to see the latest data.
+ * Called after worker processes write to the same LanceDB files.
+ */
+export declare function refreshTables(): Promise<void>;
+/** Close all table handles and the connection. */
+export declare function closeTables(): void;
+/** Reset all state (for tests). */
+export declare function resetTables(): void;
+export declare function seedForTable(name: TableName): Record<string, unknown>[];
+//# sourceMappingURL=tables.d.ts.map

package/dist/src/storage/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/storage/tables.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAc,KAAK,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAI/B,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,oFAKnB,CAAC;AAEX,gEAAgE;AAChE,eAAO,MAAM,WAAW,6GAGd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,OAAO,aAAa,CAAC;AA0ElC,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAS/C;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CASnD;AAED,kDAAkD;AAClD,wBAAgB,WAAW,IAAI,IAAI,CAMlC;AAED,mCAAmC;AACnC,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAYvE"}