@prisma-next/cli 0.16.0-dev.3 → 0.16.0-dev.30

package/dist/{migration-log-C_xam2HZ.mjs.map → migration-log-CjafbZ2Z.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"migration-log-C_xam2HZ.mjs","names":[],"sources":["../src/utils/formatters/migration-log-table.ts","../src/commands/migration-log.ts"],"sourcesContent":["import type { LedgerEntryRecord } from '@prisma-next/contract/types';\nimport stringWidth from 'string-width';\nimport type { GlyphMode } from '../glyph-mode';\nimport {\n  abbreviateContractHash,\n  migrationListEmptySource,\n  migrationListForwardArrow,\n} from './migration-list-data-column';\nimport { IDENTITY_MIGRATION_LIST_STYLER, type MigrationListStyler } from './migration-list-render';\n\nexport type LedgerTimestampMode = 'local' | 'utc' | 'iso';\n\nexport interface RenderMigrationLogTableOptions {\n  readonly utc?: boolean;\n  readonly styler?: MigrationListStyler;\n  readonly glyphMode?: GlyphMode;\n}\n\nexport interface SerializedLedgerEntryRecord {\n  readonly space: string;\n  readonly name: string;\n  readonly hash: string;\n  readonly fromContract: string | null;\n  readonly toContract: string;\n  readonly appliedAt: string;\n  readonly operationCount: number;\n}\n\nconst HEADING_APPLIED_AT = 'Applied at';\nconst HEADING_SPACE = 'Space';\nconst HEADING_MIGRATION = 'Migration';\nconst HEADING_CHANGE = 'Change';\nconst HEADING_OPS = 'Ops';\nconst COLUMN_SEPARATOR = ' ';\nconst DIVIDER_CHAR = '─';\nconst ASCII_DIVIDER_CHAR = '-';\n\nexport function sortLedgerEntries(entries: readonly LedgerEntryRecord[]): LedgerEntryRecord[] {\n  return [...entries].sort((left, right) => {\n    const timeDiff = left.appliedAt.getTime() - right.appliedAt.getTime();\n    if (timeDiff !== 0) {\n      return timeDiff;\n    }\n    const spaceDiff = left.space.localeCompare(right.space);\n    if (spaceDiff !== 0) {\n      return spaceDiff;\n    }\n    return left.migrationName.localeCompare(right.migrationName);\n  });\n}\n\nfunction pad2(value: number): string {\n  return String(value).padStart(2, '0');\n}\n\nexport function formatLedgerAppliedAt(date: Date, mode: LedgerTimestampMode): string {\n  if (mode === 'iso') {\n    return date.toISOString();\n  }\n  if (mode === 'utc') {\n    return `${date.getUTCFullYear()}-${pad2(date.getUTCMonth() + 1)}-${pad2(date.getUTCDate())} ${pad2(date.getUTCHours())}:${pad2(date.getUTCMinutes())}:${pad2(date.getUTCSeconds())}Z`;\n  }\n  const offsetMinutes = -date.getTimezoneOffset();\n  const sign = offsetMinutes >= 0 ? '+' : '-';\n  const absoluteOffset = Math.abs(offsetMinutes);\n  const offsetHours = pad2(Math.floor(absoluteOffset / 60));\n  const offsetMins = pad2(absoluteOffset % 60);\n  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())} ${sign}${offsetHours}:${offsetMins}`;\n}\n\nexport function formatHashEndpoint(hash: string | null, glyphMode: GlyphMode = 'unicode'): string {\n  if (hash === null) {\n    return migrationListEmptySource(glyphMode);\n  }\n  return abbreviateContractHash(hash);\n}\n\nexport function formatHashTransition(\n  from: string | null,\n  to: string,\n  glyphMode: GlyphMode = 'unicode',\n): string {\n  return `${formatHashEndpoint(from, glyphMode)} ${migrationListForwardArrow(glyphMode)} ${abbreviateContractHash(to)}`;\n}\n\nexport function styleHashTransition(\n  from: string | null,\n  to: string,\n  styler: MigrationListStyler,\n  glyphMode: GlyphMode = 'unicode',\n): string {\n  const fromPart =\n    from === null\n      ? styler.glyph(migrationListEmptySource(glyphMode))\n      : styler.sourceHash(abbreviateContractHash(from));\n  const arrow = styler.glyph(migrationListForwardArrow(glyphMode));\n  const dest = styler.destHash(abbreviateContractHash(to));\n  return `${fromPart} ${arrow} ${dest}`;\n}\n\nfunction padVisible(text: string, targetWidth: number): string {\n  const padding = Math.max(0, targetWidth - stringWidth(text));\n  return text + ' '.repeat(padding);\n}\n\nfunction columnWidth(values: readonly string[]): number {\n  return values.reduce((max, value) => Math.max(max, stringWidth(value)), 0);\n}\n\nfunction padDividerCell(valueWidth: number, dividerChar: string): string {\n  return dividerChar.repeat(valueWidth + 2);\n}\n\nfunction padTextCell(value: string, valueWidth: number): string {\n  return ` ${padVisible(value, valueWidth)} `;\n}\n\nfunction padOpsCell(value: string, valueWidth: number): string {\n  const padding = Math.max(0, valueWidth - stringWidth(value));\n  return ` ${' '.repeat(padding)}${value} `;\n}\n\nexport function renderMigrationLogTable(\n  entries: readonly LedgerEntryRecord[],\n  options: RenderMigrationLogTableOptions = {},\n): string {\n  const sorted = sortLedgerEntries(entries);\n  if (sorted.length === 0) {\n    return '';\n  }\n\n  const styler = options.styler ?? IDENTITY_MIGRATION_LIST_STYLER;\n  const glyphMode = options.glyphMode ?? 'unicode';\n  const dividerChar = glyphMode === 'ascii' ? ASCII_DIVIDER_CHAR : DIVIDER_CHAR;\n  const showSpace = new Set(sorted.map((entry) => entry.space)).size > 1;\n  const timestampMode: LedgerTimestampMode = options.utc ? 'utc' : 'local';\n  const rows = sorted.map((entry) => ({\n    appliedAt: formatLedgerAppliedAt(entry.appliedAt, timestampMode),\n    space: entry.space,\n    migrationName: entry.migrationName,\n    transition: formatHashTransition(entry.from, entry.to, glyphMode),\n    ops: `${entry.operationCount} ops`,\n    from: entry.from,\n    to: entry.to,\n  }));\n\n  const appliedAtWidth = columnWidth([HEADING_APPLIED_AT, ...rows.map((row) => row.appliedAt)]);\n  const spaceWidth = showSpace ? columnWidth([HEADING_SPACE, ...rows.map((row) => row.space)]) : 0;\n  const nameWidth = columnWidth([HEADING_MIGRATION, ...rows.map((row) => row.migrationName)]);\n  const transitionWidth = columnWidth([HEADING_CHANGE, ...rows.map((row) => row.transition)]);\n  const opsWidth = columnWidth([HEADING_OPS, ...rows.map((row) => row.ops)]);\n\n  const headingParts = [padTextCell(HEADING_APPLIED_AT, appliedAtWidth)];\n  if (showSpace) {\n    headingParts.push(padTextCell(HEADING_SPACE, spaceWidth));\n  }\n  headingParts.push(\n    padTextCell(HEADING_MIGRATION, nameWidth),\n    padTextCell(HEADING_CHANGE, transitionWidth),\n    padOpsCell(HEADING_OPS, opsWidth),\n  );\n  const heading = headingParts.join(COLUMN_SEPARATOR);\n\n  const dividerParts = [padDividerCell(appliedAtWidth, dividerChar)];\n  if (showSpace) {\n    dividerParts.push(padDividerCell(spaceWidth, dividerChar));\n  }\n  dividerParts.push(\n    padDividerCell(nameWidth, dividerChar),\n    padDividerCell(transitionWidth, dividerChar),\n    padDividerCell(opsWidth, dividerChar),\n  );\n  const divider = dividerParts.map((cell) => styler.summary(cell)).join(COLUMN_SEPARATOR);\n\n  const dataRows = rows.map((row) => {\n    const parts = [padTextCell(row.appliedAt, appliedAtWidth)];\n    if (showSpace) {\n      parts.push(padTextCell(row.space, spaceWidth));\n    }\n    parts.push(\n      padTextCell(styler.dirName(row.migrationName), nameWidth),\n      padTextCell(styleHashTransition(row.from, row.to, styler, glyphMode), transitionWidth),\n      padOpsCell(row.ops, opsWidth),\n    );\n    return parts.join(COLUMN_SEPARATOR);\n  });\n\n  return [heading, divider, ...dataRows].join('\\n');\n}\n\nexport function serializeLedgerEntriesForJson(\n  entries: readonly LedgerEntryRecord[],\n): SerializedLedgerEntryRecord[] {\n  return sortLedgerEntries(entries).map((entry) => ({\n    space: entry.space,\n    name: entry.migrationName,\n    hash: entry.migrationHash,\n    fromContract: entry.from,\n    toContract: entry.to,\n    appliedAt: formatLedgerAppliedAt(entry.appliedAt, 'iso'),\n    operationCount: entry.operationCount,\n  }));\n}\n\nexport const MIGRATION_LOG_EMPTY_MESSAGE = 'No migrations have been applied to this database.';\n","import { loadConfig } from '@prisma-next/config-loader';\nimport type { LedgerEntryRecord } from '@prisma-next/contract/types';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { createControlClient } from '../control-api/client';\nimport {\n  CliStructuredError,\n  errorUnexpected,\n  mapMigrationToolsError,\n  requireLiveDatabase,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  maskConnectionUrl,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { createAnsiMigrationListStyler } from '../utils/formatters/migration-list-styler';\nimport {\n  MIGRATION_LOG_EMPTY_MESSAGE,\n  renderMigrationLogTable,\n  serializeLedgerEntriesForJson,\n} from '../utils/formatters/migration-log-table';\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';\nimport type { MigrationLogResult } from './json/schemas';\n\nexport type { MigrationLogResult };\n\ninterface MigrationLogOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly utc?: boolean;\n  readonly ascii?: boolean;\n}\n\nexport async function executeMigrationLogCommand(\n  options: MigrationLogOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<readonly LedgerEntryRecord[], CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath } = resolveMigrationPaths(options.config, config);\n\n  const dbConnection = options.db ?? config.db?.connection;\n  const missingDb = requireLiveDatabase({\n    dbConnection,\n    hasDriver: !!config.driver,\n    why: `migration log needs a database connection and driver to read the ledger (set db.connection in ${configPath}, or pass --db <url>)`,\n    commandName: 'migration log',\n  });\n  if (missingDb) {\n    return notOk(missingDb);\n  }\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(errorUnexpected('Target does not support migrations'));\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration log',\n      description: 'Show executed migration history from the database ledger',\n      details: [\n        { label: 'config', value: configPath },\n        ...(typeof dbConnection === 'string'\n          ? [{ label: 'database', value: maskConnectionUrl(dbConnection) }]\n          : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    ...ifDefined('driver', config.driver),\n    extensionPacks: config.extensionPacks ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const ledger = await client.readLedger();\n    return ok(ledger);\n  } catch (error) {\n    if (CliStructuredError.is(error)) return notOk(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 read migration log: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationLogCommand(): Command {\n  const command = new Command('log');\n  setCommandDescriptions(\n    command,\n    'Show executed migration history',\n    'Reads the database ledger and displays every applied migration edge\\n' +\n      'in chronological order, including rollbacks and re-applies, merged\\n' +\n      'across all contract spaces. Requires a database connection.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration log --db $DATABASE_URL',\n    'prisma-next migration log --utc --db $DATABASE_URL',\n    'prisma-next migration log --json --db $DATABASE_URL',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\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('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--utc', 'Render human timestamps in UTC instead of local time')\n    .option('--ascii', 'Use ASCII glyphs (pipe-friendly)')\n    .action(async (options: MigrationLogOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeMigrationLogCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (entries) => {\n        if (flags.json) {\n          const records = serializeLedgerEntriesForJson(entries);\n          const result: MigrationLogResult = {\n            ok: true,\n            records,\n            summary: `${records.length} migration(s) applied`,\n          };\n          ui.output(JSON.stringify(result, null, 2));\n        } else if (!flags.quiet) {\n          if (entries.length === 0) {\n            ui.output(MIGRATION_LOG_EMPTY_MESSAGE);\n          } else {\n            const styler = createAnsiMigrationListStyler({ useColor: ui.useColor });\n            ui.output(\n              renderMigrationLogTable(entries, {\n                utc: options.utc === true,\n                styler,\n                glyphMode: ui.resolveGlyphMode(options.ascii === true),\n              }),\n            );\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration-log-CjafbZ2Z.mjs","names":[],"sources":["../src/utils/formatters/migration-log-table.ts","../src/commands/migration-log.ts"],"sourcesContent":["import type { LedgerEntryRecord } from '@prisma-next/contract/types';\nimport stringWidth from 'string-width';\nimport type { GlyphMode } from '../glyph-mode';\nimport {\n  abbreviateContractHash,\n  migrationListEmptySource,\n  migrationListForwardArrow,\n} from './migration-list-data-column';\nimport { IDENTITY_MIGRATION_LIST_STYLER, type MigrationListStyler } from './migration-list-render';\n\nexport type LedgerTimestampMode = 'local' | 'utc' | 'iso';\n\nexport interface RenderMigrationLogTableOptions {\n  readonly utc?: boolean;\n  readonly styler?: MigrationListStyler;\n  readonly glyphMode?: GlyphMode;\n}\n\nexport interface SerializedLedgerEntryRecord {\n  readonly space: string;\n  readonly name: string;\n  readonly hash: string;\n  readonly fromContract: string | null;\n  readonly toContract: string;\n  readonly appliedAt: string;\n  readonly operationCount: number;\n}\n\nconst HEADING_APPLIED_AT = 'Applied at';\nconst HEADING_SPACE = 'Space';\nconst HEADING_MIGRATION = 'Migration';\nconst HEADING_CHANGE = 'Change';\nconst HEADING_OPS = 'Ops';\nconst COLUMN_SEPARATOR = ' ';\nconst DIVIDER_CHAR = '─';\nconst ASCII_DIVIDER_CHAR = '-';\n\nexport function sortLedgerEntries(entries: readonly LedgerEntryRecord[]): LedgerEntryRecord[] {\n  return [...entries].sort((left, right) => {\n    const timeDiff = left.appliedAt.getTime() - right.appliedAt.getTime();\n    if (timeDiff !== 0) {\n      return timeDiff;\n    }\n    const spaceDiff = left.space.localeCompare(right.space);\n    if (spaceDiff !== 0) {\n      return spaceDiff;\n    }\n    return left.migrationName.localeCompare(right.migrationName);\n  });\n}\n\nfunction pad2(value: number): string {\n  return String(value).padStart(2, '0');\n}\n\nexport function formatLedgerAppliedAt(date: Date, mode: LedgerTimestampMode): string {\n  if (mode === 'iso') {\n    return date.toISOString();\n  }\n  if (mode === 'utc') {\n    return `${date.getUTCFullYear()}-${pad2(date.getUTCMonth() + 1)}-${pad2(date.getUTCDate())} ${pad2(date.getUTCHours())}:${pad2(date.getUTCMinutes())}:${pad2(date.getUTCSeconds())}Z`;\n  }\n  const offsetMinutes = -date.getTimezoneOffset();\n  const sign = offsetMinutes >= 0 ? '+' : '-';\n  const absoluteOffset = Math.abs(offsetMinutes);\n  const offsetHours = pad2(Math.floor(absoluteOffset / 60));\n  const offsetMins = pad2(absoluteOffset % 60);\n  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())} ${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())} ${sign}${offsetHours}:${offsetMins}`;\n}\n\nexport function formatHashEndpoint(hash: string | null, glyphMode: GlyphMode = 'unicode'): string {\n  if (hash === null) {\n    return migrationListEmptySource(glyphMode);\n  }\n  return abbreviateContractHash(hash);\n}\n\nexport function formatHashTransition(\n  from: string | null,\n  to: string,\n  glyphMode: GlyphMode = 'unicode',\n): string {\n  return `${formatHashEndpoint(from, glyphMode)} ${migrationListForwardArrow(glyphMode)} ${abbreviateContractHash(to)}`;\n}\n\nexport function styleHashTransition(\n  from: string | null,\n  to: string,\n  styler: MigrationListStyler,\n  glyphMode: GlyphMode = 'unicode',\n): string {\n  const fromPart =\n    from === null\n      ? styler.glyph(migrationListEmptySource(glyphMode))\n      : styler.sourceHash(abbreviateContractHash(from));\n  const arrow = styler.glyph(migrationListForwardArrow(glyphMode));\n  const dest = styler.destHash(abbreviateContractHash(to));\n  return `${fromPart} ${arrow} ${dest}`;\n}\n\nfunction padVisible(text: string, targetWidth: number): string {\n  const padding = Math.max(0, targetWidth - stringWidth(text));\n  return text + ' '.repeat(padding);\n}\n\nfunction columnWidth(values: readonly string[]): number {\n  return values.reduce((max, value) => Math.max(max, stringWidth(value)), 0);\n}\n\nfunction padDividerCell(valueWidth: number, dividerChar: string): string {\n  return dividerChar.repeat(valueWidth + 2);\n}\n\nfunction padTextCell(value: string, valueWidth: number): string {\n  return ` ${padVisible(value, valueWidth)} `;\n}\n\nfunction padOpsCell(value: string, valueWidth: number): string {\n  const padding = Math.max(0, valueWidth - stringWidth(value));\n  return ` ${' '.repeat(padding)}${value} `;\n}\n\nexport function renderMigrationLogTable(\n  entries: readonly LedgerEntryRecord[],\n  options: RenderMigrationLogTableOptions = {},\n): string {\n  const sorted = sortLedgerEntries(entries);\n  if (sorted.length === 0) {\n    return '';\n  }\n\n  const styler = options.styler ?? IDENTITY_MIGRATION_LIST_STYLER;\n  const glyphMode = options.glyphMode ?? 'unicode';\n  const dividerChar = glyphMode === 'ascii' ? ASCII_DIVIDER_CHAR : DIVIDER_CHAR;\n  const showSpace = new Set(sorted.map((entry) => entry.space)).size > 1;\n  const timestampMode: LedgerTimestampMode = options.utc ? 'utc' : 'local';\n  const rows = sorted.map((entry) => ({\n    appliedAt: formatLedgerAppliedAt(entry.appliedAt, timestampMode),\n    space: entry.space,\n    migrationName: entry.migrationName,\n    transition: formatHashTransition(entry.from, entry.to, glyphMode),\n    ops: `${entry.operationCount} ops`,\n    from: entry.from,\n    to: entry.to,\n  }));\n\n  const appliedAtWidth = columnWidth([HEADING_APPLIED_AT, ...rows.map((row) => row.appliedAt)]);\n  const spaceWidth = showSpace ? columnWidth([HEADING_SPACE, ...rows.map((row) => row.space)]) : 0;\n  const nameWidth = columnWidth([HEADING_MIGRATION, ...rows.map((row) => row.migrationName)]);\n  const transitionWidth = columnWidth([HEADING_CHANGE, ...rows.map((row) => row.transition)]);\n  const opsWidth = columnWidth([HEADING_OPS, ...rows.map((row) => row.ops)]);\n\n  const headingParts = [padTextCell(HEADING_APPLIED_AT, appliedAtWidth)];\n  if (showSpace) {\n    headingParts.push(padTextCell(HEADING_SPACE, spaceWidth));\n  }\n  headingParts.push(\n    padTextCell(HEADING_MIGRATION, nameWidth),\n    padTextCell(HEADING_CHANGE, transitionWidth),\n    padOpsCell(HEADING_OPS, opsWidth),\n  );\n  const heading = headingParts.join(COLUMN_SEPARATOR);\n\n  const dividerParts = [padDividerCell(appliedAtWidth, dividerChar)];\n  if (showSpace) {\n    dividerParts.push(padDividerCell(spaceWidth, dividerChar));\n  }\n  dividerParts.push(\n    padDividerCell(nameWidth, dividerChar),\n    padDividerCell(transitionWidth, dividerChar),\n    padDividerCell(opsWidth, dividerChar),\n  );\n  const divider = dividerParts.map((cell) => styler.summary(cell)).join(COLUMN_SEPARATOR);\n\n  const dataRows = rows.map((row) => {\n    const parts = [padTextCell(row.appliedAt, appliedAtWidth)];\n    if (showSpace) {\n      parts.push(padTextCell(row.space, spaceWidth));\n    }\n    parts.push(\n      padTextCell(styler.dirName(row.migrationName), nameWidth),\n      padTextCell(styleHashTransition(row.from, row.to, styler, glyphMode), transitionWidth),\n      padOpsCell(row.ops, opsWidth),\n    );\n    return parts.join(COLUMN_SEPARATOR);\n  });\n\n  return [heading, divider, ...dataRows].join('\\n');\n}\n\nexport function serializeLedgerEntriesForJson(\n  entries: readonly LedgerEntryRecord[],\n): SerializedLedgerEntryRecord[] {\n  return sortLedgerEntries(entries).map((entry) => ({\n    space: entry.space,\n    name: entry.migrationName,\n    hash: entry.migrationHash,\n    fromContract: entry.from,\n    toContract: entry.to,\n    appliedAt: formatLedgerAppliedAt(entry.appliedAt, 'iso'),\n    operationCount: entry.operationCount,\n  }));\n}\n\nexport const MIGRATION_LOG_EMPTY_MESSAGE = 'No migrations have been applied to this database.';\n","import { loadConfig } from '@prisma-next/config-loader';\nimport type { LedgerEntryRecord } from '@prisma-next/contract/types';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { createControlClient } from '../control-api/client';\nimport {\n  CliStructuredError,\n  errorUnexpected,\n  mapMigrationToolsError,\n  requireLiveDatabase,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  maskConnectionUrl,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n  targetSupportsMigrations,\n} from '../utils/command-helpers';\nimport { createAnsiMigrationListStyler } from '../utils/formatters/migration-list-styler';\nimport {\n  MIGRATION_LOG_EMPTY_MESSAGE,\n  renderMigrationLogTable,\n  serializeLedgerEntriesForJson,\n} from '../utils/formatters/migration-log-table';\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';\nimport type { MigrationLogResult } from './json/schemas';\n\nexport type { MigrationLogResult };\n\ninterface MigrationLogOptions extends CommonCommandOptions {\n  readonly db?: string;\n  readonly config?: string;\n  readonly utc?: boolean;\n  readonly ascii?: boolean;\n}\n\nexport async function executeMigrationLogCommand(\n  options: MigrationLogOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<readonly LedgerEntryRecord[], CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath } = resolveMigrationPaths(options.config, config);\n\n  const dbConnection = options.db ?? config.db?.connection;\n  const missingDb = requireLiveDatabase({\n    dbConnection,\n    hasDriver: !!config.driver,\n    why: `migration log needs a database connection and driver to read the ledger (set db.connection in ${configPath}, or pass --db <url>)`,\n    commandName: 'migration log',\n  });\n  if (missingDb) {\n    return notOk(missingDb);\n  }\n  if (!targetSupportsMigrations(config.target)) {\n    return notOk(errorUnexpected('Target does not support migrations'));\n  }\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration log',\n      description: 'Show executed migration history from the database ledger',\n      details: [\n        { label: 'config', value: configPath },\n        ...(typeof dbConnection === 'string'\n          ? [{ label: 'database', value: maskConnectionUrl(dbConnection) }]\n          : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  const client = createControlClient({\n    family: config.family,\n    target: config.target,\n    adapter: config.adapter,\n    ...ifDefined('driver', config.driver),\n    extensions: config.extensions ?? [],\n  });\n\n  try {\n    await client.connect(dbConnection);\n    const ledger = await client.readLedger();\n    return ok(ledger);\n  } catch (error) {\n    if (CliStructuredError.is(error)) return notOk(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 read migration log: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  } finally {\n    await client.close();\n  }\n}\n\nexport function createMigrationLogCommand(): Command {\n  const command = new Command('log');\n  setCommandDescriptions(\n    command,\n    'Show executed migration history',\n    'Reads the database ledger and displays every applied migration edge\\n' +\n      'in chronological order, including rollbacks and re-applies, merged\\n' +\n      'across all contract spaces. Requires a database connection.',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration log --db $DATABASE_URL',\n    'prisma-next migration log --utc --db $DATABASE_URL',\n    'prisma-next migration log --json --db $DATABASE_URL',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration list', oneLiner: 'List on-disk migrations' },\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('--db <url>', 'Database connection string')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--utc', 'Render human timestamps in UTC instead of local time')\n    .option('--ascii', 'Use ASCII glyphs (pipe-friendly)')\n    .action(async (options: MigrationLogOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeMigrationLogCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (entries) => {\n        if (flags.json) {\n          const records = serializeLedgerEntriesForJson(entries);\n          const result: MigrationLogResult = {\n            ok: true,\n            records,\n            summary: `${records.length} migration(s) applied`,\n          };\n          ui.output(JSON.stringify(result, null, 2));\n        } else if (!flags.quiet) {\n          if (entries.length === 0) {\n            ui.output(MIGRATION_LOG_EMPTY_MESSAGE);\n          } else {\n            const styler = createAnsiMigrationListStyler({ useColor: ui.useColor });\n            ui.output(\n              renderMigrationLogTable(entries, {\n                utc: options.utc === true,\n                styler,\n                glyphMode: ui.resolveGlyphMode(options.ascii === true),\n              }),\n            );\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":"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"}

package/dist/{migration-path-target-DpPTsRCg.mjs → migration-path-target-C0TQuV5n.mjs}

@@ -1,4 +1,4 @@
-import { rt as errorRuntime } from "./command-helpers-Cpq44aVa.mjs";
+import { rt as errorRuntime } from "./command-helpers-CVn3U9Uz.mjs";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { isAbsolute, relative, resolve } from "pathe";
 //#region src/utils/migration-path-target.ts
@@ -35,4 +35,4 @@ function findPackageByDirPath(packages, resolvedDirPath) {
 //#endregion
 export { resolveTargetPathAcrossSpaces as i, looksLikePath as n, resolveAppTargetPath as r, findPackageByDirPath as t };
 
-//# sourceMappingURL=migration-path-target-DpPTsRCg.mjs.map
+//# sourceMappingURL=migration-path-target-C0TQuV5n.mjs.map

package/dist/{migration-path-target-DpPTsRCg.mjs.map → migration-path-target-C0TQuV5n.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"migration-path-target-DpPTsRCg.mjs","names":[],"sources":["../src/utils/migration-path-target.ts"],"sourcesContent":["import type { OnDiskMigrationPackage } from '@prisma-next/migration-tools/package';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { isAbsolute, relative, resolve } from 'pathe';\nimport { type CliStructuredError, errorRuntime } from './cli-errors';\n\nexport function looksLikePath(target: string): boolean {\n  return target.includes('/') || target.includes('\\\\');\n}\n\nexport function resolveAppTargetPath(\n  target: string,\n  appMigrationsDir: string,\n  appMigrationsRelative: string,\n): Result<string, CliStructuredError> {\n  const targetPath = resolve(target);\n  const relativeToApp = relative(appMigrationsDir, targetPath);\n  const isOutsideAppDir =\n    relativeToApp === '' ||\n    relativeToApp === '.' ||\n    relativeToApp.startsWith('..') ||\n    isAbsolute(relativeToApp);\n  if (isOutsideAppDir) {\n    return notOk(\n      errorRuntime('Target must point to an app-space migration', {\n        why: `Expected a path under ${appMigrationsRelative}, got ${target}`,\n        fix: 'Pass an app-space migration directory or use a hash prefix.',\n      }),\n    );\n  }\n  return ok(targetPath);\n}\n\n/**\n * Resolve a filesystem-path target to the migration dir that contains it,\n * searching each in-scope space's `migrationsDir`. A path is explicit, so\n * it can belong to at most one space — returns the first match, or `null`\n * when the path falls outside every space dir.\n */\nexport function resolveTargetPathAcrossSpaces(\n  target: string,\n  spaces: ReadonlyArray<{ readonly migrationsDir: string }>,\n): string | null {\n  const targetPath = resolve(target);\n  for (const space of spaces) {\n    const rel = relative(space.migrationsDir, targetPath);\n    const isOutside = rel === '' || rel === '.' || rel.startsWith('..') || isAbsolute(rel);\n    if (!isOutside) {\n      return targetPath;\n    }\n  }\n  return null;\n}\n\nexport function findPackageByDirPath(\n  packages: readonly OnDiskMigrationPackage[],\n  resolvedDirPath: string,\n): OnDiskMigrationPackage | undefined {\n  const normalized = resolve(resolvedDirPath);\n  return packages.find((p) => resolve(p.dirPath) === normalized);\n}\n"],"mappings":";;;;AAKA,SAAgB,cAAc,QAAyB;CACrD,OAAO,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,IAAI;AACrD;AAEA,SAAgB,qBACd,QACA,kBACA,uBACoC;CACpC,MAAM,aAAa,QAAQ,MAAM;CACjC,MAAM,gBAAgB,SAAS,kBAAkB,UAAU;CAM3D,IAJE,kBAAkB,MAClB,kBAAkB,OAClB,cAAc,WAAW,IAAI,KAC7B,WAAW,aAAa,GAExB,OAAO,MACL,aAAa,+CAA+C;EAC1D,KAAK,yBAAyB,sBAAsB,QAAQ;EAC5D,KAAK;CACP,CAAC,CACH;CAEF,OAAO,GAAG,UAAU;AACtB;;;;;;;AAQA,SAAgB,8BACd,QACA,QACe;CACf,MAAM,aAAa,QAAQ,MAAM;CACjC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,MAAM,SAAS,MAAM,eAAe,UAAU;EAEpD,IAAI,EADc,QAAQ,MAAM,QAAQ,OAAO,IAAI,WAAW,IAAI,KAAK,WAAW,GAAG,IAEnF,OAAO;CAEX;CACA,OAAO;AACT;AAEA,SAAgB,qBACd,UACA,iBACoC;CACpC,MAAM,aAAa,QAAQ,eAAe;CAC1C,OAAO,SAAS,MAAM,MAAM,QAAQ,EAAE,OAAO,MAAM,UAAU;AAC/D"}
+{"version":3,"file":"migration-path-target-C0TQuV5n.mjs","names":[],"sources":["../src/utils/migration-path-target.ts"],"sourcesContent":["import type { OnDiskMigrationPackage } from '@prisma-next/migration-tools/package';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { isAbsolute, relative, resolve } from 'pathe';\nimport { type CliStructuredError, errorRuntime } from './cli-errors';\n\nexport function looksLikePath(target: string): boolean {\n  return target.includes('/') || target.includes('\\\\');\n}\n\nexport function resolveAppTargetPath(\n  target: string,\n  appMigrationsDir: string,\n  appMigrationsRelative: string,\n): Result<string, CliStructuredError> {\n  const targetPath = resolve(target);\n  const relativeToApp = relative(appMigrationsDir, targetPath);\n  const isOutsideAppDir =\n    relativeToApp === '' ||\n    relativeToApp === '.' ||\n    relativeToApp.startsWith('..') ||\n    isAbsolute(relativeToApp);\n  if (isOutsideAppDir) {\n    return notOk(\n      errorRuntime('Target must point to an app-space migration', {\n        why: `Expected a path under ${appMigrationsRelative}, got ${target}`,\n        fix: 'Pass an app-space migration directory or use a hash prefix.',\n      }),\n    );\n  }\n  return ok(targetPath);\n}\n\n/**\n * Resolve a filesystem-path target to the migration dir that contains it,\n * searching each in-scope space's `migrationsDir`. A path is explicit, so\n * it can belong to at most one space — returns the first match, or `null`\n * when the path falls outside every space dir.\n */\nexport function resolveTargetPathAcrossSpaces(\n  target: string,\n  spaces: ReadonlyArray<{ readonly migrationsDir: string }>,\n): string | null {\n  const targetPath = resolve(target);\n  for (const space of spaces) {\n    const rel = relative(space.migrationsDir, targetPath);\n    const isOutside = rel === '' || rel === '.' || rel.startsWith('..') || isAbsolute(rel);\n    if (!isOutside) {\n      return targetPath;\n    }\n  }\n  return null;\n}\n\nexport function findPackageByDirPath(\n  packages: readonly OnDiskMigrationPackage[],\n  resolvedDirPath: string,\n): OnDiskMigrationPackage | undefined {\n  const normalized = resolve(resolvedDirPath);\n  return packages.find((p) => resolve(p.dirPath) === normalized);\n}\n"],"mappings":";;;;AAKA,SAAgB,cAAc,QAAyB;CACrD,OAAO,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,IAAI;AACrD;AAEA,SAAgB,qBACd,QACA,kBACA,uBACoC;CACpC,MAAM,aAAa,QAAQ,MAAM;CACjC,MAAM,gBAAgB,SAAS,kBAAkB,UAAU;CAM3D,IAJE,kBAAkB,MAClB,kBAAkB,OAClB,cAAc,WAAW,IAAI,KAC7B,WAAW,aAAa,GAExB,OAAO,MACL,aAAa,+CAA+C;EAC1D,KAAK,yBAAyB,sBAAsB,QAAQ;EAC5D,KAAK;CACP,CAAC,CACH;CAEF,OAAO,GAAG,UAAU;AACtB;;;;;;;AAQA,SAAgB,8BACd,QACA,QACe;CACf,MAAM,aAAa,QAAQ,MAAM;CACjC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,MAAM,SAAS,MAAM,eAAe,UAAU;EAEpD,IAAI,EADc,QAAQ,MAAM,QAAQ,OAAO,IAAI,WAAW,IAAI,KAAK,WAAW,GAAG,IAEnF,OAAO;CAEX;CACA,OAAO;AACT;AAEA,SAAgB,qBACd,UACA,iBACoC;CACpC,MAAM,aAAa,QAAQ,eAAe;CAC1C,OAAO,SAAS,MAAM,MAAM,QAAQ,EAAE,OAAO,MAAM,UAAU;AAC/D"}

package/dist/{migration-plan-CreSVtWZ.mjs → migration-plan-Pc4hCF1H.mjs}

@@ -1,22 +1,22 @@
-import { A as formatStyledHeader, B as errorContractValidationFailed, F as CliStructuredError, Q as errorPlanForgotTheFlag, W as errorFileNotFound, X as errorMigrationPlanningFailed, _ as createTerminalUI, ct as errorUnexpected, g as parseGlobalFlagsOrExit, it as errorSnapshotMissing, l as setCommandDescriptions, lt as mapMigrationToolsError, o as resolveContractPath, ot as errorTargetMigrationNotSupported, r as getTargetMigrations, s as resolveMigrationPaths, t as addGlobalOptions, u as setCommandExamples, ut as mapRefResolutionError, y as handleResult } from "./command-helpers-Cpq44aVa.mjs";
-import { t as assertFrameworkComponentsCompatible } from "./framework-components-CnbUbiJw.mjs";
-import { c as toExtensionInputs, i as loadContractSpaceAggregateForCli, t as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-D_3VeHVb.mjs";
-import { t as mapContractAtError } from "./contract-at-errors-D9gEjYtg.mjs";
+import { A as formatStyledHeader, B as errorContractValidationFailed, F as CliStructuredError, Q as errorPlanForgotTheFlag, W as errorFileNotFound, X as errorMigrationPlanningFailed, _ as createTerminalUI, ct as errorUnexpected, g as parseGlobalFlagsOrExit, it as errorSnapshotMissing, l as setCommandDescriptions, lt as mapMigrationToolsError, o as resolveContractPath, ot as errorTargetMigrationNotSupported, r as getTargetMigrations, s as resolveMigrationPaths, t as addGlobalOptions, u as setCommandExamples, ut as mapRefResolutionError, y as handleResult } from "./command-helpers-CVn3U9Uz.mjs";
+import { t as assertFrameworkComponentsCompatible } from "./framework-components-DUN-TYDg.mjs";
+import { c as toExtensionInputs, i as loadContractSpaceAggregateForCli, t as buildContractSpaceAggregate } from "./contract-space-aggregate-loader-B6E9LGa6.mjs";
+import { t as mapContractAtError } from "./contract-at-errors-C-l4-JEY.mjs";
 import { Command } from "commander";
 import { loadConfig } from "@prisma-next/config-loader";
 import { getEmittedArtifactPaths } from "@prisma-next/emitter";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { join, relative } from "pathe";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { readFile } from "node:fs/promises";
 import { createControlStack, hasOperationPreview } from "@prisma-next/framework-components/control";
-import { emitContractSpaceArtefacts, planAllSpaces, readContractSpaceHeadRef, spaceMigrationDirectory } from "@prisma-next/migration-tools/spaces";
+import { emitContractSpaceArtifacts, 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 { snapshotsImportPathFrom, writeContractSnapshot } from "@prisma-next/migration-tools/contract-snapshot-store";
 import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 import { computeMigrationHash } from "@prisma-next/migration-tools/hash";
-import { copyFilesWithRename, formatMigrationDirName, materialiseExtensionMigrationPackageIfMissing, writeMigrationPackage } from "@prisma-next/migration-tools/io";
+import { 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
 /**
@@ -25,9 +25,11 @@ import { deriveProvidedInvariants } from "@prisma-next/migration-tools/invariant
 * For every extension that exposes a `contractSpace`:
 *
 * 1. Read the on-disk head ref (returns `null` on first emit).
-* 2. Re-emit `contract.json` / `contract.d.ts` / `refs/head.json`
-*    unconditionally via {@link emitContractSpaceArtefacts}. The
-*    framework owns these files; re-emit is the contract.
+* 2. Write the head contract into the migrations-root snapshot store
+*    (write-if-absent, keyed by hash) and unconditionally re-emit
+*    `refs/head.json`, via {@link emitContractSpaceArtifacts}. The
+*    framework owns `refs/head.json`; re-emit is the contract for that
+*    file. The snapshot itself is only written once per distinct hash.
 * 3. Materialise any descriptor-shipped migration packages not yet on
 *    disk via {@link materialiseExtensionMigrationPackageIfMissing}.
 *    Existing packages are left untouched (by-existence skip).
@@ -44,20 +46,20 @@ import { deriveProvidedInvariants } from "@prisma-next/migration-tools/invariant
 * surface (`migrate`, `migration status`, the runner).
 */
 async function runContractSpaceSeedPhase(inputs) {
-	const planned = planAllSpaces(inputs.extensionPacks.filter((pack) => pack.contractSpace !== void 0).map((pack) => ({
+	const planned = planAllSpaces(inputs.extensions.filter((pack) => pack.contractSpace !== void 0).map((pack) => ({
 		spaceId: pack.id,
 		priorContract: null,
 		newContract: pack.contractSpace.contractJson,
 		__pack: pack.contractSpace
 	})), (input) => input.__pack.migrations);
 	const descriptorBySpace = /* @__PURE__ */ new Map();
-	for (const pack of inputs.extensionPacks) if (pack.contractSpace !== void 0) descriptorBySpace.set(pack.id, pack.contractSpace);
+	for (const pack of inputs.extensions) if (pack.contractSpace !== void 0) descriptorBySpace.set(pack.id, pack.contractSpace);
 	const seeded = [];
 	for (const space of planned) {
 		const descriptor = descriptorBySpace.get(space.spaceId);
 		if (descriptor === void 0) continue;
 		const priorHash = (await readContractSpaceHeadRef(inputs.migrationsDir, space.spaceId))?.hash ?? null;
-		await emitContractSpaceArtefacts(inputs.migrationsDir, space.spaceId, {
+		await emitContractSpaceArtifacts(inputs.migrationsDir, space.spaceId, {
 			contract: descriptor.contractJson,
 			contractDts: buildPlaceholderContractDts(space.spaceId),
 			headRef: {
@@ -109,7 +111,7 @@ function buildPlaceholderContractDts(spaceId) {
 }
 //#endregion
 //#region src/utils/plan-resolution.ts
-const FULL_HASH_PATTERN = /^sha256:([0-9a-f]{64}|empty)$/;
+const FULL_HASH_PATTERN = /^([0-9a-f]{64}|empty)$/;
 function looksLikeFullHash(input) {
 	return FULL_HASH_PATTERN.test(input);
 }
@@ -135,8 +137,8 @@ async function resolveContractRef(parsed, space, options) {
 	const refName = provenance.kind === "ref" ? provenance.refName : void 0;
 	try {
 		const at = await space.contractAt(hash, refName !== void 0 ? { refName } : void 0);
-		if (at.provenance === "snapshot") return ok({
-			kind: "snapshot",
+		if (at.provenance === "ref") return ok({
+			kind: "ref",
 			hash: at.hash,
 			contract: at.contract,
 			contractJson: at.contractJson,
@@ -147,8 +149,7 @@ async function resolveContractRef(parsed, space, options) {
 			hash: at.hash,
 			contract: at.contract,
 			contractJson: at.contractJson,
-			contractDts: at.contractDts,
-			sourceDir: at.sourceDir
+			contractDts: at.contractDts
 		});
 	} catch (error) {
 		return mapContractAtError(error, options?.artifactRole !== void 0 ? { artifactRole: options.artifactRole } : void 0);
@@ -163,8 +164,7 @@ async function resolveFromPolicy(parsed, input, refs, explicitFromLabel) {
 	if (resolution.value.kind === "graph-node") return ok({
 		kind: "graph-node",
 		fromHash: resolution.value.hash,
-		fromContract: resolution.value.contract,
-		sourceDir: resolution.value.sourceDir
+		fromContract: resolution.value.contract
 	});
 	const { hash, contract, contractJson, contractDts } = resolution.value;
 	if (graphIsEmpty(input.space)) return ok({
@@ -183,7 +183,7 @@ async function resolveFromPolicy(parsed, input, refs, explicitFromLabel) {
 		throw error;
 	}
 	return ok({
-		kind: "snapshot",
+		kind: "ref",
 		fromHash: hash,
 		fromContract: contract,
 		contractDts,
@@ -248,17 +248,7 @@ async function resolveToForPlan(optionsTo, input) {
 }
 //#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, ownership) {
+async function runPlannerLeg(planner, migrations, frameworkComponents, contract, fromContract, spaceId, ownership, snapshotsImportPath) {
 	const fromSchema = migrations.contractToSchema(fromContract, frameworkComponents);
 	const plannerResult = planner.plan({
 		contract,
@@ -272,7 +262,8 @@ async function runPlannerLeg(planner, migrations, frameworkComponents, contract,
 		fromContract,
 		frameworkComponents,
 		spaceId,
-		ownership
+		ownership,
+		snapshotsImportPath
 	});
 	if (plannerResult.kind === "failure") return notOk(errorMigrationPlanningFailed({ conflicts: plannerResult.conflicts }));
 	let plannedOps = [];
@@ -373,14 +364,13 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	let toArtifacts = null;
 	let fromContract = null;
 	let fromHash = null;
-	let fromContractSourceDir = null;
 	let snapshotStartContract = null;
 	let isAutoBaseline = false;
 	const tolerantAggregateResult = await loadContractSpaceAggregateForCli({
 		targetId: config.target.targetId,
 		migrationsDir,
 		appContract: toContract,
-		extensionPacks: config.extensionPacks ?? [],
+		extensions: config.extensions ?? [],
 		deserializeContract: (json) => familyInstance.deserializeContract(json)
 	});
 	if (!tolerantAggregateResult.ok) return notOk(tolerantAggregateResult.failure);
@@ -395,12 +385,12 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 		case "graph-node":
 			fromHash = resolutionResult.value.fromHash;
 			fromContract = resolutionResult.value.fromContract;
-			fromContractSourceDir = resolutionResult.value.sourceDir;
 			break;
-		case "snapshot":
+		case "ref":
 			fromHash = resolutionResult.value.fromHash;
 			fromContract = resolutionResult.value.fromContract;
 			snapshotStartContract = {
+				fromHash: resolutionResult.value.fromHash,
 				contractJson: resolutionResult.value.contractJson,
 				contractDts: resolutionResult.value.contractDts
 			};
@@ -409,6 +399,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			fromHash = resolutionResult.value.fromHash;
 			fromContract = resolutionResult.value.fromContract;
 			snapshotStartContract = {
+				fromHash: resolutionResult.value.fromHash,
 				contractJson: resolutionResult.value.contractJson,
 				contractDts: resolutionResult.value.contractDts
 			};
@@ -427,7 +418,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	}
 	const seedResult = await runContractSpaceSeedPhase({
 		migrationsDir,
-		extensionPacks: toExtensionInputs(config.extensionPacks ?? [])
+		extensions: toExtensionInputs(config.extensions ?? [])
 	});
 	if (!flags.json && !flags.quiet) {
 		for (const record of seedResult.seeded) if (record.action === "updated") {
@@ -455,7 +446,7 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 		targetId: config.target.targetId,
 		migrationsDir,
 		appContract: toContract,
-		extensionPacks: config.extensionPacks ?? [],
+		extensions: config.extensions ?? [],
 		deserializeContract: (json) => familyInstance.deserializeContract(json)
 	});
 	if (!aggregateResult.ok) return notOk(aggregateResult.failure);
@@ -463,21 +454,22 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 	const frameworkComponents = assertFrameworkComponentsCompatible(config.family.familyId, config.target.targetId, [
 		config.target,
 		config.adapter,
-		...config.extensionPacks ?? []
+		...config.extensions ?? []
 	]);
-	async function writeDestinationEndContract(packageDir) {
+	async function writeDestinationSnapshot(destHash) {
 		if (toArtifacts !== null) {
-			await writeSnapshotContractArtifacts(packageDir, toArtifacts.contractJson, toArtifacts.contractDts, "end-contract");
+			await writeContractSnapshot(migrationsDir, destHash, {
+				contractJson: toArtifacts.contractJson,
+				contractDts: toArtifacts.contractDts
+			});
 			return;
 		}
 		const destinationArtifacts = getEmittedArtifactPaths(contractPathAbsolute);
-		await copyFilesWithRename(packageDir, [{
-			sourcePath: destinationArtifacts.jsonPath,
-			destName: "end-contract.json"
-		}, {
-			sourcePath: destinationArtifacts.dtsPath,
-			destName: "end-contract.d.ts"
-		}]);
+		const [contractJsonRaw, contractDts] = await Promise.all([readFile(destinationArtifacts.jsonPath, "utf-8"), readFile(destinationArtifacts.dtsPath, "utf-8")]);
+		await writeContractSnapshot(migrationsDir, destHash, {
+			contractJson: JSON.parse(contractJsonRaw),
+			contractDts
+		});
 	}
 	try {
 		const planner = migrations.createPlanner(controlAdapter);
@@ -488,10 +480,13 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 			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, aggregate);
+			const baselineLeg = await runPlannerLeg(planner, migrations, frameworkComponents, fromContract, null, aggregate.app.spaceId, aggregate, snapshotsImportPathFrom(baselinePackageDir, migrationsDir));
 			if (!baselineLeg.ok) return notOk(baselineLeg.failure);
 			await writePlannedMigrationPackage(baselinePackageDir, null, fromHash, baselineTimestamp, baselineLeg.value);
-			await writeSnapshotContractArtifacts(baselinePackageDir, snapshotStartContract.contractJson, snapshotStartContract.contractDts, "end-contract");
+			await writeContractSnapshot(migrationsDir, fromHash, {
+				contractJson: snapshotStartContract.contractJson,
+				contractDts: snapshotStartContract.contractDts
+			});
 			if (fromHash === toStorageHash) {
 				const baselineOps = baselineLeg.value.hasPlaceholders ? [] : baselineLeg.value.plannedOps;
 				if (baselineLeg.value.hasPlaceholders) {
@@ -528,11 +523,14 @@ async function executeMigrationPlanCommand(options, flags, ui, startTime) {
 					timings: { total: Date.now() - startTime }
 				});
 			}
-			const deltaLeg = await runPlannerLeg(planner, migrations, frameworkComponents, aggregate.app.contract(), fromContract, aggregate.app.spaceId, aggregate);
+			const deltaLeg = await runPlannerLeg(planner, migrations, frameworkComponents, aggregate.app.contract(), fromContract, aggregate.app.spaceId, aggregate, snapshotsImportPathFrom(deltaPackageDir, migrationsDir));
 			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);
+			await writeDestinationSnapshot(toStorageHash);
+			await writeContractSnapshot(migrationsDir, fromHash, {
+				contractJson: snapshotStartContract.contractJson,
+				contractDts: snapshotStartContract.contractDts
+			});
 			const deltaOps = deltaLeg.value.hasPlaceholders ? [] : deltaLeg.value.plannedOps;
 			if (deltaLeg.value.hasPlaceholders) return ok({
 				ok: true,
@@ -568,20 +566,14 @@ async function executeMigrationPlanCommand(options, flags, ui, 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, aggregate);
+		const deltaLeg = await runPlannerLeg(planner, migrations, frameworkComponents, aggregate.app.contract(), fromContract, aggregate.app.spaceId, aggregate, snapshotsImportPathFrom(packageDir, migrationsDir));
 		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, [{
-				sourcePath: sourceArtifacts.jsonPath,
-				destName: "start-contract.json"
-			}, {
-				sourcePath: sourceArtifacts.dtsPath,
-				destName: "start-contract.d.ts"
-			}]);
-		} else if (snapshotStartContract !== null) await writeSnapshotStartContract(packageDir, snapshotStartContract.contractJson, snapshotStartContract.contractDts);
+		await writeDestinationSnapshot(toStorageHash);
+		if (snapshotStartContract !== null) await writeContractSnapshot(migrationsDir, snapshotStartContract.fromHash, {
+			contractJson: snapshotStartContract.contractJson,
+			contractDts: snapshotStartContract.contractDts
+		});
 		if (deltaLeg.value.hasPlaceholders) return ok({
 			ok: true,
 			noOp: false,
@@ -744,18 +736,16 @@ function formatMigrationPlanOutput(result, flags) {
 *
 * Note: matches `metadata.to` (the contract hash this migration produces),
 * not `metadata.migrationHash` (the package's content-addressed identity).
-* Tries exact match first, then prefix match (auto-prepending `sha256:` when
-* the needle omits the scheme). Returns the matched package on success, or a
-* discriminated failure indicating whether the prefix was ambiguous or simply
-* not found.
+* Tries exact match first, then prefix match. Returns the matched package on
+* success, or a discriminated failure indicating whether the prefix was
+* ambiguous or simply not found.
 *
 * @internal Exported for testing only.
 */
 function resolveBundleByPrefix(bundles, needle) {
 	const exact = bundles.find((p) => p.metadata.to === needle);
 	if (exact) return ok(exact);
-	const prefixWithScheme = needle.startsWith("sha256:") ? needle : `sha256:${needle}`;
-	const candidates = bundles.filter((p) => p.metadata.to.startsWith(prefixWithScheme));
+	const candidates = bundles.filter((p) => p.metadata.to.startsWith(needle));
 	if (candidates.length === 1) return ok(candidates[0]);
 	if (candidates.length > 1) return notOk({
 		reason: "ambiguous",
@@ -766,4 +756,4 @@ function resolveBundleByPrefix(bundles, needle) {
 //#endregion
 export { formatMigrationPlanOutput as n, resolveBundleByPrefix as r, createMigrationPlanCommand as t };
 
-//# sourceMappingURL=migration-plan-CreSVtWZ.mjs.map
+//# sourceMappingURL=migration-plan-Pc4hCF1H.mjs.map