@cleocode/core 2026.5.133 → 2026.5.134

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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"}

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

@@ -0,0 +1,22 @@
+/**
+ * Exodus status reporter.
+ *
+ * `runExodusStatus()` returns a structured view of the current exodus state
+ * without performing any reads or writes beyond stat() calls.
+ *
+ * @task T11248 (E5 · AC3 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import type { ExodusStatusResult } from './types.js';
+/**
+ * Return a structured status report for the exodus subsystem.
+ *
+ * This is a read-only operation — no mutations occur.
+ *
+ * @param cwd - Working directory used to resolve the project root.
+ * @returns {@link ExodusStatusResult}
+ *
+ * @task T11248 (AC3)
+ */
+export declare function runExodusStatus(cwd?: string): ExodusStatusResult;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/store/exodus/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA0CpE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA4BhE"}

package/dist/store/exodus/status.js

@@ -0,0 +1,88 @@
+/**
+ * Exodus status reporter.
+ *
+ * `runExodusStatus()` returns a structured view of the current exodus state
+ * without performing any reads or writes beyond stat() calls.
+ *
+ * @task T11248 (E5 · AC3 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveCleoDir } from '../../paths.js';
+import { resolveDualScopeDbPath } from '../dual-scope-db.js';
+import { buildExodusPlan } from './plan.js';
+// ---------------------------------------------------------------------------
+// Journal reader (mirrors logic in migrate.ts — kept local for zero coupling)
+// ---------------------------------------------------------------------------
+const JOURNAL_FILENAME = 'exodus-journal.json';
+function readJournal(stagingDir) {
+    const p = join(stagingDir, JOURNAL_FILENAME);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function findStagingDirs(cleoDir) {
+    try {
+        return readdirSync(cleoDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && e.name.startsWith('exodus-staging-'))
+            .map((e) => join(cleoDir, e.name))
+            .sort()
+            .reverse(); // most-recent first
+    }
+    catch {
+        return [];
+    }
+}
+function safeBytes(p) {
+    try {
+        return statSync(p).size;
+    }
+    catch {
+        return 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Main status runner
+// ---------------------------------------------------------------------------
+/**
+ * Return a structured status report for the exodus subsystem.
+ *
+ * This is a read-only operation — no mutations occur.
+ *
+ * @param cwd - Working directory used to resolve the project root.
+ * @returns {@link ExodusStatusResult}
+ *
+ * @task T11248 (AC3)
+ */
+export function runExodusStatus(cwd) {
+    const plan = buildExodusPlan(cwd);
+    const cleoDir = resolveCleoDir(cwd);
+    // Find staging directories
+    const stagingDirs = findStagingDirs(cleoDir);
+    const latestStaging = stagingDirs[0] ?? null;
+    const journal = latestStaging ? readJournal(latestStaging) : null;
+    const projectDbPath = resolveDualScopeDbPath('project', cwd);
+    const globalDbPath = resolveDualScopeDbPath('global');
+    const sourcesInfo = plan.sources.map((s) => ({
+        name: s.name,
+        path: s.path,
+        exists: existsSync(s.path),
+        bytes: safeBytes(s.path),
+    }));
+    return {
+        hasStaging: latestStaging !== null,
+        stagingDir: latestStaging,
+        journal,
+        projectDbExists: existsSync(projectDbPath),
+        globalDbExists: existsSync(globalDbPath),
+        sourcesPresent: sourcesInfo.some((s) => s.exists),
+        sources: sourcesInfo,
+    };
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,169 @@
+/**
+ * Shared types for the `cleo exodus` migration subsystem.
+ *
+ * The exodus subsystem migrates data from the legacy multi-DB fleet
+ * (tasks.db · brain.db · conduit.db · nexus.db · signaldock.db · skills.db)
+ * into the consolidated dual-scope `cleo.db` (project + global).
+ *
+ * @task T11248 (E5 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ * @adr ADR-068, ADR-069
+ */
+/** The two consolidated target scopes. */
+export type ExodusScope = 'project' | 'global';
+/**
+ * Descriptor for one legacy source database.
+ *
+ * Each legacy DB maps to a scope (project or global) and a set of tables
+ * that will be copied into the consolidated `cleo.db` for that scope.
+ */
+export interface LegacyDbDescriptor {
+    /** Logical name for display / logging. */
+    readonly name: string;
+    /** Absolute path to the legacy `.db` file. */
+    readonly path: string;
+    /** Consolidated target scope that will receive this DB's tables. */
+    readonly targetScope: ExodusScope;
+}
+/**
+ * Per-table migration status tracked inside the staging journal
+ * (`exodus-journal.json`).
+ */
+export type TableMigrationStatus = 'pending' | 'done' | 'skipped';
+/** Journal entry for one source table. */
+export interface JournalTableEntry {
+    readonly sourceDb: string;
+    readonly tableName: string;
+    status: TableMigrationStatus;
+    rowsCopied: number;
+    /** ISO-8601 timestamp of last update. */
+    updatedAt: string;
+    /** Error message if status ended in a non-retryable skip. */
+    error?: string;
+}
+/**
+ * Contents of `.cleo/exodus-staging-<iso>/exodus-journal.json`.
+ *
+ * Written before the migration begins and updated atomically after each table
+ * copy so that a crash can be resumed from the last completed table.
+ */
+export interface ExodusJournal {
+    /** Exodus format version — bump when the schema changes. */
+    readonly version: 1;
+    /** cleo package version at the time the migration was started. */
+    readonly cleoVersion: string;
+    /** Drizzle v1.0.0-rc.3 schema hash (constant — used for cross-version guard). */
+    readonly targetSchemaVersion: string;
+    /** Node.js version at migration time. */
+    readonly nodeVersion: string;
+    /** SQLite version at migration time. */
+    readonly sqliteVersion: string;
+    /** ISO-8601 timestamp when the journal was first created. */
+    readonly startedAt: string;
+    /** ISO-8601 timestamp of last update. */
+    updatedAt: string;
+    /** Per-table progress entries. Ordered by (sourceDb, tableName). */
+    tables: JournalTableEntry[];
+}
+/**
+ * Result of a single `ExodusTable` copy operation.
+ *
+ * Returned by `copyTable` and collected into the migration report.
+ */
+export interface TableCopyResult {
+    readonly sourceDb: string;
+    readonly tableName: string;
+    readonly rowsCopied: number;
+    readonly skipped: boolean;
+    readonly reason?: string;
+}
+/**
+ * Top-level exodus plan — computed by `buildExodusPlan()` before any writes.
+ *
+ * Carries all pre-flight information including disk-space check results so
+ * that `--dry-run` can print a rich preview.
+ */
+export interface ExodusPlan {
+    /** The legacy source descriptors that will participate in the migration. */
+    readonly sources: LegacyDbDescriptor[];
+    /** Combined size of all source DB files in bytes. */
+    readonly totalSourceBytes: number;
+    /** Available disk bytes on the target filesystem. */
+    readonly availableBytes: number;
+    /** Whether the 3× free-disk pre-flight passes. */
+    readonly diskPreflight: boolean;
+    /** Absolute path to the staging directory. */
+    readonly stagingDir: string;
+    /** Whether a staging directory from a previous run was found (resume mode). */
+    readonly resumeFromStaging: boolean;
+    /** Absolute path to the target project cleo.db. */
+    readonly projectDbPath: string;
+    /** Absolute path to the target global cleo.db. */
+    readonly globalDbPath: string;
+}
+/**
+ * Result returned by `runExodusMigrate()`.
+ */
+export interface ExodusMigrateResult {
+    readonly ok: boolean;
+    readonly tables: TableCopyResult[];
+    readonly stagingDir: string;
+    readonly backupPaths: string[];
+    /** Error message if `ok === false`. */
+    readonly error?: string;
+}
+/**
+ * Per-table verification entry produced by `runExodusVerify()`.
+ */
+export interface VerifyTableResult {
+    readonly tableName: string;
+    readonly scope: ExodusScope;
+    /** Row count in the source legacy DB. */
+    readonly sourceCount: number;
+    /** Row count in the consolidated cleo.db. */
+    readonly targetCount: number;
+    /** xxhash3-based ordered canonical-JSON digest (hex). */
+    readonly sourceHash: string;
+    readonly targetHash: string;
+    readonly hashMatch: boolean;
+    readonly countMatch: boolean;
+}
+/**
+ * Result returned by `runExodusVerify()`.
+ */
+export interface ExodusVerifyResult {
+    readonly ok: boolean;
+    readonly tables: VerifyTableResult[];
+    readonly error?: string;
+}
+/**
+ * Status returned by `runExodusStatus()`.
+ */
+export interface ExodusStatusResult {
+    /** Whether a staging journal exists from a previous (possibly incomplete) run. */
+    readonly hasStaging: boolean;
+    readonly stagingDir: string | null;
+    readonly journal: ExodusJournal | null;
+    /** Whether the consolidated project-scope cleo.db already exists. */
+    readonly projectDbExists: boolean;
+    /** Whether the consolidated global-scope cleo.db already exists. */
+    readonly globalDbExists: boolean;
+    /** Whether all source legacy DBs exist. */
+    readonly sourcesPresent: boolean;
+    readonly sources: Array<{
+        name: string;
+        path: string;
+        exists: boolean;
+        bytes: number;
+    }>;
+}
+/**
+ * Canonical schema version tag embedded in the exodus journal.
+ *
+ * This constant represents the Drizzle v1.0.0-rc.3 target schema "epoch"
+ * for the dual-scope consolidation (T11245 · E2 · SG-DB-SUBSTRATE-V2).
+ * The exact value is a stable marker — not a live hash — so that import
+ * refuses cross-version migration unless `--force-cross-version` is passed.
+ */
+export declare const EXODUS_TARGET_SCHEMA_VERSION: "drizzle-v1.0.0-rc.3/dual-scope/2026-05";
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/store/exodus/types.js

@@ -0,0 +1,21 @@
+/**
+ * Shared types for the `cleo exodus` migration subsystem.
+ *
+ * The exodus subsystem migrates data from the legacy multi-DB fleet
+ * (tasks.db · brain.db · conduit.db · nexus.db · signaldock.db · skills.db)
+ * into the consolidated dual-scope `cleo.db` (project + global).
+ *
+ * @task T11248 (E5 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ * @adr ADR-068, ADR-069
+ */
+/**
+ * Canonical schema version tag embedded in the exodus journal.
+ *
+ * This constant represents the Drizzle v1.0.0-rc.3 target schema "epoch"
+ * for the dual-scope consolidation (T11245 · E2 · SG-DB-SUBSTRATE-V2).
+ * The exact value is a stable marker — not a live hash — so that import
+ * refuses cross-version migration unless `--force-cross-version` is passed.
+ */
+export const EXODUS_TARGET_SCHEMA_VERSION = 'drizzle-v1.0.0-rc.3/dual-scope/2026-05';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/store/exodus/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4JH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,wCAAiD,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Exodus verification engine.
+ *
+ * `runExodusVerify()` checks equivalence between source legacy DBs and the
+ * consolidated dual-scope `cleo.db` after a migration.
+ *
+ * ## Equivalence checks (AC7)
+ *
+ * Per-table:
+ *   1. `COUNT(*)` parity — source and target row counts must match.
+ *   2. Ordered canonical-JSON digest — SELECT all rows ORDER BY rowid, JSON-
+ *      stringify each row, SHA-256 the concatenation (truncated to 32 hex).
+ *
+ * @task T11248 (E5 · AC7 · SG-DB-SUBSTRATE-V2)
+ * @saga T11242
+ */
+import type { ExodusVerifyResult, LegacyDbDescriptor } from './types.js';
+/**
+ * Run equivalence verification after an exodus migration.
+ *
+ * Opens source DBs read-only and the consolidated target DBs read-only, then
+ * compares row counts and canonical-JSON digests per table.
+ *
+ * @param sources        - Legacy source descriptors (from `buildExodusPlan()`).
+ * @param projectDbPath  - Absolute path to the consolidated project `cleo.db`.
+ * @param globalDbPath   - Absolute path to the consolidated global `cleo.db`.
+ * @param onProgress     - Optional progress callback.
+ *
+ * @returns {@link ExodusVerifyResult}
+ *
+ * @task T11248 (AC7)
+ */
+export declare function runExodusVerify(sources: LegacyDbDescriptor[], projectDbPath: string, globalDbPath: string, onProgress?: (msg: string) => void): ExodusVerifyResult;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/store/exodus/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAkDpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACjC,kBAAkB,CA4GpB"}