@payloadcms/codemod 4.0.0-internal.b8a92d2 → 4.0.0-internal.bf4bcce

package/dist/upgrade/selectAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selectAgent.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process'\n\nexport type AgentId = 'claude' | 'codex'\n\nexport type Agent = {\n  /** Executable expected on PATH. */\n  command: string\n  id: AgentId\n  /** Human label shown in the picker. */\n  label: string\n}\n\n/** Coding agents the dispatcher can hand the orchestration prompt to. */\nexport const AGENTS: Agent[] = [\n  { id: 'claude', command: 'claude', label: 'Claude Code' },\n  { id: 'codex', command: 'codex', label: 'Codex' },\n]\n\n/**\n * Hand the prompt to `agent`, run the mechanical slice here, or print the\n * prompt to stdout for manual use.\n */\nexport type DispatchChoice = { agent: Agent; kind: 'agent' } | { kind: 'print' } | { kind: 'run' }\n\nexport type SelectDispatchArgs = {\n  /** Value of `--agent`, if the user pinned one. */\n  agentFlag?: string\n  /** Agents found on PATH. */\n  installed: Agent[]\n  /** Both stdin and stdout are a TTY, so a picker can run. */\n  isInteractive: boolean\n  /** Interactive picker; only called when a choice is genuinely needed. */\n  prompt: (agents: Agent[]) => Promise<DispatchChoice>\n}\n\n/**\n * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested\n * without a terminal. `--agent` wins and is strict (unknown or not-installed\n * throws). A non-interactive session falls back to printing the prompt. Any TTY\n * opens the picker, which offers running the mechanical slice or printing even\n * when no agent is installed.\n */\nexport async function selectDispatch({\n  agentFlag,\n  installed,\n  isInteractive,\n  prompt,\n}: SelectDispatchArgs): Promise<DispatchChoice> {\n  if (agentFlag) {\n    const known = AGENTS.find((a) => a.id === agentFlag)\n    if (!known) {\n      throw new Error(\n        `Unknown agent \"${agentFlag}\". Supported: ${AGENTS.map((a) => a.id).join(', ')}.`,\n      )\n    }\n    if (!installed.some((a) => a.id === known.id)) {\n      throw new Error(\n        `Agent \"${agentFlag}\" is not installed (command \"${known.command}\" not found).`,\n      )\n    }\n    return { agent: known, kind: 'agent' }\n  }\n\n  if (!isInteractive) {\n    return { kind: 'print' }\n  }\n\n  return prompt(installed)\n}\n\n/** Filter the registry down to agents whose command resolves on PATH. */\nexport function detectInstalledAgents(\n  isAvailable: (command: string) => boolean = isCommandAvailable,\n): Agent[] {\n  return AGENTS.filter((agent) => isAvailable(agent.command))\n}\n\n/** Cross-platform PATH probe using the OS command locator. */\nexport function isCommandAvailable(command: string): boolean {\n  const locator = process.platform === 'win32' ? 'where' : 'which'\n  const result = spawnSync(locator, [command], { stdio: 'ignore' })\n  return result.status === 0\n}\n"],"names":["spawnSync","AGENTS","id","command","label","selectDispatch","agentFlag","installed","isInteractive","prompt","known","find","a","Error","map","join","some","agent","kind","detectInstalledAgents","isAvailable","isCommandAvailable","filter","locator","process","platform","result","stdio","status"],"mappings":"AAAA,SAASA,SAAS,QAAQ,qBAAoB;AAY9C,uEAAuE,GACvE,OAAO,MAAMC,SAAkB;IAC7B;QAAEC,IAAI;QAAUC,SAAS;QAAUC,OAAO;IAAc;IACxD;QAAEF,IAAI;QAASC,SAAS;QAASC,OAAO;IAAQ;CACjD,CAAA;AAmBD;;;;;;CAMC,GACD,OAAO,eAAeC,eAAe,EACnCC,SAAS,EACTC,SAAS,EACTC,aAAa,EACbC,MAAM,EACa;IACnB,IAAIH,WAAW;QACb,MAAMI,QAAQT,OAAOU,IAAI,CAAC,CAACC,IAAMA,EAAEV,EAAE,KAAKI;QAC1C,IAAI,CAACI,OAAO;YACV,MAAM,IAAIG,MACR,CAAC,eAAe,EAAEP,UAAU,cAAc,EAAEL,OAAOa,GAAG,CAAC,CAACF,IAAMA,EAAEV,EAAE,EAAEa,IAAI,CAAC,MAAM,CAAC,CAAC;QAErF;QACA,IAAI,CAACR,UAAUS,IAAI,CAAC,CAACJ,IAAMA,EAAEV,EAAE,KAAKQ,MAAMR,EAAE,GAAG;YAC7C,MAAM,IAAIW,MACR,CAAC,OAAO,EAAEP,UAAU,6BAA6B,EAAEI,MAAMP,OAAO,CAAC,aAAa,CAAC;QAEnF;QACA,OAAO;YAAEc,OAAOP;YAAOQ,MAAM;QAAQ;IACvC;IAEA,IAAI,CAACV,eAAe;QAClB,OAAO;YAAEU,MAAM;QAAQ;IACzB;IAEA,OAAOT,OAAOF;AAChB;AAEA,uEAAuE,GACvE,OAAO,SAASY,sBACdC,cAA4CC,kBAAkB;IAE9D,OAAOpB,OAAOqB,MAAM,CAAC,CAACL,QAAUG,YAAYH,MAAMd,OAAO;AAC3D;AAEA,4DAA4D,GAC5D,OAAO,SAASkB,mBAAmBlB,OAAe;IAChD,MAAMoB,UAAUC,QAAQC,QAAQ,KAAK,UAAU,UAAU;IACzD,MAAMC,SAAS1B,UAAUuB,SAAS;QAACpB;KAAQ,EAAE;QAAEwB,OAAO;IAAS;IAC/D,OAAOD,OAAOE,MAAM,KAAK;AAC3B"}

package/dist/upgrade/selfCommand.d.ts

@@ -0,0 +1,13 @@
+type ResolveSelfCommandArgs = {
+    argv1?: string;
+    override?: string;
+};
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */
+export declare function resolveSelfCommand({ argv1, override, }?: ResolveSelfCommandArgs): string;
+export {};
+//# sourceMappingURL=selfCommand.d.ts.map

package/dist/upgrade/selfCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfCommand.d.ts","sourceRoot":"","sources":["../../src/upgrade/selfCommand.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAuB,EACvB,QAA8C,GAC/C,GAAE,sBAA2B,GAAG,MAAM,CAQtC"}

package/dist/upgrade/selfCommand.js

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */ export function resolveSelfCommand({ argv1 = process.argv[1], override = process.env.PAYLOAD_CODEMOD_COMMAND } = {}) {
+    if (override) {
+        return override;
+    }
+    if (argv1 && !argv1.includes('node_modules')) {
+        return `node ${resolve(argv1)}`;
+    }
+    return 'npx @payloadcms/codemod';
+}
+
+//# sourceMappingURL=selfCommand.js.map

package/dist/upgrade/selfCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selfCommand.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\ntype ResolveSelfCommandArgs = {\n  argv1?: string\n  override?: string\n}\n\n/**\n * The command a follower types to re-invoke this CLI. A published install lives\n * under node_modules and is reached with npx; a source checkout is reached with\n * `node <bin>` so local testing runs the local build, not a published version.\n * `PAYLOAD_CODEMOD_COMMAND` overrides both.\n */\nexport function resolveSelfCommand({\n  argv1 = process.argv[1],\n  override = process.env.PAYLOAD_CODEMOD_COMMAND,\n}: ResolveSelfCommandArgs = {}): string {\n  if (override) {\n    return override\n  }\n  if (argv1 && !argv1.includes('node_modules')) {\n    return `node ${resolve(argv1)}`\n  }\n  return 'npx @payloadcms/codemod'\n}\n"],"names":["resolve","resolveSelfCommand","argv1","process","argv","override","env","PAYLOAD_CODEMOD_COMMAND","includes"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAW;AAOnC;;;;;CAKC,GACD,OAAO,SAASC,mBAAmB,EACjCC,QAAQC,QAAQC,IAAI,CAAC,EAAE,EACvBC,WAAWF,QAAQG,GAAG,CAACC,uBAAuB,EACvB,GAAG,CAAC,CAAC;IAC5B,IAAIF,UAAU;QACZ,OAAOA;IACT;IACA,IAAIH,SAAS,CAACA,MAAMM,QAAQ,CAAC,iBAAiB;QAC5C,OAAO,CAAC,KAAK,EAAER,QAAQE,QAAQ;IACjC;IACA,OAAO;AACT"}

package/dist/upgrade/types.d.ts

@@ -0,0 +1,47 @@
+/** Minimal shape of an npm registry packument we read. */
+export type RegistryPackument = {
+    'dist-tags'?: Record<string, string>;
+    versions?: Record<string, {
+        engines?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+    }>;
+};
+export type FetchRegistry = (packageName: string) => Promise<RegistryPackument>;
+export type Spawn = (command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<{
+    code: number;
+}>;
+export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/** Target versions the command resolves. Only some are written; see `written`. */
+export type ResolvedVersions = {
+    /** Copied verbatim into engines.node. */
+    enginesNode: string;
+    /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */
+    nextTarget: null | string;
+    /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */
+    payloadVersion: string;
+    /** TypeScript floor (guide-sourced constant). */
+    typescript: string;
+    /** Newest @types/node patch within the Node major. */
+    typesNode: string;
+};
+export type UpgradeDeps = {
+    exists: (path: string) => boolean;
+    fetchRegistry: FetchRegistry;
+    spawn: Spawn;
+};
+/**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
+ */
+export declare const TS_FLOOR = "6.0.3";
+/** Path (relative to dist/) of the bundled runbook the command points users to. */
+export declare const RUNBOOK_RELATIVE_PATH = "runbook/payload-v4-upgrade.md";
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */
+export declare const MIGRATION_GUIDE_RELATIVE_PATH = "runbook/v4.mdx";
+//# sourceMappingURL=types.d.ts.map

package/dist/upgrade/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upgrade/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC1C,CACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/E,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE5D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,qFAAqF;IACrF,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAU,CAAA;AAE/B,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,kCAAkC,CAAA;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,mBAAmB,CAAA"}

package/dist/upgrade/types.js

@@ -0,0 +1,11 @@
+/** Minimal shape of an npm registry packument we read. */ /**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
+ */ export const TS_FLOOR = '6.0.3';
+/** Path (relative to dist/) of the bundled runbook the command points users to. */ export const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md';
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */ export const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx';
+
+//# sourceMappingURL=types.js.map

package/dist/upgrade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/types.ts"],"sourcesContent":["/** Minimal shape of an npm registry packument we read. */\nexport type RegistryPackument = {\n  'dist-tags'?: Record<string, string>\n  versions?: Record<\n    string,\n    {\n      engines?: Record<string, string>\n      peerDependencies?: Record<string, string>\n    }\n  >\n}\n\nexport type FetchRegistry = (packageName: string) => Promise<RegistryPackument>\n\nexport type Spawn = (\n  command: string,\n  args: string[],\n  options: { cwd: string; env: NodeJS.ProcessEnv },\n) => Promise<{ code: number }>\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\n/** Target versions the command resolves. Only some are written; see `written`. */\nexport type ResolvedVersions = {\n  /** Copied verbatim into engines.node. */\n  enginesNode: string\n  /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */\n  nextTarget: null | string\n  /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */\n  payloadVersion: string\n  /** TypeScript floor (guide-sourced constant). */\n  typescript: string\n  /** Newest @types/node patch within the Node major. */\n  typesNode: string\n}\n\nexport type UpgradeDeps = {\n  exists: (path: string) => boolean\n  fetchRegistry: FetchRegistry\n  spawn: Spawn\n}\n\n/**\n * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it\n * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.\n */\nexport const TS_FLOOR = '6.0.3'\n\n/** Path (relative to dist/) of the bundled runbook the command points users to. */\nexport const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md'\n\n/**\n * Path (relative to dist/) of the bundled migration guide. Present only when the\n * monorepo copy was available at build time; the report points at it when it exists.\n */\nexport const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx'\n"],"names":["TS_FLOOR","RUNBOOK_RELATIVE_PATH","MIGRATION_GUIDE_RELATIVE_PATH"],"mappings":"AAAA,wDAAwD,GA0CxD;;;CAGC,GACD,OAAO,MAAMA,WAAW,QAAO;AAE/B,iFAAiF,GACjF,OAAO,MAAMC,wBAAwB,gCAA+B;AAEpE;;;CAGC,GACD,OAAO,MAAMC,gCAAgC,iBAAgB"}

package/dist/utils/project.d.ts

@@ -0,0 +1,10 @@
+import { Project } from 'ts-morph';
+/**
+ * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.
+ *
+ * Falls back to globbing when the tsconfig resolves no source files (e.g. a
+ * solution-style config with only `references`), so transforms never silently
+ * run against an empty project.
+ */
+export declare function loadProject(path: string): Project;
+//# sourceMappingURL=project.d.ts.map

package/dist/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,OAAO,EAAa,MAAM,UAAU,CAAA;AAQ9D;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBjD"}

package/dist/utils/project.js

@@ -0,0 +1,43 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { IndentationText, Project, QuoteKind } from 'ts-morph';
+const manipulationSettings = {
+    indentationText: IndentationText.TwoSpaces,
+    quoteKind: QuoteKind.Single,
+    useTrailingCommas: true
+};
+/**
+ * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.
+ *
+ * Falls back to globbing when the tsconfig resolves no source files (e.g. a
+ * solution-style config with only `references`), so transforms never silently
+ * run against an empty project.
+ */ export function loadProject(path) {
+    const tsconfigPath = resolve(path, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        const project = new Project({
+            manipulationSettings,
+            tsConfigFilePath: tsconfigPath
+        });
+        if (project.getSourceFiles().length > 0) {
+            return project;
+        }
+        console.warn(`Warning: ${tsconfigPath} resolved no source files. Falling back to globbing ${path}.`);
+    }
+    return loadProjectFromGlob(path);
+}
+function loadProjectFromGlob(path) {
+    const project = new Project({
+        manipulationSettings
+    });
+    project.addSourceFilesAtPaths([
+        `${path}/**/*.{ts,tsx,js,jsx}`,
+        '!**/node_modules/**',
+        '!**/dist/**',
+        '!**/.next/**',
+        '!**/build/**'
+    ]);
+    return project;
+}
+
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/project.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { IndentationText, Project, QuoteKind } from 'ts-morph'\n\nconst manipulationSettings = {\n  indentationText: IndentationText.TwoSpaces,\n  quoteKind: QuoteKind.Single,\n  useTrailingCommas: true,\n}\n\n/**\n * Load a ts-morph Project rooted at `path`, using its tsconfig.json if present.\n *\n * Falls back to globbing when the tsconfig resolves no source files (e.g. a\n * solution-style config with only `references`), so transforms never silently\n * run against an empty project.\n */\nexport function loadProject(path: string): Project {\n  const tsconfigPath = resolve(path, 'tsconfig.json')\n\n  if (existsSync(tsconfigPath)) {\n    const project = new Project({ manipulationSettings, tsConfigFilePath: tsconfigPath })\n\n    if (project.getSourceFiles().length > 0) {\n      return project\n    }\n\n    console.warn(\n      `Warning: ${tsconfigPath} resolved no source files. Falling back to globbing ${path}.`,\n    )\n  }\n\n  return loadProjectFromGlob(path)\n}\n\nfunction loadProjectFromGlob(path: string): Project {\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"],"names":["existsSync","resolve","IndentationText","Project","QuoteKind","manipulationSettings","indentationText","TwoSpaces","quoteKind","Single","useTrailingCommas","loadProject","path","tsconfigPath","project","tsConfigFilePath","getSourceFiles","length","console","warn","loadProjectFromGlob","addSourceFilesAtPaths"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAS;AACpC,SAASC,OAAO,QAAQ,YAAW;AACnC,SAASC,eAAe,EAAEC,OAAO,EAAEC,SAAS,QAAQ,WAAU;AAE9D,MAAMC,uBAAuB;IAC3BC,iBAAiBJ,gBAAgBK,SAAS;IAC1CC,WAAWJ,UAAUK,MAAM;IAC3BC,mBAAmB;AACrB;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,YAAYC,IAAY;IACtC,MAAMC,eAAeZ,QAAQW,MAAM;IAEnC,IAAIZ,WAAWa,eAAe;QAC5B,MAAMC,UAAU,IAAIX,QAAQ;YAAEE;YAAsBU,kBAAkBF;QAAa;QAEnF,IAAIC,QAAQE,cAAc,GAAGC,MAAM,GAAG,GAAG;YACvC,OAAOH;QACT;QAEAI,QAAQC,IAAI,CACV,CAAC,SAAS,EAAEN,aAAa,oDAAoD,EAAED,KAAK,CAAC,CAAC;IAE1F;IAEA,OAAOQ,oBAAoBR;AAC7B;AAEA,SAASQ,oBAAoBR,IAAY;IACvC,MAAME,UAAU,IAAIX,QAAQ;QAAEE;IAAqB;IACnDS,QAAQO,qBAAqB,CAAC;QAC5B,GAAGT,KAAK,qBAAqB,CAAC;QAC9B;QACA;QACA;QACA;KACD;IACD,OAAOE;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/codemod",
-  "version": "4.0.0-internal.b8a92d2",
+  "version": "4.0.0-internal.bf4bcce",
   "description": "Codemods for migrating Payload projects across versions.",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -29,20 +29,24 @@
     "README.md"
   ],
   "dependencies": {
-    "ts-morph": "^21.0.1"
+    "@clack/prompts": "1.2.0",
+    "semver": "^7.8.5",
+    "ts-morph": "^28.0.0"
   },
   "devDependencies": {
     "@swc/core": "1.15.3",
     "@types/node": "24.12.3",
+    "@types/semver": "^7.7.1",
     "rimraf": "6.0.1",
     "typescript": "npm:@typescript/typescript6@6.0.2",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "engines": {
     "node": ">=24.15.0"
   },
   "scripts": {
-    "build": "pnpm typecheck && pnpm build:swc",
+    "build": "pnpm typecheck && pnpm build:swc && pnpm build:copy-docs",
+    "build:copy-docs": "node scripts/copy-migration-guide.mjs",
     "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
     "clean": "rimraf -g {dist,*.tsbuildinfo}",
     "lint": "eslint .",