@geekmidas/cli 10.0.0-alpha.97 → 10.0.0-alpha.99

package/dist/index.cjs

@@ -6,9 +6,10 @@ const require_run = require("./run-fVZ-rLnc.cjs");
 const require_credentials = require("./credentials-Zqr3QQYB.cjs");
 const require_discover = require("./discover-DPgu-ScS.cjs");
 const require_derive = require("./derive-DAbo49sm.cjs");
-const require_workspace = require("./workspace-C1M-S4al.cjs");
+const require_workspace = require("./workspace-DRjdu1OY.cjs");
 const require_config = require("./config.cjs");
-const require_seeds = require("./seeds-BQlj9Fsg.cjs");
+const require_seeds = require("./seeds-BNHSpjNP.cjs");
+const require_identity = require("./identity-CbLfgQNT.cjs");
 const require_EndpointGenerator = require("./EndpointGenerator-De03t1hd.cjs");
 const require_openapi = require("./openapi.cjs");
 const require_SubscriberGenerator = require("./SubscriberGenerator-Dvz7EzqK.cjs");
@@ -16,12 +17,11 @@ const require_appPorts = require("./appPorts-Cu79hJF6.cjs");
 const require_drivers = require("./drivers-DDojgzz0.cjs");
 const require_emit = require("./emit-Dmc1nvdS.cjs");
 const require_local = require("./local-DNhnkugT.cjs");
-const require_sniffer = require("./sniffer-CeUKUoHn.cjs");
-const require_deploy = require("./deploy-Cu_HyWoJ.cjs");
+const require_sniffer = require("./sniffer-Cylp9W2D.cjs");
+const require_deploy = require("./deploy-CbJMJsgX.cjs");
 const require_credentialSchemas = require("./credentialSchemas-CAPKFkrG.cjs");
-const require_compose = require("./compose-C39XupJu.cjs");
-const require_stack = require("./stack-Clzi40EE.cjs");
-const require_LocalStateStore = require("./LocalStateStore-B_bRI8M7.cjs");
+const require_compose = require("./compose-CIrFNWHb.cjs");
+const require_LocalStateStore = require("./LocalStateStore-BD14kra9.cjs");
 const require_utils = require("./utils-D2Nk1Nv2.cjs");
 const require_ready = require("./ready-D3PIjx3S.cjs");
 let node_path = require("node:path");
@@ -56,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.97";
+var version = "10.0.0-alpha.99";
 //#endregion
 //#region src/prompt.ts
 /**
@@ -139,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-CeUKUoHn.cjs")).then((n) => n.dokploy_api_exports);
+	const { DokployApi } = await Promise.resolve().then(() => require("./sniffer-Cylp9W2D.cjs")).then((n) => n.dokploy_api_exports);
 	return new DokployApi({
 		baseUrl: endpoint,
 		token
@@ -2333,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-CWq8-s21.cjs"));
+		const { prepareDevDatabases } = await Promise.resolve().then(() => require("./migrate-DjrTwWJA.cjs"));
 		await prepareDevDatabases(workspace, reconciled.env, { seed: !!options.seed });
-	} else await Promise.resolve().then(() => require("./migrate-CWq8-s21.cjs")).then(({ reportPendingMigrations }) => reportPendingMigrations(workspace, reconciled.env)).catch((error) => {
+	} else await Promise.resolve().then(() => require("./migrate-DjrTwWJA.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 = {};
@@ -3388,7 +3388,7 @@ async function buildApp(input) {
 				...production,
 				...telemetry ? { telemetry } : {}
 			});
-			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-SX3Uy8qT.cjs"));
+			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Bgoq8IyR.cjs"));
 			await bundleServer({
 				entryPoint,
 				outputDir: (0, node_path.join)(outputDir, "dist"),
@@ -3533,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-SX3Uy8qT.cjs"));
+		const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Bgoq8IyR.cjs"));
 		const outfile = require_seeds.workerBundleName(worker.id);
 		await bundleServer({
 			entryPoint,
@@ -3619,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-SX3Uy8qT.cjs"));
+			const { bundleServer } = await Promise.resolve().then(() => require("./bundler-Bgoq8IyR.cjs"));
 			const allConstructs = [
 				...endpoints.map((e) => e.construct),
 				...functions.map((f) => f.construct),
@@ -3865,7 +3865,7 @@ var ComposeModeConflict = class extends require_errors.GkmError {
 };
 /** 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_stack.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_compose.pinnedRef(image.ref, image.digest)]));
 }
 /** `gkm compose`. */
 async function composeCommand(options, deps = {}) {
@@ -3877,15 +3877,26 @@ async function composeCommand(options, deps = {}) {
 	const { workspace } = await require_config.loadWorkspaceConfig(cwd);
 	const { stage } = options;
 	if (options.down) {
+		const local = stage === workspace.stages.local;
+		const server = local ? void 0 : require_compose.composeServer({
+			stage,
+			local,
+			config: workspace.deploy?.compose?.server,
+			custom: (await (await require_seeds.secretsStoreFor(workspace, stage)).read(stage))?.custom
+		});
 		const override = require_compose.stackOverrideFile(workspace.root, stage);
+		const dir = (0, node_path.join)(workspace.root, require_compose.stackDir(stage));
 		const ref = {
-			project: require_stack.composeProject(require_seeds.deployIdentity(workspace, stage)),
-			file: (0, node_path.join)(workspace.root, require_stack.stackDir(stage), "docker-compose.yml"),
+			project: require_compose.composeProject(require_identity.deployIdentity(workspace, stage)),
+			file: (0, node_path.join)(dir, "docker-compose.yml"),
 			...(0, node_fs.existsSync)(override) ? { overrides: [override] } : {},
-			cwd: workspace.root
+			cwd: workspace.root,
+			...server ? { host: require_compose.dockerHost(server) } : {}
 		};
-		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);
+		const docker = deps.docker ?? require_compose.dockerCompose;
+		if (server) console.log(`→ ${require_compose.sshTarget(server)} (docker over ssh)`);
+		if (server && await require_compose.removeEdgeRoutes(docker, require_compose.edgeRef((0, node_path.join)(dir, `gkm-edge.yml`), { host: ref.host }), ref.project)) console.log(`🌐 Removed ${ref.project}'s routes from ${require_compose.EDGE_PROJECT}.`);
+		await docker.down(ref);
 		console.log(`🛑 Stopped ${ref.project}. Its volumes are kept.`);
 		return;
 	}
@@ -3894,7 +3905,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_stack.parseDigests(options.digestsFile, await (0, node_fs_promises.readFile)((0, node_path.resolve)(cwd, options.digestsFile), "utf-8"))
+		digests: require_compose.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,
@@ -3914,8 +3925,6 @@ async function composeCommand(options, deps = {}) {
 		...options.push ? { buildOnly: true } : {},
 		...options.allowDevServices ? { allowDevServices: true } : {},
 		...options.skipDns ? { skipDns: true } : {},
-		...options.resourcesOnly ? { resourcesOnly: true } : {},
-		...options.skipResources ? { skipResources: true } : {},
 		...options.rotateKeys ? { rotateKeys: true } : {},
 		...options.retireOldKeys ? { retireOldKeys: true } : {},
 		logger: {
@@ -5438,25 +5447,25 @@ function loadPackageJson() {
 * Run: pnpm --filter @geekmidas/cli sync-versions
 */
 const GEEKMIDAS_VERSIONS = {
-	"@geekmidas/audit": "~10.0.0-alpha.97",
-	"@geekmidas/auth": "~10.0.0-alpha.97",
-	"@geekmidas/cache": "~10.0.0-alpha.97",
-	"@geekmidas/client": "~10.0.0-alpha.97",
-	"@geekmidas/cloud": "~10.0.0-alpha.97",
-	"@geekmidas/constructs": "~10.0.0-alpha.97",
-	"@geekmidas/db": "~10.0.0-alpha.97",
-	"@geekmidas/emailkit": "~10.0.0-alpha.97",
-	"@geekmidas/envkit": "~10.0.0-alpha.97",
-	"@geekmidas/errors": "~10.0.0-alpha.97",
-	"@geekmidas/events": "~10.0.0-alpha.97",
-	"@geekmidas/logger": "~10.0.0-alpha.97",
-	"@geekmidas/manifest": "~10.0.0-alpha.97",
-	"@geekmidas/rate-limit": "~10.0.0-alpha.97",
-	"@geekmidas/schema": "~10.0.0-alpha.97",
-	"@geekmidas/services": "~10.0.0-alpha.97",
-	"@geekmidas/storage": "~10.0.0-alpha.97",
-	"@geekmidas/telescope": "~10.0.0-alpha.97",
-	"@geekmidas/testkit": "~10.0.0-alpha.97",
+	"@geekmidas/audit": "~10.0.0-alpha.99",
+	"@geekmidas/auth": "~10.0.0-alpha.99",
+	"@geekmidas/cache": "~10.0.0-alpha.99",
+	"@geekmidas/client": "~10.0.0-alpha.99",
+	"@geekmidas/cloud": "~10.0.0-alpha.99",
+	"@geekmidas/constructs": "~10.0.0-alpha.99",
+	"@geekmidas/db": "~10.0.0-alpha.99",
+	"@geekmidas/emailkit": "~10.0.0-alpha.99",
+	"@geekmidas/envkit": "~10.0.0-alpha.99",
+	"@geekmidas/errors": "~10.0.0-alpha.99",
+	"@geekmidas/events": "~10.0.0-alpha.99",
+	"@geekmidas/logger": "~10.0.0-alpha.99",
+	"@geekmidas/manifest": "~10.0.0-alpha.99",
+	"@geekmidas/rate-limit": "~10.0.0-alpha.99",
+	"@geekmidas/schema": "~10.0.0-alpha.99",
+	"@geekmidas/services": "~10.0.0-alpha.99",
+	"@geekmidas/storage": "~10.0.0-alpha.99",
+	"@geekmidas/telescope": "~10.0.0-alpha.99",
+	"@geekmidas/testkit": "~10.0.0-alpha.99",
 	"@geekmidas/cli": `~${loadPackageJson().version}`
 };
 //#endregion
@@ -5857,7 +5866,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 = "3e132c8a7cb4e861d459ae32496c1a122d892b14", version = cliVersion()) {
+function stagesActionUses(commit = "c9e539e1dbb06bad206fc9c356648b8927fd6181", 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
@@ -6109,7 +6118,6 @@ function stagesJob(options) {
       has-build: \${{ steps.stages.outputs.has-build }}
       has-deploy: \${{ steps.stages.outputs.has-deploy }}
       aws-region: \${{ steps.stages.outputs.aws-region }}
-      resources: \${{ steps.stages.outputs.resources }}
     steps:
       - uses: actions/checkout@v4
 
@@ -6127,10 +6135,6 @@ ${pm.setup}
           stage: \${{ inputs.stage }}
 `;
 }
-/** Every step in `steps` run only when `condition` holds. */
-function onlyIf(steps, condition) {
-	return steps.replace(/^ {6}- /gm, `      - if: ${condition}\n        `);
-}
 /**
 * The registry login a compose build pushes with: GitHub's own token on
 * ghcr.io, otherwise a username variable and a password secret.
@@ -6147,19 +6151,17 @@ function registryLogin(registry) {
 }
 /**
 * The compose deploy: images are built and pushed by the runner, where the
-* code is, and pulled by the server, where the stage runs.
+* code is, and run by the stage's server — whose Docker engine the runner
+* drives over SSH.
 *
 * - `build` (on a push): every deployed stage's images, tagged with the
 *   commit, and their digests kept as the artifact `digests-<stage>`.
 * - `deploy`: the commit the event names — a release's tag, a manual run's
-*   `ref` — then that commit's push build, whose digests pin each image. Over
-*   SSH, with a pinned host key, the server checks the commit out and runs
-*   `gkm compose` on exactly those images.
-* - Resources: where the stage has some the deploy creates — a provider's
-*   bucket and key, DNS records through a provider — the runner creates them
-*   first (`gkm deploy --resources-only`) with the stage's role and the DNS
-*   token from its environment, and the server deploys with
-*   `--skip-resources`: neither credential reaches the server.
+*   `ref` — then that commit's push build, whose digests pin each image. One
+*   `gkm compose` on the runner, with the stage's role and DNS token, creates
+*   the stage's resources and DNS records and runs exactly those images on the
+*   server's engine (`DOCKER_HOST=ssh://…`, from `deploy.compose.server`).
+*   The server holds Docker and the deploy user's key, and no credential.
 */
 function composeDeploy(options) {
 	const pm = tooling(options);
@@ -6191,7 +6193,7 @@ ${pm.setup}
 
 ${registryLogin(registry)}
       # A site's public URLs are built into it, so the build reads the stage's
-      # secrets store. With secrets.store on SSM or Secrets Manager the job
+      # secrets store. With secrets.store on S3, SSM or Secrets Manager the job
       # assumes the stage's role (AWS_ROLE_ARN, set by gkm deploy:github);
       # with the default 'file' store there is no role to assume.
       - name: Assume the stage's AWS role
@@ -6235,13 +6237,8 @@ ${registryLogin(registry)}
     permissions:
       contents: read
       actions: read
+      packages: read
       id-token: write
-    env:
-      # Whether the stage has resources the deploy creates — a provider's
-      # bucket and key (deploy.<kind>.<stage>), DNS records through a provider
-      # in dns: the runner creates them with the stage's role and DNS token,
-      # so neither reaches the server, which deploys with --skip-resources.
-      RESOURCES_ON_RUNNER: \${{ contains(fromJSON(needs.stages.outputs.resources || '[]'), matrix.stage) }}
     steps:
       # A release deploys its tag's commit, never its target_commitish — the
       # branch it was drafted against, which has moved on since.
@@ -6264,40 +6261,30 @@ ${registryLogin(registry)}
           REF: \${{ inputs.ref }}
           SHA: \${{ github.sha }}
 
-      # The deploy's resources, here on the runner: each provider's bucket
-      # and key (written into the stage's secrets store), and every public
-      # host's DNS record — a new app's included, one per host, never a
-      # wildcard — written through the provider where it is missing or out of
-      # date and read back from it. The stage's secrets (GKM_SERVER_IPV4
-      # among them) are read with the stage's role; the DNS token is a secret
-      # on this stage's environment. A missing credential fails here, before
-      # anything is deployed.
       - name: Check out the commit
-        if: env.RESOURCES_ON_RUNNER == 'true'
         uses: actions/checkout@v4
         with:
           ref: \${{ steps.commit.outputs.sha }}
 
-${onlyIf(pm.setup, "env.RESOURCES_ON_RUNNER == 'true'")}
+${pm.setup}
       - name: Install
-        if: env.RESOURCES_ON_RUNNER == 'true'
         run: ${pm.install}
 
+      # The server's engine pulls with the login docker sends from here: it
+      # holds none of its own.
+${registryLogin(registry)}
+      # The stage's secrets and deploy state are read and written here, with
+      # the stage's role (AWS_ROLE_ARN, set by gkm deploy:github). With the
+      # default 'file' secrets store there is no role, and no secrets file in
+      # a checkout: set secrets.store in gkm.config.ts to a store on AWS to
+      # deploy from CI.
       - name: Assume the stage's AWS role
-        if: env.RESOURCES_ON_RUNNER == 'true' && needs.stages.outputs.aws-region != ''
+        if: needs.stages.outputs.aws-region != ''
         uses: aws-actions/configure-aws-credentials@v4
         with:
           role-to-assume: \${{ vars.AWS_ROLE_ARN }}
           aws-region: \${{ needs.stages.outputs.aws-region }}
 
-      - name: Create the stage's resources
-        if: env.RESOURCES_ON_RUNNER == 'true'
-        run: ${pm.exec} gkm deploy --stage "$STAGE" --resources-only
-        env:
-          STAGE: \${{ matrix.stage }}
-          GODADDY_API_TOKEN: \${{ secrets.GODADDY_API_TOKEN }}
-          HOSTINGER_API_TOKEN: \${{ secrets.HOSTINGER_API_TOKEN }}
-
       # The push run of this workflow that built the commit for this stage:
       # this run on a push, the newest one with the stage's digests otherwise.
       - name: Find the commit's push build
@@ -6342,48 +6329,42 @@ ${onlyIf(pm.setup, "env.RESOURCES_ON_RUNNER == 'true'")}
           STAGE: \${{ matrix.stage }}
           SHA: \${{ steps.commit.outputs.sha }}
 
-      # Each environment holds DEPLOY_SSH_KEY (secret) and DEPLOY_KNOWN_HOSTS,
-      # DEPLOY_HOST, DEPLOY_USER and DEPLOY_PATH (variables): the server's
-      # host key is pinned, never accepted on first sight. DEPLOY_PATH is a
-      # clone of this repository, with a docker login to ${registry.split("/")[0]}
-      # and the stage's secrets.
-      #
-      # Every value reaches the server as an argument to a quoted heredoc —
-      # nothing is pasted into the script.
-      - name: Deploy on the server
+      # The deploy user's key (DEPLOY_SSH_KEY, a secret) and the server's
+      # pinned host key (DEPLOY_KNOWN_HOSTS, a variable) on each environment:
+      # never accepted on first sight. The server — user and host — is
+      # deploy.compose.server in gkm.config.ts and the stage's GKM_SERVER_IPV4.
+      - name: SSH to the server
         run: |
           mkdir -p ~/.ssh && chmod 700 ~/.ssh
           (umask 077 && printf '%s\\n' "$SSH_KEY" > ~/.ssh/deploy_key)
           printf '%s\\n' "$KNOWN_HOSTS" > ~/.ssh/known_hosts
-          digests=""
-          if [ -f digests.json ]; then digests=$(base64 -w0 < digests.json); fi
-          ssh -i ~/.ssh/deploy_key -o IdentitiesOnly=yes -o StrictHostKeyChecking=yes \\
-            "$DEPLOY_USER@$DEPLOY_HOST" \\
-            "bash -s -- $(printf '%q ' "$STAGE" "$SHA" "$DEPLOY_PATH" "$digests" "$RESOURCES_ON_RUNNER")" <<'REMOTE'
-          set -euo pipefail
-          stage=$1 sha=$2 dir=$3 digests=$4 resources_on_runner=$5
-          cd "$dir"
-          git fetch --quiet origin
-          git checkout --quiet --detach "$sha"
-          ${pm.install}
-          args=(--stage "$stage" --tag "$sha")
-          if [ -n "$digests" ]; then
-            mkdir -p .gkm
-            printf '%s' "$digests" | base64 -d > ".gkm/digests-$stage.json"
-            args+=(--digests-file ".gkm/digests-$stage.json")
-          fi
-          # Created and confirmed from the runner already.
-          if [ "$resources_on_runner" = true ]; then args+=(--skip-resources); fi
-          ${pm.exec} gkm compose "\${args[@]}"
-          REMOTE
+          cat > ~/.ssh/config <<'CONFIG'
+          Host *
+            IdentityFile ~/.ssh/deploy_key
+            IdentitiesOnly yes
+            StrictHostKeyChecking yes
+            ControlMaster auto
+            ControlPath ~/.ssh/cm-%C
+            ControlPersist 5m
+          CONFIG
         env:
           SSH_KEY: \${{ secrets.DEPLOY_SSH_KEY }}
           KNOWN_HOSTS: \${{ vars.DEPLOY_KNOWN_HOSTS }}
-          DEPLOY_HOST: \${{ vars.DEPLOY_HOST }}
-          DEPLOY_USER: \${{ vars.DEPLOY_USER }}
-          DEPLOY_PATH: \${{ vars.DEPLOY_PATH }}
+
+      # Everything, from here: the stage's resources and DNS records, its
+      # databases migrated through an SSH tunnel, and exactly the pushed
+      # images run on the server's Docker. The DNS token is a secret on the
+      # stage's environment, and never leaves the runner.
+      - name: Deploy
+        run: |
+          args=(--stage "$STAGE" --tag "$SHA")
+          if [ -f digests.json ]; then args+=(--digests-file digests.json); fi
+          ${pm.exec} gkm compose "\${args[@]}"
+        env:
           STAGE: \${{ matrix.stage }}
           SHA: \${{ steps.commit.outputs.sha }}
+          GODADDY_API_TOKEN: \${{ secrets.GODADDY_API_TOKEN }}
+          HOSTINGER_API_TOKEN: \${{ secrets.HOSTINGER_API_TOKEN }}
 `;
 }
 /**
@@ -7811,7 +7792,7 @@ ${deployBlock(options)}
 ${workspaceConstructsGlobs(options.routesStructure, (0, node_path.dirname)(options.apiPath)).map((glob) => `    '${glob}',`).join("\n")}
   ],
 
-  secrets: {
+${stateBlock(options)}  secrets: {
     enabled: true,${secretsStore(options)}
   },
 });
@@ -7822,13 +7803,24 @@ ${workspaceConstructsGlobs(options.routesStructure, (0, node_path.dirname)(optio
 * `gkm build` builds for, and which backends a cache or a broker resolves to.
 */
 function deployBlock(options) {
-	if (options.deployTarget === "compose") return `
-  // \`gkm compose --stage <stage>\` runs a stage as one Docker Compose stack on
-  // the machine it runs on. CI builds every image and pushes it here; the
-  // server pulls exactly those. On ghcr.io the owner is the repository's —
+	if (options.deployTarget === "compose") {
+		const key = (stage) => /^[A-Za-z_$][\w$]*$/.test(stage) ? stage : `'${stage}'`;
+		const servers = options.stages.deployed.map((stage) => `${key(stage)}: { user: 'deploy' }`).join(", ");
+		return `
+  // \`gkm compose --stage <stage>\` runs a stage as one Docker Compose stack:
+  // the local stage on this machine, a deployed stage on its server, whose
+  // Docker it drives over SSH. CI builds every image and pushes it here, and
+  // the server runs exactly those. On ghcr.io the owner is the repository's —
   // the user or organisation whose packages the workflow's token can write.
-  deploy: { default: 'compose', registry: '${options.registry}' },
+  deploy: {
+    default: 'compose',
+    registry: '${options.registry}',
+    // Each deployed stage's server: the SSH user, in its docker group. The
+    // host is the stage's GKM_SERVER_IPV4 secret unless \`host\` is set.
+    compose: { server: { ${servers} } },
+  },
 `;
+	}
 	if (options.deployTarget !== "sst") return "";
 	return `
   // \`gkm deploy\` runs \`sst deploy\` on the manifest \`gkm build\` writes to
@@ -7837,17 +7829,32 @@ function deployBlock(options) {
 `;
 }
 /**
-* Where a deployed stage's secrets live. On AWS that is SSM in the stage's own
-* account, which the deploy job reaches with the role it already assumed; a
-* server target keeps the encrypted local file, the default.
+* Where a deployed stage's deploy state lives: on AWS, the project bucket —
+* one bucket per project and account, created by the first deploy — which
+* the stage's secrets share.
+*/
+function stateBlock(options) {
+	if (options.deployTarget !== "sst" || !options.region) return "";
+	return `  // Deploy state, secrets and backups share one bucket per project and
+  // account, gkm-<project>-<account id>, created by the first deploy:
+  // versioned, encrypted, never public.
+  state: { provider: 's3', region: '${options.region}' },
+
+`;
+}
+/**
+* Where a deployed stage's secrets live. On AWS that is the project bucket,
+* beside the deploy state, in the stage's own account, which the deploy job
+* reaches with the role it already assumed; a server target keeps the
+* encrypted local file, the default.
 */
 function secretsStore(options) {
 	if (options.deployTarget !== "sst" || !options.region) return "";
 	return `
-    // Deployed stages keep their secrets in SSM, in the account each stage
-    // deploys to: \`gkm secrets:set <KEY> '…' --stage <stage>\` writes there.
-    // Past 8 KB a stage needs { provider: 'secrets-manager', region } instead.
-    store: { provider: 'ssm', region: '${options.region}' },`;
+    // Deployed stages keep their secrets in the project bucket, beside the
+    // state, in the account each stage deploys to:
+    // \`gkm secrets:set <KEY> '…' --stage <stage>\` writes there.
+    store: { provider: 's3' },`;
 }
 /**
 * The workspace's constructs, at its root rather than inside an app.
@@ -10830,8 +10837,8 @@ function printNextSteps(projectName, options, pkgManager) {
 	if (options.deployTarget === "compose") {
 		console.log("🚀 Deployment (Docker Compose, on your server):");
 		console.log(`  Images are pushed to ${options.registry}; .github/workflows/deploy.yml builds them`);
-		console.log("  and runs gkm compose on the server over SSH. See the comments in it for the");
-		console.log("  environment variables and secrets each stage needs.");
+		console.log("  and deploys each stage to its server's Docker over SSH (deploy.compose.server");
+		console.log("  in gkm.config.ts). See the comments in it for the secrets each stage needs.");
 		console.log("");
 	}
 	if (options.deployTarget === "sst") {
@@ -11597,7 +11604,7 @@ function testDatabases(reconciled) {
 * starts without the reference data the app needs.
 */
 async function migrateTestStage(workspace, env) {
-	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-CWq8-s21.cjs"));
+	const { migrateAndSeed } = await Promise.resolve().then(() => require("./migrate-DjrTwWJA.cjs"));
 	const { discover } = await Promise.resolve().then(() => require("./discover-DPgu-ScS.cjs")).then((n) => n.discover_exports);
 	const sources = {};
 	const manifest = await discover({
@@ -12033,7 +12040,7 @@ program.command("migrate").description("Apply each database construct's migratio
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-CWq8-s21.cjs"));
+		const { migrateCommand } = await Promise.resolve().then(() => require("./migrate-DjrTwWJA.cjs"));
 		await migrateCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -12046,7 +12053,7 @@ program.command("seed").description("Migrate, then run each database construct's
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-CWq8-s21.cjs"));
+		const { seedCommand } = await Promise.resolve().then(() => require("./migrate-DjrTwWJA.cjs"));
 		await seedCommand({
 			...options,
 			...construct ? { construct } : {}
@@ -12059,7 +12066,7 @@ program.command("migration").description("Write a construct's next migration: an
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-CWq8-s21.cjs"));
+		const { migrationCommand } = await Promise.resolve().then(() => require("./migrate-DjrTwWJA.cjs"));
 		await migrationCommand({
 			construct,
 			...name ? { name } : {}
@@ -12105,7 +12112,7 @@ program.command("docker").description("Generate Docker deployment files").option
 		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", "Deployed stage: neither write the public hosts' DNS records nor check they point at GKM_SERVER_IPV4 (a CDN or proxy in front, or records written elsewhere)").option("--resources-only", "Deployed stage: create its resources — deploy.<kind>.<stage> providers' buckets and keys, and its DNS records — and nothing else (a CI runner, before the server deploys)").option("--skip-resources", "Deployed stage: an earlier --resources-only run created its resources; run no provider and write or check no DNS record").option("--rotate-keys", "Deployed stage: each provider issues its runtime keys a successor (the old one is deleted by the next deploy)").option("--retire-old-keys", "Deployed stage: delete a rotated-out key now instead of on the next deploy").action(async (options) => {
+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", "Deployed stage: neither write the public hosts' DNS records nor check they point at GKM_SERVER_IPV4 (a CDN or proxy in front, or records written elsewhere)").option("--rotate-keys", "Deployed stage: each provider issues its runtime keys a successor (the old one is deleted by the next deploy)").option("--retire-old-keys", "Deployed stage: delete a rotated-out key now instead of on the next deploy").action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
@@ -12159,7 +12166,7 @@ program.command("secrets:add").description("Build the keys a stage must be given
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { secretsAddCommand } = await Promise.resolve().then(() => require("./add-HXzTCy_I.cjs"));
+		const { secretsAddCommand } = await Promise.resolve().then(() => require("./add-Iuo3ao5E.cjs"));
 		await secretsAddCommand(options);
 	} catch (error) {
 		exitWithError(error);
@@ -12169,7 +12176,7 @@ program.command("encryption:rotate").description("Add a new current key to an En
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRotateCommand } = await Promise.resolve().then(() => require("./encryption-CUyw-8sc.cjs"));
+		const { encryptionRotateCommand } = await Promise.resolve().then(() => require("./encryption-CmQvQOSe.cjs"));
 		await encryptionRotateCommand(construct, options);
 	} catch (error) {
 		exitWithError(error);
@@ -12179,7 +12186,7 @@ program.command("encryption:retire").description("Remove an old key from an Encr
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { encryptionRetireCommand } = await Promise.resolve().then(() => require("./encryption-CUyw-8sc.cjs"));
+		const { encryptionRetireCommand } = await Promise.resolve().then(() => require("./encryption-CmQvQOSe.cjs"));
 		await encryptionRetireCommand(construct, key, options);
 	} catch (error) {
 		exitWithError(error);
@@ -12218,7 +12225,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-BQlj9Fsg.cjs")).then((n) => n.store_exports);
+		const { secretsStoreFor } = await Promise.resolve().then(() => require("./seeds-BNHSpjNP.cjs")).then((n) => n.store_exports);
 		const { workspace } = await loadWorkspaceConfig();
 		const stage = options.stage ?? workspace.stages.local;
 		const store = await secretsStoreFor(workspace, stage);
@@ -12227,7 +12234,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-BQlj9Fsg.cjs")).then((n) => n.workspace_exports);
+		const { derivedContainers } = await Promise.resolve().then(() => require("./seeds-BNHSpjNP.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`);
@@ -12240,18 +12247,18 @@ program.command("secrets:reconcile").description("Backfill missing custom secret
 		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) => {
+program.command("secrets:migrate").description("Copy a deployed stage's secrets from the configured store to another (s3, ssm, secrets-manager, file), verify the copy, and print how to delete the source").requiredOption("--stage <stage>", "A deployed stage").requiredOption("--to <provider>", "s3, ssm, secrets-manager or file").option("--region <region>", "The target's AWS region (default: the S3 state's for s3, else the configured store's)").option("--profile <profile>", "AWS profile for the stage's account").option("--force", "Replace different secrets 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-CsMrI7Dk.cjs"));
+		const { secretsMigrateCommand } = await Promise.resolve().then(() => require("./migrate-CxZYzF_u.cjs"));
 		await secretsMigrateCommand(options);
 	} catch (error) {
 		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", "Compose: neither write the public hosts' DNS records nor check they point at GKM_SERVER_IPV4 (a CDN or proxy in front, or records written elsewhere)").option("--resources-only", "Deployed stage: create its resources — deploy.<kind>.<stage> providers' buckets and keys, and its DNS records — and nothing else (a CI runner, before the server deploys)").option("--skip-resources", "Deployed stage: an earlier --resources-only run created its resources; run no provider and write or check no DNS record").option("--rotate-keys", "Deployed stage: each provider issues its runtime keys a successor (the old one is deleted by the next deploy)").option("--retire-old-keys", "Deployed stage: delete a rotated-out key now instead of on the next deploy").action(async (options) => {
-	const { deployCli } = await Promise.resolve().then(() => require("./cli-1l0L9LCA.cjs"));
+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", "Compose: neither write the public hosts' DNS records nor check they point at GKM_SERVER_IPV4 (a CDN or proxy in front, or records written elsewhere)").option("--rotate-keys", "Deployed stage: each provider issues its runtime keys a successor (the old one is deleted by the next deploy)").option("--retire-old-keys", "Deployed stage: delete a rotated-out key now instead of on the next deploy").action(async (options) => {
+	const { deployCli } = await Promise.resolve().then(() => require("./cli-W2DMRIbP.cjs"));
 	const globalOptions = program.opts();
 	const code = await deployCli({
 		cwd: (0, node_path.resolve)(globalOptions.cwd ?? process.cwd()),
@@ -12264,8 +12271,6 @@ program.command("deploy").description("Deploy a stage through its target").optio
 		...options.atomic ? { atomic: true } : {},
 		...options.allowDevServices ? { allowDevServices: true } : {},
 		...options.skipDns ? { skipDns: true } : {},
-		...options.resourcesOnly ? { resourcesOnly: true } : {},
-		...options.skipResources ? { skipResources: true } : {},
 		...options.rotateKeys ? { rotateKeys: true } : {},
 		...options.retireOldKeys ? { retireOldKeys: true } : {}
 	});
@@ -12273,7 +12278,7 @@ 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-CvGfm4DX.cjs")).then((n) => n.rollback_exports);
+		const { rollbackStage } = await Promise.resolve().then(() => require("./rollback-DBfLvC8k.cjs")).then((n) => n.rollback_exports);
 		const { terminalCredentials } = await Promise.resolve().then(() => require("./terminal-CPHuH4S1.cjs"));
 		const globalOptions = program.opts();
 		await rollbackStage({
@@ -12307,7 +12312,7 @@ program.command("deploy:github").description("Let GitHub Actions deploy a stage:
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-DC4SIqV1.cjs"));
+		const { deployGithubCommand } = await Promise.resolve().then(() => require("./github-Ds2RYnSU.cjs"));
 		await deployGithubCommand(options);
 	} catch (error) {
 		exitWithError(error);
@@ -12317,7 +12322,7 @@ program.command("stages").description("The workspace's stages from gkm.config.ts
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		const { stagesCommand } = await Promise.resolve().then(() => require("./stages-BpDXFPGg.cjs"));
+		const { stagesCommand } = await Promise.resolve().then(() => require("./stages-DdBV7msu.cjs"));
 		await stagesCommand(options);
 	} catch (error) {
 		exitWithError(error);