prisma-next 0.5.0-dev.3 → 0.5.0-dev.30

package/dist/agent-skill-mongo.md

@@ -4,7 +4,7 @@ This project uses **Prisma Next** with **MongoDB** via `@prisma-next/mongo`. Pri
 
 ## Files
 
-- **Contract**: `{{schemaPath}}` — the user's data models. Edit this to add or change models.
+- **Contract**: `{{schemaPath}}` ({{authoringLabel}} authoring) — the user's data models. Edit this to add or change models.
 - **Config**: `prisma-next.config.ts` — tells the CLI where the contract is and how to connect to the database. Loads `.env` via `dotenv/config`.
 - **Database client**: `{{schemaDir}}/db.ts` — `import { db } from '{{dbImportPath}}'`. This is the entry point for all queries.
 - **Generated files** (do not edit by hand):
@@ -23,71 +23,103 @@ This project uses **Prisma Next** with **MongoDB** via `@prisma-next/mongo`. Pri
 
 ## How to write queries
 
-Always use the ORM (`db.orm`). Only fall back to `db.sql` if the user explicitly asks for raw queries or the ORM doesn't support the operation.
+Use the ORM (`db.orm`). Each root accessor is the lowercased plural form emitted by `prisma-next contract emit` (typically the `@@map`-ped collection name) — for `model User { @@map("users") }` use `db.orm.users`, for `model Post { @@map("posts") }` use `db.orm.posts`. The Mongo facade has no raw-SQL surface. Two escape hatches exist for cases the ORM can't express; both are covered under "Escape hatches" below.
 
 ```typescript
 import { db } from '{{dbImportPath}}';
 
 // Find one record
-const user = await db.orm.User
-  .where(user => user.email.eq('alice@example.com'))
+const user = await db.orm.users
+  .where({ email: 'alice@example.com' })
   .first();
-// Returns { id: ObjectId; email: string; ... } | null
+// Returns { _id: ObjectId; email: string; ... } | null
 
-// Find multiple records
-const users = await db.orm.User
-  .select('id', 'email')
+// Find multiple records — `.all()` returns an AsyncIterableResult, consume
+// either as an async iterable (below) or by `await`ing it to materialise an Array.
+for await (const user of db.orm.users
+  .select('_id', 'email')
   .take(10)
-  .all();
-// Returns Array<{ id: ObjectId; email: string }>
+  .all()) {
+  // Each `user` is { _id: ObjectId; email: string }
+}
+// Returns AsyncIterableResult<{ _id: ObjectId; email: string }>
 
 // Filter, order, limit
-const recentPosts = await db.orm.Post
-  .where(post => post.authorId.eq(userId))
-  .orderBy(post => post.createdAt.desc())
-  .select('id', 'title', 'createdAt')
+const recentPosts = await db.orm.posts
+  .where({ authorId: userId })
+  .orderBy({ createdAt: -1 })
+  .select('_id', 'title', 'createdAt')
   .take(50)
   .all();
 
-// Include relations
-const usersWithPosts = await db.orm.User
-  .select('id', 'email')
-  .include('posts', post =>
-    post.select('id', 'title').orderBy(p => p.createdAt.desc()).take(5)
-  )
+// Include relations (reference relations only — embedded relations come back automatically)
+const usersWithPosts = await db.orm.users
+  .select('_id', 'email')
+  .include('posts')
   .take(10)
   .all();
 ```
 
 ### Key ORM methods
 
-- `.where(predicate)` — filter records. Predicate receives a model accessor with `.eq()`, `.neq()`, `.ilike()`, `.lt()`, `.gt()`, etc.
+- `.where({ field: value, ... })` — filter records by an equality object. Pass a raw filter expression for `$gt`/`$in`/`$regex` etc.
 - `.select('field1', 'field2', ...)` — pick which fields to return
-- `.orderBy(accessor => accessor.field.asc()` or `.desc())` — sort results
-- `.take(n)` — limit number of results
-- `.all()` — execute and return all matching records as an array
-- `.first()` — execute and return the first matching record, or `null`
-- `.first({ id: value })` — find a single record by primary key, or `null`
-- `.include('relation', builder => ...)` — eager-load a relation
+- `.orderBy({ field: 1 | -1 })` — sort results (1 = ascending, -1 = descending)
+- `.take(n)` / `.skip(n)` — limit and offset
+- `.all()` — execute and return all matching records as an `AsyncIterableResult`
+- `.first()` — execute with limit 1 and return the first matching row, or `null`
+- `.include('relationName')` — eager-load a reference relation (`$lookup`); embedded relations are already part of the row
+- `.variant('VariantName')` — narrow a polymorphic collection to a discriminator value
+
+## Escape hatches
+
+The ORM covers the common cases. When you genuinely need something it can't express, prefer these — in order — over reaching for `db.runtime()` (which is an internal executor surface, not a `mongodb`-driver handle):
+
+1. **Typed raw aggregations — `db.query`.** The facade exposes a `db.query` builder that runs aggregation pipelines through the same runtime + middleware + codec stack as `db.orm`, so results stay typed against the contract. Use this for `$lookup`/`$facet`/`$graphLookup`/window-function pipelines that the ORM doesn't surface.
+
+2. **Direct `mongodb` driver control — `mongoClient` binding.** If you need a raw `MongoClient` (e.g. for transactions, change streams, sessions, or a driver feature Prisma Next doesn't expose), construct one yourself and pass it to `mongo({ mongoClient, dbName, contractJson })`. Your code keeps the `MongoClient` reference and uses it directly, while the same `db` object still gives you the typed ORM surface:
+
+   ```typescript
+   import { MongoClient } from 'mongodb';
+   import mongo from '@prisma-next/mongo/runtime';
+   import type { Contract } from './contract.d';
+   import contractJson from './contract.json' with { type: 'json' };
+
+   const client = new MongoClient(process.env['DATABASE_URL']!);
+   await client.connect();
+
+   export const db = mongo<Contract>({ contractJson, mongoClient: client, dbName: 'mydb' });
+
+   const session = client.startSession();
+   try {
+     await session.withTransaction(async () => {
+       await db.orm.users.createAll([{ /* ... */ }]);
+     });
+   } finally {
+     await session.endSession();
+   }
+   ```
 
 ## Rules
 
 - **Never hand-edit** `contract.json` or `contract.d.ts`. Always regenerate them with `contract emit`.
 - **Always emit after contract changes.** When you modify `{{schemaPath}}`, run `{{pkgRun}} contract emit` before writing any code that depends on the new or changed models.
-- **Don't restructure `db.ts`.** It's scaffolded by init and works as-is.
-- **Use `db.orm` for queries**, not `db.sql`. The ORM is the primary query surface.
+- **Don't restructure `db.ts`.** It's scaffolded by init and works as-is. `db` connects lazily on the first query — there is no `db.connect(...)` step.
+- **Root accessors are emitter-driven.** Use the lowercased plural collection name (e.g. `db.orm.users`, `db.orm.posts`) — not the PascalCase model name. Re-run `{{pkgRun}} contract emit` if a new model's accessor isn't appearing on `db.orm`.
 - **Connection string** is `DATABASE_URL` in `.env`. If the user reports connection errors, check this value and the `.env` file.
+- **Transactions and change streams** require a MongoDB **replica set**. The Mongo facade does not yet expose `db.transaction(...)` — for now, use the `mongoClient` escape hatch above to drive transactions/sessions directly. See the quick reference for dev-environment options; the typed transaction API is tracked under [TML-2313](https://linear.app/prisma-company/issue/TML-2313/mongo-dev-replica-set-story-is-missing-transactions-change-streams).
+- **Don't reach for `db.runtime()`** as an escape hatch. It returns the internal executor (`MongoRuntime`), not a `mongodb` `MongoClient` or `Db`. Use `db.query` for raw aggregations and the `mongoClient` binding for direct driver control.
 
 ## Workflow for common tasks
 
 **User wants to add a new model or field:**
 1. Edit `{{schemaPath}}`
 2. Run `{{pkgRun}} contract emit`
-3. Write query code using `db.orm.ModelName`
+3. Write query code using `db.orm.<collection>` (lowercased plural, see Rules above)
 
 **User wants to query data:**
 1. Import `db` from `{{dbImportPath}}`
-2. Use `db.orm.ModelName` with `.where()`, `.select()`, `.all()`, `.first()`, etc.
+2. Use `db.orm.<collection>` with `.where()`, `.select()`, `.all()`, `.first()`, etc.
 
 **User wants to set up or change the database connection:**
 1. Edit `DATABASE_URL` in `.env`

package/dist/agent-skill-postgres.md

@@ -4,7 +4,7 @@ This project uses **Prisma Next** with **PostgreSQL** via `@prisma-next/postgres
 
 ## Files
 
-- **Contract**: `{{schemaPath}}` — the user's data models. Edit this to add or change models.
+- **Contract**: `{{schemaPath}}` ({{authoringLabel}} authoring) — the user's data models. Edit this to add or change models.
 - **Config**: `prisma-next.config.ts` — tells the CLI where the contract is and how to connect to the database. Loads `.env` via `dotenv/config`.
 - **Database client**: `{{schemaDir}}/db.ts` — `import { db } from '{{dbImportPath}}'`. This is the entry point for all queries.
 - **Generated files** (do not edit by hand):

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-C0JhVj0c.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,11 +1,19 @@
 #!/usr/bin/env node
 
-import "./config-loader-_W4T21X1.mjs";
-import { d as setCommandExamples, g as formatRootHelp, h as formatCommandHelp, m as parseGlobalFlags, u as setCommandDescriptions } from "./result-handler-CIyu0Pdt.mjs";
-import { t as createContractEmitCommand } from "./contract-emit-CNYyzJwF.mjs";
-import { n as installShutdownHandlers } from "./terminal-ui-C5k88MmW.mjs";
-import { t as createContractInferCommand } from "./contract-infer-BP3DrGgz.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 { d as setCommandExamples, g as formatRootHelp, h as formatCommandHelp, m as parseGlobalFlags, n as addGlobalOptions, u as setCommandDescriptions } from "./result-handler-BmVh8AeV.mjs";
+import { t as createContractEmitCommand } from "./contract-emit-DWtGQYCD.mjs";
+import { t as createContractInferCommand } from "./contract-infer-GztVCOCJ.mjs";
+import "./client-keSCAgjW.mjs";
+import "./inspect-live-schema-BaR9ISwa.mjs";
+import "./migrations-MEoKMiV5.mjs";
+import "./migration-command-scaffold-D1dWuEWQ.mjs";
 import { createDbInitCommand } from "./commands/db-init.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";
@@ -15,20 +23,126 @@ 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-B0HLF7So.mjs";
+import { t as createMigrationStatusCommand } from "./migration-status-CP5k8O5i.mjs";
 import { Command } from "commander";
 import { distance } from "closest-match";
 
+//#region src/commands/init/exit-codes.ts
+/**
+* Stable exit codes for the `init` command.
+*
+* These are part of the command's public contract. AI agents and CI scripts
+* branch on them (FR1.6), so the values must remain stable across versions.
+*
+* Codes 0–3 are the CLI-wide reserved values per the [CLI Style Guide
+* Exit Codes section](../../../../../../../docs/CLI%20Style%20Guide.md#exit-codes):
+* `OK = 0`, `INTERNAL_ERROR = 1`, `PRECONDITION = 2`, `USER_ABORTED = 3`.
+* Codes 4 and 5 are command-specific outcomes for `init`'s two fallible
+* side effects (install + emit). Documented in `--help` via
+* `setCommandDescriptions` in `./index.ts`.
+*/
+const INIT_EXIT_OK = 0;
+/**
+* Anything we did not anticipate — a bug in prisma-next, not something
+* the caller did wrong. Includes the structured error code `5009`
+* (invalid output document) and any unrecognised internal error code,
+* so callers can distinguish "tool is broken" from "your invocation
+* was wrong" (`PRECONDITION = 2`). Maps to the generic "RUN" error
+* domain.
+*/
+const INIT_EXIT_INTERNAL_ERROR = 1;
+/**
+* Preconditions not met. The caller asked for something we cannot do
+* without more input or a different environment. Examples:
+*   - missing `package.json` / `deno.json`
+*   - non-interactive mode without enough flags to proceed
+*   - re-init without `--force` in non-interactive mode
+*/
+const INIT_EXIT_PRECONDITION = 2;
+/**
+* The user actively aborted an interactive prompt (Ctrl-C, declined the
+* re-init confirmation, etc.). Distinct from PRECONDITION because the user
+* was given the choice and made it; no diagnostic is needed.
+*/
+const INIT_EXIT_USER_ABORTED = 3;
+/**
+* Dependency installation step failed without a recoverable fallback.
+* `init` automatically falls back from `pnpm` to `npm` on a recognised
+* workspace/catalog leak (FR7.2); this code is returned only when the
+* fallback also fails, or when the package manager is not pnpm and the
+* single attempt failed. Files written before the install step (config,
+* schema, db client, etc.) remain on disk so the user can fix the
+* environment and re-run; the error envelope's `meta.filesWritten` lists
+* them.
+*/
+const INIT_EXIT_INSTALL_FAILED = 4;
+/**
+* Contract emit step failed after a successful install. Files written
+* before emit (including any installed dependencies) are still on disk;
+* the user can fix the underlying issue (typically a contract syntax
+* error or a missing extension pack) and re-run `prisma-next contract
+* emit` manually.
+*/
+const INIT_EXIT_EMIT_FAILED = 5;
+
+//#endregion
 //#region src/commands/init/index.ts
 function createInitCommand() {
 	const command = new Command("init");
-	setCommandDescriptions(command, "Initialize a new Prisma Next project", "Scaffolds config, schema, and runtime files, installs dependencies,\nand emits the contract. Gets you from zero to typed queries in one step.");
-	setCommandExamples(command, ["prisma-next init", "prisma-next init --no-install"]);
-	command.option("--no-install", "Skip dependency installation and contract emission").action(async (options) => {
-		const { runInit } = await import("./init-CQfo_4Ro.mjs");
-		await runInit(process.cwd(), { noInstall: !options.install });
+	setCommandDescriptions(command, "Initialize a new Prisma Next project", `Scaffolds config, schema, and runtime files, installs dependencies,
+and emits the contract. Gets you from zero to typed queries in one step.
+
+Run interactively for a guided experience, or supply --target / --authoring
+and --yes for a fully scriptable run (CI, AI coding agents, automation).
+
+Exit codes (see CLI Style Guide § Exit Codes):
+  ${INIT_EXIT_OK}   OK                    Init succeeded.\n  ${INIT_EXIT_INTERNAL_ERROR}   INTERNAL_ERROR        Unexpected bug in prisma-next (please report).\n  ${INIT_EXIT_PRECONDITION}   PRECONDITION          Bad flags / missing prerequisite (e.g. no package.json).\n  ${INIT_EXIT_USER_ABORTED}   USER_ABORTED          User cancelled an interactive prompt.\n  ${INIT_EXIT_INSTALL_FAILED}   INSTALL_FAILED        Dependency installation failed (init-specific).\n  ${INIT_EXIT_EMIT_FAILED}   EMIT_FAILED           \`contract emit\` failed after install (init-specific).`);
+	setCommandExamples(command, [
+		"prisma-next init",
+		"prisma-next init --yes --target postgres --authoring psl",
+		"prisma-next init --yes --target mongodb --authoring typescript --json",
+		"prisma-next init --yes --force --target postgres --authoring psl  # overwrite an existing scaffold",
+		"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-DAbQMxIR.mjs");
+		const flags = parseGlobalFlags(options);
+		const canPrompt = deriveCanPrompt({
+			flagsInteractive: flags.interactive,
+			optionInteractive: options.interactive,
+			stdinIsTTY: Boolean(process.stdin.isTTY)
+		});
+		const exitCode = await runInit(process.cwd(), {
+			options,
+			flags,
+			canPrompt
+		});
+		process.exit(exitCode);
 	});
-	return command;
+}
+/**
+* Bridges the action handler's two TTY checks (stdout via `flags`, stdin
+* via `process.stdin.isTTY`) into the `canPrompt` boolean `runInit`
+* 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).
+*
+* Exported so callers and tests can derive the same value without
+* touching `process` globals — F14 of the M1/M2 review.
+*/
+function deriveCanPrompt(opts) {
+	if (opts.optionInteractive === true) return true;
+	if (opts.flagsInteractive === false) return false;
+	return opts.stdinIsTTY;
 }
 
 //#endregion
@@ -72,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({
@@ -203,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);
@@ -247,5 +363,5 @@ if (args.length > 0) {
 program.parse();
 
 //#endregion
-export {  };
+export { INIT_EXIT_PRECONDITION as a, INIT_EXIT_OK as i, INIT_EXIT_INSTALL_FAILED as n, INIT_EXIT_USER_ABORTED as o, INIT_EXIT_INTERNAL_ERROR as r, INIT_EXIT_EMIT_FAILED as t };
 //# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/commands/init/index.ts","../src/utils/suggest-command.ts","../src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { setCommandDescriptions, setCommandExamples } from '../../utils/command-helpers';\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  setCommandExamples(command, ['prisma-next init', 'prisma-next init --no-install']);\n  command\n    .option('--no-install', 'Skip dependency installation and contract emission')\n    .action(async (options: { readonly install?: boolean }) => {\n      const { runInit } = await import('./init');\n      await runInit(process.cwd(), { noInstall: !options.install });\n    });\n\n  return command;\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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"}