@cleocode/cleo 2026.2.5

package/dist/store/data-safety.js

@@ -0,0 +1,298 @@
+/**
+ * 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 { eq } from 'drizzle-orm';
+import { getDb } from './sqlite.js';
+import * as schema from './schema.js';
+import { gitCheckpoint } from './git-checkpoint.js';
+import { checkSequence, repairSequence, } from '../core/sequence/index.js';
+const DEFAULT_CONFIG = {
+    verifyWrites: true,
+    detectCollisions: true,
+    validateSequence: true,
+    autoCheckpoint: true,
+    strictMode: true,
+};
+/** Safety violation error. */
+export class SafetyError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SafetyError';
+    }
+}
+/**
+ * Check if a task ID already exists (collision detection).
+ * @throws SafetyError if task exists and strict mode is enabled
+ */
+export async function checkTaskExists(taskId, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.detectCollisions)
+        return false;
+    const db = await getDb(cwd);
+    const existing = db
+        .select()
+        .from(schema.tasks)
+        .where(eq(schema.tasks.id, taskId))
+        .all();
+    const exists = existing.length > 0;
+    if (exists && cfg.strictMode) {
+        throw new SafetyError(`Task ID collision detected: ${taskId} already exists`, 'COLLISION_DETECTED', { taskId, existingTask: existing[0] });
+    }
+    return exists;
+}
+/**
+ * Verify a task was actually written to the database.
+ * @throws SafetyError if verification fails
+ */
+export async function verifyTaskWrite(taskId, expectedData, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.verifyWrites)
+        return true;
+    const db = await getDb(cwd);
+    const rows = db
+        .select()
+        .from(schema.tasks)
+        .where(eq(schema.tasks.id, taskId))
+        .all();
+    if (rows.length === 0) {
+        if (cfg.strictMode) {
+            throw new SafetyError(`Write verification failed: Task ${taskId} not found after write`, 'WRITE_VERIFICATION_FAILED', { taskId });
+        }
+        return false;
+    }
+    // Verify expected data if provided
+    if (expectedData) {
+        const row = rows[0];
+        for (const [key, value] of Object.entries(expectedData)) {
+            if (value !== undefined && row[key] !== value) {
+                if (cfg.strictMode) {
+                    throw new SafetyError(`Write verification failed: Task ${taskId} field ${key} mismatch`, 'WRITE_VERIFICATION_MISMATCH', { taskId, field: key, expected: value, actual: row[key] });
+                }
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Validate and repair sequence if necessary.
+ * @returns true if sequence was valid or successfully repaired
+ */
+export async function validateAndRepairSequence(cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.validateSequence)
+        return { valid: true, repaired: false };
+    try {
+        const check = await checkSequence(cwd);
+        if (check.valid) {
+            return { valid: true, repaired: false };
+        }
+        // Sequence is behind, repair it
+        const repair = await repairSequence(cwd);
+        if (repair.repaired) {
+            console.warn(`[SAFETY] Sequence repaired: ${repair.oldCounter} -> ${repair.newCounter}`);
+            return {
+                valid: true,
+                repaired: true,
+                oldCounter: repair.oldCounter,
+                newCounter: repair.newCounter,
+            };
+        }
+        return { valid: false, repaired: false };
+    }
+    catch (err) {
+        if (cfg.strictMode) {
+            throw new SafetyError(`Sequence validation failed: ${String(err)}`, 'SEQUENCE_VALIDATION_FAILED', { error: String(err) });
+        }
+        return { valid: false, repaired: false };
+    }
+}
+/**
+ * Trigger auto-checkpoint after successful write.
+ */
+export async function triggerCheckpoint(context, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.autoCheckpoint)
+        return;
+    try {
+        await gitCheckpoint('auto', context, cwd);
+    }
+    catch (err) {
+        // Checkpoint failures are non-fatal but should be logged
+        console.warn(`[SAFETY] Checkpoint failed (non-fatal): ${String(err)}`);
+    }
+}
+/**
+ * Safely create a task with all safety mechanisms.
+ * Wraps the actual createTask operation.
+ */
+export async function safeCreateTask(createFn, task, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // 1. Validate sequence before creation
+    if (cfg.validateSequence) {
+        await validateAndRepairSequence(cwd, config);
+    }
+    // 2. Check for collisions
+    if (cfg.detectCollisions) {
+        await checkTaskExists(task.id, cwd, config);
+    }
+    // 3. Perform the actual creation
+    const result = await createFn();
+    // 4. Verify the write
+    if (cfg.verifyWrites) {
+        await verifyTaskWrite(task.id, { title: task.title }, cwd, config);
+    }
+    // 5. Trigger checkpoint
+    if (cfg.autoCheckpoint) {
+        await triggerCheckpoint(`created ${task.id}`, cwd, config);
+    }
+    return result;
+}
+/**
+ * Safely update a task with all safety mechanisms.
+ */
+export async function safeUpdateTask(updateFn, taskId, updates, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // 1. Perform the actual update
+    const result = await updateFn();
+    if (!result)
+        return null;
+    // 2. Verify the write
+    if (cfg.verifyWrites) {
+        await verifyTaskWrite(taskId, updates, cwd, config);
+    }
+    // 3. Trigger checkpoint
+    if (cfg.autoCheckpoint) {
+        await triggerCheckpoint(`updated ${taskId}`, cwd, config);
+    }
+    return result;
+}
+/**
+ * Safely delete a task with all safety mechanisms.
+ */
+export async function safeDeleteTask(deleteFn, taskId, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // 1. Perform the actual deletion
+    const result = await deleteFn();
+    if (!result)
+        return false;
+    // 2. Verify the deletion (task should NOT exist)
+    if (cfg.verifyWrites) {
+        const db = await getDb(cwd);
+        const rows = db
+            .select()
+            .from(schema.tasks)
+            .where(eq(schema.tasks.id, taskId))
+            .all();
+        if (rows.length > 0) {
+            if (cfg.strictMode) {
+                throw new SafetyError(`Delete verification failed: Task ${taskId} still exists after delete`, 'DELETE_VERIFICATION_FAILED', { taskId });
+            }
+        }
+    }
+    // 3. Trigger checkpoint
+    if (cfg.autoCheckpoint) {
+        await triggerCheckpoint(`deleted ${taskId}`, cwd, config);
+    }
+    return result;
+}
+/**
+ * Verify session write.
+ */
+export async function verifySessionWrite(sessionId, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    if (!cfg.verifyWrites)
+        return true;
+    const db = await getDb(cwd);
+    const rows = db
+        .select()
+        .from(schema.sessions)
+        .where(eq(schema.sessions.id, sessionId))
+        .all();
+    if (rows.length === 0) {
+        if (cfg.strictMode) {
+            throw new SafetyError(`Write verification failed: Session ${sessionId} not found after write`, 'SESSION_WRITE_VERIFICATION_FAILED', { sessionId });
+        }
+        return false;
+    }
+    return true;
+}
+/**
+ * Safely create a session with all safety mechanisms.
+ */
+export async function safeCreateSession(createFn, session, cwd, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // 1. Perform the actual creation
+    const result = await createFn();
+    // 2. Verify the write
+    if (cfg.verifyWrites) {
+        await verifySessionWrite(session.id, cwd, config);
+    }
+    // 3. Trigger checkpoint
+    if (cfg.autoCheckpoint) {
+        await triggerCheckpoint(`session ${session.id} started`, cwd, config);
+    }
+    return result;
+}
+/**
+ * Force a checkpoint before destructive operations.
+ * Use this before migrations, bulk updates, etc.
+ */
+export async function forceCheckpointBeforeOperation(operation, cwd) {
+    console.log(`[SAFETY] Forcing checkpoint before: ${operation}`);
+    try {
+        await gitCheckpoint('manual', `pre-${operation}`, cwd);
+    }
+    catch (err) {
+        console.error(`[SAFETY] Failed to create pre-operation checkpoint: ${String(err)}`);
+        // Don't throw - checkpoint failures shouldn't block operations
+    }
+}
+/**
+ * Run comprehensive data integrity check.
+ * Reports all issues found.
+ */
+export async function runDataIntegrityCheck(cwd) {
+    const issues = [];
+    const repairs = [];
+    // 1. Check sequence
+    try {
+        const seqCheck = await checkSequence(cwd);
+        if (!seqCheck.valid) {
+            issues.push(`Sequence invalid: counter ${seqCheck.counter} < max ID T${seqCheck.maxIdInData}`);
+            // Auto-repair
+            const repair = await repairSequence(cwd);
+            if (repair.repaired) {
+                repairs.push(`Sequence repaired: ${repair.oldCounter} -> ${repair.newCounter}`);
+            }
+            else {
+                issues.push('Sequence repair failed');
+            }
+        }
+    }
+    catch (err) {
+        issues.push(`Sequence check failed: ${String(err)}`);
+    }
+    // 2. Check for ghost entries (would need to compare todo-log with database)
+    // This is a complex check that would require loading the entire log
+    // For now, we skip this but document it as needed
+    return {
+        passed: issues.length === repairs.length,
+        issues,
+        repairs,
+    };
+}
+//# sourceMappingURL=data-safety.js.map

package/dist/store/data-safety.js.map

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

package/dist/store/export.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Export package generation for task data interchange.
+ * Ported from lib/data/export.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+import type { Task, TodoFile } from '../types/task.js';
+/** 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[], todoData: TodoFile, options: {
+    mode: string;
+    rootTaskIds: string[];
+    includeChildren: boolean;
+    cleoVersion?: string;
+    filters?: unknown;
+}): ExportPackage;
+/**
+ * Export a single task.
+ */
+export declare function exportSingle(taskId: string, todoData: TodoFile): ExportPackage | null;
+/**
+ * Export a subtree (task + all descendants).
+ */
+export declare function exportSubtree(rootId: string, todoData: TodoFile): 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,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAKvD,+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,QAAQ,EAAE,QAAQ,EAClB,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;CACnB,GACA,aAAa,CAsCf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,IAAI,CASrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,IAAI,CAuBtF"}

package/dist/store/export.js

@@ -0,0 +1,153 @@
+/**
+ * Export package generation for task data interchange.
+ * Ported from lib/data/export.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+import { createHash } from 'node:crypto';
+/** Export format version. */
+const EXPORT_FORMAT_VERSION = '1.0.0';
+/**
+ * Calculate SHA-256 checksum for export integrity (truncated to 16 hex chars).
+ */
+export function calculateExportChecksum(tasksJson) {
+    const canonical = JSON.stringify(JSON.parse(tasksJson));
+    return createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+}
+/**
+ * Verify export package checksum.
+ */
+export function verifyExportChecksum(pkg) {
+    const tasksJson = JSON.stringify(pkg.tasks);
+    const calculated = calculateExportChecksum(tasksJson);
+    return pkg._meta.checksum === calculated;
+}
+/**
+ * Build ID map from tasks.
+ */
+export function buildIdMap(tasks) {
+    const map = {};
+    for (const task of tasks) {
+        map[task.id] = {
+            type: task.type ?? 'task',
+            title: task.title,
+            status: task.status,
+            parentId: task.parentId ?? null,
+            depends: task.depends ?? [],
+        };
+    }
+    return map;
+}
+/**
+ * Build relationship graph from tasks.
+ */
+export function buildRelationshipGraph(tasks) {
+    const exportedIds = new Set(tasks.map((t) => t.id));
+    const hierarchy = {};
+    const dependencies = {};
+    for (const task of tasks) {
+        // Hierarchy
+        if (task.parentId && exportedIds.has(task.parentId)) {
+            if (!hierarchy[task.parentId])
+                hierarchy[task.parentId] = [];
+            hierarchy[task.parentId].push(task.id);
+        }
+        // Dependencies
+        if (task.depends?.length) {
+            const internalDeps = task.depends.filter((d) => exportedIds.has(d));
+            if (internalDeps.length > 0) {
+                dependencies[task.id] = internalDeps;
+            }
+        }
+    }
+    // Roots: tasks with no parent in export and no deps in export
+    const roots = tasks
+        .filter((t) => {
+        const hasParentInExport = t.parentId && exportedIds.has(t.parentId);
+        const hasDepsInExport = t.depends?.some((d) => exportedIds.has(d));
+        return !hasParentInExport && !hasDepsInExport;
+    })
+        .map((t) => t.id);
+    return { hierarchy, dependencies, roots };
+}
+/**
+ * Build a complete export package.
+ */
+export function buildExportPackage(tasks, todoData, options) {
+    const now = new Date().toISOString();
+    const projectName = todoData.project?.name ?? 'unknown';
+    const maxId = tasks.reduce((max, t) => {
+        const num = parseInt(t.id.replace('T', ''), 10);
+        return num > max ? num : max;
+    }, 0);
+    const idMap = buildIdMap(tasks);
+    const relationshipGraph = buildRelationshipGraph(tasks);
+    const tasksJson = JSON.stringify(tasks);
+    const checksum = calculateExportChecksum(tasksJson);
+    return {
+        $schema: 'https://cleo-dev.com/schemas/v1/export-package.schema.json',
+        _meta: {
+            format: 'cleo-export',
+            version: EXPORT_FORMAT_VERSION,
+            exportedAt: now,
+            source: {
+                project: projectName,
+                cleo_version: options.cleoVersion ?? '0.95.0',
+                nextId: maxId + 1,
+            },
+            checksum,
+            taskCount: tasks.length,
+            exportMode: options.mode,
+        },
+        selection: {
+            mode: options.mode,
+            rootTaskIds: options.rootTaskIds,
+            includeChildren: options.includeChildren,
+            filters: options.filters,
+        },
+        idMap,
+        tasks,
+        relationshipGraph,
+    };
+}
+/**
+ * Export a single task.
+ */
+export function exportSingle(taskId, todoData) {
+    const task = todoData.tasks.find((t) => t.id === taskId);
+    if (!task)
+        return null;
+    return buildExportPackage([task], todoData, {
+        mode: 'single',
+        rootTaskIds: [taskId],
+        includeChildren: false,
+    });
+}
+/**
+ * Export a subtree (task + all descendants).
+ */
+export function exportSubtree(rootId, todoData) {
+    const root = todoData.tasks.find((t) => t.id === rootId);
+    if (!root)
+        return null;
+    // Collect all descendants
+    const collected = new Map();
+    const queue = [rootId];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        const task = todoData.tasks.find((t) => t.id === id);
+        if (!task || collected.has(id))
+            continue;
+        collected.set(id, task);
+        const children = todoData.tasks.filter((t) => t.parentId === id);
+        queue.push(...children.map((c) => c.id));
+    }
+    const tasks = [...collected.values()];
+    return buildExportPackage(tasks, todoData, {
+        mode: 'subtree',
+        rootTaskIds: [rootId],
+        includeChildren: true,
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/store/export.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * 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
+ * @epic T4545
+ */
+/** 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, git repo, debounce elapsed, files changed.
+ * @task T4552
+ */
+export declare function shouldCheckpoint(options?: {
+    force?: boolean;
+    cwd?: string;
+}): Promise<boolean>;
+/**
+ * Stage .cleo/ state files and commit if conditions met.
+ * Never fatal - all git errors are suppressed.
+ * @task T4552
+ */
+export declare function gitCheckpoint(trigger?: 'auto' | 'session-end' | 'manual', context?: string, cwd?: string): Promise<void>;
+/**
+ * Show checkpoint configuration and status.
+ * @task T4552
+ */
+export declare function gitCheckpointStatus(cwd?: string): Promise<CheckpointStatus>;
+/**
+ * Show what files would be committed (dry-run).
+ * @task T4552
+ */
+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;;;;;;;;;;GAUG;AAuCH,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;AAkHD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,OAAO,CAAC,CAiClB;AAED;;;;GAIG;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,CAoDf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BjF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAO9E"}