@prisma-next/cli 0.4.2 → 0.4.4

package/dist/commands/migration-plan.mjs

@@ -1,35 +1,22 @@
-import { t as loadConfig } from "../config-loader-C25b63rJ.mjs";
-import { _ as errorUnexpected, a as errorContractValidationFailed, f as errorMigrationPlanningFailed, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime, t as CliStructuredError } from "../cli-errors-Cd79vmTH.mjs";
-import { t as assertFrameworkComponentsCompatible } from "../framework-components-Cr--XBKy.mjs";
-import { t as extractSqlDdl } from "../extract-sql-ddl-D9UbZDyz.mjs";
-import { t as TerminalUI } from "../terminal-ui-C3ZLwQxK.mjs";
-import { _ as formatStyledHeader, c as resolveMigrationPaths, d as setCommandExamples, i as loadAllBundles, m as parseGlobalFlags, n as addGlobalOptions, r as getTargetMigrations, s as resolveContractPath, t as handleResult, u as setCommandDescriptions } from "../result-handler-Ba3zWQsI.mjs";
+import { t as loadConfig } from "../config-loader-ih8ViDb_.mjs";
+import { _ as errorUnexpected, a as errorContractValidationFailed, f as errorMigrationPlanningFailed, h as errorTargetMigrationNotSupported, l as errorFileNotFound, m as errorRuntime, t as CliStructuredError, v as mapMigrationToolsError } from "../cli-errors-By1iVE3z.mjs";
+import { t as assertFrameworkComponentsCompatible } from "../framework-components-Bgcre3Z6.mjs";
+import { t as TerminalUI } from "../terminal-ui-u2YgKghu.mjs";
+import { a as loadMigrationPackages, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, g as parseGlobalFlags, i as getTargetMigrations, l as resolveMigrationPaths, n as addGlobalOptions, t as handleResult, y as formatStyledHeader } from "../result-handler-Ch6hVnOo.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 { createControlStack } from "@prisma-next/framework-components/control";
-import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
 import { readFile } from "node:fs/promises";
-import { findLatestMigration } from "@prisma-next/migration-tools/dag";
+import { createControlStack, hasOperationPreview } from "@prisma-next/framework-components/control";
 import { copyFilesWithRename, formatMigrationDirName, writeMigrationPackage } from "@prisma-next/migration-tools/io";
-import { computeMigrationId } from "@prisma-next/migration-tools/attestation";
-import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { findLatestMigration } from "@prisma-next/migration-tools/migration-graph";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
+import { computeMigrationHash } from "@prisma-next/migration-tools/hash";
 import { writeMigrationTs } from "@prisma-next/migration-tools/migration-ts";
+import { deriveProvidedInvariants } from "@prisma-next/migration-tools/invariants";
 
 //#region src/commands/migration-plan.ts
-function mapMigrationToolsError(error) {
-	if (CliStructuredError.is(error)) return error;
-	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
-		why: error.why,
-		fix: error.fix,
-		meta: {
-			code: error.code,
-			...error.details ?? {}
-		}
-	});
-	return errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Unexpected error during migration plan: ${error instanceof Error ? error.message : String(error)}` });
-}
 async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	const config = await loadConfig(options.config);
 	const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(options.config, config);
@@ -87,10 +74,10 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	if (typeof rawStorageHash !== "string") return notOk(errorContractValidationFailed("Contract is missing storageHash", { where: { path: contractPathAbsolute } }));
 	const toStorageHash = rawStorageHash;
 	let fromContract = null;
-	let fromHash = EMPTY_CONTRACT_HASH;
+	let fromHash = null;
 	let fromContractSourceDir = null;
 	try {
-		const { bundles, graph } = await loadAllBundles(migrationsDir);
+		const { bundles, graph } = await loadMigrationPackages(migrationsDir);
 		if (options.from) {
 			const resolved = resolveBundleByPrefix(bundles, options.from);
 			if (!resolved.ok) {
@@ -103,23 +90,24 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 					fix: "Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration target."
 				}));
 			}
-			fromHash = resolved.value.manifest.to;
-			fromContract = resolved.value.manifest.toContract;
+			fromHash = resolved.value.metadata.to;
+			fromContract = resolved.value.metadata.toContract;
 			fromContractSourceDir = resolved.value.dirPath;
 		} else {
 			const latestMigration = findLatestMigration(graph);
 			if (latestMigration) {
 				fromHash = latestMigration.to;
-				const leafPkg = bundles.find((p) => p.manifest.migrationId === latestMigration.migrationId);
+				const leafPkg = bundles.find((p) => p.metadata.migrationHash === latestMigration.migrationHash);
 				if (leafPkg) {
-					fromContract = leafPkg.manifest.toContract;
+					fromContract = leafPkg.metadata.toContract;
 					fromContractSourceDir = leafPkg.dirPath;
 				}
 			}
 		}
 	} catch (error) {
 		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		throw error;
+		const message = error instanceof Error ? error.message : String(error);
+		return notOk(errorUnexpected(message, { why: `Unexpected error while loading migrations: ${message}` }));
 	}
 	if (fromHash === toStorageHash) return ok({
 		ok: true,
@@ -139,10 +127,9 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	]);
 	const timestamp = /* @__PURE__ */ new Date();
 	const packageDir = join(migrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
-	const baseManifest = {
+	const baseMetadata = {
 		from: fromHash,
 		to: toStorageHash,
-		kind: "regular",
 		fromContract,
 		toContract: toContractJson,
 		hints: {
@@ -167,7 +154,6 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 				"destructive",
 				"data"
 			] },
-			fromHash,
 			fromContract,
 			frameworkComponents
 		});
@@ -186,9 +172,13 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 		}
 		const migrationTsContent = plannerResult.plan.renderTypeScript();
 		const opsForWrite = hasPlaceholders ? [] : plannedOps;
+		const metadataWithInvariants = {
+			...baseMetadata,
+			providedInvariants: deriveProvidedInvariants(opsForWrite)
+		};
 		await writeMigrationPackage(packageDir, {
-			...baseManifest,
-			migrationId: computeMigrationId(baseManifest, opsForWrite)
+			...metadataWithInvariants,
+			migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite)
 		}, opsForWrite);
 		const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
 		await copyFilesWithRename(packageDir, [{
@@ -220,7 +210,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			summary: "Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit",
 			timings: { total: Date.now() - startTime }
 		});
-		const sql = extractSqlDdl(plannedOps);
+		const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(plannedOps) : void 0;
 		return ok({
 			ok: true,
 			noOp: false,
@@ -232,12 +222,15 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 				label: op.label,
 				operationClass: op.operationClass
 			})),
-			sql,
+			...preview !== void 0 ? { preview } : {},
 			summary: `Planned ${plannedOps.length} operation(s)`,
 			timings: { total: Date.now() - startTime }
 		});
 	} catch (error) {
-		return notOk(mapMigrationToolsError(error));
+		if (CliStructuredError.is(error)) return notOk(error);
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		const message = error instanceof Error ? error.message : String(error);
+		return notOk(errorUnexpected(message, { why: `Unexpected error during migration plan: ${message}` }));
 	}
 }
 function createMigrationPlanCommand() {
@@ -302,15 +295,16 @@ function formatMigrationPlanOutput(result, flags) {
 	lines.push(dim_(`to:     ${result.to}`));
 	if (result.dir) lines.push(dim_(`dir:    ${result.dir}`));
 	lines.push("");
-	lines.push(`Next: ${green_(`node ${result.dir ?? "<dir>"}/migration.ts`)} to emit ops.json and attest migrationId before running ${green_("prisma-next migration apply")}.`);
-	if (result.sql && result.sql.length > 0) {
+	lines.push(`Next: review ${green_(result.dir ?? "<dir>")} if needed, then run ${green_("prisma-next migration apply")}.`);
+	if (result.preview && result.preview.statements.length > 0) {
+		const allSql = result.preview.statements.every((s) => s.language === "sql");
 		lines.push("");
-		lines.push(dim_("DDL preview"));
+		lines.push(dim_(allSql ? "DDL preview" : "Operation preview"));
 		lines.push("");
-		for (const statement of result.sql) {
-			const trimmed = statement.trim();
+		for (const statement of result.preview.statements) {
+			const trimmed = statement.text.trim();
 			if (!trimmed) continue;
-			const line = trimmed.endsWith(";") ? trimmed : `${trimmed};`;
+			const line = statement.language === "sql" && !trimmed.endsWith(";") ? `${trimmed};` : trimmed;
 			lines.push(line);
 		}
 	}
@@ -321,20 +315,23 @@ function formatMigrationPlanOutput(result, flags) {
 	return lines.join("\n");
 }
 /**
-* Resolve a migration bundle by exact hash or prefix match.
+* Resolve a migration package by **target contract hash** (`metadata.to`)
+* using exact match or prefix match.
 *
+* Note: matches `metadata.to` (the contract hash this migration produces),
+* not `metadata.migrationHash` (the package's content-addressed identity).
 * Tries exact match first, then prefix match (auto-prepending `sha256:` when
-* the needle omits the scheme). Returns the matched bundle on success, or a
+* the needle omits the scheme). Returns the matched package on success, or a
 * discriminated failure indicating whether the prefix was ambiguous or simply
 * not found.
 *
 * @internal Exported for testing only.
 */
 function resolveBundleByPrefix(bundles, needle) {
-	const exact = bundles.find((p) => p.manifest.to === needle);
+	const exact = bundles.find((p) => p.metadata.to === needle);
 	if (exact) return ok(exact);
 	const prefixWithScheme = needle.startsWith("sha256:") ? needle : `sha256:${needle}`;
-	const candidates = bundles.filter((p) => p.manifest.to.startsWith(prefixWithScheme));
+	const candidates = bundles.filter((p) => p.metadata.to.startsWith(prefixWithScheme));
 	if (candidates.length === 1) return ok(candidates[0]);
 	if (candidates.length > 1) return notOk({
 		reason: "ambiguous",

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

@@ -1 +1 @@
-{"version":3,"file":"migration-plan.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","toContractJson: Contract","fromContract: Contract | null","fromHash: string","fromContractSourceDir: string | null","baseManifest: Omit<MigrationManifest, 'migrationId'>","plannedOps: readonly MigrationPlanOperation[]","lines: string[]"],"sources":["../../src/commands/migration-plan.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { getEmittedArtifactPaths } from '@prisma-next/emitter';\nimport {\n  createControlStack,\n  type MigrationPlanOperation,\n} from '@prisma-next/framework-components/control';\nimport { computeMigrationId } from '@prisma-next/migration-tools/attestation';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { findLatestMigration } from '@prisma-next/migration-tools/dag';\nimport {\n  copyFilesWithRename,\n  formatMigrationDirName,\n  writeMigrationPackage,\n} from '@prisma-next/migration-tools/io';\nimport { writeMigrationTs } from '@prisma-next/migration-tools/migration-ts';\nimport { type MigrationManifest, MigrationToolsError } from '@prisma-next/migration-tools/types';\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 { extractSqlDdl } from '../control-api/operations/extract-sql-ddl';\nimport {\n  type CliErrorConflict,\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorMigrationPlanningFailed,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  loadAllBundles,\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 { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationPlanOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly name?: string;\n  readonly from?: string;\n}\n\nexport interface MigrationPlanResult {\n  readonly ok: boolean;\n  readonly noOp: boolean;\n  readonly from: string;\n  readonly to: string;\n  readonly dir?: string;\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  readonly sql?: readonly string[];\n  readonly summary: string;\n  /**\n   * When true, `migration.ts` was written but contains unfilled\n   * `placeholder(...)` calls. The user must edit the file and then run\n   * `node migration.ts` to self-emit `ops.json` / `migration.json`.\n   */\n  readonly pendingPlaceholders?: boolean;\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nfunction mapMigrationToolsError(error: unknown): CliStructuredError {\n  if (CliStructuredError.is(error)) {\n    return error;\n  }\n  if (MigrationToolsError.is(error)) {\n    return errorRuntime(error.message, {\n      why: error.why,\n      fix: error.fix,\n      meta: { code: error.code, ...(error.details ?? {}) },\n    });\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error), {\n    why: `Unexpected error during migration plan: ${error instanceof Error ? error.message : String(error)}`,\n  });\n}\n\nasync function executeMigrationPlanCommand(\n  options: MigrationPlanOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationPlanResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: contractPath },\n      { label: 'migrations', value: migrationsRelative },\n    ];\n    if (options.from) {\n      details.push({ label: 'from', value: options.from });\n    }\n    if (options.name) {\n      details.push({ label: 'name', value: options.name });\n    }\n    const header = formatStyledHeader({\n      command: 'migration plan',\n      description: 'Plan a migration from contract changes',\n      url: 'https://pris.ly/migration-plan',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Load contract file (the \"to\" contract)\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        errorFileNotFound(contractPathAbsolute, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: `Run \\`prisma-next contract emit\\` to generate ${contractPath}, or update \\`config.contract.output\\` in ${configPath}`,\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  let toContractJson: Contract;\n  try {\n    toContractJson = JSON.parse(contractJsonContent) as Contract;\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const rawStorageHash = toContractJson.storage?.storageHash;\n  if (typeof rawStorageHash !== 'string') {\n    return notOk(\n      errorContractValidationFailed('Contract is missing storageHash', {\n        where: { path: contractPathAbsolute },\n      }),\n    );\n  }\n  const toStorageHash = rawStorageHash;\n\n  // Read existing migrations and determine \"from\" contract\n  let fromContract: Contract | null = null;\n  let fromHash: string = EMPTY_CONTRACT_HASH;\n  let fromContractSourceDir: string | null = null;\n\n  try {\n    const { bundles, graph } = await loadAllBundles(migrationsDir);\n\n    if (options.from) {\n      const resolved = resolveBundleByPrefix(bundles, options.from);\n      if (!resolved.ok) {\n        const f = resolved.failure;\n        return notOk(\n          f.reason === 'ambiguous'\n            ? errorRuntime('Multiple matching migrations found', {\n                why: `Prefix \"${options.from}\" matches ${f.count} migrations in ${migrationsRelative}`,\n                fix: 'Provide a longer prefix to disambiguate, or omit --from to use the latest migration target.',\n              })\n            : errorRuntime('Starting contract not found', {\n                why: `No migration with to hash matching \"${options.from}\" exists in ${migrationsRelative}`,\n                fix: 'Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration target.',\n              }),\n        );\n      }\n      fromHash = resolved.value.manifest.to;\n      fromContract = resolved.value.manifest.toContract;\n      fromContractSourceDir = resolved.value.dirPath;\n    } else {\n      const latestMigration = findLatestMigration(graph);\n      if (latestMigration) {\n        fromHash = latestMigration.to;\n        const leafPkg = bundles.find((p) => p.manifest.migrationId === latestMigration.migrationId);\n        if (leafPkg) {\n          fromContract = leafPkg.manifest.toContract;\n          fromContractSourceDir = leafPkg.dirPath;\n        }\n      }\n    }\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  // Check for no-op (same hash means no changes)\n  if (fromHash === toStorageHash) {\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: true,\n      from: fromHash,\n      to: toStorageHash,\n      operations: [],\n      summary: 'No changes detected between contracts',\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\n  }\n\n  // Check target supports migrations\n  const migrations = getTargetMigrations(config.target);\n  if (!migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n  const frameworkComponents = assertFrameworkComponentsCompatible(\n    config.family.familyId,\n    config.target.targetId,\n    [config.target, config.adapter, ...(config.extensionPacks ?? [])],\n  );\n\n  // Build manifest and write migration package\n  const timestamp = new Date();\n  const slug = options.name ?? 'migration';\n  const dirName = formatMigrationDirName(timestamp, slug);\n  const packageDir = join(migrationsDir, dirName);\n\n  const baseManifest: Omit<MigrationManifest, 'migrationId'> = {\n    from: fromHash,\n    to: toStorageHash,\n    kind: 'regular',\n    fromContract,\n    toContract: toContractJson,\n    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '2.0.0',\n    },\n    labels: [],\n    createdAt: timestamp.toISOString(),\n  };\n\n  try {\n    const stack = createControlStack(config);\n    const familyInstance = config.family.create(stack);\n    const planner = migrations.createPlanner(familyInstance);\n    const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);\n    const plannerResult = planner.plan({\n      contract: toContractJson,\n      schema: fromSchema,\n      policy: { allowedOperationClasses: ['additive', 'widening', 'destructive', 'data'] },\n      fromHash,\n      fromContract,\n      frameworkComponents,\n    });\n    if (plannerResult.kind === 'failure') {\n      return notOk(\n        errorMigrationPlanningFailed({\n          conflicts: plannerResult.conflicts as readonly CliErrorConflict[],\n        }),\n      );\n    }\n\n    // Accessing .operations triggers toOp() on each call. If any call\n    // is a DataTransformCall with an unfilled placeholder stub, toOp()\n    // throws PN-MIG-2001. We catch that here so the migration can still\n    // be scaffolded with `ops: []`; the user fills the placeholder, then\n    // re-runs `node migration.ts` to attest with the real ops.\n    let plannedOps: readonly MigrationPlanOperation[] = [];\n    let hasPlaceholders = false;\n    try {\n      plannedOps = plannerResult.plan.operations;\n      if (plannedOps.length === 0) {\n        return notOk(\n          errorMigrationPlanningFailed({\n            conflicts: [\n              {\n                kind: 'unsupportedChange',\n                summary:\n                  'Contract changed but planner produced no operations. ' +\n                  'This indicates unsupported or ignored changes.',\n              },\n            ],\n          }),\n        );\n      }\n    } catch (e) {\n      if (CliStructuredError.is(e) && e.domain === 'MIG' && e.code === '2001') {\n        hasPlaceholders = true;\n      } else {\n        throw e;\n      }\n    }\n\n    const migrationTsContent = plannerResult.plan.renderTypeScript();\n\n    // Always-attest: compute migrationId over (manifest, ops). When\n    // placeholders blocked lowering, ops is `[]` and the id hashes over\n    // the empty list — re-emitting after the user fills the placeholder\n    // produces a different id (over the real ops). This is intentional;\n    // there is no on-disk \"draft\" state.\n    const opsForWrite = hasPlaceholders ? [] : plannedOps;\n    const manifest: MigrationManifest = {\n      ...baseManifest,\n      migrationId: computeMigrationId(baseManifest, opsForWrite),\n    };\n\n    await writeMigrationPackage(packageDir, manifest, opsForWrite);\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    await writeMigrationTs(packageDir, migrationTsContent);\n\n    if (hasPlaceholders) {\n      const result: MigrationPlanResult = {\n        ok: true,\n        noOp: false,\n        from: fromHash,\n        to: toStorageHash,\n        dir: relative(process.cwd(), packageDir),\n        operations: [],\n        pendingPlaceholders: true,\n        summary:\n          'Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit',\n        timings: { total: Date.now() - startTime },\n      };\n      return ok(result);\n    }\n\n    const sql = extractSqlDdl(plannedOps);\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: false,\n      from: fromHash,\n      to: toStorageHash,\n      dir: relative(process.cwd(), packageDir),\n      operations: plannedOps.map((op) => ({\n        id: op.id,\n        label: op.label,\n        operationClass: op.operationClass,\n      })),\n      sql,\n      summary: `Planned ${plannedOps.length} operation(s)`,\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\n  } catch (error) {\n    return notOk(mapMigrationToolsError(error));\n  }\n}\n\nexport function createMigrationPlanCommand(): Command {\n  const command = new Command('plan');\n  setCommandDescriptions(\n    command,\n    'Plan a migration from contract changes',\n    'Compares the emitted contract against the latest on-disk migration state and\\n' +\n      'produces a new migration package with the required operations. No database\\n' +\n      'connection is needed — this is a fully offline operation.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration plan',\n    'prisma-next migration plan --name add-users-table',\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--name <slug>', 'Name slug for the migration directory', 'migration')\n    .option('--from <hash>', 'Explicit starting contract hash (overrides latest migration target)')\n    .action(async (options: MigrationPlanOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeMigrationPlanCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (planResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(planResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationPlanOutput(planResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n\nfunction formatMigrationPlanOutput(result: MigrationPlanResult, flags: GlobalFlags): string {\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n\n  const green_ = useColor ? (s: string) => `\\x1b[32m${s}\\x1b[0m` : (s: string) => s;\n  const yellow_ = useColor ? (s: string) => `\\x1b[33m${s}\\x1b[0m` : (s: string) => s;\n  const dim_ = useColor ? (s: string) => `\\x1b[2m${s}\\x1b[0m` : (s: string) => s;\n\n  if (result.noOp) {\n    lines.push(`${green_('✔')} No changes detected`);\n    lines.push(dim_(`  from: ${result.from}`));\n    lines.push(dim_(`  to:   ${result.to}`));\n    return lines.join('\\n');\n  }\n\n  if (result.pendingPlaceholders) {\n    lines.push(`${yellow_('⚠')} ${result.summary}`);\n    lines.push('');\n    lines.push(dim_(`from: ${result.from}`));\n    lines.push(dim_(`to:   ${result.to}`));\n    if (result.dir) {\n      lines.push(dim_(`dir:  ${result.dir}`));\n    }\n    lines.push('');\n    lines.push(\n      'Open migration.ts and replace each `placeholder(...)` call with your actual query.',\n    );\n    lines.push(`Then run: ${green_(`node ${result.dir ?? '<dir>'}/migration.ts`)}`);\n    return lines.join('\\n');\n  }\n\n  lines.push(`${green_('✔')} ${result.summary}`);\n  lines.push('');\n\n  if (result.operations.length > 0) {\n    lines.push(dim_('│'));\n    for (let i = 0; i < result.operations.length; i++) {\n      const op = result.operations[i]!;\n      const isLast = i === result.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? yellow_(`[${op.operationClass}]`)\n          : dim_(`[${op.operationClass}]`);\n      lines.push(`${dim_(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${yellow_('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n    lines.push('');\n  }\n\n  lines.push(dim_(`from:   ${result.from}`));\n  lines.push(dim_(`to:     ${result.to}`));\n  if (result.dir) {\n    lines.push(dim_(`dir:    ${result.dir}`));\n  }\n\n  lines.push('');\n  lines.push(\n    `Next: ${green_(`node ${result.dir ?? '<dir>'}/migration.ts`)} to emit ops.json and attest migrationId before running ${green_('prisma-next migration apply')}.`,\n  );\n\n  if (result.sql && result.sql.length > 0) {\n    lines.push('');\n    lines.push(dim_('DDL preview'));\n    lines.push('');\n    for (const statement of result.sql) {\n      const trimmed = statement.trim();\n      if (!trimmed) continue;\n      const line = trimmed.endsWith(';') ? trimmed : `${trimmed};`;\n      lines.push(line);\n    }\n  }\n\n  if (flags.verbose && result.timings) {\n    lines.push('');\n    lines.push(dim_(`Total time: ${result.timings.total}ms`));\n  }\n\n  return lines.join('\\n');\n}\n\nexport type PrefixResolutionFailure =\n  | { reason: 'ambiguous'; count: number }\n  | { reason: 'not-found' };\n\n/**\n * Resolve a migration bundle by exact hash or prefix match.\n *\n * Tries exact match first, then prefix match (auto-prepending `sha256:` when\n * the needle omits the scheme). Returns the matched bundle on success, or a\n * discriminated failure indicating whether the prefix was ambiguous or simply\n * not found.\n *\n * @internal Exported for testing only.\n */\nexport function resolveBundleByPrefix<T extends { manifest: { to: string } }>(\n  bundles: readonly T[],\n  needle: string,\n): Result<T, PrefixResolutionFailure> {\n  const exact = bundles.find((p) => p.manifest.to === needle);\n  if (exact) return ok(exact);\n\n  const prefixWithScheme = needle.startsWith('sha256:') ? needle : `sha256:${needle}`;\n  const candidates = bundles.filter((p) => p.manifest.to.startsWith(prefixWithScheme));\n\n  if (candidates.length === 1) return ok(candidates[0]!);\n  if (candidates.length > 1) return notOk({ reason: 'ambiguous', count: candidates.length });\n  return notOk({ reason: 'not-found' });\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration-plan.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","toContractJson: Contract","fromContract: Contract | null","fromHash: string | null","fromContractSourceDir: string | null","baseMetadata: Omit<MigrationMetadata, 'migrationHash' | 'providedInvariants'>","plannedOps: readonly MigrationPlanOperation[]","metadataWithInvariants: Omit<MigrationMetadata, 'migrationHash'>","lines: string[]"],"sources":["../../src/commands/migration-plan.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { getEmittedArtifactPaths } from '@prisma-next/emitter';\nimport {\n  createControlStack,\n  hasOperationPreview,\n  type MigrationPlanOperation,\n  type OperationPreview,\n} from '@prisma-next/framework-components/control';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { computeMigrationHash } from '@prisma-next/migration-tools/hash';\nimport { deriveProvidedInvariants } from '@prisma-next/migration-tools/invariants';\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  type CliErrorConflict,\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorMigrationPlanningFailed,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  loadMigrationPackages,\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 { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationPlanOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly name?: string;\n  readonly from?: string;\n}\n\nexport interface MigrationPlanResult {\n  readonly ok: boolean;\n  readonly noOp: boolean;\n  readonly from: string | null;\n  readonly to: string;\n  readonly dir?: string;\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  /**\n   * Family-agnostic textual preview of the migration plan operations.\n   * Replaces the previous `sql?: readonly string[]` field; consumers should\n   * read `result.preview?.statements`.\n   */\n  readonly preview?: OperationPreview;\n  readonly summary: string;\n  /**\n   * When true, `migration.ts` was written but contains unfilled\n   * `placeholder(...)` calls. The user must edit the file and then run\n   * `node migration.ts` to self-emit `ops.json` / `migration.json`.\n   */\n  readonly pendingPlaceholders?: boolean;\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nasync function executeMigrationPlanCommand(\n  options: MigrationPlanOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationPlanResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'contract', value: contractPath },\n      { label: 'migrations', value: migrationsRelative },\n    ];\n    if (options.from) {\n      details.push({ label: 'from', value: options.from });\n    }\n    if (options.name) {\n      details.push({ label: 'name', value: options.name });\n    }\n    const header = formatStyledHeader({\n      command: 'migration plan',\n      description: 'Plan a migration from contract changes',\n      url: 'https://pris.ly/migration-plan',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Load contract file (the \"to\" contract)\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        errorFileNotFound(contractPathAbsolute, {\n          why: `Contract file not found at ${contractPathAbsolute}`,\n          fix: `Run \\`prisma-next contract emit\\` to generate ${contractPath}, or update \\`config.contract.output\\` in ${configPath}`,\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  let toContractJson: Contract;\n  try {\n    toContractJson = JSON.parse(contractJsonContent) as Contract;\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const rawStorageHash = toContractJson.storage?.storageHash;\n  if (typeof rawStorageHash !== 'string') {\n    return notOk(\n      errorContractValidationFailed('Contract is missing storageHash', {\n        where: { path: contractPathAbsolute },\n      }),\n    );\n  }\n  const toStorageHash = rawStorageHash;\n\n  // Read existing migrations and determine \"from\" contract\n  let fromContract: Contract | null = null;\n  let fromHash: string | null = null;\n  let fromContractSourceDir: string | null = null;\n\n  try {\n    const { bundles, graph } = await loadMigrationPackages(migrationsDir);\n\n    if (options.from) {\n      const resolved = resolveBundleByPrefix(bundles, options.from);\n      if (!resolved.ok) {\n        const f = resolved.failure;\n        return notOk(\n          f.reason === 'ambiguous'\n            ? errorRuntime('Multiple matching migrations found', {\n                why: `Prefix \"${options.from}\" matches ${f.count} migrations in ${migrationsRelative}`,\n                fix: 'Provide a longer prefix to disambiguate, or omit --from to use the latest migration target.',\n              })\n            : errorRuntime('Starting contract not found', {\n                why: `No migration with to hash matching \"${options.from}\" exists in ${migrationsRelative}`,\n                fix: 'Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration target.',\n              }),\n        );\n      }\n      fromHash = resolved.value.metadata.to;\n      fromContract = resolved.value.metadata.toContract;\n      fromContractSourceDir = resolved.value.dirPath;\n    } else {\n      const latestMigration = findLatestMigration(graph);\n      if (latestMigration) {\n        fromHash = latestMigration.to;\n        const leafPkg = bundles.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  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    // Wrap unexpected (non-MigrationToolsError) failures from the migration\n    // load phase in a structured CLI envelope. Letting them throw would\n    // bypass `handleResult()` and crash the command — see CLI structured-\n    // errors guideline (CliStructuredError + Result pattern).\n    const message = error instanceof Error ? error.message : String(error);\n    return notOk(\n      errorUnexpected(message, {\n        why: `Unexpected error while loading migrations: ${message}`,\n      }),\n    );\n  }\n\n  // Check for no-op (same hash means no changes)\n  if (fromHash === toStorageHash) {\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: true,\n      from: fromHash,\n      to: toStorageHash,\n      operations: [],\n      summary: 'No changes detected between contracts',\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\n  }\n\n  // Check target supports migrations\n  const migrations = getTargetMigrations(config.target);\n  if (!migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n  const frameworkComponents = assertFrameworkComponentsCompatible(\n    config.family.familyId,\n    config.target.targetId,\n    [config.target, config.adapter, ...(config.extensionPacks ?? [])],\n  );\n\n  // Build manifest and write migration package\n  const timestamp = new Date();\n  const slug = options.name ?? 'migration';\n  const dirName = formatMigrationDirName(timestamp, slug);\n  const packageDir = join(migrationsDir, dirName);\n\n  const baseMetadata: Omit<MigrationMetadata, 'migrationHash' | 'providedInvariants'> = {\n    from: fromHash,\n    to: toStorageHash,\n    fromContract,\n    toContract: toContractJson,\n    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '2.0.0',\n    },\n    labels: [],\n    createdAt: timestamp.toISOString(),\n  };\n\n  try {\n    const stack = createControlStack(config);\n    const familyInstance = config.family.create(stack);\n    const planner = migrations.createPlanner(familyInstance);\n    const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);\n    const plannerResult = planner.plan({\n      contract: toContractJson,\n      schema: fromSchema,\n      policy: { allowedOperationClasses: ['additive', 'widening', 'destructive', 'data'] },\n      fromContract,\n      frameworkComponents,\n    });\n    if (plannerResult.kind === 'failure') {\n      return notOk(\n        errorMigrationPlanningFailed({\n          conflicts: plannerResult.conflicts as readonly CliErrorConflict[],\n        }),\n      );\n    }\n\n    // Accessing .operations triggers toOp() on each call. If any call\n    // is a DataTransformCall with an unfilled placeholder stub, toOp()\n    // throws PN-MIG-2001. We catch that here so the migration can still\n    // be scaffolded with `ops: []`; the user fills the placeholder, then\n    // re-runs `node migration.ts` to attest with the real ops.\n    let plannedOps: readonly MigrationPlanOperation[] = [];\n    let hasPlaceholders = false;\n    try {\n      plannedOps = plannerResult.plan.operations;\n      if (plannedOps.length === 0) {\n        return notOk(\n          errorMigrationPlanningFailed({\n            conflicts: [\n              {\n                kind: 'unsupportedChange',\n                summary:\n                  'Contract changed but planner produced no operations. ' +\n                  'This indicates unsupported or ignored changes.',\n              },\n            ],\n          }),\n        );\n      }\n    } catch (e) {\n      if (CliStructuredError.is(e) && e.domain === 'MIG' && e.code === '2001') {\n        hasPlaceholders = true;\n      } else {\n        throw e;\n      }\n    }\n\n    const migrationTsContent = plannerResult.plan.renderTypeScript();\n\n    // Always-attest: compute migrationHash over (metadata, ops). When\n    // placeholders blocked lowering, ops is `[]` and the hash is computed\n    // over the empty list — re-emitting after the user fills the placeholder\n    // produces a different hash (over the real ops). This is intentional;\n    // there is no on-disk \"draft\" state.\n    const opsForWrite = hasPlaceholders ? [] : plannedOps;\n    const metadataWithInvariants: Omit<MigrationMetadata, 'migrationHash'> = {\n      ...baseMetadata,\n      providedInvariants: deriveProvidedInvariants(opsForWrite),\n    };\n    const metadata: MigrationMetadata = {\n      ...metadataWithInvariants,\n      migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite),\n    };\n\n    await writeMigrationPackage(packageDir, metadata, opsForWrite);\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    await writeMigrationTs(packageDir, migrationTsContent);\n\n    if (hasPlaceholders) {\n      const result: MigrationPlanResult = {\n        ok: true,\n        noOp: false,\n        from: fromHash,\n        to: toStorageHash,\n        dir: relative(process.cwd(), packageDir),\n        operations: [],\n        pendingPlaceholders: true,\n        summary:\n          'Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit',\n        timings: { total: Date.now() - startTime },\n      };\n      return ok(result);\n    }\n\n    const preview = hasOperationPreview(familyInstance)\n      ? familyInstance.toOperationPreview(plannedOps)\n      : undefined;\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: false,\n      from: fromHash,\n      to: toStorageHash,\n      dir: relative(process.cwd(), packageDir),\n      operations: plannedOps.map((op) => ({\n        id: op.id,\n        label: op.label,\n        operationClass: op.operationClass,\n      })),\n      ...(preview !== undefined ? { preview } : {}),\n      summary: `Planned ${plannedOps.length} operation(s)`,\n      timings: { total: Date.now() - startTime },\n    };\n    return ok(result);\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    return notOk(\n      errorUnexpected(message, {\n        why: `Unexpected error during migration plan: ${message}`,\n      }),\n    );\n  }\n}\n\nexport function createMigrationPlanCommand(): Command {\n  const command = new Command('plan');\n  setCommandDescriptions(\n    command,\n    'Plan a migration from contract changes',\n    'Compares the emitted contract against the latest on-disk migration state and\\n' +\n      'produces a new migration package with the required operations. No database\\n' +\n      'connection is needed — this is a fully offline operation.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration plan',\n    'prisma-next migration plan --name add-users-table',\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--name <slug>', 'Name slug for the migration directory', 'migration')\n    .option('--from <hash>', 'Explicit starting contract hash (overrides latest migration target)')\n    .action(async (options: MigrationPlanOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeMigrationPlanCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (planResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(planResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationPlanOutput(planResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n\nfunction formatMigrationPlanOutput(result: MigrationPlanResult, flags: GlobalFlags): string {\n  const lines: string[] = [];\n  const useColor = flags.color !== false;\n\n  const green_ = useColor ? (s: string) => `\\x1b[32m${s}\\x1b[0m` : (s: string) => s;\n  const yellow_ = useColor ? (s: string) => `\\x1b[33m${s}\\x1b[0m` : (s: string) => s;\n  const dim_ = useColor ? (s: string) => `\\x1b[2m${s}\\x1b[0m` : (s: string) => s;\n\n  if (result.noOp) {\n    lines.push(`${green_('✔')} No changes detected`);\n    lines.push(dim_(`  from: ${result.from}`));\n    lines.push(dim_(`  to:   ${result.to}`));\n    return lines.join('\\n');\n  }\n\n  if (result.pendingPlaceholders) {\n    lines.push(`${yellow_('⚠')} ${result.summary}`);\n    lines.push('');\n    lines.push(dim_(`from: ${result.from}`));\n    lines.push(dim_(`to:   ${result.to}`));\n    if (result.dir) {\n      lines.push(dim_(`dir:  ${result.dir}`));\n    }\n    lines.push('');\n    lines.push(\n      'Open migration.ts and replace each `placeholder(...)` call with your actual query.',\n    );\n    lines.push(`Then run: ${green_(`node ${result.dir ?? '<dir>'}/migration.ts`)}`);\n    return lines.join('\\n');\n  }\n\n  lines.push(`${green_('✔')} ${result.summary}`);\n  lines.push('');\n\n  if (result.operations.length > 0) {\n    lines.push(dim_('│'));\n    for (let i = 0; i < result.operations.length; i++) {\n      const op = result.operations[i]!;\n      const isLast = i === result.operations.length - 1;\n      const treeChar = isLast ? '└' : '├';\n      const opClassLabel =\n        op.operationClass === 'destructive'\n          ? yellow_(`[${op.operationClass}]`)\n          : dim_(`[${op.operationClass}]`);\n      lines.push(`${dim_(treeChar)}─ ${op.label} ${opClassLabel}`);\n    }\n\n    const hasDestructive = result.operations.some((op) => op.operationClass === 'destructive');\n    if (hasDestructive) {\n      lines.push('');\n      lines.push(\n        `${yellow_('⚠')} This migration contains destructive operations that may cause data loss.`,\n      );\n    }\n    lines.push('');\n  }\n\n  lines.push(dim_(`from:   ${result.from}`));\n  lines.push(dim_(`to:     ${result.to}`));\n  if (result.dir) {\n    lines.push(dim_(`dir:    ${result.dir}`));\n  }\n\n  lines.push('');\n  lines.push(\n    `Next: review ${green_(result.dir ?? '<dir>')} if needed, then run ${green_('prisma-next migration apply')}.`,\n  );\n\n  if (result.preview && result.preview.statements.length > 0) {\n    // The non-empty length is already guaranteed by the surrounding check, so\n    // a plain `every` here is equivalent to the helper in formatters/migrations.ts.\n    const allSql = result.preview.statements.every((s) => s.language === 'sql');\n    lines.push('');\n    lines.push(dim_(allSql ? 'DDL preview' : 'Operation preview'));\n    lines.push('');\n    for (const statement of result.preview.statements) {\n      const trimmed = statement.text.trim();\n      if (!trimmed) continue;\n      const line = statement.language === 'sql' && !trimmed.endsWith(';') ? `${trimmed};` : trimmed;\n      lines.push(line);\n    }\n  }\n\n  if (flags.verbose && result.timings) {\n    lines.push('');\n    lines.push(dim_(`Total time: ${result.timings.total}ms`));\n  }\n\n  return lines.join('\\n');\n}\n\nexport type PrefixResolutionFailure =\n  | { reason: 'ambiguous'; count: number }\n  | { reason: 'not-found' };\n\n/**\n * Resolve a migration package by **target contract hash** (`metadata.to`)\n * using exact match or prefix match.\n *\n * Note: matches `metadata.to` (the contract hash this migration produces),\n * not `metadata.migrationHash` (the package's content-addressed identity).\n * Tries exact match first, then prefix match (auto-prepending `sha256:` when\n * the needle omits the scheme). Returns the matched package on success, or a\n * discriminated failure indicating whether the prefix was ambiguous or simply\n * not found.\n *\n * @internal Exported for testing only.\n */\nexport function resolveBundleByPrefix<T extends { metadata: { to: string } }>(\n  bundles: readonly T[],\n  needle: string,\n): Result<T, PrefixResolutionFailure> {\n  const exact = bundles.find((p) => p.metadata.to === needle);\n  if (exact) return ok(exact);\n\n  const prefixWithScheme = needle.startsWith('sha256:') ? needle : `sha256:${needle}`;\n  const candidates = bundles.filter((p) => p.metadata.to.startsWith(prefixWithScheme));\n\n  if (candidates.length === 1) return ok(candidates[0]!);\n  if (candidates.length > 1) return notOk({ reason: 'ambiguous', count: candidates.length });\n  return notOk({ reason: 'not-found' });\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { t as CliStructuredError } from "../cli-errors-BFYgBH3L.mjs";
+import { t as CliStructuredError } from "../cli-errors-DDeVsP2Y.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { RefEntry } from "@prisma-next/migration-tools/refs";

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

@@ -1 +1 @@
-{"version":3,"file":"migration-ref.d.mts","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":[],"mappings":";;;;;;UAwBU,YAAA;;EAAA,SAAA,GAAA,EAAA,MAAY;EAOZ,SAAA,IAAA,EAAY,MAAA;EAOZ,SAAA,UAAe,EAAA,SAAA,MAAA,EAAA;AAAA;AAQF,UAfb,YAAA,CA6BD;EAOA,SAAA,EAAA,EAAA,IAAA;EAOM,SAAA,GAAA,EAAA,MAAA;EAIG,SAAA,IAAA,EAAA,MAAA;EAAc,SAAA,UAAA,EAAA,SAAA,MAAA,EAAA;;UAxCtB,eAAA,CAwCP;EAAO,SAAA,EAAA,EAAA,IAAA;EAoBK,SAAA,GAAA,EAAA,MAAA;EAGG,SAAA,OAAA,EAAA,IAAA;;UAzDR,aAAA,CAyDC;EAAR,SAAA,EAAA,EAAA,IAAA;EAAO,SAAA,IAAA,EAvDO,MAuDP,CAAA,MAAA,EAvDsB,QAuDtB,CAAA;AAAA;iBAzCD,sBAAA,CAwDS,IAAA,EAAA,MAAA,CAAA,EAxD6B,kBAwD7B;iBAjDT,uBAAA,CAiD0B,IAAA,EAAA,MAAA,CAAA,EAjDa,kBAiDb;iBA1CpB,oBAAA,CA0CJ,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAtCP,OAsCO,CAtCC,MAsCD,CAtCQ,YAsCR,EAtCsB,kBAsCtB,CAAA,CAAA;AAAA,iBAlBK,oBAAA,CA8BqB,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAEjB,MAAA,CAAA,EAAA,MAAA;CAAe,CAAA,EA7B/B,OA6B+B,CA7BvB,MA6BuB,CA7BhB,YA6BgB,EA7BF,kBA6BE,CAAA,CAAA;iBAjBnB,uBAAA,CAiBH,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAdR,OAcQ,CAdA,MAcA,CAdO,eAcP,EAdwB,kBAcxB,CAAA,CAAA;AA8IX,iBAhJe,qBAAA,CAgJ0B,OAAI,EAAA;;IA9IzC,QAAQ,OAAO,eAAe;iBA8IlB,yBAAA,CAAA,GAA6B"}
+{"version":3,"file":"migration-ref.d.mts","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":[],"mappings":";;;;;;UA6BU,YAAA;;EAAA,SAAA,GAAA,EAAA,MAAY;EAOZ,SAAA,IAAA,EAAY,MAAA;EAOZ,SAAA,UAAe,EAAA,SAAA,MAAA,EAAA;AAAA;AAQF,UAfb,YAAA,CAyBD;EAOA,SAAA,EAAA,EAAA,IAAA;EAOM,SAAA,GAAA,EAAA,MAAA;EAIG,SAAA,IAAA,EAAA,MAAA;EAAc,SAAA,UAAA,EAAA,SAAA,MAAA,EAAA;;UApCtB,eAAA,CAoCP;EAAO,SAAA,EAAA,EAAA,IAAA;EAoBK,SAAA,GAAA,EAAA,MAAA;EAGG,SAAA,OAAA,EAAA,IAAA;;UArDR,aAAA,CAqDC;EAAR,SAAA,EAAA,EAAA,IAAA;EAAO,SAAA,IAAA,EAnDO,MAmDP,CAAA,MAAA,EAnDsB,QAmDtB,CAAA;AAAA;iBAzCD,sBAAA,CAwDS,IAAA,EAAA,MAAA,CAAA,EAxD6B,kBAwD7B;iBAjDT,uBAAA,CAiD0B,IAAA,EAAA,MAAA,CAAA,EAjDa,kBAiDb;iBA1CpB,oBAAA,CA0CJ,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAtCP,OAsCO,CAtCC,MAsCD,CAtCQ,YAsCR,EAtCsB,kBAsCtB,CAAA,CAAA;AAAA,iBAlBK,oBAAA,CA8BqB,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAEjB,MAAA,CAAA,EAAA,MAAA;CAAe,CAAA,EA7B/B,OA6B+B,CA7BvB,MA6BuB,CA7BhB,YA6BgB,EA7BF,kBA6BE,CAAA,CAAA;iBAjBnB,uBAAA,CAiBH,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAR,MAAA,CAAA,EAAA,MAAA;CAAO,CAAA,EAdR,OAcQ,CAdA,MAcA,CAdO,eAcP,EAdwB,kBAcxB,CAAA,CAAA;AA8IX,iBAhJe,qBAAA,CAgJ0B,OAAI,EAAA;;IA9IzC,QAAQ,OAAO,eAAe;iBA8IlB,yBAAA,CAAA,GAA6B"}

package/dist/commands/migration-ref.mjs

@@ -1,19 +1,15 @@
-import { t as loadConfig } from "../config-loader-C25b63rJ.mjs";
-import { _ as errorUnexpected, m as errorRuntime, t as CliStructuredError } from "../cli-errors-Cd79vmTH.mjs";
-import { t as TerminalUI } from "../terminal-ui-C3ZLwQxK.mjs";
-import { c as resolveMigrationPaths, h as formatCommandHelp, m as parseGlobalFlags, n as addGlobalOptions, t as handleResult, u as setCommandDescriptions } from "../result-handler-Ba3zWQsI.mjs";
+import { t as loadConfig } from "../config-loader-ih8ViDb_.mjs";
+import { _ as errorUnexpected, m as errorRuntime, t as CliStructuredError, v as mapMigrationToolsError } from "../cli-errors-By1iVE3z.mjs";
+import { t as TerminalUI } from "../terminal-ui-u2YgKghu.mjs";
+import { _ as formatCommandHelp, d as setCommandDescriptions, g as parseGlobalFlags, l as resolveMigrationPaths, n as addGlobalOptions, t as handleResult } from "../result-handler-Ch6hVnOo.mjs";
 import { Command } from "commander";
 import { notOk, ok } from "@prisma-next/utils/result";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 import { deleteRef, readRef, readRefs, validateRefName, validateRefValue, writeRef } from "@prisma-next/migration-tools/refs";
-import { MigrationToolsError } from "@prisma-next/migration-tools/types";
 
 //#region src/commands/migration-ref.ts
 function mapError(error) {
-	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
-		why: error.why,
-		fix: error.fix,
-		meta: { code: error.code }
-	});
+	if (MigrationToolsError.is(error)) return mapMigrationToolsError(error);
 	return errorUnexpected(error instanceof Error ? error.message : String(error));
 }
 function cliErrorInvalidRefName(name) {

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

@@ -1 +1 @@
-{"version":3,"file":"migration-ref.mjs","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":["import type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRef,\n  readRef,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRef,\n} from '@prisma-next/migration-tools/refs';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { CliStructuredError, errorRuntime, errorUnexpected } from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefGetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return errorRuntime(error.message, {\n      why: error.why,\n      fix: error.fix,\n      meta: { code: error.code },\n    });\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nfunction cliErrorInvalidRefValue(hash: string): CliStructuredError {\n  return errorRuntime(`Invalid contract hash \"${hash}\"`, {\n    why: `\"${hash}\" is not a valid contract hash`,\n    fix: 'Contract hashes must match the format \"sha256:<64 hex chars>\". Copy the hash from `prisma-next contract emit` or `migration status --json`.',\n  });\n}\n\nasync function executeRefSetCommand(\n  name: string,\n  hash: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n  if (!validateRefValue(hash)) {\n    return notOk(cliErrorInvalidRefValue(hash));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry: RefEntry = { hash, invariants: [] };\n    await writeRef(refsDir, name, entry);\n    return ok({ ok: true as const, ref: name, hash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefGetCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefGetResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry = await readRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, hash: entry.hash, invariants: entry.invariants });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract hash',\n    'Sets a named ref to point to a contract hash in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument('<hash>', 'Contract hash to point to')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefGetCommand(): Command {\n  const command = new Command('get');\n  setCommandDescriptions(\n    command,\n    'Get the hash for a ref',\n    'Reads a named ref from migrations/refs/ and prints its contract hash.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to look up')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefGetCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else {\n            ui.output(value.hash);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport {\n  executeRefSetCommand,\n  executeRefGetCommand,\n  executeRefDeleteCommand,\n  executeRefListCommand,\n  cliErrorInvalidRefName,\n  cliErrorInvalidRefValue,\n};\n\nexport function createMigrationRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage migration refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefGetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration-ref.mjs","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":["import { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRef,\n  readRef,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRef,\n} from '@prisma-next/migration-tools/refs';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport {\n  CliStructuredError,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { TerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefGetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return mapMigrationToolsError(error);\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nfunction cliErrorInvalidRefValue(hash: string): CliStructuredError {\n  return errorRuntime(`Invalid contract hash \"${hash}\"`, {\n    why: `\"${hash}\" is not a valid contract hash`,\n    fix: 'Contract hashes must match the format \"sha256:<64 hex chars>\". Copy the hash from `prisma-next contract emit` or `migration status --json`.',\n  });\n}\n\nasync function executeRefSetCommand(\n  name: string,\n  hash: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n  if (!validateRefValue(hash)) {\n    return notOk(cliErrorInvalidRefValue(hash));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry: RefEntry = { hash, invariants: [] };\n    await writeRef(refsDir, name, entry);\n    return ok({ ok: true as const, ref: name, hash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefGetCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefGetResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const entry = await readRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, hash: entry.hash, invariants: entry.invariants });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRef(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nasync function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract hash',\n    'Sets a named ref to point to a contract hash in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument('<hash>', 'Contract hash to point to')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefGetCommand(): Command {\n  const command = new Command('get');\n  setCommandDescriptions(\n    command,\n    'Get the hash for a ref',\n    'Reads a named ref from migrations/refs/ and prints its contract hash.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to look up')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefGetCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else {\n            ui.output(value.hash);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlags(options);\n        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlags(options);\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport {\n  executeRefSetCommand,\n  executeRefGetCommand,\n  executeRefDeleteCommand,\n  executeRefListCommand,\n  cliErrorInvalidRefName,\n  cliErrorInvalidRefValue,\n};\n\nexport function createMigrationRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage migration refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefGetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1,27 +1,33 @@
-import { t as CliStructuredError } from "../cli-errors-BFYgBH3L.mjs";
+import { t as CliStructuredError } from "../cli-errors-DDeVsP2Y.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
-import { MigrationBundle } from "@prisma-next/migration-tools/types";
+import { OperationPreview } from "@prisma-next/framework-components/control";
+import { MigrationPackage } from "@prisma-next/migration-tools/package";
 
 //#region src/commands/migration-show.d.ts
 interface MigrationShowResult {
   readonly ok: true;
   readonly dirName: string;
   readonly dirPath: string;
-  readonly from: string;
+  readonly from: string | null;
   readonly to: string;
-  readonly migrationId: string;
-  readonly kind: string;
+  readonly migrationHash: string;
   readonly createdAt: string;
   readonly operations: readonly {
     readonly id: string;
     readonly label: string;
     readonly operationClass: string;
   }[];
-  readonly sql: readonly string[];
+  /**
+   * Family-agnostic textual preview of the migration's operations. Replaces
+   * the previous string-array DDL field. 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;
 }
-declare function resolveByHashPrefix(packages: readonly MigrationBundle[], prefix: string): Result<MigrationBundle, CliStructuredError>;
+declare function resolveByHashPrefix(packages: readonly MigrationPackage[], prefix: string): Result<MigrationPackage, CliStructuredError>;
 declare function createMigrationShowCommand(): Command;
 //#endregion
 export { MigrationShowResult, createMigrationShowCommand, resolveByHashPrefix };

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

@@ -1 +1 @@
-{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":[],"mappings":";;;;;;UA2BiB,mBAAA;;EAAA,SAAA,OAAA,EAAA,MAAmB;EAsBpB,SAAA,OAAA,EAAA,MAAmB;EACd,SAAA,IAAA,EAAA,MAAA;EAEX,SAAA,EAAA,EAAA,MAAA;EAAiB,SAAA,WAAA,EAAA,MAAA;EAAxB,SAAA,IAAA,EAAA,MAAA;EAAM,SAAA,SAAA,EAAA,MAAA;EAiJO,SAAA,UAAA,EAAA,SAA0B;;;;;;;;iBApJ1B,mBAAA,oBACK,oCAElB,OAAO,iBAAiB;iBAiJX,0BAAA,CAAA,GAA8B"}
+{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":[],"mappings":";;;;;;;UAsCiB,mBAAA;;EAAA,SAAA,OAAA,EAAA,MAAmB;EA2BpB,SAAA,OAAA,EAAA,MAAmB;EACd,SAAA,IAAA,EAAA,MAAA,GAAA,IAAA;EAEX,SAAA,EAAA,EAAA,MAAA;EAAkB,SAAA,aAAA,EAAA,MAAA;EAAzB,SAAA,SAAA,EAAA,MAAA;EAAM,SAAA,UAAA,EAAA,SAAA;IAqJO,SAAA,EAAA,EAAA,MAAA;;;;;;;;;;oBAhKI;;;iBAQJ,mBAAA,oBACK,qCAElB,OAAO,kBAAkB;iBAqJZ,0BAAA,CAAA,GAA8B"}

package/dist/commands/migration-show.mjs

@@ -1,15 +1,16 @@
-import { t as loadConfig } from "../config-loader-C25b63rJ.mjs";
-import { _ as errorUnexpected, m as errorRuntime } from "../cli-errors-Cd79vmTH.mjs";
-import { t as extractOperationStatements } from "../extract-operation-statements-DsFfxXVZ.mjs";
-import { t as TerminalUI } from "../terminal-ui-C3ZLwQxK.mjs";
-import { _ as formatStyledHeader, d as setCommandExamples, m as parseGlobalFlags, n as addGlobalOptions, t as handleResult, u as setCommandDescriptions } from "../result-handler-Ba3zWQsI.mjs";
-import { a as formatMigrationShowOutput } from "../migrations-Bo5WtTla.mjs";
+import { t as loadConfig } from "../config-loader-ih8ViDb_.mjs";
+import { _ as errorUnexpected, m as errorRuntime, v as mapMigrationToolsError } from "../cli-errors-By1iVE3z.mjs";
+import "../framework-components-Bgcre3Z6.mjs";
+import { t as TerminalUI } from "../terminal-ui-u2YgKghu.mjs";
+import { d as setCommandDescriptions, f as setCommandExamples, g as parseGlobalFlags, n as addGlobalOptions, t as handleResult, y as formatStyledHeader } from "../result-handler-Ch6hVnOo.mjs";
+import { t as createControlClient } from "../client-1JqqkiC7.mjs";
+import { a as formatMigrationShowOutput } from "../migrations-MEoKMiV5.mjs";
 import { Command } from "commander";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { relative, resolve } from "pathe";
-import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/dag";
 import { readMigrationPackage, readMigrationsDir } from "@prisma-next/migration-tools/io";
-import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/migration-graph";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 
 //#region src/commands/migration-show.ts
 function looksLikePath(target) {
@@ -17,14 +18,14 @@ function looksLikePath(target) {
 }
 function resolveByHashPrefix(packages, prefix) {
 	const normalizedPrefix = prefix.startsWith("sha256:") ? prefix : `sha256:${prefix}`;
-	const matches = packages.filter((p) => p.manifest.migrationId.startsWith(normalizedPrefix));
+	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 migrationId starting with "${normalizedPrefix}"`,
+		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.manifest.migrationId}`).join("\n")}`,
+		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."
 	}));
 }
@@ -72,7 +73,7 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 					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.manifest.migrationId === latestMigration.migrationId);
+				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."
@@ -81,41 +82,39 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 			}
 		}
 	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(errorRuntime(error.message, {
-			why: error.why,
-			fix: error.fix,
-			meta: {
-				code: error.code,
-				...error.details ?? {}
-			}
-		}));
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
 		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read migration: ${error instanceof Error ? error.message : String(error)}` }));
 	}
 	const ops = pkg.ops;
-	const sql = extractOperationStatements(config.family.familyId, ops) ?? [];
+	const preview = createControlClient({
+		family: config.family,
+		target: config.target,
+		adapter: config.adapter,
+		...config.driver ? { driver: config.driver } : {},
+		extensionPacks: config.extensionPacks ?? []
+	}).toOperationPreview(ops) ?? { statements: [] };
 	return ok({
 		ok: true,
 		dirName: pkg.dirName,
 		dirPath: relative(process.cwd(), pkg.dirPath),
-		from: pkg.manifest.from,
-		to: pkg.manifest.to,
-		migrationId: pkg.manifest.migrationId,
-		kind: pkg.manifest.kind,
-		createdAt: pkg.manifest.createdAt,
+		from: pkg.metadata.from,
+		to: pkg.metadata.to,
+		migrationHash: pkg.metadata.migrationHash,
+		createdAt: pkg.metadata.createdAt,
 		operations: ops.map((op) => ({
 			id: op.id,
 			label: op.label,
 			operationClass: op.operationClass
 		})),
-		sql,
+		preview,
 		summary: `${ops.length} operation(s)`
 	});
 }
 function createMigrationShowCommand() {
 	const command = new Command("show");
-	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, DDL preview, and metadata for a migration package.\nAccepts a directory path, a hash prefix (git-style), or defaults to the\nlatest migration.");
+	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, statement preview, and metadata for a migration package.\nAccepts a directory path, a hash prefix (git-style), or defaults to the\nlatest migration.");
 	setCommandExamples(command, ["prisma-next migration show", "prisma-next migration show sha256:a1b2c3"]);
-	addGlobalOptions(command).argument("[target]", "Migration directory path or migrationId hash prefix (defaults to latest)").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
+	addGlobalOptions(command).argument("[target]", "Migration directory path or migrationHash prefix (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,