@geekmidas/cli 10.0.0-alpha.91 → 10.0.0-alpha.93

package/dist/index.cjs

@@ -1,26 +1,29 @@
 #!/usr/bin/env -S npx tsx
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
-const require_credentials = require("./credentials-BKfIugu2.cjs");
-const require_discover = require("./discover-D1It5r_h.cjs");
+const require_errors = require("./errors-DMC4Umsb.cjs");
+const require_credentials = require("./credentials-QBu7VgaQ.cjs");
+const require_discover = require("./discover-DPgu-ScS.cjs");
 const require_derive = require("./derive-DAbo49sm.cjs");
-const require_workspace = require("./workspace-CwW3Gkru.cjs");
+const require_workspace = require("./workspace-CHOB2Xg3.cjs");
 const require_config = require("./config.cjs");
-const require_seeds = require("./seeds-CkIPFGNO.cjs");
-const require_EndpointGenerator = require("./EndpointGenerator-CwLjBCFE.cjs");
+const require_seeds = require("./seeds-c-ByX9je.cjs");
+const require_EndpointGenerator = require("./EndpointGenerator-De03t1hd.cjs");
 const require_openapi = require("./openapi.cjs");
-const require_SubscriberGenerator = require("./SubscriberGenerator-BVn7cQ-2.cjs");
+const require_SubscriberGenerator = require("./SubscriberGenerator-Dvz7EzqK.cjs");
 const require_appPorts = require("./appPorts-Cu79hJF6.cjs");
-const require_drivers = require("./drivers-LYSdQDmd.cjs");
+const require_drivers = require("./drivers-DDojgzz0.cjs");
 const require_emit = require("./emit-Dmc1nvdS.cjs");
-const require_local = require("./local-BjxDfPvy.cjs");
-const require_sniffer = require("./sniffer-IAQEpsQb.cjs");
-const require_deploy = require("./deploy-CuHasEA4.cjs");
-const require_compose = require("./compose-CvpU6ooi.cjs");
-const require_credentialSchemas = require("./credentialSchemas-DCR4Wd1W.cjs");
-const require_LocalStateStore = require("./LocalStateStore-BBeTlRTH.cjs");
+const require_local = require("./local-B61kUh0w.cjs");
+const require_sniffer = require("./sniffer-Dq5BS98f.cjs");
+const require_deploy = require("./deploy-C3Mhnmus.cjs");
+const require_compose = require("./compose-BHVKLluX.cjs");
+const require_stack = require("./stack-1PeLJS2j.cjs");
+const require_credentialSchemas = require("./credentialSchemas-CAPKFkrG.cjs");
+const require_LocalStateStore = require("./LocalStateStore-oX_zxj9V.cjs");
 const require_utils = require("./utils-D2Nk1Nv2.cjs");
-const require_ready = require("./ready-BpNbORRB.cjs");
+require("./awsStore-B5We7bMg.cjs");
+const require_ready = require("./ready-D3PIjx3S.cjs");
 let node_path = require("node:path");
 let commander = require("commander");
 let node_process = require("node:process");
@@ -53,7 +56,7 @@ crypto = require_rolldown_runtime.__toESM(crypto, 1);
 let _geekmidas_constructs_functions = require("@geekmidas/constructs/functions");
 let _geekmidas_constructs_topic = require("@geekmidas/constructs/topic");
 //#region package.json
-var version = "10.0.0-alpha.91";
+var version = "10.0.0-alpha.93";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -64,7 +67,7 @@ var version = "10.0.0-alpha.91";
 * named error instead, and the command decides whether to ask.
 */
 /** A prompt was needed with no terminal to ask at. */
-var PromptNeedsTerminal = class extends Error {
+var PromptNeedsTerminal = class extends require_errors.GkmError {
 	question;
 	instead;
 	constructor(question, instead) {
@@ -136,7 +139,7 @@ const logger$8 = console;
 * Validate Dokploy token by making a test API call
 */
 async function validateDokployToken(endpoint, token) {
-	const { DokployApi } = await Promise.resolve().then(() => require("./sniffer-IAQEpsQb.cjs")).then((n) => n.dokploy_api_exports);
+	const { DokployApi } = await Promise.resolve().then(() => require("./sniffer-Dq5BS98f.cjs")).then((n) => n.dokploy_api_exports);
 	return new DokployApi({
 		baseUrl: endpoint,
 		token
@@ -520,7 +523,7 @@ async function isTrusted(url) {
 	}
 }
 /** The edge has not run, so there is no authority to trust yet. */
-var NoLocalAuthority = class extends Error {
+var NoLocalAuthority = class extends require_errors.GkmError {
 	path;
 	constructor(path) {
 		super(`No local certificate authority at ${path}. It is generated the first time the edge starts, so run "gkm setup" (or "gkm dev") once — and if this project declares no file server, nothing needs one.`);
@@ -529,7 +532,7 @@ var NoLocalAuthority = class extends Error {
 	}
 };
 /** A platform with no trust store this knows how to write to. */
-var UnsupportedPlatform = class extends Error {
+var UnsupportedPlatform = class extends require_errors.GkmError {
 	platform;
 	certificate;
 	constructor(platform, certificate) {
@@ -614,7 +617,7 @@ const SIGNED_IN = [
 	"localstack"
 ];
 /** Nothing has generated this workspace's local logins yet. */
-var NoLocalCredentials = class extends Error {
+var NoLocalCredentials = class extends require_errors.GkmError {
 	workspace;
 	constructor(workspace) {
 		super(`'${workspace}' has no local logins on this machine yet: they are generated the first time gkm dev, gkm test or gkm setup starts its services. Run one of them, then this again.`);
@@ -664,7 +667,7 @@ const DISCOVERY_QUIET_ENV = "GKM_DISCOVERY_QUIET";
 /** The route everything is served under. */
 const BASE = "/__gkm";
 /** `GKM_DISCOVERY_PORT` is set to something that is not a port. */
-var InvalidDiscoveryPort = class extends Error {
+var InvalidDiscoveryPort = class extends require_errors.GkmError {
 	value;
 	constructor(value) {
 		super(`${DISCOVERY_PORT_ENV}=${value} is not a port. Set it to a number from 0 to 65535 (0 serves discovery on a free port of its own), or unset it to use dev.discoveryPort.`);
@@ -1754,7 +1757,7 @@ function closeFakes(served) {
 //#region src/exec/index.ts
 const logger$6 = console;
 /** `gkm exec` was given nothing to run. */
-var NoCommandSpecified = class extends Error {
+var NoCommandSpecified = class extends require_errors.GkmError {
 	constructor() {
 		super("No command specified. Usage: gkm exec -- <command>");
 		this.name = "NoCommandSpecified";
@@ -2330,9 +2333,9 @@ async function workspaceDevCommand(configured, options) {
 	for (const { id, port } of fakes) logger$5.log(`🎭 ${id} fake: http://localhost:${port}`);
 	logger$5.log(options.migrate || options.seed ? "🗄️  Migrating the databases" : "🗄️  Checking for pending migrations");
 	if (options.migrate || options.seed) {
-		const { prepareDevDatabases } = await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs"));
+		const { prepareDevDatabases } = await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs"));
 		await prepareDevDatabases(workspace, reconciled.env, { seed: !!options.seed });
-	} else await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs")).then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
+	} else await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs")).then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
 		logger$5.log(`⚠️  Could not check for pending migrations: ${error instanceof Error ? error.message : String(error)}`);
 	});
 	const appUrls = {};
@@ -2742,7 +2745,7 @@ function tsxCommand(appRoot, args) {
 	}
 }
 /** A port this app must serve on is held by something else. */
-var DevPortInUse = class extends Error {
+var DevPortInUse = class extends require_errors.GkmError {
 	port;
 	holder;
 	constructor(port, holder) {
@@ -2759,7 +2762,7 @@ var DevPortInUse = class extends Error {
 * Only these are refused: a port another project holds is moved off instead
 * (see `assignAppPorts`), but moving off our own would start a second copy.
 */
-var WorkspacePortsInUse = class extends Error {
+var WorkspacePortsInUse = class extends require_errors.GkmError {
 	held;
 	constructor(held) {
 		super(`This workspace's apps are already running:\n${held.map(({ app, port, holder }) => `   ${app}: ${port} — ${require_appPorts.describeHolder(holder)}`).join("\n")}\nA previous \`gkm dev\` left them behind. Stop them (kill the pids above) and start again. Nothing was started.`);
@@ -3216,7 +3219,7 @@ const SUPERSEDED_OUTPUT = [
 function isMainProvider(value) {
 	return value === "aws" || value === "server";
 }
-var UnknownBuildProvider = class extends Error {
+var UnknownBuildProvider = class extends require_errors.GkmError {
 	provider;
 	constructor(provider) {
 		super(`'${provider}' is not a build target. Pass --provider aws or --provider server, or leave it out to build for where gkm.config.ts deploys.`);
@@ -3225,7 +3228,7 @@ var UnknownBuildProvider = class extends Error {
 	}
 };
 /** `--cache` named something that is not a cache backend. */
-var UnknownCacheBackend = class extends Error {
+var UnknownCacheBackend = class extends require_errors.GkmError {
 	backend;
 	constructor(backend) {
 		super(`'${backend}' is not a cache backend. Pass --cache upstash, elasticache, db or redis, or leave it out to register the deploy target's.`);
@@ -3385,7 +3388,7 @@ async function buildApp(input) {
 				...production,
 				...telemetry ? { telemetry } : {}
 			});
-			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-BQJiB7Ub.cjs"));
+			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Dfsr6KXU.cjs"));
 			await bundleServer({
 				entryPoint,
 				outputDir: (0, node_path.join)(outputDir, "dist"),
@@ -3530,7 +3533,7 @@ async function buildWorkers(input) {
 		});
 		logger$4.log(`Generated worker ${worker.id}: ${crons.length} crons, ${queues.length} queues, ${subscribers.length} subscribers`);
 		if (!input.bundle) continue;
-		const { bundleServer } = await Promise.resolve().then(() => require("./bundler-BQJiB7Ub.cjs"));
+		const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Dfsr6KXU.cjs"));
 		const outfile = require_seeds.workerBundleName(worker.id);
 		await bundleServer({
 			entryPoint,
@@ -3616,7 +3619,7 @@ async function buildForTarget(target, context, appRoot, workspaceRoot, endpointG
 		let masterKey;
 		if (context.production?.bundle && !skipBundle) {
 			logger$4.log(`\n📦 Bundling production server...`);
-			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-BQJiB7Ub.cjs"));
+			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Dfsr6KXU.cjs"));
 			const allConstructs = [
 				...endpoints.map((e) => e.construct),
 				...functions.map((f) => f.construct),
@@ -3854,7 +3857,7 @@ function formatRoutes(routes) {
 * `deploy()` as any other target, so there is one way a stack comes up.
 */
 /** `--build` and `--pull` together ask for two different things. */
-var ComposeModeConflict = class extends Error {
+var ComposeModeConflict = class extends require_errors.GkmError {
 	constructor() {
 		super("--build and --pull ask for opposite things: build images from this checkout, or pull a tag CI pushed. Pass one of them.");
 		this.name = "ComposeModeConflict";
@@ -3862,7 +3865,7 @@ var ComposeModeConflict = class extends Error {
 };
 /** Each pushed image as `<ref>@sha256:…`, by app. */
 function pushedDigests(run) {
-	return Object.fromEntries(Object.entries(run.images).filter(([, image]) => image.digest).sort(([a], [b]) => a.localeCompare(b)).map(([app, image]) => [app, require_compose.pinnedRef(image.ref, image.digest)]));
+	return Object.fromEntries(Object.entries(run.images).filter(([, image]) => image.digest).sort(([a], [b]) => a.localeCompare(b)).map(([app, image]) => [app, require_stack.pinnedRef(image.ref, image.digest)]));
 }
 /** `gkm compose`. */
 async function composeCommand(options, deps = {}) {
@@ -3876,12 +3879,12 @@ async function composeCommand(options, deps = {}) {
 	if (options.down) {
 		const override = require_compose.stackOverrideFile(workspace.root, stage);
 		const ref = {
-			project: require_compose.composeProject(require_seeds.deployIdentity(workspace, stage)),
-			file: (0, node_path.join)(workspace.root, require_compose.stackDir(stage), "docker-compose.yml"),
+			project: require_stack.composeProject(require_seeds.deployIdentity(workspace, stage)),
+			file: (0, node_path.join)(workspace.root, require_stack.stackDir(stage), "docker-compose.yml"),
 			...(0, node_fs.existsSync)(override) ? { overrides: [override] } : {},
 			cwd: workspace.root
 		};
-		if (await require_compose.removeEdgeRoutes(require_compose.edgeDir(deps.env ?? process.env), ref.project)) console.log(`🌐 Removed ${ref.project}'s routes from ${require_compose.EDGE_PROJECT}.`);
+		if (await require_compose.removeEdgeRoutes(require_compose.edgeDir(deps.env ?? process.env), ref.project)) console.log(`🌐 Removed ${ref.project}'s routes from ${require_stack.EDGE_PROJECT}.`);
 		await (deps.docker ?? require_compose.dockerCompose).down(ref);
 		console.log(`🛑 Stopped ${ref.project}. Its volumes are kept.`);
 		return;
@@ -3891,7 +3894,7 @@ async function composeCommand(options, deps = {}) {
 	const tag = options.tag ?? (options.pull ? "latest" : void 0);
 	const pin = options.digestsFile && pulls ? {
 		file: options.digestsFile,
-		digests: require_compose.parseDigests(options.digestsFile, await (0, node_fs_promises.readFile)((0, node_path.resolve)(cwd, options.digestsFile), "utf-8"))
+		digests: require_stack.parseDigests(options.digestsFile, await (0, node_fs_promises.readFile)((0, node_path.resolve)(cwd, options.digestsFile), "utf-8"))
 	} : void 0;
 	const result = await require_deploy.deploy({
 		cwd,
@@ -3936,12 +3939,37 @@ async function composeCommand(options, deps = {}) {
 		deploy: result
 	};
 }
+//#endregion
+//#region src/debug.ts
+let _debug = false;
+/**
+* Enable debug mode globally.
+* When enabled, verbose error details are shown everywhere.
+*/
+function enableDebug() {
+	_debug = true;
+}
+/**
+* Check if debug mode is active.
+* Activated by `--debug` flag or `GKM_DEBUG=1` env var.
+*/
+function isDebug() {
+	return _debug || process.env.GKM_DEBUG === "1";
+}
 /**
 * Format a fatal error for display.
-* Always includes the full stack trace since these are process-ending errors.
+*
+* An error gkm raised on purpose ({@link isGkmError}) is `Name: message` —
+* its message is the answer, and a stack would only point into gkm. Anything
+* else is unexpected, and prints its stack and every cause beneath it. Debug
+* mode prints the stack of both.
 */
 function formatError(error) {
 	if (!(error instanceof Error)) return String(error);
+	if (require_errors.isGkmError(error) && !isDebug()) {
+		const cause = error.cause;
+		return cause === void 0 ? `${error.name}: ${error.message}` : `${error.name}: ${error.message}\n\nCaused by: ${cause instanceof Error ? `${cause.name}: ${cause.message}` : String(cause)}`;
+	}
 	let output = error.stack ?? error.message;
 	let cause = error.cause;
 	while (cause) if (cause instanceof Error) {
@@ -3953,6 +3981,14 @@ function formatError(error) {
 	}
 	return output;
 }
+/**
+* End a command that failed: print the error ({@link formatError}) on stderr
+* and exit 1. What every command's action does with what it throws.
+*/
+function exitWithError(error) {
+	console.error(formatError(error));
+	process.exit(1);
+}
 //#endregion
 //#region src/deploy/init.ts
 const logger$3 = console;
@@ -4104,6 +4140,7 @@ const MASKED = "********";
 */
 function maskStateSecrets(state) {
 	const masked = structuredClone(state);
+	if (masked.provider !== "dokploy") return masked;
 	for (const credentials of Object.values(masked.appCredentials ?? {})) credentials.dbPassword = MASKED;
 	for (const secrets of Object.values(masked.generatedSecrets ?? {})) for (const name of Object.keys(secrets)) secrets[name] = MASKED;
 	if (masked.backups) {
@@ -4159,6 +4196,7 @@ async function stateShowCommand(options) {
 	if (options.json) console.log(JSON.stringify(state, null, 2));
 	else {
 		printStateDetails(state);
+		printDnsRecords(stored.resources);
 		printUnfinished(stored.resources);
 	}
 }
@@ -4203,8 +4241,8 @@ async function stateDiffCommand(options) {
 	if (!remote) console.log("Remote: (none)");
 	else console.log(`Remote: Last deployed ${remote.lastDeployedAt}`);
 	console.log("");
-	const localApps = local?.applications ?? {};
-	const remoteApps = remote?.applications ?? {};
+	const localApps = dokploy(local)?.applications ?? {};
+	const remoteApps = dokploy(remote)?.applications ?? {};
 	const allApps = /* @__PURE__ */ new Set([...Object.keys(localApps), ...Object.keys(remoteApps)]);
 	if (allApps.size > 0) {
 		console.log("Applications:");
@@ -4217,8 +4255,8 @@ async function stateDiffCommand(options) {
 			else console.log(`  ${app}: ${localId} (local) != ${remoteId} (remote) [MISMATCH]`);
 		}
 	}
-	const localServices = local?.services ?? {};
-	const remoteServices = remote?.services ?? {};
+	const localServices = dokploy(local)?.services ?? {};
+	const remoteServices = dokploy(remote)?.services ?? {};
 	if (Object.keys(localServices).length > 0 || Object.keys(remoteServices).length > 0) {
 		console.log("\nServices:");
 		const serviceKeys = /* @__PURE__ */ new Set([...Object.keys(localServices), ...Object.keys(remoteServices)]);
@@ -4283,6 +4321,10 @@ async function copyStage(from, to, stage) {
 	for (const { updatedAt: _stamped, ...record } of Object.values(source.resources)) version = await to.putResource(stage, record, { expectedVersion: version });
 	return source;
 }
+/** `state` if Dokploy wrote it — the only shape with ids of its own. */
+function dokploy(state) {
+	return state?.provider === "dokploy" ? state : null;
+}
 function describeRecord(record) {
 	if (!record) return "(none)";
 	return record.id ? `${record.status} ${record.id}` : record.status;
@@ -4296,6 +4338,12 @@ function printUnfinished(resources) {
 	for (const record of pending) console.log(`  ${record.key}`);
 }
 function printStateSummary(state) {
+	if (state.provider !== "dokploy") {
+		console.log(`  Stage: ${state.stage} (${state.provider})`);
+		console.log(`  Apps released: ${Object.keys(state.releases ?? {}).length}`);
+		console.log(`  Last deployed: ${state.lastDeployedAt}`);
+		return;
+	}
 	const appCount = Object.keys(state.applications).length;
 	const hasPostgres = !!state.services.postgresId;
 	const hasRedis = !!state.services.redisId;
@@ -4306,6 +4354,14 @@ function printStateSummary(state) {
 	console.log(`  Last deployed: ${state.lastDeployedAt}`);
 }
 function printStateDetails(state) {
+	if (state.provider !== "dokploy") {
+		console.log(`Stage: ${state.stage} (${state.provider})`);
+		console.log(`Last Deployed: ${state.lastDeployedAt}`);
+		if (state.identity) console.log(`Identity: ${state.identity}`);
+		console.log("");
+		printReleases(state.releases);
+		return;
+	}
 	console.log(`Stage: ${state.stage}`);
 	console.log(`Environment ID: ${state.environmentId}`);
 	console.log(`Last Deployed: ${state.lastDeployedAt}`);
@@ -4347,6 +4403,62 @@ function printStateDetails(state) {
 		for (const [hostname, info] of Object.entries(state.dnsVerified)) console.log(`  ${hostname}: ${info.serverIp} (${info.verifiedAt})`);
 	}
 }
+/** Each app's current release, and who released it. */
+function printReleases(releases) {
+	console.log("Releases:");
+	const apps = Object.entries(releases ?? {});
+	if (apps.length === 0) {
+		console.log("  (none)");
+		return;
+	}
+	for (const [app, { current }] of apps) console.log(`  ${app}: ${describeRelease(current)}`);
+}
+/** `ghcr.io/acme/api:v2 (sha256:…) · 2026-… · ada@laptop` */
+function describeRelease(release) {
+	return [
+		`${release.ref}${release.digest ? ` (${release.digest})` : ""}`,
+		release.releasedAt,
+		require_seeds.describeActor(release.releasedBy)
+	].join(" · ");
+}
+/** The DNS records gkm wrote for the stage. */
+function printDnsRecords(resources) {
+	const records = require_seeds.dnsResources(resources);
+	if (records.length === 0) return;
+	console.log("");
+	console.log("DNS Records:");
+	for (const record of records) console.log(`  ${record.fqdn} ${record.type} ${record.value} (TTL ${record.ttl}${record.provider ? `, ${record.provider}` : ""})`);
+}
+/**
+* Who wrote a stage's state, newest first, and what each app runs.
+* `gkm state:history --stage=<stage>`
+*/
+async function stateHistoryCommand(options) {
+	const { workspace } = await require_config.loadWorkspaceConfig();
+	const stored = await (await require_seeds.createStateStore({
+		config: workspace.state,
+		workspaceRoot: workspace.root,
+		workspaceName: workspace.name
+	})).read(options.stage);
+	if (!stored) {
+		console.log(`No state found for stage: ${options.stage}`);
+		return;
+	}
+	const history = {
+		stage: options.stage,
+		history: stored.history,
+		releases: Object.fromEntries(Object.entries(stored.state.releases ?? {}).map(([app, releases]) => [app, releases.current]))
+	};
+	if (options.json) {
+		console.log(JSON.stringify(history, null, 2));
+		return;
+	}
+	console.log(`History of stage ${options.stage} (newest first):`);
+	if (history.history.length === 0) console.log("  (none recorded)");
+	for (const entry of history.history) console.log(`  ${entry.serial} · ${entry.at} · ${require_seeds.describeActor(entry.by)} · ${entry.operation}`);
+	console.log("");
+	printReleases(stored.state.releases);
+}
 //#endregion
 //#region src/secrets/generator.ts
 /**
@@ -5318,25 +5430,25 @@ function loadPackageJson() {
 * Run: pnpm --filter @geekmidas/cli sync-versions
 */
 const GEEKMIDAS_VERSIONS = {
-	"@geekmidas/audit": "~10.0.0-alpha.91",
-	"@geekmidas/auth": "~10.0.0-alpha.91",
-	"@geekmidas/cache": "~10.0.0-alpha.91",
-	"@geekmidas/client": "~10.0.0-alpha.91",
-	"@geekmidas/cloud": "~10.0.0-alpha.91",
-	"@geekmidas/constructs": "~10.0.0-alpha.91",
-	"@geekmidas/db": "~10.0.0-alpha.91",
-	"@geekmidas/emailkit": "~10.0.0-alpha.91",
-	"@geekmidas/envkit": "~10.0.0-alpha.91",
-	"@geekmidas/errors": "~10.0.0-alpha.91",
-	"@geekmidas/events": "~10.0.0-alpha.91",
-	"@geekmidas/logger": "~10.0.0-alpha.91",
-	"@geekmidas/manifest": "~10.0.0-alpha.91",
-	"@geekmidas/rate-limit": "~10.0.0-alpha.91",
-	"@geekmidas/schema": "~10.0.0-alpha.91",
-	"@geekmidas/services": "~10.0.0-alpha.91",
-	"@geekmidas/storage": "~10.0.0-alpha.91",
-	"@geekmidas/telescope": "~10.0.0-alpha.91",
-	"@geekmidas/testkit": "~10.0.0-alpha.91",
+	"@geekmidas/audit": "~10.0.0-alpha.93",
+	"@geekmidas/auth": "~10.0.0-alpha.93",
+	"@geekmidas/cache": "~10.0.0-alpha.93",
+	"@geekmidas/client": "~10.0.0-alpha.93",
+	"@geekmidas/cloud": "~10.0.0-alpha.93",
+	"@geekmidas/constructs": "~10.0.0-alpha.93",
+	"@geekmidas/db": "~10.0.0-alpha.93",
+	"@geekmidas/emailkit": "~10.0.0-alpha.93",
+	"@geekmidas/envkit": "~10.0.0-alpha.93",
+	"@geekmidas/errors": "~10.0.0-alpha.93",
+	"@geekmidas/events": "~10.0.0-alpha.93",
+	"@geekmidas/logger": "~10.0.0-alpha.93",
+	"@geekmidas/manifest": "~10.0.0-alpha.93",
+	"@geekmidas/rate-limit": "~10.0.0-alpha.93",
+	"@geekmidas/schema": "~10.0.0-alpha.93",
+	"@geekmidas/services": "~10.0.0-alpha.93",
+	"@geekmidas/storage": "~10.0.0-alpha.93",
+	"@geekmidas/telescope": "~10.0.0-alpha.93",
+	"@geekmidas/testkit": "~10.0.0-alpha.93",
 	"@geekmidas/cli": `~${loadPackageJson().version}`
 };
 //#endregion
@@ -5737,7 +5849,7 @@ const COMMIT = /^[0-9a-f]{40}$/;
 * The `uses:` value for the stages action, with a comment saying which CLI
 * release the pinned commit is.
 */
-function stagesActionUses(commit = "b0922ee71407fefc3e94a0352793ef5e78c1bdea", version = cliVersion()) {
+function stagesActionUses(commit = "a619ff213e362417b184dff08c8175a86f5d9d07", version = cliVersion()) {
 	return commit && COMMIT.test(commit) ? `${STAGES_ACTION}@${commit} # @geekmidas/cli ${version}` : `${STAGES_ACTION}@main # pin to a commit SHA: see the action's README`;
 }
 //#endregion
@@ -7248,7 +7360,7 @@ ${inputs.join("\n")}
 * An SST scaffold asked for without a region. `init` always resolves one —
 * asked, `--region`, or eu-west-1 under `--yes` — so this is a caller's bug.
 */
-var SstNeedsRegion = class extends Error {
+var SstNeedsRegion = class extends require_errors.GkmError {
 	constructor() {
 		super("An SST deploy needs a region: pass --region, e.g. eu-west-1.");
 		this.name = "SstNeedsRegion";
@@ -10688,7 +10800,7 @@ function resolveStages(options, answers) {
 	return stages;
 }
 /** `--deploy` naming a target init has no scaffold for. */
-var UnknownDeployTarget = class extends Error {
+var UnknownDeployTarget = class extends require_errors.GkmError {
 	target;
 	known;
 	constructor(target, known) {
@@ -10707,7 +10819,7 @@ function defaultRegistry(name) {
 	return `ghcr.io/${(name ?? "my-org").toLowerCase()}`;
 }
 /** `--region` that is not shaped like one, e.g. `europe` for `eu-west-1`. */
-var NotAnAwsRegion = class extends Error {
+var NotAnAwsRegion = class extends require_errors.GkmError {
 	region;
 	constructor(region) {
 		super(`"${region}" is not an AWS region. Use one like eu-west-1.`);
@@ -10837,7 +10949,7 @@ async function secretsSetCommand(key, value, options) {
 	logger$2.log(`\n✓ Secret "${key}" set for stage "${stage}" (${store.name})`);
 }
 /** `gkm secrets:unset` for a key the stage does not hold. */
-var SecretNotSet = class extends Error {
+var SecretNotSet = class extends require_errors.GkmError {
 	key;
 	stage;
 	constructor(key, stage) {
@@ -10848,7 +10960,7 @@ var SecretNotSet = class extends Error {
 	}
 };
 /** `gkm secrets:unset` on a stage that has no secrets at all. */
-var StageSecretsNotFound = class extends Error {
+var StageSecretsNotFound = class extends require_errors.GkmError {
 	stage;
 	constructor(stage) {
 		super(`The stage '${stage}' has no secrets, so there is nothing to remove.`);
@@ -11019,138 +11131,8 @@ function maskUrl(url) {
 	}
 }
 //#endregion
-//#region src/providers/dns.ts
-/** Whether the workspace deploys through the compose target. */
-function deploysWithCompose(workspace) {
-	return workspace.deploy?.default === "compose" || Object.values(workspace.apps).some((app) => app.resolvedDeployTarget === "compose");
-}
-/**
-* A compose stage that serves a domain has its server's address in its
-* secrets — checked before `gkm setup --stage` does anything else.
-*
-* @throws {ServerAddressMissing} for a compose stage with a domain and none
-* @throws {ServerAddressInvalid} for a value that is not an address
-*/
-function assertStageServer(workspace, stage, secrets) {
-	if (stage === workspace.stages.local) return void 0;
-	if (!deploysWithCompose(workspace)) return require_compose.serverAddress(stage, secrets?.custom);
-	return require_compose.requiredServerAddress(stage, workspace.domains?.[stage], secrets?.custom);
-}
-/**
-* The hosts a compose stage serves: its stack composed as a deploy would —
-* with the secrets it would generate made up in memory, never written — and
-* every route's host read off it.
-*/
-async function composeStageHosts(options) {
-	const { workspace, stage } = options;
-	const runnables = options.runnables ?? {};
-	const background = options.background ?? {};
-	const manifest = options.manifest ?? await require_discover.discover({
-		patterns: require_seeds.constructGlobs(workspace),
-		cwd: workspace.root,
-		runnables,
-		background
-	});
-	const stored = await (await require_seeds.secretsStoreFor(workspace, stage, {
-		...options.profile ? { profile: options.profile } : {},
-		...options.home ? { home: options.home } : {}
-	})).read(stage);
-	const { deployedStackSecrets } = await Promise.resolve().then(() => require("./compose-CvpU6ooi.cjs")).then((n) => n.secrets_exports);
-	const { composeStack } = await Promise.resolve().then(() => require("./compose-CvpU6ooi.cjs")).then((n) => n.stack_exports);
-	const { secrets } = deployedStackSecrets(workspace, stage, stored, manifest);
-	const stack = composeStack({
-		workspace,
-		manifest,
-		runnables,
-		background,
-		stage,
-		identity: require_seeds.deployIdentity(workspace, stage),
-		images: {
-			mode: "pull",
-			tag: "dns",
-			...workspace.deploy?.registry ? { registry: workspace.deploy.registry } : {}
-		},
-		secrets,
-		buildOnly: true,
-		allowDevServices: true
-	});
-	return require_compose.stackHosts(stack);
-}
-/**
-* `GKM_SERVER_IPV4` from the stage's secrets and `dns`: each public host's
-* records, created or corrected. A dry run reads and prints, and writes
-* nothing.
-*/
-async function provisionStageDns(options) {
-	const { workspace, stage } = options;
-	const log = options.log ?? ((line) => console.log(line));
-	if (stage === workspace.stages.local || !workspace.dns || !deploysWithCompose(workspace)) return {
-		mode: "none",
-		hosts: [],
-		changes: []
-	};
-	const store = await require_seeds.secretsStoreFor(workspace, stage, {
-		...options.profile ? { profile: options.profile } : {},
-		...options.home ? { home: options.home } : {}
-	});
-	const server = require_compose.serverAddress(stage, (await store.read(stage))?.custom);
-	if (!server) {
-		log(`\n🌐 DNS for '${stage}': no GKM_SERVER_IPV4 in its secrets, so no records — ${require_compose.serverAddressHint(stage)}`);
-		return {
-			mode: "none",
-			hosts: [],
-			changes: []
-		};
-	}
-	const hosts = [...options.hosts ?? await composeStageHosts({
-		workspace,
-		stage,
-		...options.profile ? { profile: options.profile } : {},
-		...options.home ? { home: options.home } : {},
-		...options.manifest ? { manifest: options.manifest } : {},
-		...options.runnables ? { runnables: options.runnables } : {},
-		...options.background ? { background: options.background } : {}
-	})];
-	log(`\n🌐 DNS for '${stage}' → ${server.ipv4}${server.ipv6 ? ` / ${server.ipv6}` : ""}${options.dryRun ? " (dry run — nothing is written)" : ""}`);
-	const plan = require_compose.planStackDns({
-		stage,
-		hosts,
-		server,
-		dns: workspace.dns
-	});
-	try {
-		return {
-			mode: "records",
-			hosts,
-			changes: await require_compose.applyStackDns(plan, {
-				...options.dryRun ? { dryRun: true } : {},
-				log,
-				credentials: {
-					env: options.env ?? process.env,
-					...options.home ? { home: options.home } : {},
-					log
-				},
-				...options.providerFor ? { providerFor: options.providerFor } : {}
-			})
-		};
-	} catch (error) {
-		if (error instanceof require_credentials.MissingCredential) {
-			log(`   ⚠ ${error.message}`);
-			log("   Until then, create these records yourself:");
-			for (const domain of plan.domains) for (const r of domain.records) log(`     ${r.host.padEnd(32)} ${r.type.padEnd(5)} ${r.value}  (TTL ${r.ttl})`);
-			return {
-				mode: "records",
-				hosts,
-				changes: []
-			};
-		}
-		throw error;
-	}
-}
-//#endregion
 //#region src/setup/index.ts
 var setup_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
-	StageSecretsUnreadable: () => StageSecretsUnreadable,
 	createFreshWorkspaceSecrets: () => createFreshWorkspaceSecrets,
 	ensureStageSecrets: () => ensureStageSecrets,
 	reconcileSecrets: () => reconcileSecrets,
@@ -11182,7 +11164,10 @@ async function setupCommand(options = {}) {
 	logger$1.log(`📦 Workspace: ${workspace.name}`);
 	logger$1.log(`📱 Apps: ${Object.keys(workspace.apps).join(", ")}`);
 	logger$1.log(`🔑 Stage: ${stage}\n`);
-	if (!local) assertStageServer(workspace, stage, await readStageSecrets(await require_seeds.secretsStoreFor(workspace, stage, { ...options.profile ? { profile: options.profile } : {} }), stage, options));
+	if (!local) {
+		const store = await require_seeds.secretsStoreFor(workspace, stage, { ...options.profile ? { profile: options.profile } : {} });
+		require_seeds.assertStageServer(workspace, stage, await store.read(stage));
+	}
 	if (!local && options.dryRun) {
 		await provisionDeployed(workspace, stage, options);
 		return;
@@ -11201,48 +11186,6 @@ async function setupCommand(options = {}) {
 	}
 	printSummary(workspace, stage);
 }
-/** Where each AWS store keeps a stage's secrets, as a person reads it. */
-const AWS_STORES = {
-	ssm: "SSM Parameter Store",
-	"secrets-manager": "Secrets Manager"
-};
-/**
-* A deployed stage's secrets are kept in its AWS account, and no AWS
-* credentials were found to read them with.
-*
-* Raised before any provider runs: even a dry run reads the stage's secrets,
-* since its plan needs the server they name (`GKM_SERVER_IPV4`).
-*/
-var StageSecretsUnreadable = class extends Error {
-	stage;
-	store;
-	profile;
-	dryRun;
-	constructor(stage, store, profile, dryRun, cause) {
-		const where = AWS_STORES[store] ?? `the '${store}' store`;
-		const command = `gkm setup --stage ${stage}${dryRun ? " --dry-run" : ""}`;
-		super(`The '${stage}' stage's secrets are kept in ${where}, in the stage's AWS account, and ` + (profile ? `the AWS profile '${profile}' has no credentials to read them with. Sign in to it (aws sso login --profile ${profile}) or name another: ${command} --profile <profile>.` : `no AWS credentials were found to read them with. Name the account's profile: ${command} --profile <profile>, or AWS_PROFILE=<profile> ${command}.`) + (dryRun ? " A dry run still reads them: its plan needs the server the stage names (GKM_SERVER_IPV4)." : ""), { cause });
-		this.stage = stage;
-		this.store = store;
-		this.profile = profile;
-		this.dryRun = dryRun;
-		this.name = "StageSecretsUnreadable";
-	}
-};
-/**
-* The stage's secrets from its store, refused with
-* {@link StageSecretsUnreadable} when there are no AWS credentials to read
-* them — matched by the SDK's error name, its message being free to change.
-* Any other failure is the store's own, and passes through.
-*/
-async function readStageSecrets(store, stage, options) {
-	try {
-		return await store.read(stage);
-	} catch (error) {
-		if (error?.name === "CredentialsProviderError") throw new StageSecretsUnreadable(stage, store.name, options.profile, options.dryRun === true, error);
-		throw error;
-	}
-}
 /**
 * A deployed stage's providers: each one's `ensure()`, in the stage's own
 * account, its keys written into the stage's secrets.
@@ -11259,7 +11202,7 @@ async function provisionDeployed(workspace, stage, options) {
 		log: (line) => logger$1.log(line)
 	})).filter((r) => r.mode === "provider");
 	if (configured.length === 0) logger$1.log(`   None configured: '${stage}' takes every key from its secrets (gkm secrets:add --stage ${stage}). Name one in gkm.config.ts — deploy: { objects: { ${stage}: { provider: 's3' } } } — to have ${require_seeds.provisionCommand(stage)} create it.`);
-	const dns = await provisionStageDns({
+	const dns = await require_seeds.provisionStageDns({
 		workspace,
 		stage,
 		...options.dryRun ? { dryRun: true } : {},
@@ -11485,7 +11428,7 @@ async function readReady(path) {
 	}
 }
 /** A name recorded for the test stage without the test stage's suffix. */
-var NotATestDatabase = class extends Error {
+var NotATestDatabase = class extends require_errors.GkmError {
 	database;
 	constructor(database) {
 		super(`Refusing to drop '${database}': only the test stage's databases (named '…_${require_workspace.TEST_STAGE}') are dropped after a suite. Delete ${require_ready.TEST_READY_FILE} if it was edited by hand.`);
@@ -11622,8 +11565,8 @@ function testDatabases(reconciled) {
 * starts without the reference data the app needs.
 */
 async function migrateTestStage(workspace, env) {
-	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs"));
-	const { discover } = await Promise.resolve().then(() => require("./discover-D1It5r_h.cjs")).then((n) => n.discover_exports);
+	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs"));
+	const { discover } = await Promise.resolve().then(() => require("./discover-DPgu-ScS.cjs")).then((n) => n.discover_exports);
 	const sources = {};
 	const manifest = await discover({
 		patterns: require_seeds.constructGlobs(workspace),
@@ -11641,7 +11584,7 @@ async function migrateTestStage(workspace, env) {
 	for (const { target, seeded } of seeds) if (seeded.length > 0) console.log(`  🌱 ${target.seeds}: ran ${seeded.join(", ")}`);
 }
 /** `gkm test` outside a project that declares stages, with none named. */
-var NoStageToTest = class extends Error {
+var NoStageToTest = class extends require_errors.GkmError {
 	constructor() {
 		super("No stage to test with: add `stages` to gkm.config.ts, or pass --stage.");
 		this.name = "NoStageToTest";
@@ -11909,7 +11852,7 @@ function install(pm, cwd) {
 	}
 }
 /** npm did not answer for a package, so there is no version to compare. */
-var RegistryUnavailable = class extends Error {
+var RegistryUnavailable = class extends require_errors.GkmError {
 	packageName;
 	status;
 	constructor(packageName, status) {
@@ -11920,7 +11863,7 @@ var RegistryUnavailable = class extends Error {
 	}
 };
 /** A dist-tag npm does not have, e.g. `--tag beta` before any beta. */
-var NoReleaseOnTag = class extends Error {
+var NoReleaseOnTag = class extends require_errors.GkmError {
 	tag;
 	tags;
 	constructor(tag, tags) {
@@ -11931,7 +11874,7 @@ var NoReleaseOnTag = class extends Error {
 	}
 };
 /** The line asked for is behind what is installed; upgrade never goes back. */
-var WouldDowngrade = class extends Error {
+var WouldDowngrade = class extends require_errors.GkmError {
 	installed;
 	tag;
 	target;
@@ -11956,7 +11899,7 @@ var InstallFailed = class extends Error {
 //#region src/index.ts
 const program = new commander.Command();
 program.name("gkm").description("GeekMidas backend framework CLI").version(version).option("--cwd <path>", "Change working directory").option("--debug", "Enable debug mode (verbose errors with stack traces)").hook("preAction", () => {
-	if (program.opts().debug);
+	if (program.opts().debug) enableDebug();
 });
 program.command("init").description("Scaffold a new project").argument("[name]", "Project name").option("--template <template>", "Project template (minimal, api, serverless, worker)").option("--skip-install", "Skip dependency installation", false).option("-y, --yes", "Skip prompts, use defaults", false).option("--monorepo", "Setup as monorepo with packages/models", false).option("--api-path <path>", "API app path in monorepo (default: apps/api)").option("--pm <manager>", "Package manager (pnpm, npm, yarn, bun)").option("--deploy <target>", "Where it deploys (dokploy, compose, sst, none)").option("--region <region>", "AWS region for an SST deploy (e.g. eu-west-1)").option("--registry <registry>", "Container registry for a compose deploy (e.g. ghcr.io/acme)").option("--stages <names>", "Deployed stages, comma-separated (e.g. staging,prod)").option("--protected-stage <name>", "Which deployed stage is production").option("--local-stage <name>", "What gkm dev runs as (e.g. dev)").action(async (name, options) => {
 	try {
@@ -11964,8 +11907,7 @@ program.command("init").description("Scaffold a new project").argument("[name]",
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await initCommand(name, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("trust").description("Trust the local edge's certificate authority, so a browser accepts https").option("--dry-run", "Print the commands instead of running them").action(async (options) => {
@@ -11974,8 +11916,7 @@ program.command("trust").description("Trust the local edge's certificate authori
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await trustCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("setup").description("Reconcile declared constructs — locally, containers and secrets; on a deployed stage, its providers (deploy.objects)").option("--stage <stage>", "Stage name (default: stages.local)").option("--force", "Regenerate secrets even if they exist").option("--skip-docker", "Skip starting Docker services").option("-y, --yes", "Skip prompts").option("--dry-run", "A deployed stage: print what its providers would create or change, and write nothing").option("--profile <profile>", "AWS profile for the stage's account").option("--rotate-keys", "A deployed stage: issue each provisioned key a successor (the old one is deleted after the next deploy)").option("--retire-old-keys", "A deployed stage: delete a rotated-out key now instead of after the next deploy").action(async (options) => {
@@ -11984,8 +11925,7 @@ program.command("setup").description("Reconcile declared constructs — locally,
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await setupCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("build").description("Build handlers and the manifest from declared constructs").option("--provider <provider>", "Build for aws or server (default: where gkm.config.ts deploys)").option("--enable-openapi", "Enable OpenAPI documentation generation for server builds").option("--production", "Build for production (no dev tools, bundled output)").option("--skip-bundle", "Skip bundling step in production build").option("--stage <stage>", "Inject encrypted secrets for deployment stage").option("--mark-optional", "Suffix optional env vars with ? in manifest envVars field (e.g. PORT?)").addOption(new commander.Option("--cache <backend>", "Register the drivers for this cache backend rather than the target default").hideHelp()).action(async (options) => {
@@ -12004,8 +11944,7 @@ program.command("build").description("Build handlers and the manifest from decla
 			markOptional: options.markOptional || false
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("dev").description("Reconcile constructs and start the dev server with automatic reload").option("-p, --port <port>", "Port to run the development server on").option("--entry <file>", "Entry file to run (bypasses gkm config)").option("--watch", "Watch for file changes (default: true with --entry)").option("--no-watch", "Disable file watching").option("--enable-openapi", "Enable OpenAPI documentation for development server", true).option("--migrate", "Apply pending migrations before the apps start").option("--seed", "Migrate, then run the seeds, before the apps start").option("--fake", "Call each external API’s fake (test/fakes/<id>.ts) instead of the provider").option("--no-subscribers", "Run no topic subscribers: nothing is subscribed, polled or pushed to").action(async (options) => {
@@ -12024,8 +11963,7 @@ program.command("dev").description("Reconcile constructs and start the dev serve
 			subscribers: options.subscribers
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("dev:credentials").description("Print each local service's address and login — Postgres, MinIO, Mailpit, Redis, … — without starting anything").option("--json", "Print them as JSON, for a script").action(async (options) => {
@@ -12035,8 +11973,7 @@ program.command("dev:credentials").description("Print each local service's addre
 		const { devCredentialsCommand } = await Promise.resolve().then(() => credentials_exports);
 		await devCredentialsCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("exec").description("Run a command with secrets injected into Credentials").argument("<command...>", "Command to run (use -- before command)").action(async (commandArgs) => {
@@ -12045,8 +11982,7 @@ program.command("exec").description("Run a command with secrets injected into Cr
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await execCommand(commandArgs);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("test").description("Run tests with secrets loaded from environment").option("--stage <stage>", "Stage to load secrets from (default: stages.local)").option("--run", "Run tests once without watch mode").option("--watch", "Enable watch mode").option("--coverage", "Generate coverage report").option("--ui", "Open Vitest UI").option("--auto-setup", "Generate a fresh stage (secrets + key) from the workspace config when none exists (for CI; also via GKM_AUTO_SETUP)").option("--prepare", "Write the test manifest and #test harness, then stop — for a typecheck that runs before the suite").option("--setup", "Reconcile, migrate and seed the test stage and write the harness, then stop — what @geekmidas/cli/vitest runs").option("--teardown", "Drop the test stage's databases the last setup created, then stop — what @geekmidas/cli/vitest runs when the suite ends").argument("[pattern]", "Pattern to filter tests").action(async (pattern, options) => {
@@ -12058,50 +11994,46 @@ program.command("test").description("Run tests with secrets loaded from environm
 			pattern
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("migrate").description("Apply each database construct's migrations from db/<construct>/migrations/, as its owner").argument("[construct]", "Only this construct, by name").option("--stage <stage>", "The local stage (default) or test — a deploy migrates its own stage").action(async (construct, options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs"));
+		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs"));
 		await migrateCommand({
 			...options,
 			...construct ? { construct } : {}
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("seed").description("Migrate, then run each database construct's seeds from db/<construct>/seeds/, as its owner").argument("[construct]", "Only this construct, by name").option("--stage <stage>", "The local stage (default) or test — a deploy seeds its own stage").action(async (construct, options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs"));
+		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs"));
 		await seedCommand({
 			...options,
 			...construct ? { construct } : {}
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("migration").description("Write a construct's next migration: an empty one for a database, the schema change for an auth server").argument("<construct>", "The construct, by name").argument("[name]", "What the migration is called").action(async (construct, name) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-q2YYLJLE.cjs"));
+		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-C8wTpakT.cjs"));
 		await migrationCommand({
 			construct,
 			...name ? { name } : {}
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("cron").description("Manage cron jobs").action(() => {
@@ -12129,8 +12061,7 @@ program.command("openapi").description("Generate OpenAPI specification from endp
 			...telemetry !== void 0 ? { telemetry } : {}
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("docker").description("Generate Docker deployment files").option("--build", "Build Docker image after generating files").option("--push", "Push image to registry after building").option("--tag <tag>", "Image tag", "latest").option("--registry <registry>", "Container registry URL").action(async (options) => {
@@ -12139,8 +12070,7 @@ program.command("docker").description("Generate Docker deployment files").option
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await require_seeds.dockerCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("compose").description("Run the workspace's APIs and sites for a stage as one Docker Compose stack behind Caddy").requiredOption("--stage <stage>", "Stage to run — always named, so a stack is never a deployed stage by accident").option("--tag <tag>", "Run the images CI pushed at this tag (sites: <tag>-<stage>); nothing is built").option("--build", "Build images from this checkout, tagged with the commit").option("--pull", "Pull images (at --tag, or latest) rather than build them").option("--push", "With --build: push every image to deploy.registry and start nothing (for CI)").option("--digests-file <path>", "With --push: write each image as <ref>@sha256:… (JSON). With --tag: run the images at those digests").option("--dry-run", "Write the files and print the plan; start nothing").option("--down", "Stop the stage's stack (its volumes are kept)").option("--allow-dev-services", "Deployed stage: run the dev service (MinIO, Mailpit) for every bucket and mail the stage doesn't account for. Not production-grade").option("--skip-dns-check", "Deployed stage: do not check that each public host resolves to GKM_SERVER_IPV4 in the stage secrets before starting (a CDN or proxy in front)").action(async (options) => {
@@ -12149,8 +12079,7 @@ program.command("compose").description("Run the workspace's APIs and sites for a
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await composeCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("prepack").description("Generate Docker files for production deployment").option("--build", "Build Docker image after generating files").option("--push", "Push image to registry after building").option("--tag <tag>", "Image tag", "latest").option("--registry <registry>", "Container registry URL").action(async (options) => {
@@ -12164,8 +12093,7 @@ program.command("prepack").description("Generate Docker files for production dep
 			registry: options.registry
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:init").description("Initialize secrets for a deployment stage").requiredOption("--stage <stage>", "Stage name (e.g., production, staging)").option("--force", "Overwrite existing secrets").action(async (options) => {
@@ -12174,8 +12102,7 @@ program.command("secrets:init").description("Initialize secrets for a deployment
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsInitCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:set").description("Set a custom secret for a stage").argument("<key>", "Secret key (e.g., API_KEY)").argument("[value]", "Secret value (reads from stdin if omitted)").requiredOption("--stage <stage>", "Stage name").action(async (key, value, options) => {
@@ -12184,8 +12111,7 @@ program.command("secrets:set").description("Set a custom secret for a stage").ar
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsSetCommand(key, value, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:unset").description("Remove a custom secret from a stage").argument("<key>", "Secret key (e.g., API_KEY)").requiredOption("--stage <stage>", "Stage name").action(async (key, options) => {
@@ -12194,41 +12120,37 @@ program.command("secrets:unset").description("Remove a custom secret from a stag
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsUnsetCommand(key, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:add").description("Build the keys a stage must be given — buckets, mail, file servers, third parties' credentials — across every app").requiredOption("--stage <stage>", "Stage name").option("--missing", "Only the keys the stage has not set").option("--json", "Print the keys as JSON and ask nothing").action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { secretsAddCommand } = await Promise.resolve().then(() => require("./add-DmmBDV2e.cjs"));
+		const { secretsAddCommand } = await Promise.resolve().then(() => require("./add-VcyJnsPX.cjs"));
 		await secretsAddCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("encryption:rotate").description("Add a new current key to an Encryption construct's keyring on a server stage").argument("<construct>", "The Encryption construct (e.g. Pii)").requiredOption("--stage <stage>", "A deployed stage").action(async (construct, options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRotateCommand } = await Promise.resolve().then(() => require("./encryption-CjYdUb2s.cjs"));
+		const { encryptionRotateCommand } = await Promise.resolve().then(() => require("./encryption-D7zmwzWz.cjs"));
 		await encryptionRotateCommand(construct, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("encryption:retire").description("Remove an old key from an Encryption construct's keyring, once nothing is under it").argument("<construct>", "The Encryption construct (e.g. Pii)").argument("<key>", "The key to retire (e.g. k1)").requiredOption("--stage <stage>", "A deployed stage").action(async (construct, key, options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRetireCommand } = await Promise.resolve().then(() => require("./encryption-CjYdUb2s.cjs"));
+		const { encryptionRetireCommand } = await Promise.resolve().then(() => require("./encryption-D7zmwzWz.cjs"));
 		await encryptionRetireCommand(construct, key, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:show").description("Show secrets for a stage").requiredOption("--stage <stage>", "Stage name").option("--reveal", "Show actual secret values (not masked)").action(async (options) => {
@@ -12237,8 +12159,7 @@ program.command("secrets:show").description("Show secrets for a stage").required
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsShowCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:rotate").description("Rotate service passwords").requiredOption("--stage <stage>", "Stage name").option("--service <service>", "Specific service to rotate (postgres, redis, minio, …)").action(async (options) => {
@@ -12247,8 +12168,7 @@ program.command("secrets:rotate").description("Rotate service passwords").requir
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsRotateCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:import").description("Import secrets from a JSON file").argument("<file>", "JSON file path (e.g., secrets.json)").requiredOption("--stage <stage>", "Stage name").option("--no-merge", "Replace all custom secrets instead of merging").action(async (file, options) => {
@@ -12257,8 +12177,7 @@ program.command("secrets:import").description("Import secrets from a JSON file")
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await secretsImportCommand(file, options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:reconcile").description("Backfill missing custom secrets from workspace config").option("--stage <stage>", "Stage name (default: stages.local)").action(async (options) => {
@@ -12267,7 +12186,7 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		const { loadWorkspaceConfig } = await Promise.resolve().then(() => require("./config.cjs"));
 		const { reconcileMissingSecrets } = await Promise.resolve().then(() => require("./reconcile-CuCQBa5-.cjs"));
-		const { secretsStoreFor } = await Promise.resolve().then(() => require("./seeds-CkIPFGNO.cjs")).then((n) => n.store_exports);
+		const { secretsStoreFor } = await Promise.resolve().then(() => require("./seeds-c-ByX9je.cjs")).then((n) => n.store_exports);
 		const { workspace } = await loadWorkspaceConfig();
 		const stage = options.stage ?? workspace.stages.local;
 		const store = await secretsStoreFor(workspace, stage);
@@ -12276,7 +12195,7 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 			console.error(`No secrets found for stage "${stage}". Run "gkm secrets:init --stage ${stage}" first.`);
 			process.exit(1);
 		}
-		const { derivedContainers } = await Promise.resolve().then(() => require("./seeds-CkIPFGNO.cjs")).then((n) => n.workspace_exports);
+		const { derivedContainers } = await Promise.resolve().then(() => require("./seeds-c-ByX9je.cjs")).then((n) => n.workspace_exports);
 		const result = reconcileMissingSecrets(secrets, workspace, await derivedContainers(workspace, stage));
 		if (!result) {
 			console.log(`\n✓ Secrets for stage "${stage}" are up-to-date`);
@@ -12286,23 +12205,21 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 		console.log(`\n✓ Reconciled ${result.addedKeys.length} missing secret(s) for stage "${stage}":`);
 		for (const key of result.addedKeys) console.log(`    + ${key}`);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("secrets:migrate").description("Copy a deployed stage's secrets from the configured store to another (file, ssm, secrets-manager)").requiredOption("--stage <stage>", "A deployed stage").requiredOption("--to <provider>", "file, ssm or secrets-manager").option("--region <region>", "The target's AWS region (default: the configured store's)").option("--profile <profile>", "AWS profile for the stage's account").option("--force", "Replace a stage the target already holds").action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { secretsMigrateCommand } = await Promise.resolve().then(() => require("./migrate-CGaancHY.cjs"));
+		const { secretsMigrateCommand } = await Promise.resolve().then(() => require("./migrate-DFjbGnSr.cjs"));
 		await secretsMigrateCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("deploy").description("Deploy a stage through its target").option("--target <name>", "Deploy target: dokploy, compose, sst, or one named in deploy.targets (default: deploy.default)").option("--provider <provider>", "[DEPRECATED] Use --target instead").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").option("--tag <tag>", "Image tag (default: stage-timestamp; compose: the commit). Compose pulls a given tag").option("--skip-push", "Skip pushing image to registry").option("--skip-build", "Skip build step (use existing build)").option("--json", "Write events as JSON lines instead of progress; never prompts").option("--dry-run", "Show what would be created or reused; change, build and push nothing").option("--atomic", "If the release fails, roll back every app it released, not only the failed ones").option("--allow-dev-services", "Server targets: run the dev service (MinIO, Mailpit) for every bucket and mail the stage doesn't account for. Not production-grade").option("--skip-dns-check", "Compose: do not check that each public host resolves to GKM_SERVER_IPV4 in the stage secrets before starting (a CDN or proxy in front)").action(async (options) => {
-	const { deployCli } = await Promise.resolve().then(() => require("./cli-BE9mqeX8.cjs"));
+	const { deployCli } = await Promise.resolve().then(() => require("./cli-DL19w4OE.cjs"));
 	const globalOptions = program.opts();
 	const code = await deployCli({
 		cwd: (0, node_path.resolve)(globalOptions.cwd ?? process.cwd()),
@@ -12320,8 +12237,8 @@ program.command("deploy").description("Deploy a stage through its target").optio
 });
 program.command("deploy:rollback").description("Put a stage's app back on its previous release (Dokploy): one app with --app, every app with --atomic").requiredOption("--stage <stage>", "A deployed stage").option("--app <app>", "The app to roll back").option("--atomic", "Roll back every app that has an earlier release").action(async (options) => {
 	try {
-		const { rollbackStage } = await Promise.resolve().then(() => require("./rollback-UIjS25F1.cjs")).then((n) => n.rollback_exports);
-		const { terminalCredentials } = await Promise.resolve().then(() => require("./terminal-DuapRxh6.cjs"));
+		const { rollbackStage } = await Promise.resolve().then(() => require("./rollback--ympG9ss.cjs")).then((n) => n.rollback_exports);
+		const { terminalCredentials } = await Promise.resolve().then(() => require("./terminal-8XngdSTo.cjs"));
 		const globalOptions = program.opts();
 		await rollbackStage({
 			cwd: (0, node_path.resolve)(globalOptions.cwd ?? process.cwd()),
@@ -12332,8 +12249,7 @@ program.command("deploy:rollback").description("Put a stage's app back on its pr
 			log: (line) => console.log(line)
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("deploy:init").description("Initialize Dokploy deployment (create project and application)").option("--endpoint <url>", "Dokploy server URL (uses stored credentials if logged in)").requiredOption("--project <name>", "Project name (creates if not exists)").requiredOption("--app <name>", "Application name").option("--project-id <id>", "Use existing project ID instead of creating").option("--registry-id <id>", "Configure registry for the application").action(async (options) => {
@@ -12348,30 +12264,27 @@ program.command("deploy:init").description("Initialize Dokploy deployment (creat
 			registryId: options.registryId
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("deploy:github").description("Let GitHub Actions deploy a stage: OIDC role in the stage's AWS account, and the GitHub environment the deploy workflow uses").requiredOption("--stage <stage>", "A deployed stage from gkm.config.ts").option("--profile <profile>", "AWS profile for the stage's account").option("--repo <owner/name>", "GitHub repository (default: this one)").option("--policy-arn <arn>", "Policy for the deploy role (default: AdministratorAccess)").option("--dry-run", "Show the plan without changing AWS or GitHub").action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-B5Bw4HIu.cjs"));
+		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-zneTMvnO.cjs"));
 		await deployGithubCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("stages").description("The workspace's stages from gkm.config.ts: local, deployed and protected").option("--json", "Print them as JSON").option("--github-output", "Write the stages, and which this workflow run builds and deploys, to $GITHUB_OUTPUT").option("--event <name>", "The event to plan for (default: $GITHUB_EVENT_NAME)").option("--stage <stage>", "The stage a workflow_dispatch deploys").action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { stagesCommand } = await Promise.resolve().then(() => require("./stages-CUn6gvXL.cjs"));
+		const { stagesCommand } = await Promise.resolve().then(() => require("./stages-BI8JvPzI.cjs"));
 		await stagesCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("deploy:list").description("List Dokploy resources (projects, registries)").option("--endpoint <url>", "Dokploy server URL (uses stored credentials if logged in)").option("--projects", "List projects").option("--registries", "List registries").action(async (options) => {
@@ -12397,8 +12310,7 @@ program.command("deploy:list").description("List Dokploy resources (projects, re
 			});
 		}
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("login").description("Authenticate with a deployment or DNS provider").option("--provider <provider>", "Provider to log in to (dokploy, hostinger, godaddy)", "dokploy").option("--service <provider>", "[DEPRECATED] Use --provider instead").option("--token <token>", "API token (will prompt if not provided)").option("--endpoint <url>", "Service endpoint URL").action(async (options) => {
@@ -12420,8 +12332,7 @@ program.command("login").description("Authenticate with a deployment or DNS prov
 			endpoint: options.endpoint
 		});
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("logout").description("Remove stored credentials").option("--provider <provider>", "Whose credentials to remove (dokploy, godaddy, all)", "dokploy").option("--service <provider>", "[DEPRECATED] Use --provider instead").action(async (options) => {
@@ -12430,8 +12341,7 @@ program.command("logout").description("Remove stored credentials").option("--pro
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await logoutCommand({ provider: options.service ?? options.provider });
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("whoami").description("Show current authentication status").action(async () => {
@@ -12440,8 +12350,7 @@ program.command("whoami").description("Show current authentication status").acti
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await whoamiCommand();
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("state:pull").description("Pull deployment state from remote to local").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").action(async (options) => {
@@ -12450,8 +12359,7 @@ program.command("state:pull").description("Pull deployment state from remote to
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await statePullCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("state:push").description("Push deployment state from local to remote").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").action(async (options) => {
@@ -12460,8 +12368,7 @@ program.command("state:push").description("Push deployment state from local to r
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await statePushCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("state:show").description("Show deployment state for a stage").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").option("--json", "Output as JSON").action(async (options) => {
@@ -12470,8 +12377,16 @@ program.command("state:show").description("Show deployment state for a stage").r
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await stateShowCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
+	}
+});
+program.command("state:history").description("Show who wrote a stage's deploy state, newest first, and what each app runs").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").option("--json", "Output as JSON").action(async (options) => {
+	try {
+		const globalOptions = program.opts();
+		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
+		await stateHistoryCommand(options);
+	} catch (error) {
+		exitWithError(error);
 	}
 });
 program.command("state:unlock").description("Release a stage deploy lock left behind by a run that crashed").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").action(async (options) => {
@@ -12480,8 +12395,7 @@ program.command("state:unlock").description("Release a stage deploy lock left be
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await stateUnlockCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("state:diff").description("Compare local and remote deployment state").requiredOption("--stage <stage>", "Deployment stage (e.g., production, staging)").action(async (options) => {
@@ -12490,8 +12404,7 @@ program.command("state:diff").description("Compare local and remote deployment s
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await stateDiffCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 program.command("upgrade").description("Upgrade @geekmidas/cli (with --all, every @geekmidas package) along the release line the project is on").option("--dry-run", "Show what would be upgraded without making changes").option("--all", "Every @geekmidas package, and the third-party packages their peers require").option("--tag <tag>", "npm dist-tag to follow (default: the line you are on)").action(async (options) => {
@@ -12500,20 +12413,17 @@ program.command("upgrade").description("Upgrade @geekmidas/cli (with --all, ever
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await upgradeCommand(options);
 	} catch (error) {
-		console.error(formatError(error));
-		process.exit(1);
+		exitWithError(error);
 	}
 });
 try {
 	require_seeds.assertDevServicesFlag(process.argv.slice(2));
 } catch (error) {
-	console.error(formatError(error));
-	process.exit(1);
+	exitWithError(error);
 }
 program.parse();
 //#endregion
 exports.canPrompt = canPrompt;
-exports.deploysWithCompose = deploysWithCompose;
 exports.formatError = formatError;
 exports.generateFullstackCustomSecrets = generateFullstackCustomSecrets;
 exports.prompt = prompt;