@iworkforces/tracelattice 2.0.3

package/dist/persistence/SqlitePersistence.js

@@ -0,0 +1,248 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { GLOBAL_SESSION_ID, asSessionId } from "../contracts/ids.js";
+import { PersistenceCompatibilityError, PersistenceCorruptionError } from "../errors.js";
+import { runSqliteReadTransaction, runSqliteTransaction } from "./SqliteDriver.js";
+import { decodeEdgeRow, decodeSummaryRow, decodeThoughtRow, numberField, stringField } from "./SqlitePayload.js";
+import { assertBranchScope, assertEdgeScopes, assertPersistableThoughtCollections, assertPersistableThoughts, assertSummaryScopes, assertThoughtScope, compareCodePoint, parsePersistenceBranchId } from "./PersistenceScope.js";
+import { initializeOrValidateSqliteV2 } from "./SqliteSchemaV2.js";
+class SqlitePersistence {
+    _db;
+    _sourcePath;
+    _maxHistorySize;
+    _persistBranches;
+    constructor(_db, _sourcePath, _maxHistorySize, _persistBranches){
+        this._db = _db;
+        this._sourcePath = _sourcePath;
+        this._maxHistorySize = _maxHistorySize;
+        this._persistBranches = _persistBranches;
+    }
+    static createWithDatabase(database, options = {}, sourcePath = '<structural-sqlite>') {
+        initializeOrValidateSqliteV2(database, sourcePath);
+        return new SqlitePersistence(database, sourcePath, options?.maxHistorySize ?? 10000, options?.persistBranches ?? true);
+    }
+    static async create(options) {
+        const defaultDataDir = existsSync('.claude/data') ? '.claude/data' : join(homedir(), '.claude/data');
+        const dbPath = options?.dbPath ?? join(defaultDataDir, 'history.db');
+        let Database;
+        try {
+            const module = await import("better-sqlite3");
+            Database = module.default;
+        } catch (error) {
+            throw new PersistenceCompatibilityError(dbPath, "SQLite persistence requires the optional 'better-sqlite3' package", error);
+        }
+        const database = new Database(dbPath);
+        try {
+            const persistence = SqlitePersistence.createWithDatabase(database, options, dbPath);
+            if (options?.enableWAL !== false) database.pragma('journal_mode = WAL');
+            database.pragma('synchronous = NORMAL');
+            database.pragma('foreign_keys = ON');
+            database.pragma('busy_timeout = 5000');
+            database.pragma('cache_size = -64000');
+            database.pragma('temp_store = MEMORY');
+            return persistence;
+        } catch (error) {
+            database.close();
+            throw error;
+        }
+    }
+    async saveThought(thought) {
+        assertThoughtScope('saveThought', GLOBAL_SESSION_ID, thought);
+        this._saveThought(GLOBAL_SESSION_ID, thought);
+    }
+    async saveThoughtForSession(sessionId, thought) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertThoughtScope('saveThoughtForSession', validatedSessionId, thought);
+        this._saveThought(validatedSessionId, thought);
+    }
+    _saveThought(sessionId, thought) {
+        runSqliteTransaction(this._db, ()=>{
+            this._loadValidatedThoughtState(sessionId, [
+                thought
+            ]);
+            this._db.prepare('INSERT INTO thoughts (session_id, data) VALUES (?, ?)').run(sessionId, JSON.stringify(thought));
+            if (this._maxHistorySize > 0) {
+                const countRow = this._db.prepare('SELECT COUNT(*) AS count FROM thoughts WHERE session_id = ?').get(sessionId);
+                const excess = numberField(countRow, 'count', `${this._sourcePath}:thought-count`) - this._maxHistorySize;
+                if (excess > 0) this._db.prepare('DELETE FROM thoughts WHERE id IN (SELECT id FROM thoughts WHERE session_id = ? ORDER BY id ASC LIMIT ?)').run(sessionId, excess);
+            }
+        });
+    }
+    async loadHistory() {
+        return await this.loadHistoryForSession(GLOBAL_SESSION_ID);
+    }
+    async loadHistoryForSession(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return runSqliteReadTransaction(this._db, ()=>this._loadValidatedThoughtState(validatedSessionId).history);
+    }
+    async saveBranch(branchId, thoughts) {
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);
+        assertBranchScope('saveBranch', GLOBAL_SESSION_ID, validatedBranchId, thoughts);
+        this._saveBranch(GLOBAL_SESSION_ID, validatedBranchId, thoughts);
+    }
+    async saveBranchForSession(sessionId, branchId, thoughts) {
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);
+        assertBranchScope('saveBranchForSession', validatedSessionId, validatedBranchId, thoughts);
+        this._saveBranch(validatedSessionId, validatedBranchId, thoughts);
+    }
+    _saveBranch(sessionId, branchId, thoughts) {
+        assertPersistableThoughts(thoughts, `${this._sourcePath}:branch:${branchId}`);
+        if (!this._persistBranches) return void runSqliteReadTransaction(this._db, ()=>this._loadValidatedThoughtState(sessionId, thoughts, branchId));
+        runSqliteTransaction(this._db, ()=>{
+            this._loadValidatedThoughtState(sessionId, thoughts, branchId);
+            this._db.prepare('INSERT OR REPLACE INTO branches (session_id, branch_id, data) VALUES (?, ?, ?)').run(sessionId, branchId, JSON.stringify(thoughts));
+        });
+    }
+    async deleteBranch(branchId) {
+        await this.deleteBranchForSession(GLOBAL_SESSION_ID, branchId);
+    }
+    async deleteBranchForSession(sessionId, branchId) {
+        if (!this._persistBranches) return;
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);
+        runSqliteTransaction(this._db, ()=>{
+            this._db.prepare('DELETE FROM branches WHERE session_id = ? AND branch_id = ?').run(validatedSessionId, validatedBranchId);
+        });
+    }
+    async loadBranch(branchId) {
+        return await this.loadBranchForSession(GLOBAL_SESSION_ID, branchId);
+    }
+    async loadBranchForSession(sessionId, branchId) {
+        if (!this._persistBranches) return;
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);
+        return runSqliteReadTransaction(this._db, ()=>this._loadValidatedThoughtState(validatedSessionId).branches.get(validatedBranchId));
+    }
+    async listBranches() {
+        return await this.listBranchesForSession(GLOBAL_SESSION_ID);
+    }
+    async listBranchesForSession(sessionId) {
+        if (!this._persistBranches) return [];
+        return this._db.prepare('SELECT branch_id FROM branches WHERE session_id = ? ORDER BY branch_id ASC').all(asSessionId(sessionId)).map((row)=>parsePersistenceBranchId(stringField(row, 'branch_id', this._sourcePath), this._sourcePath));
+    }
+    async listSessions() {
+        return this._db.prepare('SELECT session_id FROM thoughts UNION SELECT session_id FROM branches UNION SELECT session_id FROM edges UNION SELECT session_id FROM summaries').all().map((row)=>asSessionId(stringField(row, 'session_id', this._sourcePath))).sort(compareCodePoint);
+    }
+    async clear() {
+        runSqliteTransaction(this._db, ()=>{
+            for (const table of [
+                'thoughts',
+                'branches',
+                'edges',
+                'summaries'
+            ])this._db.exec(`DELETE FROM ${table}`);
+        });
+    }
+    async clearSession(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        runSqliteTransaction(this._db, ()=>{
+            for (const table of [
+                'thoughts',
+                'branches',
+                'edges',
+                'summaries'
+            ])this._db.prepare(`DELETE FROM ${table} WHERE session_id = ?`).run(validatedSessionId);
+        });
+    }
+    async saveEdges(sessionId, edges) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertEdgeScopes(validatedSessionId, edges);
+        runSqliteTransaction(this._db, ()=>{
+            this._db.prepare('DELETE FROM edges WHERE session_id = ?').run(validatedSessionId);
+            const insert = this._db.prepare('INSERT INTO edges (id, session_id, from_id, to_id, kind, created_at, metadata) VALUES (?, ?, ?, ?, ?, ?, ?)');
+            for (const edge of edges)insert.run(edge.id, edge.sessionId, edge.from, edge.to, edge.kind, edge.createdAt, void 0 === edge.metadata ? null : JSON.stringify(edge.metadata));
+        });
+    }
+    async loadEdges(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return this._db.prepare('SELECT id, session_id, from_id, to_id, kind, created_at, metadata FROM edges WHERE session_id = ? ORDER BY created_at ASC, id ASC').all(validatedSessionId).map((row, index)=>decodeEdgeRow(row, `${this._sourcePath}:edges:${index}`));
+    }
+    async listEdgeSessions() {
+        return this._db.prepare('SELECT DISTINCT session_id FROM edges ORDER BY session_id ASC').all().map((row)=>asSessionId(stringField(row, 'session_id', this._sourcePath)));
+    }
+    async saveSummaries(sessionId, summaries) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertSummaryScopes(validatedSessionId, summaries);
+        runSqliteTransaction(this._db, ()=>{
+            this._db.prepare('DELETE FROM summaries WHERE session_id = ?').run(validatedSessionId);
+            const insert = this._db.prepare('INSERT INTO summaries (id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)');
+            for (const summary of summaries)insert.run(summary.id, summary.sessionId, summary.branchId ?? null, summary.rootThoughtId, JSON.stringify(summary.coveredIds), summary.coveredRange[0], summary.coveredRange[1], JSON.stringify(summary.topics), summary.aggregateConfidence, summary.createdAt, void 0 === summary.meta ? null : JSON.stringify(summary.meta));
+        });
+    }
+    async loadSummaries(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return this._db.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 WHERE session_id = ? ORDER BY created_at ASC, id ASC').all(validatedSessionId).map((row, index)=>decodeSummaryRow(row, `${this._sourcePath}:summaries:${index}`));
+    }
+    async healthy() {
+        try {
+            this._db.prepare('SELECT 1').get();
+            return true;
+        } catch (error) {
+            if (error instanceof Error) return false;
+            throw error;
+        }
+    }
+    async close() {
+        this._db.close();
+    }
+    getStats() {
+        const thoughtCount = numberField(this._db.prepare('SELECT COUNT(*) AS count FROM thoughts').get(), 'count', this._sourcePath);
+        const branchCount = numberField(this._db.prepare('SELECT COUNT(*) AS count FROM branches').get(), 'count', this._sourcePath);
+        return {
+            thoughtCount,
+            branchCount: this._persistBranches ? branchCount : 0,
+            dbSize: 0
+        };
+    }
+    _loadValidatedThoughtState(sessionId, candidates = [], replacingBranch) {
+        const history = this.loadHistoryRows(sessionId);
+        for (const thought of history)assertThoughtScope('saveThoughtForSession', sessionId, thought);
+        const collections = [
+            {
+                sessionId,
+                thoughts: void 0 === replacingBranch ? [
+                    ...history,
+                    ...candidates
+                ] : history
+            }
+        ];
+        const branches = new Map();
+        for (const row of this._db.prepare('SELECT branch_id, data FROM branches WHERE session_id = ?').all(sessionId)){
+            const branchId = parsePersistenceBranchId(stringField(row, 'branch_id', this._sourcePath), this._sourcePath);
+            const data = stringField(row, 'data', this._sourcePath);
+            let values;
+            try {
+                values = JSON.parse(data);
+            } catch (error) {
+                throw new PersistenceCorruptionError(this._sourcePath, error);
+            }
+            if (!Array.isArray(values)) throw new PersistenceCorruptionError(this._sourcePath, new TypeError('branch data is not an array'));
+            const thoughts = values.map((value, index)=>decodeThoughtRow({
+                    data: JSON.stringify(value)
+                }, `${this._sourcePath}:branch:${sessionId}:${branchId}:${index}`));
+            assertBranchScope('saveBranchForSession', sessionId, branchId, thoughts);
+            branches.set(branchId, thoughts);
+            if (branchId !== replacingBranch) collections.push({
+                sessionId,
+                thoughts
+            });
+        }
+        if (void 0 !== replacingBranch) collections.push({
+            sessionId,
+            thoughts: candidates
+        });
+        assertPersistableThoughtCollections(collections, this._sourcePath);
+        return {
+            history,
+            branches
+        };
+    }
+    loadHistoryRows(sessionId) {
+        return this._db.prepare('SELECT data FROM thoughts WHERE session_id = ? ORDER BY id ASC').all(sessionId).map((row)=>decodeThoughtRow(row, this._sourcePath));
+    }
+}
+export { SqlitePersistence };
+
+//# sourceMappingURL=SqlitePersistence.js.map

package/dist/persistence/SqlitePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqlitePersistence.js","sources":["../../src/persistence/SqlitePersistence.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport type {\n\tPersistenceConfig,\n\tSessionScopedPersistenceBackend,\n} from '../contracts/PersistenceBackend.js';\nimport { asSessionId, GLOBAL_SESSION_ID, type BranchId, type SessionId } from '../contracts/ids.js';\nimport type { Summary } from '../core/compression/Summary.js';\nimport type { Edge } from '../core/graph/Edge.js';\nimport type { ThoughtData } from '../core/thought.js';\nimport { PersistenceCompatibilityError, PersistenceCorruptionError } from '../errors.js';\nimport type { SqliteDatabase, SqliteDatabaseConstructor } from './SqliteDriver.js';\nimport { runSqliteReadTransaction, runSqliteTransaction } from './SqliteDriver.js';\nimport {\n\tdecodeEdgeRow,\n\tdecodeSummaryRow,\n\tdecodeThoughtRow,\n\tnumberField,\n\tstringField,\n} from './SqlitePayload.js';\nimport {\n\tassertBranchScope,\n\tassertEdgeScopes,\n\tassertPersistableThoughtCollections,\n\tassertPersistableThoughts,\n\tassertSummaryScopes,\n\tassertThoughtScope,\n\tcompareCodePoint,\n\tparsePersistenceBranchId,\n\ttype PersistedThoughtCollection,\n} from './PersistenceScope.js';\nimport { initializeOrValidateSqliteV2 } from './SqliteSchemaV2.js';\n\ntype SqliteOptions = PersistenceConfig['options'];\n\ntype ValidatedThoughtState = {\n\treadonly history: ThoughtData[];\n\treadonly branches: ReadonlyMap<BranchId, ThoughtData[]>;\n};\n\nexport class SqlitePersistence implements SessionScopedPersistenceBackend {\n\tprivate constructor(\n\t\tprivate readonly _db: SqliteDatabase,\n\t\tprivate readonly _sourcePath: string,\n\t\tprivate readonly _maxHistorySize: number,\n\t\tprivate readonly _persistBranches: boolean\n\t) {}\n\n\tpublic static createWithDatabase(\n\t\tdatabase: SqliteDatabase,\n\t\toptions: SqliteOptions = {},\n\t\tsourcePath = '<structural-sqlite>'\n\t): SqlitePersistence {\n\t\tinitializeOrValidateSqliteV2(database, sourcePath);\n\t\treturn new SqlitePersistence(\n\t\t\tdatabase,\n\t\t\tsourcePath,\n\t\t\toptions?.maxHistorySize ?? 10000,\n\t\t\toptions?.persistBranches ?? true\n\t\t);\n\t}\n\n\tpublic static async create(options?: SqliteOptions): Promise<SqlitePersistence> {\n\t\tconst defaultDataDir = existsSync('.claude/data')\n\t\t\t? '.claude/data'\n\t\t\t: join(homedir(), '.claude/data');\n\t\tconst dbPath = options?.dbPath ?? join(defaultDataDir, 'history.db');\n\t\tlet Database: SqliteDatabaseConstructor;\n\t\ttry {\n\t\t\tconst module = await import('better-sqlite3');\n\t\t\tDatabase = module.default;\n\t\t} catch (error) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tdbPath,\n\t\t\t\t\"SQLite persistence requires the optional 'better-sqlite3' package\",\n\t\t\t\terror\n\t\t\t);\n\t\t}\n\t\tconst database = new Database(dbPath);\n\t\ttry {\n\t\t\tconst persistence = SqlitePersistence.createWithDatabase(database, options, dbPath);\n\t\t\tif (options?.enableWAL !== false) database.pragma('journal_mode = WAL');\n\t\t\tdatabase.pragma('synchronous = NORMAL');\n\t\t\tdatabase.pragma('foreign_keys = ON');\n\t\t\tdatabase.pragma('busy_timeout = 5000');\n\t\t\tdatabase.pragma('cache_size = -64000');\n\t\t\tdatabase.pragma('temp_store = MEMORY');\n\t\t\treturn persistence;\n\t\t} catch (error) {\n\t\t\tdatabase.close();\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tpublic async saveThought(thought: ThoughtData): Promise<void> {\n\t\tassertThoughtScope('saveThought', GLOBAL_SESSION_ID, thought);\n\t\tthis._saveThought(GLOBAL_SESSION_ID, thought);\n\t}\n\n\tpublic async saveThoughtForSession(sessionId: SessionId, thought: ThoughtData): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertThoughtScope('saveThoughtForSession', validatedSessionId, thought);\n\t\tthis._saveThought(validatedSessionId, thought);\n\t}\n\n\tprivate _saveThought(sessionId: SessionId, thought: ThoughtData): void {\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tthis._loadValidatedThoughtState(sessionId, [thought]);\n\t\t\tthis._db\n\t\t\t\t.prepare('INSERT INTO thoughts (session_id, data) VALUES (?, ?)')\n\t\t\t\t.run(sessionId, JSON.stringify(thought));\n\t\t\tif (this._maxHistorySize > 0) {\n\t\t\t\tconst countRow = this._db\n\t\t\t\t\t.prepare('SELECT COUNT(*) AS count FROM thoughts WHERE session_id = ?')\n\t\t\t\t\t.get(sessionId);\n\t\t\t\tconst excess =\n\t\t\t\t\tnumberField(countRow, 'count', `${this._sourcePath}:thought-count`) -\n\t\t\t\t\tthis._maxHistorySize;\n\t\t\t\tif (excess > 0) {\n\t\t\t\t\tthis._db\n\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t'DELETE FROM thoughts WHERE id IN (SELECT id FROM thoughts WHERE session_id = ? ORDER BY id ASC LIMIT ?)'\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.run(sessionId, excess);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t}\n\n\tpublic async loadHistory(): Promise<ThoughtData[]> {\n\t\treturn await this.loadHistoryForSession(GLOBAL_SESSION_ID);\n\t}\n\n\tpublic async loadHistoryForSession(sessionId: SessionId): Promise<ThoughtData[]> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\treturn runSqliteReadTransaction(\n\t\t\tthis._db,\n\t\t\t() => this._loadValidatedThoughtState(validatedSessionId).history\n\t\t);\n\t}\n\n\tpublic async saveBranch(branchId: BranchId, thoughts: ThoughtData[]): Promise<void> {\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);\n\t\tassertBranchScope('saveBranch', GLOBAL_SESSION_ID, validatedBranchId, thoughts);\n\t\tthis._saveBranch(GLOBAL_SESSION_ID, validatedBranchId, thoughts);\n\t}\n\n\tpublic async saveBranchForSession(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId,\n\t\tthoughts: readonly ThoughtData[]\n\t): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);\n\t\tassertBranchScope('saveBranchForSession', validatedSessionId, validatedBranchId, thoughts);\n\t\tthis._saveBranch(validatedSessionId, validatedBranchId, thoughts);\n\t}\n\n\tprivate _saveBranch(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId,\n\t\tthoughts: readonly ThoughtData[]\n\t): void {\n\t\tassertPersistableThoughts(thoughts, `${this._sourcePath}:branch:${branchId}`);\n\t\tif (!this._persistBranches) {\n\t\t\trunSqliteReadTransaction(this._db, () =>\n\t\t\t\tthis._loadValidatedThoughtState(sessionId, thoughts, branchId)\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tthis._loadValidatedThoughtState(sessionId, thoughts, branchId);\n\t\t\tthis._db\n\t\t\t\t.prepare('INSERT OR REPLACE INTO branches (session_id, branch_id, data) VALUES (?, ?, ?)')\n\t\t\t\t.run(sessionId, branchId, JSON.stringify(thoughts));\n\t\t});\n\t}\n\n\tpublic async deleteBranch(branchId: BranchId): Promise<void> {\n\t\tawait this.deleteBranchForSession(GLOBAL_SESSION_ID, branchId);\n\t}\n\n\tpublic async deleteBranchForSession(sessionId: SessionId, branchId: BranchId): Promise<void> {\n\t\tif (!this._persistBranches) return;\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tthis._db\n\t\t\t\t.prepare('DELETE FROM branches WHERE session_id = ? AND branch_id = ?')\n\t\t\t\t.run(validatedSessionId, validatedBranchId);\n\t\t});\n\t}\n\n\tpublic async loadBranch(branchId: BranchId): Promise<ThoughtData[] | undefined> {\n\t\treturn await this.loadBranchForSession(GLOBAL_SESSION_ID, branchId);\n\t}\n\n\tpublic async loadBranchForSession(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId\n\t): Promise<ThoughtData[] | undefined> {\n\t\tif (!this._persistBranches) return undefined;\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, `${this._sourcePath}:branches`);\n\t\treturn runSqliteReadTransaction(this._db, () =>\n\t\t\tthis._loadValidatedThoughtState(validatedSessionId).branches.get(validatedBranchId)\n\t\t);\n\t}\n\n\tpublic async listBranches(): Promise<BranchId[]> {\n\t\treturn await this.listBranchesForSession(GLOBAL_SESSION_ID);\n\t}\n\n\tpublic async listBranchesForSession(sessionId: SessionId): Promise<BranchId[]> {\n\t\tif (!this._persistBranches) return [];\n\t\treturn this._db\n\t\t\t.prepare('SELECT branch_id FROM branches WHERE session_id = ? ORDER BY branch_id ASC')\n\t\t\t.all(asSessionId(sessionId))\n\t\t\t.map((row) =>\n\t\t\t\tparsePersistenceBranchId(stringField(row, 'branch_id', this._sourcePath), this._sourcePath)\n\t\t\t);\n\t}\n\n\tpublic async listSessions(): Promise<SessionId[]> {\n\t\treturn this._db\n\t\t\t.prepare(\n\t\t\t\t'SELECT session_id FROM thoughts UNION SELECT session_id FROM branches UNION SELECT session_id FROM edges UNION SELECT session_id FROM summaries'\n\t\t\t)\n\t\t\t.all()\n\t\t\t.map((row) => asSessionId(stringField(row, 'session_id', this._sourcePath)))\n\t\t\t.sort(compareCodePoint);\n\t}\n\n\tpublic async clear(): Promise<void> {\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tfor (const table of ['thoughts', 'branches', 'edges', 'summaries'])\n\t\t\t\tthis._db.exec(`DELETE FROM ${table}`);\n\t\t});\n\t}\n\n\tpublic async clearSession(sessionId: SessionId): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tfor (const table of ['thoughts', 'branches', 'edges', 'summaries']) {\n\t\t\t\tthis._db.prepare(`DELETE FROM ${table} WHERE session_id = ?`).run(validatedSessionId);\n\t\t\t}\n\t\t});\n\t}\n\n\tpublic async saveEdges(sessionId: SessionId, edges: readonly Edge[]): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertEdgeScopes(validatedSessionId, edges);\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tthis._db.prepare('DELETE FROM edges WHERE session_id = ?').run(validatedSessionId);\n\t\t\tconst insert = this._db.prepare(\n\t\t\t\t'INSERT INTO edges (id, session_id, from_id, to_id, kind, created_at, metadata) VALUES (?, ?, ?, ?, ?, ?, ?)'\n\t\t\t);\n\t\t\tfor (const edge of edges)\n\t\t\t\tinsert.run(\n\t\t\t\t\tedge.id,\n\t\t\t\t\tedge.sessionId,\n\t\t\t\t\tedge.from,\n\t\t\t\t\tedge.to,\n\t\t\t\t\tedge.kind,\n\t\t\t\t\tedge.createdAt,\n\t\t\t\t\tedge.metadata === undefined ? null : JSON.stringify(edge.metadata)\n\t\t\t\t);\n\t\t});\n\t}\n\n\tpublic async loadEdges(sessionId: SessionId): Promise<Edge[]> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\treturn this._db\n\t\t\t.prepare(\n\t\t\t\t'SELECT id, session_id, from_id, to_id, kind, created_at, metadata FROM edges WHERE session_id = ? ORDER BY created_at ASC, id ASC'\n\t\t\t)\n\t\t\t.all(validatedSessionId)\n\t\t\t.map((row, index) => decodeEdgeRow(row, `${this._sourcePath}:edges:${index}`));\n\t}\n\n\tpublic async listEdgeSessions(): Promise<SessionId[]> {\n\t\treturn this._db\n\t\t\t.prepare('SELECT DISTINCT session_id FROM edges ORDER BY session_id ASC')\n\t\t\t.all()\n\t\t\t.map((row) => asSessionId(stringField(row, 'session_id', this._sourcePath)));\n\t}\n\n\tpublic async saveSummaries(sessionId: SessionId, summaries: readonly Summary[]): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tassertSummaryScopes(validatedSessionId, summaries);\n\t\trunSqliteTransaction(this._db, () => {\n\t\t\tthis._db.prepare('DELETE FROM summaries WHERE session_id = ?').run(validatedSessionId);\n\t\t\tconst insert = this._db.prepare(\n\t\t\t\t'INSERT INTO summaries (id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)'\n\t\t\t);\n\t\t\tfor (const summary of summaries)\n\t\t\t\tinsert.run(\n\t\t\t\t\tsummary.id,\n\t\t\t\t\tsummary.sessionId,\n\t\t\t\t\tsummary.branchId ?? null,\n\t\t\t\t\tsummary.rootThoughtId,\n\t\t\t\t\tJSON.stringify(summary.coveredIds),\n\t\t\t\t\tsummary.coveredRange[0],\n\t\t\t\t\tsummary.coveredRange[1],\n\t\t\t\t\tJSON.stringify(summary.topics),\n\t\t\t\t\tsummary.aggregateConfidence,\n\t\t\t\t\tsummary.createdAt,\n\t\t\t\t\tsummary.meta === undefined ? null : JSON.stringify(summary.meta)\n\t\t\t\t);\n\t\t});\n\t}\n\n\tpublic async loadSummaries(sessionId: SessionId): Promise<Summary[]> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\treturn this._db\n\t\t\t.prepare(\n\t\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 WHERE session_id = ? ORDER BY created_at ASC, id ASC'\n\t\t\t)\n\t\t\t.all(validatedSessionId)\n\t\t\t.map((row, index) => decodeSummaryRow(row, `${this._sourcePath}:summaries:${index}`));\n\t}\n\n\tpublic async healthy(): Promise<boolean> {\n\t\ttry {\n\t\t\tthis._db.prepare('SELECT 1').get();\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tif (error instanceof Error) return false;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tpublic async close(): Promise<void> {\n\t\tthis._db.close();\n\t}\n\n\tpublic getStats(): {\n\t\treadonly thoughtCount: number;\n\t\treadonly branchCount: number;\n\t\treadonly dbSize: number;\n\t} {\n\t\tconst thoughtCount = numberField(\n\t\t\tthis._db.prepare('SELECT COUNT(*) AS count FROM thoughts').get(),\n\t\t\t'count',\n\t\t\tthis._sourcePath\n\t\t);\n\t\tconst branchCount = numberField(\n\t\t\tthis._db.prepare('SELECT COUNT(*) AS count FROM branches').get(),\n\t\t\t'count',\n\t\t\tthis._sourcePath\n\t\t);\n\t\treturn { thoughtCount, branchCount: this._persistBranches ? branchCount : 0, dbSize: 0 };\n\t}\n\n\tprivate _loadValidatedThoughtState(\n\t\tsessionId: SessionId,\n\t\tcandidates: readonly ThoughtData[] = [],\n\t\treplacingBranch?: BranchId\n\t): ValidatedThoughtState {\n\t\tconst history = this.loadHistoryRows(sessionId);\n\t\tfor (const thought of history) {\n\t\t\tassertThoughtScope('saveThoughtForSession', sessionId, thought);\n\t\t}\n\t\tconst collections: PersistedThoughtCollection[] = [\n\t\t\t{\n\t\t\t\tsessionId,\n\t\t\t\tthoughts: replacingBranch === undefined ? [...history, ...candidates] : history,\n\t\t\t},\n\t\t];\n\t\tconst branches = new Map<BranchId, ThoughtData[]>();\n\t\tfor (const row of this._db\n\t\t\t.prepare('SELECT branch_id, data FROM branches WHERE session_id = ?')\n\t\t\t.all(sessionId)) {\n\t\t\tconst branchId = parsePersistenceBranchId(\n\t\t\t\tstringField(row, 'branch_id', this._sourcePath),\n\t\t\t\tthis._sourcePath\n\t\t\t);\n\t\t\tconst data = stringField(row, 'data', this._sourcePath);\n\t\t\tlet values: unknown;\n\t\t\ttry {\n\t\t\t\tvalues = JSON.parse(data);\n\t\t\t} catch (error) {\n\t\t\t\tthrow new PersistenceCorruptionError(this._sourcePath, error);\n\t\t\t}\n\t\t\tif (!Array.isArray(values))\n\t\t\t\tthrow new PersistenceCorruptionError(\n\t\t\t\t\tthis._sourcePath,\n\t\t\t\t\tnew TypeError('branch data is not an array')\n\t\t\t\t);\n\t\t\tconst thoughts = values.map((value, index) =>\n\t\t\t\tdecodeThoughtRow(\n\t\t\t\t\t{ data: JSON.stringify(value) },\n\t\t\t\t\t`${this._sourcePath}:branch:${sessionId}:${branchId}:${index}`\n\t\t\t\t)\n\t\t\t);\n\t\t\tassertBranchScope('saveBranchForSession', sessionId, branchId, thoughts);\n\t\t\tbranches.set(branchId, thoughts);\n\t\t\tif (branchId !== replacingBranch) collections.push({ sessionId, thoughts });\n\t\t}\n\t\tif (replacingBranch !== undefined) {\n\t\t\tcollections.push({ sessionId, thoughts: candidates });\n\t\t}\n\t\tassertPersistableThoughtCollections(collections, this._sourcePath);\n\t\treturn { history, branches };\n\t}\n\n\tprivate loadHistoryRows(sessionId: SessionId): ThoughtData[] {\n\t\treturn this._db\n\t\t\t.prepare('SELECT data FROM thoughts WHERE session_id = ? ORDER BY id ASC')\n\t\t\t.all(sessionId)\n\t\t\t.map((row) => decodeThoughtRow(row, this._sourcePath));\n\t}\n}\n"],"names":["SqlitePersistence","_db","_sourcePath","_maxHistorySize","_persistBranches","database","options","sourcePath","initializeOrValidateSqliteV2","defaultDataDir","existsSync","join","homedir","dbPath","Database","module","error","PersistenceCompatibilityError","persistence","thought","assertThoughtScope","GLOBAL_SESSION_ID","sessionId","validatedSessionId","asSessionId","runSqliteTransaction","JSON","countRow","excess","numberField","runSqliteReadTransaction","branchId","thoughts","validatedBranchId","parsePersistenceBranchId","assertBranchScope","assertPersistableThoughts","row","stringField","compareCodePoint","table","edges","assertEdgeScopes","insert","edge","undefined","index","decodeEdgeRow","summaries","assertSummaryScopes","summary","decodeSummaryRow","Error","thoughtCount","branchCount","candidates","replacingBranch","history","collections","branches","Map","data","values","PersistenceCorruptionError","Array","TypeError","value","decodeThoughtRow","assertPersistableThoughtCollections"],"mappings":"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"}

package/dist/persistence/SqliteSchemaV2.d.ts

@@ -0,0 +1,14 @@
+import type { SqliteDatabase } from './SqliteDriver.js';
+export declare const SQLITE_V2_SCHEMA_DDL = "\nCREATE TABLE schema_version (\n  singleton INTEGER PRIMARY KEY CHECK (singleton = 1),\n  version INTEGER NOT NULL CHECK (version = 2)\n);\nCREATE TABLE thoughts (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  data TEXT NOT NULL,\n  created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE INDEX idx_thoughts_session_id ON thoughts(session_id, id);\nCREATE TABLE branches (\n  session_id TEXT NOT NULL,\n  branch_id TEXT NOT NULL,\n  data TEXT NOT NULL,\n  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  PRIMARY KEY (session_id, branch_id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),\n  CHECK (length(branch_id) BETWEEN 1 AND 50),\n  CHECK (branch_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE TABLE edges (\n  id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  from_id TEXT NOT NULL,\n  to_id TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  created_at INTEGER NOT NULL,\n  metadata TEXT,\n  PRIMARY KEY (session_id, id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE INDEX idx_edges_session_created ON edges(session_id, created_at, id);\nCREATE INDEX idx_edges_from ON edges(session_id, from_id);\nCREATE INDEX idx_edges_to ON edges(session_id, to_id);\nCREATE TABLE summaries (\n  id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  branch_id TEXT,\n  root_thought_id TEXT NOT NULL,\n  covered_ids TEXT NOT NULL,\n  covered_range_start INTEGER NOT NULL,\n  covered_range_end INTEGER NOT NULL,\n  topics TEXT NOT NULL,\n  aggregate_confidence REAL NOT NULL,\n  created_at INTEGER NOT NULL,\n  meta TEXT,\n  PRIMARY KEY (session_id, id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),\n  CHECK (branch_id IS NULL OR (\n    length(branch_id) BETWEEN 1 AND 50\n    AND branch_id NOT GLOB '*[^A-Za-z0-9_-]*'\n  )),\n  CHECK (aggregate_confidence >= 0.0 AND aggregate_confidence <= 1.0)\n);\nCREATE INDEX idx_summaries_session_created\n  ON summaries(session_id, created_at, id);\nCREATE INDEX idx_summaries_session_branch\n  ON summaries(session_id, branch_id);\n";
+export declare const SQLITE_V2_VERSION_INSERT = "INSERT INTO schema_version (singleton, version) VALUES (1, 2);";
+type SchemaObject = {
+    readonly type: string;
+    readonly name: string;
+    readonly tableName: string;
+    readonly sql: string;
+};
+export declare function sqliteSchemaObjects(database: SqliteDatabase, sourcePath: string): SchemaObject[];
+export declare function validateSqliteV2Schema(database: SqliteDatabase, sourcePath: string): void;
+export declare function initializeOrValidateSqliteV2(database: SqliteDatabase, sourcePath: string): void;
+export {};
+//# sourceMappingURL=SqliteSchemaV2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSchemaV2.d.ts","sourceRoot":"","sources":["../../src/persistence/SqliteSchemaV2.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,oBAAoB,4tEAiEhC,CAAC;AAEF,eAAO,MAAM,wBAAwB,mEAC4B,CAAC;AAElE,KAAK,YAAY,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB,CAAC;AAuCF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAOhG;AAYD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA8BzF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAS/F"}

package/dist/persistence/SqliteSchemaV2.js

@@ -0,0 +1,129 @@
+import { PersistenceCompatibilityError, PersistenceImportRequiredError } from "../errors.js";
+import { runSqliteTransaction } from "./SqliteDriver.js";
+const SQLITE_V2_SCHEMA_DDL = `
+CREATE TABLE schema_version (
+  singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+  version INTEGER NOT NULL CHECK (version = 2)
+);
+CREATE TABLE thoughts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  data TEXT NOT NULL,
+  created_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  CHECK (length(session_id) BETWEEN 1 AND 100),
+  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')
+);
+CREATE INDEX idx_thoughts_session_id ON thoughts(session_id, id);
+CREATE TABLE branches (
+  session_id TEXT NOT NULL,
+  branch_id TEXT NOT NULL,
+  data TEXT NOT NULL,
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  PRIMARY KEY (session_id, branch_id),
+  CHECK (length(session_id) BETWEEN 1 AND 100),
+  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),
+  CHECK (length(branch_id) BETWEEN 1 AND 50),
+  CHECK (branch_id NOT GLOB '*[^A-Za-z0-9_-]*')
+);
+CREATE TABLE edges (
+  id TEXT NOT NULL,
+  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,
+  PRIMARY KEY (session_id, id),
+  CHECK (length(session_id) BETWEEN 1 AND 100),
+  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')
+);
+CREATE INDEX idx_edges_session_created ON edges(session_id, created_at, id);
+CREATE INDEX idx_edges_from ON edges(session_id, from_id);
+CREATE INDEX idx_edges_to ON edges(session_id, to_id);
+CREATE TABLE summaries (
+  id TEXT NOT NULL,
+  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,
+  PRIMARY KEY (session_id, id),
+  CHECK (length(session_id) BETWEEN 1 AND 100),
+  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),
+  CHECK (branch_id IS NULL OR (
+    length(branch_id) BETWEEN 1 AND 50
+    AND branch_id NOT GLOB '*[^A-Za-z0-9_-]*'
+  )),
+  CHECK (aggregate_confidence >= 0.0 AND aggregate_confidence <= 1.0)
+);
+CREATE INDEX idx_summaries_session_created
+  ON summaries(session_id, created_at, id);
+CREATE INDEX idx_summaries_session_branch
+  ON summaries(session_id, branch_id);
+`;
+const SQLITE_V2_VERSION_INSERT = 'INSERT INTO schema_version (singleton, version) VALUES (1, 2);';
+function normalizeSql(sql) {
+    return sql.replace(/\s+/g, ' ').replace(/;$/, '').trim().toLowerCase();
+}
+function expectedV2Objects() {
+    const objects = new Map();
+    for (const statement of SQLITE_V2_SCHEMA_DDL.split(';').map((sql)=>sql.trim()).filter(Boolean)){
+        const match = /^CREATE\s+(TABLE|INDEX)\s+([^\s(]+)/i.exec(statement);
+        if (match?.[1] !== void 0 && void 0 !== match[2]) objects.set(`${match[1].toLowerCase()}:${match[2]}`, normalizeSql(statement));
+    }
+    return objects;
+}
+const V2_OBJECTS = expectedV2Objects();
+function readSchemaObject(row, sourcePath) {
+    if ('object' != typeof row || null === row) throw new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master row');
+    const type = 'type' in row ? row.type : void 0;
+    const name = 'name' in row ? row.name : void 0;
+    const tableName = 'tbl_name' in row ? row.tbl_name : void 0;
+    const sql = 'sql' in row ? row.sql : void 0;
+    if ('string' != typeof type || 'string' != typeof name || 'string' != typeof tableName || 'string' != typeof sql) throw new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master fields');
+    return {
+        type,
+        name,
+        tableName,
+        sql
+    };
+}
+function sqliteSchemaObjects(database, sourcePath) {
+    return database.prepare("SELECT type, name, tbl_name, sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%' ORDER BY type, name").all().map((row)=>readSchemaObject(row, sourcePath));
+}
+function hasLegacyShape(objects) {
+    const names = new Set(objects.map(({ type, name })=>`${type}:${name}`));
+    return names.has('table:thoughts') && names.has('table:edges') && names.has('table:summaries') && !names.has('table:schema_version');
+}
+function validateSqliteV2Schema(database, sourcePath) {
+    const objects = sqliteSchemaObjects(database, sourcePath);
+    if (objects.length !== V2_OBJECTS.size) {
+        if (hasLegacyShape(objects)) throw new PersistenceImportRequiredError(sourcePath, [
+            'unversioned SQLite v1 schema'
+        ]);
+        throw new PersistenceCompatibilityError(sourcePath, 'SQLite v2 object set does not match');
+    }
+    for (const object of objects){
+        const expected = V2_OBJECTS.get(`${object.type}:${object.name}`);
+        if (void 0 === expected || normalizeSql(object.sql) !== expected) throw new PersistenceCompatibilityError(sourcePath, `SQLite v2 drift at '${object.name}'`);
+    }
+    const versionRows = database.prepare('SELECT singleton, version FROM schema_version').all();
+    const versionRow = versionRows[0];
+    if (1 !== versionRows.length || 'object' != typeof versionRow || null === versionRow || !('singleton' in versionRow) || 1 !== versionRow.singleton || !('version' in versionRow) || 2 !== versionRow.version) throw new PersistenceCompatibilityError(sourcePath, 'schema_version must contain exactly (1, 2)');
+}
+function initializeOrValidateSqliteV2(database, sourcePath) {
+    const objects = sqliteSchemaObjects(database, sourcePath);
+    if (0 === objects.length) runSqliteTransaction(database, ()=>{
+        database.exec(SQLITE_V2_SCHEMA_DDL);
+        database.exec(SQLITE_V2_VERSION_INSERT);
+    });
+    validateSqliteV2Schema(database, sourcePath);
+}
+export { SQLITE_V2_SCHEMA_DDL, SQLITE_V2_VERSION_INSERT, initializeOrValidateSqliteV2, sqliteSchemaObjects, validateSqliteV2Schema };
+
+//# sourceMappingURL=SqliteSchemaV2.js.map

package/dist/persistence/SqliteSchemaV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqliteSchemaV2.js","sources":["../../src/persistence/SqliteSchemaV2.ts"],"sourcesContent":["import { PersistenceCompatibilityError, PersistenceImportRequiredError } from '../errors.js';\nimport type { SqliteDatabase } from './SqliteDriver.js';\nimport { runSqliteTransaction } from './SqliteDriver.js';\n\nexport const SQLITE_V2_SCHEMA_DDL = `\nCREATE TABLE schema_version (\n  singleton INTEGER PRIMARY KEY CHECK (singleton = 1),\n  version INTEGER NOT NULL CHECK (version = 2)\n);\nCREATE TABLE thoughts (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  session_id TEXT NOT NULL,\n  data TEXT NOT NULL,\n  created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE INDEX idx_thoughts_session_id ON thoughts(session_id, id);\nCREATE TABLE branches (\n  session_id TEXT NOT NULL,\n  branch_id TEXT NOT NULL,\n  data TEXT NOT NULL,\n  updated_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  PRIMARY KEY (session_id, branch_id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),\n  CHECK (length(branch_id) BETWEEN 1 AND 50),\n  CHECK (branch_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE TABLE edges (\n  id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  from_id TEXT NOT NULL,\n  to_id TEXT NOT NULL,\n  kind TEXT NOT NULL,\n  created_at INTEGER NOT NULL,\n  metadata TEXT,\n  PRIMARY KEY (session_id, id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*')\n);\nCREATE INDEX idx_edges_session_created ON edges(session_id, created_at, id);\nCREATE INDEX idx_edges_from ON edges(session_id, from_id);\nCREATE INDEX idx_edges_to ON edges(session_id, to_id);\nCREATE TABLE summaries (\n  id TEXT NOT NULL,\n  session_id TEXT NOT NULL,\n  branch_id TEXT,\n  root_thought_id TEXT NOT NULL,\n  covered_ids TEXT NOT NULL,\n  covered_range_start INTEGER NOT NULL,\n  covered_range_end INTEGER NOT NULL,\n  topics TEXT NOT NULL,\n  aggregate_confidence REAL NOT NULL,\n  created_at INTEGER NOT NULL,\n  meta TEXT,\n  PRIMARY KEY (session_id, id),\n  CHECK (length(session_id) BETWEEN 1 AND 100),\n  CHECK (session_id NOT GLOB '*[^A-Za-z0-9_-]*'),\n  CHECK (branch_id IS NULL OR (\n    length(branch_id) BETWEEN 1 AND 50\n    AND branch_id NOT GLOB '*[^A-Za-z0-9_-]*'\n  )),\n  CHECK (aggregate_confidence >= 0.0 AND aggregate_confidence <= 1.0)\n);\nCREATE INDEX idx_summaries_session_created\n  ON summaries(session_id, created_at, id);\nCREATE INDEX idx_summaries_session_branch\n  ON summaries(session_id, branch_id);\n`;\n\nexport const SQLITE_V2_VERSION_INSERT =\n\t'INSERT INTO schema_version (singleton, version) VALUES (1, 2);';\n\ntype SchemaObject = {\n\treadonly type: string;\n\treadonly name: string;\n\treadonly tableName: string;\n\treadonly sql: string;\n};\n\nfunction normalizeSql(sql: string): string {\n\treturn sql.replace(/\\s+/g, ' ').replace(/;$/, '').trim().toLowerCase();\n}\n\nfunction expectedV2Objects(): Map<string, string> {\n\tconst objects = new Map<string, string>();\n\tfor (const statement of SQLITE_V2_SCHEMA_DDL.split(';')\n\t\t.map((sql) => sql.trim())\n\t\t.filter(Boolean)) {\n\t\tconst match = /^CREATE\\s+(TABLE|INDEX)\\s+([^\\s(]+)/i.exec(statement);\n\t\tif (match?.[1] === undefined || match[2] === undefined) continue;\n\t\tobjects.set(`${match[1].toLowerCase()}:${match[2]}`, normalizeSql(statement));\n\t}\n\treturn objects;\n}\n\nconst V2_OBJECTS = expectedV2Objects();\n\nfunction readSchemaObject(row: unknown, sourcePath: string): SchemaObject {\n\tif (typeof row !== 'object' || row === null) {\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master row');\n\t}\n\tconst type = 'type' in row ? row.type : undefined;\n\tconst name = 'name' in row ? row.name : undefined;\n\tconst tableName = 'tbl_name' in row ? row.tbl_name : undefined;\n\tconst sql = 'sql' in row ? row.sql : undefined;\n\tif (\n\t\ttypeof type !== 'string' ||\n\t\ttypeof name !== 'string' ||\n\t\ttypeof tableName !== 'string' ||\n\t\ttypeof sql !== 'string'\n\t) {\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'invalid sqlite_master fields');\n\t}\n\treturn { type, name, tableName, sql };\n}\n\nexport function sqliteSchemaObjects(database: SqliteDatabase, sourcePath: string): SchemaObject[] {\n\treturn database\n\t\t.prepare(\n\t\t\t\"SELECT type, name, tbl_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) => readSchemaObject(row, sourcePath));\n}\n\nfunction hasLegacyShape(objects: readonly SchemaObject[]): boolean {\n\tconst names = new Set(objects.map(({ type, name }) => `${type}:${name}`));\n\treturn (\n\t\tnames.has('table:thoughts') &&\n\t\tnames.has('table:edges') &&\n\t\tnames.has('table:summaries') &&\n\t\t!names.has('table:schema_version')\n\t);\n}\n\nexport function validateSqliteV2Schema(database: SqliteDatabase, sourcePath: string): void {\n\tconst objects = sqliteSchemaObjects(database, sourcePath);\n\tif (objects.length !== V2_OBJECTS.size) {\n\t\tif (hasLegacyShape(objects)) {\n\t\t\tthrow new PersistenceImportRequiredError(sourcePath, ['unversioned SQLite v1 schema']);\n\t\t}\n\t\tthrow new PersistenceCompatibilityError(sourcePath, 'SQLite v2 object set does not match');\n\t}\n\tfor (const object of objects) {\n\t\tconst expected = V2_OBJECTS.get(`${object.type}:${object.name}`);\n\t\tif (expected === undefined || normalizeSql(object.sql) !== expected) {\n\t\t\tthrow new PersistenceCompatibilityError(sourcePath, `SQLite v2 drift at '${object.name}'`);\n\t\t}\n\t}\n\tconst versionRows = database.prepare('SELECT singleton, version FROM schema_version').all();\n\tconst versionRow = versionRows[0];\n\tif (\n\t\tversionRows.length !== 1 ||\n\t\ttypeof versionRow !== 'object' ||\n\t\tversionRow === null ||\n\t\t!('singleton' in versionRow) ||\n\t\tversionRow.singleton !== 1 ||\n\t\t!('version' in versionRow) ||\n\t\tversionRow.version !== 2\n\t) {\n\t\tthrow new PersistenceCompatibilityError(\n\t\t\tsourcePath,\n\t\t\t'schema_version must contain exactly (1, 2)'\n\t\t);\n\t}\n}\n\nexport function initializeOrValidateSqliteV2(database: SqliteDatabase, sourcePath: string): void {\n\tconst objects = sqliteSchemaObjects(database, sourcePath);\n\tif (objects.length === 0) {\n\t\trunSqliteTransaction(database, () => {\n\t\t\tdatabase.exec(SQLITE_V2_SCHEMA_DDL);\n\t\t\tdatabase.exec(SQLITE_V2_VERSION_INSERT);\n\t\t});\n\t}\n\tvalidateSqliteV2Schema(database, sourcePath);\n}\n"],"names":["SQLITE_V2_SCHEMA_DDL","SQLITE_V2_VERSION_INSERT","normalizeSql","sql","expectedV2Objects","objects","Map","statement","Boolean","match","undefined","V2_OBJECTS","readSchemaObject","row","sourcePath","PersistenceCompatibilityError","type","name","tableName","sqliteSchemaObjects","database","hasLegacyShape","names","Set","validateSqliteV2Schema","PersistenceImportRequiredError","object","expected","versionRows","versionRow","initializeOrValidateSqliteV2","runSqliteTransaction"],"mappings":"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"}

package/dist/persistence/SqliteSnapshotWriter.d.ts

@@ -0,0 +1,17 @@
+import type { FileSnapshotV2 } from './FileSnapshotTypes.js';
+import type { SqliteDatabase } from './SqliteDriver.js';
+/**
+ * Writes and validates a canonical File v2 snapshot into an empty SQLite v2 database.
+ *
+ * @param database - Empty SQLite destination database.
+ * @param snapshot - Validated snapshot to write.
+ * @param destinationPath - Destination path included in compatibility errors.
+ * @returns Nothing after the transaction commits successfully.
+ *
+ * @example
+ * ```ts
+ * writeSqliteSnapshot(database, snapshot, '/data/history.db');
+ * ```
+ */
+export declare function writeSqliteSnapshot(database: SqliteDatabase, snapshot: FileSnapshotV2, destinationPath: string): void;
+//# sourceMappingURL=SqliteSnapshotWriter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteSnapshotWriter.d.ts","sourceRoot":"","sources":["../../src/persistence/SqliteSnapshotWriter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,cAAc,EAEd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA4DxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,EACxB,eAAe,EAAE,MAAM,GACrB,IAAI,CAaN"}

package/dist/persistence/SqliteSnapshotWriter.js

@@ -0,0 +1,30 @@
+import { runSqliteTransaction } from "./SqliteDriver.js";
+import { SQLITE_V2_SCHEMA_DDL, SQLITE_V2_VERSION_INSERT, validateSqliteV2Schema } from "./SqliteSchemaV2.js";
+function insertThoughts(database, records) {
+    const insert = database.prepare('INSERT INTO thoughts (session_id, data) VALUES (?, ?)');
+    for (const record of records)for (const thought of record.thoughts)insert.run(record.sessionId, JSON.stringify(thought));
+}
+function insertBranches(database, records) {
+    const insert = database.prepare('INSERT INTO branches (session_id, branch_id, data) VALUES (?, ?, ?)');
+    for (const record of records)insert.run(record.sessionId, record.branchId, JSON.stringify(record.thoughts));
+}
+function insertEdge(database, edge) {
+    database.prepare('INSERT INTO edges (id, session_id, from_id, to_id, kind, created_at, metadata) VALUES (?, ?, ?, ?, ?, ?, ?)').run(edge.id, edge.sessionId, edge.from, edge.to, edge.kind, edge.createdAt, void 0 === edge.metadata ? null : JSON.stringify(edge.metadata));
+}
+function insertSummary(database, summary) {
+    database.prepare('INSERT INTO summaries (id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(summary.id, summary.sessionId, summary.branchId ?? null, summary.rootThoughtId, JSON.stringify(summary.coveredIds), summary.coveredRange[0], summary.coveredRange[1], JSON.stringify(summary.topics), summary.aggregateConfidence, summary.createdAt, void 0 === summary.meta ? null : JSON.stringify(summary.meta));
+}
+function writeSqliteSnapshot(database, snapshot, destinationPath) {
+    runSqliteTransaction(database, ()=>{
+        database.exec(SQLITE_V2_SCHEMA_DDL);
+        insertThoughts(database, snapshot.thoughts);
+        insertBranches(database, snapshot.branches);
+        for (const record of snapshot.edges)for (const edge of record.edges)insertEdge(database, edge);
+        for (const record of snapshot.summaries)for (const summary of record.summaries)insertSummary(database, summary);
+        database.exec(SQLITE_V2_VERSION_INSERT);
+        validateSqliteV2Schema(database, destinationPath);
+    });
+}
+export { writeSqliteSnapshot };
+
+//# sourceMappingURL=SqliteSnapshotWriter.js.map

package/dist/persistence/SqliteSnapshotWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/SqliteSnapshotWriter.js","sources":["../../src/persistence/SqliteSnapshotWriter.ts"],"sourcesContent":["import type { Summary } from '../core/compression/Summary.js';\nimport type { Edge } from '../core/graph/Edge.js';\nimport type {\n\tBranchRecordV2,\n\tFileSnapshotV2,\n\tThoughtSessionV2,\n} from './FileSnapshotTypes.js';\nimport type { SqliteDatabase } from './SqliteDriver.js';\nimport { runSqliteTransaction } from './SqliteDriver.js';\nimport {\n\tSQLITE_V2_SCHEMA_DDL,\n\tSQLITE_V2_VERSION_INSERT,\n\tvalidateSqliteV2Schema,\n} from './SqliteSchemaV2.js';\n\nfunction insertThoughts(database: SqliteDatabase, records: readonly ThoughtSessionV2[]): void {\n\tconst insert = database.prepare('INSERT INTO thoughts (session_id, data) VALUES (?, ?)');\n\tfor (const record of records) {\n\t\tfor (const thought of record.thoughts) insert.run(record.sessionId, JSON.stringify(thought));\n\t}\n}\n\nfunction insertBranches(database: SqliteDatabase, records: readonly BranchRecordV2[]): void {\n\tconst insert = database.prepare(\n\t\t'INSERT INTO branches (session_id, branch_id, data) VALUES (?, ?, ?)'\n\t);\n\tfor (const record of records) {\n\t\tinsert.run(record.sessionId, record.branchId, JSON.stringify(record.thoughts));\n\t}\n}\n\nfunction insertEdge(database: SqliteDatabase, edge: Edge): void {\n\tdatabase\n\t\t.prepare(\n\t\t\t'INSERT INTO edges (id, session_id, from_id, to_id, kind, created_at, metadata) VALUES (?, ?, ?, ?, ?, ?, ?)'\n\t\t)\n\t\t.run(\n\t\t\tedge.id,\n\t\t\tedge.sessionId,\n\t\t\tedge.from,\n\t\t\tedge.to,\n\t\t\tedge.kind,\n\t\t\tedge.createdAt,\n\t\t\tedge.metadata === undefined ? null : JSON.stringify(edge.metadata)\n\t\t);\n}\n\nfunction insertSummary(database: SqliteDatabase, summary: Summary): void {\n\tdatabase\n\t\t.prepare(\n\t\t\t'INSERT INTO summaries (id, session_id, branch_id, root_thought_id, covered_ids, covered_range_start, covered_range_end, topics, aggregate_confidence, created_at, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)'\n\t\t)\n\t\t.run(\n\t\t\tsummary.id,\n\t\t\tsummary.sessionId,\n\t\t\tsummary.branchId ?? null,\n\t\t\tsummary.rootThoughtId,\n\t\t\tJSON.stringify(summary.coveredIds),\n\t\t\tsummary.coveredRange[0],\n\t\t\tsummary.coveredRange[1],\n\t\t\tJSON.stringify(summary.topics),\n\t\t\tsummary.aggregateConfidence,\n\t\t\tsummary.createdAt,\n\t\t\tsummary.meta === undefined ? null : JSON.stringify(summary.meta)\n\t\t);\n}\n\n/**\n * Writes and validates a canonical File v2 snapshot into an empty SQLite v2 database.\n *\n * @param database - Empty SQLite destination database.\n * @param snapshot - Validated snapshot to write.\n * @param destinationPath - Destination path included in compatibility errors.\n * @returns Nothing after the transaction commits successfully.\n *\n * @example\n * ```ts\n * writeSqliteSnapshot(database, snapshot, '/data/history.db');\n * ```\n */\nexport function writeSqliteSnapshot(\n\tdatabase: SqliteDatabase,\n\tsnapshot: FileSnapshotV2,\n\tdestinationPath: string\n): void {\n\trunSqliteTransaction(database, () => {\n\t\tdatabase.exec(SQLITE_V2_SCHEMA_DDL);\n\t\tinsertThoughts(database, snapshot.thoughts);\n\t\tinsertBranches(database, snapshot.branches);\n\t\tfor (const record of snapshot.edges)\n\t\t\tfor (const edge of record.edges) insertEdge(database, edge);\n\t\tfor (const record of snapshot.summaries) {\n\t\t\tfor (const summary of record.summaries) insertSummary(database, summary);\n\t\t}\n\t\tdatabase.exec(SQLITE_V2_VERSION_INSERT);\n\t\tvalidateSqliteV2Schema(database, destinationPath);\n\t});\n}\n"],"names":["insertThoughts","database","records","insert","record","thought","JSON","insertBranches","insertEdge","edge","undefined","insertSummary","summary","writeSqliteSnapshot","snapshot","destinationPath","runSqliteTransaction","SQLITE_V2_SCHEMA_DDL","SQLITE_V2_VERSION_INSERT","validateSqliteV2Schema"],"mappings":";;AAeA,SAASA,eAAeC,QAAwB,EAAEC,OAAoC;IACrF,MAAMC,SAASF,SAAS,OAAO,CAAC;IAChC,KAAK,MAAMG,UAAUF,QACpB,KAAK,MAAMG,WAAWD,OAAO,QAAQ,CAAED,OAAO,GAAG,CAACC,OAAO,SAAS,EAAEE,KAAK,SAAS,CAACD;AAErF;AAEA,SAASE,eAAeN,QAAwB,EAAEC,OAAkC;IACnF,MAAMC,SAASF,SAAS,OAAO,CAC9B;IAED,KAAK,MAAMG,UAAUF,QACpBC,OAAO,GAAG,CAACC,OAAO,SAAS,EAAEA,OAAO,QAAQ,EAAEE,KAAK,SAAS,CAACF,OAAO,QAAQ;AAE9E;AAEA,SAASI,WAAWP,QAAwB,EAAEQ,IAAU;IACvDR,SACE,OAAO,CACP,+GAEA,GAAG,CACHQ,KAAK,EAAE,EACPA,KAAK,SAAS,EACdA,KAAK,IAAI,EACTA,KAAK,EAAE,EACPA,KAAK,IAAI,EACTA,KAAK,SAAS,EACdA,AAAkBC,WAAlBD,KAAK,QAAQ,GAAiB,OAAOH,KAAK,SAAS,CAACG,KAAK,QAAQ;AAEpE;AAEA,SAASE,cAAcV,QAAwB,EAAEW,OAAgB;IAChEX,SACE,OAAO,CACP,oNAEA,GAAG,CACHW,QAAQ,EAAE,EACVA,QAAQ,SAAS,EACjBA,QAAQ,QAAQ,IAAI,MACpBA,QAAQ,aAAa,EACrBN,KAAK,SAAS,CAACM,QAAQ,UAAU,GACjCA,QAAQ,YAAY,CAAC,EAAE,EACvBA,QAAQ,YAAY,CAAC,EAAE,EACvBN,KAAK,SAAS,CAACM,QAAQ,MAAM,GAC7BA,QAAQ,mBAAmB,EAC3BA,QAAQ,SAAS,EACjBA,AAAiBF,WAAjBE,QAAQ,IAAI,GAAiB,OAAON,KAAK,SAAS,CAACM,QAAQ,IAAI;AAElE;AAeO,SAASC,oBACfZ,QAAwB,EACxBa,QAAwB,EACxBC,eAAuB;IAEvBC,qBAAqBf,UAAU;QAC9BA,SAAS,IAAI,CAACgB;QACdjB,eAAeC,UAAUa,SAAS,QAAQ;QAC1CP,eAAeN,UAAUa,SAAS,QAAQ;QAC1C,KAAK,MAAMV,UAAUU,SAAS,KAAK,CAClC,KAAK,MAAML,QAAQL,OAAO,KAAK,CAAEI,WAAWP,UAAUQ;QACvD,KAAK,MAAML,UAAUU,SAAS,SAAS,CACtC,KAAK,MAAMF,WAAWR,OAAO,SAAS,CAAEO,cAAcV,UAAUW;QAEjEX,SAAS,IAAI,CAACiB;QACdC,uBAAuBlB,UAAUc;IAClC;AACD"}