@prisma/orm-postgres 8.0.0-rc.13-dev.3 → 8.0.0-rc.13-dev.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/orm-postgres",
-  "version": "8.0.0-rc.13-dev.3",
+  "version": "8.0.0-rc.13-dev.4",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
@@ -10,10 +10,10 @@
     "skills"
   ],
   "dependencies": {
-    "@prisma/orm-family-sql": "8.0.0-rc.13-dev.3",
-    "@prisma/orm-framework": "8.0.0-rc.13-dev.3",
-    "@prisma/orm-target-postgres": "8.0.0-rc.13-dev.3",
-    "@prisma/orm-toolchain": "8.0.0-rc.13-dev.3",
+    "@prisma/orm-family-sql": "8.0.0-rc.13-dev.4",
+    "@prisma/orm-framework": "8.0.0-rc.13-dev.4",
+    "@prisma/orm-target-postgres": "8.0.0-rc.13-dev.4",
+    "@prisma/orm-toolchain": "8.0.0-rc.13-dev.4",
     "@types/node": "26.1.2",
     "@types/pg": "8.20.4",
     "pathe": "^2.0.3",
@@ -21,9 +21,9 @@
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
-    "@internal/postgres": "8.0.0-rc.13-dev.3",
-    "@repo/tsconfig": "8.0.0-rc.13-dev.3",
-    "@repo/tsdown": "8.0.0-rc.13-dev.3",
+    "@internal/postgres": "8.0.0-rc.13-dev.4",
+    "@repo/tsconfig": "8.0.0-rc.13-dev.4",
+    "@repo/tsdown": "8.0.0-rc.13-dev.4",
     "tsdown": "0.22.14",
     "typescript": "5.9.3"
   },

package/skills/prisma-8/SKILL.md

@@ -15,7 +15,7 @@ description: >-
   ORM 7 or earlier (schema.prisma + @prisma/client).
 metadata:
   library: '@prisma/orm-postgres'
-  library_version: '8.0.0-rc.13-dev.3'
+  library_version: '8.0.0-rc.13-dev.4'
   version: '2026-09-12'
 ---
 

package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/instructions.md

@@ -14,6 +14,7 @@ changes:
         - '"ref"\s*:\s*\{(?![^{}]*"kind")[^{}]*"(?:table|column)"\s*:'
         - '\.ref\??\.(?:table|column)\b'
         - '\bref\s*:\s*\{(?![^{}]*\bkind\b)[^{}]*\b(?:table|column)\s*:[^{}]*\b(?:table|column)\s*:'
+    script: ./scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
   - id: ts-defaults-encoded-by-codec
     summary: |
       `defineContract` from the Postgres and SQLite packages now encodes every literal `.default(value)` through the column's codec. The literal is the codec's input type. TypeScript checks it for fields built inside the `defineContract` factory, and the build fails with `CONTRACT.DEFAULT_INVALID` for a value the codec refuses. Pass a value of the codec's input type, or choose the field preset whose codec takes the value you have.
@@ -120,7 +121,15 @@ A contract with generated defaults (`temporal.createdAt()`, `temporal.updatedAt(
 ```
 
 1. Run `prisma contract emit` so `contract.json` and `contract.d.ts` use the new keys. The runtime rejects a contract whose refs still say `table` and `column` with `Contract structural validation failed: execution.mutations.defaults[0].ref.entry must be a string`.
-2. Contract snapshots under `migrations/snapshots/<hash>/` that carry an `execution` section have the old keys too. In each `execution.mutations.defaults[].ref`, in both `contract.json` and `contract.d.ts`, rename `table` to `entry` and `column` to `field`, and write the keys in the order `entry`, `field`, `namespace`, which is the order `prisma contract emit` writes. Leave the snapshot's existing `executionHash` as it is. It no longer matches the renamed content, but the snapshot loader re-hashes only the storage section, so nothing checks it. `storageHash` and `profileHash` do not move, so snapshot directory names stay the same.
+2. Contracts stored under `migrations/` carry the old keys too: the snapshots in `migrations/snapshots/<hash>/contract.json` and `contract.d.ts`, and any intermediate contract a migration imports from its own directory, such as `migrations/app/<dir>/intermediate.json` and `intermediate.d.ts`. From the project root, run the script that sits next to this guide. `<skill>` is the directory of the synced `prisma-8` skill:
+
+   ```bash
+   pnpm exec tsx <skill>/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
+   ```
+
+   The script reads every `.json` and `.d.ts` file under a `migrations/` directory, skipping `node_modules`, `.git` and `dist`, and changes only `execution.mutations.defaults[].ref` entries. In each one it renames `table` to `entry` and `column` to `field`, and writes the keys in the order `entry`, `field`, `namespace`, which is the order `prisma contract emit` writes. The old key order varies between files: older `contract.d.ts` files list `namespace`, `table`, `column`, newer ones `column`, `namespace`, `table`. The script handles any order; a hand edit or a search-and-replace that assumes one order misses some refs. A `contract.json` in canonical form stays canonical, so a snapshot matches a fresh emit apart from `executionHash`; an indented JSON file keeps its indentation. The script leaves every `executionHash` as it is. That hash no longer matches the renamed content, but the snapshot loader re-hashes only the storage section, so nothing checks it. `storageHash` and `profileHash` do not move, so snapshot directory names stay the same. A second run changes nothing. Pass `--check` to list the files it would change without writing them; it exits 1 if any would change. A `.json` file it cannot parse is listed as `NOT JSON` and also makes it exit 1.
+
+   To confirm the rewrite, name one migration directory under `migrations/app/` as both ends of a plan: `prisma migration plan --from <dir> --to <dir>`. It loads that migration's snapshot without touching the database. Before the rewrite it fails with `CONTRACT.VALIDATION_FAILED` and `execution.mutations.defaults[0].ref.entry must be a string`; after the rewrite it prints `No changes detected` and writes no migration. In a project with extensions it also re-pins their files under `migrations/<space-id>/`, as every `migration plan` does. `prisma db migrate --to <hash>` does not confirm it: it applies migrations, and on a database already past that snapshot it has no route back, so it fails either way. `prisma migration check` and `prisma db verify` never validate an app snapshot's `execution` section, so they pass before and after the rewrite.
 3. Code that reads the section directly changes `.ref.table` to `.ref.entry` and `.ref.column` to `.ref.field`.
 
 `executionHash` changes for every contract with generated defaults, because the canonical JSON changes. Nothing compares it against the database, so no migration or re-sign is needed.

package/skills/prisma-8/upgrading/app/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts

@@ -0,0 +1,193 @@
+// Renames `table`/`column` to `entry`/`field` in execution default refs of contracts under `migrations/`.
+import { readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, relative, sep } from 'node:path';
+
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist']);
+const RENAMES = new Map([
+  ['table', 'entry'],
+  ['column', 'field'],
+]);
+
+const check = process.argv.includes('--check');
+const projectRoot = process.cwd();
+
+function isContractFile(name: string): boolean {
+  return name.endsWith('.json') || name.endsWith('.d.ts');
+}
+
+async function findMigrationFiles(dir: string, found: string[] = []): Promise<string[]> {
+  for (const entry of await readdir(dir, { withFileTypes: true })) {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+      await findMigrationFiles(path, found);
+    } else if (
+      entry.isFile() &&
+      isContractFile(entry.name) &&
+      relative(projectRoot, dir).split(sep).includes('migrations')
+    ) {
+      found.push(path);
+    }
+  }
+  return found;
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function sortKeys(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(sortKeys);
+  if (!isObject(value)) return value;
+  const sorted: Record<string, unknown> = {};
+  for (const key of Object.keys(value).sort()) sorted[key] = sortKeys(value[key]);
+  return sorted;
+}
+
+function parseJson(text: string): unknown {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return undefined;
+  }
+}
+
+function serializeLike(original: string, value: unknown): string {
+  if (original === `${JSON.stringify(sortKeys(parseJson(original)))}\n`) {
+    return `${JSON.stringify(sortKeys(value))}\n`;
+  }
+  const indent = /\n([ \t]+)/.exec(original)?.[1] ?? 2;
+  return `${JSON.stringify(value, null, indent)}${original.endsWith('\n') ? '\n' : ''}`;
+}
+
+function renameInJson(text: string): string | undefined {
+  const contract = parseJson(text);
+  if (contract === undefined) return undefined;
+  if (!isObject(contract) || !isObject(contract['execution'])) return text;
+  const mutations = contract['execution']['mutations'];
+  const defaults = isObject(mutations) ? mutations['defaults'] : undefined;
+  if (!Array.isArray(defaults)) return text;
+  let changed = false;
+  for (const entry of defaults) {
+    if (!isObject(entry) || !isObject(entry['ref'])) continue;
+    const keys = Object.keys(entry['ref']);
+    if (!keys.some((key) => RENAMES.has(key))) continue;
+    entry['ref'] = sortKeys(
+      Object.fromEntries(
+        Object.entries(entry['ref']).map(([key, value]) => [RENAMES.get(key) ?? key, value]),
+      ),
+    );
+    changed = true;
+  }
+  return changed ? serializeLike(text, contract) : text;
+}
+
+const DEFAULT_ELEMENT_PATH = ['execution', 'mutations', 'defaults', ''];
+const MEMBER_BEFORE_OPENER = /readonly (\w+): (?:readonly )?$/;
+const REF_MEMBER = /readonly (\w+): ('(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*")/g;
+
+interface OpenBlock {
+  readonly member: string;
+  readonly start: number;
+  readonly isDefaultRef: boolean;
+}
+
+interface Span {
+  readonly start: number;
+  readonly end: number;
+}
+
+function closingQuote(text: string, start: number): number {
+  let i = start + 1;
+  while (i < text.length && text[i] !== text[start]) i += text[i] === '\\' ? 2 : 1;
+  return i;
+}
+
+function commentEnd(text: string, start: number): number {
+  const end =
+    text[start + 1] === '/' ? text.indexOf('\n', start) : text.indexOf('*/', start + 2) + 1;
+  return end > start ? end : text.length;
+}
+
+function isDefaultElement(open: readonly OpenBlock[]): boolean {
+  const members = open.slice(-DEFAULT_ELEMENT_PATH.length).map((block) => block.member);
+  return members.join('/') === DEFAULT_ELEMENT_PATH.join('/');
+}
+
+function executionDefaultRefs(text: string): Span[] {
+  const open: OpenBlock[] = [];
+  const refs: Span[] = [];
+  for (let i = 0; i < text.length; i++) {
+    const char = text[i];
+    if (char === "'" || char === '"' || char === '`') {
+      i = closingQuote(text, i);
+    } else if (char === '/' && (text[i + 1] === '/' || text[i + 1] === '*')) {
+      i = commentEnd(text, i);
+    } else if (char === '{' || char === '[') {
+      const member = MEMBER_BEFORE_OPENER.exec(text.slice(Math.max(0, i - 64), i))?.[1] ?? '';
+      const isDefaultRef = char === '{' && member === 'ref' && isDefaultElement(open);
+      open.push({ member, start: i, isDefaultRef });
+    } else if (char === '}' || char === ']') {
+      const block = open.pop();
+      if (block?.isDefaultRef) refs.push({ start: block.start, end: i + 1 });
+    }
+  }
+  return refs;
+}
+
+function renameRefMembers(block: string): string {
+  const members = [...block.matchAll(REF_MEMBER)];
+  if (!members.some(([, key = '']) => RENAMES.has(key))) return block;
+  const sorted = members
+    .map(([, key = '', value = '']) => `readonly ${RENAMES.get(key) ?? key}: ${value}`)
+    .sort();
+  let i = 0;
+  return block.replace(REF_MEMBER, () => sorted[i++] ?? '');
+}
+
+function renameInDts(text: string): string {
+  let renamed = text;
+  for (const { start, end } of executionDefaultRefs(text).reverse()) {
+    const block = renameRefMembers(renamed.slice(start, end));
+    renamed = `${renamed.slice(0, start)}${block}${renamed.slice(end)}`;
+  }
+  return renamed;
+}
+
+async function replaceFile(path: string, content: string): Promise<void> {
+  const temporary = join(dirname(path), `.${basename(path)}.${process.pid}.tmp`);
+  try {
+    await writeFile(temporary, content, 'utf-8');
+    await rename(temporary, path);
+  } catch (error) {
+    await rm(temporary, { force: true });
+    throw error;
+  }
+}
+
+async function main(): Promise<void> {
+  const files = await findMigrationFiles(projectRoot);
+  let changed = 0;
+  let unparseable = 0;
+  for (const path of files.sort()) {
+    const before = await readFile(path, 'utf-8');
+    const after = path.endsWith('.json') ? renameInJson(before) : renameInDts(before);
+    if (after === undefined) {
+      unparseable += 1;
+      console.log(`NOT JSON ${relative(projectRoot, path)}`);
+      continue;
+    }
+    if (after === before) continue;
+    changed += 1;
+    console.log(`${check ? 'WOULD FIX' : 'FIXED'} ${relative(projectRoot, path)}`);
+    if (!check) await replaceFile(path, after);
+  }
+  console.log(
+    `${files.length} file(s) under migrations/ scanned, ${changed} ${check ? 'need' : 'got'} the rename.`,
+  );
+  if (unparseable > 0) {
+    console.log(`${unparseable} .json file(s) could not be parsed; check them by hand.`);
+  }
+  if (unparseable > 0 || (check && changed > 0)) process.exit(1);
+}
+
+void main();

package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/instructions.md

@@ -14,6 +14,7 @@ changes:
         - '"ref"\s*:\s*\{(?![^{}]*"kind")[^{}]*"(?:table|column)"\s*:'
         - '\.ref\??\.(?:table|column)\b'
         - '\bref\s*:\s*\{(?![^{}]*\bkind\b)[^{}]*\b(?:table|column)\s*:[^{}]*\b(?:table|column)\s*:'
+    script: ./scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
   - id: mutation-default-generator-types-move-to-framework
     summary: |
       `GeneratorStability` and `RuntimeMutationDefaultGenerator` are no longer exported by the SQL
@@ -185,7 +186,15 @@ A contract with generated defaults (`temporal.createdAt()`, `temporal.updatedAt(
 ```
 
 1. Run `prisma contract emit` so `contract.json` and `contract.d.ts` use the new keys. The runtime rejects a contract whose refs still say `table` and `column` with `Contract structural validation failed: execution.mutations.defaults[0].ref.entry must be a string`.
-2. Contract snapshots under `migrations/snapshots/<hash>/` that carry an `execution` section have the old keys too. In each `execution.mutations.defaults[].ref`, in both `contract.json` and `contract.d.ts`, rename `table` to `entry` and `column` to `field`, and write the keys in the order `entry`, `field`, `namespace`, which is the order `prisma contract emit` writes. Leave the snapshot's existing `executionHash` as it is. It no longer matches the renamed content, but the snapshot loader re-hashes only the storage section, so nothing checks it. `storageHash` and `profileHash` do not move, so snapshot directory names stay the same.
+2. Contracts stored under `migrations/` carry the old keys too: the snapshots in `migrations/snapshots/<hash>/contract.json` and `contract.d.ts`, and any intermediate contract a migration imports from its own directory, such as `migrations/<dir>/intermediate.json` and `intermediate.d.ts`. From the extension package root, run the script that sits next to this guide. `<skill>` is the directory of the synced `prisma-8` skill:
+
+   ```bash
+   pnpm exec tsx <skill>/upgrading/extension/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts
+   ```
+
+   The script reads every `.json` and `.d.ts` file under a `migrations/` directory, skipping `node_modules`, `.git` and `dist`, and changes only `execution.mutations.defaults[].ref` entries. In each one it renames `table` to `entry` and `column` to `field`, and writes the keys in the order `entry`, `field`, `namespace`, which is the order `prisma contract emit` writes. The old key order varies between files: older `contract.d.ts` files list `namespace`, `table`, `column`, newer ones `column`, `namespace`, `table`. The script handles any order; a hand edit or a search-and-replace that assumes one order misses some refs. A `contract.json` in canonical form stays canonical, so a snapshot matches a fresh emit apart from `executionHash`; an indented JSON file keeps its indentation. The script leaves every `executionHash` as it is. That hash no longer matches the renamed content, but the snapshot loader re-hashes only the storage section, so nothing checks it. `storageHash` and `profileHash` do not move, so snapshot directory names stay the same. A second run changes nothing. Pass `--check` to list the files it would change without writing them; it exits 1 if any would change. A `.json` file it cannot parse is listed as `NOT JSON` and also makes it exit 1.
+
+   To confirm the rewrite, run the script again with `--check`; it exits 0 when no ref is left to rename. No CLI command reads the package's own `migrations/snapshots/`: run from the package root, the CLI looks for migrations in `migrations/app/`, and a contract-space package keeps them directly under `migrations/`. The CLI reads an extension's contract space in an app that installs the extension, from the app's `migrations/<space-id>/` and `migrations/snapshots/`. There, `prisma migration check --space <space-id>` loads the contract at the space's head and fails with `MIGRATION.CHECK_CONTRACT_UNREADABLE` while its refs still say `table` and `column`. The head is the only snapshot of an extension space the CLI loads; `prisma db migrate --to <hash>` selects a snapshot of the app space, not of an extension.
 3. Code that reads the section directly changes `.ref.table` to `.ref.entry` and `.ref.column` to `.ref.field`.
 
 `executionHash` changes for every contract with generated defaults, because the canonical JSON changes. Nothing compares it against the database, so no migration or re-sign is needed.

package/skills/prisma-8/upgrading/extension/upgrades/8.0.0-rc.12-to-8.0.0-rc.13/scripts/execution-ref-entry-field/rename-execution-ref-keys.ts

@@ -0,0 +1,193 @@
+// Renames `table`/`column` to `entry`/`field` in execution default refs of contracts under `migrations/`.
+import { readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, relative, sep } from 'node:path';
+
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist']);
+const RENAMES = new Map([
+  ['table', 'entry'],
+  ['column', 'field'],
+]);
+
+const check = process.argv.includes('--check');
+const projectRoot = process.cwd();
+
+function isContractFile(name: string): boolean {
+  return name.endsWith('.json') || name.endsWith('.d.ts');
+}
+
+async function findMigrationFiles(dir: string, found: string[] = []): Promise<string[]> {
+  for (const entry of await readdir(dir, { withFileTypes: true })) {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+      await findMigrationFiles(path, found);
+    } else if (
+      entry.isFile() &&
+      isContractFile(entry.name) &&
+      relative(projectRoot, dir).split(sep).includes('migrations')
+    ) {
+      found.push(path);
+    }
+  }
+  return found;
+}
+
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function sortKeys(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(sortKeys);
+  if (!isObject(value)) return value;
+  const sorted: Record<string, unknown> = {};
+  for (const key of Object.keys(value).sort()) sorted[key] = sortKeys(value[key]);
+  return sorted;
+}
+
+function parseJson(text: string): unknown {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return undefined;
+  }
+}
+
+function serializeLike(original: string, value: unknown): string {
+  if (original === `${JSON.stringify(sortKeys(parseJson(original)))}\n`) {
+    return `${JSON.stringify(sortKeys(value))}\n`;
+  }
+  const indent = /\n([ \t]+)/.exec(original)?.[1] ?? 2;
+  return `${JSON.stringify(value, null, indent)}${original.endsWith('\n') ? '\n' : ''}`;
+}
+
+function renameInJson(text: string): string | undefined {
+  const contract = parseJson(text);
+  if (contract === undefined) return undefined;
+  if (!isObject(contract) || !isObject(contract['execution'])) return text;
+  const mutations = contract['execution']['mutations'];
+  const defaults = isObject(mutations) ? mutations['defaults'] : undefined;
+  if (!Array.isArray(defaults)) return text;
+  let changed = false;
+  for (const entry of defaults) {
+    if (!isObject(entry) || !isObject(entry['ref'])) continue;
+    const keys = Object.keys(entry['ref']);
+    if (!keys.some((key) => RENAMES.has(key))) continue;
+    entry['ref'] = sortKeys(
+      Object.fromEntries(
+        Object.entries(entry['ref']).map(([key, value]) => [RENAMES.get(key) ?? key, value]),
+      ),
+    );
+    changed = true;
+  }
+  return changed ? serializeLike(text, contract) : text;
+}
+
+const DEFAULT_ELEMENT_PATH = ['execution', 'mutations', 'defaults', ''];
+const MEMBER_BEFORE_OPENER = /readonly (\w+): (?:readonly )?$/;
+const REF_MEMBER = /readonly (\w+): ('(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*")/g;
+
+interface OpenBlock {
+  readonly member: string;
+  readonly start: number;
+  readonly isDefaultRef: boolean;
+}
+
+interface Span {
+  readonly start: number;
+  readonly end: number;
+}
+
+function closingQuote(text: string, start: number): number {
+  let i = start + 1;
+  while (i < text.length && text[i] !== text[start]) i += text[i] === '\\' ? 2 : 1;
+  return i;
+}
+
+function commentEnd(text: string, start: number): number {
+  const end =
+    text[start + 1] === '/' ? text.indexOf('\n', start) : text.indexOf('*/', start + 2) + 1;
+  return end > start ? end : text.length;
+}
+
+function isDefaultElement(open: readonly OpenBlock[]): boolean {
+  const members = open.slice(-DEFAULT_ELEMENT_PATH.length).map((block) => block.member);
+  return members.join('/') === DEFAULT_ELEMENT_PATH.join('/');
+}
+
+function executionDefaultRefs(text: string): Span[] {
+  const open: OpenBlock[] = [];
+  const refs: Span[] = [];
+  for (let i = 0; i < text.length; i++) {
+    const char = text[i];
+    if (char === "'" || char === '"' || char === '`') {
+      i = closingQuote(text, i);
+    } else if (char === '/' && (text[i + 1] === '/' || text[i + 1] === '*')) {
+      i = commentEnd(text, i);
+    } else if (char === '{' || char === '[') {
+      const member = MEMBER_BEFORE_OPENER.exec(text.slice(Math.max(0, i - 64), i))?.[1] ?? '';
+      const isDefaultRef = char === '{' && member === 'ref' && isDefaultElement(open);
+      open.push({ member, start: i, isDefaultRef });
+    } else if (char === '}' || char === ']') {
+      const block = open.pop();
+      if (block?.isDefaultRef) refs.push({ start: block.start, end: i + 1 });
+    }
+  }
+  return refs;
+}
+
+function renameRefMembers(block: string): string {
+  const members = [...block.matchAll(REF_MEMBER)];
+  if (!members.some(([, key = '']) => RENAMES.has(key))) return block;
+  const sorted = members
+    .map(([, key = '', value = '']) => `readonly ${RENAMES.get(key) ?? key}: ${value}`)
+    .sort();
+  let i = 0;
+  return block.replace(REF_MEMBER, () => sorted[i++] ?? '');
+}
+
+function renameInDts(text: string): string {
+  let renamed = text;
+  for (const { start, end } of executionDefaultRefs(text).reverse()) {
+    const block = renameRefMembers(renamed.slice(start, end));
+    renamed = `${renamed.slice(0, start)}${block}${renamed.slice(end)}`;
+  }
+  return renamed;
+}
+
+async function replaceFile(path: string, content: string): Promise<void> {
+  const temporary = join(dirname(path), `.${basename(path)}.${process.pid}.tmp`);
+  try {
+    await writeFile(temporary, content, 'utf-8');
+    await rename(temporary, path);
+  } catch (error) {
+    await rm(temporary, { force: true });
+    throw error;
+  }
+}
+
+async function main(): Promise<void> {
+  const files = await findMigrationFiles(projectRoot);
+  let changed = 0;
+  let unparseable = 0;
+  for (const path of files.sort()) {
+    const before = await readFile(path, 'utf-8');
+    const after = path.endsWith('.json') ? renameInJson(before) : renameInDts(before);
+    if (after === undefined) {
+      unparseable += 1;
+      console.log(`NOT JSON ${relative(projectRoot, path)}`);
+      continue;
+    }
+    if (after === before) continue;
+    changed += 1;
+    console.log(`${check ? 'WOULD FIX' : 'FIXED'} ${relative(projectRoot, path)}`);
+    if (!check) await replaceFile(path, after);
+  }
+  console.log(
+    `${files.length} file(s) under migrations/ scanned, ${changed} ${check ? 'need' : 'got'} the rename.`,
+  );
+  if (unparseable > 0) {
+    console.log(`${unparseable} .json file(s) could not be parsed; check them by hand.`);
+  }
+  if (unparseable > 0 || (check && changed > 0)) process.exit(1);
+}
+
+void main();