@cleocode/cleo 2026.2.5

package/dist/store/import-remap.js

@@ -0,0 +1,145 @@
+/**
+ * ID remapping logic for import system.
+ * Ported from lib/data/import-remap.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+/**
+ * Get the next available task ID number from existing tasks.
+ */
+export function getNextAvailableId(tasks) {
+    if (tasks.length === 0)
+        return 1;
+    const maxId = tasks.reduce((max, t) => {
+        const num = parseInt(t.id.replace('T', ''), 10);
+        return isNaN(num) ? max : Math.max(max, num);
+    }, 0);
+    return maxId + 1;
+}
+/**
+ * Generate a remap table for importing tasks.
+ * Maps source task IDs to new sequential IDs starting from nextAvailable.
+ */
+export function generateRemapTable(sourceTaskIds, existingTasks) {
+    const forward = new Map();
+    const reverse = new Map();
+    let nextId = getNextAvailableId(existingTasks);
+    for (const sourceId of sourceTaskIds) {
+        const newId = `T${String(nextId).padStart(3, '0')}`;
+        forward.set(sourceId, newId);
+        reverse.set(newId, sourceId);
+        nextId++;
+    }
+    return { forward, reverse };
+}
+/**
+ * Validate that a remap table is complete and consistent.
+ */
+export function validateRemapTable(table, expectedSourceIds) {
+    const errors = [];
+    // Check completeness
+    for (const id of expectedSourceIds) {
+        if (!table.forward.has(id)) {
+            errors.push(`Missing mapping for source ID: ${id}`);
+        }
+    }
+    // Check consistency
+    for (const [source, target] of table.forward) {
+        const reverseSource = table.reverse.get(target);
+        if (reverseSource !== source) {
+            errors.push(`Inconsistent mapping: ${source} -> ${target} -> ${reverseSource}`);
+        }
+    }
+    // Check ID format
+    for (const newId of table.reverse.keys()) {
+        if (!/^T\d{3,}$/.test(newId)) {
+            errors.push(`Invalid new task ID format: ${newId}`);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Remap a single task ID, returning original if not in table.
+ */
+export function remapTaskId(taskId, table) {
+    if (!taskId)
+        return null;
+    return table.forward.get(taskId) ?? taskId;
+}
+/**
+ * Remap all ID references in a task.
+ */
+export function remapTaskReferences(task, table, existingTaskIds, missingDepStrategy = 'strip') {
+    const newId = table.forward.get(task.id);
+    if (!newId)
+        throw new Error(`No mapping for task ${task.id}`);
+    // Remap parent
+    let newParentId = undefined;
+    if (task.parentId) {
+        if (table.forward.has(task.parentId)) {
+            newParentId = table.forward.get(task.parentId);
+        }
+        else if (existingTaskIds.has(task.parentId)) {
+            newParentId = task.parentId;
+        }
+        else {
+            newParentId = null; // Orphan
+        }
+    }
+    // Remap dependencies
+    let newDepends = undefined;
+    if (task.depends?.length) {
+        newDepends = [];
+        for (const dep of task.depends) {
+            if (table.forward.has(dep)) {
+                newDepends.push(table.forward.get(dep));
+            }
+            else if (existingTaskIds.has(dep)) {
+                newDepends.push(dep);
+            }
+            else if (missingDepStrategy === 'fail') {
+                throw new Error(`Missing dependency ${dep} for task ${task.id}`);
+            }
+            // 'strip' strategy: just skip missing deps
+        }
+    }
+    return {
+        ...task,
+        id: newId,
+        ...(newParentId !== undefined ? { parentId: newParentId } : {}),
+        ...(newDepends !== undefined ? { depends: newDepends } : {}),
+    };
+}
+/**
+ * Detect duplicate titles between import and target.
+ */
+export function detectDuplicateTitles(importTasks, existingTasks) {
+    const titleMap = new Map();
+    for (const t of existingTasks) {
+        titleMap.set(t.title.toLowerCase(), t.id);
+    }
+    const conflicts = [];
+    for (const t of importTasks) {
+        const existing = titleMap.get(t.title.toLowerCase());
+        if (existing) {
+            conflicts.push({ sourceId: t.id, title: t.title, existingId: existing });
+        }
+    }
+    return conflicts;
+}
+/**
+ * Resolve duplicate title by appending suffix.
+ */
+export function resolveDuplicateTitle(title, existingTitles) {
+    let candidate = `${title} (imported)`;
+    if (!existingTitles.has(candidate.toLowerCase()))
+        return candidate;
+    for (let i = 2; i <= 1000; i++) {
+        candidate = `${title} (imported-${i})`;
+        if (!existingTitles.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    return candidate;
+}
+//# sourceMappingURL=import-remap.js.map

package/dist/store/import-remap.js.map

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

package/dist/store/import-sort.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Topological sort for import order using Kahn's algorithm.
+ * Ported from lib/data/import-sort.sh
+ *
+ * Ensures tasks are imported in dependency order where:
+ * 1. Parents are imported before children (parentId references)
+ * 2. Dependencies are imported before dependents (depends[] references)
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/** Minimal task shape needed for topological sorting. */
+export interface SortableTask {
+    id: string;
+    parentId?: string | null;
+    depends?: string[];
+}
+/**
+ * Topological sort for task import order using Kahn's algorithm.
+ *
+ * Ensures tasks are imported in dependency order:
+ * - Parents before children (parentId references)
+ * - Dependencies before dependents (depends[] references)
+ * - Only counts edges to tasks within the set (external deps ignored)
+ *
+ * @task T4552
+ */
+export declare function topologicalSortTasks(tasks: SortableTask[]): string[];
+/**
+ * Detect cycles in task dependency graph.
+ * Returns true if no cycles, false if cycles detected.
+ * @task T4552
+ */
+export declare function detectCycles(tasks: SortableTask[]): boolean;
+//# sourceMappingURL=import-sort.d.ts.map

package/dist/store/import-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-sort.d.ts","sourceRoot":"","sources":["../../src/store/import-sort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAwGpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAO3D"}

package/dist/store/import-sort.js

@@ -0,0 +1,123 @@
+/**
+ * Topological sort for import order using Kahn's algorithm.
+ * Ported from lib/data/import-sort.sh
+ *
+ * Ensures tasks are imported in dependency order where:
+ * 1. Parents are imported before children (parentId references)
+ * 2. Dependencies are imported before dependents (depends[] references)
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { CleoError } from '../core/errors.js';
+import { ExitCode } from '../types/exit-codes.js';
+/**
+ * Topological sort for task import order using Kahn's algorithm.
+ *
+ * Ensures tasks are imported in dependency order:
+ * - Parents before children (parentId references)
+ * - Dependencies before dependents (depends[] references)
+ * - Only counts edges to tasks within the set (external deps ignored)
+ *
+ * @task T4552
+ */
+export function topologicalSortTasks(tasks) {
+    if (tasks.length === 0)
+        return [];
+    // Build lookup from id to index
+    const idToIndex = new Map();
+    for (let i = 0; i < tasks.length; i++) {
+        idToIndex.set(tasks[i].id, i);
+    }
+    // Initialize graph nodes
+    const nodes = tasks.map((task) => {
+        // Count in-degree: edges from parentId + depends that are within the set
+        let inDegree = 0;
+        if (task.parentId && idToIndex.has(task.parentId)) {
+            inDegree++;
+        }
+        const deps = task.depends ?? [];
+        for (const dep of deps) {
+            if (idToIndex.has(dep)) {
+                inDegree++;
+            }
+        }
+        return {
+            id: task.id,
+            inDegree,
+            children: [],
+            dependents: [],
+        };
+    });
+    // Build reverse edges (parent -> children, dep -> dependents)
+    for (const task of tasks) {
+        // Add to parent's children list
+        if (task.parentId) {
+            const parentIdx = idToIndex.get(task.parentId);
+            if (parentIdx !== undefined) {
+                nodes[parentIdx].children.push(task.id);
+            }
+        }
+        // Add to each dep's dependents list
+        const deps = task.depends ?? [];
+        for (const dep of deps) {
+            const depIdx = idToIndex.get(dep);
+            if (depIdx !== undefined) {
+                nodes[depIdx].dependents.push(task.id);
+            }
+        }
+    }
+    // Build node lookup by ID for efficient access
+    const nodeById = new Map();
+    for (const node of nodes) {
+        nodeById.set(node.id, node);
+    }
+    // Kahn's algorithm: initialize queue with zero in-degree nodes
+    const queue = [];
+    for (const node of nodes) {
+        if (node.inDegree === 0) {
+            queue.push(node.id);
+        }
+    }
+    const result = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        result.push(current);
+        const currentNode = nodeById.get(current);
+        // Process all successors (children + dependents)
+        const successors = [...currentNode.children, ...currentNode.dependents];
+        for (const successorId of successors) {
+            const successor = nodeById.get(successorId);
+            if (!successor)
+                continue;
+            successor.inDegree--;
+            if (successor.inDegree === 0) {
+                queue.push(successorId);
+            }
+        }
+    }
+    // Cycle detection
+    if (result.length !== tasks.length) {
+        const processed = new Set(result);
+        const unprocessed = tasks
+            .map((t) => t.id)
+            .filter((id) => !processed.has(id));
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Cycle detected in task dependencies. Tasks in cycle: ${unprocessed.join(', ')}`);
+    }
+    return result;
+}
+/**
+ * Detect cycles in task dependency graph.
+ * Returns true if no cycles, false if cycles detected.
+ * @task T4552
+ */
+export function detectCycles(tasks) {
+    try {
+        topologicalSortTasks(tasks);
+        return true; // No cycles
+    }
+    catch {
+        return false; // Cycles detected
+    }
+}
+//# sourceMappingURL=import-sort.js.map

package/dist/store/import-sort.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Unified store interface for CLEO V2 data access.
+ * @epic T4454
+ * @task T4457
+ * @task T4645
+ * @task T4745
+ */
+export { atomicWrite, atomicWriteJson, safeReadFile } from './atomic.js';
+export { createBackup, listBackups, restoreFromBackup } from './backup.js';
+export { acquireLock, isLocked, withLock } from './lock.js';
+export type { ReleaseFn } from './lock.js';
+export { readJson, readJsonRequired, saveJson, appendJsonl, computeChecksum, } from './json.js';
+export type { SaveJsonOptions } from './json.js';
+export { createStoreProvider, detectStoreEngine, } from './provider.js';
+export type { StoreProvider, StoreEngine, TaskFilters, SessionFilters, AddTaskOptions, AddTaskResult, CompleteTaskOptions, CompleteTaskResult, UpdateTaskOptions, UpdateTaskResult, DeleteTaskOptions, DeleteTaskResult, FindTasksOptions, FindTasksResult, ListTasksOptions, ListTasksResult, ArchiveTasksOptions, ArchiveTasksResult, FocusShowResult, FocusSetResult, FocusHistoryEntry, TaskCurrentResult, TaskStartResult, TaskWorkHistoryEntry, AnalysisResult, } from './provider.js';
+export { createJsonStoreProvider } from './json-provider.js';
+export { SafetyDataAccessor, wrapWithSafety, isSafetyEnabled, getSafetyStatus, } from './safety-data-accessor.js';
+export type { SafetyOptions } from './data-safety-central.js';
+export { DataSafetyError, getSafetyStats, resetSafetyStats, runDataIntegrityCheck, forceSafetyCheckpoint, disableSafety, enableSafety, } from './data-safety-central.js';
+/**
+ * Get a StoreProvider instance for the given working directory.
+ * Convenience wrapper around createStoreProvider with auto-detection.
+ *
+ * @task T4645
+ * @epic T4638
+ */
+export declare function getStore(cwd?: string): Promise<import('./provider.js').StoreProvider>;
+//# sourceMappingURL=index.d.ts.map

package/dist/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EAAE,aAAa,EAC7B,mBAAmB,EAAE,kBAAkB,EACvC,iBAAiB,EAAE,gBAAgB,EACnC,iBAAiB,EAAE,gBAAgB,EACnC,gBAAgB,EAAE,eAAe,EACjC,gBAAgB,EAAE,eAAe,EACjC,mBAAmB,EAAE,kBAAkB,EACvC,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAClD,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EACxD,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,eAAe,EAAE,aAAa,CAAC,CAG3F"}

package/dist/store/index.js

@@ -0,0 +1,28 @@
+/**
+ * Unified store interface for CLEO V2 data access.
+ * @epic T4454
+ * @task T4457
+ * @task T4645
+ * @task T4745
+ */
+export { atomicWrite, atomicWriteJson, safeReadFile } from './atomic.js';
+export { createBackup, listBackups, restoreFromBackup } from './backup.js';
+export { acquireLock, isLocked, withLock } from './lock.js';
+export { readJson, readJsonRequired, saveJson, appendJsonl, computeChecksum, } from './json.js';
+export { createStoreProvider, detectStoreEngine, } from './provider.js';
+export { createJsonStoreProvider } from './json-provider.js';
+// Safety-enabled DataAccessor exports (@task T4745)
+export { SafetyDataAccessor, wrapWithSafety, isSafetyEnabled, getSafetyStatus, } from './safety-data-accessor.js';
+export { DataSafetyError, getSafetyStats, resetSafetyStats, runDataIntegrityCheck, forceSafetyCheckpoint, disableSafety, enableSafety, } from './data-safety-central.js';
+/**
+ * Get a StoreProvider instance for the given working directory.
+ * Convenience wrapper around createStoreProvider with auto-detection.
+ *
+ * @task T4645
+ * @epic T4638
+ */
+export async function getStore(cwd) {
+    const { createStoreProvider: create } = await import('./provider.js');
+    return create(undefined, cwd);
+}
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAiBvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,oDAAoD;AACpD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAY;IACzC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/store/json-data-accessor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * JSON file-based implementation of the DataAccessor interface.
+ *
+ * Delegates to readJson/readJsonRequired/saveJson/appendJsonl for all I/O,
+ * and uses path helpers from ../core/paths.js for file location resolution.
+ *
+ * @epic T4454
+ */
+import type { DataAccessor } from './data-accessor.js';
+/**
+ * Create a JSON file-backed DataAccessor.
+ *
+ * @param cwd - Working directory for path resolution (defaults to process.cwd())
+ */
+export declare function createJsonDataAccessor(cwd?: string): Promise<DataAccessor>;
+//# sourceMappingURL=json-data-accessor.d.ts.map

package/dist/store/json-data-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-data-accessor.d.ts","sourceRoot":"","sources":["../../src/store/json-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA6B,MAAM,oBAAoB,CAAC;AAUlF;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8DhF"}

package/dist/store/json-data-accessor.js

@@ -0,0 +1,68 @@
+/**
+ * JSON file-based implementation of the DataAccessor interface.
+ *
+ * Delegates to readJson/readJsonRequired/saveJson/appendJsonl for all I/O,
+ * and uses path helpers from ../core/paths.js for file location resolution.
+ *
+ * @epic T4454
+ */
+import { readJson, readJsonRequired, saveJson, appendJsonl } from './json.js';
+import { getTaskPath, getArchivePath, getSessionsPath, getLogPath, getBackupDir, } from '../core/paths.js';
+/**
+ * Create a JSON file-backed DataAccessor.
+ *
+ * @param cwd - Working directory for path resolution (defaults to process.cwd())
+ */
+export async function createJsonDataAccessor(cwd) {
+    const accessor = {
+        engine: 'json',
+        async loadTaskFile() {
+            return readJsonRequired(getTaskPath(cwd));
+        },
+        async saveTaskFile(data) {
+            await saveJson(getTaskPath(cwd), data, { backupDir: getBackupDir(cwd) });
+        },
+        // Deprecated aliases
+        async loadTodoFile() {
+            return accessor.loadTaskFile();
+        },
+        async saveTodoFile(data) {
+            return accessor.saveTaskFile(data);
+        },
+        async loadArchive() {
+            return readJson(getArchivePath(cwd));
+        },
+        async saveArchive(data) {
+            await saveJson(getArchivePath(cwd), data, { backupDir: getBackupDir(cwd) });
+        },
+        async loadSessions() {
+            const data = await readJson(getSessionsPath(cwd));
+            if (data) {
+                // Ensure _meta exists even on old sessions files
+                if (!data._meta) {
+                    data._meta = { schemaVersion: '1.0.0', lastUpdated: new Date().toISOString() };
+                }
+                if (!data.version) {
+                    data.version = '1.0.0';
+                }
+                return data;
+            }
+            return {
+                sessions: [],
+                version: '1.0.0',
+                _meta: { schemaVersion: '1.0.0', lastUpdated: new Date().toISOString() },
+            };
+        },
+        async saveSessions(data) {
+            await saveJson(getSessionsPath(cwd), data, { backupDir: getBackupDir(cwd) });
+        },
+        async appendLog(entry) {
+            await appendJsonl(getLogPath(cwd), entry);
+        },
+        async close() {
+            // No-op: JSON files don't hold open resources.
+        },
+    };
+    return accessor;
+}
+//# sourceMappingURL=json-data-accessor.js.map

package/dist/store/json-data-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-data-accessor.js","sourceRoot":"","sources":["../../src/store/json-data-accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAY;IACvD,MAAM,QAAQ,GAAiB;QAC7B,MAAM,EAAE,MAAe;QAEvB,KAAK,CAAC,YAAY;YAChB,OAAO,gBAAgB,CAAW,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAc;YAC/B,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,qBAAqB;QACrB,KAAK,CAAC,YAAY;YAChB,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAc;YAC/B,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,WAAW;YACf,OAAO,QAAQ,CAAc,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAAiB;YACjC,MAAM,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,KAAK,CAAC,YAAY;YAChB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAe,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,IAAI,IAAI,EAAE,CAAC;gBACT,iDAAiD;gBACjD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBAChB,IAAI,CAAC,KAAK,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACjF,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACzB,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;aACzE,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAkB;YACnC,MAAM,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,KAA8B;YAC5C,MAAM,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK;YACT,+CAA+C;QACjD,CAAC;KACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/store/json-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON StoreProvider implementation.
+ *
+ * Wraps existing JSON file operations (tasks, sessions, task work) behind
+ * the StoreProvider interface. This allows the CLI and MCP engine to
+ * use StoreProvider for all data access, switchable between JSON and SQLite.
+ *
+ * @task T4644
+ * @epic T4638
+ */
+import type { StoreProvider } from './provider.js';
+/**
+ * Create a JSON-backed StoreProvider.
+ *
+ * Delegates to existing core module functions that read/write JSON files.
+ * A JsonDataAccessor is created once and passed to all core calls, ensuring
+ * consistent storage access throughout the provider's lifetime.
+ *
+ * @task T4644
+ * @epic T4638
+ */
+export declare function createJsonStoreProvider(cwd?: string): StoreProvider;
+//# sourceMappingURL=json-provider.d.ts.map

package/dist/store/json-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-provider.d.ts","sourceRoot":"","sources":["../../src/store/json-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,eAAe,CAAC;AAsChF;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CA+OnE"}