@prisma/cli 3.0.0-beta.9 → 3.0.0-dev.101.1

package/dist/lib/app/branch-database-deploy.js

@@ -1,10 +1,10 @@
 import { CliError, usageError } from "../../shell/errors.js";
+import { confirmPrompt } from "../../shell/prompt.js";
 import { renderSummaryLine } from "../../shell/ui.js";
 import { canPrompt } from "../../shell/runtime.js";
-import { confirmPrompt } from "../../shell/prompt.js";
 import { formatCommandArgument } from "../../shell/command-arguments.js";
 import "../project/setup.js";
-import { hasBranchDatabaseSignal, inspectBranchDatabaseSignal, runBranchDatabaseSchemaSetup } from "./branch-database.js";
+import { hasBranchDatabaseSignal, inspectBranchDatabaseSignal } from "./branch-database.js";
 import path from "node:path";
 //#region src/lib/app/branch-database-deploy.ts
 async function maybeSetupBranchDatabase(context, provider, projectId, branch, options) {
@@ -26,13 +26,12 @@ async function maybeSetupBranchDatabase(context, provider, projectId, branch, op
 			result: options.db === true ? {
 				status: "skipped",
 				reason: existingDatabaseEnvReason(branch),
-				envVars: targetEnvVars,
-				schema: null
+				envVars: targetEnvVars
 			} : void 0,
 			warnings: warning ? [warning] : []
 		};
 	}
-	const localSignal = await inspectBranchDatabaseSignal(context.runtime.cwd, context.runtime.signal);
+	const localSignal = await inspectBranchDatabaseSignal(options.projectDir, context.runtime.signal);
 	if (localSignal.unsupportedSchema) {
 		if (options.db === true) throw unsupportedBranchDatabaseSchemaError(localSignal.unsupportedSchema, branch, context);
 		return emptyBranchDatabaseSetupOutcome();
@@ -56,9 +55,9 @@ async function maybeSetupBranchDatabase(context, provider, projectId, branch, op
 			initialValue: false
 		})) return emptyBranchDatabaseSetupOutcome();
 	} else if (!canPrompt(context) && !context.flags.yes) throw nonInteractiveDatabaseSetupRequiresYesError(branch);
-	return setupBranchDatabase(context, provider, projectId, branch, localSignal, envState);
+	return setupBranchDatabase(context, provider, projectId, branch, localSignal, envState, options.projectDir);
 }
-async function setupBranchDatabase(context, provider, projectId, branch, signal, envState) {
+async function setupBranchDatabase(context, provider, projectId, branch, signal, envState, projectDir) {
 	emitBranchDatabaseProgress(context, "pending", "Creating database");
 	const database = await provider.createBranchDatabase({
 		projectId,
@@ -70,27 +69,11 @@ async function setupBranchDatabase(context, provider, projectId, branch, signal,
 	});
 	emitBranchDatabaseProgress(context, "success", "Created database");
 	try {
-		let schemaSetup = null;
-		const warnings = [];
-		let skippedSchemaWarning = null;
-		if (signal.schema) {
-			emitBranchDatabaseProgress(context, "pending", `Applying database schema with ${formatSchemaSetupCommand(signal.schema.command)}`);
-			schemaSetup = await runBranchDatabaseSchemaSetup({
-				context,
-				schema: signal.schema,
-				databaseUrl: database.databaseUrl,
-				directUrl: database.directUrl
-			}).catch((error) => {
-				throw schemaSetupFailedError(error, signal.schema, branch, context.runtime.cwd);
-			});
-			emitBranchDatabaseProgress(context, "success", "Applied database schema");
-		} else skippedSchemaWarning = "No supported Prisma schema source was found. Database env vars were created, but schema setup was skipped.";
 		const envVars = await upsertBranchDatabaseEnvVars(context, provider, projectId, branch, database, envState);
-		emitBranchDatabaseProgress(context, "success", `Added ${envScopeLabel(branch)} env var${envVars.length === 1 ? "" : "s"} ${envVars.join(", ")}`);
-		if (skippedSchemaWarning) {
-			emitBranchDatabaseWarning(context, skippedSchemaWarning);
-			warnings.push(skippedSchemaWarning);
-		}
+		emitBranchDatabaseProgress(context, "success", `Added ${envScopeLabel(branch)} env var${envVars.length === 1 ? "" : "s"} ${envVars.join(", ")} — shared by every app on ${envScopeLabel(branch) === "production" ? "production" : `branch "${branch.name}"`}`);
+		const schemaCommand = signal.schema ? `DATABASE_URL=<url> npx ${formatSchemaSetupCommand(signal.schema.command)} (detected ${path.relative(projectDir, signal.schema.path) || signal.schema.path})` : "your own migration tooling";
+		const schemaSuggestion = `The new database is empty. Get a connection URL with \`prisma-cli database connection create ${database.id}\`, then apply your schema with ${schemaCommand}.`;
+		emitBranchDatabaseWarning(context, schemaSuggestion);
 		return {
 			result: {
 				status: "created",
@@ -98,14 +81,9 @@ async function setupBranchDatabase(context, provider, projectId, branch, signal,
 					id: database.id,
 					name: database.name
 				},
-				envVars,
-				schema: schemaSetup ? {
-					command: schemaSetup.command,
-					source: schemaSetup.source,
-					path: schemaSetup.schemaPath
-				} : null
+				envVars
 			},
-			warnings
+			warnings: [schemaSuggestion]
 		};
 	} catch (error) {
 		throw await cleanupCreatedBranchDatabaseAfterFailure(context, provider, database, branch, error);
@@ -307,24 +285,6 @@ function branchDatabaseCleanupFailedError(setupError, cleanupError, database, br
 		nextSteps: []
 	});
 }
-function schemaSetupFailedError(error, schema, branch, cwd) {
-	return new CliError({
-		code: "SCHEMA_SETUP_FAILED",
-		domain: "app",
-		summary: "Database schema setup failed",
-		why: error instanceof Error ? error.message : String(error),
-		fix: "Fix the Prisma schema or migrations, then rerun deploy with --db.",
-		debug: formatDebugDetails(error),
-		meta: {
-			branch: branch.name,
-			schemaPath: schema.path,
-			source: schema.kind,
-			command: schema.command
-		},
-		exitCode: 1,
-		nextSteps: [...formatSchemaSetupNextSteps(schema, cwd), formatAppDeployWithDbNextStep(branch)]
-	});
-}
 function unsupportedBranchDatabaseSchemaError(schema, branch, context) {
 	return usageError("Database setup is not available for this Prisma schema", `${path.relative(context.runtime.cwd, schema.path) || defaultUnsupportedSchemaSourcePath(schema)} targets ${formatUnsupportedSchemaTarget(schema.target)}, but --db creates Prisma Postgres databases.`, "Use project env commands to provide a database URL, or switch the Prisma schema source to PostgreSQL before using --db.", [formatProjectEnvAddNextStep(branch), `prisma-cli app deploy --branch ${formatCommandArgument(branch.name)}`], "app");
 }
@@ -337,14 +297,6 @@ function formatProjectEnvListNextStep(branch) {
 function formatProjectEnvAddNextStep(branch) {
 	return branch.kind === "production" ? "prisma-cli project env add DATABASE_URL=<value> --role production" : `prisma-cli project env add DATABASE_URL=<value> --branch ${formatCommandArgument(branch.name)}`;
 }
-function formatSchemaSetupNextSteps(schema, cwd) {
-	const sourcePath = path.relative(cwd, schema.path) || defaultSchemaSourcePath(schema);
-	switch (schema.command) {
-		case "migrate-deploy": return [`npx --no-install prisma migrate deploy --schema ${formatCommandArgument(sourcePath)}`];
-		case "db-push": return [`npx --no-install prisma db push --schema ${formatCommandArgument(sourcePath)}`];
-		case "prisma-next-db-init": return [`npx --no-install prisma-next contract emit --config ${formatCommandArgument(sourcePath)}`, `npx --no-install prisma-next db init --config ${formatCommandArgument(sourcePath)} --db <DATABASE_URL>`];
-	}
-}
 function defaultSchemaSourcePath(schema) {
 	return schema.kind === "prisma-next" ? "prisma-next.config.ts" : "schema.prisma";
 }

package/dist/lib/app/branch-database.js

@@ -1,6 +1,5 @@
 import { access, readFile, readdir, stat } from "node:fs/promises";
 import path from "node:path";
-import { spawn } from "node:child_process";
 //#region src/lib/app/branch-database.ts
 const SKIPPED_DIRECTORIES = new Set([
 	".git",
@@ -67,23 +66,6 @@ function hasBranchDatabaseSignal(signal) {
 	if (signal.unsupportedSchema) return false;
 	return Boolean(signal.schema || signal.databaseUrlReferences.length > 0);
 }
-async function runBranchDatabaseSchemaSetup(options) {
-	const schemaPath = path.relative(options.context.runtime.cwd, options.schema.path) || defaultSchemaSourcePath(options.schema);
-	const commands = buildSchemaSetupCommands(options.schema, schemaPath, options.databaseUrl);
-	for (const command of commands) await runPrismaCommand({
-		context: options.context,
-		...command,
-		env: {
-			DATABASE_URL: options.databaseUrl,
-			...options.directUrl ? { DIRECT_URL: options.directUrl } : {}
-		}
-	});
-	return {
-		command: options.schema.command,
-		source: options.schema.kind,
-		schemaPath
-	};
-}
 async function scanDirectory(cwd, directory, depth, state, signal) {
 	signal.throwIfAborted();
 	if (depth > MAX_SCAN_DEPTH || state.filesVisited >= MAX_SCAN_FILES) return;
@@ -229,88 +211,5 @@ async function readTextFileIfSmall(filePath, signal) {
 		signal
 	});
 }
-function buildSchemaSetupCommands(schema, schemaPath, databaseUrl) {
-	if (schema.command === "migrate-deploy") return [{
-		args: [
-			"--no-install",
-			"prisma",
-			"migrate",
-			"deploy",
-			"--schema",
-			schemaPath
-		],
-		displayCommand: "npx --no-install prisma migrate deploy"
-	}];
-	if (schema.command === "db-push") return [{
-		args: [
-			"--no-install",
-			"prisma",
-			"db",
-			"push",
-			"--schema",
-			schemaPath
-		],
-		displayCommand: "npx --no-install prisma db push"
-	}];
-	return [{
-		args: [
-			"--no-install",
-			"prisma-next",
-			"contract",
-			"emit",
-			"--config",
-			schemaPath
-		],
-		displayCommand: "npx --no-install prisma-next contract emit"
-	}, {
-		args: [
-			"--no-install",
-			"prisma-next",
-			"db",
-			"init",
-			"--config",
-			schemaPath,
-			"--db",
-			databaseUrl
-		],
-		displayCommand: "npx --no-install prisma-next db init"
-	}];
-}
-function defaultSchemaSourcePath(schema) {
-	return schema.kind === "prisma-next" ? "prisma-next.config.ts" : "schema.prisma";
-}
-async function runPrismaCommand(options) {
-	const shouldPipeOutput = !options.context.flags.json && !options.context.flags.quiet;
-	const child = spawn("npx", options.args, {
-		cwd: options.context.runtime.cwd,
-		env: {
-			...options.context.runtime.env,
-			...options.env
-		},
-		signal: options.context.runtime.signal,
-		stdio: shouldPipeOutput ? [
-			"ignore",
-			"pipe",
-			"pipe"
-		] : [
-			"ignore",
-			"ignore",
-			"ignore"
-		]
-	});
-	if (shouldPipeOutput) {
-		child.stdout?.pipe(options.context.output.stderr, { end: false });
-		child.stderr?.pipe(options.context.output.stderr, { end: false });
-	}
-	const exit = await new Promise((resolve, reject) => {
-		child.once("error", reject);
-		child.once("close", (code, signal) => resolve({
-			code,
-			signal
-		}));
-	});
-	if (exit.signal) throw new Error(`${options.displayCommand} was terminated by ${exit.signal}.`);
-	if (exit.code !== 0) throw new Error(`${options.displayCommand} exited with code ${exit.code ?? 1}.`);
-}
 //#endregion
-export { hasBranchDatabaseSignal, inspectBranchDatabaseSignal, runBranchDatabaseSchemaSetup };
+export { hasBranchDatabaseSignal, inspectBranchDatabaseSignal };

package/dist/lib/app/build-settings.js

@@ -0,0 +1,93 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveBuildSettings, resolveConfiguredBuildSettings } from "@prisma/compute-sdk";
+//#region src/lib/app/build-settings.ts
+/** Legacy build-settings file: no longer read or written, only detected for migration. */
+const PRISMA_APP_CONFIG_FILENAME = "prisma.app.json";
+/**
+* Detects a leftover `prisma.app.json`. The file is no longer used: one that
+* matches the effective settings is reported for deletion, one with custom
+* values must be migrated to the compute config so builds never silently
+* change.
+*/
+async function detectLegacyBuildSettings(options) {
+	const configPath = path.join(options.appPath, PRISMA_APP_CONFIG_FILENAME);
+	let content;
+	try {
+		options.signal?.throwIfAborted();
+		content = await readFile(configPath, {
+			encoding: "utf8",
+			signal: options.signal
+		});
+	} catch (error) {
+		if (options.signal?.aborted) throw error;
+		return { kind: "absent" };
+	}
+	let legacy;
+	try {
+		const parsed = JSON.parse(content);
+		const buildCommand = parsed.buildCommand === null || typeof parsed.buildCommand === "string" ? typeof parsed.buildCommand === "string" ? parsed.buildCommand.trim() || null : null : void 0;
+		const outputDirectory = typeof parsed.outputDirectory === "string" ? normalizeRelativePath(parsed.outputDirectory) : void 0;
+		if (buildCommand === void 0 || !outputDirectory) return {
+			kind: "invalid",
+			configPath
+		};
+		legacy = {
+			buildCommand,
+			outputDirectory
+		};
+	} catch {
+		return {
+			kind: "invalid",
+			configPath
+		};
+	}
+	return legacy.buildCommand === options.effective.buildCommand && legacy.outputDirectory === options.effective.outputDirectory ? {
+		kind: "matching",
+		configPath
+	} : {
+		kind: "custom",
+		configPath,
+		...legacy
+	};
+}
+/** Resolves build settings purely from framework inference; nothing is read or written. */
+async function resolveInferredAppBuildSettings(options) {
+	return {
+		status: "inferred",
+		configPath: null,
+		relativeConfigPath: null,
+		settings: await resolveBuildSettings(options)
+	};
+}
+/**
+* Resolves build settings when the compute config owns them: configured
+* fields win, omitted fields fall back to framework defaults.
+*/
+async function resolveConfiguredAppBuildSettings(options) {
+	const configFilename = path.basename(options.configPath);
+	const settings = await resolveConfiguredBuildSettings({
+		appPath: options.appPath,
+		buildType: options.buildType,
+		configured: options.configured,
+		source: `set by ${configFilename}`,
+		signal: options.signal
+	});
+	return {
+		status: "config",
+		configPath: options.configPath,
+		relativeConfigPath: configFilename,
+		settings
+	};
+}
+function normalizeRelativePath(value) {
+	const raw = value.trim().replace(/\\/g, "/");
+	if (raw.length === 0 || raw.split("/").includes("..")) return;
+	if (/^[A-Za-z]:/.test(raw)) return;
+	const normalized = path.posix.normalize(raw);
+	const segments = normalized.split("/");
+	if (path.win32.isAbsolute(value) || path.posix.isAbsolute(normalized) || segments.includes("..")) return;
+	return normalized === "." ? "." : normalized;
+}
+//#endregion
+export { PRISMA_APP_CONFIG_FILENAME, detectLegacyBuildSettings, resolveConfiguredAppBuildSettings, resolveInferredAppBuildSettings };

package/dist/lib/app/build.js

@@ -0,0 +1,82 @@
+import "./build-settings.js";
+import { FRAMEWORKS } from "@prisma/compute-sdk/config";
+import "node:fs/promises";
+import "node:path";
+import { normalizeArtifactSymlinks, resolveBuildStrategy } from "@prisma/compute-sdk";
+//#region src/lib/app/build.ts
+const RESOLVED_APP_BUILD_TYPES = [...frameworkBuildTypesByLastOccurrence()];
+const APP_BUILD_TYPES = ["auto", ...RESOLVED_APP_BUILD_TYPES];
+const APP_BUILD_TYPE_LABELS = APP_BUILD_TYPES.join(", ");
+function frameworkBuildTypesByLastOccurrence() {
+	const buildTypes = /* @__PURE__ */ new Set();
+	for (const framework of FRAMEWORKS) {
+		if (buildTypes.has(framework.buildType)) buildTypes.delete(framework.buildType);
+		buildTypes.add(framework.buildType);
+	}
+	return buildTypes;
+}
+var AppBuildStrategy = class {
+	#appPath;
+	#entrypoint;
+	#buildType;
+	#signal;
+	#buildSettings;
+	constructor(options) {
+		this.#appPath = options.appPath;
+		this.#entrypoint = options.entrypoint;
+		this.#buildType = options.buildType ?? "auto";
+		this.#signal = options.signal;
+		this.#buildSettings = options.buildSettings;
+	}
+	async canBuild(signal = this.#signal) {
+		const { strategy } = await resolveAppBuildStrategy({
+			appPath: this.#appPath,
+			entrypoint: this.#entrypoint,
+			buildType: this.#buildType,
+			signal,
+			buildSettings: this.#buildSettings
+		});
+		return strategy.canBuild(signal);
+	}
+	async execute(signal = this.#signal) {
+		const { artifact } = await executeAppBuild({
+			appPath: this.#appPath,
+			entrypoint: this.#entrypoint,
+			buildType: this.#buildType,
+			signal,
+			buildSettings: this.#buildSettings
+		});
+		return artifact;
+	}
+};
+async function executeAppBuild(options) {
+	const { strategy, buildType } = await resolveAppBuildStrategy({
+		appPath: options.appPath,
+		entrypoint: options.entrypoint,
+		buildType: options.buildType ?? "auto",
+		signal: options.signal,
+		buildSettings: options.buildSettings
+	});
+	const artifact = await strategy.execute(options.signal);
+	try {
+		await normalizeArtifactSymlinks(artifact.directory, options.appPath, options.signal);
+		return {
+			artifact,
+			buildType
+		};
+	} catch (error) {
+		await artifact.cleanup?.().catch(() => void 0);
+		throw error;
+	}
+}
+async function resolveAppBuildStrategy(options) {
+	return resolveBuildStrategy({
+		appPath: options.appPath,
+		buildType: options.buildType,
+		entrypoint: options.entrypoint,
+		buildSettings: options.buildSettings,
+		signal: options.signal
+	});
+}
+//#endregion
+export { APP_BUILD_TYPES, APP_BUILD_TYPE_LABELS, AppBuildStrategy, RESOLVED_APP_BUILD_TYPES, executeAppBuild };

package/dist/lib/app/bun-project.js

@@ -21,13 +21,12 @@ async function readBunPackageJson(appPath, signal) {
 	}
 }
 function readBunPackageEntrypoint(packageJson) {
-	if (typeof packageJson?.main === "string") return packageJson.main;
-	if (typeof packageJson?.module === "string") return packageJson.module;
+	return typeof packageJson?.main === "string" ? packageJson.main : void 0;
 }
 async function resolveBunEntrypoint(appPath, explicitEntrypoint, signal) {
 	const packageJson = await readBunPackageJson(appPath, signal);
 	const candidate = explicitEntrypoint ?? readBunPackageEntrypoint(packageJson);
-	if (!candidate) throw new Error("Entrypoint is required. Pass --entry or define package.json main or module.");
+	if (!candidate) throw new Error("Entrypoint is required. Pass --entry or define package.json main.");
 	if (path.isAbsolute(candidate)) throw new Error("Entrypoint must be a relative path.");
 	const normalized = path.normalize(candidate);
 	if (normalized.startsWith("..") || path.isAbsolute(normalized) || normalized.includes(`${path.sep}..${path.sep}`)) throw new Error("Entrypoint must not escape the app directory.");

package/dist/lib/app/compute-config.js

@@ -0,0 +1,147 @@
+import { CliError } from "../../shell/errors.js";
+import { COMPUTE_CONFIG_FILENAME, COMPUTE_CONFIG_FILENAME as COMPUTE_CONFIG_FILENAME$1, ComputeConfigTargetRequiredError, computeTargetAppDir, frameworkByKey, inferComputeTargetFromCwd, loadComputeConfig, selectComputeDeployTarget } from "@prisma/compute-sdk/config";
+import path from "node:path";
+import { matchError } from "better-result";
+//#region src/lib/app/compute-config.ts
+/**
+* Loads the nearest compute config, searching from `cwd` up to the source
+* root (repository or workspace boundary). Thin adapter over the SDK loader
+* keeping the CLI's positional-signal call shape.
+*/
+async function loadComputeConfig$1(cwd, signal) {
+	return loadComputeConfig(cwd, { signal });
+}
+/** Local build/run strategy implied by a configured framework. */
+function computeFrameworkToBuildType(framework) {
+	return frameworkByKey(framework).buildType;
+}
+function mergeComputeDeployInputs(options) {
+	const { cli, target, configFilename } = options;
+	const configAnnotation = `set by ${configFilename}`;
+	const framework = cli.framework ? {
+		value: cli.framework,
+		annotation: "set by --framework"
+	} : target?.framework ? {
+		value: target.framework,
+		annotation: configAnnotation
+	} : void 0;
+	const entrypoint = cli.entrypoint ? {
+		value: cli.entrypoint,
+		annotation: "set by --entry"
+	} : target?.entry ? {
+		value: target.entry,
+		annotation: configAnnotation
+	} : void 0;
+	const httpPort = cli.httpPort ? {
+		value: cli.httpPort,
+		annotation: "set by --http-port"
+	} : target?.httpPort ? {
+		value: String(target.httpPort),
+		annotation: configAnnotation
+	} : void 0;
+	const cliEnvInputs = cli.envInputs && cli.envInputs.length > 0 ? cli.envInputs : void 0;
+	const configEnvInputs = target && target.envInputs.length > 0 ? target.envInputs : void 0;
+	const envInputs = cliEnvInputs ?? configEnvInputs;
+	const configAppName = target?.name ? {
+		value: target.name,
+		annotation: configAnnotation
+	} : target?.key ? {
+		value: target.key,
+		annotation: configAnnotation
+	} : void 0;
+	return {
+		framework,
+		entrypoint,
+		httpPort,
+		envInputs,
+		envInputsFromConfig: !cliEnvInputs && configEnvInputs !== void 0,
+		configAppName,
+		appRoot: target?.root ?? void 0
+	};
+}
+/**
+* Merges CLI inputs for the local `app build` and `app run` commands with a
+* selected config target. Explicit flags win; `--build-type auto` is the
+* flag default and defers to the configured framework.
+*/
+function mergeComputeLocalInputs(options) {
+	const { cli, target } = options;
+	const cliBuildType = cli.buildType && cli.buildType !== "auto" ? cli.buildType : void 0;
+	const configBuildType = target?.framework ? computeFrameworkToBuildType(target.framework) : void 0;
+	return {
+		entrypoint: cli.entrypoint ?? target?.entry ?? void 0,
+		buildType: cliBuildType ?? configBuildType,
+		buildTypeFromConfig: !cliBuildType && configBuildType !== void 0,
+		port: cli.port ?? (target?.httpPort ? String(target.httpPort) : void 0),
+		appRoot: target?.root ?? void 0
+	};
+}
+function computeConfigErrorToCliError(error, commandName = "deploy") {
+	const command = `prisma-cli app ${commandName}`;
+	return matchError(error, {
+		ComputeConfigAmbiguousError: (ambiguous) => new CliError({
+			code: "COMPUTE_CONFIG_INVALID",
+			domain: "app",
+			summary: "Multiple compute config files found",
+			why: ambiguous.message,
+			fix: `Keep exactly one compute config file, preferably ${COMPUTE_CONFIG_FILENAME}.`,
+			meta: { configPaths: ambiguous.configPaths },
+			exitCode: 2,
+			nextSteps: [command]
+		}),
+		ComputeConfigLoadError: (load) => new CliError({
+			code: "COMPUTE_CONFIG_INVALID",
+			domain: "app",
+			summary: `Could not load ${path.basename(load.configPath)}`,
+			why: load.message,
+			fix: `Fix the error in ${path.basename(load.configPath)} and rerun the command.`,
+			where: load.configPath,
+			meta: { configPath: load.configPath },
+			exitCode: 2,
+			nextSteps: [command]
+		}),
+		ComputeConfigInvalidError: (invalid) => new CliError({
+			code: "COMPUTE_CONFIG_INVALID",
+			domain: "app",
+			summary: `Invalid ${path.basename(invalid.configPath)}`,
+			why: invalid.issues.join(" "),
+			fix: `Edit ${path.basename(invalid.configPath)} so it default-exports defineComputeConfig({ app }) or defineComputeConfig({ apps }).`,
+			where: invalid.configPath,
+			meta: {
+				configPath: invalid.configPath,
+				issues: invalid.issues
+			},
+			exitCode: 2,
+			nextSteps: [command]
+		}),
+		ComputeConfigTargetRequiredError: (required) => new CliError({
+			code: "COMPUTE_CONFIG_TARGET_REQUIRED",
+			domain: "app",
+			summary: "App target required",
+			why: required.message,
+			fix: `Pass the app target, for example ${command} <target>.`,
+			meta: {
+				configPath: required.configPath,
+				availableTargets: required.availableTargets
+			},
+			exitCode: 2,
+			nextSteps: required.availableTargets.map((target) => `${command} ${target}`)
+		}),
+		ComputeConfigTargetUnknownError: (unknown) => new CliError({
+			code: "COMPUTE_CONFIG_TARGET_UNKNOWN",
+			domain: "app",
+			summary: `Unknown app target "${unknown.requestedTarget}"`,
+			why: unknown.message,
+			fix: unknown.availableTargets.length > 0 ? `Pass one of the configured targets: ${unknown.availableTargets.join(", ")}.` : "Remove the target argument; this config defines a single app.",
+			meta: {
+				configPath: unknown.configPath,
+				requestedTarget: unknown.requestedTarget,
+				availableTargets: unknown.availableTargets
+			},
+			exitCode: 2,
+			nextSteps: unknown.availableTargets.length > 0 ? unknown.availableTargets.map((target) => `${command} ${target}`) : [command]
+		})
+	});
+}
+//#endregion
+export { COMPUTE_CONFIG_FILENAME$1 as COMPUTE_CONFIG_FILENAME, ComputeConfigTargetRequiredError, computeConfigErrorToCliError, computeFrameworkToBuildType, computeTargetAppDir, inferComputeTargetFromCwd, loadComputeConfig$1 as loadComputeConfig, mergeComputeDeployInputs, mergeComputeLocalInputs, selectComputeDeployTarget };

package/dist/lib/app/deploy-plan.js

@@ -0,0 +1,58 @@
+//#region src/lib/app/deploy-plan.ts
+/**
+* Decides whether a deploy covers one app or the whole system. A multi-app
+* config with no target named or inferred deploys every target in declaration
+* order; everything else (single-app config, an explicit/inferred target, or
+* no config at all) is a single deploy.
+*/
+function planAppDeploy(options) {
+	const { config, requestedTarget, hasCreateProject } = options;
+	if (!(config !== null && config.kind === "multi" && !requestedTarget && config.targets.length > 1)) return { mode: "single" };
+	const total = config.targets.length;
+	return {
+		mode: "all",
+		targets: config.targets.map((target, index) => ({
+			targetKey: target.key,
+			index,
+			total,
+			bindsCreateProject: index === 0 && hasCreateProject
+		}))
+	};
+}
+/**
+* Names the per-app inputs present in a deploy-all invocation, in the order
+* they should be reported. An empty list means the run is unambiguous; the
+* caller renders the usage error when it is not.
+*/
+function perAppInputsForDeployAll(inputs) {
+	return [
+		["--app", inputs.appName],
+		["--framework", inputs.framework],
+		["--entry", inputs.entrypoint],
+		["--http-port", inputs.httpPort],
+		["--env", inputs.envAssignments?.length ? inputs.envAssignments : void 0],
+		[inputs.appIdEnvVar.name, inputs.appIdEnvVar.value]
+	].filter(([, value]) => value !== void 0).map(([flag]) => flag);
+}
+/**
+* Describes a deploy-all run that stopped at the first failing target: which
+* targets already went live and which were never attempted, so the caller can
+* surface a converge path. Pure; the caller folds this into the CliError.
+*/
+function describeDeployAllFailure(options) {
+	const { targetKeys, failedIndex, completed } = options;
+	const failedTarget = targetKeys[failedIndex];
+	const notAttempted = targetKeys.slice(failedIndex + 1);
+	return {
+		failedTarget,
+		completed,
+		notAttempted,
+		contextLines: [
+			`Deploying all apps stopped at "${failedTarget}" (${failedIndex + 1}/${targetKeys.length}).`,
+			...completed.length > 0 ? [`Already live: ${completed.map((entry) => entry.target).join(", ")}.`] : [],
+			...notAttempted.length > 0 ? [`Not attempted: ${notAttempted.join(", ")}.`] : []
+		]
+	};
+}
+//#endregion
+export { describeDeployAllFailure, perAppInputsForDeployAll, planAppDeploy };

package/dist/lib/app/{preview-progress.js → deploy-progress.js}

@@ -1,6 +1,6 @@
 import { renderDeployOutputRows } from "./deploy-output.js";
-//#region src/lib/app/preview-progress.ts
-function createPreviewDeployProgressState() {
+//#region src/lib/app/deploy-progress.ts
+function createDeployProgressState() {
 	return {
 		buildStarted: false,
 		buildCompleted: false,
@@ -13,7 +13,7 @@ function createPreviewDeployProgressState() {
 		promotedUrl: null
 	};
 }
-function createPreviewDeployProgress(output, ui, enabled, state = createPreviewDeployProgressState()) {
+function createDeployProgress(output, ui, enabled, state = createDeployProgressState()) {
 	const write = (line) => {
 		if (!enabled) return;
 		output.write(`${line}\n`);
@@ -63,7 +63,7 @@ function createPreviewDeployProgress(output, ui, enabled, state = createPreviewD
 function formatArtifactSize(byteLength) {
 	return `${(byteLength / 1024 / 1024).toFixed(1)} MB`;
 }
-function createPreviewPromoteProgress(output, enabled) {
+function createPromoteProgress(output, enabled) {
 	if (!enabled) return;
 	const write = (line) => {
 		output.write(`${line}\n`);
@@ -97,4 +97,4 @@ function createPreviewPromoteProgress(output, enabled) {
 	};
 }
 //#endregion
-export { createPreviewDeployProgress, createPreviewDeployProgressState, createPreviewPromoteProgress };
+export { createDeployProgress, createDeployProgressState, createPromoteProgress };