@cleocode/core 2026.10.27 → 2026.11.1-canary.10

package/dist/store/sync/replay-pin.d.ts

@@ -67,4 +67,3 @@ export declare function triggerSetHash(db: DatabaseSync): string;
  * @returns The pin.
  */
 export declare function replayPinOf(db: DatabaseSync, transitions?: ReplayPin['transitions']): ReplayPin;
-//# sourceMappingURL=replay-pin.d.ts.map

package/dist/store/sync/replica-registry.d.ts

@@ -140,4 +140,3 @@ export declare class ReplicaRegistry {
  * @returns The registry, or `null`.
  */
 export declare function readDeviceRegistry(): ReplicaRegistry | null;
-//# sourceMappingURL=replica-registry.d.ts.map

package/dist/store/sync/replica.d.ts

@@ -396,4 +396,3 @@ export interface VaultRestoreRebind {
 export declare function rebindAfterVaultRestore(dbPath: string, scope: ReplicaScope, before: FileIdentity | null, opts?: Pick<SyncOpenOptions, 'deviceId' | 'registry' | 'stat' | 'now'>): Promise<VaultRestoreRebind | null>;
 /** The current clock of the store's active replica, for diagnostics. Read-only. */
 export declare function currentClock(db: DatabaseSync, scope: ReplicaScope): string | undefined;
-//# sourceMappingURL=replica.d.ts.map

package/dist/store/sync/retire.d.ts

@@ -158,4 +158,3 @@ export declare function liveReplicaHorizon(heads: Readonly<Record<string, string
  * @returns The membership with retirements applied.
  */
 export declare function withRetirements(replicas: readonly ProjectReplica[], retired: ReadonlyMap<string, RetiredReplicaRow>): ProjectReplica[];
-//# sourceMappingURL=retire.d.ts.map

package/dist/store/sync/row-meta.d.ts

@@ -147,4 +147,3 @@ export declare function readRowMetaFull(db: DatabaseSync, tbl: string, uid: stri
  * @param meta - The snapshot, or null.
  */
 export declare function restoreRowMeta(db: DatabaseSync, tbl: string, uid: string, meta: RowMetaFull | null): void;
-//# sourceMappingURL=row-meta.d.ts.map

package/dist/store/sync/schema.d.ts

@@ -125,4 +125,3 @@ export declare function ensureSyncSchema(db: DatabaseSync, options?: {
 export declare function healSyncSchema(db: DatabaseSync, expected: readonly string[], options?: {
     root?: string;
 }): boolean;
-//# sourceMappingURL=schema.d.ts.map

package/dist/store/sync/seal-backlog.d.ts

@@ -18,4 +18,3 @@ export declare function sealBacklog(db: DatabaseSync): {
     readonly oldestSeq: number | null;
     readonly oldestAtMs: number | null;
 };
-//# sourceMappingURL=seal-backlog.d.ts.map

package/dist/store/sync/sealer-values.d.ts

@@ -31,4 +31,3 @@ export type WireValue = string | number | null | {
 export declare function decodeEnc(text: string): WireValue;
 /** Canonical JSON: keys sorted at every level. */
 export declare function canonicalJson(value: unknown): string;
-//# sourceMappingURL=sealer-values.d.ts.map

package/dist/store/sync/sealer.d.ts

@@ -319,4 +319,3 @@ export declare function chashBaselineSnapshot(db: DatabaseSync, scope: TableScop
  *   previous re-baseline's `snapshot`.
  */
 export declare function rebaselineChash(db: DatabaseSync, scope: TableScope, snapshot: ChashSnapshot): ChashRebaseline;
-//# sourceMappingURL=sealer.d.ts.map

package/dist/store/sync/segments.d.ts

@@ -129,4 +129,3 @@ export declare function markSegmentPushed(db: DatabaseSync, s: {
     readonly serverSeq: number;
     readonly nowIso: string;
 }): void;
-//# sourceMappingURL=segments.d.ts.map

package/dist/store/sync/sequencing.d.ts

@@ -217,4 +217,3 @@ export declare function undoBudget(db: DatabaseSync, budget?: number): UndoBudge
  * @returns The budget state after recording.
  */
 export declare function recordUndoBudget(db: DatabaseSync, nowIso: string, budget?: number): UndoBudget;
-//# sourceMappingURL=sequencing.d.ts.map

package/dist/store/sync/skew-hold.d.ts

@@ -68,4 +68,3 @@ export declare class SkewHold {
     /** How many transactions are queued, over all replicas. */
     get size(): number;
 }
-//# sourceMappingURL=skew-hold.d.ts.map

package/dist/store/sync/structural.d.ts

@@ -88,4 +88,3 @@ export declare function withSuspectAccounting<T>(db: DatabaseSync, scope: TableS
     result: T;
     suspect: string[];
 };
-//# sourceMappingURL=structural.d.ts.map

package/dist/store/sync/timestamp-canon.d.ts

@@ -44,4 +44,3 @@ export declare const SYNC_TIMESTAMP_COLUMNS: Readonly<Record<TableScope, Readonl
 export declare const CANON_EXCLUDED_COLUMNS: Readonly<Record<TableScope, Readonly<Record<string, readonly string[]>>>>;
 /** The captured timestamp columns of `table` (empty when it has none). */
 export declare function timestampColumns(scope: TableScope, table: string): ReadonlySet<string>;
-//# sourceMappingURL=timestamp-canon.d.ts.map

package/dist/store/sync/timestamps.d.ts

@@ -60,4 +60,3 @@ export declare function ambiguousTimestamps(db: DatabaseSync, scope: TableScope)
  *   so two copies of a store agree.
  */
 export declare function canonicalizeStoreTimestamps(db: DatabaseSync, scope: TableScope): TimestampCanonReport;
-//# sourceMappingURL=timestamps.d.ts.map

package/dist/store/sync/tombstones.d.ts

@@ -72,4 +72,3 @@ export declare function tombstoneCounts(db: DatabaseSync): {
     full: number;
     minimal: number;
 };
-//# sourceMappingURL=tombstones.d.ts.map

package/dist/store/sync/trigger-classes.d.ts

@@ -226,4 +226,3 @@ export type SuspendPurpose = 'rewind' | 'undo' | 'forward';
  *   `E_GUARD_SUSPEND_FORWARD` when a forward purpose suspends `guard`.
  */
 export declare function withTriggersSuspended<T>(db: DatabaseSync, scopes: ReadonlyArray<SuspendableClass | 'all'>, purpose: SuspendPurpose, fn: () => T): T;
-//# sourceMappingURL=trigger-classes.d.ts.map

package/dist/store/sync/trigger-suspend-at-path.d.ts

@@ -20,4 +20,3 @@ import { type TriggerSuspendStepZero } from './trigger-classes.js';
  * @returns What step 0 did, or `null` when the file is not a project store.
  */
 export declare function ensureTriggerSuspendTableAtPath(dbPath: string): TriggerSuspendStepZero | null;
-//# sourceMappingURL=trigger-suspend-at-path.d.ts.map

package/dist/store/sync/txn-signing.d.ts

@@ -66,4 +66,3 @@ export declare function verifyTxnSignature(publicKey: Uint8Array, stream: string
  * @returns The first bad index, or null.
  */
 export declare function firstBadTxnSignature(publicKey: Uint8Array, stream: string, txns: readonly LedgerTxn[]): number | null;
-//# sourceMappingURL=txn-signing.d.ts.map

package/dist/store/sync/uid-alias.d.ts

@@ -30,6 +30,7 @@
  * @task T13397
  */
 import type { DatabaseSync } from 'node:sqlite';
+import type { LedgerOp } from '@cleocode/contracts/ledger';
 import type { CaptureTableDef } from './capture.js';
 import type { StagedTxn } from './inbox.js';
 import { UID_ALIAS_JOURNAL_TABLE, UID_REF_ALIAS_JOURNAL_TABLE } from './schema.js';
@@ -41,6 +42,11 @@ export interface UidAlias {
     /** The row's birth fingerprint before the re-key (the K's `obfp`). */
     readonly oldBfp: string;
     readonly newUid: string;
+    /**
+     * The row's birth fingerprint after the re-key (the K's `bfp`), when the K
+     * moved it (T14335). Omitted or null: the fingerprint did not change.
+     */
+    readonly newBfp?: string | null;
     /** The replica that wrote the K. */
     readonly origin: string;
     /** The K's HLC. */
@@ -66,6 +72,27 @@ export declare function recordUidAlias(db: DatabaseSync, alias: UidAlias, nowIso
  * @param oldBfp - Its birth fingerprint.
  */
 export declare function markAliasPlaced(db: DatabaseSync, table: string, oldUid: string, oldBfp: string): void;
+/**
+ * Whether the alias of (table, uid, fingerprint) is recorded.
+ *
+ * @param db - The store.
+ * @param table - The re-keyed row's table.
+ * @param uid - The old uid.
+ * @param bfp - The old fingerprint.
+ */
+export declare function hasUidAlias(db: DatabaseSync, table: string, uid: string, bfp: string): boolean;
+/**
+ * Drop the aliases `ops`' K ops recorded for `origin` (T14336): the applier
+ * records the alias of a waiting K before its transaction applies, and a
+ * transaction refused afterwards must leave none behind. Only rows carrying
+ * the K's own origin, HLC and target match, so an alias another K recorded
+ * is never touched.
+ *
+ * @param db - The store, inside the apply frame's transaction.
+ * @param origin - The replica that wrote the refused transaction.
+ * @param ops - Its ops.
+ */
+export declare function dropUidAliasesOf(db: DatabaseSync, origin: string, ops: readonly LedgerOp[]): void;
 /** One announcement this replica owes ({@link markAliasPlaced}). */
 export interface OwedAnnouncement {
     readonly table: string;
@@ -97,4 +124,3 @@ export declare function markAliasAnnounced(db: DatabaseSync, a: OwedAnnouncement
  * @returns The transaction its planning and apply see.
  */
 export declare function followUidAliases(db: DatabaseSync, st: StagedTxn, defs: (table: string) => CaptureTableDef | null): StagedTxn;
-//# sourceMappingURL=uid-alias.d.ts.map

package/dist/store/sync/uid-alias.js

@@ -44,9 +44,21 @@ const MAX_ALIAS_HOPS = 32;
 export function recordUidAlias(db, alias, nowIso) {
     if (!hasTable(db, UID_ALIAS_JOURNAL_TABLE))
         return;
-    db.prepare(`INSERT INTO ${UID_ALIAS_JOURNAL_TABLE} (tbl, old_uid, old_bfp, new_uid, origin, hlc, created_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT (tbl, old_uid, old_bfp) DO NOTHING`).run(alias.table, alias.oldUid, alias.oldBfp, alias.newUid, alias.origin, alias.hlc, nowIso);
+    // T14335: the new fingerprint, when the K moved it (a journal from before
+    // the column records the uid only, as it always did).
+    const newBfp = alias.newBfp != null && alias.newBfp !== alias.oldBfp && hasNewBfpColumn(db)
+        ? alias.newBfp
+        : null;
+    if (newBfp !== null) {
+        db.prepare(`INSERT INTO ${UID_ALIAS_JOURNAL_TABLE} (tbl, old_uid, old_bfp, new_uid, new_bfp, origin, hlc, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT (tbl, old_uid, old_bfp) DO NOTHING`).run(alias.table, alias.oldUid, alias.oldBfp, alias.newUid, newBfp, alias.origin, alias.hlc, nowIso);
+    }
+    else {
+        db.prepare(`INSERT INTO ${UID_ALIAS_JOURNAL_TABLE} (tbl, old_uid, old_bfp, new_uid, origin, hlc, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT (tbl, old_uid, old_bfp) DO NOTHING`).run(alias.table, alias.oldUid, alias.oldBfp, alias.newUid, alias.origin, alias.hlc, nowIso);
+    }
     // Every K, the origin's and each announcement, draws its writer's boundary.
     if (hasTable(db, UID_REF_ALIAS_JOURNAL_TABLE)) {
         db.prepare(`INSERT INTO ${UID_REF_ALIAS_JOURNAL_TABLE} (tbl, old_uid, origin, new_uid, hlc)
@@ -69,6 +81,47 @@ export function markAliasPlaced(db, table, oldUid, oldBfp) {
         return;
     db.prepare(`UPDATE ${UID_ALIAS_JOURNAL_TABLE} SET placed = 1 WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`).run(table, oldUid, oldBfp);
 }
+/**
+ * Whether the alias of (table, uid, fingerprint) is recorded.
+ *
+ * @param db - The store.
+ * @param table - The re-keyed row's table.
+ * @param uid - The old uid.
+ * @param bfp - The old fingerprint.
+ */
+export function hasUidAlias(db, table, uid, bfp) {
+    return (hasTable(db, UID_ALIAS_JOURNAL_TABLE) &&
+        db
+            .prepare(`SELECT 1 FROM ${UID_ALIAS_JOURNAL_TABLE} WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`)
+            .get(table, uid, bfp) !== undefined);
+}
+/**
+ * Drop the aliases `ops`' K ops recorded for `origin` (T14336): the applier
+ * records the alias of a waiting K before its transaction applies, and a
+ * transaction refused afterwards must leave none behind. Only rows carrying
+ * the K's own origin, HLC and target match, so an alias another K recorded
+ * is never touched.
+ *
+ * @param db - The store, inside the apply frame's transaction.
+ * @param origin - The replica that wrote the refused transaction.
+ * @param ops - Its ops.
+ */
+export function dropUidAliasesOf(db, origin, ops) {
+    if (!hasTable(db, UID_ALIAS_JOURNAL_TABLE))
+        return;
+    const refs = hasTable(db, UID_REF_ALIAS_JOURNAL_TABLE);
+    for (const op of ops) {
+        const oldBfp = op.obfp ?? op.bfp;
+        if (op.o !== 'K' || !op.nu || !oldBfp)
+            continue;
+        db.prepare(`DELETE FROM ${UID_ALIAS_JOURNAL_TABLE}
+        WHERE tbl = ? AND old_uid = ? AND old_bfp = ? AND new_uid = ? AND origin = ? AND hlc = ?`).run(op.t, op.u, oldBfp, op.nu, origin, op.h);
+        if (refs) {
+            db.prepare(`DELETE FROM ${UID_REF_ALIAS_JOURNAL_TABLE}
+          WHERE tbl = ? AND old_uid = ? AND origin = ? AND new_uid = ? AND hlc = ?`).run(op.t, op.u, origin, op.nu, op.h);
+        }
+    }
+}
 /**
  * The re-key announcements this replica owes, oldest first.
  *
@@ -92,20 +145,44 @@ export function owedAnnouncements(db) {
 export function markAliasAnnounced(db, a, nowIso) {
     db.prepare(`UPDATE ${UID_ALIAS_JOURNAL_TABLE} SET followed_at = ? WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`).run(nowIso, a.table, a.oldUid, a.oldBfp);
 }
+/**
+ * Per handle: whether the alias journal has the `new_bfp` column. The sync
+ * journal migrations run before apply, so the answer holds for the handle;
+ * it is cached only once the journal exists (capture may be enabled later).
+ */
+const newBfpColumn = new WeakMap();
+/** Whether the alias journal has the T14335 `new_bfp` column, read once per handle. */
+function hasNewBfpColumn(db) {
+    const cached = newBfpColumn.get(db);
+    if (cached !== undefined)
+        return cached;
+    const has = db
+        .prepare(`SELECT 1 FROM pragma_table_info('${UID_ALIAS_JOURNAL_TABLE}') WHERE name = 'new_bfp'`)
+        .get() !== undefined;
+    if (has || hasTable(db, UID_ALIAS_JOURNAL_TABLE))
+        newBfpColumn.set(db, has);
+    return has;
+}
 /**
  * Where the row (table, uid, fingerprint) lives now, following re-keys, or
- * null when it was never re-keyed here.
+ * null when it was never re-keyed here. Each hop is matched on the row's
+ * fingerprint at that hop: a re-key that moved the fingerprint (T14335)
+ * carries it into the next lookup and into the result.
  */
 function rowAlias(db, table, uid, bfp) {
-    const next = db.prepare(`SELECT new_uid AS uid FROM ${UID_ALIAS_JOURNAL_TABLE} WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`);
+    const next = db.prepare(hasNewBfpColumn(db)
+        ? `SELECT new_uid AS uid, new_bfp AS bfp FROM ${UID_ALIAS_JOURNAL_TABLE} WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`
+        : `SELECT new_uid AS uid, NULL AS bfp FROM ${UID_ALIAS_JOURNAL_TABLE} WHERE tbl = ? AND old_uid = ? AND old_bfp = ?`);
     let cur = uid;
+    let curBfp = bfp;
     for (let hop = 0; hop < MAX_ALIAS_HOPS; hop++) {
-        const row = next.get(table, cur, bfp);
-        if (!row || row.uid === cur)
+        const row = next.get(table, cur, curBfp);
+        if (!row || (row.uid === cur && (row.bfp ?? curBfp) === curBfp))
             break;
         cur = row.uid;
+        curBfp = row.bfp ?? curBfp;
     }
-    return cur === uid ? null : cur;
+    return cur === uid && curBfp === bfp ? null : { uid: cur, bfp: curBfp };
 }
 /**
  * The new uid a reference to `uid` written by `replica` at `txnHlc` means,
@@ -141,17 +218,26 @@ export function followUidAliases(db, st, defs) {
         let out = op;
         const fp = op.o === 'K' ? op.obfp : op.bfp;
         const moved = fp ? rowAlias(db, op.t, op.u, fp) : null;
-        if (moved !== null)
-            out = { ...out, u: moved };
+        // T14335: the op takes the row's identity now, its fingerprint included,
+        // so a held loser arrives as the row it was re-keyed onto and is placed
+        // as that row, never as a collision with it.
+        // A K is never moved by its own alias (recorded before it applies, T14336).
+        if (moved !== null && !(op.o === 'K' && moved.uid === op.nu)) {
+            out =
+                op.o === 'K'
+                    ? { ...out, u: moved.uid, obfp: moved.bfp }
+                    : { ...out, u: moved.uid, ...(op.bfp !== undefined ? { bfp: moved.bfp } : {}) };
+        }
         const def = defs(op.t);
         if (def && op.a) {
             const a = { ...op.a };
             let refsMoved = false;
             for (const [col, v] of Object.entries(op.a)) {
-                const target = def.refs.get(col);
-                if (!target || typeof v !== 'string')
+                // A reference column, or (T14335) a column holding the target's uid.
+                const targetTable = def.refs.get(col)?.table ?? def.uidRefs?.get(col);
+                if (!targetTable || typeof v !== 'string')
                     continue;
-                const to = refAlias(db, target.table, v, st.replicaId, st.txn.hlc);
+                const to = refAlias(db, targetTable, v, st.replicaId, st.txn.hlc);
                 if (to === null)
                     continue;
                 a[col] = to;

package/dist/store/sync/uid-alias.js.map

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

package/dist/store/sync/write-actor.d.ts

@@ -55,4 +55,3 @@ export declare function runWithWriteActorOp<T>(op: string, fn: () => T): T;
  * @returns The actor JSON, or null.
  */
 export declare function currentWriteActorJson(): string | null;
-//# sourceMappingURL=write-actor.d.ts.map

package/dist/store/sync/writer-version.d.ts

@@ -40,4 +40,3 @@ export declare function raiseMinWriterVersion(db: DatabaseSync, version?: string
  * @throws {StoreWriterTooOldError}
  */
 export declare function assertWriterVersion(db: DatabaseSync, version?: string): void;
-//# sourceMappingURL=writer-version.d.ts.map

package/dist/store/t310-readiness.d.ts

@@ -80,4 +80,3 @@ export declare function assertT310Ready(projectRoot?: string): void;
  * ```
  */
 export declare function isT310Ready(projectRoot?: string): boolean;
-//# sourceMappingURL=t310-readiness.d.ts.map

package/dist/store/table-classification.d.ts

@@ -73,7 +73,7 @@
  * @epic T12322
  * @module store/table-classification
  */
-import type { TableClass, TableClassification, TableScope, TableScopeRegistry } from '@cleocode/contracts';
+import type { RetiredSyncColumn, TableClass, TableClassification, TableScope, TableScopeRegistry } from '@cleocode/contracts';
 /**
  * The classification registry for the project `cleo.db`.
  *
@@ -198,6 +198,35 @@ export declare const SNAPSHOT_STATE_TABLES: Readonly<Record<TableScope, readonly
  * @task T13324
  */
 export declare function isSnapshotStateTable(scope: TableScope, name: string): boolean;
+/**
+ * Columns a migration dropped from a syncing table, per scope.
+ *
+ * The sync contract for a retired column: an op from a peer that has not run
+ * the migration yet may still name it in an image (an insert or delete image
+ * carries every non-NULL column). A receiver whose table no longer has the
+ * column drops it from the op's images and applies the rest
+ * (`withoutLocalColumns` in `store/sync/apply/applier.ts`), because a store
+ * that dropped a column never gains it back, so refusing the op as schema
+ * skew would hold the stream forever. A receiver whose table still has the
+ * column (not migrated yet) applies it as before. A column unknown to the
+ * receiver and absent from this list is still refused (`E_SCHEMA_AHEAD`).
+ *
+ * Every migration that drops a column of a syncing table adds an entry here
+ * in the same change; entries are never removed while an older build may
+ * still send the column.
+ *
+ * @task T14311
+ */
+export declare const RETIRED_SYNC_COLUMNS: Readonly<Record<TableScope, readonly RetiredSyncColumn[]>>;
+/**
+ * The retired columns of one table ({@link RETIRED_SYNC_COLUMNS}).
+ *
+ * @param scope - Which `cleo.db` the table lives in.
+ * @param table - The physical table name.
+ * @returns The names of the columns retired from the table, possibly empty.
+ * @task T14311
+ */
+export declare function retiredSyncColumns(scope: TableScope, table: string): readonly string[];
 /**
  * The keys of a `local-only` key/value table (column `key`) that describe the
  * database file's own data or schema, among keys that describe this machine.
@@ -257,4 +286,3 @@ export declare function fileStateKeyRule(scope: TableScope, name: string): FileS
  * @task T13107
  */
 export declare function isFileStateKey(rule: FileStateKeyRule, key: string): boolean;
-//# sourceMappingURL=table-classification.d.ts.map

package/dist/store/table-classification.js

@@ -724,6 +724,12 @@ const PROJECT_TABLES = {
         status: 'draft',
         source: 'table-classification-draft.md',
     },
+    docs_fts_rows: {
+        class: 'derived',
+        status: 'optional-transient',
+        source: 'T14197 (docs full-text index)',
+        note: 'the slug and sha256 each docs_fts rowid holds; syncDocsFts (docs/docs-fts.ts) rebuilds both tables from the synced docs_attachments rows and blob bodies, cheaply and without an LLM. Never captured, never replicated',
+    },
     docs_publications: {
         class: 'portable-project',
         status: 'resolved',
@@ -2205,6 +2211,8 @@ const FTS5_BASES = [
     'brain_observations_fts',
     'brain_patterns_fts',
     'conduit_messages_fts',
+    // T14197: the docs store's full-text index, rebuilt from `attachments` by syncDocsFts.
+    'docs_fts',
     'nexus_symbols_fts',
 ];
 /** The FTS5 virtual tables above and their `_config/_content/_data/_docsize/_idx` shadows. */
@@ -2421,6 +2429,47 @@ export const SNAPSHOT_STATE_TABLES = {
 export function isSnapshotStateTable(scope, name) {
     return SNAPSHOT_STATE_TABLES[scope].includes(name);
 }
+/**
+ * Columns a migration dropped from a syncing table, per scope.
+ *
+ * The sync contract for a retired column: an op from a peer that has not run
+ * the migration yet may still name it in an image (an insert or delete image
+ * carries every non-NULL column). A receiver whose table no longer has the
+ * column drops it from the op's images and applies the rest
+ * (`withoutLocalColumns` in `store/sync/apply/applier.ts`), because a store
+ * that dropped a column never gains it back, so refusing the op as schema
+ * skew would hold the stream forever. A receiver whose table still has the
+ * column (not migrated yet) applies it as before. A column unknown to the
+ * receiver and absent from this list is still refused (`E_SCHEMA_AHEAD`).
+ *
+ * Every migration that drops a column of a syncing table adds an entry here
+ * in the same change; entries are never removed while an older build may
+ * still send the column.
+ *
+ * @task T14311
+ */
+export const RETIRED_SYNC_COLUMNS = {
+    project: [
+        {
+            table: 'tasks_tasks',
+            column: 'ivtr_state',
+            retiredBy: 'T14311',
+            reason: 'the IVTR loop state was retired; its migration drops the column',
+        },
+    ],
+    global: [],
+};
+/**
+ * The retired columns of one table ({@link RETIRED_SYNC_COLUMNS}).
+ *
+ * @param scope - Which `cleo.db` the table lives in.
+ * @param table - The physical table name.
+ * @returns The names of the columns retired from the table, possibly empty.
+ * @task T14311
+ */
+export function retiredSyncColumns(scope, table) {
+    return RETIRED_SYNC_COLUMNS[scope].filter((r) => r.table === table).map((r) => r.column);
+}
 /**
  * `local-only` key/value tables that mix keys describing the database file
  * with keys describing this machine. A vault restore takes the file's keys