@prisma-next/cli 0.3.0-dev.7 → 0.3.0-dev.70

package/dist/commands/migration-plan.mjs

@@ -0,0 +1,266 @@
+import { t as loadConfig } from "../config-loader-PPf4CtDj.mjs";
+import { _ as errorUnexpected, c as errorFileNotFound, f as errorMigrationPlanningFailed, h as errorTargetMigrationNotSupported, i as errorContractValidationFailed, m as errorRuntime } from "../cli-errors-JlPTsazx.mjs";
+import { t as assertFrameworkComponentsCompatible } from "../framework-components-CjV_jD8f.mjs";
+import { t as extractSqlDdl } from "../extract-sql-ddl-BmlKvk4o.mjs";
+import { C as parseGlobalFlags, D as setCommandDescriptions, T as resolveContractPath, n as formatCommandHelp, t as handleResult, y as formatStyledHeader } from "../result-handler-iA9JtUC7.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { join, relative, resolve } from "pathe";
+import { createControlPlaneStack } from "@prisma-next/core-control-plane/stack";
+import { EMPTY_CONTRACT_HASH } from "@prisma-next/core-control-plane/constants";
+import { readFile } from "node:fs/promises";
+import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/dag";
+import { formatMigrationDirName, readMigrationsDir, writeMigrationPackage } from "@prisma-next/migration-tools/io";
+import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+import { attestMigration } from "@prisma-next/migration-tools/attestation";
+
+//#region src/commands/migration-plan.ts
+function mapMigrationToolsError(error) {
+	if (MigrationToolsError.is(error)) return errorRuntime(error.message, {
+		why: error.why,
+		fix: error.fix,
+		meta: {
+			code: error.code,
+			...error.details ?? {}
+		}
+	});
+	return errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Unexpected error during migration plan: ${error instanceof Error ? error.message : String(error)}` });
+}
+async function executeMigrationPlanCommand(options, flags, startTime) {
+	const config = await loadConfig(options.config);
+	const configPath = options.config ? relative(process.cwd(), resolve(options.config)) : "prisma-next.config.ts";
+	const migrationsDir = resolve(options.config ? resolve(options.config, "..") : process.cwd(), config.migrations?.dir ?? "migrations");
+	const migrationsRelative = relative(process.cwd(), migrationsDir);
+	const contractPathAbsolute = resolveContractPath(config);
+	const contractPath = relative(process.cwd(), contractPathAbsolute);
+	if (flags.json !== "object" && !flags.quiet) {
+		const details = [
+			{
+				label: "config",
+				value: configPath
+			},
+			{
+				label: "contract",
+				value: contractPath
+			},
+			{
+				label: "migrations",
+				value: migrationsRelative
+			}
+		];
+		if (options.from) details.push({
+			label: "from",
+			value: options.from
+		});
+		if (options.name) details.push({
+			label: "name",
+			value: options.name
+		});
+		const header = formatStyledHeader({
+			command: "migration plan",
+			description: "Plan a migration from contract changes",
+			url: "https://pris.ly/migration-plan",
+			details,
+			flags
+		});
+		console.log(header);
+	}
+	let contractJsonContent;
+	try {
+		contractJsonContent = await readFile(contractPathAbsolute, "utf-8");
+	} catch (error) {
+		if (error instanceof Error && error.code === "ENOENT") return notOk(errorFileNotFound(contractPathAbsolute, {
+			why: `Contract file not found at ${contractPathAbsolute}`,
+			fix: `Run \`prisma-next contract emit\` to generate ${contractPath}, or update \`config.contract.output\` in ${configPath}`
+		}));
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read contract file: ${error instanceof Error ? error.message : String(error)}` }));
+	}
+	let toContractJson;
+	try {
+		toContractJson = JSON.parse(contractJsonContent);
+	} catch (error) {
+		return notOk(errorContractValidationFailed(`Contract JSON is invalid: ${error instanceof Error ? error.message : String(error)}`, { where: { path: contractPathAbsolute } }));
+	}
+	const toStorageHash = toContractJson["storageHash"];
+	if (!toStorageHash) return notOk(errorContractValidationFailed("Contract is missing storageHash", { where: { path: contractPathAbsolute } }));
+	let fromContract = null;
+	let fromHash = EMPTY_CONTRACT_HASH;
+	let parentMigrationId = null;
+	try {
+		const packages = (await readMigrationsDir(migrationsDir)).filter((p) => typeof p.manifest.migrationId === "string");
+		const latestMigration = findLatestMigration(reconstructGraph(packages));
+		const leafHash = latestMigration ? latestMigration.to : EMPTY_CONTRACT_HASH;
+		if (options.from) {
+			fromHash = options.from;
+			const sourcePkg = packages.find((p) => p.manifest.to === fromHash);
+			if (!sourcePkg) return notOk(errorRuntime("Starting contract not found", {
+				why: `No migration with to="${fromHash}" exists in ${migrationsRelative}`,
+				fix: "Check that the --from hash matches a known migration target hash, or omit --from to use the latest migration leaf."
+			}));
+			fromContract = sourcePkg.manifest.toContract;
+			parentMigrationId = sourcePkg.manifest.migrationId;
+		} else if (leafHash !== EMPTY_CONTRACT_HASH && latestMigration) {
+			fromHash = leafHash;
+			parentMigrationId = latestMigration.migrationId;
+			const leafPkg = packages.find((p) => p.manifest.migrationId === latestMigration.migrationId);
+			if (leafPkg) fromContract = leafPkg.manifest.toContract;
+		}
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		throw error;
+	}
+	if (fromHash === toStorageHash) return ok({
+		ok: true,
+		noOp: true,
+		from: fromHash,
+		to: toStorageHash,
+		operations: [],
+		summary: "No changes detected between contracts",
+		timings: { total: Date.now() - startTime }
+	});
+	const targetWithMigrations = config.target;
+	if (!targetWithMigrations.migrations) return notOk(errorTargetMigrationNotSupported({ why: `Target "${config.target.id}" does not support migrations` }));
+	const { migrations } = targetWithMigrations;
+	const stack = createControlPlaneStack({
+		target: config.target,
+		adapter: config.adapter,
+		extensionPacks: config.extensionPacks ?? []
+	});
+	const familyInstance = config.family.create(stack);
+	const frameworkComponents = assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [
+		config.target,
+		config.adapter,
+		...config.extensionPacks ?? []
+	]);
+	const planner = migrations.createPlanner(familyInstance);
+	const fromSchemaIR = migrations.contractToSchema(fromContract);
+	const plannerResult = planner.plan({
+		contract: toContractJson,
+		schema: fromSchemaIR,
+		policy: { allowedOperationClasses: [
+			"additive",
+			"widening",
+			"destructive"
+		] },
+		frameworkComponents
+	});
+	if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
+	const ops = plannerResult.plan.operations;
+	if (ops.length === 0) return notOk(errorMigrationPlanningFailed({ conflicts: [{
+		kind: "unsupportedChange",
+		summary: "Contract changed but planner produced no operations. This indicates unsupported or ignored changes (e.g. removals, type changes, or a planner/contract mismatch)."
+	}] }));
+	const timestamp = /* @__PURE__ */ new Date();
+	const packageDir = join(migrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
+	const manifest = {
+		from: fromHash,
+		to: toStorageHash,
+		migrationId: null,
+		parentMigrationId,
+		kind: "regular",
+		fromContract,
+		toContract: toContractJson,
+		hints: {
+			used: [],
+			applied: [],
+			plannerVersion: "1.0.0",
+			planningStrategy: "diff"
+		},
+		labels: [],
+		createdAt: timestamp.toISOString()
+	};
+	try {
+		await writeMigrationPackage(packageDir, manifest, ops);
+		const migrationId = await attestMigration(packageDir);
+		const sql = extractSqlDdl(ops);
+		return ok({
+			ok: true,
+			noOp: false,
+			from: fromHash,
+			to: toStorageHash,
+			migrationId,
+			dir: relative(process.cwd(), packageDir),
+			operations: ops.map((op) => ({
+				id: op.id,
+				label: op.label,
+				operationClass: op.operationClass
+			})),
+			sql,
+			summary: `Planned ${ops.length} operation(s)`,
+			timings: { total: Date.now() - startTime }
+		});
+	} catch (error) {
+		return notOk(mapMigrationToolsError(error));
+	}
+}
+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.");
+	command.configureHelp({ formatHelp: (cmd) => {
+		return formatCommandHelp({
+			command: cmd,
+			flags: parseGlobalFlags({})
+		});
+	} }).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)").option("--json [format]", "Output as JSON (object)", false).option("-q, --quiet", "Quiet mode: errors only").option("-v, --verbose", "Verbose output: debug info, timings").option("-vv, --trace", "Trace output: deep internals, stack traces").option("--timestamps", "Add timestamps to output").option("--color", "Force color output").option("--no-color", "Disable color output").action(async (options) => {
+		const flags = parseGlobalFlags(options);
+		const exitCode = handleResult(await executeMigrationPlanCommand(options, flags, Date.now()), flags, (planResult) => {
+			if (flags.json === "object") console.log(JSON.stringify(planResult, null, 2));
+			else if (!flags.quiet) console.log(formatMigrationPlanOutput(planResult, flags));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+function formatMigrationPlanOutput(result, flags) {
+	const lines = [];
+	const useColor = flags.color !== false;
+	const green_ = useColor ? (s) => `\x1b[32m${s}\x1b[0m` : (s) => s;
+	const yellow_ = useColor ? (s) => `\x1b[33m${s}\x1b[0m` : (s) => s;
+	const dim_ = useColor ? (s) => `\x1b[2m${s}\x1b[0m` : (s) => s;
+	if (result.noOp) {
+		lines.push(`${green_("✔")} No changes detected`);
+		lines.push(dim_(`  from: ${result.from}`));
+		lines.push(dim_(`  to:   ${result.to}`));
+		return lines.join("\n");
+	}
+	lines.push(`${green_("✔")} ${result.summary}`);
+	lines.push("");
+	if (result.operations.length > 0) {
+		lines.push(dim_("│"));
+		for (let i = 0; i < result.operations.length; i++) {
+			const op = result.operations[i];
+			const treeChar = i === result.operations.length - 1 ? "└" : "├";
+			const opClassLabel = op.operationClass === "destructive" ? yellow_(`[${op.operationClass}]`) : dim_(`[${op.operationClass}]`);
+			lines.push(`${dim_(treeChar)}─ ${op.label} ${opClassLabel}`);
+		}
+		if (result.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${yellow_("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+		lines.push("");
+	}
+	lines.push(dim_(`from:   ${result.from}`));
+	lines.push(dim_(`to:     ${result.to}`));
+	if (result.migrationId) lines.push(dim_(`migrationId: ${result.migrationId}`));
+	if (result.dir) lines.push(dim_(`dir:    ${result.dir}`));
+	if (result.sql && result.sql.length > 0) {
+		lines.push("");
+		lines.push(dim_("DDL preview"));
+		lines.push("");
+		for (const statement of result.sql) {
+			const trimmed = statement.trim();
+			if (!trimmed) continue;
+			const line = trimmed.endsWith(";") ? trimmed : `${trimmed};`;
+			lines.push(line);
+		}
+	}
+	if (flags.verbose && result.timings) {
+		lines.push("");
+		lines.push(dim_(`Total time: ${result.timings.total}ms`));
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+export { createMigrationPlanCommand };
+//# sourceMappingURL=migration-plan.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-plan.mjs","names":["details: Array<{ label: string; value: string }>","contractJsonContent: string","toContractJson: ContractIR","fromContract: ContractIR | null","fromHash: string","parentMigrationId: string | null","ops: readonly MigrationPlanOperation[]","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 type {\n  ControlTargetDescriptor,\n  MigrationPlanOperation,\n} from '@prisma-next/core-control-plane/types';\nimport { attestMigration } from '@prisma-next/migration-tools/attestation';\nimport { findLatestMigration, reconstructGraph } from '@prisma-next/migration-tools/dag';\nimport {\n  formatMigrationDirName,\n  readMigrationsDir,\n  writeMigrationPackage,\n} 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, resolve } 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 { resolveContractPath, setCommandDescriptions } from '../utils/command-helpers';\nimport { assertFrameworkComponentsCompatible } from '../utils/framework-components';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { formatCommandHelp, formatStyledHeader } from '../utils/output';\nimport { handleResult } from '../utils/result-handler';\n\ninterface MigrationPlanOptions {\n  readonly config?: string;\n  readonly name?: string;\n  readonly from?: string;\n  readonly json?: string | boolean;\n  readonly quiet?: boolean;\n  readonly q?: boolean;\n  readonly verbose?: boolean;\n  readonly v?: boolean;\n  readonly vv?: boolean;\n  readonly trace?: boolean;\n  readonly timestamps?: boolean;\n  readonly color?: boolean;\n  readonly 'no-color'?: boolean;\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  startTime: number,\n): Promise<Result<MigrationPlanResult, 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  const contractPathAbsolute = resolveContractPath(config);\n  const contractPath = relative(process.cwd(), contractPathAbsolute);\n\n  if (flags.json !== 'object' && !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    console.log(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  let parentMigrationId: string | null = null;\n\n  try {\n    const allPackages = await readMigrationsDir(migrationsDir);\n    const packages = allPackages.filter((p) => typeof p.manifest.migrationId === 'string');\n    const graph = reconstructGraph(packages);\n    const latestMigration = findLatestMigration(graph);\n    const leafHash = latestMigration ? latestMigration.to : EMPTY_CONTRACT_HASH;\n\n    if (options.from) {\n      fromHash = options.from;\n      const sourcePkg = packages.find((p) => p.manifest.to === fromHash);\n      if (!sourcePkg) {\n        return notOk(\n          errorRuntime('Starting contract not found', {\n            why: `No migration with to=\"${fromHash}\" 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      fromContract = sourcePkg.manifest.toContract;\n      parentMigrationId = sourcePkg.manifest.migrationId;\n    } else if (leafHash !== EMPTY_CONTRACT_HASH && latestMigration) {\n      fromHash = leafHash;\n      parentMigrationId = latestMigration.migrationId;\n      const leafPkg = packages.find((p) => p.manifest.migrationId === latestMigration.migrationId);\n      if (leafPkg) {\n        fromContract = leafPkg.manifest.toContract;\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 targetWithMigrations = config.target as ControlTargetDescriptor<string, string>;\n  if (!targetWithMigrations.migrations) {\n    return notOk(\n      errorTargetMigrationNotSupported({\n        why: `Target \"${config.target.id}\" does not support migrations`,\n      }),\n    );\n  }\n\n  // Plan migration using the same planner as db init\n  const { migrations } = targetWithMigrations;\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);\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  const ops: readonly MigrationPlanOperation[] = plannerResult.plan.operations;\n\n  if (ops.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    parentMigrationId,\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, ops);\n    const migrationId = await attestMigration(packageDir);\n\n    const sql = extractSqlDdl(ops);\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: ops.map((op) => ({\n        id: op.id,\n        label: op.label,\n        operationClass: op.operationClass,\n      })),\n      sql,\n      summary: `Planned ${ops.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  command\n    .configureHelp({\n      formatHelp: (cmd) => {\n        const flags = parseGlobalFlags({});\n        return formatCommandHelp({ command: cmd, flags });\n      },\n    })\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    .option('--json [format]', 'Output as JSON (object)', false)\n    .option('-q, --quiet', 'Quiet mode: errors only')\n    .option('-v, --verbose', 'Verbose output: debug info, timings')\n    .option('-vv, --trace', 'Trace output: deep internals, stack traces')\n    .option('--timestamps', 'Add timestamps to output')\n    .option('--color', 'Force color output')\n    .option('--no-color', 'Disable color output')\n    .action(async (options: MigrationPlanOptions) => {\n      const flags = parseGlobalFlags(options);\n      const startTime = Date.now();\n\n      const result = await executeMigrationPlanCommand(options, flags, startTime);\n\n      const exitCode = handleResult(result, flags, (planResult) => {\n        if (flags.json === 'object') {\n          console.log(JSON.stringify(planResult, null, 2));\n        } else if (!flags.quiet) {\n          console.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"],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+import { Command } from "commander";
+import { CliStructuredError } from "@prisma-next/core-control-plane/errors";
+import { Result } from "@prisma-next/utils/result";
+import { MigrationPackage } from "@prisma-next/migration-tools/types";
+
+//#region src/commands/migration-show.d.ts
+interface MigrationShowResult {
+  readonly ok: true;
+  readonly dirName: string;
+  readonly dirPath: string;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationId: string | null;
+  readonly kind: string;
+  readonly createdAt: string;
+  readonly operations: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly operationClass: string;
+  }[];
+  readonly sql: readonly string[];
+  readonly summary: string;
+}
+declare function resolveByHashPrefix(packages: readonly MigrationPackage[], prefix: string): Result<MigrationPackage, CliStructuredError>;
+declare function createMigrationShowCommand(): Command;
+//#endregion
+export { MigrationShowResult, createMigrationShowCommand, resolveByHashPrefix };
+//# sourceMappingURL=migration-show.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-show.d.mts","names":[],"sources":["../../src/commands/migration-show.ts"],"sourcesContent":[],"mappings":";;;;;;UA8BiB,mBAAA;;EAAA,SAAA,OAAA,EAAA,MAAmB;EAsBpB,SAAA,OAAA,EAAA,MAAmB;EACd,SAAA,IAAA,EAAA,MAAA;EAEX,SAAA,EAAA,EAAA,MAAA;EAAkB,SAAA,WAAA,EAAA,MAAA,GAAA,IAAA;EAAzB,SAAA,IAAA,EAAA,MAAA;EAAM,SAAA,SAAA,EAAA,MAAA;EA0JO,SAAA,UAAA,EAAA,SAA0B;;;;;;;;iBA7J1B,mBAAA,oBACK,qCAElB,OAAO,kBAAkB;iBA0JZ,0BAAA,CAAA,GAA8B"}

package/dist/commands/migration-show.mjs

@@ -0,0 +1,138 @@
+import { t as loadConfig } from "../config-loader-PPf4CtDj.mjs";
+import { _ as errorUnexpected, m as errorRuntime } from "../cli-errors-JlPTsazx.mjs";
+import { t as extractSqlDdl } from "../extract-sql-ddl-BmlKvk4o.mjs";
+import { C as parseGlobalFlags, D as setCommandDescriptions, d as formatMigrationShowOutput, n as formatCommandHelp, t as handleResult, y as formatStyledHeader } from "../result-handler-iA9JtUC7.mjs";
+import { Command } from "commander";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { relative, resolve } from "pathe";
+import { findLatestMigration, reconstructGraph } from "@prisma-next/migration-tools/dag";
+import { readMigrationPackage, readMigrationsDir } from "@prisma-next/migration-tools/io";
+import { MigrationToolsError } from "@prisma-next/migration-tools/types";
+
+//#region src/commands/migration-show.ts
+function looksLikePath(target) {
+	return target.includes("/") || target.includes("\\");
+}
+function resolveByHashPrefix(packages, prefix) {
+	const normalizedPrefix = prefix.startsWith("sha256:") ? prefix : `sha256:${prefix}`;
+	const matches = packages.filter((p) => typeof p.manifest.migrationId === "string").filter((p) => p.manifest.migrationId.startsWith(normalizedPrefix));
+	if (matches.length === 1) return ok(matches[0]);
+	if (matches.length === 0) return notOk(errorRuntime("No migration found matching prefix", {
+		why: `No attested migration has a migrationId starting with "${normalizedPrefix}"`,
+		fix: "Run `prisma-next migration show` (no argument) to see the latest migration, or check the migrations directory for available packages."
+	}));
+	return notOk(errorRuntime("Ambiguous hash prefix", {
+		why: `Multiple migrations match prefix "${normalizedPrefix}":\n${matches.map((p) => `  ${p.dirName}  ${p.manifest.migrationId}`).join("\n")}`,
+		fix: "Provide a longer prefix to uniquely identify the migration."
+	}));
+}
+async function executeMigrationShowCommand(target, options, flags) {
+	const config = await loadConfig(options.config);
+	const configPath = options.config ? relative(process.cwd(), resolve(options.config)) : "prisma-next.config.ts";
+	const migrationsDir = resolve(options.config ? resolve(options.config, "..") : process.cwd(), config.migrations?.dir ?? "migrations");
+	const migrationsRelative = relative(process.cwd(), migrationsDir);
+	if (flags.json !== "object" && !flags.quiet) {
+		const details = [{
+			label: "config",
+			value: configPath
+		}, {
+			label: "migrations",
+			value: migrationsRelative
+		}];
+		if (target) details.push({
+			label: "target",
+			value: target
+		});
+		const header = formatStyledHeader({
+			command: "migration show",
+			description: "Display migration package contents",
+			details,
+			flags
+		});
+		console.log(header);
+	}
+	let pkg;
+	try {
+		if (target && looksLikePath(target)) pkg = await readMigrationPackage(resolve(target));
+		else {
+			const allPackages = await readMigrationsDir(migrationsDir);
+			if (allPackages.length === 0) return notOk(errorRuntime("No migrations found", {
+				why: `No migration packages found in ${migrationsRelative}`,
+				fix: "Run `prisma-next migration plan` to create a migration first."
+			}));
+			if (target) {
+				const resolved = resolveByHashPrefix(allPackages, target);
+				if (!resolved.ok) return resolved;
+				pkg = resolved.value;
+			} else {
+				const attested = allPackages.filter((p) => typeof p.manifest.migrationId === "string");
+				if (attested.length === 0) return notOk(errorRuntime("No attested migrations found", {
+					why: `All migrations in ${migrationsRelative} are drafts (migrationId: null)`,
+					fix: "Run `prisma-next migration verify --dir <path>` to attest a draft migration."
+				}));
+				const latestMigration = findLatestMigration(reconstructGraph(attested));
+				if (!latestMigration) return notOk(errorRuntime("Could not resolve latest migration", {
+					why: "No latest migration found in the migration chain",
+					fix: "The migrations directory may be corrupted. Inspect the migration.json files."
+				}));
+				const leafPkg = attested.find((p) => p.manifest.migrationId === latestMigration.migrationId);
+				if (!leafPkg) return notOk(errorRuntime("Could not resolve latest migration", {
+					why: `Latest migration ${latestMigration.dirName} does not match any package`,
+					fix: "The migrations directory may be corrupted. Inspect the migration.json files."
+				}));
+				pkg = leafPkg;
+			}
+		}
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(errorRuntime(error.message, {
+			why: error.why,
+			fix: error.fix,
+			meta: {
+				code: error.code,
+				...error.details ?? {}
+			}
+		}));
+		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to read migration: ${error instanceof Error ? error.message : String(error)}` }));
+	}
+	const ops = pkg.ops;
+	const sql = extractSqlDdl(ops);
+	return ok({
+		ok: true,
+		dirName: pkg.dirName,
+		dirPath: relative(process.cwd(), pkg.dirPath),
+		from: pkg.manifest.from,
+		to: pkg.manifest.to,
+		migrationId: pkg.manifest.migrationId,
+		kind: pkg.manifest.kind,
+		createdAt: pkg.manifest.createdAt,
+		operations: ops.map((op) => ({
+			id: op.id,
+			label: op.label,
+			operationClass: op.operationClass
+		})),
+		sql,
+		summary: `${ops.length} operation(s)`
+	});
+}
+function createMigrationShowCommand() {
+	const command = new Command("show");
+	setCommandDescriptions(command, "Display migration package contents", "Shows the operations, DDL preview, and metadata for a migration package.\nAccepts a directory path, a hash prefix (git-style), or defaults to the\nlatest migration.");
+	command.configureHelp({ formatHelp: (cmd) => {
+		return formatCommandHelp({
+			command: cmd,
+			flags: parseGlobalFlags({})
+		});
+	} }).argument("[target]", "Migration directory path or migrationId hash prefix (defaults to latest)").option("--config <path>", "Path to prisma-next.config.ts").option("--json [format]", "Output as JSON (object)", false).option("-q, --quiet", "Quiet mode: errors only").option("-v, --verbose", "Verbose output").option("-vv, --trace", "Trace output").option("--timestamps", "Add timestamps to output").option("--color", "Force color output").option("--no-color", "Disable color output").action(async (target, options) => {
+		const flags = parseGlobalFlags(options);
+		const exitCode = handleResult(await executeMigrationShowCommand(target, options, flags), flags, (showResult) => {
+			if (flags.json === "object") console.log(JSON.stringify(showResult, null, 2));
+			else if (!flags.quiet) console.log(formatMigrationShowOutput(showResult, flags));
+		});
+		process.exit(exitCode);
+	});
+	return command;
+}
+
+//#endregion
+export { createMigrationShowCommand, resolveByHashPrefix };
+//# sourceMappingURL=migration-show.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-show.mjs","names":["details: Array<{ label: string; value: string }>","pkg: MigrationPackage"],"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 { MigrationPackage } 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';\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 { setCommandDescriptions } from '../utils/command-helpers';\nimport { type GlobalFlags, parseGlobalFlags } from '../utils/global-flags';\nimport { formatCommandHelp, formatMigrationShowOutput, formatStyledHeader } from '../utils/output';\nimport { handleResult } from '../utils/result-handler';\n\ninterface MigrationShowOptions {\n  readonly config?: string;\n  readonly json?: string | boolean;\n  readonly quiet?: boolean;\n  readonly q?: boolean;\n  readonly verbose?: boolean;\n  readonly v?: boolean;\n  readonly vv?: boolean;\n  readonly trace?: boolean;\n  readonly timestamps?: boolean;\n  readonly color?: boolean;\n  readonly 'no-color'?: boolean;\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 MigrationPackage[],\n  prefix: string,\n): Result<MigrationPackage, 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): 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 !== 'object' && !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    console.log(header);\n  }\n\n  let pkg: MigrationPackage;\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((p) => typeof p.manifest.migrationId === 'string');\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  command\n    .configureHelp({\n      formatHelp: (cmd) => {\n        const defaultFlags = parseGlobalFlags({});\n        return formatCommandHelp({ command: cmd, flags: defaultFlags });\n      },\n    })\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    .option('--json [format]', 'Output as JSON (object)', false)\n    .option('-q, --quiet', 'Quiet mode: errors only')\n    .option('-v, --verbose', 'Verbose output')\n    .option('-vv, --trace', 'Trace output')\n    .option('--timestamps', 'Add timestamps to output')\n    .option('--color', 'Force color output')\n    .option('--no-color', 'Disable color output')\n    .action(async (target: string | undefined, options: MigrationShowOptions) => {\n      const flags = parseGlobalFlags(options);\n\n      const result = await executeMigrationShowCommand(target, options, flags);\n\n      const exitCode = handleResult(result, flags, (showResult) => {\n        if (flags.json === 'object') {\n          console.log(JSON.stringify(showResult, null, 2));\n        } else if (!flags.quiet) {\n          console.log(formatMigrationShowOutput(showResult, flags));\n        }\n      });\n\n      process.exit(exitCode);\n    });\n\n  return command;\n}\n"],"mappings":";;;;;;;;;;;;AAgDA,SAAS,cAAc,QAAyB;AAC9C,QAAO,OAAO,SAAS,IAAI,IAAI,OAAO,SAAS,KAAK;;AAGtD,SAAgB,oBACd,UACA,QAC8C;CAC9C,MAAM,mBAAmB,OAAO,WAAW,UAAU,GAAG,SAAS,UAAU;CAE3E,MAAM,UADW,SAAS,QAAQ,MAAM,OAAO,EAAE,SAAS,gBAAgB,SAAS,CAC1D,QAAQ,MAAM,EAAE,SAAS,YAAa,WAAW,iBAAiB,CAAC;AAE5F,KAAI,QAAQ,WAAW,EACrB,QAAO,GAAG,QAAQ,GAAI;AAGxB,KAAI,QAAQ,WAAW,EACrB,QAAO,MACL,aAAa,sCAAsC;EACjD,KAAK,0DAA0D,iBAAiB;EAChF,KAAK;EACN,CAAC,CACH;AAIH,QAAO,MACL,aAAa,yBAAyB;EACpC,KAAK,qCAAqC,iBAAiB,MAH5C,QAAQ,KAAK,MAAM,KAAK,EAAE,QAAQ,IAAI,EAAE,SAAS,cAAc,CAAC,KAAK,KAAK;EAIzF,KAAK;EACN,CAAC,CACH;;AAGH,eAAe,4BACb,QACA,SACA,OAC0D;CAC1D,MAAM,SAAS,MAAM,WAAW,QAAQ,OAAO;CAC/C,MAAM,aAAa,QAAQ,SACvB,SAAS,QAAQ,KAAK,EAAE,QAAQ,QAAQ,OAAO,CAAC,GAChD;CAEJ,MAAM,gBAAgB,QACpB,QAAQ,SAAS,QAAQ,QAAQ,QAAQ,KAAK,GAAG,QAAQ,KAAK,EAC9D,OAAO,YAAY,OAAO,aAC3B;CACD,MAAM,qBAAqB,SAAS,QAAQ,KAAK,EAAE,cAAc;AAEjE,KAAI,MAAM,SAAS,YAAY,CAAC,MAAM,OAAO;EAC3C,MAAMA,UAAmD,CACvD;GAAE,OAAO;GAAU,OAAO;GAAY,EACtC;GAAE,OAAO;GAAc,OAAO;GAAoB,CACnD;AACD,MAAI,OACF,SAAQ,KAAK;GAAE,OAAO;GAAU,OAAO;GAAQ,CAAC;EAElD,MAAM,SAAS,mBAAmB;GAChC,SAAS;GACT,aAAa;GACb;GACA;GACD,CAAC;AACF,UAAQ,IAAI,OAAO;;CAGrB,IAAIC;AAEJ,KAAI;AACF,MAAI,UAAU,cAAc,OAAO,CACjC,OAAM,MAAM,qBAAqB,QAAQ,OAAO,CAAC;OAC5C;GACL,MAAM,cAAc,MAAM,kBAAkB,cAAc;AAC1D,OAAI,YAAY,WAAW,EACzB,QAAO,MACL,aAAa,uBAAuB;IAClC,KAAK,kCAAkC;IACvC,KAAK;IACN,CAAC,CACH;AAGH,OAAI,QAAQ;IACV,MAAM,WAAW,oBAAoB,aAAa,OAAO;AACzD,QAAI,CAAC,SAAS,GAAI,QAAO;AACzB,UAAM,SAAS;UACV;IACL,MAAM,WAAW,YAAY,QAAQ,MAAM,OAAO,EAAE,SAAS,gBAAgB,SAAS;AACtF,QAAI,SAAS,WAAW,EACtB,QAAO,MACL,aAAa,gCAAgC;KAC3C,KAAK,qBAAqB,mBAAmB;KAC7C,KAAK;KACN,CAAC,CACH;IAGH,MAAM,kBAAkB,oBADV,iBAAiB,SAAS,CACU;AAClD,QAAI,CAAC,gBACH,QAAO,MACL,aAAa,sCAAsC;KACjD,KAAK;KACL,KAAK;KACN,CAAC,CACH;IAEH,MAAM,UAAU,SAAS,MACtB,MAAM,EAAE,SAAS,gBAAgB,gBAAgB,YACnD;AACD,QAAI,CAAC,QACH,QAAO,MACL,aAAa,sCAAsC;KACjD,KAAK,oBAAoB,gBAAgB,QAAQ;KACjD,KAAK;KACN,CAAC,CACH;AAEH,UAAM;;;UAGH,OAAO;AACd,MAAI,oBAAoB,GAAG,MAAM,CAC/B,QAAO,MACL,aAAa,MAAM,SAAS;GAC1B,KAAK,MAAM;GACX,KAAK,MAAM;GACX,MAAM;IAAE,MAAM,MAAM;IAAM,GAAI,MAAM,WAAW,EAAE;IAAG;GACrD,CAAC,CACH;AAEH,SAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,EAAE,EACtE,KAAK,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACzF,CAAC,CACH;;CAGH,MAAM,MAAM,IAAI;CAChB,MAAM,MAAM,cAAc,IAAI;AAmB9B,QAAO,GAjB6B;EAClC,IAAI;EACJ,SAAS,IAAI;EACb,SAAS,SAAS,QAAQ,KAAK,EAAE,IAAI,QAAQ;EAC7C,MAAM,IAAI,SAAS;EACnB,IAAI,IAAI,SAAS;EACjB,aAAa,IAAI,SAAS;EAC1B,MAAM,IAAI,SAAS;EACnB,WAAW,IAAI,SAAS;EACxB,YAAY,IAAI,KAAK,QAAQ;GAC3B,IAAI,GAAG;GACP,OAAO,GAAG;GACV,gBAAgB,GAAG;GACpB,EAAE;EACH;EACA,SAAS,GAAG,IAAI,OAAO;EACxB,CACgB;;AAGnB,SAAgB,6BAAsC;CACpD,MAAM,UAAU,IAAI,QAAQ,OAAO;AACnC,wBACE,SACA,sCACA,uKAGD;AACD,SACG,cAAc,EACb,aAAa,QAAQ;AAEnB,SAAO,kBAAkB;GAAE,SAAS;GAAK,OADpB,iBAAiB,EAAE,CAAC;GACqB,CAAC;IAElE,CAAC,CACD,SACC,YACA,2EACD,CACA,OAAO,mBAAmB,gCAAgC,CAC1D,OAAO,mBAAmB,2BAA2B,MAAM,CAC3D,OAAO,eAAe,0BAA0B,CAChD,OAAO,iBAAiB,iBAAiB,CACzC,OAAO,gBAAgB,eAAe,CACtC,OAAO,gBAAgB,2BAA2B,CAClD,OAAO,WAAW,qBAAqB,CACvC,OAAO,cAAc,uBAAuB,CAC5C,OAAO,OAAO,QAA4B,YAAkC;EAC3E,MAAM,QAAQ,iBAAiB,QAAQ;EAIvC,MAAM,WAAW,aAFF,MAAM,4BAA4B,QAAQ,SAAS,MAAM,EAElC,QAAQ,eAAe;AAC3D,OAAI,MAAM,SAAS,SACjB,SAAQ,IAAI,KAAK,UAAU,YAAY,MAAM,EAAE,CAAC;YACvC,CAAC,MAAM,MAChB,SAAQ,IAAI,0BAA0B,YAAY,MAAM,CAAC;IAE3D;AAEF,UAAQ,KAAK,SAAS;GACtB;AAEJ,QAAO"}

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

@@ -0,0 +1,35 @@
+import { Command } from "commander";
+import { MigrationChainEntry, MigrationPackage } from "@prisma-next/migration-tools/types";
+
+//#region src/commands/migration-status.d.ts
+interface MigrationStatusEntry {
+  readonly dirName: string;
+  readonly from: string;
+  readonly to: string;
+  readonly migrationId: string | null;
+  readonly operationCount: number;
+  readonly operationSummary: string;
+  readonly hasDestructive: boolean;
+  readonly status: 'applied' | 'pending' | 'unknown';
+}
+interface StatusDiagnostic {
+  readonly code: string;
+  readonly severity: 'warn' | 'info';
+  readonly message: string;
+  readonly hints: readonly string[];
+}
+interface MigrationStatusResult {
+  readonly ok: true;
+  readonly mode: 'online' | 'offline';
+  readonly migrations: readonly MigrationStatusEntry[];
+  readonly markerHash?: string;
+  readonly leafHash: string;
+  readonly contractHash: string;
+  readonly summary: string;
+  readonly diagnostics: readonly StatusDiagnostic[];
+}
+declare function buildMigrationEntries(chain: readonly MigrationChainEntry[], packages: readonly MigrationPackage[], markerHash: string | undefined): MigrationStatusEntry[];
+declare function createMigrationStatusCommand(): Command;
+//#endregion
+export { MigrationStatusEntry, MigrationStatusResult, StatusDiagnostic, buildMigrationEntries, createMigrationStatusCommand };
+//# sourceMappingURL=migration-status.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-status.d.mts","names":[],"sources":["../../src/commands/migration-status.ts"],"sourcesContent":[],"mappings":";;;;UA6CiB,oBAAA;;EAAA,SAAA,IAAA,EAAA,MAAA;EAWA,SAAA,EAAA,EAAA,MAAgB;EAOhB,SAAA,WAAA,EAAA,MAAqB,GAAA,IAGN;EAqChB,SAAA,cAAA,EAAqB,MAAA;EACnB,SAAA,gBAAA,EAAA,MAAA;EACG,SAAA,cAAA,EAAA,OAAA;EAElB,SAAA,MAAA,EAAA,SAAA,GAAA,SAAA,GAAA,SAAA;;AA8Ra,UAjVC,gBAAA,CAiVD;;;;;;UA1UC,qBAAA;;;gCAGe;;;;;iCAKC;;iBAgCjB,qBAAA,iBACE,0CACG,qDAElB;iBA8Ra,4BAAA,CAAA,GAAgC"}