@cleocode/cleo 2026.2.5

package/dist/core/migration/checksum.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Checksum utilities for backup verification.
+ *
+ * Provides SHA-256 checksum computation and backup verification
+ * to ensure data integrity during migrations.
+ *
+ * @task T4728
+ * @epic T4454
+ */
+/**
+ * Result of a backup verification operation.
+ */
+export interface VerificationResult {
+    /** Whether the backup is valid */
+    valid: boolean;
+    /** Error message if verification failed */
+    error?: string;
+    /** SHA-256 checksum of the source file */
+    sourceChecksum: string;
+    /** SHA-256 checksum of the backup file */
+    backupChecksum: string;
+}
+/**
+ * Compute SHA-256 checksum of a file.
+ *
+ * @param filePath - Path to the file
+ * @returns Hex-encoded SHA-256 checksum
+ * @task T4728
+ */
+export declare function computeChecksum(filePath: string): Promise<string>;
+/**
+ * Verify that a backup file matches the source file and is a valid SQLite database.
+ *
+ * Performs three checks:
+ * 1. Computes SHA-256 checksum of both files
+ * 2. Compares checksums to detect any content differences
+ * 3. Verifies the backup can be opened as a valid SQLite database
+ *
+ * @param sourcePath - Path to the source database file
+ * @param backupPath - Path to the backup file
+ * @returns VerificationResult with checksums and validity status
+ * @task T4728
+ */
+export declare function verifyBackup(sourcePath: string, backupPath: string): Promise<VerificationResult>;
+/**
+ * Quick checksum comparison without SQLite verification.
+ * Use when you only need to compare file contents.
+ *
+ * @param filePath1 - First file path
+ * @param filePath2 - Second file path
+ * @returns true if checksums match, false otherwise
+ * @task T4728
+ */
+export declare function compareChecksums(filePath1: string, filePath2: string): Promise<boolean>;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/core/migration/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../../src/core/migration/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/core/migration/checksum.js

@@ -0,0 +1,90 @@
+/**
+ * Checksum utilities for backup verification.
+ *
+ * Provides SHA-256 checksum computation and backup verification
+ * to ensure data integrity during migrations.
+ *
+ * @task T4728
+ * @epic T4454
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import initSqlJs from 'sql.js';
+/**
+ * Compute SHA-256 checksum of a file.
+ *
+ * @param filePath - Path to the file
+ * @returns Hex-encoded SHA-256 checksum
+ * @task T4728
+ */
+export async function computeChecksum(filePath) {
+    const content = readFileSync(filePath);
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Verify that a backup file matches the source file and is a valid SQLite database.
+ *
+ * Performs three checks:
+ * 1. Computes SHA-256 checksum of both files
+ * 2. Compares checksums to detect any content differences
+ * 3. Verifies the backup can be opened as a valid SQLite database
+ *
+ * @param sourcePath - Path to the source database file
+ * @param backupPath - Path to the backup file
+ * @returns VerificationResult with checksums and validity status
+ * @task T4728
+ */
+export async function verifyBackup(sourcePath, backupPath) {
+    // Compute checksums for both files
+    const sourceChecksum = await computeChecksum(sourcePath);
+    const backupChecksum = await computeChecksum(backupPath);
+    // Compare checksums - any difference means corruption or tampering
+    if (sourceChecksum !== backupChecksum) {
+        return {
+            valid: false,
+            error: `Checksum mismatch: source=${sourceChecksum}, backup=${backupChecksum}`,
+            sourceChecksum,
+            backupChecksum,
+        };
+    }
+    // Verify backup can be opened as a valid SQLite database
+    // This catches cases where the file is intact but not a valid SQLite file
+    try {
+        const SQL = await initSqlJs();
+        const buffer = readFileSync(backupPath);
+        const db = new SQL.Database(buffer);
+        // Run a simple query to verify the database is functional
+        db.run('SELECT 1');
+        // Clean up
+        db.close();
+    }
+    catch (err) {
+        return {
+            valid: false,
+            error: `Backup is not a valid SQLite database: ${String(err)}`,
+            sourceChecksum,
+            backupChecksum,
+        };
+    }
+    // All checks passed
+    return {
+        valid: true,
+        sourceChecksum,
+        backupChecksum,
+    };
+}
+/**
+ * Quick checksum comparison without SQLite verification.
+ * Use when you only need to compare file contents.
+ *
+ * @param filePath1 - First file path
+ * @param filePath2 - Second file path
+ * @returns true if checksums match, false otherwise
+ * @task T4728
+ */
+export async function compareChecksums(filePath1, filePath2) {
+    const checksum1 = await computeChecksum(filePath1);
+    const checksum2 = await computeChecksum(filePath2);
+    return checksum1 === checksum2;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/core/migration/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/core/migration/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,SAAS,MAAM,QAAQ,CAAC;AAgB/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,UAAkB;IAElB,mCAAmC;IACnC,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAEzD,mEAAmE;IACnE,IAAI,cAAc,KAAK,cAAc,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,6BAA6B,cAAc,YAAY,cAAc,EAAE;YAC9E,cAAc;YACd,cAAc;SACf,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,0EAA0E;IAC1E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEpC,0DAA0D;QAC1D,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEnB,WAAW;QACX,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,0CAA0C,MAAM,CAAC,GAAG,CAAC,EAAE;YAC9D,cAAc;YACd,cAAc;SACf,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,OAAO;QACL,KAAK,EAAE,IAAI;QACX,cAAc;QACd,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,SAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,SAAS,KAAK,SAAS,CAAC;AACjC,CAAC"}

package/dist/core/migration/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Migration system - schema version detection and migration runner.
+ * @task T4468
+ * @epic T4454
+ */
+export { checkStorageMigration } from './preflight.js';
+export type { PreflightResult } from './preflight.js';
+export { computeChecksum, verifyBackup, compareChecksums, } from './checksum.js';
+export type { VerificationResult } from './checksum.js';
+export { validateSourceFiles, formatValidationResult, checkTaskCountMismatch, } from './validate.js';
+export type { JsonValidationResult, JsonFileValidation } from './validate.js';
+export { createMigrationState, updateMigrationState, updateMigrationPhase, updateMigrationProgress, addMigrationError, addMigrationWarning, loadMigrationState, isMigrationInProgress, canResumeMigration, completeMigration, failMigration, clearMigrationState, getMigrationSummary, verifySourceIntegrity, } from './state.js';
+export type { MigrationState, MigrationPhase, MigrationProgress, SourceFileInfo } from './state.js';
+export { MigrationLogger, createMigrationLogger, readMigrationLog, logFileExists, getLatestMigrationLog, } from './logger.js';
+export type { MigrationLogEntry, LogLevel, MigrationLoggerConfig, } from './logger.js';
+/** Schema version info. */
+export interface SchemaVersion {
+    current: string;
+    target: string;
+    needsMigration: boolean;
+}
+/** Migration function signature. */
+export type MigrationFn = (data: unknown) => unknown;
+/** Migration definition. */
+export interface MigrationDef {
+    fromVersion: string;
+    toVersion: string;
+    description: string;
+    migrate: MigrationFn;
+}
+/** Migration run result. */
+export interface MigrationResult {
+    file: string;
+    fromVersion: string;
+    toVersion: string;
+    migrationsApplied: string[];
+    success: boolean;
+    errors: string[];
+    dryRun: boolean;
+}
+/** Status of all data files. */
+export interface MigrationStatus {
+    todoJson: SchemaVersion | null;
+    configJson: SchemaVersion | null;
+    archiveJson: SchemaVersion | null;
+}
+/**
+ * Detect schema version from a data file.
+ * @task T4468
+ */
+export declare function detectVersion(data: unknown): string;
+/**
+ * Compare two version strings (X.Y.Z format, works for both semver and CalVer).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ * @task T4468
+ */
+export declare function compareSemver(a: string, b: string): number;
+/**
+ * Get migration status for all data files.
+ * @task T4468
+ */
+export declare function getMigrationStatus(cwd?: string): Promise<MigrationStatus>;
+/**
+ * Run migrations on a data file.
+ * @task T4468
+ */
+export declare function runMigration(fileType: string, options?: {
+    dryRun?: boolean;
+}, cwd?: string): Promise<MigrationResult>;
+/**
+ * Run all pending migrations.
+ * @task T4468
+ */
+export declare function runAllMigrations(options?: {
+    dryRun?: boolean;
+}, cwd?: string): Promise<MigrationResult[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/migration/index.d.ts.map

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

package/dist/core/migration/index.js

@@ -0,0 +1,278 @@
+/**
+ * Migration system - schema version detection and migration runner.
+ * @task T4468
+ * @epic T4454
+ */
+// Re-export pre-flight check for CLI/MCP consumers (@task T4699)
+export { checkStorageMigration } from './preflight.js';
+// Re-export checksum utilities for backup verification (@task T4728)
+export { computeChecksum, verifyBackup, compareChecksums, } from './checksum.js';
+// Re-export pre-migration validation (@task T4725)
+export { validateSourceFiles, formatValidationResult, checkTaskCountMismatch, } from './validate.js';
+// Re-export migration state tracking (@task T4726)
+export { createMigrationState, updateMigrationState, updateMigrationPhase, updateMigrationProgress, addMigrationError, addMigrationWarning, loadMigrationState, isMigrationInProgress, canResumeMigration, completeMigration, failMigration, clearMigrationState, getMigrationSummary, verifySourceIntegrity, } from './state.js';
+// Re-export migration logger (@task T4727)
+export { MigrationLogger, createMigrationLogger, readMigrationLog, logFileExists, getLatestMigrationLog, } from './logger.js';
+import { readJson, saveJson } from '../../store/json.js';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { getTaskPath, getBackupDir, getCleoDirAbsolute, getConfigPath } from '../paths.js';
+import { join } from 'node:path';
+// Current target schema versions
+const TARGET_VERSIONS = {
+    todo: '2.10.0',
+    config: '2.0.0',
+    archive: '2.6.0',
+    log: '1.0.0',
+};
+// Migration registry
+const MIGRATIONS = {
+    todo: [
+        {
+            fromVersion: '2.6.0',
+            toVersion: '2.7.0',
+            description: 'Add epicLifecycle and origin fields',
+            migrate: (data) => {
+                const d = data;
+                const tasks = d['tasks'];
+                for (const task of tasks) {
+                    if (task['type'] === 'epic' && !task['epicLifecycle']) {
+                        task['epicLifecycle'] = null;
+                    }
+                    if (!task['origin']) {
+                        task['origin'] = null;
+                    }
+                }
+                return d;
+            },
+        },
+        {
+            fromVersion: '2.7.0',
+            toVersion: '2.8.0',
+            description: 'Add verification gates',
+            migrate: (data) => {
+                const d = data;
+                const tasks = d['tasks'];
+                for (const task of tasks) {
+                    if (!task['verification']) {
+                        task['verification'] = null;
+                    }
+                }
+                return d;
+            },
+        },
+        {
+            fromVersion: '2.8.0',
+            toVersion: '2.9.0',
+            description: 'Add provenance tracking',
+            migrate: (data) => {
+                const d = data;
+                const tasks = d['tasks'];
+                for (const task of tasks) {
+                    if (!task['provenance']) {
+                        task['provenance'] = null;
+                    }
+                }
+                return d;
+            },
+        },
+        {
+            fromVersion: '2.9.0',
+            toVersion: '2.10.0',
+            description: 'Add multi-session support fields',
+            migrate: (data) => {
+                const d = data;
+                const meta = d['_meta'];
+                if (!meta['multiSessionEnabled']) {
+                    meta['multiSessionEnabled'] = false;
+                }
+                if (!meta['activeSessionCount']) {
+                    meta['activeSessionCount'] = 0;
+                }
+                return d;
+            },
+        },
+    ],
+};
+/**
+ * Detect schema version from a data file.
+ * @task T4468
+ */
+export function detectVersion(data) {
+    const d = data;
+    // Check _meta.schemaVersion (canonical)
+    const meta = d['_meta'];
+    if (meta?.['schemaVersion']) {
+        return meta['schemaVersion'];
+    }
+    // Fallback to .version
+    if (d['version'] && typeof d['version'] === 'string') {
+        return d['version'];
+    }
+    return '0.0.0';
+}
+/**
+ * Compare two version strings (X.Y.Z format, works for both semver and CalVer).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ * @task T4468
+ */
+export function compareSemver(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Get migration status for all data files.
+ * @task T4468
+ */
+export async function getMigrationStatus(cwd) {
+    const result = {
+        todoJson: null,
+        configJson: null,
+        archiveJson: null,
+    };
+    // Check todo.json
+    try {
+        const todoData = await readJson(getTaskPath(cwd));
+        if (todoData) {
+            const current = detectVersion(todoData);
+            const target = TARGET_VERSIONS['todo'];
+            result.todoJson = {
+                current,
+                target,
+                needsMigration: compareSemver(current, target) < 0,
+            };
+        }
+    }
+    catch {
+        // File may not exist
+    }
+    // Check config.json
+    try {
+        const configData = await readJson(getConfigPath(cwd));
+        if (configData) {
+            const current = detectVersion(configData);
+            const target = TARGET_VERSIONS['config'];
+            result.configJson = {
+                current,
+                target,
+                needsMigration: compareSemver(current, target) < 0,
+            };
+        }
+    }
+    catch {
+        // File may not exist
+    }
+    // Check archive
+    try {
+        const archivePath = join(getCleoDirAbsolute(cwd), 'todo-archive.json');
+        const archiveData = await readJson(archivePath);
+        if (archiveData) {
+            const current = detectVersion(archiveData);
+            const target = TARGET_VERSIONS['archive'];
+            result.archiveJson = {
+                current,
+                target,
+                needsMigration: compareSemver(current, target) < 0,
+            };
+        }
+    }
+    catch {
+        // File may not exist
+    }
+    return result;
+}
+/**
+ * Run migrations on a data file.
+ * @task T4468
+ */
+export async function runMigration(fileType, options = {}, cwd) {
+    const filePaths = {
+        todo: getTaskPath(cwd),
+        config: getConfigPath(cwd),
+        archive: join(getCleoDirAbsolute(cwd), 'todo-archive.json'),
+    };
+    const filePath = filePaths[fileType];
+    if (!filePath) {
+        throw new CleoError(ExitCode.INVALID_INPUT, `Unknown file type: ${fileType}`);
+    }
+    const data = await readJson(filePath);
+    if (!data) {
+        throw new CleoError(ExitCode.NOT_FOUND, `File not found: ${filePath}`);
+    }
+    const currentVersion = detectVersion(data);
+    const targetVersion = TARGET_VERSIONS[fileType] ?? '0.0.0';
+    const migrations = MIGRATIONS[fileType] ?? [];
+    // Find applicable migrations
+    const applicable = migrations.filter(m => compareSemver(m.fromVersion, currentVersion) >= 0 &&
+        compareSemver(m.toVersion, targetVersion) <= 0).sort((a, b) => compareSemver(a.fromVersion, b.fromVersion));
+    if (applicable.length === 0) {
+        return {
+            file: filePath,
+            fromVersion: currentVersion,
+            toVersion: currentVersion,
+            migrationsApplied: [],
+            success: true,
+            errors: [],
+            dryRun: options.dryRun ?? false,
+        };
+    }
+    // Apply migrations sequentially
+    let migrated = data;
+    const applied = [];
+    const errors = [];
+    for (const migration of applicable) {
+        try {
+            migrated = migration.migrate(migrated);
+            applied.push(`${migration.fromVersion} -> ${migration.toVersion}: ${migration.description}`);
+        }
+        catch (err) {
+            errors.push(`Migration ${migration.fromVersion} -> ${migration.toVersion} failed: ${err}`);
+            break;
+        }
+    }
+    // Update schema version in _meta
+    const migratedObj = migrated;
+    const meta = (migratedObj['_meta'] ?? {});
+    meta['schemaVersion'] = errors.length === 0 ? targetVersion : currentVersion;
+    migratedObj['_meta'] = meta;
+    if (!options.dryRun && errors.length === 0) {
+        await saveJson(filePath, migrated, { backupDir: getBackupDir(cwd) });
+    }
+    return {
+        file: filePath,
+        fromVersion: currentVersion,
+        toVersion: errors.length === 0 ? targetVersion : currentVersion,
+        migrationsApplied: applied,
+        success: errors.length === 0,
+        errors,
+        dryRun: options.dryRun ?? false,
+    };
+}
+/**
+ * Run all pending migrations.
+ * @task T4468
+ */
+export async function runAllMigrations(options = {}, cwd) {
+    const status = await getMigrationStatus(cwd);
+    const results = [];
+    if (status.todoJson?.needsMigration) {
+        results.push(await runMigration('todo', options, cwd));
+    }
+    if (status.configJson?.needsMigration) {
+        results.push(await runMigration('config', options, cwd));
+    }
+    if (status.archiveJson?.needsMigration) {
+        results.push(await runMigration('archive', options, cwd));
+    }
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/migration/index.js.map

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