@prisma-next/cli 0.4.2 → 0.4.4

package/README.md

@@ -951,12 +951,12 @@ prisma-next migration plan [--config <path>] [--name <slug>] [--from <hash>] [--
 2. Reads existing migrations from `config.migrations.dir` (default: `migrations/`)
 3. Determines the starting point: `--from <hash>` if provided, otherwise the latest migration target
 4. Diffs the starting contract against the new contract using the target's migration planner
-5. Scaffolds a new migration package: `migration.ts` (containing `placeholder(...)` lambdas for any data transforms), `migration.json` (with a content-addressed `migrationId` over the planned ops, or over `[]` when the planner could not lower any calls because of placeholders), `ops.json` (the planned ops, or `[]` in the placeholder-blocked case), and contract bookends. The package is **always** fully attested — there is no draft state on disk.
-6. If the plan has unfilled `placeholder(...)` slots, the command returns a successful `pendingPlaceholders` envelope (a warning, not a failure) asking the developer to fill in the slots before re-emitting. The on-disk `ops.json` is `[]` and `migrationId` is the hash of `(manifest, [])`, so applying the migration as-written will not advance the storage hash to the intended destination — the runner's destination-hash post-check surfaces this as a state mismatch. After filling in the placeholders, run `node migrations/<dir>/migration.ts` to re-emit `ops.json` and the corresponding `migrationId`. `PN-MIG-2001` is raised only at self-emit time when a slot is still unfilled.
+5. Scaffolds a new migration package: `migration.ts` (containing `placeholder(...)` lambdas for any data transforms), `migration.json` (with a content-addressed `migrationHash` over the planned ops, or over `[]` when the planner could not lower any calls because of placeholders), `ops.json` (the planned ops, or `[]` in the placeholder-blocked case), and contract bookends. The package is **always** fully attested — there is no draft state on disk.
+6. If the plan has unfilled `placeholder(...)` slots, the command returns a successful `pendingPlaceholders` envelope (a warning, not a failure) asking the developer to fill in the slots before re-emitting. The on-disk `ops.json` is `[]` and `migrationHash` is the hash of `(metadata, [])`, so applying the migration as-written will not advance the storage hash to the intended destination — the runner's destination-hash post-check surfaces this as a state mismatch. After filling in the placeholders, run `node migrations/<dir>/migration.ts` to re-emit `ops.json` and the corresponding `migrationHash`. `PN-MIG-2001` is raised only at self-emit time when a slot is still unfilled.
 
 **Outputs:**
 - `migrations/<dir>/migration.ts` — editable migration source (with `placeholder(...)` slots when the planner inserted them)
-- `migrations/<dir>/migration.json` — fully attested manifest (`migrationId: string`, never null)
+- `migrations/<dir>/migration.json` — fully attested metadata (`migrationHash: string`, never null)
 - `migrations/<dir>/ops.json` — planned operations (empty list `[]` if placeholders blocked the planner)
 - `migrations/<dir>/start-contract.{json,d.ts}` — bookend from the "from" side (when applicable)
 - `migrations/<dir>/end-contract.{json,d.ts}` — bookend from the "to" side
@@ -965,14 +965,14 @@ prisma-next migration plan [--config <path>] [--name <slug>] [--from <hash>] [--
 
 ### `prisma-next migration show`
 
-Display a migration package's operations, DDL preview, and metadata. Accepts a directory path, a hash prefix (git-style matching against `migrationId`), or defaults to the latest migration.
+Display a migration package's operations, DDL preview, and metadata. Accepts a directory path, a hash prefix (git-style matching against `migrationHash`), or defaults to the latest migration.
 
 ```bash
 prisma-next migration show [target] [--config <path>] [--json] [-v] [-q] [--color/--no-color]
 ```
 
 **Options:**
-- `[target]`: Migration directory path or migrationId hash prefix (defaults to latest)
+- `[target]`: Migration directory path or `migrationHash` prefix (defaults to latest)
 - `--config <path>`: Path to `prisma-next.config.ts`
 - `--json`: Output as JSON object
 - `-q, --quiet`: Quiet mode (errors only)
@@ -980,7 +980,7 @@ prisma-next migration show [target] [--config <path>] [--json] [-v] [-q] [--colo
 
 **What it does:**
 1. If `target` is a path (contains `/` or `\`), reads that directory directly
-2. If `target` is a hash prefix, scans all attested migrations and matches against `migrationId`
+2. If `target` is a hash prefix, scans all attested migrations and matches against `migrationHash`
 3. If no target, defaults to the latest migration
 4. Displays operations with operation class badges, destructive warnings, and DDL preview
 
@@ -1034,15 +1034,14 @@ prisma-next migration apply [--db <url>] [--ref <name>] [--config <path>] [--jso
 - `-v, --verbose`: Verbose output (debug info, timings)
 
 **What it does:**
-1. Reads migration packages from `config.migrations.dir` (every package is attested — there is no on-disk draft state)
-2. **Defense in depth:** rehashes `(manifest, ops)` for each loaded bundle and confirms it matches the stored `migrationId`. If a bundle has been hand-edited or partially written since emit, apply aborts with a structured runtime error pointing at the offending directory and asks the developer to re-run `node migrations/<dir>/migration.ts` (or restore from version control).
-3. Reconstructs the migration graph from all loaded bundles
-4. Determines the destination hash: from `--ref` (via `refs.json`) or from `contract.json`
-5. Connects to the database and reads the current marker hash
-6. Finds the shortest path from the marker hash to the destination using graph pathfinding
-7. Executes each pending migration in order using the target's `MigrationRunner`
-8. Each migration runs in its own transaction with prechecks, postchecks, and idempotency checks enabled
-9. After each migration, the runner verifies the schema and updates the marker/ledger
+1. Reads migration packages from `config.migrations.dir`. Every package is attested — there is no on-disk draft state. The loader (`readMigrationPackage` in `@prisma-next/migration-tools/io`) rehashes `(metadata, ops)` for each `MigrationPackage` it returns and confirms the result matches the stored `migrationHash`. If a package has been hand-edited or partially written since emit, the load fails with `MIGRATION.HASH_MISMATCH` pointing at the offending directory and asks the developer to re-run `node migrations/<dir>/migration.ts` (or restore from version control).
+2. Reconstructs the migration graph from all loaded packages
+3. Determines the destination hash: from `--ref` (via `refs.json`) or from `contract.json`
+4. Connects to the database and reads the current marker hash
+5. Finds the shortest path from the marker hash to the destination using graph pathfinding
+6. Executes each pending migration in order using the target's `MigrationRunner`
+7. Each migration runs in its own transaction with prechecks, postchecks, and idempotency checks enabled
+8. After each migration, the runner verifies the schema and updates the marker/ledger
 
 **Config requirements:** Requires `driver` and `db.connection` (or `--db`). `migrations.dir` is optional and defaults to `migrations/`.
 
@@ -1050,7 +1049,7 @@ prisma-next migration apply [--db <url>] [--ref <name>] [--config <path>] [--jso
 
 **Ref-based routing:** With `--ref`, apply targets the ref's hash instead of the contract hash. This enables multi-environment workflows where staging and production track different points in the migration graph.
 
-### Emitting `ops.json` and computing `migrationId`
+### Emitting `ops.json` and computing `migrationHash`
 
 There is no dedicated CLI command for emitting a migration — migrations
 self-emit. After scaffolding (via `migration plan` or `migration new`),
@@ -1061,7 +1060,9 @@ run `migration.ts` directly with Node to produce `ops.json` and attest
 node migrations/<dir>/migration.ts
 ```
 
-The scaffolded `migration.ts` calls `MigrationCLI.run(import.meta.url, ...)` from `@prisma-next/cli/migration-cli` when invoked as the entrypoint. (Postgres scaffolds re-export `MigrationCLI` through `@prisma-next/target-postgres/migration` so a Postgres `migration.ts` only needs the single facade import; Mongo scaffolds still pull from `@prisma-next/cli/migration-cli` directly.) The CLI entrypoint loads `prisma-next.config.ts`, assembles a `ControlStack`, instantiates the migration with that stack (so `dataTransform` and other adapter-aware helpers can materialize a real adapter), and serializes operations to `ops.json` while writing the content-addressed `migrationId` into `migration.json`. If `migration.ts` contains unfilled `placeholder()` slots, the script exits with `PN-MIG-2001` and reports the slot to fill in.
+The scaffolded `migration.ts` calls `MigrationCLI.run(import.meta.url, ...)` from `@prisma-next/cli/migration-cli` when invoked as the entrypoint. (Postgres scaffolds re-export `MigrationCLI` through `@prisma-next/target-postgres/migration` so a Postgres `migration.ts` only needs the single facade import; Mongo scaffolds still pull from `@prisma-next/cli/migration-cli` directly.) The CLI entrypoint loads `prisma-next.config.ts`, assembles a `ControlStack`, instantiates the migration with that stack (so `dataTransform` and other adapter-aware helpers can materialize a real adapter), and serializes operations to `ops.json` while writing the content-addressed `migrationHash` into `migration.json`. If `migration.ts` contains unfilled `placeholder()` slots, the script exits with `PN-MIG-2001` and reports the slot to fill in.
+
+`MigrationCLI.run` accepts an optional third argument `{ argv?, stdout?, stderr? }` for in-process testability (default: `process.argv` / `process.stdout` / `process.stderr`) and returns the exit code as a `Promise<number>`. The flag surface is `--help` / `--dry-run` / `--config <path>`, parsed by [`clipanion`](https://github.com/arcanis/clipanion). The main multi-command surface (`prisma-next contract emit`, `db verify`, etc.) uses Commander; the per-migration `MigrationCLI.run` entrypoint uses clipanion to keep authored migration files lightweight and in-process testable.
 
 ### `prisma-next migration ref`
 
@@ -1093,17 +1094,22 @@ flowchart TD
     CMD_EMIT[Emit Command]
     CMD_DB[DB Commands]
     CMD_MIG[Migration Commands]
-    LOAD[TS Contract Loader]
+    EXEC_EMIT[executeContractEmit]
+    PUBLISH[publishContractArtifactPair]
     EMIT[Emitter]
     CTRL[Control Client]
     MIG_TOOLS["@prisma-next/migration-tools"]
     FS[File System]
+    VITE["@prisma-next/vite-plugin-contract-emit"]
 
     CLI --> CMD_EMIT
     CLI --> CMD_DB
     CLI --> CMD_MIG
-    CMD_EMIT --> LOAD
-    LOAD --> EMIT
+    CMD_EMIT --> EXEC_EMIT
+    VITE --> EXEC_EMIT
+    EXEC_EMIT --> EMIT
+    EXEC_EMIT --> PUBLISH
+    PUBLISH --> FS
     CMD_DB --> CTRL
     CMD_MIG --> CTRL
     CMD_MIG --> MIG_TOOLS
@@ -1111,6 +1117,35 @@ flowchart TD
     CTRL --> FS
 ```
 
+## Canonical Contract Emit Path
+
+> **For agents/contributors**: `executeContractEmit` is the SINGLE publication path
+> for `contract.json` + `contract.d.ts`. The CLI command (`prisma-next contract
+> emit`) and the Vite plugin (`@prisma-next/vite-plugin-contract-emit`) both
+> call into it. Do NOT re-implement the load → emit → publish dance in a new
+> caller; if you need additional behavior, extend `ContractEmitOptions` /
+> `ContractEmitResult` and update `executeContractEmit` itself.
+
+How it composes:
+
+- The whole flow (load config → resolve source → emit bytes → publish) is
+  serialized per output JSON path via `queueEmitByOutput`
+  (`src/utils/emit-queue.ts`). Concurrent calls for the same output line up
+  FIFO; concurrent calls for distinct outputs run in parallel. Last submission
+  wins on disk.
+- Within a single emit, `publishContractArtifactPair`
+  (`src/utils/publish-contract-artifact-pair.ts`) stages temp files, renames
+  `contract.d.ts` before `contract.json`, and attempts to restore the previous
+  pair if either rename fails — so type-only consumers never observe a
+  mismatched pair.
+- Long-lived hosts (Vite dev server, watch CLIs) must call `disposeEmitQueue`
+  on shutdown to drop the per-output queue state, otherwise the module-global
+  queue map leaks one entry per unique output path.
+
+The `validateContractDeps` warning is returned in `ContractEmitResult.validationWarning`
+rather than written to stderr by the operation — callers (CLI, Vite plugin) decide
+how to render it (`ui.warn`, plugin logger, etc.).
+
 ## Config Validation and Normalization
 
 The `defineConfig()` function validates and normalizes configs using Arktype:
@@ -1266,7 +1301,7 @@ export default defineConfig({
 - **`commander`**: CLI argument parsing and command routing
 - **`esbuild`**: Bundling TypeScript contract files with import allowlisting
 - **`@prisma-next/emitter`**: Contract emission engine (returns strings)
-- **`@prisma-next/migration-tools`**: On-disk migration I/O, attestation, and history reconstruction
+- **`@prisma-next/migration-tools`**: On-disk migration I/O, hash verification, and history reconstruction
 - **`@prisma-next/framework-components`**: Control plane types, migration operation types, control stack (via `./control`)
 - **`@prisma-next/errors`**: Error types and factories (via `./control`)
 

package/dist/cli-errors-By1iVE3z.mjs

@@ -0,0 +1,34 @@
+import { CliStructuredError as CliStructuredError$1, errorConfigValidation as errorConfigValidation$1, errorContractConfigMissing as errorContractConfigMissing$1, errorContractValidationFailed, errorDatabaseConnectionRequired, errorDriverRequired, errorFileNotFound, errorMigrationPlanningFailed, errorTargetMigrationNotSupported, errorUnexpected as errorUnexpected$1 } from "@prisma-next/errors/control";
+import { ERROR_CODE_DESTRUCTIVE_CHANGES, errorDestructiveChanges, errorHashMismatch, errorMarkerMissing, errorRunnerFailed, errorRuntime, errorRuntime as errorRuntime$1, errorTargetMismatch } from "@prisma-next/errors/execution";
+import "@prisma-next/errors/migration";
+
+//#region src/utils/cli-errors.ts
+/**
+* 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 ?? {}
+		}
+	});
+}
+
+//#endregion
+export { errorUnexpected$1 as _, errorContractValidationFailed as a, errorDriverRequired as c, errorMarkerMissing as d, errorMigrationPlanningFailed as f, errorTargetMismatch as g, errorTargetMigrationNotSupported as h, errorContractConfigMissing$1 as i, errorFileNotFound as l, errorRuntime$1 as m, ERROR_CODE_DESTRUCTIVE_CHANGES as n, errorDatabaseConnectionRequired as o, errorRunnerFailed as p, errorConfigValidation$1 as r, errorDestructiveChanges as s, CliStructuredError$1 as t, errorHashMismatch as u, mapMigrationToolsError as v };
+//# sourceMappingURL=cli-errors-By1iVE3z.mjs.map

package/dist/cli-errors-By1iVE3z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-errors-By1iVE3z.mjs","names":[],"sources":["../src/utils/cli-errors.ts"],"sourcesContent":["/**\n * Re-export all domain error factories from @prisma-next/errors for convenience.\n * CLI-specific errors (e.g., Commander argument validation in the main CLI, or\n * clipanion parse errors in the migration-file CLI) can be added here if needed.\n */\nexport type { CliErrorConflict, CliErrorEnvelope } from '@prisma-next/errors/control';\n\nimport {\n  CliStructuredError,\n  errorConfigFileNotFound,\n  errorConfigValidation,\n  errorContractConfigMissing,\n  errorContractMissingExtensionPacks,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFamilyReadMarkerSqlRequired,\n  errorFileNotFound,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n  errorMigrationPlanningFailed,\n  errorQueryRunnerFactoryRequired,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n} from '@prisma-next/errors/control';\nimport { errorRuntime } from '@prisma-next/errors/execution';\nimport type { MigrationToolsError } from '@prisma-next/migration-tools/errors';\n\nexport {\n  CliStructuredError,\n  errorConfigFileNotFound,\n  errorConfigValidation,\n  errorContractConfigMissing,\n  errorContractMissingExtensionPacks,\n  errorContractValidationFailed,\n  errorDatabaseConnectionRequired,\n  errorDriverRequired,\n  errorFamilyReadMarkerSqlRequired,\n  errorFileNotFound,\n  errorMigrationCliInvalidConfigArg,\n  errorMigrationCliUnknownFlag,\n  errorMigrationPlanningFailed,\n  errorQueryRunnerFactoryRequired,\n  errorTargetMigrationNotSupported,\n  errorUnexpected,\n};\nexport {\n  ERROR_CODE_DESTRUCTIVE_CHANGES,\n  errorDestructiveChanges,\n  errorHashMismatch,\n  errorMarkerMissing,\n  errorMarkerRequired,\n  errorRunnerFailed,\n  errorRuntime,\n  errorSchemaVerificationFailed,\n  errorTargetMismatch,\n} from '@prisma-next/errors/execution';\nexport {\n  errorMigrationFileMissing,\n  errorMigrationInvalidDefaultExport,\n  errorMigrationPlanNotArray,\n  errorUnfilledPlaceholder,\n  placeholder,\n} from '@prisma-next/errors/migration';\n\n/**\n * Maps a `MigrationToolsError` raised by the migration-tools loader/graph\n * surface (`readMigrationPackage`, `readMigrationsDir`, `readRefs`,\n * `resolveRef`, `reconstructGraph`, ...) into a CLI `errorRuntime` envelope.\n *\n * The full `error.details` payload is forwarded into `meta` so machine\n * consumers (`--json`) see structural fields like `dir`, `storedHash`,\n * `computedHash` (for `MIGRATION.HASH_MISMATCH`) alongside the stable\n * `code`. The user-visible `summary`/`why`/`fix` text is unchanged.\n *\n * Callers are expected to gate on `MigrationToolsError.is(error)` first\n * (mirroring the original inline pattern); non-`MigrationToolsError`\n * values are caller-classified (rethrow, wrap with command-specific\n * `errorUnexpected`, etc.).\n */\nexport function mapMigrationToolsError(error: MigrationToolsError): CliStructuredError {\n  return errorRuntime(error.message, {\n    why: error.why,\n    fix: error.fix,\n    meta: { code: error.code, ...(error.details ?? {}) },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAgFA,SAAgB,uBAAuB,OAAgD;AACrF,QAAO,aAAa,MAAM,SAAS;EACjC,KAAK,MAAM;EACX,KAAK,MAAM;EACX,MAAM;GAAE,MAAM,MAAM;GAAM,GAAI,MAAM,WAAW,EAAE;GAAG;EACrD,CAAC"}

package/dist/{cli-errors-BFYgBH3L.d.mts → cli-errors-DDeVsP2Y.d.mts}

@@ -1,4 +1,5 @@
 import { CliStructuredError as CliStructuredError$1 } from "@prisma-next/errors/control";
 import "@prisma-next/errors/execution";
 import "@prisma-next/errors/migration";
+import { MigrationToolsError } from "@prisma-next/migration-tools/errors";
 export { CliStructuredError$1 as t };

package/dist/cli.mjs

@@ -1,18 +1,19 @@
 #!/usr/bin/env node
 
-import "./config-loader-C25b63rJ.mjs";
-import "./cli-errors-Cd79vmTH.mjs";
-import "./framework-components-Cr--XBKy.mjs";
-import "./client-CrsnY58k.mjs";
-import { n as installShutdownHandlers } from "./terminal-ui-C3ZLwQxK.mjs";
-import { d as setCommandExamples, g as formatRootHelp, h as formatCommandHelp, m as parseGlobalFlags, n as addGlobalOptions, u as setCommandDescriptions } from "./result-handler-Ba3zWQsI.mjs";
-import { t as createContractEmitCommand } from "./contract-emit-NJ01hiiv.mjs";
-import { t as createContractInferCommand } from "./contract-infer-D9cC3rJm.mjs";
-import "./inspect-live-schema-yrHAvG71.mjs";
-import "./migrations-Bo5WtTla.mjs";
-import "./migration-command-scaffold-B3B09et6.mjs";
+import "./config-loader-ih8ViDb_.mjs";
+import "./cli-errors-By1iVE3z.mjs";
+import "./contract-emit-RZBWzkop.mjs";
+import "./framework-components-Bgcre3Z6.mjs";
+import { n as installShutdownHandlers } from "./terminal-ui-u2YgKghu.mjs";
+import { _ as formatCommandHelp, d as setCommandDescriptions, f as setCommandExamples, g as parseGlobalFlags, n as addGlobalOptions, v as formatRootHelp } from "./result-handler-Ch6hVnOo.mjs";
+import { t as createContractEmitCommand } from "./contract-emit-rt_Nmdwq.mjs";
+import { t as createContractInferCommand } from "./contract-infer-Cf5J2wVg.mjs";
+import "./client-1JqqkiC7.mjs";
+import "./inspect-live-schema-LWtXfxm_.mjs";
+import "./migrations-MEoKMiV5.mjs";
+import "./migration-command-scaffold-CU452v9h.mjs";
 import { createDbInitCommand } from "./commands/db-init.mjs";
-import "./verify-Bkycc-Tf.mjs";
+import "./verify-BT9tgCOH.mjs";
 import { createDbSchemaCommand } from "./commands/db-schema.mjs";
 import { createDbSignCommand } from "./commands/db-sign.mjs";
 import { createDbUpdateCommand } from "./commands/db-update.mjs";
@@ -22,7 +23,7 @@ import { createMigrationNewCommand } from "./commands/migration-new.mjs";
 import { createMigrationPlanCommand } from "./commands/migration-plan.mjs";
 import { createMigrationRefCommand } from "./commands/migration-ref.mjs";
 import { createMigrationShowCommand } from "./commands/migration-show.mjs";
-import { t as createMigrationStatusCommand } from "./migration-status-DUMiH8_G.mjs";
+import { t as createMigrationStatusCommand } from "./migration-status-DoPrFIOQ.mjs";
 import { Command } from "commander";
 import { distance } from "closest-match";
 
@@ -104,7 +105,7 @@ Exit codes (see CLI Style Guide § Exit Codes):
 		"prisma-next init --no-install                                       # skip pnpm/npm install + emit"
 	]);
 	return addGlobalOptions(command).option("--target <db>", "Database target: postgres or mongodb").option("--authoring <style>", "Schema authoring style: psl or typescript").option("--schema-path <path>", "Where to write the starter schema (default: prisma/contract.prisma)").option("--force", "Overwrite an existing scaffold without prompting").option("--write-env", "Write a .env file from .env.example (gitignored; default: only .env.example)").option("--probe-db", "Connect to DATABASE_URL once and check the server version against the target minimum (opt-in; off by default)").option("--strict-probe", "Treat a failed --probe-db as fatal (no-op without --probe-db; init is offline-by-default)").option("--no-install", "Skip dependency installation and contract emission").action(async (options) => {
-		const { runInit } = await import("./init-m8x0UoPY.mjs");
+		const { runInit } = await import("./init-DAbQMxIR.mjs");
 		const flags = parseGlobalFlags(options);
 		const canPrompt = deriveCanPrompt({
 			flagsInteractive: flags.interactive,
@@ -185,7 +186,9 @@ const versionOption = program.options.find((opt) => opt.flags.includes("--versio
 if (versionOption) versionOption.description = "Output the version number";
 program.configureOutput({
 	writeErr: () => {},
-	writeOut: () => {}
+	writeOut: (str) => {
+		process.stdout.write(str);
+	}
 });
 const rootHelpFormatter = (cmd) => {
 	return formatRootHelp({
@@ -316,7 +319,7 @@ const helpCommand = new Command("help").description("Show usage instructions").c
 		program,
 		flags: parseGlobalFlags({})
 	});
-	process.stderr.write(`${helpText}\n`);
+	process.stdout.write(`${helpText}\n`);
 	process.exit(0);
 });
 program.addCommand(helpCommand);

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/commands/init/exit-codes.ts","../src/commands/init/index.ts","../src/utils/suggest-command.ts","../src/cli.ts"],"sourcesContent":["/**\n * Stable exit codes for the `init` command.\n *\n * These are part of the command's public contract. AI agents and CI scripts\n * branch on them (FR1.6), so the values must remain stable across versions.\n *\n * Codes 0–3 are the CLI-wide reserved values per the [CLI Style Guide\n * Exit Codes section](../../../../../../../docs/CLI%20Style%20Guide.md#exit-codes):\n * `OK = 0`, `INTERNAL_ERROR = 1`, `PRECONDITION = 2`, `USER_ABORTED = 3`.\n * Codes 4 and 5 are command-specific outcomes for `init`'s two fallible\n * side effects (install + emit). Documented in `--help` via\n * `setCommandDescriptions` in `./index.ts`.\n */\n\nexport const INIT_EXIT_OK = 0;\n\n/**\n * Anything we did not anticipate — a bug in prisma-next, not something\n * the caller did wrong. Includes the structured error code `5009`\n * (invalid output document) and any unrecognised internal error code,\n * so callers can distinguish \"tool is broken\" from \"your invocation\n * was wrong\" (`PRECONDITION = 2`). Maps to the generic \"RUN\" error\n * domain.\n */\nexport const INIT_EXIT_INTERNAL_ERROR = 1;\n\n/**\n * Preconditions not met. The caller asked for something we cannot do\n * without more input or a different environment. Examples:\n *   - missing `package.json` / `deno.json`\n *   - non-interactive mode without enough flags to proceed\n *   - re-init without `--force` in non-interactive mode\n */\nexport const INIT_EXIT_PRECONDITION = 2;\n\n/**\n * The user actively aborted an interactive prompt (Ctrl-C, declined the\n * re-init confirmation, etc.). Distinct from PRECONDITION because the user\n * was given the choice and made it; no diagnostic is needed.\n */\nexport const INIT_EXIT_USER_ABORTED = 3;\n\n/**\n * Dependency installation step failed without a recoverable fallback.\n * `init` automatically falls back from `pnpm` to `npm` on a recognised\n * workspace/catalog leak (FR7.2); this code is returned only when the\n * fallback also fails, or when the package manager is not pnpm and the\n * single attempt failed. Files written before the install step (config,\n * schema, db client, etc.) remain on disk so the user can fix the\n * environment and re-run; the error envelope's `meta.filesWritten` lists\n * them.\n */\nexport const INIT_EXIT_INSTALL_FAILED = 4;\n\n/**\n * Contract emit step failed after a successful install. Files written\n * before emit (including any installed dependencies) are still on disk;\n * the user can fix the underlying issue (typically a contract syntax\n * error or a missing extension pack) and re-run `prisma-next contract\n * emit` manually.\n */\nexport const INIT_EXIT_EMIT_FAILED = 5;\n","import { Command } from 'commander';\nimport {\n  addGlobalOptions,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../../utils/command-helpers';\nimport { type CommonCommandOptions, parseGlobalFlags } from '../../utils/global-flags';\nimport {\n  INIT_EXIT_EMIT_FAILED,\n  INIT_EXIT_INSTALL_FAILED,\n  INIT_EXIT_INTERNAL_ERROR,\n  INIT_EXIT_OK,\n  INIT_EXIT_PRECONDITION,\n  INIT_EXIT_USER_ABORTED,\n} from './exit-codes';\n\n/**\n * Commander.js parsed options for `init`. The init-specific options live\n * alongside the inherited `CommonCommandOptions` global flags.\n *\n * `target` and `authoring` are typed as plain `string` here because\n * Commander.js does not enforce enums at parse time — the validation /\n * normalisation happens in `inputs.ts::resolveInitInputs`, which can\n * raise a structured `errorInitInvalidFlagValue` with the full set of\n * allowed values.\n */\ninterface InitCommandOptions extends CommonCommandOptions {\n  readonly target?: string;\n  readonly authoring?: string;\n  readonly schemaPath?: string;\n  readonly force?: boolean;\n  readonly writeEnv?: boolean;\n  readonly probeDb?: boolean;\n  readonly strictProbe?: boolean;\n  readonly install?: boolean;\n}\n\nexport function createInitCommand(): Command {\n  const command = new Command('init');\n  setCommandDescriptions(\n    command,\n    'Initialize a new Prisma Next project',\n    'Scaffolds config, schema, and runtime files, installs dependencies,\\n' +\n      'and emits the contract. Gets you from zero to typed queries in one step.\\n' +\n      '\\n' +\n      'Run interactively for a guided experience, or supply --target / --authoring\\n' +\n      'and --yes for a fully scriptable run (CI, AI coding agents, automation).\\n' +\n      '\\n' +\n      'Exit codes (see CLI Style Guide § Exit Codes):\\n' +\n      `  ${INIT_EXIT_OK}   OK                    Init succeeded.\\n` +\n      `  ${INIT_EXIT_INTERNAL_ERROR}   INTERNAL_ERROR        Unexpected bug in prisma-next (please report).\\n` +\n      `  ${INIT_EXIT_PRECONDITION}   PRECONDITION          Bad flags / missing prerequisite (e.g. no package.json).\\n` +\n      `  ${INIT_EXIT_USER_ABORTED}   USER_ABORTED          User cancelled an interactive prompt.\\n` +\n      `  ${INIT_EXIT_INSTALL_FAILED}   INSTALL_FAILED        Dependency installation failed (init-specific).\\n` +\n      `  ${INIT_EXIT_EMIT_FAILED}   EMIT_FAILED           \\`contract emit\\` failed after install (init-specific).`,\n  );\n  setCommandExamples(command, [\n    'prisma-next init',\n    'prisma-next init --yes --target postgres --authoring psl',\n    'prisma-next init --yes --target mongodb --authoring typescript --json',\n    'prisma-next init --yes --force --target postgres --authoring psl  # overwrite an existing scaffold',\n    'prisma-next init --no-install                                       # skip pnpm/npm install + emit',\n  ]);\n\n  return addGlobalOptions(command)\n    .option('--target <db>', 'Database target: postgres or mongodb')\n    .option('--authoring <style>', 'Schema authoring style: psl or typescript')\n    .option(\n      '--schema-path <path>',\n      'Where to write the starter schema (default: prisma/contract.prisma)',\n    )\n    .option('--force', 'Overwrite an existing scaffold without prompting')\n    .option(\n      '--write-env',\n      'Write a .env file from .env.example (gitignored; default: only .env.example)',\n    )\n    .option(\n      '--probe-db',\n      'Connect to DATABASE_URL once and check the server version against the target minimum (opt-in; off by default)',\n    )\n    .option(\n      '--strict-probe',\n      'Treat a failed --probe-db as fatal (no-op without --probe-db; init is offline-by-default)',\n    )\n    .option('--no-install', 'Skip dependency installation and contract emission')\n    .action(async (options: InitCommandOptions) => {\n      const { runInit } = await import('./init');\n      const flags = parseGlobalFlags(options);\n      const canPrompt = deriveCanPrompt({\n        flagsInteractive: flags.interactive,\n        optionInteractive: options.interactive,\n        stdinIsTTY: Boolean(process.stdin.isTTY),\n      });\n      const exitCode = await runInit(process.cwd(), { options, flags, canPrompt });\n      process.exit(exitCode);\n    });\n}\n\n/**\n * Bridges the action handler's two TTY checks (stdout via `flags`, stdin\n * via `process.stdin.isTTY`) into the `canPrompt` boolean `runInit`\n * consumes.\n *\n * Per the [Style Guide § Interactivity](../../../../../../../docs/CLI%20Style%20Guide.md#interactivity):\n *\n * - `flags.interactive` governs *decoration* (TerminalUI, intro/outro,\n *   spinners) and is derived from stdout-TTY by `parseGlobalFlags`,\n *   honouring `--interactive` / `--no-interactive`.\n * - Prompting additionally requires a stdin TTY — closing stdin is a\n *   common signal in CI / agent environments even when stdout stays\n *   attached.\n * - `--interactive` is the explicit override: when the user passes it,\n *   we honour it (e.g. testing flows where stdin is stubbed).\n *\n * Exported so callers and tests can derive the same value without\n * touching `process` globals — F14 of the M1/M2 review.\n */\nexport function deriveCanPrompt(opts: {\n  readonly flagsInteractive: boolean | undefined;\n  readonly optionInteractive: boolean | undefined;\n  readonly stdinIsTTY: boolean;\n}): boolean {\n  if (opts.optionInteractive === true) return true;\n  if (opts.flagsInteractive === false) return false;\n  return opts.stdinIsTTY;\n}\n","import { distance } from 'closest-match';\n\n/**\n * Suggests similar command names for a mistyped input.\n *\n * Uses Levenshtein distance to find close matches. Only suggests commands\n * within a reasonable distance threshold (40% of the input length, minimum 2).\n * Returns up to 3 suggestions in case of ties.\n *\n * @returns Array of suggested command names (empty if nothing is close enough).\n */\nexport function suggestCommands(input: string, candidates: readonly string[]): string[] {\n  if (candidates.length === 0) return [];\n\n  // Threshold: at most 40% of the input length (min 2) to avoid absurd suggestions\n  const maxDistance = Math.max(2, Math.ceil(input.length * 0.4));\n\n  const scored = candidates\n    .map((name) => ({ name, dist: distance(input, name) }))\n    .filter((entry) => entry.dist <= maxDistance)\n    .sort((a, b) => a.dist - b.dist);\n\n  if (scored.length === 0) return [];\n\n  // Take the best distance, then include ties (up to 3)\n  const bestDist = scored[0]!.dist;\n  return scored\n    .filter((entry) => entry.dist === bestDist)\n    .slice(0, 3)\n    .map((entry) => entry.name);\n}\n","import { Command } from 'commander';\nimport { createContractEmitCommand } from './commands/contract-emit';\nimport { createContractInferCommand } from './commands/contract-infer';\nimport { createInitCommand } from './commands/init';\nimport { installShutdownHandlers } from './utils/shutdown';\n\n// Install SIGINT/SIGTERM handlers before anything else\ninstallShutdownHandlers();\n\nimport { createDbInitCommand } from './commands/db-init';\nimport { createDbSchemaCommand } from './commands/db-schema';\nimport { createDbSignCommand } from './commands/db-sign';\nimport { createDbUpdateCommand } from './commands/db-update';\nimport { createDbVerifyCommand } from './commands/db-verify';\nimport { createMigrationApplyCommand } from './commands/migration-apply';\nimport { createMigrationNewCommand } from './commands/migration-new';\nimport { createMigrationPlanCommand } from './commands/migration-plan';\nimport { createMigrationRefCommand } from './commands/migration-ref';\nimport { createMigrationShowCommand } from './commands/migration-show';\nimport { createMigrationStatusCommand } from './commands/migration-status';\nimport { setCommandDescriptions } from './utils/command-helpers';\nimport { formatCommandHelp, formatRootHelp } from './utils/formatters/help';\nimport { parseGlobalFlags } from './utils/global-flags';\nimport { suggestCommands } from './utils/suggest-command';\n\n/**\n * Formats the \"Did you mean ...?\" hint for an unknown command.\n */\nfunction formatSuggestion(input: string, candidates: readonly string[]): string {\n  const suggestions = suggestCommands(\n    input,\n    candidates.map((c) => c),\n  );\n  if (suggestions.length === 0) return '';\n  if (suggestions.length === 1) return `\\nDid you mean ${suggestions[0]}?\\n`;\n  return `\\nDid you mean one of these?\\n${suggestions.map((s) => `  ${s}`).join('\\n')}\\n`;\n}\n\nconst program = new Command();\n\nprogram.name('prisma-next').description('Prisma Next CLI').version('0.0.1');\n\n// Override version option description to match capitalization style\nconst versionOption = program.options.find((opt) => opt.flags.includes('--version'));\nif (versionOption) {\n  versionOption.description = 'Output the version number';\n}\n\nprogram.configureOutput({\n  writeErr: () => {\n    // Suppress all default error output - we handle errors in exitOverride\n  },\n  writeOut: () => {\n    // Suppress all default output - our custom formatters handle everything\n  },\n});\n\n// Customize root help output to use our styled format\nconst rootHelpFormatter = (cmd: Command) => {\n  const flags = parseGlobalFlags({});\n  return formatRootHelp({ program: cmd, flags });\n};\n\nprogram.configureHelp({\n  formatHelp: rootHelpFormatter,\n  subcommandDescription: () => '',\n});\n\n// Override exit to handle unhandled errors (fail fast cases)\n// Commands handle structured errors themselves via process.exit()\nprogram.exitOverride((err) => {\n  if (err) {\n    const errorCode = (err as { code?: string }).code;\n    const errorMessage = String(err.message ?? '');\n    const errorName = err.name ?? '';\n\n    // Unknown command/argument → exit 2 (CLI usage error)\n    const isUnknownCommandError =\n      errorCode === 'commander.unknownCommand' ||\n      errorCode === 'commander.unknownArgument' ||\n      (errorName === 'CommanderError' &&\n        (errorMessage.includes('unknown command') || errorMessage.includes('unknown argument')));\n    if (isUnknownCommandError) {\n      const flags = parseGlobalFlags({});\n      const match = errorMessage.match(/unknown command ['\"]([^'\"]+)['\"]/);\n      const commandName = match ? match[1] : process.argv[3] || process.argv[2] || 'unknown';\n\n      const firstArg = process.argv[2];\n      const parentCommand = firstArg\n        ? program.commands.find((cmd) => cmd.name() === firstArg)\n        : undefined;\n\n      if (parentCommand && commandName !== firstArg) {\n        const subNames = parentCommand.commands.map((c) => c.name());\n        process.stderr.write(\n          `Unknown command: ${commandName}${formatSuggestion(commandName!, subNames)}\\n`,\n        );\n        const helpText = formatCommandHelp({ command: parentCommand, flags });\n        process.stderr.write(`${helpText}\\n`);\n      } else {\n        const topNames = program.commands.map((c) => c.name());\n        process.stderr.write(\n          `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\\n`,\n        );\n        const helpText = formatRootHelp({ program, flags });\n        process.stderr.write(`${helpText}\\n`);\n      }\n      process.exit(2);\n      return;\n    }\n\n    // Help requests → exit 0\n    const isHelpError =\n      errorCode === 'commander.help' ||\n      errorCode === 'commander.helpDisplayed' ||\n      errorCode === 'outputHelp' ||\n      errorMessage === '(outputHelp)' ||\n      errorMessage.includes('outputHelp') ||\n      (errorName === 'CommanderError' && errorMessage.includes('outputHelp'));\n    if (isHelpError) {\n      process.exit(0);\n      return;\n    }\n\n    // Missing required arguments → exit 2 (CLI usage error)\n    const isMissingArgumentError =\n      errorCode === 'commander.missingArgument' ||\n      errorCode === 'commander.missingMandatoryOptionValue' ||\n      (errorName === 'CommanderError' &&\n        (errorMessage.includes('missing') || errorMessage.includes('required')));\n    if (isMissingArgumentError) {\n      process.exit(2);\n      return;\n    }\n\n    // Unhandled error → exit 1\n    process.stderr.write(`Unhandled error: ${err.message}\\n`);\n    if (err.stack) {\n      process.stderr.write(`${err.stack}\\n`);\n    }\n    process.exit(1);\n  }\n  process.exit(0);\n});\n\n// Register contract subcommand\nconst contractCommand = new Command('contract');\nsetCommandDescriptions(\n  contractCommand,\n  'Contract management commands',\n  'Define and emit your application data contract. The contract describes your schema as a\\n' +\n    'declarative data structure that can be signed and verified against your database.',\n);\ncontractCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\n// Add emit subcommand to contract\nconst contractEmitCommand = createContractEmitCommand();\ncontractCommand.addCommand(contractEmitCommand);\n\n// Add infer subcommand to contract\nconst contractInferCommand = createContractInferCommand();\ncontractCommand.addCommand(contractInferCommand);\n\n// Register contract command\nprogram.addCommand(contractCommand);\n\n// Register db subcommand\nconst dbCommand = new Command('db');\nsetCommandDescriptions(\n  dbCommand,\n  'Database management commands',\n  'Verify and sign your database with your contract. Ensure your database schema matches\\n' +\n    'your contract, and sign it to record the contract hash for future verification.',\n);\ndbCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\n// Add verify subcommand to db\nconst dbVerifyCommand = createDbVerifyCommand();\ndbCommand.addCommand(dbVerifyCommand);\n\n// Add init subcommand to db\nconst dbInitCommand = createDbInitCommand();\ndbCommand.addCommand(dbInitCommand);\n\n// Add update subcommand to db\nconst dbUpdateCommand = createDbUpdateCommand();\ndbCommand.addCommand(dbUpdateCommand);\n\n// Add schema subcommand to db\nconst dbSchemaCommand = createDbSchemaCommand();\ndbCommand.addCommand(dbSchemaCommand);\n\n// Add sign subcommand to db\nconst dbSignCommand = createDbSignCommand();\ndbCommand.addCommand(dbSignCommand);\n\n// Register db command\nprogram.addCommand(dbCommand);\n\n// Register migration subcommand\nconst migrationCommand = new Command('migration');\nsetCommandDescriptions(\n  migrationCommand,\n  'On-disk migration management commands',\n  'Plan, apply, and scaffold on-disk migration packages. Migrations are\\n' +\n    'contract-to-contract edges stored as versioned directories under migrations/.',\n);\nmigrationCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\nconst migrationPlanCommand = createMigrationPlanCommand();\nmigrationCommand.addCommand(migrationPlanCommand);\n\nconst migrationNewCommand = createMigrationNewCommand();\nmigrationCommand.addCommand(migrationNewCommand);\n\nconst migrationShowCommand = createMigrationShowCommand();\nmigrationCommand.addCommand(migrationShowCommand);\n\nconst migrationStatusCommand = createMigrationStatusCommand();\nmigrationCommand.addCommand(migrationStatusCommand);\n\nconst migrationApplyCommand = createMigrationApplyCommand();\nmigrationCommand.addCommand(migrationApplyCommand);\n\nconst migrationRefCommand = createMigrationRefCommand();\nmigrationCommand.addCommand(migrationRefCommand);\n\nprogram.addCommand(migrationCommand);\n\n// Register init command (top-level, not nested)\nconst initCommand = createInitCommand();\nprogram.addCommand(initCommand);\n\n// Create help command\nconst helpCommand = new Command('help')\n  .description('Show usage instructions')\n  .configureHelp({\n    formatHelp: (cmd) => {\n      const flags = parseGlobalFlags({});\n      return formatCommandHelp({ command: cmd, flags });\n    },\n  })\n  .action(() => {\n    const flags = parseGlobalFlags({});\n    const helpText = formatRootHelp({ program, flags });\n    // Help is decoration → stderr\n    process.stderr.write(`${helpText}\\n`);\n    process.exit(0);\n  });\n\nprogram.addCommand(helpCommand);\n\n// Set help as the default action when no command is provided\nprogram.action(() => {\n  const flags = parseGlobalFlags({});\n  const helpText = formatRootHelp({ program, flags });\n  process.stderr.write(`${helpText}\\n`);\n  process.exit(0);\n});\n\n// Check if a command was invoked with no arguments (just the command name)\n// or if an unrecognized command was provided\nconst args = process.argv.slice(2);\nif (args.length > 0) {\n  const commandName = args[0];\n  // Handle version option explicitly since we suppress default output\n  if (commandName === '--version' || commandName === '-V') {\n    // Version is data → stdout\n    process.stdout.write(`${program.version()}\\n`);\n    process.exit(0);\n  }\n  // Skip command check for global options like --help, -h\n  const isGlobalOption = commandName === '--help' || commandName === '-h';\n  if (!isGlobalOption) {\n    // Check if this is a recognized command\n    const command = program.commands.find((cmd) => cmd.name() === commandName);\n\n    if (!command) {\n      // Unrecognized command → exit 2 (CLI usage error)\n      const flags = parseGlobalFlags({});\n      const topNames = program.commands.map((c) => c.name());\n      process.stderr.write(\n        `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\\n`,\n      );\n      const helpText = formatRootHelp({ program, flags });\n      process.stderr.write(`${helpText}\\n`);\n      process.exit(2);\n    } else if (command.commands.length > 0 && args.length === 1) {\n      // Parent command called with no subcommand - show help and exit with 0\n      const flags = parseGlobalFlags({});\n      const helpText = formatCommandHelp({ command, flags });\n      process.stderr.write(`${helpText}\\n`);\n      process.exit(0);\n    }\n  }\n}\n\nprogram.parse();\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/commands/init/exit-codes.ts","../src/commands/init/index.ts","../src/utils/suggest-command.ts","../src/cli.ts"],"sourcesContent":["/**\n * Stable exit codes for the `init` command.\n *\n * These are part of the command's public contract. AI agents and CI scripts\n * branch on them (FR1.6), so the values must remain stable across versions.\n *\n * Codes 0–3 are the CLI-wide reserved values per the [CLI Style Guide\n * Exit Codes section](../../../../../../../docs/CLI%20Style%20Guide.md#exit-codes):\n * `OK = 0`, `INTERNAL_ERROR = 1`, `PRECONDITION = 2`, `USER_ABORTED = 3`.\n * Codes 4 and 5 are command-specific outcomes for `init`'s two fallible\n * side effects (install + emit). Documented in `--help` via\n * `setCommandDescriptions` in `./index.ts`.\n */\n\nexport const INIT_EXIT_OK = 0;\n\n/**\n * Anything we did not anticipate — a bug in prisma-next, not something\n * the caller did wrong. Includes the structured error code `5009`\n * (invalid output document) and any unrecognised internal error code,\n * so callers can distinguish \"tool is broken\" from \"your invocation\n * was wrong\" (`PRECONDITION = 2`). Maps to the generic \"RUN\" error\n * domain.\n */\nexport const INIT_EXIT_INTERNAL_ERROR = 1;\n\n/**\n * Preconditions not met. The caller asked for something we cannot do\n * without more input or a different environment. Examples:\n *   - missing `package.json` / `deno.json`\n *   - non-interactive mode without enough flags to proceed\n *   - re-init without `--force` in non-interactive mode\n */\nexport const INIT_EXIT_PRECONDITION = 2;\n\n/**\n * The user actively aborted an interactive prompt (Ctrl-C, declined the\n * re-init confirmation, etc.). Distinct from PRECONDITION because the user\n * was given the choice and made it; no diagnostic is needed.\n */\nexport const INIT_EXIT_USER_ABORTED = 3;\n\n/**\n * Dependency installation step failed without a recoverable fallback.\n * `init` automatically falls back from `pnpm` to `npm` on a recognised\n * workspace/catalog leak (FR7.2); this code is returned only when the\n * fallback also fails, or when the package manager is not pnpm and the\n * single attempt failed. Files written before the install step (config,\n * schema, db client, etc.) remain on disk so the user can fix the\n * environment and re-run; the error envelope's `meta.filesWritten` lists\n * them.\n */\nexport const INIT_EXIT_INSTALL_FAILED = 4;\n\n/**\n * Contract emit step failed after a successful install. Files written\n * before emit (including any installed dependencies) are still on disk;\n * the user can fix the underlying issue (typically a contract syntax\n * error or a missing extension pack) and re-run `prisma-next contract\n * emit` manually.\n */\nexport const INIT_EXIT_EMIT_FAILED = 5;\n","import { Command } from 'commander';\nimport {\n  addGlobalOptions,\n  setCommandDescriptions,\n  setCommandExamples,\n} from '../../utils/command-helpers';\nimport { type CommonCommandOptions, parseGlobalFlags } from '../../utils/global-flags';\nimport {\n  INIT_EXIT_EMIT_FAILED,\n  INIT_EXIT_INSTALL_FAILED,\n  INIT_EXIT_INTERNAL_ERROR,\n  INIT_EXIT_OK,\n  INIT_EXIT_PRECONDITION,\n  INIT_EXIT_USER_ABORTED,\n} from './exit-codes';\n\n/**\n * Commander.js parsed options for `init`. The init-specific options live\n * alongside the inherited `CommonCommandOptions` global flags.\n *\n * `target` and `authoring` are typed as plain `string` here because\n * Commander.js does not enforce enums at parse time — the validation /\n * normalisation happens in `inputs.ts::resolveInitInputs`, which can\n * raise a structured `errorInitInvalidFlagValue` with the full set of\n * allowed values.\n */\ninterface InitCommandOptions extends CommonCommandOptions {\n  readonly target?: string;\n  readonly authoring?: string;\n  readonly schemaPath?: string;\n  readonly force?: boolean;\n  readonly writeEnv?: boolean;\n  readonly probeDb?: boolean;\n  readonly strictProbe?: boolean;\n  readonly install?: boolean;\n}\n\nexport function createInitCommand(): Command {\n  const command = new Command('init');\n  setCommandDescriptions(\n    command,\n    'Initialize a new Prisma Next project',\n    'Scaffolds config, schema, and runtime files, installs dependencies,\\n' +\n      'and emits the contract. Gets you from zero to typed queries in one step.\\n' +\n      '\\n' +\n      'Run interactively for a guided experience, or supply --target / --authoring\\n' +\n      'and --yes for a fully scriptable run (CI, AI coding agents, automation).\\n' +\n      '\\n' +\n      'Exit codes (see CLI Style Guide § Exit Codes):\\n' +\n      `  ${INIT_EXIT_OK}   OK                    Init succeeded.\\n` +\n      `  ${INIT_EXIT_INTERNAL_ERROR}   INTERNAL_ERROR        Unexpected bug in prisma-next (please report).\\n` +\n      `  ${INIT_EXIT_PRECONDITION}   PRECONDITION          Bad flags / missing prerequisite (e.g. no package.json).\\n` +\n      `  ${INIT_EXIT_USER_ABORTED}   USER_ABORTED          User cancelled an interactive prompt.\\n` +\n      `  ${INIT_EXIT_INSTALL_FAILED}   INSTALL_FAILED        Dependency installation failed (init-specific).\\n` +\n      `  ${INIT_EXIT_EMIT_FAILED}   EMIT_FAILED           \\`contract emit\\` failed after install (init-specific).`,\n  );\n  setCommandExamples(command, [\n    'prisma-next init',\n    'prisma-next init --yes --target postgres --authoring psl',\n    'prisma-next init --yes --target mongodb --authoring typescript --json',\n    'prisma-next init --yes --force --target postgres --authoring psl  # overwrite an existing scaffold',\n    'prisma-next init --no-install                                       # skip pnpm/npm install + emit',\n  ]);\n\n  return addGlobalOptions(command)\n    .option('--target <db>', 'Database target: postgres or mongodb')\n    .option('--authoring <style>', 'Schema authoring style: psl or typescript')\n    .option(\n      '--schema-path <path>',\n      'Where to write the starter schema (default: prisma/contract.prisma)',\n    )\n    .option('--force', 'Overwrite an existing scaffold without prompting')\n    .option(\n      '--write-env',\n      'Write a .env file from .env.example (gitignored; default: only .env.example)',\n    )\n    .option(\n      '--probe-db',\n      'Connect to DATABASE_URL once and check the server version against the target minimum (opt-in; off by default)',\n    )\n    .option(\n      '--strict-probe',\n      'Treat a failed --probe-db as fatal (no-op without --probe-db; init is offline-by-default)',\n    )\n    .option('--no-install', 'Skip dependency installation and contract emission')\n    .action(async (options: InitCommandOptions) => {\n      const { runInit } = await import('./init');\n      const flags = parseGlobalFlags(options);\n      const canPrompt = deriveCanPrompt({\n        flagsInteractive: flags.interactive,\n        optionInteractive: options.interactive,\n        stdinIsTTY: Boolean(process.stdin.isTTY),\n      });\n      const exitCode = await runInit(process.cwd(), { options, flags, canPrompt });\n      process.exit(exitCode);\n    });\n}\n\n/**\n * Bridges the action handler's two TTY checks (stdout via `flags`, stdin\n * via `process.stdin.isTTY`) into the `canPrompt` boolean `runInit`\n * consumes.\n *\n * Per the [Style Guide § Interactivity](../../../../../../../docs/CLI%20Style%20Guide.md#interactivity):\n *\n * - `flags.interactive` governs *decoration* (TerminalUI, intro/outro,\n *   spinners) and is derived from stdout-TTY by `parseGlobalFlags`,\n *   honouring `--interactive` / `--no-interactive`.\n * - Prompting additionally requires a stdin TTY — closing stdin is a\n *   common signal in CI / agent environments even when stdout stays\n *   attached.\n * - `--interactive` is the explicit override: when the user passes it,\n *   we honour it (e.g. testing flows where stdin is stubbed).\n *\n * Exported so callers and tests can derive the same value without\n * touching `process` globals — F14 of the M1/M2 review.\n */\nexport function deriveCanPrompt(opts: {\n  readonly flagsInteractive: boolean | undefined;\n  readonly optionInteractive: boolean | undefined;\n  readonly stdinIsTTY: boolean;\n}): boolean {\n  if (opts.optionInteractive === true) return true;\n  if (opts.flagsInteractive === false) return false;\n  return opts.stdinIsTTY;\n}\n","import { distance } from 'closest-match';\n\n/**\n * Suggests similar command names for a mistyped input.\n *\n * Uses Levenshtein distance to find close matches. Only suggests commands\n * within a reasonable distance threshold (40% of the input length, minimum 2).\n * Returns up to 3 suggestions in case of ties.\n *\n * @returns Array of suggested command names (empty if nothing is close enough).\n */\nexport function suggestCommands(input: string, candidates: readonly string[]): string[] {\n  if (candidates.length === 0) return [];\n\n  // Threshold: at most 40% of the input length (min 2) to avoid absurd suggestions\n  const maxDistance = Math.max(2, Math.ceil(input.length * 0.4));\n\n  const scored = candidates\n    .map((name) => ({ name, dist: distance(input, name) }))\n    .filter((entry) => entry.dist <= maxDistance)\n    .sort((a, b) => a.dist - b.dist);\n\n  if (scored.length === 0) return [];\n\n  // Take the best distance, then include ties (up to 3)\n  const bestDist = scored[0]!.dist;\n  return scored\n    .filter((entry) => entry.dist === bestDist)\n    .slice(0, 3)\n    .map((entry) => entry.name);\n}\n","import { Command } from 'commander';\nimport { createContractEmitCommand } from './commands/contract-emit';\nimport { createContractInferCommand } from './commands/contract-infer';\nimport { createInitCommand } from './commands/init';\nimport { installShutdownHandlers } from './utils/shutdown';\n\n// Install SIGINT/SIGTERM handlers before anything else\ninstallShutdownHandlers();\n\nimport { createDbInitCommand } from './commands/db-init';\nimport { createDbSchemaCommand } from './commands/db-schema';\nimport { createDbSignCommand } from './commands/db-sign';\nimport { createDbUpdateCommand } from './commands/db-update';\nimport { createDbVerifyCommand } from './commands/db-verify';\nimport { createMigrationApplyCommand } from './commands/migration-apply';\nimport { createMigrationNewCommand } from './commands/migration-new';\nimport { createMigrationPlanCommand } from './commands/migration-plan';\nimport { createMigrationRefCommand } from './commands/migration-ref';\nimport { createMigrationShowCommand } from './commands/migration-show';\nimport { createMigrationStatusCommand } from './commands/migration-status';\nimport { setCommandDescriptions } from './utils/command-helpers';\nimport { formatCommandHelp, formatRootHelp } from './utils/formatters/help';\nimport { parseGlobalFlags } from './utils/global-flags';\nimport { suggestCommands } from './utils/suggest-command';\n\n/**\n * Formats the \"Did you mean ...?\" hint for an unknown command.\n */\nfunction formatSuggestion(input: string, candidates: readonly string[]): string {\n  const suggestions = suggestCommands(\n    input,\n    candidates.map((c) => c),\n  );\n  if (suggestions.length === 0) return '';\n  if (suggestions.length === 1) return `\\nDid you mean ${suggestions[0]}?\\n`;\n  return `\\nDid you mean one of these?\\n${suggestions.map((s) => `  ${s}`).join('\\n')}\\n`;\n}\n\nconst program = new Command();\n\nprogram.name('prisma-next').description('Prisma Next CLI').version('0.0.1');\n\n// Override version option description to match capitalization style\nconst versionOption = program.options.find((opt) => opt.flags.includes('--version'));\nif (versionOption) {\n  versionOption.description = 'Output the version number';\n}\n\nprogram.configureOutput({\n  writeErr: () => {\n    // Suppress all default error output - we handle errors in exitOverride\n  },\n  writeOut: (str) => {\n    // Commander routes explicitly-requested `--help` (success-path help)\n    // through writeOut; per the Style Guide § Output Conventions rule 8,\n    // user-requested help is data and goes to stdout. Error-path help\n    // (e.g. usage shown after an unknown command) goes through writeErr,\n    // which stays suppressed because we render that ourselves with the\n    // matching error envelope.\n    //\n    // Explicit `--version` is short-circuited before `program.parse()`\n    // (see the argv pre-scan at the bottom of this file), so it does not\n    // reach this writer.\n    process.stdout.write(str);\n  },\n});\n\n// Customize root help output to use our styled format\nconst rootHelpFormatter = (cmd: Command) => {\n  const flags = parseGlobalFlags({});\n  return formatRootHelp({ program: cmd, flags });\n};\n\nprogram.configureHelp({\n  formatHelp: rootHelpFormatter,\n  subcommandDescription: () => '',\n});\n\n// Override exit to handle unhandled errors (fail fast cases)\n// Commands handle structured errors themselves via process.exit()\nprogram.exitOverride((err) => {\n  if (err) {\n    const errorCode = (err as { code?: string }).code;\n    const errorMessage = String(err.message ?? '');\n    const errorName = err.name ?? '';\n\n    // Unknown command/argument → exit 2 (CLI usage error)\n    const isUnknownCommandError =\n      errorCode === 'commander.unknownCommand' ||\n      errorCode === 'commander.unknownArgument' ||\n      (errorName === 'CommanderError' &&\n        (errorMessage.includes('unknown command') || errorMessage.includes('unknown argument')));\n    if (isUnknownCommandError) {\n      const flags = parseGlobalFlags({});\n      const match = errorMessage.match(/unknown command ['\"]([^'\"]+)['\"]/);\n      const commandName = match ? match[1] : process.argv[3] || process.argv[2] || 'unknown';\n\n      const firstArg = process.argv[2];\n      const parentCommand = firstArg\n        ? program.commands.find((cmd) => cmd.name() === firstArg)\n        : undefined;\n\n      if (parentCommand && commandName !== firstArg) {\n        const subNames = parentCommand.commands.map((c) => c.name());\n        process.stderr.write(\n          `Unknown command: ${commandName}${formatSuggestion(commandName!, subNames)}\\n`,\n        );\n        const helpText = formatCommandHelp({ command: parentCommand, flags });\n        process.stderr.write(`${helpText}\\n`);\n      } else {\n        const topNames = program.commands.map((c) => c.name());\n        process.stderr.write(\n          `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\\n`,\n        );\n        const helpText = formatRootHelp({ program, flags });\n        process.stderr.write(`${helpText}\\n`);\n      }\n      process.exit(2);\n      return;\n    }\n\n    // Help requests → exit 0\n    const isHelpError =\n      errorCode === 'commander.help' ||\n      errorCode === 'commander.helpDisplayed' ||\n      errorCode === 'outputHelp' ||\n      errorMessage === '(outputHelp)' ||\n      errorMessage.includes('outputHelp') ||\n      (errorName === 'CommanderError' && errorMessage.includes('outputHelp'));\n    if (isHelpError) {\n      process.exit(0);\n      return;\n    }\n\n    // Missing required arguments → exit 2 (CLI usage error)\n    const isMissingArgumentError =\n      errorCode === 'commander.missingArgument' ||\n      errorCode === 'commander.missingMandatoryOptionValue' ||\n      (errorName === 'CommanderError' &&\n        (errorMessage.includes('missing') || errorMessage.includes('required')));\n    if (isMissingArgumentError) {\n      process.exit(2);\n      return;\n    }\n\n    // Unhandled error → exit 1\n    process.stderr.write(`Unhandled error: ${err.message}\\n`);\n    if (err.stack) {\n      process.stderr.write(`${err.stack}\\n`);\n    }\n    process.exit(1);\n  }\n  process.exit(0);\n});\n\n// Register contract subcommand\nconst contractCommand = new Command('contract');\nsetCommandDescriptions(\n  contractCommand,\n  'Contract management commands',\n  'Define and emit your application data contract. The contract describes your schema as a\\n' +\n    'declarative data structure that can be signed and verified against your database.',\n);\ncontractCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\n// Add emit subcommand to contract\nconst contractEmitCommand = createContractEmitCommand();\ncontractCommand.addCommand(contractEmitCommand);\n\n// Add infer subcommand to contract\nconst contractInferCommand = createContractInferCommand();\ncontractCommand.addCommand(contractInferCommand);\n\n// Register contract command\nprogram.addCommand(contractCommand);\n\n// Register db subcommand\nconst dbCommand = new Command('db');\nsetCommandDescriptions(\n  dbCommand,\n  'Database management commands',\n  'Verify and sign your database with your contract. Ensure your database schema matches\\n' +\n    'your contract, and sign it to record the contract hash for future verification.',\n);\ndbCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\n// Add verify subcommand to db\nconst dbVerifyCommand = createDbVerifyCommand();\ndbCommand.addCommand(dbVerifyCommand);\n\n// Add init subcommand to db\nconst dbInitCommand = createDbInitCommand();\ndbCommand.addCommand(dbInitCommand);\n\n// Add update subcommand to db\nconst dbUpdateCommand = createDbUpdateCommand();\ndbCommand.addCommand(dbUpdateCommand);\n\n// Add schema subcommand to db\nconst dbSchemaCommand = createDbSchemaCommand();\ndbCommand.addCommand(dbSchemaCommand);\n\n// Add sign subcommand to db\nconst dbSignCommand = createDbSignCommand();\ndbCommand.addCommand(dbSignCommand);\n\n// Register db command\nprogram.addCommand(dbCommand);\n\n// Register migration subcommand\nconst migrationCommand = new Command('migration');\nsetCommandDescriptions(\n  migrationCommand,\n  'On-disk migration management commands',\n  'Plan, apply, and scaffold on-disk migration packages. Migrations are\\n' +\n    'contract-to-contract edges stored as versioned directories under migrations/.',\n);\nmigrationCommand.configureHelp({\n  formatHelp: (cmd) => {\n    const flags = parseGlobalFlags({});\n    return formatCommandHelp({ command: cmd, flags });\n  },\n  subcommandDescription: () => '',\n});\n\nconst migrationPlanCommand = createMigrationPlanCommand();\nmigrationCommand.addCommand(migrationPlanCommand);\n\nconst migrationNewCommand = createMigrationNewCommand();\nmigrationCommand.addCommand(migrationNewCommand);\n\nconst migrationShowCommand = createMigrationShowCommand();\nmigrationCommand.addCommand(migrationShowCommand);\n\nconst migrationStatusCommand = createMigrationStatusCommand();\nmigrationCommand.addCommand(migrationStatusCommand);\n\nconst migrationApplyCommand = createMigrationApplyCommand();\nmigrationCommand.addCommand(migrationApplyCommand);\n\nconst migrationRefCommand = createMigrationRefCommand();\nmigrationCommand.addCommand(migrationRefCommand);\n\nprogram.addCommand(migrationCommand);\n\n// Register init command (top-level, not nested)\nconst initCommand = createInitCommand();\nprogram.addCommand(initCommand);\n\n// Create help command\nconst helpCommand = new Command('help')\n  .description('Show usage instructions')\n  .configureHelp({\n    formatHelp: (cmd) => {\n      const flags = parseGlobalFlags({});\n      return formatCommandHelp({ command: cmd, flags });\n    },\n  })\n  .action(() => {\n    const flags = parseGlobalFlags({});\n    const helpText = formatRootHelp({ program, flags });\n    // The `help` command was invoked explicitly: help is the data the\n    // caller asked for. Per Style Guide § Output Conventions rule 8,\n    // explicit help goes to stdout with exit code 0.\n    process.stdout.write(`${helpText}\\n`);\n    process.exit(0);\n  });\n\nprogram.addCommand(helpCommand);\n\n// Set help as the default action when no command is provided. The user\n// did not invoke `--help`; we are voluntarily showing usage to help them\n// recover from an underspecified invocation, so the help text is\n// decoration around an implicit \"what did you want me to do?\" and goes\n// to stderr (Style Guide § Output Conventions rule 8).\n//\n// FOLLOW-UP: the exit code here is 0 today, but a no-arg invocation is\n// arguably a usage error (PRECONDITION → exit 2) for consistency with\n// the unknown-command path. Out of scope for the explicit-help routing\n// work; revisit when tightening exit-code semantics across the CLI.\nprogram.action(() => {\n  const flags = parseGlobalFlags({});\n  const helpText = formatRootHelp({ program, flags });\n  process.stderr.write(`${helpText}\\n`);\n  process.exit(0);\n});\n\n// Check if a command was invoked with no arguments (just the command name)\n// or if an unrecognized command was provided\nconst args = process.argv.slice(2);\nif (args.length > 0) {\n  const commandName = args[0];\n  // Handle version option explicitly since we suppress default output\n  if (commandName === '--version' || commandName === '-V') {\n    // Version is data → stdout\n    process.stdout.write(`${program.version()}\\n`);\n    process.exit(0);\n  }\n  // Skip command check for global options like --help, -h\n  const isGlobalOption = commandName === '--help' || commandName === '-h';\n  if (!isGlobalOption) {\n    // Check if this is a recognized command\n    const command = program.commands.find((cmd) => cmd.name() === commandName);\n\n    if (!command) {\n      // Unrecognized command → exit 2 (CLI usage error)\n      const flags = parseGlobalFlags({});\n      const topNames = program.commands.map((c) => c.name());\n      process.stderr.write(\n        `Unknown command: ${commandName}${formatSuggestion(commandName!, topNames)}\\n`,\n      );\n      const helpText = formatRootHelp({ program, flags });\n      process.stderr.write(`${helpText}\\n`);\n      process.exit(2);\n    } else if (command.commands.length > 0 && args.length === 1) {\n      // Parent command called with no subcommand. Same shape as the\n      // no-args case above: the user did not request help, we are\n      // voluntarily rendering it as decoration around an underspecified\n      // invocation, so it goes to stderr per Style Guide § Output\n      // Conventions rule 8. Exit code 0 today; the FOLLOW-UP note on\n      // `program.action` applies here too (arguably should be 2).\n      const flags = parseGlobalFlags({});\n      const helpText = formatCommandHelp({ command, flags });\n      process.stderr.write(`${helpText}\\n`);\n      process.exit(0);\n    }\n  }\n}\n\nprogram.parse();\n"],"mappings":"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"}

package/dist/{client-CrsnY58k.mjs → client-1JqqkiC7.mjs}

@@ -1,10 +1,9 @@
-import { t as assertFrameworkComponentsCompatible } from "./framework-components-Cr--XBKy.mjs";
-import { t as enrichContract } from "./contract-enrichment-CAOELa-H.mjs";
-import { t as extractOperationStatements } from "./extract-operation-statements-DsFfxXVZ.mjs";
+import { t as assertFrameworkComponentsCompatible } from "./framework-components-Bgcre3Z6.mjs";
+import { t as enrichContract } from "./contract-enrichment-4Ptgw3Pe.mjs";
 import { emit } from "@prisma-next/emitter";
-import { notOk, ok } from "@prisma-next/utils/result";
 import { ifDefined } from "@prisma-next/utils/defined";
-import { createControlStack, hasMigrations, hasSchemaView } from "@prisma-next/framework-components/control";
+import { notOk, ok } from "@prisma-next/utils/result";
+import { createControlStack, hasMigrations, hasOperationPreview, hasPslContractInfer, hasSchemaView } from "@prisma-next/framework-components/control";
 import { EMPTY_CONTRACT_HASH } from "@prisma-next/migration-tools/constants";
 
 //#region src/control-api/errors.ts
@@ -99,7 +98,7 @@ async function executeDbInit(options) {
 		contract,
 		schema: schemaIR,
 		policy,
-		fromHash: "",
+		fromContract: null,
 		frameworkComponents
 	});
 	if (plannerResult.kind === "failure") {
@@ -187,12 +186,12 @@ async function executeDbInit(options) {
 		outcome: "ok"
 	});
 	if (mode === "plan") {
-		const planSql = extractOperationStatements(familyInstance.familyId, migrationPlan.operations);
+		const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(migrationPlan.operations) : void 0;
 		return ok({
 			mode: "plan",
 			plan: {
 				operations: stripOperations(migrationPlan.operations),
-				...ifDefined("sql", planSql)
+				...ifDefined("preview", preview)
 			},
 			destination: {
 				storageHash: migrationPlan.destination.storageHash,
@@ -308,7 +307,7 @@ async function executeDbUpdate(options) {
 		contract,
 		schema: schemaIR,
 		policy,
-		fromHash: "",
+		fromContract: null,
 		frameworkComponents
 	});
 	if (plannerResult.kind === "failure") {
@@ -334,12 +333,12 @@ async function executeDbUpdate(options) {
 	});
 	const migrationPlan = plannerResult.plan;
 	if (mode === "plan") {
-		const planSql = extractOperationStatements(familyInstance.familyId, migrationPlan.operations);
+		const preview = hasOperationPreview(familyInstance) ? familyInstance.toOperationPreview(migrationPlan.operations) : void 0;
 		return ok({
 			mode: "plan",
 			plan: {
 				operations: stripOperations(migrationPlan.operations),
-				...planSql !== void 0 ? { sql: planSql } : {}
+				...ifDefined("preview", preview)
 			},
 			destination: {
 				storageHash: migrationPlan.destination.storageHash,
@@ -425,6 +424,21 @@ async function executeDbUpdate(options) {
 
 //#endregion
 //#region src/control-api/operations/migration-apply.ts
+/**
+* Apply a sequence of migration packages against the configured driver.
+*
+* Validates the path's continuity (origin → ... → destination, no gaps),
+* then drives the family/target's migration runner over each package's
+* operations in order, surfacing per-migration progress through `onProgress`.
+*
+* The `pendingMigrations` parameter is trusted input. Callers are responsible
+* for upstream verification of the originating migration packages — typically
+* by loading them via `readMigrationPackage` from
+* `@prisma-next/migration-tools/io`, which performs hash-integrity checks at
+* the load boundary. This operation does not re-verify the packages and
+* assumes the `(metadata, ops)` pairs on disk have not been tampered with
+* since emit.
+*/
 async function executeMigrationApply(options) {
 	const { driver, familyInstance, originHash, destinationHash, pendingMigrations, migrations, frameworkComponents, targetId, onProgress } = options;
 	if (pendingMigrations.length === 0) {
@@ -446,31 +460,33 @@ async function executeMigrationApply(options) {
 	}
 	const firstMigration = pendingMigrations[0];
 	const lastMigration = pendingMigrations[pendingMigrations.length - 1];
-	if (firstMigration.from !== originHash || lastMigration.to !== destinationHash) return notOk({
+	const firstFromMarker = firstMigration.from ?? EMPTY_CONTRACT_HASH;
+	if (firstFromMarker !== originHash || lastMigration.to !== destinationHash) return notOk({
 		code: "MIGRATION_PATH_NOT_FOUND",
 		summary: "Migration apply path does not match requested origin and destination",
-		why: `Path resolved as ${firstMigration.from} -> ${lastMigration.to}, but requested ${originHash} -> ${destinationHash}`,
+		why: `Path resolved as ${firstFromMarker} -> ${lastMigration.to}, but requested ${originHash} -> ${destinationHash}`,
 		meta: {
 			originHash,
 			destinationHash,
-			pathOrigin: firstMigration.from,
+			pathOrigin: firstFromMarker,
 			pathDestination: lastMigration.to
 		}
 	});
 	for (let i = 1; i < pendingMigrations.length; i++) {
 		const previous = pendingMigrations[i - 1];
 		const current = pendingMigrations[i];
-		if (previous.to !== current.from) return notOk({
+		const currentFromMarker = current.from ?? EMPTY_CONTRACT_HASH;
+		if (previous.to !== currentFromMarker) return notOk({
 			code: "MIGRATION_PATH_NOT_FOUND",
 			summary: "Migration apply path contains a discontinuity between adjacent migrations",
-			why: `Migration "${previous.dirName}" ends at ${previous.to}, but next migration "${current.dirName}" starts at ${current.from}`,
+			why: `Migration "${previous.dirName}" ends at ${previous.to}, but next migration "${current.dirName}" starts at ${currentFromMarker}`,
 			meta: {
 				originHash,
 				destinationHash,
 				previousDirName: previous.dirName,
 				previousTo: previous.to,
 				currentDirName: current.dirName,
-				currentFrom: current.from,
+				currentFrom: currentFromMarker,
 				discontinuityIndex: i
 			}
 		});
@@ -494,9 +510,10 @@ async function executeMigrationApply(options) {
 		] };
 		const plan = {
 			targetId,
-			origin: migration.from === EMPTY_CONTRACT_HASH ? null : { storageHash: migration.from },
+			origin: migration.from === null ? null : { storageHash: migration.from },
 			destination: { storageHash: migration.to },
-			operations
+			operations,
+			providedInvariants: migration.providedInvariants
 		};
 		const destinationContract = familyInstance.validateContract(migration.toContract);
 		const runnerResult = await runner.execute({
@@ -871,6 +888,14 @@ var ControlClientImpl = class {
 		this.init();
 		if (this.familyInstance && hasSchemaView(this.familyInstance)) return this.familyInstance.toSchemaView(schemaIR);
 	}
+	inferPslContract(schemaIR) {
+		this.init();
+		if (this.familyInstance && hasPslContractInfer(this.familyInstance)) return this.familyInstance.inferPslContract(schemaIR);
+	}
+	toOperationPreview(operations) {
+		this.init();
+		if (this.familyInstance && hasOperationPreview(this.familyInstance)) return this.familyInstance.toOperationPreview(operations);
+	}
 	async emit(options) {
 		const { onProgress, contractConfig } = options;
 		this.init();
@@ -994,4 +1019,4 @@ var ControlClientImpl = class {
 
 //#endregion
 export { ContractValidationError as n, createControlClient as t };
-//# sourceMappingURL=client-CrsnY58k.mjs.map
+//# sourceMappingURL=client-1JqqkiC7.mjs.map