@iworkforces/tracelattice 2.0.3

package/dist/persistence/FileLegacyImport.js

@@ -0,0 +1,183 @@
+import { lstat, mkdir, mkdtemp, readFile, readdir, rename, rm } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { GLOBAL_SESSION_ID, asSessionId } from "../contracts/ids.js";
+import { PersistenceCompatibilityError, PersistenceCorruptionError, PersistenceLegacyAmbiguityError } from "../errors.js";
+import { EdgeSchema } from "../schema.js";
+import { SummarySchema } from "../core/compression/Summary.js";
+import { parseEdge, parseSummary, parseThoughtData } from "./PersistenceCodec.js";
+import { EMPTY_FILE_SNAPSHOT_V2, parseFileSnapshotV2, serializeFileSnapshotV2 } from "./FileSnapshotV2.js";
+import { FileWriter, isFileNotFound } from "./FileWriter.js";
+import { compareCodePoint, parsePersistenceBranchId } from "./PersistenceScope.js";
+import * as __rspack_external_valibot from "valibot";
+const LEGACY_NAMESPACES = [
+    'branches',
+    'edges',
+    'summaries'
+];
+async function destinationIsAbsent(path) {
+    try {
+        await lstat(path);
+        return false;
+    } catch (error) {
+        if (isFileNotFound(error)) return true;
+        throw error;
+    }
+}
+async function parseJson(path) {
+    try {
+        return JSON.parse(await readFile(path, 'utf-8'));
+    } catch (error) {
+        if (error instanceof SyntaxError) throw new PersistenceCorruptionError(path, error);
+        throw error;
+    }
+}
+async function parseThoughtArray(path) {
+    const raw = await parseJson(path);
+    try {
+        return __rspack_external_valibot.parse(__rspack_external_valibot.array(__rspack_external_valibot.unknown()), raw).map((thought)=>parseThoughtData(thought, path));
+    } catch (error) {
+        if (error instanceof PersistenceCompatibilityError) throw error;
+        throw new PersistenceCorruptionError(path, error);
+    }
+}
+async function namespaceFiles(sourceDataDir, namespace) {
+    const directory = join(sourceDataDir, namespace);
+    try {
+        const entries = await readdir(directory, {
+            withFileTypes: true
+        });
+        for (const entry of entries)if (!entry.isFile() || !entry.name.endsWith('.json')) throw new PersistenceCompatibilityError(directory, `unknown legacy artifact '${entry.name}'`);
+        return entries.map((entry)=>join(directory, entry.name)).sort(compareCodePoint);
+    } catch (error) {
+        if (isFileNotFound(error)) return [];
+        throw error;
+    }
+}
+async function validateLegacyLayout(sourceDataDir) {
+    const entries = await readdir(sourceDataDir, {
+        withFileTypes: true
+    });
+    const allowed = new Set([
+        'history.json',
+        ...LEGACY_NAMESPACES
+    ]);
+    for (const entry of entries){
+        if (!allowed.has(entry.name)) throw new PersistenceCompatibilityError(sourceDataDir, `unknown legacy artifact '${entry.name}'`);
+        if ('history.json' === entry.name ? !entry.isFile() : !entry.isDirectory()) throw new PersistenceCompatibilityError(sourceDataDir, `invalid legacy artifact '${entry.name}'`);
+    }
+}
+function groupHistory(thoughts) {
+    const grouped = new Map();
+    for (const thought of thoughts){
+        const sessionId = thought.session_id ?? GLOBAL_SESSION_ID;
+        const history = grouped.get(sessionId) ?? [];
+        history.push(thought);
+        grouped.set(sessionId, history);
+    }
+    return [
+        ...grouped
+    ].map(([sessionId, sessionThoughts])=>({
+            sessionId,
+            thoughts: sessionThoughts
+        }));
+}
+async function loadLegacyHistory(sourceDataDir) {
+    const historyPath = join(sourceDataDir, 'history.json');
+    try {
+        return groupHistory(await parseThoughtArray(historyPath));
+    } catch (error) {
+        if (isFileNotFound(error)) return [];
+        throw error;
+    }
+}
+async function loadLegacyBranches(sourceDataDir) {
+    const records = [];
+    for (const path of (await namespaceFiles(sourceDataDir, 'branches'))){
+        const branchId = parsePersistenceBranchId(basename(path, '.json'), path);
+        const thoughts = await parseThoughtArray(path);
+        if (0 === thoughts.length) throw new PersistenceLegacyAmbiguityError(path, '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(path, 'branch thoughts resolve to multiple sessions');
+        const [sessionId] = sessions;
+        if (void 0 === sessionId) throw new PersistenceLegacyAmbiguityError(path, 'branch session is absent');
+        records.push({
+            sessionId,
+            branchId,
+            thoughts
+        });
+    }
+    return records;
+}
+async function loadLegacyEdges(sourceDataDir) {
+    const records = [];
+    for (const path of (await namespaceFiles(sourceDataDir, 'edges'))){
+        const sessionId = asSessionId(basename(path, '.json'));
+        try {
+            const edges = __rspack_external_valibot.parse(__rspack_external_valibot.array(EdgeSchema), await parseJson(path)).map(parseEdge);
+            if (edges.length > 0) records.push({
+                sessionId,
+                edges
+            });
+        } catch (error) {
+            if (error instanceof PersistenceCorruptionError) throw error;
+            throw new PersistenceCorruptionError(path, error);
+        }
+    }
+    return records;
+}
+async function loadLegacySummaries(sourceDataDir) {
+    const records = [];
+    for (const path of (await namespaceFiles(sourceDataDir, 'summaries'))){
+        const sessionId = asSessionId(basename(path, '.json'));
+        try {
+            const summaries = __rspack_external_valibot.parse(__rspack_external_valibot.array(SummarySchema), await parseJson(path)).map((summary)=>parseSummary(summary, path));
+            if (summaries.length > 0) records.push({
+                sessionId,
+                summaries
+            });
+        } catch (error) {
+            if (error instanceof PersistenceCorruptionError) throw error;
+            throw new PersistenceCorruptionError(path, error);
+        }
+    }
+    return records;
+}
+async function loadLegacySnapshot(sourceDataDir) {
+    await validateLegacyLayout(sourceDataDir);
+    return {
+        ...EMPTY_FILE_SNAPSHOT_V2,
+        thoughts: await loadLegacyHistory(sourceDataDir),
+        branches: await loadLegacyBranches(sourceDataDir),
+        edges: await loadLegacyEdges(sourceDataDir),
+        summaries: await loadLegacySummaries(sourceDataDir)
+    };
+}
+async function importLegacyFileV1(sourceDataDir, destinationDataDir) {
+    if (!await destinationIsAbsent(destinationDataDir)) throw new PersistenceCompatibilityError(destinationDataDir, 'destination must be absent');
+    const snapshot = await loadLegacySnapshot(sourceDataDir);
+    await mkdir(dirname(destinationDataDir), {
+        recursive: true
+    });
+    const stagingDir = await mkdtemp(join(dirname(destinationDataDir), `.${basename(destinationDataDir)}.import-`));
+    const writer = new FileWriter(stagingDir);
+    try {
+        await writer.ready();
+        await writer.run(async (dataDir)=>{
+            const snapshotPath = join(dataDir, 'snapshot.json');
+            await writer.publish(snapshotPath, serializeFileSnapshotV2(snapshot, snapshotPath));
+        });
+        await writer.close();
+        parseFileSnapshotV2(await readFile(join(stagingDir, 'snapshot.json'), 'utf-8'), join(stagingDir, 'snapshot.json'));
+        await rename(stagingDir, destinationDataDir);
+    } catch (error) {
+        await writer.close();
+        await rm(stagingDir, {
+            recursive: true,
+            force: true
+        });
+        throw error;
+    }
+}
+export { importLegacyFileV1 };
+
+//# sourceMappingURL=FileLegacyImport.js.map

package/dist/persistence/FileLegacyImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/FileLegacyImport.js","sources":["../../src/persistence/FileLegacyImport.ts"],"sourcesContent":["import { lstat, mkdtemp, mkdir, readFile, readdir, rename, rm } from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport * as v from 'valibot';\nimport { asSessionId, GLOBAL_SESSION_ID, type SessionId } from '../contracts/ids.js';\nimport {\n\tPersistenceCompatibilityError,\n\tPersistenceCorruptionError,\n\tPersistenceLegacyAmbiguityError,\n} from '../errors.js';\nimport { EdgeSchema } from '../schema.js';\nimport { SummarySchema } from '../core/compression/Summary.js';\nimport type { ThoughtData } from '../core/thought.js';\nimport { parseEdge, parseSummary, parseThoughtData } from './PersistenceCodec.js';\nimport {\n\tEMPTY_FILE_SNAPSHOT_V2,\n\tparseFileSnapshotV2,\n\tserializeFileSnapshotV2,\n} from './FileSnapshotV2.js';\nimport type {\n\tBranchRecordV2,\n\tEdgeSessionV2,\n\tFileSnapshotV2,\n\tSummarySessionV2,\n\tThoughtSessionV2,\n} from './FileSnapshotTypes.js';\nimport { FileWriter, isFileNotFound } from './FileWriter.js';\nimport { compareCodePoint, parsePersistenceBranchId } from './PersistenceScope.js';\n\nconst LEGACY_NAMESPACES = ['branches', 'edges', 'summaries'] as const;\n\nasync function destinationIsAbsent(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\nasync function parseJson(path: string): Promise<unknown> {\n\ttry {\n\t\treturn JSON.parse(await readFile(path, 'utf-8'));\n\t} catch (error) {\n\t\tif (error instanceof SyntaxError) throw new PersistenceCorruptionError(path, error);\n\t\tthrow error;\n\t}\n}\n\nasync function parseThoughtArray(path: string): Promise<ThoughtData[]> {\n\tconst raw = await parseJson(path);\n\ttry {\n\t\treturn v.parse(v.array(v.unknown()), raw).map((thought) => parseThoughtData(thought, path));\n\t} catch (error) {\n\t\tif (error instanceof PersistenceCompatibilityError) throw error;\n\t\tthrow new PersistenceCorruptionError(path, error);\n\t}\n}\n\nasync function namespaceFiles(sourceDataDir: string, namespace: string): Promise<string[]> {\n\tconst directory = join(sourceDataDir, namespace);\n\ttry {\n\t\tconst entries = await readdir(directory, { withFileTypes: true });\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.isFile() || !entry.name.endsWith('.json')) {\n\t\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\t\tdirectory,\n\t\t\t\t\t`unknown legacy artifact '${entry.name}'`\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\treturn entries.map((entry) => join(directory, entry.name)).sort(compareCodePoint);\n\t} catch (error) {\n\t\tif (isFileNotFound(error)) return [];\n\t\tthrow error;\n\t}\n}\n\nasync function validateLegacyLayout(sourceDataDir: string): Promise<void> {\n\tconst entries = await readdir(sourceDataDir, { withFileTypes: true });\n\tconst allowed = new Set<string>(['history.json', ...LEGACY_NAMESPACES]);\n\tfor (const entry of entries) {\n\t\tif (!allowed.has(entry.name)) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tsourceDataDir,\n\t\t\t\t`unknown legacy artifact '${entry.name}'`\n\t\t\t);\n\t\t}\n\t\tif (entry.name === 'history.json' ? !entry.isFile() : !entry.isDirectory()) {\n\t\t\tthrow new PersistenceCompatibilityError(\n\t\t\t\tsourceDataDir,\n\t\t\t\t`invalid legacy artifact '${entry.name}'`\n\t\t\t);\n\t\t}\n\t}\n}\n\nfunction groupHistory(thoughts: readonly ThoughtData[]): ThoughtSessionV2[] {\n\tconst grouped = new Map<SessionId, ThoughtData[]>();\n\tfor (const thought of thoughts) {\n\t\tconst sessionId = thought.session_id ?? GLOBAL_SESSION_ID;\n\t\tconst history = grouped.get(sessionId) ?? [];\n\t\thistory.push(thought);\n\t\tgrouped.set(sessionId, history);\n\t}\n\treturn [...grouped].map(([sessionId, sessionThoughts]) => ({\n\t\tsessionId,\n\t\tthoughts: sessionThoughts,\n\t}));\n}\n\nasync function loadLegacyHistory(sourceDataDir: string): Promise<ThoughtSessionV2[]> {\n\tconst historyPath = join(sourceDataDir, 'history.json');\n\ttry {\n\t\treturn groupHistory(await parseThoughtArray(historyPath));\n\t} catch (error) {\n\t\tif (isFileNotFound(error)) return [];\n\t\tthrow error;\n\t}\n}\n\nasync function loadLegacyBranches(sourceDataDir: string): Promise<BranchRecordV2[]> {\n\tconst records: BranchRecordV2[] = [];\n\tfor (const path of await namespaceFiles(sourceDataDir, 'branches')) {\n\t\tconst branchId = parsePersistenceBranchId(basename(path, '.json'), path);\n\t\tconst thoughts = await parseThoughtArray(path);\n\t\tif (thoughts.length === 0) {\n\t\t\tthrow new PersistenceLegacyAmbiguityError(path, 'empty branch has no inferable session');\n\t\t}\n\t\tconst sessions = new Set(thoughts.map((thought) => thought.session_id ?? GLOBAL_SESSION_ID));\n\t\tif (sessions.size !== 1) {\n\t\t\tthrow new PersistenceLegacyAmbiguityError(\n\t\t\t\tpath,\n\t\t\t\t'branch thoughts resolve to multiple sessions'\n\t\t\t);\n\t\t}\n\t\tconst [sessionId] = sessions;\n\t\tif (sessionId === undefined) {\n\t\t\tthrow new PersistenceLegacyAmbiguityError(path, 'branch session is absent');\n\t\t}\n\t\trecords.push({ sessionId, branchId, thoughts });\n\t}\n\treturn records;\n}\n\nasync function loadLegacyEdges(sourceDataDir: string): Promise<EdgeSessionV2[]> {\n\tconst records: EdgeSessionV2[] = [];\n\tfor (const path of await namespaceFiles(sourceDataDir, 'edges')) {\n\t\tconst sessionId = asSessionId(basename(path, '.json'));\n\t\ttry {\n\t\t\tconst edges = v.parse(v.array(EdgeSchema), await parseJson(path)).map(parseEdge);\n\t\t\tif (edges.length > 0) records.push({ sessionId, edges });\n\t\t} catch (error) {\n\t\t\tif (error instanceof PersistenceCorruptionError) throw error;\n\t\t\tthrow new PersistenceCorruptionError(path, error);\n\t\t}\n\t}\n\treturn records;\n}\n\nasync function loadLegacySummaries(sourceDataDir: string): Promise<SummarySessionV2[]> {\n\tconst records: SummarySessionV2[] = [];\n\tfor (const path of await namespaceFiles(sourceDataDir, 'summaries')) {\n\t\tconst sessionId = asSessionId(basename(path, '.json'));\n\t\ttry {\n\t\t\tconst summaries = v\n\t\t\t\t.parse(v.array(SummarySchema), await parseJson(path))\n\t\t\t\t.map((summary) => parseSummary(summary, path));\n\t\t\tif (summaries.length > 0) records.push({ sessionId, summaries });\n\t\t} catch (error) {\n\t\t\tif (error instanceof PersistenceCorruptionError) throw error;\n\t\t\tthrow new PersistenceCorruptionError(path, error);\n\t\t}\n\t}\n\treturn records;\n}\n\nasync function loadLegacySnapshot(sourceDataDir: string): Promise<FileSnapshotV2> {\n\tawait validateLegacyLayout(sourceDataDir);\n\treturn {\n\t\t...EMPTY_FILE_SNAPSHOT_V2,\n\t\tthoughts: await loadLegacyHistory(sourceDataDir),\n\t\tbranches: await loadLegacyBranches(sourceDataDir),\n\t\tedges: await loadLegacyEdges(sourceDataDir),\n\t\tsummaries: await loadLegacySummaries(sourceDataDir),\n\t};\n}\n\nexport async function importLegacyFileV1(\n\tsourceDataDir: string,\n\tdestinationDataDir: string\n): Promise<void> {\n\tif (!(await destinationIsAbsent(destinationDataDir))) {\n\t\tthrow new PersistenceCompatibilityError(destinationDataDir, 'destination must be absent');\n\t}\n\tconst snapshot = await loadLegacySnapshot(sourceDataDir);\n\tawait mkdir(dirname(destinationDataDir), { recursive: true });\n\tconst stagingDir = await mkdtemp(\n\t\tjoin(dirname(destinationDataDir), `.${basename(destinationDataDir)}.import-`)\n\t);\n\tconst writer = new FileWriter(stagingDir);\n\ttry {\n\t\tawait writer.ready();\n\t\tawait writer.run(async (dataDir) => {\n\t\t\tconst snapshotPath = join(dataDir, 'snapshot.json');\n\t\t\tawait writer.publish(snapshotPath, serializeFileSnapshotV2(snapshot, snapshotPath));\n\t\t});\n\t\tawait writer.close();\n\t\tparseFileSnapshotV2(\n\t\t\tawait readFile(join(stagingDir, 'snapshot.json'), 'utf-8'),\n\t\t\tjoin(stagingDir, 'snapshot.json')\n\t\t);\n\t\tawait rename(stagingDir, destinationDataDir);\n\t} catch (error) {\n\t\tawait writer.close();\n\t\tawait rm(stagingDir, { recursive: true, force: true });\n\t\tthrow error;\n\t}\n}\n"],"names":["LEGACY_NAMESPACES","destinationIsAbsent","path","lstat","error","isFileNotFound","parseJson","JSON","readFile","SyntaxError","PersistenceCorruptionError","parseThoughtArray","raw","v","thought","parseThoughtData","PersistenceCompatibilityError","namespaceFiles","sourceDataDir","namespace","directory","join","entries","readdir","entry","compareCodePoint","validateLegacyLayout","allowed","Set","groupHistory","thoughts","grouped","Map","sessionId","GLOBAL_SESSION_ID","history","sessionThoughts","loadLegacyHistory","historyPath","loadLegacyBranches","records","branchId","parsePersistenceBranchId","basename","PersistenceLegacyAmbiguityError","sessions","undefined","loadLegacyEdges","asSessionId","edges","EdgeSchema","parseEdge","loadLegacySummaries","summaries","SummarySchema","summary","parseSummary","loadLegacySnapshot","EMPTY_FILE_SNAPSHOT_V2","importLegacyFileV1","destinationDataDir","snapshot","mkdir","dirname","stagingDir","mkdtemp","writer","FileWriter","dataDir","snapshotPath","serializeFileSnapshotV2","parseFileSnapshotV2","rename","rm"],"mappings":"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"}

package/dist/persistence/FilePersistence.d.ts

@@ -0,0 +1,53 @@
+import type { IMetrics } from '../contracts/interfaces.js';
+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 FileWriterOperations } from './FileWriter.js';
+type FilePersistenceOptions = NonNullable<PersistenceConfig['options']> & {
+    readonly metrics?: IMetrics;
+    readonly writerOperations?: FileWriterOperations;
+};
+export declare class FilePersistence implements SessionScopedPersistenceBackend {
+    private readonly _dataDir;
+    private readonly _maxHistorySize;
+    private readonly _persistBranches;
+    private readonly _metrics;
+    private readonly _writer;
+    constructor(options?: FilePersistenceOptions);
+    static create(options?: FilePersistenceOptions): Promise<FilePersistence>;
+    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>;
+    getDataDir(): string;
+    getBranchIds(): Promise<string[]>;
+    close(): Promise<void>;
+    private _read;
+    private _mutate;
+    private _loadSnapshot;
+    private _legacyArtifacts;
+    private _measure;
+}
+export {};
+//# sourceMappingURL=FilePersistence.d.ts.map

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

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

package/dist/persistence/FilePersistence.js

@@ -0,0 +1,312 @@
+import { existsSync } from "node:fs";
+import { readFile, readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { GLOBAL_SESSION_ID, asSessionId } from "../contracts/ids.js";
+import { PersistenceImportRequiredError } from "../errors.js";
+import { EMPTY_FILE_SNAPSHOT_V2, parseFileSnapshotV2, serializeFileSnapshotV2, sessionsInSnapshot } from "./FileSnapshotV2.js";
+import { FileWriter, isFileNotFound } from "./FileWriter.js";
+import { assertBranchScope, assertEdgeScopes, assertPersistableThoughtCollections, assertPersistableThoughts, assertSummaryScopes, assertThoughtScope, compareCodePoint, parsePersistenceBranchId } from "./PersistenceScope.js";
+const SNAPSHOT_NAME = 'snapshot.json';
+const LEGACY_DIRECTORIES = [
+    'branches',
+    'edges',
+    'summaries'
+];
+class FilePersistence {
+    _dataDir;
+    _maxHistorySize;
+    _persistBranches;
+    _metrics;
+    _writer;
+    constructor(options){
+        const defaultDataDir = existsSync('.claude/data') ? '.claude/data' : join(homedir(), '.claude/data');
+        this._dataDir = options?.dataDir ?? defaultDataDir;
+        this._maxHistorySize = options?.maxHistorySize ?? 10000;
+        this._persistBranches = options?.persistBranches ?? true;
+        this._metrics = options?.metrics;
+        this._writer = new FileWriter(this._dataDir, options?.writerOperations);
+    }
+    static async create(options) {
+        const persistence = new FilePersistence(options);
+        try {
+            await persistence._writer.ready();
+            await persistence._writer.run(async (dataDir)=>await persistence._loadSnapshot(dataDir));
+            return persistence;
+        } catch (error) {
+            await persistence.close();
+            throw error;
+        }
+    }
+    async saveThought(thought) {
+        assertThoughtScope('saveThought', GLOBAL_SESSION_ID, thought);
+        await this._saveThought(GLOBAL_SESSION_ID, thought);
+    }
+    async saveThoughtForSession(sessionId, thought) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertThoughtScope('saveThoughtForSession', validatedSessionId, thought);
+        await this._saveThought(validatedSessionId, thought);
+    }
+    async _saveThought(sessionId, thought) {
+        assertPersistableThoughts([
+            thought
+        ], `${sessionId}/thoughts`);
+        await this._mutate('save_thought', (snapshot)=>{
+            const current = snapshot.thoughts.find((record)=>record.sessionId === sessionId)?.thoughts ?? [];
+            const prospective = [
+                ...current,
+                thought
+            ];
+            assertPersistableThoughtCollections([
+                {
+                    sessionId,
+                    thoughts: prospective
+                },
+                ...snapshot.branches.filter((record)=>record.sessionId === sessionId).map((record)=>({
+                        sessionId,
+                        thoughts: record.thoughts
+                    }))
+            ], `${sessionId}/thoughts`);
+            const retained = this._maxHistorySize > 0 ? prospective.slice(-this._maxHistorySize) : prospective;
+            return {
+                ...snapshot,
+                thoughts: [
+                    ...snapshot.thoughts.filter((record)=>record.sessionId !== sessionId),
+                    {
+                        sessionId,
+                        thoughts: retained
+                    }
+                ]
+            };
+        });
+    }
+    async loadHistory() {
+        return await this.loadHistoryForSession(GLOBAL_SESSION_ID);
+    }
+    async loadHistoryForSession(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return await this._read('load_history', (snapshot)=>[
+                ...snapshot.thoughts.find((record)=>record.sessionId === validatedSessionId)?.thoughts ?? []
+            ]);
+    }
+    async saveBranch(branchId, thoughts) {
+        const validatedBranchId = parsePersistenceBranchId(branchId, 'global/branches');
+        assertBranchScope('saveBranch', GLOBAL_SESSION_ID, validatedBranchId, thoughts);
+        await this._saveBranch(GLOBAL_SESSION_ID, validatedBranchId, thoughts);
+    }
+    async saveBranchForSession(sessionId, branchId, thoughts) {
+        const validatedSessionId = asSessionId(sessionId);
+        const validatedBranchId = parsePersistenceBranchId(branchId, `${validatedSessionId}/branches`);
+        assertBranchScope('saveBranchForSession', validatedSessionId, validatedBranchId, thoughts);
+        await this._saveBranch(validatedSessionId, validatedBranchId, thoughts);
+    }
+    async _saveBranch(sessionId, branchId, thoughts) {
+        assertPersistableThoughtCollections([
+            {
+                sessionId,
+                thoughts
+            }
+        ], `${sessionId}/branches/${branchId}`);
+        if (!this._persistBranches) return void await this._writer.run(async (dataDir)=>{
+            const snapshot = await this._loadSnapshot(dataDir);
+            assertPersistableThoughtCollections([
+                {
+                    sessionId,
+                    thoughts: snapshot.thoughts.find((record)=>record.sessionId === sessionId)?.thoughts ?? []
+                },
+                ...snapshot.branches.filter((record)=>record.sessionId === sessionId).map((record)=>({
+                        sessionId,
+                        thoughts: record.thoughts
+                    })),
+                {
+                    sessionId,
+                    thoughts
+                }
+            ], `${sessionId}/branches/${branchId}`);
+        });
+        await this._mutate('save_branch', (snapshot)=>({
+                ...snapshot,
+                branches: [
+                    ...snapshot.branches.filter((record)=>record.sessionId !== sessionId || record.branchId !== branchId),
+                    {
+                        sessionId,
+                        branchId,
+                        thoughts: [
+                            ...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, `${validatedSessionId}/branches`);
+        await this._mutate('delete_branch', (snapshot)=>({
+                ...snapshot,
+                branches: snapshot.branches.filter((record)=>record.sessionId !== validatedSessionId || record.branchId !== 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, `${validatedSessionId}/branches`);
+        return await this._read('load_branch', (snapshot)=>{
+            const thoughts = snapshot.branches.find((record)=>record.sessionId === validatedSessionId && record.branchId === validatedBranchId)?.thoughts;
+            return void 0 === thoughts ? void 0 : [
+                ...thoughts
+            ];
+        });
+    }
+    async listBranches() {
+        return await this.listBranchesForSession(GLOBAL_SESSION_ID);
+    }
+    async listBranchesForSession(sessionId) {
+        if (!this._persistBranches) return [];
+        const validatedSessionId = asSessionId(sessionId);
+        return await this._read('list_branches', (snapshot)=>snapshot.branches.filter((record)=>record.sessionId === validatedSessionId).map((record)=>record.branchId).sort(compareCodePoint));
+    }
+    async listSessions() {
+        return await this._read('list_sessions', sessionsInSnapshot);
+    }
+    async clear() {
+        await this._mutate('clear', ()=>EMPTY_FILE_SNAPSHOT_V2);
+    }
+    async clearSession(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        await this._mutate('clear_session', (snapshot)=>({
+                version: 2,
+                thoughts: snapshot.thoughts.filter((record)=>record.sessionId !== validatedSessionId),
+                branches: snapshot.branches.filter((record)=>record.sessionId !== validatedSessionId),
+                edges: snapshot.edges.filter((record)=>record.sessionId !== validatedSessionId),
+                summaries: snapshot.summaries.filter((record)=>record.sessionId !== validatedSessionId)
+            }));
+    }
+    async saveEdges(sessionId, edges) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertEdgeScopes(validatedSessionId, edges);
+        await this._mutate('save_edges', (snapshot)=>({
+                ...snapshot,
+                edges: [
+                    ...snapshot.edges.filter((record)=>record.sessionId !== validatedSessionId),
+                    ...0 === edges.length ? [] : [
+                        {
+                            sessionId: validatedSessionId,
+                            edges: [
+                                ...edges
+                            ]
+                        }
+                    ]
+                ]
+            }));
+    }
+    async loadEdges(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return await this._read('load_edges', (snapshot)=>[
+                ...snapshot.edges.find((record)=>record.sessionId === validatedSessionId)?.edges ?? []
+            ]);
+    }
+    async listEdgeSessions() {
+        return await this._read('list_edge_sessions', (snapshot)=>snapshot.edges.map((record)=>record.sessionId).sort(compareCodePoint));
+    }
+    async saveSummaries(sessionId, summaries) {
+        const validatedSessionId = asSessionId(sessionId);
+        assertSummaryScopes(validatedSessionId, summaries);
+        await this._mutate('save_summaries', (snapshot)=>({
+                ...snapshot,
+                summaries: [
+                    ...snapshot.summaries.filter((record)=>record.sessionId !== validatedSessionId),
+                    ...0 === summaries.length ? [] : [
+                        {
+                            sessionId: validatedSessionId,
+                            summaries: [
+                                ...summaries
+                            ]
+                        }
+                    ]
+                ]
+            }));
+    }
+    async loadSummaries(sessionId) {
+        const validatedSessionId = asSessionId(sessionId);
+        return await this._read('load_summaries', (snapshot)=>[
+                ...snapshot.summaries.find((record)=>record.sessionId === validatedSessionId)?.summaries ?? []
+            ]);
+    }
+    async healthy() {
+        try {
+            await this._writer.run(async (dataDir)=>await this._loadSnapshot(dataDir));
+            return true;
+        } catch (error) {
+            if (error instanceof Error) return false;
+            throw error;
+        }
+    }
+    getDataDir() {
+        return this._dataDir;
+    }
+    async getBranchIds() {
+        return await this.listBranches();
+    }
+    async close() {
+        await this._writer.close();
+    }
+    async _read(operation, select) {
+        return await this._measure(operation, async ()=>await this._writer.run(async (dataDir)=>select(await this._loadSnapshot(dataDir))));
+    }
+    async _mutate(operation, mutate) {
+        await this._measure(operation, async ()=>{
+            await this._writer.run(async (dataDir)=>{
+                const snapshotPath = join(dataDir, SNAPSHOT_NAME);
+                const updated = mutate(await this._loadSnapshot(dataDir));
+                await this._writer.publish(snapshotPath, serializeFileSnapshotV2(updated, snapshotPath));
+            });
+        });
+    }
+    async _loadSnapshot(dataDir) {
+        const snapshotPath = join(dataDir, SNAPSHOT_NAME);
+        try {
+            return parseFileSnapshotV2(await readFile(snapshotPath, 'utf-8'), snapshotPath);
+        } catch (error) {
+            if (!isFileNotFound(error)) throw error;
+        }
+        const legacyArtifacts = await this._legacyArtifacts(dataDir);
+        if (legacyArtifacts.length > 0) throw new PersistenceImportRequiredError(dataDir, legacyArtifacts);
+        return EMPTY_FILE_SNAPSHOT_V2;
+    }
+    async _legacyArtifacts(dataDir) {
+        const artifacts = [];
+        try {
+            await readFile(join(dataDir, 'history.json'), 'utf-8');
+            artifacts.push('history.json');
+        } catch (error) {
+            if (!isFileNotFound(error)) throw error;
+        }
+        for (const directory of LEGACY_DIRECTORIES)try {
+            const files = await readdir(join(dataDir, directory));
+            artifacts.push(...files.filter((file)=>file.endsWith('.json')).map((file)=>`${directory}/${file}`));
+        } catch (error) {
+            if (!isFileNotFound(error)) throw error;
+        }
+        return artifacts.sort(compareCodePoint);
+    }
+    async _measure(operation, action) {
+        const startTime = Date.now();
+        try {
+            return await action();
+        } finally{
+            this._metrics?.histogram('persistence_op_duration_seconds', (Date.now() - startTime) / 1000, {
+                operation
+            });
+        }
+    }
+}
+export { FilePersistence };
+
+//# sourceMappingURL=FilePersistence.js.map

package/dist/persistence/FilePersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/FilePersistence.js","sources":["../../src/persistence/FilePersistence.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile, readdir } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport type { IMetrics } from '../contracts/interfaces.js';\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 { PersistenceImportRequiredError } from '../errors.js';\nimport {\n\tEMPTY_FILE_SNAPSHOT_V2,\n\tparseFileSnapshotV2,\n\tserializeFileSnapshotV2,\n\tsessionsInSnapshot,\n} from './FileSnapshotV2.js';\nimport type { FileSnapshotV2 } from './FileSnapshotTypes.js';\nimport { FileWriter, isFileNotFound, type FileWriterOperations } from './FileWriter.js';\nimport {\n\tassertBranchScope,\n\tassertEdgeScopes,\n\tassertPersistableThoughtCollections,\n\tassertPersistableThoughts,\n\tassertSummaryScopes,\n\tassertThoughtScope,\n\tcompareCodePoint,\n\tparsePersistenceBranchId,\n} from './PersistenceScope.js';\n\ntype FilePersistenceOptions = NonNullable<PersistenceConfig['options']> & {\n\treadonly metrics?: IMetrics;\n\treadonly writerOperations?: FileWriterOperations;\n};\n\nconst SNAPSHOT_NAME = 'snapshot.json';\nconst LEGACY_DIRECTORIES = ['branches', 'edges', 'summaries'] as const;\n\nexport class FilePersistence implements SessionScopedPersistenceBackend {\n\tprivate readonly _dataDir: string;\n\tprivate readonly _maxHistorySize: number;\n\tprivate readonly _persistBranches: boolean;\n\tprivate readonly _metrics: IMetrics | undefined;\n\tprivate readonly _writer: FileWriter;\n\n\tconstructor(options?: FilePersistenceOptions) {\n\t\tconst defaultDataDir = existsSync('.claude/data')\n\t\t\t? '.claude/data'\n\t\t\t: join(homedir(), '.claude/data');\n\t\tthis._dataDir = options?.dataDir ?? defaultDataDir;\n\t\tthis._maxHistorySize = options?.maxHistorySize ?? 10000;\n\t\tthis._persistBranches = options?.persistBranches ?? true;\n\t\tthis._metrics = options?.metrics;\n\t\tthis._writer = new FileWriter(this._dataDir, options?.writerOperations);\n\t}\n\n\tpublic static async create(options?: FilePersistenceOptions): Promise<FilePersistence> {\n\t\tconst persistence = new FilePersistence(options);\n\t\ttry {\n\t\t\tawait persistence._writer.ready();\n\t\t\tawait persistence._writer.run(async (dataDir) => await persistence._loadSnapshot(dataDir));\n\t\t\treturn persistence;\n\t\t} catch (error) {\n\t\t\tawait persistence.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\tawait this._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\tawait this._saveThought(validatedSessionId, thought);\n\t}\n\n\tprivate async _saveThought(sessionId: SessionId, thought: ThoughtData): Promise<void> {\n\t\tassertPersistableThoughts([thought], `${sessionId}/thoughts`);\n\t\tawait this._mutate('save_thought', (snapshot) => {\n\t\t\tconst current =\n\t\t\t\tsnapshot.thoughts.find((record) => record.sessionId === sessionId)?.thoughts ?? [];\n\t\t\tconst prospective = [...current, thought];\n\t\t\tassertPersistableThoughtCollections(\n\t\t\t\t[\n\t\t\t\t\t{ sessionId, thoughts: prospective },\n\t\t\t\t\t...snapshot.branches\n\t\t\t\t\t\t.filter((record) => record.sessionId === sessionId)\n\t\t\t\t\t\t.map((record) => ({ sessionId, thoughts: record.thoughts })),\n\t\t\t\t],\n\t\t\t\t`${sessionId}/thoughts`\n\t\t\t);\n\t\t\tconst retained =\n\t\t\t\tthis._maxHistorySize > 0 ? prospective.slice(-this._maxHistorySize) : prospective;\n\t\t\treturn {\n\t\t\t\t...snapshot,\n\t\t\t\tthoughts: [\n\t\t\t\t\t...snapshot.thoughts.filter((record) => record.sessionId !== sessionId),\n\t\t\t\t\t{ sessionId, thoughts: retained },\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 await this._read('load_history', (snapshot) => [\n\t\t\t...(snapshot.thoughts.find((record) => record.sessionId === validatedSessionId)?.thoughts ??\n\t\t\t\t[]),\n\t\t]);\n\t}\n\n\tpublic async saveBranch(branchId: BranchId, thoughts: ThoughtData[]): Promise<void> {\n\t\tconst validatedBranchId = parsePersistenceBranchId(branchId, 'global/branches');\n\t\tassertBranchScope('saveBranch', GLOBAL_SESSION_ID, validatedBranchId, thoughts);\n\t\tawait this._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, `${validatedSessionId}/branches`);\n\t\tassertBranchScope('saveBranchForSession', validatedSessionId, validatedBranchId, thoughts);\n\t\tawait this._saveBranch(validatedSessionId, validatedBranchId, thoughts);\n\t}\n\n\tprivate async _saveBranch(\n\t\tsessionId: SessionId,\n\t\tbranchId: BranchId,\n\t\tthoughts: readonly ThoughtData[]\n\t): Promise<void> {\n\t\tassertPersistableThoughtCollections(\n\t\t\t[{ sessionId, thoughts }],\n\t\t\t`${sessionId}/branches/${branchId}`\n\t\t);\n\t\tif (!this._persistBranches) {\n\t\t\tawait this._writer.run(async (dataDir) => {\n\t\t\t\tconst snapshot = await this._loadSnapshot(dataDir);\n\t\t\t\tassertPersistableThoughtCollections(\n\t\t\t\t\t[\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tsessionId,\n\t\t\t\t\t\t\tthoughts:\n\t\t\t\t\t\t\t\tsnapshot.thoughts.find((record) => record.sessionId === sessionId)?.thoughts ?? [],\n\t\t\t\t\t\t},\n\t\t\t\t\t\t...snapshot.branches\n\t\t\t\t\t\t\t.filter((record) => record.sessionId === sessionId)\n\t\t\t\t\t\t\t.map((record) => ({ sessionId, thoughts: record.thoughts })),\n\t\t\t\t\t\t{ sessionId, thoughts },\n\t\t\t\t\t],\n\t\t\t\t\t`${sessionId}/branches/${branchId}`\n\t\t\t\t);\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\t\tawait this._mutate('save_branch', (snapshot) => ({\n\t\t\t...snapshot,\n\t\t\tbranches: [\n\t\t\t\t...snapshot.branches.filter(\n\t\t\t\t\t(record) => record.sessionId !== sessionId || record.branchId !== branchId\n\t\t\t\t),\n\t\t\t\t{ sessionId, branchId, thoughts: [...thoughts] },\n\t\t\t],\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, `${validatedSessionId}/branches`);\n\t\tawait this._mutate('delete_branch', (snapshot) => ({\n\t\t\t...snapshot,\n\t\t\tbranches: snapshot.branches.filter(\n\t\t\t\t(record) => record.sessionId !== validatedSessionId || record.branchId !== validatedBranchId\n\t\t\t),\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, `${validatedSessionId}/branches`);\n\t\treturn await this._read('load_branch', (snapshot) => {\n\t\t\tconst thoughts = snapshot.branches.find(\n\t\t\t\t(record) => record.sessionId === validatedSessionId && record.branchId === validatedBranchId\n\t\t\t)?.thoughts;\n\t\t\treturn thoughts === undefined ? undefined : [...thoughts];\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\tconst validatedSessionId = asSessionId(sessionId);\n\t\treturn await this._read('list_branches', (snapshot) =>\n\t\t\tsnapshot.branches\n\t\t\t\t.filter((record) => record.sessionId === validatedSessionId)\n\t\t\t\t.map((record) => record.branchId)\n\t\t\t\t.sort(compareCodePoint)\n\t\t);\n\t}\n\n\tpublic async listSessions(): Promise<SessionId[]> {\n\t\treturn await this._read('list_sessions', sessionsInSnapshot);\n\t}\n\n\tpublic async clear(): Promise<void> {\n\t\tawait this._mutate('clear', () => EMPTY_FILE_SNAPSHOT_V2);\n\t}\n\n\tpublic async clearSession(sessionId: SessionId): Promise<void> {\n\t\tconst validatedSessionId = asSessionId(sessionId);\n\t\tawait this._mutate('clear_session', (snapshot) => ({\n\t\t\tversion: 2,\n\t\t\tthoughts: snapshot.thoughts.filter((record) => record.sessionId !== validatedSessionId),\n\t\t\tbranches: snapshot.branches.filter((record) => record.sessionId !== validatedSessionId),\n\t\t\tedges: snapshot.edges.filter((record) => record.sessionId !== validatedSessionId),\n\t\t\tsummaries: snapshot.summaries.filter((record) => record.sessionId !== validatedSessionId),\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\tawait this._mutate('save_edges', (snapshot) => ({\n\t\t\t...snapshot,\n\t\t\tedges: [\n\t\t\t\t...snapshot.edges.filter((record) => record.sessionId !== validatedSessionId),\n\t\t\t\t...(edges.length === 0 ? [] : [{ sessionId: validatedSessionId, edges: [...edges] }]),\n\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 await this._read('load_edges', (snapshot) => [\n\t\t\t...(snapshot.edges.find((record) => record.sessionId === validatedSessionId)?.edges ?? []),\n\t\t]);\n\t}\n\n\tpublic async listEdgeSessions(): Promise<SessionId[]> {\n\t\treturn await this._read('list_edge_sessions', (snapshot) =>\n\t\t\tsnapshot.edges.map((record) => record.sessionId).sort(compareCodePoint)\n\t\t);\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\tawait this._mutate('save_summaries', (snapshot) => ({\n\t\t\t...snapshot,\n\t\t\tsummaries: [\n\t\t\t\t...snapshot.summaries.filter((record) => record.sessionId !== validatedSessionId),\n\t\t\t\t...(summaries.length === 0\n\t\t\t\t\t? []\n\t\t\t\t\t: [{ sessionId: validatedSessionId, summaries: [...summaries] }]),\n\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 await this._read('load_summaries', (snapshot) => [\n\t\t\t...(snapshot.summaries.find((record) => record.sessionId === validatedSessionId)?.summaries ??\n\t\t\t\t[]),\n\t\t]);\n\t}\n\n\tpublic async healthy(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this._writer.run(async (dataDir) => await this._loadSnapshot(dataDir));\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 getDataDir(): string {\n\t\treturn this._dataDir;\n\t}\n\n\tpublic async getBranchIds(): Promise<string[]> {\n\t\treturn await this.listBranches();\n\t}\n\n\tpublic async close(): Promise<void> {\n\t\tawait this._writer.close();\n\t}\n\n\tprivate async _read<T>(operation: string, select: (snapshot: FileSnapshotV2) => T): Promise<T> {\n\t\treturn await this._measure(\n\t\t\toperation,\n\t\t\tasync () =>\n\t\t\t\tawait this._writer.run(async (dataDir) => select(await this._loadSnapshot(dataDir)))\n\t\t);\n\t}\n\n\tprivate async _mutate(\n\t\toperation: string,\n\t\tmutate: (snapshot: FileSnapshotV2) => FileSnapshotV2\n\t): Promise<void> {\n\t\tawait this._measure(operation, async () => {\n\t\t\tawait this._writer.run(async (dataDir) => {\n\t\t\t\tconst snapshotPath = join(dataDir, SNAPSHOT_NAME);\n\t\t\t\tconst updated = mutate(await this._loadSnapshot(dataDir));\n\t\t\t\tawait this._writer.publish(snapshotPath, serializeFileSnapshotV2(updated, snapshotPath));\n\t\t\t});\n\t\t});\n\t}\n\n\tprivate async _loadSnapshot(dataDir: string): Promise<FileSnapshotV2> {\n\t\tconst snapshotPath = join(dataDir, SNAPSHOT_NAME);\n\t\ttry {\n\t\t\treturn parseFileSnapshotV2(await readFile(snapshotPath, 'utf-8'), snapshotPath);\n\t\t} catch (error) {\n\t\t\tif (!isFileNotFound(error)) throw error;\n\t\t}\n\t\tconst legacyArtifacts = await this._legacyArtifacts(dataDir);\n\t\tif (legacyArtifacts.length > 0) {\n\t\t\tthrow new PersistenceImportRequiredError(dataDir, legacyArtifacts);\n\t\t}\n\t\treturn EMPTY_FILE_SNAPSHOT_V2;\n\t}\n\n\tprivate async _legacyArtifacts(dataDir: string): Promise<string[]> {\n\t\tconst artifacts: string[] = [];\n\t\ttry {\n\t\t\tawait readFile(join(dataDir, 'history.json'), 'utf-8');\n\t\t\tartifacts.push('history.json');\n\t\t} catch (error) {\n\t\t\tif (!isFileNotFound(error)) throw error;\n\t\t}\n\t\tfor (const directory of LEGACY_DIRECTORIES) {\n\t\t\ttry {\n\t\t\t\tconst files = await readdir(join(dataDir, directory));\n\t\t\t\tartifacts.push(\n\t\t\t\t\t...files.filter((file) => file.endsWith('.json')).map((file) => `${directory}/${file}`)\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tif (!isFileNotFound(error)) throw error;\n\t\t\t}\n\t\t}\n\t\treturn artifacts.sort(compareCodePoint);\n\t}\n\n\tprivate async _measure<T>(operation: string, action: () => Promise<T>): Promise<T> {\n\t\tconst startTime = Date.now();\n\t\ttry {\n\t\t\treturn await action();\n\t\t} finally {\n\t\t\tthis._metrics?.histogram('persistence_op_duration_seconds', (Date.now() - startTime) / 1000, {\n\t\t\t\toperation,\n\t\t\t});\n\t\t}\n\t}\n}\n"],"names":["SNAPSHOT_NAME","LEGACY_DIRECTORIES","FilePersistence","options","defaultDataDir","existsSync","join","homedir","FileWriter","persistence","dataDir","error","thought","assertThoughtScope","GLOBAL_SESSION_ID","sessionId","validatedSessionId","asSessionId","assertPersistableThoughts","snapshot","current","record","prospective","assertPersistableThoughtCollections","retained","branchId","thoughts","validatedBranchId","parsePersistenceBranchId","assertBranchScope","undefined","compareCodePoint","sessionsInSnapshot","EMPTY_FILE_SNAPSHOT_V2","edges","assertEdgeScopes","summaries","assertSummaryScopes","Error","operation","select","mutate","snapshotPath","updated","serializeFileSnapshotV2","parseFileSnapshotV2","readFile","isFileNotFound","legacyArtifacts","PersistenceImportRequiredError","artifacts","directory","files","readdir","file","action","startTime","Date"],"mappings":";;;;;;;;;AAsCA,MAAMA,gBAAgB;AACtB,MAAMC,qBAAqB;IAAC;IAAY;IAAS;CAAY;AAEtD,MAAMC;IACK,SAAiB;IACjB,gBAAwB;IACxB,iBAA0B;IAC1B,SAA+B;IAC/B,QAAoB;IAErC,YAAYC,OAAgC,CAAE;QAC7C,MAAMC,iBAAiBC,WAAW,kBAC/B,iBACAC,KAAKC,WAAW;QACnB,IAAI,CAAC,QAAQ,GAAGJ,SAAS,WAAWC;QACpC,IAAI,CAAC,eAAe,GAAGD,SAAS,kBAAkB;QAClD,IAAI,CAAC,gBAAgB,GAAGA,SAAS,mBAAmB;QACpD,IAAI,CAAC,QAAQ,GAAGA,SAAS;QACzB,IAAI,CAAC,OAAO,GAAG,IAAIK,WAAW,IAAI,CAAC,QAAQ,EAAEL,SAAS;IACvD;IAEA,aAAoB,OAAOA,OAAgC,EAA4B;QACtF,MAAMM,cAAc,IAAIP,gBAAgBC;QACxC,IAAI;YACH,MAAMM,YAAY,OAAO,CAAC,KAAK;YAC/B,MAAMA,YAAY,OAAO,CAAC,GAAG,CAAC,OAAOC,UAAY,MAAMD,YAAY,aAAa,CAACC;YACjF,OAAOD;QACR,EAAE,OAAOE,OAAO;YACf,MAAMF,YAAY,KAAK;YACvB,MAAME;QACP;IACD;IAEA,MAAa,YAAYC,OAAoB,EAAiB;QAC7DC,mBAAmB,eAAeC,mBAAmBF;QACrD,MAAM,IAAI,CAAC,YAAY,CAACE,mBAAmBF;IAC5C;IAEA,MAAa,sBAAsBG,SAAoB,EAAEH,OAAoB,EAAiB;QAC7F,MAAMI,qBAAqBC,YAAYF;QACvCF,mBAAmB,yBAAyBG,oBAAoBJ;QAChE,MAAM,IAAI,CAAC,YAAY,CAACI,oBAAoBJ;IAC7C;IAEA,MAAc,aAAaG,SAAoB,EAAEH,OAAoB,EAAiB;QACrFM,0BAA0B;YAACN;SAAQ,EAAE,GAAGG,UAAU,SAAS,CAAC;QAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAACI;YACnC,MAAMC,UACLD,SAAS,QAAQ,CAAC,IAAI,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKN,YAAY,YAAY,EAAE;YACnF,MAAMO,cAAc;mBAAIF;gBAASR;aAAQ;YACzCW,oCACC;gBACC;oBAAER;oBAAW,UAAUO;gBAAY;mBAChCH,SAAS,QAAQ,CAClB,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKN,WACxC,GAAG,CAAC,CAACM,SAAY;wBAAEN;wBAAW,UAAUM,OAAO,QAAQ;oBAAC;aAC1D,EACD,GAAGN,UAAU,SAAS,CAAC;YAExB,MAAMS,WACL,IAAI,CAAC,eAAe,GAAG,IAAIF,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,IAAIA;YACvE,OAAO;gBACN,GAAGH,QAAQ;gBACX,UAAU;uBACNA,SAAS,QAAQ,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKN;oBAC7D;wBAAEA;wBAAW,UAAUS;oBAAS;iBAChC;YACF;QACD;IACD;IAEA,MAAa,cAAsC;QAClD,OAAO,MAAM,IAAI,CAAC,qBAAqB,CAACV;IACzC;IAEA,MAAa,sBAAsBC,SAAoB,EAA0B;QAChF,MAAMC,qBAAqBC,YAAYF;QACvC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAACI,WAAa;mBACjDA,SAAS,QAAQ,CAAC,IAAI,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL,qBAAqB,YAChF,EAAE;aACH;IACF;IAEA,MAAa,WAAWS,QAAkB,EAAEC,QAAuB,EAAiB;QACnF,MAAMC,oBAAoBC,yBAAyBH,UAAU;QAC7DI,kBAAkB,cAAcf,mBAAmBa,mBAAmBD;QACtE,MAAM,IAAI,CAAC,WAAW,CAACZ,mBAAmBa,mBAAmBD;IAC9D;IAEA,MAAa,qBACZX,SAAoB,EACpBU,QAAkB,EAClBC,QAAgC,EAChB;QAChB,MAAMV,qBAAqBC,YAAYF;QACvC,MAAMY,oBAAoBC,yBAAyBH,UAAU,GAAGT,mBAAmB,SAAS,CAAC;QAC7Fa,kBAAkB,wBAAwBb,oBAAoBW,mBAAmBD;QACjF,MAAM,IAAI,CAAC,WAAW,CAACV,oBAAoBW,mBAAmBD;IAC/D;IAEA,MAAc,YACbX,SAAoB,EACpBU,QAAkB,EAClBC,QAAgC,EAChB;QAChBH,oCACC;YAAC;gBAAER;gBAAWW;YAAS;SAAE,EACzB,GAAGX,UAAU,UAAU,EAAEU,UAAU;QAEpC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAC3B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAOf;YAC7B,MAAMS,WAAW,MAAM,IAAI,CAAC,aAAa,CAACT;YAC1Ca,oCACC;gBACC;oBACCR;oBACA,UACCI,SAAS,QAAQ,CAAC,IAAI,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKN,YAAY,YAAY,EAAE;gBACpF;mBACGI,SAAS,QAAQ,CAClB,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKN,WACxC,GAAG,CAAC,CAACM,SAAY;wBAAEN;wBAAW,UAAUM,OAAO,QAAQ;oBAAC;gBAC1D;oBAAEN;oBAAWW;gBAAS;aACtB,EACD,GAAGX,UAAU,UAAU,EAAEU,UAAU;QAErC;QAGD,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAACN,WAAc;gBAChD,GAAGA,QAAQ;gBACX,UAAU;uBACNA,SAAS,QAAQ,CAAC,MAAM,CAC1B,CAACE,SAAWA,OAAO,SAAS,KAAKN,aAAaM,OAAO,QAAQ,KAAKI;oBAEnE;wBAAEV;wBAAWU;wBAAU,UAAU;+BAAIC;yBAAS;oBAAC;iBAC/C;YACF;IACD;IAEA,MAAa,aAAaD,QAAkB,EAAiB;QAC5D,MAAM,IAAI,CAAC,sBAAsB,CAACX,mBAAmBW;IACtD;IAEA,MAAa,uBAAuBV,SAAoB,EAAEU,QAAkB,EAAiB;QAC5F,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC5B,MAAMT,qBAAqBC,YAAYF;QACvC,MAAMY,oBAAoBC,yBAAyBH,UAAU,GAAGT,mBAAmB,SAAS,CAAC;QAC7F,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAACG,WAAc;gBAClD,GAAGA,QAAQ;gBACX,UAAUA,SAAS,QAAQ,CAAC,MAAM,CACjC,CAACE,SAAWA,OAAO,SAAS,KAAKL,sBAAsBK,OAAO,QAAQ,KAAKM;YAE7E;IACD;IAEA,MAAa,WAAWF,QAAkB,EAAsC;QAC/E,OAAO,MAAM,IAAI,CAAC,oBAAoB,CAACX,mBAAmBW;IAC3D;IAEA,MAAa,qBACZV,SAAoB,EACpBU,QAAkB,EACmB;QACrC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC5B,MAAMT,qBAAqBC,YAAYF;QACvC,MAAMY,oBAAoBC,yBAAyBH,UAAU,GAAGT,mBAAmB,SAAS,CAAC;QAC7F,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAACG;YACvC,MAAMO,WAAWP,SAAS,QAAQ,CAAC,IAAI,CACtC,CAACE,SAAWA,OAAO,SAAS,KAAKL,sBAAsBK,OAAO,QAAQ,KAAKM,oBACzE;YACH,OAAOD,AAAaI,WAAbJ,WAAyBI,SAAY;mBAAIJ;aAAS;QAC1D;IACD;IAEA,MAAa,eAAoC;QAChD,OAAO,MAAM,IAAI,CAAC,sBAAsB,CAACZ;IAC1C;IAEA,MAAa,uBAAuBC,SAAoB,EAAuB;QAC9E,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE;QACrC,MAAMC,qBAAqBC,YAAYF;QACvC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAACI,WACzCA,SAAS,QAAQ,CACf,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL,oBACxC,GAAG,CAAC,CAACK,SAAWA,OAAO,QAAQ,EAC/B,IAAI,CAACU;IAET;IAEA,MAAa,eAAqC;QACjD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiBC;IAC1C;IAEA,MAAa,QAAuB;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,IAAMC;IACnC;IAEA,MAAa,aAAalB,SAAoB,EAAiB;QAC9D,MAAMC,qBAAqBC,YAAYF;QACvC,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAACI,WAAc;gBAClD,SAAS;gBACT,UAAUA,SAAS,QAAQ,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;gBACpE,UAAUG,SAAS,QAAQ,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;gBACpE,OAAOG,SAAS,KAAK,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;gBAC9D,WAAWG,SAAS,SAAS,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;YACvE;IACD;IAEA,MAAa,UAAUD,SAAoB,EAAEmB,KAAsB,EAAiB;QACnF,MAAMlB,qBAAqBC,YAAYF;QACvCoB,iBAAiBnB,oBAAoBkB;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAACf,WAAc;gBAC/C,GAAGA,QAAQ;gBACX,OAAO;uBACHA,SAAS,KAAK,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;uBACtDkB,AAAiB,MAAjBA,MAAM,MAAM,GAAS,EAAE,GAAG;wBAAC;4BAAE,WAAWlB;4BAAoB,OAAO;mCAAIkB;6BAAM;wBAAC;qBAAE;iBACpF;YACF;IACD;IAEA,MAAa,UAAUnB,SAAoB,EAAmB;QAC7D,MAAMC,qBAAqBC,YAAYF;QACvC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAACI,WAAa;mBAC/CA,SAAS,KAAK,CAAC,IAAI,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL,qBAAqB,SAAS,EAAE;aACzF;IACF;IAEA,MAAa,mBAAyC;QACrD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAACG,WAC9CA,SAAS,KAAK,CAAC,GAAG,CAAC,CAACE,SAAWA,OAAO,SAAS,EAAE,IAAI,CAACU;IAExD;IAEA,MAAa,cAAchB,SAAoB,EAAEqB,SAA6B,EAAiB;QAC9F,MAAMpB,qBAAqBC,YAAYF;QACvCsB,oBAAoBrB,oBAAoBoB;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAACjB,WAAc;gBACnD,GAAGA,QAAQ;gBACX,WAAW;uBACPA,SAAS,SAAS,CAAC,MAAM,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL;uBAC1DoB,AAAqB,MAArBA,UAAU,MAAM,GACjB,EAAE,GACF;wBAAC;4BAAE,WAAWpB;4BAAoB,WAAW;mCAAIoB;6BAAU;wBAAC;qBAAE;iBACjE;YACF;IACD;IAEA,MAAa,cAAcrB,SAAoB,EAAsB;QACpE,MAAMC,qBAAqBC,YAAYF;QACvC,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAACI,WAAa;mBACnDA,SAAS,SAAS,CAAC,IAAI,CAAC,CAACE,SAAWA,OAAO,SAAS,KAAKL,qBAAqB,aACjF,EAAE;aACH;IACF;IAEA,MAAa,UAA4B;QACxC,IAAI;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAON,UAAY,MAAM,IAAI,CAAC,aAAa,CAACA;YACnE,OAAO;QACR,EAAE,OAAOC,OAAO;YACf,IAAIA,iBAAiB2B,OAAO,OAAO;YACnC,MAAM3B;QACP;IACD;IAEO,aAAqB;QAC3B,OAAO,IAAI,CAAC,QAAQ;IACrB;IAEA,MAAa,eAAkC;QAC9C,OAAO,MAAM,IAAI,CAAC,YAAY;IAC/B;IAEA,MAAa,QAAuB;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK;IACzB;IAEA,MAAc,MAAS4B,SAAiB,EAAEC,MAAuC,EAAc;QAC9F,OAAO,MAAM,IAAI,CAAC,QAAQ,CACzBD,WACA,UACC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO7B,UAAY8B,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC9B;IAE7E;IAEA,MAAc,QACb6B,SAAiB,EACjBE,MAAoD,EACpC;QAChB,MAAM,IAAI,CAAC,QAAQ,CAACF,WAAW;YAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO7B;gBAC7B,MAAMgC,eAAepC,KAAKI,SAASV;gBACnC,MAAM2C,UAAUF,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC/B;gBAChD,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAACgC,cAAcE,wBAAwBD,SAASD;YAC3E;QACD;IACD;IAEA,MAAc,cAAchC,OAAe,EAA2B;QACrE,MAAMgC,eAAepC,KAAKI,SAASV;QACnC,IAAI;YACH,OAAO6C,oBAAoB,MAAMC,SAASJ,cAAc,UAAUA;QACnE,EAAE,OAAO/B,OAAO;YACf,IAAI,CAACoC,eAAepC,QAAQ,MAAMA;QACnC;QACA,MAAMqC,kBAAkB,MAAM,IAAI,CAAC,gBAAgB,CAACtC;QACpD,IAAIsC,gBAAgB,MAAM,GAAG,GAC5B,MAAM,IAAIC,+BAA+BvC,SAASsC;QAEnD,OAAOf;IACR;IAEA,MAAc,iBAAiBvB,OAAe,EAAqB;QAClE,MAAMwC,YAAsB,EAAE;QAC9B,IAAI;YACH,MAAMJ,SAASxC,KAAKI,SAAS,iBAAiB;YAC9CwC,UAAU,IAAI,CAAC;QAChB,EAAE,OAAOvC,OAAO;YACf,IAAI,CAACoC,eAAepC,QAAQ,MAAMA;QACnC;QACA,KAAK,MAAMwC,aAAalD,mBACvB,IAAI;YACH,MAAMmD,QAAQ,MAAMC,QAAQ/C,KAAKI,SAASyC;YAC1CD,UAAU,IAAI,IACVE,MAAM,MAAM,CAAC,CAACE,OAASA,KAAK,QAAQ,CAAC,UAAU,GAAG,CAAC,CAACA,OAAS,GAAGH,UAAU,CAAC,EAAEG,MAAM;QAExF,EAAE,OAAO3C,OAAO;YACf,IAAI,CAACoC,eAAepC,QAAQ,MAAMA;QACnC;QAED,OAAOuC,UAAU,IAAI,CAACnB;IACvB;IAEA,MAAc,SAAYQ,SAAiB,EAAEgB,MAAwB,EAAc;QAClF,MAAMC,YAAYC,KAAK,GAAG;QAC1B,IAAI;YACH,OAAO,MAAMF;QACd,SAAU;YACT,IAAI,CAAC,QAAQ,EAAE,UAAU,mCAAoCE,AAAAA,CAAAA,KAAK,GAAG,KAAKD,SAAQ,IAAK,MAAM;gBAC5FjB;YACD;QACD;IACD;AACD"}