@prisma-next/cli 0.8.0-dev.7 → 0.8.0-dev.8

package/src/commands/{migration-ref.ts → ref.ts}

@@ -1,8 +1,8 @@
 import { MigrationToolsError } from '@prisma-next/migration-tools/errors';
+import { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';
 import type { RefEntry } from '@prisma-next/migration-tools/refs';
 import {
   deleteRef,
-  readRef,
   readRefs,
   validateRefName,
   validateRefValue,
@@ -16,9 +16,11 @@ import {
   errorRuntime,
   errorUnexpected,
   mapMigrationToolsError,
+  mapRefResolutionError,
 } from '../utils/cli-errors';
 import {
   addGlobalOptions,
+  loadMigrationPackages,
   resolveMigrationPaths,
   setCommandDescriptions,
 } from '../utils/command-helpers';
@@ -34,13 +36,6 @@ interface RefSetResult {
   readonly invariants: readonly string[];
 }
 
-interface RefGetResult {
-  readonly ok: true;
-  readonly ref: string;
-  readonly hash: string;
-  readonly invariants: readonly string[];
-}
-
 interface RefDeleteResult {
   readonly ok: true;
   readonly ref: string;
@@ -66,53 +61,42 @@ function cliErrorInvalidRefName(name: string): CliStructuredError {
   });
 }
 
-function cliErrorInvalidRefValue(hash: string): CliStructuredError {
-  return errorRuntime(`Invalid contract hash "${hash}"`, {
-    why: `"${hash}" is not a valid contract hash`,
-    fix: 'Contract hashes must match the format "sha256:<64 hex chars>". Copy the hash from `prisma-next contract emit` or `migration status --json`.',
-  });
-}
-
-async function executeRefSetCommand(
+export async function executeRefSetCommand(
   name: string,
-  hash: string,
+  contractInput: string,
   options: { config?: string },
 ): Promise<Result<RefSetResult, CliStructuredError>> {
   if (!validateRefName(name)) {
     return notOk(cliErrorInvalidRefName(name));
   }
-  if (!validateRefValue(hash)) {
-    return notOk(cliErrorInvalidRefValue(hash));
-  }
 
   try {
     const config = await loadConfig(options.config);
-    const { refsDir } = resolveMigrationPaths(options.config, config);
-    const entry: RefEntry = { hash, invariants: [] };
+    const { appMigrationsDir, refsDir } = resolveMigrationPaths(options.config, config);
+
+    let resolvedHash: string;
+    if (validateRefValue(contractInput)) {
+      resolvedHash = contractInput;
+    } else {
+      const { graph } = await loadMigrationPackages(appMigrationsDir);
+      const refs = await readRefs(refsDir);
+      const refResult = parseContractRef(contractInput, { graph, refs });
+      if (!refResult.ok) {
+        return notOk(mapRefResolutionError(refResult.failure));
+      }
+      resolvedHash = refResult.value.hash;
+    }
+
+    const entry: RefEntry = { hash: resolvedHash, invariants: [] };
     await writeRef(refsDir, name, entry);
-    return ok({ ok: true as const, ref: name, hash, invariants: [] });
-  } catch (error) {
-    if (error instanceof CliStructuredError) return notOk(error);
-    return notOk(mapError(error));
-  }
-}
-
-async function executeRefGetCommand(
-  name: string,
-  options: { config?: string },
-): Promise<Result<RefGetResult, CliStructuredError>> {
-  try {
-    const config = await loadConfig(options.config);
-    const { refsDir } = resolveMigrationPaths(options.config, config);
-    const entry = await readRef(refsDir, name);
-    return ok({ ok: true as const, ref: name, hash: entry.hash, invariants: entry.invariants });
+    return ok({ ok: true as const, ref: name, hash: resolvedHash, invariants: [] });
   } catch (error) {
     if (error instanceof CliStructuredError) return notOk(error);
     return notOk(mapError(error));
   }
 }
 
-async function executeRefDeleteCommand(
+export async function executeRefDeleteCommand(
   name: string,
   options: { config?: string },
 ): Promise<Result<RefDeleteResult, CliStructuredError>> {
@@ -127,7 +111,7 @@ async function executeRefDeleteCommand(
   }
 }
 
-async function executeRefListCommand(options: {
+export async function executeRefListCommand(options: {
   config?: string;
 }): Promise<Result<RefListResult, CliStructuredError>> {
   try {
@@ -145,12 +129,15 @@ function createRefSetCommand(): Command {
   const command = new Command('set');
   setCommandDescriptions(
     command,
-    'Set a ref to a contract hash',
-    'Sets a named ref to point to a contract hash in migrations/refs/.',
+    'Set a ref to a contract reference',
+    'Sets a named ref to point to a resolved contract reference (hash, alias, or path) in migrations/refs/.',
   );
   addGlobalOptions(command)
     .argument('<name>', 'Ref name (e.g., staging, production)')
-    .argument('<hash>', 'Contract hash to point to')
+    .argument(
+      '<contract>',
+      'Contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',
+    )
     .option('--config <path>', 'Path to prisma-next.config.ts')
     .action(
       async (
@@ -174,37 +161,6 @@ function createRefSetCommand(): Command {
   return command;
 }
 
-function createRefGetCommand(): Command {
-  const command = new Command('get');
-  setCommandDescriptions(
-    command,
-    'Get the hash for a ref',
-    'Reads a named ref from migrations/refs/ and prints its contract hash.',
-  );
-  addGlobalOptions(command)
-    .argument('<name>', 'Ref name to look up')
-    .option('--config <path>', 'Path to prisma-next.config.ts')
-    .action(
-      async (
-        name: string,
-        options: { config?: string; json?: string | boolean; quiet?: boolean },
-      ) => {
-        const flags = parseGlobalFlags(options);
-        const ui = new TerminalUI({ color: flags.color, interactive: flags.interactive });
-        const result = await executeRefGetCommand(name, options);
-        const exitCode = handleResult(result, flags, ui, (value) => {
-          if (flags.json) {
-            ui.output(JSON.stringify(value));
-          } else {
-            ui.output(value.hash);
-          }
-        });
-        process.exit(exitCode);
-      },
-    );
-  return command;
-}
-
 function createRefDeleteCommand(): Command {
   const command = new Command('delete');
   setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');
@@ -262,20 +218,11 @@ function createRefListCommand(): Command {
   return command;
 }
 
-export {
-  cliErrorInvalidRefName,
-  cliErrorInvalidRefValue,
-  executeRefDeleteCommand,
-  executeRefGetCommand,
-  executeRefListCommand,
-  executeRefSetCommand,
-};
-
-export function createMigrationRefCommand(): Command {
+export function createRefCommand(): Command {
   const command = new Command('ref');
   setCommandDescriptions(
     command,
-    'Manage migration refs',
+    'Manage contract refs',
     'Manage named refs in migrations/refs/. Refs map logical environment\n' +
       'names (e.g., staging, production) to contract hashes.',
   );
@@ -284,7 +231,6 @@ export function createMigrationRefCommand(): Command {
     subcommandDescription: () => '',
   });
   command.addCommand(createRefSetCommand());
-  command.addCommand(createRefGetCommand());
   command.addCommand(createRefDeleteCommand());
   command.addCommand(createRefListCommand());
   return command;

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/db-apply-aggregate.ts

@@ -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/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>,
@@ -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/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

@@ -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.
  *

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,

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"}