@prisma/composer-cli 0.11.0 → 0.12.0

package/dist/family.mjs

@@ -4,7 +4,7 @@ import { t as alchemyCommandLine } from "./run-alchemy--ZIvgqyU-Cub4-pDf.mjs";
 import { spawn } from "node:child_process";
 import { EnvironmentCredentialManager, createCli, defineCommand, defineCommandFamily, defineConfigSection, defineSessionCommand, exitWithChildStatus, flag, loadConfig, positional } from "@prisma/cli-engine";
 import { CliStructuredError, notOk, ok } from "@prisma/cli-engine/protocol";
-//#region ../../0-framework/3-tooling/cli/dist/log-WOf7R2HN.mjs
+//#region ../../0-framework/3-tooling/cli/dist/log-E_5UMZl8.mjs
 /** In-package variant threading the injection seam (the CLI's RunDeps, unit
 * tests). Deliberately NOT re-exported through `./control` — the seam mirrors
 * internal types and is not part of the published surface. */
@@ -12,7 +12,7 @@ async function deployWithDeps(input, deps) {
 	const cwd = input.cwd ?? process.cwd();
 	let executor;
 	try {
-		executor = await import("./execute-deploy-destroy-DJ3BlpgU-BCTSVylF.mjs");
+		executor = await import("./execute-deploy-destroy-Bsdh8hf4-CZVPrQtx.mjs");
 	} catch (error) {
 		return notOk$1(executorLoadFailure("deploy", error, cwd));
 	}
@@ -25,7 +25,7 @@ async function destroyWithDeps(input, deps) {
 	const cwd = input.cwd ?? process.cwd();
 	let executor;
 	try {
-		executor = await import("./execute-deploy-destroy-DJ3BlpgU-BCTSVylF.mjs");
+		executor = await import("./execute-deploy-destroy-Bsdh8hf4-CZVPrQtx.mjs");
 	} catch (error) {
 		return notOk$1(executorLoadFailure("destroy", error, cwd));
 	}
@@ -38,7 +38,7 @@ async function devWithDeps(input, deps) {
 	const cwd = input.cwd ?? process.cwd();
 	let executor;
 	try {
-		executor = await import("./execute-dev-CQ0Lo2eN-DBThEMBv.mjs");
+		executor = await import("./execute-dev-CQ0Lo2eN-DxMcOjxh.mjs");
 	} catch (error) {
 		return notOk$1(executorLoadFailure("dev", error, cwd));
 	}
@@ -51,14 +51,14 @@ async function logWithDeps(input, deps) {
 	const cwd = input.cwd ?? process.cwd();
 	let executor;
 	try {
-		executor = await import("./execute-log-CUzTOzSj-31WISHGD.mjs");
+		executor = await import("./execute-log-CUzTOzSj-BndClj6B.mjs");
 	} catch (error) {
 		return notOk$1(executorLoadFailure("log", error, cwd));
 	}
 	return executor.executeLog(input, deps, cwd);
 }
 //#endregion
-//#region ../../0-framework/3-tooling/cli/dist/engine-cli-CMw8Uug4.mjs
+//#region ../../0-framework/3-tooling/cli/dist/engine-cli-BI4fPmYY.mjs
 /**
 * The family boundary's error translation.
 *
@@ -266,6 +266,23 @@ const composerSection = defineConfigSection({
 	validate
 });
 /**
+* `destroy`'s target, from its two mutually exclusive flags. Kept out of the
+* grammar because the engine's flag layer has no "exactly one of these"
+* construct — and because both wrong shapes need their own remedy, which a
+* generic arity error could not give.
+*/
+function targetOf(stage, production) {
+	if (stage !== void 0 && production) return notOk(new CliStructuredError("DEPLOY.TARGET_CONFLICT", "Pass either --stage <name> or --production to `destroy`, not both."));
+	if (stage === void 0 && !production) return notOk(new CliStructuredError("DEPLOY.TARGET_MISSING", "`destroy` requires an explicit target.", { nextActions: [{
+		kind: "user-choice",
+		label: "Pass --stage <name> to tear down a branch environment, or --production to tear down the production environment."
+	}] }));
+	return ok(stage !== void 0 ? {
+		kind: "stage",
+		stage
+	} : { kind: "production" });
+}
+/**
 * The workspace the in-process leg acts in, from the engine's credential
 * read. Handlers never decode a token and never read PRISMA_WORKSPACE_ID:
 * whether the credential came from a stored session or the environment, the
@@ -280,16 +297,18 @@ async function workspaceIdOf(ctx) {
 	return (await ctx.activeCredential())?.workspaceId;
 }
 /**
-* `deploy <entry>` — a result command that hands the terminal to alchemy.
+* `destroy <entry>` — deploy's mirror: same derivation, alchemy destroy.
 *
-* `--production` is gone. It was accepted and then always errored ("only
-* valid with destroy"), so no invocation using it could ever have succeeded;
-* deploy targets production by default when no `--stage` is given.
+* No confirmation prompt, matching the CLI this replaces. The front door
+* cannot know what the child will tear down, so a consent step here would be
+* asking the user to approve a list nobody has computed yet; if destroy
+* deserves one it belongs in composer's own operation, not in the grammar.
 */
-const createDeployCommand = (operations) => defineCommand({
+const createDestroyCommand = (operations) => defineCommand({
 	help: {
-		summary: "Deploy the application whose root node is <entry>'s default export.",
-		examples: ["{bin} deploy src/service.ts", "{bin} deploy src/service.ts --stage feat-auth"]
+		summary: "Tear down the application whose root node is <entry>'s default export.",
+		description: "Same derivation as deploy. Requires an explicit target: --stage <name> for a branch environment, or --production for the production environment.",
+		examples: ["{bin} destroy src/service.ts --stage feat-auth", "{bin} destroy src/service.ts --production"]
 	},
 	args: {
 		positionals: { entry: positional.string({
@@ -298,21 +317,14 @@ const createDeployCommand = (operations) => defineCommand({
 		}) },
 		flags: {
 			name: flag.string({
-				brief: "Override the root node's name — the deploy's application name.",
+				brief: "Override the root node's name — the application name to tear down.",
 				placeholder: "name"
 			}),
 			stage: flag.string({
-				brief: "Deploy scope to target; omit for production.",
+				brief: "Tear down this branch environment.",
 				placeholder: "stage"
 			}),
-			report: flag.string({
-				brief: "Write the deploy's outcome as JSON to this path — resources, preview URLs, and the failure cause. Also settable as PRISMA_COMPOSER_REPORT_FILE.",
-				placeholder: "path"
-			}),
-			buildId: flag.string({
-				brief: "Join the deploy record your CI already created rather than letting the target create one. Each target also reads its own environment variable for this; the flag wins.",
-				placeholder: "id"
-			})
+			production: flag.boolean({ brief: "Tear down the project-level production environment." })
 		}
 	},
 	needs: {
@@ -321,69 +333,129 @@ const createDeployCommand = (operations) => defineCommand({
 	},
 	maySpawn: true,
 	handler: async (args, ctx) => {
+		const target = targetOf(args.flags.stage, args.flags.production);
+		if (!target.ok) return target;
 		const alchemy = convergeSpawn(ctx);
-		return settleConverge(await operations.deploy({
+		return settleConverge(await operations.destroy({
 			entry: args.positionals.entry,
 			name: args.flags.name,
-			stage: args.flags.stage,
+			target: target.value,
 			cwd: ctx.cwd,
-			reportPath: args.flags.report,
-			reportId: args.flags.buildId
+			onEvent: (event) => {
+				if (event.kind !== "no-local-deploy-state") return;
+				ctx.report({
+					kind: "message",
+					severity: "warn",
+					text: `No prior deploy state under ${event.cwd} — if you deployed from a different directory, run destroy from there; otherwise this is a no-op.`
+				});
+			}
 		}, operationDeps({
 			alchemy,
 			configPath: ctx.config.configPath,
 			workspaceId: await workspaceIdOf(ctx),
 			client: ctx.api
-		})), ctx, ({ summary }) => ctx.present({ data: { summary: summary ?? null } }, {
-			human: (ui) => summary === void 0 ? [{
-				kind: "summary",
-				status: "ok",
-				text: "Deployed."
-			}] : [{
+		})), ctx, () => ctx.present({ data: void 0 }, {
+			human: () => [{
 				kind: "summary",
 				status: "ok",
-				text: `Deployed ${ui.emphasize(summary.app)}.`
-			}, {
-				kind: "table",
-				columns: ["Address", "Deployed"],
-				rows: summary.nodes.map((node) => [node.address, node.entities.map((entity) => `${entity.kind} ${entity.id}`).join(", ")])
+				text: "Destroyed."
 			}],
 			stdout: () => [],
-			json: () => ({ summary: summary ?? null }),
+			json: () => void 0,
 			next: () => []
 		}));
 	}
 });
 /**
-* `destroy`'s target, from its two mutually exclusive flags. Kept out of the
-* grammar because the engine's flag layer has no "exactly one of these"
-* construct — and because both wrong shapes need their own remedy, which a
-* generic arity error could not give.
+* `log <entry> [address]` — a session command that tails the merged logs of
+* the app running locally on this machine.
+*
+* It reads the LOCAL dev-emulator daemon, not the platform's logs surface, so
+* it is credential-free. It hands the terminal to nothing, which is why it
+* does not declare `maySpawn` and keeps json support: the log lines ARE its
+* json surface.
+*
+* Windows is refused inside the operation itself (LOG.PLATFORM_UNSUPPORTED),
+* which is why nothing here reads the platform.
 */
-function targetOf(stage, production) {
-	if (stage !== void 0 && production) return notOk(new CliStructuredError("DEPLOY.TARGET_CONFLICT", "Pass either --stage <name> or --production to `destroy`, not both."));
-	if (stage === void 0 && !production) return notOk(new CliStructuredError("DEPLOY.TARGET_MISSING", "`destroy` requires an explicit target.", { nextActions: [{
-		kind: "user-choice",
-		label: "Pass --stage <name> to tear down a branch environment, or --production to tear down the production environment."
-	}] }));
-	return ok(stage !== void 0 ? {
-		kind: "stage",
-		stage
-	} : { kind: "production" });
-}
+/** An empty screen reads as broken, so show a little recent history before going live. */
+const DEFAULT_TAIL = 20;
+const createLogCommand = (operations) => defineSessionCommand({
+	help: {
+		summary: "Tail the merged logs of the locally-running application whose root node is <entry>'s default export.",
+		examples: ["{bin} log src/service.ts", "{bin} log src/service.ts catalog.service"]
+	},
+	args: {
+		positionals: {
+			entry: positional.string({
+				brief: "The module whose default export is the application root.",
+				placeholder: "entry"
+			}),
+			address: positional.optionalString({
+				brief: "Only this service's lines, by its dotted address (catalog.service); every service when absent.",
+				placeholder: "address"
+			})
+		},
+		flags: {
+			name: flag.string({
+				brief: "Override the root node's name — the dev instance's application name.",
+				placeholder: "name"
+			}),
+			tail: flag.number({
+				brief: `How many trailing history lines to show before live output (default ${String(DEFAULT_TAIL)}).`,
+				placeholder: "lines",
+				default: DEFAULT_TAIL
+			})
+		}
+	},
+	needs: { config: composerSection },
+	handler: async (args, ctx) => {
+		const reportLogEvent = (event) => {
+			ctx.report({
+				kind: "message",
+				severity: "warn",
+				text: event.kind === "stream-failed" ? `Stream failed: ${event.message}` : `Falling behind — dropped the ${String(event.count)} oldest lines.`
+			});
+		};
+		const result = await operations.log({
+			entry: args.positionals.entry,
+			name: args.flags.name,
+			address: args.positionals.address,
+			tail: args.flags.tail ?? DEFAULT_TAIL,
+			cwd: ctx.cwd,
+			signal: ctx.signal,
+			onEvent: reportLogEvent
+		}, { configPath: ctx.config.configPath });
+		if (!result.ok) return notOk(toEngineError(result.failure));
+		const attached = result.value;
+		if (attached.services.length === 0) {
+			ctx.report({
+				kind: "message",
+				severity: "warn",
+				text: `No running services for "${attached.appName}" — start it first with \`dev ${args.positionals.entry}\`.`
+			});
+			return ok(void 0);
+		}
+		for await (const { service, line } of attached.lines) ctx.report({
+			kind: "output",
+			source: service,
+			channel: "data",
+			line: `[${service}] ${line}`
+		});
+		return ok(void 0);
+	}
+});
 /**
-* `destroy <entry>` — deploy's mirror: same derivation, alchemy destroy.
+* `deploy <entry>` — a result command that hands the terminal to alchemy.
 *
-* No confirmation prompt, matching the CLI this replaces. The front door
-* cannot know what the child will tear down, so a consent step here would be
-* asking the user to approve a list nobody has computed yet; if destroy
-* deserves one it belongs in composer's own operation, not in the grammar.
+* `--production` is gone. It was accepted and then always errored ("only
+* valid with destroy"), so no invocation using it could ever have succeeded;
+* deploy targets production by default when no `--stage` is given.
 */
-const createDestroyCommand = (operations) => defineCommand({
+const createDeployCommand = (operations) => defineCommand({
 	help: {
-		summary: "Tear down the application whose root node is <entry>'s default export.",
-		description: "Same derivation as deploy. Requires an explicit target: --stage <name> for a branch environment, or --production for the production environment.",
-		examples: ["{bin} destroy src/service.ts --stage feat-auth", "{bin} destroy src/service.ts --production"]
+		summary: "Deploy the application whose root node is <entry>'s default export.",
+		examples: ["{bin} deploy src/service.ts", "{bin} deploy src/service.ts --stage feat-auth"]
 	},
 	args: {
 		positionals: { entry: positional.string({
@@ -392,14 +464,21 @@ const createDestroyCommand = (operations) => defineCommand({
 		}) },
 		flags: {
 			name: flag.string({
-				brief: "Override the root node's name — the application name to tear down.",
+				brief: "Override the root node's name — the deploy's application name.",
 				placeholder: "name"
 			}),
 			stage: flag.string({
-				brief: "Tear down this branch environment.",
+				brief: "Deploy scope to target; omit for production.",
 				placeholder: "stage"
 			}),
-			production: flag.boolean({ brief: "Tear down the project-level production environment." })
+			report: flag.string({
+				brief: "Write the deploy's outcome as JSON to this path — resources, preview URLs, and the failure cause. Also settable as PRISMA_COMPOSER_REPORT_FILE.",
+				placeholder: "path"
+			}),
+			buildId: flag.string({
+				brief: "Join the deploy record your CI already created rather than letting the target create one. Each target also reads its own environment variable for this; the flag wins.",
+				placeholder: "id"
+			})
 		}
 	},
 	needs: {
@@ -408,35 +487,35 @@ const createDestroyCommand = (operations) => defineCommand({
 	},
 	maySpawn: true,
 	handler: async (args, ctx) => {
-		const target = targetOf(args.flags.stage, args.flags.production);
-		if (!target.ok) return target;
 		const alchemy = convergeSpawn(ctx);
-		return settleConverge(await operations.destroy({
+		return settleConverge(await operations.deploy({
 			entry: args.positionals.entry,
 			name: args.flags.name,
-			target: target.value,
+			stage: args.flags.stage,
 			cwd: ctx.cwd,
-			onEvent: (event) => {
-				if (event.kind !== "no-local-deploy-state") return;
-				ctx.report({
-					kind: "message",
-					severity: "warn",
-					text: `No prior deploy state under ${event.cwd} — if you deployed from a different directory, run destroy from there; otherwise this is a no-op.`
-				});
-			}
+			reportPath: args.flags.report,
+			reportId: args.flags.buildId
 		}, operationDeps({
 			alchemy,
 			configPath: ctx.config.configPath,
 			workspaceId: await workspaceIdOf(ctx),
 			client: ctx.api
-		})), ctx, () => ctx.present({ data: void 0 }, {
-			human: () => [{
+		})), ctx, ({ summary }) => ctx.present({ data: { summary: summary ?? null } }, {
+			human: (ui) => summary === void 0 ? [{
 				kind: "summary",
 				status: "ok",
-				text: "Destroyed."
+				text: "Deployed."
+			}] : [{
+				kind: "summary",
+				status: "ok",
+				text: `Deployed ${ui.emphasize(summary.app)}.`
+			}, {
+				kind: "table",
+				columns: ["Address", "Deployed"],
+				rows: summary.nodes.map((node) => [node.address, node.entities.map((entity) => `${entity.kind} ${entity.id}`).join(", ")])
 			}],
 			stdout: () => [],
-			json: () => void 0,
+			json: () => ({ summary: summary ?? null }),
 			next: () => []
 		}));
 	}
@@ -578,7 +657,7 @@ Generated stack file: ${event.stackFilePath}\nRun \`${event.reproduceCommand}\`
 const createDevCommand = (operations) => defineSessionCommand({
 	help: {
 		summary: "Bring up the application whose root node is <entry>'s default export, entirely on this machine.",
-		description: "Runs credential-free and watches the app for changes, reconverging on every edit. Logs are a separate command; run `log <entry>` to tail them.",
+		description: "Runs credential-free and watches the app for changes, reconverging on every edit.",
 		examples: ["{bin} dev src/service.ts", "{bin} dev src/service.ts --fresh"]
 	},
 	args: {
@@ -615,85 +694,6 @@ const createDevCommand = (operations) => defineSessionCommand({
 	}
 });
 /**
-* `log <entry> [address]` — a session command that tails the merged logs of
-* the app running locally on this machine.
-*
-* It reads the LOCAL dev-emulator daemon, not the platform's logs surface, so
-* it is credential-free. It hands the terminal to nothing, which is why it
-* does not declare `maySpawn` and keeps json support: the log lines ARE its
-* json surface.
-*
-* Windows is refused inside the operation itself (LOG.PLATFORM_UNSUPPORTED),
-* which is why nothing here reads the platform.
-*/
-/** An empty screen reads as broken, so show a little recent history before going live. */
-const DEFAULT_TAIL = 20;
-const createLogCommand = (operations) => defineSessionCommand({
-	help: {
-		summary: "Tail the merged logs of the locally-running application whose root node is <entry>'s default export.",
-		examples: ["{bin} log src/service.ts", "{bin} log src/service.ts catalog.service"]
-	},
-	args: {
-		positionals: {
-			entry: positional.string({
-				brief: "The module whose default export is the application root.",
-				placeholder: "entry"
-			}),
-			address: positional.optionalString({
-				brief: "Only this service's lines, by its dotted address (catalog.service); every service when absent.",
-				placeholder: "address"
-			})
-		},
-		flags: {
-			name: flag.string({
-				brief: "Override the root node's name — the dev instance's application name.",
-				placeholder: "name"
-			}),
-			tail: flag.number({
-				brief: `How many trailing history lines to show before live output (default ${String(DEFAULT_TAIL)}).`,
-				placeholder: "lines",
-				default: DEFAULT_TAIL
-			})
-		}
-	},
-	needs: { config: composerSection },
-	handler: async (args, ctx) => {
-		const reportLogEvent = (event) => {
-			ctx.report({
-				kind: "message",
-				severity: "warn",
-				text: event.kind === "stream-failed" ? `Stream failed: ${event.message}` : `Falling behind — dropped the ${String(event.count)} oldest lines.`
-			});
-		};
-		const result = await operations.log({
-			entry: args.positionals.entry,
-			name: args.flags.name,
-			address: args.positionals.address,
-			tail: args.flags.tail ?? DEFAULT_TAIL,
-			cwd: ctx.cwd,
-			signal: ctx.signal,
-			onEvent: reportLogEvent
-		}, { configPath: ctx.config.configPath });
-		if (!result.ok) return notOk(toEngineError(result.failure));
-		const attached = result.value;
-		if (attached.services.length === 0) {
-			ctx.report({
-				kind: "message",
-				severity: "warn",
-				text: `No running services for "${attached.appName}" — start it first with \`dev ${args.positionals.entry}\`.`
-			});
-			return ok(void 0);
-		}
-		for await (const { service, line } of attached.lines) ctx.report({
-			kind: "output",
-			source: service,
-			channel: "data",
-			line: `[${service}] ${line}`
-		});
-		return ok(void 0);
-	}
-});
-/**
 * Composer's `CommandFamily` — the unit the engine mounts, whether the process
 * is composer's own CLI or the `prisma` bin.
 *
@@ -708,9 +708,14 @@ const createLogCommand = (operations) => defineSessionCommand({
 * scripts/check-family-static-graph.mjs enforces this against BUILT output,
 * where type-only imports have already been erased.
 *
-* The four commands close over the operations they are given, so a host can
+* The commands close over the operations they are given, so a host can
 * mount this family against the test double and exercise real grammar, real
 * arg validation and real handlers with no alchemy behind them.
+*
+* The family ships `deploy` and `dev` only: `destroy` and `log` were retired
+* from the family surface (2026-08-21 PM review), so hosts mounting the family
+* — the `prisma` bin — never see them. They remain first-class commands of
+* composer's own bin, mounted on top of the family in engine-cli.ts.
 */
 const realOperations = {
 	deploy: deployWithDeps,
@@ -724,9 +729,7 @@ function createComposerFamily(options = {}) {
 		configSection: composerSection,
 		commands: {
 			deploy: createDeployCommand(operations),
-			destroy: createDestroyCommand(operations),
-			dev: createDevCommand(operations),
-			log: createLogCommand(operations)
+			dev: createDevCommand(operations)
 		},
 		docsBaseUrl: DOCS_BASE
 	});
@@ -895,22 +898,27 @@ function createRuntime(host, loadConfig) {
 const BINARY_NAME = "prisma-composer";
 /**
 * Composer's commands mount at the top level of its own CLI (`prisma-composer
-* deploy`); under the `prisma` bin the same family mounts one level down
-* (`prisma composer deploy`). The family is identical either way — only the
-* mount paths differ, which is exactly the split `createCli` draws between
-* `commandFamilies` and `commands`.
+* deploy`). The bin mounts more than the family carries: `destroy` and `log`
+* were retired from the family (the surface the `prisma` bin mounts, per the
+* 2026-08-21 PM review) but stay first-class commands of `prisma-composer`
+* itself, so their definitions are mounted here on top of the family.
 */
-function mountedTree(family) {
-	return { ...family.commands };
+function mountedTree(family, operations) {
+	return {
+		...family.commands,
+		destroy: createDestroyCommand(operations),
+		log: createLogCommand(operations)
+	};
 }
 function createComposerCli(spec) {
-	const family = createComposerFamily({ operations: spec.operations });
+	const operations = spec.operations ?? realOperations;
+	const family = createComposerFamily({ operations });
 	return createCli({
 		name: BINARY_NAME,
 		version: spec.version,
 		commandFamilies: [family],
 		groups: {},
-		commands: mountedTree(family)
+		commands: mountedTree(family, operations)
 	});
 }
 /**