prisma-next 0.11.0-dev.46 → 0.11.0-dev.48

package/dist/commands/migration-new.mjs

@@ -1,16 +1,17 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { C as errorRuntime, E as errorTargetMigrationNotSupported, O as errorUnexpected, k as mapMigrationToolsError, l as errorFileNotFound, t as CliStructuredError } from "../cli-errors-DFF1LlfU.mjs";
+import { C as errorRuntime, E as errorTargetMigrationNotSupported, O as errorUnexpected, l as errorFileNotFound, t as CliStructuredError } from "../cli-errors-DFF1LlfU.mjs";
 import { t as assertFrameworkComponentsCompatible } from "../framework-components-DTcjouhS.mjs";
-import { A as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, i as getTargetMigrations, l as resolveMigrationPaths, t as addGlobalOptions, v as parseGlobalFlagsOrExit, w as handleResult, y as createTerminalUI } from "../command-helpers-yLuA78TP.mjs";
+import { A as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, i as getTargetMigrations, l as resolveMigrationPaths, t as addGlobalOptions, v as parseGlobalFlagsOrExit, w as handleResult, y as createTerminalUI } from "../command-helpers-CI8P5Xyd.mjs";
+import { i as refusePackageCorruptionOnAggregate } from "../contract-space-aggregate-loader-CVHGuA35.mjs";
 import { Command } from "commander";
 import { getEmittedArtifactPaths } from "@prisma-next/emitter";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { join, relative } from "pathe";
 import { readFile } from "node:fs/promises";
 import { APP_SPACE_ID, createControlStack } from "@prisma-next/framework-components/control";
-import { copyFilesWithRename, formatMigrationDirName, readMigrationsDir, writeMigrationPackage } from "@prisma-next/migration-tools/io";
-import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/migration-graph";
-import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
+import { copyFilesWithRename, formatMigrationDirName, writeMigrationPackage } from "@prisma-next/migration-tools/io";
+import { findLatestMigration } from "@prisma-next/migration-tools/migration-graph";
+import { loadContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
 import { computeMigrationHash } from "@prisma-next/migration-tools/hash";
 import { writeMigrationTs } from "@prisma-next/migration-tools/migration-ts";
 //#region src/commands/migration-new.ts
@@ -25,7 +26,7 @@ import { writeMigrationTs } from "@prisma-next/migration-tools/migration-ts";
 */
 async function executeMigrationNewCommand(options) {
 	const config = await loadConfig(options.config);
-	const { appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
+	const { migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
 	const stack = createControlStack(config);
 	const familyInstance = config.family.create(stack);
 	const contractPathAbsolute = resolveContractPath(config);
@@ -41,7 +42,8 @@ async function executeMigrationNewCommand(options) {
 	}
 	let toContract;
 	try {
-		toContract = familyInstance.deserializeContract(JSON.parse(contractJsonContent));
+		const parsedContract = JSON.parse(contractJsonContent);
+		toContract = familyInstance.deserializeContract(parsedContract);
 	} catch (error) {
 		return notOk(errorRuntime("Contract JSON is invalid", {
 			why: `Failed to deserialize ${contractPathAbsolute}: ${error instanceof Error ? error.message : String(error)}`,
@@ -53,32 +55,32 @@ async function executeMigrationNewCommand(options) {
 		why: `Contract at ${contractPathAbsolute} has no storageHash`,
 		fix: "Run `prisma-next contract emit` to regenerate the contract"
 	}));
+	const aggregate = await loadContractSpaceAggregate({
+		migrationsDir,
+		deserializeContract: (json) => familyInstance.deserializeContract(json),
+		appContract: toContract
+	});
+	const packageCorruptionFailure = refusePackageCorruptionOnAggregate(aggregate);
+	if (packageCorruptionFailure) return notOk(packageCorruptionFailure);
+	const packages = aggregate.app.packages;
+	const graph = aggregate.app.graph();
 	let fromHash = null;
 	let fromContractSourceDir = null;
-	try {
-		const packages = await readMigrationsDir(appMigrationsDir);
-		if (packages.length > 0) {
-			const graph = reconstructGraph(packages);
-			if (options.from) {
-				const match = packages.find((p) => p.metadata.to.startsWith(options.from));
-				if (!match) return notOk(errorRuntime("Starting contract not found", {
-					why: `No migration with to hash matching "${options.from}" exists in ${appMigrationsRelative}`,
-					fix: "Check that the --from hash matches a known migration target hash."
-				}));
-				fromHash = match.metadata.to;
-				fromContractSourceDir = match.dirPath;
-			} else {
-				const latestMigration = findLatestMigration(graph);
-				if (latestMigration) {
-					fromHash = latestMigration.to;
-					const leafPkg = packages.find((p) => p.metadata.migrationHash === latestMigration.migrationHash);
-					if (leafPkg) fromContractSourceDir = leafPkg.dirPath;
-				}
-			}
+	if (packages.length > 0) if (options.from) {
+		const match = packages.find((p) => p.metadata.to.startsWith(options.from));
+		if (!match) return notOk(errorRuntime("Starting contract not found", {
+			why: `No migration with to hash matching "${options.from}" exists in ${appMigrationsRelative}`,
+			fix: "Check that the --from hash matches a known migration target hash."
+		}));
+		fromHash = match.metadata.to;
+		fromContractSourceDir = match.dirPath;
+	} else {
+		const latestMigration = findLatestMigration(graph);
+		if (latestMigration) {
+			fromHash = latestMigration.to;
+			const leafPkg = packages.find((p) => p.metadata.migrationHash === latestMigration.migrationHash);
+			if (leafPkg) fromContractSourceDir = leafPkg.dirPath;
 		}
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		throw error;
 	}
 	if (fromHash === toStorageHash && !options.from) return notOk(errorRuntime("No changes detected", {
 		why: "The from and to contract hashes are identical — there is nothing to migrate.",

package/dist/commands/migration-new.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration-new.mjs","names":[],"sources":["../../src/commands/migration-new.ts"],"sourcesContent":["/**\n * `migration new` — scaffolds a migration package with a `migration.ts` file\n * for manual authoring.\n *\n * The planner's `emptyMigration(context)` returns a\n * `MigrationPlanWithAuthoringSurface`, whose `renderTypeScript()` produces\n * the target-appropriate empty stub. The CLI writes the returned source\n * verbatim.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { getEmittedArtifactPaths } from '@prisma-next/emitter';\nimport { APP_SPACE_ID, createControlStack } from '@prisma-next/framework-components/control';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { computeMigrationHash } from '@prisma-next/migration-tools/hash';\nimport {\n  copyFilesWithRename,\n  formatMigrationDirName,\n  readMigrationsDir,\n  writeMigrationPackage,\n} from '@prisma-next/migration-tools/io';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport {\n  findLatestMigration,\n  reconstructGraph,\n} from '@prisma-next/migration-tools/migration-graph';\nimport { writeMigrationTs } from '@prisma-next/migration-tools/migration-ts';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join, relative } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport {\n  CliStructuredError,\n  errorFileNotFound,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport { assertFrameworkComponentsCompatible } from '../utils/framework-components';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationNewOptions extends CommonCommandOptions {\n  readonly name?: string;\n  readonly from?: string;\n  readonly config?: string;\n}\n\ninterface MigrationNewResult {\n  readonly ok: true;\n  readonly dir: string;\n  readonly from: string | null;\n  readonly to: string;\n  readonly summary: string;\n}\n\nasync function executeMigrationNewCommand(\n  options: MigrationNewOptions,\n): Promise<Result<MigrationNewResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);\n\n  // Construct the family instance up-front so the on-disk contract read\n  // below crosses the serializer seam (`familyInstance.deserializeContract`)\n  // at the read site, not somewhere downstream. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      return notOk(\n        errorRuntime(`Contract file not found at ${contractPathAbsolute}`, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: 'Run `prisma-next contract emit` first to generate the contract',\n        }),\n      );\n    }\n    throw error;\n  }\n\n  let toContract: Contract;\n  try {\n    toContract = familyInstance.deserializeContract(JSON.parse(contractJsonContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorRuntime('Contract JSON is invalid', {\n        why: `Failed to deserialize ${contractPathAbsolute}: ${error instanceof Error ? error.message : String(error)}`,\n        fix: 'Run `prisma-next contract emit` to regenerate the contract',\n      }),\n    );\n  }\n\n  const toStorageHash = toContract.storage?.storageHash;\n  if (typeof toStorageHash !== 'string') {\n    return notOk(\n      errorRuntime('Contract is missing storageHash', {\n        why: `Contract at ${contractPathAbsolute} has no storageHash`,\n        fix: 'Run `prisma-next contract emit` to regenerate the contract',\n      }),\n    );\n  }\n\n  let fromHash: string | null = null;\n  let fromContractSourceDir: string | null = null;\n\n  try {\n    const packages = await readMigrationsDir(appMigrationsDir);\n\n    if (packages.length > 0) {\n      const graph = reconstructGraph(packages);\n\n      if (options.from) {\n        const match = packages.find((p) => p.metadata.to.startsWith(options.from!));\n        if (!match) {\n          return notOk(\n            errorRuntime('Starting contract not found', {\n              why: `No migration with to hash matching \"${options.from}\" exists in ${appMigrationsRelative}`,\n              fix: 'Check that the --from hash matches a known migration target hash.',\n            }),\n          );\n        }\n        fromHash = match.metadata.to;\n        fromContractSourceDir = match.dirPath;\n      } else {\n        const latestMigration = findLatestMigration(graph);\n        if (latestMigration) {\n          fromHash = latestMigration.to;\n          const leafPkg = packages.find(\n            (p) => p.metadata.migrationHash === latestMigration.migrationHash,\n          );\n          if (leafPkg) {\n            fromContractSourceDir = leafPkg.dirPath;\n          }\n        }\n      }\n    }\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  if (fromHash === toStorageHash && !options.from) {\n    return notOk(\n      errorRuntime('No changes detected', {\n        why: 'The from and to contract hashes are identical — there is nothing to migrate.',\n        fix: 'Change the contract and run `prisma-next contract emit` before creating a new migration. To author a data-only migration on the current contract hash, pass `--from <hash>` explicitly.',\n      }),\n    );\n  }\n\n  const timestamp = new Date();\n  const slug = options.name ?? 'migration';\n  const dirName = formatMigrationDirName(timestamp, slug);\n  const packageDir = join(appMigrationsDir, dirName);\n\n  // `migration new` scaffolds an empty `migration.ts` for the user to\n  // fill, so we attest over `ops: []`. Re-running self-emit after the\n  // user adds operations will produce a different `migrationHash` (over\n  // the real ops). This is intentional — there is no on-disk draft.\n  const baseMetadata: Omit<MigrationMetadata, 'migrationHash'> = {\n    from: fromHash,\n    to: toStorageHash,\n    providedInvariants: [],\n    createdAt: timestamp.toISOString(),\n  };\n  const metadata: MigrationMetadata = {\n    ...baseMetadata,\n    migrationHash: computeMigrationHash(baseMetadata, []),\n  };\n\n  const migrations = getTargetMigrations(config.target);\n  if (!migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.targetId}\" does not support migrations`,\n      }),\n    );\n  }\n\n  try {\n    assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [\n      config.target,\n      config.adapter,\n      ...(config.extensionPacks ?? []),\n    ]);\n\n    await writeMigrationPackage(packageDir, metadata, []);\n    const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);\n    await copyFilesWithRename(packageDir, [\n      { sourcePath: destinationArtifacts.jsonPath, destName: 'end-contract.json' },\n      { sourcePath: destinationArtifacts.dtsPath, destName: 'end-contract.d.ts' },\n    ]);\n    if (fromContractSourceDir !== null) {\n      const sourceArtifacts = getEmittedArtifactPaths(\n        join(fromContractSourceDir, 'end-contract.json'),\n      );\n      try {\n        await copyFilesWithRename(packageDir, [\n          { sourcePath: sourceArtifacts.jsonPath, destName: 'start-contract.json' },\n          { sourcePath: sourceArtifacts.dtsPath, destName: 'start-contract.d.ts' },\n        ]);\n      } catch (error) {\n        if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n          return notOk(\n            errorFileNotFound(sourceArtifacts.jsonPath, {\n              why: `Predecessor migration is missing its destination contract snapshot at ${sourceArtifacts.jsonPath}`,\n              fix: 'Re-emit the predecessor migration (`prisma-next migration plan` from its source) so its sibling `end-contract.json` is restored, then re-run this command.',\n            }),\n          );\n        }\n        throw error;\n      }\n    }\n\n    const planner = migrations.createPlanner(familyInstance);\n    const emptyPlan = planner.emptyMigration(\n      {\n        packageDir,\n        contractJsonPath: join(packageDir, 'end-contract.json'),\n        fromHash,\n        toHash: toStorageHash,\n      },\n      APP_SPACE_ID,\n    );\n    await writeMigrationTs(packageDir, emptyPlan.renderTypeScript());\n\n    return ok({\n      ok: true as const,\n      dir: relative(process.cwd(), packageDir),\n      from: fromHash,\n      to: toStorageHash,\n      summary: `Scaffolded migration at ${relative(process.cwd(), packageDir)}`,\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to scaffold migration: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n}\n\nexport function createMigrationNewCommand(): Command {\n  const command = new Command('new');\n  setCommandDescriptions(\n    command,\n    'Scaffold a new migration for manual authoring',\n    'Creates a migration package with a migration.ts file for manual authoring.\\n' +\n      'Write the migration body in migration.ts, then run the file with Node\\n' +\n      '(`node migration.ts`) to self-emit ops.json and attest the package.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration new --name split-name',\n    'prisma-next migration new --name custom-fk --from sha256:abc...',\n  ]);\n  addGlobalOptions(command)\n    .option('--name <slug>', 'Migration name (used in directory name)')\n    .option('--from <hash>', 'Starting contract hash (default: latest migration target)')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: MigrationNewOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n\n      if (!flags.json && !flags.quiet) {\n        const header = formatStyledHeader({\n          command: 'migration new',\n          description: 'Scaffold a new migration',\n          details: [],\n          flags,\n        });\n        ui.stderr(header);\n      }\n\n      const result = await executeMigrationNewCommand(options);\n\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value, null, 2));\n        } else if (!flags.quiet) {\n          ui.output(`\\nScaffolded migration at ${value.dir}`);\n          ui.output(`  from: ${value.from}`);\n          ui.output(`  to:   ${value.to}`);\n          ui.output(\n            `\\nEdit migration.ts, then run it directly (\\`node \"${value.dir}/migration.ts\"\\`) to self-emit and attest.`,\n          );\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,eAAe,2BACb,SACyD;CACzD,MAAM,SAAS,MAAM,WAAW,QAAQ,MAAM;CAC9C,MAAM,EAAE,kBAAkB,0BAA0B,sBAAsB,QAAQ,QAAQ,MAAM;CAKhG,MAAM,QAAQ,mBAAmB,MAAM;CACvC,MAAM,iBAAiB,OAAO,OAAO,OAAO,KAAK;CAEjD,MAAM,uBAAuB,oBAAoB,MAAM;CAEvD,IAAI;CACJ,IAAI;EACF,sBAAsB,MAAM,SAAS,sBAAsB,OAAO;CACpE,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAU,MAA4B,SAAS,UAClE,OAAO,MACL,aAAa,8BAA8B,wBAAwB;GACjE,KAAK,8BAA8B;GACnC,KAAK;EACP,CAAC,CACH;EAEF,MAAM;CACR;CAEA,IAAI;CACJ,IAAI;EACF,aAAa,eAAe,oBAAoB,KAAK,MAAM,mBAAmB,CAAY;CAC5F,SAAS,OAAO;EACd,OAAO,MACL,aAAa,4BAA4B;GACvC,KAAK,yBAAyB,qBAAqB,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC5G,KAAK;EACP,CAAC,CACH;CACF;CAEA,MAAM,gBAAgB,WAAW,SAAS;CAC1C,IAAI,OAAO,kBAAkB,UAC3B,OAAO,MACL,aAAa,mCAAmC;EAC9C,KAAK,eAAe,qBAAqB;EACzC,KAAK;CACP,CAAC,CACH;CAGF,IAAI,WAA0B;CAC9B,IAAI,wBAAuC;CAE3C,IAAI;EACF,MAAM,WAAW,MAAM,kBAAkB,gBAAgB;EAEzD,IAAI,SAAS,SAAS,GAAG;GACvB,MAAM,QAAQ,iBAAiB,QAAQ;GAEvC,IAAI,QAAQ,MAAM;IAChB,MAAM,QAAQ,SAAS,MAAM,MAAM,EAAE,SAAS,GAAG,WAAW,QAAQ,IAAK,CAAC;IAC1E,IAAI,CAAC,OACH,OAAO,MACL,aAAa,+BAA+B;KAC1C,KAAK,uCAAuC,QAAQ,KAAK,cAAc;KACvE,KAAK;IACP,CAAC,CACH;IAEF,WAAW,MAAM,SAAS;IAC1B,wBAAwB,MAAM;GAChC,OAAO;IACL,MAAM,kBAAkB,oBAAoB,KAAK;IACjD,IAAI,iBAAiB;KACnB,WAAW,gBAAgB;KAC3B,MAAM,UAAU,SAAS,MACtB,MAAM,EAAE,SAAS,kBAAkB,gBAAgB,aACtD;KACA,IAAI,SACF,wBAAwB,QAAQ;IAEpC;GACF;EACF;CACF,SAAS,OAAO;EACd,IAAI,oBAAoB,GAAG,KAAK,GAC9B,OAAO,MAAM,uBAAuB,KAAK,CAAC;EAE5C,MAAM;CACR;CAEA,IAAI,aAAa,iBAAiB,CAAC,QAAQ,MACzC,OAAO,MACL,aAAa,uBAAuB;EAClC,KAAK;EACL,KAAK;CACP,CAAC,CACH;CAGF,MAAM,4BAAY,IAAI,KAAK;CAG3B,MAAM,aAAa,KAAK,kBADR,uBAAuB,WAD1B,QAAQ,QAAQ,WAEmB,CAAC;CAMjD,MAAM,eAAyD;EAC7D,MAAM;EACN,IAAI;EACJ,oBAAoB,CAAC;EACrB,WAAW,UAAU,YAAY;CACnC;CACA,MAAM,WAA8B;EAClC,GAAG;EACH,eAAe,qBAAqB,cAAc,CAAC,CAAC;CACtD;CAEA,MAAM,aAAa,oBAAoB,OAAO,MAAM;CACpD,IAAI,CAAC,YACH,OAAO,MACL,iCAAiC,EAC/B,KAAK,WAAW,OAAO,OAAO,SAAS,+BACzC,CAAC,CACH;CAGF,IAAI;EACF,oCAAoC,OAAO,OAAO,UAAU,OAAO,OAAO,UAAU;GAClF,OAAO;GACP,OAAO;GACP,GAAI,OAAO,kBAAkB,CAAC;EAChC,CAAC;EAED,MAAM,sBAAsB,YAAY,UAAU,CAAC,CAAC;EACpD,MAAM,uBAAuB,wBAAwB,oBAAoB;EACzE,MAAM,oBAAoB,YAAY,CACpC;GAAE,YAAY,qBAAqB;GAAU,UAAU;EAAoB,GAC3E;GAAE,YAAY,qBAAqB;GAAS,UAAU;EAAoB,CAC5E,CAAC;EACD,IAAI,0BAA0B,MAAM;GAClC,MAAM,kBAAkB,wBACtB,KAAK,uBAAuB,mBAAmB,CACjD;GACA,IAAI;IACF,MAAM,oBAAoB,YAAY,CACpC;KAAE,YAAY,gBAAgB;KAAU,UAAU;IAAsB,GACxE;KAAE,YAAY,gBAAgB;KAAS,UAAU;IAAsB,CACzE,CAAC;GACH,SAAS,OAAO;IACd,IAAI,iBAAiB,SAAU,MAA4B,SAAS,UAClE,OAAO,MACL,kBAAkB,gBAAgB,UAAU;KAC1C,KAAK,yEAAyE,gBAAgB;KAC9F,KAAK;IACP,CAAC,CACH;IAEF,MAAM;GACR;EACF;EAYA,MAAM,iBAAiB,YAVP,WAAW,cAAc,cACjB,EAAE,eACxB;GACE;GACA,kBAAkB,KAAK,YAAY,mBAAmB;GACtD;GACA,QAAQ;EACV,GACA,YAEyC,EAAE,iBAAiB,CAAC;EAE/D,OAAO,GAAG;GACR,IAAI;GACJ,KAAK,SAAS,QAAQ,IAAI,GAAG,UAAU;GACvC,MAAM;GACN,IAAI;GACJ,SAAS,2BAA2B,SAAS,QAAQ,IAAI,GAAG,UAAU;EACxE,CAAC;CACH,SAAS,OAAO;EACd,IAAI,mBAAmB,GAAG,KAAK,GAC7B,OAAO,MAAM,KAAK;EAEpB,OAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EACtE,KAAK,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,IAC7F,CAAC,CACH;CACF;AACF;AAEA,SAAgB,4BAAqC;CACnD,MAAM,UAAU,IAAI,QAAQ,KAAK;CACjC,uBACE,SACA,iDACA,wNAGF;CACA,mBAAmB,SAAS,CAC1B,+CACA,iEACF,CAAC;CACD,iBAAiB,OAAO,EACrB,OAAO,iBAAiB,yCAAyC,EACjE,OAAO,iBAAiB,2DAA2D,EACnF,OAAO,mBAAmB,+BAA+B,EACzD,OAAO,OAAO,YAAiC;EAC9C,MAAM,QAAQ,uBAAuB,OAAO;EAC5C,MAAM,KAAK,iBAAiB,KAAK;EAEjC,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;GAC/B,MAAM,SAAS,mBAAmB;IAChC,SAAS;IACT,aAAa;IACb,SAAS,CAAC;IACV;GACF,CAAC;GACD,GAAG,OAAO,MAAM;EAClB;EAIA,MAAM,WAAW,aAAa,MAFT,2BAA2B,OAAO,GAEjB,OAAO,KAAK,UAAU;GAC1D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,OAAO;IACvB,GAAG,OAAO,6BAA6B,MAAM,KAAK;IAClD,GAAG,OAAO,WAAW,MAAM,MAAM;IACjC,GAAG,OAAO,WAAW,MAAM,IAAI;IAC/B,GAAG,OACD,sDAAsD,MAAM,IAAI,2CAClE;GACF;EACF,CAAC;EAED,QAAQ,KAAK,QAAQ;CACvB,CAAC;CAEH,OAAO;AACT"}
+{"version":3,"file":"migration-new.mjs","names":[],"sources":["../../src/commands/migration-new.ts"],"sourcesContent":["/**\n * `migration new` — scaffolds a migration package with a `migration.ts` file\n * for manual authoring.\n *\n * The planner's `emptyMigration(context)` returns a\n * `MigrationPlanWithAuthoringSurface`, whose `renderTypeScript()` produces\n * the target-appropriate empty stub. The CLI writes the returned source\n * verbatim.\n */\n\nimport { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { getEmittedArtifactPaths } from '@prisma-next/emitter';\nimport { APP_SPACE_ID, createControlStack } from '@prisma-next/framework-components/control';\nimport { loadContractSpaceAggregate } from '@prisma-next/migration-tools/aggregate';\nimport { computeMigrationHash } from '@prisma-next/migration-tools/hash';\nimport {\n  copyFilesWithRename,\n  formatMigrationDirName,\n  writeMigrationPackage,\n} from '@prisma-next/migration-tools/io';\nimport type { MigrationMetadata } from '@prisma-next/migration-tools/metadata';\nimport { findLatestMigration } from '@prisma-next/migration-tools/migration-graph';\nimport { writeMigrationTs } from '@prisma-next/migration-tools/migration-ts';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join, relative } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport {\n  CliStructuredError,\n  errorFileNotFound,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { refusePackageCorruptionOnAggregate } from '../utils/contract-space-aggregate-loader';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport { assertFrameworkComponentsCompatible } from '../utils/framework-components';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationNewOptions extends CommonCommandOptions {\n  readonly name?: string;\n  readonly from?: string;\n  readonly config?: string;\n}\n\ninterface MigrationNewResult {\n  readonly ok: true;\n  readonly dir: string;\n  readonly from: string | null;\n  readonly to: string;\n  readonly summary: string;\n}\n\nasync function executeMigrationNewCommand(\n  options: MigrationNewOptions,\n): Promise<Result<MigrationNewResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  // Construct the family instance up-front so the on-disk contract read\n  // below crosses the serializer seam (`familyInstance.deserializeContract`)\n  // at the read site, not somewhere downstream. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n      return notOk(\n        errorRuntime(`Contract file not found at ${contractPathAbsolute}`, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: 'Run `prisma-next contract emit` first to generate the contract',\n        }),\n      );\n    }\n    throw error;\n  }\n\n  let toContract: Contract;\n  try {\n    const parsedContract: unknown = JSON.parse(contractJsonContent);\n    toContract = familyInstance.deserializeContract(parsedContract);\n  } catch (error) {\n    return notOk(\n      errorRuntime('Contract JSON is invalid', {\n        why: `Failed to deserialize ${contractPathAbsolute}: ${error instanceof Error ? error.message : String(error)}`,\n        fix: 'Run `prisma-next contract emit` to regenerate the contract',\n      }),\n    );\n  }\n\n  const toStorageHash = toContract.storage?.storageHash;\n  if (typeof toStorageHash !== 'string') {\n    return notOk(\n      errorRuntime('Contract is missing storageHash', {\n        why: `Contract at ${contractPathAbsolute} has no storageHash`,\n        fix: 'Run `prisma-next contract emit` to regenerate the contract',\n      }),\n    );\n  }\n\n  const aggregate = await loadContractSpaceAggregate({\n    migrationsDir,\n    deserializeContract: (json) => familyInstance.deserializeContract(json),\n    appContract: toContract,\n  });\n  const packageCorruptionFailure = refusePackageCorruptionOnAggregate(aggregate);\n  if (packageCorruptionFailure) {\n    return notOk(packageCorruptionFailure);\n  }\n\n  const packages = aggregate.app.packages;\n  const graph = aggregate.app.graph();\n\n  let fromHash: string | null = null;\n  let fromContractSourceDir: string | null = null;\n\n  if (packages.length > 0) {\n    if (options.from) {\n      const match = packages.find((p) => p.metadata.to.startsWith(options.from!));\n      if (!match) {\n        return notOk(\n          errorRuntime('Starting contract not found', {\n            why: `No migration with to hash matching \"${options.from}\" exists in ${appMigrationsRelative}`,\n            fix: 'Check that the --from hash matches a known migration target hash.',\n          }),\n        );\n      }\n      fromHash = match.metadata.to;\n      fromContractSourceDir = match.dirPath;\n    } else {\n      const latestMigration = findLatestMigration(graph);\n      if (latestMigration) {\n        fromHash = latestMigration.to;\n        const leafPkg = packages.find(\n          (p) => p.metadata.migrationHash === latestMigration.migrationHash,\n        );\n        if (leafPkg) {\n          fromContractSourceDir = leafPkg.dirPath;\n        }\n      }\n    }\n  }\n\n  if (fromHash === toStorageHash && !options.from) {\n    return notOk(\n      errorRuntime('No changes detected', {\n        why: 'The from and to contract hashes are identical — there is nothing to migrate.',\n        fix: 'Change the contract and run `prisma-next contract emit` before creating a new migration. To author a data-only migration on the current contract hash, pass `--from <hash>` explicitly.',\n      }),\n    );\n  }\n\n  const timestamp = new Date();\n  const slug = options.name ?? 'migration';\n  const dirName = formatMigrationDirName(timestamp, slug);\n  const packageDir = join(appMigrationsDir, dirName);\n\n  // `migration new` scaffolds an empty `migration.ts` for the user to\n  // fill, so we attest over `ops: []`. Re-running self-emit after the\n  // user adds operations will produce a different `migrationHash` (over\n  // the real ops). This is intentional — there is no on-disk draft.\n  const baseMetadata: Omit<MigrationMetadata, 'migrationHash'> = {\n    from: fromHash,\n    to: toStorageHash,\n    providedInvariants: [],\n    createdAt: timestamp.toISOString(),\n  };\n  const metadata: MigrationMetadata = {\n    ...baseMetadata,\n    migrationHash: computeMigrationHash(baseMetadata, []),\n  };\n\n  const migrations = getTargetMigrations(config.target);\n  if (!migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.targetId}\" does not support migrations`,\n      }),\n    );\n  }\n\n  try {\n    assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [\n      config.target,\n      config.adapter,\n      ...(config.extensionPacks ?? []),\n    ]);\n\n    await writeMigrationPackage(packageDir, metadata, []);\n    const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);\n    await copyFilesWithRename(packageDir, [\n      { sourcePath: destinationArtifacts.jsonPath, destName: 'end-contract.json' },\n      { sourcePath: destinationArtifacts.dtsPath, destName: 'end-contract.d.ts' },\n    ]);\n    if (fromContractSourceDir !== null) {\n      const sourceArtifacts = getEmittedArtifactPaths(\n        join(fromContractSourceDir, 'end-contract.json'),\n      );\n      try {\n        await copyFilesWithRename(packageDir, [\n          { sourcePath: sourceArtifacts.jsonPath, destName: 'start-contract.json' },\n          { sourcePath: sourceArtifacts.dtsPath, destName: 'start-contract.d.ts' },\n        ]);\n      } catch (error) {\n        if (error instanceof Error && (error as { code?: string }).code === 'ENOENT') {\n          return notOk(\n            errorFileNotFound(sourceArtifacts.jsonPath, {\n              why: `Predecessor migration is missing its destination contract snapshot at ${sourceArtifacts.jsonPath}`,\n              fix: 'Re-emit the predecessor migration (`prisma-next migration plan` from its source) so its sibling `end-contract.json` is restored, then re-run this command.',\n            }),\n          );\n        }\n        throw error;\n      }\n    }\n\n    const planner = migrations.createPlanner(familyInstance);\n    const emptyPlan = planner.emptyMigration(\n      {\n        packageDir,\n        contractJsonPath: join(packageDir, 'end-contract.json'),\n        fromHash,\n        toHash: toStorageHash,\n      },\n      APP_SPACE_ID,\n    );\n    await writeMigrationTs(packageDir, emptyPlan.renderTypeScript());\n\n    return ok({\n      ok: true as const,\n      dir: relative(process.cwd(), packageDir),\n      from: fromHash,\n      to: toStorageHash,\n      summary: `Scaffolded migration at ${relative(process.cwd(), packageDir)}`,\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to scaffold migration: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n}\n\nexport function createMigrationNewCommand(): Command {\n  const command = new Command('new');\n  setCommandDescriptions(\n    command,\n    'Scaffold a new migration for manual authoring',\n    'Creates a migration package with a migration.ts file for manual authoring.\\n' +\n      'Write the migration body in migration.ts, then run the file with Node\\n' +\n      '(`node migration.ts`) to self-emit ops.json and attest the package.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration new --name split-name',\n    'prisma-next migration new --name custom-fk --from sha256:abc...',\n  ]);\n  addGlobalOptions(command)\n    .option('--name <slug>', 'Migration name (used in directory name)')\n    .option('--from <hash>', 'Starting contract hash (default: latest migration target)')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: MigrationNewOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n\n      if (!flags.json && !flags.quiet) {\n        const header = formatStyledHeader({\n          command: 'migration new',\n          description: 'Scaffold a new migration',\n          details: [],\n          flags,\n        });\n        ui.stderr(header);\n      }\n\n      const result = await executeMigrationNewCommand(options);\n\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value, null, 2));\n        } else if (!flags.quiet) {\n          ui.output(`\\nScaffolded migration at ${value.dir}`);\n          ui.output(`  from: ${value.from}`);\n          ui.output(`  to:   ${value.to}`);\n          ui.output(\n            `\\nEdit migration.ts, then run it directly (\\`node \"${value.dir}/migration.ts\"\\`) to self-emit and attest.`,\n          );\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

package/dist/commands/migration-plan.d.mts

@@ -1,4 +1,4 @@
-import { t as GlobalFlags } from "../global-flags-Dvibm2yu.mjs";
+import { t as GlobalFlags } from "../global-flags-DWsQ6SSI.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { OperationPreview } from "@prisma-next/framework-components/control";

package/dist/commands/migration-plan.mjs

@@ -1,2 +1,2 @@
-import { n as formatMigrationPlanOutput, r as resolveBundleByPrefix, t as createMigrationPlanCommand } from "../migration-plan-BHoeET4O.mjs";
+import { n as formatMigrationPlanOutput, r as resolveBundleByPrefix, t as createMigrationPlanCommand } from "../migration-plan-BLvOmNCu.mjs";
 export { createMigrationPlanCommand, formatMigrationPlanOutput, resolveBundleByPrefix };

package/dist/commands/migration-show.d.mts

@@ -1,15 +1,10 @@
-import { N as CliStructuredError } from "../types-UWB2-rrw.mjs";
+import { N as CliStructuredError } from "../types-CEtm6v6a.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { OperationPreview } from "@prisma-next/framework-components/control";
-import { OnDiskMigrationPackage } from "@prisma-next/migration-tools/package";
 
 //#region src/commands/migration-show.d.ts
-/**
- * Details of one space's latest (or targeted) migration package.
- */
-interface MigrationShowSpacePresent {
-  readonly kind: 'present';
+interface MigrationShowPresent {
   readonly spaceId: string;
   readonly dirName: string;
   readonly dirPath: string;
@@ -22,61 +17,15 @@ interface MigrationShowSpacePresent {
     readonly label: string;
     readonly operationClass: string;
   }[];
-  /**
-   * Family-agnostic textual preview of the migration's operations. Always
-   * defined; statements is empty for a no-op migration or a family that does
-   * not implement the `OperationPreviewCapable` capability.
-   */
   readonly preview: OperationPreview;
   readonly summary: string;
 }
-/**
- * Placeholder for a loaded contract space that has no on-disk migration
- * package — the extension descriptor declared the space but no migrations
- * directory has been materialised for it yet. Surfaces the space in the
- * response so JSON consumers see every loaded extension instead of having
- * silently-skipped entries.
- */
-interface MigrationShowSpaceMissing {
-  readonly kind: 'missing';
-  readonly spaceId: string;
-  readonly summary: string;
-}
-type MigrationShowSpaceResult = MigrationShowSpacePresent | MigrationShowSpaceMissing;
 interface MigrationShowResult {
   readonly ok: true;
-  /**
-   * Per-space results, ordered: app first, then extensions alphabetically
-   * (matching the aggregate's canonical ordering).
-   */
-  readonly spaces: readonly MigrationShowSpaceResult[];
+  readonly migration: MigrationShowPresent;
 }
-/**
- * Validate that a path-like `migration show` target resolves inside the app
- * migrations directory. The returned result is always emitted under
- * `aggregate.app.spaceId`, so accepting an extension-space (or otherwise
- * external) path here would silently mislabel the result. Returns the
- * resolved absolute path on success.
- *
- * `pathe.relative` can return an absolute path when the target cannot be
- * expressed relative to the base (e.g. on Windows when `target` is on a
- * different drive than `appMigrationsDir`). That case does not start with
- * `..`, so the absolute-check below is required to reject cross-drive
- * targets rather than mislabeling them as app-space.
- */
 declare function resolveAppTargetPath(target: string, appMigrationsDir: string, appMigrationsRelative: string): Result<string, CliStructuredError>;
-declare function resolveByHashPrefix(packages: readonly OnDiskMigrationPackage[], prefix: string): Result<OnDiskMigrationPackage, CliStructuredError>;
-/**
- * Resolve the latest migration from a space directory.
- *
- * Returns `ok(null)` only when the directory is empty or absent (ENOENT is
- * absorbed by `readMigrationsDir`). If `readMigrationsDir` returned packages
- * but `findLatestMigration` cannot pick a leaf, the on-disk history is
- * corrupt — return a runtime error rather than collapsing it to a `missing`
- * placeholder, which would hide the corruption from the caller.
- */
-declare function resolveLatestFromDir(spaceDir: string): Promise<Result<OnDiskMigrationPackage | null, CliStructuredError>>;
 declare function createMigrationShowCommand(): Command;
 //#endregion
-export { MigrationShowResult, MigrationShowSpaceMissing, MigrationShowSpacePresent, MigrationShowSpaceResult, createMigrationShowCommand, resolveAppTargetPath, resolveByHashPrefix, resolveLatestFromDir };
+export { MigrationShowPresent, MigrationShowResult, createMigrationShowCommand, resolveAppTargetPath };
 //# sourceMappingURL=migration-show.d.mts.map

package/dist/commands/migration-show.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"mappings":";;;;;;;;;AAwDA;UAAiB,yBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EAAA;;;;;EAAA,SAOF,OAAA,EAAS,gBAAgB;EAAA,SACzB,OAAA;AAAA;;;;;;;AAaO;UAHD,yBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;AAAA;AAAA,KAGC,wBAAA,GAA2B,yBAAA,GAA4B,yBAAyB;AAAA,UAE3E,mBAAA;EAAA,SACN,EAAA;EAKyC;;;;EAAA,SAAzC,MAAA,WAAiB,wBAAwB;AAAA;AAoBpD;;;;;;;;;;AAIoC;AAmBpC;;AAvBA,iBAAgB,oBAAA,CACd,MAAA,UACA,gBAAA,UACA,qBAAA,WACC,MAAM,SAAS,kBAAA;AAAA,iBAmBF,mBAAA,CACd,QAAA,WAAmB,sBAAA,IACnB,MAAA,WACC,MAAA,CAAO,sBAAA,EAAwB,kBAAA;;;;;;;;;;iBAmCZ,oBAAA,CACpB,QAAA,WACC,OAAA,CAAQ,MAAA,CAAO,sBAAA,SAA+B,kBAAA;AAAA,iBAgSjC,0BAAA,CAAA,GAA8B,OAAO"}
+{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"mappings":";;;;;;UA6CiB,oBAAA;EAAA,SACN,OAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,SAAA;EAAA,SACA,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EAAA,SAEF,OAAA,EAAS,gBAAgB;EAAA,SACzB,OAAA;AAAA;AAAA,UAGM,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA,EAAW,oBAAoB;AAAA;AAAA,iBAO1B,oBAAA,CACd,MAAA,UACA,gBAAA,UACA,qBAAA,WACC,MAAM,SAAS,kBAAA;AAAA,iBAqLF,0BAAA,CAAA,GAA8B,OAAO"}

package/dist/commands/migration-show.mjs

@@ -1,38 +1,21 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { A as mapRefResolutionError, C as errorRuntime, O as errorUnexpected, a as errorContractValidationFailed, k as mapMigrationToolsError, l as errorFileNotFound } from "../cli-errors-DFF1LlfU.mjs";
-import { A as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions, v as parseGlobalFlagsOrExit, w as handleResult, y as createTerminalUI } from "../command-helpers-yLuA78TP.mjs";
-import { t as createControlClient } from "../client-a5NJce0-.mjs";
-import { t as buildContractSpaceAggregate } from "../contract-space-aggregate-loader-EVU3n9YE.mjs";
-import { a as formatMigrationShowOutput } from "../migrations-D-UCOGtk.mjs";
+import { A as mapRefResolutionError, C as errorRuntime, O as errorUnexpected, a as errorContractValidationFailed, l as errorFileNotFound } from "../cli-errors-DFF1LlfU.mjs";
+import { A as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions, v as parseGlobalFlagsOrExit, w as handleResult, y as createTerminalUI } from "../command-helpers-CI8P5Xyd.mjs";
+import { t as createControlClient } from "../client-5uvDppD8.mjs";
+import { a as formatMigrationShowOutput } from "../migrations-vzQt9LI2.mjs";
 import { Command } from "commander";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { isAbsolute, relative, resolve } from "pathe";
 import { readFile } from "node:fs/promises";
 import { APP_SPACE_ID, createControlStack } from "@prisma-next/framework-components/control";
-import { readMigrationPackage, readMigrationsDir } from "@prisma-next/migration-tools/io";
-import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/migration-graph";
-import { spaceMigrationDirectory } from "@prisma-next/migration-tools/spaces";
-import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
-import { readRefs } from "@prisma-next/migration-tools/refs";
+import { loadContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
+import { castAs } from "@prisma-next/utils/casts";
 import { parseMigrationRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/migration-show.ts
 function looksLikePath(target) {
 	return target.includes("/") || target.includes("\\");
 }
-/**
-* Validate that a path-like `migration show` target resolves inside the app
-* migrations directory. The returned result is always emitted under
-* `aggregate.app.spaceId`, so accepting an extension-space (or otherwise
-* external) path here would silently mislabel the result. Returns the
-* resolved absolute path on success.
-*
-* `pathe.relative` can return an absolute path when the target cannot be
-* expressed relative to the base (e.g. on Windows when `target` is on a
-* different drive than `appMigrationsDir`). That case does not start with
-* `..`, so the absolute-check below is required to reject cross-drive
-* targets rather than mislabeling them as app-space.
-*/
 function resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative) {
 	const targetPath = resolve(target);
 	const relativeToApp = relative(appMigrationsDir, targetPath);
@@ -42,48 +25,10 @@ function resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative) {
 	}));
 	return ok(targetPath);
 }
-function resolveByHashPrefix(packages, prefix) {
-	const normalizedPrefix = prefix.startsWith("sha256:") ? prefix : `sha256:${prefix}`;
-	const matches = packages.filter((p) => p.metadata.migrationHash.startsWith(normalizedPrefix));
-	if (matches.length === 1) return ok(matches[0]);
-	if (matches.length === 0) return notOk(errorRuntime("No migration found matching prefix", {
-		why: `No migration has a migrationHash starting with "${normalizedPrefix}"`,
-		fix: "Run `prisma-next migration show` (no argument) to see the latest migration, or check the migrations directory for available packages."
-	}));
-	return notOk(errorRuntime("Ambiguous hash prefix", {
-		why: `Multiple migrations match prefix "${normalizedPrefix}":\n${matches.map((p) => `  ${p.dirName}  ${p.metadata.migrationHash}`).join("\n")}`,
-		fix: "Provide a longer prefix to uniquely identify the migration."
-	}));
-}
-/**
-* Resolve the latest migration from a space directory.
-*
-* Returns `ok(null)` only when the directory is empty or absent (ENOENT is
-* absorbed by `readMigrationsDir`). If `readMigrationsDir` returned packages
-* but `findLatestMigration` cannot pick a leaf, the on-disk history is
-* corrupt — return a runtime error rather than collapsing it to a `missing`
-* placeholder, which would hide the corruption from the caller.
-*/
-async function resolveLatestFromDir(spaceDir) {
-	try {
-		const allPackages = await readMigrationsDir(spaceDir);
-		if (allPackages.length === 0) return ok(null);
-		const latestMigration = findLatestMigration(reconstructGraph(allPackages));
-		if (!latestMigration) return notOk(errorRuntime("Could not resolve latest migration", {
-			why: `No latest migration found in ${relative(process.cwd(), spaceDir)}`,
-			fix: "The migrations directory may be corrupted. Inspect the migration.json files."
-		}));
-		return ok(allPackages.find((p) => p.metadata.migrationHash === latestMigration.migrationHash) ?? null);
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read migrations: ${error instanceof Error ? error.message : String(error)}` }));
-	}
-}
-function pkgToSpaceResult(spaceId, pkg, client) {
-	const ops = pkg.ops;
+function pkgToPresent(spaceId, pkg, client) {
+	const ops = castAs(pkg.ops);
 	const preview = client.toOperationPreview(ops) ?? { statements: [] };
 	return {
-		kind: "present",
 		spaceId,
 		dirName: pkg.dirName,
 		dirPath: relative(process.cwd(), pkg.dirPath),
@@ -100,34 +45,37 @@ function pkgToSpaceResult(spaceId, pkg, client) {
 		summary: `${ops.length} operation(s)`
 	};
 }
+function findPackageByDirPath(packages, resolvedDirPath) {
+	const normalized = resolve(resolvedDirPath);
+	return packages.find((p) => resolve(p.dirPath) === normalized);
+}
 async function executeMigrationShowCommand(target, options, flags, ui) {
 	const config = await loadConfig(options.config);
-	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(options.config, config);
+	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
 	const contractPathAbsolute = resolveContractPath(config);
 	const contractPath = relative(process.cwd(), contractPathAbsolute);
 	if (!flags.json && !flags.quiet) {
-		const details = [
-			{
-				label: "config",
-				value: configPath
-			},
-			{
-				label: "contract",
-				value: contractPath
-			},
-			{
-				label: "migrations",
-				value: appMigrationsRelative
-			}
-		];
-		if (target) details.push({
-			label: "target",
-			value: target
-		});
 		const header = formatStyledHeader({
 			command: "migration show",
 			description: "Display migration package contents",
-			details,
+			details: [
+				{
+					label: "config",
+					value: configPath
+				},
+				{
+					label: "contract",
+					value: contractPath
+				},
+				{
+					label: "migrations",
+					value: appMigrationsRelative
+				},
+				{
+					label: "target",
+					value: target
+				}
+			],
 			flags
 		});
 		ui.stderr(header);
@@ -139,38 +87,6 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 		...ifDefined("driver", config.driver),
 		extensionPacks: config.extensionPacks ?? []
 	});
-	if (target) try {
-		let appPkg;
-		if (looksLikePath(target)) {
-			const resolved = resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative);
-			if (!resolved.ok) return resolved;
-			appPkg = await readMigrationPackage(resolved.value);
-		} else {
-			const allPackages = await readMigrationsDir(appMigrationsDir);
-			if (allPackages.length === 0) return notOk(errorRuntime("No migrations found", {
-				why: `No migration packages found in ${appMigrationsRelative}`,
-				fix: "Run `prisma-next migration plan` to create a migration first."
-			}));
-			const migResult = parseMigrationRef(target, {
-				graph: reconstructGraph(allPackages),
-				refs: await readRefs(refsDir)
-			});
-			if (!migResult.ok) return notOk(mapRefResolutionError(migResult.failure));
-			const matchedPkg = allPackages.find((p) => p.metadata.migrationHash === migResult.value.migrationHash);
-			if (!matchedPkg) return notOk(errorRuntime("Migration package not found", {
-				why: `Resolved migration "${migResult.value.dirName}" but the package was not loaded`,
-				fix: "The migrations directory may be corrupted. Inspect the migration.json files."
-			}));
-			appPkg = matchedPkg;
-		}
-		return ok({
-			ok: true,
-			spaces: [pkgToSpaceResult(APP_SPACE_ID, appPkg, client)]
-		});
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read app-space migration: ${error instanceof Error ? error.message : String(error)}` }));
-	}
 	let contractJsonContent;
 	try {
 		contractJsonContent = await readFile(contractPathAbsolute, "utf-8");
@@ -185,60 +101,54 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 	const familyInstance = config.family.create(stack);
 	let appContract;
 	try {
-		appContract = familyInstance.deserializeContract(JSON.parse(contractJsonContent));
+		appContract = familyInstance.deserializeContract(castAs(JSON.parse(contractJsonContent)));
 	} catch (error) {
 		return notOk(errorContractValidationFailed(`Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`, { where: { path: contractPathAbsolute } }));
 	}
-	const aggregateResult = await buildContractSpaceAggregate({
-		targetId: config.target.targetId,
+	const aggregate = await loadContractSpaceAggregate({
 		migrationsDir,
 		appContract,
-		extensionPacks: config.extensionPacks ?? [],
 		deserializeContract: (json) => familyInstance.deserializeContract(json)
 	});
-	if (!aggregateResult.ok) return notOk(aggregateResult.failure);
-	const aggregate = aggregateResult.value;
-	const spaces = [];
-	try {
-		const allPackages = await readMigrationsDir(appMigrationsDir);
-		if (allPackages.length === 0) return notOk(errorRuntime("No migrations found", {
+	const packages = aggregate.app.packages;
+	const graph = aggregate.app.graph();
+	const refs = aggregate.app.refs;
+	let appPkg;
+	if (looksLikePath(target)) {
+		const resolved = resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative);
+		if (!resolved.ok) return resolved;
+		const matched = findPackageByDirPath(packages, resolved.value);
+		if (!matched) return notOk(errorRuntime("Migration package not found", {
+			why: `No loaded migration package at ${relative(process.cwd(), resolved.value)}`,
+			fix: "Pass a directory name, hash prefix, or path to an on-disk app-space migration package."
+		}));
+		appPkg = matched;
+	} else {
+		if (packages.length === 0) return notOk(errorRuntime("No migrations found", {
 			why: `No migration packages found in ${appMigrationsRelative}`,
 			fix: "Run `prisma-next migration plan` to create a migration first."
 		}));
-		const latestMigration = findLatestMigration(reconstructGraph(allPackages));
-		if (!latestMigration) return notOk(errorRuntime("Could not resolve latest migration", {
-			why: "No latest migration found in the migration history",
-			fix: "The migrations directory may be corrupted. Inspect the migration.json files."
-		}));
-		const leafPkg = allPackages.find((p) => p.metadata.migrationHash === latestMigration.migrationHash);
-		if (!leafPkg) return notOk(errorRuntime("Could not resolve latest migration", {
-			why: `Latest migration ${latestMigration.dirName} does not match any package`,
+		const migResult = parseMigrationRef(target, {
+			graph,
+			refs
+		});
+		if (!migResult.ok) return notOk(mapRefResolutionError(migResult.failure));
+		const matchedPkg = packages.find((p) => p.metadata.migrationHash === migResult.value.migrationHash);
+		if (!matchedPkg) return notOk(errorRuntime("Migration package not found", {
+			why: `Resolved migration "${migResult.value.dirName}" but the package was not loaded`,
 			fix: "The migrations directory may be corrupted. Inspect the migration.json files."
 		}));
-		spaces.push(pkgToSpaceResult(aggregate.app.spaceId, leafPkg, client));
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read app-space migration: ${error instanceof Error ? error.message : String(error)}` }));
-	}
-	for (const ext of aggregate.extensions) {
-		const extPkgResult = await resolveLatestFromDir(spaceMigrationDirectory(migrationsDir, ext.spaceId));
-		if (!extPkgResult.ok) return extPkgResult;
-		if (extPkgResult.value !== null) spaces.push(pkgToSpaceResult(ext.spaceId, extPkgResult.value, client));
-		else spaces.push({
-			kind: "missing",
-			spaceId: ext.spaceId,
-			summary: "No on-disk migration package for this space"
-		});
+		appPkg = matchedPkg;
 	}
 	return ok({
 		ok: true,
-		spaces
+		migration: pkgToPresent(APP_SPACE_ID, appPkg, client)
 	});
 }
 function createMigrationShowCommand() {
 	const command = new Command("show");
-	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, statement preview, and metadata for every loaded contract\nspace (app + extensions). Accepts a directory path or hash prefix to target a\nspecific app-space migration; defaults to the latest per space.");
-	setCommandExamples(command, ["prisma-next migration show", "prisma-next migration show sha256:a1b2c3"]);
+	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, statement preview, and metadata for one app-space migration.\nAccepts a directory path, directory name, or hash prefix.");
+	setCommandExamples(command, ["prisma-next migration show 20260101_100000_add_user", "prisma-next migration show sha256:a1b2c3"]);
 	setCommandSeeAlso(command, [
 		{
 			verb: "migration status",
@@ -257,7 +167,7 @@ function createMigrationShowCommand() {
 			oneLiner: "Show the migration graph topology"
 		}
 	]);
-	addGlobalOptions(command).argument("[target]", "Migration reference: directory name, hash/prefix, or path (defaults to latest)").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
+	addGlobalOptions(command).argument("<target>", "Migration reference: directory name, hash/prefix, or path").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
 		const flags = parseGlobalFlagsOrExit(options);
 		const ui = createTerminalUI(flags);
 		const exitCode = handleResult(await executeMigrationShowCommand(target, options, flags, ui), flags, ui, (showResult) => {
@@ -269,6 +179,6 @@ function createMigrationShowCommand() {
 	return command;
 }
 //#endregion
-export { createMigrationShowCommand, resolveAppTargetPath, resolveByHashPrefix, resolveLatestFromDir };
+export { createMigrationShowCommand, resolveAppTargetPath };
 
 //# sourceMappingURL=migration-show.mjs.map