@prisma-next/cli 0.3.0-dev.113 → 0.3.0-dev.115

package/README.md

@@ -925,7 +925,7 @@ prisma-next migration plan [--config <path>] [--name <slug>] [--from <hash>] [--
 **Options:**
 - `--config <path>`: Path to `prisma-next.config.ts`
 - `--name <slug>`: Name slug for the migration directory (default: `migration`)
-- `--from <hash>`: Explicit starting contract hash (overrides latest chain leaf detection)
+- `--from <hash>`: Explicit starting contract hash (overrides latest migration target detection)
 - `--json`: Output as JSON object
 - `-q, --quiet`: Quiet mode (errors only)
 - `-v, --verbose`: Verbose output (debug info, timings)
@@ -933,11 +933,11 @@ prisma-next migration plan [--config <path>] [--name <slug>] [--from <hash>] [--
 **What it does:**
 1. Loads config and reads `contract.json` (the "to" contract)
 2. Reads existing migrations from `config.migrations.dir` (default: `migrations/`)
-3. Determines the starting point: `--from <hash>` if provided, otherwise the graph leaf (latest migration)
+3. Determines the starting point: `--from <hash>` if provided, otherwise the latest migration target
 4. Diffs the starting contract against the new contract using the target's migration planner
 5. Writes a new migration package (`migration.json` + `ops.json`) and attests the `migrationId`
 
-**Branching with `--from`:** Use `--from` to create a migration edge from a specific contract hash instead of the graph leaf. This enables branched migration graphs where multiple environments diverge from a common ancestor.
+**Branching with `--from`:** Use `--from` to create a migration edge from a specific contract hash instead of the latest migration target. This enables branched migration graphs where multiple environments diverge from a common ancestor.
 
 ### `prisma-next migration show`
 
@@ -957,7 +957,7 @@ prisma-next migration show [target] [--config <path>] [--json] [-v] [-q] [--colo
 **What it does:**
 1. If `target` is a path (contains `/` or `\`), reads that directory directly
 2. If `target` is a hash prefix, scans all attested migrations and matches against `migrationId`
-3. If no target, defaults to the latest migration (chain leaf)
+3. If no target, defaults to the latest migration
 4. Displays operations with operation class badges, destructive warnings, and DDL preview
 
 **Destructive warnings:** When a migration contains destructive operations (e.g., `DROP TABLE`, `ALTER COLUMN TYPE`), the output includes a prominent `⚠` warning about potential data loss.
@@ -991,7 +991,7 @@ prisma-next migration status [--db <url>] [--ref <name>] [--config <path>] [--js
 6. Shows operation summaries with destructive operation highlighting
 7. In `--ref` mode, the `CONTRACT.AHEAD` warning is suppressed — contract being ahead of a ref target is expected in multi-environment workflows
 
-**Branched graphs:** When the migration graph has multiple leaves (divergence), status reports an `AMBIGUOUS_LEAF` error with the divergence point and branch details. Use `--ref` to target a specific branch.
+**Branched graphs:** When the migration graph has multiple branches (divergence), status reports an `AMBIGUOUS_TARGET` error with the divergence point and branch details. Use `--ref` to target a specific branch.
 
 ### `prisma-next migration apply`
 
@@ -1240,7 +1240,7 @@ export default defineConfig({
 - **`commander`**: CLI argument parsing and command routing
 - **`esbuild`**: Bundling TypeScript contract files with import allowlisting
 - **`@prisma-next/emitter`**: Contract emission engine (returns strings)
-- **`@prisma-next/migration-tools`**: On-disk migration I/O, attestation, and chain reconstruction
+- **`@prisma-next/migration-tools`**: On-disk migration I/O, attestation, and history reconstruction
 - **`@prisma-next/core-control-plane`**: Config types, migration operation types, error types, control plane stack
 
 ## Design Decisions

package/dist/cli.mjs

@@ -13,7 +13,7 @@ import { createMigrationApplyCommand } from "./commands/migration-apply.mjs";
 import { createMigrationPlanCommand } from "./commands/migration-plan.mjs";
 import { createMigrationRefCommand } from "./commands/migration-ref.mjs";
 import { createMigrationShowCommand } from "./commands/migration-show.mjs";
-import { t as createMigrationStatusCommand } from "./migration-status-DAQKsmWW.mjs";
+import { t as createMigrationStatusCommand } from "./migration-status-B7OVZ-Ka.mjs";
 import { createMigrationVerifyCommand } from "./commands/migration-verify.mjs";
 import { Command } from "commander";
 import { distance } from "closest-match";

package/dist/commands/migration-apply.mjs

@@ -217,7 +217,7 @@ async function executeMigrationApplyCommand(options, flags, ui, startTime) {
 }
 function createMigrationApplyCommand() {
 	const command = new Command("apply");
-	setCommandDescriptions(command, "Apply planned migrations to the database", "Applies previously planned migrations (created by `migration plan`) to a live database.\nCompares the database marker against the migration chain to determine which\nmigrations are pending, then executes them sequentially. Each migration runs\nin its own transaction. Does not plan new migrations — run `migration plan` first.");
+	setCommandDescriptions(command, "Apply planned migrations to the database", "Applies previously planned migrations (created by `migration plan`) to a live database.\nCompares the database marker against the migration history to determine which\nmigrations are pending, then executes them sequentially. Each migration runs\nin its own transaction. Does not plan new migrations — run `migration plan` first.");
 	setCommandExamples(command, ["prisma-next migration apply --db $DATABASE_URL"]);
 	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--ref <name>", "Target ref name from migrations/refs.json").action(async (options) => {
 		const flags = parseGlobalFlags(options);

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

@@ -1 +1 @@
-{"version":3,"file":"migration-apply.mjs","names":["destinationHash: string","refName: string | undefined","details: Array<{ label: string; value: string }>","bundles: readonly AttestedMigrationBundle[]","graph: MigrationGraph","pendingMigrations: MigrationApplyStep[]"],"sources":["../../src/commands/migration-apply.ts"],"sourcesContent":["import { EMPTY_CONTRACT_HASH } from '@prisma-next/core-control-plane/constants';\nimport { findPathWithDecision } from '@prisma-next/migration-tools/dag';\nimport { readRefs, resolveRef } from '@prisma-next/migration-tools/refs';\nimport type { AttestedMigrationBundle, MigrationGraph } from '@prisma-next/migration-tools/types';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type { MigrationApplyFailure, MigrationApplyStep } from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationBundles,\n  maskConnectionUrl,\n  readContractEnvelope,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n  toPathDecisionResult,\n} from '../utils/command-helpers';\nimport { formatMigrationApplyCommandOutput } 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 MigrationApplyCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly ref?: string;\n}\n\nexport interface MigrationApplyResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly dirName: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly pathDecision?: {\n    readonly fromHash: string;\n    readonly toHash: string;\n    readonly alternativeCount: number;\n    readonly tieBreakReasons: readonly string[];\n    readonly refName?: string;\n    readonly selectedPath: readonly {\n      readonly dirName: string;\n      readonly migrationId: string | null;\n      readonly from: string;\n      readonly to: string;\n    }[];\n  };\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nfunction mapMigrationToolsError(error: unknown): CliStructuredErrorType {\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 apply: ${error instanceof Error ? error.message : String(error)}`,\n  });\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migration apply` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nfunction packageToStep(pkg: AttestedMigrationBundle): MigrationApplyStep {\n  return {\n    dirName: pkg.dirName,\n    from: pkg.manifest.from,\n    to: pkg.manifest.to,\n    toContract: pkg.manifest.toContract,\n    operations: pkg.ops,\n  };\n}\n\nasync function executeMigrationApplyCommand(\n  options: MigrationApplyCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationApplyResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative, refsPath } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migration apply (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migration apply',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migration apply',\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  let destinationHash: string;\n  let refName: string | undefined;\n\n  if (options.ref) {\n    refName = options.ref;\n    try {\n      const refs = await readRefs(refsPath);\n      destinationHash = resolveRef(refs, refName);\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      throw error;\n    }\n  } else {\n    try {\n      const envelope = await readContractEnvelope(config);\n      destinationHash = envelope.storageHash;\n    } catch (error) {\n      return notOk(\n        errorRuntime('Current contract is unavailable', {\n          why: `Failed to read contract: ${error instanceof Error ? error.message : String(error)}`,\n          fix: 'Run `prisma-next contract emit` to generate a valid contract.json, then retry apply.',\n        }),\n      );\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 (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (refName) {\n      details.push({ label: 'ref', value: refName });\n    }\n    const header = formatStyledHeader({\n      command: 'migration apply',\n      description: 'Apply planned migrations to the database',\n      url: 'https://pris.ly/migration-apply',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Read migrations and build migration chain model (offline — no DB needed)\n  let bundles: readonly AttestedMigrationBundle[];\n  let graph: MigrationGraph;\n  try {\n    ({ bundles, graph } = await loadMigrationBundles(migrationsDir));\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const marker = await client.readMarker();\n\n    // --- No attested migrations on disk ---\n    if (bundles.length === 0) {\n      if (marker?.storageHash) {\n        return notOk(\n          errorRuntime('Database has state but no migrations exist', {\n            why: `The database marker hash \"${marker.storageHash}\" exists but no attested migrations were found in ${migrationsRelative}`,\n            fix: 'Ensure the migrations directory is correct. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n            meta: { markerHash: marker.storageHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Non-empty contract + no migrations = user needs to plan first.\n      if (destinationHash !== EMPTY_CONTRACT_HASH) {\n        return notOk(\n          errorRuntime('Current contract has no planned migrations', {\n            why: `No attested migrations were found in ${migrationsRelative}, but current contract hash is \"${destinationHash}\"`,\n            fix: 'Run `prisma-next migration plan` to create an attested migration for the current contract.',\n            meta: { destinationHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Empty contract + no migrations = nothing to do.\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: EMPTY_CONTRACT_HASH,\n        applied: [],\n        summary: 'No attested migrations found',\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    // --- Validate marker state ---\n\n    // The empty sentinel should never appear in a real marker row — if it does,\n    // the marker was corrupted and replaying all migrations would be dangerous.\n    if (marker?.storageHash === EMPTY_CONTRACT_HASH) {\n      return notOk(\n        errorRuntime('Database marker contains the empty sentinel hash', {\n          why: `The marker row exists but contains the empty sentinel value \"${EMPTY_CONTRACT_HASH}\". This should never happen — the marker should contain the hash of the last applied contract.`,\n          fix: 'The marker is corrupted. Run `prisma-next db sign` to overwrite it with the correct contract hash, or drop and recreate the database.',\n          meta: { markerHash: EMPTY_CONTRACT_HASH },\n        }),\n      );\n    }\n\n    const markerHash = marker?.storageHash;\n\n    if (markerHash !== undefined && !graph.nodes.has(markerHash)) {\n      return notOk(\n        errorRuntime('Database marker does not match any known migration', {\n          why: `The database marker hash \"${markerHash}\" is not found in the migration history at ${migrationsRelative}`,\n          fix: 'Ensure the migrations directory matches this database. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n          meta: { markerHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    if (!graph.nodes.has(destinationHash)) {\n      return notOk(\n        errorRuntime('Current contract has no planned migration path', {\n          why: `Current contract hash \"${destinationHash}\" is not present in the migration history at ${migrationsRelative}`,\n          fix: 'Run `prisma-next migration plan` to create a migration for the current contract, then re-run apply.',\n          meta: { destinationHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    // --- Resolve path and apply ---\n\n    // \"No marker\" means the database is fresh — start from the empty contract hash.\n    const originHash = markerHash ?? EMPTY_CONTRACT_HASH;\n\n    const decision = findPathWithDecision(graph, originHash, destinationHash, refName);\n    if (!decision) {\n      return notOk(\n        errorRuntime('No migration path from current state to target', {\n          why: `Cannot find a path from \"${originHash}\" to target \"${destinationHash}\"`,\n          fix: 'Check the migration history for gaps or inconsistencies.',\n          meta: { markerHash: originHash, destinationHash },\n        }),\n      );\n    }\n\n    const pendingPath = decision.selectedPath;\n    const pathDecision = toPathDecisionResult(decision);\n\n    if (pendingPath.length === 0) {\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: originHash,\n        applied: [],\n        summary: 'Already up to date',\n        pathDecision,\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    const bundleByDir = new Map(bundles.map((b) => [b.dirName, b]));\n    const pendingMigrations: MigrationApplyStep[] = [];\n    for (const migration of pendingPath) {\n      const pkg = bundleByDir.get(migration.dirName);\n      if (!pkg) {\n        return notOk(\n          errorRuntime(`Migration package not found: ${migration.dirName}`, {\n            why: `The migration directory for path segment ${migration.from} → ${migration.to} was not found`,\n            fix: 'Ensure all migration directories are present and intact.',\n          }),\n        );\n      }\n      pendingMigrations.push(packageToStep(pkg));\n    }\n\n    if (!flags.quiet && !flags.json) {\n      for (const migration of pendingMigrations) {\n        ui.step(`Pending ${migration.dirName}`);\n      }\n    }\n\n    const applyResult = await client.migrationApply({\n      originHash,\n      destinationHash,\n      pendingMigrations,\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: pendingPath.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      pathDecision,\n      timings: { total: Date.now() - startTime },\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationApplyCommand(): Command {\n  const command = new Command('apply');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to the database',\n    'Applies previously planned migrations (created by `migration plan`) to a live database.\\n' +\n      'Compares the database marker against the migration chain to determine which\\n' +\n      'migrations are pending, then executes them sequentially. Each migration runs\\n' +\n      'in its own transaction. Does not plan new migrations — run `migration plan` first.',\n  );\n  setCommandExamples(command, ['prisma-next migration apply --db $DATABASE_URL']);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--ref <name>', 'Target ref name from migrations/refs.json')\n    .action(async (options: MigrationApplyCommandOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({\n        color: flags.color,\n        interactive: flags.interactive,\n      });\n\n      const result = await executeMigrationApplyCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (applyResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(applyResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(applyResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":";;;;;;;;;;;;;AA0EA,SAAS,uBAAuB,OAAwC;AACtE,KAAI,oBAAoB,GAAG,MAAM,CAC/B,QAAO,aAAa,MAAM,SAAS;EACjC,KAAK,MAAM;EACX,KAAK,MAAM;EACX,MAAM;GAAE,MAAM,MAAM;GAAM,GAAI,MAAM,WAAW,EAAE;GAAG;EACrD,CAAC;AAEJ,QAAO,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EAC7E,KAAK,4CAA4C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACxG,CAAC;;AAGJ,SAAS,gBAAgB,SAAwD;AAC/E,QAAO,aAAa,QAAQ,SAAS;EACnC,KAAK,QAAQ,OAAO;EACpB,KAAK;EACL,MAAM,QAAQ,QAAQ,EAAE;EACzB,CAAC;;AAGJ,SAAS,cAAc,KAAkD;AACvE,QAAO;EACL,SAAS,IAAI;EACb,MAAM,IAAI,SAAS;EACnB,IAAI,IAAI,SAAS;EACjB,YAAY,IAAI,SAAS;EACzB,YAAY,IAAI;EACjB;;AAGH,eAAe,6BACb,SACA,OACA,IACA,WAC+D;CAC/D,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;CAC/C,MAAM,EAAE,YAAY,eAAe,oBAAoB,aAAa,sBAClE,QAAQ,QACR,OACD;CAED,MAAM,eAAe,QAAQ,MAAM,OAAO,IAAI;AAC9C,KAAI,CAAC,aACH,QAAO,MACL,gCAAgC;EAC9B,KAAK,6EAA6E,WAAW;EAC7F,aAAa;EACd,CAAC,CACH;AAGH,KAAI,CAAC,OAAO,OACV,QAAO,MACL,oBAAoB,EAClB,KAAK,iDACN,CAAC,CACH;AAGH,KAAI,CAAC,yBAAyB,OAAO,OAAO,CAC1C,QAAO,MACL,iCAAiC,EAC/B,KAAK,WAAW,OAAO,OAAO,GAAG,gCAClC,CAAC,CACH;CAGH,IAAIA;CACJ,IAAIC;AAEJ,KAAI,QAAQ,KAAK;AACf,YAAU,QAAQ;AAClB,MAAI;AAEF,qBAAkB,WADL,MAAM,SAAS,SAAS,EACF,QAAQ;WACpC,OAAO;AACd,OAAI,oBAAoB,GAAG,MAAM,CAC/B,QAAO,MAAM,uBAAuB,MAAM,CAAC;AAE7C,SAAM;;OAGR,KAAI;AAEF,qBADiB,MAAM,qBAAqB,OAAO,EACxB;UACpB,OAAO;AACd,SAAO,MACL,aAAa,mCAAmC;GAC9C,KAAK,4BAA4B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GACvF,KAAK;GACN,CAAC,CACH;;AAIL,KAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;EAC/B,MAAMC,UAAmD,CACvD;GAAE,OAAO;GAAU,OAAO;GAAY,EACtC;GAAE,OAAO;GAAc,OAAO;GAAoB,CACnD;AACD,MAAI,OAAO,iBAAiB,SAC1B,SAAQ,KAAK;GACX,OAAO;GACP,OAAO,kBAAkB,aAAa;GACvC,CAAC;AAEJ,MAAI,QACF,SAAQ,KAAK;GAAE,OAAO;GAAO,OAAO;GAAS,CAAC;EAEhD,MAAM,SAAS,mBAAmB;GAChC,SAAS;GACT,aAAa;GACb,KAAK;GACL;GACA;GACD,CAAC;AACF,KAAG,OAAO,OAAO;;CAInB,IAAIC;CACJ,IAAIC;AACJ,KAAI;AACF,GAAC,CAAE,SAAS,SAAU,MAAM,qBAAqB,cAAc;UACxD,OAAO;AACd,MAAI,oBAAoB,GAAG,MAAM,CAC/B,QAAO,MAAM,uBAAuB,MAAM,CAAC;AAE7C,QAAM;;CAGR,MAAM,SAAS,oBAAoB;EACjC,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,QAAQ,OAAO;EACf,gBAAgB,OAAO,kBAAkB,EAAE;EAC5C,CAAC;AAEF,KAAI;AACF,QAAM,OAAO,QAAQ,aAAa;EAClC,MAAM,SAAS,MAAM,OAAO,YAAY;AAGxC,MAAI,QAAQ,WAAW,GAAG;AACxB,OAAI,QAAQ,YACV,QAAO,MACL,aAAa,8CAA8C;IACzD,KAAK,6BAA6B,OAAO,YAAY,oDAAoD;IACzG,KAAK;IACL,MAAM;KAAE,YAAY,OAAO;KAAa,eAAe;KAAoB;IAC5E,CAAC,CACH;AAGH,OAAI,oBAAoB,oBACtB,QAAO,MACL,aAAa,8CAA8C;IACzD,KAAK,wCAAwC,mBAAmB,kCAAkC,gBAAgB;IAClH,KAAK;IACL,MAAM;KAAE;KAAiB,eAAe;KAAoB;IAC7D,CAAC,CACH;AAGH,UAAO,GAAG;IACR,IAAI;IACJ,mBAAmB;IACnB,iBAAiB;IACjB,YAAY;IACZ,SAAS,EAAE;IACX,SAAS;IACT,SAAS,EAAE,OAAO,KAAK,KAAK,GAAG,WAAW;IAC3C,CAAC;;AAOJ,MAAI,QAAQ,gBAAgB,oBAC1B,QAAO,MACL,aAAa,oDAAoD;GAC/D,KAAK,gEAAgE,oBAAoB;GACzF,KAAK;GACL,MAAM,EAAE,YAAY,qBAAqB;GAC1C,CAAC,CACH;EAGH,MAAM,aAAa,QAAQ;AAE3B,MAAI,eAAe,UAAa,CAAC,MAAM,MAAM,IAAI,WAAW,CAC1D,QAAO,MACL,aAAa,sDAAsD;GACjE,KAAK,6BAA6B,WAAW,6CAA6C;GAC1F,KAAK;GACL,MAAM;IAAE;IAAY,YAAY,CAAC,GAAG,MAAM,MAAM;IAAE;GACnD,CAAC,CACH;AAGH,MAAI,CAAC,MAAM,MAAM,IAAI,gBAAgB,CACnC,QAAO,MACL,aAAa,kDAAkD;GAC7D,KAAK,0BAA0B,gBAAgB,+CAA+C;GAC9F,KAAK;GACL,MAAM;IAAE;IAAiB,YAAY,CAAC,GAAG,MAAM,MAAM;IAAE;GACxD,CAAC,CACH;EAMH,MAAM,aAAa,cAAc;EAEjC,MAAM,WAAW,qBAAqB,OAAO,YAAY,iBAAiB,QAAQ;AAClF,MAAI,CAAC,SACH,QAAO,MACL,aAAa,kDAAkD;GAC7D,KAAK,4BAA4B,WAAW,eAAe,gBAAgB;GAC3E,KAAK;GACL,MAAM;IAAE,YAAY;IAAY;IAAiB;GAClD,CAAC,CACH;EAGH,MAAM,cAAc,SAAS;EAC7B,MAAM,eAAe,qBAAqB,SAAS;AAEnD,MAAI,YAAY,WAAW,EACzB,QAAO,GAAG;GACR,IAAI;GACJ,mBAAmB;GACnB,iBAAiB;GACjB,YAAY;GACZ,SAAS,EAAE;GACX,SAAS;GACT;GACA,SAAS,EAAE,OAAO,KAAK,KAAK,GAAG,WAAW;GAC3C,CAAC;EAGJ,MAAM,cAAc,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;EAC/D,MAAMC,oBAA0C,EAAE;AAClD,OAAK,MAAM,aAAa,aAAa;GACnC,MAAM,MAAM,YAAY,IAAI,UAAU,QAAQ;AAC9C,OAAI,CAAC,IACH,QAAO,MACL,aAAa,gCAAgC,UAAU,WAAW;IAChE,KAAK,4CAA4C,UAAU,KAAK,KAAK,UAAU,GAAG;IAClF,KAAK;IACN,CAAC,CACH;AAEH,qBAAkB,KAAK,cAAc,IAAI,CAAC;;AAG5C,MAAI,CAAC,MAAM,SAAS,CAAC,MAAM,KACzB,MAAK,MAAM,aAAa,kBACtB,IAAG,KAAK,WAAW,UAAU,UAAU;EAI3C,MAAM,cAAc,MAAM,OAAO,eAAe;GAC9C;GACA;GACA;GACD,CAAC;AAEF,MAAI,CAAC,YAAY,GACf,QAAO,MAAM,gBAAgB,YAAY,QAAQ,CAAC;EAGpD,MAAM,EAAE,UAAU;AAElB,SAAO,GAAG;GACR,IAAI;GACJ,mBAAmB,MAAM;GACzB,iBAAiB,YAAY;GAC7B,YAAY,MAAM;GAClB,SAAS,MAAM;GACf,SAAS,MAAM;GACf;GACA,SAAS,EAAE,OAAO,KAAK,KAAK,GAAG,WAAW;GAC3C,CAAC;UACK,OAAO;AACd,MAAI,mBAAmB,GAAG,MAAM,CAC9B,QAAO,MAAM,MAAM;AAErB,SAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EACtE,KAAK,4CAA4C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACxG,CAAC,CACH;WACO;AACR,QAAM,OAAO,OAAO;;;AAIxB,SAAgB,8BAAuC;CACrD,MAAM,UAAU,IAAI,QAAQ,QAAQ;AACpC,wBACE,SACA,4CACA,yUAID;AACD,oBAAmB,SAAS,CAAC,iDAAiD,CAAC;AAC/E,kBAAiB,QAAQ,CACtB,OAAO,cAAc,6BAA6B,CAClD,OAAO,mBAAmB,gCAAgC,CAC1D,OAAO,gBAAgB,4CAA4C,CACnE,OAAO,OAAO,YAA0C;EACvD,MAAM,QAAQ,iBAAiB,QAAQ;EACvC,MAAM,YAAY,KAAK,KAAK;EAE5B,MAAM,KAAK,IAAI,WAAW;GACxB,OAAO,MAAM;GACb,aAAa,MAAM;GACpB,CAAC;EAIF,MAAM,WAAW,aAFF,MAAM,6BAA6B,SAAS,OAAO,IAAI,UAAU,EAE1C,OAAO,KAAK,gBAAgB;AAChE,OAAI,MAAM,KACR,IAAG,OAAO,KAAK,UAAU,aAAa,MAAM,EAAE,CAAC;YACtC,CAAC,MAAM,MAChB,IAAG,IAAI,kCAAkC,aAAa,MAAM,CAAC;IAE/D;AAEF,UAAQ,KAAK,SAAS;GACtB;AAEJ,QAAO"}
+{"version":3,"file":"migration-apply.mjs","names":["destinationHash: string","refName: string | undefined","details: Array<{ label: string; value: string }>","bundles: readonly AttestedMigrationBundle[]","graph: MigrationGraph","pendingMigrations: MigrationApplyStep[]"],"sources":["../../src/commands/migration-apply.ts"],"sourcesContent":["import { EMPTY_CONTRACT_HASH } from '@prisma-next/core-control-plane/constants';\nimport { findPathWithDecision } from '@prisma-next/migration-tools/dag';\nimport { readRefs, resolveRef } from '@prisma-next/migration-tools/refs';\nimport type { AttestedMigrationBundle, MigrationGraph } from '@prisma-next/migration-tools/types';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/types';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\n\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport type { MigrationApplyFailure, MigrationApplyStep } from '../control-api/types';\nimport {\n  CliStructuredError,\n  type CliStructuredError as CliStructuredErrorType,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorRuntime,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  loadMigrationBundles,\n  maskConnectionUrl,\n  readContractEnvelope,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  targetSupportsMigrations,\n  toPathDecisionResult,\n} from '../utils/command-helpers';\nimport { formatMigrationApplyCommandOutput } 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 MigrationApplyCommandOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly ref?: string;\n}\n\nexport interface MigrationApplyResult {\n  readonly ok: boolean;\n  readonly migrationsApplied: number;\n  readonly migrationsTotal: number;\n  readonly markerHash: string;\n  readonly applied: readonly {\n    readonly dirName: string;\n    readonly from: string;\n    readonly to: string;\n    readonly operationsExecuted: number;\n  }[];\n  readonly summary: string;\n  readonly pathDecision?: {\n    readonly fromHash: string;\n    readonly toHash: string;\n    readonly alternativeCount: number;\n    readonly tieBreakReasons: readonly string[];\n    readonly refName?: string;\n    readonly selectedPath: readonly {\n      readonly dirName: string;\n      readonly migrationId: string | null;\n      readonly from: string;\n      readonly to: string;\n    }[];\n  };\n  readonly timings: {\n    readonly total: number;\n  };\n}\n\nfunction mapMigrationToolsError(error: unknown): CliStructuredErrorType {\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 apply: ${error instanceof Error ? error.message : String(error)}`,\n  });\n}\n\nfunction mapApplyFailure(failure: MigrationApplyFailure): CliStructuredErrorType {\n  return errorRuntime(failure.summary, {\n    why: failure.why ?? 'Migration runner failed',\n    fix: 'Fix the issue and re-run `prisma-next migration apply` — previously applied migrations are preserved.',\n    meta: failure.meta ?? {},\n  });\n}\n\nfunction packageToStep(pkg: AttestedMigrationBundle): MigrationApplyStep {\n  return {\n    dirName: pkg.dirName,\n    from: pkg.manifest.from,\n    to: pkg.manifest.to,\n    toContract: pkg.manifest.toContract,\n    operations: pkg.ops,\n  };\n}\n\nasync function executeMigrationApplyCommand(\n  options: MigrationApplyCommandOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n  startTime: number,\n): Promise<Result<MigrationApplyResult, CliStructuredErrorType>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative, refsPath } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  const dbConnection = options.db ?? config.db?.connection;\n  if (!dbConnection) {\n    return notOk(\n      errorDatabaseConnectionRequired({\n        why: `Database connection is required for migration apply (set db.connection in ${configPath}, or pass --db <url>)`,\n        commandName: 'migration apply',\n      }),\n    );\n  }\n\n  if (!config.driver) {\n    return notOk(\n      errorDriverRequired({\n        why: 'Config.driver is required for migration apply',\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  let destinationHash: string;\n  let refName: string | undefined;\n\n  if (options.ref) {\n    refName = options.ref;\n    try {\n      const refs = await readRefs(refsPath);\n      destinationHash = resolveRef(refs, refName);\n    } catch (error) {\n      if (MigrationToolsError.is(error)) {\n        return notOk(mapMigrationToolsError(error));\n      }\n      throw error;\n    }\n  } else {\n    try {\n      const envelope = await readContractEnvelope(config);\n      destinationHash = envelope.storageHash;\n    } catch (error) {\n      return notOk(\n        errorRuntime('Current contract is unavailable', {\n          why: `Failed to read contract: ${error instanceof Error ? error.message : String(error)}`,\n          fix: 'Run `prisma-next contract emit` to generate a valid contract.json, then retry apply.',\n        }),\n      );\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 (typeof dbConnection === 'string') {\n      details.push({\n        label: 'database',\n        value: maskConnectionUrl(dbConnection),\n      });\n    }\n    if (refName) {\n      details.push({ label: 'ref', value: refName });\n    }\n    const header = formatStyledHeader({\n      command: 'migration apply',\n      description: 'Apply planned migrations to the database',\n      url: 'https://pris.ly/migration-apply',\n      details,\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  // Read migrations and build migration chain model (offline — no DB needed)\n  let bundles: readonly AttestedMigrationBundle[];\n  let graph: MigrationGraph;\n  try {\n    ({ bundles, graph } = await loadMigrationBundles(migrationsDir));\n  } catch (error) {\n    if (MigrationToolsError.is(error)) {\n      return notOk(mapMigrationToolsError(error));\n    }\n    throw error;\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    driver: config.driver,\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const marker = await client.readMarker();\n\n    // --- No attested migrations on disk ---\n    if (bundles.length === 0) {\n      if (marker?.storageHash) {\n        return notOk(\n          errorRuntime('Database has state but no migrations exist', {\n            why: `The database marker hash \"${marker.storageHash}\" exists but no attested migrations were found in ${migrationsRelative}`,\n            fix: 'Ensure the migrations directory is correct. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n            meta: { markerHash: marker.storageHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Non-empty contract + no migrations = user needs to plan first.\n      if (destinationHash !== EMPTY_CONTRACT_HASH) {\n        return notOk(\n          errorRuntime('Current contract has no planned migrations', {\n            why: `No attested migrations were found in ${migrationsRelative}, but current contract hash is \"${destinationHash}\"`,\n            fix: 'Run `prisma-next migration plan` to create an attested migration for the current contract.',\n            meta: { destinationHash, migrationsDir: migrationsRelative },\n          }),\n        );\n      }\n      // Empty contract + no migrations = nothing to do.\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: EMPTY_CONTRACT_HASH,\n        applied: [],\n        summary: 'No attested migrations found',\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    // --- Validate marker state ---\n\n    // The empty sentinel should never appear in a real marker row — if it does,\n    // the marker was corrupted and replaying all migrations would be dangerous.\n    if (marker?.storageHash === EMPTY_CONTRACT_HASH) {\n      return notOk(\n        errorRuntime('Database marker contains the empty sentinel hash', {\n          why: `The marker row exists but contains the empty sentinel value \"${EMPTY_CONTRACT_HASH}\". This should never happen — the marker should contain the hash of the last applied contract.`,\n          fix: 'The marker is corrupted. Run `prisma-next db sign` to overwrite it with the correct contract hash, or drop and recreate the database.',\n          meta: { markerHash: EMPTY_CONTRACT_HASH },\n        }),\n      );\n    }\n\n    const markerHash = marker?.storageHash;\n\n    if (markerHash !== undefined && !graph.nodes.has(markerHash)) {\n      return notOk(\n        errorRuntime('Database marker does not match any known migration', {\n          why: `The database marker hash \"${markerHash}\" is not found in the migration history at ${migrationsRelative}`,\n          fix: 'Ensure the migrations directory matches this database. If the database was managed with `db init` or `db update`, run `prisma-next db sign` to update the marker.',\n          meta: { markerHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    if (!graph.nodes.has(destinationHash)) {\n      return notOk(\n        errorRuntime('Current contract has no planned migration path', {\n          why: `Current contract hash \"${destinationHash}\" is not present in the migration history at ${migrationsRelative}`,\n          fix: 'Run `prisma-next migration plan` to create a migration for the current contract, then re-run apply.',\n          meta: { destinationHash, knownNodes: [...graph.nodes] },\n        }),\n      );\n    }\n\n    // --- Resolve path and apply ---\n\n    // \"No marker\" means the database is fresh — start from the empty contract hash.\n    const originHash = markerHash ?? EMPTY_CONTRACT_HASH;\n\n    const decision = findPathWithDecision(graph, originHash, destinationHash, refName);\n    if (!decision) {\n      return notOk(\n        errorRuntime('No migration path from current state to target', {\n          why: `Cannot find a path from \"${originHash}\" to target \"${destinationHash}\"`,\n          fix: 'Check the migration history for gaps or inconsistencies.',\n          meta: { markerHash: originHash, destinationHash },\n        }),\n      );\n    }\n\n    const pendingPath = decision.selectedPath;\n    const pathDecision = toPathDecisionResult(decision);\n\n    if (pendingPath.length === 0) {\n      return ok({\n        ok: true,\n        migrationsApplied: 0,\n        migrationsTotal: 0,\n        markerHash: originHash,\n        applied: [],\n        summary: 'Already up to date',\n        pathDecision,\n        timings: { total: Date.now() - startTime },\n      });\n    }\n\n    const bundleByDir = new Map(bundles.map((b) => [b.dirName, b]));\n    const pendingMigrations: MigrationApplyStep[] = [];\n    for (const migration of pendingPath) {\n      const pkg = bundleByDir.get(migration.dirName);\n      if (!pkg) {\n        return notOk(\n          errorRuntime(`Migration package not found: ${migration.dirName}`, {\n            why: `The migration directory for path segment ${migration.from} → ${migration.to} was not found`,\n            fix: 'Ensure all migration directories are present and intact.',\n          }),\n        );\n      }\n      pendingMigrations.push(packageToStep(pkg));\n    }\n\n    if (!flags.quiet && !flags.json) {\n      for (const migration of pendingMigrations) {\n        ui.step(`Pending ${migration.dirName}`);\n      }\n    }\n\n    const applyResult = await client.migrationApply({\n      originHash,\n      destinationHash,\n      pendingMigrations,\n    });\n\n    if (!applyResult.ok) {\n      return notOk(mapApplyFailure(applyResult.failure));\n    }\n\n    const { value } = applyResult;\n\n    return ok({\n      ok: true,\n      migrationsApplied: value.migrationsApplied,\n      migrationsTotal: pendingPath.length,\n      markerHash: value.markerHash,\n      applied: value.applied,\n      summary: value.summary,\n      pathDecision,\n      timings: { total: Date.now() - startTime },\n    });\n  } catch (error) {\n    if (CliStructuredError.is(error)) {\n      return notOk(error);\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Unexpected error during migration apply: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationApplyCommand(): Command {\n  const command = new Command('apply');\n  setCommandDescriptions(\n    command,\n    'Apply planned migrations to the database',\n    'Applies previously planned migrations (created by `migration plan`) to a live database.\\n' +\n      'Compares the database marker against the migration history to determine which\\n' +\n      'migrations are pending, then executes them sequentially. Each migration runs\\n' +\n      'in its own transaction. Does not plan new migrations — run `migration plan` first.',\n  );\n  setCommandExamples(command, ['prisma-next migration apply --db $DATABASE_URL']);\n  addGlobalOptions(command)\n    .option('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--ref <name>', 'Target ref name from migrations/refs.json')\n    .action(async (options: MigrationApplyCommandOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const ui = new TerminalUI({\n        color: flags.color,\n        interactive: flags.interactive,\n      });\n\n      const result = await executeMigrationApplyCommand(options, flags, ui, startTime);\n\n      const exitCode = handleResult(result, flags, ui, (applyResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(applyResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationApplyCommandOutput(applyResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

package/dist/commands/migration-plan.mjs

@@ -91,10 +91,10 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 				const f = resolved.failure;
 				return notOk(f.reason === "ambiguous" ? errorRuntime("Multiple matching migrations found", {
 					why: `Prefix "${options.from}" matches ${f.count} migrations in ${migrationsRelative}`,
-					fix: "Provide a longer prefix to disambiguate, or omit --from to use the latest migration leaf."
+					fix: "Provide a longer prefix to disambiguate, or omit --from to use the latest migration target."
 				}) : errorRuntime("Starting contract not found", {
 					why: `No migration with to hash matching "${options.from}" exists in ${migrationsRelative}`,
-					fix: "Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration leaf."
+					fix: "Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration target."
 				}));
 			}
 			fromHash = resolved.value.manifest.to;
@@ -196,7 +196,7 @@ function createMigrationPlanCommand() {
 	const command = new Command("plan");
 	setCommandDescriptions(command, "Plan a migration from contract changes", "Compares the emitted contract against the latest on-disk migration state and\nproduces a new migration package with the required operations. No database\nconnection is needed — this is a fully offline operation.");
 	setCommandExamples(command, ["prisma-next migration plan", "prisma-next migration plan --name add-users-table"]);
-	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--name <slug>", "Name slug for the migration directory", "migration").option("--from <hash>", "Explicit starting contract hash (overrides migration chain leaf)").action(async (options) => {
+	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--name <slug>", "Name slug for the migration directory", "migration").option("--from <hash>", "Explicit starting contract hash (overrides latest migration target)").action(async (options) => {
 		const flags = parseGlobalFlags(options);
 		const startTime = Date.now();
 		const ui = new TerminalUI({

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

@@ -1 +1 @@
-{"version":3,"file":"migration-plan.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","toContractJson: 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 leaf.',\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 leaf.',\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 migration chain leaf)')\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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"}
+{"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-show.mjs

@@ -73,7 +73,7 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 				}));
 				const latestMigration = findLatestMigration(reconstructGraph(attested));
 				if (!latestMigration) return notOk(errorRuntime("Could not resolve latest migration", {
-					why: "No latest migration found in the migration chain",
+					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);

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

@@ -1 +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 chain',\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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"}
+{"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.mjs

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

package/dist/{migration-status-DAQKsmWW.mjs → migration-status-B7OVZ-Ka.mjs}

@@ -1305,7 +1305,7 @@ async function executeMigrationStatusCommand(options, flags, ui) {
 		});
 		const header = formatStyledHeader({
 			command: "migration status",
-			description: "Show migration chain and applied status",
+			description: "Show migration history and applied status",
 			details,
 			flags
 		});
@@ -1390,7 +1390,7 @@ async function executeMigrationStatusCommand(options, flags, ui) {
 		if (graph.nodes.has(contractHash)) hints.push("Run 'prisma-next db sign' to overwrite the marker if the database already matches the contract", "Run 'prisma-next db update' to push the current contract to the database", "Run 'prisma-next contract infer' to make your contract match the database", "Run 'prisma-next db verify' to inspect the database state");
 		else hints.push("Run 'prisma-next db update' to push the current contract to the database", "Run 'prisma-next contract infer' to make your contract match the database", "Run 'prisma-next db verify' to inspect the database state");
 		diagnostics.push({
-			code: "MIGRATION.MARKER_NOT_IN_GRAPH",
+			code: "MIGRATION.MARKER_NOT_IN_HISTORY",
 			severity: "warn",
 			message: "Database was updated outside the migration system (marker does not match any migration)",
 			hints
@@ -1434,7 +1434,7 @@ async function executeMigrationStatusCommand(options, flags, ui) {
 		diverged: true
 	});
 	const chain = resolveDisplayChain(graph, targetHash, markerHash);
-	if (!chain) return notOk(errorRuntime("Cannot reconstruct migration chain", {
+	if (!chain) return notOk(errorRuntime("Cannot reconstruct migration history", {
 		why: `No path from ${EMPTY_CONTRACT_HASH} to target ${targetHash}`,
 		fix: "The migration history may have gaps. Check the migrations directory for missing or corrupted packages."
 	}));
@@ -1450,7 +1450,7 @@ async function executeMigrationStatusCommand(options, flags, ui) {
 	else summary = `${pendingCount} pending migration(s) — run 'prisma-next migration apply' to apply`;
 	else summary = `${entries.length} migration(s) on disk`;
 	if (mode === "online") if (markerHash !== void 0 && !graph.nodes.has(markerHash) && markerHash === contractHash) diagnostics.push({
-		code: "MIGRATION.MARKER_NOT_IN_GRAPH",
+		code: "MIGRATION.MARKER_NOT_IN_HISTORY",
 		severity: "warn",
 		message: "Database matches the current contract but was updated directly (not via migration apply)",
 		hints: ["Run 'prisma-next migration plan' to plan a migration to your current contract"]
@@ -1492,7 +1492,7 @@ async function executeMigrationStatusCommand(options, flags, ui) {
 }
 function createMigrationStatusCommand() {
 	const command = new Command("status");
-	setCommandDescriptions(command, "Show migration chain and applied status", "Displays the migration chain in order. When a database connection\nis available, shows which migrations are applied and which are pending.\nWithout a database connection, shows the chain from disk only.");
+	setCommandDescriptions(command, "Show migration history and applied status", "Displays the migration history in order. When a database connection\nis available, shows which migrations are applied and which are pending.\nWithout a database connection, shows the history from disk only.");
 	setCommandExamples(command, ["prisma-next migration status", "prisma-next migration status --db $DATABASE_URL"]);
 	addGlobalOptions(command).option("--db <url>", "Database connection string").option("--config <path>", "Path to prisma-next.config.ts").option("--ref <name>", "Target ref name from migrations/refs.json").option("--graph", "Show the full migration graph with all branches").option("--limit <n>", "Maximum number of migrations to display (default: 10)").option("--all", "Show full history (disables truncation)").action(async (options) => {
 		const flags = parseGlobalFlags(options);
@@ -1573,4 +1573,4 @@ function summarizeRefDistance(graph, markerHash, refHash, refName) {
 
 //#endregion
 export { deriveEdgeStatuses as n, createMigrationStatusCommand as t };
-//# sourceMappingURL=migration-status-DAQKsmWW.mjs.map
+//# sourceMappingURL=migration-status-B7OVZ-Ka.mjs.map