@prisma-next/cli 0.12.0 → 0.13.0-dev.10

package/dist/commands/migrate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.mjs","names":[],"sources":["../../src/commands/migrate.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { errorUnknownInvariant, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type {\n  MigrationApplyFailure,\n  MigrationApplyPathDecision,\n  PerSpaceExecutionEntry,\n} from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorMarkerMismatch,\n  errorPathUnreachable,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  collectDeclaredInvariants,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { mapContractAtError } from '../utils/contract-at-errors';\nimport {\n  loadContractSpaceAggregateForCli,\n  refuseContractSpaceIntegrity,\n} from '../utils/contract-space-aggregate-loader';\nimport { toDeclaredExtensionsFromRaw } from '../utils/extension-pack-inputs';\nimport { formatMigrationApplyCommandOutput } from '../utils/formatters/migrations';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { executeRefAdvancement, readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrateCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly to?: string;\n  readonly advanceRef?: string;\n}\n\nexport interface MigrateResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly spaceId: string;\n    readonly dirName: string;\n    readonly migrationHash: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly perSpace: readonly PerSpaceExecutionEntry[];\n  readonly pathDecision?: MigrationApplyPathDecision;\n  readonly timings: {\n    readonly total: number;\n  };\n  readonly advancedRef?: { readonly name: string; readonly hash: string } | null;\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  if (failure.code === 'MIGRATION_PATH_NOT_FOUND') {\n    return errorPathUnreachable(failure);\n  }\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migrate --to <contract>` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nasync function executeMigrateCommand(\n  options: MigrateCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrateResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migrate (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migrate',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migrate',\n      }),\n    );\n  }\n\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  const toArg = options.to;\n\n  // Construct the family instance up-front so the on-disk contract read\n  // crosses the serializer seam (`familyInstance.deserializeContract`) at\n  // the read site. The downstream `client.migrationApply({ contract })`\n  // re-validates internally (no harm — validation is idempotent), but\n  // closing the gap at the read site is what makes the cast-pattern\n  // lint enforceable and matches the other CLI commands. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  let contractRaw: Contract;\n  let contractContent: string;\n  try {\n    contractContent = 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 a valid contract.json, then retry.',\n        }),\n      );\n    }\n    return notOk(\n      errorContractValidationFailed(\n        `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n  try {\n    contractRaw = familyInstance.deserializeContract(JSON.parse(contractContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const loadedAggregate = await loadContractSpaceAggregateForCli({\n    targetId: config.target.targetId,\n    migrationsDir,\n    appContract: contractRaw,\n    extensionPacks: config.extensionPacks ?? [],\n    deserializeContract: (json) => familyInstance.deserializeContract(json),\n  });\n  if (!loadedAggregate.ok) {\n    return notOk(loadedAggregate.failure);\n  }\n  const aggregate = loadedAggregate.value;\n  const integrityFailure = refuseContractSpaceIntegrity(aggregate, {\n    declaredExtensions: toDeclaredExtensionsFromRaw(\n      (config.extensionPacks ?? []) as ReadonlyArray<unknown>,\n    ),\n    checkContracts: true,\n  });\n  if (integrityFailure) {\n    return notOk(integrityFailure);\n  }\n\n  let refEntry: RefEntry | undefined;\n  let refName: string | undefined;\n  if (toArg) {\n    const refs = aggregate.app.refs;\n    const refResult = parseContractRef(toArg, { graph: aggregate.app.graph(), refs });\n    if (!refResult.ok) {\n      return notOk(mapRefResolutionError(refResult.failure));\n    }\n    if (refResult.value.provenance.kind === 'ref') {\n      refName = refResult.value.provenance.refName;\n      const resolved = refs[refName];\n      if (resolved) refEntry = resolved;\n    } else {\n      refEntry = { hash: refResult.value.hash, invariants: [] };\n    }\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: appMigrationsRelative },\n    ];\n    if (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (toArg) {\n      details.push({ label: 'to', value: toArg });\n    }\n    const header = formatStyledHeader({\n      command: 'migrate',\n      description: 'Apply planned migrations to advance the database',\n      url: 'https://pris.ly/migrate',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const appGraph = aggregate.app.graph();\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n\n    const allMarkers = await client.readAllMarkers();\n    const appMarker = allMarkers.get('app') ?? null;\n\n    if (appMarker !== null && !isGraphNode(appMarker.storageHash, appGraph)) {\n      return notOk(\n        errorMarkerMismatch(\n          appMarker.storageHash,\n          [...appGraph.nodes].sort(),\n          findLatestMigration(appGraph)?.to ?? null,\n        ),\n      );\n    }\n\n    if (refEntry && refEntry.invariants.length > 0) {\n      const declared = collectDeclaredInvariants(appGraph);\n      const known = new Set<string>(declared);\n      for (const id of appMarker?.invariants ?? []) known.add(id);\n      const unknown = refEntry.invariants.filter((id) => !known.has(id));\n      if (unknown.length > 0) {\n        return notOk(\n          mapMigrationToolsError(\n            errorUnknownInvariant({\n              ...ifDefined('refName', toArg),\n              unknown,\n              declared: [...declared].sort(),\n            }),\n          ),\n        );\n      }\n    }\n\n    if (!flags.quiet && !flags.json) {\n      ui.step('Loading contract spaces…');\n    }\n\n    // When `--to` resolves to an on-disk graph node with a matching bundle,\n    // verify and apply against THAT bundle's destination contract via\n    // `contractAt` — not the emitted `contract.json`. With `--to` omitted,\n    // or a target with no matching bundle, the emitted contract stays the\n    // apply contract (the only migrate-specific default). The same\n    // `contractAt` artifacts feed the optional ref-advancement snapshot.\n    let applyContract: Contract = contractRaw;\n    let snapshotContractJson: Record<string, unknown> = JSON.parse(contractContent);\n    let snapshotContractDts: string | undefined;\n    if (toArg && refEntry) {\n      const targetHash = refEntry.hash;\n      const matchingBundle = aggregate.app.packages.find((p) => p.metadata.to === targetHash);\n      if (matchingBundle) {\n        try {\n          const at = await aggregate.app.contractAt(\n            targetHash,\n            refName !== undefined ? { refName } : undefined,\n          );\n          applyContract = at.contract;\n          snapshotContractJson = at.contractJson as Record<string, unknown>;\n          snapshotContractDts = at.contractDts;\n        } catch (error) {\n          return mapContractAtError(error, { artifactRole: 'to' });\n        }\n      }\n    }\n\n    const applyResult = await client.migrationApply({\n      contract: applyContract,\n      migrationsDir,\n      ...ifDefined('refHash', refEntry?.hash),\n      ...(refEntry?.invariants ? { refInvariants: refEntry.invariants } : {}),\n      ...(refEntry !== undefined ? ifDefined('refName', toArg) : {}),\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    let advancedRef: { name: string; hash: string } | null = null;\n    if (options.advanceRef !== undefined) {\n      try {\n        const contractIR =\n          snapshotContractDts !== undefined\n            ? { contract: snapshotContractJson, contractDts: snapshotContractDts }\n            : await readContractIR(snapshotContractJson, contractPathAbsolute);\n        advancedRef = await executeRefAdvancement(\n          refsDir,\n          options.advanceRef,\n          value.markerHash,\n          contractIR,\n        );\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: value.perSpace.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      perSpace: value.perSpace,\n      ...ifDefined('pathDecision', value.pathDecision),\n      timings: { total: Date.now() - startTime },\n      advancedRef,\n    });\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    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migrate: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrateCommand(): Command {\n  const command = new Command('migrate');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to advance the database',\n    'Walks every contract space (app + extensions) and applies pending\\n' +\n      'on-disk migrations in canonical order (extensions alphabetically,\\n' +\n      'then app). Graph-walks the on-disk migration graph for every space.\\n' +\n      'Use --to to target a specific contract (hash, ref name, migration dir).',\n  );\n  setCommandExamples(command, [\n    'prisma-next migrate --db $DATABASE_URL',\n    'prisma-next migrate --to production --db $DATABASE_URL',\n    'prisma-next migrate --to sha256:abc123 --db $DATABASE_URL',\n  ]);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--to <contract>',\n      'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--advance-ref <name>', 'Advance the named ref to the post-apply marker after success')\n    .action(async (options: MigrateCommandOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const startTime = Date.now();\n\n      const ui = createTerminalUI(flags);\n\n      const result = await executeMigrateCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (migrateResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(migrateResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(migrateResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migrate.mjs","names":[],"sources":["../../src/commands/migrate.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport { createControlStack } from '@prisma-next/framework-components/control';\nimport { type ContractSpaceMember, requireHeadRef } from '@prisma-next/migration-tools/aggregate';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { errorUnknownInvariant, MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry, Refs } from '@prisma-next/migration-tools/refs';\nimport { readRefs } from '@prisma-next/migration-tools/refs';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport { planMemberPath } from '../control-api/operations/migrate';\nimport type {\n  MigrateFailure,\n  MigratePathDecision,\n  PerSpaceExecutionEntry,\n} from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFileNotFound,\n  errorMarkerMismatch,\n  errorPathUnreachable,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n  requireLiveDatabase,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  collectDeclaredInvariants,\n  maskConnectionUrl,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { mapContractAtError } from '../utils/contract-at-errors';\nimport {\n  buildReadAggregate,\n  loadContractSpaceAggregateForCli,\n  refuseContractSpaceIntegrity,\n} from '../utils/contract-space-aggregate-loader';\nimport { toDeclaredExtensionsFromRaw } from '../utils/extension-pack-inputs';\nimport {\n  computeLabelColumn,\n  computeMaxDirNameWidth,\n  renderMigrationGraphCommand,\n} from '../utils/formatters/migration-graph-command-render';\nimport { buildGrid } from '../utils/formatters/migration-graph-grid-layout';\nimport {\n  formatOnPathMigrationRow,\n  type MigrationEdgeAnnotation,\n} from '../utils/formatters/migration-graph-labels';\nimport { buildMigrationGraphRows } from '../utils/formatters/migration-graph-rows';\nimport {\n  highlightFromEdgeAnnotations,\n  indentMigrationGraphTreeBlock,\n} from '../utils/formatters/migration-graph-space-render';\nimport { formatMigrationApplyCommandOutput } from '../utils/formatters/migrations';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { executeRefAdvancement, readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\nimport { listRefsByContractHash } from './migration-list';\n\ninterface MigrateCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly to?: string;\n  readonly advanceRef?: string;\n  readonly show?: boolean;\n  readonly from?: string;\n}\n\n/**\n * One migration that will run in a `migrate --show` preview, in execution order.\n */\nexport interface MigrateShowMigration {\n  readonly spaceId: string;\n  readonly dirName: string;\n  readonly migrationHash: string;\n  readonly from: string;\n  readonly to: string;\n}\n\n/** Result returned by `migrate --show`. Read-only; no writes performed. */\nexport interface MigrateShowResult {\n  readonly ok: true;\n  readonly migrations: readonly MigrateShowMigration[];\n  readonly summary: string;\n  /**\n   * Pre-rendered Tier-3 graph tree for human output. Off-path migrations render\n   * dim; on-path migrations render in ordinary colours. Only present in human\n   * (non-JSON) mode.\n   */\n  readonly graphOutput?: string;\n  /**\n   * Name column width for the \"Will run, in order:\" list — globally aligned with\n   * every graph-tree section. Only present in human (non-JSON) mode.\n   */\n  readonly runListDirNameWidth?: number;\n  /**\n   * Left-pad offset (number of blank spaces) matching the graph's data-column\n   * offset (`globalMaxEdgeTreePrefixWidth`). Used to align list rows with graph\n   * rows so every `→` in the output (graph + list) lands at the same column.\n   * Only present in human (non-JSON) mode when multiple spaces are rendered.\n   */\n  readonly runListLeftPad?: number;\n}\n\nexport interface MigrateResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly spaceId: string;\n    readonly dirName: string;\n    readonly migrationHash: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly perSpace: readonly PerSpaceExecutionEntry[];\n  readonly pathDecision?: MigratePathDecision;\n  readonly timings: {\n    readonly total: number;\n  };\n  readonly advancedRef?: { readonly name: string; readonly hash: string } | null;\n}\n\n/**\n * Read-only preview of the migration path `migrate` will take.\n *\n * Computes the path through the SAME seam as `executeMigrate`:\n * - `readAllMarkers()` for the from-state (when no `--from` is given), preserving\n *   the full marker including `invariants` (not just `storageHash`).\n * - `planMemberPath()` (shared with `executeMigrate`) for per-member path selection,\n *   which feeds `graphWalkStrategy()` with the same target hash, target invariants,\n *   and current marker as the real apply path uses.\n *\n * Returns BEFORE any write boundary (`runMigration` / marker / DDL). No\n * DB state is mutated.\n */\nasync function executeMigrateShowCommand(\n  options: MigrateCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrateShowResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative, refsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  const hasDriver = !!config.driver;\n  const hasExplicitFrom = options.from !== undefined;\n\n  // When --from is omitted we read the live DB marker (same as migrate's default).\n  // When --from is given, we're in offline hypothetical mode — no connection needed.\n  if (!hasExplicitFrom) {\n    const missingDb = requireLiveDatabase({\n      dbConnection,\n      hasDriver,\n      why: 'migrate --show needs a database connection to read the live marker (or pass --from <contract> for an offline preview)',\n      retryCommand: 'prisma-next migrate --show --from <contract>',\n    });\n    if (missingDb) {\n      return notOk(missingDb);\n    }\n  }\n\n  let allRefs: Refs = {};\n  try {\n    allRefs = await readRefs(refsDir);\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  const loaded = await buildReadAggregate(config, { migrationsDir });\n  if (!loaded.ok) {\n    return notOk(loaded.failure);\n  }\n  const { aggregate, contractHash } = loaded.value;\n  const appGraph = aggregate.app.graph();\n\n  // Resolve the --to target (defaults to the on-disk contract, same as migrate).\n  // Also capture the ref's invariants so planMemberPath feeds graphWalkStrategy the\n  // same target invariants that real migrate would use (refInvariants ?? headRef.invariants).\n  let targetHash: string = contractHash;\n  let refInvariants: readonly string[] | undefined;\n  if (options.to) {\n    const toResult = parseContractRef(options.to, {\n      graph: appGraph,\n      refs: allRefs,\n      contractHash,\n    });\n    if (!toResult.ok) {\n      return notOk(mapRefResolutionError(toResult.failure));\n    }\n    if (toResult.value.provenance.kind === 'reserved-db') {\n      return notOk(\n        errorDatabaseConnectionRequired({\n          why: '@db is not valid as a --to target; it names the live database state, not a target contract.',\n          commandName: 'migrate --show',\n        }),\n      );\n    }\n    targetHash = toResult.value.hash;\n    if (toResult.value.provenance.kind === 'ref') {\n      const refEntry = allRefs[toResult.value.provenance.refName];\n      if (refEntry) refInvariants = refEntry.invariants;\n    }\n  }\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 (dbConnection && !hasExplicitFrom) {\n      details.push({ label: 'database', value: maskConnectionUrl(String(dbConnection)) });\n    }\n    if (options.from) {\n      details.push({ label: 'from', value: options.from });\n    }\n    if (options.to) {\n      details.push({ label: 'to', value: options.to });\n    }\n    const header = formatStyledHeader({\n      command: 'migrate --show',\n      description: 'Preview the migration path migrate will take (read-only)',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Resolve the from-state.\n  // - Explicit --from: parse it offline (no connection).\n  // - Omitted: read the live DB marker via readAllMarkers() — the same source migrate uses.\n  //\n  // Full marker records (storageHash + invariants) are preserved so planMemberPath\n  // can feed graphWalkStrategy the complete currentMarker — exactly as executeMigrate\n  // does via familyInstance.readAllMarkers(). A stripped { storageHash, invariants: [] }\n  // marker would produce a different `required` set and a different (incorrect) path.\n  type LiveMarker = { readonly storageHash: string; readonly invariants: readonly string[] };\n  const markerBySpace = new Map<string, LiveMarker | null>();\n  const allMembers: ReadonlyArray<ContractSpaceMember> = [aggregate.app, ...aggregate.extensions];\n\n  if (hasExplicitFrom) {\n    // @db with explicit --from requires a connection\n    if (options.from === '@db') {\n      const missingDb = requireLiveDatabase({\n        dbConnection,\n        hasDriver,\n        why: '@db resolves to the live database marker and requires a --db connection',\n        retryCommand: 'prisma-next migrate --show --from @db --db $DATABASE_URL',\n      });\n      if (missingDb) {\n        return notOk(missingDb);\n      }\n      // Fall through to the connection path below\n    } else {\n      const fromResult = parseContractRef(options.from, {\n        graph: appGraph,\n        refs: allRefs,\n        contractHash,\n      });\n      if (!fromResult.ok) {\n        return notOk(mapRefResolutionError(fromResult.failure));\n      }\n      if (fromResult.value.provenance.kind === 'reserved-db') {\n        // Unreachable given the @db branch above, but guard for safety\n        const missingDb = requireLiveDatabase({\n          dbConnection,\n          hasDriver,\n          why: '@db resolves to the live database marker and requires a --db connection',\n        });\n        if (missingDb) {\n          return notOk(missingDb);\n        }\n      } else {\n        // Offline hypothetical: the --from ref only carries a hash (no live invariants).\n        // Apply the from-hash marker to the APP space only. Extension spaces are left\n        // absent from markerBySpace (treated as null / greenfield by planMemberPath),\n        // so they plan from their own marker → own head — exactly as executeMigrate does.\n        const fromHash = fromResult.value.hash;\n        const offlineMarker: LiveMarker | null =\n          fromHash === EMPTY_CONTRACT_HASH ? null : { storageHash: fromHash, invariants: [] };\n        markerBySpace.set(aggregate.app.spaceId, offlineMarker);\n      }\n    }\n  }\n\n  // If we need the live DB marker (no --from, or --from @db), connect and read.\n  const needsLiveMarker = !hasExplicitFrom || options.from === '@db';\n  if (needsLiveMarker) {\n    if (!dbConnection || !hasDriver) {\n      return notOk(\n        errorDatabaseConnectionRequired({\n          why: 'A database connection is required to read the live marker for migrate --show',\n          commandName: 'migrate --show',\n        }),\n      );\n    }\n    const client = createControlClient({\n      family: config.family,\n      target: config.target,\n      adapter: config.adapter,\n      driver: config.driver!,\n      extensionPacks: config.extensionPacks ?? [],\n    });\n    try {\n      await client.connect(dbConnection);\n      const allMarkers = await client.readAllMarkers();\n      // Store the full marker record (storageHash + invariants) per space.\n      // This is the same data executeMigrate uses via familyInstance.readAllMarkers().\n      for (const member of allMembers) {\n        const marker = allMarkers.get(member.spaceId);\n        markerBySpace.set(member.spaceId, marker ?? null);\n      }\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      return notOk(\n        errorUnexpected(error instanceof Error ? error.message : String(error), {\n          why: `Failed to read live DB marker: ${error instanceof Error ? error.message : String(error)}`,\n        }),\n      );\n    } finally {\n      await client.close();\n    }\n  }\n\n  // Walk the path via planMemberPath — the same helper executeMigrate uses.\n  // planMemberPath feeds graphWalkStrategy identical inputs (targetHash, targetInvariants,\n  // currentMarker with full invariants), so the preview path is always the path migrate runs.\n  //\n  // Canonical schedule order: extensions alphabetically first, then app — mirroring the\n  // runner's `applyOrder` in operations/migrate.ts so the \"Will run, in order:\" list\n  // reflects the actual execution sequence (extensions install first, app last).\n  const canonicalOrderMembers: ReadonlyArray<ContractSpaceMember> = [\n    ...aggregate.extensions,\n    aggregate.app,\n  ];\n  const orderedMigrations: MigrateShowMigration[] = [];\n  for (const member of canonicalOrderMembers) {\n    const isAppMember = member.spaceId === aggregate.app.spaceId;\n    const headRef = requireHeadRef(member);\n    const memberTargetHash = isAppMember ? targetHash : headRef.hash;\n    const memberRefInvariants = isAppMember ? refInvariants : undefined;\n    const liveMarker = markerBySpace.get(member.spaceId) ?? null;\n\n    const outcome = planMemberPath({\n      member,\n      aggregate,\n      targetHash: memberTargetHash,\n      refInvariants: memberRefInvariants,\n      liveMarker,\n    });\n\n    if (outcome.kind === 'at-head') {\n      // Empty-graph member already at target — nothing to run for this space.\n      continue;\n    }\n    if (outcome.kind === 'never-planned') {\n      return notOk(\n        errorPathUnreachable({\n          code: 'MIGRATION_PATH_NOT_FOUND',\n          summary: `No on-disk migrations for contract space \"${outcome.spaceId}\"`,\n          why: `migrate is replay-only: space \"${outcome.spaceId}\" has no on-disk migrations but its head ref targets \"${outcome.targetHash}\".`,\n          meta: { spaceId: outcome.spaceId, target: outcome.targetHash, kind: 'neverPlanned' },\n        }),\n      );\n    }\n    if (outcome.kind === 'unreachable') {\n      const fromHash = outcome.liveMarker?.storageHash ?? EMPTY_CONTRACT_HASH;\n      return notOk(\n        errorPathUnreachable({\n          code: 'MIGRATION_PATH_NOT_FOUND',\n          summary: `No migration path from ${fromHash.slice(0, 14)} to ${outcome.targetHash.slice(0, 14)} in space \"${outcome.spaceId}\".`,\n          why: `The migration graph has no path from the from-state to the target in space \"${outcome.spaceId}\".`,\n          meta: { spaceId: outcome.spaceId, from: fromHash, to: outcome.targetHash },\n        }),\n      );\n    }\n    if (outcome.kind === 'unsatisfiable') {\n      return notOk(\n        errorRuntime(`Missing required invariants for space \"${outcome.spaceId}\"`, {\n          why: `The path requires invariants not available on disk: ${outcome.missing.join(', ')}`,\n        }),\n      );\n    }\n\n    for (const edge of outcome.plan.migrationEdges) {\n      orderedMigrations.push({\n        spaceId: member.spaceId,\n        dirName: edge.dirName,\n        migrationHash: edge.migrationHash,\n        from: edge.from,\n        to: edge.to,\n      });\n    }\n  }\n\n  const count = orderedMigrations.length;\n  const summary =\n    count === 0\n      ? 'Already up to date — nothing to run'\n      : `${count} migration${count === 1 ? '' : 's'} will run`;\n\n  // Build the Tier-3 graph visualization (human mode only; skipped for --json).\n  // Reuses the existing annotation hook — no parallel renderer.\n  let graphOutput: string | undefined;\n  let runListDirNameWidth: number | undefined;\n  let runListLeftPad: number | undefined;\n  if (!flags.json) {\n    const onPathHashes = new Set(orderedMigrations.map((m) => m.migrationHash));\n    const colorize = flags.color !== false;\n\n    // Build layouts for all spaces first so we can compute global column widths\n    // before rendering. This ensures the name column, hash column, and ops column\n    // start at the same horizontal offset across every space section AND the\n    // \"Will run, in order:\" list below.\n    const memberLayouts = allMembers.map((member) => {\n      const isApp = member.spaceId === aggregate.app.spaceId;\n      const memberGraph = member.graph();\n      const rowModel = buildMigrationGraphRows(memberGraph, isApp ? { contractHash } : {});\n      const edgeAnnotations = new Map<string, MigrationEdgeAnnotation>();\n      for (const edge of memberGraph.migrationByHash.values()) {\n        edgeAnnotations.set(edge.migrationHash, {\n          pathHighlight: onPathHashes.has(edge.migrationHash) ? 'on-path' : 'off-path',\n        });\n      }\n      // The on-path migration set lifts to focus mode so the chosen route draws\n      // green/continuous; off-path lanes dim. Rows, gutter, and labels all come\n      // from this one grid.\n      const grid = buildGrid(rowModel, {}, highlightFromEdgeAnnotations(edgeAnnotations));\n      return { member, isApp, memberGraph, rowModel, grid, edgeAnnotations };\n    });\n\n    // Global max across all space grids so every section's labels share columns.\n    const globalLabelColumn =\n      memberLayouts.length > 1\n        ? Math.max(...memberLayouts.map(({ grid }) => computeLabelColumn(grid, 'unicode')))\n        : undefined;\n    const globalMaxDirNameWidthFromLayouts =\n      memberLayouts.length > 1\n        ? Math.max(...memberLayouts.map(({ rowModel }) => computeMaxDirNameWidth(rowModel)))\n        : undefined;\n    // The run-list name column width must be at least as wide as the global tree dirName\n    // width so that tree sections and the list align at the hash column.\n    const runListMaxFromMigrations =\n      orderedMigrations.length > 0\n        ? Math.max(...orderedMigrations.map((m) => m.dirName.length))\n        : 0;\n    const globalMaxDirNameWidth =\n      globalMaxDirNameWidthFromLayouts !== undefined\n        ? Math.max(globalMaxDirNameWidthFromLayouts, runListMaxFromMigrations)\n        : undefined;\n    runListDirNameWidth = globalMaxDirNameWidth ?? runListMaxFromMigrations;\n    runListLeftPad = globalLabelColumn;\n\n    // Render each space section with globally computed widths.\n    const showSpaceHeadings = allMembers.length > 1;\n    const sections: string[] = [];\n    for (const { member, isApp, rowModel, grid, edgeAnnotations } of memberLayouts) {\n      const liveMarker = markerBySpace.get(member.spaceId) ?? null;\n      const liveMarkerHash = liveMarker?.storageHash ?? EMPTY_CONTRACT_HASH;\n      const tree = renderMigrationGraphCommand({\n        grid,\n        rowModel,\n        contractHash,\n        isAppSpace: isApp,\n        ...(needsLiveMarker ? { dbHash: liveMarkerHash } : {}),\n        refsByHash: listRefsByContractHash(member),\n        edgeAnnotationsByHash: edgeAnnotations,\n        colorize,\n        glyphMode: 'unicode',\n        ...(globalLabelColumn !== undefined ? { globalLabelColumn } : {}),\n        ...(globalMaxDirNameWidth !== undefined ? { globalMaxDirNameWidth } : {}),\n      });\n      if (tree.length === 0) continue;\n      if (showSpaceHeadings) {\n        sections.push(`${member.spaceId}:\\n${indentMigrationGraphTreeBlock(tree, '  ')}`);\n      } else {\n        sections.push(tree);\n      }\n    }\n    graphOutput = sections.join('\\n\\n');\n  }\n\n  return ok({\n    ok: true,\n    migrations: orderedMigrations,\n    summary,\n    ...(graphOutput !== undefined ? { graphOutput } : {}),\n    ...(runListDirNameWidth !== undefined ? { runListDirNameWidth } : {}),\n    ...(runListLeftPad !== undefined ? { runListLeftPad } : {}),\n  });\n}\n\nfunction formatMigrateShowOutput(result: MigrateShowResult, flags: GlobalFlags): string {\n  if (flags.quiet) return '';\n  const colorize = flags.color !== false;\n  const lines: string[] = [];\n  // Graph tree first (shows the full topology with on-path highlighted).\n  if (result.graphOutput !== undefined && result.graphOutput.length > 0) {\n    lines.push(result.graphOutput);\n    lines.push('');\n  }\n  const n = result.migrations.length;\n  if (n > 0) {\n    // Consolidated header: one line replaces the old separate summary + blank +\n    // \"Will run, in order:\" header.\n    lines.push(`The following ${n} migration${n === 1 ? '' : 's'} will run:`);\n    // Ordered list rendered through the SAME on-path row renderer as the tree.\n    // `formatOnPathMigrationRow` uses PATH_HIGHLIGHT_STYLES.onPath so the list and\n    // graph-tree rows are styled identically — changing the on-path colour in future\n    // is a one-line edit in PATH_HIGHLIGHT_STYLES.\n    //\n    // Alignment anchor: the `→` arrow (source-hash onward) must land at the SAME\n    // absolute column as in graph edge rows, across every graph section and this list.\n    //\n    // Multi-space output layout (space headings + 2-space indented tree sections):\n    //   Graph edge row:  [2 heading][G gutter][D dirName][7 source] [→] [dest]\n    //   List row:        [2 spaces][L dirName][  ][7 source] [→] [dest]\n    //   Alignment:  2 + G + D + 9 = 2 + L + 2 + 9   =>   L = G + D - 2\n    //\n    // Single-space output layout (flat tree, no heading indent):\n    //   Graph edge row:  [G gutter][D dirName][7 source] [→] [dest]\n    //   List row:        [2 spaces][L dirName][  ][7 source] [→] [dest]\n    //   Alignment:  G + D + 9 = 2 + L + 2 + 9   =>   L = G + D - 4\n    //\n    // D (edgeDirNameWidth) = max(rawDirNameWidth + LABEL_GAP, MIN_HASH_DATA_COLUMN - G)\n    // where LABEL_GAP = 2 and MIN_HASH_DATA_COLUMN = 25 (same constants as the renderer).\n    //\n    // runListLeftPad is set only for multi-space; undefined means single-space.\n    const isMultiSpace = result.runListLeftPad !== undefined;\n    const gutter = result.runListLeftPad ?? 0;\n    const rawDirNameWidth =\n      result.runListDirNameWidth ?? Math.max(...result.migrations.map((m) => m.dirName.length));\n    const edgeDirNameWidth = Math.max(rawDirNameWidth + 2, 25 - gutter);\n    const listDirNameWidth = gutter + edgeDirNameWidth - (isMultiSpace ? 2 : 4);\n    for (const m of result.migrations) {\n      lines.push(\n        `  ${formatOnPathMigrationRow(m.dirName, m.from, m.to, listDirNameWidth, colorize, 'unicode')}`,\n      );\n    }\n  } else {\n    lines.push(result.summary);\n  }\n  return lines.join('\\n');\n}\n\nfunction mapApplyFailure(failure: MigrateFailure): CliStructuredErrorType {\n  if (failure.code === 'MIGRATION_PATH_NOT_FOUND') {\n    return errorPathUnreachable(failure);\n  }\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migrate --to <contract>` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nasync function executeMigrateCommand(\n  options: MigrateCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrateResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsRelative, refsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migrate (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migrate',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migrate',\n      }),\n    );\n  }\n\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  const toArg = options.to;\n\n  // Construct the family instance up-front so the on-disk contract read\n  // crosses the serializer seam (`familyInstance.deserializeContract`) at\n  // the read site. The downstream `client.migrate({ contract })`\n  // re-validates internally (no harm — validation is idempotent), but\n  // closing the gap at the read site is what makes the cast-pattern\n  // lint enforceable and matches the other CLI commands. See TML-2536.\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  let contractRaw: Contract;\n  let contractContent: string;\n  try {\n    contractContent = 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 a valid contract.json, then retry.',\n        }),\n      );\n    }\n    return notOk(\n      errorContractValidationFailed(\n        `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n  try {\n    contractRaw = familyInstance.deserializeContract(JSON.parse(contractContent) as unknown);\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const loadedAggregate = await loadContractSpaceAggregateForCli({\n    targetId: config.target.targetId,\n    migrationsDir,\n    appContract: contractRaw,\n    extensionPacks: config.extensionPacks ?? [],\n    deserializeContract: (json) => familyInstance.deserializeContract(json),\n  });\n  if (!loadedAggregate.ok) {\n    return notOk(loadedAggregate.failure);\n  }\n  const aggregate = loadedAggregate.value;\n  const integrityFailure = refuseContractSpaceIntegrity(aggregate, {\n    declaredExtensions: toDeclaredExtensionsFromRaw(\n      (config.extensionPacks ?? []) as ReadonlyArray<unknown>,\n    ),\n    checkContracts: true,\n  });\n  if (integrityFailure) {\n    return notOk(integrityFailure);\n  }\n\n  let refEntry: RefEntry | undefined;\n  let refName: string | undefined;\n  if (toArg) {\n    const refs = aggregate.app.refs;\n    const refResult = parseContractRef(toArg, { graph: aggregate.app.graph(), refs });\n    if (!refResult.ok) {\n      return notOk(mapRefResolutionError(refResult.failure));\n    }\n    if (refResult.value.provenance.kind === 'ref') {\n      refName = refResult.value.provenance.refName;\n      const resolved = refs[refName];\n      if (resolved) refEntry = resolved;\n    } else {\n      refEntry = { hash: refResult.value.hash, invariants: [] };\n    }\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const details: Array<{ label: string; value: string }> = [\n      { label: 'config', value: configPath },\n      { label: 'migrations', value: appMigrationsRelative },\n    ];\n    if (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (toArg) {\n      details.push({ label: 'to', value: toArg });\n    }\n    const header = formatStyledHeader({\n      command: 'migrate',\n      description: 'Apply planned migrations to advance the database',\n      url: 'https://pris.ly/migrate',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const appGraph = aggregate.app.graph();\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n\n    const allMarkers = await client.readAllMarkers();\n    const appMarker = allMarkers.get('app') ?? null;\n\n    if (appMarker !== null && !isGraphNode(appMarker.storageHash, appGraph)) {\n      return notOk(\n        errorMarkerMismatch(\n          appMarker.storageHash,\n          [...appGraph.nodes].sort(),\n          findLatestMigration(appGraph)?.to ?? null,\n        ),\n      );\n    }\n\n    if (refEntry && refEntry.invariants.length > 0) {\n      const declared = collectDeclaredInvariants(appGraph);\n      const known = new Set<string>(declared);\n      for (const id of appMarker?.invariants ?? []) known.add(id);\n      const unknown = refEntry.invariants.filter((id) => !known.has(id));\n      if (unknown.length > 0) {\n        return notOk(\n          mapMigrationToolsError(\n            errorUnknownInvariant({\n              ...ifDefined('refName', toArg),\n              unknown,\n              declared: [...declared].sort(),\n            }),\n          ),\n        );\n      }\n    }\n\n    if (!flags.quiet && !flags.json) {\n      ui.step('Loading contract spaces…');\n    }\n\n    // When `--to` resolves to an on-disk graph node with a matching bundle,\n    // verify and apply against THAT bundle's destination contract via\n    // `contractAt` — not the emitted `contract.json`. With `--to` omitted,\n    // or a target with no matching bundle, the emitted contract stays the\n    // apply contract (the only migrate-specific default). The same\n    // `contractAt` artifacts feed the optional ref-advancement snapshot.\n    let applyContract: Contract = contractRaw;\n    let snapshotContractJson: Record<string, unknown> = JSON.parse(contractContent);\n    let snapshotContractDts: string | undefined;\n    if (toArg && refEntry) {\n      const targetHash = refEntry.hash;\n      const matchingBundle = aggregate.app.packages.find((p) => p.metadata.to === targetHash);\n      if (matchingBundle) {\n        try {\n          const at = await aggregate.app.contractAt(\n            targetHash,\n            refName !== undefined ? { refName } : undefined,\n          );\n          applyContract = at.contract;\n          snapshotContractJson = at.contractJson as Record<string, unknown>;\n          snapshotContractDts = at.contractDts;\n        } catch (error) {\n          return mapContractAtError(error, { artifactRole: 'to' });\n        }\n      }\n    }\n\n    const applyResult = await client.migrate({\n      contract: applyContract,\n      migrationsDir,\n      ...ifDefined('refHash', refEntry?.hash),\n      ...(refEntry?.invariants ? { refInvariants: refEntry.invariants } : {}),\n      ...(refEntry !== undefined ? ifDefined('refName', toArg) : {}),\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    let advancedRef: { name: string; hash: string } | null = null;\n    if (options.advanceRef !== undefined) {\n      try {\n        const contractIR =\n          snapshotContractDts !== undefined\n            ? { contract: snapshotContractJson, contractDts: snapshotContractDts }\n            : await readContractIR(snapshotContractJson, contractPathAbsolute);\n        advancedRef = await executeRefAdvancement(\n          refsDir,\n          options.advanceRef,\n          value.markerHash,\n          contractIR,\n        );\n      } catch (error) {\n        if (MigrationToolsError.is(error)) {\n          return notOk(mapMigrationToolsError(error));\n        }\n        throw error;\n      }\n    }\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: value.perSpace.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      perSpace: value.perSpace,\n      ...ifDefined('pathDecision', value.pathDecision),\n      timings: { total: Date.now() - startTime },\n      advancedRef,\n    });\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    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migrate: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrateCommand(): Command {\n  const command = new Command('migrate');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to advance the database',\n    'Walks every contract space (app + extensions) and applies pending\\n' +\n      'on-disk migrations in canonical order (extensions alphabetically,\\n' +\n      'then app). Graph-walks the on-disk migration graph for every space.\\n' +\n      'Use --to to target a specific contract (hash, ref name, migration dir).\\n' +\n      'Use --show for a read-only preview of the path that would run.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migrate --db $DATABASE_URL',\n    'prisma-next migrate --to production --db $DATABASE_URL',\n    'prisma-next migrate --to sha256:abc123 --db $DATABASE_URL',\n    'prisma-next migrate --show --db $DATABASE_URL',\n    'prisma-next migrate --show --from @contract --to production',\n  ]);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option(\n      '--to <contract>',\n      'Target contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--advance-ref <name>', 'Advance the named ref to the post-apply marker after success')\n    .option('--show', 'Preview the migration path without applying (read-only)')\n    .option(\n      '--from <contract>',\n      'From-state for --show preview (@contract, @db, hash, ref name, or migration dir)',\n    )\n    .action(async (options: MigrateCommandOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const startTime = Date.now();\n\n      const ui = createTerminalUI(flags);\n\n      if (options.show) {\n        // Read-only path: compute the migration plan and print the ordered list.\n        // NEVER reaches runMigration() or any write boundary.\n        const result = await executeMigrateShowCommand(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 {\n            // Print directly to stdout — not via ui.log() which injects Clack's │ gutter.\n            ui.output(formatMigrateShowOutput(showResult, flags));\n          }\n        });\n\n        process.exit(exitCode);\n        return;\n      }\n\n      const result = await executeMigrateCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (migrateResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(migrateResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(migrateResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1,19 +1,61 @@
+import { N as CliStructuredError } from "../types-C_tYiJYx.mjs";
+import { f as migrationCheckResultSchema, n as MigrationCheckResult, t as CheckFailure } from "../schemas-CeGMYFYX.mjs";
 import { Command } from "commander";
-//#region src/utils/integrity-violation-to-check-failure.d.ts
-interface CheckFailure {
-  readonly pnCode: string;
-  readonly where: string;
-  readonly why: string;
-  readonly fix: string;
-}
-//#endregion
+import { Result } from "@prisma-next/utils/result";
+import { ContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
+import { Refs } from "@prisma-next/migration-tools/refs";
+import { MigrationGraph } from "@prisma-next/migration-tools/graph";
+import { OnDiskMigrationPackage } from "@prisma-next/migration-tools/package";
+
 //#region src/commands/migration-check.d.ts
-interface MigrationCheckResult {
-  readonly ok: boolean;
-  readonly failures: readonly CheckFailure[];
-  readonly summary: string;
+/**
+ * One contract space's on-disk state, resolved for the explicit graph
+ * checks `runMigrationCheck` runs per space: the space's migration
+ * packages, its user-authored refs, its induced graph, and the absolute
+ * `migrations/<space>/` + `migrations/<space>/refs/` directories the
+ * file-existence and dangling-ref `where` paths are derived from.
+ */
+interface CheckSpace {
+  readonly spaceId: string;
+  readonly packages: readonly OnDiskMigrationPackage[];
+  readonly refs: Refs;
+  readonly graph: MigrationGraph;
+  readonly migrationsDir: string;
+  readonly refsDir: string;
+}
+/**
+ * Project the loaded {@link ContractSpaceAggregate} into the
+ * {@link CheckSpace} rows the multi-space check iterates — one per on-disk
+ * contract-space directory, in the aggregate's `app`-first ordering. Mirrors
+ * `migration list`'s `migrationSpaceListEntriesFromAggregate`: space
+ * membership matches the on-disk directories, package / ref / graph data come
+ * from `aggregate.space(id)`.
+ */
+declare function enumerateCheckSpaces(aggregate: ContractSpaceAggregate, projectMigrationsDir: string): Promise<readonly CheckSpace[]>;
+/**
+ * Inputs for {@link runMigrationCheck} — the multi-space policy core of
+ * the holistic (no-arg) `migration check`. Enumeration is supplied by the
+ * caller (the CLI shell builds it from {@link enumerateCheckSpaces}); the
+ * core does not touch config, flags, or streams.
+ */
+interface RunMigrationCheckInputs {
+  readonly spaces: readonly CheckSpace[];
+  readonly spaceFilter?: string;
 }
+/**
+ * Policy core of the holistic `migration check`: validates `--space`,
+ * narrows the pre-enumerated spaces, and runs the per-space explicit graph
+ * checks (file-existence, snapshot consistency, reachability, dangling
+ * refs), aggregating every failure into one {@link MigrationCheckResult}.
+ *
+ * `--space` validation mirrors `migration list`: an invalid id →
+ * {@link errorInvalidSpaceId}; an id with no on-disk space →
+ * {@link errorSpaceNotFound}. Both map to exit `PRECONDITION` at the shell.
+ * Aggregate-integrity violations (which already span every space) are folded
+ * in by the caller, not here.
+ */
+declare function runMigrationCheck(inputs: RunMigrationCheckInputs): Result<MigrationCheckResult, CliStructuredError>;
 declare function createMigrationCheckCommand(): Command;
 //#endregion
-export { type CheckFailure, MigrationCheckResult, createMigrationCheckCommand };
+export { type CheckFailure, CheckSpace, type MigrationCheckResult, RunMigrationCheckInputs, createMigrationCheckCommand, enumerateCheckSpaces, migrationCheckResultSchema, runMigrationCheck };
 //# sourceMappingURL=migration-check.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-check.d.mts","names":[],"sources":["../../src/utils/integrity-violation-to-check-failure.ts","../../src/commands/migration-check.ts"],"mappings":";;UAGiB,YAAA;EAAA,SACN,MAAA;EAAA,SACA,KAAA;EAAA,SACA,GAAA;EAAA,SACA,GAAA;AAAA;;;UCgCM,oBAAA;EAAA,SACN,EAAA;EAAA,SACA,QAAA,WAAmB,YAAY;EAAA,SAC/B,OAAA;AAAA;AAAA,iBAsOK,2BAAA,CAAA,GAA+B,OAAO"}
+{"version":3,"file":"migration-check.d.mts","names":[],"sources":["../../src/commands/migration-check.ts"],"mappings":";;;;;;;;;;AAoIA;;;;;;;AAAA,UAAiB,UAAA;EAAA,SACN,OAAA;EAAA,SACA,QAAA,WAAmB,sBAAA;EAAA,SACnB,IAAA,EAAM,IAAA;EAAA,SACN,KAAA,EAAO,cAAA;EAAA,SACP,aAAA;EAAA,SACA,OAAA;AAAA;;;;AAAO;AAWlB;;;;iBAAsB,oBAAA,CACpB,SAAA,EAAW,sBAAA,EACX,oBAAA,WACC,OAAA,UAAiB,UAAA;;;;;;;UAyGH,uBAAA;EAAA,SACN,MAAA,WAAiB,UAAU;EAAA,SAC3B,WAAA;AAAA;AAFX;;;;;;;;AAEsB;AAetB;;;AAjBA,iBAiBgB,iBAAA,CACd,MAAA,EAAQ,uBAAA,GACP,MAAA,CAAO,oBAAA,EAAsB,kBAAA;AAAA,iBA+ShB,2BAAA,IAA+B,OAAO"}

package/dist/commands/migration-check.mjs

@@ -1,2 +1,3 @@
-import { t as createMigrationCheckCommand } from "../migration-check-BiBJoYYW.mjs";
-export { createMigrationCheckCommand };
+import { n as enumerateCheckSpaces, r as runMigrationCheck, t as createMigrationCheckCommand } from "../migration-check-soB5uZEQ.mjs";
+import { t as migrationCheckResultSchema } from "../schemas-KhXMzNA_.mjs";
+export { createMigrationCheckCommand, enumerateCheckSpaces, migrationCheckResultSchema, runMigrationCheck };

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

@@ -1,7 +1,7 @@
-import { N as CliStructuredError } from "../types-Dt_SfqFm.mjs";
-import { n as GlobalFlags, t as CommonCommandOptions } from "../global-flags-DEHjV8_s.mjs";
-import { n as StatusRef } from "../migration-types-D2FW63pr.mjs";
-import { t as TerminalUI } from "../terminal-ui-5Y6mrg93.mjs";
+import { N as CliStructuredError } from "../types-C_tYiJYx.mjs";
+import { o as MigrationSpaceGraphEntry } from "../schemas-CeGMYFYX.mjs";
+import { n as GlobalFlags, t as CommonCommandOptions } from "../global-flags-BpoOYtNZ.mjs";
+import { t as TerminalUI } from "../terminal-ui-DGRNFWna.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
 import { MigrationGraph } from "@prisma-next/migration-tools/graph";
@@ -10,18 +10,27 @@ import { MigrationGraph } from "@prisma-next/migration-tools/graph";
 interface MigrationGraphOptions extends CommonCommandOptions {
   readonly config?: string;
   readonly dot?: boolean;
-  readonly tree?: boolean;
+  readonly space?: string;
   readonly ascii?: boolean;
+  readonly legend?: boolean;
+}
+interface MigrationGraphTreeSection {
+  readonly space: string;
+  readonly tree: string;
+  readonly showHeading: boolean;
 }
 interface MigrationGraphResult {
   readonly ok: true;
+  /** App-space graph for the `--dot` Graphviz output. */
   readonly graph: MigrationGraph;
-  readonly contractHash: string | null;
-  readonly refs: readonly StatusRef[];
+  /** Nested per-space contracts + migrations for `--json`. */
+  readonly spaces: readonly MigrationSpaceGraphEntry[];
+  readonly treeSections: readonly MigrationGraphTreeSection[];
   readonly summary: string;
 }
+declare function formatMigrationGraphHumanOutput(result: MigrationGraphResult): string;
 declare function executeMigrationGraphCommand(options: MigrationGraphOptions, flags: GlobalFlags, ui: TerminalUI): Promise<Result<MigrationGraphResult, CliStructuredError>>;
 declare function createMigrationGraphCommand(): Command;
 //#endregion
-export { MigrationGraphResult, createMigrationGraphCommand, executeMigrationGraphCommand };
+export { MigrationGraphResult, MigrationGraphTreeSection, createMigrationGraphCommand, executeMigrationGraphCommand, formatMigrationGraphHumanOutput };
 //# sourceMappingURL=migration-graph.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-graph.d.mts","names":[],"sources":["../../src/commands/migration-graph.ts"],"mappings":";;;;;;;;;UA0BU,qBAAA,SAA8B,oBAAoB;EAAA,SACjD,MAAA;EAAA,SACA,GAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;AAAA;AAAA,UAGM,oBAAA;EAAA,SACN,EAAA;EAAA,SACA,KAAA,EAAO,cAAA;EAAA,SACP,YAAA;EAAA,SACA,IAAA,WAAe,SAAS;EAAA,SACxB,OAAA;AAAA;AAAA,iBAGW,4BAAA,CACpB,OAAA,EAAS,qBAAA,EACT,KAAA,EAAO,WAAA,EACP,EAAA,EAAI,UAAA,GACH,OAAA,CAAQ,MAAA,CAAO,oBAAA,EAAsB,kBAAA;AAAA,iBA0CxB,2BAAA,CAAA,GAA+B,OAAO"}
+{"version":3,"file":"migration-graph.d.mts","names":[],"sources":["../../src/commands/migration-graph.ts"],"mappings":";;;;;;;;;UAmCU,qBAAA,SAA8B,oBAAoB;EAAA,SACjD,MAAA;EAAA,SACA,GAAA;EAAA,SACA,KAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;AAAA;AAAA,UAGM,yBAAA;EAAA,SACN,KAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;AAAA;AAAA,UAGM,oBAAA;EAAA,SACN,EAAA;EAP+B;EAAA,SAS/B,KAAA,EAAO,cAAA;EATwB;EAAA,SAW/B,MAAA,WAAiB,wBAAA;EAAA,SACjB,YAAA,WAAuB,yBAAA;EAAA,SACvB,OAAA;AAAA;AAAA,iBASK,+BAAA,CAAgC,MAA4B,EAApB,oBAAoB;AAAA,iBAiBtD,4BAAA,CACpB,OAAA,EAAS,qBAAA,EACT,KAAA,EAAO,WAAA,EACP,EAAA,EAAI,UAAA,GACH,OAAA,CAAQ,MAAA,CAAO,oBAAA,EAAsB,kBAAA;AAAA,iBA0HxB,2BAAA,IAA+B,OAAO"}

package/dist/commands/migration-graph.mjs

@@ -1,2 +1,185 @@
-import { n as executeMigrationGraphCommand, t as createMigrationGraphCommand } from "../migration-graph-D7DVUElV.mjs";
-export { createMigrationGraphCommand, executeMigrationGraphCommand };
+import { t as loadConfig } from "../config-loader-p9JMrekQ.mjs";
+import { A as formatStyledHeader, _ as createTerminalUI, d as setCommandSeeAlso, g as parseGlobalFlagsOrExit, l as setCommandDescriptions, s as resolveMigrationPaths, t as addGlobalOptions, u as setCommandExamples, y as handleResult } from "../command-helpers-DGMvGBeX.mjs";
+import { n as buildReadAggregate } from "../contract-space-aggregate-loader-ClI1KN6d.mjs";
+import { a as renderMigrationGraphLegend, f as indentMigrationGraphTreeBlock, l as computeGlobalMaxDirNameWidth, p as renderMigrationGraphSpaceTree, u as computeGlobalMaxEdgeTreePrefixWidth } from "../migration-graph-command-render-CEez7YUK.mjs";
+import { c as validateLegendOptions, i as migrationSpaceListEntriesFromAggregate, o as runMigrationList, r as listRefsByContractHash, s as shouldShowLegend } from "../migration-list-DlJJ_38Z.mjs";
+import { Command } from "commander";
+import { ifDefined } from "@prisma-next/utils/defined";
+import { ok } from "@prisma-next/utils/result";
+import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
+//#region src/commands/migration-graph.ts
+function computeGraphSummary(spaces) {
+	const contractCount = spaces.reduce((count, space) => count + space.contracts.length, 0);
+	const migrationCount = spaces.reduce((count, space) => count + space.migrations.length, 0);
+	return `${spaces.length} space(s), ${contractCount} contract(s), ${migrationCount} migration(s)`;
+}
+function formatMigrationGraphHumanOutput(result) {
+	const sections = [];
+	for (const section of result.treeSections) {
+		if (section.showHeading) sections.push(`${section.space}:`);
+		if (section.tree.length > 0) sections.push(section.tree);
+		else sections.push("(no migrations)");
+		sections.push("");
+	}
+	sections.push(result.summary);
+	return sections.join("\n").trimEnd();
+}
+async function executeMigrationGraphCommand(options, flags, ui) {
+	const config = await loadConfig(options.config);
+	const { configPath, migrationsRelative, migrationsDir } = resolveMigrationPaths(options.config, config);
+	if (!flags.json && !flags.quiet) {
+		const header = formatStyledHeader({
+			command: "migration graph",
+			description: "Show the migration graph topology",
+			details: [
+				{
+					label: "config",
+					value: configPath
+				},
+				{
+					label: "migrations",
+					value: migrationsRelative
+				},
+				...options.space !== void 0 ? [{
+					label: "space",
+					value: options.space
+				}] : []
+			],
+			flags
+		});
+		ui.stderr(header);
+		if (shouldShowLegend(options, flags)) {
+			ui.stderr(renderMigrationGraphLegend({
+				colorize: flags.color !== false,
+				glyphMode: ui.resolveGlyphMode(options.ascii === true)
+			}));
+			ui.stderr("");
+		}
+	}
+	const loaded = await buildReadAggregate(config, { migrationsDir });
+	if (!loaded.ok) return loaded;
+	const { aggregate, contractHash: liveContractHash } = loaded.value;
+	const appGraph = aggregate.app.graph();
+	const listResult = runMigrationList({
+		spaces: await migrationSpaceListEntriesFromAggregate(aggregate, migrationsDir),
+		...ifDefined("spaceFilter", options.space)
+	});
+	if (!listResult.ok) return listResult;
+	const scopedSpaces = listResult.value.spaces;
+	const showSpaceHeadings = scopedSpaces.length > 1;
+	const glyphMode = ui.resolveGlyphMode(options.ascii === true);
+	const colorize = flags.color !== false;
+	const globalLayoutInputs = showSpaceHeadings ? scopedSpaces.filter((spaceEntry) => spaceEntry.migrations.length > 0).map((spaceEntry) => ({
+		graph: aggregate.space(spaceEntry.space).graph(),
+		liveContractHash
+	})) : [];
+	const globalMaxEdgeTreePrefixWidth = globalLayoutInputs.length > 0 ? computeGlobalMaxEdgeTreePrefixWidth(globalLayoutInputs) : void 0;
+	const globalMaxDirNameWidth = globalLayoutInputs.length > 0 ? computeGlobalMaxDirNameWidth(globalLayoutInputs) : void 0;
+	const treeSections = [];
+	const spaces = [];
+	for (const spaceEntry of scopedSpaces) {
+		const member = aggregate.space(spaceEntry.space);
+		if (member === void 0) continue;
+		const graph = member.graph();
+		const isAppSpace = spaceEntry.space === aggregate.app.spaceId;
+		const refsByHash = listRefsByContractHash(member);
+		const tree = spaceEntry.migrations.length === 0 ? "" : renderMigrationGraphSpaceTree({
+			graph,
+			migrations: spaceEntry.migrations,
+			liveContractHash,
+			glyphMode,
+			colorize,
+			isAppSpace,
+			refsByHash,
+			...globalMaxEdgeTreePrefixWidth !== void 0 ? { globalMaxEdgeTreePrefixWidth } : {},
+			...globalMaxDirNameWidth !== void 0 ? { globalMaxDirNameWidth } : {}
+		});
+		const displayTree = showSpaceHeadings && tree.length > 0 ? indentMigrationGraphTreeBlock(tree, "  ") : tree;
+		treeSections.push({
+			space: spaceEntry.space,
+			tree: displayTree,
+			showHeading: showSpaceHeadings
+		});
+		spaces.push({
+			space: spaceEntry.space,
+			contracts: [...graph.nodes].map((hash) => ({
+				hash,
+				refs: [...refsByHash.get(hash) ?? []]
+			})),
+			migrations: [...graph.migrationByHash.values()].map((edge) => ({
+				name: edge.dirName,
+				hash: edge.migrationHash,
+				fromContract: edge.from === EMPTY_CONTRACT_HASH ? null : edge.from,
+				toContract: edge.to
+			}))
+		});
+	}
+	return ok({
+		ok: true,
+		graph: appGraph,
+		spaces,
+		treeSections,
+		summary: computeGraphSummary(spaces)
+	});
+}
+function createMigrationGraphCommand() {
+	const command = new Command("graph");
+	setCommandDescriptions(command, "Show the migration graph topology", "Renders the migration graph topology.\nOffline — does not consult the database.\n--ascii swaps box-drawing for pipe-friendly ASCII glyphs.\nUse --json for machine-readable output, or --dot for Graphviz DOT\nformat.");
+	setCommandExamples(command, [
+		"prisma-next migration graph",
+		"prisma-next migration graph --json",
+		"prisma-next migration graph --dot",
+		"prisma-next migration graph --ascii",
+		"prisma-next migration graph --legend",
+		"prisma-next migration graph --space app"
+	]);
+	setCommandSeeAlso(command, [
+		{
+			verb: "migration status",
+			oneLiner: "Show migration path and pending status"
+		},
+		{
+			verb: "migration log",
+			oneLiner: "Show executed migration history"
+		},
+		{
+			verb: "migration list",
+			oneLiner: "List on-disk migrations"
+		},
+		{
+			verb: "migration show",
+			oneLiner: "Display migration package contents"
+		}
+	]);
+	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--space <id>", "Narrow output to a single contract space").option("--dot", "Output in Graphviz DOT format").option("--ascii", "Use ASCII glyphs (pipe-friendly)").option("--legend", "Print a key for the tree glyphs and lane colors").action(async (options) => {
+		const flags = parseGlobalFlagsOrExit(options);
+		const ui = createTerminalUI(flags);
+		const legendValidation = validateLegendOptions(options, flags);
+		if (!legendValidation.ok) process.exit(handleResult(legendValidation, flags, ui));
+		const exitCode = handleResult(await executeMigrationGraphCommand(options, flags, ui), flags, ui, (graphResult) => {
+			if (options.dot) {
+				const lines = ["digraph migrations {"];
+				for (const edge of graphResult.graph.migrationByHash.values()) {
+					const from = edge.from.slice(0, 12);
+					const to = edge.to.slice(0, 12);
+					lines.push(`  "${from}" -> "${to}" [label="${edge.dirName}"];`);
+				}
+				lines.push("}");
+				ui.output(lines.join("\n"));
+			} else if (flags.json) {
+				const jsonResult = {
+					ok: true,
+					spaces: [...graphResult.spaces],
+					summary: graphResult.summary
+				};
+				ui.output(JSON.stringify(jsonResult, null, 2));
+			} else if (!flags.quiet) ui.output(formatMigrationGraphHumanOutput(graphResult));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+//#endregion
+export { createMigrationGraphCommand, executeMigrationGraphCommand, formatMigrationGraphHumanOutput };
+
+//# sourceMappingURL=migration-graph.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-graph.mjs","names":[],"sources":["../../src/commands/migration-graph.ts"],"sourcesContent":["import { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport type { MigrationGraph } from '@prisma-next/migration-tools/graph';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport type { CliStructuredError } from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n} from '../utils/command-helpers';\nimport { buildReadAggregate } from '../utils/contract-space-aggregate-loader';\nimport { renderMigrationGraphLegend } from '../utils/formatters/migration-graph-labels';\nimport {\n  computeGlobalMaxDirNameWidth,\n  computeGlobalMaxEdgeTreePrefixWidth,\n  indentMigrationGraphTreeBlock,\n  renderMigrationGraphSpaceTree,\n} from '../utils/formatters/migration-graph-space-render';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { shouldShowLegend, validateLegendOptions } from '../utils/legend';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\nimport type { MigrationGraphJsonResult, MigrationSpaceGraphEntry } from './json/schemas';\nimport {\n  listRefsByContractHash,\n  migrationSpaceListEntriesFromAggregate,\n  runMigrationList,\n} from './migration-list';\n\ninterface MigrationGraphOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly dot?: boolean;\n  readonly space?: string;\n  readonly ascii?: boolean;\n  readonly legend?: boolean;\n}\n\nexport interface MigrationGraphTreeSection {\n  readonly space: string;\n  readonly tree: string;\n  readonly showHeading: boolean;\n}\n\nexport interface MigrationGraphResult {\n  readonly ok: true;\n  /** App-space graph for the `--dot` Graphviz output. */\n  readonly graph: MigrationGraph;\n  /** Nested per-space contracts + migrations for `--json`. */\n  readonly spaces: readonly MigrationSpaceGraphEntry[];\n  readonly treeSections: readonly MigrationGraphTreeSection[];\n  readonly summary: string;\n}\n\nfunction computeGraphSummary(spaces: readonly MigrationSpaceGraphEntry[]): string {\n  const contractCount = spaces.reduce((count, space) => count + space.contracts.length, 0);\n  const migrationCount = spaces.reduce((count, space) => count + space.migrations.length, 0);\n  return `${spaces.length} space(s), ${contractCount} contract(s), ${migrationCount} migration(s)`;\n}\n\nexport function formatMigrationGraphHumanOutput(result: MigrationGraphResult): string {\n  const sections: string[] = [];\n  for (const section of result.treeSections) {\n    if (section.showHeading) {\n      sections.push(`${section.space}:`);\n    }\n    if (section.tree.length > 0) {\n      sections.push(section.tree);\n    } else {\n      sections.push('(no migrations)');\n    }\n    sections.push('');\n  }\n  sections.push(result.summary);\n  return sections.join('\\n').trimEnd();\n}\n\nexport async function executeMigrationGraphCommand(\n  options: MigrationGraphOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationGraphResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsRelative, migrationsDir } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration graph',\n      description: 'Show the migration graph topology',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'migrations', value: migrationsRelative },\n        ...(options.space !== undefined ? [{ label: 'space', value: options.space }] : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n    if (shouldShowLegend(options, flags)) {\n      ui.stderr(\n        renderMigrationGraphLegend({\n          colorize: flags.color !== false,\n          glyphMode: ui.resolveGlyphMode(options.ascii === true),\n        }),\n      );\n      ui.stderr('');\n    }\n  }\n\n  const loaded = await buildReadAggregate(config, { migrationsDir });\n  if (!loaded.ok) {\n    return loaded;\n  }\n\n  const { aggregate, contractHash: liveContractHash } = loaded.value;\n  const appGraph = aggregate.app.graph();\n\n  const listSpaces = await migrationSpaceListEntriesFromAggregate(aggregate, migrationsDir);\n  const listResult = runMigrationList({\n    spaces: listSpaces,\n    ...ifDefined('spaceFilter', options.space),\n  });\n  if (!listResult.ok) {\n    return listResult;\n  }\n\n  const scopedSpaces = listResult.value.spaces;\n  const showSpaceHeadings = scopedSpaces.length > 1;\n  const glyphMode = ui.resolveGlyphMode(options.ascii === true);\n  const colorize = flags.color !== false;\n\n  const globalLayoutInputs = showSpaceHeadings\n    ? scopedSpaces\n        .filter((spaceEntry) => spaceEntry.migrations.length > 0)\n        .map((spaceEntry) => ({\n          graph: aggregate.space(spaceEntry.space)!.graph(),\n          liveContractHash,\n        }))\n    : [];\n  const globalMaxEdgeTreePrefixWidth =\n    globalLayoutInputs.length > 0\n      ? computeGlobalMaxEdgeTreePrefixWidth(globalLayoutInputs)\n      : undefined;\n  const globalMaxDirNameWidth =\n    globalLayoutInputs.length > 0 ? computeGlobalMaxDirNameWidth(globalLayoutInputs) : undefined;\n\n  const treeSections: MigrationGraphTreeSection[] = [];\n  const spaces: MigrationSpaceGraphEntry[] = [];\n  for (const spaceEntry of scopedSpaces) {\n    const member = aggregate.space(spaceEntry.space);\n    if (member === undefined) {\n      continue;\n    }\n    const graph = member.graph();\n    const isAppSpace = spaceEntry.space === aggregate.app.spaceId;\n    const refsByHash = listRefsByContractHash(member);\n    const tree =\n      spaceEntry.migrations.length === 0\n        ? ''\n        : renderMigrationGraphSpaceTree({\n            graph,\n            migrations: spaceEntry.migrations,\n            liveContractHash,\n            glyphMode,\n            colorize,\n            isAppSpace,\n            refsByHash,\n            ...(globalMaxEdgeTreePrefixWidth !== undefined ? { globalMaxEdgeTreePrefixWidth } : {}),\n            ...(globalMaxDirNameWidth !== undefined ? { globalMaxDirNameWidth } : {}),\n          });\n    const displayTree =\n      showSpaceHeadings && tree.length > 0 ? indentMigrationGraphTreeBlock(tree, '  ') : tree;\n    treeSections.push({\n      space: spaceEntry.space,\n      tree: displayTree,\n      showHeading: showSpaceHeadings,\n    });\n    spaces.push({\n      space: spaceEntry.space,\n      contracts: [...graph.nodes].map((hash) => ({\n        hash,\n        refs: [...(refsByHash.get(hash) ?? [])],\n      })),\n      migrations: [...graph.migrationByHash.values()].map((edge) => ({\n        name: edge.dirName,\n        hash: edge.migrationHash,\n        fromContract: edge.from === EMPTY_CONTRACT_HASH ? null : edge.from,\n        toContract: edge.to,\n      })),\n    });\n  }\n\n  return ok({\n    ok: true,\n    graph: appGraph,\n    spaces,\n    treeSections,\n    summary: computeGraphSummary(spaces),\n  });\n}\n\nexport function createMigrationGraphCommand(): Command {\n  const command = new Command('graph');\n  setCommandDescriptions(\n    command,\n    'Show the migration graph topology',\n    'Renders the migration graph topology.\\n' +\n      'Offline — does not consult the database.\\n' +\n      '--ascii swaps box-drawing for pipe-friendly ASCII glyphs.\\n' +\n      'Use --json for machine-readable output, or --dot for Graphviz DOT\\n' +\n      'format.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration graph',\n    'prisma-next migration graph --json',\n    'prisma-next migration graph --dot',\n    'prisma-next migration graph --ascii',\n    'prisma-next migration graph --legend',\n    'prisma-next migration graph --space app',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration log', oneLiner: 'Show executed migration history' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\n    { verb: 'migration show', oneLiner: 'Display migration package contents' },\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--space <id>', 'Narrow output to a single contract space')\n    .option('--dot', 'Output in Graphviz DOT format')\n    .option('--ascii', 'Use ASCII glyphs (pipe-friendly)')\n    .option('--legend', 'Print a key for the tree glyphs and lane colors')\n    .action(async (options: MigrationGraphOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const legendValidation = validateLegendOptions(options, flags);\n      if (!legendValidation.ok) {\n        process.exit(handleResult(legendValidation, flags, ui));\n      }\n      const result = await executeMigrationGraphCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (graphResult) => {\n        if (options.dot) {\n          const lines = ['digraph migrations {'];\n          for (const edge of graphResult.graph.migrationByHash.values()) {\n            const from = edge.from.slice(0, 12);\n            const to = edge.to.slice(0, 12);\n            lines.push(`  \"${from}\" -> \"${to}\" [label=\"${edge.dirName}\"];`);\n          }\n          lines.push('}');\n          ui.output(lines.join('\\n'));\n        } else if (flags.json) {\n          const jsonResult: MigrationGraphJsonResult = {\n            ok: true,\n            spaces: [...graphResult.spaces],\n            summary: graphResult.summary,\n          };\n          ui.output(JSON.stringify(jsonResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.output(formatMigrationGraphHumanOutput(graphResult));\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1,32 +1,22 @@
-import { N as CliStructuredError } from "../types-Dt_SfqFm.mjs";
-import { n as GlobalFlags, t as CommonCommandOptions } from "../global-flags-DEHjV8_s.mjs";
-import { n as GlyphMode, t as TerminalUI } from "../terminal-ui-5Y6mrg93.mjs";
+import { N as CliStructuredError } from "../types-C_tYiJYx.mjs";
+import { r as MigrationListResult, s as MigrationSpaceListEntry } from "../schemas-CeGMYFYX.mjs";
+import { n as GlobalFlags, t as CommonCommandOptions } from "../global-flags-BpoOYtNZ.mjs";
+import { n as GlyphMode, t as TerminalUI } from "../terminal-ui-DGRNFWna.mjs";
 import { Command } from "commander";
 import { Result } from "@prisma-next/utils/result";
-import { ContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
+import { ContractSpaceAggregate, ContractSpaceMember } from "@prisma-next/migration-tools/aggregate";
+import { MigrationGraph } from "@prisma-next/migration-tools/graph";
 
-//#region src/utils/formatters/migration-list-types.d.ts
-interface MigrationListEntry {
-  readonly dirName: string;
-  readonly from: string | null;
-  readonly to: string;
-  readonly migrationHash: string;
-  readonly operationCount: number;
-  readonly createdAt: string;
-  readonly refs: readonly string[];
-  readonly providedInvariants: readonly string[];
-}
-interface MigrationSpaceListEntry {
-  readonly spaceId: string;
-  readonly migrations: readonly MigrationListEntry[];
-}
-interface MigrationListResult {
-  readonly ok: true;
-  readonly spaces: readonly MigrationSpaceListEntry[];
-  readonly summary: string;
-}
-//#endregion
 //#region src/commands/migration-list.d.ts
+/**
+ * Ref names decorating a space's destination contract hashes. The
+ * tolerant `member.refs` deliberately omits the structural `head.json`;
+ * for extension spaces the old enumerator surfaced it as a `head`
+ * decoration on the tip migration, so fold `member.headRef` back in to
+ * keep that output. The app space synthesises its head, so it carries
+ * no on-disk `head` ref to restore.
+ */
+declare function listRefsByContractHash(member: ContractSpaceMember): ReadonlyMap<string, readonly string[]>;
 /**
  * Project the loaded {@link ContractSpaceAggregate} into the render-ready
  * {@link MigrationSpaceListEntry} rows `migration list` displays.
@@ -40,10 +30,19 @@ interface MigrationListOptions extends CommonCommandOptions {
   readonly config?: string;
   readonly space?: string;
   readonly ascii?: boolean;
+  readonly legend?: boolean;
+}
+interface MigrationListExecuteResult {
+  readonly list: MigrationListResult;
+  readonly liveContractHash: string;
+  readonly aggregate: ContractSpaceAggregate;
 }
 interface MigrationListHumanRenderOptions {
   readonly glyphMode: GlyphMode;
   readonly useColor: boolean;
+  readonly liveContractHash: string;
+  readonly graphForSpace: (spaceId: string) => MigrationGraph | undefined;
+  readonly appSpaceId?: string;
 }
 declare function renderMigrationListHumanOutput(result: MigrationListResult, options: MigrationListHumanRenderOptions): string;
 /**
@@ -73,8 +72,8 @@ declare function runMigrationList(inputs: RunMigrationListInputs): Result<Migrat
  * stderr (interactive mode only), and delegates to {@link runMigrationList}.
  * Kept intentionally thin so the unit-testable surface lives in the core.
  */
-declare function executeMigrationListCommand(options: MigrationListOptions, flags: GlobalFlags, ui: TerminalUI): Promise<Result<MigrationListResult, CliStructuredError>>;
+declare function executeMigrationListCommand(options: MigrationListOptions, flags: GlobalFlags, ui: TerminalUI): Promise<Result<MigrationListExecuteResult, CliStructuredError>>;
 declare function createMigrationListCommand(): Command;
 //#endregion
-export { MigrationListHumanRenderOptions, RunMigrationListInputs, createMigrationListCommand, executeMigrationListCommand, migrationSpaceListEntriesFromAggregate, renderMigrationListHumanOutput, runMigrationList };
+export { MigrationListExecuteResult, MigrationListHumanRenderOptions, RunMigrationListInputs, createMigrationListCommand, executeMigrationListCommand, listRefsByContractHash, migrationSpaceListEntriesFromAggregate, renderMigrationListHumanOutput, runMigrationList };
 //# sourceMappingURL=migration-list.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-list.d.mts","names":[],"sources":["../../src/utils/formatters/migration-list-types.ts","../../src/commands/migration-list.ts"],"mappings":";;;;;;;;UAAiB,kBAAA;EAAA,SACN,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,cAAA;EAAA,SACA,SAAA;EAAA,SACA,IAAA;EAAA,SACA,kBAAA;AAAA;AAAA,UAGM,uBAAA;EAAA,SACN,OAAA;EAAA,SACA,UAAA,WAAqB,kBAAkB;AAAA;AAAA,UAGjC,mBAAA;EAAA,SACN,EAAA;EAAA,SACA,MAAA,WAAiB,uBAAuB;EAAA,SACxC,OAAA;AAAA;;;;;;;;;;;iBC8EW,sCAAA,CACpB,SAAA,EAAW,sBAAA,EACX,oBAAA,WACC,OAAA,UAAiB,uBAAA;AAAA,UA6BV,oBAAA,SAA6B,oBAAoB;EAAA,SAChD,MAAA;EAAA,SACA,KAAA;EAAA,SACA,KAAA;AAAA;AAAA,UAGM,+BAAA;EAAA,SACN,SAAA,EAAW,SAAS;EAAA,SACpB,QAAA;AAAA;AAAA,iBAGK,8BAAA,CACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,+BAA+B;;;ADjIQ;AAGlD;;;;;UC6IiB,sBAAA;EAAA,SACN,MAAA,WAAiB,uBAAuB;EAAA,SACxC,WAAA;AAAA;AD5IO;;;;AC8ElB;;;;;AD9EkB,iBCgKF,gBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,MAAA,CAAO,mBAAA,EAAqB,kBAAA;;;;;;iBA6BT,2BAAA,CACpB,OAAA,EAAS,oBAAA,EACT,KAAA,EAAO,WAAA,EACP,EAAA,EAAI,UAAA,GACH,OAAA,CAAQ,MAAA,CAAO,mBAAA,EAAqB,kBAAA;AAAA,iBAqCvB,0BAAA,CAAA,GAA8B,OAAO"}
+{"version":3,"file":"migration-list.d.mts","names":[],"sources":["../../src/commands/migration-list.ts"],"mappings":";;;;;;;;;;AAmEA;;;;;;;;AAAA,iBAAgB,sBAAA,CACd,MAAA,EAAQ,mBAAA,GACP,WAAW;AA4Bd;;;;;;;;AAAA,iBAAsB,sCAAA,CACpB,SAAA,EAAW,sBAAA,EACX,oBAAA,WACC,OAAA,UAAiB,uBAAA;AAAA,UA6BV,oBAAA,SAA6B,oBAAoB;EAAA,SAChD,MAAA;EAAA,SACA,KAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;AAAA;AAAA,UAGM,0BAAA;EAAA,SACN,IAAA,EAAM,mBAAA;EAAA,SACN,gBAAA;EAAA,SACA,SAAA,EAAW,sBAAsB;AAAA;AAAA,UAG3B,+BAAA;EAAA,SACN,SAAA,EAAW,SAAA;EAAA,SACX,QAAA;EAAA,SACA,gBAAA;EAAA,SACA,aAAA,GAAgB,OAAA,aAAoB,cAAc;EAAA,SAClD,UAAA;AAAA;AAAA,iBAGK,8BAAA,CACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,+BAA+B;;;;;;;;;UAmBzB,sBAAA;EAAA,SACN,MAAA,WAAiB,uBAAuB;EAAA,SACxC,WAAA;AAAA;;;;;;;;;;iBAoBK,gBAAA,CACd,MAAA,EAAQ,sBAAA,GACP,MAAA,CAAO,mBAAA,EAAqB,kBAAA;AAhDV;AAGrB;;;;AAHqB,iBA6EC,2BAAA,CACpB,OAAA,EAAS,oBAAA,EACT,KAAA,EAAO,WAAA,EACP,EAAA,EAAI,UAAA,GACH,OAAA,CAAQ,MAAA,CAAO,0BAAA,EAA4B,kBAAA;AAAA,iBAiD9B,0BAAA,IAA8B,OAAO"}