@cleocode/core 2026.3.38 → 2026.3.40

package/dist/migration/logger.js

@@ -1,360 +0,0 @@
-/**
- * Structured logging for migration operations.
- *
- * Provides audit trail and debugging support for all migration phases.
- * Logs are written in JSONL format for easy parsing and appending.
- *
- * @task T4727
- * @epic T4454
- */
-import { accessSync, appendFileSync, constants, existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, } from 'node:fs';
-import { dirname, join, relative } from 'node:path';
-/** Structured logger for migration operations */
-export class MigrationLogger {
-    logPath;
-    entries = [];
-    startTime;
-    cleoDir;
-    config;
-    /**
-     * Create a new migration logger.
-     * @param cleoDir - Path to .cleo directory
-     * @param config - Optional configuration
-     */
-    constructor(cleoDir, config = {}) {
-        this.cleoDir = cleoDir;
-        this.config = {
-            maxLogFiles: config.maxLogFiles ?? 10,
-            minLevel: config.minLevel ?? 'debug',
-            consoleOutput: config.consoleOutput ?? false,
-        };
-        // Generate timestamped log filename
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-        this.logPath = join(cleoDir, 'logs', `migration-${timestamp}.jsonl`);
-        // Ensure logs directory exists
-        const logsDir = dirname(this.logPath);
-        if (!existsSync(logsDir)) {
-            mkdirSync(logsDir, { recursive: true });
-        }
-        this.startTime = Date.now();
-        // Clean up old log files
-        this.cleanupOldLogs();
-    }
-    /**
-     * Get numeric priority for log level comparison.
-     */
-    getLevelPriority(level) {
-        const priorities = {
-            debug: 0,
-            info: 1,
-            warn: 2,
-            error: 3,
-        };
-        return priorities[level];
-    }
-    /**
-     * Check if a log level should be recorded.
-     */
-    shouldLog(level) {
-        return this.getLevelPriority(level) >= this.getLevelPriority(this.config.minLevel);
-    }
-    /**
-     * Write a log entry.
-     */
-    log(level, phase, operation, message, data) {
-        if (!this.shouldLog(level)) {
-            return;
-        }
-        const entry = {
-            timestamp: new Date().toISOString(),
-            level,
-            phase,
-            operation,
-            message,
-            durationMs: Date.now() - this.startTime,
-            data,
-        };
-        this.entries.push(entry);
-        // Append to file
-        try {
-            appendFileSync(this.logPath, JSON.stringify(entry) + '\n');
-        }
-        catch (err) {
-            // If file logging fails, try console as fallback
-            console.error(`Failed to write to migration log: ${String(err)}`);
-        }
-        // Console output if enabled
-        if (this.config.consoleOutput) {
-            const prefix = `[${level.toUpperCase()}] ${phase}.${operation}:`;
-            if (level === 'error') {
-                console.error(prefix, message, data ?? '');
-            }
-            else if (level === 'warn') {
-                console.warn(prefix, message, data ?? '');
-            }
-            else {
-                console.log(prefix, message, data ?? '');
-            }
-        }
-    }
-    /**
-     * Log an info-level message.
-     */
-    info(phase, operation, message, data) {
-        this.log('info', phase, operation, message, data);
-    }
-    /**
-     * Log a warning-level message.
-     */
-    warn(phase, operation, message, data) {
-        this.log('warn', phase, operation, message, data);
-    }
-    /**
-     * Log an error-level message.
-     */
-    error(phase, operation, message, data) {
-        this.log('error', phase, operation, message, data);
-    }
-    /**
-     * Log a debug-level message.
-     */
-    debug(phase, operation, message, data) {
-        this.log('debug', phase, operation, message, data);
-    }
-    /**
-     * Log file operation with size information.
-     */
-    logFileOperation(phase, operation, sourcePath, targetPath, additionalData) {
-        const data = {
-            sourcePath: relative(this.cleoDir, sourcePath),
-            ...additionalData,
-        };
-        // Get source file size if it exists
-        if (existsSync(sourcePath)) {
-            try {
-                const stats = statSync(sourcePath);
-                data.sourceSize = stats.size;
-                data.sourceModified = stats.mtime.toISOString();
-            }
-            catch {
-                // Size not available
-            }
-        }
-        // Get target file size if provided and exists
-        if (targetPath) {
-            data.targetPath = relative(this.cleoDir, targetPath);
-            if (existsSync(targetPath)) {
-                try {
-                    const stats = statSync(targetPath);
-                    data.targetSize = stats.size;
-                    data.targetModified = stats.mtime.toISOString();
-                }
-                catch {
-                    // Size not available
-                }
-            }
-        }
-        this.info(phase, `file-${operation}`, `File ${operation} operation`, data);
-    }
-    /**
-     * Log validation result.
-     */
-    logValidation(phase, target, valid, details, errors) {
-        const data = {
-            target,
-            valid,
-            ...details,
-        };
-        if (errors && errors.length > 0) {
-            data.errors = errors;
-            this.error(phase, 'validation', `Validation failed for ${target}`, data);
-        }
-        else if (!valid) {
-            this.warn(phase, 'validation', `Validation warning for ${target}`, data);
-        }
-        else {
-            this.info(phase, 'validation', `Validation passed for ${target}`, data);
-        }
-    }
-    /**
-     * Log import progress.
-     */
-    logImportProgress(phase, entityType, imported, total, additionalData) {
-        const percent = total > 0 ? Math.round((imported / total) * 100) : 0;
-        this.info(phase, 'import-progress', `Imported ${imported} of ${total} ${entityType}`, {
-            imported,
-            total,
-            percent,
-            remaining: total - imported,
-            ...additionalData,
-        });
-    }
-    /**
-     * Log phase start.
-     */
-    phaseStart(phase, data) {
-        this.info(phase, 'start', `Starting phase: ${phase}`, data);
-    }
-    /**
-     * Log phase completion.
-     */
-    phaseComplete(phase, data) {
-        this.info(phase, 'complete', `Completed phase: ${phase}`, data);
-    }
-    /**
-     * Log phase failure.
-     */
-    phaseFailed(phase, error, data) {
-        this.error(phase, 'failed', `Phase failed: ${phase}`, {
-            error: error instanceof Error ? error.message : error,
-            stack: error instanceof Error ? error.stack : undefined,
-            ...data,
-        });
-    }
-    /**
-     * Clean up old log files, keeping only the most recent ones.
-     */
-    cleanupOldLogs() {
-        try {
-            const logsDir = join(this.cleoDir, 'logs');
-            if (!existsSync(logsDir)) {
-                return;
-            }
-            const files = readdirSync(logsDir)
-                .filter((f) => f.startsWith('migration-') && f.endsWith('.jsonl'))
-                .map((f) => ({
-                name: f,
-                path: join(logsDir, f),
-                mtime: statSync(join(logsDir, f)).mtime.getTime(),
-            }))
-                .sort((a, b) => b.mtime - a.mtime);
-            // Remove files beyond the retention limit
-            const filesToRemove = files.slice(this.config.maxLogFiles);
-            for (const file of filesToRemove) {
-                try {
-                    unlinkSync(file.path);
-                }
-                catch {
-                    // Ignore cleanup errors
-                }
-            }
-        }
-        catch {
-            // Cleanup is best-effort
-        }
-    }
-    /**
-     * Get the absolute path to the log file.
-     */
-    getLogPath() {
-        return this.logPath;
-    }
-    /**
-     * Get the path to the log file relative to cleoDir.
-     */
-    getRelativeLogPath() {
-        return relative(this.cleoDir, this.logPath).replaceAll('\\', '/');
-    }
-    /**
-     * Get all logged entries.
-     */
-    getEntries() {
-        return [...this.entries];
-    }
-    /**
-     * Get entries filtered by level.
-     */
-    getEntriesByLevel(level) {
-        return this.entries.filter((e) => e.level === level);
-    }
-    /**
-     * Get entries for a specific phase.
-     */
-    getEntriesByPhase(phase) {
-        return this.entries.filter((e) => e.phase === phase);
-    }
-    /**
-     * Get the total duration of the migration so far.
-     */
-    getDurationMs() {
-        return Date.now() - this.startTime;
-    }
-    /**
-     * Get summary statistics for the migration.
-     */
-    getSummary() {
-        const counts = {
-            error: 0,
-            warn: 0,
-            info: 0,
-            debug: 0,
-        };
-        const phases = new Set();
-        for (const entry of this.entries) {
-            counts[entry.level]++;
-            phases.add(entry.phase);
-        }
-        return {
-            totalEntries: this.entries.length,
-            durationMs: this.getDurationMs(),
-            errors: counts.error,
-            warnings: counts.warn,
-            info: counts.info,
-            debug: counts.debug,
-            phases: Array.from(phases).sort(),
-        };
-    }
-}
-/**
- * Create a migration logger for the given cleo directory.
- * Convenience function for functional programming style.
- */
-export function createMigrationLogger(cleoDir, config) {
-    return new MigrationLogger(cleoDir, config);
-}
-/**
- * Read and parse a migration log file.
- */
-export function readMigrationLog(logPath) {
-    const content = readFileSync(logPath, 'utf-8');
-    return content
-        .split('\n')
-        .filter((line) => line.trim())
-        .map((line) => JSON.parse(line));
-}
-/**
- * Check if a log file exists and is readable.
- */
-export function logFileExists(logPath) {
-    try {
-        accessSync(logPath, constants.R_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get the most recent migration log file for a cleo directory.
- */
-export function getLatestMigrationLog(cleoDir) {
-    try {
-        const logsDir = join(cleoDir, 'logs');
-        if (!existsSync(logsDir)) {
-            return null;
-        }
-        const files = readdirSync(logsDir)
-            .filter((f) => f.startsWith('migration-') && f.endsWith('.jsonl'))
-            .map((f) => ({
-            name: f,
-            path: join(logsDir, f),
-            mtime: statSync(join(logsDir, f)).mtime.getTime(),
-        }))
-            .sort((a, b) => b.mtime - a.mtime);
-        return files.length > 0 ? files[0].path : null;
-    }
-    catch {
-        return null;
-    }
-}
-//# sourceMappingURL=logger.js.map

package/dist/migration/logger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/migration/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAiCpD,iDAAiD;AACjD,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAChB,OAAO,GAAwB,EAAE,CAAC;IAClC,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,MAAM,CAAwB;IAEtC;;;;OAIG;IACH,YAAY,OAAe,EAAE,SAAgC,EAAE;QAC7D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG;YACZ,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO;YACpC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK;SAC7C,CAAC;QAEF,oCAAoC;QACpC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,SAAS,QAAQ,CAAC,CAAC;QAErE,+BAA+B;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,yBAAyB;QACzB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAe;QACtC,MAAM,UAAU,GAA6B;YAC3C,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAC;QACF,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,KAAe;QAC/B,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACK,GAAG,CACT,KAAe,EACf,KAAa,EACb,SAAiB,EACjB,OAAe,EACf,IAA8B;QAE9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAsB;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK;YACL,KAAK;YACL,SAAS;YACT,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACvC,IAAI;SACL,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEzB,iBAAiB;QACjB,IAAI,CAAC;YACH,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iDAAiD;YACjD,OAAO,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,SAAS,GAAG,CAAC;YACjE,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,SAAiB,EAAE,OAAe,EAAE,IAA8B;QACpF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,SAAiB,EAAE,OAAe,EAAE,IAA8B;QACpF,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa,EAAE,SAAiB,EAAE,OAAe,EAAE,IAA8B;QACrF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa,EAAE,SAAiB,EAAE,OAAe,EAAE,IAA8B;QACrF,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,KAAa,EACb,SAA4D,EAC5D,UAAkB,EAClB,UAAmB,EACnB,cAAwC;QAExC,MAAM,IAAI,GAA4B;YACpC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;YAC9C,GAAG,cAAc;SAClB,CAAC;QAEF,oCAAoC;QACpC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACnC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC7B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;oBACnC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;oBAC7B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,SAAS,EAAE,EAAE,QAAQ,SAAS,YAAY,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,aAAa,CACX,KAAa,EACb,MAAc,EACd,KAAc,EACd,OAAiC,EACjC,MAAiB;QAEjB,MAAM,IAAI,GAA4B;YACpC,MAAM;YACN,KAAK;YACL,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,yBAAyB,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,0BAA0B,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,yBAAyB,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,KAAa,EACb,UAAkB,EAClB,QAAgB,EAChB,KAAa,EACb,cAAwC;QAExC,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,QAAQ,OAAO,KAAK,IAAI,UAAU,EAAE,EAAE;YACpF,QAAQ;YACR,KAAK;YACL,OAAO;YACP,SAAS,EAAE,KAAK,GAAG,QAAQ;YAC3B,GAAG,cAAc;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa,EAAE,IAA8B;QACtD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAa,EAAE,IAA8B;QACzD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,oBAAoB,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa,EAAE,KAAqB,EAAE,IAA8B;QAC9E,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,iBAAiB,KAAK,EAAE,EAAE;YACpD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACrD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACvD,GAAG,IAAI;SACR,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAyD,WAAW,CAAC,OAAO,CAAC;iBACrF,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;iBACzE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;gBACnB,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;aAClD,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,CAAoB,EAAE,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAE3E,0CAA0C;YAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAY,CAAC,CAAC;YAC5D,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAe;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAa;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU;QASR,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACjC,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,MAAM,EAAE,MAAM,CAAC,KAAK;YACpB,QAAQ,EAAE,MAAM,CAAC,IAAI;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;SAClC,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,MAA8B;IAE9B,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE/C,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsB,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAyD,WAAW,CAAC,OAAO,CAAC;aACrF,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACzE,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC;YACnB,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACtB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;SAClD,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAoB,EAAE,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE3E,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/migration/preflight.d.ts

@@ -1,10 +0,0 @@
-/**
- * Backward-compatible pre-flight migration exports.
- *
- * Runtime callers should import from src/core/system/storage-preflight.ts.
- *
- * @task T5305
- */
-export type { PreflightResult } from '../system/storage-preflight.js';
-export { checkStorageMigration } from '../system/storage-preflight.js';
-//# sourceMappingURL=preflight.d.ts.map

package/dist/migration/preflight.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/migration/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/migration/preflight.js

@@ -1,9 +0,0 @@
-/**
- * Backward-compatible pre-flight migration exports.
- *
- * Runtime callers should import from src/core/system/storage-preflight.ts.
- *
- * @task T5305
- */
-export { checkStorageMigration } from '../system/storage-preflight.js';
-//# sourceMappingURL=preflight.js.map

package/dist/migration/preflight.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/migration/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/migration/state.d.ts

@@ -1,186 +0,0 @@
-/**
- * Migration state tracking and recovery.
- *
- * Provides persistent tracking of migration progress to enable:
- * - Resumable migrations after interruptions
- * - Debugging of failed migrations
- * - Progress monitoring during long operations
- *
- * @task T4726
- * @epic T4454
- */
-/** Migration phase - tracks current step in the migration process */
-export type MigrationPhase = 'init' | 'backup' | 'validate' | 'import' | 'verify' | 'cleanup' | 'complete' | 'failed';
-/** Source file info with checksum for integrity verification */
-export interface SourceFileInfo {
-    path: string;
-    checksum: string;
-    taskCount?: number;
-    sessionCount?: number;
-    archivedCount?: number;
-}
-/** Migration progress tracking */
-export interface MigrationProgress {
-    tasksImported: number;
-    archivedImported: number;
-    sessionsImported: number;
-    totalTasks: number;
-    totalArchived: number;
-    totalSessions: number;
-}
-/** Complete migration state structure */
-export interface MigrationState {
-    version: '1.0.0';
-    startedAt: string;
-    phase: MigrationPhase;
-    sourceFiles: {
-        todoJson?: SourceFileInfo;
-        sessionsJson?: SourceFileInfo;
-        archiveJson?: SourceFileInfo;
-    };
-    backupPath?: string;
-    tempPath?: string;
-    progress: MigrationProgress;
-    errors: string[];
-    warnings: string[];
-    completedAt?: string;
-}
-/**
- * Create initial migration state at the start of migration.
- *
- * Captures source file checksums and initializes progress tracking.
- * Uses atomic write pattern to ensure state is never in an inconsistent state.
- *
- * @param cleoDir - Path to .cleo directory
- * @param sourceFiles - Optional pre-computed source file info
- * @returns The created migration state
- * @task T4726
- */
-export declare function createMigrationState(cleoDir: string, sourceFiles?: MigrationState['sourceFiles']): Promise<MigrationState>;
-/**
- * Update migration state with partial updates.
- *
- * Merges updates with existing state and writes atomically.
- * Automatically adds timestamp to phase transitions.
- *
- * @param cleoDir - Path to .cleo directory
- * @param updates - Partial state updates to apply
- * @returns The updated migration state
- * @task T4726
- */
-export declare function updateMigrationState(cleoDir: string, updates: Partial<MigrationState>): Promise<MigrationState>;
-/**
- * Update just the migration phase.
- * Convenience wrapper for common phase transition.
- *
- * @param cleoDir - Path to .cleo directory
- * @param phase - New phase
- * @returns The updated migration state
- * @task T4726
- */
-export declare function updateMigrationPhase(cleoDir: string, phase: MigrationPhase): Promise<MigrationState>;
-/**
- * Update progress counters during import.
- *
- * @param cleoDir - Path to .cleo directory
- * @param progress - Progress updates (only changed counters needed)
- * @returns The updated migration state
- * @task T4726
- */
-export declare function updateMigrationProgress(cleoDir: string, progress: Partial<MigrationProgress>): Promise<MigrationState>;
-/**
- * Add an error to the migration state.
- *
- * @param cleoDir - Path to .cleo directory
- * @param error - Error message
- * @returns The updated migration state
- * @task T4726
- */
-export declare function addMigrationError(cleoDir: string, error: string): Promise<MigrationState>;
-/**
- * Add a warning to the migration state.
- *
- * @param cleoDir - Path to .cleo directory
- * @param warning - Warning message
- * @returns The updated migration state
- * @task T4726
- */
-export declare function addMigrationWarning(cleoDir: string, warning: string): Promise<MigrationState>;
-/**
- * Load existing migration state.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns Migration state, or null if no state file exists
- * @task T4726
- */
-export declare function loadMigrationState(cleoDir: string): Promise<MigrationState | null>;
-/**
- * Check if a migration is in progress.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns true if migration state exists and is not complete/failed
- * @task T4726
- */
-export declare function isMigrationInProgress(cleoDir: string): Promise<boolean>;
-/**
- * Check if migration can be resumed.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns Object with resume info, or null if cannot resume
- * @task T4726
- */
-export declare function canResumeMigration(cleoDir: string): Promise<{
-    canResume: boolean;
-    phase: MigrationPhase;
-    progress: MigrationProgress;
-    errors: string[];
-} | null>;
-/**
- * Mark migration as complete.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns The completed migration state
- * @task T4726
- */
-export declare function completeMigration(cleoDir: string): Promise<MigrationState>;
-/**
- * Mark migration as failed with error details.
- *
- * @param cleoDir - Path to .cleo directory
- * @param error - Primary error message
- * @returns The failed migration state
- * @task T4726
- */
-export declare function failMigration(cleoDir: string, error: string): Promise<MigrationState>;
-/**
- * Clear migration state file.
- * Safe to call even if state doesn't exist.
- *
- * @param cleoDir - Path to .cleo directory
- * @task T4726
- */
-export declare function clearMigrationState(cleoDir: string): Promise<void>;
-/**
- * Get a summary of migration state for display.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns Human-readable summary, or null if no state
- * @task T4726
- */
-export declare function getMigrationSummary(cleoDir: string): Promise<string | null>;
-/**
- * Verify source files haven't changed since migration started.
- *
- * Compares current checksums with stored checksums to detect
- * if source files were modified during migration.
- *
- * @param cleoDir - Path to .cleo directory
- * @returns Object with verification results
- * @task T4726
- */
-export declare function verifySourceIntegrity(cleoDir: string): Promise<{
-    valid: boolean;
-    changed: string[];
-    missing: string[];
-}>;
-//# sourceMappingURL=state.d.ts.map

package/dist/migration/state.d.ts.map

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