@cleocode/core 2026.3.42 → 2026.3.44

package/dist/store/data-safety.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Data Safety Module - Critical protection layer for CLEO data operations.
+ *
+ * Implements:
+ * - Write verification (verify data was actually persisted)
+ * - Collision detection (prevent duplicate task IDs)
+ * - Sequence validation (ensure sequence counter matches database)
+ * - Auto-checkpoint integration (git commit after writes)
+ *
+ * @task T4739
+ * @epic T4732
+ */
+import type { Session, Task } from '@cleocode/contracts';
+/** Safety configuration options. */
+export interface SafetyConfig {
+    /** Enable write verification (default: true) */
+    verifyWrites: boolean;
+    /** Enable collision detection (default: true) */
+    detectCollisions: boolean;
+    /** Enable sequence validation (default: true) */
+    validateSequence: boolean;
+    /** Enable auto-checkpoint (default: true) */
+    autoCheckpoint: boolean;
+    /** Throw on safety violations (default: true) */
+    strictMode: boolean;
+}
+/** Safety violation error. */
+export declare class SafetyError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Check if a task ID already exists (collision detection).
+ * @throws SafetyError if task exists and strict mode is enabled
+ */
+export declare function checkTaskExists(taskId: string, cwd?: string, config?: Partial<SafetyConfig>): Promise<boolean>;
+/**
+ * Verify a task was actually written to the database.
+ * @throws SafetyError if verification fails
+ */
+export declare function verifyTaskWrite(taskId: string, expectedData?: Partial<Task>, cwd?: string, config?: Partial<SafetyConfig>): Promise<boolean>;
+/**
+ * Validate and repair sequence if necessary.
+ * @returns true if sequence was valid or successfully repaired
+ */
+export declare function validateAndRepairSequence(cwd?: string, config?: Partial<SafetyConfig>): Promise<{
+    valid: boolean;
+    repaired: boolean;
+    oldCounter?: number;
+    newCounter?: number;
+}>;
+/**
+ * Trigger auto-checkpoint after successful write.
+ */
+export declare function triggerCheckpoint(context: string, cwd?: string, config?: Partial<SafetyConfig>): Promise<void>;
+/**
+ * Safely create a task with all safety mechanisms.
+ * Wraps the actual createTask operation.
+ */
+export declare function safeCreateTask(createFn: () => Promise<Task>, task: Task, cwd?: string, config?: Partial<SafetyConfig>): Promise<Task>;
+/**
+ * Safely update a task with all safety mechanisms.
+ */
+export declare function safeUpdateTask(updateFn: () => Promise<Task | null>, taskId: string, _updates: Partial<Task>, cwd?: string, config?: Partial<SafetyConfig>): Promise<Task | null>;
+/**
+ * Safely delete a task with all safety mechanisms.
+ */
+export declare function safeDeleteTask(deleteFn: () => Promise<boolean>, taskId: string, cwd?: string, config?: Partial<SafetyConfig>): Promise<boolean>;
+/**
+ * Verify session write.
+ */
+export declare function verifySessionWrite(sessionId: string, cwd?: string, config?: Partial<SafetyConfig>): Promise<boolean>;
+/**
+ * Safely create a session with all safety mechanisms.
+ */
+export declare function safeCreateSession(createFn: () => Promise<Session>, session: Session, cwd?: string, config?: Partial<SafetyConfig>): Promise<Session>;
+/**
+ * Force a checkpoint before destructive operations.
+ * Use this before migrations, bulk updates, etc.
+ */
+export declare function forceCheckpointBeforeOperation(operation: string, cwd?: string): Promise<void>;
+/**
+ * Run comprehensive data integrity check.
+ * Reports all issues found.
+ */
+export declare function runDataIntegrityCheck(cwd?: string): Promise<{
+    passed: boolean;
+    issues: string[];
+    repairs: string[];
+}>;
+//# sourceMappingURL=data-safety.d.ts.map

package/dist/store/data-safety.d.ts.map

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

package/dist/store/db-helpers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared database helper functions for SQLite store modules.
+ *
+ * Consolidates upsert and dependency patterns used across
+ * sqlite-data-accessor.ts, task-store.ts, and session-store.ts.
+ *
+ * @epic T4454
+ */
+import type { Session, Task } from '@cleocode/contracts';
+import type { NodeSQLiteDatabase } from 'drizzle-orm/node-sqlite';
+import type { NewTaskRow } from './tasks-schema.js';
+import * as schema from './tasks-schema.js';
+/** Drizzle database instance type. */
+type DrizzleDb = NodeSQLiteDatabase<typeof schema>;
+/** Archive-specific fields for task upsert. */
+export interface ArchiveFields {
+    archivedAt?: string;
+    archiveReason?: string;
+    cycleTimeDays?: number | null;
+}
+/**
+ * Upsert a single task row into the tasks table.
+ * Handles both active task upsert and archived task upsert via optional archiveFields.
+ *
+ * Defensively nulls out parentId if it references a non-existent task,
+ * preventing orphaned FK violations from blocking bulk operations (T5034).
+ */
+export declare function upsertTask(db: DrizzleDb, row: NewTaskRow, archiveFields?: ArchiveFields): Promise<void>;
+/**
+ * Upsert a single session row into the sessions table.
+ */
+export declare function upsertSession(db: DrizzleDb, session: Session): Promise<void>;
+/**
+ * Update dependencies for a task: delete existing, then re-insert.
+ * Optionally filters by a set of valid IDs.
+ */
+export declare function updateDependencies(db: DrizzleDb, taskId: string, depends: string[], validIds?: Set<string>): Promise<void>;
+/**
+ * Batch-update dependencies for multiple tasks in two bulk SQL operations.
+ * Replaces per-task updateDependencies() loops with:
+ * 1. Single DELETE for all task IDs
+ * 2. Single INSERT for all dependency rows
+ *
+ * Callers are responsible for wrapping this in a transaction if needed.
+ */
+export declare function batchUpdateDependencies(db: DrizzleDb, tasks: Array<{
+    taskId: string;
+    deps: string[];
+}>, validIds?: Set<string>): Promise<void>;
+/**
+ * Batch-load dependencies for a list of tasks and apply them in-place.
+ * Uses inArray for efficient querying. Optionally filters by a set of valid IDs.
+ */
+export declare function loadDependenciesForTasks(db: DrizzleDb, tasks: Task[], validationIds?: Set<string>): Promise<void>;
+/**
+ * Batch-load relations for a list of tasks and apply them in-place.
+ * Mirrors loadDependenciesForTasks pattern for task_relations table (T5168).
+ */
+export declare function loadRelationsForTasks(db: DrizzleDb, tasks: Task[]): Promise<void>;
+export {};
+//# sourceMappingURL=db-helpers.d.ts.map

package/dist/store/db-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-helpers.d.ts","sourceRoot":"","sources":["../../src/store/db-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,sCAAsC;AACtC,KAAK,SAAS,GAAG,kBAAkB,CAAC,OAAO,MAAM,CAAC,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqDf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkClF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAChD,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BvF"}

package/dist/store/export.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Export package generation for task data interchange.
+ * Ported from lib/data/export.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+import type { Task } from '@cleocode/contracts';
+/** Export package metadata. */
+export interface ExportMeta {
+    format: 'cleo-export';
+    version: string;
+    exportedAt: string;
+    source: {
+        project: string;
+        cleo_version: string;
+        nextId: number;
+    };
+    checksum: string;
+    taskCount: number;
+    exportMode: string;
+}
+/** Export selection criteria. */
+export interface ExportSelection {
+    mode: string;
+    rootTaskIds: string[];
+    includeChildren: boolean;
+    filters?: unknown;
+}
+/** ID map entry. */
+export interface IdMapEntry {
+    type: string;
+    title: string;
+    status: string;
+    parentId: string | null;
+    depends: string[];
+}
+/** Relationship graph. */
+export interface RelationshipGraph {
+    hierarchy: Record<string, string[]>;
+    dependencies: Record<string, string[]>;
+    roots: string[];
+}
+/** Complete export package. */
+export interface ExportPackage {
+    $schema: string;
+    _meta: ExportMeta;
+    selection: ExportSelection;
+    idMap: Record<string, IdMapEntry>;
+    tasks: Task[];
+    relationshipGraph: RelationshipGraph;
+}
+/**
+ * Calculate SHA-256 checksum for export integrity (truncated to 16 hex chars).
+ */
+export declare function calculateExportChecksum(tasksJson: string): string;
+/**
+ * Verify export package checksum.
+ */
+export declare function verifyExportChecksum(pkg: ExportPackage): boolean;
+/**
+ * Build ID map from tasks.
+ */
+export declare function buildIdMap(tasks: Task[]): Record<string, IdMapEntry>;
+/**
+ * Build relationship graph from tasks.
+ */
+export declare function buildRelationshipGraph(tasks: Task[]): RelationshipGraph;
+/**
+ * Build a complete export package.
+ */
+export declare function buildExportPackage(tasks: Task[], options: {
+    mode: string;
+    rootTaskIds: string[];
+    includeChildren: boolean;
+    cleoVersion?: string;
+    filters?: unknown;
+    projectName?: string;
+}): ExportPackage;
+/**
+ * Export a single task.
+ */
+export declare function exportSingle(taskId: string, allTasks: Task[], projectName?: string): ExportPackage | null;
+/**
+ * Export a subtree (task + all descendants).
+ */
+export declare function exportSubtree(rootId: string, allTasks: Task[], projectName?: string): ExportPackage | null;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/store/export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAKhD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,oBAAoB;AACpB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAIhE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAYpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAgCvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,aAAa,CAsCf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,IAAI,EAAE,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CAUtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,IAAI,EAAE,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CAwBtB"}

package/dist/store/file-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * File utility helpers for CLEO data access.
+ *
+ * File utility helpers for CLEO data access including atomic writes,
+ * file locking, and backup rotation.
+ *
+ * @task T4833
+ * @epic T4654
+ */
+/**
+ * Write a JSON file atomically with backup rotation.
+ *
+ * Pattern: write temp -> backup original -> rename temp to target
+ *
+ * @param filePath - Target file path
+ * @param data - Data to serialize as JSON
+ * @param indent - JSON indentation (default: 2 spaces)
+ */
+export declare function writeJsonFileAtomic<T>(filePath: string, data: T, indent?: number): void;
+/**
+ * Read a JSON file, returning parsed content or null if not found.
+ *
+ * @param filePath - Path to the JSON file
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): T | null;
+/**
+ * Get the path to a CLEO data file within a project root.
+ *
+ * @param projectRoot - Root directory of the project
+ * @param filename - Filename within .cleo/ directory
+ */
+export declare function getDataPath(projectRoot: string, filename: string): string;
+/**
+ * Resolve the project root directory.
+ * Checks CLEO_ROOT env, then falls back to cwd.
+ */
+export declare function resolveProjectRoot(): string;
+/**
+ * Read and write a JSON file with exclusive locking.
+ *
+ * Acquires a cross-process lock, reads current state, applies the
+ * transform function, validates, and writes back atomically.
+ *
+ * @param filePath - File to lock and modify
+ * @param transform - Function that receives current data and returns new data
+ * @returns The transformed data
+ */
+export declare function withLock<T>(filePath: string, transform: (current: T | null) => T): Promise<T>;
+/**
+ * Acquire a file lock and execute an operation.
+ * Unlike withLock, this doesn't read/write the file - caller manages I/O.
+ * The return type R is independent of the file content type.
+ */
+export declare function withFileLock<R>(filePath: string, operation: () => R | Promise<R>): Promise<R>;
+/**
+ * Acquire locks on multiple files in correct order.
+ * Used for operations that need to modify multiple files atomically
+ * (e.g., coordinated updates across task data and config).
+ *
+ * @param filePaths - Files to lock
+ * @param operation - Function to execute while locks are held
+ */
+export declare function withMultiLock<T>(filePaths: string[], operation: () => T | Promise<T>): Promise<T>;
+/**
+ * Check if a CLEO project directory exists at the given path
+ */
+export declare function isProjectInitialized(projectRoot: string): boolean;
+/**
+ * List backup files for a given data file
+ */
+export declare function listBackups(filePath: string): string[];
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/store/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/store/file-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0DH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI,CAqB1F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAUpE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AA6BD;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD"}

package/dist/store/git-checkpoint.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Git checkpoint system for CLEO state files.
+ * Ported from lib/data/git-checkpoint.sh
+ *
+ * Opt-in automatic git commits of .cleo/ state files at semantic
+ * boundaries (save_json, session end) with debounce to prevent commit noise.
+ * All git errors are suppressed - checkpointing is never fatal.
+ *
+ * @task T4552
+ * @task T4872
+ * @epic T4545
+ */
+/**
+ * Build environment variables that point git at the isolated .cleo/.git repo.
+ * @task T4872
+ */
+export declare function makeCleoGitEnv(cleoDir: string): NodeJS.ProcessEnv;
+/**
+ * Run a git command against the isolated .cleo/.git repo, suppressing errors.
+ * @task T4872
+ */
+export declare function cleoGitCommand(args: string[], cleoDir: string): Promise<{
+    stdout: string;
+    success: boolean;
+}>;
+/**
+ * Check whether the isolated .cleo/.git repo has been initialized.
+ * @task T4872
+ */
+export declare function isCleoGitInitialized(cleoDir: string): boolean;
+/**
+ * Load additional state file paths from config.json `checkpoint.stateFileAllowlist`.
+ * Returns an empty array if config is missing, malformed, or the key is absent.
+ */
+export declare function loadStateFileAllowlist(cwd?: string): Promise<string[]>;
+/** Checkpoint configuration. */
+export interface CheckpointConfig {
+    enabled: boolean;
+    debounceMinutes: number;
+    messagePrefix: string;
+    noVerify: boolean;
+}
+/** Checkpoint status information. */
+export interface CheckpointStatus {
+    config: CheckpointConfig;
+    status: {
+        isGitRepo: boolean;
+        lastCheckpoint: string;
+        lastCheckpointEpoch: number;
+        pendingChanges: number;
+        suppressed: boolean;
+    };
+}
+/** Changed file with its status. */
+export interface ChangedFile {
+    path: string;
+    status: 'modified' | 'untracked';
+}
+/**
+ * Load checkpoint configuration from config.json.
+ * @task T4552
+ */
+export declare function loadCheckpointConfig(cwd?: string): Promise<CheckpointConfig>;
+/**
+ * Check whether a checkpoint should be performed.
+ * Evaluates: enabled, .cleo/.git initialized, debounce elapsed, files changed.
+ * @task T4552
+ * @task T4872
+ */
+export declare function shouldCheckpoint(options?: {
+    force?: boolean;
+    cwd?: string;
+}): Promise<boolean>;
+/**
+ * Stage .cleo/ state files and commit to the isolated .cleo/.git repo.
+ * Never fatal - all git errors are suppressed.
+ * @task T4552
+ * @task T4872
+ */
+export declare function gitCheckpoint(trigger?: 'auto' | 'session-end' | 'manual', context?: string, cwd?: string): Promise<void>;
+/**
+ * Show checkpoint configuration and status.
+ * @task T4552
+ * @task T4872
+ */
+export declare function gitCheckpointStatus(cwd?: string): Promise<CheckpointStatus>;
+/**
+ * Show what files would be committed (dry-run).
+ * @task T4552
+ * @task T4872
+ */
+export declare function gitCheckpointDryRun(cwd?: string): Promise<ChangedFile[]>;
+//# sourceMappingURL=git-checkpoint.d.ts.map

package/dist/store/git-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-checkpoint.d.ts","sourceRoot":"","sources":["../../src/store/git-checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CASjE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAW/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAwBD;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAY5E;AAeD,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoBlF;AA4GD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,OAAO,CAAC,CAqCnB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,MAAM,GAAG,aAAa,GAAG,QAAiB,EACnD,OAAO,CAAC,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAuDf;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BjF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAO9E"}

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

@@ -0,0 +1,58 @@
+/**
+ * Import-specific logging functions for CLEO system.
+ * Ported from lib/data/import-logging.sh
+ *
+ * Provides structured audit logging for import operations including
+ * start, success, error, and conflict events.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/** Import package metadata extracted from the export file. */
+export interface ImportPackageMeta {
+    sourceFile: string;
+    sourceProject: string;
+    exportedAt: string;
+    packageChecksum: string;
+    taskCount: number;
+}
+/** Import conflict types. */
+export type ImportConflictType = 'duplicate_title' | 'missing_dependency' | 'missing_parent' | 'depth_exceeded' | 'phase_mismatch';
+/** Import conflict resolution strategies. */
+export type ImportConflictResolution = 'skip' | 'rename' | 'force' | 'strip' | 'create_placeholder' | 'fail';
+/** Import options for logging context. */
+export interface ImportOptions {
+    parent?: string;
+    phase?: string;
+    resetStatus?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Extract package metadata from an export file.
+ * @task T4552
+ */
+export declare function extractPackageMeta(sourceFilePath: string): Promise<ImportPackageMeta>;
+/**
+ * Log import operation start with package metadata.
+ * @task T4552
+ */
+export declare function logImportStart(sourceFilePath: string, sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import operation completion with full metadata.
+ * @task T4552
+ */
+export declare function logImportSuccess(sourceFilePath: string, tasksImported: string[], idRemap: Record<string, string>, conflicts?: Array<{
+    type: string;
+    resolution: string;
+}>, options?: ImportOptions, sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import operation error with diagnostic details.
+ * @task T4552
+ */
+export declare function logImportError(sourceFilePath: string, errorMessage: string, errorCode: string | number, stage?: 'validation' | 'parsing' | 'remapping' | 'writing' | 'unknown', sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import conflict detection and resolution.
+ * @task T4552
+ */
+export declare function logImportConflict(conflictType: ImportConflictType, taskId: string, conflictDetails: Record<string, unknown>, resolution: ImportConflictResolution, sessionId?: string, cwd?: string): Promise<void>;
+//# sourceMappingURL=import-logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import-logging.d.ts","sourceRoot":"","sources":["../../src/store/import-logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,oBAAoB,GACpB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,oBAAoB,GACpB,MAAM,CAAC;AAEX,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuBD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAW3F;AA+BD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EACvD,OAAO,CAAC,EAAE,aAAa,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,KAAK,GAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAqB,EACjF,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,UAAU,EAAE,wBAAwB,EACpC,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAYf"}

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-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/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"}