@prisma/orm-toolchain 0.16.0-dev.36

package/dist/command-helpers-CAoXqAY9-DWUBcTXM.mjs

@@ -0,0 +1,1671 @@
+import { c as spaceMigrationDirectory, t as APP_SPACE_ID$1 } from "./verify-contract-spaces-BZDcJsuA-De8v4Z4T.mjs";
+import { CliStructuredError as CliStructuredError$1, errorConfigValidation as errorConfigValidation$1, errorContractConfigMissing as errorContractConfigMissing$1, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDriverRequired, errorFileNotFound, errorInvalidOutputFormat, errorMigrationPlanningFailed, errorOutputFormatMutex, errorTargetMigrationNotSupported, errorUnexpected as errorUnexpected$1 } from "@prisma/orm-framework/errors/control";
+import { ifDefined } from "@prisma/orm-framework/utils/defined";
+import { notOk } from "@prisma/orm-framework/utils/result";
+import { relative, resolve } from "pathe";
+import { readFile } from "node:fs/promises";
+import { hasMigrations } from "@prisma/orm-framework/components/control";
+import { ERROR_CODE_DESTRUCTIVE_CHANGES, errorDestructiveChanges, errorHashMismatch, errorMarkerMissing, errorRunnerFailed, errorRuntime, errorRuntime as errorRuntime$1, errorTargetMismatch } from "@prisma/orm-framework/errors/execution";
+import "@prisma/orm-framework/errors/migration";
+import { blindCast } from "@prisma/orm-framework/utils/casts";
+import { blue, bold, cyan, dim, green, magenta, red, yellow } from "colorette";
+import wrapAnsi from "wrap-ansi";
+import stringWidth from "string-width";
+import stripAnsi from "strip-ansi";
+import { isCI } from "ci-info";
+import * as clack from "@clack/prompts";
+//#region ../../../1-framework/3-tooling/cli/dist/command-helpers-CAoXqAY9.mjs
+function errorRefSetHashNotInGraph(resolvedHash, reachableHashes, graphTipHash) {
+	const reachableList = reachableHashes.length > 0 ? reachableHashes.join(", ") : "(none — migration graph is empty)";
+	const fix = reachableHashes.length > 0 ? graphTipHash !== null ? `Set the ref to a graph-node hash such as ${graphTipHash}, or run \`prisma-next migration plan\` to extend the graph.` : "Set the ref to a hash that appears in the migration graph." : "Run `prisma-next migration plan` first.";
+	return errorRuntime(`Resolved contract hash is not in the migration graph: ${resolvedHash}`, {
+		why: reachableHashes.length > 0 ? `The migration graph reaches ${reachableList}; resolved ${resolvedHash} isn't a graph node.` : "The migration graph is empty — no hashes reachable.",
+		fix,
+		meta: {
+			code: "MIGRATION.HASH_NOT_IN_GRAPH",
+			resolvedHash,
+			reachableHashes: [...reachableHashes],
+			...graphTipHash !== null ? { graphTipHash } : {}
+		}
+	});
+}
+function errorRefSetEmptySentinel(hash) {
+	return errorRuntime(`Cannot set ref to the empty-database sentinel: ${hash}`, {
+		why: "The empty-database sentinel is a planner internal; it is not a valid ref target.",
+		fix: "Set the ref to a contract hash from the migration graph, or use another ref name.",
+		meta: {
+			code: "MIGRATION.REF_SET_EMPTY_SENTINEL",
+			hash
+		}
+	});
+}
+/**
+* `--legend` was combined with a machine-readable or silent output flag.
+* The legend is human-only decoration on stderr.
+*/
+function errorLegendHumanOnly(conflictingFlag) {
+	return errorRuntime("`--legend` is only available for human-readable output", {
+		why: `\`--legend\` prints a glyph key to stderr and cannot be combined with ${conflictingFlag}.`,
+		fix: `Omit ${conflictingFlag} to print the legend alongside the tree, or omit --legend when using ${conflictingFlag}.`,
+		meta: {
+			code: "MIGRATION.LEGEND_HUMAN_ONLY",
+			conflictingFlag
+		}
+	});
+}
+/**
+* `--space <id>` was given a value that doesn't satisfy the contract-space
+* naming rule (`[a-z][a-z0-9_-]{0,63}` per `isValidSpaceId`). Fires before
+* any fs work — the input is syntactically rejected the same way an on-disk
+* directory with that name would be skipped by the enumerator.
+*/
+function errorInvalidSpaceId(spaceId) {
+	return errorRuntime(`Invalid contract space id: ${spaceId}`, {
+		why: "Contract space ids must match [a-z][a-z0-9_-]{0,63} (lowercase, starts with a letter, max 64 characters — the rule applied to every on-disk space directory).",
+		fix: "Pass a space id that matches the directory naming rule, or omit --space to list every space.",
+		meta: {
+			code: "MIGRATION.INVALID_SPACE_ID",
+			spaceId
+		}
+	});
+}
+/**
+* `migration list --space <id>` was given a contract-space id that has no
+* directory under `migrations/`. Distinct from "the space exists but is
+* empty" — that path renders the empty-state line and exits 0 per the
+* slice spec § Empty-state. This error fires only when `<projectMigrationsDir>/<spaceId>`
+* does not exist on disk.
+*
+* `availableSpaces` lists the contract-space directory names actually
+* present, sorted lex-asc, so the diagnostic can suggest a near match
+* without making the user reach for `ls`.
+*/
+function errorSpaceNotFound(spaceId, availableSpaces) {
+	const availableList = availableSpaces.length > 0 ? availableSpaces.join(", ") : "(none — no contract spaces on disk yet)";
+	const fix = availableSpaces.length > 0 ? `Pick one of: ${availableList}. Run \`prisma-next migration list\` (no --space) to see every space's migrations.` : "Author a migration with `prisma-next migration new` to create the first contract-space directory.";
+	return errorRuntime(`Unknown contract space: ${spaceId}`, {
+		why: `No directory named "${spaceId}" exists under the migrations root.`,
+		fix,
+		meta: {
+			code: "MIGRATION.SPACE_NOT_FOUND",
+			spaceId,
+			availableSpaces: [...availableSpaces]
+		}
+	});
+}
+function errorRefSetBundleNotFound(hash) {
+	return errorRuntime(`No migration bundle matches graph-node hash ${hash}`, {
+		why: `The hash is a graph node but no on-disk bundle has metadata.to = ${hash}.`,
+		fix: "Run `pnpm fixtures:check`, or re-emit the migration that produces this hash so its bundle is restored.",
+		meta: {
+			code: "MIGRATION.REF_SET_BUNDLE_NOT_FOUND",
+			hash
+		}
+	});
+}
+function errorPlanForgotTheFlag(resolvedHash, reachableRefs, graphTipHash) {
+	const reachableList = reachableRefs.length > 0 ? reachableRefs.map((r) => `${r.name} (${r.hash})`).join(", ") : "(none)";
+	const refFix = reachableRefs.length > 0 ? `Run migration plan with ${reachableRefs.map((r) => `--from ${r.name}`).join(" or ")}.` : graphTipHash !== null ? `Run migration plan --from ${graphTipHash}.` : "Commit pending migrations first, then run migration plan.";
+	return errorRuntime(`Resolved from-hash is not in the migration graph: ${resolvedHash}`, {
+		why: `The migration graph reaches ${reachableList}; resolved ${resolvedHash} isn't a graph node.`,
+		fix: refFix,
+		meta: {
+			code: "MIGRATION.HASH_NOT_IN_GRAPH",
+			resolvedHash,
+			reachableRefs: reachableRefs.map((r) => r.name),
+			...graphTipHash !== null ? { graphTipHash } : {}
+		}
+	});
+}
+/**
+* `viaRef: true` (the default) mirrors migration-tools' `errorRefNotResolvable`:
+* a ref name with no pointer file, where the fallback hash isn't a graph
+* node either — there's nothing to materialize a contract from.
+* `viaRef: false` is a distinct, ref-independent case: an explicit `--from
+* <hash>` that doesn't name a ref, on an empty migration graph, so there is
+* no graph node and no ref to resolve a contract through.
+*/
+function errorSnapshotMissing(identifier, options) {
+	const viaRef = options?.viaRef !== false;
+	const fix = viaRef ? `Create the ref with "prisma-next ref set ${identifier} <hash>" (or advance it via "prisma-next db update --advance-ref ${identifier}"), or pass a hash that is a node in the migration graph.` : `No contract source exists for hash "${identifier}" on an empty migration graph. Use --from with a ref name (its contract resolves through the snapshot store), or run db update first.`;
+	return errorRuntime(viaRef ? `Ref "${identifier}" is not resolvable` : `No contract source for from-hash "${identifier}"`, {
+		why: viaRef ? `Ref "${identifier}" has no pointer file, and the hash being resolved is not a node in the migration graph either.` : `Hash "${identifier}" is not a node in the migration graph (the graph is empty), and it does not name a ref either.`,
+		fix,
+		meta: {
+			code: "MIGRATION.SNAPSHOT_MISSING",
+			identifier,
+			viaRef
+		}
+	});
+}
+function errorMarkerMismatch(markerHash, reachableHashes, graphTip) {
+	const reachableList = reachableHashes.length > 0 ? reachableHashes.join(", ") : "(none — migration graph is empty)";
+	const planFromFix = graphTip !== null ? `Run \`prisma-next migration plan --from ${graphTip}\` if the live marker is canonical and the on-disk graph needs catching up.` : "Run `prisma-next migration plan` if the live marker is canonical and the on-disk graph needs catching up.";
+	return errorRuntime("Database marker is not reachable in the on-disk migration graph", {
+		why: `DB marker is ${markerHash}, but the on-disk migration graph reaches: ${reachableList}.`,
+		fix: [
+			planFromFix,
+			`Run \`prisma-next ref set db ${markerHash}\` if the on-disk graph is canonical and the local \`db\` ref drifted.`,
+			"Investigate whether the database was migrated by an out-of-band process."
+		].join("\n"),
+		meta: {
+			code: "MIGRATION.MARKER_MISMATCH",
+			markerHash,
+			reachableHashes: [...reachableHashes],
+			...graphTip !== null ? { graphTip } : {}
+		}
+	});
+}
+function errorPathUnreachable(failure) {
+	const meta = failure.meta ?? {};
+	const fromHashMeta = typeof meta["fromHash"] === "string" ? meta["fromHash"] : null;
+	const planFromHash = fromHashMeta === "<empty>" ? null : fromHashMeta;
+	const targetHash = typeof meta["targetHash"] === "string" ? meta["targetHash"] : typeof meta["target"] === "string" ? meta["target"] : null;
+	const deadEnds = meta["deadEnds"];
+	const deadEndsSuffix = Array.isArray(deadEnds) && deadEnds.length > 0 ? ` Dead-ends: ${deadEnds.map(String).join(", ")}.` : "";
+	const neverPlanned = meta["kind"] === "neverPlanned";
+	const planCommand = (() => {
+		if (neverPlanned) return "prisma-next migration plan --name <slug>";
+		if (planFromHash !== null && targetHash !== null) return `prisma-next migration plan --from ${planFromHash} --to ${targetHash} --name <slug>`;
+		if (targetHash !== null) return `prisma-next migration plan --to ${targetHash} --name <slug>`;
+		if (planFromHash !== null) return `prisma-next migration plan --from ${planFromHash} --name <slug>`;
+		return "prisma-next migration plan";
+	})();
+	const applyCommand = targetHash !== null && !neverPlanned ? `prisma-next migrate --to ${targetHash}` : "prisma-next migrate";
+	return errorRuntime(failure.summary, {
+		why: failure.why ?? `Cannot reach target "${targetHash ?? "<unknown>"}" from current marker "${fromHashMeta ?? "<unknown>"}".${deadEndsSuffix}`,
+		fix: [
+			"Plan the missing edge, then apply it:",
+			`  1. ${planCommand}`,
+			`  2. ${applyCommand}`,
+			"A rollback (reverse) plan is expected to contain destructive (DROP) operations — review them before applying.",
+			"Narrower cases (rename inference, re-adding a NOT NULL column without a safe default, or a type change that needs data) may additionally need a hint in the planned migration.",
+			"Inspect the on-disk graph with `prisma-next migration list`, or `prisma-next migration show <bundle>` for any bundle in the path you expected."
+		].join("\n"),
+		meta: {
+			...meta,
+			code: "MIGRATION.PATH_UNREACHABLE"
+		}
+	});
+}
+/**
+* Maps a `MigrationToolsError` raised by the migration-tools loader/graph
+* surface (`readMigrationPackage`, `readMigrationsDir`, `readRefs`,
+* `resolveRef`, `reconstructGraph`, ...) into a CLI `errorRuntime` envelope.
+*
+* The full `error.details` payload is forwarded into `meta` so machine
+* consumers (`--json`) see structural fields like `dir`, `storedHash`,
+* `computedHash` (for `MIGRATION.HASH_MISMATCH`) alongside the stable
+* `code`. The user-visible `summary`/`why`/`fix` text is unchanged.
+*
+* Callers are expected to gate on `MigrationToolsError.is(error)` first
+* (mirroring the original inline pattern); non-`MigrationToolsError`
+* values are caller-classified (rethrow, wrap with command-specific
+* `errorUnexpected`, etc.).
+*/
+function mapMigrationToolsError(error) {
+	return errorRuntime(error.message, {
+		why: error.why,
+		fix: error.fix,
+		meta: {
+			code: error.code,
+			...error.details ?? {}
+		}
+	});
+}
+/**
+* Shared "needs a live database" precondition for read verbs that consult the
+* marker/ledger (`migration log`, `migration status`). A command needs both a
+* connection string and a control-plane driver; either missing yields the same
+* `CONFIG.DB_CONNECTION_REQUIRED` envelope with `meta.missingFlags` (canonical long-form flags
+* per CLI Style Guide §Errors) so callers can react programmatically. Returns
+* `null` when both are present.
+*/
+function requireLiveDatabase(args) {
+	if (args.dbConnection && args.hasDriver) return null;
+	const missingFlags = args.dbConnection ? [] : ["--db"];
+	return errorDatabaseConnectionRequired({
+		why: args.why,
+		missingFlags,
+		...ifDefined("commandName", args.commandName),
+		...ifDefined("retryCommand", args.retryCommand)
+	});
+}
+/**
+* Maps a `RefResolutionError` from the contract/migration reference
+* resolver into a CLI structured error envelope.
+*/
+/**
+* A migration ref (dirName or hash-prefix) resolves in more than one contract
+* space. The user must qualify with `--space <id>` to disambiguate.
+*/
+function errorAmbiguousMigrationRef(ref, spaceIds) {
+	const spaceList = spaceIds.join(", ");
+	return errorRuntime(`Ambiguous migration reference: "${ref}" resolves in multiple spaces — qualify with --space <id>`, {
+		why: `"${ref}" matches migrations in spaces: ${spaceList}.`,
+		fix: `Qualify with --space <id> to select one space. Available matching spaces: ${spaceList}.`,
+		meta: {
+			code: "MIGRATION.AMBIGUOUS_MIGRATION_REF",
+			ref,
+			spaceIds: [...spaceIds]
+		}
+	});
+}
+function mapRefResolutionError(error) {
+	switch (error.kind) {
+		case "not-found": return errorRuntime(`Not a known ${error.grammar} reference: "${error.input}"`, {
+			why: `No ${error.grammar} matching "${error.input}" exists in the migration graph or refs index.`,
+			fix: error.grammar === "contract" ? "Provide a valid contract hash, ref name, or migration directory name." : "Provide a valid migration directory name or migration hash.",
+			meta: {
+				input: error.input,
+				grammar: error.grammar
+			}
+		});
+		case "ambiguous": return errorRuntime(`Ambiguous ${error.grammar} reference: "${error.input}"`, {
+			why: `"${error.input}" matches multiple ${error.grammar}s: ${error.candidates.join(", ")}`,
+			fix: "Provide a longer prefix or use the full hash to disambiguate.",
+			meta: {
+				input: error.input,
+				candidates: error.candidates,
+				grammar: error.grammar
+			}
+		});
+		case "wrong-grammar": return errorRuntime(error.message, {
+			why: error.message,
+			fix: error.fix,
+			meta: {
+				input: error.input,
+				expectedGrammar: error.expectedGrammar
+			}
+		});
+		case "invalid-format": return errorRuntime(`Invalid reference format: "${error.input}"`, {
+			why: error.reason,
+			fix: "Provide a valid contract hash, ref name, or migration directory name.",
+			meta: { input: error.input }
+		});
+	}
+}
+/**
+* Checks if verbose output is enabled at the specified level.
+*/
+function isVerbose(flags, level) {
+	return (flags.verbose ?? 0) >= level;
+}
+/**
+* Creates a color-aware formatter function.
+* Returns a function that applies the color only if colors are enabled.
+*/
+function createColorFormatter(useColor, colorFn) {
+	return useColor ? colorFn : (text) => text;
+}
+/**
+* Formats text with dim styling if colors are enabled.
+*/
+function formatDim(useColor, text) {
+	return useColor ? dim(text) : text;
+}
+/**
+* Fixed width for left column in help output.
+*/
+const LEFT_COLUMN_WIDTH$1 = 20;
+/**
+* Creates an arrow segment badge with green background and white text.
+* Body: green background with white "prisma-next" text
+* Tip: dark grey arrow pointing right (Powerline separator)
+*/
+function createPrismaNextBadge$1(useColor) {
+	if (!useColor) return "prisma-next";
+	return bold("prisma-next");
+}
+/**
+* Creates a padding function.
+*/
+function createPadFunction() {
+	return (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+}
+/**
+* Formats a header line: brand + operation + intent
+*/
+function formatHeaderLine$1(options) {
+	if (options.operation) return `${options.brand} ${options.operation} → ${options.intent}`;
+	return `${options.brand} ${options.intent}`;
+}
+/**
+* Formats a "Read more" URL line.
+* The "Read more" label is in default color (not cyan), and the URL is blue.
+*/
+function formatReadMoreLine$1(options) {
+	const labelPadded = createPadFunction()("Read more", options.maxLabelWidth);
+	const valueColored = options.useColor ? blue(options.url) : options.url;
+	return `${options.formatDimText("│")} ${labelPadded}  ${valueColored}`;
+}
+/**
+* Pads text to a fixed width, accounting for ANSI escape codes.
+* Uses string-width to measure the actual display width.
+*/
+function padToFixedWidth(text, width) {
+	const actualWidth = stringWidth(text);
+	const padding = Math.max(0, width - actualWidth);
+	return text + " ".repeat(padding);
+}
+/**
+* Renders a command tree structure.
+* Handles both single-level (subcommands of a command) and multi-level (top-level commands with subcommands) trees.
+*/
+function renderCommandTree(options) {
+	const { commands, useColor, formatDimText, hasItemsAfter, continuationPrefix } = options;
+	const lines = [];
+	if (commands.length === 0) return lines;
+	for (let i = 0; i < commands.length; i++) {
+		const cmd = commands[i];
+		if (!cmd) continue;
+		const subcommands = cmd.commands.filter((subcmd) => !subcmd.name().startsWith("_"));
+		const isLastCommand = i === commands.length - 1;
+		if (subcommands.length > 0) {
+			const treePrefix = `${isLastCommand && !hasItemsAfter ? formatDimText("└") : formatDimText("├")}─ `;
+			const treePrefixWidth = stringWidth(stripAnsi(treePrefix));
+			const remainingWidth = LEFT_COLUMN_WIDTH$1 - treePrefixWidth;
+			const commandNamePadded = padToFixedWidth(cmd.name(), remainingWidth);
+			const commandNameColored = useColor ? cyan(commandNamePadded) : commandNamePadded;
+			lines.push(`${formatDimText("│")} ${treePrefix}${commandNameColored}`);
+			for (let j = 0; j < subcommands.length; j++) {
+				const subcmd = subcommands[j];
+				if (!subcmd) continue;
+				const isLastSubcommand = j === subcommands.length - 1;
+				const shortDescription = subcmd.description() || "";
+				const treeChar = isLastSubcommand ? "└" : "├";
+				const continuation = continuationPrefix ?? (isLastCommand && isLastSubcommand && !hasItemsAfter ? " " : formatDimText("│"));
+				const subTreePrefix = `${continuation === " " ? " " : continuation}  ${formatDimText(treeChar)}─ `;
+				const subTreePrefixWidth = stringWidth(stripAnsi(subTreePrefix));
+				const subRemainingWidth = LEFT_COLUMN_WIDTH$1 - subTreePrefixWidth;
+				const subcommandNamePadded = padToFixedWidth(subcmd.name(), subRemainingWidth);
+				const subcommandNameColored = useColor ? cyan(subcommandNamePadded) : subcommandNamePadded;
+				lines.push(`${formatDimText("│")} ${subTreePrefix}${subcommandNameColored}  ${shortDescription}`);
+			}
+		} else {
+			const treePrefix = `${isLastCommand && !hasItemsAfter ? formatDimText("└") : formatDimText("├")}─ `;
+			const treePrefixWidth = stringWidth(stripAnsi(treePrefix));
+			const remainingWidth = LEFT_COLUMN_WIDTH$1 - treePrefixWidth;
+			const commandNamePadded = padToFixedWidth(cmd.name(), remainingWidth);
+			const commandNameColored = useColor ? cyan(commandNamePadded) : commandNamePadded;
+			const shortDescription = cmd.description() || "";
+			lines.push(`${formatDimText("│")} ${treePrefix}${commandNameColored}  ${shortDescription}`);
+		}
+	}
+	return lines;
+}
+/**
+* Formats the header in the new experimental visual style.
+* This header appears at the start of command output, showing the operation,
+* intent, documentation link, and parameters.
+*/
+function formatStyledHeader(options) {
+	const lines = [];
+	const useColor = options.flags.color !== false;
+	const formatDimText = (text) => formatDim(useColor, text);
+	const brand = createPrismaNextBadge$1(useColor);
+	const operation = useColor ? bold(options.command) : options.command;
+	const intent = formatDimText(options.description);
+	lines.push(formatHeaderLine$1({
+		brand,
+		operation,
+		intent
+	}));
+	lines.push(formatDimText("│"));
+	for (const detail of options.details) {
+		const labelPadded = padToFixedWidth(`${detail.label}:`, LEFT_COLUMN_WIDTH$1);
+		const labelColored = useColor ? cyan(labelPadded) : labelPadded;
+		lines.push(`${formatDimText("│")} ${labelColored}  ${detail.value}`);
+	}
+	if (options.url) {
+		lines.push(formatDimText("│"));
+		lines.push(formatReadMoreLine$1({
+			url: options.url,
+			maxLabelWidth: LEFT_COLUMN_WIDTH$1,
+			useColor,
+			formatDimText
+		}));
+	}
+	lines.push(formatDimText("└"));
+	return `${lines.join("\n")}\n`;
+}
+/**
+* Formats a success message in the styled output format.
+*/
+function formatSuccessMessage(flags) {
+	return `${createColorFormatter(flags.color !== false, green)("✔")} Success`;
+}
+/**
+* Fixed width for left column in help output.
+* Must match the value in styled.ts.
+*/
+const LEFT_COLUMN_WIDTH = 20;
+/**
+* Minimum width for right column wrapping in help output.
+*/
+const RIGHT_COLUMN_MIN_WIDTH = 40;
+/**
+* Maximum width for right column wrapping in help output (when terminal is wide enough).
+*/
+const RIGHT_COLUMN_MAX_WIDTH = 90;
+/**
+* Gets the terminal width, or returns a default if not available.
+*/
+function getTerminalWidth() {
+	const terminalWidth = process.stderr.columns || process.stdout.columns;
+	const envWidth = Number.parseInt(process.env["CLI_WIDTH"] || "", 10);
+	return terminalWidth || (Number.isFinite(envWidth) ? envWidth : 80);
+}
+/**
+* Calculates the available width for the right column based on terminal width.
+*/
+function calculateRightColumnWidth() {
+	const availableWidth = getTerminalWidth() - 2 - LEFT_COLUMN_WIDTH - 2;
+	return Math.max(RIGHT_COLUMN_MIN_WIDTH, Math.min(availableWidth, RIGHT_COLUMN_MAX_WIDTH));
+}
+/**
+* Creates the CLI brand badge.
+*/
+function createPrismaNextBadge(useColor) {
+	return useColor ? bold("prisma-next") : "prisma-next";
+}
+/**
+* Formats a header line: brand + operation + intent
+*/
+function formatHeaderLine(options) {
+	if (options.operation) return `${options.brand} ${options.operation} → ${options.intent}`;
+	return `${options.brand} ${options.intent}`;
+}
+/**
+* Wraps text to fit within a specified width using wrap-ansi.
+*/
+function wrapTextAnsi(text, width) {
+	return wrapAnsi(text, width, {
+		hard: false,
+		trim: true
+	}).split("\n");
+}
+/**
+* Formats a default value as "default: <value>" with dimming.
+*/
+function formatDefaultValue(value, useColor) {
+	const defaultText = `default: ${String(value)}`;
+	return useColor ? dim(defaultText) : defaultText;
+}
+/**
+* Formats a "Read more" URL line.
+*/
+function formatReadMoreLine(options) {
+	const labelPadded = `Read more${" ".repeat(Math.max(0, options.maxLabelWidth - 9))}`;
+	const valueColored = options.useColor ? blue(options.url) : options.url;
+	return `${options.formatDimText("│")} ${labelPadded}  ${valueColored}`;
+}
+/**
+* Formats multiline description with "Prisma Next" in green.
+*/
+function formatMultilineDescription(options) {
+	const lines = [];
+	const formatGreen = (text) => options.useColor ? green(text) : text;
+	const wrapWidth = 24 + calculateRightColumnWidth() - 2;
+	for (const descLine of options.descriptionLines) {
+		const wrappedLines = wrapTextAnsi(descLine.replace(/Prisma Next/g, (match) => formatGreen(match)), wrapWidth);
+		for (const wrappedLine of wrappedLines) lines.push(`${options.formatDimText("│")} ${wrappedLine}`);
+	}
+	return lines;
+}
+/**
+* Maps command paths to their documentation URLs.
+*/
+function getCommandDocsUrl(commandPath) {
+	return {
+		"contract emit": "https://pris.ly/contract-emit",
+		"contract infer": "https://pris.ly/contract-infer",
+		"db schema": "https://pris.ly/db-schema",
+		"db verify": "https://pris.ly/db-verify",
+		"db update": "https://pris.ly/db-update",
+		"migration plan": "https://pris.ly/migration-plan",
+		migrate: "https://pris.ly/migrate",
+		"migration show": "https://pris.ly/migration-show",
+		"migration status": "https://pris.ly/migration-status"
+	}[commandPath];
+}
+/**
+* Builds the full command path from a command and its parents.
+*/
+function buildCommandPath(command) {
+	const parts = [];
+	let current = command;
+	while (current && current.name() !== "prisma-next") {
+		parts.unshift(current.name());
+		current = current.parent ?? void 0;
+	}
+	return parts.join(" ");
+}
+/**
+* Formats help output for a command using the styled format.
+*/
+function formatCommandHelp(options) {
+	const { command, flags } = options;
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatDimText = (text) => formatDim(useColor, text);
+	const commandPath = buildCommandPath(command);
+	const shortDescription = command.description() || "";
+	const longDescription = getLongDescription(command);
+	const argsSuffix = command.registeredArguments.map((arg) => arg.required ? `<${arg.name()}>` : `[${arg.name()}]`).join(" ");
+	const brand = createPrismaNextBadge(useColor);
+	const commandWithArgs = argsSuffix ? `${commandPath} ${argsSuffix}` : commandPath;
+	const operation = useColor ? bold(commandWithArgs) : commandWithArgs;
+	const intent = formatDimText(shortDescription);
+	lines.push(formatHeaderLine({
+		brand,
+		operation,
+		intent
+	}));
+	lines.push(formatDimText("│"));
+	const optionsList = command.options.map((opt) => {
+		const description = opt.description || "";
+		const defaultValue = opt.defaultValue;
+		return {
+			flags: opt.flags,
+			description,
+			defaultValue
+		};
+	});
+	const subcommands = command.commands.filter((cmd) => !cmd.name().startsWith("_"));
+	if (subcommands.length > 0) {
+		const treeLines = renderCommandTree({
+			commands: subcommands,
+			useColor,
+			formatDimText,
+			hasItemsAfter: optionsList.length > 0
+		});
+		lines.push(...treeLines);
+	}
+	if (subcommands.length > 0 && optionsList.length > 0) lines.push(formatDimText("│"));
+	if (optionsList.length > 0) for (const opt of optionsList) {
+		const flagsPadded = padToFixedWidth(opt.flags, LEFT_COLUMN_WIDTH);
+		let flagsColored = flagsPadded;
+		if (useColor) {
+			flagsColored = flagsPadded.replace(/(<[^>]+>)/g, (match) => magenta(match));
+			flagsColored = cyan(flagsColored);
+		}
+		const rightColumnWidth = calculateRightColumnWidth();
+		const wrappedDescription = wrapTextAnsi(opt.description, rightColumnWidth);
+		lines.push(`${formatDimText("│")} ${flagsColored}  ${wrappedDescription[0] || ""}`);
+		for (let i = 1; i < wrappedDescription.length; i++) {
+			const emptyLabel = " ".repeat(LEFT_COLUMN_WIDTH);
+			lines.push(`${formatDimText("│")} ${emptyLabel}  ${wrappedDescription[i] || ""}`);
+		}
+		if (opt.defaultValue !== void 0) {
+			const emptyLabel = " ".repeat(LEFT_COLUMN_WIDTH);
+			const defaultText = formatDefaultValue(opt.defaultValue, useColor);
+			lines.push(`${formatDimText("│")} ${emptyLabel}  ${defaultText}`);
+		}
+	}
+	const docsUrl = getCommandDocsUrl(commandPath);
+	if (docsUrl) {
+		lines.push(formatDimText("│"));
+		lines.push(formatReadMoreLine({
+			url: docsUrl,
+			maxLabelWidth: LEFT_COLUMN_WIDTH,
+			useColor,
+			formatDimText
+		}));
+	}
+	const examples = getCommandExamples(command);
+	if (examples && examples.length > 0) {
+		lines.push(formatDimText("│"));
+		lines.push(`${formatDimText("│")} ${formatDimText("Examples:")}`);
+		for (const example of examples) lines.push(`${formatDimText("│")}   ${useColor ? dim("$") : "$"} ${example}`);
+	}
+	const seeAlso = getCommandSeeAlso(command);
+	if (seeAlso && seeAlso.length > 0) {
+		lines.push(formatDimText("│"));
+		lines.push(`${formatDimText("│")} ${formatDimText("See also:")}`);
+		for (const ref of seeAlso) lines.push(`${formatDimText("│")}   ${ref.verb}  ${formatDimText(ref.oneLiner)}`);
+	}
+	if (longDescription) {
+		lines.push(formatDimText("│"));
+		const descriptionLines = longDescription.split("\n").filter((line) => line.trim().length > 0);
+		lines.push(...formatMultilineDescription({
+			descriptionLines,
+			useColor,
+			formatDimText
+		}));
+	}
+	lines.push(formatDimText("└"));
+	return `${lines.join("\n")}\n`;
+}
+/**
+* Formats help output for the root program using the styled format.
+*/
+function formatRootHelp(options) {
+	const { program, flags } = options;
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatDimText = (text) => formatDim(useColor, text);
+	const brand = createPrismaNextBadge(useColor);
+	const intent = formatDimText("Manage your data layer");
+	lines.push(formatHeaderLine({
+		brand,
+		operation: "",
+		intent
+	}));
+	lines.push(formatDimText("│"));
+	const topLevelCommands = program.commands.filter((cmd) => !cmd.name().startsWith("_") && cmd.name() !== "help");
+	const globalOptions = program.options.map((opt) => {
+		const description = opt.description || "";
+		const defaultValue = opt.defaultValue;
+		return {
+			flags: opt.flags,
+			description,
+			defaultValue
+		};
+	});
+	if (topLevelCommands.length > 0) {
+		const treeLines = renderCommandTree({
+			commands: topLevelCommands,
+			useColor,
+			formatDimText,
+			hasItemsAfter: globalOptions.length > 0
+		});
+		lines.push(...treeLines);
+	}
+	if (topLevelCommands.length > 0 && globalOptions.length > 0) lines.push(formatDimText("│"));
+	if (globalOptions.length > 0) for (const opt of globalOptions) {
+		const flagsPadded = padToFixedWidth(opt.flags, LEFT_COLUMN_WIDTH);
+		let flagsColored = flagsPadded;
+		if (useColor) {
+			flagsColored = flagsPadded.replace(/(<[^>]+>)/g, (match) => magenta(match));
+			flagsColored = cyan(flagsColored);
+		}
+		const rightColumnWidth = calculateRightColumnWidth();
+		const wrappedDescription = wrapTextAnsi(opt.description, rightColumnWidth);
+		lines.push(`${formatDimText("│")} ${flagsColored}  ${wrappedDescription[0] || ""}`);
+		for (let i = 1; i < wrappedDescription.length; i++) {
+			const emptyLabel = " ".repeat(LEFT_COLUMN_WIDTH);
+			lines.push(`${formatDimText("│")} ${emptyLabel}  ${wrappedDescription[i] || ""}`);
+		}
+		if (opt.defaultValue !== void 0) {
+			const emptyLabel = " ".repeat(LEFT_COLUMN_WIDTH);
+			const defaultText = formatDefaultValue(opt.defaultValue, useColor);
+			lines.push(`${formatDimText("│")} ${emptyLabel}  ${defaultText}`);
+		}
+	}
+	const formatGreen = (text) => useColor ? green(text) : text;
+	const descriptionLines = [`Use ${formatGreen("Prisma Next")} to define your data layer as a contract. Sign your database and application with the same contract to guarantee compatibility. Plan and apply migrations to safely evolve your schema.`];
+	if (descriptionLines.length > 0) {
+		lines.push(formatDimText("│"));
+		lines.push(...formatMultilineDescription({
+			descriptionLines,
+			useColor,
+			formatDimText
+		}));
+	}
+	lines.push(formatDimText("└"));
+	return `${lines.join("\n")}\n`;
+}
+/**
+* Returns true when the process is running in any CI environment recognised
+* by the `ci-info` package. The single source of truth for CI detection
+* across this CLI — colour-output suppression and telemetry-skip both call
+* this helper, so neither path drifts from the other when a new CI provider
+* is added upstream.
+*
+* `ci-info` checks the standard `CI=true` marker plus dozens of
+* provider-specific environment variables (Buildkite, Jenkins, Drone,
+* Bitbucket Pipelines, Azure Pipelines, AWS CodeBuild, …) that the raw
+* `process.env.CI` read misses.
+*
+*/
+function isCI$1() {
+	return isCI;
+}
+/**
+* Render a single statement of an `OperationPreview` for the human-readable
+* preview block. SQL statements get a trailing `;` if missing so the rendered
+* preview is byte-identical to the legacy `string[]`-based renderer for SQL
+* targets. Other languages (`'mongodb-shell'`) render verbatim.
+*/
+function renderPreviewStatement(text, language) {
+	const trimmed = text.trim();
+	if (!trimmed) return void 0;
+	if (language === "sql") return trimmed.endsWith(";") ? trimmed : `${trimmed};`;
+	return trimmed;
+}
+/**
+* Choose the header label for a preview block. SQL-only previews keep the
+* legacy `DDL preview` label so the rendered output is byte-identical to the
+* pre-aggregate SQL CLI; previews from any other family — or a mix that
+* includes any non-SQL language — use the family-agnostic `Operation preview`
+* label.
+*
+* An empty `statements` array deliberately renders as `Operation preview`
+* rather than `DDL preview`: `Array.prototype.every` is vacuously true for
+* empty arrays, but we have no evidence the preview is SQL-only when no
+* statements are present, so the family-agnostic label is the safer default.
+*/
+function previewBlockHeader(preview) {
+	return preview.statements.length > 0 && preview.statements.every((s) => s.language === "sql") ? "DDL preview" : "Operation preview";
+}
+function formatPlannerWarningsBlock(warnings, useColor) {
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = ["", "Warnings:"];
+	for (const warning of warnings) lines.push(`  ${formatDimText(`- ${warning.summary}`)}`);
+	return lines;
+}
+/**
+* Render the shared per-space execution block consumed by the `db init`
+* / `db update` / `migrate` summaries. Always shows: space
+* label (`Extension space: <id>` or `App space`) → per-op lines under
+* each space → per-space marker hash (when known).
+*
+* `mode` controls the marker label phrasing — `'apply'` shows
+* `marker → <hash>` (post-apply), `'plan'` omits the marker line
+* entirely (no marker has been written yet).
+*/
+function formatPerSpaceBlock(perSpace, mode, useColor) {
+	const formatYellow = createColorFormatter(useColor, yellow);
+	const formatCyan = createColorFormatter(useColor, cyan);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = [];
+	for (let s = 0; s < perSpace.length; s++) {
+		const space = perSpace[s];
+		if (s > 0) lines.push("");
+		const header = space.kind === "app" ? formatCyan("App space") : formatCyan(`Extension space: ${space.spaceId}`);
+		lines.push(header);
+		if (space.operations.length === 0) lines.push(`  ${formatDimText("(no operations)")}`);
+		else for (let i = 0; i < space.operations.length; i++) {
+			const op = space.operations[i];
+			const treeChar = i === space.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`  ${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (mode === "apply" && space.marker) lines.push(`  ${formatDimText(`marker: ${space.marker.storageHash}`)}`);
+	}
+	return lines;
+}
+/**
+* Formats human-readable output for migration commands (db init, db update) in plan mode.
+*/
+function formatMigrationPlanOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const operationCount = result.plan?.operations.length ?? 0;
+	const spaceCount = result.perSpace?.length ?? 0;
+	if (spaceCount > 0) lines.push(`${formatGreen("✔")} Planned ${operationCount} operation(s) across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}`);
+	else lines.push(`${formatGreen("✔")} Planned ${operationCount} operation(s)`);
+	if (result.warnings && result.warnings.length > 0) lines.push(...formatPlannerWarningsBlock(result.warnings, useColor));
+	const formatYellow = createColorFormatter(useColor, yellow);
+	if (result.perSpace && result.perSpace.length > 0) {
+		lines.push("");
+		lines.push(...formatPerSpaceBlock(result.perSpace, "plan", useColor));
+		if (result.perSpace.some((s) => s.operations.some((op) => op.operationClass === "destructive"))) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	} else if (result.plan?.operations && result.plan.operations.length > 0) {
+		lines.push(`${formatDimText("│")}`);
+		for (let i = 0; i < result.plan.operations.length; i++) {
+			const op = result.plan.operations[i];
+			if (!op) continue;
+			const treeChar = i === result.plan.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (result.plan.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	}
+	if (result.plan?.destination) {
+		lines.push("");
+		lines.push(`${formatDimText(`Destination hash: ${result.plan.destination.storageHash}`)}`);
+	}
+	if (result.plannedAdvanceRef) {
+		lines.push("");
+		lines.push(formatDimText(`Would advance ref "${result.plannedAdvanceRef.name}" → ${result.plannedAdvanceRef.hash}`));
+	}
+	const preview = result.plan?.preview;
+	if (preview) {
+		lines.push("");
+		lines.push(`${formatDimText(previewBlockHeader(preview))}`);
+		if (preview.statements.length === 0) lines.push(`${formatDimText("No operations.")}`);
+		else {
+			lines.push("");
+			for (const statement of preview.statements) {
+				const rendered = renderPreviewStatement(statement.text, statement.language);
+				if (rendered) lines.push(rendered);
+			}
+		}
+	}
+	if (isVerbose(flags, 1)) lines.push(`${formatDimText(`Total time: ${result.timings.total}ms`)}`);
+	lines.push("");
+	lines.push(`${formatDimText("This is a dry run. No changes were applied.")}`);
+	lines.push(`${formatDimText("Run without --dry-run to apply changes.")}`);
+	return lines.join("\n");
+}
+function formatMigrationApplyCommandOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	lines.push(`${formatGreen("✔")} ${result.summary}`);
+	if (result.perSpace.length > 0) {
+		lines.push("");
+		for (const line of formatPerSpaceBlock(result.perSpace, "apply", useColor)) lines.push(line);
+	}
+	if (result.advancedRef) {
+		lines.push("");
+		lines.push(formatDimText(`Advanced ref "${result.advancedRef.name}" → ${result.advancedRef.hash}`));
+	}
+	lines.push("");
+	lines.push(formatDimText("Next: prisma-next migration status"));
+	if (isVerbose(flags, 1) && result.timings) {
+		lines.push("");
+		lines.push(formatDimText(`Total time: ${result.timings.total}ms`));
+	}
+	return lines.join("\n");
+}
+function formatSpaceShowBlock(space, useColor) {
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatYellow = createColorFormatter(useColor, yellow);
+	const formatDimText = (text) => formatDim(useColor, text);
+	const lines = [];
+	lines.push(`${formatGreen("✔")} ${space.name}`);
+	lines.push(`${formatDimText(`  from: ${space.fromContract ?? "(baseline)"}`)}`);
+	lines.push(`${formatDimText(`  to:   ${space.toContract}`)}`);
+	lines.push(`${formatDimText(`  hash: ${space.hash}`)}`);
+	lines.push(`${formatDimText(`  created: ${space.createdAt}`)}`);
+	lines.push("");
+	lines.push(`${space.operations.length} operation(s)`);
+	if (space.operations.length > 0) {
+		lines.push(`${formatDimText("│")}`);
+		for (let i = 0; i < space.operations.length; i++) {
+			const op = space.operations[i];
+			const treeChar = i === space.operations.length - 1 ? "└" : "├";
+			const destructiveMarker = op.operationClass === "destructive" ? ` ${formatYellow("(destructive)")}` : "";
+			lines.push(`${formatDimText(treeChar)}─ ${op.label}${destructiveMarker}`);
+		}
+		if (space.operations.some((op) => op.operationClass === "destructive")) {
+			lines.push("");
+			lines.push(`${formatYellow("⚠")} This migration contains destructive operations that may cause data loss.`);
+		}
+	}
+	if (space.preview.statements.length > 0) {
+		lines.push("");
+		lines.push(`${formatDimText(previewBlockHeader(space.preview))}`);
+		lines.push("");
+		for (const statement of space.preview.statements) {
+			const rendered = renderPreviewStatement(statement.text, statement.language);
+			if (rendered) lines.push(rendered);
+		}
+	}
+	return lines;
+}
+function formatMigrationShowOutput(result, flags) {
+	if (flags.quiet) return "";
+	const useColor = flags.color !== false;
+	return formatSpaceShowBlock(result.migration, useColor).join("\n");
+}
+/**
+* Formats human-readable output for migration commands (db init, db update) in apply mode.
+*/
+function formatMigrationApplyOutput(result, flags) {
+	if (flags.quiet) return "";
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatGreen = createColorFormatter(useColor, green);
+	const formatDimText = (text) => formatDim(useColor, text);
+	if (result.ok) {
+		const executed = result.execution?.operationsExecuted ?? 0;
+		const spaceCount = result.perSpace?.length ?? 0;
+		if (executed === 0) {
+			const acrossClause = spaceCount > 0 ? ` across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}` : "";
+			lines.push(`${formatGreen("✔")} Database already matches contract${acrossClause}`);
+		} else if (spaceCount > 0) lines.push(`${formatGreen("✔")} Applied ${executed} operation(s) across ${spaceCount} contract space${spaceCount === 1 ? "" : "s"}`);
+		else lines.push(`${formatGreen("✔")} Applied ${executed} operation(s)`);
+		if (result.warnings && result.warnings.length > 0) lines.push(...formatPlannerWarningsBlock(result.warnings, useColor));
+		if (result.perSpace && result.perSpace.length > 0) {
+			lines.push("");
+			lines.push(...formatPerSpaceBlock(result.perSpace, "apply", useColor));
+			lines.push("");
+			lines.push(formatDimText(`Run 'prisma-next migration status' to confirm ${spaceCount === 1 ? "the space is" : "all spaces are"} up to date.`));
+		} else if (result.marker) {
+			lines.push(`${formatDimText(`  App-space marker: ${result.marker.storageHash}`)}`);
+			if (result.marker.profileHash) lines.push(`${formatDimText(`  Profile hash: ${result.marker.profileHash}`)}`);
+		}
+		if (isVerbose(flags, 1)) lines.push(`${formatDimText(`  Total time: ${result.timings.total}ms`)}`);
+		if (result.advancedRef) lines.push(formatDimText(`Advanced ref "${result.advancedRef.name}" → ${result.advancedRef.hash}`));
+	}
+	return lines.join("\n");
+}
+/**
+* Formats JSON output for migration commands (db init, db update).
+*/
+function formatMigrationJson(result) {
+	return JSON.stringify(result, null, 2);
+}
+/**
+* The display label for a schema-diff issue in the shared error envelope,
+* derived from which sides are present: expected-only is a missing object,
+* actual-only an extra one, both a mismatch. `undefined` when the entry is not
+* a schema-diff issue (it carries neither side) so the caller can fall through
+* to its generic label.
+*/
+function schemaDiffIssueLabel(issue) {
+	const hasExpected = issue.expected !== void 0;
+	const hasActual = issue.actual !== void 0;
+	if (hasExpected && hasActual) return "mismatch";
+	if (hasExpected) return "missing";
+	if (hasActual) return "extra";
+}
+/**
+* Formats error output for human-readable display.
+*/
+function formatErrorOutput(error, flags) {
+	const lines = [];
+	const useColor = flags.color !== false;
+	const formatRed = createColorFormatter(useColor, red);
+	const formatDimText = (text) => formatDim(useColor, text);
+	lines.push(`${formatRed("✖")} ${error.summary} (${error.code})`);
+	if (error.why) lines.push(`${formatDimText(`  Why: ${error.why}`)}`);
+	if (error.fix) lines.push(`${formatDimText(`  Fix: ${error.fix}`)}`);
+	if (error.where?.path) {
+		const whereLine = error.where.line ? `${error.where.path}:${error.where.line}` : error.where.path;
+		lines.push(`${formatDimText(`  Where: ${whereLine}`)}`);
+	}
+	if (error.meta?.["conflicts"]) {
+		const conflicts = error.meta["conflicts"];
+		if (conflicts.length > 0) {
+			const maxToShow = isVerbose(flags, 1) ? conflicts.length : Math.min(3, conflicts.length);
+			const header = isVerbose(flags, 1) ? "  Conflicts:" : `  Conflicts (showing ${maxToShow} of ${conflicts.length}):`;
+			lines.push(`${formatDimText(header)}`);
+			for (const conflict of conflicts.slice(0, maxToShow)) lines.push(`${formatDimText(`    - [${conflict.kind}] ${conflict.summary}`)}`);
+			if (!isVerbose(flags, 1) && conflicts.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all conflicts")}`);
+		}
+	}
+	if (error.meta?.["issues"]) {
+		const issues = error.meta["issues"];
+		if (issues.length > 0) {
+			const maxToShow = isVerbose(flags, 1) ? issues.length : Math.min(3, issues.length);
+			const header = isVerbose(flags, 1) ? "  Issues:" : `  Issues (showing ${maxToShow} of ${issues.length}):`;
+			lines.push(`${formatDimText(header)}`);
+			for (const issue of issues.slice(0, maxToShow)) {
+				const label = issue.kind ?? schemaDiffIssueLabel(issue) ?? "issue";
+				const message = issue.message ?? issue.path?.join("/") ?? "";
+				lines.push(`${formatDimText(`    - [${label}] ${message}`)}`);
+			}
+			if (!isVerbose(flags, 1) && issues.length > maxToShow) lines.push(`${formatDimText("  Re-run with -v/--verbose to see all issues")}`);
+		}
+	}
+	if (error.docsUrl && isVerbose(flags, 1)) lines.push(formatDimText(error.docsUrl));
+	const plannerWarnings = error.meta?.["plannerWarnings"];
+	if (Array.isArray(plannerWarnings) && plannerWarnings.length > 0) {
+		const typedWarnings = blindCast(plannerWarnings);
+		lines.push(...formatPlannerWarningsBlock(typedWarnings, useColor));
+	}
+	if (isVerbose(flags, 2) && error.meta) lines.push(`${formatDimText(`  Meta: ${JSON.stringify(error.meta, null, 2)}`)}`);
+	return lines.join("\n");
+}
+/**
+* Formats error output as JSON.
+*/
+function formatErrorJson(error) {
+	return JSON.stringify(error, null, 2);
+}
+/**
+* Processes a CLI command result, handling both success and error cases.
+* Formats output appropriately and returns the exit code.
+* Never throws - returns exit code for commands to use with process.exit().
+*
+* Error output:
+* - JSON mode: JSON error to stdout (piped) via ui.output(), human sees nothing on stderr.
+* - Interactive: human-readable error to stderr.
+*/
+function handleResult(result, flags, ui, onSuccess) {
+	if (result.ok) {
+		if (onSuccess) onSuccess(result.value);
+		return 0;
+	}
+	const envelope = result.failure.toEnvelope();
+	if (flags.json) ui.output(formatErrorJson(envelope));
+	else ui.error(formatErrorOutput(envelope, flags));
+	return result.failure.code === "CLI.INIT_USER_ABORTED" ? 3 : 2;
+}
+function localeString(env) {
+	return env["LC_ALL"] ?? env["LC_CTYPE"] ?? env["LANG"] ?? "";
+}
+function isUtf8Locale(env) {
+	const locale = localeString(env);
+	if (locale.length === 0) return false;
+	return /UTF-8|utf8/i.test(locale);
+}
+function detectGlyphMode(input) {
+	if (!input.isTTY) return "ascii";
+	if (!isUtf8Locale(input.env)) return "ascii";
+	return "unicode";
+}
+function createShutdownHandler(options) {
+	const exit = options?.exit ?? ((code) => process.exit(code));
+	const gracePeriodMs = options?.gracePeriodMs ?? 3e3;
+	const controller = new AbortController();
+	let shuttingDown = false;
+	let graceTimer;
+	const onSignal = () => {
+		if (shuttingDown) {
+			exit(130);
+			return;
+		}
+		shuttingDown = true;
+		controller.abort();
+		graceTimer = setTimeout(() => exit(130), gracePeriodMs);
+		graceTimer.unref();
+	};
+	return {
+		signal: controller.signal,
+		isShuttingDown: () => shuttingDown,
+		onSignal,
+		clearGraceTimer: () => {
+			if (graceTimer !== void 0) {
+				clearTimeout(graceTimer);
+				graceTimer = void 0;
+			}
+		}
+	};
+}
+const globalHandler = createShutdownHandler();
+/**
+* The global AbortSignal. Pass this to any async operation that should
+* be cancellable on Ctrl+C (e.g., DB queries, long-running emit).
+*/
+const shutdownSignal = globalHandler.signal;
+/**
+* Installs SIGINT and SIGTERM handlers. Call once at CLI startup.
+*
+* - First signal: aborts the controller, starts a 3s grace timer.
+* - Second signal: force-exits immediately.
+*/
+let installed = false;
+function installShutdownHandlers() {
+	if (installed) return;
+	installed = true;
+	process.on("SIGINT", globalHandler.onSignal);
+	process.on("SIGTERM", globalHandler.onSignal);
+}
+/**
+* Composable CLI output abstraction.
+*
+* Follows the Unix convention of separating data from decoration:
+* - **stdout** — data output only (`ui.output()`). This is what scripts and pipes capture.
+* - **stderr** — all decoration (spinners, logs, notes, intro/outro). Visible in terminal, invisible in pipes.
+*
+* Rules:
+* 1. All methods except `output()` and `error()` write to stderr only in interactive mode.
+* 2. `output(data)` always writes to stdout — if a command calls it, there is data to emit.
+* 3. `error()` always writes to stderr — errors matter even when piped.
+* 4. Decoration is suppressed when piped unless `--format pretty` was explicit (`forcePretty`).
+* 5. Never write data to stderr — decoration methods are for human context only.
+* 6. Never write decoration to stdout — it breaks pipes, `$(...)` captures, and `> file` redirects.
+*/
+var TerminalUI = class TerminalUI {
+	/**
+	* True when stdout is a TTY (interactive terminal).
+	* False when piped (e.g., `prisma-next db verify | jq`).
+	*/
+	isInteractive;
+	/**
+	* Whether color output is enabled.
+	*/
+	useColor;
+	/**
+	* When true, decoration methods write even on non-TTY stdout
+	* (explicit `--format pretty`).
+	*/
+	forcePretty;
+	/**
+	* Whether stdout is a TTY — used for migration-list graph glyph detection.
+	*/
+	stdoutIsTTY;
+	/**
+	* Process environment snapshot for locale-aware glyph detection.
+	*/
+	env;
+	static stderrOpts = { output: process.stderr };
+	constructor(options) {
+		this.isInteractive = options?.interactive ?? !!process.stdout.isTTY;
+		this.forcePretty = options?.forcePretty ?? false;
+		this.useColor = options?.color ?? (this.isInteractive || this.forcePretty);
+		this.stdoutIsTTY = options?.stdoutIsTTY ?? !!process.stdout.isTTY;
+		this.env = options?.env ?? process.env;
+	}
+	get isTTY() {
+		return this.stdoutIsTTY;
+	}
+	/**
+	* Resolve glyph mode for migration list/tree output. `--ascii` forces ASCII;
+	* otherwise delegates to the pure {@link detectGlyphMode} helper.
+	*/
+	resolveGlyphMode(forceAscii) {
+		if (forceAscii) return "ascii";
+		return detectGlyphMode(this.glyphModeInput());
+	}
+	glyphModeInput() {
+		return {
+			isTTY: this.stdoutIsTTY,
+			env: this.env
+		};
+	}
+	get shouldDecorate() {
+		return this.isInteractive || this.forcePretty;
+	}
+	/**
+	* Log a message line to stderr. No-op when piped unless forcePretty.
+	*/
+	log(message) {
+		if (!this.shouldDecorate) return;
+		clack.log.message(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Log a success message to stderr. No-op when piped unless forcePretty.
+	*/
+	success(message) {
+		if (!this.shouldDecorate) return;
+		clack.log.success(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Log a warning message to stderr. No-op when piped unless forcePretty.
+	*/
+	warn(message) {
+		if (!this.shouldDecorate) return;
+		clack.log.warn(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Log an error message to stderr. Always writes (errors matter even in pipes).
+	*/
+	error(message) {
+		clack.log.error(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Log an info message to stderr. No-op when piped unless forcePretty.
+	*/
+	info(message) {
+		if (!this.shouldDecorate) return;
+		clack.log.info(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Log a step message to stderr. No-op when piped unless forcePretty.
+	*/
+	step(message) {
+		if (!this.shouldDecorate) return;
+		clack.log.step(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Display a note box on stderr. No-op when piped unless forcePretty.
+	*/
+	note(message, title) {
+		if (!this.shouldDecorate) return;
+		clack.note(message, title, TerminalUI.stderrOpts);
+	}
+	/**
+	* Display intro banner on stderr. No-op when piped unless forcePretty.
+	*/
+	intro(title) {
+		if (!this.shouldDecorate) return;
+		clack.intro(title, TerminalUI.stderrOpts);
+	}
+	/**
+	* Display outro banner on stderr. No-op when piped unless forcePretty.
+	*/
+	outro(message) {
+		if (!this.shouldDecorate) return;
+		clack.outro(message, TerminalUI.stderrOpts);
+	}
+	/**
+	* Create a Clack spinner on stderr with a 100ms delay threshold.
+	* The spinner only appears if the operation takes longer than the threshold,
+	* avoiding flicker for fast operations. Returns a no-op spinner when not decorating.
+	*/
+	spinner(delayMs = 100) {
+		const noop = {
+			start: () => {},
+			stop: () => {},
+			cancel: () => {},
+			error: () => {},
+			message: () => {},
+			clear: () => {},
+			get isCancelled() {
+				return false;
+			}
+		};
+		if (!this.shouldDecorate) return noop;
+		let inner;
+		let timer;
+		let pendingMsg;
+		let settled = false;
+		const ensureCleared = () => {
+			if (timer !== void 0) {
+				clearTimeout(timer);
+				timer = void 0;
+			}
+		};
+		const onAbort = () => {
+			if (!settled) {
+				settled = true;
+				ensureCleared();
+				if (inner) inner.cancel("Interrupted");
+			}
+		};
+		if (!shutdownSignal.aborted) shutdownSignal.addEventListener("abort", onAbort, { once: true });
+		return {
+			start(msg) {
+				pendingMsg = msg;
+				timer = setTimeout(() => {
+					if (!settled) {
+						inner = clack.spinner(TerminalUI.stderrOpts);
+						inner.start(pendingMsg);
+					}
+				}, delayMs);
+			},
+			stop(msg) {
+				settled = true;
+				ensureCleared();
+				if (inner) inner.stop(msg);
+			},
+			cancel(msg) {
+				settled = true;
+				ensureCleared();
+				if (inner) inner.cancel(msg);
+			},
+			error(msg) {
+				settled = true;
+				ensureCleared();
+				if (inner) inner.error(msg);
+			},
+			message(msg) {
+				pendingMsg = msg;
+				if (inner) inner.message(msg);
+			},
+			clear() {
+				settled = true;
+				ensureCleared();
+				if (inner) inner.clear();
+			},
+			get isCancelled() {
+				return inner?.isCancelled ?? false;
+			}
+		};
+	}
+	/**
+	* Prompt for yes/no confirmation on stderr. Returns true if confirmed.
+	* In non-interactive mode or when cancelled (Ctrl-C), returns false.
+	*/
+	async confirm(message) {
+		if (!this.isInteractive) return false;
+		const result = await clack.confirm({
+			message,
+			...TerminalUI.stderrOpts
+		});
+		if (clack.isCancel(result)) return false;
+		return result;
+	}
+	/**
+	* Write a raw line to stderr. No-op when piped unless forcePretty.
+	* Use for decoration that doesn't fit Clack's log format (e.g. styled headers).
+	*/
+	stderr(message) {
+		if (!this.shouldDecorate) return;
+		process.stderr.write(`${message}\n`);
+	}
+	/**
+	* Write machine-readable data to stdout.
+	* Always writes — if a command calls output(), there is data to emit.
+	*
+	* This is what scripts and pipes capture: `prisma-next db verify --json | jq .ok`
+	*/
+	output(data) {
+		process.stdout.write(`${data}\n`);
+	}
+	green(text) {
+		return this.useColor ? green(text) : text;
+	}
+	red(text) {
+		return this.useColor ? red(text) : text;
+	}
+	cyan(text) {
+		return this.useColor ? cyan(text) : text;
+	}
+	dim(text) {
+		return this.useColor ? dim(text) : text;
+	}
+	bold(text) {
+		return this.useColor ? bold(text) : text;
+	}
+	yellow(text) {
+		return this.useColor ? yellow(text) : text;
+	}
+};
+function createTerminalUI(flags, runtime) {
+	return new TerminalUI({
+		color: flags.color,
+		interactive: flags.interactive,
+		forcePretty: flags.format === "pretty" && flags.explicitFormat,
+		stdoutIsTTY: runtime?.isTTY,
+		env: runtime?.env
+	});
+}
+function isJsonFlagSet(json) {
+	return json === true;
+}
+function resolveOutputFormat(options) {
+	const formatOption = options.format;
+	const jsonFlag = isJsonFlagSet(options.json);
+	if (formatOption !== void 0) {
+		if (formatOption !== "pretty" && formatOption !== "json") throw errorInvalidOutputFormat(formatOption);
+		if (jsonFlag && formatOption === "pretty") throw errorOutputFormatMutex();
+		return {
+			format: formatOption,
+			explicitFormat: true
+		};
+	}
+	if (jsonFlag) return {
+		format: "json",
+		explicitFormat: false
+	};
+	if (!process.stdout.isTTY) return {
+		format: "json",
+		explicitFormat: false
+	};
+	return {
+		format: "pretty",
+		explicitFormat: false
+	};
+}
+function inferJsonModeForParseError(options) {
+	if (options.format === "json") return true;
+	if (isJsonFlagSet(options.json) && options.format !== "pretty") return true;
+	if (options.format !== void 0) return false;
+	return !process.stdout.isTTY;
+}
+function emitGlobalFlagParseError(error, options) {
+	const jsonMode = inferJsonModeForParseError(options);
+	const flags = {
+		format: jsonMode ? "json" : "pretty",
+		explicitFormat: false,
+		...jsonMode ? { json: true } : {},
+		color: false,
+		verbose: 0,
+		interactive: false
+	};
+	const ui = createTerminalUI(flags);
+	const exitCode = handleResult(notOk(error), flags, ui);
+	process.exit(exitCode);
+}
+/**
+* Parses global flags from CLI options.
+* Handles verbosity flags (-v, --trace), output format (--format, --json),
+* quiet mode, color, interactivity (--interactive/--no-interactive), and
+* auto-accept (-y/--yes).
+*
+* On invalid or conflicting format flags, prints a structured CLI error
+* envelope and exits with code 2.
+*/
+function parseGlobalFlagsOrExit(options) {
+	try {
+		return parseGlobalFlags(options);
+	} catch (error) {
+		if (CliStructuredError$1.is(error)) emitGlobalFlagParseError(error, options);
+		throw error;
+	}
+}
+/**
+* Parses global flags from CLI options.
+* Handles verbosity flags (-v, --trace), output format (--format, --json),
+* quiet mode, color, interactivity (--interactive/--no-interactive), and
+* auto-accept (-y/--yes).
+*
+* Throws {@link CliStructuredError} for invalid or conflicting format flags.
+*/
+function parseGlobalFlags(options) {
+	const { format, explicitFormat } = resolveOutputFormat(options);
+	const flags = {
+		format,
+		explicitFormat
+	};
+	if (format === "json") flags.json = true;
+	if (options.quiet || options.q) flags.quiet = true;
+	if (options.trace || process.env["PRISMA_NEXT_TRACE"] === "1") flags.verbose = 2;
+	else if (options.verbose || options.v || process.env["PRISMA_NEXT_DEBUG"] === "1") flags.verbose = 1;
+	else flags.verbose = 0;
+	if (process.env["NO_COLOR"] || flags.json) flags.color = false;
+	else if (options["no-color"]) flags.color = false;
+	else if (options.color !== void 0) flags.color = options.color;
+	else flags.color = process.stdout.isTTY && !isCI$1();
+	if (options["no-interactive"]) flags.interactive = false;
+	else if (options.interactive !== void 0) flags.interactive = options.interactive;
+	else flags.interactive = !!process.stdout.isTTY;
+	if (options.yes || options.y) flags.yes = true;
+	return flags;
+}
+/**
+* Bridges the two TTY checks (stdout via `flags`, stdin via
+* `process.stdin.isTTY`) into the `canPrompt` boolean the interactive
+* `init` flow consumes.
+*
+* Per the [Style Guide § Interactivity](../../../../../../../docs/CLI%20Style%20Guide.md#interactivity):
+*
+* - `flags.interactive` governs *decoration* (TerminalUI, intro/outro,
+*   spinners) and is derived from stdout-TTY by `parseGlobalFlags`,
+*   honouring `--interactive` / `--no-interactive`.
+* - Prompting additionally requires a stdin TTY — closing stdin is a
+*   common signal in CI / agent environments even when stdout stays
+*   attached.
+* - `--interactive` is the explicit override: when the user passes it,
+*   we honour it (e.g. testing flows where stdin is stubbed).
+*
+* Single source of truth for the interactive-prompt decision: both the
+* `init` action handler and the preAction telemetry bridge derive
+* prompt-eligibility from this helper so they cannot drift. Lives in
+* `global-flags` (alongside `parseGlobalFlags`) to keep
+* `utils/telemetry` and `commands/init/index` free of an import cycle.
+*
+* Exported so callers and tests can derive the same value without
+* touching `process` globals.
+*/
+function deriveCanPrompt(opts) {
+	if (opts.optionInteractive === true) return true;
+	if (opts.flagsInteractive === false) return false;
+	return opts.stdinIsTTY;
+}
+const longDescriptions = /* @__PURE__ */ new WeakMap();
+const commandExamples = /* @__PURE__ */ new WeakMap();
+const commandSeeAlso = /* @__PURE__ */ new WeakMap();
+/**
+* Sets both short and long descriptions for a command.
+* The short description is used in command trees and headers.
+* The long description is shown at the bottom of help output.
+*/
+function setCommandDescriptions(command, shortDescription, longDescription) {
+	command.description(shortDescription);
+	if (longDescription) longDescriptions.set(command, longDescription);
+	return command;
+}
+/**
+* Sets copy-pastable examples for a command, shown in help text.
+*/
+function setCommandExamples(command, examples) {
+	commandExamples.set(command, examples);
+	return command;
+}
+/**
+* Gets the long description from a command if it was set via setCommandDescriptions.
+*/
+function getLongDescription(command) {
+	return longDescriptions.get(command);
+}
+/**
+* Gets examples from a command if set via setCommandExamples.
+*/
+function getCommandExamples(command) {
+	return commandExamples.get(command);
+}
+/**
+* Sets cross-references to related commands, rendered in a "See also"
+* section below the Examples block in help output.
+*/
+function setCommandSeeAlso(command, refs) {
+	commandSeeAlso.set(command, refs);
+	return command;
+}
+/**
+* Gets the see-also cross-references from a command.
+*/
+function getCommandSeeAlso(command) {
+	return commandSeeAlso.get(command);
+}
+/**
+* Resolves the absolute path to contract.json from the config.
+*/
+function resolveContractPath(config) {
+	if (config.contract?.output === void 0) throw errorRuntime$1("config.contract.output is required to resolve the contract path", {
+		why: "CLI commands read the emitted contract from config.contract.output; the config has no value to read.",
+		fix: "Ensure your prisma-next.config.ts goes through `defineConfig()`, which normalises a default output when the provider supplies an input path, or set `contract.output` explicitly."
+	});
+	return resolve(config.contract.output);
+}
+/**
+* Resolves the migrations directory and config path from CLI options.
+* Shared by migrate, migration-plan, and migration-status.
+*
+* - `migrationsDir` is the project's top-level `migrations/` directory
+*   (the root that the aggregate loader walks for every contract space).
+* - `appMigrationsDir` is the app subspace directory under it
+*   (`<migrationsDir>/<APP_SPACE_ID>/`). Every per-app reader / writer
+*   (`migration new`, `migration plan`, `migrate`,
+*   `migration status`, `migration show`, `migration ref`) operates on
+*   this directory. Extensions own their own `migrations/<spaceId>/`.
+* - `refsDir` is the app's refs directory (`<appMigrationsDir>/refs/`).
+*   The framework does not maintain refs at the migrations root.
+*/
+function resolveMigrationPaths(configOption, config) {
+	const configPath = configOption ? relative(process.cwd(), resolve(configOption)) : "prisma-next.config.ts";
+	const migrationsDir = resolve(configOption ? resolve(configOption, "..") : process.cwd(), config.migrations?.dir ?? "migrations");
+	const migrationsRelative = relative(process.cwd(), migrationsDir);
+	const appMigrationsDir = spaceMigrationDirectory(migrationsDir, APP_SPACE_ID$1);
+	return {
+		configPath,
+		migrationsDir,
+		migrationsRelative,
+		appMigrationsDir,
+		appMigrationsRelative: relative(process.cwd(), appMigrationsDir),
+		refsDir: resolve(appMigrationsDir, "refs")
+	};
+}
+function collectDeclaredInvariants(graph) {
+	const declared = /* @__PURE__ */ new Set();
+	for (const edges of graph.forwardChain.values()) for (const edge of edges) for (const inv of edge.invariants) declared.add(inv);
+	return declared;
+}
+/**
+* Maps a `MigrationEdge` to the structural-edge shape used in the
+* `MIGRATION.NO_INVARIANT_PATH` error envelope. Shared between
+* `migrate` and `migration status` so both commands surface
+* the same JSON wire shape when an invariant-aware route is unsatisfiable.
+*/
+function toStructuralEdge(edge) {
+	return {
+		dirName: edge.dirName,
+		migrationHash: edge.migrationHash,
+		from: edge.from,
+		to: edge.to,
+		invariants: edge.invariants
+	};
+}
+function targetSupportsMigrations(target) {
+	return hasMigrations(target);
+}
+function getTargetMigrations(target) {
+	return hasMigrations(target) ? target.migrations : void 0;
+}
+/**
+* Reads and parses contract.json, validating the framework-level envelope
+* fields (storageHash, schemaVersion, target, targetFamily).
+*
+* Family-specific validation (storage structure, codec mappings, etc.)
+* happens downstream in the control client via the family instance.
+*/
+async function readContractEnvelope(config) {
+	const contractPath = resolveContractPath(config);
+	const content = await readFile(contractPath, "utf-8");
+	const json = JSON.parse(content);
+	const { schemaVersion, target, targetFamily, profileHash } = json;
+	const storageHash = json["storage"]?.["storageHash"];
+	if (typeof storageHash !== "string") throw new CliStructuredError$1("CONTRACT.VALIDATION_FAILED", `Contract at ${relative(process.cwd(), contractPath)} is missing a valid storage.storageHash. Run \`prisma-next contract emit\` to regenerate.`, { where: { path: contractPath } });
+	if (typeof schemaVersion !== "string") throw new CliStructuredError$1("CONTRACT.VALIDATION_FAILED", `Contract at ${relative(process.cwd(), contractPath)} is missing schemaVersion.`, { where: { path: contractPath } });
+	if (typeof target !== "string") throw new CliStructuredError$1("CONTRACT.VALIDATION_FAILED", `Contract at ${relative(process.cwd(), contractPath)} is missing target.`, { where: { path: contractPath } });
+	if (typeof targetFamily !== "string") throw new CliStructuredError$1("CONTRACT.VALIDATION_FAILED", `Contract at ${relative(process.cwd(), contractPath)} is missing targetFamily.`, { where: { path: contractPath } });
+	return {
+		...json,
+		storageHash,
+		schemaVersion,
+		target,
+		targetFamily,
+		...typeof profileHash === "string" ? { profileHash } : {}
+	};
+}
+/**
+* Masks credentials in a database connection URL.
+* Handles standard URLs (username + password + query params) and libpq-style key=value strings.
+*/
+function maskConnectionUrl(url) {
+	try {
+		const parsed = new URL(url);
+		if (parsed.username) parsed.username = "****";
+		if (parsed.password) parsed.password = "****";
+		for (const key of [...parsed.searchParams.keys()]) if (/password/i.test(key)) parsed.searchParams.set(key, "****");
+		return parsed.toString();
+	} catch {
+		return url.replace(/password\s*=\s*\S+/gi, "password=****").replace(/user\s*=\s*\S+/gi, "user=****");
+	}
+}
+/**
+* Strips raw connection URL fragments from an error message to prevent credential leakage.
+* Call this before surfacing driver errors to the user.
+*/
+function sanitizeErrorMessage(message, connectionUrl) {
+	if (!connectionUrl) return message;
+	try {
+		const parsed = new URL(connectionUrl);
+		let sanitized = message;
+		sanitized = sanitized.replaceAll(connectionUrl, maskConnectionUrl(connectionUrl));
+		if (parsed.password) sanitized = sanitized.replaceAll(parsed.password, "****");
+		if (parsed.username) sanitized = sanitized.replaceAll(parsed.username, "****");
+		return sanitized;
+	} catch {
+		return message.replace(/password\s*=\s*\S+/gi, "password=****").replace(/user\s*=\s*\S+/gi, "user=****");
+	}
+}
+/**
+* Registers the global CLI options shared by every command:
+* --format, --json, -q/--quiet, -v/--verbose, --trace, --color, --no-color,
+* --interactive, --no-interactive, -y/--yes.
+*
+* Also sets up the styled help formatter.
+*/
+function addGlobalOptions(command) {
+	return command.configureHelp({ formatHelp: (cmd) => {
+		return formatCommandHelp({
+			command: cmd,
+			flags: parseGlobalFlags({})
+		});
+	} }).option("--format <pretty|json>", "Output format (default: pretty, or json when stdout is not a TTY)").option("--json", "Output as JSON (alias for --format json)").option("-q, --quiet", "Quiet mode: errors only").option("-v, --verbose", "Verbose output: debug info, timings").option("--trace", "Trace output: deep internals, stack traces").option("--color", "Force color output").option("--no-color", "Disable color output").option("--interactive", "Force interactive mode").option("--no-interactive", "Disable interactive prompts").option("-y, --yes", "Auto-accept prompts");
+}
+//#endregion
+export { maskConnectionUrl as $, errorSpaceNotFound as A, formatMigrationJson as B, errorPlanForgotTheFlag as C, errorRunnerFailed as D, errorRefSetHashNotInGraph as E, formatDim as F, formatSuccessMessage as G, formatMigrationShowOutput as H, formatErrorJson as I, installShutdownHandlers as J, getTargetMigrations as K, formatErrorOutput as L, errorTargetMismatch as M, errorUnexpected$1 as N, errorRuntime$1 as O, formatCommandHelp as P, mapRefResolutionError as Q, formatMigrationApplyCommandOutput as R, errorPathUnreachable as S, errorRefSetEmptySentinel as T, formatRootHelp as U, formatMigrationPlanOutput as V, formatStyledHeader as W, isVerbose as X, isCI$1 as Y, mapMigrationToolsError as Z, errorInvalidSpaceId as _, createColorFormatter as a, resolveMigrationPaths as at, errorMarkerMissing as b, errorAmbiguousMigrationRef as c, setCommandExamples as ct, errorContractValidationFailed as d, toStructuralEdge as dt, parseGlobalFlags as et, errorDatabaseConnectionRequired as f, errorHashMismatch as g, errorFileNotFound as h, collectDeclaredInvariants as i, resolveContractPath as it, errorTargetMigrationNotSupported as j, errorSnapshotMissing as k, errorConfigValidation$1 as l, setCommandSeeAlso as lt, errorDriverRequired as m, ERROR_CODE_DESTRUCTIVE_CHANGES as n, readContractEnvelope as nt, createTerminalUI as o, sanitizeErrorMessage as ot, errorDestructiveChanges as p, handleResult as q, addGlobalOptions as r, requireLiveDatabase as rt, deriveCanPrompt as s, setCommandDescriptions as st, CliStructuredError$1 as t, parseGlobalFlagsOrExit as tt, errorContractConfigMissing$1 as u, targetSupportsMigrations as ut, errorLegendHumanOnly as v, errorRefSetBundleNotFound as w, errorMigrationPlanningFailed as x, errorMarkerMismatch as y, formatMigrationApplyOutput as z };
+
+//# sourceMappingURL=command-helpers-CAoXqAY9-DWUBcTXM.mjs.map