@cleocode/core 2026.4.9 → 2026.4.12

package/dist/migration/index.js

@@ -0,0 +1,282 @@
+/**
+ * Migration system - schema version detection and migration runner.
+ * @task T4468
+ * @epic T4454
+ */
+// Re-export agent-outputs migration utility (@task T4700)
+export { detectLegacyAgentOutputs, migrateAgentOutputs, } from './agent-outputs.js';
+// Re-export checksum utilities for backup verification (@task T4728)
+export { compareChecksums, computeChecksum, verifyBackup, } from './checksum.js';
+// Re-export migration logger (@task T4727)
+export { createMigrationLogger, getLatestMigrationLog, logFileExists, MigrationLogger, readMigrationLog, } from './logger.js';
+// Re-export pre-flight check for CLI consumers (@task T4699)
+export { checkStorageMigration } from './preflight.js';
+// Re-export migration state tracking (@task T4726)
+export { addMigrationError, addMigrationWarning, canResumeMigration, clearMigrationState, completeMigration, createMigrationState, failMigration, getMigrationSummary, isMigrationInProgress, loadMigrationState, updateMigrationPhase, updateMigrationProgress, updateMigrationState, verifySourceIntegrity, } from './state.js';
+// Re-export pre-migration validation (@task T4725)
+export { checkTaskCountMismatch, formatValidationResult, validateSourceFiles, } from './validate.js';
+import { join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getBackupDir, getCleoDirAbsolute, getConfigPath, getTaskPath } from '../paths.js';
+import { readJson, saveJson } from '../store/json.js';
+// 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 taskData = await readJson(getTaskPath(cwd));
+        if (taskData) {
+            const current = detectVersion(taskData);
+            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/migration/index.js.map

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

package/dist/migration/logger.js

@@ -0,0 +1,360 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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.js

@@ -0,0 +1,9 @@
+/**
+ * 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

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