prisma-next 0.11.0-dev.47 → 0.11.0-dev.49

package/dist/migration-list-C2xnaYsT.mjs

@@ -1,279 +0,0 @@
-import { t as loadConfig } from "./config-loader-B6sJjXTv.mjs";
-import { O as errorUnexpected, T as errorSpaceNotFound, f as errorInvalidSpaceId, k as mapMigrationToolsError } from "./cli-errors-DFF1LlfU.mjs";
-import { A as formatStyledHeader, C as formatMigrationDataColumn, S as computeMigrationDirNameWidth, d as setCommandDescriptions, f as setCommandExamples, l as resolveMigrationPaths, p as setCommandSeeAlso, t as addGlobalOptions, v as parseGlobalFlagsOrExit, w as handleResult, x as renderMigrationListGraphResult, y as createTerminalUI } from "./command-helpers-CI8P5Xyd.mjs";
-import { Command } from "commander";
-import { ifDefined } from "@prisma-next/utils/defined";
-import { notOk, ok } from "@prisma-next/utils/result";
-import { APP_SPACE_ID, isValidSpaceId } from "@prisma-next/migration-tools/spaces";
-import { bold, cyan, cyanBright, dim, green, greenBright, yellow } from "colorette";
-import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
-import { enumerateMigrationSpaces } from "@prisma-next/migration-tools/enumerate-migration-spaces";
-import { classifyMigrationListGraphTopology } from "@prisma-next/migration-tools/migration-list-graph-topology";
-//#region src/utils/formatters/migration-list-render.ts
-const KIND_GLYPH = {
-	forward: "*",
-	rollback: "↩",
-	self: "⟲"
-};
-const IDENTITY_MIGRATION_LIST_STYLER = {
-	kind: (text) => text,
-	dirName: (text) => text,
-	sourceHash: (text) => text,
-	destHash: (text) => text,
-	glyph: (text) => text,
-	lane: (text) => text,
-	invariants: (ids) => `{${ids.join(", ")}}`,
-	refs: (names) => `(${names.join(", ")})`,
-	spaceHeading: (text) => text,
-	summary: (text) => text,
-	emptyState: (text) => text
-};
-function resolveEdgeKind(migrationHash, kindByMigrationHash) {
-	return kindByMigrationHash.get(migrationHash) ?? "forward";
-}
-function formatMigrationRow(migration, dirNameWidth, edgeKind, style) {
-	return `${`${style.kind(KIND_GLYPH[edgeKind])} `}${formatMigrationDataColumn(migration, {
-		dirNameWidth,
-		edgeKind,
-		style,
-		forwardArrow: "→"
-	})}`;
-}
-function formatEmptyStateLine(spaceId, style) {
-	return style.emptyState(`There are no migrations in migrations/${spaceId}/ yet`);
-}
-function renderSpaceBlock(spaceId, migrations, multiSpace, style) {
-	if (migrations.length === 0) {
-		const emptyLine = formatEmptyStateLine(spaceId, style);
-		if (!multiSpace) return [emptyLine];
-		return [style.spaceHeading(`${spaceId}:`), `  ${emptyLine}`];
-	}
-	const kindByMigrationHash = classifyMigrationListGraphTopology(migrations).kindByMigrationHash;
-	const dirNameWidth = computeMigrationDirNameWidth(migrations);
-	const rows = migrations.map((entry) => formatMigrationRow(entry, dirNameWidth, resolveEdgeKind(entry.migrationHash, kindByMigrationHash), style));
-	if (!multiSpace) return rows;
-	return [style.spaceHeading(`${spaceId}:`), ...rows.map((row) => `  ${row}`)];
-}
-/**
-* Compose the styled `migration list` output. The renderer is
-* presentation-neutral — every token passes through `style` before
-* landing in the output, so the same composition serves the pure-text
-* path ({@link renderMigrationList} via
-* {@link IDENTITY_MIGRATION_LIST_STYLER}) and the ANSI-styled CLI path
-* (via the ANSI styler the CLI shell wires up).
-*/
-function renderMigrationListWithStyle(result, style) {
-	const multiSpace = result.spaces.length > 1;
-	const lines = [];
-	for (let index = 0; index < result.spaces.length; index++) {
-		const space = result.spaces[index];
-		if (index > 0) lines.push("");
-		lines.push(...renderSpaceBlock(space.spaceId, space.migrations, multiSpace, style));
-	}
-	if (result.spaces.reduce((count, space) => count + space.migrations.length, 0) > 0) {
-		lines.push("");
-		lines.push(style.summary(result.summary));
-	}
-	return lines.join("\n");
-}
-//#endregion
-//#region src/utils/formatters/migration-list-styler.ts
-/**
-* The reserved ref name for the live-database marker. Treated as a
-* structurally distinct token from user-named refs so the styler can
-* make it visually pop in `(refs)` decorations.
-*/
-const DB_REF_NAME = "db";
-function styleRefName(name) {
-	return name === DB_REF_NAME ? bold(greenBright(name)) : green(name);
-}
-/**
-* Build a {@link MigrationListStyler} that decorates `migration list`
-* tokens with ANSI SGR codes. When `useColor` is `false` (non-TTY,
-* `--no-color`, `NO_COLOR=1`, piped output) the function returns the
-* shared identity styler so callers get plain text with zero ANSI
-* bytes — pipe-friendly by construction.
-*
-* Palette:
-*
-* - `dirName`: bold
-* - `sourceHash`: dim cyan
-* - `destHash`: bright cyan
-* - `glyph` (`→` / `⟲` / `∅`): dim
-* - `lane` (graph gutter lines `│` and fan/join connectors `├─┐` / `├─┘`): dim
-* - `invariants` (`{...}`): yellow
-* - `refs` (`(...)`): green; the live-DB `db` marker inside is green-bold
-* - `spaceHeading` (`<spaceId>:`): bold
-* - `summary`: dim
-* - `emptyState`: dim
-*/
-function createAnsiMigrationListStyler(opts) {
-	if (!opts.useColor) return IDENTITY_MIGRATION_LIST_STYLER;
-	return {
-		kind: (text) => dim(text),
-		dirName: (text) => bold(text),
-		sourceHash: (text) => dim(cyan(text)),
-		destHash: (text) => cyanBright(text),
-		glyph: (text) => dim(text),
-		lane: (text) => dim(text),
-		invariants: (ids) => yellow(`{${ids.join(", ")}}`),
-		refs: (names) => {
-			const open = green("(");
-			const close = green(")");
-			const separator = green(", ");
-			return open + names.map(styleRefName).join(separator) + close;
-		},
-		spaceHeading: (text) => bold(text),
-		summary: (text) => dim(text),
-		emptyState: (text) => dim(text)
-	};
-}
-//#endregion
-//#region src/commands/migration-list.ts
-function renderMigrationListHumanOutput(result, options) {
-	const styler = createAnsiMigrationListStyler({ useColor: options.useColor });
-	if (options.graph) return renderMigrationListGraphResult(result, styler, options.glyphMode);
-	return renderMigrationListWithStyle(result, styler);
-}
-function computeSummary(spaces) {
-	const totalMigrations = spaces.reduce((count, space) => count + space.migrations.length, 0);
-	if (spaces.length <= 1) return `${totalMigrations} migration(s) on disk`;
-	return `${totalMigrations} migration(s) across ${spaces.length} contract space(s)`;
-}
-/**
-* The unit-testable core of `migration list`. Given an absolute
-* `migrationsDir` and an optional `spaceFilter`, enumerates every
-* on-disk migration (via {@link enumerateMigrationSpaces}), narrows to
-* the requested space if any, and assembles a {@link MigrationListResult}
-* ready for the renderer or JSON serializer.
-*
-* The enumerator is the single source of truth for "what is a contract
-* space": existence, the `--space` candidate-suggestion list, and
-* scoping are all derived from one {@link enumerateMigrationSpaces}
-* traversal. This means the reserved-name exclusion the enumerator
-* applies (e.g. the per-space `refs/` subdirectory) is honoured here for
-* free — a `--space refs` request resolves to `SPACE_NOT_FOUND`, not a
-* synthesized empty-state.
-*
-* Distinct empty-state paths:
-*
-* - `migrations/` missing or contains no valid space directories →
-*   synthesizes `[{ spaceId: APP_SPACE_ID, migrations: [] }]` so the
-*   renderer's empty-state path can name a directory (spec § Empty-state +
-*   the `migrations/` missing edge case).
-* - `--space <id>` on an existing-but-empty space dir → the enumerator
-*   surfaces `{ spaceId, migrations: [] }`; `<id>` is in the set, so it
-*   scopes to that entry and renders the empty-state the same way.
-* - `--space <id>` on a non-existent (or reserved) space → structured
-*   `MIGRATION.SPACE_NOT_FOUND` error (NOT empty-state).
-*
-* Errors caught here:
-*
-* - {@link MigrationToolsError} from the enumerator → mapped through
-*   {@link mapMigrationToolsError} so callers see the catalogue code.
-* - Anything else (filesystem etc.) → wrapped via {@link errorUnexpected}.
-*/
-async function runMigrationList(inputs) {
-	const { migrationsDir, spaceFilter } = inputs;
-	if (spaceFilter !== void 0 && !isValidSpaceId(spaceFilter)) return notOk(errorInvalidSpaceId(spaceFilter));
-	let spaces;
-	try {
-		spaces = await enumerateMigrationSpaces({ projectMigrationsDir: migrationsDir });
-	} catch (error) {
-		if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));
-		return notOk(errorUnexpected(error instanceof Error ? error.message : String(error), { why: `Failed to enumerate migrations: ${error instanceof Error ? error.message : String(error)}` }));
-	}
-	if (spaceFilter !== void 0 && !spaces.some((s) => s.spaceId === spaceFilter)) return notOk(errorSpaceNotFound(spaceFilter, spaces.map((s) => s.spaceId).sort()));
-	const scopedSpaces = spaceFilter !== void 0 ? spaces.filter((s) => s.spaceId === spaceFilter) : spaces;
-	const resultSpaces = scopedSpaces.length === 0 ? [{
-		spaceId: APP_SPACE_ID,
-		migrations: []
-	}] : scopedSpaces;
-	return ok({
-		ok: true,
-		spaces: resultSpaces,
-		summary: computeSummary(resultSpaces)
-	});
-}
-/**
-* CLI shell: loads config, resolves paths, prints the styled header on
-* stderr (interactive mode only), and delegates to {@link runMigrationList}.
-* Kept intentionally thin so the unit-testable surface lives in the core.
-*/
-async function executeMigrationListCommand(options, flags, ui) {
-	const config = await loadConfig(options.config);
-	const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(options.config, config);
-	if (!flags.json && !flags.quiet) {
-		const header = formatStyledHeader({
-			command: "migration list",
-			description: "List on-disk migrations, latest first, per contract space",
-			details: [
-				{
-					label: "config",
-					value: configPath
-				},
-				{
-					label: "migrations",
-					value: migrationsRelative
-				},
-				...options.space !== void 0 ? [{
-					label: "space",
-					value: options.space
-				}] : []
-			],
-			flags
-		});
-		ui.stderr(header);
-	}
-	return runMigrationList({
-		migrationsDir,
-		...ifDefined("spaceFilter", options.space)
-	});
-}
-function createMigrationListCommand() {
-	const command = new Command("list");
-	setCommandDescriptions(command, "List on-disk migrations, latest first, per contract space", "Enumerates every on-disk migration under migrations/<space>/ for every\ncontract space found on disk, latest first. Offline — does not consult\nthe database. Each row leads with a kind glyph (* forward, ↩ rollback,\n⟲ self), then dirName, then source → destination contract hashes\n(7-char git-style). Self-edges show a single hash. Invariants render as\n{...}; refs on the destination as (production, db). Pass --space <id>\nto narrow to one contract space. --graph draws the forward spine with\nlane gutters; --ascii forces ASCII glyphs (orthogonal to --no-color).");
-	setCommandExamples(command, [
-		"prisma-next migration list",
-		"prisma-next migration list --graph",
-		"prisma-next migration list --space app",
-		"prisma-next migration list --graph --ascii",
-		"prisma-next migration list --json"
-	]);
-	setCommandSeeAlso(command, [
-		{
-			verb: "migration status",
-			oneLiner: "Show migration path and pending status"
-		},
-		{
-			verb: "migration log",
-			oneLiner: "Show executed migration history"
-		},
-		{
-			verb: "migration graph",
-			oneLiner: "Show the migration graph topology"
-		},
-		{
-			verb: "migration show",
-			oneLiner: "Display migration package contents"
-		}
-	]);
-	addGlobalOptions(command).option("--config <path>", "Path to prisma-next.config.ts").option("--space <id>", "Narrow output to a single contract space").option("--graph", "Draw migration relationships as an annotated tree").option("--ascii", "Use ASCII glyphs for --graph (pipe-friendly)").action(async (options) => {
-		const flags = parseGlobalFlagsOrExit(options);
-		const ui = createTerminalUI(flags);
-		const exitCode = handleResult(await executeMigrationListCommand(options, flags, ui), flags, ui, (listResult) => {
-			if (flags.json) ui.output(JSON.stringify(listResult, null, 2));
-			else if (!flags.quiet) ui.output(renderMigrationListHumanOutput(listResult, {
-				graph: options.graph === true,
-				glyphMode: ui.resolveGlyphMode(options.ascii === true),
-				useColor: ui.useColor
-			}));
-		});
-		process.exit(exitCode);
-	});
-	return command;
-}
-//#endregion
-export { renderMigrationListHumanOutput as n, runMigrationList as r, createMigrationListCommand as t };
-
-//# sourceMappingURL=migration-list-C2xnaYsT.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"migration-list-C2xnaYsT.mjs","names":[],"sources":["../src/utils/formatters/migration-list-render.ts","../src/utils/formatters/migration-list-styler.ts","../src/commands/migration-list.ts"],"sourcesContent":["import {\n  classifyMigrationListGraphTopology,\n  type EdgeKind,\n} from '@prisma-next/migration-tools/migration-list-graph-topology';\nimport type {\n  MigrationListEntry,\n  MigrationListResult,\n} from '@prisma-next/migration-tools/migration-list-types';\nimport {\n  computeMigrationDirNameWidth,\n  formatMigrationDataColumn,\n  MIGRATION_LIST_FORWARD_EDGE_GLYPH,\n} from './migration-list-data-column';\n\nexport type { EdgeKind } from '@prisma-next/migration-tools/migration-list-graph-topology';\n\nexport type {\n  MigrationListEntry,\n  MigrationListResult,\n  MigrationSpaceListEntry,\n} from '@prisma-next/migration-tools/migration-list-types';\n\nconst KIND_GLYPH: Record<EdgeKind, string> = {\n  forward: '*',\n  rollback: '↩',\n  self: '⟲',\n};\n\n/**\n * Semantic styler for `migration list` output tokens. Token-typed so\n * the renderer composes presentation-neutral fragments and the styler\n * decides how each token kind is decorated (ANSI codes, plain text,\n * etc.). The renderer pads with raw spaces *outside* styled tokens so\n * visible column widths stay stable regardless of what the styler\n * emits — adding ANSI escape sequences never disturbs alignment.\n *\n * `invariants` and `refs` receive the underlying string arrays rather\n * than a pre-joined string so per-element styling (e.g. distinguishing\n * the live-DB `db` marker from user-named refs) is possible without\n * having to re-parse a joined block.\n */\nexport interface MigrationListStyler {\n  kind(text: string): string;\n  dirName(text: string): string;\n  sourceHash(text: string): string;\n  destHash(text: string): string;\n  glyph(text: string): string;\n  lane(text: string): string;\n  invariants(ids: readonly string[]): string;\n  refs(names: readonly string[]): string;\n  spaceHeading(text: string): string;\n  summary(text: string): string;\n  emptyState(text: string): string;\n}\n\nexport const IDENTITY_MIGRATION_LIST_STYLER: MigrationListStyler = {\n  kind: (text) => text,\n  dirName: (text) => text,\n  sourceHash: (text) => text,\n  destHash: (text) => text,\n  glyph: (text) => text,\n  lane: (text) => text,\n  invariants: (ids) => `{${ids.join(', ')}}`,\n  refs: (names) => `(${names.join(', ')})`,\n  spaceHeading: (text) => text,\n  summary: (text) => text,\n  emptyState: (text) => text,\n};\n\nfunction resolveEdgeKind(\n  migrationHash: string,\n  kindByMigrationHash: ReadonlyMap<string, EdgeKind>,\n): EdgeKind {\n  return kindByMigrationHash.get(migrationHash) ?? 'forward';\n}\n\nfunction formatMigrationRow(\n  migration: MigrationListEntry,\n  dirNameWidth: number,\n  edgeKind: EdgeKind,\n  style: MigrationListStyler,\n): string {\n  const kindColumn = `${style.kind(KIND_GLYPH[edgeKind])} `;\n  const data = formatMigrationDataColumn(migration, {\n    dirNameWidth,\n    edgeKind,\n    style,\n    forwardArrow: MIGRATION_LIST_FORWARD_EDGE_GLYPH,\n  });\n  return `${kindColumn}${data}`;\n}\n\nfunction formatEmptyStateLine(spaceId: string, style: MigrationListStyler): string {\n  return style.emptyState(`There are no migrations in migrations/${spaceId}/ yet`);\n}\n\nfunction renderSpaceBlock(\n  spaceId: string,\n  migrations: readonly MigrationListEntry[],\n  multiSpace: boolean,\n  style: MigrationListStyler,\n): readonly string[] {\n  if (migrations.length === 0) {\n    const emptyLine = formatEmptyStateLine(spaceId, style);\n    if (!multiSpace) {\n      return [emptyLine];\n    }\n    return [style.spaceHeading(`${spaceId}:`), `  ${emptyLine}`];\n  }\n\n  const kindByMigrationHash = classifyMigrationListGraphTopology(migrations).kindByMigrationHash;\n  const dirNameWidth = computeMigrationDirNameWidth(migrations);\n  const rows = migrations.map((entry) =>\n    formatMigrationRow(\n      entry,\n      dirNameWidth,\n      resolveEdgeKind(entry.migrationHash, kindByMigrationHash),\n      style,\n    ),\n  );\n  if (!multiSpace) {\n    return rows;\n  }\n  return [style.spaceHeading(`${spaceId}:`), ...rows.map((row) => `  ${row}`)];\n}\n\n/**\n * Compose the styled `migration list` output. The renderer is\n * presentation-neutral — every token passes through `style` before\n * landing in the output, so the same composition serves the pure-text\n * path ({@link renderMigrationList} via\n * {@link IDENTITY_MIGRATION_LIST_STYLER}) and the ANSI-styled CLI path\n * (via the ANSI styler the CLI shell wires up).\n */\nexport function renderMigrationListWithStyle(\n  result: MigrationListResult,\n  style: MigrationListStyler,\n): string {\n  const multiSpace = result.spaces.length > 1;\n  const lines: string[] = [];\n\n  for (let index = 0; index < result.spaces.length; index++) {\n    const space = result.spaces[index]!;\n    if (index > 0) {\n      lines.push('');\n    }\n    lines.push(...renderSpaceBlock(space.spaceId, space.migrations, multiSpace, style));\n  }\n\n  const totalMigrations = result.spaces.reduce(\n    (count, space) => count + space.migrations.length,\n    0,\n  );\n  if (totalMigrations > 0) {\n    lines.push('');\n    lines.push(style.summary(result.summary));\n  }\n\n  return lines.join('\\n');\n}\n\nexport function renderMigrationList(result: MigrationListResult): string {\n  return renderMigrationListWithStyle(result, IDENTITY_MIGRATION_LIST_STYLER);\n}\n","import { bold, cyan, cyanBright, dim, green, greenBright, yellow } from 'colorette';\nimport { IDENTITY_MIGRATION_LIST_STYLER, type MigrationListStyler } from './migration-list-render';\n\n/**\n * The reserved ref name for the live-database marker. Treated as a\n * structurally distinct token from user-named refs so the styler can\n * make it visually pop in `(refs)` decorations.\n */\nconst DB_REF_NAME = 'db';\n\nfunction styleRefName(name: string): string {\n  return name === DB_REF_NAME ? bold(greenBright(name)) : green(name);\n}\n\n/**\n * Build a {@link MigrationListStyler} that decorates `migration list`\n * tokens with ANSI SGR codes. When `useColor` is `false` (non-TTY,\n * `--no-color`, `NO_COLOR=1`, piped output) the function returns the\n * shared identity styler so callers get plain text with zero ANSI\n * bytes — pipe-friendly by construction.\n *\n * Palette:\n *\n * - `dirName`: bold\n * - `sourceHash`: dim cyan\n * - `destHash`: bright cyan\n * - `glyph` (`→` / `⟲` / `∅`): dim\n * - `lane` (graph gutter lines `│` and fan/join connectors `├─┐` / `├─┘`): dim\n * - `invariants` (`{...}`): yellow\n * - `refs` (`(...)`): green; the live-DB `db` marker inside is green-bold\n * - `spaceHeading` (`<spaceId>:`): bold\n * - `summary`: dim\n * - `emptyState`: dim\n */\nexport function createAnsiMigrationListStyler(opts: {\n  readonly useColor: boolean;\n}): MigrationListStyler {\n  if (!opts.useColor) {\n    return IDENTITY_MIGRATION_LIST_STYLER;\n  }\n  return {\n    kind: (text) => dim(text),\n    dirName: (text) => bold(text),\n    sourceHash: (text) => dim(cyan(text)),\n    destHash: (text) => cyanBright(text),\n    glyph: (text) => dim(text),\n    lane: (text) => dim(text),\n    invariants: (ids) => yellow(`{${ids.join(', ')}}`),\n    refs: (names) => {\n      const open = green('(');\n      const close = green(')');\n      const separator = green(', ');\n      return open + names.map(styleRefName).join(separator) + close;\n    },\n    spaceHeading: (text) => bold(text),\n    summary: (text) => dim(text),\n    emptyState: (text) => dim(text),\n  };\n}\n","import { enumerateMigrationSpaces } from '@prisma-next/migration-tools/enumerate-migration-spaces';\nimport { MigrationToolsError } from '@prisma-next/migration-tools/errors';\nimport type {\n  MigrationListResult,\n  MigrationSpaceListEntry,\n} from '@prisma-next/migration-tools/migration-list-types';\nimport { APP_SPACE_ID, isValidSpaceId } from '@prisma-next/migration-tools/spaces';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { notOk, ok, type Result } from '@prisma-next/utils/result';\nimport { Command } from 'commander';\nimport { loadConfig } from '../config-loader';\nimport {\n  type CliStructuredError,\n  errorInvalidSpaceId,\n  errorSpaceNotFound,\n  errorUnexpected,\n  mapMigrationToolsError,\n} from '../utils/cli-errors';\nimport {\n  addGlobalOptions,\n  resolveMigrationPaths,\n  setCommandDescriptions,\n  setCommandExamples,\n  setCommandSeeAlso,\n} from '../utils/command-helpers';\nimport {\n  type GlyphMode,\n  renderMigrationListGraphResult,\n} from '../utils/formatters/migration-list-graph-render';\nimport { renderMigrationListWithStyle } from '../utils/formatters/migration-list-render';\nimport { createAnsiMigrationListStyler } from '../utils/formatters/migration-list-styler';\nimport { formatStyledHeader } from '../utils/formatters/styled';\nimport type { CommonCommandOptions } from '../utils/global-flags';\nimport { type GlobalFlags, parseGlobalFlagsOrExit } from '../utils/global-flags';\nimport { handleResult } from '../utils/result-handler';\nimport { createTerminalUI, type TerminalUI } from '../utils/terminal-ui';\n\ninterface MigrationListOptions extends CommonCommandOptions {\n  readonly config?: string;\n  readonly space?: string;\n  readonly graph?: boolean;\n  readonly ascii?: boolean;\n}\n\nexport interface MigrationListHumanRenderOptions {\n  readonly graph: boolean;\n  readonly glyphMode: GlyphMode;\n  readonly useColor: boolean;\n}\n\nexport function renderMigrationListHumanOutput(\n  result: MigrationListResult,\n  options: MigrationListHumanRenderOptions,\n): string {\n  const styler = createAnsiMigrationListStyler({ useColor: options.useColor });\n  if (options.graph) {\n    return renderMigrationListGraphResult(result, styler, options.glyphMode);\n  }\n  return renderMigrationListWithStyle(result, styler);\n}\n\n/**\n * Inputs for {@link runMigrationList} — the pure-ish data-and-policy core\n * of `migration list` that tests exercise directly.\n *\n * The core depends only on the filesystem rooted at `migrationsDir`. It\n * does NOT call `loadConfig`, parse CLI flags, render a styled header,\n * or write to any stream. Output rendering is the caller's concern (the\n * CLI shell renders via {@link renderMigrationList}; JSON callers\n * serialize the {@link MigrationListResult} directly).\n */\nexport interface RunMigrationListInputs {\n  /** Absolute path to the project's `migrations/` directory. */\n  readonly migrationsDir: string;\n  /**\n   * Optional contract-space id to narrow the result to a single space.\n   * Same validation rules as {@link isValidSpaceId}. When absent, every\n   * on-disk space contributes.\n   */\n  readonly spaceFilter?: string;\n}\n\nfunction computeSummary(spaces: readonly MigrationSpaceListEntry[]): string {\n  const totalMigrations = spaces.reduce((count, space) => count + space.migrations.length, 0);\n  if (spaces.length <= 1) {\n    return `${totalMigrations} migration(s) on disk`;\n  }\n  return `${totalMigrations} migration(s) across ${spaces.length} contract space(s)`;\n}\n\n/**\n * The unit-testable core of `migration list`. Given an absolute\n * `migrationsDir` and an optional `spaceFilter`, enumerates every\n * on-disk migration (via {@link enumerateMigrationSpaces}), narrows to\n * the requested space if any, and assembles a {@link MigrationListResult}\n * ready for the renderer or JSON serializer.\n *\n * The enumerator is the single source of truth for \"what is a contract\n * space\": existence, the `--space` candidate-suggestion list, and\n * scoping are all derived from one {@link enumerateMigrationSpaces}\n * traversal. This means the reserved-name exclusion the enumerator\n * applies (e.g. the per-space `refs/` subdirectory) is honoured here for\n * free — a `--space refs` request resolves to `SPACE_NOT_FOUND`, not a\n * synthesized empty-state.\n *\n * Distinct empty-state paths:\n *\n * - `migrations/` missing or contains no valid space directories →\n *   synthesizes `[{ spaceId: APP_SPACE_ID, migrations: [] }]` so the\n *   renderer's empty-state path can name a directory (spec § Empty-state +\n *   the `migrations/` missing edge case).\n * - `--space <id>` on an existing-but-empty space dir → the enumerator\n *   surfaces `{ spaceId, migrations: [] }`; `<id>` is in the set, so it\n *   scopes to that entry and renders the empty-state the same way.\n * - `--space <id>` on a non-existent (or reserved) space → structured\n *   `MIGRATION.SPACE_NOT_FOUND` error (NOT empty-state).\n *\n * Errors caught here:\n *\n * - {@link MigrationToolsError} from the enumerator → mapped through\n *   {@link mapMigrationToolsError} so callers see the catalogue code.\n * - Anything else (filesystem etc.) → wrapped via {@link errorUnexpected}.\n */\nexport async function runMigrationList(\n  inputs: RunMigrationListInputs,\n): Promise<Result<MigrationListResult, CliStructuredError>> {\n  const { migrationsDir, spaceFilter } = inputs;\n\n  if (spaceFilter !== undefined && !isValidSpaceId(spaceFilter)) {\n    return notOk(errorInvalidSpaceId(spaceFilter));\n  }\n\n  let spaces: readonly MigrationSpaceListEntry[];\n  try {\n    spaces = await enumerateMigrationSpaces({ projectMigrationsDir: migrationsDir });\n  } catch (error) {\n    if (MigrationToolsError.is(error)) return notOk(mapMigrationToolsError(error));\n    return notOk(\n      errorUnexpected(error instanceof Error ? error.message : String(error), {\n        why: `Failed to enumerate migrations: ${error instanceof Error ? error.message : String(error)}`,\n      }),\n    );\n  }\n\n  if (spaceFilter !== undefined && !spaces.some((s) => s.spaceId === spaceFilter)) {\n    return notOk(errorSpaceNotFound(spaceFilter, spaces.map((s) => s.spaceId).sort()));\n  }\n\n  const scopedSpaces =\n    spaceFilter !== undefined ? spaces.filter((s) => s.spaceId === spaceFilter) : spaces;\n\n  const resultSpaces: readonly MigrationSpaceListEntry[] =\n    scopedSpaces.length === 0 ? [{ spaceId: APP_SPACE_ID, migrations: [] }] : scopedSpaces;\n\n  return ok({\n    ok: true,\n    spaces: resultSpaces,\n    summary: computeSummary(resultSpaces),\n  });\n}\n\n/**\n * CLI shell: loads config, resolves paths, prints the styled header on\n * stderr (interactive mode only), and delegates to {@link runMigrationList}.\n * Kept intentionally thin so the unit-testable surface lives in the core.\n */\nasync function executeMigrationListCommand(\n  options: MigrationListOptions,\n  flags: GlobalFlags,\n  ui: TerminalUI,\n): Promise<Result<MigrationListResult, CliStructuredError>> {\n  const config = await loadConfig(options.config);\n  const { configPath, migrationsDir, migrationsRelative } = resolveMigrationPaths(\n    options.config,\n    config,\n  );\n\n  if (!flags.json && !flags.quiet) {\n    const header = formatStyledHeader({\n      command: 'migration list',\n      description: 'List on-disk migrations, latest first, per contract space',\n      details: [\n        { label: 'config', value: configPath },\n        { label: 'migrations', value: migrationsRelative },\n        ...(options.space !== undefined ? [{ label: 'space', value: options.space }] : []),\n      ],\n      flags,\n    });\n    ui.stderr(header);\n  }\n\n  return runMigrationList({\n    migrationsDir,\n    ...ifDefined('spaceFilter', options.space),\n  });\n}\n\nexport function createMigrationListCommand(): Command {\n  const command = new Command('list');\n  setCommandDescriptions(\n    command,\n    'List on-disk migrations, latest first, per contract space',\n    'Enumerates every on-disk migration under migrations/<space>/ for every\\n' +\n      'contract space found on disk, latest first. Offline — does not consult\\n' +\n      'the database. Each row leads with a kind glyph (* forward, ↩ rollback,\\n' +\n      '⟲ self), then dirName, then source → destination contract hashes\\n' +\n      '(7-char git-style). Self-edges show a single hash. Invariants render as\\n' +\n      '{...}; refs on the destination as (production, db). Pass --space <id>\\n' +\n      'to narrow to one contract space. --graph draws the forward spine with\\n' +\n      'lane gutters; --ascii forces ASCII glyphs (orthogonal to --no-color).',\n  );\n  setCommandExamples(command, [\n    'prisma-next migration list',\n    'prisma-next migration list --graph',\n    'prisma-next migration list --space app',\n    'prisma-next migration list --graph --ascii',\n    'prisma-next migration list --json',\n  ]);\n  setCommandSeeAlso(command, [\n    { verb: 'migration status', oneLiner: 'Show migration path and pending status' },\n    { verb: 'migration log', oneLiner: 'Show executed migration history' },\n    { verb: 'migration graph', oneLiner: 'Show the migration graph topology' },\n    { verb: 'migration show', oneLiner: 'Display migration package contents' },\n  ]);\n  addGlobalOptions(command)\n    .option('--config <path>', 'Path to prisma-next.config.ts')\n    .option('--space <id>', 'Narrow output to a single contract space')\n    .option('--graph', 'Draw migration relationships as an annotated tree')\n    .option('--ascii', 'Use ASCII glyphs for --graph (pipe-friendly)')\n    .action(async (options: MigrationListOptions) => {\n      const flags = parseGlobalFlagsOrExit(options);\n      const ui = createTerminalUI(flags);\n      const result = await executeMigrationListCommand(options, flags, ui);\n      const exitCode = handleResult(result, flags, ui, (listResult) => {\n        if (flags.json) {\n          ui.output(JSON.stringify(listResult, null, 2));\n        } else if (!flags.quiet) {\n          ui.output(\n            renderMigrationListHumanOutput(listResult, {\n              graph: options.graph === true,\n              glyphMode: ui.resolveGlyphMode(options.ascii === true),\n              useColor: ui.useColor,\n            }),\n          );\n        }\n      });\n      process.exit(exitCode);\n    });\n  return command;\n}\n"],"mappings":";;;;;;;;;;;;AAsBA,MAAM,aAAuC;CAC3C,SAAS;CACT,UAAU;CACV,MAAM;AACR;AA6BA,MAAa,iCAAsD;CACjE,OAAO,SAAS;CAChB,UAAU,SAAS;CACnB,aAAa,SAAS;CACtB,WAAW,SAAS;CACpB,QAAQ,SAAS;CACjB,OAAO,SAAS;CAChB,aAAa,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE;CACxC,OAAO,UAAU,IAAI,MAAM,KAAK,IAAI,EAAE;CACtC,eAAe,SAAS;CACxB,UAAU,SAAS;CACnB,aAAa,SAAS;AACxB;AAEA,SAAS,gBACP,eACA,qBACU;CACV,OAAO,oBAAoB,IAAI,aAAa,KAAK;AACnD;AAEA,SAAS,mBACP,WACA,cACA,UACA,OACQ;CAQR,OAAO,GAAG,GAPY,MAAM,KAAK,WAAW,SAAS,EAAE,KAC1C,0BAA0B,WAAW;EAChD;EACA;EACA;EACA,cAAA;CACF,CAC0B;AAC5B;AAEA,SAAS,qBAAqB,SAAiB,OAAoC;CACjF,OAAO,MAAM,WAAW,yCAAyC,QAAQ,MAAM;AACjF;AAEA,SAAS,iBACP,SACA,YACA,YACA,OACmB;CACnB,IAAI,WAAW,WAAW,GAAG;EAC3B,MAAM,YAAY,qBAAqB,SAAS,KAAK;EACrD,IAAI,CAAC,YACH,OAAO,CAAC,SAAS;EAEnB,OAAO,CAAC,MAAM,aAAa,GAAG,QAAQ,EAAE,GAAG,KAAK,WAAW;CAC7D;CAEA,MAAM,sBAAsB,mCAAmC,UAAU,EAAE;CAC3E,MAAM,eAAe,6BAA6B,UAAU;CAC5D,MAAM,OAAO,WAAW,KAAK,UAC3B,mBACE,OACA,cACA,gBAAgB,MAAM,eAAe,mBAAmB,GACxD,KACF,CACF;CACA,IAAI,CAAC,YACH,OAAO;CAET,OAAO,CAAC,MAAM,aAAa,GAAG,QAAQ,EAAE,GAAG,GAAG,KAAK,KAAK,QAAQ,KAAK,KAAK,CAAC;AAC7E;;;;;;;;;AAUA,SAAgB,6BACd,QACA,OACQ;CACR,MAAM,aAAa,OAAO,OAAO,SAAS;CAC1C,MAAM,QAAkB,CAAC;CAEzB,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,OAAO,QAAQ,SAAS;EACzD,MAAM,QAAQ,OAAO,OAAO;EAC5B,IAAI,QAAQ,GACV,MAAM,KAAK,EAAE;EAEf,MAAM,KAAK,GAAG,iBAAiB,MAAM,SAAS,MAAM,YAAY,YAAY,KAAK,CAAC;CACpF;CAMA,IAJwB,OAAO,OAAO,QACnC,OAAO,UAAU,QAAQ,MAAM,WAAW,QAC3C,CAEgB,IAAI,GAAG;EACvB,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,MAAM,QAAQ,OAAO,OAAO,CAAC;CAC1C;CAEA,OAAO,MAAM,KAAK,IAAI;AACxB;;;;;;;;ACvJA,MAAM,cAAc;AAEpB,SAAS,aAAa,MAAsB;CAC1C,OAAO,SAAS,cAAc,KAAK,YAAY,IAAI,CAAC,IAAI,MAAM,IAAI;AACpE;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,8BAA8B,MAEtB;CACtB,IAAI,CAAC,KAAK,UACR,OAAO;CAET,OAAO;EACL,OAAO,SAAS,IAAI,IAAI;EACxB,UAAU,SAAS,KAAK,IAAI;EAC5B,aAAa,SAAS,IAAI,KAAK,IAAI,CAAC;EACpC,WAAW,SAAS,WAAW,IAAI;EACnC,QAAQ,SAAS,IAAI,IAAI;EACzB,OAAO,SAAS,IAAI,IAAI;EACxB,aAAa,QAAQ,OAAO,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE;EACjD,OAAO,UAAU;GACf,MAAM,OAAO,MAAM,GAAG;GACtB,MAAM,QAAQ,MAAM,GAAG;GACvB,MAAM,YAAY,MAAM,IAAI;GAC5B,OAAO,OAAO,MAAM,IAAI,YAAY,EAAE,KAAK,SAAS,IAAI;EAC1D;EACA,eAAe,SAAS,KAAK,IAAI;EACjC,UAAU,SAAS,IAAI,IAAI;EAC3B,aAAa,SAAS,IAAI,IAAI;CAChC;AACF;;;ACRA,SAAgB,+BACd,QACA,SACQ;CACR,MAAM,SAAS,8BAA8B,EAAE,UAAU,QAAQ,SAAS,CAAC;CAC3E,IAAI,QAAQ,OACV,OAAO,+BAA+B,QAAQ,QAAQ,QAAQ,SAAS;CAEzE,OAAO,6BAA6B,QAAQ,MAAM;AACpD;AAuBA,SAAS,eAAe,QAAoD;CAC1E,MAAM,kBAAkB,OAAO,QAAQ,OAAO,UAAU,QAAQ,MAAM,WAAW,QAAQ,CAAC;CAC1F,IAAI,OAAO,UAAU,GACnB,OAAO,GAAG,gBAAgB;CAE5B,OAAO,GAAG,gBAAgB,uBAAuB,OAAO,OAAO;AACjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,iBACpB,QAC0D;CAC1D,MAAM,EAAE,eAAe,gBAAgB;CAEvC,IAAI,gBAAgB,KAAA,KAAa,CAAC,eAAe,WAAW,GAC1D,OAAO,MAAM,oBAAoB,WAAW,CAAC;CAG/C,IAAI;CACJ,IAAI;EACF,SAAS,MAAM,yBAAyB,EAAE,sBAAsB,cAAc,CAAC;CACjF,SAAS,OAAO;EACd,IAAI,oBAAoB,GAAG,KAAK,GAAG,OAAO,MAAM,uBAAuB,KAAK,CAAC;EAC7E,OAAO,MACL,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EACtE,KAAK,mCAAmC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,IAC/F,CAAC,CACH;CACF;CAEA,IAAI,gBAAgB,KAAA,KAAa,CAAC,OAAO,MAAM,MAAM,EAAE,YAAY,WAAW,GAC5E,OAAO,MAAM,mBAAmB,aAAa,OAAO,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;CAGnF,MAAM,eACJ,gBAAgB,KAAA,IAAY,OAAO,QAAQ,MAAM,EAAE,YAAY,WAAW,IAAI;CAEhF,MAAM,eACJ,aAAa,WAAW,IAAI,CAAC;EAAE,SAAS;EAAc,YAAY,CAAC;CAAE,CAAC,IAAI;CAE5E,OAAO,GAAG;EACR,IAAI;EACJ,QAAQ;EACR,SAAS,eAAe,YAAY;CACtC,CAAC;AACH;;;;;;AAOA,eAAe,4BACb,SACA,OACA,IAC0D;CAC1D,MAAM,SAAS,MAAM,WAAW,QAAQ,MAAM;CAC9C,MAAM,EAAE,YAAY,eAAe,uBAAuB,sBACxD,QAAQ,QACR,MACF;CAEA,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,OAAO;EAC/B,MAAM,SAAS,mBAAmB;GAChC,SAAS;GACT,aAAa;GACb,SAAS;IACP;KAAE,OAAO;KAAU,OAAO;IAAW;IACrC;KAAE,OAAO;KAAc,OAAO;IAAmB;IACjD,GAAI,QAAQ,UAAU,KAAA,IAAY,CAAC;KAAE,OAAO;KAAS,OAAO,QAAQ;IAAM,CAAC,IAAI,CAAC;GAClF;GACA;EACF,CAAC;EACD,GAAG,OAAO,MAAM;CAClB;CAEA,OAAO,iBAAiB;EACtB;EACA,GAAG,UAAU,eAAe,QAAQ,KAAK;CAC3C,CAAC;AACH;AAEA,SAAgB,6BAAsC;CACpD,MAAM,UAAU,IAAI,QAAQ,MAAM;CAClC,uBACE,SACA,6DACA,wjBAQF;CACA,mBAAmB,SAAS;EAC1B;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,kBAAkB,SAAS;EACzB;GAAE,MAAM;GAAoB,UAAU;EAAyC;EAC/E;GAAE,MAAM;GAAiB,UAAU;EAAkC;EACrE;GAAE,MAAM;GAAmB,UAAU;EAAoC;EACzE;GAAE,MAAM;GAAkB,UAAU;EAAqC;CAC3E,CAAC;CACD,iBAAiB,OAAO,EACrB,OAAO,mBAAmB,+BAA+B,EACzD,OAAO,gBAAgB,0CAA0C,EACjE,OAAO,WAAW,mDAAmD,EACrE,OAAO,WAAW,8CAA8C,EAChE,OAAO,OAAO,YAAkC;EAC/C,MAAM,QAAQ,uBAAuB,OAAO;EAC5C,MAAM,KAAK,iBAAiB,KAAK;EAEjC,MAAM,WAAW,aAAa,MADT,4BAA4B,SAAS,OAAO,EAAE,GAC7B,OAAO,KAAK,eAAe;GAC/D,IAAI,MAAM,MACR,GAAG,OAAO,KAAK,UAAU,YAAY,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,OAChB,GAAG,OACD,+BAA+B,YAAY;IACzC,OAAO,QAAQ,UAAU;IACzB,WAAW,GAAG,iBAAiB,QAAQ,UAAU,IAAI;IACrD,UAAU,GAAG;GACf,CAAC,CACH;EAEJ,CAAC;EACD,QAAQ,KAAK,QAAQ;CACvB,CAAC;CACH,OAAO;AACT"}

package/dist/migration-list-graph-render-DKw1AT-e.d.mts

@@ -1,7 +0,0 @@
-import { MigrationListResult } from "@prisma-next/migration-tools/migration-list-types";
-
-//#region src/utils/formatters/migration-list-graph-render.d.ts
-type GlyphMode = 'unicode' | 'ascii';
-//#endregion
-export { GlyphMode as t };
-//# sourceMappingURL=migration-list-graph-render-DKw1AT-e.d.mts.map

package/dist/migration-list-graph-render-DKw1AT-e.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migration-list-graph-render-DKw1AT-e.d.mts","names":[],"sources":["../src/utils/formatters/migration-list-graph-render.ts"],"mappings":";;;KAuBY,SAAA"}