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

package/dist/commands/migration-show.mjs

@@ -1,53 +1,35 @@
-import { t as loadConfig } from "../config-loader-B6sJjXTv.mjs";
-import { P as errorContractValidationFailed, R as errorFileNotFound, T as formatStyledHeader, X as errorRuntime, _ as createTerminalUI, d as setCommandSeeAlso, g as parseGlobalFlagsOrExit, l as setCommandDescriptions, o as resolveContractPath, rt as mapRefResolutionError, s as resolveMigrationPaths, t as addGlobalOptions, tt as errorUnexpected, u as setCommandExamples, y as handleResult } from "../command-helpers-Bbw1GbwL.mjs";
-import { t as createControlClient } from "../client-KgJorIvG.mjs";
-import { a as formatMigrationShowOutput } from "../migrations-Cv2jxNNK.mjs";
+import { t as loadConfig } from "../config-loader-p9JMrekQ.mjs";
+import { A as formatStyledHeader, B as errorContractValidationFailed, E as formatMigrationShowOutput, W as errorFileNotFound, _ as createTerminalUI, ct as errorUnexpected, d as setCommandSeeAlso, g as parseGlobalFlagsOrExit, l as setCommandDescriptions, o as resolveContractPath, rt as errorRuntime, s as resolveMigrationPaths, t as addGlobalOptions, u as setCommandExamples, ut as mapRefResolutionError, y as handleResult } from "../command-helpers-DGMvGBeX.mjs";
+import { t as createControlClient } from "../client-CJzuo5wX.mjs";
+import { n as looksLikePath, r as resolveAppTargetPath, t as findPackageByDirPath } from "../migration-path-target-Ce6OZImp.mjs";
 import { Command } from "commander";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { notOk, ok } from "@prisma-next/utils/result";
-import { isAbsolute, relative, resolve } from "pathe";
+import { relative } from "pathe";
 import { readFile } from "node:fs/promises";
 import { APP_SPACE_ID, createControlStack } from "@prisma-next/framework-components/control";
-import { loadContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
 import { castAs } from "@prisma-next/utils/casts";
+import { loadContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
 import { parseMigrationRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/migration-show.ts
-function looksLikePath(target) {
-	return target.includes("/") || target.includes("\\");
-}
-function resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative) {
-	const targetPath = resolve(target);
-	const relativeToApp = relative(appMigrationsDir, targetPath);
-	if (relativeToApp === "" || relativeToApp === "." || relativeToApp.startsWith("..") || isAbsolute(relativeToApp)) return notOk(errorRuntime("Target must point to an app-space migration", {
-		why: `Expected a path under ${appMigrationsRelative}, got ${target}`,
-		fix: "Pass an app-space migration directory or use a hash prefix."
-	}));
-	return ok(targetPath);
-}
 function pkgToPresent(spaceId, pkg, client) {
 	const ops = castAs(pkg.ops);
-	const preview = client.toOperationPreview(ops) ?? { statements: [] };
+	const rawPreview = client.toOperationPreview(ops) ?? { statements: [] };
 	return {
-		spaceId,
-		dirName: pkg.dirName,
-		dirPath: relative(process.cwd(), pkg.dirPath),
-		from: pkg.metadata.from,
-		to: pkg.metadata.to,
-		migrationHash: pkg.metadata.migrationHash,
+		space: spaceId,
+		name: pkg.dirName,
+		fromContract: pkg.metadata.from,
+		toContract: pkg.metadata.to,
+		hash: pkg.metadata.migrationHash,
 		createdAt: pkg.metadata.createdAt,
 		operations: ops.map((op) => ({
 			id: op.id,
 			label: op.label,
 			operationClass: op.operationClass
 		})),
-		preview,
-		summary: `${ops.length} operation(s)`
+		preview: { statements: [...rawPreview.statements] }
 	};
 }
-function findPackageByDirPath(packages, resolvedDirPath) {
-	const normalized = resolve(resolvedDirPath);
-	return packages.find((p) => resolve(p.dirPath) === normalized);
-}
 async function executeMigrationShowCommand(target, options, flags, ui) {
 	const config = await loadConfig(options.config);
 	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
@@ -139,15 +121,21 @@ async function executeMigrationShowCommand(target, options, flags, ui) {
 		}));
 		appPkg = matchedPkg;
 	}
+	const migration = pkgToPresent(APP_SPACE_ID, appPkg, client);
 	return ok({
 		ok: true,
-		migration: pkgToPresent(APP_SPACE_ID, appPkg, client)
+		summary: `Migration ${migration.name} in ${migration.space}: ${migration.operations.length} operation(s)`,
+		migration
 	});
 }
 function createMigrationShowCommand() {
 	const command = new Command("show");
-	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, statement preview, and metadata for one app-space migration.\nAccepts a directory path, directory name, or hash prefix.");
-	setCommandExamples(command, ["prisma-next migration show 20260101_100000_add_user", "prisma-next migration show sha256:a1b2c3"]);
+	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, statement preview, and metadata for one app-space migration.\nAccepts a directory path, directory name, or hash prefix.\nOffline — does not consult the database.");
+	setCommandExamples(command, [
+		"prisma-next migration show 20260101_100000_add_user",
+		"prisma-next migration show sha256:a1b2c3",
+		"prisma-next migration show 20260101_100000_add_user --json"
+	]);
 	setCommandSeeAlso(command, [
 		{
 			verb: "migration status",
@@ -166,7 +154,7 @@ function createMigrationShowCommand() {
 			oneLiner: "Show the migration graph topology"
 		}
 	]);
-	addGlobalOptions(command).argument("<target>", "Migration reference: directory name, hash/prefix, or path").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
+	addGlobalOptions(command).argument("<target>", "Migration reference: directory name, hash/prefix, ref, or path").option("--config <path>", "Path to prisma-next.config.ts").action(async (target, options) => {
 		const flags = parseGlobalFlagsOrExit(options);
 		const ui = createTerminalUI(flags);
 		const exitCode = handleResult(await executeMigrationShowCommand(target, options, flags, ui), flags, ui, (showResult) => {
@@ -178,6 +166,6 @@ function createMigrationShowCommand() {
 	return command;
 }
 //#endregion
-export { createMigrationShowCommand, resolveAppTargetPath };
+export { createMigrationShowCommand };
 
 //# sourceMappingURL=migration-show.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-show.mjs","names":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport {\n  APP_SPACE_ID,\n  createControlStack,\n  type MigrationPlanOperation,\n  type OperationPreview,\n} from '@prisma-next/framework-components/control';\nimport { loadContractSpaceAggregate } from '@prisma-next/migration-tools/aggregate';\nimport type { OnDiskMigrationPackage } from '@prisma-next/migration-tools/package';\nimport { parseMigrationRef } from '@prisma-next/migration-tools/ref-resolution';\nimport { castAs } from '@prisma-next/utils/casts';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { isAbsolute, relative, resolve } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport {\n  type CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorRuntime,\n  errorUnexpected,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\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, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationShowOptions extends CommonCommandOptions {\n  readonly config?: string;\n}\n\nexport interface MigrationShowPresent {\n  readonly spaceId: string;\n  readonly dirName: string;\n  readonly dirPath: string;\n  readonly from: string | null;\n  readonly to: string;\n  readonly migrationHash: string;\n  readonly createdAt: string;\n  readonly operations: readonly {\n    readonly id: string;\n    readonly label: string;\n    readonly operationClass: string;\n  }[];\n  readonly preview: OperationPreview;\n  readonly summary: string;\n}\n\nexport interface MigrationShowResult {\n  readonly ok: true;\n  readonly migration: MigrationShowPresent;\n}\n\nfunction looksLikePath(target: string): boolean {\n  return target.includes('/') || target.includes('\\\\');\n}\n\nexport function resolveAppTargetPath(\n  target: string,\n  appMigrationsDir: string,\n  appMigrationsRelative: string,\n): Result<string, CliStructuredError> {\n  const targetPath = resolve(target);\n  const relativeToApp = relative(appMigrationsDir, targetPath);\n  const isOutsideAppDir =\n    relativeToApp === '' ||\n    relativeToApp === '.' ||\n    relativeToApp.startsWith('..') ||\n    isAbsolute(relativeToApp);\n  if (isOutsideAppDir) {\n    return notOk(\n      errorRuntime('Target must point to an app-space migration', {\n        why: `Expected a path under ${appMigrationsRelative}, got ${target}`,\n        fix: 'Pass an app-space migration directory or use a hash prefix.',\n      }),\n    );\n  }\n  return ok(targetPath);\n}\n\nfunction pkgToPresent(\n  spaceId: string,\n  pkg: OnDiskMigrationPackage,\n  client: ReturnType<typeof createControlClient>,\n): MigrationShowPresent {\n  const ops = castAs<readonly MigrationPlanOperation[]>(pkg.ops);\n  const preview: OperationPreview = client.toOperationPreview(ops) ?? { statements: [] };\n  return {\n    spaceId,\n    dirName: pkg.dirName,\n    dirPath: relative(process.cwd(), pkg.dirPath),\n    from: pkg.metadata.from,\n    to: pkg.metadata.to,\n    migrationHash: pkg.metadata.migrationHash,\n    createdAt: pkg.metadata.createdAt,\n    operations: ops.map((op) => ({\n      id: op.id,\n      label: op.label,\n      operationClass: op.operationClass,\n    })),\n    preview,\n    summary: `${ops.length} operation(s)`,\n  };\n}\n\nfunction findPackageByDirPath(\n  packages: readonly OnDiskMigrationPackage[],\n  resolvedDirPath: string,\n): OnDiskMigrationPackage | undefined {\n  const normalized = resolve(resolvedDirPath);\n  return packages.find((p) => resolve(p.dirPath) === normalized);\n}\n\nasync function executeMigrationShowCommand(\n  target: string,\n  options: MigrationShowOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationShowResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } =\n    resolveMigrationPaths(options.config, config);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration show',\n      description: 'Display migration package contents',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'contract', value: contractPath },\n        { label: 'migrations', value: appMigrationsRelative },\n        { label: 'target', value: target },\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    ...ifDefined('driver', config.driver),\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as NodeJS.ErrnoException).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}`,\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: 'Failed to read contract file',\n      }),\n    );\n  }\n\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  let appContract: Contract;\n  try {\n    appContract = familyInstance.deserializeContract(\n      castAs<unknown>(JSON.parse(contractJsonContent)),\n    );\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const aggregate = await loadContractSpaceAggregate({\n    migrationsDir,\n    appContract,\n    deserializeContract: (json: unknown) => familyInstance.deserializeContract(json),\n  });\n\n  const packages = aggregate.app.packages;\n  const graph = aggregate.app.graph();\n  const refs = aggregate.app.refs;\n\n  let appPkg: OnDiskMigrationPackage;\n  if (looksLikePath(target)) {\n    const resolved = resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative);\n    if (!resolved.ok) return resolved;\n    const matched = findPackageByDirPath(packages, resolved.value);\n    if (!matched) {\n      return notOk(\n        errorRuntime('Migration package not found', {\n          why: `No loaded migration package at ${relative(process.cwd(), resolved.value)}`,\n          fix: 'Pass a directory name, hash prefix, or path to an on-disk app-space migration package.',\n        }),\n      );\n    }\n    appPkg = matched;\n  } else {\n    if (packages.length === 0) {\n      return notOk(\n        errorRuntime('No migrations found', {\n          why: `No migration packages found in ${appMigrationsRelative}`,\n          fix: 'Run `prisma-next migration plan` to create a migration first.',\n        }),\n      );\n    }\n    const migResult = parseMigrationRef(target, { graph, refs });\n    if (!migResult.ok) {\n      return notOk(mapRefResolutionError(migResult.failure));\n    }\n    const matchedPkg = packages.find(\n      (p) => p.metadata.migrationHash === migResult.value.migrationHash,\n    );\n    if (!matchedPkg) {\n      return notOk(\n        errorRuntime('Migration package not found', {\n          why: `Resolved migration \"${migResult.value.dirName}\" but the package was not loaded`,\n          fix: 'The migrations directory may be corrupted. Inspect the migration.json files.',\n        }),\n      );\n    }\n    appPkg = matchedPkg;\n  }\n\n  return ok({\n    ok: true,\n    migration: pkgToPresent(APP_SPACE_ID, appPkg, client),\n  });\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, statement preview, and metadata for one app-space migration.\\n' +\n      'Accepts a directory path, directory name, or hash prefix.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration show 20260101_100000_add_user',\n    'prisma-next migration show sha256:a1b2c3',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration log', oneLiner: 'Show executed migration history' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\n    { verb: 'migration graph', oneLiner: 'Show the migration graph topology' },\n  ]);\n  addGlobalOptions(command)\n    .argument('<target>', 'Migration reference: directory name, hash/prefix, or path')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (target: string, options: MigrationShowOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n\n      const ui = createTerminalUI(flags);\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":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { Contract } from '@prisma-next/contract/types';\nimport {\n  APP_SPACE_ID,\n  createControlStack,\n  type MigrationPlanOperation,\n} from '@prisma-next/framework-components/control';\nimport { loadContractSpaceAggregate } from '@prisma-next/migration-tools/aggregate';\nimport type { OnDiskMigrationPackage } from '@prisma-next/migration-tools/package';\nimport { parseMigrationRef } from '@prisma-next/migration-tools/ref-resolution';\nimport { castAs } from '@prisma-next/utils/casts';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { relative } from 'pathe';\nimport { loadConfig } from '../config-loader';\nimport { createControlClient } from '../control-api/client';\nimport {\n  type CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorRuntime,\n  errorUnexpected,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveContractPath,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\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, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport {\n  findPackageByDirPath,\n  looksLikePath,\n  resolveAppTargetPath,\n} from '../utils/migration-path-target';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\nimport type { MigrationShowResult } from './json/schemas';\n\ninterface MigrationShowOptions extends CommonCommandOptions {\n  readonly config?: string;\n}\n\nexport interface MigrationShowPresent {\n  readonly space: string;\n  readonly name: string;\n  readonly fromContract: string | null;\n  readonly toContract: string;\n  readonly hash: string;\n  readonly createdAt: string;\n  readonly operations: { id: string; label: string; operationClass: string }[];\n  readonly preview: {\n    statements: { text: string; language: string }[];\n  };\n}\n\nexport type { MigrationShowResult };\n\nfunction pkgToPresent(\n  spaceId: string,\n  pkg: OnDiskMigrationPackage,\n  client: ReturnType<typeof createControlClient>,\n): MigrationShowPresent {\n  const ops = castAs<readonly MigrationPlanOperation[]>(pkg.ops);\n  const rawPreview = client.toOperationPreview(ops) ?? { statements: [] };\n  return {\n    space: spaceId,\n    name: pkg.dirName,\n    fromContract: pkg.metadata.from,\n    toContract: pkg.metadata.to,\n    hash: pkg.metadata.migrationHash,\n    createdAt: pkg.metadata.createdAt,\n    operations: ops.map((op) => ({\n      id: op.id,\n      label: op.label,\n      operationClass: op.operationClass,\n    })),\n    preview: { statements: [...rawPreview.statements] },\n  };\n}\n\nasync function executeMigrationShowCommand(\n  target: string,\n  options: MigrationShowOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationShowResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } =\n    resolveMigrationPaths(options.config, config);\n\n  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration show',\n      description: 'Display migration package contents',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'contract', value: contractPath },\n        { label: 'migrations', value: appMigrationsRelative },\n        { label: 'target', value: target },\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    ...ifDefined('driver', config.driver),\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  let contractJsonContent: string;\n  try {\n    contractJsonContent = await readFile(contractPathAbsolute, 'utf-8');\n  } catch (error) {\n    if (error instanceof Error && (error as NodeJS.ErrnoException).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}`,\n        }),\n      );\n    }\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: 'Failed to read contract file',\n      }),\n    );\n  }\n\n  const stack = createControlStack(config);\n  const familyInstance = config.family.create(stack);\n\n  let appContract: Contract;\n  try {\n    appContract = familyInstance.deserializeContract(\n      castAs<unknown>(JSON.parse(contractJsonContent)),\n    );\n  } catch (error) {\n    return notOk(\n      errorContractValidationFailed(\n        `Contract at ${contractPathAbsolute} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`,\n        { where: { path: contractPathAbsolute } },\n      ),\n    );\n  }\n\n  const aggregate = await loadContractSpaceAggregate({\n    migrationsDir,\n    appContract,\n    deserializeContract: (json: unknown) => familyInstance.deserializeContract(json),\n  });\n\n  const packages = aggregate.app.packages;\n  const graph = aggregate.app.graph();\n  const refs = aggregate.app.refs;\n\n  let appPkg: OnDiskMigrationPackage;\n  if (looksLikePath(target)) {\n    const resolved = resolveAppTargetPath(target, appMigrationsDir, appMigrationsRelative);\n    if (!resolved.ok) return resolved;\n    const matched = findPackageByDirPath(packages, resolved.value);\n    if (!matched) {\n      return notOk(\n        errorRuntime('Migration package not found', {\n          why: `No loaded migration package at ${relative(process.cwd(), resolved.value)}`,\n          fix: 'Pass a directory name, hash prefix, or path to an on-disk app-space migration package.',\n        }),\n      );\n    }\n    appPkg = matched;\n  } else {\n    if (packages.length === 0) {\n      return notOk(\n        errorRuntime('No migrations found', {\n          why: `No migration packages found in ${appMigrationsRelative}`,\n          fix: 'Run `prisma-next migration plan` to create a migration first.',\n        }),\n      );\n    }\n    const migResult = parseMigrationRef(target, { graph, refs });\n    if (!migResult.ok) {\n      return notOk(mapRefResolutionError(migResult.failure));\n    }\n    const matchedPkg = packages.find(\n      (p) => p.metadata.migrationHash === migResult.value.migrationHash,\n    );\n    if (!matchedPkg) {\n      return notOk(\n        errorRuntime('Migration package not found', {\n          why: `Resolved migration \"${migResult.value.dirName}\" but the package was not loaded`,\n          fix: 'The migrations directory may be corrupted. Inspect the migration.json files.',\n        }),\n      );\n    }\n    appPkg = matchedPkg;\n  }\n\n  const migration = pkgToPresent(APP_SPACE_ID, appPkg, client);\n  return ok({\n    ok: true,\n    summary: `Migration ${migration.name} in ${migration.space}: ${migration.operations.length} operation(s)`,\n    migration,\n  });\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, statement preview, and metadata for one app-space migration.\\n' +\n      'Accepts a directory path, directory name, or hash prefix.\\n' +\n      'Offline — does not consult the database.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration show 20260101_100000_add_user',\n    'prisma-next migration show sha256:a1b2c3',\n    'prisma-next migration show 20260101_100000_add_user --json',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration log', oneLiner: 'Show executed migration history' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\n    { verb: 'migration graph', oneLiner: 'Show the migration graph topology' },\n  ]);\n  addGlobalOptions(command)\n    .argument('<target>', 'Migration reference: directory name, hash/prefix, ref, or path')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (target: string, options: MigrationShowOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n\n      const ui = createTerminalUI(flags);\n\n      const result = await executeMigrationShowCommand(target, options, flags, ui);\n\n      const exitCode = handleResult(result, flags, ui, (showResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(showResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.log(formatMigrationShowOutput(showResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":"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"}

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

@@ -1,157 +1,55 @@
-import { n as StatusRef, t as StatusDiagnostic } from "../migration-types-D2FW63pr.mjs";
+import { N as CliStructuredError } from "../types-C_tYiJYx.mjs";
+import { c as MigrationStatusEntry, d as StatusDiagnosticJson, l as MigrationStatusResult, p as migrationStatusJsonResultSchema, u as MigrationStatusSpace } from "../schemas-CeGMYFYX.mjs";
+import { n as GlobalFlags, t as CommonCommandOptions } from "../global-flags-BpoOYtNZ.mjs";
+import { t as TerminalUI } from "../terminal-ui-DGRNFWna.mjs";
 import { Command } from "commander";
-import { ContractMarkerRecordLike, ContractSpaceAggregate } from "@prisma-next/migration-tools/aggregate";
-import { MigrationGraph } from "@prisma-next/migration-tools/graph";
-import { OnDiskMigrationPackage } from "@prisma-next/migration-tools/package";
+import { Result } from "@prisma-next/utils/result";
 
-//#region src/utils/formatters/graph-migration-mapper.d.ts
-type EdgeStatusKind = 'applied' | 'pending' | 'unreachable';
-/** Minimal per-edge status from the CLI's status result. */
-interface EdgeStatus {
-  readonly dirName: string;
-  readonly status: EdgeStatusKind;
+//#region src/utils/migration-types.d.ts
+interface StatusRef {
+  readonly name: string;
+  readonly hash: string;
+  readonly active: boolean;
 }
 //#endregion
 //#region src/commands/migration-status.d.ts
-interface MigrationStatusEntry {
-  readonly dirName: string;
-  readonly from: string;
-  readonly to: string;
-  readonly migrationHash: string;
-  readonly operationCount: number;
-  readonly operationSummary: string;
-  readonly hasDestructive: boolean;
-  readonly status: EdgeStatusKind | 'unknown';
+interface MigrationStatusOptions extends CommonCommandOptions {
+  readonly db?: string;
+  readonly config?: string;
+  readonly to?: string;
+  readonly from?: string;
+  readonly space?: string;
+  readonly legend?: boolean;
+  readonly ascii?: boolean;
 }
-/**
- * Per-space status row in the aggregate-shaped status output.
- *
- * Surfaces, for each contract space:
- *
- * - `headHash`: the on-disk head ref's hash (where the space is going).
- * - `markerHash`: the live marker hash for the space, or null if no
- *    marker has been written yet (greenfield, or pre-`migrate`).
- * - `pendingCount`: number of migration edges between marker and head.
- *    Computed via {@link graphWalkStrategy}; 0 means the space is
- *    already at head.
- * - `status`: convenience tag the formatter uses to pick a glyph.
- *    `'never-planned'` is reserved for spaces with non-empty head but
- *    no on-disk migrations — which shouldn't happen if the loader's
- *    integrity check passes.
- *
- * Online-only fields (`markerHash`, `status`) are absent when the
- * command runs without a database connection.
- */
-interface MigrationStatusSpaceEntry {
-  readonly spaceId: string;
-  readonly kind: 'app' | 'extension';
-  readonly headHash: string;
-  readonly markerHash?: string | null;
-  readonly pendingCount?: number;
-  readonly status?: 'up-to-date' | 'pending' | 'no-marker' | 'never-planned' | 'unreachable';
+interface MigrationStatusTreeSection {
+  readonly space: string;
+  readonly tree: string;
+  readonly showHeading: boolean;
 }
-/**
- * Sum per-space `pendingCount` into a cross-space total, but only when
- * every loaded space reports a defined `pendingCount`. Returns
- * `undefined` if any space is on the marker-unknown / offline path
- * (where `pendingCount` is intentionally absent), so JSON consumers can
- * distinguish "no pending" from "unknown".
- */
-declare function computeTotalPendingAcrossSpaces(spaces: readonly MigrationStatusSpaceEntry[]): number | undefined;
-interface MigrationStatusResult {
+interface MigrationStatusCommandResult {
   readonly ok: true;
-  readonly mode: 'online' | 'offline';
-  readonly migrations: readonly MigrationStatusEntry[];
-  readonly markerHash?: string;
-  readonly targetHash: string;
-  readonly contractHash: string;
-  readonly refs?: readonly StatusRef[];
-  /** Required invariants from the active ref, sorted ascending. Always present (`[]` when no `--ref` or the ref declares none) — knowable offline. */
-  readonly requiredInvariants: readonly string[];
-  /**
-   * Invariants the marker has applied at least once, intersected with
-   * `requiredInvariants` for display relevance. JSON consumers see only the
-   * subset overlapping the active ref's required set — the full unfiltered
-   * marker invariant list lives on `marker.invariants` (control plane) and
-   * is not surfaced here. Present only in `mode === 'online'`; absent when
-   * offline (the marker is unknown, not empty).
-   */
-  readonly appliedInvariants?: readonly string[];
-  /** required − applied. Present only in `mode === 'online'`; absent when offline. */
-  readonly missingInvariants?: readonly string[];
-  readonly pathDecision?: {
-    readonly fromHash: string;
-    readonly toHash: string;
-    readonly alternativeCount: number;
-    readonly tieBreakReasons: readonly string[];
-    readonly refName?: string;
-    readonly requiredInvariants: readonly string[];
-    readonly satisfiedInvariants: readonly string[];
-    readonly selectedPath: readonly {
-      readonly dirName: string;
-      readonly migrationHash: string;
-      readonly from: string;
-      readonly to: string;
-      readonly invariants: readonly string[];
-    }[];
-  };
+  readonly spaces: readonly MigrationStatusSpace[];
   readonly summary: string;
-  readonly diagnostics: readonly StatusDiagnostic[];
-  /**
-   * Aggregate enumeration of every on-disk contract space (app +
-   * extensions), in canonical schedule order (extensions
-   * alphabetically, then app). Present whenever the aggregate loader
-   * succeeded; absent in early-error returns (e.g. unreadable
-   * migrations directory) where the existing diagnostics already
-   * surface the failure.
-   *
-   * The top-level fields (`migrations`, `markerHash`, `targetHash`,
-   * `pathDecision`, …) describe the **app member** specifically.
-   * Per-space detail for extension members lives only on this list.
-   */
-  readonly spaces?: readonly MigrationStatusSpaceEntry[];
-  /** Cross-space pending-migration total (sum of `spaces[].pendingCount`). Present when `spaces` is. */
-  readonly totalPendingAcrossSpaces?: number;
-  readonly graph?: MigrationGraph;
-  readonly bundles?: readonly OnDiskMigrationPackage[];
-  readonly edgeStatuses?: readonly EdgeStatus[];
-  readonly activeRefHash?: string;
-  readonly activeRefName?: string;
-  readonly diverged?: boolean;
+  readonly diagnostics: readonly StatusDiagnosticJson[];
+  readonly treeSections: readonly MigrationStatusTreeSection[];
 }
-/**
- * Derive per-edge status across the full graph using path analysis.
- *
- * - **applied**: edge is on the path from root to the DB marker
- * - **pending**: edge is on the path from the DB marker to the target
- *   (and the marker is reachable from root, i.e. it's on the same branch)
- * - **unreachable**: edge is on the path from root to the target but the DB
- *   marker is on a different branch — `apply` can't reach these edges
- *   without the DB first moving to this branch
- *
- * Returns statuses only for edges that have a known status (skips offline
- * and edges not on any relevant path).
- *
- * @internal Exported for testing only.
- */
-declare function deriveEdgeStatuses(graph: MigrationGraph, targetHash: string, contractHash: string, markerHash: string | undefined, mode: 'online' | 'offline'): EdgeStatus[];
-/**
- * Build the aggregate enumeration of contract spaces for the status
- * output. Loads the aggregate from disk (lossy on failure — extension
- * spaces are simply omitted, the app member's output keeps working),
- * reads per-space marker rows when online, and uses
- * {@link graphWalkStrategy} to compute each space's pending count.
- *
- * The aggregate-walking status reports per-space marker + pending
- * state alongside the cross-space totals.
- */
-declare function loadAggregateStatusSpaces(args: {
-  readonly aggregate: ContractSpaceAggregate;
-  readonly extensionPacks: ReadonlyArray<unknown>;
-  readonly markersBySpace: ReadonlyMap<string, ContractMarkerRecordLike> | null;
-}): Promise<readonly MigrationStatusSpaceEntry[]>;
+declare function buildNoPathSummary(args: {
+  readonly markerHash: string | undefined;
+  readonly targetHash: string;
+  readonly explicitTarget: boolean;
+  readonly refName: string | undefined;
+}): string;
+declare function buildStatusHeadline(args: {
+  readonly pendingCount: number;
+  readonly targetHash: string;
+  readonly markerDiverged: boolean;
+  readonly markerHash: string | undefined;
+}): string;
+declare function formatStatusSummary(result: MigrationStatusCommandResult, colorize: boolean): string;
+declare function formatStatusHumanOutput(result: MigrationStatusCommandResult, colorize: boolean): string;
+declare function executeMigrationStatusCommand(options: MigrationStatusOptions, flags: GlobalFlags, ui: TerminalUI): Promise<Result<MigrationStatusCommandResult, CliStructuredError>>;
 declare function createMigrationStatusCommand(): Command;
-declare function formatStatusSummary(result: MigrationStatusResult, colorize: boolean): string;
 //#endregion
-export { MigrationStatusEntry, MigrationStatusResult, MigrationStatusSpaceEntry, type StatusDiagnostic, type StatusRef, computeTotalPendingAcrossSpaces, createMigrationStatusCommand, deriveEdgeStatuses, formatStatusSummary, loadAggregateStatusSpaces };
+export { type MigrationStatusEntry, MigrationStatusOptions, type MigrationStatusResult, type MigrationStatusSpace, MigrationStatusTreeSection, type StatusDiagnosticJson, type StatusRef, buildNoPathSummary, buildStatusHeadline, createMigrationStatusCommand, executeMigrationStatusCommand, formatStatusHumanOutput, formatStatusSummary, migrationStatusJsonResultSchema };
 //# sourceMappingURL=migration-status.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"migration-status.d.mts","names":[],"sources":["../../src/utils/formatters/graph-migration-mapper.ts","../../src/commands/migration-status.ts"],"mappings":";;;;;;;KAiBY,cAAA;;UAmBK,UAAA;EAAA,SACN,OAAA;EAAA,SACA,MAAA,EAAQ,cAAc;AAAA;;;UC+ChB,oBAAA;EAAA,SACN,OAAA;EAAA,SACA,IAAA;EAAA,SACA,EAAA;EAAA,SACA,aAAA;EAAA,SACA,cAAA;EAAA,SACA,gBAAA;EAAA,SACA,cAAA;EAAA,SACA,MAAA,EAAQ,cAAc;AAAA;;;;;ADvDA;;;;AC+CjC;;;;;;;;;;;UA8BiB,yBAAA;EAAA,SACN,OAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;EAAA,SACA,MAAA;AAAA;;;;;;;;iBAUK,+BAAA,CACd,MAA4C,WAA3B,yBAAyB;AAAA,UAa3B,qBAAA;EAAA,SACN,EAAA;EAAA,SACA,IAAA;EAAA,SACA,UAAA,WAAqB,oBAAA;EAAA,SACrB,UAAA;EAAA,SACA,UAAA;EAAA,SACA,YAAA;EAAA,SACA,IAAA,YAAgB,SAAA;EAAA;EAAA,SAEhB,kBAAA;EA0CkB;;;;;;;;EAAA,SAjClB,iBAAA;EAfqB;EAAA,SAiBrB,iBAAA;EAAA,SACA,YAAA;IAAA,SACE,QAAA;IAAA,SACA,MAAA;IAAA,SACA,gBAAA;IAAA,SACA,eAAA;IAAA,SACA,OAAA;IAAA,SACA,kBAAA;IAAA,SACA,mBAAA;IAAA,SACA,YAAA;MAAA,SACE,OAAA;MAAA,SACA,aAAA;MAAA,SACA,IAAA;MAAA,SACA,EAAA;MAAA,SACA,UAAA;IAAA;EAAA;EAAA,SAGJ,OAAA;EAAA,SACA,WAAA,WAAsB,gBAAA;EANlB;;;;;;;;;;;;EAAA,SAmBJ,MAAA,YAAkB,yBAAA;EAKlB;EAAA,SAHA,wBAAA;EAAA,SACA,KAAA,GAAQ,cAAA;EAAA,SACR,OAAA,YAAmB,sBAAA;EAAA,SACnB,YAAA,YAAwB,UAAA;EAAA,SACxB,aAAA;EAAA,SACA,aAAA;EAAA,SACA,QAAA;AAAA;;;;;;;;;;;AAqDE;AAqLb;;;;iBA3LgB,kBAAA,CACd,KAAA,EAAO,cAAA,EACP,UAAA,UACA,YAAA,UACA,UAAA,sBACA,IAAA,yBACC,UAAU;;;;;;;;;;;iBAqLS,yBAAA,CAA0B,IAAA;EAAA,SACrC,SAAA,EAAW,sBAAA;EAAA,SACX,cAAA,EAAgB,aAAA;EAAA,SAChB,cAAA,EAAgB,WAAA,SAAoB,wBAAA;AAAA,IAC3C,OAAA,UAAiB,yBAAA;AAAA,iBA+pBL,4BAAA,CAAA,GAAgC,OAAO;AAAA,iBAoGvC,mBAAA,CAAoB,MAAA,EAAQ,qBAAqB,EAAE,QAAA"}
+{"version":3,"file":"migration-status.d.mts","names":[],"sources":["../../src/utils/migration-types.ts","../../src/commands/migration-status.ts"],"mappings":";;;;;;;;UAAiB,SAAA;EAAA,SACN,IAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;AAAA;;;UCqFM,sBAAA,SAA+B,oBAAoB;EAAA,SACzD,EAAA;EAAA,SACA,MAAA;EAAA,SACA,EAAA;EAAA,SACA,IAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;EAAA,SACA,KAAA;AAAA;AAAA,UAGM,0BAAA;EAAA,SACN,KAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;AAAA;AAAA,UAGD,4BAAA;EAAA,SACC,EAAA;EAAA,SACA,MAAA,WAAiB,oBAAA;EAAA,SACjB,OAAA;EAAA,SACA,WAAA,WAAsB,oBAAA;EAAA,SACtB,YAAA,WAAuB,0BAAA;AAAA;AAAA,iBA8DlB,kBAAA,CAAmB,IAAA;EAAA,SACxB,UAAA;EAAA,SACA,UAAA;EAAA,SACA,cAAA;EAAA,SACA,OAAA;AAAA;AAAA,iBAiBK,mBAAA,CAAoB,IAAA;EAAA,SACzB,YAAA;EAAA,SACA,UAAA;EAAA,SACA,cAAA;EAAA,SACA,UAAA;AAAA;AAAA,iBAWK,mBAAA,CACd,MAAA,EAAQ,4BAA4B,EACpC,QAAA;AAAA,iBAyBc,uBAAA,CACd,MAAA,EAAQ,4BAA4B,EACpC,QAAA;AAAA,iBAqCoB,6BAAA,CACpB,OAAA,EAAS,sBAAA,EACT,KAAA,EAAO,WAAA,EACP,EAAA,EAAI,UAAA,GACH,OAAA,CAAQ,MAAA,CAAO,4BAAA,EAA8B,kBAAA;AAAA,iBAmXhC,4BAAA,IAAgC,OAAO"}