@cleocode/core 2.0.0

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * ID remapping logic for import system.
+ * Ported from lib/data/import-remap.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+import type { Task } from '@cleocode/contracts';
+/** Forward and reverse remap tables. */
+export interface RemapTable {
+    forward: Map<string, string>;
+    reverse: Map<string, string>;
+}
+/**
+ * Get the next available task ID number from existing tasks.
+ */
+export declare function getNextAvailableId(tasks: Task[]): number;
+/**
+ * Generate a remap table for importing tasks.
+ * Maps source task IDs to new sequential IDs starting from nextAvailable.
+ */
+export declare function generateRemapTable(sourceTaskIds: string[], existingTasks: Task[]): RemapTable;
+/**
+ * Validate that a remap table is complete and consistent.
+ */
+export declare function validateRemapTable(table: RemapTable, expectedSourceIds: string[]): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Remap a single task ID, returning original if not in table.
+ */
+export declare function remapTaskId(taskId: string | null, table: RemapTable): string | null;
+/**
+ * Remap all ID references in a task.
+ */
+export declare function remapTaskReferences(task: Task, table: RemapTable, existingTaskIds: Set<string>, missingDepStrategy?: 'strip' | 'fail'): Task;
+/**
+ * Detect duplicate titles between import and target.
+ */
+export declare function detectDuplicateTitles(importTasks: Task[], existingTasks: Task[]): Array<{
+    sourceId: string;
+    title: string;
+    existingId: string;
+}>;
+/**
+ * Resolve duplicate title by appending suffix.
+ */
+export declare function resolveDuplicateTitle(title: string, existingTitles: Set<string>): string;
+//# sourceMappingURL=import-remap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import-remap.d.ts","sourceRoot":"","sources":["../../src/store/import-remap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAOxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,UAAU,CAa7F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,iBAAiB,EAAE,MAAM,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAGnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,kBAAkB,GAAE,OAAO,GAAG,MAAgB,GAC7C,IAAI,CAsCN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,IAAI,EAAE,EACnB,aAAa,EAAE,IAAI,EAAE,GACpB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAehE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAUxF"}

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 Number.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;
+    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;
+    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,CAsGpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAO3D"}

package/dist/store/import-sort.js

@@ -0,0 +1,121 @@
+/**
+ * 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 '../errors.js';
+import { ExitCode } from '@cleocode/contracts';
+/**
+ * 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 { forceCheckpointBeforeOperation } from './data-safety.js';
+export type { SafetyOptions } from './data-safety-central.js';
+export { DataSafetyError, disableSafety, enableSafety, forceSafetyCheckpoint, getSafetyStats, resetSafetyStats, runDataIntegrityCheck, } from './data-safety-central.js';
+export type { SaveJsonOptions } from './json.js';
+export { appendJsonl, computeChecksum, readJson, readJsonRequired, saveJson, } from './json.js';
+export type { ReleaseFn } from './lock.js';
+export { acquireLock, isLocked, withLock } from './lock.js';
+export type { AddTaskOptions, AddTaskResult, AnalysisResult, ArchiveTasksOptions, ArchiveTasksResult, CompleteTaskOptions, CompleteTaskResult, DeleteTaskOptions, DeleteTaskResult, FindTasksOptions, FindTasksResult, ListTasksOptions, ListTasksResult, SessionFilters, StoreEngine, StoreProvider, TaskCurrentResult, TaskFilters, TaskStartResult, TaskWorkHistoryEntry, UpdateTaskOptions, UpdateTaskResult, } from './provider.js';
+export { createStoreProvider } from './provider.js';
+export { getSafetyStatus, isSafetyEnabled, SafetyDataAccessor, wrapWithSafety, } from './safety-data-accessor.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,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,WAAW,EACX,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC;;;;;;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 { forceCheckpointBeforeOperation } from './data-safety.js';
+export { DataSafetyError, disableSafety, enableSafety, forceSafetyCheckpoint, getSafetyStats, resetSafetyStats, runDataIntegrityCheck, } from './data-safety-central.js';
+export { appendJsonl, computeChecksum, readJson, readJsonRequired, saveJson, } from './json.js';
+export { acquireLock, isLocked, withLock } from './lock.js';
+export { createStoreProvider } from './provider.js';
+// Safety-enabled DataAccessor exports (@task T4745)
+export { getSafetyStatus, isSafetyEnabled, SafetyDataAccessor, wrapWithSafety, } from './safety-data-accessor.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,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,WAAW,EACX,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAyB5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,oDAAoD;AACpD,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC;;;;;;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.d.ts

@@ -0,0 +1,57 @@
+/**
+ * JSON read/write with schema validation, locking, and backup.
+ * This is the primary data access layer for CLEO data files.
+ * @epic T4454
+ * @task T4457
+ */
+/**
+ * Read and parse a JSON file.
+ * Returns null if the file does not exist.
+ */
+export declare function readJson<T = unknown>(filePath: string): Promise<T | null>;
+/**
+ * Read a JSON file, throwing if it doesn't exist.
+ */
+export declare function readJsonRequired<T = unknown>(filePath: string): Promise<T>;
+/**
+ * Compute a truncated SHA-256 checksum of a value.
+ * Used for integrity verification (matches Bash CLI's 16-char hex format).
+ */
+export declare function computeChecksum(data: unknown): string;
+/** Options for saveJson. */
+export interface SaveJsonOptions {
+    /** Directory for backups. If omitted, no backup is created. */
+    backupDir?: string;
+    /** Maximum number of backups to retain. Default: 5. */
+    maxBackups?: number;
+    /** JSON indentation. Default: 2. */
+    indent?: number;
+    /** Validation function. Called before write; throw to abort. */
+    validate?: (data: unknown) => void | Promise<void>;
+}
+/**
+ * Save JSON data with optional locking, backup, and validation.
+ * Follows the CLEO atomic write pattern:
+ *   1. Acquire lock
+ *   2. Validate data
+ *   3. Create backup of existing file
+ *   4. Atomic write (temp file -> rename)
+ *   5. Release lock
+ */
+export declare function saveJson(filePath: string, data: unknown, options?: SaveJsonOptions): Promise<void>;
+/**
+ * Append a line to a JSONL file atomically.
+ * Used for manifest entries and audit logs.
+ */
+export declare function appendJsonl(filePath: string, entry: unknown): Promise<void>;
+/**
+ * Read log entries from a hybrid JSON/JSONL file.
+ * Handles three formats:
+ *   1. Pure JSON: `{ "entries": [...] }` (legacy bash format)
+ *   2. Pure JSONL: one JSON object per line (new TS format)
+ *   3. Hybrid: JSON object followed by JSONL lines (migration state)
+ * Returns a flat array of all entries found.
+ * @task T4622
+ */
+export declare function readLogEntries(filePath: string): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/store/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAMhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIrD;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjF;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CA8FzF"}