@prisma-next/cli 0.3.0-dev.11 → 0.3.0-dev.114

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-plan.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","toContractJson: ContractIR","fromContract: ContractIR | null","fromHash: string","manifest: MigrationManifest","lines: string[]"],"sources":["../../src/commands/migration-plan.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { ContractIR } from '@prisma-next/contract/ir';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/core-control-plane/constants';\nimport { createControlPlaneStack } from '@prisma-next/core-control-plane/stack';\nimport { attestMigration } from '@prisma-next/migration-tools/attestation';\nimport { findLatestMigration } from '@prisma-next/migration-tools/dag';\nimport { formatMigrationDirName, writeMigrationPackage } from '@prisma-next/migration-tools/io';\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  type CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorMigrationPlanningFailed,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  getTargetMigrations,\n  loadMigrationBundles,\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 migrationId?: 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  readonly timings: {\n    readonly total: number;\n  };\n}\n\nfunction mapMigrationToolsError(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, ...(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: ContractIR;\n  try {\n    toContractJson = JSON.parse(contractJsonContent) as ContractIR;\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 toStorageHash = (toContractJson as unknown as Record<string, unknown>)['storageHash'] as\n    | string\n    | undefined;\n  if (!toStorageHash) {\n    return notOk(\n      errorContractValidationFailed('Contract is missing storageHash', {\n        where: { path: contractPathAbsolute },\n      }),\n    );\n  }\n\n  // Read existing migrations and determine \"from\" contract\n  let fromContract: ContractIR | null = null;\n  let fromHash: string = EMPTY_CONTRACT_HASH;\n\n  try {\n    const { bundles, graph } = await loadMigrationBundles(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    } 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        }\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 stack = createControlPlaneStack({\n    target: config.target,\n    adapter: config.adapter,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n  const familyInstance = config.family.create(stack);\n  const frameworkComponents = assertFrameworkComponentsCompatible(\n    config.family.familyId,\n    config.target.targetId,\n    [config.target, config.adapter, ...(config.extensionPacks ?? [])],\n  );\n  const planner = migrations.createPlanner(familyInstance);\n  const fromSchemaIR = migrations.contractToSchema(fromContract, frameworkComponents);\n  const plannerResult = planner.plan({\n    contract: toContractJson,\n    schema: fromSchemaIR,\n    policy: { allowedOperationClasses: ['additive', 'widening', 'destructive'] },\n    frameworkComponents,\n  });\n\n  if (plannerResult.kind === 'failure') {\n    return notOk(\n      errorMigrationPlanningFailed({\n        conflicts: plannerResult.conflicts as readonly CliErrorConflict[],\n      }),\n    );\n  }\n\n  if (plannerResult.plan.operations.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 (e.g. removals, type changes, or a planner/contract mismatch).',\n          },\n        ],\n      }),\n    );\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 manifest: MigrationManifest = {\n    from: fromHash,\n    to: toStorageHash,\n    migrationId: null,\n    kind: 'regular',\n    fromContract,\n    toContract: toContractJson,\n    hints: {\n      used: [],\n      applied: [],\n      plannerVersion: '1.0.0',\n      planningStrategy: 'diff',\n    },\n    labels: [],\n    createdAt: timestamp.toISOString(),\n  };\n\n  try {\n    await writeMigrationPackage(packageDir, manifest, plannerResult.plan.operations);\n    const migrationId = await attestMigration(packageDir);\n\n    const sql = extractSqlDdl(plannerResult.plan.operations);\n    const result: MigrationPlanResult = {\n      ok: true,\n      noOp: false,\n      from: fromHash,\n      to: toStorageHash,\n      migrationId,\n      dir: relative(process.cwd(), packageDir),\n      operations: plannerResult.plan.operations.map((op) => ({\n        id: op.id,\n        label: op.label,\n        operationClass: op.operationClass,\n      })),\n      sql,\n      summary: `Planned ${plannerResult.plan.operations.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  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.migrationId) {\n    lines.push(dim_(`migrationId: ${result.migrationId}`));\n  }\n  if (result.dir) {\n    lines.push(dim_(`dir:    ${result.dir}`));\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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"}

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

@@ -0,0 +1,43 @@
+import { t as CliStructuredError } from "../cli-errors-D6HxRn3A.mjs";
+import { Command } from "commander";
+import { Result } from "@prisma-next/utils/result";
+
+//#region src/commands/migration-ref.d.ts
+interface RefSetResult {
+  readonly ok: true;
+  readonly ref: string;
+  readonly hash: string;
+}
+interface RefGetResult {
+  readonly ok: true;
+  readonly ref: string;
+  readonly hash: string;
+}
+interface RefDeleteResult {
+  readonly ok: true;
+  readonly ref: string;
+  readonly deleted: true;
+}
+interface RefListResult {
+  readonly ok: true;
+  readonly refs: Record<string, string>;
+}
+declare function cliErrorInvalidRefName(name: string): CliStructuredError;
+declare function cliErrorInvalidRefValue(hash: string): CliStructuredError;
+declare function errorRefNotFound(name: string): CliStructuredError;
+declare function executeRefSetCommand(name: string, hash: string, options: {
+  config?: string;
+}): Promise<Result<RefSetResult, CliStructuredError>>;
+declare function executeRefGetCommand(name: string, options: {
+  config?: string;
+}): Promise<Result<RefGetResult, CliStructuredError>>;
+declare function executeRefDeleteCommand(name: string, options: {
+  config?: string;
+}): Promise<Result<RefDeleteResult, CliStructuredError>>;
+declare function executeRefListCommand(options: {
+  config?: string;
+}): Promise<Result<RefListResult, CliStructuredError>>;
+declare function createMigrationRefCommand(): Command;
+//#endregion
+export { cliErrorInvalidRefName, cliErrorInvalidRefValue, createMigrationRefCommand, errorRefNotFound, executeRefDeleteCommand, executeRefGetCommand, executeRefListCommand, executeRefSetCommand };
+//# sourceMappingURL=migration-ref.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-ref.d.mts","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":[],"mappings":";;;;;UAmBU,YAAA;;EAAA,SAAA,GAAA,EAAA,MAAY;EAMZ,SAAA,IAAA,EAAY,MAAA;AAAA;AAMG,UANf,YAAA,CAYa;EAqBd,SAAA,EAAA,EAAA,IAAA;EAOA,SAAA,GAAA,EAAA,MAAA;EAOA,SAAA,IAAA,EAAA,MAAgB;AAAkC;UAzCjD,eAAA,CAoDQ;EAAc,SAAA,EAAA,EAAA,IAAA;EAArB,SAAA,GAAA,EAAA,MAAA;EAAR,SAAA,OAAA,EAAA,IAAA;;AAAO,UA9CA,aAAA,CAmEK;EAGG,SAAA,EAAA,EAAA,IAAA;EAAc,SAAA,IAAA,EApEf,MAoEe,CAAA,MAAA,EAAA,MAAA,CAAA;;iBAjDvB,sBAAA,CAiDN,IAAA,EAAA,MAAA,CAAA,EAjD4C,kBAiD5C;iBA1CM,uBAAA,CA0CC,IAAA,EAAA,MAAA,CAAA,EA1CsC,kBA0CtC;AAAA,iBAnCD,gBAAA,CAgD6B,IAAA,EAAA,MAAA,CAAA,EAhDG,kBAgDH;iBAzCvB,oBAAA,CA4CG,IAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAiB,MAAA,CAAA,EAAA,MAAA;CAAxB,CAAA,EAxCR,OAwCQ,CAxCA,MAwCA,CAxCO,YAwCP,EAxCqB,kBAwCrB,CAAA,CAAA;iBAnBI,oBAAA,CAmBZ,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAO,MAAA,CAAA,EAAA,MAAA;AAAA,CAAA,CAAA,EAhBP,OAiCY,CAjCJ,MAiCI,CAjCG,YAiCkB,EAjCJ,kBAiCI,CAAA,CAAA;iBApBrB,uBAAA,CAsBI,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA;EAAe,MAAA,CAAA,EAAA,MAAA;CAAtB,CAAA,EAnBT,OAmBS,CAnBD,MAmBC,CAnBM,eAmBN,EAnBuB,kBAmBvB,CAAA,CAAA;iBAFG,qBAAA,CAEX,OAAA,EAAA;EAAO,MAAA,CAAA,EAAA,MAAA;AAiJX,CAAA,CAAA,EAjJI,OAiJY,CAjJJ,MAiJI,CAjJG,aAiJsB,EAjJP,kBAiJkB,CAAA,CAAA;iBAApC,yBAAA,CAAA,GAA6B"}

package/dist/commands/migration-ref.mjs

@@ -0,0 +1,194 @@
+import { t as loadConfig } from "../config-loader-d_KF19Tw.mjs";
+import { _ as errorUnexpected, m as errorRuntime, t as CliStructuredError } from "../cli-errors-ByGuoqNj.mjs";
+import { _ as formatCommandHelp, f as setCommandDescriptions, g as parseGlobalFlags, i as addGlobalOptions, r as handleResult, t as TerminalUI } from "../terminal-ui-DAcMBRKf.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { resolve } from "pathe";
+import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { readRefs, resolveRef, validateRefName, validateRefValue, writeRefs } from "@prisma-next/migration-tools/refs";
+
+//#region src/commands/migration-ref.ts
+function resolveRefsPath(configPath, config) {
+	return resolve(configPath ? resolve(configPath, "..") : process.cwd(), config?.migrations?.dir ?? "migrations", "refs.json");
+}
+function mapError(error) {
+	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
+		why: error.why,
+		fix: error.fix,
+		meta: { code: error.code }
+	});
+	return errorUnexpected(error instanceof Error ? error.message : String(error));
+}
+function cliErrorInvalidRefName(name) {
+	return errorRuntime(`Invalid ref name "${name}"`, {
+		why: `Ref name "${name}" does not match the required format`,
+		fix: "Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments"
+	});
+}
+function cliErrorInvalidRefValue(hash) {
+	return errorRuntime(`Invalid contract hash "${hash}"`, {
+		why: `"${hash}" is not a valid contract hash`,
+		fix: "Contract hashes must match the format \"sha256:<64 hex chars>\". Copy the hash from `prisma-next contract emit` or `migration status --json`."
+	});
+}
+function errorRefNotFound(name) {
+	return errorRuntime(`Ref "${name}" does not exist`, {
+		why: `No ref named "${name}" found in refs.json`,
+		fix: `Run \`prisma-next migration ref list\` to see available refs, or \`prisma-next migration ref set ${name} <hash>\` to create it`
+	});
+}
+async function executeRefSetCommand(name, hash, options) {
+	if (!validateRefName(name)) return notOk(cliErrorInvalidRefName(name));
+	if (!validateRefValue(hash)) return notOk(cliErrorInvalidRefValue(hash));
+	try {
+		const config = await loadConfig(options.config);
+		const refsPath = resolveRefsPath(options.config, config);
+		await writeRefs(refsPath, {
+			...await readRefs(refsPath),
+			[name]: hash
+		});
+		return ok({
+			ok: true,
+			ref: name,
+			hash
+		});
+	} catch (error) {
+		if (error instanceof CliStructuredError) return notOk(error);
+		return notOk(mapError(error));
+	}
+}
+async function executeRefGetCommand(name, options) {
+	try {
+		const config = await loadConfig(options.config);
+		return ok({
+			ok: true,
+			ref: name,
+			hash: resolveRef(await readRefs(resolveRefsPath(options.config, config)), name)
+		});
+	} catch (error) {
+		if (error instanceof CliStructuredError) return notOk(error);
+		return notOk(mapError(error));
+	}
+}
+async function executeRefDeleteCommand(name, options) {
+	try {
+		const config = await loadConfig(options.config);
+		const refsPath = resolveRefsPath(options.config, config);
+		const refs = await readRefs(refsPath);
+		if (!Object.hasOwn(refs, name)) return notOk(errorRefNotFound(name));
+		const { [name]: _, ...remaining } = refs;
+		await writeRefs(refsPath, remaining);
+		return ok({
+			ok: true,
+			ref: name,
+			deleted: true
+		});
+	} catch (error) {
+		if (error instanceof CliStructuredError) return notOk(error);
+		return notOk(mapError(error));
+	}
+}
+async function executeRefListCommand(options) {
+	try {
+		const config = await loadConfig(options.config);
+		return ok({
+			ok: true,
+			refs: await readRefs(resolveRefsPath(options.config, config))
+		});
+	} catch (error) {
+		if (error instanceof CliStructuredError) return notOk(error);
+		return notOk(mapError(error));
+	}
+}
+function createRefSetCommand() {
+	const command = new Command("set");
+	setCommandDescriptions(command, "Set a ref to a contract hash", "Sets a named ref to point to a contract hash in migrations/refs.json.");
+	addGlobalOptions(command).argument("<name>", "Ref name (e.g., staging, production)").argument("<hash>", "Contract hash to point to").option("--config <path>", "Path to prisma-next.config.ts").action(async (name, hash, options) => {
+		const flags = parseGlobalFlags(options);
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeRefSetCommand(name, hash, options), flags, ui, (value) => {
+			if (flags.json) ui.output(JSON.stringify(value));
+			else if (!flags.quiet) ui.output(`Set ref "${value.ref}" → ${value.hash}`);
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function createRefGetCommand() {
+	const command = new Command("get");
+	setCommandDescriptions(command, "Get the hash for a ref", "Reads a named ref from migrations/refs.json and prints its contract hash.");
+	addGlobalOptions(command).argument("<name>", "Ref name to look up").option("--config <path>", "Path to prisma-next.config.ts").action(async (name, options) => {
+		const flags = parseGlobalFlags(options);
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeRefGetCommand(name, options), flags, ui, (value) => {
+			if (flags.json) ui.output(JSON.stringify(value));
+			else ui.output(value.hash);
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function createRefDeleteCommand() {
+	const command = new Command("delete");
+	setCommandDescriptions(command, "Delete a ref", "Removes a named ref from migrations/refs.json.");
+	addGlobalOptions(command).argument("<name>", "Ref name to delete").option("--config <path>", "Path to prisma-next.config.ts").action(async (name, options) => {
+		const flags = parseGlobalFlags(options);
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeRefDeleteCommand(name, options), flags, ui, (value) => {
+			if (flags.json) ui.output(JSON.stringify(value));
+			else if (!flags.quiet) ui.output(`Deleted ref "${value.ref}"`);
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function createRefListCommand() {
+	const command = new Command("list");
+	setCommandDescriptions(command, "List all refs", "Lists all named refs from migrations/refs.json.");
+	addGlobalOptions(command).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 executeRefListCommand(options), flags, ui, (value) => {
+			if (flags.json) ui.output(JSON.stringify(value));
+			else if (!flags.quiet) {
+				const entries = Object.entries(value.refs);
+				if (entries.length === 0) ui.output("No refs defined");
+				else for (const [refName, hash] of entries) ui.output(`${refName} → ${hash}`);
+			}
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function createMigrationRefCommand() {
+	const command = new Command("ref");
+	setCommandDescriptions(command, "Manage migration refs", "Manage named refs in migrations/refs.json. Refs map logical environment\nnames (e.g., staging, production) to contract hashes.");
+	addGlobalOptions(command).configureHelp({
+		formatHelp: (cmd) => formatCommandHelp({
+			command: cmd,
+			flags: parseGlobalFlags({})
+		}),
+		subcommandDescription: () => ""
+	});
+	command.addCommand(createRefSetCommand());
+	command.addCommand(createRefGetCommand());
+	command.addCommand(createRefDeleteCommand());
+	command.addCommand(createRefListCommand());
+	return command;
+}
+
+//#endregion
+export { cliErrorInvalidRefName, cliErrorInvalidRefValue, createMigrationRefCommand, errorRefNotFound, executeRefDeleteCommand, executeRefGetCommand, executeRefListCommand, executeRefSetCommand };
+//# sourceMappingURL=migration-ref.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-ref.mjs","names":[],"sources":["../../src/commands/migration-ref.ts"],"sourcesContent":["import {\n  readRefs,\n  resolveRef,\n  validateRefName,\n  validateRefValue,\n  writeRefs,\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 { resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { CliStructuredError, errorRuntime, errorUnexpected } from '../utils/cli-errors';\nimport { addGlobalOptions, setCommandDescriptions } 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}\n\ninterface RefGetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: 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, string>;\n}\n\nfunction resolveRefsPath(configPath?: string, config?: { migrations?: { dir?: string } }): string {\n  const base = configPath ? resolve(configPath, '..') : process.cwd();\n  return resolve(base, config?.migrations?.dir ?? 'migrations', 'refs.json');\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\nfunction errorRefNotFound(name: string): CliStructuredError {\n  return errorRuntime(`Ref \"${name}\" does not exist`, {\n    why: `No ref named \"${name}\" found in refs.json`,\n    fix: `Run \\`prisma-next migration ref list\\` to see available refs, or \\`prisma-next migration ref set ${name} <hash>\\` to create it`,\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 refsPath = resolveRefsPath(options.config, config);\n    const refs = await readRefs(refsPath);\n    const updated = { ...refs, [name]: hash };\n    await writeRefs(refsPath, updated);\n    return ok({ ok: true as const, ref: name, hash });\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 refsPath = resolveRefsPath(options.config, config);\n    const refs = await readRefs(refsPath);\n    const hash = resolveRef(refs, name);\n    return ok({ ok: true as const, ref: name, hash });\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 refsPath = resolveRefsPath(options.config, config);\n    const refs = await readRefs(refsPath);\n    if (!Object.hasOwn(refs, name)) {\n      return notOk(errorRefNotFound(name));\n    }\n    const { [name]: _, ...remaining } = refs;\n    await writeRefs(refsPath, remaining);\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 refsPath = resolveRefsPath(options.config, config);\n    const refs = await readRefs(refsPath);\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.json.',\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.json 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.json.');\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(\n    command,\n    'List all refs',\n    'Lists all named refs from migrations/refs.json.',\n  );\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, hash] of entries) {\n              ui.output(`${refName} → ${hash}`);\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  errorRefNotFound,\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.json. 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

@@ -0,0 +1,28 @@
+import { t as CliStructuredError } from "../cli-errors-D6HxRn3A.mjs";
+import { Command } from "commander";
+import { Result } from "@prisma-next/utils/result";
+import { MigrationBundle } from "@prisma-next/migration-tools/types";
+
+//#region src/commands/migration-show.d.ts
+interface MigrationShowResult {
+  readonly ok: true;
+  readonly dirName: string;
+  readonly dirPath: string;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationId: string | null;
+  readonly kind: string;
+  readonly createdAt: string;
+  readonly operations: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly operationClass: string;
+  }[];
+  readonly sql: readonly string[];
+  readonly summary: string;
+}
+declare function resolveByHashPrefix(packages: readonly MigrationBundle[], prefix: string): Result<MigrationBundle, CliStructuredError>;
+declare function createMigrationShowCommand(): Command;
+//#endregion
+export { MigrationShowResult, createMigrationShowCommand, resolveByHashPrefix };
+//# sourceMappingURL=migration-show.d.mts.map

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

@@ -0,0 +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,GAAA,IAAA;EAAxB,SAAA,IAAA,EAAA,MAAA;EAAM,SAAA,SAAA,EAAA,MAAA;EA2JO,SAAA,UAAA,EAAA,SAA0B;;;;;;;;iBA9J1B,mBAAA,oBACK,oCAElB,OAAO,iBAAiB;iBA2JX,0BAAA,CAAA,GAA8B"}

package/dist/commands/migration-show.mjs

@@ -0,0 +1,139 @@
+import { t as loadConfig } from "../config-loader-d_KF19Tw.mjs";
+import { _ as errorUnexpected, m as errorRuntime } from "../cli-errors-ByGuoqNj.mjs";
+import { t as extractSqlDdl } from "../extract-sql-ddl-Jf5blEO0.mjs";
+import { f as setCommandDescriptions, g as parseGlobalFlags, i as addGlobalOptions, p as setCommandExamples, r as handleResult, t as TerminalUI, y as formatStyledHeader } from "../terminal-ui-DAcMBRKf.mjs";
+import { a as formatMigrationShowOutput } from "../migrations-Db_ea9eE.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, isAttested } from "@prisma-next/migration-tools/types";
+
+//#region src/commands/migration-show.ts
+function looksLikePath(target) {
+	return target.includes("/") || target.includes("\\");
+}
+function resolveByHashPrefix(packages, prefix) {
+	const normalizedPrefix = prefix.startsWith("sha256:") ? prefix : `sha256:${prefix}`;
+	const matches = packages.filter((p) => typeof p.manifest.migrationId === "string").filter((p) => p.manifest.migrationId.startsWith(normalizedPrefix));
+	if (matches.length === 1) return ok(matches[0]);
+	if (matches.length === 0) return notOk(errorRuntime("No migration found matching prefix", {
+		why: `No attested migration has a migrationId 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")}`,
+		fix: "Provide a longer prefix to uniquely identify the migration."
+	}));
+}
+async function executeMigrationShowCommand(target, options, flags, ui) {
+	const config = await loadConfig(options.config);
+	const configPath = options.config ? relative(process.cwd(), resolve(options.config)) : "prisma-next.config.ts";
+	const migrationsDir = resolve(options.config ? resolve(options.config, "..") : process.cwd(), config.migrations?.dir ?? "migrations");
+	const migrationsRelative = relative(process.cwd(), migrationsDir);
+	if (!flags.json && !flags.quiet) {
+		const details = [{
+			label: "config",
+			value: configPath
+		}, {
+			label: "migrations",
+			value: migrationsRelative
+		}];
+		if (target) details.push({
+			label: "target",
+			value: target
+		});
+		const header = formatStyledHeader({
+			command: "migration show",
+			description: "Display migration package contents",
+			details,
+			flags
+		});
+		ui.stderr(header);
+	}
+	let pkg;
+	try {
+		if (target && looksLikePath(target)) pkg = await readMigrationPackage(resolve(target));
+		else {
+			const allPackages = await readMigrationsDir(migrationsDir);
+			if (allPackages.length === 0) return notOk(errorRuntime("No migrations found", {
+				why: `No migration packages found in ${migrationsRelative}`,
+				fix: "Run `prisma-next migration plan` to create a migration first."
+			}));
+			if (target) {
+				const resolved = resolveByHashPrefix(allPackages, target);
+				if (!resolved.ok) return resolved;
+				pkg = resolved.value;
+			} else {
+				const attested = allPackages.filter(isAttested);
+				if (attested.length === 0) return notOk(errorRuntime("No attested migrations found", {
+					why: `All migrations in ${migrationsRelative} are drafts (migrationId: null)`,
+					fix: "Run `prisma-next migration verify --dir <path>` to attest a draft migration."
+				}));
+				const latestMigration = findLatestMigration(reconstructGraph(attested));
+				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 = attested.find((p) => p.manifest.migrationId === latestMigration.migrationId);
+				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."
+				}));
+				pkg = leafPkg;
+			}
+		}
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(errorRuntime(error.message, {
+			why: error.why,
+			fix: error.fix,
+			meta: {
+				code: error.code,
+				...error.details ?? {}
+			}
+		}));
+		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 = extractSqlDdl(ops);
+	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,
+		operations: ops.map((op) => ({
+			id: op.id,
+			label: op.label,
+			operationClass: op.operationClass
+		})),
+		sql,
+		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.");
+	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) => {
+		const flags = parseGlobalFlags(options);
+		const ui = new TerminalUI({
+			color: flags.color,
+			interactive: flags.interactive
+		});
+		const exitCode = handleResult(await executeMigrationShowCommand(target, options, flags, ui), flags, ui, (showResult) => {
+			if (flags.json) ui.output(JSON.stringify(showResult, null, 2));
+			else if (!flags.quiet) ui.log(formatMigrationShowOutput(showResult, flags));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+
+//#endregion
+export { createMigrationShowCommand, resolveByHashPrefix };
+//# sourceMappingURL=migration-show.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-show.mjs","names":["details: Array<{ label: string; value: string }>","pkg: MigrationBundle"],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":["import type { MigrationPlanOperation } from '@prisma-next/core-control-plane/types';\nimport { findLatestMigration, reconstructGraph } from '@prisma-next/migration-tools/dag';\nimport { readMigrationPackage, readMigrationsDir } from '@prisma-next/migration-tools/io';\nimport type { MigrationBundle } from '@prisma-next/migration-tools/types';\nimport { isAttested, MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { relative, resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { extractSqlDdl } from '../control-api/operations/extract-sql-ddl';\nimport { type CliStructuredError, errorRuntime, errorUnexpected } from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../utils/command-helpers';\nimport { formatMigrationShowOutput } from '../utils/formatters/migrations';\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 MigrationShowOptions extends CommonCommandOptions {\n  readonly config?: string;\n}\n\nexport interface MigrationShowResult {\n  readonly ok: true;\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly from: string;\n  readonly to: string;\n  readonly migrationId: string | null;\n  readonly kind: string;\n  readonly createdAt: 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\nfunction looksLikePath(target: string): boolean {\n  return target.includes('/') || target.includes('\\\\');\n}\n\nexport function resolveByHashPrefix(\n  packages: readonly MigrationBundle[],\n  prefix: string,\n): Result<MigrationBundle, CliStructuredError> {\n  const normalizedPrefix = prefix.startsWith('sha256:') ? prefix : `sha256:${prefix}`;\n  const attested = packages.filter((p) => typeof p.manifest.migrationId === 'string');\n  const matches = attested.filter((p) => p.manifest.migrationId!.startsWith(normalizedPrefix));\n\n  if (matches.length === 1) {\n    return ok(matches[0]!);\n  }\n\n  if (matches.length === 0) {\n    return notOk(\n      errorRuntime('No migration found matching prefix', {\n        why: `No attested migration has a migrationId starting with \"${normalizedPrefix}\"`,\n        fix: 'Run `prisma-next migration show` (no argument) to see the latest migration, or check the migrations directory for available packages.',\n      }),\n    );\n  }\n\n  const candidates = matches.map((p) => `  ${p.dirName}  ${p.manifest.migrationId}`).join('\\n');\n  return notOk(\n    errorRuntime('Ambiguous hash prefix', {\n      why: `Multiple migrations match prefix \"${normalizedPrefix}\":\\n${candidates}`,\n      fix: 'Provide a longer prefix to uniquely identify the migration.',\n    }),\n  );\n}\n\nasync function executeMigrationShowCommand(\n  target: string | undefined,\n  options: MigrationShowOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationShowResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const configPath = options.config\n    ? relative(process.cwd(), resolve(options.config))\n    : 'prisma-next.config.ts';\n\n  const migrationsDir = resolve(\n    options.config ? resolve(options.config, '..') : process.cwd(),\n    config.migrations?.dir ?? 'migrations',\n  );\n  const migrationsRelative = relative(process.cwd(), migrationsDir);\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: migrationsRelative },\n    ];\n    if (target) {\n      details.push({ label: 'target', value: target });\n    }\n    const header = formatStyledHeader({\n      command: 'migration show',\n      description: 'Display migration package contents',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  let pkg: MigrationBundle;\n\n  try {\n    if (target && looksLikePath(target)) {\n      pkg = await readMigrationPackage(resolve(target));\n    } else {\n      const allPackages = await readMigrationsDir(migrationsDir);\n      if (allPackages.length === 0) {\n        return notOk(\n          errorRuntime('No migrations found', {\n            why: `No migration packages found in ${migrationsRelative}`,\n            fix: 'Run `prisma-next migration plan` to create a migration first.',\n          }),\n        );\n      }\n\n      if (target) {\n        const resolved = resolveByHashPrefix(allPackages, target);\n        if (!resolved.ok) return resolved;\n        pkg = resolved.value;\n      } else {\n        const attested = allPackages.filter(isAttested);\n        if (attested.length === 0) {\n          return notOk(\n            errorRuntime('No attested migrations found', {\n              why: `All migrations in ${migrationsRelative} are drafts (migrationId: null)`,\n              fix: 'Run `prisma-next migration verify --dir <path>` to attest a draft migration.',\n            }),\n          );\n        }\n        const graph = reconstructGraph(attested);\n        const latestMigration = findLatestMigration(graph);\n        if (!latestMigration) {\n          return notOk(\n            errorRuntime('Could not resolve latest migration', {\n              why: 'No latest migration found in the migration history',\n              fix: 'The migrations directory may be corrupted. Inspect the migration.json files.',\n            }),\n          );\n        }\n        const leafPkg = attested.find(\n          (p) => p.manifest.migrationId === latestMigration.migrationId,\n        );\n        if (!leafPkg) {\n          return notOk(\n            errorRuntime('Could not resolve latest migration', {\n              why: `Latest migration ${latestMigration.dirName} does not match any package`,\n              fix: 'The migrations directory may be corrupted. Inspect the migration.json files.',\n            }),\n          );\n        }\n        pkg = leafPkg;\n      }\n    }\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(\n        errorRuntime(error.message, {\n          why: error.why,\n          fix: error.fix,\n          meta: { code: error.code, ...(error.details ?? {}) },\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to read migration: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  const ops = pkg.ops as readonly MigrationPlanOperation[];\n  const sql = extractSqlDdl(ops);\n\n  const result: MigrationShowResult = {\n    ok: true,\n    dirName: pkg.dirName,\n    dirPath: relative(process.cwd(), pkg.dirPath),\n    from: pkg.manifest.from,\n    to: pkg.manifest.to,\n    migrationId: pkg.manifest.migrationId,\n    kind: pkg.manifest.kind,\n    createdAt: pkg.manifest.createdAt,\n    operations: ops.map((op) => ({\n      id: op.id,\n      label: op.label,\n      operationClass: op.operationClass,\n    })),\n    sql,\n    summary: `${ops.length} operation(s)`,\n  };\n  return ok(result);\n}\n\nexport function createMigrationShowCommand(): Command {\n  const command = new Command('show');\n  setCommandDescriptions(\n    command,\n    'Display migration package contents',\n    'Shows the operations, DDL preview, and metadata for a migration package.\\n' +\n      'Accepts a directory path, a hash prefix (git-style), or defaults to the\\n' +\n      'latest migration.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration show',\n    'prisma-next migration show sha256:a1b2c3',\n  ]);\n  addGlobalOptions(command)\n    .argument(\n      '[target]',\n      'Migration directory path or migrationId hash prefix (defaults to latest)',\n    )\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (target: string | undefined, options: MigrationShowOptions) => {\n      const flags = parseGlobalFlags(options);\n\n      const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });\n\n      const result = await executeMigrationShowCommand(target, options, flags, ui);\n\n      const exitCode = handleResult(result, flags, ui, (showResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(showResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationShowOutput(showResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,85 @@
+import { Command } from "commander";
+import { MigrationBundle, MigrationGraph } from "@prisma-next/migration-tools/types";
+
+//#region src/utils/migration-types.d.ts
+interface StatusRef {
+  readonly name: string;
+  readonly hash: string;
+  readonly active: boolean;
+}
+interface StatusDiagnostic {
+  readonly code: string;
+  readonly severity: 'warn' | 'info';
+  readonly message: string;
+  readonly hints: readonly string[];
+}
+//#endregion
+//#region src/utils/formatters/graph-migration-mapper.d.ts
+type EdgeStatusKind = 'applied' | 'pending' | 'unreachable';
+/** Minimal per-edge status from the CLI's status result. */
+interface EdgeStatus {
+  readonly dirName: string;
+  readonly status: EdgeStatusKind;
+}
+//#endregion
+//#region src/commands/migration-status.d.ts
+interface MigrationStatusEntry {
+  readonly dirName: string;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationId: string | null;
+  readonly operationCount: number;
+  readonly operationSummary: string;
+  readonly hasDestructive: boolean;
+  readonly status: EdgeStatusKind | 'unknown';
+}
+interface MigrationStatusResult {
+  readonly ok: true;
+  readonly mode: 'online' | 'offline';
+  readonly migrations: readonly MigrationStatusEntry[];
+  readonly markerHash?: string;
+  readonly targetHash: string;
+  readonly contractHash: string;
+  readonly refs?: readonly StatusRef[];
+  readonly pathDecision?: {
+    readonly fromHash: string;
+    readonly toHash: string;
+    readonly alternativeCount: number;
+    readonly tieBreakReasons: readonly string[];
+    readonly refName?: string;
+    readonly selectedPath: readonly {
+      readonly dirName: string;
+      readonly migrationId: string | null;
+      readonly from: string;
+      readonly to: string;
+    }[];
+  };
+  readonly summary: string;
+  readonly diagnostics: readonly StatusDiagnostic[];
+  readonly graph?: MigrationGraph;
+  readonly bundles?: readonly MigrationBundle[];
+  readonly edgeStatuses?: readonly EdgeStatus[];
+  readonly activeRefHash?: string;
+  readonly activeRefName?: string;
+  readonly diverged?: boolean;
+}
+/**
+ * Derive per-edge status across the full graph using path analysis.
+ *
+ * - **applied**: edge is on the path from root to the DB marker
+ * - **pending**: edge is on the path from the DB marker to the target
+ *   (and the marker is reachable from root, i.e. it's on the same branch)
+ * - **unreachable**: edge is on the path from root to the target but the DB
+ *   marker is on a different branch — `apply` can't reach these edges
+ *   without the DB first moving to this branch
+ *
+ * Returns statuses only for edges that have a known status (skips offline
+ * and edges not on any relevant path).
+ *
+ * @internal Exported for testing only.
+ */
+declare function deriveEdgeStatuses(graph: MigrationGraph, targetHash: string, contractHash: string, markerHash: string | undefined, mode: 'online' | 'offline'): EdgeStatus[];
+declare function createMigrationStatusCommand(): Command;
+//#endregion
+export { MigrationStatusEntry, MigrationStatusResult, type StatusDiagnostic, type StatusRef, createMigrationStatusCommand, deriveEdgeStatuses };
+//# sourceMappingURL=migration-status.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-status.d.mts","names":[],"sources":["../../src/utils/migration-types.ts","../../src/utils/formatters/graph-migration-mapper.ts","../../src/commands/migration-status.ts"],"sourcesContent":[],"mappings":";;;;UAAiB,SAAA;;;;AAAjB;AAMiB,UAAA,gBAAA,CAAgB;;;;ECWrB,SAAA,KAAA,EAAA,SAAc,MAAA,EAAA;AAmB1B;;;KAnBY,cAAA;ADjBZ;AAMiB,UC8BA,UAAA,CD9BgB;;mBCgCd;;;;ADtCF,UE2DA,oBAAA,CF3DS;EAMT,SAAA,OAAA,EAAA,MAAgB;;;;ECWrB,SAAA,cAAc,EAAA,MAAA;EAmBT,SAAA,gBAEE,EAAA,MAAA;;mBC6BA;;AAKF,UAAA,qBAAA,CAAqB;EAGN,SAAA,EAAA,EAAA,IAAA;EAIL,SAAA,IAAA,EAAA,QAAA,GAAA,SAAA;EAeM,SAAA,UAAA,EAAA,SAnBD,oBAmBC,EAAA;EACd,SAAA,UAAA,CAAA,EAAA,MAAA;EACW,SAAA,UAAA,EAAA,MAAA;EACK,SAAA,YAAA,EAAA,MAAA;EAAU,SAAA,IAAA,CAAA,EAAA,SAlBlB,SAkBkB,EAAA;EAkD7B,SAAA,YAAkB,CAAA,EAAA;IAuiBlB,SAAA,QAAA,EAAA,MAAA;;;;;;;;;;;;;iCA5lBiB;mBACd;8BACW;mCACK;;;;;;;;;;;;;;;;;;;;iBAkDnB,kBAAA,QACP,uHAKN;iBAiiBa,4BAAA,CAAA,GAAgC"}

package/dist/commands/migration-status.mjs

@@ -0,0 +1,4 @@
+import "../config-loader-d_KF19Tw.mjs";
+import { n as deriveEdgeStatuses, t as createMigrationStatusCommand } from "../migration-status-B7OVZ-Ka.mjs";
+
+export { createMigrationStatusCommand, deriveEdgeStatuses };