@cleocode/core 2026.10.3 → 2026.10.5-rc.ci.672

package/dist/store/exodus/task-id-collision-sql.js

@@ -0,0 +1,97 @@
+/**
+ * The one definition of a task-id collision between a legacy `tasks.db` and
+ * the live `cleo.db` (T13172), shared by the reconcile (which renumbers them)
+ * and the read-only `cleo doctor superseded-store` survey (which must never
+ * call a file safe to archive while one of its tasks is only shadowed).
+ *
+ * Kept import-free so the survey can use it without loading the store stack.
+ *
+ * @module
+ * @task T13172
+ */
+/**
+ * Legacy tasks whose id a live task with a different creation instant holds.
+ * Run on the live store with the legacy file attached as `legacy`.
+ *
+ * Columns:
+ * - `legacyId`, `legacyTitle`, `legacyCreatedAt`, `liveTitle`;
+ * - `decision`: `collision` when both creation times parse and differ (a
+ *   different task), `undecided` when either does not parse (`julianday` is
+ *   NULL) and the raw values differ: the rows cannot be told apart, so the
+ *   reconcile reports them and never renumbers or duplicates;
+ * - `recoveredAs`: for a `collision`, the live task an earlier run recovered
+ *   it as, else `NULL`. A candidate has the same title and creation instant
+ *   and an id that is NOT a legacy id (so it is not the legacy row's own copy
+ *   or another legacy task). Twins (same title and instant, however the
+ *   instant is spelled) are paired with candidates in id order, one to one,
+ *   so no candidate is claimed twice.
+ *
+ * A recovery an earlier run recorded (its receipt's remap, loaded into
+ * `temp.cleo_prior_recoveries` by `loadPriorRecoveries`, T13183) wins over the
+ * title match when the recorded task still exists with the legacy creation
+ * instant and type, so a recovered task retitled since is still recognised (a
+ * hand-edited receipt cannot aim a legacy id at an unrelated same-instant
+ * task of another type), and its id leaves the candidate pool.
+ *
+ * A different title alone is the same task edited since the cutover.
+ */
+export const TASK_ID_COLLISIONS_SQL = taskIdCollisionsSql('legacy.tasks');
+/**
+ * {@link TASK_ID_COLLISIONS_SQL} against any legacy task table: the live
+ * store's own bare `tasks` (`main.tasks`, a partial strand, T13225) as well as
+ * an attached legacy file's.
+ *
+ * @param legacyTasks - Schema-qualified legacy task table, e.g. `legacy.tasks`.
+ */
+export function taskIdCollisionsSql(legacyTasks) {
+    return `WITH
+  collided AS (
+    SELECT s.id AS legacyId, s.title AS legacyTitle, s.created_at AS legacyCreatedAt,
+           s.type AS legacyType, t.title AS liveTitle,
+           (SELECT m.id FROM temp.cleo_prior_recoveries p
+              JOIN main.tasks_tasks m ON m.id = p.new_id
+             WHERE p.legacy_id = s.id AND m.id <> s.id
+               AND julianday(m.created_at) = julianday(s.created_at)
+               AND m.type IS s.type
+             ORDER BY p.seq DESC LIMIT 1) AS aliasId,
+           CASE WHEN julianday(s.created_at) IS NULL OR julianday(t.created_at) IS NULL
+                THEN 'undecided' ELSE 'collision' END AS decision
+      FROM ${legacyTasks} s
+      JOIN main.tasks_tasks t ON t.id = s.id
+     WHERE CASE WHEN julianday(s.created_at) IS NULL OR julianday(t.created_at) IS NULL
+                THEN t.created_at IS NOT s.created_at
+                ELSE julianday(t.created_at) <> julianday(s.created_at) END
+  ),
+  numbered AS (
+    SELECT legacyId, legacyTitle, julianday(legacyCreatedAt) AS instant,
+           ROW_NUMBER() OVER (
+             PARTITION BY legacyTitle, julianday(legacyCreatedAt) ORDER BY legacyId
+           ) AS rn
+      FROM collided WHERE decision = 'collision' AND aliasId IS NULL
+  ),
+  grp AS (SELECT DISTINCT legacyTitle, instant FROM numbered),
+  candidates AS (
+    SELECT g.legacyTitle, g.instant, m.id AS candidateId,
+           ROW_NUMBER() OVER (PARTITION BY g.legacyTitle, g.instant ORDER BY m.id) AS rn
+      FROM grp g
+      JOIN main.tasks_tasks m
+        ON m.title IS g.legacyTitle AND julianday(m.created_at) = g.instant
+     WHERE m.id NOT IN (SELECT id FROM ${legacyTasks})
+       AND m.id NOT IN (SELECT aliasId FROM collided WHERE aliasId IS NOT NULL)
+  )
+SELECT c.legacyId, c.legacyTitle, c.legacyCreatedAt, c.legacyType, c.liveTitle, c.decision,
+       COALESCE(c.aliasId, k.candidateId) AS recoveredAs
+  FROM collided c
+  LEFT JOIN numbered n ON n.legacyId = c.legacyId
+  LEFT JOIN candidates k
+    ON k.legacyTitle IS n.legacyTitle AND k.instant = n.instant AND k.rn = n.rn
+ ORDER BY c.legacyId`;
+}
+/**
+ * The TEMP table {@link TASK_ID_COLLISIONS_SQL} reads earlier recoveries from.
+ * Create it on the connection before running the query (empty is fine).
+ */
+export const PRIOR_RECOVERIES_TABLE_SQL = `CREATE TEMP TABLE IF NOT EXISTS cleo_prior_recoveries (
+  seq INTEGER NOT NULL, legacy_id TEXT NOT NULL, new_id TEXT NOT NULL
+)`;
+//# sourceMappingURL=task-id-collision-sql.js.map

package/dist/store/exodus/task-id-collision-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-collision-sql.js","sourceRoot":"","sources":["../../../src/store/exodus/task-id-collision-sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,OAAO;;;;;;;;;;;;aAYI,WAAW;;;;;;;;;;;;;;;;;;;;yCAoBiB,WAAW;;;;;;;;;qBAS/B,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;EAExC,CAAC"}

package/dist/store/exodus/task-id-remap.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Recover legacy tasks whose id a DIFFERENT live task now holds (T13172).
+ *
+ * ## Why this exists
+ *
+ * A deferred exodus-on-open (#1826) left an empty consolidated `cleo.db` while
+ * the legacy `tasks.db` still held the project. The user kept working: the
+ * empty store allocated `T001` again (strict-spine makes it a saga) while the
+ * legacy store also holds a `T001`. The reconcile copies with
+ * `INSERT OR IGNORE` and assesses by key, so the legacy `T001` was skipped,
+ * counted as present, and its children (`parent_id = 'T001'`) attached to the
+ * new saga — while the receipt said every legacy row was present.
+ *
+ * The fix renumbers before copying, never after: the legacy file is copied into
+ * scratch, every colliding legacy task gets a fresh id there, and everything
+ * that refers to it in that copy follows, exactly as a display-id rename does
+ * in `cleo.db`:
+ *
+ * - every column that holds a task id ({@link taskReferenceColumns}: declared
+ *   foreign keys plus the ROW_IDENTITY refs, key refs, owners and JSON-array
+ *   refs such as a session's `tasks_completed_json`), mapped to the legacy
+ *   table names;
+ * - the acceptance criteria whose ids are derived from the task id
+ *   (`buildAcRowId`) are re-derived, with their evidence bindings and history
+ *   ({@link rederiveAcIdsNative}). Without that the recovered task's
+ *   "tests pass" criterion has the same id as the live `T001`'s and is
+ *   skipped by `INSERT OR IGNORE`.
+ *
+ * The reconcile then assesses and copies from the copy, so the copy engine,
+ * its verification and its revert work unchanged, and live rows are never
+ * touched. What a collision is, and when a legacy task was already recovered
+ * by an earlier run, is decided by {@link TASK_ID_COLLISIONS_SQL}. A collision
+ * whose creation times cannot be compared is reported, never renumbered.
+ *
+ * Not rewritten: task ids inside free text (titles, descriptions, notes).
+ *
+ * @module
+ * @task T13172
+ */
+import type { SupersededStoreConflict, SupersededStoreIdRemap } from '@cleocode/contracts';
+import type { LegacyDbDescriptor } from './types.js';
+/** The note every receipt with remaps carries about what is not rewritten. */
+export declare const FREE_TEXT_IDS_NOTE = "task ids written inside free text (titles, descriptions, notes) are not rewritten";
+/** A remap with the legacy facts the post-copy check and later runs compare. */
+export interface PlannedRemap extends SupersededStoreIdRemap {
+    /** The legacy row's creation time, compared with the copied row after the copy. */
+    legacyCreatedAt: string;
+}
+/** Result of {@link remapCollidingTaskIds}. */
+export interface TaskIdRemapResult {
+    /** The sources to assess and copy: the legacy tasks source replaced by its renumbered copy. */
+    readonly sources: LegacyDbDescriptor[];
+    /** One entry per renumbered legacy task; empty when nothing collides. */
+    readonly remaps: PlannedRemap[];
+    /** Collisions the run cannot decide (unparseable creation time), as one conflict, or `null`. */
+    readonly undecided: SupersededStoreConflict | null;
+    /** Path of the renumbered copy, or `null` when no copy was needed. */
+    readonly remappedPath: string | null;
+}
+/**
+ * Renumber legacy tasks whose id a different live task holds, in a scratch
+ * copy of the legacy `tasks.db`, and return the sources to reconcile from.
+ *
+ * @param liveStorePath - The live project `cleo.db` (read only).
+ * @param sources - The project's legacy sources.
+ * @param scratch - Directory the renumbered copy is written to.
+ * @param cleoDir - The project's resolved `.cleo`, where earlier receipts live.
+ * @returns The sources (unchanged when nothing needs renumbering), the
+ *   remaps, and any collision the run cannot decide.
+ * @example
+ * ```ts
+ * const { sources, remaps } = remapCollidingTaskIds(livePath, fileSources, scratch, cleoDir);
+ * for (const r of remaps) console.log(`${r.legacyId} -> ${r.newId}`);
+ * ```
+ */
+export declare function remapCollidingTaskIds(liveStorePath: string, sources: readonly LegacyDbDescriptor[], scratch: string, cleoDir: string): TaskIdRemapResult;
+/**
+ * Remaps whose new id the live store does not hold as the recovered legacy
+ * task after the copy: a concurrent write took the id first, so the copy's
+ * `INSERT OR IGNORE` skipped the recovered task. Empty when every remap landed.
+ *
+ * @param liveStorePath - The live project `cleo.db`.
+ * @param remaps - The run's remaps.
+ * @returns `legacyId -> newId` for each remap that did not land.
+ * @example
+ * ```ts
+ * if (unlandedRemaps(live, remaps).length > 0) revert();
+ * ```
+ */
+export declare function unlandedRemaps(liveStorePath: string, remaps: readonly PlannedRemap[]): string[];
+/**
+ * One line naming every remap, for a receipt's reason.
+ *
+ * @param remaps - The remaps of a run.
+ * @returns E.g. `1 legacy task(s) … recovered under new ids: legacy T001 ("old") -> T004, …`.
+ * @example
+ * ```ts
+ * describeRemaps(remaps);
+ * ```
+ */
+export declare function describeRemaps(remaps: readonly SupersededStoreIdRemap[]): string;
+/**
+ * One line naming the collisions a run could not decide, for a receipt's reason.
+ *
+ * @param conflict - The undecided conflict.
+ * @returns E.g. `2 legacy task(s) left uncopied (T001, T007): …`.
+ * @example
+ * ```ts
+ * describeUndecided(result.undecided);
+ * ```
+ */
+export declare function describeUndecided(conflict: SupersededStoreConflict): string;
+//# sourceMappingURL=task-id-remap.d.ts.map

package/dist/store/exodus/task-id-remap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-remap.d.ts","sourceRoot":"","sources":["../../../src/store/exodus/task-id-remap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAO3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMrD,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,sFACsD,CAAC;AAqGtF,gFAAgF;AAChF,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAChC,gGAAgG;IAChG,QAAQ,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACnD,sEAAsE;IACtE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,iBAAiB,CAgGnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAc/F;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAOhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAM3E"}

package/dist/store/exodus/task-id-remap.js

@@ -0,0 +1,301 @@
+/**
+ * Recover legacy tasks whose id a DIFFERENT live task now holds (T13172).
+ *
+ * ## Why this exists
+ *
+ * A deferred exodus-on-open (#1826) left an empty consolidated `cleo.db` while
+ * the legacy `tasks.db` still held the project. The user kept working: the
+ * empty store allocated `T001` again (strict-spine makes it a saga) while the
+ * legacy store also holds a `T001`. The reconcile copies with
+ * `INSERT OR IGNORE` and assesses by key, so the legacy `T001` was skipped,
+ * counted as present, and its children (`parent_id = 'T001'`) attached to the
+ * new saga — while the receipt said every legacy row was present.
+ *
+ * The fix renumbers before copying, never after: the legacy file is copied into
+ * scratch, every colliding legacy task gets a fresh id there, and everything
+ * that refers to it in that copy follows, exactly as a display-id rename does
+ * in `cleo.db`:
+ *
+ * - every column that holds a task id ({@link taskReferenceColumns}: declared
+ *   foreign keys plus the ROW_IDENTITY refs, key refs, owners and JSON-array
+ *   refs such as a session's `tasks_completed_json`), mapped to the legacy
+ *   table names;
+ * - the acceptance criteria whose ids are derived from the task id
+ *   (`buildAcRowId`) are re-derived, with their evidence bindings and history
+ *   ({@link rederiveAcIdsNative}). Without that the recovered task's
+ *   "tests pass" criterion has the same id as the live `T001`'s and is
+ *   skipped by `INSERT OR IGNORE`.
+ *
+ * The reconcile then assesses and copies from the copy, so the copy engine,
+ * its verification and its revert work unchanged, and live rows are never
+ * touched. What a collision is, and when a legacy task was already recovered
+ * by an earlier run, is decided by {@link TASK_ID_COLLISIONS_SQL}. A collision
+ * whose creation times cannot be compared is reported, never renumbered.
+ *
+ * Not rewritten: task ids inside free text (titles, descriptions, notes).
+ *
+ * @module
+ * @task T13172
+ */
+import { openCleoDbSnapshot } from '../open-cleo-db.js';
+import { rederiveAcIdsNative, rewriteTaskIdReferencesNative } from '../sqlite-data-accessor.js';
+import { taskReferenceColumns } from '../task-reference-columns.js';
+import { loadPriorRecoveries, priorRecoveries } from './prior-recoveries.js';
+import { resolveConsolidatedTableName } from './table-name-map.js';
+import { TASK_ID_COLLISIONS_SQL } from './task-id-collision-sql.js';
+/** The legacy table holding task rows, and its consolidated home. */
+const LEGACY_TASKS_TABLE = 'tasks';
+const LIVE_TASKS_TABLE = 'tasks_tasks';
+/** The note every receipt with remaps carries about what is not rewritten. */
+export const FREE_TEXT_IDS_NOTE = 'task ids written inside free text (titles, descriptions, notes) are not rewritten';
+/** Quote an SQLite string literal. */
+function literal(value) {
+    return `'${value.replace(/'/g, "''")}'`;
+}
+/** Whether `schema.table` exists on `db`. */
+function hasTable(db, schema, table) {
+    return (db
+        .prepare(`SELECT 1 AS ok FROM "${schema}".sqlite_master WHERE type='table' AND name=?`)
+        .get(table) !== undefined);
+}
+/** Text value of a row column, or `''`. */
+function text(row, key) {
+    const value = row?.[key];
+    return typeof value === 'string' ? value : '';
+}
+/** Collisions between the legacy tasks at `legacyPath` and the live store. */
+function findCollisions(liveStorePath, legacyPath, cleoDir) {
+    const live = openCleoDbSnapshot(liveStorePath, { readOnly: true });
+    try {
+        live.db.exec(`ATTACH DATABASE ${literal(legacyPath)} AS legacy`);
+        try {
+            if (!hasTable(live.db, 'legacy', LEGACY_TASKS_TABLE) ||
+                !hasTable(live.db, 'main', LIVE_TASKS_TABLE)) {
+                return [];
+            }
+            // Recoveries earlier runs recorded in their receipts (T13183), read from
+            // the resolved .cleo the reconcile writes them to.
+            loadPriorRecoveries(live.db, priorRecoveries(cleoDir));
+            const rows = live.db.prepare(TASK_ID_COLLISIONS_SQL).all();
+            return rows.map((row) => ({
+                legacyId: text(row, 'legacyId'),
+                legacyTitle: text(row, 'legacyTitle'),
+                legacyCreatedAt: text(row, 'legacyCreatedAt'),
+                legacyType: text(row, 'legacyType') || null,
+                liveTitle: text(row, 'liveTitle'),
+                decision: text(row, 'decision') === 'undecided' ? 'undecided' : 'collision',
+                recoveredAs: text(row, 'recoveredAs') || null,
+            }));
+        }
+        finally {
+            live.db.exec('DETACH DATABASE legacy');
+        }
+    }
+    finally {
+        live.close();
+    }
+}
+/** Highest numeric `T<n>` id among `ids`, or 0. */
+function maxNumericId(ids) {
+    let max = 0;
+    for (const id of ids) {
+        const match = /^T(\d+)$/.exec(id);
+        if (match?.[1] !== undefined)
+            max = Math.max(max, Number(match[1]));
+    }
+    return max;
+}
+/** Every task id in `schema.table` of `db`. */
+function idsOf(db, schema, table) {
+    if (!hasTable(db, schema, table))
+        return [];
+    return db.prepare(`SELECT id FROM "${schema}"."${table}"`).all().map((row) => text(row, 'id'));
+}
+/**
+ * Consolidated table name → its name in a legacy `tasks.db` copy, from the
+ * tables the copy holds and the exodus table-name map.
+ */
+function legacyNameMap(db) {
+    const byConsolidated = new Map();
+    const tables = db
+        .prepare("SELECT name FROM main.sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
+        .all();
+    for (const row of tables) {
+        const legacy = text(row, 'name');
+        const resolution = resolveConsolidatedTableName('tasks', legacy);
+        if (resolution.kind !== 'skip')
+            byConsolidated.set(resolution.targetName, legacy);
+    }
+    return (consolidated) => byConsolidated.get(consolidated) ?? null;
+}
+/**
+ * Renumber legacy tasks whose id a different live task holds, in a scratch
+ * copy of the legacy `tasks.db`, and return the sources to reconcile from.
+ *
+ * @param liveStorePath - The live project `cleo.db` (read only).
+ * @param sources - The project's legacy sources.
+ * @param scratch - Directory the renumbered copy is written to.
+ * @param cleoDir - The project's resolved `.cleo`, where earlier receipts live.
+ * @returns The sources (unchanged when nothing needs renumbering), the
+ *   remaps, and any collision the run cannot decide.
+ * @example
+ * ```ts
+ * const { sources, remaps } = remapCollidingTaskIds(livePath, fileSources, scratch, cleoDir);
+ * for (const r of remaps) console.log(`${r.legacyId} -> ${r.newId}`);
+ * ```
+ */
+export function remapCollidingTaskIds(liveStorePath, sources, scratch, cleoDir) {
+    const unchanged = { sources: [...sources], remaps: [], undecided: null, remappedPath: null };
+    const tasksSource = sources.find((s) => s.name === 'tasks');
+    if (tasksSource === undefined)
+        return unchanged;
+    const collisions = findCollisions(liveStorePath, tasksSource.path, cleoDir);
+    const undecidedIds = collisions.filter((c) => c.decision === 'undecided').map((c) => c.legacyId);
+    const undecided = undecidedIds.length === 0
+        ? null
+        : {
+            sourceDb: tasksSource.name,
+            sourceTable: LEGACY_TASKS_TABLE,
+            targetTable: LIVE_TASKS_TABLE,
+            rows: undecidedIds.length,
+            reason: 'id-collision-undecided',
+            ids: undecidedIds,
+        };
+    const decided = collisions.filter((c) => c.decision === 'collision');
+    if (decided.length === 0)
+        return { ...unchanged, undecided };
+    const remappedPath = `${scratch}/tasks.remapped.db`;
+    const legacy = openCleoDbSnapshot(tasksSource.path, { readOnly: true });
+    let legacyIds;
+    try {
+        // VACUUM INTO folds any WAL content into the copy; the legacy file is untouched.
+        legacy.db.exec(`VACUUM INTO ${literal(remappedPath)}`);
+        legacyIds = idsOf(legacy.db, 'main', LEGACY_TASKS_TABLE);
+    }
+    finally {
+        legacy.close();
+    }
+    const liveIds = (() => {
+        const live = openCleoDbSnapshot(liveStorePath, { readOnly: true });
+        try {
+            return idsOf(live.db, 'main', LIVE_TASKS_TABLE);
+        }
+        finally {
+            live.close();
+        }
+    })();
+    // Fresh ids are above every id either store holds, so a new id is never
+    // another task's legacy id and the renumbering needs no ordering.
+    let next = maxNumericId([...liveIds, ...legacyIds]);
+    const remaps = decided.map((c) => ({
+        sourceDb: tasksSource.name,
+        legacyId: c.legacyId,
+        newId: c.recoveredAs ?? `T${String(++next).padStart(3, '0')}`,
+        legacyTitle: c.legacyTitle,
+        liveTitle: c.liveTitle,
+        alreadyRecovered: c.recoveredAs !== null,
+        referencesRepointed: 0,
+        legacyCreatedAt: c.legacyCreatedAt,
+        legacyType: c.legacyType,
+    }));
+    const copy = openCleoDbSnapshot(remappedPath, { readOnly: false, applyPragmas: false });
+    try {
+        copy.db.exec('PRAGMA foreign_keys = OFF');
+        const localName = legacyNameMap(copy.db);
+        const refs = taskReferenceColumns(copy.db, localName);
+        const acTables = {
+            criteria: localName('tasks_task_acceptance_criteria') ?? 'task_acceptance_criteria',
+            followers: ['tasks_evidence_ac_bindings', 'tasks_task_acceptance_criteria_history']
+                .map(localName)
+                .filter((name) => name !== null),
+        };
+        copy.db.exec('BEGIN IMMEDIATE');
+        try {
+            for (const remap of remaps) {
+                copy.db
+                    .prepare(`UPDATE "${LEGACY_TASKS_TABLE}" SET id = ? WHERE id = ?`)
+                    .run(remap.newId, remap.legacyId);
+                const rewritten = {
+                    ...rewriteTaskIdReferencesNative(copy.db, refs, remap.legacyId, remap.newId),
+                };
+                for (const [key, n] of Object.entries(rederiveAcIdsNative(copy.db, remap.legacyId, remap.newId, acTables))) {
+                    rewritten[key] = (rewritten[key] ?? 0) + n;
+                }
+                remap.referencesRepointed = Object.values(rewritten).reduce((a, b) => a + b, 0);
+            }
+            copy.db.exec('COMMIT');
+        }
+        catch (error) {
+            copy.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+    finally {
+        copy.close();
+    }
+    return {
+        sources: sources.map((s) => (s === tasksSource ? { ...s, path: remappedPath } : s)),
+        remaps,
+        undecided,
+        remappedPath,
+    };
+}
+/**
+ * Remaps whose new id the live store does not hold as the recovered legacy
+ * task after the copy: a concurrent write took the id first, so the copy's
+ * `INSERT OR IGNORE` skipped the recovered task. Empty when every remap landed.
+ *
+ * @param liveStorePath - The live project `cleo.db`.
+ * @param remaps - The run's remaps.
+ * @returns `legacyId -> newId` for each remap that did not land.
+ * @example
+ * ```ts
+ * if (unlandedRemaps(live, remaps).length > 0) revert();
+ * ```
+ */
+export function unlandedRemaps(liveStorePath, remaps) {
+    if (remaps.length === 0)
+        return [];
+    const live = openCleoDbSnapshot(liveStorePath, { readOnly: true });
+    try {
+        const row = live.db.prepare(`SELECT 1 AS ok FROM ${LIVE_TASKS_TABLE}
+        WHERE id = ? AND title IS ? AND julianday(created_at) IS julianday(?)`);
+        return remaps
+            .filter((r) => row.get(r.newId, r.legacyTitle, r.legacyCreatedAt) === undefined)
+            .map((r) => `${r.legacyId} -> ${r.newId}`);
+    }
+    finally {
+        live.close();
+    }
+}
+/**
+ * One line naming every remap, for a receipt's reason.
+ *
+ * @param remaps - The remaps of a run.
+ * @returns E.g. `1 legacy task(s) … recovered under new ids: legacy T001 ("old") -> T004, …`.
+ * @example
+ * ```ts
+ * describeRemaps(remaps);
+ * ```
+ */
+export function describeRemaps(remaps) {
+    const items = remaps.map((r) => `legacy ${r.legacyId} ("${r.legacyTitle}") -> ${r.newId}` +
+        `${r.alreadyRecovered ? ' (already recovered)' : ''}, because live ${r.legacyId} is "${r.liveTitle}"`);
+    return `${remaps.length} legacy task(s) whose id a different live task holds, recovered under new ids: ${items.join('; ')} (${FREE_TEXT_IDS_NOTE})`;
+}
+/**
+ * One line naming the collisions a run could not decide, for a receipt's reason.
+ *
+ * @param conflict - The undecided conflict.
+ * @returns E.g. `2 legacy task(s) left uncopied (T001, T007): …`.
+ * @example
+ * ```ts
+ * describeUndecided(result.undecided);
+ * ```
+ */
+export function describeUndecided(conflict) {
+    return (`${conflict.rows} legacy task(s) left uncopied (${(conflict.ids ?? []).join(', ')}): ` +
+        'a live task holds the id and a creation time does not parse, so the run cannot tell ' +
+        'whether they are the same task; keep .cleo/tasks.db');
+}
+//# sourceMappingURL=task-id-remap.js.map

package/dist/store/exodus/task-id-remap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id-remap.js","sourceRoot":"","sources":["../../../src/store/exodus/task-id-remap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,OAAgB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,aAAsB,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAC7B,mFAAmF,CAAC;AAEtF,sCAAsC;AACtC,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED,6CAA6C;AAC7C,SAAS,QAAQ,CAAC,EAAgB,EAAE,MAAc,EAAE,KAAa;IAC/D,OAAO,CACL,EAAE;SACC,OAAO,CAAC,wBAAwB,MAAM,+CAA+C,CAAC;SACtF,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,CAC5B,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAS,IAAI,CAAC,GAAwC,EAAE,GAAW;IACjE,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAaD,8EAA8E;AAC9E,SAAS,cAAc,CAAC,aAAqB,EAAE,UAAkB,EAAE,OAAe;IAChF,MAAM,IAAI,GAAG,kBAAkB,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,IACE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC;gBAChD,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAC5C,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,yEAAyE;YACzE,mDAAmD;YACnD,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,GAAG,EAAoC,CAAC;YAC7F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC;gBAC/B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;gBACrC,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC;gBAC7C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,IAAI;gBAC3C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC;gBACjC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;gBAC3E,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,IAAI;aAC9C,CAAC,CAAC,CAAC;QACN,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,SAAS,YAAY,CAAC,GAAsB;IAC1C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+CAA+C;AAC/C,SAAS,KAAK,CAAC,EAAgB,EAAE,MAAc,EAAE,KAAa;IAC5D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,OACE,EAAE,CAAC,OAAO,CAAC,mBAAmB,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,EACxD,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,EAAgB;IACrC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CAAC,qFAAqF,CAAC;SAC9F,GAAG,EAAoC,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM;YAAE,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,OAAsC,EACtC,OAAe,EACf,OAAe;IAEf,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC7F,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC5D,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,UAAU,GAAG,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjG,MAAM,SAAS,GACb,YAAY,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACE,QAAQ,EAAE,WAAW,CAAC,IAAI;YAC1B,WAAW,EAAE,kBAAkB;YAC/B,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,YAAY,CAAC,MAAM;YACzB,MAAM,EAAE,wBAAwB;YAChC,GAAG,EAAE,YAAY;SAClB,CAAC;IACR,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,CAAC;IAE7D,MAAM,YAAY,GAAG,GAAG,OAAO,oBAAoB,CAAC;IACpD,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,IAAI,SAAmB,CAAC;IACxB,IAAI,CAAC;QACH,iFAAiF;QACjF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACvD,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3D,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,wEAAwE;IACxE,kEAAkE;IAClE,IAAI,IAAI,GAAG,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IACpD,MAAM,MAAM,GAAmB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,QAAQ,EAAE,WAAW,CAAC,IAAI;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QAC7D,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,gBAAgB,EAAE,CAAC,CAAC,WAAW,KAAK,IAAI;QACxC,mBAAmB,EAAE,CAAC;QACtB,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAI,GAAG,kBAAkB,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG;YACf,QAAQ,EAAE,SAAS,CAAC,gCAAgC,CAAC,IAAI,0BAA0B;YACnF,SAAS,EAAE,CAAC,4BAA4B,EAAE,wCAAwC,CAAC;iBAChF,GAAG,CAAC,SAAS,CAAC;iBACd,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;SACnD,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,EAAE;qBACJ,OAAO,CAAC,WAAW,kBAAkB,2BAA2B,CAAC;qBACjE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,MAAM,SAAS,GAAG;oBAChB,GAAG,6BAA6B,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC;iBAC7E,CAAC;gBACF,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CACnC,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CACpE,EAAE,CAAC;oBACF,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC7C,CAAC;gBACD,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM;QACN,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB,EAAE,MAA+B;IACnF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,uBAAuB,gBAAgB;8EACiC,CACzE,CAAC;QACF,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,SAAS,CAAC;aAC/E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyC;IACtE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CACtB,CAAC,CAAC,EAAE,EAAE,CACJ,UAAU,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,WAAW,SAAS,CAAC,CAAC,KAAK,EAAE;QACzD,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,SAAS,GAAG,CACxG,CAAC;IACF,OAAO,GAAG,MAAM,CAAC,MAAM,kFAAkF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,kBAAkB,GAAG,CAAC;AACtJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiC;IACjE,OAAO,CACL,GAAG,QAAQ,CAAC,IAAI,kCAAkC,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QACtF,sFAAsF;QACtF,qDAAqD,CACtD,CAAC;AACJ,CAAC"}

package/dist/store/exodus/verify-migration.js

@@ -42,7 +42,7 @@
  */
 import { existsSync } from 'node:fs';
 import { createRequire } from 'node:module';
-import { MIGRATION_ENUM_DRIFT_SAMPLE_LIMIT } from '@cleocode/contracts';
+import { MIGRATION_ENUM_DRIFT_SAMPLE_LIMIT } from '@cleocode/contracts/migration-parity.js';
 import { getLogger } from '../../logger.js';
 import { openCleoDbSnapshot } from '../open-cleo-db.js';
 import { buildDigestExpr, detectIsoGlobColumns, legacyRowProjection, } from './column-transforms.js';