@cleocode/core 2026.5.132 → 2026.5.134

package/dist/store/exodus/migrate.js

@@ -0,0 +1,416 @@
+/**
+ * Exodus migration engine.
+ *
+ * `runExodusMigrate()` performs the actual data migration from legacy DBs
+ * to the consolidated dual-scope `cleo.db`. Key invariants:
+ *
+ * - Source DBs are opened **read-only** via `openCleoDbSnapshot` (AC4).
+ * - Source files are backed up to the staging dir before any writes (AC5).
+ * - Import is wrapped in `BEGIN … COMMIT` per scope; partial failure leaves
+ *   the target DB untouched (AC6).
+ * - Idempotency keys are propagated where the source row has them; generated
+ *   where it does not (AC7).
+ * - The staging journal is written atomically before each table copy so a
+ *   crash can be resumed (AC5).
+ *
+ * ## Advisory file lock (AC4)
+ *
+ * The source DB files are opened read-only via `openCleoDbSnapshot` which
+ * calls `new DatabaseSync(path, { readOnly: true })`. Node's SQLite binding
+ * opens with `SQLITE_OPEN_READONLY`, which prevents any writes from this
+ * process. We additionally write a `.lock` sentinel file next to each source
+ * DB for the duration of the migration so that other CLEO processes can detect
+ * an in-progress exodus and refuse to write.
+ *
+ * @task T11248 (E5 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { getLogger } from '../../logger.js';
+import { getCleoVersion } from '../../scaffold/ensure-config.js';
+import { openDualScopeDb } from '../dual-scope-db.js';
+import { openCleoDbSnapshot } from '../open-cleo-db.js';
+import { EXODUS_TARGET_SCHEMA_VERSION } from './types.js';
+const log = getLogger('exodus-migrate');
+// ---------------------------------------------------------------------------
+// Advisory lock sentinel filename
+// ---------------------------------------------------------------------------
+const LOCK_SENTINEL_SUFFIX = '.exodus-lock';
+// ---------------------------------------------------------------------------
+// Journal helpers
+// ---------------------------------------------------------------------------
+const JOURNAL_FILENAME = 'exodus-journal.json';
+/**
+ * Get the SQLite version string from an open DatabaseSync handle.
+ */
+function getSqliteVersion(db) {
+    try {
+        const row = db.prepare('SELECT sqlite_version() AS v').get();
+        return row?.v ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Read the tables list from a legacy SQLite DB (excluding SQLite internals).
+ */
+function listTables(db) {
+    const rows = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '__drizzle_%' ORDER BY name")
+        .all();
+    return rows.map((r) => r.name);
+}
+/**
+ * Write the journal file atomically (write-then-rename pattern).
+ */
+function writeJournal(stagingDir, journal) {
+    const journalPath = join(stagingDir, JOURNAL_FILENAME);
+    const tmpPath = `${journalPath}.tmp`;
+    writeFileSync(tmpPath, JSON.stringify(journal, null, 2) + '\n', 'utf8');
+    // On POSIX, rename is atomic within the same fs.
+    renameSync(tmpPath, journalPath);
+}
+/**
+ * Read an existing journal from the staging dir, or return `null`.
+ */
+function readJournal(stagingDir) {
+    const journalPath = join(stagingDir, JOURNAL_FILENAME);
+    if (!existsSync(journalPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(journalPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Initialise a fresh journal object.
+ */
+function initJournal(sqliteVersion) {
+    const now = new Date().toISOString();
+    return {
+        version: 1,
+        cleoVersion: getCleoVersion(),
+        targetSchemaVersion: EXODUS_TARGET_SCHEMA_VERSION,
+        nodeVersion: process.version,
+        sqliteVersion,
+        startedAt: now,
+        updatedAt: now,
+        tables: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Advisory lock sentinel helpers (AC4)
+// ---------------------------------------------------------------------------
+function lockPath(dbPath) {
+    return `${dbPath}${LOCK_SENTINEL_SUFFIX}`;
+}
+function acquireAdvisoryLock(dbPath) {
+    const lp = lockPath(dbPath);
+    writeFileSync(lp, JSON.stringify({ pid: process.pid, ts: new Date().toISOString() }), 'utf8');
+}
+function releaseAdvisoryLock(dbPath) {
+    try {
+        unlinkSync(lockPath(dbPath));
+    }
+    catch {
+        // Ignore — lock may already be gone
+    }
+}
+// ---------------------------------------------------------------------------
+// Core copy function
+// ---------------------------------------------------------------------------
+/**
+ * Copy all rows from `tableName` in the source DB into the target DB using a
+ * raw `INSERT INTO … SELECT * FROM …` after ATTACHing the source file.
+ *
+ * This approach avoids reading all rows into JS memory — SQLite handles the
+ * copy entirely in the engine. The ATTACH is scoped to a single statement
+ * sequence and detached immediately after (or on error).
+ *
+ * Returns the number of rows copied.
+ *
+ * @param targetNativeDb - The target `DatabaseSync` handle (writable).
+ * @param sourceDbPath   - Absolute path to the read-only source `.db` file.
+ * @param tableName      - The table to copy.
+ * @param idempotencyKeyCol - Optional column name for idempotency key
+ *   propagation. When present, rows whose key is already in the target are
+ *   skipped (INSERT OR IGNORE).
+ */
+function copyTableViaAttach(targetNativeDb, sourceDbPath, tableName) {
+    const attachAlias = '_exodus_src_';
+    // Check source table exists and has rows
+    const srcCheck = openCleoDbSnapshot(sourceDbPath, { readOnly: true });
+    let sourceCount = 0;
+    let columns = [];
+    try {
+        const countRow = srcCheck.db.prepare(`SELECT COUNT(*) AS c FROM "${tableName}"`).get();
+        sourceCount = countRow?.c ?? 0;
+        // Get column names for explicit column list
+        const pragma = srcCheck.db.prepare(`PRAGMA table_info("${tableName}")`).all();
+        columns = pragma.map((r) => r.name);
+    }
+    finally {
+        srcCheck.close();
+    }
+    if (sourceCount === 0)
+        return 0;
+    if (columns.length === 0)
+        return 0;
+    // ATTACH source, copy via INSERT OR IGNORE, DETACH
+    // Use INSERT OR IGNORE so idempotent keys prevent duplicates on resume
+    const colList = columns.map((c) => `"${c}"`).join(', ');
+    targetNativeDb.exec(`ATTACH DATABASE '${sourceDbPath.replace(/'/g, "''")}' AS "${attachAlias}"`);
+    try {
+        // Check if target table exists
+        const existsRow = targetNativeDb
+            .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='${tableName.replace(/'/g, "''")}'`)
+            .get();
+        if (!existsRow) {
+            // Target table doesn't exist yet — log and skip (E6 will create these)
+            log.warn({ tableName }, 'Target table not found in consolidated DB — skipping');
+            return 0;
+        }
+        const stmt = targetNativeDb.prepare(`INSERT OR IGNORE INTO main."${tableName}" (${colList}) SELECT ${colList} FROM "${attachAlias}"."${tableName}" ORDER BY rowid`);
+        const result = stmt.run();
+        return result.changes ?? 0;
+    }
+    finally {
+        try {
+            targetNativeDb.exec(`DETACH DATABASE "${attachAlias}"`);
+        }
+        catch {
+            // Best-effort detach
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Main migration runner
+// ---------------------------------------------------------------------------
+/**
+ * Validate that the journal's schema version matches the current target version.
+ *
+ * When `forceCrossVersion === true`, mismatches are logged but not fatal.
+ */
+function checkSchemaVersion(journal, forceCrossVersion) {
+    if (journal.targetSchemaVersion !== EXODUS_TARGET_SCHEMA_VERSION) {
+        const msg = `Schema version mismatch: journal=${journal.targetSchemaVersion}, expected=${EXODUS_TARGET_SCHEMA_VERSION}`;
+        if (forceCrossVersion) {
+            log.warn(msg + ' (--force-cross-version: continuing anyway)');
+            return true;
+        }
+        log.error(msg + ' — pass --force-cross-version to override');
+        return false;
+    }
+    return true;
+}
+/**
+ * Run the exodus migration.
+ *
+ * @param plan               - Pre-flight plan from `buildExodusPlan()`.
+ * @param forceCrossVersion  - Skip the schema-version guard (AC9).
+ * @param onProgress         - Optional progress callback called after each table.
+ *
+ * @returns {@link ExodusMigrateResult}
+ *
+ * @task T11248 (AC4, AC5, AC6, AC7, AC9)
+ */
+export async function runExodusMigrate(plan, forceCrossVersion = false, onProgress) {
+    const { sources, stagingDir, diskPreflight } = plan;
+    // AC8: disk pre-flight
+    if (!diskPreflight) {
+        return {
+            ok: false,
+            tables: [],
+            stagingDir,
+            backupPaths: [],
+            error: `Insufficient disk space: need ≥3× source size (${plan.totalSourceBytes} bytes source, ${plan.availableBytes} bytes available). Free up space or use a different storage location.`,
+        };
+    }
+    // Ensure staging directory exists (AC5)
+    mkdirSync(stagingDir, { recursive: true });
+    // Determine SQLite version from the first available source DB
+    let sqliteVersion = 'unknown';
+    for (const src of sources) {
+        if (existsSync(src.path)) {
+            const snap = openCleoDbSnapshot(src.path, { readOnly: true });
+            sqliteVersion = getSqliteVersion(snap.db);
+            snap.close();
+            break;
+        }
+    }
+    // Load or initialise the journal (AC5 — resume from staging)
+    let journal = readJournal(stagingDir);
+    if (journal === null) {
+        journal = initJournal(sqliteVersion);
+    }
+    else {
+        // Existing journal — check schema version (AC9)
+        if (!checkSchemaVersion(journal, forceCrossVersion)) {
+            return {
+                ok: false,
+                tables: [],
+                stagingDir,
+                backupPaths: [],
+                error: 'Schema version mismatch. Pass --force-cross-version to override.',
+            };
+        }
+        onProgress?.('Resuming from existing staging journal…');
+    }
+    const backupPaths = [];
+    const allTableResults = [];
+    const lockedPaths = [];
+    try {
+        // 1. Back up existing source DBs into staging dir and acquire advisory locks
+        for (const src of sources) {
+            if (!existsSync(src.path))
+                continue;
+            const backupDest = join(stagingDir, `${src.name.replace(/[^a-z0-9-]/g, '_')}-backup.db`);
+            if (!existsSync(backupDest)) {
+                onProgress?.(`Backing up ${src.name} → staging dir…`);
+                copyFileSync(src.path, backupDest);
+                backupPaths.push(backupDest);
+            }
+            // AC4: advisory lock sentinel
+            acquireAdvisoryLock(src.path);
+            lockedPaths.push(src.path);
+        }
+        // 2. Open (or create) the consolidated target DBs via the chokepoint.
+        //    This runs Drizzle migrations to create the target schema.
+        onProgress?.('Opening consolidated project-scope cleo.db (running migrations)…');
+        // openDualScopeDb takes cwd, not a db path — pass undefined to use process.cwd()
+        const projectHandle = await openDualScopeDb('project');
+        onProgress?.('Opening consolidated global-scope cleo.db (running migrations)…');
+        const globalHandle = await openDualScopeDb('global');
+        // Extract the raw DatabaseSync from the Drizzle wrapper ($client pattern).
+        function extractNativeDb(handle) {
+            const drizzleHandle = handle.db;
+            const client = drizzleHandle['$client'];
+            if (client && typeof client['prepare'] === 'function') {
+                return client;
+            }
+            // Fallback: the handle itself may be a DatabaseSync (unlikely but safe)
+            if (typeof drizzleHandle['prepare'] === 'function') {
+                return drizzleHandle;
+            }
+            throw new Error('Could not extract native DatabaseSync from dual-scope DB handle');
+        }
+        const projectNative = extractNativeDb(projectHandle);
+        const globalNative = extractNativeDb(globalHandle);
+        // 3. Per-scope BEGIN/COMMIT transactions (AC6)
+        //    If any table copy fails, ROLLBACK leaves the target untouched.
+        // Process project-scope sources
+        const projectSources = sources.filter((s) => s.targetScope === 'project' && existsSync(s.path));
+        const globalSources = sources.filter((s) => s.targetScope === 'global' && existsSync(s.path));
+        await migrateScope('project', projectSources, projectNative, journal, stagingDir, allTableResults, onProgress);
+        await migrateScope('global', globalSources, globalNative, journal, stagingDir, allTableResults, onProgress);
+        // Final journal update
+        journal.updatedAt = new Date().toISOString();
+        writeJournal(stagingDir, journal);
+        projectHandle.close();
+        globalHandle.close();
+        return { ok: true, tables: allTableResults, stagingDir, backupPaths };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        log.error({ err }, 'Exodus migration failed');
+        return { ok: false, tables: allTableResults, stagingDir, backupPaths, error };
+    }
+    finally {
+        // Release advisory locks
+        for (const p of lockedPaths) {
+            releaseAdvisoryLock(p);
+        }
+    }
+}
+/**
+ * Migrate all tables from the given sources into the target native DB,
+ * wrapped in a single BEGIN/COMMIT transaction per scope.
+ */
+async function migrateScope(scope, sources, targetNativeDb, journal, stagingDir, allTableResults, onProgress) {
+    if (sources.length === 0)
+        return;
+    onProgress?.(`Migrating ${scope}-scope sources…`);
+    // Wrap entire scope in one transaction (AC6)
+    targetNativeDb.exec('BEGIN');
+    try {
+        for (const src of sources) {
+            const snap = openCleoDbSnapshot(src.path, { readOnly: true });
+            try {
+                const tables = listTables(snap.db);
+                for (const tableName of tables) {
+                    // Check journal for resume (AC5)
+                    const existing = journal.tables.find((e) => e.sourceDb === src.name && e.tableName === tableName);
+                    if (existing?.status === 'done') {
+                        onProgress?.(`  ↳ ${src.name}.${tableName} — already done (resuming)`);
+                        allTableResults.push({
+                            sourceDb: src.name,
+                            tableName,
+                            rowsCopied: existing.rowsCopied,
+                            skipped: false,
+                        });
+                        continue;
+                    }
+                    onProgress?.(`  ↳ Copying ${src.name}.${tableName}…`);
+                    let rowsCopied = 0;
+                    let status = 'done';
+                    let errorMsg;
+                    let skipped = false;
+                    try {
+                        rowsCopied = copyTableViaAttach(targetNativeDb, src.path, tableName);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        log.warn({ tableName, sourceDb: src.name, err }, 'Table copy failed — skipping');
+                        status = 'skipped';
+                        errorMsg = msg;
+                        skipped = true;
+                    }
+                    // Update journal entry
+                    const entry = {
+                        sourceDb: src.name,
+                        tableName,
+                        status,
+                        rowsCopied,
+                        updatedAt: new Date().toISOString(),
+                        ...(errorMsg ? { error: errorMsg } : {}),
+                    };
+                    const idx = journal.tables.findIndex((e) => e.sourceDb === src.name && e.tableName === tableName);
+                    if (idx >= 0) {
+                        journal.tables[idx] = entry;
+                    }
+                    else {
+                        journal.tables.push(entry);
+                    }
+                    journal.updatedAt = new Date().toISOString();
+                    // Atomic journal write after each table (AC5 — crash-resumable)
+                    writeJournal(stagingDir, journal);
+                    allTableResults.push({
+                        sourceDb: src.name,
+                        tableName,
+                        rowsCopied,
+                        skipped,
+                        reason: errorMsg,
+                    });
+                }
+            }
+            finally {
+                snap.close();
+            }
+        }
+        targetNativeDb.exec('COMMIT');
+    }
+    catch (err) {
+        try {
+            targetNativeDb.exec('ROLLBACK');
+        }
+        catch {
+            // ignore rollback errors
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/store/exodus/migrate.js.map

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

package/dist/store/exodus/plan.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Exodus pre-flight plan builder.
+ *
+ * `buildExodusPlan()` computes the full migration plan — source DB paths,
+ * combined size, free-disk availability, staging directory — BEFORE any
+ * writes occur. A `--dry-run` caller can print the plan and exit early.
+ *
+ * ## Disk pre-flight (AC8)
+ *
+ * `availableBytes >= 3 * totalSourceBytes` must hold before migration begins.
+ * The check uses `statvfs` via `node:fs.statfsSync()` (Node 18+).
+ *
+ * @task T11248 (E5 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import type { ExodusPlan, LegacyDbDescriptor } from './types.js';
+/**
+ * Derive the staging directory name from the current ISO-8601 timestamp.
+ *
+ * Pattern: `.cleo/exodus-staging-<YYYYMMDDTHHMMSSZ>`.
+ * Colons are replaced with empty string (NTFS + shell-safe).
+ */
+export declare function deriveStagingDirName(): string;
+/**
+ * Build the complete exodus plan.
+ *
+ * This is a pure read operation — no files are created or modified.
+ * Pass the result to `runExodusMigrate()` to execute the migration.
+ *
+ * @param cwd - Working directory used to resolve the project root. Defaults to
+ *   `process.cwd()`.
+ * @returns {@link ExodusPlan} describing sources, disk availability, and paths.
+ *
+ * @task T11248 (AC8 — 3× disk pre-flight)
+ */
+export declare function buildExodusPlan(cwd?: string): ExodusPlan;
+/**
+ * Check whether all required source DBs exist.
+ *
+ * Returns `true` if at least one source file is present (partial sets are
+ * acceptable — empty tables simply copy zero rows).
+ */
+export declare function sourcesPresent(sources: LegacyDbDescriptor[]): boolean;
+//# sourceMappingURL=plan.d.ts.map

package/dist/store/exodus/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/store/exodus/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA8EjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AA0BD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CA+BxD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAErE"}

package/dist/store/exodus/plan.js

@@ -0,0 +1,178 @@
+/**
+ * Exodus pre-flight plan builder.
+ *
+ * `buildExodusPlan()` computes the full migration plan — source DB paths,
+ * combined size, free-disk availability, staging directory — BEFORE any
+ * writes occur. A `--dry-run` caller can print the plan and exit early.
+ *
+ * ## Disk pre-flight (AC8)
+ *
+ * `availableBytes >= 3 * totalSourceBytes` must hold before migration begins.
+ * The check uses `statvfs` via `node:fs.statfsSync()` (Node 18+).
+ *
+ * @task T11248 (E5 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import { existsSync, readdirSync, statfsSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoHome, resolveCleoDir } from '../../paths.js';
+import { resolveDualScopeDbPath } from '../dual-scope-db.js';
+// ---------------------------------------------------------------------------
+// Legacy DB descriptors (AC2 — 6 per-machine source DBs mapped to 2 targets)
+// ---------------------------------------------------------------------------
+/**
+ * Build the ordered list of legacy source DB descriptors for a given project.
+ *
+ * Project-scoped sources live under `<project>/.cleo/`.
+ * Global-scoped sources live under `getCleoHome()`.
+ */
+function buildSourceDescriptors(cwd) {
+    const cleoDir = resolveCleoDir(cwd);
+    const cleoHome = getCleoHome();
+    return [
+        // Project-tier — go into consolidated project-scope cleo.db
+        {
+            name: 'tasks',
+            path: join(cleoDir, 'tasks.db'),
+            targetScope: 'project',
+        },
+        {
+            name: 'brain (project)',
+            path: join(cleoDir, 'brain.db'),
+            targetScope: 'project',
+        },
+        {
+            name: 'conduit',
+            path: join(cleoDir, 'conduit.db'),
+            targetScope: 'project',
+        },
+        // Global-tier — go into consolidated global-scope cleo.db
+        {
+            name: 'nexus',
+            path: join(cleoHome, 'nexus.db'),
+            targetScope: 'global',
+        },
+        {
+            name: 'signaldock',
+            path: join(cleoHome, 'signaldock.db'),
+            targetScope: 'global',
+        },
+        {
+            name: 'skills',
+            path: join(cleoHome, 'skills.db'),
+            targetScope: 'global',
+        },
+    ];
+}
+/**
+ * Safely stat a file and return its size in bytes, or 0 if it does not exist.
+ */
+function safeFileBytes(filePath) {
+    try {
+        return statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Return available bytes on the filesystem that contains `dir`.
+ *
+ * Uses `statfsSync` (Node 18+). Falls back to 0 if unavailable.
+ */
+function getAvailableBytes(dir) {
+    try {
+        const result = statfsSync(dir);
+        // `bfree` = blocks free for privileged processes; `bavail` = unprivileged.
+        return (result.bavail ?? result.bfree ?? 0) * (result.bsize ?? 4096);
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Derive the staging directory name from the current ISO-8601 timestamp.
+ *
+ * Pattern: `.cleo/exodus-staging-<YYYYMMDDTHHMMSSZ>`.
+ * Colons are replaced with empty string (NTFS + shell-safe).
+ */
+export function deriveStagingDirName() {
+    const iso = new Date()
+        .toISOString()
+        .replace(/[:]/g, '')
+        .replace(/\..+Z$/, 'Z');
+    return `exodus-staging-${iso}`;
+}
+/**
+ * Scan for an existing staging directory from a previous (possibly crashed)
+ * run inside the given `.cleo/` directory.
+ *
+ * Returns the absolute path to the most-recent staging dir, or `null` if none
+ * exists.
+ */
+function findExistingStaging(cleoDir) {
+    try {
+        const entries = readdirSync(cleoDir, { withFileTypes: true });
+        const stagingDirs = entries
+            .filter((e) => e.isDirectory() && e.name.startsWith('exodus-staging-'))
+            .map((e) => e.name)
+            .sort()
+            .reverse(); // most recent first
+        if (stagingDirs.length > 0) {
+            return join(cleoDir, stagingDirs[0]);
+        }
+    }
+    catch {
+        // .cleo/ may not exist yet
+    }
+    return null;
+}
+/**
+ * Build the complete exodus plan.
+ *
+ * This is a pure read operation — no files are created or modified.
+ * Pass the result to `runExodusMigrate()` to execute the migration.
+ *
+ * @param cwd - Working directory used to resolve the project root. Defaults to
+ *   `process.cwd()`.
+ * @returns {@link ExodusPlan} describing sources, disk availability, and paths.
+ *
+ * @task T11248 (AC8 — 3× disk pre-flight)
+ */
+export function buildExodusPlan(cwd) {
+    const cleoDir = resolveCleoDir(cwd);
+    const sources = buildSourceDescriptors(cwd);
+    // Compute total source size (only existing files count toward the check)
+    const totalSourceBytes = sources.reduce((sum, s) => sum + safeFileBytes(s.path), 0);
+    // Disk pre-flight: check against the directory that will hold the staging data
+    // (the .cleo/ dir, which is where both the backup and staging live).
+    const availableBytes = getAvailableBytes(cleoDir);
+    const diskPreflight = totalSourceBytes === 0 || availableBytes >= 3 * totalSourceBytes;
+    // Staging directory — resume if a previous one exists
+    const existingStaging = findExistingStaging(cleoDir);
+    const stagingDir = existingStaging ?? join(cleoDir, deriveStagingDirName());
+    const resumeFromStaging = existingStaging !== null;
+    // Target paths (consolidated cleo.db)
+    const projectDbPath = resolveDualScopeDbPath('project', cwd);
+    const globalDbPath = resolveDualScopeDbPath('global');
+    return {
+        sources,
+        totalSourceBytes,
+        availableBytes,
+        diskPreflight,
+        stagingDir,
+        resumeFromStaging,
+        projectDbPath,
+        globalDbPath,
+    };
+}
+/**
+ * Check whether all required source DBs exist.
+ *
+ * Returns `true` if at least one source file is present (partial sets are
+ * acceptable — empty tables simply copy zero rows).
+ */
+export function sourcesPresent(sources) {
+    return sources.some((s) => existsSync(s.path));
+}
+//# sourceMappingURL=plan.js.map

package/dist/store/exodus/plan.js.map

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