prisma-next 0.8.0-dev.1 → 0.8.0-dev.11

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-list.mjs","names":[],"sources":["../../src/commands/migration-list.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/framework-components/control';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findPath } from '@prisma-next/migration-tools/migration-graph';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport {\n  type CliStructuredError,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationPackages,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n} from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationListOptions extends CommonCommandOptions {\n  readonly config?: string;\n}\n\nexport interface MigrationListEntry {\n  readonly dirName: string;\n  readonly from: string;\n  readonly to: string;\n  readonly migrationHash: string;\n  readonly operationCount: number;\n  readonly createdAt: string;\n}\n\nexport interface MigrationListResult {\n  readonly ok: true;\n  readonly migrations: readonly MigrationListEntry[];\n  readonly summary: string;\n}\n\nasync function executeMigrationListCommand(\n  options: MigrationListOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationListResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration list',\n      description: 'List on-disk migrations in topological order',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'migrations', value: appMigrationsRelative },\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let bundles: Awaited<ReturnType<typeof loadMigrationPackages>>['bundles'];\n  let graph: Awaited<ReturnType<typeof loadMigrationPackages>>['graph'];\n  try {\n    ({ bundles, graph } = await loadMigrationPackages(appMigrationsDir));\n  } catch (error) {\n    if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read migrations: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  if (bundles.length === 0) {\n    return ok({ ok: true, migrations: [], summary: 'No migrations found' });\n  }\n\n  const leaves = [...graph.nodes].filter(\n    (n) => !graph.forwardChain.has(n) || graph.forwardChain.get(n)!.length === 0,\n  );\n  const targetHash =\n    leaves.length === 1 ? leaves[0]! : ([...graph.nodes].values().next().value as string);\n  const chain = findPath(graph, EMPTY_CONTRACT_HASH, targetHash) ?? [];\n\n  const pkgByDirName = new Map(bundles.map((p) => [p.dirName, p]));\n  const entries: MigrationListEntry[] = chain.map((edge) => {\n    const pkg = pkgByDirName.get(edge.dirName);\n    const ops = (pkg?.ops ?? []) as readonly MigrationPlanOperation[];\n    return {\n      dirName: edge.dirName,\n      from: edge.from,\n      to: edge.to,\n      migrationHash: edge.migrationHash,\n      operationCount: ops.length,\n      createdAt: edge.createdAt,\n    };\n  });\n\n  return ok({\n    ok: true,\n    migrations: entries,\n    summary: `${entries.length} migration(s) on disk`,\n  });\n}\n\nexport function createMigrationListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(\n    command,\n    'List on-disk migrations in topological order',\n    'Enumerates all migration packages under migrations/<space>/ in\\n' +\n      'topological order. Offline — does not consult the database.',\n  );\n  setCommandExamples(command, ['prisma-next migration list']);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration log', oneLiner: 'Show executed migration history' },\n    { verb: 'migration graph', oneLiner: 'Show the migration graph topology' },\n    { verb: 'migration show', oneLiner: 'Display migration package contents' },\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: MigrationListOptions) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeMigrationListCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (listResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(listResult, null, 2));\n        } else if (!flags.quiet) {\n          if (listResult.migrations.length === 0) {\n            ui.log('No migrations found');\n          } else {\n            for (const entry of listResult.migrations) {\n              ui.log(\n                `${entry.dirName}  ${entry.migrationHash.slice(0, 16)}…  ${entry.operationCount} op(s)`,\n              );\n            }\n            ui.log(`\\n${listResult.summary}`);\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":";;;;;;;;;;;AA6CA,eAAe,4BACb,SACA,OACA,IAC0D;CAC1D,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;CAC/C,MAAM,EAAE,YAAY,kBAAkB,0BAA0B,sBAC9D,QAAQ,QACR,OACD;CAED,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;EAC/B,MAAM,SAAS,mBAAmB;GAChC,SAAS;GACT,aAAa;GACb,SAAS,CACP;IAAE,OAAO;IAAU,OAAO;IAAY,EACtC;IAAE,OAAO;IAAc,OAAO;IAAuB,CACtD;GACD;GACD,CAAC;EACF,GAAG,OAAO,OAAO;;CAGnB,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,CAAC,CAAE,SAAS,SAAU,MAAM,sBAAsB,iBAAiB;UAC5D,OAAO;EACd,IAAI,oBAAoB,GAAG,MAAM,EAAE,OAAO,MAAM,uBAAuB,MAAM,CAAC;EAC9E,OAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EACtE,KAAK,8BAA8B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC1F,CAAC,CACH;;CAGH,IAAI,QAAQ,WAAW,GACrB,OAAO,GAAG;EAAE,IAAI;EAAM,YAAY,EAAE;EAAE,SAAS;EAAuB,CAAC;CAGzE,MAAM,SAAS,CAAC,GAAG,MAAM,MAAM,CAAC,QAC7B,MAAM,CAAC,MAAM,aAAa,IAAI,EAAE,IAAI,MAAM,aAAa,IAAI,EAAE,CAAE,WAAW,EAC5E;CACD,MAAM,aACJ,OAAO,WAAW,IAAI,OAAO,KAAO,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;CACvE,MAAM,QAAQ,SAAS,OAAO,qBAAqB,WAAW,IAAI,EAAE;CAEpE,MAAM,eAAe,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;CAChE,MAAM,UAAgC,MAAM,KAAK,SAAS;EAExD,MAAM,MADM,aAAa,IAAI,KAAK,QAClB,EAAE,OAAO,EAAE;EAC3B,OAAO;GACL,SAAS,KAAK;GACd,MAAM,KAAK;GACX,IAAI,KAAK;GACT,eAAe,KAAK;GACpB,gBAAgB,IAAI;GACpB,WAAW,KAAK;GACjB;GACD;CAEF,OAAO,GAAG;EACR,IAAI;EACJ,YAAY;EACZ,SAAS,GAAG,QAAQ,OAAO;EAC5B,CAAC;;AAGJ,SAAgB,6BAAsC;CACpD,MAAM,UAAU,IAAI,QAAQ,OAAO;CACnC,uBACE,SACA,gDACA,8HAED;CACD,mBAAmB,SAAS,CAAC,6BAA6B,CAAC;CAC3D,kBAAkB,SAAS;EACzB;GAAE,MAAM;GAAoB,UAAU;GAA0C;EAChF;GAAE,MAAM;GAAiB,UAAU;GAAmC;EACtE;GAAE,MAAM;GAAmB,UAAU;GAAqC;EAC1E;GAAE,MAAM;GAAkB,UAAU;GAAsC;EAC3E,CAAC;CACF,iBAAiB,QAAQ,CACtB,OAAO,mBAAmB,gCAAgC,CAC1D,OAAO,OAAO,YAAkC;EAC/C,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,KAAK,IAAI,WAAW;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,CAAC;EAEjF,MAAM,WAAW,aAAa,MADT,4BAA4B,SAAS,OAAO,GAAG,EAC9B,OAAO,KAAK,eAAe;GAC/D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,YAAY,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,OAChB,IAAI,WAAW,WAAW,WAAW,GACnC,GAAG,IAAI,sBAAsB;QACxB;IACL,KAAK,MAAM,SAAS,WAAW,YAC7B,GAAG,IACD,GAAG,MAAM,QAAQ,IAAI,MAAM,cAAc,MAAM,GAAG,GAAG,CAAC,KAAK,MAAM,eAAe,QACjF;IAEH,GAAG,IAAI,KAAK,WAAW,UAAU;;IAGrC;EACF,QAAQ,KAAK,SAAS;GACtB;CACJ,OAAO"}

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

@@ -0,0 +1,21 @@
+import { Command } from "commander";
+
+//#region src/commands/migration-log.d.ts
+interface MigrationLogEntry {
+  readonly dirName: string;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationHash: string;
+  readonly operationCount: number;
+  readonly createdAt: string;
+}
+interface MigrationLogResult {
+  readonly ok: true;
+  readonly markerHash: string | null;
+  readonly applied: readonly MigrationLogEntry[];
+  readonly summary: string;
+}
+declare function createMigrationLogCommand(): Command;
+//#endregion
+export { MigrationLogEntry, MigrationLogResult, createMigrationLogCommand };
+//# sourceMappingURL=migration-log.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-log.d.mts","names":[],"sources":["../../src/commands/migration-log.ts"],"mappings":";;;UAqCiB,iBAAA;EAAA,SACN,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,cAAA;EAAA,SACA,SAAA;AAAA;AAAA,UAGM,kBAAA;EAAA,SACN,EAAA;EAAA,SACA,UAAA;EAAA,SACA,OAAA,WAAkB,iBAAA;EAAA,SAClB,OAAA;AAAA;AAAA,iBA0HK,yBAAA,CAAA,GAA6B,OAAA"}

package/dist/commands/migration-log.mjs

@@ -0,0 +1,146 @@
+import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
+import { _ as errorUnexpected, c as errorDriverRequired, o as errorDatabaseConnectionRequired, v as mapMigrationToolsError } from "../cli-errors-CF60g2cG.mjs";
+import { _ as parseGlobalFlags, a as loadMigrationPackages, b as formatStyledHeader, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, m as targetSupportsMigrations, o as maskConnectionUrl, p as setCommandSeeAlso, t as addGlobalOptions } from "../command-helpers-D3vL5yi8.mjs";
+import { t as handleResult } from "../result-handler-Bm_6dDYg.mjs";
+import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
+import { t as createControlClient } from "../client-XkUw4xD0.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { findPath } from "@prisma-next/migration-tools/migration-graph";
+import { cyan, dim } from "colorette";
+import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
+//#region src/commands/migration-log.ts
+async function executeMigrationLogCommand(options, flags, ui) {
+	const config = await loadConfig(options.config);
+	const { configPath, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
+	const dbConnection = options.db ?? config.db?.connection;
+	if (!dbConnection) return notOk(errorDatabaseConnectionRequired({
+		why: `Database connection is required for migration log (set db.connection in ${configPath}, or pass --db <url>)`,
+		commandName: "migration log"
+	}));
+	if (!config.driver) return notOk(errorDriverRequired({ why: "Config.driver is required for migration log" }));
+	if (!targetSupportsMigrations(config.target)) return notOk(errorUnexpected("Target does not support migrations"));
+	if (!flags.json && !flags.quiet) {
+		const header = formatStyledHeader({
+			command: "migration log",
+			description: "Show executed migration history",
+			details: [
+				{
+					label: "config",
+					value: configPath
+				},
+				{
+					label: "migrations",
+					value: appMigrationsRelative
+				},
+				...typeof dbConnection === "string" ? [{
+					label: "database",
+					value: maskConnectionUrl(dbConnection)
+				}] : []
+			],
+			flags
+		});
+		ui.stderr(header);
+	}
+	let bundles;
+	let graph;
+	try {
+		({bundles, graph} = await loadMigrationPackages(appMigrationsDir));
+	} 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)}` }));
+	}
+	const client = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		driver: config.driver,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	try {
+		await client.connect(dbConnection);
+		const markerHash = (await client.readMarker())?.storageHash ?? null;
+		if (!markerHash) return ok({
+			ok: true,
+			markerHash: null,
+			applied: [],
+			summary: "No migrations applied (database has no marker)"
+		});
+		const appliedPath = findPath(graph, EMPTY_CONTRACT_HASH, markerHash);
+		if (appliedPath === null) return notOk(errorUnexpected("Database marker is not reachable from migration history", {
+			why: `Marker hash ${markerHash} is not reachable from the root of the on-disk migration graph.`,
+			fix: "The database may have been migrated outside this project. Use `migration status` to inspect the current state."
+		}));
+		const pkgByDirName = new Map(bundles.map((p) => [p.dirName, p]));
+		const entries = appliedPath.map((edge) => {
+			const ops = pkgByDirName.get(edge.dirName)?.ops ?? [];
+			return {
+				dirName: edge.dirName,
+				from: edge.from,
+				to: edge.to,
+				migrationHash: edge.migrationHash,
+				operationCount: ops.length,
+				createdAt: edge.createdAt
+			};
+		});
+		return ok({
+			ok: true,
+			markerHash,
+			applied: entries,
+			summary: `${entries.length} migration(s) applied`
+		});
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read migration log: ${error instanceof Error ? error.message : String(error)}` }));
+	} finally {
+		await client.close();
+	}
+}
+function createMigrationLogCommand() {
+	const command = new Command("log");
+	setCommandDescriptions(command, "Show executed migration history", "Reads the database marker and displays the applied migration chain\nfrom the initial state to the current marker position.");
+	setCommandExamples(command, ["prisma-next migration log --db $DATABASE_URL", "prisma-next migration log --json --db $DATABASE_URL"]);
+	setCommandSeeAlso(command, [
+		{
+			verb: "migration status",
+			oneLiner: "Show migration path and pending status"
+		},
+		{
+			verb: "migration list",
+			oneLiner: "List on-disk migrations"
+		},
+		{
+			verb: "migration graph",
+			oneLiner: "Show the migration graph topology"
+		},
+		{
+			verb: "migration show",
+			oneLiner: "Display migration package contents"
+		}
+	]);
+	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").action(async (options) => {
+		const flags = parseGlobalFlags(options);
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeMigrationLogCommand(options, flags, ui), flags, ui, (logResult) => {
+			if (flags.json) ui.output(JSON.stringify(logResult, null, 2));
+			else if (!flags.quiet) {
+				const c = (fn, s) => flags.color !== false ? fn(s) : s;
+				if (logResult.applied.length === 0) ui.log(logResult.summary);
+				else {
+					for (const entry of logResult.applied) ui.log(`${c(cyan, "✓")} ${entry.dirName}  ${c(dim, entry.migrationHash.slice(0, 16) + "…")}  ${entry.operationCount} op(s)`);
+					ui.log(`\n${logResult.summary}`);
+				}
+			}
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+//#endregion
+export { createMigrationLogCommand };
+
+//# sourceMappingURL=migration-log.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-log.mjs","names":[],"sources":["../../src/commands/migration-log.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/framework-components/control';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findPath } from '@prisma-next/migration-tools/migration-graph';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { cyan, dim } from 'colorette';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport {\n  type CliStructuredError,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationPackages,\n  maskConnectionUrl,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationLogOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n}\n\nexport interface MigrationLogEntry {\n  readonly dirName: string;\n  readonly from: string;\n  readonly to: string;\n  readonly migrationHash: string;\n  readonly operationCount: number;\n  readonly createdAt: string;\n}\n\nexport interface MigrationLogResult {\n  readonly ok: true;\n  readonly markerHash: string | null;\n  readonly applied: readonly MigrationLogEntry[];\n  readonly summary: string;\n}\n\nasync function executeMigrationLogCommand(\n  options: MigrationLogOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationLogResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migration log (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migration log',\n      }),\n    );\n  }\n  if (!config.driver) {\n    return notOk(errorDriverRequired({ why: 'Config.driver is required for migration log' }));\n  }\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(errorUnexpected('Target does not support migrations'));\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration log',\n      description: 'Show executed migration history',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'migrations', value: appMigrationsRelative },\n        ...(typeof dbConnection === 'string'\n          ? [{ label: 'database', value: maskConnectionUrl(dbConnection) }]\n          : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let bundles: Awaited<ReturnType<typeof loadMigrationPackages>>['bundles'];\n  let graph: Awaited<ReturnType<typeof loadMigrationPackages>>['graph'];\n  try {\n    ({ bundles, graph } = await loadMigrationPackages(appMigrationsDir));\n  } catch (error) {\n    if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read migrations: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const marker = await client.readMarker();\n    const markerHash = marker?.storageHash ?? null;\n\n    if (!markerHash) {\n      return ok({\n        ok: true,\n        markerHash: null,\n        applied: [],\n        summary: 'No migrations applied (database has no marker)',\n      });\n    }\n\n    const appliedPath = findPath(graph, EMPTY_CONTRACT_HASH, markerHash);\n    if (appliedPath === null) {\n      return notOk(\n        errorUnexpected('Database marker is not reachable from migration history', {\n          why: `Marker hash ${markerHash} is not reachable from the root of the on-disk migration graph.`,\n          fix: 'The database may have been migrated outside this project. Use `migration status` to inspect the current state.',\n        }),\n      );\n    }\n    const pkgByDirName = new Map(bundles.map((p) => [p.dirName, p]));\n    const entries: MigrationLogEntry[] = appliedPath.map((edge) => {\n      const pkg = pkgByDirName.get(edge.dirName);\n      const ops = (pkg?.ops ?? []) as readonly MigrationPlanOperation[];\n      return {\n        dirName: edge.dirName,\n        from: edge.from,\n        to: edge.to,\n        migrationHash: edge.migrationHash,\n        operationCount: ops.length,\n        createdAt: edge.createdAt,\n      };\n    });\n\n    return ok({\n      ok: true,\n      markerHash,\n      applied: entries,\n      summary: `${entries.length} migration(s) applied`,\n    });\n  } catch (error) {\n    if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read migration log: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationLogCommand(): Command {\n  const command = new Command('log');\n  setCommandDescriptions(\n    command,\n    'Show executed migration history',\n    'Reads the database marker and displays the applied migration chain\\n' +\n      'from the initial state to the current marker position.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration log --db $DATABASE_URL',\n    'prisma-next migration log --json --db $DATABASE_URL',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\n    { verb: 'migration graph', oneLiner: 'Show the migration graph topology' },\n    { verb: 'migration show', oneLiner: 'Display migration package contents' },\n  ]);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: MigrationLogOptions) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeMigrationLogCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (logResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(logResult, null, 2));\n        } else if (!flags.quiet) {\n          const c = (fn: (s: string) => string, s: string) => (flags.color !== false ? fn(s) : s);\n          if (logResult.applied.length === 0) {\n            ui.log(logResult.summary);\n          } else {\n            for (const entry of logResult.applied) {\n              ui.log(\n                `${c(cyan, '✓')} ${entry.dirName}  ${c(dim, entry.migrationHash.slice(0, 16) + '…')}  ${entry.operationCount} op(s)`,\n              );\n            }\n            ui.log(`\\n${logResult.summary}`);\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"migration-new.d.mts","names":[],"sources":["../../src/commands/migration-new.ts"],"mappings":";;;iBAuQgB,yBAAA,CAAA,GAA6B,OAAA"}
+{"version":3,"file":"migration-new.d.mts","names":[],"sources":["../../src/commands/migration-new.ts"],"mappings":";;;iBA+QgB,yBAAA,CAAA,GAA6B,OAAA"}

package/dist/commands/migration-new.mjs

@@ -1,9 +1,9 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { _ as errorUnexpected, h as errorTargetMigrationNotSupported, m as errorRuntime, t as CliStructuredError, v as mapMigrationToolsError } from "../cli-errors-D3_sMh2K.mjs";
-import { t as assertFrameworkComponentsCompatible } from "../framework-components-ChqVUxR-.mjs";
-import { c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, g as parseGlobalFlags, i as getTargetMigrations, l as resolveMigrationPaths, t as addGlobalOptions, y as formatStyledHeader } from "../command-helpers-BeZHkxV8.mjs";
-import { t as TerminalUI } from "../terminal-ui-C_hFNbAn.mjs";
-import { t as handleResult } from "../result-handler-rmPVKIP2.mjs";
+import { _ as errorUnexpected, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime, t as CliStructuredError, v as mapMigrationToolsError } from "../cli-errors-CF60g2cG.mjs";
+import { t as assertFrameworkComponentsCompatible } from "../framework-components-xFLFpZUO.mjs";
+import { _ as parseGlobalFlags, b as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, i as getTargetMigrations, l as resolveMigrationPaths, t as addGlobalOptions } from "../command-helpers-D3vL5yi8.mjs";
+import { t as handleResult } from "../result-handler-Bm_6dDYg.mjs";
+import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
 import { Command } from "commander";
 import { getEmittedArtifactPaths } from "@prisma-next/emitter";
 import { notOk, ok } from "@prisma-next/utils/result";
@@ -53,7 +53,6 @@ async function executeMigrationNewCommand(options) {
 		why: `Contract at ${contractPathAbsolute} has no storageHash`,
 		fix: "Run `prisma-next contract emit` to regenerate the contract"
 	}));
-	let fromContract = null;
 	let fromHash = null;
 	let fromContractSourceDir = null;
 	try {
@@ -67,17 +66,13 @@ async function executeMigrationNewCommand(options) {
 					fix: "Check that the --from hash matches a known migration target hash."
 				}));
 				fromHash = match.metadata.to;
-				fromContract = match.metadata.toContract;
 				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) {
-						fromContract = leafPkg.metadata.toContract;
-						fromContractSourceDir = leafPkg.dirPath;
-					}
+					if (leafPkg) fromContractSourceDir = leafPkg.dirPath;
 				}
 			}
 		}
@@ -94,8 +89,6 @@ async function executeMigrationNewCommand(options) {
 	const baseMetadata = {
 		from: fromHash,
 		to: toStorageHash,
-		fromContract,
-		toContract: toContractJson,
 		hints: {
 			used: [],
 			applied: [],
@@ -128,13 +121,21 @@ async function executeMigrationNewCommand(options) {
 		}]);
 		if (fromContractSourceDir !== null) {
 			const sourceArtifacts = getEmittedArtifactPaths(join(fromContractSourceDir, "end-contract.json"));
-			await copyFilesWithRename(packageDir, [{
-				sourcePath: sourceArtifacts.jsonPath,
-				destName: "start-contract.json"
-			}, {
-				sourcePath: sourceArtifacts.dtsPath,
-				destName: "start-contract.d.ts"
-			}]);
+			try {
+				await copyFilesWithRename(packageDir, [{
+					sourcePath: sourceArtifacts.jsonPath,
+					destName: "start-contract.json"
+				}, {
+					sourcePath: sourceArtifacts.dtsPath,
+					destName: "start-contract.d.ts"
+				}]);
+			} catch (error) {
+				if (error instanceof Error && error.code === "ENOENT") return notOk(errorFileNotFound(sourceArtifacts.jsonPath, {
+					why: `Predecessor migration is missing its destination contract snapshot at ${sourceArtifacts.jsonPath}`,
+					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."
+				}));
+				throw error;
+			}
 		}
 		const stack = createControlStack(config);
 		const familyInstance = config.family.create(stack);

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 { readFileSync } from 'node:fs';\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  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 { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } 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  const contractPathAbsolute = resolveContractPath(config);\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = readFileSync(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 toContractJson: Contract;\n  try {\n    toContractJson = JSON.parse(contractJsonContent) as Contract;\n  } catch (error) {\n    return notOk(\n      errorRuntime('Contract JSON is invalid', {\n        why: `Failed to parse ${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 = (\n    (toContractJson as unknown as Record<string, unknown>)['storage'] as\n      | Record<string, unknown>\n      | undefined\n  )?.['storageHash'] as string | undefined;\n  if (!toStorageHash) {\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 fromContract: Contract | null = null;\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        fromContract = match.metadata.toContract;\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            fromContract = leafPkg.metadata.toContract;\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    fromContract,\n    toContract: toContractJson,\n    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '1.0.0',\n    },\n    labels: [],\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      await copyFilesWithRename(packageDir, [\n        { sourcePath: sourceArtifacts.jsonPath, destName: 'start-contract.json' },\n        { sourcePath: sourceArtifacts.dtsPath, destName: 'start-contract.d.ts' },\n      ]);\n    }\n\n    const stack = createControlStack(config);\n    const familyInstance = config.family.create(stack);\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 = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\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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"}
+{"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 { readFileSync } from 'node:fs';\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 { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } 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  const contractPathAbsolute = resolveContractPath(config);\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = readFileSync(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 toContractJson: Contract;\n  try {\n    toContractJson = JSON.parse(contractJsonContent) as Contract;\n  } catch (error) {\n    return notOk(\n      errorRuntime('Contract JSON is invalid', {\n        why: `Failed to parse ${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 = (\n    (toContractJson as unknown as Record<string, unknown>)['storage'] as\n      | Record<string, unknown>\n      | undefined\n  )?.['storageHash'] as string | undefined;\n  if (!toStorageHash) {\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    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '1.0.0',\n    },\n    labels: [],\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 stack = createControlStack(config);\n    const familyInstance = config.family.create(stack);\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 = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\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-Icqpxk23.mjs";
+import { t as GlobalFlags } from "../global-flags-DGmw6Kqg.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { OperationPreview } from "@prisma-next/framework-components/control";
@@ -20,7 +20,7 @@ interface MigrationPlanResult {
    * Surfacing these in the result (rather than only via `ui.step` log
    * lines) makes the cross-space side effect explicit to JSON consumers
    * and the success-summary renderer — the same multi-space side effect
-   * that `migration apply` will replay.
+   * that `migrate` will replay.
    */
   readonly emittedExtensionDirs: readonly {
     readonly spaceId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"migration-plan.d.mts","names":[],"sources":["../../src/commands/migration-plan.ts"],"mappings":";;;;;;UA4DiB,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,GAAA;EAJA;;;;;;;;;;;;EAAA,SAiBA,oBAAA;IAAA,SAA0C,OAAA;IAAA,SAA0B,OAAA;EAAA;EAAA,SACpE,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EA2Y6B;;;;AA4D1C;EA5D0C,SApY/B,OAAA,GAAU,gBAAA;EAAA,SACV,OAAA;EA+b8E;;;;;EAAA,SAzb9E,mBAAA;EAAA,SACA,OAAA;IAAA,SACE,KAAA;EAAA;AAAA;AAAA,iBA2XG,0BAAA,CAAA,GAA8B,OAAA;AAAA,iBA4D9B,yBAAA,CAA0B,MAAA,EAAQ,mBAAA,EAAqB,KAAA,EAAO,WAAA;AAAA,KA2HlE,uBAAA;EACN,MAAA;EAAqB,KAAA;AAAA;EACrB,MAAA;AAAA;;;;;;;;;;;;;;iBAeU,qBAAA;EAAkC,QAAA;IAAY,EAAA;EAAA;AAAA,EAAA,CAC5D,OAAA,WAAkB,CAAA,IAClB,MAAA,WACC,MAAA,CAAO,CAAA,EAAG,uBAAA"}
+{"version":3,"file":"migration-plan.d.mts","names":[],"sources":["../../src/commands/migration-plan.ts"],"mappings":";;;;;;UA0FiB,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,GAAA;EAJA;;;;;;;;;;;;EAAA,SAiBA,oBAAA;IAAA,SAA0C,OAAA;IAAA,SAA0B,OAAA;EAAA;EAAA,SACpE,UAAA;IAAA,SACE,EAAA;IAAA,SACA,KAAA;IAAA,SACA,cAAA;EAAA;EAiZ6B;;;;AA+D1C;EA/D0C,SA1Y/B,OAAA,GAAU,gBAAA;EAAA,SACV,OAAA;EAwc8E;;;;;EAAA,SAlc9E,mBAAA;EAAA,SACA,OAAA;IAAA,SACE,KAAA;EAAA;AAAA;AAAA,iBAiYG,0BAAA,CAAA,GAA8B,OAAA;AAAA,iBA+D9B,yBAAA,CAA0B,MAAA,EAAQ,mBAAA,EAAqB,KAAA,EAAO,WAAA;AAAA,KA2HlE,uBAAA;EACN,MAAA;EAAqB,KAAA;AAAA;EACrB,MAAA;AAAA;;;;;;;;;;;;;;iBAeU,qBAAA;EAAkC,QAAA;IAAY,EAAA;EAAA;AAAA,EAAA,CAC5D,OAAA,WAAkB,CAAA,IAClB,MAAA,WACC,MAAA,CAAO,CAAA,EAAG,uBAAA"}

package/dist/commands/migration-plan.mjs

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

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

@@ -1,4 +1,4 @@
-import { t as CliStructuredError } from "../cli-errors-B9OBbled.mjs";
+import { t as CliStructuredError } from "../cli-errors-DdcjVLJV.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { OperationPreview } from "@prisma-next/framework-components/control";

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":";;;;;;;;;AAmDA;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,gBAAA;EAAA,SACT,OAAA;AAAA;;;;;;;;UAUM,yBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;AAAA;AAAA,KAGC,wBAAA,GAA2B,yBAAA,GAA4B,yBAAA;AAAA,UAElD,mBAAA;EAAA,SACN,EAAA;EAKyC;;;;EAAA,SAAzC,MAAA,WAAiB,wBAAA;AAAA;AAoB5B;;;;;;;;;;;AAuBA;;AAvBA,iBAAgB,oBAAA,CACd,MAAA,UACA,gBAAA,UACA,qBAAA,WACC,MAAA,SAAe,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,iBAkOjC,0BAAA,CAAA,GAA8B,OAAA"}
+{"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,gBAAA;EAAA,SACT,OAAA;AAAA;;;;;;;;UAUM,yBAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA;AAAA;AAAA,KAGC,wBAAA,GAA2B,yBAAA,GAA4B,yBAAA;AAAA,UAElD,mBAAA;EAAA,SACN,EAAA;EAKyC;;;;EAAA,SAAzC,MAAA,WAAiB,wBAAA;AAAA;AAoB5B;;;;;;;;;;;AAuBA;;AAvBA,iBAAgB,oBAAA,CACd,MAAA,UACA,gBAAA,UACA,qBAAA,WACC,MAAA,SAAe,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,iBA4RjC,0BAAA,CAAA,GAA8B,OAAA"}

package/dist/commands/migration-show.mjs

@@ -1,21 +1,23 @@
 import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { _ as errorUnexpected, a as errorContractValidationFailed, l as errorFileNotFound, m as errorRuntime, v as mapMigrationToolsError } from "../cli-errors-D3_sMh2K.mjs";
-import { c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, g as parseGlobalFlags, l as resolveMigrationPaths, t as addGlobalOptions, y as formatStyledHeader } from "../command-helpers-BeZHkxV8.mjs";
-import { t as TerminalUI } from "../terminal-ui-C_hFNbAn.mjs";
-import { t as handleResult } from "../result-handler-rmPVKIP2.mjs";
-import { t as createControlClient } from "../client-4d26awB-.mjs";
-import { t as buildContractSpaceAggregate } from "../contract-space-aggregate-loader-BrwKK6Q6.mjs";
-import { a as formatMigrationShowOutput } from "../migrations-CTsyBXCA.mjs";
+import { _ as errorUnexpected, a as errorContractValidationFailed, l as errorFileNotFound, m as errorRuntime, v as mapMigrationToolsError, y as mapRefResolutionError } from "../cli-errors-CF60g2cG.mjs";
+import { _ as parseGlobalFlags, b as formatStyledHeader, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions } from "../command-helpers-D3vL5yi8.mjs";
+import { t as handleResult } from "../result-handler-Bm_6dDYg.mjs";
+import { t as TerminalUI } from "../terminal-ui-XtOQsqe9.mjs";
+import { t as createControlClient } from "../client-XkUw4xD0.mjs";
+import { t as buildContractSpaceAggregate } from "../contract-space-aggregate-loader-D68YpuPR.mjs";
+import { a as formatMigrationShowOutput } from "../migrations-DyUf5lTt.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 { createControlStack } from "@prisma-next/framework-components/control";
+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 { parseMigrationRef } from "@prisma-next/migration-tools/ref-resolution";
+import { readRefs } from "@prisma-next/migration-tools/refs";
 //#region src/commands/migration-show.ts
 function looksLikePath(target) {
 	return target.includes("/") || target.includes("\\");
@@ -102,7 +104,7 @@ function pkgToSpaceResult(spaceId, pkg, client) {
 }
 async function executeMigrationShowCommand(target, options, flags, ui) {
 	const config = await loadConfig(options.config);
-	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
+	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(options.config, config);
 	const contractPathAbsolute = resolveContractPath(config);
 	const contractPath = relative(process.cwd(), contractPathAbsolute);
 	if (!flags.json && !flags.quiet) {
@@ -132,6 +134,45 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 		});
 		ui.stderr(header);
 	}
+	const client = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		...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");
@@ -159,45 +200,24 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 	});
 	if (!aggregateResult.ok) return notOk(aggregateResult.failure);
 	const aggregate = aggregateResult.value;
-	const client = createControlClient({
-		family: config.family,
-		target: config.target,
-		adapter: config.adapter,
-		...ifDefined("driver", config.driver),
-		extensionPacks: config.extensionPacks ?? []
-	});
 	const spaces = [];
 	try {
-		let appPkg;
-		if (target && 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."
-			}));
-			if (target) {
-				const resolved = resolveByHashPrefix(allPackages, target);
-				if (!resolved.ok) return resolved;
-				appPkg = resolved.value;
-			} else {
-				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`,
-					fix: "The migrations directory may be corrupted. Inspect the migration.json files."
-				}));
-				appPkg = leafPkg;
-			}
-		}
-		spaces.push(pkgToSpaceResult(aggregate.app.spaceId, appPkg, client));
+		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 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`,
+			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)}` }));
@@ -221,7 +241,25 @@ 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"]);
-	addGlobalOptions(command).argument("[target]", "App-space migration path or migrationHash prefix (defaults to latest)").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
+	setCommandSeeAlso(command, [
+		{
+			verb: "migration status",
+			oneLiner: "Show migration path and pending status"
+		},
+		{
+			verb: "migration log",
+			oneLiner: "Show executed migration history"
+		},
+		{
+			verb: "migration list",
+			oneLiner: "List on-disk migrations"
+		},
+		{
+			verb: "migration graph",
+			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) => {
 		const flags = parseGlobalFlags(options);
 		const ui = new TerminalUI({
 			color: flags.color,