@prisma-next/cli 0.16.0-dev.4 → 0.16.0-dev.5

package/dist/commands/ref.mjs

@@ -5,11 +5,11 @@ import { Command } from "commander";
 import { loadConfig } from "@prisma-next/config-loader";
 import { notOk, ok } from "@prisma-next/utils/result";
 import { join } from "pathe";
-import { readFile } from "node:fs/promises";
 import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
 import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 import { findLatestMigration, isGraphNode } from "@prisma-next/migration-tools/migration-graph";
 import { deleteRefPaired, readRefs, validateRefName, validateRefValue, writeRefPaired } from "@prisma-next/migration-tools/refs";
+import { contractSnapshotDir, readContractSnapshotJson } from "@prisma-next/migration-tools/contract-snapshot-store";
 import { parseContractRef } from "@prisma-next/migration-tools/ref-resolution";
 //#region src/commands/ref.ts
 function mapError(error) {
@@ -47,17 +47,15 @@ async function executeRefSetCommand(name, contractInput, options) {
 			const graphTip = findLatestMigration(graph)?.to ?? null;
 			return notOk(errorRefSetHashNotInGraph(resolvedHash, [...graph.nodes].sort(), graphTip));
 		}
-		const matchingBundle = bundles.find((bundle) => bundle.metadata.to === resolvedHash);
-		if (!matchingBundle) return notOk(errorRefSetBundleNotFound(resolvedHash));
-		const contractJsonPath = join(matchingBundle.dirPath, "end-contract.json");
+		if (!bundles.find((bundle) => bundle.metadata.to === resolvedHash)) return notOk(errorRefSetBundleNotFound(resolvedHash));
+		const contractJsonPath = join(contractSnapshotDir(migrationsDir, resolvedHash), "contract.json");
 		let contractJson;
 		try {
-			const raw = await readFile(contractJsonPath, "utf-8");
-			contractJson = JSON.parse(raw);
+			contractJson = await readContractSnapshotJson(migrationsDir, resolvedHash);
 		} catch (readError) {
-			if (readError instanceof Error && readError.code === "ENOENT") return notOk(errorFileNotFound(contractJsonPath, {
-				why: `Migration bundle for hash ${resolvedHash} is missing its end-contract snapshot at ${contractJsonPath}`,
-				fix: "Run `pnpm fixtures:check`, or re-emit the migration so its end-contract.json is restored."
+			if (MigrationToolsError.is(readError) && readError.code === "MIGRATION.CONTRACT_SNAPSHOT_MISSING") return notOk(errorFileNotFound(contractJsonPath, {
+				why: `Migration bundle for hash ${resolvedHash} is missing its contract snapshot at ${contractJsonPath}`,
+				fix: "Restore migrations/snapshots/ from version control, or re-run the command that produced this migration to regenerate its snapshot."
 			}));
 			throw readError;
 		}

package/dist/commands/ref.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref.mjs","names":[],"sources":["../../src/commands/ref.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { loadConfig } from '@prisma-next/config-loader';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRefPaired,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRefPaired,\n} from '@prisma-next/migration-tools/refs';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join } from 'pathe';\nimport {\n  CliStructuredError,\n  errorFileNotFound,\n  errorRefSetBundleNotFound,\n  errorRefSetEmptySentinel,\n  errorRefSetHashNotInGraph,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { buildReadAggregate } from '../utils/contract-space-aggregate-loader';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return mapMigrationToolsError(error);\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nexport async function executeRefSetCommand(\n  name: string,\n  contractInput: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { migrationsDir, refsDir } = resolveMigrationPaths(options.config, config);\n    const loaded = await buildReadAggregate(config, { migrationsDir });\n    if (!loaded.ok) {\n      return notOk(loaded.failure);\n    }\n    const graph = loaded.value.aggregate.app.graph();\n    const bundles = loaded.value.aggregate.app.packages;\n    const refs = loaded.value.aggregate.app.refs;\n\n    let resolvedHash: string;\n    if (validateRefValue(contractInput)) {\n      resolvedHash = contractInput;\n    } else {\n      const refResult = parseContractRef(contractInput, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      resolvedHash = refResult.value.hash;\n    }\n\n    if (resolvedHash === EMPTY_CONTRACT_HASH) {\n      return notOk(errorRefSetEmptySentinel(resolvedHash));\n    }\n    if (!isGraphNode(resolvedHash, graph)) {\n      const graphTip = findLatestMigration(graph)?.to ?? null;\n      return notOk(errorRefSetHashNotInGraph(resolvedHash, [...graph.nodes].sort(), graphTip));\n    }\n\n    const matchingBundle = bundles.find((bundle) => bundle.metadata.to === resolvedHash);\n    if (!matchingBundle) {\n      return notOk(errorRefSetBundleNotFound(resolvedHash));\n    }\n\n    const contractJsonPath = join(matchingBundle.dirPath, 'end-contract.json');\n    let contractJson: Record<string, unknown>;\n    try {\n      const raw = await readFile(contractJsonPath, 'utf-8');\n      contractJson = JSON.parse(raw) as Record<string, unknown>;\n    } catch (readError) {\n      if (readError instanceof Error && (readError as NodeJS.ErrnoException).code === 'ENOENT') {\n        return notOk(\n          errorFileNotFound(contractJsonPath, {\n            why: `Migration bundle for hash ${resolvedHash} is missing its end-contract snapshot at ${contractJsonPath}`,\n            fix: 'Run `pnpm fixtures:check`, or re-emit the migration so its end-contract.json is restored.',\n          }),\n        );\n      }\n      throw readError;\n    }\n\n    const contractIR = await readContractIR(contractJson, contractJsonPath);\n    const entry: RefEntry = { hash: resolvedHash, invariants: [] };\n    await writeRefPaired(refsDir, name, entry, contractIR);\n    return ok({ ok: true as const, ref: name, hash: resolvedHash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nexport async function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRefPaired(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nexport async function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract reference',\n    'Sets a named ref to point to a resolved contract reference (hash, alias, or path) in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument(\n      '<contract>',\n      'Contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlagsOrExit(options);\n        const ui = createTerminalUI(flags);\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlagsOrExit(options);\n        const ui = createTerminalUI(flags);\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport function createRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage contract refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":"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"}
+{"version":3,"file":"ref.mjs","names":[],"sources":["../../src/commands/ref.ts"],"sourcesContent":["import { loadConfig } from '@prisma-next/config-loader';\nimport { EMPTY_CONTRACT_HASH } from '@prisma-next/migration-tools/constants';\nimport {\n  contractSnapshotDir,\n  readContractSnapshotJson,\n} from '@prisma-next/migration-tools/contract-snapshot-store';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { findLatestMigration, isGraphNode } from '@prisma-next/migration-tools/migration-graph';\nimport { parseContractRef } from '@prisma-next/migration-tools/ref-resolution';\nimport type { RefEntry } from '@prisma-next/migration-tools/refs';\nimport {\n  deleteRefPaired,\n  readRefs,\n  validateRefName,\n  validateRefValue,\n  writeRefPaired,\n} from '@prisma-next/migration-tools/refs';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { join } from 'pathe';\nimport {\n  CliStructuredError,\n  errorFileNotFound,\n  errorRefSetBundleNotFound,\n  errorRefSetEmptySentinel,\n  errorRefSetHashNotInGraph,\n  errorRuntime,\n  errorUnexpected,\n  mapMigrationToolsError,\n  mapRefResolutionError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n} from '../utils/command-helpers';\nimport { buildReadAggregate } from '../utils/contract-space-aggregate-loader';\nimport { formatCommandHelp } from '../utils/formatters/help';\nimport { parseGlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { readContractIR } from '../utils/ref-advancement';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI } from '../utils/terminal-ui';\n\ninterface RefSetResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly hash: string;\n  readonly invariants: readonly string[];\n}\n\ninterface RefDeleteResult {\n  readonly ok: true;\n  readonly ref: string;\n  readonly deleted: true;\n}\n\ninterface RefListResult {\n  readonly ok: true;\n  readonly refs: Record<string, RefEntry>;\n}\n\nfunction mapError(error: unknown): CliStructuredError {\n  if (MigrationToolsError.is(error)) {\n    return mapMigrationToolsError(error);\n  }\n  return errorUnexpected(error instanceof Error ? error.message : String(error));\n}\n\nfunction cliErrorInvalidRefName(name: string): CliStructuredError {\n  return errorRuntime(`Invalid ref name \"${name}\"`, {\n    why: `Ref name \"${name}\" does not match the required format`,\n    fix: 'Ref names must be lowercase alphanumeric with hyphens or forward slashes, no `.` or `..` segments',\n  });\n}\n\nexport async function executeRefSetCommand(\n  name: string,\n  contractInput: string,\n  options: { config?: string },\n): Promise<Result<RefSetResult, CliStructuredError>> {\n  if (!validateRefName(name)) {\n    return notOk(cliErrorInvalidRefName(name));\n  }\n\n  try {\n    const config = await loadConfig(options.config);\n    const { migrationsDir, refsDir } = resolveMigrationPaths(options.config, config);\n    const loaded = await buildReadAggregate(config, { migrationsDir });\n    if (!loaded.ok) {\n      return notOk(loaded.failure);\n    }\n    const graph = loaded.value.aggregate.app.graph();\n    const bundles = loaded.value.aggregate.app.packages;\n    const refs = loaded.value.aggregate.app.refs;\n\n    let resolvedHash: string;\n    if (validateRefValue(contractInput)) {\n      resolvedHash = contractInput;\n    } else {\n      const refResult = parseContractRef(contractInput, { graph, refs });\n      if (!refResult.ok) {\n        return notOk(mapRefResolutionError(refResult.failure));\n      }\n      resolvedHash = refResult.value.hash;\n    }\n\n    if (resolvedHash === EMPTY_CONTRACT_HASH) {\n      return notOk(errorRefSetEmptySentinel(resolvedHash));\n    }\n    if (!isGraphNode(resolvedHash, graph)) {\n      const graphTip = findLatestMigration(graph)?.to ?? null;\n      return notOk(errorRefSetHashNotInGraph(resolvedHash, [...graph.nodes].sort(), graphTip));\n    }\n\n    const matchingBundle = bundles.find((bundle) => bundle.metadata.to === resolvedHash);\n    if (!matchingBundle) {\n      return notOk(errorRefSetBundleNotFound(resolvedHash));\n    }\n\n    const contractJsonPath = join(\n      contractSnapshotDir(migrationsDir, resolvedHash),\n      'contract.json',\n    );\n    let contractJson: Record<string, unknown>;\n    try {\n      contractJson = (await readContractSnapshotJson(migrationsDir, resolvedHash)) as Record<\n        string,\n        unknown\n      >;\n    } catch (readError) {\n      if (\n        MigrationToolsError.is(readError) &&\n        readError.code === 'MIGRATION.CONTRACT_SNAPSHOT_MISSING'\n      ) {\n        return notOk(\n          errorFileNotFound(contractJsonPath, {\n            why: `Migration bundle for hash ${resolvedHash} is missing its contract snapshot at ${contractJsonPath}`,\n            fix: 'Restore migrations/snapshots/ from version control, or re-run the command that produced this migration to regenerate its snapshot.',\n          }),\n        );\n      }\n      throw readError;\n    }\n\n    const contractIR = await readContractIR(contractJson, contractJsonPath);\n    const entry: RefEntry = { hash: resolvedHash, invariants: [] };\n    await writeRefPaired(refsDir, name, entry, contractIR);\n    return ok({ ok: true as const, ref: name, hash: resolvedHash, invariants: [] });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nexport async function executeRefDeleteCommand(\n  name: string,\n  options: { config?: string },\n): Promise<Result<RefDeleteResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    await deleteRefPaired(refsDir, name);\n    return ok({ ok: true as const, ref: name, deleted: true as const });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nexport async function executeRefListCommand(options: {\n  config?: string;\n}): Promise<Result<RefListResult, CliStructuredError>> {\n  try {\n    const config = await loadConfig(options.config);\n    const { refsDir } = resolveMigrationPaths(options.config, config);\n    const refs = await readRefs(refsDir);\n    return ok({ ok: true as const, refs });\n  } catch (error) {\n    if (error instanceof CliStructuredError) return notOk(error);\n    return notOk(mapError(error));\n  }\n}\n\nfunction createRefSetCommand(): Command {\n  const command = new Command('set');\n  setCommandDescriptions(\n    command,\n    'Set a ref to a contract reference',\n    'Sets a named ref to point to a resolved contract reference (hash, alias, or path) in migrations/refs/.',\n  );\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name (e.g., staging, production)')\n    .argument(\n      '<contract>',\n      'Contract reference (hash, prefix, ref name, migration dir name, <dir>^, or ./path)',\n    )\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        hash: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlagsOrExit(options);\n        const ui = createTerminalUI(flags);\n        const result = await executeRefSetCommand(name, hash, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Set ref \"${value.ref}\" → ${value.hash}`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefDeleteCommand(): Command {\n  const command = new Command('delete');\n  setCommandDescriptions(command, 'Delete a ref', 'Removes a named ref from migrations/refs/.');\n  addGlobalOptions(command)\n    .argument('<name>', 'Ref name to delete')\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(\n      async (\n        name: string,\n        options: { config?: string; json?: string | boolean; quiet?: boolean },\n      ) => {\n        const flags = parseGlobalFlagsOrExit(options);\n        const ui = createTerminalUI(flags);\n        const result = await executeRefDeleteCommand(name, options);\n        const exitCode = handleResult(result, flags, ui, (value) => {\n          if (flags.json) {\n            ui.output(JSON.stringify(value));\n          } else if (!flags.quiet) {\n            ui.output(`Deleted ref \"${value.ref}\"`);\n          }\n        });\n        process.exit(exitCode);\n      },\n    );\n  return command;\n}\n\nfunction createRefListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(command, 'List all refs', 'Lists all named refs from migrations/refs/.');\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .action(async (options: { config?: string; json?: string | boolean; quiet?: boolean }) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeRefListCommand(options);\n      const exitCode = handleResult(result, flags, ui, (value) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(value));\n        } else if (!flags.quiet) {\n          const entries = Object.entries(value.refs);\n          if (entries.length === 0) {\n            ui.output('No refs defined');\n          } else {\n            for (const [refName, entry] of entries) {\n              const invariantsSuffix =\n                entry.invariants.length > 0 ? ` [invariants: ${entry.invariants.join(', ')}]` : '';\n              ui.output(`${refName} → ${entry.hash}${invariantsSuffix}`);\n            }\n          }\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n\nexport function createRefCommand(): Command {\n  const command = new Command('ref');\n  setCommandDescriptions(\n    command,\n    'Manage contract refs',\n    'Manage named refs in migrations/refs/. Refs map logical environment\\n' +\n      'names (e.g., staging, production) to contract hashes.',\n  );\n  addGlobalOptions(command).configureHelp({\n    formatHelp: (cmd) => formatCommandHelp({ command: cmd, flags: parseGlobalFlags({}) }),\n    subcommandDescription: () => '',\n  });\n  command.addCommand(createRefSetCommand());\n  command.addCommand(createRefDeleteCommand());\n  command.addCommand(createRefListCommand());\n  return command;\n}\n"],"mappings":"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"}

package/dist/{contract-at-errors-D9gEjYtg.mjs → contract-at-errors-CTtzKR6q.mjs}

@@ -1,6 +1,5 @@
 import { B as errorContractValidationFailed, F as CliStructuredError, W as errorFileNotFound, ct as errorUnexpected, it as errorSnapshotMissing, lt as mapMigrationToolsError } from "./command-helpers-Cpq44aVa.mjs";
 import { notOk } from "@prisma-next/utils/result";
-import { join } from "pathe";
 import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 //#region src/utils/contract-at-errors.ts
 function mapContractAtError(error, options) {
@@ -21,14 +20,11 @@ function mapContractAtError(error, options) {
 			why: error.why,
 			fix: error.fix
 		}));
-		case "MIGRATION.FILE_MISSING": {
-			const file = typeof error.details?.["file"] === "string" ? error.details["file"] : "end-contract.json";
-			const dir = typeof error.details?.["dir"] === "string" ? error.details["dir"] : "";
-			const jsonPath = dir ? join(dir, "end-contract.json") : file;
-			const role = options?.artifactRole ?? "from";
-			return notOk(errorFileNotFound(jsonPath, {
-				why: role === "to" ? `Target migration is missing its destination contract snapshot at ${jsonPath}` : `Predecessor migration is missing its destination contract snapshot at ${jsonPath}`,
-				fix: role === "to" ? "Re-emit the target migration so its sibling `end-contract.json` / `end-contract.d.ts` are restored, then re-run this command." : "Re-emit the predecessor migration (`prisma-next migration plan` from its source) so its sibling `end-contract.json` is restored, then re-run this command."
+		case "MIGRATION.CONTRACT_SNAPSHOT_MISSING": {
+			const expectedPath = typeof error.details?.["expectedPath"] === "string" ? error.details["expectedPath"] : "migrations/snapshots/";
+			return notOk(errorFileNotFound(expectedPath, {
+				why: (options?.artifactRole ?? "from") === "to" ? `Target migration is missing its contract snapshot at ${expectedPath}` : `Predecessor migration is missing its contract snapshot at ${expectedPath}`,
+				fix: "Restore migrations/snapshots/ from version control, or re-run the command that produced this migration to regenerate its snapshot."
 			}));
 		}
 		default: return notOk(mapMigrationToolsError(error));
@@ -39,4 +35,4 @@ function mapContractAtError(error, options) {
 //#endregion
 export { mapContractAtError as t };
 
-//# sourceMappingURL=contract-at-errors-D9gEjYtg.mjs.map
+//# sourceMappingURL=contract-at-errors-CTtzKR6q.mjs.map

package/dist/contract-at-errors-CTtzKR6q.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-at-errors-CTtzKR6q.mjs","names":[],"sources":["../src/utils/contract-at-errors.ts"],"sourcesContent":["import { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport { notOk, type Result } from '@prisma-next/utils/result';\nimport {\n  CliStructuredError,\n  errorContractValidationFailed,\n  errorFileNotFound,\n  errorSnapshotMissing,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from './cli-errors';\n\nexport function mapContractAtError(\n  error: unknown,\n  options?: { readonly artifactRole?: 'from' | 'to' },\n): Result<never, CliStructuredError> {\n  if (MigrationToolsError.is(error)) {\n    switch (error.code) {\n      case 'MIGRATION.SNAPSHOT_MISSING': {\n        const refName =\n          typeof error.details?.['refName'] === 'string'\n            ? error.details['refName']\n            : typeof error.details?.['identifier'] === 'string'\n              ? error.details['identifier']\n              : 'unknown';\n        return notOk(errorSnapshotMissing(refName));\n      }\n      case 'MIGRATION.CONTRACT_DESERIALIZATION_FAILED': {\n        const filePath =\n          typeof error.details?.['filePath'] === 'string'\n            ? error.details['filePath']\n            : 'ref-snapshot';\n        const message =\n          typeof error.details?.['message'] === 'string' ? error.details['message'] : error.message;\n        const isRefSnapshot = filePath.endsWith('.contract.json');\n        return notOk(\n          errorContractValidationFailed(\n            isRefSnapshot\n              ? `Ref snapshot contract failed to deserialize: ${message}`\n              : `Predecessor contract at ${filePath} failed to deserialize: ${message}`,\n            { where: { path: isRefSnapshot ? 'ref-snapshot' : filePath } },\n          ),\n        );\n      }\n      case 'MIGRATION.INVALID_JSON': {\n        const filePath =\n          typeof error.details?.['filePath'] === 'string' ? error.details['filePath'] : 'unknown';\n        const message =\n          typeof error.details?.['parseError'] === 'string'\n            ? error.details['parseError']\n            : error.message;\n        const role = options?.artifactRole ?? 'from';\n        return notOk(\n          errorContractValidationFailed(\n            role === 'to'\n              ? `Target contract at ${filePath} failed to deserialize: ${message}`\n              : `Predecessor contract at ${filePath} failed to deserialize: ${message}`,\n            { where: { path: filePath } },\n          ),\n        );\n      }\n      case 'MIGRATION.BUNDLE_NOT_FOUND_FOR_GRAPH_NODE':\n        return notOk(\n          errorUnexpected(error.message, {\n            why: error.why,\n            fix: error.fix,\n          }),\n        );\n      case 'MIGRATION.CONTRACT_SNAPSHOT_MISSING': {\n        const expectedPath =\n          typeof error.details?.['expectedPath'] === 'string'\n            ? error.details['expectedPath']\n            : 'migrations/snapshots/';\n        const role = options?.artifactRole ?? 'from';\n        return notOk(\n          errorFileNotFound(expectedPath, {\n            why:\n              role === 'to'\n                ? `Target migration is missing its contract snapshot at ${expectedPath}`\n                : `Predecessor migration is missing its contract snapshot at ${expectedPath}`,\n            fix: 'Restore migrations/snapshots/ from version control, or re-run the command that produced this migration to regenerate its snapshot.',\n          }),\n        );\n      }\n      default:\n        return notOk(mapMigrationToolsError(error));\n    }\n  }\n  if (CliStructuredError.is(error)) {\n    return notOk(error);\n  }\n  throw error;\n}\n"],"mappings":";;;;AAWA,SAAgB,mBACd,OACA,SACmC;CACnC,IAAI,oBAAoB,GAAG,KAAK,GAC9B,QAAQ,MAAM,MAAd;EACE,KAAK,8BAOH,OAAO,MAAM,qBALX,OAAO,MAAM,UAAU,eAAe,WAClC,MAAM,QAAQ,aACd,OAAO,MAAM,UAAU,kBAAkB,WACvC,MAAM,QAAQ,gBACd,SACiC,CAAC;EAE5C,KAAK,6CAA6C;GAChD,MAAM,WACJ,OAAO,MAAM,UAAU,gBAAgB,WACnC,MAAM,QAAQ,cACd;GACN,MAAM,UACJ,OAAO,MAAM,UAAU,eAAe,WAAW,MAAM,QAAQ,aAAa,MAAM;GACpF,MAAM,gBAAgB,SAAS,SAAS,gBAAgB;GACxD,OAAO,MACL,8BACE,gBACI,gDAAgD,YAChD,2BAA2B,SAAS,0BAA0B,WAClE,EAAE,OAAO,EAAE,MAAM,gBAAgB,iBAAiB,SAAS,EAAE,CAC/D,CACF;EACF;EACA,KAAK,0BAA0B;GAC7B,MAAM,WACJ,OAAO,MAAM,UAAU,gBAAgB,WAAW,MAAM,QAAQ,cAAc;GAChF,MAAM,UACJ,OAAO,MAAM,UAAU,kBAAkB,WACrC,MAAM,QAAQ,gBACd,MAAM;GAEZ,OAAO,MACL,+BAFW,SAAS,gBAAgB,YAGzB,OACL,sBAAsB,SAAS,0BAA0B,YACzD,2BAA2B,SAAS,0BAA0B,WAClE,EAAE,OAAO,EAAE,MAAM,SAAS,EAAE,CAC9B,CACF;EACF;EACA,KAAK,6CACH,OAAO,MACL,gBAAgB,MAAM,SAAS;GAC7B,KAAK,MAAM;GACX,KAAK,MAAM;EACb,CAAC,CACH;EACF,KAAK,uCAAuC;GAC1C,MAAM,eACJ,OAAO,MAAM,UAAU,oBAAoB,WACvC,MAAM,QAAQ,kBACd;GAEN,OAAO,MACL,kBAAkB,cAAc;IAC9B,MAHS,SAAS,gBAAgB,YAIvB,OACL,wDAAwD,iBACxD,6DAA6D;IACnE,KAAK;GACP,CAAC,CACH;EACF;EACA,SACE,OAAO,MAAM,uBAAuB,KAAK,CAAC;CAC9C;CAEF,IAAI,mBAAmB,GAAG,KAAK,GAC7B,OAAO,MAAM,KAAK;CAEpB,MAAM;AACR"}

package/dist/exports/init-output.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"init-output.d.mts","names":[],"sources":["../../src/commands/init/output.ts"],"mappings":";;;;;;;;;;;;;;;;cAkBa,gEAAgB;;;;;;;;;;;;;;;;KAwBjB,oBAAoB,iBAAiB"}
+{"version":3,"file":"init-output.d.mts","names":[],"sources":["../../src/commands/init/output.ts"],"mappings":";;;;;;;;;;;;;;;;cAkBa,gEAAgB;;;;;;;;;;;;;;;;KAuBjB,oBAAoB,iBAAiB"}

package/dist/exports/init-output.mjs

@@ -1,2 +1,2 @@
-import { t as InitOutputSchema } from "../output-mEQ74_nd.mjs";
+import { t as InitOutputSchema } from "../output-DWNYqZGc.mjs";
 export { InitOutputSchema };

package/dist/{init-C3JhkHg-.mjs → init-CgKEi_t5.mjs}

@@ -1,6 +1,6 @@
 import { F as CliStructuredError, _ as createTerminalUI, b as formatErrorJson, x as formatErrorOutput } from "./command-helpers-Cpq44aVa.mjs";
 import { a as starterSchema, c as version, i as schemaSample, n as dbFile, o as targetLabel, r as defaultSchemaPath, s as targetPackageName, t as configFile } from "./cli.mjs";
-import { i as renderInitOutro, n as buildNextSteps, r as formatInitJson, t as InitOutputSchema } from "./output-mEQ74_nd.mjs";
+import { i as renderInitOutro, n as buildNextSteps, r as formatInitJson, t as InitOutputSchema } from "./output-DWNYqZGc.mjs";
 import { createRequire } from "node:module";
 import { basename, dirname, extname, isAbsolute, join, normalize } from "pathe";
 import { blindCast } from "@prisma-next/utils/casts";
@@ -413,50 +413,59 @@ function errorInitSkillInstallFailed(options) {
 //#endregion
 //#region src/commands/init/hygiene-gitattributes.ts
 /**
-* The schema-relative `.gitattributes` entries written for a freshly
-* initialised project (FR3.4). Mirrors the relevant subset of the
-* repo-root [`.gitattributes`](../../../../../../../../.gitattributes):
+* The `.gitattributes` entries written for a freshly initialised project
+* (FR3.4). Mirrors the relevant subset of the repo-root
+* [`.gitattributes`](../../../../../../../../.gitattributes):
 *
 * - **Today**: `contract.json`, `contract.d.ts` are emitted on every
 *   `prisma-next contract emit`. Marking them `linguist-generated`
 *   keeps GitHub's diff stats honest and collapses the file in code
 *   review by default.
-* - **Forward-looking**: `end-contract.*`, `start-contract.*`, `ops.json`,
-*   `migration.json` are not yet emitted by `init` flows but will be
-*   produced by adjacent commands (lower / migration tooling). Adding
-*   them now matches Decision 5 (forward-looking subset) so the file
-*   does not need to be amended every time a new artefact lands.
-*
-* Patterns are written relative to the schema directory so a user
-* who runs `init --schema-path db/contract.prisma` gets
-* `db/contract.json linguist-generated` — not the workspace-glob form
-* `<glob>/contract.json` (which would over-match any unrelated
+* - **Forward-looking**: `ops.json`, `migration.json` are not yet emitted
+*   by `init` flows but will be produced by adjacent commands (lower /
+*   migration tooling). Adding them now matches Decision 5
+*   (forward-looking subset) so the file does not need to be amended
+*   every time a new artifact lands.
+*
+* `ARTIFACT_FILENAMES` entries are written relative to the schema
+* directory so a user who runs `init --schema-path db/contract.prisma`
+* gets `db/contract.json linguist-generated` — not the workspace-glob
+* form `<glob>/contract.json` (which would over-match any unrelated
 * `contract.json` the user has elsewhere) and not the absolute
-* `DEFAULT_CONTRACT_SOURCE_DIR/contract.json` (which would silently break for a non-default
-* schema path).
+* `DEFAULT_CONTRACT_SOURCE_DIR/contract.json` (which would silently
+* break for a non-default schema path).
+*
+* The migration contract snapshot store (`migrations/snapshots/<hex>/`)
+* is anchored to the migrations root instead, not the schema directory:
+* migration package depth under `migrations/` varies (`app/<pkg>`,
+* `<space>/<pkg>`, or a bare `<pkg>` in extension source repos), so no
+* single schema-dir-relative pattern can reach every snapshot. See
+* `STORE_GITATTRIBUTES_LINES` below.
 */
-const ARTEFACT_FILENAMES$1 = [
+const ARTIFACT_FILENAMES$1 = [
 	"contract.json",
 	"contract.d.ts",
-	"end-contract.json",
-	"end-contract.d.ts",
-	"start-contract.json",
-	"start-contract.d.ts",
 	"ops.json",
 	"migration.json"
 ];
 const ATTRIBUTE = "linguist-generated";
 /**
+* Full `.gitattributes` lines for the migration contract snapshot store,
+* already anchored to the migrations root — unlike `ARTIFACT_FILENAMES`,
+* these are not combined with the schema-relative prefix.
+*/
+const STORE_GITATTRIBUTES_LINES = [`migrations/snapshots/**/contract.json ${ATTRIBUTE}`, `migrations/snapshots/**/contract.d.ts ${ATTRIBUTE}`];
+/**
 * Computes the `.gitattributes` lines this scaffold expects to own. Each
 * line has the shape `<path> linguist-generated`. The `target` parameter
 * is currently unused but accepted for symmetry with the other hygiene
 * helpers and to leave room for target-specific entries (e.g. a future
-* Mongo-only artefact) without a signature break.
+* family-specific artifact) without a signature break.
 */
 function requiredGitattributesLines(schemaDir, _target) {
 	const dir = schemaDir === "." ? "" : schemaDir.replace(/\/+$/, "");
 	const prefix = dir === "" ? "" : `${dir}/`;
-	return ARTEFACT_FILENAMES$1.map((file) => `${prefix}${file} ${ATTRIBUTE}`);
+	return [...ARTIFACT_FILENAMES$1.map((file) => `${prefix}${file} ${ATTRIBUTE}`), ...STORE_GITATTRIBUTES_LINES];
 }
 /**
 * Idempotent `.gitattributes` merge (FR3.4 / FR9.3). Returns the new file
@@ -1037,40 +1046,39 @@ function requirePeer(moduleId, baseDir, overrides) {
 /**
 * Filenames the contract pipeline emits next to the user's schema source
 * (`<schemaDir>/contract.json`, `<schemaDir>/contract.d.ts`, …). Mirrors
-* `ARTEFACT_FILENAMES` in `hygiene-gitattributes.ts`; kept as a separate
-* constant here because the cleanup contract is target-agnostic and we
-* deliberately do not want a stale `start-contract.json` from a previous
-* target lingering after a re-init.
-*
-* If a future emit pipeline produces an additional artefact, add it here
-* **and** to the gitattributes list — the two stay in lockstep so the
-* file `init` advertises as `linguist-generated` is exactly the file
-* `init` is willing to delete on re-init.
-*/
-const ARTEFACT_FILENAMES = [
+* the schema-dir-relative `ARTIFACT_FILENAMES` in `hygiene-gitattributes.ts`
+* (not that file's migrations-root-anchored store lines, which are outside
+* this command's scope — reinit only ever touches `schemaDir`); kept as a
+* separate constant here because the cleanup contract is target-agnostic
+* and we deliberately do not want a stale artifact from a previous target
+* lingering after a re-init.
+*
+* If a future emit pipeline produces an additional schema-dir artifact,
+* add it here **and** to `ARTIFACT_FILENAMES` in `hygiene-gitattributes.ts`
+* — the two stay in lockstep so the file `init` advertises as
+* `linguist-generated` is exactly the file `init` is willing to delete on
+* re-init.
+*/
+const ARTIFACT_FILENAMES = [
 	"contract.json",
 	"contract.d.ts",
-	"end-contract.json",
-	"end-contract.d.ts",
-	"start-contract.json",
-	"start-contract.d.ts",
 	"ops.json",
 	"migration.json"
 ];
 /**
-* Returns the schema-relative paths of stale contract artefacts the
+* Returns the schema-relative paths of stale contract artifacts the
 * previous `init` run (or a `contract emit`) left behind in `schemaDir`.
 * Paths are returned relative to `baseDir` so the caller can plumb them
 * into `filesWritten`-style logging without re-deriving the path.
 *
 * Pure function: no filesystem mutation. Used by `runInit`'s precondition
 * phase (FR6.2 / NFR3 atomicity) so a downstream parse failure leaves
-* the artefacts on disk and the project byte-identical to its pre-init
+* the artifacts on disk and the project byte-identical to its pre-init
 * state.
 */
-function findStaleArtefacts(baseDir, schemaDir) {
+function findStaleArtifacts(baseDir, schemaDir) {
 	const result = [];
-	for (const filename of ARTEFACT_FILENAMES) {
+	for (const filename of ARTIFACT_FILENAMES) {
 		const rel = join(schemaDir, filename);
 		if (existsSync(join(baseDir, rel))) result.push(rel);
 	}
@@ -1669,7 +1677,7 @@ async function runInit(baseDir, runOptions) {
 			content: envExampleContent(inputs.target)
 		}
 	];
-	const filesToDelete = inputs.reinit ? [...findStaleArtefacts(baseDir, schemaDir)] : [];
+	const filesToDelete = inputs.reinit ? [...findStaleArtifacts(baseDir, schemaDir)] : [];
 	if (existsSync(join(baseDir, ".agents/skills/prisma-next/SKILL.md"))) filesToDelete.push(LEGACY_SKILL_FILE);
 	if (inputs.writeEnv) if (!existsSync(join(baseDir, ".env"))) filesToWrite.push({
 		path: ".env",
@@ -2081,7 +2089,7 @@ function formatCatalogWarning(workspaceFile, entries) {
 /**
 * Recognised pnpm error signatures that justify a fallback to npm.
 *
-* These patterns indicate the published artefact itself is at fault
+* These patterns indicate the published artifact itself is at fault
 * (a leaked `workspace:*` or `catalog:` specifier), not the user's
 * environment — pnpm is faithfully reporting "I cannot resolve this
 * registry version", and npm is willing to install it because npm
@@ -2193,4 +2201,4 @@ function sanitisePackageName(raw) {
 //#endregion
 export { runInit };
 
-//# sourceMappingURL=init-C3JhkHg-.mjs.map
+//# sourceMappingURL=init-CgKEi_t5.mjs.map