prisma-next 0.11.0-dev.7 → 0.11.0-dev.70

package/dist/{migration-plan-C2jeH1J5.mjs → migration-plan-DHLa2Khm.mjs}

@@ -1,23 +1,23 @@
 import { t as loadConfig } from "./config-loader-B6sJjXTv.mjs";
-import { _ as errorTargetMigrationNotSupported, a as errorContractValidationFailed, b as mapMigrationToolsError, l as errorFileNotFound, p as errorMigrationPlanningFailed, t as CliStructuredError, x as mapRefResolutionError, y as errorUnexpected } from "./cli-errors-Djtz98Vm.mjs";
-import { t as assertFrameworkComponentsCompatible } from "./framework-components-65gOHkHB.mjs";
-import { t as createTerminalUI } from "./terminal-ui-BiB_8KNo.mjs";
-import { S as formatStyledHeader, a as loadMigrationPackages, c as resolveContractPath, d as setCommandDescriptions, f as setCommandExamples, i as getTargetMigrations, l as resolveMigrationPaths, t as addGlobalOptions, v as parseGlobalFlagsOrExit, y as handleResult } from "./command-helpers-DtavI0wJ.mjs";
-import { n as toExtensionInputs, t as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-BmNQwlws.mjs";
+import { $ as errorTargetMigrationNotSupported, A as CliStructuredError, G as errorPlanForgotTheFlag, P as errorContractValidationFailed, R as errorFileNotFound, T as formatStyledHeader, U as errorMigrationPlanningFailed, Z as errorSnapshotMissing, _ as createTerminalUI, g as parseGlobalFlagsOrExit, l as setCommandDescriptions, nt as mapMigrationToolsError, o as resolveContractPath, r as getTargetMigrations, rt as mapRefResolutionError, s as resolveMigrationPaths, t as addGlobalOptions, tt as errorUnexpected, u as setCommandExamples, y as handleResult } from "./command-helpers-CoceqqMl.mjs";
+import { t as assertFrameworkComponentsCompatible } from "./framework-components-R_O3y5IW.mjs";
+import { n as toExtensionInputs } from "./extension-pack-inputs-IDvjRCi3.mjs";
+import { a as loadContractSpaceAggregateForCli, n as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-lafgkTwG.mjs";
+import { t as mapContractAtError } from "./contract-at-errors-Bhf2jnkp.mjs";
 import { Command } from "commander";
 import { getEmittedArtifactPaths } from "@prisma-next/emitter";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { join, relative } from "pathe";
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { createControlStack, hasOperationPreview } from "@prisma-next/framework-components/control";
-import { copyFilesWithRename, formatMigrationDirName, materialiseExtensionMigrationPackageIfMissing, writeMigrationPackage } from "@prisma-next/migration-tools/io";
-import { findLatestMigration } from "@prisma-next/migration-tools/migration-graph";
 import { emitContractSpaceArtefacts, planAllSpaces, readContractSpaceHeadRef, spaceMigrationDirectory } from "@prisma-next/migration-tools/spaces";
 import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
+import { assertHashIsGraphNode, findLatestMigration, isGraphNode } from "@prisma-next/migration-tools/migration-graph";
 import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
-import { readRefs } from "@prisma-next/migration-tools/refs";
 import { computeMigrationHash } from "@prisma-next/migration-tools/hash";
+import { copyFilesWithRename, formatMigrationDirName, materialiseExtensionMigrationPackageIfMissing, writeMigrationPackage } from "@prisma-next/migration-tools/io";
 import { writeMigrationTs } from "@prisma-next/migration-tools/migration-ts";
+import { canonicalizeJson } from "@prisma-next/framework-components/utils";
 import { deriveProvidedInvariants } from "@prisma-next/migration-tools/invariants";
 //#region src/utils/contract-space-seed-phase.ts
 /**
@@ -109,44 +109,203 @@ function buildPlaceholderContractDts(spaceId) {
 	].join("\n");
 }
 //#endregion
-//#region src/commands/migration-plan.ts
-/**
-* Load a predecessor migration's destination contract from its sibling
-* `end-contract.json` on disk and route it through the family's
-* `ContractSerializer` (via `deserializeContract`) so the in-memory shape
-* is the hydrated `Contract` every other caller sees. Bypassing this
-* seam was the root cause of TML-2536: a raw `JSON.parse(...) as Contract`
-* here let polymorphic `storage.types` entries reach the planner without
-* the `kind` discriminator the planner dispatches on.
-*
-* Throws `CliStructuredError` with:
-*   - `errorFileNotFound` when the sibling file is missing — the user
-*     has likely deleted or never authored the snapshot, and the
-*     message names the file and points them at re-emitting from the
-*     source.
-*   - `errorContractValidationFailed` when the JSON parses but the
-*     family deserializer rejects it (legacy untagged shape, structural
-*     mismatch, etc.) — the message names the predecessor's path so
-*     the operator can locate the bad snapshot.
-*/
-async function readPredecessorEndContract(migrationDir, familyInstance) {
-	const path = join(migrationDir, "end-contract.json");
-	let raw;
+//#region src/utils/plan-resolution.ts
+const FULL_HASH_PATTERN = /^sha256:([0-9a-f]{64}|empty)$/;
+function looksLikeFullHash(input) {
+	return FULL_HASH_PATTERN.test(input);
+}
+function graphIsEmpty(member) {
+	return member.packages.length === 0;
+}
+function getReachableRefs(refs, graph) {
+	return Object.entries(refs).flatMap(([name, entry]) => entry && isGraphNode(entry.hash, graph) ? [{
+		name,
+		hash: entry.hash
+	}] : []).sort((a, b) => a.name.localeCompare(b.name));
+}
+function assertFromIsGraphNode(fromHash, graph, refs, graphTipHash) {
 	try {
-		raw = await readFile(path, "utf-8");
+		assertHashIsGraphNode(fromHash, graph);
 	} catch (error) {
-		if (error instanceof Error && error.code === "ENOENT") throw errorFileNotFound(path, {
-			why: `Predecessor migration is missing its destination contract snapshot at ${path}`,
-			fix: "Re-emit the predecessor migration (`prisma-next migration plan` from its source) so its sibling `end-contract.json` is restored, then re-run this command."
-		});
+		if (MigrationToolsError.is(error) && error.code === "MIGRATION.HASH_NOT_IN_GRAPH") throw errorPlanForgotTheFlag(fromHash, getReachableRefs(refs, graph), graphTipHash);
 		throw error;
 	}
+}
+async function resolveContractRef(parsed, member, options) {
+	const { hash, provenance } = parsed;
+	const refName = provenance.kind === "ref" ? provenance.refName : void 0;
+	try {
+		const at = await member.contractAt(hash, refName !== void 0 ? { refName } : void 0);
+		if (at.provenance === "snapshot") return ok({
+			kind: "snapshot",
+			hash: at.hash,
+			contract: at.contract,
+			contractJson: at.contractJson,
+			contractDts: at.contractDts
+		});
+		return ok({
+			kind: "graph-node",
+			hash: at.hash,
+			contract: at.contract,
+			contractJson: at.contractJson,
+			contractDts: at.contractDts,
+			sourceDir: at.sourceDir
+		});
+	} catch (error) {
+		return mapContractAtError(error, options?.artifactRole !== void 0 ? { artifactRole: options.artifactRole } : void 0);
+	}
+}
+async function resolveFromPolicy(parsed, input, refs, explicitFromLabel) {
+	const resolution = await resolveContractRef(parsed, input.member, {
+		...explicitFromLabel !== void 0 ? { explicitLabel: explicitFromLabel } : {},
+		artifactRole: "from"
+	});
+	if (!resolution.ok) return resolution;
+	if (resolution.value.kind === "graph-node") return ok({
+		kind: "graph-node",
+		fromHash: resolution.value.hash,
+		fromContract: resolution.value.contract,
+		sourceDir: resolution.value.sourceDir
+	});
+	const { hash, contract, contractJson, contractDts } = resolution.value;
+	if (graphIsEmpty(input.member)) return ok({
+		kind: "auto-baseline",
+		fromHash: hash,
+		fromContract: contract,
+		contractDts,
+		contractJson
+	});
+	const graph = input.member.graph();
+	const graphTip = findLatestMigration(graph)?.to ?? null;
 	try {
-		return familyInstance.deserializeContract(JSON.parse(raw));
+		assertFromIsGraphNode(hash, graph, refs, graphTip);
 	} catch (error) {
-		if (CliStructuredError.is(error)) throw error;
-		throw errorContractValidationFailed(`Predecessor contract at ${path} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`, { where: { path } });
+		if (CliStructuredError.is(error)) return notOk(error);
+		throw error;
+	}
+	return ok({
+		kind: "snapshot",
+		fromHash: hash,
+		fromContract: contract,
+		contractDts,
+		contractJson
+	});
+}
+async function resolveFromForPlan(input) {
+	const { optionsFrom, member } = input;
+	const graph = member.graph();
+	const refs = member.refs;
+	if (optionsFrom === void 0) {
+		const dbRef = refs["db"];
+		if (!dbRef) return ok({
+			kind: "greenfield",
+			fromHash: null,
+			fromContract: null
+		});
+		return resolveFromPolicy({
+			hash: dbRef.hash,
+			provenance: {
+				kind: "ref",
+				refName: "db"
+			}
+		}, input, refs);
+	}
+	const refResult = parseContractRef(optionsFrom, {
+		graph,
+		refs
+	});
+	if (!refResult.ok) {
+		if (looksLikeFullHash(optionsFrom)) {
+			const empty = graphIsEmpty(member);
+			const graphTip = findLatestMigration(graph)?.to ?? null;
+			if (empty) return notOk(errorSnapshotMissing(optionsFrom, { viaRef: false }));
+			return notOk(errorPlanForgotTheFlag(optionsFrom, getReachableRefs(refs, graph), graphTip));
+		}
+		return notOk(mapRefResolutionError(refResult.failure));
+	}
+	return resolveFromPolicy(refResult.value, input, refs, optionsFrom);
+}
+async function resolveToForPlan(optionsTo, input) {
+	const { member } = input;
+	const graph = member.graph();
+	const refs = member.refs;
+	const refResult = parseContractRef(optionsTo, {
+		graph,
+		refs
+	});
+	if (!refResult.ok) return notOk(mapRefResolutionError(refResult.failure));
+	const resolution = await resolveContractRef(refResult.value, member, {
+		explicitLabel: optionsTo,
+		artifactRole: "to"
+	});
+	if (!resolution.ok) return resolution;
+	const { hash, contract, contractJson, contractDts } = resolution.value;
+	return ok({
+		hash,
+		contract,
+		contractJson,
+		contractDts
+	});
+}
+//#endregion
+//#region src/commands/migration-plan.ts
+async function writeSnapshotContractArtifacts(packageDir, contractJson, contractDts, artifactBasename) {
+	await mkdir(packageDir, { recursive: true });
+	const jsonContent = `${canonicalizeJson(contractJson)}\n`;
+	const dtsContent = contractDts.endsWith("\n") ? contractDts : `${contractDts}\n`;
+	await writeFile(join(packageDir, `${artifactBasename}.json`), jsonContent);
+	await writeFile(join(packageDir, `${artifactBasename}.d.ts`), dtsContent);
+}
+async function writeSnapshotStartContract(packageDir, contractJson, contractDts) {
+	await writeSnapshotContractArtifacts(packageDir, contractJson, contractDts, "start-contract");
+}
+async function runPlannerLeg(planner, migrations, frameworkComponents, contract, fromContract, spaceId) {
+	const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);
+	const plannerResult = planner.plan({
+		contract,
+		schema: fromSchema,
+		policy: { allowedOperationClasses: [
+			"additive",
+			"widening",
+			"destructive",
+			"data"
+		] },
+		fromContract,
+		frameworkComponents,
+		spaceId
+	});
+	if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
+	let plannedOps = [];
+	let hasPlaceholders = false;
+	try {
+		plannedOps = plannerResult.plan.operations;
+		if (plannedOps.length === 0) return notOk(errorMigrationPlanningFailed({ conflicts: [{
+			kind: "unsupportedChange",
+			summary: "Contract changed but planner produced no operations. This indicates unsupported or ignored changes."
+		}] }));
+	} catch (e) {
+		if (CliStructuredError.is(e) && e.domain === "MIG" && e.code === "2001") hasPlaceholders = true;
+		else throw e;
 	}
+	return ok({
+		plannedOps,
+		migrationTsContent: plannerResult.plan.renderTypeScript(),
+		hasPlaceholders
+	});
+}
+async function writePlannedMigrationPackage(packageDir, fromHash, toHash, createdAt, leg) {
+	const opsForWrite = leg.hasPlaceholders ? [] : leg.plannedOps;
+	const metadataWithInvariants = {
+		from: fromHash,
+		to: toHash,
+		providedInvariants: deriveProvidedInvariants(opsForWrite),
+		createdAt: createdAt.toISOString()
+	};
+	await writeMigrationPackage(packageDir, {
+		...metadataWithInvariants,
+		migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite)
+	}, opsForWrite);
+	await writeMigrationTs(packageDir, leg.migrationTsContent);
 }
 async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	const config = await loadConfig(options.config);
@@ -172,6 +331,10 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			label: "from",
 			value: options.from
 		});
+		if (options.to) details.push({
+			label: "to",
+			value: options.to
+		});
 		if (options.name) details.push({
 			label: "name",
 			value: options.name
@@ -205,43 +368,61 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	}
 	const rawStorageHash = toContract.storage?.storageHash;
 	if (typeof rawStorageHash !== "string") return notOk(errorContractValidationFailed("Contract is missing storageHash", { where: { path: contractPathAbsolute } }));
-	const toStorageHash = rawStorageHash;
+	let toStorageHash = rawStorageHash;
+	let toArtifacts = null;
 	let fromContract = null;
 	let fromHash = null;
 	let fromContractSourceDir = null;
-	try {
-		const { bundles, graph } = await loadMigrationPackages(appMigrationsDir);
-		if (options.from) {
-			const refs = await readRefs(resolveMigrationPaths(options.config, config).refsDir);
-			const refResult = parseContractRef(options.from, {
-				graph,
-				refs
-			});
-			if (!refResult.ok) return notOk(mapRefResolutionError(refResult.failure));
-			fromHash = refResult.value.hash;
-			const matchingBundle = bundles.find((p) => p.metadata.to === fromHash);
-			if (!matchingBundle) return notOk(errorUnexpected(`No migration bundle found for --from "${options.from}" (resolved hash: ${fromHash})`, {
-				why: `The ref resolved successfully but no on-disk migration package has an end-contract hash matching ${fromHash}.`,
-				fix: "Provide a ref or hash that corresponds to an existing migration package, or run `migration list` to see available migrations."
-			}));
-			fromContractSourceDir = matchingBundle.dirPath;
-			fromContract = await readPredecessorEndContract(fromContractSourceDir, familyInstance);
-		} else {
-			const latestMigration = findLatestMigration(graph);
-			if (latestMigration) {
-				fromHash = latestMigration.to;
-				const leafPkg = bundles.find((p) => p.metadata.migrationHash === latestMigration.migrationHash);
-				if (leafPkg) {
-					fromContractSourceDir = leafPkg.dirPath;
-					fromContract = await readPredecessorEndContract(fromContractSourceDir, familyInstance);
-				}
-			}
-		}
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		if (CliStructuredError.is(error)) return notOk(error);
-		const message = error instanceof Error ? error.message : String(error);
-		return notOk(errorUnexpected(message, { why: `Unexpected error while loading migrations: ${message}` }));
+	let snapshotStartContract = null;
+	let isAutoBaseline = false;
+	const tolerantAggregateResult = await loadContractSpaceAggregateForCli({
+		targetId: config.target.targetId,
+		migrationsDir,
+		appContract: toContract,
+		extensionPacks: config.extensionPacks ?? [],
+		deserializeContract: (json) => familyInstance.deserializeContract(json)
+	});
+	if (!tolerantAggregateResult.ok) return notOk(tolerantAggregateResult.failure);
+	const resolutionMember = tolerantAggregateResult.value.app;
+	const resolutionResult = await resolveFromForPlan({
+		optionsFrom: options.from,
+		member: resolutionMember
+	});
+	if (!resolutionResult.ok) return notOk(resolutionResult.failure);
+	switch (resolutionResult.value.kind) {
+		case "greenfield": break;
+		case "graph-node":
+			fromHash = resolutionResult.value.fromHash;
+			fromContract = resolutionResult.value.fromContract;
+			fromContractSourceDir = resolutionResult.value.sourceDir;
+			break;
+		case "snapshot":
+			fromHash = resolutionResult.value.fromHash;
+			fromContract = resolutionResult.value.fromContract;
+			snapshotStartContract = {
+				contractJson: resolutionResult.value.contractJson,
+				contractDts: resolutionResult.value.contractDts
+			};
+			break;
+		case "auto-baseline":
+			fromHash = resolutionResult.value.fromHash;
+			fromContract = resolutionResult.value.fromContract;
+			snapshotStartContract = {
+				contractJson: resolutionResult.value.contractJson,
+				contractDts: resolutionResult.value.contractDts
+			};
+			isAutoBaseline = true;
+			break;
+	}
+	if (options.to !== void 0) {
+		const toResolution = await resolveToForPlan(options.to, { member: resolutionMember });
+		if (!toResolution.ok) return notOk(toResolution.failure);
+		toContract = toResolution.value.contract;
+		toStorageHash = toResolution.value.hash;
+		toArtifacts = {
+			contractJson: toResolution.value.contractJson,
+			contractDts: toResolution.value.contractDts
+		};
 	}
 	const seedResult = await runContractSpaceSeedPhase({
 		migrationsDir,
@@ -257,7 +438,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 		spaceId: r.spaceId,
 		dirName
 	})));
-	if (fromHash === toStorageHash) return ok({
+	if (fromHash === toStorageHash && !isAutoBaseline) return ok({
 		ok: true,
 		noOp: true,
 		from: fromHash,
@@ -283,58 +464,11 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 		config.adapter,
 		...config.extensionPacks ?? []
 	]);
-	const timestamp = /* @__PURE__ */ new Date();
-	const packageDir = join(appMigrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
-	const baseMetadata = {
-		from: fromHash,
-		to: toStorageHash,
-		hints: {
-			used: [],
-			applied: [],
-			plannerVersion: "2.0.0"
-		},
-		labels: [],
-		createdAt: timestamp.toISOString()
-	};
-	try {
-		const planner = migrations.createPlanner(familyInstance);
-		const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);
-		const plannerResult = planner.plan({
-			contract: aggregate.app.contract,
-			schema: fromSchema,
-			policy: { allowedOperationClasses: [
-				"additive",
-				"widening",
-				"destructive",
-				"data"
-			] },
-			fromContract,
-			frameworkComponents,
-			spaceId: aggregate.app.spaceId
-		});
-		if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
-		let plannedOps = [];
-		let hasPlaceholders = false;
-		try {
-			plannedOps = plannerResult.plan.operations;
-			if (plannedOps.length === 0) return notOk(errorMigrationPlanningFailed({ conflicts: [{
-				kind: "unsupportedChange",
-				summary: "Contract changed but planner produced no operations. This indicates unsupported or ignored changes."
-			}] }));
-		} catch (e) {
-			if (CliStructuredError.is(e) && e.domain === "MIG" && e.code === "2001") hasPlaceholders = true;
-			else throw e;
+	async function writeDestinationEndContract(packageDir) {
+		if (toArtifacts !== null) {
+			await writeSnapshotContractArtifacts(packageDir, toArtifacts.contractJson, toArtifacts.contractDts, "end-contract");
+			return;
 		}
-		const migrationTsContent = plannerResult.plan.renderTypeScript();
-		const opsForWrite = hasPlaceholders ? [] : plannedOps;
-		const metadataWithInvariants = {
-			...baseMetadata,
-			providedInvariants: deriveProvidedInvariants(opsForWrite)
-		};
-		await writeMigrationPackage(packageDir, {
-			...metadataWithInvariants,
-			migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite)
-		}, opsForWrite);
 		const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
 		await copyFilesWithRename(packageDir, [{
 			sourcePath: destinationArtifacts.jsonPath,
@@ -343,6 +477,100 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			sourcePath: destinationArtifacts.dtsPath,
 			destName: "end-contract.d.ts"
 		}]);
+	}
+	try {
+		const planner = migrations.createPlanner(familyInstance);
+		if (isAutoBaseline && fromHash !== null && fromContract !== null && snapshotStartContract !== null) {
+			const baselineTimestamp = /* @__PURE__ */ new Date();
+			const deltaTimestamp = new Date(baselineTimestamp.getTime() + 6e4);
+			const baselineDirName = formatMigrationDirName(baselineTimestamp, "baseline");
+			const deltaDirName = formatMigrationDirName(deltaTimestamp, options.name ?? "migration");
+			const baselinePackageDir = join(appMigrationsDir, baselineDirName);
+			const deltaPackageDir = join(appMigrationsDir, deltaDirName);
+			const baselineLeg = await runPlannerLeg(planner, migrations, frameworkComponents, fromContract, null, aggregate.app.spaceId);
+			if (!baselineLeg.ok) return notOk(baselineLeg.failure);
+			await writePlannedMigrationPackage(baselinePackageDir, null, fromHash, baselineTimestamp, baselineLeg.value);
+			await writeSnapshotContractArtifacts(baselinePackageDir, snapshotStartContract.contractJson, snapshotStartContract.contractDts, "end-contract");
+			if (fromHash === toStorageHash) {
+				const baselineOps = baselineLeg.value.hasPlaceholders ? [] : baselineLeg.value.plannedOps;
+				if (baselineLeg.value.hasPlaceholders) {
+					const baselineDir = relative(process.cwd(), baselinePackageDir);
+					return ok({
+						ok: true,
+						noOp: false,
+						from: fromHash,
+						to: toStorageHash,
+						dir: baselineDir,
+						baselineDir,
+						operations: [],
+						emittedExtensionDirs,
+						pendingPlaceholders: true,
+						summary: "Planned baseline with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit",
+						timings: { total: Date.now() - startTime }
+					});
+				}
+				const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(baselineOps) : void 0;
+				return ok({
+					ok: true,
+					noOp: false,
+					from: fromHash,
+					to: toStorageHash,
+					baselineDir: relative(process.cwd(), baselinePackageDir),
+					operations: baselineOps.map((op) => ({
+						id: op.id,
+						label: op.label,
+						operationClass: op.operationClass
+					})),
+					emittedExtensionDirs,
+					...preview !== void 0 ? { preview } : {},
+					summary: buildAutoBaselinePlanSummary(0, emittedExtensionDirs.length),
+					timings: { total: Date.now() - startTime }
+				});
+			}
+			const deltaLeg = await runPlannerLeg(planner, migrations, frameworkComponents, aggregate.app.contract(), fromContract, aggregate.app.spaceId);
+			if (!deltaLeg.ok) return notOk(deltaLeg.failure);
+			await writePlannedMigrationPackage(deltaPackageDir, fromHash, toStorageHash, deltaTimestamp, deltaLeg.value);
+			await writeDestinationEndContract(deltaPackageDir);
+			await writeSnapshotStartContract(deltaPackageDir, snapshotStartContract.contractJson, snapshotStartContract.contractDts);
+			const deltaOps = deltaLeg.value.hasPlaceholders ? [] : deltaLeg.value.plannedOps;
+			if (deltaLeg.value.hasPlaceholders) return ok({
+				ok: true,
+				noOp: false,
+				from: fromHash,
+				to: toStorageHash,
+				dir: relative(process.cwd(), deltaPackageDir),
+				baselineDir: relative(process.cwd(), baselinePackageDir),
+				operations: [],
+				emittedExtensionDirs,
+				pendingPlaceholders: true,
+				summary: "Planned baseline + migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit",
+				timings: { total: Date.now() - startTime }
+			});
+			const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(deltaOps) : void 0;
+			return ok({
+				ok: true,
+				noOp: false,
+				from: fromHash,
+				to: toStorageHash,
+				dir: relative(process.cwd(), deltaPackageDir),
+				baselineDir: relative(process.cwd(), baselinePackageDir),
+				operations: deltaOps.map((op) => ({
+					id: op.id,
+					label: op.label,
+					operationClass: op.operationClass
+				})),
+				emittedExtensionDirs,
+				...preview !== void 0 ? { preview } : {},
+				summary: buildAutoBaselinePlanSummary(deltaOps.length, emittedExtensionDirs.length),
+				timings: { total: Date.now() - startTime }
+			});
+		}
+		const timestamp = /* @__PURE__ */ new Date();
+		const packageDir = join(appMigrationsDir, formatMigrationDirName(timestamp, options.name ?? "migration"));
+		const deltaLeg = await runPlannerLeg(planner, migrations, frameworkComponents, aggregate.app.contract(), fromContract, aggregate.app.spaceId);
+		if (!deltaLeg.ok) return notOk(deltaLeg.failure);
+		await writePlannedMigrationPackage(packageDir, fromHash, toStorageHash, timestamp, deltaLeg.value);
+		await writeDestinationEndContract(packageDir);
 		if (fromContractSourceDir !== null) {
 			const sourceArtifacts = getEmittedArtifactPaths(join(fromContractSourceDir, "end-contract.json"));
 			await copyFilesWithRename(packageDir, [{
@@ -352,9 +580,8 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 				sourcePath: sourceArtifacts.dtsPath,
 				destName: "start-contract.d.ts"
 			}]);
-		}
-		await writeMigrationTs(packageDir, migrationTsContent);
-		if (hasPlaceholders) return ok({
+		} else if (snapshotStartContract !== null) await writeSnapshotStartContract(packageDir, snapshotStartContract.contractJson, snapshotStartContract.contractDts);
+		if (deltaLeg.value.hasPlaceholders) return ok({
 			ok: true,
 			noOp: false,
 			from: fromHash,
@@ -366,6 +593,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			summary: "Planned migration with placeholder(s) — edit migration.ts then run `node migration.ts` to self-emit",
 			timings: { total: Date.now() - startTime }
 		});
+		const plannedOps = deltaLeg.value.plannedOps;
 		const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(plannedOps) : void 0;
 		return ok({
 			ok: true,
@@ -393,8 +621,12 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 function createMigrationPlanCommand() {
 	const command = new Command("plan");
 	setCommandDescriptions(command, "Plan a migration from contract changes", "Compares the emitted contract against the latest on-disk migration state and\nproduces a new migration package with the required operations. No database\nconnection is needed — this is a fully offline operation.");
-	setCommandExamples(command, ["prisma-next migration plan", "prisma-next migration plan --name add-users-table"]);
-	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--name <slug>", "Name slug for the migration directory", "migration").option("--from <contract>", "Starting contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)").action(async (options) => {
+	setCommandExamples(command, [
+		"prisma-next migration plan",
+		"prisma-next migration plan --name add-users-table",
+		"prisma-next migration plan --to <migration-dir>^ --name rollback"
+	]);
+	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--name <slug>", "Name slug for the migration directory", "migration").option("--from <contract>", "Starting contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)").option("--to <contract>", "Destination contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path); defaults to the emitted contract").action(async (options) => {
 		const flags = parseGlobalFlagsOrExit(options);
 		const startTime = Date.now();
 		const ui = createTerminalUI(flags);
@@ -425,6 +657,11 @@ function buildPlanSummary(plannedOpsCount, emittedExtensionDirsCount) {
 	if (emittedExtensionDirsCount === 0) return base;
 	return `${base}; materialised ${emittedExtensionDirsCount} ${emittedExtensionDirsCount === 1 ? "extension-space migration" : "extension-space migrations"}`;
 }
+function buildAutoBaselinePlanSummary(deltaOpsCount, emittedExtensionDirsCount) {
+	const base = `Planned baseline + ${deltaOpsCount} operation(s)`;
+	if (emittedExtensionDirsCount === 0) return base;
+	return `${base}; materialised ${emittedExtensionDirsCount} ${emittedExtensionDirsCount === 1 ? "extension-space migration" : "extension-space migrations"}`;
+}
 function formatMigrationPlanOutput(result, flags) {
 	const lines = [];
 	const useColor = flags.color !== false;
@@ -476,10 +713,12 @@ function formatMigrationPlanOutput(result, flags) {
 	}
 	lines.push(dim_(`from:   ${result.from}`));
 	lines.push(dim_(`to:     ${result.to}`));
+	if (result.baselineDir) lines.push(dim_(`Baseline → ${result.baselineDir}`));
 	if (result.dir) lines.push(dim_(`App space → ${result.dir}`));
 	for (const entry of result.emittedExtensionDirs) lines.push(dim_(`Extension space ${entry.spaceId} → migrations/${entry.spaceId}/${entry.dirName}`));
 	lines.push("");
-	lines.push(`Next: review ${green_(result.dir ?? "<dir>")} if needed, then run ${green_("prisma-next migrate")}.`);
+	const reviewTarget = result.baselineDir !== void 0 && result.dir !== void 0 ? `${result.baselineDir} and ${result.dir}` : result.baselineDir ?? result.dir ?? "<dir>";
+	lines.push(`Next: review ${green_(reviewTarget)} if needed, then run ${green_("prisma-next migrate")}.`);
 	if (result.preview && result.preview.statements.length > 0) {
 		const allSql = result.preview.statements.every((s) => s.language === "sql");
 		lines.push("");
@@ -526,4 +765,4 @@ function resolveBundleByPrefix(bundles, needle) {
 //#endregion
 export { formatMigrationPlanOutput as n, resolveBundleByPrefix as r, createMigrationPlanCommand as t };
 
-//# sourceMappingURL=migration-plan-C2jeH1J5.mjs.map
+//# sourceMappingURL=migration-plan-DHLa2Khm.mjs.map