prisma-next 0.11.0-dev.4 → 0.11.0-dev.40

package/dist/migration-list-CnYiHrNV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-list-CnYiHrNV.mjs","names":[],"sources":["../src/utils/formatters/migration-list-render.ts","../src/utils/formatters/migration-list-styler.ts","../src/commands/migration-list.ts"],"sourcesContent":["import type {\n  MigrationListEntry,\n  MigrationListResult,\n} from '@prisma-next/migration-tools/migration-list-types';\n\nexport type {\n  MigrationListEntry,\n  MigrationListResult,\n  MigrationSpaceListEntry,\n} from '@prisma-next/migration-tools/migration-list-types';\n\nconst HASH_WIDTH = 7;\nconst EMPTY_SOURCE = '∅';\nconst SELF_EDGE_GLYPH = '⟲';\nconst FORWARD_EDGE_GLYPH = '→';\nconst DECORATION_PREFIX = '  ';\n\n/**\n * Semantic styler for `migration list` output tokens. Token-typed so\n * the renderer composes presentation-neutral fragments and the styler\n * decides how each token kind is decorated (ANSI codes, plain text,\n * etc.). The renderer pads with raw spaces *outside* styled tokens so\n * visible column widths stay stable regardless of what the styler\n * emits — adding ANSI escape sequences never disturbs alignment.\n *\n * `invariants` and `refs` receive the underlying string arrays rather\n * than a pre-joined string so per-element styling (e.g. distinguishing\n * the live-DB `db` marker from user-named refs) is possible without\n * having to re-parse a joined block.\n */\nexport interface MigrationListStyler {\n  dirName(text: string): string;\n  sourceHash(text: string): string;\n  destHash(text: string): string;\n  glyph(text: string): string;\n  invariants(ids: readonly string[]): string;\n  refs(names: readonly string[]): string;\n  spaceHeading(text: string): string;\n  summary(text: string): string;\n  emptyState(text: string): string;\n}\n\nexport const IDENTITY_MIGRATION_LIST_STYLER: MigrationListStyler = {\n  dirName: (text) => text,\n  sourceHash: (text) => text,\n  destHash: (text) => text,\n  glyph: (text) => text,\n  invariants: (ids) => `{${ids.join(', ')}}`,\n  refs: (names) => `(${names.join(', ')})`,\n  spaceHeading: (text) => text,\n  summary: (text) => text,\n  emptyState: (text) => text,\n};\n\nfunction abbreviateContractHash(hash: string): string {\n  const stripped = hash.startsWith('sha256:') ? hash.slice(7) : hash;\n  return stripped.slice(0, HASH_WIDTH);\n}\n\nfunction formatSourceColumn(from: string | null, style: MigrationListStyler): string {\n  if (from === null) {\n    return style.glyph(EMPTY_SOURCE) + ' '.repeat(HASH_WIDTH - EMPTY_SOURCE.length);\n  }\n  return style.sourceHash(abbreviateContractHash(from));\n}\n\nfunction formatDestColumn(from: string | null, to: string, style: MigrationListStyler): string {\n  if (from !== null && from === to) {\n    return ' '.repeat(HASH_WIDTH);\n  }\n  return style.destHash(abbreviateContractHash(to));\n}\n\nfunction formatArrowGlyph(from: string | null, to: string, style: MigrationListStyler): string {\n  return style.glyph(from !== null && from === to ? SELF_EDGE_GLYPH : FORWARD_EDGE_GLYPH);\n}\n\nfunction formatDecorations(\n  providedInvariants: readonly string[],\n  refs: readonly string[],\n  style: MigrationListStyler,\n): string {\n  const blocks: string[] = [];\n  if (providedInvariants.length > 0) {\n    blocks.push(style.invariants(providedInvariants));\n  }\n  if (refs.length > 0) {\n    blocks.push(style.refs(refs));\n  }\n  if (blocks.length === 0) return '';\n  return `${DECORATION_PREFIX}${blocks.join(' ')}`;\n}\n\nfunction formatMigrationRow(\n  migration: MigrationListEntry,\n  dirNameWidth: number,\n  style: MigrationListStyler,\n): string {\n  const dirNamePadding = ' '.repeat(Math.max(0, dirNameWidth - migration.dirName.length));\n  const dirName = `${style.dirName(migration.dirName)}${dirNamePadding}`;\n  const source = formatSourceColumn(migration.from, style);\n  const arrow = formatArrowGlyph(migration.from, migration.to, style);\n  const dest = formatDestColumn(migration.from, migration.to, style);\n  const decorations = formatDecorations(migration.providedInvariants, migration.refs, style);\n  return `${dirName}${source} ${arrow} ${dest}${decorations}`;\n}\n\nfunction formatEmptyStateLine(spaceId: string, style: MigrationListStyler): string {\n  return style.emptyState(`There are no migrations in migrations/${spaceId}/ yet`);\n}\n\nfunction renderSpaceBlock(\n  spaceId: string,\n  migrations: readonly MigrationListEntry[],\n  multiSpace: boolean,\n  style: MigrationListStyler,\n): readonly string[] {\n  if (migrations.length === 0) {\n    const emptyLine = formatEmptyStateLine(spaceId, style);\n    if (!multiSpace) {\n      return [emptyLine];\n    }\n    return [style.spaceHeading(`${spaceId}:`), `  ${emptyLine}`];\n  }\n\n  const dirNameWidth = Math.max(...migrations.map((entry) => entry.dirName.length)) + 2;\n  const rows = migrations.map((entry) => formatMigrationRow(entry, dirNameWidth, style));\n  if (!multiSpace) {\n    return rows;\n  }\n  return [style.spaceHeading(`${spaceId}:`), ...rows.map((row) => `  ${row}`)];\n}\n\n/**\n * Compose the styled `migration list` output. The renderer is\n * presentation-neutral — every token passes through `style` before\n * landing in the output, so the same composition serves the pure-text\n * path ({@link renderMigrationList} via\n * {@link IDENTITY_MIGRATION_LIST_STYLER}) and the ANSI-styled CLI path\n * (via the ANSI styler the CLI shell wires up).\n */\nexport function renderMigrationListWithStyle(\n  result: MigrationListResult,\n  style: MigrationListStyler,\n): string {\n  const multiSpace = result.spaces.length > 1;\n  const lines: string[] = [];\n\n  for (let index = 0; index < result.spaces.length; index++) {\n    const space = result.spaces[index]!;\n    if (index > 0) {\n      lines.push('');\n    }\n    lines.push(...renderSpaceBlock(space.spaceId, space.migrations, multiSpace, style));\n  }\n\n  const totalMigrations = result.spaces.reduce(\n    (count, space) => count + space.migrations.length,\n    0,\n  );\n  if (totalMigrations > 0) {\n    lines.push('');\n    lines.push(style.summary(result.summary));\n  }\n\n  return lines.join('\\n');\n}\n\nexport function renderMigrationList(result: MigrationListResult): string {\n  return renderMigrationListWithStyle(result, IDENTITY_MIGRATION_LIST_STYLER);\n}\n","import { bold, cyan, cyanBright, dim, green, greenBright, yellow } from 'colorette';\nimport { IDENTITY_MIGRATION_LIST_STYLER, type MigrationListStyler } from './migration-list-render';\n\n/**\n * The reserved ref name for the live-database marker. Treated as a\n * structurally distinct token from user-named refs so the styler can\n * make it visually pop in `(refs)` decorations.\n */\nconst DB_REF_NAME = 'db';\n\nfunction styleRefName(name: string): string {\n  return name === DB_REF_NAME ? bold(greenBright(name)) : green(name);\n}\n\n/**\n * Build a {@link MigrationListStyler} that decorates `migration list`\n * tokens with ANSI SGR codes. When `useColor` is `false` (non-TTY,\n * `--no-color`, `NO_COLOR=1`, piped output) the function returns the\n * shared identity styler so callers get plain text with zero ANSI\n * bytes — pipe-friendly by construction.\n *\n * Palette:\n *\n * - `dirName`: bold\n * - `sourceHash`: dim cyan\n * - `destHash`: bright cyan\n * - `glyph` (`→` / `⟲` / `∅`): dim\n * - `invariants` (`{...}`): yellow\n * - `refs` (`(...)`): green; the live-DB `db` marker inside is green-bold\n * - `spaceHeading` (`<spaceId>:`): bold\n * - `summary`: dim\n * - `emptyState`: dim\n */\nexport function createAnsiMigrationListStyler(opts: {\n  readonly useColor: boolean;\n}): MigrationListStyler {\n  if (!opts.useColor) {\n    return IDENTITY_MIGRATION_LIST_STYLER;\n  }\n  return {\n    dirName: (text) => bold(text),\n    sourceHash: (text) => dim(cyan(text)),\n    destHash: (text) => cyanBright(text),\n    glyph: (text) => dim(text),\n    invariants: (ids) => yellow(`{${ids.join(', ')}}`),\n    refs: (names) => {\n      const open = green('(');\n      const close = green(')');\n      const separator = green(', ');\n      return open + names.map(styleRefName).join(separator) + close;\n    },\n    spaceHeading: (text) => bold(text),\n    summary: (text) => dim(text),\n    emptyState: (text) => dim(text),\n  };\n}\n","import { enumerateMigrationSpaces } from '@prisma-next/migration-tools/enumerate-migration-spaces';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type {\n  MigrationListResult,\n  MigrationSpaceListEntry,\n} from '@prisma-next/migration-tools/migration-list-types';\nimport { APP_SPACE_ID, isValidSpaceId } from '@prisma-next/migration-tools/spaces';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport {\n  type CliStructuredError,\n  errorInvalidSpaceId,\n  errorSpaceNotFound,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n} from '../utils/command-helpers';\nimport { renderMigrationListWithStyle } from '../utils/formatters/migration-list-render';\nimport { createAnsiMigrationListStyler } from '../utils/formatters/migration-list-styler';\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 MigrationListOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly space?: string;\n}\n\n/**\n * Inputs for {@link runMigrationList} — the pure-ish data-and-policy core\n * of `migration list` that tests exercise directly.\n *\n * The core depends only on the filesystem rooted at `migrationsDir`. It\n * does NOT call `loadConfig`, parse CLI flags, render a styled header,\n * or write to any stream. Output rendering is the caller's concern (the\n * CLI shell renders via {@link renderMigrationList}; JSON callers\n * serialize the {@link MigrationListResult} directly).\n */\nexport interface RunMigrationListInputs {\n  /** Absolute path to the project's `migrations/` directory. */\n  readonly migrationsDir: string;\n  /**\n   * Optional contract-space id to narrow the result to a single space.\n   * Same validation rules as {@link isValidSpaceId}. When absent, every\n   * on-disk space contributes.\n   */\n  readonly spaceFilter?: string;\n}\n\n/**\n * Compute the trailing one-line summary appended below the migration\n * rows. Wording follows the existing CLI's pluralization style (\"N\n * migration(s) on disk\" for the common single-space path; multi-space\n * adds \"across K contract space(s)\" so consumers can see the spread).\n *\n * The renderer suppresses the summary line when `totalMigrations === 0`\n * — the empty-state line carries enough information on its own — so\n * this function always returns a string even for the empty-state.\n */\nfunction computeSummary(spaces: readonly MigrationSpaceListEntry[]): string {\n  const totalMigrations = spaces.reduce((count, space) => count + space.migrations.length, 0);\n  if (spaces.length <= 1) {\n    return `${totalMigrations} migration(s) on disk`;\n  }\n  return `${totalMigrations} migration(s) across ${spaces.length} contract space(s)`;\n}\n\n/**\n * The unit-testable core of `migration list`. Given an absolute\n * `migrationsDir` and an optional `spaceFilter`, enumerates every\n * on-disk migration (via {@link enumerateMigrationSpaces}), narrows to\n * the requested space if any, and assembles a {@link MigrationListResult}\n * ready for the renderer or JSON serializer.\n *\n * The enumerator is the single source of truth for \"what is a contract\n * space\": existence, the `--space` candidate-suggestion list, and\n * scoping are all derived from one {@link enumerateMigrationSpaces}\n * traversal. This means the reserved-name exclusion the enumerator\n * applies (e.g. the per-space `refs/` subdirectory) is honoured here for\n * free — a `--space refs` request resolves to `SPACE_NOT_FOUND`, not a\n * synthesized empty-state.\n *\n * Distinct empty-state paths:\n *\n * - `migrations/` missing or contains no valid space directories →\n *   synthesizes `[{ spaceId: APP_SPACE_ID, migrations: [] }]` so the\n *   renderer's empty-state path can name a directory (spec § Empty-state +\n *   the `migrations/` missing edge case).\n * - `--space <id>` on an existing-but-empty space dir → the enumerator\n *   surfaces `{ spaceId, migrations: [] }`; `<id>` is in the set, so it\n *   scopes to that entry and renders the empty-state the same way.\n * - `--space <id>` on a non-existent (or reserved) space → structured\n *   `MIGRATION.SPACE_NOT_FOUND` error (NOT empty-state).\n *\n * Errors caught here:\n *\n * - {@link MigrationToolsError} from the enumerator → mapped through\n *   {@link mapMigrationToolsError} so callers see the catalogue code.\n * - Anything else (filesystem etc.) → wrapped via {@link errorUnexpected}.\n */\nexport async function runMigrationList(\n  inputs: RunMigrationListInputs,\n): Promise<Result<MigrationListResult, CliStructuredError>> {\n  const { migrationsDir, spaceFilter } = inputs;\n\n  if (spaceFilter !== undefined && !isValidSpaceId(spaceFilter)) {\n    return notOk(errorInvalidSpaceId(spaceFilter));\n  }\n\n  let spaces: readonly MigrationSpaceListEntry[];\n  try {\n    spaces = await enumerateMigrationSpaces({ projectMigrationsDir: migrationsDir });\n  } catch (error) {\n    if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to enumerate migrations: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  if (spaceFilter !== undefined && !spaces.some((s) => s.spaceId === spaceFilter)) {\n    return notOk(errorSpaceNotFound(spaceFilter, spaces.map((s) => s.spaceId).sort()));\n  }\n\n  const scopedSpaces =\n    spaceFilter !== undefined ? spaces.filter((s) => s.spaceId === spaceFilter) : spaces;\n\n  const resultSpaces: readonly MigrationSpaceListEntry[] =\n    scopedSpaces.length === 0 ? [{ spaceId: APP_SPACE_ID, migrations: [] }] : scopedSpaces;\n\n  return ok({\n    ok: true,\n    spaces: resultSpaces,\n    summary: computeSummary(resultSpaces),\n  });\n}\n\n/**\n * CLI shell: loads config, resolves paths, prints the styled header on\n * stderr (interactive mode only), and delegates to {@link runMigrationList}.\n * Kept intentionally thin so the unit-testable surface lives in the core.\n */\nasync function executeMigrationListCommand(\n  options: MigrationListOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationListResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration list',\n      description: 'List on-disk migrations, latest first, per contract space',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'migrations', value: migrationsRelative },\n        ...(options.space !== undefined ? [{ label: 'space', value: options.space }] : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  return runMigrationList({\n    migrationsDir,\n    ...ifDefined('spaceFilter', options.space),\n  });\n}\n\nexport function createMigrationListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(\n    command,\n    'List on-disk migrations, latest first, per contract space',\n    'Enumerates every on-disk migration under migrations/<space>/ for every\\n' +\n      'contract space found on disk, latest first. Offline — does not consult\\n' +\n      'the database. Each row shows source → destination contract hashes\\n' +\n      '(7-char git-style), the self-edge marker (⟲), any provided invariants\\n' +\n      '({...}), and refs landing on the destination ((production, db)). Pass\\n' +\n      '--space <id> to narrow to a single contract space.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration list',\n    'prisma-next migration list --space app',\n    'prisma-next migration list --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 graph', oneLiner: 'Show the migration graph topology' },\n    { verb: 'migration show', oneLiner: 'Display migration package contents' },\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--space <id>', 'Narrow output to a single contract space')\n    .action(async (options: MigrationListOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeMigrationListCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (listResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(listResult, null, 2));\n        } else if (!flags.quiet) {\n          const styler = createAnsiMigrationListStyler({ useColor: ui.useColor });\n          ui.output(renderMigrationListWithStyle(listResult, styler));\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":"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"}

package/dist/{migration-plan-C2jeH1J5.mjs → migration-plan-ulpJu26J.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 { A as mapRefResolutionError, E as errorTargetMigrationNotSupported, O as errorUnexpected, a as errorContractValidationFailed, h as errorMigrationPlanningFailed, k as mapMigrationToolsError, l as errorFileNotFound, t as CliStructuredError, v as errorPlanForgotTheFlag, w as errorSnapshotMissing } from "./cli-errors-DFF1LlfU.mjs";
+import { t as assertFrameworkComponentsCompatible } from "./framework-components-DTcjouhS.mjs";
+import { D 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, x as handleResult, y as createTerminalUI } from "./command-helpers-BnqwTptC.mjs";
+import { n as toExtensionInputs, t as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-EVU3n9YE.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 { assertHashIsGraphNode, findLatestMigration, isGraphNode } 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 { readRefSnapshot, readRefs } from "@prisma-next/migration-tools/refs";
 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 { 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,6 +109,135 @@ function buildPlaceholderContractDts(spaceId) {
 	].join("\n");
 }
 //#endregion
+//#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(bundles) {
+	return bundles.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 {
+		assertHashIsGraphNode(fromHash, graph);
+	} catch (error) {
+		if (MigrationToolsError.is(error) && error.code === "MIGRATION.HASH_NOT_IN_GRAPH") throw errorPlanForgotTheFlag(fromHash, getReachableRefs(refs, graph), graphTipHash);
+		throw error;
+	}
+}
+async function deserializeSnapshotContract(familyInstance, contract) {
+	try {
+		return ok(familyInstance.deserializeContract(contract));
+	} catch (error) {
+		if (CliStructuredError.is(error)) return notOk(error);
+		return notOk(errorContractValidationFailed(`Ref snapshot contract failed to deserialize: ${error instanceof Error ? error.message : String(error)}`, { where: { path: "ref-snapshot" } }));
+	}
+}
+async function resolveGraphNodeFromBundle(fromHash, bundles, readBundleEndContract, explicitFromLabel) {
+	const matchingBundle = bundles.find((pkg) => pkg.metadata.to === fromHash);
+	if (!matchingBundle) return notOk(errorUnexpected(explicitFromLabel ? `No migration bundle found for --from "${explicitFromLabel}" (resolved hash: ${fromHash})` : `No migration bundle found for graph node ${fromHash}`, {
+		why: `The hash ${fromHash} is a graph node but no on-disk migration package has an end-contract hash matching it.`,
+		fix: "Provide a ref or hash that corresponds to an existing migration package, or run `migration list` to see available migrations."
+	}));
+	try {
+		return ok({
+			kind: "graph-node",
+			fromHash,
+			fromContract: await readBundleEndContract(matchingBundle.dirPath),
+			sourceDir: matchingBundle.dirPath
+		});
+	} catch (error) {
+		if (CliStructuredError.is(error)) return notOk(error);
+		throw error;
+	}
+}
+async function resolveFromRefName(refName, fromHash, input, refs) {
+	const { refsDir, bundles, graph, familyInstance, readBundleEndContract } = input;
+	const empty = graphIsEmpty(bundles);
+	const graphTip = findLatestMigration(graph)?.to ?? null;
+	let snapshot;
+	try {
+		snapshot = await readRefSnapshot(refsDir, refName);
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		throw error;
+	}
+	if (snapshot) {
+		const contractResult = await deserializeSnapshotContract(familyInstance, snapshot.contract);
+		if (!contractResult.ok) return contractResult;
+		const fromContract = contractResult.value;
+		const { contractDts, contract: contractJson } = snapshot;
+		if (empty) return ok({
+			kind: "auto-baseline",
+			fromHash,
+			fromContract,
+			contractDts,
+			contractJson
+		});
+		try {
+			assertFromIsGraphNode(fromHash, graph, refs, graphTip);
+		} catch (error) {
+			if (CliStructuredError.is(error)) return notOk(error);
+			throw error;
+		}
+		return ok({
+			kind: "snapshot",
+			fromHash,
+			fromContract,
+			contractDts,
+			contractJson
+		});
+	}
+	if (isGraphNode(fromHash, graph)) return resolveGraphNodeFromBundle(fromHash, bundles, readBundleEndContract);
+	return notOk(errorSnapshotMissing(refName));
+}
+async function resolveFromHashProvenance(fromHash, input, _refs, explicitFromLabel) {
+	const { bundles, graph } = input;
+	if (isGraphNode(fromHash, graph)) return resolveGraphNodeFromBundle(fromHash, bundles, input.readBundleEndContract, explicitFromLabel);
+	throw new Error(`resolveFromHashProvenance: non-graph-node hash ${fromHash} should be refused via looksLikeFullHash before this helper is called`);
+}
+async function resolveFromForPlan(input) {
+	const { optionsFrom, refsDir, graph } = input;
+	let refs;
+	try {
+		refs = await readRefs(refsDir);
+	} catch (error) {
+		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
+		throw error;
+	}
+	if (optionsFrom === void 0) {
+		const dbRef = refs["db"];
+		if (!dbRef) return ok({
+			kind: "greenfield",
+			fromHash: null,
+			fromContract: null
+		});
+		return resolveFromRefName("db", dbRef.hash, input, refs);
+	}
+	const refResult = parseContractRef(optionsFrom, {
+		graph,
+		refs
+	});
+	if (!refResult.ok) {
+		if (looksLikeFullHash(optionsFrom)) {
+			const empty = graphIsEmpty(input.bundles);
+			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));
+	}
+	const { hash: fromHash, provenance } = refResult.value;
+	if (provenance.kind === "ref") return resolveFromRefName(provenance.refName, fromHash, input, refs);
+	return resolveFromHashProvenance(fromHash, input, refs, optionsFrom);
+}
+//#endregion
 //#region src/commands/migration-plan.ts
 /**
 * Load a predecessor migration's destination contract from its sibling
@@ -148,6 +277,64 @@ async function readPredecessorEndContract(migrationDir, familyInstance) {
 		throw errorContractValidationFailed(`Predecessor contract at ${path} failed to deserialize: ${error instanceof Error ? error.message : String(error)}`, { where: { path } });
 	}
 }
+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);
 	const { configPath, migrationsDir, appMigrationsDir, appMigrationsRelative } = resolveMigrationPaths(options.config, config);
@@ -206,36 +393,47 @@ 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;
+	const { refsDir } = resolveMigrationPaths(options.config, config);
 	let fromContract = null;
 	let fromHash = null;
 	let fromContractSourceDir = null;
+	let snapshotStartContract = null;
+	let isAutoBaseline = false;
 	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);
-				}
-			}
+		const resolutionResult = await resolveFromForPlan({
+			optionsFrom: options.from,
+			refsDir,
+			bundles,
+			graph,
+			familyInstance,
+			readBundleEndContract: (migrationDir) => readPredecessorEndContract(migrationDir, familyInstance)
+		});
+		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;
 		}
 	} catch (error) {
 		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
@@ -257,7 +455,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 +481,105 @@ 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;
+		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);
+			const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
+			await copyFilesWithRename(deltaPackageDir, [{
+				sourcePath: destinationArtifacts.jsonPath,
+				destName: "end-contract.json"
+			}, {
+				sourcePath: destinationArtifacts.dtsPath,
+				destName: "end-contract.d.ts"
+			}]);
+			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 migrationTsContent = plannerResult.plan.renderTypeScript();
-		const opsForWrite = hasPlaceholders ? [] : plannedOps;
-		const metadataWithInvariants = {
-			...baseMetadata,
-			providedInvariants: deriveProvidedInvariants(opsForWrite)
-		};
-		await writeMigrationPackage(packageDir, {
-			...metadataWithInvariants,
-			migrationHash: computeMigrationHash(metadataWithInvariants, opsForWrite)
-		}, opsForWrite);
+		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);
 		const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
 		await copyFilesWithRename(packageDir, [{
 			sourcePath: destinationArtifacts.jsonPath,
@@ -352,9 +597,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 +610,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,
@@ -425,6 +670,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 +726,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 +778,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-ulpJu26J.mjs.map