@prisma-next/cli 0.8.0 → 0.9.0-dev.1

package/src/control-api/operations/apply-aggregate.ts

@@ -49,7 +49,7 @@ export interface ApplyAggregateInputs<TFamilyId extends string, TTargetId extend
    * Per-space plans, keyed by `spaceId`. Produced by either the full
    * {@link planAggregate} pipeline (`db init` / `db update` — synth
    * for the app, graph-walk for extensions) or by direct
-   * {@link graphWalkStrategy} calls (`migration apply` — graph-walk
+   * {@link graphWalkStrategy} calls (`migrate` — graph-walk
    * for every member). Either way, the runner consumes the same shape.
    */
   readonly perSpacePlans: ReadonlyMap<string, AggregatePerSpacePlan>;
@@ -100,7 +100,7 @@ export type ApplyAggregateResult = Result<ApplyAggregateValue, AggregateApplyRun
 
 /**
  * Runner-driving tail shared by every aggregate apply caller — `db init`,
- * `db update`, and `migration apply`. Consumes already-resolved per-space
+ * `db update`, and `migrate`. Consumes already-resolved per-space
  * plans (the planner-vs-replay distinction is owned by the caller) and
  * dispatches them to the multi-space runner in canonical order.
  *
@@ -264,7 +264,7 @@ export function collectOrdered(
 /**
  * Action-appropriate label for the `spanStart` event the apply
  * primitive emits. `applyAggregate` is shared by `db init`, `db update`,
- * and `migration apply`; the span label tracks the user-visible action
+ * and `migrate`; the span label tracks the user-visible action
  * so structured-progress output reads naturally for each surface.
  */
 export function progressLabelForAction(action: AggregateApplyAction): string {
@@ -285,6 +285,6 @@ function labelForAction(action: AggregateApplyAction): string {
     case 'dbUpdate':
       return 'db update';
     case 'migrationApply':
-      return 'migration apply';
+      return 'migrate';
   }
 }

package/src/control-api/operations/contract-emit.ts

@@ -4,6 +4,7 @@ import { emit, getEmittedArtifactPaths } from '@prisma-next/emitter';
 import { createControlStack } from '@prisma-next/framework-components/control';
 import { abortable } from '@prisma-next/utils/abortable';
 import { ifDefined } from '@prisma-next/utils/defined';
+import type { JsonObject } from '@prisma-next/utils/json';
 import { dirname } from 'pathe';
 import { loadConfig } from '../../config-loader';
 import { errorContractConfigMissing, errorRuntime } from '../../utils/cli-errors';
@@ -231,10 +232,32 @@ export async function executeContractEmit(
         config.target.targetId,
         rawComponents,
       );
-      const enrichedIR = enrichContract(validatedContract.value as Contract, frameworkComponents);
-      familyInstance.validateContract(enrichedIR);
+      // Blind cast: `validateProviderResult` upstream has already
+      // pinned `validatedContract.value` to the provider's loose
+      // `Contract` envelope, but the local `Contract` type at this
+      // call site is the precise structural interface. Re-narrowing
+      // the envelope into the precise type is exactly what the
+      // `familyInstance.deserializeContract(enrichedIR)` call on the
+      // next line does — the cast just defers the structural check
+      // by one statement so `enrichContract` can decorate first.
+      const enrichedIR = enrichContract(
+        validatedContract.value as unknown as Contract,
+        frameworkComponents,
+      );
+      familyInstance.deserializeContract(enrichedIR);
+      // Each target's descriptor ships a `contractSerializer` SPI; the
+      // framework canonicalizer threads its `serializeContract` so the
+      // on-disk JSON envelope is constructed by target-owned code
+      // rather than by walking the in-memory contract with
+      // `Object.entries` (which would leak runtime-only class API
+      // fields into the persisted shape).
+      const serializeContract = (c: Contract): JsonObject =>
+        config.target.contractSerializer.serializeContract(c);
       emitResult = await unlessAborted(
-        emit(enrichedIR, stack, config.family.emission, { outputJsonPath }),
+        emit(enrichedIR, stack, config.family.emission, {
+          outputJsonPath,
+          serializeContract,
+        }),
       );
     } catch (error) {
       endSpan(onProgress, 'emit', 'error');

package/src/control-api/operations/db-apply-aggregate.ts

@@ -116,7 +116,7 @@ export async function executeAggregateApply<TFamilyId extends string, TTargetId
     migrationsDir,
     appContract: contract,
     extensionPacks,
-    validateContract: (json) => familyInstance.validateContract(json),
+    deserializeContract: (json) => familyInstance.deserializeContract(json),
   };
   const loaded = await buildContractSpaceAggregate(loadInputs);
   if (!loaded.ok) {
@@ -207,9 +207,10 @@ export async function executeAggregateApply<TFamilyId extends string, TTargetId
 
   // 5. Apply mode: hand off to the shared `applyAggregate` primitive.
   // The runner-driving tail is identical for `db init` / `db update` /
-  // `migration apply` — only how each caller produces `perSpacePlans`
+  // `migrate` — only how each caller produces `perSpacePlans`
   // differs (synth + graph-walk via planAggregate here; graph-walk
-  // only for migration apply). See M6 sub-spec § Required changes 1.
+  // only for migrate). Each caller produces perSpacePlans differently;
+  // this helper handles the shared apply tail.
   const applied = await applyAggregate({
     aggregate,
     perSpacePlans: planResult.value.perSpace,

package/src/control-api/operations/db-verify.ts

@@ -120,7 +120,7 @@ function buildLoadInputs<TFamilyId extends string, TTargetId extends string>(
     migrationsDir: options.migrationsDir,
     appContract: options.contract,
     extensionPacks: options.extensionPacks,
-    validateContract: (json) => options.familyInstance.validateContract(json),
+    deserializeContract: (json) => options.familyInstance.deserializeContract(json),
   };
 }
 
@@ -172,7 +172,7 @@ function createPerMemberVerifier<TFamilyId extends string, TTargetId extends str
   const { skipSchema, familyInstance, frameworkComponents } = options;
   return (projectedSchema, member, verifyMode) => {
     if (skipSchema) return buildSkippedSchemaResult(member);
-    return familyInstance.schemaVerifyAgainstSchema({
+    return familyInstance.verifySchema({
       contract: member.contract,
       // The family's `TSchemaIR` is opaque to migration-tools; the
       // aggregate verifier passes through whatever we hand it. The

package/src/control-api/operations/migration-apply.ts

@@ -34,7 +34,7 @@ import type {
 import { applyAggregate, buildPerSpaceBreakdown } from './apply-aggregate';
 
 /**
- * Inputs for the aggregate-walking `migration apply` control-api
+ * Inputs for the aggregate-walking `migrate` control-api
  * operation.
  *
  * The CLI command resolves the descriptor surface (config, refs,
@@ -110,7 +110,8 @@ export interface ExecuteMigrationApplyOptions<TFamilyId extends string, TTargetI
  *    shared with `db init` / `db update`). Marker advancement is
  *    inside the per-space transaction.
  *
- * Sub-spec § `migration apply` semantics + § Required changes 1.
+ * Encodes the replay-only contract: every contract space must have an
+ * authored migration graph on disk before this operation can advance it.
  */
 export async function executeMigrationApply<TFamilyId extends string, TTargetId extends string>(
   options: ExecuteMigrationApplyOptions<TFamilyId, TTargetId>,
@@ -136,7 +137,7 @@ export async function executeMigrationApply<TFamilyId extends string, TTargetId
     migrationsDir,
     appContract: contract,
     extensionPacks,
-    validateContract: (json) => familyInstance.validateContract(json),
+    deserializeContract: (json) => familyInstance.deserializeContract(json),
     appMigrationPackages,
   };
   const loaded = await buildContractSpaceAggregate(loadInputs);
@@ -461,7 +462,7 @@ function buildNeverPlannedFailure(spaceId: string, targetHash: string): Migratio
   return {
     code: 'MIGRATION_PATH_NOT_FOUND',
     summary: `No on-disk migrations for contract space "${spaceId}"`,
-    why: `migration apply is replay-only: every contract space must have an authored migration graph on disk. Space "${spaceId}" has no migrations under \`migrations/${spaceId}/\` but its head ref targets "${targetHash}". Run \`prisma-next migration plan\` first to materialise the path.`,
+    why: `migrate is replay-only: every contract space must have an authored migration graph on disk. Space "${spaceId}" has no migrations under \`migrations/${spaceId}/\` but its head ref targets "${targetHash}". Run \`prisma-next migration plan\` first to materialise the path.`,
     meta: { spaceId, target: targetHash, kind: 'neverPlanned' },
   };
 }

package/src/control-api/types.ts

@@ -118,7 +118,7 @@ export type OnControlProgress = (event: ControlProgressEvent) => void;
  * Options for the verify operation.
  */
 export interface VerifyOptions {
-  /** Contract or unvalidated JSON - validated at runtime via familyInstance.validateContract() */
+  /** Contract or unvalidated JSON - validated at runtime via familyInstance.deserializeContract() */
   readonly contract: unknown;
   /**
    * Database connection. If provided, verify will connect before executing.
@@ -134,7 +134,7 @@ export interface VerifyOptions {
  * Options for the schemaVerify operation.
  */
 export interface SchemaVerifyOptions {
-  /** Contract or unvalidated JSON - validated at runtime via familyInstance.validateContract() */
+  /** Contract or unvalidated JSON - validated at runtime via familyInstance.deserializeContract() */
   readonly contract: unknown;
   /**
    * Whether to use strict mode for schema verification.
@@ -156,7 +156,7 @@ export interface SchemaVerifyOptions {
  * Options for the sign operation.
  */
 export interface SignOptions {
-  /** Contract or unvalidated JSON - validated at runtime via familyInstance.validateContract() */
+  /** Contract or unvalidated JSON - validated at runtime via familyInstance.deserializeContract() */
   readonly contract: unknown;
   /**
    * Path to the contract file (for metadata in the result).
@@ -180,7 +180,7 @@ export interface SignOptions {
  * Options for the dbInit operation.
  */
 export interface DbInitOptions {
-  /** Contract or unvalidated JSON - validated at runtime via familyInstance.validateContract() */
+  /** Contract or unvalidated JSON - validated at runtime via familyInstance.deserializeContract() */
   readonly contract: unknown;
   /**
    * Mode for the dbInit operation.
@@ -209,7 +209,7 @@ export interface DbInitOptions {
  * Options for the dbUpdate operation.
  */
 export interface DbUpdateOptions {
-  /** Contract or unvalidated JSON - validated at runtime via familyInstance.validateContract() */
+  /** Contract or unvalidated JSON - validated at runtime via familyInstance.deserializeContract() */
   readonly contract: unknown;
   /**
    * Mode for the dbUpdate operation.
@@ -251,7 +251,13 @@ export interface DbUpdateOptions {
  * portion of the verifier.
  */
 export interface DbVerifyOptions {
-  readonly contract: unknown;
+  /**
+   * Already-deserialized contract. Callers cross the family
+   * `deserializeContract` seam at the read site (TML-2536) and pass the
+   * hydrated value through unchanged; this op no longer re-runs the
+   * SerializerBase pipeline.
+   */
+  readonly contract: Contract;
   readonly migrationsDir: string;
   readonly strict: boolean;
   readonly skipSchema: boolean;
@@ -590,7 +596,6 @@ export interface MigrationApplyStep {
   readonly dirName: string;
   readonly from: string | null;
   readonly to: string;
-  readonly toContract: Contract;
   readonly operations: readonly MigrationPlanOperation[];
   /**
    * Sorted, deduplicated invariant ids from `migration.json.providedInvariants`.

package/src/load-ts-contract.ts

@@ -212,7 +212,15 @@ export async function loadContractFromTs(
 
     validatePurity(contract);
 
-    return contract as Contract;
+    // Blind cast: the loaded module was authored by user code
+    // (typically via `defineContract` / a contract builder) and
+    // its runtime shape is structurally a `Contract`, but the
+    // dynamic import collapses the source typing. The contract
+    // structural validation that asserts the shape happens
+    // downstream at the `familyInstance.deserializeContract` seam
+    // (e.g. in `executeContractEmit`); this helper only checks
+    // purity here.
+    return contract as unknown as Contract;
   } catch (error) {
     try {
       if (tempFile) {

package/src/migration-cli.ts

@@ -3,7 +3,7 @@
  * `node migration.ts` directly.
  *
  * Naming: this is *not* a "migration runner" in the apply-time sense. The
- * apply-time runner is the thing `prisma-next migration apply` uses to
+ * apply-time runner is the thing `prisma-next migrate` uses to
  * execute migration JSON ops against a database. `MigrationCLI` is the
  * tiny CLI surface owned by an authored `migration.ts` file: parse the
  * file's argv, load the project's `prisma-next.config.ts`, assemble a

package/src/utils/cli-errors.ts

@@ -25,6 +25,7 @@ import {
 } from '@prisma-next/errors/control';
 import { errorRuntime } from '@prisma-next/errors/execution';
 import type { MigrationToolsError } from '@prisma-next/migration-tools/errors';
+import type { RefResolutionError } from '@prisma-next/migration-tools/ref-resolution';
 
 export {
   ERROR_CODE_DESTRUCTIVE_CHANGES,
@@ -85,3 +86,39 @@ export function mapMigrationToolsError(error: MigrationToolsError): CliStructure
     meta: { code: error.code, ...(error.details ?? {}) },
   });
 }
+
+/**
+ * Maps a `RefResolutionError` from the contract/migration reference
+ * resolver into a CLI structured error envelope.
+ */
+export function mapRefResolutionError(error: RefResolutionError): CliStructuredError {
+  switch (error.kind) {
+    case 'not-found':
+      return errorRuntime(`Not a known ${error.grammar} reference: "${error.input}"`, {
+        why: `No ${error.grammar} matching "${error.input}" exists in the migration graph or refs index.`,
+        fix:
+          error.grammar === 'contract'
+            ? 'Provide a valid contract hash, ref name, or migration directory name.'
+            : 'Provide a valid migration directory name or migration hash.',
+        meta: { input: error.input, grammar: error.grammar },
+      });
+    case 'ambiguous':
+      return errorRuntime(`Ambiguous ${error.grammar} reference: "${error.input}"`, {
+        why: `"${error.input}" matches multiple ${error.grammar}s: ${error.candidates.join(', ')}`,
+        fix: 'Provide a longer prefix or use the full hash to disambiguate.',
+        meta: { input: error.input, candidates: error.candidates, grammar: error.grammar },
+      });
+    case 'wrong-grammar':
+      return errorRuntime(error.message, {
+        why: error.message,
+        fix: error.fix,
+        meta: { input: error.input, expectedGrammar: error.expectedGrammar },
+      });
+    case 'invalid-format':
+      return errorRuntime(`Invalid reference format: "${error.input}"`, {
+        why: error.reason,
+        fix: 'Provide a valid contract hash, ref name, or migration directory name.',
+        meta: { input: error.input },
+      });
+  }
+}

package/src/utils/command-helpers.ts

@@ -17,6 +17,10 @@ import { parseGlobalFlags } from './global-flags';
 
 const longDescriptions = new WeakMap<Command, string>();
 const commandExamples = new WeakMap<Command, readonly string[]>();
+const commandSeeAlso = new WeakMap<
+  Command,
+  readonly { readonly verb: string; readonly oneLiner: string }[]
+>();
 
 /**
  * Sets both short and long descriptions for a command.
@@ -57,6 +61,27 @@ export function getCommandExamples(command: Command): readonly string[] | undefi
   return commandExamples.get(command);
 }
 
+/**
+ * Sets cross-references to related commands, rendered in a "See also"
+ * section below the Examples block in help output.
+ */
+export function setCommandSeeAlso(
+  command: Command,
+  refs: readonly { readonly verb: string; readonly oneLiner: string }[],
+): Command {
+  commandSeeAlso.set(command, refs);
+  return command;
+}
+
+/**
+ * Gets the see-also cross-references from a command.
+ */
+export function getCommandSeeAlso(
+  command: Command,
+): readonly { readonly verb: string; readonly oneLiner: string }[] | undefined {
+  return commandSeeAlso.get(command);
+}
+
 /**
  * Shared CLI options interface for migration commands (db init, db update).
  * These are the Commander.js parsed options common to both commands.
@@ -79,13 +104,13 @@ export function resolveContractPath(config: { contract?: { output?: string } }):
 
 /**
  * Resolves the migrations directory and config path from CLI options.
- * Shared by migration-apply, migration-plan, and migration-status.
+ * Shared by migrate, migration-plan, and migration-status.
  *
  * - `migrationsDir` is the project's top-level `migrations/` directory
  *   (the root that the aggregate loader walks for every contract space).
  * - `appMigrationsDir` is the app subspace directory under it
  *   (`<migrationsDir>/<APP_SPACE_ID>/`). Every per-app reader / writer
- *   (`migration new`, `migration plan`, `migration apply`,
+ *   (`migration new`, `migration plan`, `migrate`,
  *   `migration status`, `migration show`, `migration ref`) operates on
  *   this directory. Extensions own their own `migrations/<spaceId>/`.
  * - `refsDir` is the app's refs directory (`<appMigrationsDir>/refs/`).
@@ -159,7 +184,7 @@ export function collectDeclaredInvariants(graph: MigrationGraph): ReadonlySet<st
 /**
  * Maps a `MigrationEdge` to the structural-edge shape used in the
  * `MIGRATION.NO_INVARIANT_PATH` error envelope. Shared between
- * `migration apply` and `migration status` so both commands surface
+ * `migrate` and `migration status` so both commands surface
  * the same JSON wire shape when an invariant-aware route is unsatisfiable.
  */
 export function toStructuralEdge(edge: MigrationEdge): NoInvariantPathStructuralEdge {

package/src/utils/contract-space-aggregate-loader.ts

@@ -120,7 +120,7 @@ export interface BuildAggregateInputs<TFamilyId extends string, TTargetId extend
   readonly migrationsDir: string;
   readonly appContract: Contract;
   readonly extensionPacks: ReadonlyArray<ControlExtensionDescriptor<TFamilyId, TTargetId>>;
-  readonly validateContract: (contractJson: unknown) => Contract;
+  readonly deserializeContract: (contractJson: unknown) => Contract;
   /**
    * App-space migration packages to hydrate the app member's
    * migration graph with. Defaults to `[]` (matches the `db init` /
@@ -128,7 +128,7 @@ export interface BuildAggregateInputs<TFamilyId extends string, TTargetId extend
    * `migrations/` graph is not walked — the planner uses the synth
    * strategy for the app member instead).
    *
-   * `migration apply` callers thread the user's authored app-space
+   * `migrate` callers thread the user's authored app-space
    * packages (loaded via `loadMigrationPackages(appMigrationsDir)`)
    * through here so the graph-walk strategy can plot a path through
    * them — the prod-time replay path explicitly forbids synth.
@@ -144,7 +144,7 @@ export interface BuildAggregateInputs<TFamilyId extends string, TTargetId extend
  * (defaulting to `[]`). `db init` / `db update` leave it empty: the
  * planner's `synth` strategy is used for the app member (driven by
  * `callerPolicy.ignoreGraphFor`), so the app's authored `migrations/`
- * graph does not need to be walked. `migration apply` threads the
+ * graph does not need to be walked. `migrate` threads the
  * already-loaded app-space packages through so the graph-walk strategy
  * can plot a path through them — replay forbids synth.
  *
@@ -165,7 +165,7 @@ export async function buildContractSpaceAggregate<
     migrationsDir: inputs.migrationsDir,
     appContract: inputs.appContract,
     declaredExtensions,
-    validateContract: inputs.validateContract,
+    deserializeContract: inputs.deserializeContract,
     appMigrationPackages: inputs.appMigrationPackages ?? [],
   };
 

package/src/utils/contract-space-seed-phase.ts

@@ -91,7 +91,7 @@ export interface ContractSpaceSeedPhaseResult {
  * Output ordering is deterministic and alphabetical by spaceId (via
  * {@link planAllSpaces}, which also detects duplicate spaceIds). This
  * matches the canonical sort order used by every other aggregate
- * surface (`migration apply`, `migration status`, the runner).
+ * surface (`migrate`, `migration status`, the runner).
  */
 export async function runContractSpaceSeedPhase(
   inputs: ContractSpaceSeedPhaseInputs,
@@ -193,7 +193,7 @@ function buildPlaceholderContractDts(spaceId: string): string {
     ' * alongside `contract.json` and `refs/head.json`. A typed `.d.ts`',
     ' * rendering pass for extension contracts is tracked separately;',
     ' * until that ships, consumers should import `contract.json`',
-    ' * directly with `validateContract<…>(…)`.',
+    ' * and pass it through the target descriptor’s `contractSerializer`.',
     ' */',
     'export {};',
     '',

package/src/utils/formatters/help.ts

@@ -2,7 +2,7 @@ import { blue, bold, cyan, dim, green, magenta } from 'colorette';
 import type { Command } from 'commander';
 import wrapAnsi from 'wrap-ansi';
 
-import { getCommandExamples, getLongDescription } from '../command-helpers';
+import { getCommandExamples, getCommandSeeAlso, getLongDescription } from '../command-helpers';
 import type { GlobalFlags } from '../global-flags';
 import { formatDim } from './helpers';
 import { padToFixedWidth, renderCommandTree } from './styled';
@@ -134,7 +134,7 @@ function getCommandDocsUrl(commandPath: string): string | undefined {
     'db verify': 'https://pris.ly/db-verify',
     'db update': 'https://pris.ly/db-update',
     'migration plan': 'https://pris.ly/migration-plan',
-    'migration apply': 'https://pris.ly/migration-apply',
+    migrate: 'https://pris.ly/migrate',
     'migration show': 'https://pris.ly/migration-show',
     'migration status': 'https://pris.ly/migration-status',
   };
@@ -268,6 +268,16 @@ export function formatCommandHelp(options: {
     }
   }
 
+  // See also (cross-references to related commands)
+  const seeAlso = getCommandSeeAlso(command);
+  if (seeAlso && seeAlso.length > 0) {
+    lines.push(formatDimText('│'));
+    lines.push(`${formatDimText('│')} ${formatDimText('See also:')}`);
+    for (const ref of seeAlso) {
+      lines.push(`${formatDimText('│')}   ${ref.verb}  ${formatDimText(ref.oneLiner)}`);
+    }
+  }
+
   // Multi-line description (if present) - shown after all other content
   if (longDescription) {
     lines.push(formatDimText('│'));

package/src/utils/formatters/migrations.ts

@@ -90,7 +90,7 @@ export interface MigrationCommandResult {
 
 /**
  * Render the shared per-space execution block consumed by the `db init`
- * / `db update` / `migration apply` summaries. Always shows: space
+ * / `db update` / `migrate` summaries. Always shows: space
  * label (`Extension space: <id>` or `App space`) → per-op lines under
  * each space → per-space marker hash (when known).
  *
@@ -254,7 +254,7 @@ export interface MigrationApplyCommandOutputResult {
   /**
    * Per-space breakdown in canonical schedule order (extensions
    * alphabetically, then app). Always present for the aggregate-walking
-   * `migration apply` command.
+   * `migrate` command.
    */
   readonly perSpace: readonly AggregatePerSpaceExecutionEntry[];
   readonly timings?: {

package/dist/cli-errors-D3_sMh2K.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-errors-D3_sMh2K.mjs","names":[],"sources":["../src/utils/cli-errors.ts"],"sourcesContent":["/**\n * Re-export all domain error factories from @prisma-next/errors for convenience.\n * CLI-specific errors (e.g., Commander argument validation in the main CLI, or\n * clipanion parse errors in the migration-file CLI) can be added here if needed.\n */\nexport type { CliErrorConflict, CliErrorEnvelope } from '@prisma-next/errors/control';\n\nimport {\n  CliStructuredError,\n  errorConfigFileNotFound,\n  errorConfigValidation,\n  errorContractConfigMissing,\n  errorContractMissingExtensionPacks,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFamilyReadMarkerSqlRequired,\n  errorFileNotFound,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n  errorMigrationPlanningFailed,\n  errorQueryRunnerFactoryRequired,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '@prisma-next/errors/control';\nimport { errorRuntime } from '@prisma-next/errors/execution';\nimport type { MigrationToolsError } from '@prisma-next/migration-tools/errors';\n\nexport {\n  ERROR_CODE_DESTRUCTIVE_CHANGES,\n  errorDestructiveChanges,\n  errorHashMismatch,\n  errorMarkerMissing,\n  errorMarkerRequired,\n  errorRunnerFailed,\n  errorRuntime,\n  errorSchemaVerificationFailed,\n  errorTargetMismatch,\n} from '@prisma-next/errors/execution';\nexport {\n  errorMigrationFileMissing,\n  errorMigrationInvalidDefaultExport,\n  errorMigrationPlanNotArray,\n  errorUnfilledPlaceholder,\n  placeholder,\n} from '@prisma-next/errors/migration';\nexport {\n  CliStructuredError,\n  errorConfigFileNotFound,\n  errorConfigValidation,\n  errorContractConfigMissing,\n  errorContractMissingExtensionPacks,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFamilyReadMarkerSqlRequired,\n  errorFileNotFound,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n  errorMigrationPlanningFailed,\n  errorQueryRunnerFactoryRequired,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n};\n\n/**\n * Maps a `MigrationToolsError` raised by the migration-tools loader/graph\n * surface (`readMigrationPackage`, `readMigrationsDir`, `readRefs`,\n * `resolveRef`, `reconstructGraph`, ...) into a CLI `errorRuntime` envelope.\n *\n * The full `error.details` payload is forwarded into `meta` so machine\n * consumers (`--json`) see structural fields like `dir`, `storedHash`,\n * `computedHash` (for `MIGRATION.HASH_MISMATCH`) alongside the stable\n * `code`. The user-visible `summary`/`why`/`fix` text is unchanged.\n *\n * Callers are expected to gate on `MigrationToolsError.is(error)` first\n * (mirroring the original inline pattern); non-`MigrationToolsError`\n * values are caller-classified (rethrow, wrap with command-specific\n * `errorUnexpected`, etc.).\n */\nexport function mapMigrationToolsError(error: MigrationToolsError): CliStructuredError {\n  return errorRuntime(error.message, {\n    why: error.why,\n    fix: error.fix,\n    meta: { code: error.code, ...(error.details ?? {}) },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgFA,SAAgB,uBAAuB,OAAgD;CACrF,OAAO,aAAa,MAAM,SAAS;EACjC,KAAK,MAAM;EACX,KAAK,MAAM;EACX,MAAM;GAAE,MAAM,MAAM;GAAM,GAAI,MAAM,WAAW,EAAE;GAAG;EACrD,CAAC"}