@payloadcms/codemod 4.0.0-internal.cc18726 → 4.0.0-internal.cd47d20

package/README.md

@@ -14,10 +14,66 @@ With no arguments, runs every registered transform against the current directory
 
 ### Flags
 
-- `--transform <name>` — run a single transform by name.
-- `--list` — print registered transforms.
-- `--dry` — analyze only; write nothing.
-- `--print` — print transformed sources to stdout instead of writing.
+- `--transform <name>`: run a single transform by name.
+- `--list`: print registered transforms.
+- `--dry`: analyze only; write nothing.
+- `--print`: print transformed sources to stdout instead of writing.
+
+## `upgrade` command
+
+The `upgrade` command has three verbs.
+
+### `upgrade` (pick how to run it)
+
+`npx @payloadcms/codemod upgrade` is the entry point. It detects installed coding-agent CLIs
+(`claude`, `codex`) and asks how you want to run the full v3 -> v4 upgrade, Next.js 16 included:
+
+- Hand the orchestration prompt to a detected agent. The agent runs the whole sequence, calling
+  `upgrade run` for the mechanical slice as one step.
+- Run the mechanical steps here, the same work as `upgrade run`.
+- Just print the prompt to run it yourself or paste it elsewhere.
+
+Pin an agent with `--agent <claude|codex>` to skip the picker. When there is no TTY (CI), it prints
+the prompt instead of prompting.
+
+### `upgrade run` (mechanical slice)
+
+`npx @payloadcms/codemod upgrade run` performs the deterministic v3 -> v4 slice against the current
+directory (run it from your project root):
+
+1. Resolves the current Payload version from the npm registry, using the dist-tag this CLI was installed under (`beta` if run as `@payloadcms/codemod@beta`, else `canary`; override with `--tag <dist-tag>`).
+2. Rewrites `package.json`: pins `payload` + every `@payloadcms/*` to that exact version in
+   lockstep, removes dependency overrides pinning them, converts their carets to exact, and writes
+   the TypeScript / `@types/node` / `engines.node` floors. The `@payloadcms/eslint-*` packages are
+   versioned independently, so they are set to `latest` rather than lockstep-pinned.
+3. Installs with your detected package manager.
+4. Runs every registered transform against the now-v4 tree.
+5. Prints a report and points you at the bundled runbook for the rest.
+
+It does NOT upgrade Next.js. Payload v4 requires Next 16; run Next's own recommended agent
+workflow (linked from the bundled runbook) to bump Next and migrate the code together. The report
+prints the required Next target.
+
+Flags:
+
+- `--tag <dist-tag>`: dist-tag to resolve Payload versions from. Defaults to the dist-tag this CLI was installed under (`beta` when run as `@payloadcms/codemod@beta`, else `canary`).
+- `--dry`: preview the `package.json` changes and planned steps; write and install nothing.
+- `--force`: skip the dirty-git-tree warning.
+
+### `upgrade prompt` (print the prompt)
+
+`npx @payloadcms/codemod upgrade prompt` prints the orchestration prompt to stdout and exits. It is
+offline and stateless: it writes nothing and makes no network calls. The text is project-agnostic,
+so pipe it to any agent and run it from the project root. This is the same prompt the `upgrade`
+picker hands off, minus the detection and spawn.
+
+The prompt sequences the upgrade (mechanical slice via `upgrade run`, then Next.js via Next's own
+codemods and agent workflow, then regeneration, judgment work, and verification) and points at the
+bundled runbook and migration guide for detail rather than restating them.
+
+The mechanical-slice command inside the prompt re-invokes this CLI. A published install emits
+`npx @payloadcms/codemod`; a source checkout emits `node <bin>` so followers run the local build.
+Set `PAYLOAD_CODEMOD_COMMAND` to override the emitted token.
 
 ## How it works
 
@@ -25,30 +81,38 @@ The tool loads your project via [ts-morph](https://ts-morph.com/), using your `t
 
 ## Transforms
 
-- `migrate-list-view-select-api` — Removes `admin.enableListViewSelectAPI` from Collection Configs. The List View's Select API is the default in v4.
-- `migrate-disabled-fields` — migrates `field.admin.disableListColumn`, `disableListFilter`, `disableGroupBy`, `disableBulkEdit` and their equivalents on `imageSize.admin` into the consolidated `disabled` object form.
-- `globals-components-edit` — Globals: rename `admin.components.elements` to `admin.components.edit` and hoist `Description` to top-level `admin.components.Description` to match Collection conventions.
-- `migrate-force-select` — migrates `forceSelect: { ... }` on Collection/Global configs to a `select` function that augments the caller's `select` when present and returns `undefined` (preserving full-document reads) when not. Shallow values become a spread (`{ ...select, ... }`); nested values use `deepMergeSimple` from `payload/shared` (auto-imported) to preserve the previous deep-merge semantics. Non-literal values, sibling `select` already present, and unsupported member kinds are surfaced as notes for manual review.
-- `migrate-block-references-to-blocks` — renames blocks field `blockReferences` configs to `blocks`, and removes a sibling `blocks: []` placeholder when present. If a non-empty `blocks` sibling already exists, the transform leaves the field untouched and surfaces a note for manual review.
-- `migrate-hide-api-url` — migrates `admin.hideAPIURL: true` to `admin.components.views.edit.api.tab.condition: () => false` on collection and global configs.
-- `migrate-aliased-exports` — rewrites imports of types and utilities that used to be re-exported from `@payloadcms/ui` and `@payloadcms/next/utilities` to their canonical sources in `payload` / `payload/shared`.
-- `migrate-document-title-context` — migrates `title` and `setDocumentTitle` destructured from `useDocumentInfo()` to `useDocumentTitle()`. They were removed from `DocumentInfoContext` in v4 and now live on `DocumentTitleContext`.
-- `migrate-storage-adapters-to-config` — moves storage adapter factory calls (`s3Storage`, `gcsStorage`, `azureStorage`, `r2Storage`, `vercelBlobStorage`) from `plugins` to the new top-level `storage` array. Removes `plugins` if it becomes empty after the move. **Limitations:** aliased imports (e.g. `import { s3Storage as myS3 }`) are not detected; rename any aliases to the canonical factory name before running, or migrate those calls manually. The transform preserves AST structure but does not re-format output — run `prettier --write` (or your project's formatter) after applying.
-- `rename-storage-adapters-to-storage` — renames the top-level `storageAdapters` config property to `storage`. Skips any object that already has a `storage` property. Run this if you previously ran `migrate-storage-adapters-to-config` and need to update the property name.
-- `migrate-azure-chunk-large-files` — removes the `chunkLargeFiles` option from `azureStorage` `clientUploads` config. Chunked client uploads are the default in v4, so the flag no longer exists; `clientUploads: { chunkLargeFiles: true }` collapses to `clientUploads: true`. Surfaces a note when `chunkLargeFiles: false` was removed, since v4 can no longer disable chunking (and its broader CORS requirements apply).
-- `migrate-import-export-hooks` — migrates the deprecated `toCSV` and `fromCSV` field options in `custom['plugin-import-export']` to `hooks.beforeExport` and `hooks.beforeImport`. If a `hooks` object already exists it is merged into; if `hooks.beforeExport`/`hooks.beforeImport` already exist the deprecated sibling is dropped without overwriting. Review argument shapes after migration: `beforeExport` uses `siblingData` (not `row`) and `data` is the top-level document (previously `doc`).
-- `migrate-db-types-subpath` — rewrites imports from the removed `/types` subpath exports of `@payloadcms/drizzle`, `@payloadcms/db-postgres`, `@payloadcms/db-sqlite`, `@payloadcms/db-vercel-postgres`, and `@payloadcms/db-d1-sqlite` to their main entry points. Also handles re-export declarations and `declare module` augmentations.
-- `migrate-next-subpath-exports` — rewrites imports, re-exports, and string-literal component paths from the removed `@payloadcms/next/client`, `@payloadcms/next/rsc`, and `@payloadcms/next/templates` subpaths to their canonical `@payloadcms/ui` or `@payloadcms/ui/rsc` sources. After running, regenerate the import map with `payload generate:importmap`.
-- `migrate-next-generate-viewport-export` — adds a `generateViewport` export to app router layout files that already use Payload's shared Next.js layout, preserving Next.js viewport behavior without touching custom viewport implementations.
-- `migrate-lexical-is-html-element` — rewrites imports of the removed `isHTMLElement` utility from `@payloadcms/richtext-lexical` (and `/client`) to its canonical source, `lexical`, splitting it out of mixed imports and merging into an existing `lexical` import when present. Surfaces a note reminding you that `lexical` is now a required dependency (`pnpm add lexical`).
-- `migrate-after-operation-read` — rewrites `operation === 'read'` checks inside collection `afterOperation` hooks to handle the `find` and `findByID` operations (the deprecated `'read'` value was removed). Handles `===`/`!==`/`==`/`!=` against a destructured (or aliased) or property-accessed `operation` argument. Leaves `beforeOperation` (which still uses `'read'`) untouched, and surfaces notes for non-inline hooks and `switch` statements that need manual review.
-- `migrate-versions-default` — adds `versions: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have a `versions` property. Preserves the previous opt-in behaviour now that `versions` defaults to `true` for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
-- `remove-versions-true` — removes the now-redundant `versions: true` property from `CollectionConfig` and `GlobalConfig` objects. Only removes the bare boolean `true`; object-form configs (e.g. `versions: { drafts: true }`) are left untouched.
-- `remove-group-by-true` — removes `admin.groupBy` from `CollectionConfig` objects. The experimental `groupBy` flag has been removed; groupBy is now an always-available per-user UI preference.
-- `rename-typescript-schema-to-json-schema` — renames the `typescriptSchema` field-config property to `jsonSchema` (it always accepted JSON Schema, not TypeScript). Skips any object that already defines a `jsonSchema` sibling and surfaces it as a note for manual review.
-- `migrate-build-script` — rewrites the `build` npm script in `package.json` from `next build` to `payload build`, so the Import Map (and types) are generated before the Next.js build. Matches the `next build` invocation only (leaves `next build-storybook` and the like untouched) and is a no-op when `build` is already `payload build`.
-- `migrate-slug-field` — converts the removed experimental `slugField()` helper (imported from `payload`) into the native `{ type: 'slug' }` field, mapping `useAsSlug`/`fieldToUse`, `slugify`, `required`, `localized`, `disableUnique` (→ `unique: false`), and `position` (→ `admin.position`), and dropping the obsolete `checkboxName`. Removes the now-unused `slugField` import. Calls using `overrides` (or other unrecognized options) are left in place with a note for manual migration.
-- `rename-experimental-table-feature` — renames imports of `EXPERIMENTAL_TableFeature` from `@payloadcms/richtext-lexical` to `TableFeature` (the table feature is now stable) and updates all local usages, e.g. `EXPERIMENTAL_TableFeature()` call sites.
+- `remove-strict-draft-types`: removes `typescript.strictDraftTypes` from inline config objects regardless of its value. Strict draft types are always enabled in v4. Preserves other TypeScript options; indirect or spread settings must be updated manually.
+- `migrate-list-view-select-api`: Removes `admin.enableListViewSelectAPI` from Collection Configs. The List View's Select API is the default in v4.
+- `migrate-disabled-fields`: migrates `field.admin.disableListColumn`, `disableListFilter`, `disableGroupBy`, `disableBulkEdit` and their equivalents on `imageSize.admin` into the consolidated `disabled` object form.
+- `globals-components-edit`: Globals: rename `admin.components.elements` to `admin.components.edit` and hoist `Description` to top-level `admin.components.Description` to match Collection conventions.
+- `migrate-force-select`: migrates `forceSelect: { ... }` on Collection/Global configs to a `select` function that augments the caller's `select` when present and returns `undefined` (preserving full-document reads) when not. Shallow values become a spread (`{ ...select, ... }`); nested values use `deepMergeSimple` from `payload/shared` (auto-imported) to preserve the previous deep-merge semantics. Non-literal values, sibling `select` already present, and unsupported member kinds are surfaced as notes for manual review.
+- `migrate-field-component-types`: replaces field component aliases—including concrete fields, canonical generics, labels, descriptions, errors, diffs, and block row labels—with the corresponding props types wrapped in `React.FC`. Generic arguments are preserved. Explicit class components, re-exports, namespace references, and inline imports are left unchanged with notes for manual migration.
+- `migrate-block-references-to-blocks`: renames blocks field `blockReferences` configs to `blocks`, and removes a sibling `blocks: []` placeholder when present. If a non-empty `blocks` sibling already exists, the transform leaves the field untouched and surfaces a note for manual review.
+- `migrate-hide-api-url`: migrates `admin.hideAPIURL: true` to `admin.components.views.edit.api.tab.condition: () => false` on collection and global configs.
+- `migrate-aliased-exports`: rewrites imports of types and utilities that used to be re-exported from `@payloadcms/ui` and `@payloadcms/next/utilities` to their canonical sources in `payload` / `payload/shared`.
+- `migrate-payload-request-creation`: renames named request-helper and admin-context imports from `payload` and `payload/internal`. Calls migrate only with a plain identifier payload and either `{}` or an initialized local `const` options identifier whose type exposes all seven old option properties (or is `any`). The generated argument captures payload first and forwards only `context`, `depth`, `fallbackLocale`, `locale`, `req`, `urlSuffix`, and `user` through getters, preserving inherited getters, read order, and async rejection behavior. Existing `CreateLocalReqOptions` named imports from `payload` become options-only usages of `Omit<CreatePayloadRequestArgs, 'payload'>`; relative/private imports of that internal type require manual migration. Unsupported shapes, type usages, and collisions leave the affected binding unchanged with notes.
+- `migrate-document-title-context`: migrates `title` and `setDocumentTitle` destructured from `useDocumentInfo()` to `useDocumentTitle()`. They were removed from `DocumentInfoContext` in v4 and now live on `DocumentTitleContext`.
+- `migrate-storage-adapters-to-config`: moves storage adapter factory calls (`s3Storage`, `gcsStorage`, `azureStorage`, `r2Storage`, `vercelBlobStorage`) from `plugins` to the new top-level `storage` array. Removes `plugins` if it becomes empty after the move. **Limitations:** aliased imports (e.g. `import { s3Storage as myS3 }`) are not detected; rename any aliases to the canonical factory name before running, or migrate those calls manually. The transform preserves AST structure but does not re-format output. Run `prettier --write` (or your project's formatter) after applying.
+- `rename-storage-adapters-to-storage`: renames the top-level `storageAdapters` config property to `storage`. Skips any object that already has a `storage` property. Run this if you previously ran `migrate-storage-adapters-to-config` and need to update the property name.
+- `migrate-azure-chunk-large-files`: removes the `chunkLargeFiles` option from `azureStorage` `clientUploads` config. Chunked client uploads are the default in v4, so the flag no longer exists; `clientUploads: { chunkLargeFiles: true }` collapses to `clientUploads: true`. Surfaces a note when `chunkLargeFiles: false` was removed, since v4 can no longer disable chunking (and its broader CORS requirements apply).
+- `remove-storage-always-insert-fields`: removes the obsolete `alwaysInsertFields` option from inline `cloudStoragePlugin`, `azureStorage`, `gcsStorage`, `r2Storage`, `s3Storage`, and `vercelBlobStorage` configs. The `prefix` field is now always inserted. Aliased named imports are supported; indirect or spread options must be updated manually.
+- `migrate-import-export-hooks`: migrates the deprecated `toCSV` and `fromCSV` field options in `custom['plugin-import-export']` to `hooks.beforeExport` and `hooks.beforeImport`. If a `hooks` object already exists it is merged into; if `hooks.beforeExport`/`hooks.beforeImport` already exist the deprecated sibling is dropped without overwriting. Review argument shapes after migration: `beforeExport` uses `siblingData` (not `row`) and `data` is the top-level document (previously `doc`).
+- `migrate-db-types-subpath`: rewrites imports from the removed `/types` subpath exports of `@payloadcms/drizzle`, `@payloadcms/db-postgres`, `@payloadcms/db-sqlite`, `@payloadcms/db-vercel-postgres`, and `@payloadcms/db-d1-sqlite` to their main entry points. Also handles re-export declarations and `declare module` augmentations.
+- `migrate-next-subpath-exports`: rewrites imports, re-exports, and string-literal component paths from the removed `@payloadcms/next/client`, `@payloadcms/next/rsc`, and `@payloadcms/next/templates` subpaths to their canonical `@payloadcms/ui` or `@payloadcms/ui/rsc` sources. After running, regenerate the import map with `payload generate:importmap`.
+- `migrate-next-generate-viewport-export`: adds a `generateViewport` export to app router layout files that already use Payload's shared Next.js layout, preserving Next.js viewport behavior without touching custom viewport implementations.
+- `migrate-after-operation-read`: rewrites `operation === 'read'` checks inside collection `afterOperation` hooks to handle the `find` and `findByID` operations (the deprecated `'read'` value was removed). Handles `===`/`!==`/`==`/`!=` against a destructured (or aliased) or property-accessed `operation` argument. Leaves `beforeOperation` (which still uses `'read'`) untouched, and surfaces notes for non-inline hooks and `switch` statements that need manual review.
+- `migrate-versions-default`: adds `versions: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have a `versions` property. Preserves the previous opt-in behaviour now that `versions` defaults to `true` for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
+- `migrate-authorship-default`: adds `authorship: false` to every `CollectionConfig` or `GlobalConfig` object that does not already have an `authorship` property. Preserves the previous behaviour now that authorship tracking (`createdBy` / `updatedBy`) is enabled by default for both collections and globals. Detects the three common annotation forms: `: CollectionConfig`, `satisfies GlobalConfig`, and `as CollectionConfig`.
+- `remove-versions-true`: removes the now-redundant `versions: true` property from `CollectionConfig` and `GlobalConfig` objects. Only removes the bare boolean `true`; object-form configs (e.g. `versions: { drafts: true }`) are left untouched.
+- `add-override-access-true`: adds an explicit `overrideAccess: true` to Local API calls (`payload.find(...)`, `req.payload.create(...)`, `payload.jobs.run()`, and the rest) that omit it, preserving the Payload 3 default of skipping access control now that Payload 4 changes the default to `false`. Detection is syntactic so it works on JavaScript projects with no `tsconfig.json`. Deliberately never touches internal operations such as `findOperation(...)`, where a missing value meant `false` and inserting `true` would disable access control. Skips `resetPassword` (no destructuring default to preserve), calls whose argument object contains a spread, and non-Payload receivers. Review each inserted `true` and switch to `false` wherever the operation acts on behalf of a user.
+- `remove-group-by-true`: removes `admin.groupBy` from `CollectionConfig` objects. The experimental `groupBy` flag has been removed; groupBy is now an always-available per-user UI preference.
+- `remove-default-locale-publish-option`: removes `localization.defaultLocalePublishOption` from Payload configs. The Admin UI Publish button now always defaults to publishing the active locale when localized fields exist, with "Publish all locales" available as a secondary dropdown option. Surfaces a note when the removed value was `'all'`, since that combination previously changed the default and now has no config equivalent.
+- `remove-localize-status-config`: removes `localizeStatus: true` from `versions.drafts` objects and `experimental.localizeStatus: true` from the root Payload config. Per-locale status is now automatic when localization is configured and localized fields exist; an explicit `localizeStatus: false` opt-out is preserved.
+- `remove-publish-specific-locale`: removes `publishSpecificLocale` from `payload.update()` and `payload.updateGlobal()` call-site options. If the options object lacks a `locale` the property is renamed to `locale` so the same value is preserved; otherwise it is dropped.
+- `rename-typescript-schema-to-json-schema`: renames the `typescriptSchema` field-config property to `jsonSchema` (it always accepted JSON Schema, not TypeScript). Skips any object that already defines a `jsonSchema` sibling and surfaces it as a note for manual review.
+- `migrate-build-script`: rewrites the `build` npm script in `package.json` from `next build` to `payload build`, so the Import Map (and types) are generated before the Next.js build. Matches the `next build` invocation only (leaves `next build-storybook` and the like untouched) and is a no-op when `build` is already `payload build`.
+- `migrate-slug-field`: converts the removed experimental `slugField()` helper (imported from `payload`) into the native `{ type: 'slug' }` field, mapping `useAsSlug`/`fieldToUse`, `slugify`, `required`, `localized`, `disableUnique` (→ `unique: false`), and `position` (→ `admin.position`), and dropping the obsolete `checkboxName`. Removes the now-unused `slugField` import. Calls using `overrides` (or other unrecognized options) are left in place with a note for manual migration.
+- `rename-experimental-table-feature`: renames imports of `EXPERIMENTAL_TableFeature` from `@payloadcms/richtext-lexical` to `TableFeature` (the table feature is now stable) and updates all local usages, e.g. `EXPERIMENTAL_TableFeature()` call sites.
 
 ## Contributing
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAmBA,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFhF"}

package/dist/cli.js

@@ -1,12 +1,51 @@
-/* eslint-disable no-console */ import { existsSync, writeFileSync } from 'node:fs';
+/* eslint-disable no-console */ import { writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { IndentationText, Project, QuoteKind } from 'ts-morph';
 import { parseFlags } from './cli.parseFlags.js';
 import { transforms as registry } from './registry.js';
 import { runTransforms } from './runner.js';
+import { runDispatch } from './upgrade/dispatch.js';
+import { runUpgrade } from './upgrade/index.js';
+import { renderUpgradePrompt } from './upgrade/prompt.js';
+import { resolveSelfCommand } from './upgrade/selfCommand.js';
 import { loadPackageJsons, serializePackageJson } from './utils/packageJson.js';
+import { loadProject } from './utils/project.js';
 export async function main(argv = process.argv.slice(2)) {
     const flags = parseFlags(argv);
+    if (flags.command === 'upgrade') {
+        if (flags.upgrade === 'prompt') {
+            console.log(renderUpgradePrompt({
+                command: resolveSelfCommand()
+            }));
+            return;
+        }
+        if (flags.upgrade === 'run') {
+            const { failed } = await runUpgrade({
+                flags: {
+                    dry: flags.dry,
+                    force: flags.force,
+                    tag: flags.tag
+                },
+                path: flags.path
+            });
+            if (failed) {
+                process.exitCode = 1;
+            }
+            return;
+        }
+        const { failed } = await runDispatch({
+            agentFlag: flags.agent,
+            path: flags.path,
+            upgradeFlags: {
+                dry: flags.dry,
+                force: flags.force,
+                tag: flags.tag
+            }
+        });
+        if (failed) {
+            process.exitCode = 1;
+        }
+        return;
+    }
     if (flags.list) {
         printList();
         return;
@@ -71,31 +110,6 @@ function printList() {
         console.log(`${t.name}  ${t.description}`);
     }
 }
-function loadProject(path) {
-    const manipulationSettings = {
-        indentationText: IndentationText.TwoSpaces,
-        quoteKind: QuoteKind.Single,
-        useTrailingCommas: true
-    };
-    const tsconfigPath = resolve(path, 'tsconfig.json');
-    if (existsSync(tsconfigPath)) {
-        return new Project({
-            manipulationSettings,
-            tsConfigFilePath: tsconfigPath
-        });
-    }
-    const project = new Project({
-        manipulationSettings
-    });
-    project.addSourceFilesAtPaths([
-        `${path}/**/*.{ts,tsx,js,jsx}`,
-        '!**/node_modules/**',
-        '!**/dist/**',
-        '!**/.next/**',
-        '!**/build/**'
-    ]);
-    return project;
-}
 function snapshotProject(project) {
     return new Map(project.getSourceFiles().map((file)=>[
             file.getFilePath(),

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport { existsSync, writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { IndentationText, Project, QuoteKind } from 'ts-morph'\n\nimport type { TransformRunResult } from './runner.js'\nimport type { Transform } from './types.js'\n\nimport { parseFlags } from './cli.parseFlags.js'\nimport { transforms as registry } from './registry.js'\nimport { runTransforms } from './runner.js'\nimport { loadPackageJsons, serializePackageJson } from './utils/packageJson.js'\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const flags = parseFlags(argv)\n\n  if (flags.list) {\n    printList()\n    return\n  }\n\n  const selected = selectTransforms(registry, flags.transform)\n  if (selected.length === 0) {\n    console.error(`No transforms matched${flags.transform ? ` \"${flags.transform}\"` : ''}.`)\n    process.exitCode = 1\n    return\n  }\n\n  const project = loadProject(resolve(flags.path))\n  const snapshot = snapshotProject(project)\n\n  const packageJsons = loadPackageJsons(resolve(flags.path))\n\n  const { failed, results } = await runTransforms({\n    // Shares the same `data` reference, so transform mutations are visible\n    // below for change detection (do not clone here).\n    packageJsons: packageJsons.map(({ data, path }) => ({ data, path })),\n    project,\n    transforms: selected,\n  })\n\n  const changed = project\n    .getSourceFiles()\n    .filter((file) => snapshot.get(file.getFilePath()) !== file.getFullText())\n\n  const changedPackageJsons = packageJsons.filter(\n    (pkg) => serializePackageJson(pkg.data, pkg.originalText) !== pkg.originalText,\n  )\n\n  if (flags.print) {\n    if (changed.length === 0 && changedPackageJsons.length === 0) {\n      console.log('(no files changed)')\n    } else {\n      for (const file of changed) {\n        console.log(`// ${file.getFilePath()}`)\n        console.log(file.getFullText())\n      }\n      for (const pkg of changedPackageJsons) {\n        console.log(`// ${pkg.path}`)\n        console.log(serializePackageJson(pkg.data, pkg.originalText))\n      }\n    }\n  } else if (!flags.dry) {\n    await Promise.all(changed.map((file) => file.save()))\n    for (const pkg of changedPackageJsons) {\n      writeFileSync(pkg.path, serializePackageJson(pkg.data, pkg.originalText))\n    }\n  }\n\n  printSummary(results)\n\n  if (failed) {\n    process.exitCode = 1\n  }\n}\n\nfunction selectTransforms(available: Transform[], name: string | undefined): Transform[] {\n  if (!name) {\n    return available\n  }\n  return available.filter((t) => t.name === name)\n}\n\nfunction printList(): void {\n  if (registry.length === 0) {\n    console.log('No transforms registered.')\n    return\n  }\n  for (const t of registry) {\n    console.log(`${t.name}  ${t.description}`)\n  }\n}\n\nfunction loadProject(path: string): Project {\n  const manipulationSettings = {\n    indentationText: IndentationText.TwoSpaces,\n    quoteKind: QuoteKind.Single,\n    useTrailingCommas: true,\n  }\n  const tsconfigPath = resolve(path, 'tsconfig.json')\n  if (existsSync(tsconfigPath)) {\n    return new Project({ manipulationSettings, tsConfigFilePath: tsconfigPath })\n  }\n  const project = new Project({ manipulationSettings })\n  project.addSourceFilesAtPaths([\n    `${path}/**/*.{ts,tsx,js,jsx}`,\n    '!**/node_modules/**',\n    '!**/dist/**',\n    '!**/.next/**',\n    '!**/build/**',\n  ])\n  return project\n}\n\nfunction snapshotProject(project: Project): Map<string, string> {\n  return new Map(project.getSourceFiles().map((file) => [file.getFilePath(), file.getFullText()]))\n}\n\nfunction printSummary(results: TransformRunResult[]): void {\n  console.log('')\n  console.log('Codemod summary:')\n  for (const r of results) {\n    if (r.error) {\n      console.log(`  [FAIL] ${r.name} — ${r.error.message}`)\n      continue\n    }\n    console.log(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`)\n    for (const note of r.notes ?? []) {\n      console.log(`      note: ${note}`)\n    }\n  }\n}\n"],"names":["existsSync","writeFileSync","resolve","IndentationText","Project","QuoteKind","parseFlags","transforms","registry","runTransforms","loadPackageJsons","serializePackageJson","main","argv","process","slice","flags","list","printList","selected","selectTransforms","transform","length","console","error","exitCode","project","loadProject","path","snapshot","snapshotProject","packageJsons","failed","results","map","data","changed","getSourceFiles","filter","file","get","getFilePath","getFullText","changedPackageJsons","pkg","originalText","print","log","dry","Promise","all","save","printSummary","available","name","t","description","manipulationSettings","indentationText","TwoSpaces","quoteKind","Single","useTrailingCommas","tsconfigPath","tsConfigFilePath","addSourceFilesAtPaths","Map","r","message","filesChanged","note","notes"],"mappings":"AAAA,6BAA6B,GAC7B,SAASA,UAAU,EAAEC,aAAa,QAAQ,UAAS;AACnD,SAASC,OAAO,QAAQ,YAAW;AACnC,SAASC,eAAe,EAAEC,OAAO,EAAEC,SAAS,QAAQ,WAAU;AAK9D,SAASC,UAAU,QAAQ,sBAAqB;AAChD,SAASC,cAAcC,QAAQ,QAAQ,gBAAe;AACtD,SAASC,aAAa,QAAQ,cAAa;AAC3C,SAASC,gBAAgB,EAAEC,oBAAoB,QAAQ,yBAAwB;AAE/E,OAAO,eAAeC,KAAKC,OAAiBC,QAAQD,IAAI,CAACE,KAAK,CAAC,EAAE;IAC/D,MAAMC,QAAQV,WAAWO;IAEzB,IAAIG,MAAMC,IAAI,EAAE;QACdC;QACA;IACF;IAEA,MAAMC,WAAWC,iBAAiBZ,UAAUQ,MAAMK,SAAS;IAC3D,IAAIF,SAASG,MAAM,KAAK,GAAG;QACzBC,QAAQC,KAAK,CAAC,CAAC,qBAAqB,EAAER,MAAMK,SAAS,GAAG,CAAC,EAAE,EAAEL,MAAMK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACvFP,QAAQW,QAAQ,GAAG;QACnB;IACF;IAEA,MAAMC,UAAUC,YAAYzB,QAAQc,MAAMY,IAAI;IAC9C,MAAMC,WAAWC,gBAAgBJ;IAEjC,MAAMK,eAAerB,iBAAiBR,QAAQc,MAAMY,IAAI;IAExD,MAAM,EAAEI,MAAM,EAAEC,OAAO,EAAE,GAAG,MAAMxB,cAAc;QAC9C,uEAAuE;QACvE,kDAAkD;QAClDsB,cAAcA,aAAaG,GAAG,CAAC,CAAC,EAAEC,IAAI,EAAEP,IAAI,EAAE,GAAM,CAAA;gBAAEO;gBAAMP;YAAK,CAAA;QACjEF;QACAnB,YAAYY;IACd;IAEA,MAAMiB,UAAUV,QACbW,cAAc,GACdC,MAAM,CAAC,CAACC,OAASV,SAASW,GAAG,CAACD,KAAKE,WAAW,QAAQF,KAAKG,WAAW;IAEzE,MAAMC,sBAAsBZ,aAAaO,MAAM,CAC7C,CAACM,MAAQjC,qBAAqBiC,IAAIT,IAAI,EAAES,IAAIC,YAAY,MAAMD,IAAIC,YAAY;IAGhF,IAAI7B,MAAM8B,KAAK,EAAE;QACf,IAAIV,QAAQd,MAAM,KAAK,KAAKqB,oBAAoBrB,MAAM,KAAK,GAAG;YAC5DC,QAAQwB,GAAG,CAAC;QACd,OAAO;YACL,KAAK,MAAMR,QAAQH,QAAS;gBAC1Bb,QAAQwB,GAAG,CAAC,CAAC,GAAG,EAAER,KAAKE,WAAW,IAAI;gBACtClB,QAAQwB,GAAG,CAACR,KAAKG,WAAW;YAC9B;YACA,KAAK,MAAME,OAAOD,oBAAqB;gBACrCpB,QAAQwB,GAAG,CAAC,CAAC,GAAG,EAAEH,IAAIhB,IAAI,EAAE;gBAC5BL,QAAQwB,GAAG,CAACpC,qBAAqBiC,IAAIT,IAAI,EAAES,IAAIC,YAAY;YAC7D;QACF;IACF,OAAO,IAAI,CAAC7B,MAAMgC,GAAG,EAAE;QACrB,MAAMC,QAAQC,GAAG,CAACd,QAAQF,GAAG,CAAC,CAACK,OAASA,KAAKY,IAAI;QACjD,KAAK,MAAMP,OAAOD,oBAAqB;YACrC1C,cAAc2C,IAAIhB,IAAI,EAAEjB,qBAAqBiC,IAAIT,IAAI,EAAES,IAAIC,YAAY;QACzE;IACF;IAEAO,aAAanB;IAEb,IAAID,QAAQ;QACVlB,QAAQW,QAAQ,GAAG;IACrB;AACF;AAEA,SAASL,iBAAiBiC,SAAsB,EAAEC,IAAwB;IACxE,IAAI,CAACA,MAAM;QACT,OAAOD;IACT;IACA,OAAOA,UAAUf,MAAM,CAAC,CAACiB,IAAMA,EAAED,IAAI,KAAKA;AAC5C;AAEA,SAASpC;IACP,IAAIV,SAASc,MAAM,KAAK,GAAG;QACzBC,QAAQwB,GAAG,CAAC;QACZ;IACF;IACA,KAAK,MAAMQ,KAAK/C,SAAU;QACxBe,QAAQwB,GAAG,CAAC,GAAGQ,EAAED,IAAI,CAAC,EAAE,EAAEC,EAAEC,WAAW,EAAE;IAC3C;AACF;AAEA,SAAS7B,YAAYC,IAAY;IAC/B,MAAM6B,uBAAuB;QAC3BC,iBAAiBvD,gBAAgBwD,SAAS;QAC1CC,WAAWvD,UAAUwD,MAAM;QAC3BC,mBAAmB;IACrB;IACA,MAAMC,eAAe7D,QAAQ0B,MAAM;IACnC,IAAI5B,WAAW+D,eAAe;QAC5B,OAAO,IAAI3D,QAAQ;YAAEqD;YAAsBO,kBAAkBD;QAAa;IAC5E;IACA,MAAMrC,UAAU,IAAItB,QAAQ;QAAEqD;IAAqB;IACnD/B,QAAQuC,qBAAqB,CAAC;QAC5B,GAAGrC,KAAK,qBAAqB,CAAC;QAC9B;QACA;QACA;QACA;KACD;IACD,OAAOF;AACT;AAEA,SAASI,gBAAgBJ,OAAgB;IACvC,OAAO,IAAIwC,IAAIxC,QAAQW,cAAc,GAAGH,GAAG,CAAC,CAACK,OAAS;YAACA,KAAKE,WAAW;YAAIF,KAAKG,WAAW;SAAG;AAChG;AAEA,SAASU,aAAanB,OAA6B;IACjDV,QAAQwB,GAAG,CAAC;IACZxB,QAAQwB,GAAG,CAAC;IACZ,KAAK,MAAMoB,KAAKlC,QAAS;QACvB,IAAIkC,EAAE3C,KAAK,EAAE;YACXD,QAAQwB,GAAG,CAAC,CAAC,SAAS,EAAEoB,EAAEb,IAAI,CAAC,GAAG,EAAEa,EAAE3C,KAAK,CAAC4C,OAAO,EAAE;YACrD;QACF;QACA7C,QAAQwB,GAAG,CAAC,CAAC,OAAO,EAAEoB,EAAEb,IAAI,CAAC,GAAG,EAAEa,EAAEE,YAAY,CAAC/C,MAAM,CAAC,gBAAgB,CAAC;QACzE,KAAK,MAAMgD,QAAQH,EAAEI,KAAK,IAAI,EAAE,CAAE;YAChChD,QAAQwB,GAAG,CAAC,CAAC,YAAY,EAAEuB,MAAM;QACnC;IACF;AACF"}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import type { Project } from 'ts-morph'\n\n/* eslint-disable no-console */\nimport { writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport type { TransformRunResult } from './runner.js'\nimport type { Transform } from './types.js'\n\nimport { parseFlags } from './cli.parseFlags.js'\nimport { transforms as registry } from './registry.js'\nimport { runTransforms } from './runner.js'\nimport { runDispatch } from './upgrade/dispatch.js'\nimport { runUpgrade } from './upgrade/index.js'\nimport { renderUpgradePrompt } from './upgrade/prompt.js'\nimport { resolveSelfCommand } from './upgrade/selfCommand.js'\nimport { loadPackageJsons, serializePackageJson } from './utils/packageJson.js'\nimport { loadProject } from './utils/project.js'\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<void> {\n  const flags = parseFlags(argv)\n\n  if (flags.command === 'upgrade') {\n    if (flags.upgrade === 'prompt') {\n      console.log(renderUpgradePrompt({ command: resolveSelfCommand() }))\n      return\n    }\n\n    if (flags.upgrade === 'run') {\n      const { failed } = await runUpgrade({\n        flags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n        path: flags.path,\n      })\n      if (failed) {\n        process.exitCode = 1\n      }\n      return\n    }\n\n    const { failed } = await runDispatch({\n      agentFlag: flags.agent,\n      path: flags.path,\n      upgradeFlags: { dry: flags.dry, force: flags.force, tag: flags.tag },\n    })\n    if (failed) {\n      process.exitCode = 1\n    }\n    return\n  }\n\n  if (flags.list) {\n    printList()\n    return\n  }\n\n  const selected = selectTransforms(registry, flags.transform)\n  if (selected.length === 0) {\n    console.error(`No transforms matched${flags.transform ? ` \"${flags.transform}\"` : ''}.`)\n    process.exitCode = 1\n    return\n  }\n\n  const project = loadProject(resolve(flags.path))\n  const snapshot = snapshotProject(project)\n\n  const packageJsons = loadPackageJsons(resolve(flags.path))\n\n  const { failed, results } = await runTransforms({\n    // Shares the same `data` reference, so transform mutations are visible\n    // below for change detection (do not clone here).\n    packageJsons: packageJsons.map(({ data, path }) => ({ data, path })),\n    project,\n    transforms: selected,\n  })\n\n  const changed = project\n    .getSourceFiles()\n    .filter((file) => snapshot.get(file.getFilePath()) !== file.getFullText())\n\n  const changedPackageJsons = packageJsons.filter(\n    (pkg) => serializePackageJson(pkg.data, pkg.originalText) !== pkg.originalText,\n  )\n\n  if (flags.print) {\n    if (changed.length === 0 && changedPackageJsons.length === 0) {\n      console.log('(no files changed)')\n    } else {\n      for (const file of changed) {\n        console.log(`// ${file.getFilePath()}`)\n        console.log(file.getFullText())\n      }\n      for (const pkg of changedPackageJsons) {\n        console.log(`// ${pkg.path}`)\n        console.log(serializePackageJson(pkg.data, pkg.originalText))\n      }\n    }\n  } else if (!flags.dry) {\n    await Promise.all(changed.map((file) => file.save()))\n    for (const pkg of changedPackageJsons) {\n      writeFileSync(pkg.path, serializePackageJson(pkg.data, pkg.originalText))\n    }\n  }\n\n  printSummary(results)\n\n  if (failed) {\n    process.exitCode = 1\n  }\n}\n\nfunction selectTransforms(available: Transform[], name: string | undefined): Transform[] {\n  if (!name) {\n    return available\n  }\n  return available.filter((t) => t.name === name)\n}\n\nfunction printList(): void {\n  if (registry.length === 0) {\n    console.log('No transforms registered.')\n    return\n  }\n  for (const t of registry) {\n    console.log(`${t.name}  ${t.description}`)\n  }\n}\n\nfunction snapshotProject(project: Project): Map<string, string> {\n  return new Map(project.getSourceFiles().map((file) => [file.getFilePath(), file.getFullText()]))\n}\n\nfunction printSummary(results: TransformRunResult[]): void {\n  console.log('')\n  console.log('Codemod summary:')\n  for (const r of results) {\n    if (r.error) {\n      console.log(`  [FAIL] ${r.name} — ${r.error.message}`)\n      continue\n    }\n    console.log(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`)\n    for (const note of r.notes ?? []) {\n      console.log(`      note: ${note}`)\n    }\n  }\n}\n"],"names":["writeFileSync","resolve","parseFlags","transforms","registry","runTransforms","runDispatch","runUpgrade","renderUpgradePrompt","resolveSelfCommand","loadPackageJsons","serializePackageJson","loadProject","main","argv","process","slice","flags","command","upgrade","console","log","failed","dry","force","tag","path","exitCode","agentFlag","agent","upgradeFlags","list","printList","selected","selectTransforms","transform","length","error","project","snapshot","snapshotProject","packageJsons","results","map","data","changed","getSourceFiles","filter","file","get","getFilePath","getFullText","changedPackageJsons","pkg","originalText","print","Promise","all","save","printSummary","available","name","t","description","Map","r","message","filesChanged","note","notes"],"mappings":"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"}

package/dist/cli.parseFlags.d.ts

@@ -1,9 +1,23 @@
+export type CliCommand = 'upgrade';
+/**
+ * The three `upgrade` verbs:
+ * - `dispatch` (bare `upgrade`): interactive picker to hand the orchestration
+ *   prompt to a coding agent, or print it.
+ * - `run` (`upgrade run`): the deterministic mechanical slice.
+ * - `prompt` (`upgrade prompt`): print the orchestration prompt to stdout.
+ */
+export type UpgradeSubcommand = 'dispatch' | 'prompt' | 'run';
 export type CliFlags = {
+    agent?: string;
+    command?: CliCommand;
     dry: boolean;
+    force: boolean;
     list: boolean;
     path: string;
     print: boolean;
+    tag?: string;
     transform?: string;
+    upgrade?: UpgradeSubcommand;
 };
 export declare function parseFlags(argv: string[]): CliFlags;
 //# sourceMappingURL=cli.parseFlags.d.ts.map

package/dist/cli.parseFlags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.parseFlags.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAoBnD"}
+{"version":3,"file":"cli.parseFlags.d.ts","sourceRoot":"","sources":["../src/cli.parseFlags.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE7D,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAA;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAmCnD"}

package/dist/cli.parseFlags.js

@@ -4,6 +4,9 @@ export function parseFlags(argv) {
         allowPositionals: true,
         args: argv,
         options: {
+            agent: {
+                type: 'string'
+            },
             dry: {
                 type: 'boolean',
                 default: false
@@ -12,6 +15,10 @@ export function parseFlags(argv) {
                 type: 'boolean',
                 default: false
             },
+            force: {
+                type: 'boolean',
+                default: false
+            },
             list: {
                 type: 'boolean',
                 default: false
@@ -20,18 +27,38 @@ export function parseFlags(argv) {
                 type: 'boolean',
                 default: false
             },
+            tag: {
+                type: 'string'
+            },
             transform: {
                 type: 'string'
             }
         }
     });
+    const isUpgrade = positionals[0] === 'upgrade';
+    const command = isUpgrade ? 'upgrade' : undefined;
+    const upgrade = isUpgrade ? resolveUpgradeVerb(positionals[1]) : undefined;
+    // The upgrade command always operates on the current directory; only the bare
+    // transform command takes a positional path.
+    const path = isUpgrade ? process.cwd() : positionals[0] ?? process.cwd();
     return {
+        agent: values.agent,
+        command,
         dry: Boolean(values.dry) || Boolean(values['dry-run']),
+        force: Boolean(values.force),
         list: Boolean(values.list),
-        path: positionals[0] ?? process.cwd(),
+        path,
         print: Boolean(values.print),
-        transform: values.transform
+        tag: values.tag,
+        transform: values.transform,
+        upgrade
     };
 }
+function resolveUpgradeVerb(verb) {
+    if (verb === 'prompt' || verb === 'run') {
+        return verb;
+    }
+    return 'dispatch';
+}
 
 //# sourceMappingURL=cli.parseFlags.js.map

package/dist/cli.parseFlags.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.parseFlags.ts"],"sourcesContent":["import { parseArgs } from 'node:util'\n\nexport type CliFlags = {\n  dry: boolean\n  list: boolean\n  path: string\n  print: boolean\n  transform?: string\n}\n\nexport function parseFlags(argv: string[]): CliFlags {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    args: argv,\n    options: {\n      dry: { type: 'boolean', default: false },\n      'dry-run': { type: 'boolean', default: false },\n      list: { type: 'boolean', default: false },\n      print: { type: 'boolean', default: false },\n      transform: { type: 'string' },\n    },\n  })\n\n  return {\n    dry: Boolean(values.dry) || Boolean(values['dry-run']),\n    list: Boolean(values.list),\n    path: positionals[0] ?? process.cwd(),\n    print: Boolean(values.print),\n    transform: values.transform,\n  }\n}\n"],"names":["parseArgs","parseFlags","argv","positionals","values","allowPositionals","args","options","dry","type","default","list","print","transform","Boolean","path","process","cwd"],"mappings":"AAAA,SAASA,SAAS,QAAQ,YAAW;AAUrC,OAAO,SAASC,WAAWC,IAAc;IACvC,MAAM,EAAEC,WAAW,EAAEC,MAAM,EAAE,GAAGJ,UAAU;QACxCK,kBAAkB;QAClBC,MAAMJ;QACNK,SAAS;YACPC,KAAK;gBAAEC,MAAM;gBAAWC,SAAS;YAAM;YACvC,WAAW;gBAAED,MAAM;gBAAWC,SAAS;YAAM;YAC7CC,MAAM;gBAAEF,MAAM;gBAAWC,SAAS;YAAM;YACxCE,OAAO;gBAAEH,MAAM;gBAAWC,SAAS;YAAM;YACzCG,WAAW;gBAAEJ,MAAM;YAAS;QAC9B;IACF;IAEA,OAAO;QACLD,KAAKM,QAAQV,OAAOI,GAAG,KAAKM,QAAQV,MAAM,CAAC,UAAU;QACrDO,MAAMG,QAAQV,OAAOO,IAAI;QACzBI,MAAMZ,WAAW,CAAC,EAAE,IAAIa,QAAQC,GAAG;QACnCL,OAAOE,QAAQV,OAAOQ,KAAK;QAC3BC,WAAWT,OAAOS,SAAS;IAC7B;AACF"}
+{"version":3,"sources":["../src/cli.parseFlags.ts"],"sourcesContent":["import { parseArgs } from 'node:util'\n\nexport type CliCommand = 'upgrade'\n\n/**\n * The three `upgrade` verbs:\n * - `dispatch` (bare `upgrade`): interactive picker to hand the orchestration\n *   prompt to a coding agent, or print it.\n * - `run` (`upgrade run`): the deterministic mechanical slice.\n * - `prompt` (`upgrade prompt`): print the orchestration prompt to stdout.\n */\nexport type UpgradeSubcommand = 'dispatch' | 'prompt' | 'run'\n\nexport type CliFlags = {\n  agent?: string\n  command?: CliCommand\n  dry: boolean\n  force: boolean\n  list: boolean\n  path: string\n  print: boolean\n  tag?: string\n  transform?: string\n  upgrade?: UpgradeSubcommand\n}\n\nexport function parseFlags(argv: string[]): CliFlags {\n  const { positionals, values } = parseArgs({\n    allowPositionals: true,\n    args: argv,\n    options: {\n      agent: { type: 'string' },\n      dry: { type: 'boolean', default: false },\n      'dry-run': { type: 'boolean', default: false },\n      force: { type: 'boolean', default: false },\n      list: { type: 'boolean', default: false },\n      print: { type: 'boolean', default: false },\n      tag: { type: 'string' },\n      transform: { type: 'string' },\n    },\n  })\n\n  const isUpgrade = positionals[0] === 'upgrade'\n  const command = isUpgrade ? 'upgrade' : undefined\n  const upgrade = isUpgrade ? resolveUpgradeVerb(positionals[1]) : undefined\n  // The upgrade command always operates on the current directory; only the bare\n  // transform command takes a positional path.\n  const path = isUpgrade ? process.cwd() : (positionals[0] ?? process.cwd())\n\n  return {\n    agent: values.agent,\n    command,\n    dry: Boolean(values.dry) || Boolean(values['dry-run']),\n    force: Boolean(values.force),\n    list: Boolean(values.list),\n    path,\n    print: Boolean(values.print),\n    tag: values.tag,\n    transform: values.transform,\n    upgrade,\n  }\n}\n\nfunction resolveUpgradeVerb(verb: string | undefined): UpgradeSubcommand {\n  if (verb === 'prompt' || verb === 'run') {\n    return verb\n  }\n  return 'dispatch'\n}\n"],"names":["parseArgs","parseFlags","argv","positionals","values","allowPositionals","args","options","agent","type","dry","default","force","list","print","tag","transform","isUpgrade","command","undefined","upgrade","resolveUpgradeVerb","path","process","cwd","Boolean","verb"],"mappings":"AAAA,SAASA,SAAS,QAAQ,YAAW;AA0BrC,OAAO,SAASC,WAAWC,IAAc;IACvC,MAAM,EAAEC,WAAW,EAAEC,MAAM,EAAE,GAAGJ,UAAU;QACxCK,kBAAkB;QAClBC,MAAMJ;QACNK,SAAS;YACPC,OAAO;gBAAEC,MAAM;YAAS;YACxBC,KAAK;gBAAED,MAAM;gBAAWE,SAAS;YAAM;YACvC,WAAW;gBAAEF,MAAM;gBAAWE,SAAS;YAAM;YAC7CC,OAAO;gBAAEH,MAAM;gBAAWE,SAAS;YAAM;YACzCE,MAAM;gBAAEJ,MAAM;gBAAWE,SAAS;YAAM;YACxCG,OAAO;gBAAEL,MAAM;gBAAWE,SAAS;YAAM;YACzCI,KAAK;gBAAEN,MAAM;YAAS;YACtBO,WAAW;gBAAEP,MAAM;YAAS;QAC9B;IACF;IAEA,MAAMQ,YAAYd,WAAW,CAAC,EAAE,KAAK;IACrC,MAAMe,UAAUD,YAAY,YAAYE;IACxC,MAAMC,UAAUH,YAAYI,mBAAmBlB,WAAW,CAAC,EAAE,IAAIgB;IACjE,8EAA8E;IAC9E,6CAA6C;IAC7C,MAAMG,OAAOL,YAAYM,QAAQC,GAAG,KAAMrB,WAAW,CAAC,EAAE,IAAIoB,QAAQC,GAAG;IAEvE,OAAO;QACLhB,OAAOJ,OAAOI,KAAK;QACnBU;QACAR,KAAKe,QAAQrB,OAAOM,GAAG,KAAKe,QAAQrB,MAAM,CAAC,UAAU;QACrDQ,OAAOa,QAAQrB,OAAOQ,KAAK;QAC3BC,MAAMY,QAAQrB,OAAOS,IAAI;QACzBS;QACAR,OAAOW,QAAQrB,OAAOU,KAAK;QAC3BC,KAAKX,OAAOW,GAAG;QACfC,WAAWZ,OAAOY,SAAS;QAC3BI;IACF;AACF;AAEA,SAASC,mBAAmBK,IAAwB;IAClD,IAAIA,SAAS,YAAYA,SAAS,OAAO;QACvC,OAAOA;IACT;IACA,OAAO;AACT"}

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA6B3C,eAAO,MAAM,UAAU,EAAE,SAAS,EA2BjC,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAoC3C,eAAO,MAAM,UAAU,EAAE,SAAS,EAkCjC,CAAA"}

package/dist/registry.js

@@ -1,38 +1,48 @@
+import { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js';
 import { exampleNoop } from './transforms/example-noop/index.js';
 import { globalsComponentsEdit } from './transforms/globals-components-edit/index.js';
 import { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js';
 import { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js';
+import { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js';
 import { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js';
 import { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js';
 import { migrateBuildScript } from './transforms/migrate-build-script/index.js';
 import { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js';
 import { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js';
 import { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js';
+import { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js';
 import { migrateForceSelect } from './transforms/migrate-force-select/index.js';
 import { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js';
 import { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js';
 import { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js';
 import { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js';
 import { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js';
+import { migratePayloadRequestCreation } from './transforms/migrate-payload-request-creation/index.js';
 import { migrateSlugField } from './transforms/migrate-slug-field/index.js';
 import { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js';
 import { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js';
+import { removeDefaultLocalePublishOption } from './transforms/remove-default-locale-publish-option/index.js';
 import { removeGroupByTrue } from './transforms/remove-group-by-true/index.js';
 import { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js';
 import { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js';
+import { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js';
+import { removeStrictDraftTypes } from './transforms/remove-strict-draft-types/index.js';
 import { removeVersionsTrue } from './transforms/remove-versions-true/index.js';
 import { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js';
 import { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js';
 import { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js';
 export const transforms = [
     exampleNoop,
+    addOverrideAccessTrue,
     migrateAfterOperationRead,
     migrateHideAPIURL,
     globalsComponentsEdit,
     migrateListViewSelectAPI,
     migrateDisabledFields,
     migrateForceSelect,
+    migrateFieldComponentTypes,
     migrateAliasedExports,
+    migratePayloadRequestCreation,
     migrateBlockReferencesToBlocks,
     migrateBuildScript,
     migrateDocumentTitleContext,
@@ -45,10 +55,14 @@ export const transforms = [
     migrateNextSubpathExports,
     migrateSlugField,
     migrateVersionsDefault,
+    migrateAuthorshipDefault,
+    removeDefaultLocalePublishOption,
     removeGroupByTrue,
     removeLocalizeStatusConfig,
     removeVersionsTrue,
     removePublishSpecificLocale,
+    removeStorageAlwaysInsertFields,
+    removeStrictDraftTypes,
     renameTypescriptSchemaToJsonSchema,
     renameExperimentalTableFeature
 ];

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/registry.ts"],"sourcesContent":["import type { Transform } from './types.js'\n\nimport { exampleNoop } from './transforms/example-noop/index.js'\nimport { globalsComponentsEdit } from './transforms/globals-components-edit/index.js'\nimport { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js'\nimport { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js'\nimport { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js'\nimport { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js'\nimport { migrateBuildScript } from './transforms/migrate-build-script/index.js'\nimport { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js'\nimport { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js'\nimport { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js'\nimport { migrateForceSelect } from './transforms/migrate-force-select/index.js'\nimport { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js'\nimport { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js'\nimport { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js'\nimport { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js'\nimport { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js'\nimport { migrateSlugField } from './transforms/migrate-slug-field/index.js'\nimport { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js'\nimport { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js'\nimport { removeGroupByTrue } from './transforms/remove-group-by-true/index.js'\nimport { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js'\nimport { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js'\nimport { removeVersionsTrue } from './transforms/remove-versions-true/index.js'\nimport { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js'\nimport { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js'\nimport { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js'\n\nexport const transforms: Transform[] = [\n  exampleNoop,\n  migrateAfterOperationRead,\n  migrateHideAPIURL,\n  globalsComponentsEdit,\n  migrateListViewSelectAPI,\n  migrateDisabledFields,\n  migrateForceSelect,\n  migrateAliasedExports,\n  migrateBlockReferencesToBlocks,\n  migrateBuildScript,\n  migrateDocumentTitleContext,\n  migrateStorageAdaptersToConfig,\n  migrateAzureChunkLargeFiles,\n  renameStorageAdaptersToStorage,\n  migrateImportExportHooks,\n  migrateDbTypesSubpath,\n  migrateNextGenerateViewportExport,\n  migrateNextSubpathExports,\n  migrateSlugField,\n  migrateVersionsDefault,\n  removeGroupByTrue,\n  removeLocalizeStatusConfig,\n  removeVersionsTrue,\n  removePublishSpecificLocale,\n  renameTypescriptSchemaToJsonSchema,\n  renameExperimentalTableFeature,\n]\n"],"names":["exampleNoop","globalsComponentsEdit","migrateAfterOperationRead","migrateAliasedExports","migrateAzureChunkLargeFiles","migrateBlockReferencesToBlocks","migrateBuildScript","migrateDbTypesSubpath","migrateDisabledFields","migrateDocumentTitleContext","migrateForceSelect","migrateHideAPIURL","migrateImportExportHooks","migrateListViewSelectAPI","migrateNextGenerateViewportExport","migrateNextSubpathExports","migrateSlugField","migrateStorageAdaptersToConfig","migrateVersionsDefault","removeGroupByTrue","removeLocalizeStatusConfig","removePublishSpecificLocale","removeVersionsTrue","renameExperimentalTableFeature","renameStorageAdaptersToStorage","renameTypescriptSchemaToJsonSchema","transforms"],"mappings":"AAEA,SAASA,WAAW,QAAQ,qCAAoC;AAChE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,2BAA2B,QAAQ,wDAAuD;AACnG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,wBAAwB,QAAQ,oDAAmD;AAC5F,SAASC,wBAAwB,QAAQ,qDAAoD;AAC7F,SAASC,iCAAiC,QAAQ,8DAA6D;AAC/G,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,gBAAgB,QAAQ,2CAA0C;AAC3E,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,sBAAsB,QAAQ,iDAAgD;AACvF,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,8BAA8B,QAAQ,0DAAyD;AACxG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kCAAkC,QAAQ,gEAA+D;AAElH,OAAO,MAAMC,aAA0B;IACrC1B;IACAE;IACAS;IACAV;IACAY;IACAL;IACAE;IACAP;IACAE;IACAC;IACAG;IACAQ;IACAb;IACAoB;IACAZ;IACAL;IACAO;IACAC;IACAC;IACAE;IACAC;IACAC;IACAE;IACAD;IACAI;IACAF;CACD,CAAA"}
+{"version":3,"sources":["../src/registry.ts"],"sourcesContent":["import type { Transform } from './types.js'\n\nimport { addOverrideAccessTrue } from './transforms/add-override-access-true/index.js'\nimport { exampleNoop } from './transforms/example-noop/index.js'\nimport { globalsComponentsEdit } from './transforms/globals-components-edit/index.js'\nimport { migrateAfterOperationRead } from './transforms/migrate-after-operation-read/index.js'\nimport { migrateAliasedExports } from './transforms/migrate-aliased-exports/index.js'\nimport { migrateAuthorshipDefault } from './transforms/migrate-authorship-default/index.js'\nimport { migrateAzureChunkLargeFiles } from './transforms/migrate-azure-chunk-large-files/index.js'\nimport { migrateBlockReferencesToBlocks } from './transforms/migrate-block-references-to-blocks/index.js'\nimport { migrateBuildScript } from './transforms/migrate-build-script/index.js'\nimport { migrateDbTypesSubpath } from './transforms/migrate-db-types-subpath/index.js'\nimport { migrateDisabledFields } from './transforms/migrate-disabled-fields/index.js'\nimport { migrateDocumentTitleContext } from './transforms/migrate-document-title-context/index.js'\nimport { migrateFieldComponentTypes } from './transforms/migrate-field-component-types/index.js'\nimport { migrateForceSelect } from './transforms/migrate-force-select/index.js'\nimport { migrateHideAPIURL } from './transforms/migrate-hide-api-url/index.js'\nimport { migrateImportExportHooks } from './transforms/migrate-import-export-hooks/index.js'\nimport { migrateListViewSelectAPI } from './transforms/migrate-list-view-select-api/index.js'\nimport { migrateNextGenerateViewportExport } from './transforms/migrate-next-generate-viewport-export/index.js'\nimport { migrateNextSubpathExports } from './transforms/migrate-next-subpath-exports/index.js'\nimport { migratePayloadRequestCreation } from './transforms/migrate-payload-request-creation/index.js'\nimport { migrateSlugField } from './transforms/migrate-slug-field/index.js'\nimport { migrateStorageAdaptersToConfig } from './transforms/migrate-storage-adapters-to-config/index.js'\nimport { migrateVersionsDefault } from './transforms/migrate-versions-default/index.js'\nimport { removeDefaultLocalePublishOption } from './transforms/remove-default-locale-publish-option/index.js'\nimport { removeGroupByTrue } from './transforms/remove-group-by-true/index.js'\nimport { removeLocalizeStatusConfig } from './transforms/remove-localize-status-config/index.js'\nimport { removePublishSpecificLocale } from './transforms/remove-publish-specific-locale/index.js'\nimport { removeStorageAlwaysInsertFields } from './transforms/remove-storage-always-insert-fields/index.js'\nimport { removeStrictDraftTypes } from './transforms/remove-strict-draft-types/index.js'\nimport { removeVersionsTrue } from './transforms/remove-versions-true/index.js'\nimport { renameExperimentalTableFeature } from './transforms/rename-experimental-table-feature/index.js'\nimport { renameStorageAdaptersToStorage } from './transforms/rename-storage-adapters-to-storage/index.js'\nimport { renameTypescriptSchemaToJsonSchema } from './transforms/rename-typescript-schema-to-json-schema/index.js'\n\nexport const transforms: Transform[] = [\n  exampleNoop,\n  addOverrideAccessTrue,\n  migrateAfterOperationRead,\n  migrateHideAPIURL,\n  globalsComponentsEdit,\n  migrateListViewSelectAPI,\n  migrateDisabledFields,\n  migrateForceSelect,\n  migrateFieldComponentTypes,\n  migrateAliasedExports,\n  migratePayloadRequestCreation,\n  migrateBlockReferencesToBlocks,\n  migrateBuildScript,\n  migrateDocumentTitleContext,\n  migrateStorageAdaptersToConfig,\n  migrateAzureChunkLargeFiles,\n  renameStorageAdaptersToStorage,\n  migrateImportExportHooks,\n  migrateDbTypesSubpath,\n  migrateNextGenerateViewportExport,\n  migrateNextSubpathExports,\n  migrateSlugField,\n  migrateVersionsDefault,\n  migrateAuthorshipDefault,\n  removeDefaultLocalePublishOption,\n  removeGroupByTrue,\n  removeLocalizeStatusConfig,\n  removeVersionsTrue,\n  removePublishSpecificLocale,\n  removeStorageAlwaysInsertFields,\n  removeStrictDraftTypes,\n  renameTypescriptSchemaToJsonSchema,\n  renameExperimentalTableFeature,\n]\n"],"names":["addOverrideAccessTrue","exampleNoop","globalsComponentsEdit","migrateAfterOperationRead","migrateAliasedExports","migrateAuthorshipDefault","migrateAzureChunkLargeFiles","migrateBlockReferencesToBlocks","migrateBuildScript","migrateDbTypesSubpath","migrateDisabledFields","migrateDocumentTitleContext","migrateFieldComponentTypes","migrateForceSelect","migrateHideAPIURL","migrateImportExportHooks","migrateListViewSelectAPI","migrateNextGenerateViewportExport","migrateNextSubpathExports","migratePayloadRequestCreation","migrateSlugField","migrateStorageAdaptersToConfig","migrateVersionsDefault","removeDefaultLocalePublishOption","removeGroupByTrue","removeLocalizeStatusConfig","removePublishSpecificLocale","removeStorageAlwaysInsertFields","removeStrictDraftTypes","removeVersionsTrue","renameExperimentalTableFeature","renameStorageAdaptersToStorage","renameTypescriptSchemaToJsonSchema","transforms"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,WAAW,QAAQ,qCAAoC;AAChE,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,wBAAwB,QAAQ,mDAAkD;AAC3F,SAASC,2BAA2B,QAAQ,wDAAuD;AACnG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,qBAAqB,QAAQ,iDAAgD;AACtF,SAASC,qBAAqB,QAAQ,gDAA+C;AACrF,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,wBAAwB,QAAQ,oDAAmD;AAC5F,SAASC,wBAAwB,QAAQ,qDAAoD;AAC7F,SAASC,iCAAiC,QAAQ,8DAA6D;AAC/G,SAASC,yBAAyB,QAAQ,qDAAoD;AAC9F,SAASC,6BAA6B,QAAQ,yDAAwD;AACtG,SAASC,gBAAgB,QAAQ,2CAA0C;AAC3E,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,sBAAsB,QAAQ,iDAAgD;AACvF,SAASC,gCAAgC,QAAQ,6DAA4D;AAC7G,SAASC,iBAAiB,QAAQ,6CAA4C;AAC9E,SAASC,0BAA0B,QAAQ,sDAAqD;AAChG,SAASC,2BAA2B,QAAQ,uDAAsD;AAClG,SAASC,+BAA+B,QAAQ,4DAA2D;AAC3G,SAASC,sBAAsB,QAAQ,kDAAiD;AACxF,SAASC,kBAAkB,QAAQ,6CAA4C;AAC/E,SAASC,8BAA8B,QAAQ,0DAAyD;AACxG,SAASC,8BAA8B,QAAQ,2DAA0D;AACzG,SAASC,kCAAkC,QAAQ,gEAA+D;AAElH,OAAO,MAAMC,aAA0B;IACrChC;IACAD;IACAG;IACAW;IACAZ;IACAc;IACAN;IACAG;IACAD;IACAR;IACAe;IACAZ;IACAC;IACAG;IACAU;IACAf;IACAyB;IACAhB;IACAN;IACAQ;IACAC;IACAE;IACAE;IACAjB;IACAkB;IACAC;IACAC;IACAI;IACAH;IACAC;IACAC;IACAI;IACAF;CACD,CAAA"}

package/dist/runbook/payload-v4-upgrade.md

@@ -0,0 +1,55 @@
+# Payload v3 -> v4: remaining steps
+
+`npx @payloadcms/codemod upgrade run` has done the mechanical slice: pinned Payload packages to v4,
+removed conflicting overrides, written the toolchain floors, installed, and run the AST
+transforms. This checklist is what it did NOT do. The authoritative breaking-change list is
+the migration guide (`docs/migration-guide/v4.mdx`, also bundled at `dist/runbook/v4.mdx`):
+<https://github.com/payloadcms/payload/blob/main/docs/migration-guide/v4.mdx>
+
+Report each item as verified / cannot-confirm / broken. Do not call the upgrade complete while
+any gate fails or any generated file is stale.
+
+## 0. Before upgrading (do on v3)
+
+Some migrations need v3 tooling that v4 removes, so they must run BEFORE `upgrade run`,
+while the v3 packages are still installed:
+
+- Slate richtext is deleted in v4. Migrate Slate -> Lexical on v3; the migration path is gone once
+  packages are pinned to v4.
+
+## 1. Next.js 16
+
+Payload v4 requires Next 16. The command did not touch Next. Run Next's own recommended agent
+workflow, which bumps Next + React and migrates the code as one unit:
+<https://nextjs.org/docs/app/guides/upgrading/version-16#use-an-ai-agent-recommended>
+
+Keep the resulting Next version within `>=16.2.6 <17` (the exact target is printed in the
+upgrade report), since Next's `upgrade latest` may point past 16 in future.
+
+## 2. Regenerate generated files
+
+```bash
+payload generate:types && payload generate:importmap
+```
+
+Never hand-edit `payload-types.ts` or `importMap.js` — regenerate them. If a credential wall
+blocks generation, set dummy env values and re-run.
+
+## 3. Manual v4 items (not covered by transforms)
+
+- SCSS is gone: move `@payloadcms/ui/scss` to `@payloadcms/ui/css`; rename `--theme-*` -> `--color-*`.
+- Sweep agent/editor instruction files (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules/*`) for APIs v4 removed.
+- Cron parsing is strict now: `/10 * * * *` -> `*/10 * * * *`.
+- Jobs: run DB migrations for the new lease/stats fields.
+- Review per-transform notes printed in the upgrade report for spots needing manual review.
+
+## 4. Verify
+
+- `tsc --noEmit` (delete `tsconfig.tsbuildinfo` first; set `checkJs: true` so `importMap.js` is covered).
+- Run integration tests and e2e separately.
+- Build.
+- Confirm native modules (e.g. `sharp`) still load.
+
+## 5. Report honestly
+
+Distinguish verified, cannot-confirm, and broken. A silent gap reads as "checked and fine".