@iworkforces/tracelattice 2.0.3

package/dist/persistence/SqliteLegacyImport.js

@@ -0,0 +1,136 @@
+import { link as promises_link, lstat, mkdir, mkdtemp, rm } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { GLOBAL_SESSION_ID } from "../contracts/ids.js";
+import { PersistenceCompatibilityError, PersistenceCorruptionError, PersistenceLegacyAmbiguityError } from "../errors.js";
+import { parseFileSnapshotV2, serializeFileSnapshotV2 } from "./FileSnapshotV2.js";
+import { isFileNotFound } from "./FileWriter.js";
+import { validateSqliteV1Schema } from "./SqliteLegacySchema.js";
+import { decodeEdgeRow, decodeSummaryRow, decodeThoughtRow, parseSqliteJson, stringField } from "./SqlitePayload.js";
+import { parsePersistenceBranchId } from "./PersistenceScope.js";
+import { writeSqliteSnapshot } from "./SqliteSnapshotWriter.js";
+async function pathIsAbsent(path) {
+    try {
+        await lstat(path);
+        return false;
+    } catch (error) {
+        if (isFileNotFound(error)) return true;
+        throw error;
+    }
+}
+function groupBySession(values, sessionOf) {
+    const grouped = new Map();
+    for (const value of values){
+        const sessionId = sessionOf(value);
+        const sessionValues = grouped.get(sessionId) ?? [];
+        sessionValues.push(value);
+        grouped.set(sessionId, sessionValues);
+    }
+    return grouped;
+}
+function loadLegacyThoughts(database, sourcePath) {
+    const thoughts = database.prepare('SELECT data FROM thoughts ORDER BY id ASC').all().map((row, index)=>decodeThoughtRow(row, `${sourcePath}:thoughts:${index}`));
+    return [
+        ...groupBySession(thoughts, (thought)=>thought.session_id ?? GLOBAL_SESSION_ID)
+    ].map(([sessionId, sessionThoughts])=>({
+            sessionId,
+            thoughts: sessionThoughts
+        }));
+}
+function decodeLegacyBranch(row, sourcePath) {
+    const branchId = parsePersistenceBranchId(stringField(row, 'branch_id', sourcePath), sourcePath);
+    const data = parseSqliteJson(stringField(row, 'data', sourcePath), sourcePath);
+    if (!Array.isArray(data)) throw new PersistenceCorruptionError(sourcePath, new TypeError('branch data is not an array'));
+    const thoughts = data.map((value, index)=>decodeThoughtRow({
+            data: JSON.stringify(value)
+        }, `${sourcePath}:thought:${index}`));
+    if (0 === thoughts.length) throw new PersistenceLegacyAmbiguityError(sourcePath, 'empty branch has no inferable session');
+    const sessions = new Set(thoughts.map((thought)=>thought.session_id ?? GLOBAL_SESSION_ID));
+    if (1 !== sessions.size) throw new PersistenceLegacyAmbiguityError(sourcePath, 'branch thoughts resolve to multiple sessions');
+    const sessionId = sessions.values().next().value;
+    if (void 0 === sessionId) throw new PersistenceLegacyAmbiguityError(sourcePath, 'branch session is absent');
+    return {
+        sessionId,
+        branchId,
+        thoughts
+    };
+}
+function loadLegacyBranches(database, sourcePath, hasBranches) {
+    if (!hasBranches) return [];
+    return database.prepare('SELECT branch_id, data FROM branches ORDER BY branch_id ASC').all().map((row, index)=>decodeLegacyBranch(row, `${sourcePath}:branches:${index}`));
+}
+function loadLegacyEdges(database, sourcePath) {
+    const edges = database.prepare('SELECT id, session_id, from_id, to_id, kind, created_at, metadata FROM edges ORDER BY created_at ASC, id ASC').all().map((row, index)=>decodeEdgeRow(row, `${sourcePath}:edges:${index}`));
+    return [
+        ...groupBySession(edges, (edge)=>edge.sessionId)
+    ].map(([sessionId, sessionEdges])=>({
+            sessionId,
+            edges: sessionEdges
+        }));
+}
+function loadLegacySummaries(database, sourcePath) {
+    const summaries = database.prepare('SELECT id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta FROM summaries ORDER BY created_at ASC, id ASC').all().map((row, index)=>decodeSummaryRow(row, `${sourcePath}:summaries:${index}`));
+    return [
+        ...groupBySession(summaries, (summary)=>summary.sessionId)
+    ].map(([sessionId, sessionSummaries])=>({
+            sessionId,
+            summaries: sessionSummaries
+        }));
+}
+function loadLegacySnapshot(database, sourcePath) {
+    const hasBranches = validateSqliteV1Schema(database, sourcePath);
+    const snapshot = {
+        version: 2,
+        thoughts: loadLegacyThoughts(database, sourcePath),
+        branches: loadLegacyBranches(database, sourcePath, hasBranches),
+        edges: loadLegacyEdges(database, sourcePath),
+        summaries: loadLegacySummaries(database, sourcePath)
+    };
+    return parseFileSnapshotV2(serializeFileSnapshotV2(snapshot, sourcePath), sourcePath);
+}
+async function importWithDriver(sourceDbPath, destinationDbPath, Database) {
+    if (!await pathIsAbsent(destinationDbPath)) throw new PersistenceCompatibilityError(destinationDbPath, 'destination must be absent');
+    const source = new Database(sourceDbPath, {
+        readonly: true,
+        fileMustExist: true
+    });
+    let snapshot;
+    try {
+        snapshot = loadLegacySnapshot(source, sourceDbPath);
+    } finally{
+        source.close();
+    }
+    await mkdir(dirname(destinationDbPath), {
+        recursive: true
+    });
+    const stagingDir = await mkdtemp(join(dirname(destinationDbPath), `.${basename(destinationDbPath)}.import-`));
+    const stagedDbPath = join(stagingDir, basename(destinationDbPath));
+    let destination;
+    try {
+        destination = new Database(stagedDbPath);
+        writeSqliteSnapshot(destination, snapshot, stagedDbPath);
+        destination.close();
+        destination = void 0;
+        await promises_link(stagedDbPath, destinationDbPath);
+    } catch (error) {
+        destination?.close();
+        throw error;
+    } finally{
+        await rm(stagingDir, {
+            recursive: true,
+            force: true
+        });
+    }
+}
+async function importLegacySqliteV1(sourceDbPath, destinationDbPath) {
+    let Database;
+    try {
+        const module = await import("better-sqlite3");
+        Database = module.default;
+    } catch (error) {
+        throw new PersistenceCompatibilityError(sourceDbPath, "SQLite import requires the optional 'better-sqlite3' package", error);
+    }
+    await importWithDriver(sourceDbPath, destinationDbPath, Database);
+}
+export { importLegacySqliteV1 };
+
+//# sourceMappingURL=SqliteLegacyImport.js.map

package/dist/persistence/SqliteLegacyImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqliteLegacyImport.js","sources":["../../src/persistence/SqliteLegacyImport.ts"],"sourcesContent":["import { lstat, link, mkdir, mkdtemp, rm } from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { GLOBAL_SESSION_ID, type SessionId } from '../contracts/ids.js';\nimport {\n\tPersistenceCompatibilityError,\n\tPersistenceCorruptionError,\n\tPersistenceLegacyAmbiguityError,\n} from '../errors.js';\nimport { parseFileSnapshotV2, serializeFileSnapshotV2 } from './FileSnapshotV2.js';\nimport type {\n\tBranchRecordV2,\n\tEdgeSessionV2,\n\tFileSnapshotV2,\n\tSummarySessionV2,\n\tThoughtSessionV2,\n} from './FileSnapshotTypes.js';\nimport { isFileNotFound } from './FileWriter.js';\nimport type { SqliteDatabase, SqliteDatabaseConstructor } from './SqliteDriver.js';\nimport { validateSqliteV1Schema } from './SqliteLegacySchema.js';\nimport {\n\tdecodeEdgeRow,\n\tdecodeSummaryRow,\n\tdecodeThoughtRow,\n\tparseSqliteJson,\n\tstringField,\n} from './SqlitePayload.js';\nimport { parsePersistenceBranchId } from './PersistenceScope.js';\nimport { writeSqliteSnapshot } from './SqliteSnapshotWriter.js';\n\nasync function pathIsAbsent(path: string): Promise<boolean> {\n\ttry {\n\t\tawait lstat(path);\n\t\treturn false;\n\t} catch (error) {\n\t\tif (isFileNotFound(error)) return true;\n\t\tthrow error;\n\t}\n}\n\nfunction groupBySession<T>(\n\tvalues: readonly T[],\n\tsessionOf: (value: T) => SessionId\n): Map<SessionId, T[]> {\n\tconst grouped = new Map<SessionId, T[]>();\n\tfor (const value of values) {\n\t\tconst sessionId = sessionOf(value);\n\t\tconst sessionValues = grouped.get(sessionId) ?? [];\n\t\tsessionValues.push(value);\n\t\tgrouped.set(sessionId, sessionValues);\n\t}\n\treturn grouped;\n}\n\nfunction loadLegacyThoughts(database: SqliteDatabase, sourcePath: string): ThoughtSessionV2[] {\n\tconst thoughts = database\n\t\t.prepare('SELECT data FROM thoughts ORDER BY id ASC')\n\t\t.all()\n\t\t.map((row, index) => decodeThoughtRow(row, `${sourcePath}:thoughts:${index}`));\n\treturn [...groupBySession(thoughts, (thought) => thought.session_id ?? GLOBAL_SESSION_ID)].map(\n\t\t([sessionId, sessionThoughts]) => ({ sessionId, thoughts: sessionThoughts })\n\t);\n}\n\nfunction decodeLegacyBranch(row: unknown, sourcePath: string): BranchRecordV2 {\n\tconst branchId = parsePersistenceBranchId(stringField(row, 'branch_id', sourcePath), sourcePath);\n\tconst data = parseSqliteJson(stringField(row, 'data', sourcePath), sourcePath);\n\tif (!Array.isArray(data)) {\n\t\tthrow new PersistenceCorruptionError(sourcePath, new TypeError('branch data is not an array'));\n\t}\n\tconst thoughts = data.map((value, index) =>\n\t\tdecodeThoughtRow({ data: JSON.stringify(value) }, `${sourcePath}:thought:${index}`)\n\t);\n\tif (thoughts.length === 0) {\n\t\tthrow new PersistenceLegacyAmbiguityError(sourcePath, 'empty branch has no inferable session');\n\t}\n\tconst sessions = new Set(thoughts.map((thought) => thought.session_id ?? GLOBAL_SESSION_ID));\n\tif (sessions.size !== 1) {\n\t\tthrow new PersistenceLegacyAmbiguityError(\n\t\t\tsourcePath,\n\t\t\t'branch thoughts resolve to multiple sessions'\n\t\t);\n\t}\n\tconst sessionId = sessions.values().next().value;\n\tif (sessionId === undefined) {\n\t\tthrow new PersistenceLegacyAmbiguityError(sourcePath, 'branch session is absent');\n\t}\n\treturn { sessionId, branchId, thoughts };\n}\n\nfunction loadLegacyBranches(\n\tdatabase: SqliteDatabase,\n\tsourcePath: string,\n\thasBranches: boolean\n): BranchRecordV2[] {\n\tif (!hasBranches) return [];\n\treturn database\n\t\t.prepare('SELECT branch_id, data FROM branches ORDER BY branch_id ASC')\n\t\t.all()\n\t\t.map((row, index) => decodeLegacyBranch(row, `${sourcePath}:branches:${index}`));\n}\n\nfunction loadLegacyEdges(database: SqliteDatabase, sourcePath: string): EdgeSessionV2[] {\n\tconst edges = database\n\t\t.prepare(\n\t\t\t'SELECT id, session_id, from_id, to_id, kind, created_at, metadata FROM edges ORDER BY created_at ASC, id ASC'\n\t\t)\n\t\t.all()\n\t\t.map((row, index) => decodeEdgeRow(row, `${sourcePath}:edges:${index}`));\n\treturn [...groupBySession(edges, (edge) => edge.sessionId)].map(([sessionId, sessionEdges]) => ({\n\t\tsessionId,\n\t\tedges: sessionEdges,\n\t}));\n}\n\nfunction loadLegacySummaries(database: SqliteDatabase, sourcePath: string): SummarySessionV2[] {\n\tconst summaries = database\n\t\t.prepare(\n\t\t\t'SELECT id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta FROM summaries ORDER BY created_at ASC, id ASC'\n\t\t)\n\t\t.all()\n\t\t.map((row, index) => decodeSummaryRow(row, `${sourcePath}:summaries:${index}`));\n\treturn [...groupBySession(summaries, (summary) => summary.sessionId)].map(\n\t\t([sessionId, sessionSummaries]) => ({ sessionId, summaries: sessionSummaries })\n\t);\n}\n\nfunction loadLegacySnapshot(database: SqliteDatabase, sourcePath: string): FileSnapshotV2 {\n\tconst hasBranches = validateSqliteV1Schema(database, sourcePath);\n\tconst snapshot: FileSnapshotV2 = {\n\t\tversion: 2,\n\t\tthoughts: loadLegacyThoughts(database, sourcePath),\n\t\tbranches: loadLegacyBranches(database, sourcePath, hasBranches),\n\t\tedges: loadLegacyEdges(database, sourcePath),\n\t\tsummaries: loadLegacySummaries(database, sourcePath),\n\t};\n\treturn parseFileSnapshotV2(serializeFileSnapshotV2(snapshot, sourcePath), sourcePath);\n}\n\nasync function importWithDriver(\n\tsourceDbPath: string,\n\tdestinationDbPath: string,\n\tDatabase: SqliteDatabaseConstructor\n): Promise<void> {\n\tif (!(await pathIsAbsent(destinationDbPath))) {\n\t\tthrow new PersistenceCompatibilityError(destinationDbPath, 'destination must be absent');\n\t}\n\tconst source = new Database(sourceDbPath, { readonly: true, fileMustExist: true });\n\tlet snapshot: FileSnapshotV2;\n\ttry {\n\t\tsnapshot = loadLegacySnapshot(source, sourceDbPath);\n\t} finally {\n\t\tsource.close();\n\t}\n\tawait mkdir(dirname(destinationDbPath), { recursive: true });\n\tconst stagingDir = await mkdtemp(\n\t\tjoin(dirname(destinationDbPath), `.${basename(destinationDbPath)}.import-`)\n\t);\n\tconst stagedDbPath = join(stagingDir, basename(destinationDbPath));\n\tlet destination: SqliteDatabase | undefined;\n\ttry {\n\t\tdestination = new Database(stagedDbPath);\n\t\twriteSqliteSnapshot(destination, snapshot, stagedDbPath);\n\t\tdestination.close();\n\t\tdestination = undefined;\n\t\tawait link(stagedDbPath, destinationDbPath);\n\t} catch (error) {\n\t\tdestination?.close();\n\t\tthrow error;\n\t} finally {\n\t\tawait rm(stagingDir, { recursive: true, force: true });\n\t}\n}\n\n/**\n * Imports an immutable SQLite v1 database into a separately published SQLite v2 destination.\n *\n * @param sourceDbPath - Existing frozen v1 source database opened read-only.\n * @param destinationDbPath - Absent destination path atomically published after validation.\n * @returns A promise that resolves after the validated v2 database is published.\n *\n * @example\n * ```ts\n * await importLegacySqliteV1('fixtures/legacy.db', 'output/history.db');\n * ```\n */\nexport async function importLegacySqliteV1(\n\tsourceDbPath: string,\n\tdestinationDbPath: string\n): Promise<void> {\n\tlet Database: SqliteDatabaseConstructor;\n\ttry {\n\t\tconst module = await import('better-sqlite3');\n\t\tDatabase = module.default;\n\t} catch (error) {\n\t\tthrow new PersistenceCompatibilityError(\n\t\t\tsourceDbPath,\n\t\t\t\"SQLite import requires the optional 'better-sqlite3' package\",\n\t\t\terror\n\t\t);\n\t}\n\tawait importWithDriver(sourceDbPath, destinationDbPath, Database);\n}\n"],"names":["pathIsAbsent","path","lstat","error","isFileNotFound","groupBySession","values","sessionOf","grouped","Map","value","sessionId","sessionValues","loadLegacyThoughts","database","sourcePath","thoughts","row","index","decodeThoughtRow","thought","GLOBAL_SESSION_ID","sessionThoughts","decodeLegacyBranch","branchId","parsePersistenceBranchId","stringField","data","parseSqliteJson","Array","PersistenceCorruptionError","TypeError","JSON","PersistenceLegacyAmbiguityError","sessions","Set","undefined","loadLegacyBranches","hasBranches","loadLegacyEdges","edges","decodeEdgeRow","edge","sessionEdges","loadLegacySummaries","summaries","decodeSummaryRow","summary","sessionSummaries","loadLegacySnapshot","validateSqliteV1Schema","snapshot","parseFileSnapshotV2","serializeFileSnapshotV2","importWithDriver","sourceDbPath","destinationDbPath","Database","PersistenceCompatibilityError","source","mkdir","dirname","stagingDir","mkdtemp","join","basename","stagedDbPath","destination","writeSqliteSnapshot","link","rm","importLegacySqliteV1","module"],"mappings":"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"}

package/dist/persistence/SqliteLegacySchema.d.ts

@@ -0,0 +1,15 @@
+import type { SqliteDatabase } from './SqliteDriver.js';
+/**
+ * Validates the frozen, unversioned SQLite v1 schema without mutating it.
+ *
+ * @param database - Read-only source database.
+ * @param sourcePath - Source name used by typed compatibility errors.
+ * @returns Whether the optional legacy branches table is present.
+ *
+ * @example
+ * ```ts
+ * const hasBranches = validateSqliteV1Schema(database, 'legacy.db');
+ * ```
+ */
+export declare function validateSqliteV1Schema(database: SqliteDatabase, sourcePath: string): boolean;
+//# sourceMappingURL=SqliteLegacySchema.d.ts.map

package/dist/persistence/SqliteLegacySchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteLegacySchema.d.ts","sourceRoot":"","sources":["../../src/persistence/SqliteLegacySchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAoDxD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAuB5F"}

package/dist/persistence/SqliteLegacySchema.js

@@ -0,0 +1,72 @@
+import { PersistenceCompatibilityError } from "../errors.js";
+const LEGACY_TABLES = new Map([
+    [
+        'thoughts',
+        "CREATE TABLE thoughts (id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT NOT NULL, created_at INTEGER DEFAULT (strftime('%s', 'now')))"
+    ],
+    [
+        'branches',
+        "CREATE TABLE branches (branch_id TEXT PRIMARY KEY, data TEXT NOT NULL, updated_at INTEGER DEFAULT (strftime('%s', 'now')))"
+    ],
+    [
+        'edges',
+        'CREATE TABLE edges (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, from_id TEXT NOT NULL, to_id TEXT NOT NULL, kind TEXT NOT NULL, created_at INTEGER NOT NULL, metadata TEXT)'
+    ],
+    [
+        'summaries',
+        'CREATE TABLE summaries (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, branch_id TEXT, root_thought_id TEXT NOT NULL, covered_ids TEXT NOT NULL, covered_range_start INTEGER NOT NULL, covered_range_end INTEGER NOT NULL, topics TEXT NOT NULL, aggregate_confidence REAL NOT NULL, created_at INTEGER NOT NULL, meta TEXT)'
+    ]
+]);
+const LEGACY_INDEXES = new Map([
+    [
+        'idx_thoughts_created_at',
+        'CREATE INDEX idx_thoughts_created_at ON thoughts(created_at)'
+    ],
+    [
+        'idx_edges_session',
+        'CREATE INDEX idx_edges_session ON edges(session_id)'
+    ],
+    [
+        'idx_edges_from',
+        'CREATE INDEX idx_edges_from ON edges(session_id, from_id)'
+    ],
+    [
+        'idx_edges_to',
+        'CREATE INDEX idx_edges_to ON edges(session_id, to_id)'
+    ],
+    [
+        'idx_summaries_session',
+        'CREATE INDEX idx_summaries_session ON summaries(session_id)'
+    ]
+]);
+function normalizeSql(sql) {
+    return sql.replace(/\s+/g, ' ').replace(/;$/, '').trim().toLowerCase();
+}
+function readObject(value, sourcePath) {
+    if ('object' != typeof value || null === value) throw new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master row');
+    const type = 'type' in value ? value.type : void 0;
+    const name = 'name' in value ? value.name : void 0;
+    const sql = 'sql' in value ? value.sql : void 0;
+    if ('string' != typeof type || 'string' != typeof name || 'string' != typeof sql) throw new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master fields');
+    return {
+        type,
+        name,
+        sql
+    };
+}
+function validateSqliteV1Schema(database, sourcePath) {
+    const objects = database.prepare("SELECT type, name, sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%' ORDER BY type, name").all().map((row)=>readObject(row, sourcePath));
+    const hasBranches = objects.some(({ type, name })=>'table' === type && 'branches' === name);
+    const expected = new Map();
+    for (const [name, sql] of LEGACY_TABLES)if ('branches' !== name || hasBranches) expected.set(`table:${name}`, normalizeSql(sql));
+    for (const [name, sql] of LEGACY_INDEXES)expected.set(`index:${name}`, normalizeSql(sql));
+    if (objects.length !== expected.size) throw new PersistenceCompatibilityError(sourcePath, 'SQLite v1 object set does not match');
+    for (const object of objects){
+        const expectedSql = expected.get(`${object.type}:${object.name}`);
+        if (void 0 === expectedSql || normalizeSql(object.sql) !== expectedSql) throw new PersistenceCompatibilityError(sourcePath, `SQLite v1 drift at '${object.name}'`);
+    }
+    return hasBranches;
+}
+export { validateSqliteV1Schema };
+
+//# sourceMappingURL=SqliteLegacySchema.js.map

package/dist/persistence/SqliteLegacySchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqliteLegacySchema.js","sources":["../../src/persistence/SqliteLegacySchema.ts"],"sourcesContent":["import { PersistenceCompatibilityError } from '../errors.js';\nimport type { SqliteDatabase } from './SqliteDriver.js';\n\ntype LegacySchemaObject = {\n\treadonly type: string;\n\treadonly name: string;\n\treadonly sql: string;\n};\n\nconst LEGACY_TABLES = new Map<string, string>([\n\t[\n\t\t'thoughts',\n\t\t\"CREATE TABLE thoughts (id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT NOT NULL, created_at INTEGER DEFAULT (strftime('%s', 'now')))\",\n\t],\n\t[\n\t\t'branches',\n\t\t\"CREATE TABLE branches (branch_id TEXT PRIMARY KEY, data TEXT NOT NULL, updated_at INTEGER DEFAULT (strftime('%s', 'now')))\",\n\t],\n\t[\n\t\t'edges',\n\t\t'CREATE TABLE edges (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, from_id TEXT NOT NULL, to_id TEXT NOT NULL, kind TEXT NOT NULL, created_at INTEGER NOT NULL, metadata TEXT)',\n\t],\n\t[\n\t\t'summaries',\n\t\t'CREATE TABLE summaries (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, branch_id TEXT, root_thought_id TEXT NOT NULL, covered_ids TEXT NOT NULL, covered_range_start INTEGER NOT NULL, covered_range_end INTEGER NOT NULL, topics TEXT NOT NULL, aggregate_confidence REAL NOT NULL, created_at INTEGER NOT NULL, meta TEXT)',\n\t],\n]);\n\nconst LEGACY_INDEXES = new Map<string, string>([\n\t['idx_thoughts_created_at', 'CREATE INDEX idx_thoughts_created_at ON thoughts(created_at)'],\n\t['idx_edges_session', 'CREATE INDEX idx_edges_session ON edges(session_id)'],\n\t['idx_edges_from', 'CREATE INDEX idx_edges_from ON edges(session_id, from_id)'],\n\t['idx_edges_to', 'CREATE INDEX idx_edges_to ON edges(session_id, to_id)'],\n\t['idx_summaries_session', 'CREATE INDEX idx_summaries_session ON summaries(session_id)'],\n]);\n\nfunction normalizeSql(sql: string): string {\n\treturn sql.replace(/\\s+/g, ' ').replace(/;$/, '').trim().toLowerCase();\n}\n\nfunction readObject(value: unknown, sourcePath: string): LegacySchemaObject {\n\tif (typeof value !== 'object' || value === null) {\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master row');\n\t}\n\tconst type = 'type' in value ? value.type : undefined;\n\tconst name = 'name' in value ? value.name : undefined;\n\tconst sql = 'sql' in value ? value.sql : undefined;\n\tif (typeof type !== 'string' || typeof name !== 'string' || typeof sql !== 'string') {\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master fields');\n\t}\n\treturn { type, name, sql };\n}\n\n/**\n * Validates the frozen, unversioned SQLite v1 schema without mutating it.\n *\n * @param database - Read-only source database.\n * @param sourcePath - Source name used by typed compatibility errors.\n * @returns Whether the optional legacy branches table is present.\n *\n * @example\n * ```ts\n * const hasBranches = validateSqliteV1Schema(database, 'legacy.db');\n * ```\n */\nexport function validateSqliteV1Schema(database: SqliteDatabase, sourcePath: string): boolean {\n\tconst objects = database\n\t\t.prepare(\n\t\t\t\"SELECT type, name, sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%' ORDER BY type, name\"\n\t\t)\n\t\t.all()\n\t\t.map((row) => readObject(row, sourcePath));\n\tconst hasBranches = objects.some(({ type, name }) => type === 'table' && name === 'branches');\n\tconst expected = new Map<string, string>();\n\tfor (const [name, sql] of LEGACY_TABLES) {\n\t\tif (name !== 'branches' || hasBranches) expected.set(`table:${name}`, normalizeSql(sql));\n\t}\n\tfor (const [name, sql] of LEGACY_INDEXES) expected.set(`index:${name}`, normalizeSql(sql));\n\tif (objects.length !== expected.size) {\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'SQLite v1 object set does not match');\n\t}\n\tfor (const object of objects) {\n\t\tconst expectedSql = expected.get(`${object.type}:${object.name}`);\n\t\tif (expectedSql === undefined || normalizeSql(object.sql) !== expectedSql) {\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, `SQLite v1 drift at '${object.name}'`);\n\t\t}\n\t}\n\treturn hasBranches;\n}\n"],"names":["LEGACY_TABLES","Map","LEGACY_INDEXES","normalizeSql","sql","readObject","value","sourcePath","PersistenceCompatibilityError","type","undefined","name","validateSqliteV1Schema","database","objects","row","hasBranches","expected","object","expectedSql"],"mappings":";AASA,MAAMA,gBAAgB,IAAIC,IAAoB;IAC7C;QACC;QACA;KACA;IACD;QACC;QACA;KACA;IACD;QACC;QACA;KACA;IACD;QACC;QACA;KACA;CACD;AAED,MAAMC,iBAAiB,IAAID,IAAoB;IAC9C;QAAC;QAA2B;KAA+D;IAC3F;QAAC;QAAqB;KAAsD;IAC5E;QAAC;QAAkB;KAA4D;IAC/E;QAAC;QAAgB;KAAwD;IACzE;QAAC;QAAyB;KAA8D;CACxF;AAED,SAASE,aAAaC,GAAW;IAChC,OAAOA,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,WAAW;AACrE;AAEA,SAASC,WAAWC,KAAc,EAAEC,UAAkB;IACrD,IAAI,AAAiB,YAAjB,OAAOD,SAAsBA,AAAU,SAAVA,OAChC,MAAM,IAAIE,8BAA8BD,YAAY;IAErD,MAAME,OAAO,UAAUH,QAAQA,MAAM,IAAI,GAAGI;IAC5C,MAAMC,OAAO,UAAUL,QAAQA,MAAM,IAAI,GAAGI;IAC5C,MAAMN,MAAM,SAASE,QAAQA,MAAM,GAAG,GAAGI;IACzC,IAAI,AAAgB,YAAhB,OAAOD,QAAqB,AAAgB,YAAhB,OAAOE,QAAqB,AAAe,YAAf,OAAOP,KAClE,MAAM,IAAII,8BAA8BD,YAAY;IAErD,OAAO;QAAEE;QAAME;QAAMP;IAAI;AAC1B;AAcO,SAASQ,uBAAuBC,QAAwB,EAAEN,UAAkB;IAClF,MAAMO,UAAUD,SACd,OAAO,CACP,gGAEA,GAAG,GACH,GAAG,CAAC,CAACE,MAAQV,WAAWU,KAAKR;IAC/B,MAAMS,cAAcF,QAAQ,IAAI,CAAC,CAAC,EAAEL,IAAI,EAAEE,IAAI,EAAE,GAAKF,AAAS,YAATA,QAAoBE,AAAS,eAATA;IACzE,MAAMM,WAAW,IAAIhB;IACrB,KAAK,MAAM,CAACU,MAAMP,IAAI,IAAIJ,cACzB,IAAIW,AAAS,eAATA,QAAuBK,aAAaC,SAAS,GAAG,CAAC,CAAC,MAAM,EAAEN,MAAM,EAAER,aAAaC;IAEpF,KAAK,MAAM,CAACO,MAAMP,IAAI,IAAIF,eAAgBe,SAAS,GAAG,CAAC,CAAC,MAAM,EAAEN,MAAM,EAAER,aAAaC;IACrF,IAAIU,QAAQ,MAAM,KAAKG,SAAS,IAAI,EACnC,MAAM,IAAIT,8BAA8BD,YAAY;IAErD,KAAK,MAAMW,UAAUJ,QAAS;QAC7B,MAAMK,cAAcF,SAAS,GAAG,CAAC,GAAGC,OAAO,IAAI,CAAC,CAAC,EAAEA,OAAO,IAAI,EAAE;QAChE,IAAIC,AAAgBT,WAAhBS,eAA6BhB,aAAae,OAAO,GAAG,MAAMC,aAC7D,MAAM,IAAIX,8BAA8BD,YAAY,CAAC,oBAAoB,EAAEW,OAAO,IAAI,CAAC,CAAC,CAAC;IAE3F;IACA,OAAOF;AACR"}

package/dist/persistence/SqlitePayload.d.ts

@@ -0,0 +1,11 @@
+import type { Summary } from '../core/compression/Summary.js';
+import type { Edge } from '../core/graph/Edge.js';
+import type { ThoughtData } from '../core/thought.js';
+export declare function stringField(row: unknown, key: string, sourcePath: string): string;
+export declare function nullableStringField(row: unknown, key: string, sourcePath: string): string | null;
+export declare function numberField(row: unknown, key: string, sourcePath: string): number;
+export declare function parseSqliteJson(json: string, sourcePath: string): unknown;
+export declare function decodeThoughtRow(row: unknown, sourcePath: string): ThoughtData;
+export declare function decodeEdgeRow(row: unknown, sourcePath: string): Edge;
+export declare function decodeSummaryRow(row: unknown, sourcePath: string): Summary;
+//# sourceMappingURL=SqlitePayload.d.ts.map

package/dist/persistence/SqlitePayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlitePayload.d.ts","sourceRoot":"","sources":["../../src/persistence/SqlitePayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMjF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CASjF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAU9E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAgBpE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CA0B1E"}

package/dist/persistence/SqlitePayload.js

@@ -0,0 +1,86 @@
+import { PersistenceCorruptionError } from "../errors.js";
+import { parseEdge, parseSummary, parseThoughtData } from "./PersistenceCodec.js";
+function field(row, key, sourcePath) {
+    if ('object' != typeof row || null === row || !(key in row)) throw new PersistenceCorruptionError(sourcePath, new TypeError(`missing column '${key}'`));
+    return Object.getOwnPropertyDescriptor(row, key)?.value;
+}
+function stringField(row, key, sourcePath) {
+    const value = field(row, key, sourcePath);
+    if ('string' != typeof value) throw new PersistenceCorruptionError(sourcePath, new TypeError(`column '${key}' is not text`));
+    return value;
+}
+function nullableStringField(row, key, sourcePath) {
+    const value = field(row, key, sourcePath);
+    if (null !== value && 'string' != typeof value) throw new PersistenceCorruptionError(sourcePath, new TypeError(`column '${key}' is not nullable text`));
+    return value;
+}
+function numberField(row, key, sourcePath) {
+    const value = field(row, key, sourcePath);
+    if ('number' != typeof value || !Number.isFinite(value)) throw new PersistenceCorruptionError(sourcePath, new TypeError(`column '${key}' is not numeric`));
+    return value;
+}
+function parseSqliteJson(json, sourcePath) {
+    try {
+        return JSON.parse(json);
+    } catch (error) {
+        throw new PersistenceCorruptionError(sourcePath, error);
+    }
+}
+function decodeThoughtRow(row, sourcePath) {
+    try {
+        return parseThoughtData(parseSqliteJson(stringField(row, 'data', sourcePath), sourcePath), sourcePath);
+    } catch (error) {
+        if (error instanceof PersistenceCorruptionError) throw error;
+        throw new PersistenceCorruptionError(sourcePath, error);
+    }
+}
+function decodeEdgeRow(row, sourcePath) {
+    const metadata = nullableStringField(row, 'metadata', sourcePath);
+    try {
+        return parseEdge({
+            id: stringField(row, 'id', sourcePath),
+            sessionId: stringField(row, 'session_id', sourcePath),
+            from: stringField(row, 'from_id', sourcePath),
+            to: stringField(row, 'to_id', sourcePath),
+            kind: stringField(row, 'kind', sourcePath),
+            createdAt: numberField(row, 'created_at', sourcePath),
+            ...null === metadata ? {} : {
+                metadata: parseSqliteJson(metadata, sourcePath)
+            }
+        });
+    } catch (error) {
+        if (error instanceof PersistenceCorruptionError) throw error;
+        throw new PersistenceCorruptionError(sourcePath, error);
+    }
+}
+function decodeSummaryRow(row, sourcePath) {
+    const branchId = nullableStringField(row, 'branch_id', sourcePath);
+    const meta = nullableStringField(row, 'meta', sourcePath);
+    try {
+        return parseSummary({
+            id: stringField(row, 'id', sourcePath),
+            sessionId: stringField(row, 'session_id', sourcePath),
+            ...null === branchId ? {} : {
+                branchId
+            },
+            rootThoughtId: stringField(row, 'root_thought_id', sourcePath),
+            coveredIds: parseSqliteJson(stringField(row, 'covered_ids', sourcePath), sourcePath),
+            coveredRange: [
+                numberField(row, 'covered_range_start', sourcePath),
+                numberField(row, 'covered_range_end', sourcePath)
+            ],
+            topics: parseSqliteJson(stringField(row, 'topics', sourcePath), sourcePath),
+            aggregateConfidence: numberField(row, 'aggregate_confidence', sourcePath),
+            createdAt: numberField(row, 'created_at', sourcePath),
+            ...null === meta ? {} : {
+                meta: parseSqliteJson(meta, sourcePath)
+            }
+        }, sourcePath);
+    } catch (error) {
+        if (error instanceof PersistenceCorruptionError) throw error;
+        throw new PersistenceCorruptionError(sourcePath, error);
+    }
+}
+export { decodeEdgeRow, decodeSummaryRow, decodeThoughtRow, nullableStringField, numberField, parseSqliteJson, stringField };
+
+//# sourceMappingURL=SqlitePayload.js.map

package/dist/persistence/SqlitePayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqlitePayload.js","sources":["../../src/persistence/SqlitePayload.ts"],"sourcesContent":["import type { Summary } from '../core/compression/Summary.js';\nimport type { Edge } from '../core/graph/Edge.js';\nimport type { ThoughtData } from '../core/thought.js';\nimport { PersistenceCorruptionError } from '../errors.js';\nimport { parseEdge, parseSummary, parseThoughtData } from './PersistenceCodec.js';\n\nfunction field(row: unknown, key: string, sourcePath: string): unknown {\n\tif (typeof row !== 'object' || row === null || !(key in row)) {\n\t\tthrow new PersistenceCorruptionError(sourcePath, new TypeError(`missing column '${key}'`));\n\t}\n\treturn Object.getOwnPropertyDescriptor(row, key)?.value;\n}\n\nexport function stringField(row: unknown, key: string, sourcePath: string): string {\n\tconst value = field(row, key, sourcePath);\n\tif (typeof value !== 'string') {\n\t\tthrow new PersistenceCorruptionError(sourcePath, new TypeError(`column '${key}' is not text`));\n\t}\n\treturn value;\n}\n\nexport function nullableStringField(row: unknown, key: string, sourcePath: string): string | null {\n\tconst value = field(row, key, sourcePath);\n\tif (value !== null && typeof value !== 'string') {\n\t\tthrow new PersistenceCorruptionError(\n\t\t\tsourcePath,\n\t\t\tnew TypeError(`column '${key}' is not nullable text`)\n\t\t);\n\t}\n\treturn value;\n}\n\nexport function numberField(row: unknown, key: string, sourcePath: string): number {\n\tconst value = field(row, key, sourcePath);\n\tif (typeof value !== 'number' || !Number.isFinite(value)) {\n\t\tthrow new PersistenceCorruptionError(\n\t\t\tsourcePath,\n\t\t\tnew TypeError(`column '${key}' is not numeric`)\n\t\t);\n\t}\n\treturn value;\n}\n\nexport function parseSqliteJson(json: string, sourcePath: string): unknown {\n\ttry {\n\t\treturn JSON.parse(json);\n\t} catch (error) {\n\t\tthrow new PersistenceCorruptionError(sourcePath, error);\n\t}\n}\n\nexport function decodeThoughtRow(row: unknown, sourcePath: string): ThoughtData {\n\ttry {\n\t\treturn parseThoughtData(\n\t\t\tparseSqliteJson(stringField(row, 'data', sourcePath), sourcePath),\n\t\t\tsourcePath\n\t\t);\n\t} catch (error) {\n\t\tif (error instanceof PersistenceCorruptionError) throw error;\n\t\tthrow new PersistenceCorruptionError(sourcePath, error);\n\t}\n}\n\nexport function decodeEdgeRow(row: unknown, sourcePath: string): Edge {\n\tconst metadata = nullableStringField(row, 'metadata', sourcePath);\n\ttry {\n\t\treturn parseEdge({\n\t\t\tid: stringField(row, 'id', sourcePath),\n\t\t\tsessionId: stringField(row, 'session_id', sourcePath),\n\t\t\tfrom: stringField(row, 'from_id', sourcePath),\n\t\t\tto: stringField(row, 'to_id', sourcePath),\n\t\t\tkind: stringField(row, 'kind', sourcePath),\n\t\t\tcreatedAt: numberField(row, 'created_at', sourcePath),\n\t\t\t...(metadata === null ? {} : { metadata: parseSqliteJson(metadata, sourcePath) }),\n\t\t});\n\t} catch (error) {\n\t\tif (error instanceof PersistenceCorruptionError) throw error;\n\t\tthrow new PersistenceCorruptionError(sourcePath, error);\n\t}\n}\n\nexport function decodeSummaryRow(row: unknown, sourcePath: string): Summary {\n\tconst branchId = nullableStringField(row, 'branch_id', sourcePath);\n\tconst meta = nullableStringField(row, 'meta', sourcePath);\n\ttry {\n\t\treturn parseSummary(\n\t\t\t{\n\t\t\t\tid: stringField(row, 'id', sourcePath),\n\t\t\t\tsessionId: stringField(row, 'session_id', sourcePath),\n\t\t\t\t...(branchId === null ? {} : { branchId }),\n\t\t\t\trootThoughtId: stringField(row, 'root_thought_id', sourcePath),\n\t\t\t\tcoveredIds: parseSqliteJson(stringField(row, 'covered_ids', sourcePath), sourcePath),\n\t\t\t\tcoveredRange: [\n\t\t\t\t\tnumberField(row, 'covered_range_start', sourcePath),\n\t\t\t\t\tnumberField(row, 'covered_range_end', sourcePath),\n\t\t\t\t],\n\t\t\t\ttopics: parseSqliteJson(stringField(row, 'topics', sourcePath), sourcePath),\n\t\t\t\taggregateConfidence: numberField(row, 'aggregate_confidence', sourcePath),\n\t\t\t\tcreatedAt: numberField(row, 'created_at', sourcePath),\n\t\t\t\t...(meta === null ? {} : { meta: parseSqliteJson(meta, sourcePath) }),\n\t\t\t},\n\t\t\tsourcePath\n\t\t);\n\t} catch (error) {\n\t\tif (error instanceof PersistenceCorruptionError) throw error;\n\t\tthrow new PersistenceCorruptionError(sourcePath, error);\n\t}\n}\n"],"names":["field","row","key","sourcePath","PersistenceCorruptionError","TypeError","Object","stringField","value","nullableStringField","numberField","Number","parseSqliteJson","json","JSON","error","decodeThoughtRow","parseThoughtData","decodeEdgeRow","metadata","parseEdge","decodeSummaryRow","branchId","meta","parseSummary"],"mappings":";;AAMA,SAASA,MAAMC,GAAY,EAAEC,GAAW,EAAEC,UAAkB;IAC3D,IAAI,AAAe,YAAf,OAAOF,OAAoBA,AAAQ,SAARA,OAAgB,CAAEC,CAAAA,OAAOD,GAAE,GACzD,MAAM,IAAIG,2BAA2BD,YAAY,IAAIE,UAAU,CAAC,gBAAgB,EAAEH,IAAI,CAAC,CAAC;IAEzF,OAAOI,OAAO,wBAAwB,CAACL,KAAKC,MAAM;AACnD;AAEO,SAASK,YAAYN,GAAY,EAAEC,GAAW,EAAEC,UAAkB;IACxE,MAAMK,QAAQR,MAAMC,KAAKC,KAAKC;IAC9B,IAAI,AAAiB,YAAjB,OAAOK,OACV,MAAM,IAAIJ,2BAA2BD,YAAY,IAAIE,UAAU,CAAC,QAAQ,EAAEH,IAAI,aAAa,CAAC;IAE7F,OAAOM;AACR;AAEO,SAASC,oBAAoBR,GAAY,EAAEC,GAAW,EAAEC,UAAkB;IAChF,MAAMK,QAAQR,MAAMC,KAAKC,KAAKC;IAC9B,IAAIK,AAAU,SAAVA,SAAkB,AAAiB,YAAjB,OAAOA,OAC5B,MAAM,IAAIJ,2BACTD,YACA,IAAIE,UAAU,CAAC,QAAQ,EAAEH,IAAI,sBAAsB,CAAC;IAGtD,OAAOM;AACR;AAEO,SAASE,YAAYT,GAAY,EAAEC,GAAW,EAAEC,UAAkB;IACxE,MAAMK,QAAQR,MAAMC,KAAKC,KAAKC;IAC9B,IAAI,AAAiB,YAAjB,OAAOK,SAAsB,CAACG,OAAO,QAAQ,CAACH,QACjD,MAAM,IAAIJ,2BACTD,YACA,IAAIE,UAAU,CAAC,QAAQ,EAAEH,IAAI,gBAAgB,CAAC;IAGhD,OAAOM;AACR;AAEO,SAASI,gBAAgBC,IAAY,EAAEV,UAAkB;IAC/D,IAAI;QACH,OAAOW,KAAK,KAAK,CAACD;IACnB,EAAE,OAAOE,OAAO;QACf,MAAM,IAAIX,2BAA2BD,YAAYY;IAClD;AACD;AAEO,SAASC,iBAAiBf,GAAY,EAAEE,UAAkB;IAChE,IAAI;QACH,OAAOc,iBACNL,gBAAgBL,YAAYN,KAAK,QAAQE,aAAaA,aACtDA;IAEF,EAAE,OAAOY,OAAO;QACf,IAAIA,iBAAiBX,4BAA4B,MAAMW;QACvD,MAAM,IAAIX,2BAA2BD,YAAYY;IAClD;AACD;AAEO,SAASG,cAAcjB,GAAY,EAAEE,UAAkB;IAC7D,MAAMgB,WAAWV,oBAAoBR,KAAK,YAAYE;IACtD,IAAI;QACH,OAAOiB,UAAU;YAChB,IAAIb,YAAYN,KAAK,MAAME;YAC3B,WAAWI,YAAYN,KAAK,cAAcE;YAC1C,MAAMI,YAAYN,KAAK,WAAWE;YAClC,IAAII,YAAYN,KAAK,SAASE;YAC9B,MAAMI,YAAYN,KAAK,QAAQE;YAC/B,WAAWO,YAAYT,KAAK,cAAcE;YAC1C,GAAIgB,AAAa,SAAbA,WAAoB,CAAC,IAAI;gBAAE,UAAUP,gBAAgBO,UAAUhB;YAAY,CAAC;QACjF;IACD,EAAE,OAAOY,OAAO;QACf,IAAIA,iBAAiBX,4BAA4B,MAAMW;QACvD,MAAM,IAAIX,2BAA2BD,YAAYY;IAClD;AACD;AAEO,SAASM,iBAAiBpB,GAAY,EAAEE,UAAkB;IAChE,MAAMmB,WAAWb,oBAAoBR,KAAK,aAAaE;IACvD,MAAMoB,OAAOd,oBAAoBR,KAAK,QAAQE;IAC9C,IAAI;QACH,OAAOqB,aACN;YACC,IAAIjB,YAAYN,KAAK,MAAME;YAC3B,WAAWI,YAAYN,KAAK,cAAcE;YAC1C,GAAImB,AAAa,SAAbA,WAAoB,CAAC,IAAI;gBAAEA;YAAS,CAAC;YACzC,eAAef,YAAYN,KAAK,mBAAmBE;YACnD,YAAYS,gBAAgBL,YAAYN,KAAK,eAAeE,aAAaA;YACzE,cAAc;gBACbO,YAAYT,KAAK,uBAAuBE;gBACxCO,YAAYT,KAAK,qBAAqBE;aACtC;YACD,QAAQS,gBAAgBL,YAAYN,KAAK,UAAUE,aAAaA;YAChE,qBAAqBO,YAAYT,KAAK,wBAAwBE;YAC9D,WAAWO,YAAYT,KAAK,cAAcE;YAC1C,GAAIoB,AAAS,SAATA,OAAgB,CAAC,IAAI;gBAAE,MAAMX,gBAAgBW,MAAMpB;YAAY,CAAC;QACrE,GACAA;IAEF,EAAE,OAAOY,OAAO;QACf,IAAIA,iBAAiBX,4BAA4B,MAAMW;QACvD,MAAM,IAAIX,2BAA2BD,YAAYY;IAClD;AACD"}

package/dist/persistence/SqlitePersistence.d.ts

@@ -0,0 +1,49 @@
+import type { PersistenceConfig, SessionScopedPersistenceBackend } from '../contracts/PersistenceBackend.js';
+import { type BranchId, type SessionId } from '../contracts/ids.js';
+import type { Summary } from '../core/compression/Summary.js';
+import type { Edge } from '../core/graph/Edge.js';
+import type { ThoughtData } from '../core/thought.js';
+import type { SqliteDatabase } from './SqliteDriver.js';
+type SqliteOptions = PersistenceConfig['options'];
+export declare class SqlitePersistence implements SessionScopedPersistenceBackend {
+    private readonly _db;
+    private readonly _sourcePath;
+    private readonly _maxHistorySize;
+    private readonly _persistBranches;
+    private constructor();
+    static createWithDatabase(database: SqliteDatabase, options?: SqliteOptions, sourcePath?: string): SqlitePersistence;
+    static create(options?: SqliteOptions): Promise<SqlitePersistence>;
+    saveThought(thought: ThoughtData): Promise<void>;
+    saveThoughtForSession(sessionId: SessionId, thought: ThoughtData): Promise<void>;
+    private _saveThought;
+    loadHistory(): Promise<ThoughtData[]>;
+    loadHistoryForSession(sessionId: SessionId): Promise<ThoughtData[]>;
+    saveBranch(branchId: BranchId, thoughts: ThoughtData[]): Promise<void>;
+    saveBranchForSession(sessionId: SessionId, branchId: BranchId, thoughts: readonly ThoughtData[]): Promise<void>;
+    private _saveBranch;
+    deleteBranch(branchId: BranchId): Promise<void>;
+    deleteBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<void>;
+    loadBranch(branchId: BranchId): Promise<ThoughtData[] | undefined>;
+    loadBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<ThoughtData[] | undefined>;
+    listBranches(): Promise<BranchId[]>;
+    listBranchesForSession(sessionId: SessionId): Promise<BranchId[]>;
+    listSessions(): Promise<SessionId[]>;
+    clear(): Promise<void>;
+    clearSession(sessionId: SessionId): Promise<void>;
+    saveEdges(sessionId: SessionId, edges: readonly Edge[]): Promise<void>;
+    loadEdges(sessionId: SessionId): Promise<Edge[]>;
+    listEdgeSessions(): Promise<SessionId[]>;
+    saveSummaries(sessionId: SessionId, summaries: readonly Summary[]): Promise<void>;
+    loadSummaries(sessionId: SessionId): Promise<Summary[]>;
+    healthy(): Promise<boolean>;
+    close(): Promise<void>;
+    getStats(): {
+        readonly thoughtCount: number;
+        readonly branchCount: number;
+        readonly dbSize: number;
+    };
+    private _loadValidatedThoughtState;
+    private loadHistoryRows;
+}
+export {};
+//# sourceMappingURL=SqlitePersistence.d.ts.map

package/dist/persistence/SqlitePersistence.d.ts.map

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