tracelattice 1.2.5

package/dist/persistence/FilePersistence.js

@@ -0,0 +1,132 @@
+import { existsSync } from "node:fs";
+import { mkdir, readFile, readdir, unlink, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve, sep } from "node:path";
+class FilePersistence {
+    _dataDir;
+    _historyPath;
+    _branchesDir;
+    _maxHistorySize;
+    _persistBranches;
+    _metrics;
+    constructor(options){
+        const defaultDataDir = existsSync('.claude/data') ? '.claude/data' : join(homedir(), '.claude/data');
+        this._dataDir = options?.dataDir ?? defaultDataDir;
+        this._historyPath = join(this._dataDir, 'history.json');
+        this._branchesDir = join(this._dataDir, 'branches');
+        this._maxHistorySize = options?.maxHistorySize ?? 10000;
+        this._persistBranches = options?.persistBranches ?? true;
+        this._metrics = options?.metrics;
+    }
+    _recordOperationDuration(operation, startTime) {
+        const durationSeconds = (Date.now() - startTime) / 1000;
+        this._metrics?.histogram('persistence_op_duration_seconds', durationSeconds, {
+            operation
+        });
+    }
+    async _ensureDirectories() {
+        if (!existsSync(this._dataDir)) await mkdir(this._dataDir, {
+            recursive: true
+        });
+        if (this._persistBranches && !existsSync(this._branchesDir)) await mkdir(this._branchesDir, {
+            recursive: true
+        });
+    }
+    _safeBranchPath(branchId) {
+        const validBranchIdPattern = /^[a-zA-Z0-9_-]{1,64}$/;
+        if (!validBranchIdPattern.test(branchId)) throw new Error("Invalid branch ID: must be 1-64 alphanumeric characters, hyphens, or underscores only");
+        const resolved = resolve(this._branchesDir, `${branchId}.json`);
+        const normalizedBranchesDir = resolve(this._branchesDir);
+        if (!resolved.startsWith(normalizedBranchesDir + sep)) throw new Error("Invalid branch ID: path traversal detected");
+        return resolved;
+    }
+    async saveThought(thought) {
+        const startTime = Date.now();
+        try {
+            await this._ensureDirectories();
+            const history = await this.loadHistory();
+            history.push(thought);
+            if (history.length > this._maxHistorySize) history.splice(0, history.length - this._maxHistorySize);
+            await writeFile(this._historyPath, JSON.stringify(history, null, 2), 'utf-8');
+        } finally{
+            this._recordOperationDuration('save_thought', startTime);
+        }
+    }
+    async loadHistory() {
+        const startTime = Date.now();
+        try {
+            if (!existsSync(this._historyPath)) return [];
+            const content = await readFile(this._historyPath, 'utf-8');
+            const data = JSON.parse(content);
+            return Array.isArray(data) ? data : [];
+        } catch  {
+            return [];
+        } finally{
+            this._recordOperationDuration('load_history', startTime);
+        }
+    }
+    async saveBranch(branchId, thoughts) {
+        const startTime = Date.now();
+        try {
+            if (!this._persistBranches) return;
+            await this._ensureDirectories();
+            const branchPath = this._safeBranchPath(branchId);
+            await writeFile(branchPath, JSON.stringify(thoughts, null, 2), 'utf-8');
+        } finally{
+            this._recordOperationDuration('save_branch', startTime);
+        }
+    }
+    async loadBranch(branchId) {
+        const startTime = Date.now();
+        try {
+            if (!this._persistBranches) return;
+            const branchPath = this._safeBranchPath(branchId);
+            try {
+                if (!existsSync(branchPath)) return;
+                const content = await readFile(branchPath, 'utf-8');
+                const data = JSON.parse(content);
+                return Array.isArray(data) ? data : void 0;
+            } catch  {
+                return;
+            }
+        } finally{
+            this._recordOperationDuration('load_branch', startTime);
+        }
+    }
+    async listBranches() {
+        return this.getBranchIds();
+    }
+    async clear() {
+        try {
+            if (existsSync(this._historyPath)) await unlink(this._historyPath);
+            if (this._persistBranches && existsSync(this._branchesDir)) {
+                const files = await readdir(this._branchesDir);
+                for (const file of files)if (file.endsWith('.json')) await unlink(join(this._branchesDir, file));
+            }
+        } catch  {}
+    }
+    async healthy() {
+        try {
+            await this._ensureDirectories();
+            return true;
+        } catch  {
+            return false;
+        }
+    }
+    getDataDir() {
+        return this._dataDir;
+    }
+    async getBranchIds() {
+        if (!this._persistBranches || !existsSync(this._branchesDir)) return [];
+        try {
+            const files = await readdir(this._branchesDir);
+            return files.filter((f)=>f.endsWith('.json')).map((f)=>f.replace('.json', ''));
+        } catch  {
+            return [];
+        }
+    }
+    async close() {}
+}
+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 { mkdir, readFile, readdir, unlink, writeFile } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { join, resolve, sep } from 'node:path';\nimport type { IMetrics } from '../contracts/index.js';\nimport type { ThoughtData } from '../core/thought.js';\nimport type { PersistenceBackend, PersistenceConfig } from './PersistenceBackend.js';\n\n/**\n * File-based persistence backend using JSON files.\n *\n * Stores thoughts and branches as JSON files in a configured directory.\n * Simple and reliable, with no external dependencies.\n *\n * File structure:\n * ```\n * dataDir/\n *   history.json          # Main thought history\n *   branches/\n *     <branch-id>.json    # Individual branch files\n * ```\n */\nexport class FilePersistence implements PersistenceBackend {\n\tprivate _dataDir: string;\n\tprivate _historyPath: string;\n\tprivate _branchesDir: string;\n\tprivate _maxHistorySize: number;\n\tprivate _persistBranches: boolean;\n\tprivate _metrics?: IMetrics;\n\n\tconstructor(options?: PersistenceConfig['options'] & { metrics?: IMetrics }) {\n\t\t// Default to .claude/data in current directory or home directory\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._historyPath = join(this._dataDir, 'history.json');\n\t\tthis._branchesDir = join(this._dataDir, 'branches');\n\t\tthis._maxHistorySize = options?.maxHistorySize ?? 10000;\n\t\tthis._persistBranches = options?.persistBranches ?? true;\n\t\tthis._metrics = options?.metrics;\n\t}\n\n\tprivate _recordOperationDuration(operation: string, startTime: number): void {\n\t\tconst durationSeconds = (Date.now() - startTime) / 1000;\n\t\tthis._metrics?.histogram('persistence_op_duration_seconds', durationSeconds, { operation });\n\t}\n\n\t/**\n\t * Initialize the persistence directory structure.\n\t */\n\tprivate async _ensureDirectories(): Promise<void> {\n\t\tif (!existsSync(this._dataDir)) {\n\t\t\tawait mkdir(this._dataDir, { recursive: true });\n\t\t}\n\t\tif (this._persistBranches && !existsSync(this._branchesDir)) {\n\t\t\tawait mkdir(this._branchesDir, { recursive: true });\n\t\t}\n\t}\n\n\t/**\n\t * Validates branch ID format and resolves the path safely.\n\t *\n\t * This method provides defense-in-depth security by:\n\t * 1. Validating the branch ID format (alphanumeric, hyphens, underscores only)\n\t * 2. Preventing path traversal attacks\n\t *\n\t * @param branchId - The branch ID to validate and resolve\n\t * @returns The safe, resolved branch file path\n\t * @throws Error if branch ID is invalid or path traversal is detected\n\t */\n\tprivate _safeBranchPath(branchId: string): string {\n\t\t// Validate format first (must be alphanumeric with hyphens/underscores, 1-64 chars)\n\t\tconst validBranchIdPattern = /^[a-zA-Z0-9_-]{1,64}$/;\n\t\tif (!validBranchIdPattern.test(branchId)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid branch ID: must be 1-64 alphanumeric characters, hyphens, or underscores only`\n\t\t\t);\n\t\t}\n\n\t\tconst resolved = resolve(this._branchesDir, `${branchId}.json`);\n\t\tconst normalizedBranchesDir = resolve(this._branchesDir);\n\n\t\t// Ensure the resolved path is still within branches directory\n\t\tif (!resolved.startsWith(normalizedBranchesDir + sep)) {\n\t\t\tthrow new Error(`Invalid branch ID: path traversal detected`);\n\t\t}\n\n\t\treturn resolved;\n\t}\n\n\tpublic async saveThought(thought: ThoughtData): Promise<void> {\n\t\tconst startTime = Date.now();\n\t\ttry {\n\t\t\tawait this._ensureDirectories();\n\n\t\t\tconst history = await this.loadHistory();\n\t\t\thistory.push(thought);\n\n\t\t\tif (history.length > this._maxHistorySize) {\n\t\t\t\thistory.splice(0, history.length - this._maxHistorySize);\n\t\t\t}\n\n\t\t\tawait writeFile(this._historyPath, JSON.stringify(history, null, 2), 'utf-8');\n\t\t} finally {\n\t\t\tthis._recordOperationDuration('save_thought', startTime);\n\t\t}\n\t}\n\n\tpublic async loadHistory(): Promise<ThoughtData[]> {\n\t\tconst startTime = Date.now();\n\t\ttry {\n\t\t\tif (!existsSync(this._historyPath)) {\n\t\t\t\treturn [];\n\t\t\t}\n\n\t\t\tconst content = await readFile(this._historyPath, 'utf-8');\n\t\t\tconst data = JSON.parse(content) as ThoughtData[];\n\n\t\t\t// Validate and filter\n\t\t\treturn Array.isArray(data) ? data : [];\n\t\t} catch {\n\t\t\t// If file is corrupted, start fresh\n\t\t\treturn [];\n\t\t} finally {\n\t\t\tthis._recordOperationDuration('load_history', startTime);\n\t\t}\n\t}\n\n\tpublic async saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void> {\n\t\tconst startTime = Date.now();\n\t\ttry {\n\t\t\tif (!this._persistBranches) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tawait this._ensureDirectories();\n\n\t\t\tconst branchPath = this._safeBranchPath(branchId);\n\t\t\tawait writeFile(branchPath, JSON.stringify(thoughts, null, 2), 'utf-8');\n\t\t} finally {\n\t\t\tthis._recordOperationDuration('save_branch', startTime);\n\t\t}\n\t}\n\n\tpublic async loadBranch(branchId: string): Promise<ThoughtData[] | undefined> {\n\t\tconst startTime = Date.now();\n\t\ttry {\n\t\t\tif (!this._persistBranches) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tconst branchPath = this._safeBranchPath(branchId);\n\n\t\t\ttry {\n\t\t\t\tif (!existsSync(branchPath)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\tconst content = await readFile(branchPath, 'utf-8');\n\t\t\t\tconst data = JSON.parse(content) as ThoughtData[];\n\n\t\t\t\treturn Array.isArray(data) ? data : undefined;\n\t\t\t} catch {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t} finally {\n\t\t\tthis._recordOperationDuration('load_branch', startTime);\n\t\t}\n\t}\n\n\tpublic async listBranches(): Promise<string[]> {\n\t\treturn this.getBranchIds();\n\t}\n\n\tpublic async clear(): Promise<void> {\n\t\ttry {\n\t\t\t// Clear history\n\t\t\tif (existsSync(this._historyPath)) {\n\t\t\t\tawait unlink(this._historyPath);\n\t\t\t}\n\n\t\t\t// Clear all branches\n\t\t\tif (this._persistBranches && existsSync(this._branchesDir)) {\n\t\t\t\tconst files = await readdir(this._branchesDir);\n\t\t\t\tfor (const file of files) {\n\t\t\t\t\tif (file.endsWith('.json')) {\n\t\t\t\t\t\tawait unlink(join(this._branchesDir, file));\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Ignore errors during clear\n\t\t}\n\t}\n\n\tpublic async healthy(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this._ensureDirectories();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Get the data directory path.\n\t */\n\tpublic getDataDir(): string {\n\t\treturn this._dataDir;\n\t}\n\n\t/**\n\t * Get all branch IDs that are persisted.\n\t */\n\tpublic async getBranchIds(): Promise<string[]> {\n\t\tif (!this._persistBranches || !existsSync(this._branchesDir)) {\n\t\t\treturn [];\n\t\t}\n\n\t\ttry {\n\t\t\tconst files = await readdir(this._branchesDir);\n\t\t\treturn files.filter((f) => f.endsWith('.json')).map((f) => f.replace('.json', ''));\n\t\t} catch {\n\t\t\treturn [];\n\t\t}\n\t}\n\n\t/**\n\t * Close the backend and release resources.\n\t * No resources to release for file backend.\n\t */\n\tpublic async close(): Promise<void> {\n\t\t// No-op for file backend (files are already flushed on write)\n\t}\n}\n"],"names":["FilePersistence","options","defaultDataDir","existsSync","join","homedir","operation","startTime","durationSeconds","Date","mkdir","branchId","validBranchIdPattern","Error","resolved","resolve","normalizedBranchesDir","sep","thought","history","writeFile","JSON","content","readFile","data","Array","thoughts","branchPath","undefined","unlink","files","readdir","file","f"],"mappings":"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"}

package/dist/persistence/MemoryPersistence.d.ts

@@ -0,0 +1,68 @@
+import type { ThoughtData } from '../core/thought.js';
+import type { PersistenceBackend } from './PersistenceBackend.js';
+/**
+ * Configuration options for MemoryPersistence.
+ */
+export interface MemoryPersistenceOptions {
+    /**
+     * Maximum number of thoughts to keep in memory.
+     * Older thoughts are trimmed when limit is exceeded.
+     * Set to 0 or undefined for unlimited.
+     * @default undefined (unlimited)
+     */
+    maxSize?: number;
+}
+/**
+ * In-memory persistence backend for testing purposes.
+ *
+ * This backend stores all data in memory and provides no durability.
+ * It's useful for testing and development where persistence is not needed.
+ *
+ * @example
+ * ```typescript
+ * // Unlimited history
+ * const backend = new MemoryPersistence();
+ *
+ * // Limited to 1000 thoughts
+ * const backend = new MemoryPersistence({ maxSize: 1000 });
+ *
+ * await backend.saveThought(thought);
+ * const history = await backend.loadHistory();
+ * ```
+ */
+export declare class MemoryPersistence implements PersistenceBackend {
+    private _history;
+    private _branches;
+    private _maxSize?;
+    constructor(options?: MemoryPersistenceOptions);
+    saveThought(thought: ThoughtData): Promise<void>;
+    loadHistory(): Promise<ThoughtData[]>;
+    saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void>;
+    loadBranch(branchId: string): Promise<ThoughtData[] | undefined>;
+    listBranches(): Promise<string[]>;
+    /**
+     * In-memory backend is always healthy.
+     */
+    healthy(): Promise<boolean>;
+    /**
+     * Clear all data from memory.
+     */
+    clear(): Promise<void>;
+    /**
+     * No resources to release for in-memory backend.
+     */
+    close(): Promise<void>;
+    /**
+     * Get the current number of thoughts in memory.
+     */
+    getHistorySize(): number;
+    /**
+     * Get the current number of branches in memory.
+     */
+    getBranchCount(): number;
+    /**
+     * Get all branch IDs.
+     */
+    getBranchIds(): string[];
+}
+//# sourceMappingURL=MemoryPersistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryPersistence.d.ts","sourceRoot":"","sources":["../../src/persistence/MemoryPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,OAAO,GAAE,wBAA6B;IAIrC,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIrC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC;IAKhE,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9C;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;OAEG;IACI,YAAY,IAAI,MAAM,EAAE;CAG/B"}

package/dist/persistence/MemoryPersistence.js

@@ -0,0 +1,51 @@
+class MemoryPersistence {
+    _history = [];
+    _branches = new Map();
+    _maxSize;
+    constructor(options = {}){
+        this._maxSize = options.maxSize && options.maxSize > 0 ? options.maxSize : void 0;
+    }
+    async saveThought(thought) {
+        this._history.push(thought);
+        if (void 0 !== this._maxSize && this._history.length > this._maxSize) this._history = this._history.slice(-this._maxSize);
+    }
+    async loadHistory() {
+        return [
+            ...this._history
+        ];
+    }
+    async saveBranch(branchId, thoughts) {
+        this._branches.set(branchId, [
+            ...thoughts
+        ]);
+    }
+    async loadBranch(branchId) {
+        const branch = this._branches.get(branchId);
+        return branch ? [
+            ...branch
+        ] : void 0;
+    }
+    async listBranches() {
+        return this.getBranchIds();
+    }
+    async healthy() {
+        return true;
+    }
+    async clear() {
+        this._history = [];
+        this._branches.clear();
+    }
+    async close() {}
+    getHistorySize() {
+        return this._history.length;
+    }
+    getBranchCount() {
+        return this._branches.size;
+    }
+    getBranchIds() {
+        return Array.from(this._branches.keys());
+    }
+}
+export { MemoryPersistence };
+
+//# sourceMappingURL=MemoryPersistence.js.map

package/dist/persistence/MemoryPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/MemoryPersistence.js","sources":["../../src/persistence/MemoryPersistence.ts"],"sourcesContent":["import type { ThoughtData } from '../core/thought.js';\nimport type { PersistenceBackend } from './PersistenceBackend.js';\n\n/**\n * Configuration options for MemoryPersistence.\n */\nexport interface MemoryPersistenceOptions {\n\t/**\n\t * Maximum number of thoughts to keep in memory.\n\t * Older thoughts are trimmed when limit is exceeded.\n\t * Set to 0 or undefined for unlimited.\n\t * @default undefined (unlimited)\n\t */\n\tmaxSize?: number;\n}\n\n/**\n * In-memory persistence backend for testing purposes.\n *\n * This backend stores all data in memory and provides no durability.\n * It's useful for testing and development where persistence is not needed.\n *\n * @example\n * ```typescript\n * // Unlimited history\n * const backend = new MemoryPersistence();\n *\n * // Limited to 1000 thoughts\n * const backend = new MemoryPersistence({ maxSize: 1000 });\n *\n * await backend.saveThought(thought);\n * const history = await backend.loadHistory();\n * ```\n */\nexport class MemoryPersistence implements PersistenceBackend {\n\tprivate _history: ThoughtData[] = [];\n\tprivate _branches: Map<string, ThoughtData[]> = new Map();\n\tprivate _maxSize?: number;\n\n\tconstructor(options: MemoryPersistenceOptions = {}) {\n\t\tthis._maxSize = options.maxSize && options.maxSize > 0 ? options.maxSize : undefined;\n\t}\n\n\tpublic async saveThought(thought: ThoughtData): Promise<void> {\n\t\tthis._history.push(thought);\n\n\t\t// Trim if maxSize is set and exceeded\n\t\tif (this._maxSize !== undefined && this._history.length > this._maxSize) {\n\t\t\tthis._history = this._history.slice(-this._maxSize);\n\t\t}\n\t}\n\n\tpublic async loadHistory(): Promise<ThoughtData[]> {\n\t\treturn [...this._history];\n\t}\n\n\tpublic async saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void> {\n\t\tthis._branches.set(branchId, [...thoughts]);\n\t}\n\n\tpublic async loadBranch(branchId: string): Promise<ThoughtData[] | undefined> {\n\t\tconst branch = this._branches.get(branchId);\n\t\treturn branch ? [...branch] : undefined;\n\t}\n\n\tpublic async listBranches(): Promise<string[]> {\n\t\treturn this.getBranchIds();\n\t}\n\n\t/**\n\t * In-memory backend is always healthy.\n\t */\n\tpublic async healthy(): Promise<boolean> {\n\t\treturn true;\n\t}\n\n\t/**\n\t * Clear all data from memory.\n\t */\n\tpublic async clear(): Promise<void> {\n\t\tthis._history = [];\n\t\tthis._branches.clear();\n\t}\n\n\t/**\n\t * No resources to release for in-memory backend.\n\t */\n\tpublic async close(): Promise<void> {\n\t\t// No-op for in-memory backend\n\t}\n\n\t/**\n\t * Get the current number of thoughts in memory.\n\t */\n\tpublic getHistorySize(): number {\n\t\treturn this._history.length;\n\t}\n\n\t/**\n\t * Get the current number of branches in memory.\n\t */\n\tpublic getBranchCount(): number {\n\t\treturn this._branches.size;\n\t}\n\n\t/**\n\t * Get all branch IDs.\n\t */\n\tpublic getBranchIds(): string[] {\n\t\treturn Array.from(this._branches.keys());\n\t}\n}\n"],"names":["MemoryPersistence","Map","options","undefined","thought","branchId","thoughts","branch","Array"],"mappings":"AAkCO,MAAMA;IACJ,WAA0B,EAAE,CAAC;IAC7B,YAAwC,IAAIC,MAAM;IAClD,SAAkB;IAE1B,YAAYC,UAAoC,CAAC,CAAC,CAAE;QACnD,IAAI,CAAC,QAAQ,GAAGA,QAAQ,OAAO,IAAIA,QAAQ,OAAO,GAAG,IAAIA,QAAQ,OAAO,GAAGC;IAC5E;IAEA,MAAa,YAAYC,OAAoB,EAAiB;QAC7D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACA;QAGnB,IAAI,AAAkBD,WAAlB,IAAI,CAAC,QAAQ,IAAkB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EACtE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ;IAEpD;IAEA,MAAa,cAAsC;QAClD,OAAO;eAAI,IAAI,CAAC,QAAQ;SAAC;IAC1B;IAEA,MAAa,WAAWE,QAAgB,EAAEC,QAAuB,EAAiB;QACjF,IAAI,CAAC,SAAS,CAAC,GAAG,CAACD,UAAU;eAAIC;SAAS;IAC3C;IAEA,MAAa,WAAWD,QAAgB,EAAsC;QAC7E,MAAME,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAACF;QAClC,OAAOE,SAAS;eAAIA;SAAO,GAAGJ;IAC/B;IAEA,MAAa,eAAkC;QAC9C,OAAO,IAAI,CAAC,YAAY;IACzB;IAKA,MAAa,UAA4B;QACxC,OAAO;IACR;IAKA,MAAa,QAAuB;QACnC,IAAI,CAAC,QAAQ,GAAG,EAAE;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK;IACrB;IAKA,MAAa,QAAuB,CAEpC;IAKO,iBAAyB;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM;IAC5B;IAKO,iBAAyB;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI;IAC3B;IAKO,eAAyB;QAC/B,OAAOK,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI;IACtC;AACD"}

package/dist/persistence/PersistenceBackend.d.ts

@@ -0,0 +1,69 @@
+import type { ThoughtData } from '../core/thought.js';
+/**
+ * Persistence backend interface for storing thought history and branches.
+ *
+ * Implementations can store data in various formats (JSON files, SQLite, etc.)
+ * while providing a unified API for HistoryManager.
+ */
+export interface PersistenceBackend {
+    /**
+     * Save a single thought to persistent storage.
+     *
+     * @param thought - The thought data to persist
+     */
+    saveThought(thought: ThoughtData): Promise<void>;
+    /**
+     * Load all thoughts from persistent storage.
+     * Returns thoughts in chronological order (oldest first).
+     *
+     * @returns Array of all persisted thoughts
+     */
+    loadHistory(): Promise<ThoughtData[]>;
+    /**
+     * Save all thoughts in a branch to persistent storage.
+     *
+     * @param branchId - The unique identifier for the branch
+     * @param thoughts - Array of thoughts in branch
+     */
+    saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void>;
+    /**
+     * Load all thoughts for a specific branch.
+     *
+     * @param branchId - The unique identifier for the branch
+     * @returns Array of thoughts in branch, or undefined if branch doesn't exist
+     */
+    loadBranch(branchId: string): Promise<ThoughtData[] | undefined>;
+    /**
+     * List all branch IDs that are persisted.
+     *
+     * @returns Array of branch identifiers
+     */
+    listBranches(): Promise<string[]>;
+    /**
+     * Check if backend is healthy.
+     * @returns Promise that resolves to true if healthy, false otherwise
+     */
+    healthy(): Promise<boolean>;
+    /**
+     * Clear all persisted data (history and branches).
+     * Use with caution - this cannot be undone.
+     */
+    clear(): Promise<void>;
+    /**
+     * Close the backend and release resources.
+     * Should be called during graceful shutdown to ensure data is flushed.
+     */
+    close(): Promise<void>;
+}
+export interface PersistenceConfig {
+    enabled?: boolean;
+    backend?: 'file' | 'sqlite' | 'memory';
+    options?: {
+        dataDir?: string;
+        dbPath?: string;
+        enableWAL?: boolean;
+        maxHistorySize?: number;
+        persistBranches?: boolean;
+    };
+}
+//# sourceMappingURL=PersistenceBackend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PersistenceBackend.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEtC;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC;IAEjE;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAElC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,OAAO,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACF"}

package/dist/persistence/PersistenceBackend.js

@@ -0,0 +1 @@
+export { };

package/dist/persistence/PersistenceFactory.d.ts

@@ -0,0 +1,21 @@
+import type { PersistenceBackend, PersistenceConfig } from './PersistenceBackend.js';
+/**
+ * Create a persistence backend based on the provided configuration.
+ *
+ * Uses dynamic imports to avoid loading unused backends,
+ * keeping the factory decoupled from concrete implementations.
+ *
+ * @param config - Persistence configuration
+ * @returns A configured persistence backend, or null if disabled
+ *
+ * @example
+ * ```typescript
+ * const backend = createPersistenceBackend({
+ *   enabled: true,
+ *   backend: 'file',
+ *   options: { dataDir: './data' }
+ * });
+ * ```
+ */
+export declare function createPersistenceBackend(config: PersistenceConfig): Promise<PersistenceBackend | null>;
+//# sourceMappingURL=PersistenceFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PersistenceFactory.d.ts","sourceRoot":"","sources":["../../src/persistence/PersistenceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAErF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAwBpC"}

package/dist/persistence/PersistenceFactory.js

@@ -0,0 +1,25 @@
+async function createPersistenceBackend(config) {
+    if (!config.enabled) return null;
+    switch(config.backend){
+        case 'file':
+            {
+                const { FilePersistence } = await import("./FilePersistence.js");
+                return new FilePersistence(config.options);
+            }
+        case 'sqlite':
+            {
+                const { SqlitePersistence } = await import("./SqlitePersistence.js");
+                return await SqlitePersistence.create(config.options);
+            }
+        case 'memory':
+            {
+                const { MemoryPersistence } = await import("./MemoryPersistence.js");
+                return new MemoryPersistence();
+            }
+        default:
+            throw new Error(`Unknown persistence backend: ${config.backend}`);
+    }
+}
+export { createPersistenceBackend };
+
+//# sourceMappingURL=PersistenceFactory.js.map

package/dist/persistence/PersistenceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence/PersistenceFactory.js","sources":["../../src/persistence/PersistenceFactory.ts"],"sourcesContent":["import type { PersistenceBackend, PersistenceConfig } from './PersistenceBackend.js';\n\n/**\n * Create a persistence backend based on the provided configuration.\n *\n * Uses dynamic imports to avoid loading unused backends,\n * keeping the factory decoupled from concrete implementations.\n *\n * @param config - Persistence configuration\n * @returns A configured persistence backend, or null if disabled\n *\n * @example\n * ```typescript\n * const backend = createPersistenceBackend({\n *   enabled: true,\n *   backend: 'file',\n *   options: { dataDir: './data' }\n * });\n * ```\n */\nexport async function createPersistenceBackend(\n\tconfig: PersistenceConfig\n): Promise<PersistenceBackend | null> {\n\tif (!config.enabled) {\n\t\treturn null;\n\t}\n\n\tswitch (config.backend) {\n\t\tcase 'file': {\n\t\t\tconst { FilePersistence } = await import('./FilePersistence.js');\n\t\t\treturn new FilePersistence(config.options);\n\t\t}\n\n\t\tcase 'sqlite': {\n\t\t\tconst { SqlitePersistence } = await import('./SqlitePersistence.js');\n\t\t\treturn await SqlitePersistence.create(config.options);\n\t\t}\n\n\t\tcase 'memory': {\n\t\t\tconst { MemoryPersistence } = await import('./MemoryPersistence.js');\n\t\t\treturn new MemoryPersistence();\n\t\t}\n\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown persistence backend: ${config.backend}`);\n\t}\n}\n"],"names":["createPersistenceBackend","config","FilePersistence","SqlitePersistence","MemoryPersistence","Error"],"mappings":"AAoBO,eAAeA,yBACrBC,MAAyB;IAEzB,IAAI,CAACA,OAAO,OAAO,EAClB,OAAO;IAGR,OAAQA,OAAO,OAAO;QACrB,KAAK;YAAQ;gBACZ,MAAM,EAAEC,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC;gBACzC,OAAO,IAAIA,gBAAgBD,OAAO,OAAO;YAC1C;QAEA,KAAK;YAAU;gBACd,MAAM,EAAEE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;gBAC3C,OAAO,MAAMA,kBAAkB,MAAM,CAACF,OAAO,OAAO;YACrD;QAEA,KAAK;YAAU;gBACd,MAAM,EAAEG,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC;gBAC3C,OAAO,IAAIA;YACZ;QAEA;YACC,MAAM,IAAIC,MAAM,CAAC,6BAA6B,EAAEJ,OAAO,OAAO,EAAE;IAClE;AACD"}

package/dist/persistence/SqlitePersistence.d.ts

@@ -0,0 +1,60 @@
+import type { ThoughtData } from '../core/thought.js';
+import type { PersistenceBackend, PersistenceConfig } from './PersistenceBackend.js';
+/**
+ * SQLite-based persistence backend.
+ *
+ * Provides efficient, transactional persistence using SQLite.
+ * Requires the 'better-sqlite3' package to be installed.
+ *
+ * @example
+ * ```typescript
+ * const backend = await SqlitePersistence.create({
+ *   dbPath: './data/history.db',
+ *   enableWAL: true
+ * });
+ * ```
+ */
+export declare class SqlitePersistence implements PersistenceBackend {
+    private _db;
+    private _maxHistorySize;
+    private _persistBranches;
+    private constructor();
+    /**
+     * Creates a new SqlitePersistence instance with dynamic import of better-sqlite3.
+     *
+     * @param options - Configuration options
+     * @returns A Promise that resolves to a SqlitePersistence instance
+     * @throws Error if better-sqlite3 is not installed
+     *
+     * @example
+     * ```typescript
+     * const backend = await SqlitePersistence.create({
+     *   dbPath: './data/history.db',
+     *   enableWAL: true
+     * });
+     * ```
+     */
+    static create(options?: PersistenceConfig['options']): Promise<SqlitePersistence>;
+    private _initializeSchema;
+    saveThought(thought: ThoughtData): Promise<void>;
+    loadHistory(): Promise<ThoughtData[]>;
+    saveBranch(branchId: string, thoughts: ThoughtData[]): Promise<void>;
+    loadBranch(branchId: string): Promise<ThoughtData[] | undefined>;
+    listBranches(): Promise<string[]>;
+    clear(): Promise<void>;
+    healthy(): Promise<boolean>;
+    /**
+     * Close the database connection with proper cleanup.
+     * Runs WAL checkpoint before closing to ensure all data is persisted.
+     */
+    close(): Promise<void>;
+    /**
+     * Get statistics about the persisted data.
+     */
+    getStats(): {
+        thoughtCount: number;
+        branchCount: number;
+        dbSize: number;
+    };
+}
+//# sourceMappingURL=SqlitePersistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqlitePersistence.d.ts","sourceRoot":"","sources":["../../src/persistence/SqlitePersistence.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAwBrF;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAU;IAElC,OAAO;IAOP;;;;;;;;;;;;;;OAcG;WACU,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmCvF,OAAO,CAAC,iBAAiB;IA2BZ,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBhD,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAerC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC;IAoBhE,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAUjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxC;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;OAEG;IACI,QAAQ,IAAI;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KACf;CAiBD"}

package/dist/persistence/SqlitePersistence.js

@@ -0,0 +1,136 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+class SqlitePersistence {
+    _db;
+    _maxHistorySize;
+    _persistBranches;
+    constructor(db, options){
+        this._db = db;
+        this._maxHistorySize = options?.maxHistorySize ?? 10000;
+        this._persistBranches = options?.persistBranches ?? true;
+        this._initializeSchema();
+    }
+    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  {
+            throw new Error("SQLite persistence requires 'better-sqlite3' package. Install it with: npm install better-sqlite3");
+        }
+        const db = new Database(dbPath);
+        if (options?.enableWAL !== false) db.pragma('journal_mode = WAL');
+        db.pragma('synchronous = NORMAL');
+        db.pragma('foreign_keys = ON');
+        db.pragma('busy_timeout = 5000');
+        db.pragma('cache_size = -64000');
+        db.pragma('temp_store = MEMORY');
+        return new SqlitePersistence(db, options);
+    }
+    _initializeSchema() {
+        this._db.exec(`
+      CREATE TABLE IF NOT EXISTS thoughts (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        data TEXT NOT NULL,
+        created_at INTEGER DEFAULT (strftime('%s', 'now'))
+      )
+    `);
+        if (this._persistBranches) this._db.exec(`
+        CREATE TABLE IF NOT EXISTS branches (
+          branch_id TEXT PRIMARY KEY,
+          data TEXT NOT NULL,
+          updated_at INTEGER DEFAULT (strftime('%s', 'now'))
+        )
+      `);
+        this._db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_thoughts_created_at ON thoughts(created_at)
+    `);
+    }
+    async saveThought(thought) {
+        const stmt = this._db.prepare('INSERT INTO thoughts (data) VALUES (?)');
+        stmt.run(JSON.stringify(thought));
+        const countStmt = this._db.prepare('SELECT COUNT(*) as count FROM thoughts');
+        const { count } = countStmt.get();
+        if (count > this._maxHistorySize) {
+            const deleteStmt = this._db.prepare(`DELETE FROM thoughts WHERE id IN (
+          SELECT id FROM thoughts ORDER BY id ASC LIMIT ?
+        )`);
+            deleteStmt.run(count - this._maxHistorySize);
+        }
+    }
+    async loadHistory() {
+        const stmt = this._db.prepare('SELECT data FROM thoughts ORDER BY id ASC');
+        const rows = stmt.all();
+        return rows.map((row)=>{
+            try {
+                return JSON.parse(row.data);
+            } catch  {
+                return null;
+            }
+        }).filter((t)=>null !== t);
+    }
+    async saveBranch(branchId, thoughts) {
+        if (!this._persistBranches) return;
+        const stmt = this._db.prepare('INSERT OR REPLACE INTO branches (branch_id, data, updated_at) VALUES (?, ?, strftime("%s", "now"))');
+        stmt.run(branchId, JSON.stringify(thoughts));
+    }
+    async loadBranch(branchId) {
+        if (!this._persistBranches) return;
+        const stmt = this._db.prepare('SELECT data FROM branches WHERE branch_id = ?');
+        const row = stmt.get(branchId);
+        if (!row) return;
+        try {
+            const data = JSON.parse(row.data);
+            return Array.isArray(data) ? data : void 0;
+        } catch  {
+            return;
+        }
+    }
+    async listBranches() {
+        if (!this._persistBranches) return [];
+        const stmt = this._db.prepare('SELECT branch_id FROM branches ORDER BY branch_id ASC');
+        const rows = stmt.all();
+        return rows.map((row)=>row.branch_id);
+    }
+    async clear() {
+        this._db.exec('DELETE FROM thoughts');
+        if (this._persistBranches) this._db.exec('DELETE FROM branches');
+    }
+    async healthy() {
+        try {
+            this._db.prepare('SELECT 1').get();
+            return true;
+        } catch  {
+            return false;
+        }
+    }
+    async close() {
+        if (this._db) {
+            try {
+                this._db.pragma('wal_checkpoint(TRUNCATE)');
+            } catch  {}
+            this._db.close();
+        }
+    }
+    getStats() {
+        const thoughtStmt = this._db.prepare('SELECT COUNT(*) as count FROM thoughts');
+        const { count: thoughtCount } = thoughtStmt.get();
+        let branchCount = 0;
+        if (this._persistBranches) {
+            const branchStmt = this._db.prepare('SELECT COUNT(*) as count FROM branches');
+            const result = branchStmt.get();
+            branchCount = result?.count ?? 0;
+        }
+        return {
+            thoughtCount,
+            branchCount,
+            dbSize: 0
+        };
+    }
+}
+export { SqlitePersistence };
+
+//# sourceMappingURL=SqlitePersistence.js.map