@prisma-next/cli 0.16.0-dev.3 → 0.16.0-dev.31

package/README.md

@@ -52,7 +52,7 @@ Commands that enforce wiring validation:
 - **`db init`**
 - **`db update`**
 
-If you hit a wiring validation error: add the required descriptors to `config.extensionPacks` (matched by descriptor `id`) and re-run the command.
+If you hit a wiring validation error: add the required descriptors to `config.extensions` (matched by descriptor `id`) and re-run the command.
 
 **Note**: Control plane domain actions (database verification, contract emission) are implemented in `@prisma-next/emitter` and `@prisma-next/framework-components/control`. The CLI uses the control plane domain actions programmatically but does not define control plane types itself.
 
@@ -92,7 +92,7 @@ export default defineConfig({
   family: sql,
   target: postgres,
   adapter: postgresAdapter,
-  extensionPacks: [],
+  extensions: [],
   contract: typescriptContract(contract, 'src/prisma/contract.json'),
 });
 ```
@@ -181,7 +181,7 @@ export default defineConfig({
   target: postgres,
   adapter: postgresAdapter,
   driver: postgresDriver,
-  extensionPacks: [],
+  extensions: [],
   contract: typescriptContract(contract, 'src/prisma/contract.json'),
   db: {
     connection: process.env.DATABASE_URL, // Optional: can also use --db flag
@@ -210,16 +210,16 @@ Success:
 ```text
 ✔ Database marker and schema match contract
   verification: marker + schema
-  storageHash: sha256:abc123...
-  profileHash: sha256:def456...
+  storageHash: abc123...
+  profileHash: def456...
 ```
 
 Marker-only success:
 ```text
 ✔ Database marker matches contract
   verification: marker only (--marker-only)
-  storageHash: sha256:abc123...
-  profileHash: sha256:def456...
+  storageHash: abc123...
+  profileHash: def456...
 
 ⚠ Schema verification skipped because --marker-only was provided
 ```
@@ -242,12 +242,12 @@ Schema drift failure:
   "summary": "Database marker and schema match contract",
   "mode": "full",
   "contract": {
-    "storageHash": "sha256:abc123...",
-    "profileHash": "sha256:def456..."
+    "storageHash": "abc123...",
+    "profileHash": "def456..."
   },
   "marker": {
-    "storageHash": "sha256:abc123...",
-    "profileHash": "sha256:def456..."
+    "storageHash": "abc123...",
+    "profileHash": "def456..."
   },
   "target": {
     "expected": "postgres"
@@ -297,7 +297,7 @@ interface ControlStack<TFamilyId, TTargetId> {
   readonly target: ControlTargetDescriptor<TFamilyId, TTargetId>;
   readonly adapter: ControlAdapterDescriptor<TFamilyId, TTargetId>;
   readonly driver: ControlDriverDescriptor<TFamilyId, TTargetId> | undefined;
-  readonly extensionPacks: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[];
+  readonly extensions: readonly ControlExtensionDescriptor<TFamilyId, TTargetId>[];
 }
 
 interface ControlFamilyInstance {
@@ -311,7 +311,7 @@ interface ControlFamilyInstance {
 }
 ```
 
-Use `createControlStack()` from `@prisma-next/framework-components/control` to create the stack with sensible defaults (`driver` defaults to `undefined`, `extensionPacks` defaults to `[]`).
+Use `createControlStack()` from `@prisma-next/framework-components/control` to create the stack with sensible defaults (`driver` defaults to `undefined`, `extensions` defaults to `[]`).
 
 The SQL family provides this via `@prisma-next/family-sql/control`. The `verify()` method handles marker checks, full `db verify` follows it with `schemaVerify()`, `--marker-only` skips that schema step, and `--schema-only` runs `schemaVerify()` without marker checks.
 
@@ -404,7 +404,7 @@ export default defineConfig({
   target: postgres,
   adapter: postgresAdapter,
   driver: postgresDriver,
-  extensionPacks: [],
+  extensions: [],
   db: {
     connection: process.env.DATABASE_URL, // Optional: can also use --db flag
   },
@@ -555,7 +555,7 @@ export default defineConfig({
   target: postgres,
   adapter: postgresAdapter,
   driver: postgresDriver,
-  extensionPacks: [],
+  extensions: [],
   contract: typescriptContract(contract, 'src/prisma/contract.json'),
   db: {
     connection: process.env.DATABASE_URL, // Optional: can also use --db flag
@@ -584,25 +584,25 @@ export default defineConfig({
 Success (new marker):
 ```
 ✔ Database signed (marker created)
-  storageHash: sha256:abc123...
-  profileHash: sha256:def456...
+  storageHash: abc123...
+  profileHash: def456...
   Total time: 42ms
 ```
 
 Success (updated marker):
 ```
-✔ Database signed (marker updated from sha256:old-hash)
-  storageHash: sha256:abc123...
-  profileHash: sha256:def456...
-  previous storageHash: sha256:old-hash
+✔ Database signed (marker updated from old-hash)
+  storageHash: abc123...
+  profileHash: def456...
+  previous storageHash: old-hash
   Total time: 42ms
 ```
 
 Success (already up-to-date):
 ```
 ✔ Database already signed with this contract
-  storageHash: sha256:abc123...
-  profileHash: sha256:def456...
+  storageHash: abc123...
+  profileHash: def456...
   Total time: 42ms
 ```
 
@@ -619,8 +619,8 @@ Failure (schema mismatch):
   "ok": true,
   "summary": "Database signed (marker created)",
   "contract": {
-    "storageHash": "sha256:abc123...",
-    "profileHash": "sha256:def456..."
+    "storageHash": "abc123...",
+    "profileHash": "def456..."
   },
   "target": {
     "expected": "postgres",
@@ -644,10 +644,10 @@ For updated markers:
 ```json
 {
   "ok": true,
-  "summary": "Database signed (marker updated from sha256:old-hash)",
+  "summary": "Database signed (marker updated from old-hash)",
   "contract": {
-    "storageHash": "sha256:abc123...",
-    "profileHash": "sha256:def456..."
+    "storageHash": "abc123...",
+    "profileHash": "def456..."
   },
   "target": {
     "expected": "postgres",
@@ -657,8 +657,8 @@ For updated markers:
     "created": false,
     "updated": true,
     "previous": {
-      "storageHash": "sha256:old-hash",
-      "profileHash": "sha256:old-profile-hash"
+      "storageHash": "old-hash",
+      "profileHash": "old-profile-hash"
     }
   },
   "meta": {
@@ -761,7 +761,7 @@ export default defineConfig({
   target: postgres,
   adapter: postgresAdapter,
   driver: postgresDriver,
-  extensionPacks: [],
+  extensions: [],
   contract: typescriptContract(contract, 'src/prisma/contract.json'),
   db: {
     connection: process.env.DATABASE_URL, // Optional: can also use --db flag
@@ -778,7 +778,7 @@ export default defineConfig({
 5. **Validate wiring**: Ensures the contract is compatible with the CLI config:
    - `contract.targetFamily` matches `config.family.familyId`
    - `contract.target` matches `config.target.targetId`
-   - `contract.extensionPacks` (if present) are provided by `config.extensionPacks` (matched by descriptor `id`)
+   - `contract.extensions` (if present) are provided by `config.extensions` (matched by descriptor `id`)
 6. **Create Planner/Runner**: Uses `config.target.migrations.createPlanner()` and `config.target.migrations.createRunner()`
 7. **Plan Migration**: Calls `planner.plan()` with the contract, schema IR, additive-only policy, and `frameworkComponents` (the active target/adapter/extension descriptors)
    - On conflict: Returns a structured failure with conflict list
@@ -803,7 +803,7 @@ prisma-next db init ➜ Bootstrap a database to match the current contract
 ├─ Create index user_email_idx on user [additive]
 └─ Add foreign key post_userId_fkey on post [additive]
 
-Destination hash: sha256:abc123...
+Destination hash: abc123...
 
 This is a dry run. No changes were applied.
 Run without --dry-run to apply changes.
@@ -822,7 +822,7 @@ Applying migration plan and verifying schema...
   → Create index user_email_idx on user...
   → Add foreign key post_userId_fkey on post...
 ✔ Applied 4 operation(s)
-  Marker written: sha256:abc123...
+  Marker written: abc123...
 ```
 
 **Output Format (JSON):**
@@ -834,7 +834,7 @@ Applying migration plan and verifying schema...
   "plan": {
     "targetId": "postgres",
     "destination": {
-      "storageHash": "sha256:abc123..."
+      "storageHash": "abc123..."
     },
     "operations": [
       {
@@ -849,7 +849,7 @@ Applying migration plan and verifying schema...
     "operationsExecuted": 4
   },
   "marker": {
-    "storageHash": "sha256:abc123..."
+    "storageHash": "abc123..."
   }
 }
 ```
@@ -891,7 +891,7 @@ prisma-next db update [--db <url>] [--config <path>] [--dry-run] [-y|--yes] [--i
 
 **Config File (`prisma-next.config.ts`):**
 
-The CLI uses a config file to specify the target family, target, adapter, extensionPacks, and contract.
+The CLI uses a config file to specify the target family, target, adapter, extensions, and contract.
 
 **Config Discovery:**
 - `--config <path>`: Explicit path (relative or absolute)
@@ -912,7 +912,7 @@ export default defineConfig({
   family: sql,
   target: postgres,
   adapter: postgresAdapter,
-  extensionPacks: [],
+  extensions: [],
   contract: typescriptContract(contract, 'src/prisma/contract.json'),
 });
 ```
@@ -952,15 +952,14 @@ prisma-next migration plan [--config <path>] [--name <slug>] [--from <contract>]
 2. Reads existing migrations from `config.migrations.dir` (default: `migrations/`)
 3. Determines the starting point: `--from <contract>` if provided, otherwise the `db` ref (greenfield when absent)
 4. Diffs the starting contract against the destination 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 `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.
+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), and `ops.json` (the planned ops, or `[]` in the placeholder-blocked case). The bookend contracts are written write-if-absent into the shared snapshot store at `migrations/snapshots/<hex>/contract.{json,d.ts}`. 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 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
+- `migrations/snapshots/<hex>/contract.{json,d.ts}` — bookend contracts, written write-if-absent, keyed by each contract's storage hash (one entry for `from` when applicable, one for `to`)
 
 **Branching with `--from` and `--to`:** Use `--from` to create a migration edge from a specific contract hash instead of the default starting point. Use `--to` to plan toward any resolved contract — including a rollback via `<migration-dir>^` — instead of the emitted contract. This enables branched migration graphs and arbitrary-target (including reverse) edges without editing contract source.
 
@@ -1028,7 +1027,7 @@ prisma-next migrate [--db <url>] [--to <contract>] [--config <path>] [--json] [-
 
 **Options:**
 - `--db <url>`: Database connection string (optional; defaults to `config.db.connection`)
-- `--to <contract>`: Target contract reference (hash, prefix, ref name, migration directory, `<dir>^`, or filesystem path). When omitted, applies toward the emitted `contract.json`. When `--to` resolves to an on-disk graph node, verification and apply use that bundle's `end-contract.json` — so a planned rollback or other arbitrary-target edge applies without editing contract source.
+- `--to <contract>`: Target contract reference (hash, prefix, ref name, migration directory, `<dir>^`, or filesystem path). When omitted, applies toward the emitted `contract.json`. When `--to` resolves to an on-disk graph node, verification and apply use the snapshot store entry for that node's hash — so a planned rollback or other arbitrary-target edge applies without editing contract source.
 - `--ref <name>`: Target a named ref from `migrations/refs.json` instead of the current contract hash
 - `--config <path>`: Path to `prisma-next.config.ts`
 - `--json`: Output as JSON object
@@ -1085,7 +1084,7 @@ prisma-next ref delete <name>                  # Delete a ref
 
 **Ref naming rules:** Lowercase alphanumeric with hyphens or forward slashes (e.g., `staging`, `prod/us-east`). No `.` or `..` segments.
 
-**Ref values:** Must be valid contract hashes (`sha256:<64 hex chars>` or `sha256:empty`).
+**Ref values:** Must be valid contract hashes (64 lowercase hex chars, or the `empty` sentinel).
 
 **Atomic writes:** `refs.json` is written atomically via temp file + rename to prevent corruption from concurrent writes.
 
@@ -1295,7 +1294,7 @@ import exampleExtension from '@prisma-next/extension-example/control';
 
 export default defineConfig({
   // family/target/adapter/driver omitted for brevity
-  extensionPacks: [exampleExtension],
+  extensions: [exampleExtension],
 });
 ```
 
@@ -1390,7 +1389,7 @@ const client = createControlClient({
   target: postgres,
   adapter: postgresAdapter,
   driver: postgresDriver,
-  extensionPacks: [],
+  extensions: [],
 });
 
 try {

package/dist/cli.mjs

@@ -1,31 +1,31 @@
 #!/usr/bin/env node
-import { D as isCI, O as formatCommandHelp, g as parseGlobalFlagsOrExit, h as parseGlobalFlags, k as formatRootHelp, l as setCommandDescriptions, m as deriveCanPrompt, t as addGlobalOptions, u as setCommandExamples, v as installShutdownHandlers } from "./command-helpers-Cpq44aVa.mjs";
-import { t as createContractEmitCommand } from "./contract-emit-CgnXSANN.mjs";
-import { t as createContractInferCommand } from "./contract-infer-Cg8evbeg.mjs";
+import { D as isCI, O as formatCommandHelp, g as parseGlobalFlagsOrExit, h as parseGlobalFlags, k as formatRootHelp, l as setCommandDescriptions, m as deriveCanPrompt, t as addGlobalOptions, u as setCommandExamples, v as installShutdownHandlers } from "./command-helpers-D-jBl0Qt.mjs";
+import { t as createContractEmitCommand } from "./contract-emit-BT46Mu8Q.mjs";
+import { t as createContractInferCommand } from "./contract-infer-DpqTQECL.mjs";
 import { createDbInitCommand } from "./commands/db-init.mjs";
 import { createDbSchemaCommand } from "./commands/db-schema.mjs";
 import { createDbSignCommand } from "./commands/db-sign.mjs";
 import { createDbUpdateCommand } from "./commands/db-update.mjs";
-import { t as createDbVerifyCommand } from "./db-verify-BEclUzki.mjs";
-import { t as createFormatCommand } from "./format-DAUAZqPt.mjs";
-import { t as createMigrationListCommand } from "./migration-list-BAKujUjh.mjs";
+import { t as createDbVerifyCommand } from "./db-verify-FEN6k1m7.mjs";
+import { t as createFormatCommand } from "./format-DI5qVr22.mjs";
+import { t as createMigrationListCommand } from "./migration-list-BkafFVXS.mjs";
 import { createMigrateCommand } from "./commands/migrate.mjs";
-import { t as createMigrationCheckCommand } from "./migration-check-MHT3w7_v.mjs";
+import { t as createMigrationCheckCommand } from "./migration-check-zEkHpPDT.mjs";
 import { createMigrationGraphCommand } from "./commands/migration-graph.mjs";
-import { t as createMigrationLogCommand } from "./migration-log-C_xam2HZ.mjs";
+import { t as createMigrationLogCommand } from "./migration-log-BxhAtbhA.mjs";
 import { createMigrationNewCommand } from "./commands/migration-new.mjs";
-import { t as createMigrationPlanCommand } from "./migration-plan-CreSVtWZ.mjs";
+import { t as createMigrationPlanCommand } from "./migration-plan-Bk2pbPQH.mjs";
 import { createMigrationShowCommand } from "./commands/migration-show.mjs";
-import { r as createMigrationStatusCommand } from "./migration-status-YgEvXf-u.mjs";
+import { r as createMigrationStatusCommand } from "./migration-status-BzlARseq.mjs";
 import { createRefCommand } from "./commands/ref.mjs";
-import { t as createTelemetryCommand } from "./telemetry-DVr6RFnq.mjs";
+import { t as createTelemetryCommand } from "./telemetry-BbniBUbP.mjs";
 import { Command } from "commander";
 import { DEFAULT_CONTRACT_SOURCE_DIR } from "@prisma-next/config/config-types";
 import { ensureInstallationId, readUserConfig, resolveGating, runTelemetry, userConfigPath } from "@prisma-next/cli-telemetry";
 import { distance } from "closest-match";
 import { fileURLToPath } from "node:url";
 //#region package.json
-var version = "0.16.0-dev.3";
+var version = "0.16.0-dev.31";
 //#endregion
 //#region src/commands/init/templates/code-templates.ts
 function targetPackageName(target) {
@@ -294,7 +294,7 @@ Exit codes (see CLI Style Guide § Exit Codes):
 		"prisma-next init --no-skill                                         # skip the skills install (air-gapped / restricted env)"
 	]);
 	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: ${defaultSchemaPath("psl")})`).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").option("--no-skill", "Skip Prisma Next skills install (air-gapped CI, restricted registries, etc.)").action(async (options) => {
-		const { runInit } = await import("./init-C3JhkHg-.mjs");
+		const { runInit } = await import("./init-ClrRkbwd.mjs");
 		const flags = parseGlobalFlagsOrExit(options);
 		const canPrompt = deriveCanPrompt({
 			flagsInteractive: flags.interactive,