@h-ai/deploy 0.1.0-alpha.66 → 0.1.0-alpha.67

package/dist/index.js

@@ -1,11 +1,11 @@
 import { createHash, randomBytes } from 'crypto';
-import { createReadStream, readFileSync, existsSync, lstatSync, writeFileSync, chmodSync, mkdirSync, mkdtempSync, copyFileSync, rmSync, statSync, readdirSync } from 'fs';
+import { createReadStream, readFileSync, existsSync, lstatSync, writeFileSync, chmodSync, mkdirSync, mkdtempSync, copyFileSync, renameSync, rmSync, statSync, readdirSync } from 'fs';
 import { resolve, join, basename, dirname, relative, sep } from 'path';
 import { z } from 'zod';
-import { core, ok, err } from '@h-ai/core';
+import { core, err, ok } from '@h-ai/core';
 import process2 from 'process';
 import { parseEnv } from 'util';
-import { parse, stringify, parseAllDocuments } from 'yaml';
+import { LineCounter, parseDocument, parse, stringify, parseAllDocuments } from 'yaml';
 import { homedir } from 'os';
 import { spawn } from 'child_process';
 import { Buffer } from 'buffer';
@@ -13,25 +13,33 @@ import { Buffer } from 'buffer';
 // src/deploy-artifact.ts
 var DeploymentArtifactSchema = z.object({
   /** 清单格式版本，与应用版本和部署环境无关。 */
-  version: z.literal(2),
+  version: z.literal(3),
   /** 应用根 package.json 的版本，用于归档、Compose 与桌面交付；最长 80 字符。 */
   appVersion: z.string().max(80).regex(/^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9a-z-]+(?:\.[0-9a-z-]+)*)?(?:\+[0-9a-z-]+(?:\.[0-9a-z-]+)*)?$/i),
-  /** 一次完整构建的标识，app/web 必须来自同一份清单。 */
+  /** 本次构建标识；同一应用版本允许重复构建。 */
   buildId: z.string().regex(/^[a-z0-9][\w.+-]*$/i),
-  /** API/独立应用和可选 Web 的镜像归档，至少包含一个 app。 */
+  /** 只包含所选镜像的构建不能用于首次安装。 */
+  partial: z.boolean().default(false),
+  /** API 单独构建时仍保留工程的 Web 拓扑。 */
+  hasWeb: z.boolean().default(false),
+  /** 工程显式配置的应用端口，部分构建未包含 app 镜像时仍保留；缺省由部署配置决定。 */
+  appContainerPort: z.number().int().min(1).max(65535).optional(),
+  /** 工程显式配置的 Web 端口，部分构建未包含 web 镜像时仍保留；缺省使用部署默认值。 */
+  webContainerPort: z.number().int().min(1).max(65535).optional(),
+  /** 本次构建选择的镜像归档。 */
   images: z.array(z.object({
     /** app 为服务或独立应用，web 为同源 API 代理的静态前端。 */
     name: z.enum(["app", "web"]),
     /** 相对于清单目录的 tar 文件名。 */
     file: z.string().regex(/^[\w.+-]+\.tar$/),
     /** 归档导入后可直接使用的不可变镜像引用。 */
-    imageRef: z.string().regex(/^[a-z0-9][a-z0-9./:_-]+$/),
+    imageRef: z.string().regex(/^[a-z0-9][a-z0-9./:_-]*:[a-z0-9_][a-z0-9_.-]*$/).refine((value) => !value.endsWith(":latest")),
     /** tar 内容的 SHA-256，用于部署前校验。 */
     sha256: z.string().regex(/^[a-f0-9]{64}$/),
     /** 容器内部监听端口；服务器公开端口由部署选择。 */
     containerPort: z.number().int().min(1).max(65535).optional()
-  })).min(1).max(2).refine((images) => images.filter((image) => image.name === "app").length === 1 && new Set(images.map((image) => image.name)).size === images.length)
-}).refine((artifact) => artifact.images.every((image) => image.file === `${image.name}-${artifact.appVersion}.tar`));
+  })).min(1).max(2).refine((images) => new Set(images.map((image) => image.name)).size === images.length)
+}).refine((artifact) => artifact.images.every((image) => image.file === `${image.name}-${artifact.appVersion}.tar`)).refine((artifact) => artifact.partial || artifact.images.some((image) => image.name === "app")).refine((artifact) => artifact.partial || !artifact.hasWeb || artifact.images.some((image) => image.name === "web"));
 async function artifactChecksum(file) {
   const hash = createHash("sha256");
   for await (const chunk of createReadStream(file))
@@ -99,11 +107,21 @@ var en_US_default = {
   deploy_purposeEmail: "Email/HTTP delivery; the default SMTP container only captures test messages",
   deploy_purposeSms: "SMS through Aliyun credentials; requires an existing signature and quota",
   deploy_webProxyInvalid: "The API prefix must be an absolute path containing only letters, numbers, underscores, hyphens and slashes.",
-  deploy_artifactInvalid: "Build artifacts are missing, corrupt, or could not be packaged. Run pnpm build --target docker at the project root and point --artifact-dir to a complete build directory.",
+  deploy_artifactInvalid: "Image artifacts are missing or invalid. Run pnpm build --target docker, select valid --artifact-dir, or use pnpm run deploy --build.",
   deploy_sshRequired: "Automatic deployment requires SSH settings. Use --bundle-only for manual transfer when the server is unreachable.",
-  deploy_bundleInstructions: "This bundle contains private configuration. Transfer it securely and restrict access.\n1. Copy {file} to Linux using removable media, a private network or scp.\n2. Install Docker/Podman with compose, tar, sha256sum and sh. Load middleware images using docker load/podman load with the exact tags below.\n3. Create a private release directory: mkdir -p release && chmod 700 release\n4. From the bundle directory run tar -xf {file} -C release\n5. Run cd release && sh {start}. Set HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME=docker or podman to select the runtime explicitly.\n6. Check docker compose -f {compose} --env-file .env.runtime ps (or logs; use podman instead of docker for Podman), Web and /health after startup. Bundle generation does not perform server health checks.\nRequired images (app/web are included; prepare middleware separately):\n{images}\nBuilt images can be reused across environments; this bundle contains configuration for the selected environment only.",
+  deploy_bundleInstructions: "Bundle: {file}\nIncludes all images needed by selected services, including self-hosted middleware.\nWith SSH access, run deploy.ps1 (Windows) or deploy.sh (Linux/macOS) from the adjacent deployment directory.\nFor isolated servers, copy and extract the tar into a separate directory, then run sh apply.sh /opt/hai/apps/project-environment.\nLinux requires Docker/Podman, Compose, sh, tar, sha256sum, awk, curl and filesystem/container permissions.\nPartial updates require a successful full installation with matching ports/layout. Steps return nonzero on failure; result-DEPLOYMENT_ID.json records the outcome.\nThe bundle contains private runtime configuration; transfer it securely.\nIncluded images:\n{images}",
   deploy_bundleMetadata: "Application version: {version}\nBuild ID: {buildId}\nCompose file: {compose}",
-  deploy_bundleOnlyContainer: "Compose bundle generation is supported only by docker-ssh."
+  deploy_bundleOnlyContainer: "Compose bundle generation is supported only by docker-ssh.",
+  deploy_selectedContainerOnly: "Selected-service deployment requires a docker-ssh Compose destination.",
+  deploy_selectionInvalid: "Cannot deploy {service}: check the service name and build its image first.",
+  deploy_imageVersionRequired: "Specify an image version; latest is not allowed: {image}",
+  deploy_bundleRuntimeRequired: "Start local Podman/Docker to export middleware images, or prepare this complete offline bundle on the build machine.",
+  deploy_bundleFailed: "Package preparation or deployment failed: {reason}",
+  deploy_configFileInvalid: "Invalid YAML in {path}, line {line}. Check indentation, colons and quotes.",
+  deploy_configFileUnreadable: "Cannot read configuration file {path}. Check its path and permissions.",
+  deploy_bundleNameInvalid: "Bundle filenames may contain letters, numbers, dots, plus signs, hyphens and underscores; parent directories may contain spaces.",
+  deploy_secretsInvalid: "Middleware credentials are damaged or incomplete: {path}. Restore a backup; passwords are not regenerated because existing data may become inaccessible.",
+  deploy_storageArtifactRequired: "Storage initialization requires the application image. Select a complete artifact containing app with --artifact-dir, or run pnpm build --target docker --images app first."
 };
 
 // messages/zh-CN.json
@@ -157,11 +175,21 @@ var zh_CN_default = {
   deploy_purposeEmail: "\u90AE\u4EF6\u6216 HTTP \u901A\u77E5\u6295\u9012\uFF1B\u9ED8\u8BA4 SMTP \u5BB9\u5668\u4EC5\u7528\u4E8E\u6D4B\u8BD5\u63A5\u6536",
   deploy_purposeSms: "\u901A\u8FC7\u963F\u91CC\u4E91\u51ED\u8BC1\u63A5\u5165\u77ED\u4FE1\u670D\u52A1\uFF0C\u9700\u5DF2\u6709\u7B7E\u540D\u4E0E\u989D\u5EA6",
   deploy_webProxyInvalid: "API \u524D\u7F00\u5FC5\u987B\u662F\u4EC5\u542B\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u3001\u8FDE\u5B57\u7B26\u548C\u659C\u6760\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002",
-  deploy_artifactInvalid: "\u6784\u5EFA\u4EA7\u7269\u7F3A\u5931\u3001\u635F\u574F\u6216\u90E8\u7F72\u6253\u5305\u5931\u8D25\u3002\u8BF7\u5148\u5728\u5DE5\u7A0B\u6839\u8FD0\u884C pnpm build --target docker\uFF0C\u5E76\u68C0\u67E5 --artifact-dir \u6307\u5411\u5B8C\u6574\u7684\u6784\u5EFA\u76EE\u5F55\u3002",
+  deploy_artifactInvalid: "\u955C\u50CF\u4EA7\u7269\u7F3A\u5931\u6216\u6821\u9A8C\u5931\u8D25\u3002\u8BF7\u5148\u6267\u884C pnpm build --target docker\uFF0C\u6216\u7528 --artifact-dir \u6307\u5B9A\u6709\u6548\u4EA7\u7269\uFF1B\u4E5F\u53EF\u7528 pnpm run deploy --build \u4E00\u6B21\u5B8C\u6210\u3002",
   deploy_sshRequired: "\u81EA\u52A8\u90E8\u7F72\u9700\u8981 SSH \u914D\u7F6E\uFF1B\u65E0\u7F51\u7EDC\u8FDE\u63A5\u65F6\u4F7F\u7528 --bundle-only \u751F\u6210\u90E8\u7F72\u5305\u5E76\u624B\u5DE5\u642C\u8FD0\u3002",
-  deploy_bundleInstructions: "\u6B64\u5305\u5305\u542B\u79C1\u6709\u914D\u7F6E\uFF0C\u8BF7\u5B89\u5168\u642C\u8FD0\u5E76\u9650\u5236\u8BBF\u95EE\u6743\u9650\u3002\n1. \u5C06 {file} \u590D\u5236\u5230 Linux \u670D\u52A1\u5668\uFF08U \u76D8\u3001\u5185\u7F51\u4F20\u8F93\u6216 scp \u5747\u53EF\uFF09\u3002\n2. \u51C6\u5907 Docker/Podman\u3001\u5BF9\u5E94 compose \u547D\u4EE4\u3001tar\u3001sha256sum \u548C sh\uFF1B\u5C06\u6240\u9700\u4E2D\u95F4\u4EF6\u955C\u50CF\u7528 docker load/podman load \u5BFC\u5165\uFF0C\u955C\u50CF\u6807\u7B7E\u987B\u4E0E\u4E0B\u5217\u6E05\u5355\u5B8C\u5168\u4E00\u81F4\u3002\n3. \u65B0\u5EFA\u4EC5\u90E8\u7F72\u7528\u6237\u53EF\u8BBF\u95EE\u7684\u76EE\u5F55\uFF1Amkdir -p release && chmod 700 release\n4. \u5728\u5305\u6240\u5728\u76EE\u5F55\u6267\u884C tar -xf {file} -C release\n5. \u6267\u884C cd release && sh {start}\uFF1B\u53EF\u7528 HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME=docker \u6216 podman \u663E\u5F0F\u9009\u62E9\u8FD0\u884C\u65F6\u3002\n6. \u542F\u52A8\u540E\u7528 docker compose -f {compose} --env-file .env.runtime ps\uFF08\u6216 logs\uFF1BPodman \u5C06 docker \u6362\u4E3A podman\uFF09\u68C0\u67E5\u72B6\u6001\u5E76\u9A8C\u8BC1 Web\u3001/health\uFF1B\u4EC5\u6253\u5305\u4E0D\u4F1A\u6267\u884C\u670D\u52A1\u5668\u5065\u5EB7\u68C0\u67E5\u3002\n\u6240\u9700\u955C\u50CF\uFF08app/web \u5DF2\u542B\u5728\u5305\u4E2D\uFF0C\u4E2D\u95F4\u4EF6\u9700\u53E6\u884C\u51C6\u5907\uFF09\uFF1A\n{images}\n\u6784\u5EFA\u955C\u50CF\u53EF\u7528\u4E8E\u591A\u73AF\u5883\uFF1B\u6B64\u5305\u7684\u73AF\u5883\u914D\u7F6E\u4EC5\u7528\u4E8E\u672C\u6B21\u6240\u9009\u73AF\u5883\u3002",
+  deploy_bundleInstructions: "\u90E8\u7F72\u5305\uFF1A{file}\n\u5305\u4E2D\u5DF2\u5305\u542B\u672C\u6B21\u9009\u62E9\u670D\u52A1\u9700\u8981\u7684\u955C\u50CF\uFF0C\u5305\u62EC\u81EA\u5EFA\u4E2D\u95F4\u4EF6\u3002\n\u6709 SSH \u8FDE\u63A5\u65F6\uFF0C\u5728\u65C1\u8FB9\u7684\u90E8\u7F72\u76EE\u5F55\u8FD0\u884C deploy.ps1\uFF08Windows\uFF09\u6216 deploy.sh\uFF08Linux/macOS\uFF09\u3002\n\u5B8C\u5168\u9694\u79BB\u65F6\uFF0C\u590D\u5236 tar \u5230 Linux \u670D\u52A1\u5668\uFF0C\u5728\u72EC\u7ACB\u76EE\u5F55\u89E3\u5305\uFF0C\u518D\u6267\u884C sh apply.sh /opt/hai/apps/\u9879\u76EE\u73AF\u5883\u3002\n\u670D\u52A1\u5668\u9700\u8981 Docker/Podman\u3001Compose\u3001sh\u3001tar\u3001sha256sum\u3001awk \u548C curl\uFF0C\u4EE5\u53CA\u76EE\u5F55\u3001\u5BB9\u5668\u8FD0\u884C\u6743\u9650\u3002\n\u90E8\u5206\u66F4\u65B0\u8981\u6C42\u670D\u52A1\u5668\u5DF2\u6709\u6210\u529F\u7684\u5B8C\u6574\u90E8\u7F72\uFF0C\u7AEF\u53E3\u53CA\u5E94\u7528\u5E03\u5C40\u4FDD\u6301\u4E00\u81F4\u3002\u6BCF\u6B65\u5931\u8D25\u4F1A\u8FD4\u56DE\u975E\u96F6\u9000\u51FA\u7801\uFF1B\u7ED3\u679C\u8BB0\u5F55\u5728\u90E8\u7F72\u76EE\u5F55 result-\u90E8\u7F72ID.json\u3002\n\u5305\u5305\u542B\u79C1\u6709\u8FD0\u884C\u914D\u7F6E\uFF0C\u8BF7\u5B89\u5168\u4F20\u8F93\u3002\n\u6240\u542B\u955C\u50CF\uFF1A\n{images}",
   deploy_bundleMetadata: "\u5E94\u7528\u7248\u672C\uFF1A{version}\n\u6784\u5EFA\u7F16\u53F7\uFF1A{buildId}\nCompose \u6587\u4EF6\uFF1A{compose}",
-  deploy_bundleOnlyContainer: "\u4EC5\u751F\u6210 Compose tar \u53EA\u652F\u6301 docker-ssh\u3002"
+  deploy_bundleOnlyContainer: "\u4EC5\u751F\u6210 Compose tar \u53EA\u652F\u6301 docker-ssh\u3002",
+  deploy_selectedContainerOnly: "\u6309\u670D\u52A1\u5C40\u90E8\u90E8\u7F72\u4EC5\u9002\u7528\u4E8E docker-ssh Compose \u76EE\u6807\u3002",
+  deploy_selectionInvalid: "\u65E0\u6CD5\u90E8\u7F72\u670D\u52A1 {service}\uFF1A\u8BF7\u68C0\u67E5\u670D\u52A1\u540D\u79F0\uFF0C\u5E76\u5148\u6784\u5EFA\u5BF9\u5E94\u955C\u50CF\u3002",
+  deploy_storageArtifactRequired: "\u5B58\u50A8\u521D\u59CB\u5316\u9700\u8981\u5E94\u7528\u955C\u50CF\u3002\u8BF7\u7528 --artifact-dir \u9009\u62E9\u542B app \u955C\u50CF\u7684\u5B8C\u6574\u5236\u54C1\uFF0C\u6216\u5148\u6267\u884C pnpm build --target docker --images app\u3002",
+  deploy_imageVersionRequired: "\u955C\u50CF\u5FC5\u987B\u6307\u5B9A\u7248\u672C\uFF0C\u4E0D\u80FD\u4F7F\u7528 latest\uFF1A{image}",
+  deploy_bundleRuntimeRequired: "\u5B8C\u6574\u79BB\u7EBF\u5305\u9700\u8981\u5BFC\u51FA\u4E2D\u95F4\u4EF6\u955C\u50CF\u3002\u8BF7\u542F\u52A8\u672C\u5730 Podman/Docker\uFF0C\u6216\u5728\u6784\u5EFA\u673A\u6253\u5305\u3002",
+  deploy_bundleFailed: "\u4EA4\u4ED8\u51C6\u5907\u6216\u90E8\u7F72\u5931\u8D25\uFF1A{reason}",
+  deploy_configFileInvalid: "\u914D\u7F6E\u6587\u4EF6 {path} \u7B2C {line} \u884C\u683C\u5F0F\u6709\u8BEF\u3002\u8BF7\u68C0\u67E5\u7F29\u8FDB\u3001\u5192\u53F7\u548C\u5F15\u53F7\u540E\u91CD\u8BD5\u3002",
+  deploy_configFileUnreadable: "\u65E0\u6CD5\u8BFB\u53D6\u914D\u7F6E\u6587\u4EF6 {path}\uFF0C\u8BF7\u68C0\u67E5\u6587\u4EF6\u8DEF\u5F84\u4E0E\u8BFB\u53D6\u6743\u9650\u3002",
+  deploy_bundleNameInvalid: "\u90E8\u7F72\u5305\u6587\u4EF6\u540D\u53EA\u652F\u6301\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u70B9\u3001\u52A0\u53F7\u3001\u77ED\u6A2A\u7EBF\u548C\u4E0B\u5212\u7EBF\uFF1B\u6240\u5728\u76EE\u5F55\u53EF\u4EE5\u5305\u542B\u7A7A\u683C\u3002",
+  deploy_secretsInvalid: "\u4E2D\u95F4\u4EF6\u51ED\u636E\u6587\u4EF6\u635F\u574F\u6216\u7F3A\u5C11\u5B57\u6BB5\uFF1A{path}\u3002\u8BF7\u4ECE\u5907\u4EFD\u6062\u590D\uFF1B\u4E0D\u4F1A\u81EA\u52A8\u66F4\u6362\u5BC6\u7801\uFF0C\u4EE5\u514D\u5DF2\u6709\u6570\u636E\u65E0\u6CD5\u8BBF\u95EE\u3002"
 };
 
 // src/deploy-i18n.ts
@@ -177,11 +205,11 @@ var VercelProviderConfigSchema = z.object({
 });
 var SshConfigSchema = z.object({
   /** 远程主机地址或 ~/.ssh/config 中的 Host 别名 */
-  host: z.string().min(1),
+  host: z.string().regex(/^[a-z0-9][a-z0-9.:-]*$/i),
   /** SSH 端口 */
   port: z.number().int().min(1).max(65535).default(22),
   /** SSH 用户名 */
-  username: z.string().min(1),
+  username: z.string().regex(/^[a-z_][\w-]*$/i),
   /** 私钥文件路径（省略时使用 ssh-agent 或 ~/.ssh 默认密钥） */
   identityFile: z.string().min(1).optional(),
   /** known_hosts 文件路径（省略时使用默认；配合 CI/临时环境隔离主机指纹） */
@@ -206,7 +234,7 @@ var DockerSshProviderConfigSchema = z.object({
   /** 远程主机运行参数 */
   remote: z.object({
     /** 远程应用根目录 */
-    baseDir: z.string().min(1).default("/opt/hai/apps"),
+    baseDir: z.string().regex(/^\/[\w/. -]+$/).refine((value) => !value.split("/").includes("..")).default("/opt/hai/apps"),
     /** 远程容器运行时（auto 优先 podman） */
     runtime: z.enum(["auto", "docker", "podman"]).default("auto")
   }).default({ baseDir: "/opt/hai/apps", runtime: "auto" }),
@@ -305,10 +333,16 @@ function resolveConfig(value, prefix, env) {
 }
 function loadDeploymentConfig(name, path, values) {
   try {
-    const config = resolveConfig(parse(readFileSync(path, "utf8")), `HAI_${name.toUpperCase()}`, values);
+    const lineCounter = new LineCounter();
+    const document = parseDocument(readFileSync(path, "utf8"), { lineCounter, prettyErrors: false });
+    if (document.errors.length)
+      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_configFileInvalid", { params: { path, line: String(lineCounter.linePos(document.errors[0].pos[0]).line) } }));
+    const config = resolveConfig(document.toJS(), `HAI_${name.toUpperCase()}`, values);
+    if (config !== null && (typeof config !== "object" || Array.isArray(config)))
+      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_configFileInvalid", { params: { path, line: "1" } }));
     return ok(config && typeof config === "object" && !Array.isArray(config) ? config : {});
   } catch {
-    return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_environmentReadFailed"));
+    return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_configFileUnreadable", { params: { path } }));
   }
 }
 function loadDeploymentEnvironment(options) {
@@ -759,6 +793,7 @@ function maskSecrets(text, secrets) {
 function runCommand(command, args, options = {}) {
   return new Promise((resolve6) => {
     const child = spawn(command, args, {
+      windowsHide: true,
       cwd: options.cwd,
       env: options.env ? { ...process2.env, ...options.env } : process2.env,
       shell: false
@@ -787,6 +822,7 @@ function runCommand(command, args, options = {}) {
     }
     child.stdout.on("data", (chunk) => {
       stdout += chunk.toString("utf-8");
+      options.onOutput?.(maskSecrets(chunk.toString("utf-8"), options.secrets));
     });
     child.stderr.on("data", (chunk) => {
       stderr += chunk.toString("utf-8");
@@ -830,62 +866,393 @@ ${stderr || `exit ${exitCode}`}`, options.secrets).slice(-3e3) }
   });
 }
 
-// src/container/deploy-bundle.ts
+// src/container/deploy-scripts.ts
 function shellArgument(value) {
   return `'${value.replaceAll("'", `'"'"'`)}'`;
 }
-async function createDeploymentBundle(options) {
-  const { directory, artifactDir, artifact, projectName, environment, runtime, coreEnv } = options;
-  const stem = basename(options.output).replace(/\.tar$/i, "");
-  const versionSuffix = `-${artifact.appVersion}`;
-  const output = resolve(dirname(options.output), `${stem.endsWith(versionSuffix) ? stem : `${stem}${versionSuffix}`}.tar`);
-  const composeName = `docker-compose-${artifact.appVersion}.yml`;
-  mkdirSync(dirname(output), { recursive: true, mode: 448 });
-  const staging = mkdtempSync(join(directory, ".bundle-"));
-  chmodSync(staging, 448);
-  const temporaryTar = `${output}.partial`;
-  const startName = `start-${environment}.sh`;
-  try {
-    mkdirSync(join(staging, "images"));
-    for (const image of artifact.images)
-      copyFileSync(join(artifactDir, image.file), join(staging, "images", image.file));
-    for (const file of [composeName, ".env.runtime", ...artifact.images.some((image) => image.name === "web") ? ["web.conf"] : []])
-      copyFileSync(join(directory, file), join(staging, file));
-    const compose = parse(readFileSync(join(directory, composeName), "utf8"));
-    const images = [...new Set(Object.values(compose.services).flatMap((service) => service.image ? [service.image] : []))];
-    const start = `#!/bin/sh
+function createApplyScript(options) {
+  const values = {
+    ID: shellArgument(options.deploymentId),
+    PROJECT: shellArgument(`hai-${options.projectName}`),
+    ENV: shellArgument(options.environment),
+    RUNTIME: shellArgument(options.runtime),
+    PARTIAL: options.partial ? "true" : "false",
+    SELECTED: shellArgument(options.selected.join(" ")),
+    ROOT: shellArgument(options.directory),
+    PORT: String(options.hostPort),
+    HEALTH: options.healthPaths.map(shellArgument).join(" ")
+  };
+  return String.raw`#!/bin/sh
 set -eu
-cd "$(dirname "$0")"
 umask 077
-export HAI_DEPLOY_ENVIRONMENT=${shellArgument(environment)}
-export HAI_CORE_ENV=${shellArgument(coreEnv)}
-runtime=${shellArgument(runtime)}
-if [ -n "\${HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME:-}" ]; then runtime="$HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME"; fi
+source_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+destination=@@ROOT@@
+if [ "$#" -gt 0 ]; then destination=$1; fi
+root=$(mkdir -p -- "$destination" && CDPATH= cd -- "$destination" && pwd)
+id=@@ID@@
+project=@@PROJECT@@
+export HAI_DEPLOY_ENVIRONMENT=@@ENV@@
+runtime=@@RUNTIME@@
+partial=@@PARTIAL@@
+orphan_option=''
+if [ "$partial" = false ]; then orphan_option=--remove-orphans; fi
+recreate_option=--force-recreate
+if [ "$partial" = true ]; then recreate_option=--no-recreate; fi
+selected=@@SELECTED@@
+release="$root/releases/$id"
+case "$release/" in "$source_dir/"*) printf 'Extract the package outside the deployment directory before applying it.\n' >&2; exit 1;; esac
+stage=''
+previous=''
+restore=''
+changed=false
+locked=false
+started=$(date +%s)
+step_started=$started
+step() {
+  if [ -n "$stage" ]; then
+    duration=$(( $(date +%s) - step_started ))
+    printf '[PASS] %s (%ss)\n' "$stage" "$duration"
+    printf '{"stage":"%s","status":"passed","durationSeconds":%s}\n' "$stage" "$duration" >> "$root/steps-$id.jsonl"
+  fi
+  stage="$1"
+  step_started=$(date +%s)
+  printf '\n[%s] %s\n' "$stage" "$2"
+}
+compose() {
+  arguments_file="$release/compose-files"
+  if [ -n "$restore" ]; then arguments_file="$root/releases/$restore/compose-files"; fi
+  # -f 按顺序合并，由 Compose 保留未选服务、卷和环境文件，不自行拼装配置。
+  command_args="$release/.compose-command"
+  # 文件列表先反向读取，再向参数头部加入，保留原始合并顺序。
+  awk '{lines[NR]=$0} END {for(i=NR;i>0;i--) print lines[i]}' "$arguments_file" > "$command_args"
+  while IFS= read -r file; do set -- -f "$file" "$@"; done < "$command_args"
+  "$runtime" compose -p "$project" "$@"
+}
+remove_selected() {
+  test "$partial" = true || return 0
+  # 直接替换选中容器，避免 Compose Provider 连带重建依赖它的未选服务；不删除卷。
+  for service in "$@"; do
+    containers=$("$runtime" ps -aq --filter "label=com.docker.compose.project=$project" --filter "label=com.docker.compose.service=$service") || return 1
+    for container in $containers; do
+      "$runtime" rm -f "$container" || return 1
+    done
+  done
+}
+finish() {
+  code=$?
+  trap - EXIT HUP INT TERM
+  if [ "$code" -ne 0 ]; then
+    printf '[FAIL] %s (exit %s)\n' "$stage" "$code" >&2
+    if [ "$changed" = true ]; then
+      diagnostics="$root/diagnostics-$id.log"
+      : > "$diagnostics"
+      for service in $selected; do
+        containers=$("$runtime" ps -aq --filter "label=com.docker.compose.project=$project" --filter "label=com.docker.compose.service=$service" || true)
+        for container in $containers; do
+          "$runtime" inspect --format '{{.Name}} {{.State.Status}} exit={{.State.ExitCode}}' "$container" >> "$diagnostics" 2>&1 || true
+          "$runtime" logs --tail 80 "$container" >> "$diagnostics" 2>&1 || true
+        done
+      done
+      printf 'Startup diagnostics saved to %s (private server file).\n' "$diagnostics" >&2
+    fi
+    if [ -f "$release/rollback-images" ]; then
+      while IFS=' ' read -r image reference; do
+        test -n "$reference" || continue
+        "$runtime" tag "$image" "$reference" || printf '[FAIL] Cannot restore image %s\n' "$reference" >&2
+      done < "$release/rollback-images"
+    fi
+    if [ "$changed" = true ] && [ -n "$previous" ]; then
+      printf '[RECOVER] Restoring previous selected services\n' >&2
+      recover_selected=$selected
+      if [ "$partial" = false ]; then recover_selected=$(grep -v -- '-init$' "$root/releases/$previous/services"); fi
+      restore="$previous"
+      if remove_selected $recover_selected && compose up -d --no-deps --no-build --pull never "$recreate_option" $orphan_option $recover_selected; then
+        case " $selected " in *' app '*)
+          if grep -qx web "$root/releases/$previous/services"; then compose exec -T web nginx -s reload || true; fi
+          ;;
+        esac
+        printf '[RECOVER] Previous containers restored; verify application health\n' >&2
+      else
+        printf '[FAIL] Recovery failed. Use the previous release and inspect container logs.\n' >&2
+      fi
+    elif [ "$changed" = true ]; then
+      compose stop $selected || true
+      printf '[RECOVER] Failed first installation stopped; data volumes retained\n' >&2
+    fi
+  fi
+  if [ "$locked" = true ]; then
+    elapsed=$(( $(date +%s) - started ))
+    outcome=passed
+    if [ "$code" -ne 0 ]; then outcome=failed; fi
+    printf '{"stage":"%s","status":"%s","durationSeconds":%s}\n' "$stage" "$outcome" "$(( $(date +%s) - step_started ))" >> "$root/steps-$id.jsonl"
+    printf '{"deploymentId":"%s","stage":"%s","exitCode":%s,"durationSeconds":%s}\n' "$id" "$stage" "$code" "$elapsed" > "$root/result-$id.json"
+    rmdir "$root/.deploy-lock" || true
+  fi
+  exit "$code"
+}
+trap finish EXIT
+trap 'exit 130' HUP INT TERM
+step preflight 'Checking deployment tools and package'
+for tool in sha256sum tar awk curl; do command -v "$tool" >/dev/null || { printf 'Required command missing: %s\n' "$tool" >&2; exit 1; }; done
 if [ "$runtime" = auto ]; then
   if command -v podman >/dev/null 2>&1 && podman version >/dev/null 2>&1; then runtime=podman; else runtime=docker; fi
 fi
-case "$runtime" in docker|podman) ;; *) echo 'HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME must be docker or podman' >&2; exit 1;; esac
+case "$runtime" in docker|podman) ;; *) printf 'Runtime must be docker or podman\n' >&2; exit 1;; esac
 "$runtime" version >/dev/null
 "$runtime" compose version >/dev/null
+"$runtime" compose up --help | grep -q never || { printf 'Compose is too old. Install Docker Compose v2 or podman-compose 1.6.0 or newer (supports --pull never).\n' >&2; exit 1; }
+mkdir "$root/.deploy-lock" 2>/dev/null || { printf 'Another deployment is running. Check %s/.deploy-lock before retrying.\n' "$root" >&2; exit 1; }
+locked=true
+cd "$source_dir"
 sha256sum -c SHA256SUMS
-chmod 600 .env.runtime
-${artifact.images.map((image) => `"$runtime" load -i ${shellArgument(`images/${image.file}`)}`).join("\n")}
-# \u79BB\u7EBF\u670D\u52A1\u5668\u5E94\u5148\u5BFC\u5165\u5168\u90E8\u4E2D\u95F4\u4EF6\u955C\u50CF\uFF1B\u7981\u6B62\u9759\u9ED8\u5C1D\u8BD5\u8054\u7F51\u3002
-for image in ${images.map(shellArgument).join(" ")}; do
-  "$runtime" image inspect "$image" >/dev/null 2>&1 || { echo "Missing image: $image. Load the matching image archive before retrying." >&2; exit 1; }
+if [ -f "$root/current" ]; then
+  previous=$(cat "$root/current")
+  case "$previous" in ''|*[!a-zA-Z0-9._-]*) printf 'Invalid deployment state\n' >&2; exit 1;; esac
+  test -f "$root/releases/$previous/compose-files"
+fi
+if [ "$partial" = true ]; then
+  test -n "$previous" || { printf 'Partial deployment requires a successful full installation. Deploy a complete bundle first.\n' >&2; exit 1; }
+  cmp -s layout "$root/releases/$previous/layout" || { printf 'Ports, API routes or application layout changed. Create a full deployment bundle.\n' >&2; exit 1; }
+fi
+test ! -e "$release" || { printf 'This deployment ID was already used. Create a new deployment bundle.\n' >&2; exit 1; }
+mkdir -p "$release"
+cp -R "$source_dir/." "$release/"
+# Nginx 以非 root 用户运行；只开放不含凭据的代理配置读取权限。
+if [ -f "$release/web.conf" ]; then chmod 644 "$release/web.conf"; fi
+: > "$release/compose-files"
+if [ "$partial" = true ]; then
+  cp "$root/releases/$previous/compose-files" "$release/compose-files"
+  cp "$root/releases/$previous/middleware.env" "$release/middleware.env"
+  for service in $selected; do
+    grep -qx "$service" "$root/releases/$previous/services" || { printf 'Service %s has no installed baseline. Use a full deployment.\n' "$service" >&2; exit 1; }
+  done
+fi
+printf '%s\n' "$release/compose-entry.json" >> "$release/compose-files"
+compose config >/dev/null
+compose config --services > "$release/services"
+: > "$release/rollback-images"
+if [ -n "$previous" ]; then
+  for service in $selected; do
+    containers=$("$runtime" ps -aq --filter "label=com.docker.compose.project=$project" --filter "label=com.docker.compose.service=$service")
+    for container in $containers; do
+      "$runtime" inspect --format '{{.Image}} {{.Config.Image}}' "$container" >> "$release/rollback-images"
+    done
+  done
+fi
+step images 'Loading packaged images (no registry access)'
+while IFS=' ' read -r archive reference; do
+  test -n "$archive" || continue
+  "$runtime" load -i "$release/images/$archive"
+  "$runtime" image inspect "$reference" >/dev/null
+  architecture=$("$runtime" image inspect --format '{{.Architecture}}' "$reference")
+  host_arch=$(uname -m)
+  case "$host_arch:$architecture" in x86_64:amd64|aarch64:arm64) ;; *) printf 'Image architecture %s does not match server %s\n' "$architecture" "$host_arch" >&2; exit 1;; esac
+done < "$release/image-list"
+step dependencies 'Checking dependencies of selected services'
+if [ "$partial" = true ]; then cat "$release/services" >> "$release/dependencies"; fi
+while IFS= read -r dependency; do
+  test -n "$dependency" || continue
+  case "$dependency" in *-init) continue;; esac
+  case " $selected " in *" $dependency "*) continue;; esac
+  running=$("$runtime" ps -q --filter "label=com.docker.compose.project=$project" --filter "label=com.docker.compose.service=$dependency")
+  test -n "$running" || { printf 'Dependency %s is not running. Include it in a full deployment.\n' "$dependency" >&2; exit 1; }
+  for container in $running; do
+    test "$("$runtime" inspect --format '{{.State.Running}}' "$container")" = true || { printf 'Dependency %s is stopped. Start it before retrying.\n' "$dependency" >&2; exit 1; }
+  done
+done < "$release/dependencies"
+step start 'Updating selected services'
+changed=true
+remove_selected $selected
+if [ -f "$release/initialize-storage" ]; then
+  remove_selected storage-init
+  compose up -d --no-deps --no-build --pull never storage
+  compose up --no-deps --no-build --pull never "$recreate_option" --exit-code-from storage-init storage-init
+fi
+compose up -d --no-deps --no-build --pull never "$recreate_option" $orphan_option $selected
+case " $selected " in
+  *' app '*)
+    case " $selected " in *' web '*) ;; *)
+      if grep -qx web "$release/services"; then compose exec -T web nginx -s reload; fi
+    esac
+    ;;
+esac
+step health 'Checking HTTP access'
+for path in @@HEALTH@@; do
+  ready=false
+  attempt=0
+  while [ "$attempt" -lt 40 ]; do
+    if curl --noproxy '*' -fsS --max-time 5 "http://127.0.0.1:@@PORT@@$path" >/dev/null 2>&1; then ready=true; break; fi
+    attempt=$((attempt + 1))
+    sleep 3
+  done
+  test "$ready" = true || { printf 'HTTP check failed: %s. Inspect compose logs for selected services.\n' "$path" >&2; exit 1; }
 done
-exec "$runtime" compose -f ${shellArgument(composeName)} --env-file .env.runtime -p ${shellArgument(`hai-${projectName}`)} up -d
+step complete 'Deployment passed all checks'
+printf '%s\n' "$id" > "$root/current.next"
+mv "$root/current.next" "$root/current"
+printf '[PASS] %s\n' "$id"
+`.replace(/@@([A-Z]+)@@/g, (_match, name) => values[name]);
+}
+function createUploadScripts(config, bundle, projectName) {
+  const ssh = config.ssh;
+  const host = ssh?.host ?? "SERVER_HOST";
+  const user = ssh?.username ?? "deploy";
+  const remote = `${config.remote.baseDir}/${projectName}`;
+  const port = ssh?.port ?? 22;
+  const sh = String.raw`#!/bin/sh
+set -eu
+cd "$(dirname "$0")"
+host=@@HOST@@
+user=@@USER@@
+port=@@PORT@@
+remote=@@REMOTE@@
+bundle=@@BUNDLE@@
+if [ "$#" -ge 1 ]; then host=$1; fi
+if [ "$#" -ge 2 ]; then port=$2; fi
+if [ "$#" -ge 3 ]; then user=$3; fi
+identity=$(printenv HAI_DEPLOY_IDENTITY_FILE || true)
+if [ -z "$identity" ]; then identity=@@IDENTITY@@; fi
+test "$host" != SERVER_HOST || { printf 'Specify the server: sh deploy.sh SERVER [PORT] [USER].\n' >&2; exit 1; }
+for tool in ssh scp; do command -v "$tool" >/dev/null || { printf 'Install OpenSSH (%s).\n' "$tool" >&2; exit 1; }; done
+set -- -o BatchMode=yes -o StrictHostKeyChecking=@@STRICT@@ -o ConnectTimeout=10
+if [ -n "$identity" ]; then set -- "$@" -i "$identity"; fi
+known_hosts=@@KNOWN@@
+if value=$(printenv HAI_DEPLOY_KNOWN_HOSTS_FILE); then known_hosts=$value; fi
+if [ -n "$known_hosts" ]; then set -- "$@" -o "UserKnownHostsFile=$known_hosts"; fi
+printf '[1/3] Connecting to %s\n' "$host"
+ssh "$@" -p "$port" "$user@$host" "mkdir -p '$remote/incoming' && chmod 700 '$remote' '$remote/incoming'"
+printf '[2/3] Uploading %s\n' "$bundle"
+scp_host=$host
+case "$host" in *:*) scp_host="[$host]";; esac
+scp "$@" -P "$port" "$bundle" "$user@$scp_host:$remote/incoming/$bundle"
+printf '[3/3] Applying package and checking HTTP access\n'
+ssh "$@" -p "$port" "$user@$host" "cd '$remote/incoming' && mkdir -p '$bundle.contents' && tar -xf '$bundle' -C '$bundle.contents' && sh '$bundle.contents/apply.sh' '$remote'"
+`;
+  const ps1 = String.raw`param([string]$IdentityFile = $env:HAI_DEPLOY_IDENTITY_FILE)
+$ErrorActionPreference = 'Stop'
+Set-Location -LiteralPath $PSScriptRoot
+$target = Get-Content -LiteralPath './deploy-target.json' -Raw | ConvertFrom-Json
+if ($target.host -eq 'SERVER_HOST') { throw 'Set the server host in deploy-target.json.' }
+if ($target.host -notmatch '^[a-zA-Z0-9][a-zA-Z0-9.:-]*$' -or $target.username -notmatch '^[a-zA-Z_][a-zA-Z0-9_-]*$' -or $target.directory -notmatch '^/[a-zA-Z0-9/_. -]+$' -or $target.directory -match '(^|/)\.\.(/|$)' -or $target.bundle -notmatch '^[a-zA-Z0-9_.+-]+\.tar$') { throw 'Invalid deployment target.' }
+$options = @('-o', 'BatchMode=yes', '-o', 'StrictHostKeyChecking=accept-new', '-o', 'ConnectTimeout=10')
+if ($target.strictHostKeyChecking -eq $false) { $options[3] = 'StrictHostKeyChecking=no' }
+if (-not $IdentityFile) { $IdentityFile = $target.identityFile }
+if ($IdentityFile) { $options += @('-i', $IdentityFile) }
+if ($target.knownHostsFile) { $options += @('-o', "UserKnownHostsFile=$($target.knownHostsFile)") }
+$destination = "$($target.username)@$($target.host)"
+$scpDestination = if ($target.host.Contains(':')) { "$($target.username)@[$($target.host)]" } else { $destination }
+$remote = $target.directory
+$bundle = $target.bundle
+function Invoke-Step([string]$Name, [string]$Command, [string[]]$Arguments) {
+  Write-Host "[$Name]"
+  & $Command @Arguments
+  if ($LASTEXITCODE -ne 0) { throw "$Name failed (exit $LASTEXITCODE)." }
+}
+try {
+  foreach ($tool in @('ssh', 'scp')) { Get-Command $tool -ErrorAction Stop | Out-Null }
+  Invoke-Step '1/3 Connect' 'ssh' ($options + @('-p', [string]$target.port, $destination, "mkdir -p '$remote/incoming' && chmod 700 '$remote' '$remote/incoming'"))
+  Invoke-Step '2/3 Upload' 'scp' ($options + @('-P', [string]$target.port, $bundle, "$($scpDestination):$remote/incoming/$bundle"))
+  Invoke-Step '3/3 Apply and verify HTTP' 'ssh' ($options + @('-p', [string]$target.port, $destination, "cd '$remote/incoming' && mkdir -p '$bundle.contents' && tar -xf '$bundle' -C '$bundle.contents' && sh '$bundle.contents/apply.sh' '$remote'"))
+} catch { Write-Error $_; exit 1 }
 `;
-    writeFileSync(join(directory, startName), start, { mode: 448 });
-    writeFileSync(join(staging, startName), start, { mode: 448 });
-    const instructions = deployM("deploy_bundleInstructions", { params: { file: basename(output), start: startName, images: images.join("\n"), compose: composeName } });
-    const metadata = deployM("deploy_bundleMetadata", { params: { version: artifact.appVersion, buildId: artifact.buildId, compose: composeName } });
-    writeFileSync(join(staging, "README.txt"), `${metadata}
+  const values = { HOST: shellArgument(host), USER: shellArgument(user), PORT: String(port), REMOTE: shellArgument(remote), BUNDLE: shellArgument(bundle), IDENTITY: shellArgument(ssh?.identityFile ?? ""), KNOWN: shellArgument(ssh?.knownHostsFile ?? ""), STRICT: ssh?.strictHostKeyChecking === false ? "no" : "accept-new" };
+  return { sh: sh.replace(/@@([A-Z]+)@@/g, (_match, name) => values[name]), ps1 };
+}
+
+// src/container/deploy-bundle.ts
+async function createDeploymentBundle(options) {
+  const { directory, artifactDir, artifact, projectName, environment, config, selected } = options;
+  const stem = basename(options.output).replace(/\.tar$/i, "");
+  const suffix = `-${artifact.appVersion}`;
+  const output = resolve(dirname(options.output), `${stem.endsWith(suffix) ? stem : `${stem}${suffix}`}.tar`);
+  if (!/^[\w.+-]+\.tar$/.test(basename(output)))
+    throw new Error(deployM("deploy_bundleNameInvalid"));
+  const staging = mkdtempSync(join(directory, ".bundle-"));
+  const temporaryTar = `${output}.partial`;
+  mkdirSync(dirname(output), { recursive: true, mode: 448 });
+  chmodSync(staging, 448);
+  const files = [];
+  const put = (file, content) => {
+    mkdirSync(dirname(join(staging, file)), { recursive: true });
+    writeFileSync(join(staging, file), content, { mode: 384 });
+    files.push(file);
+  };
+  try {
+    mkdirSync(join(staging, "images"));
+    const compose = parse(readFileSync(join(directory, `docker-compose-${artifact.appVersion}.yml`), "utf8"));
+    const dependencies = /* @__PURE__ */ new Set();
+    const references = /* @__PURE__ */ new Set();
+    for (const name of selected) {
+      const service = compose.services[name];
+      if (!service)
+        throw new Error(deployM("deploy_selectionInvalid", { params: { service: name } }));
+      if (typeof service.image === "string")
+        references.add(service.image);
+      if (service.depends_on) {
+        for (const dependency of Array.isArray(service.depends_on) ? service.depends_on : Object.keys(service.depends_on))
+          dependencies.add(dependency);
+      }
+      if (service.env_file)
+        service.env_file = [`../${options.deploymentId}/.env.runtime`, `../${options.deploymentId}/middleware.env`];
+      if (Array.isArray(service.volumes))
+        service.volumes = service.volumes.map((mount) => typeof mount === "string" ? mount.replace("./web.conf:", `../${options.deploymentId}/web.conf:`) : mount);
+    }
+    put("compose.json", JSON.stringify({ ...compose, services: Object.fromEntries(selected.map((name) => [name, compose.services[name]])) }));
+    put("compose-entry.json", JSON.stringify({ ...compose, services: Object.fromEntries(selected.map((name) => [name, { extends: { file: `../${options.deploymentId}/compose.json`, service: name } }])) }));
+    let runtime;
+    const imageList = [];
+    for (const reference of references) {
+      if (!/:[^/:]+$/.test(reference) || /:latest$/i.test(reference))
+        throw new Error(deployM("deploy_imageVersionRequired", { params: { image: reference } }));
+      const built = artifact.images.find((image) => image.imageRef === reference);
+      const file = built?.file ?? `middleware-${imageList.length + 1}.tar`;
+      if (built) {
+        copyFileSync(join(artifactDir, file), join(staging, "images", file));
+      } else {
+        if (!runtime) {
+          const candidates = options.runtime === "auto" ? ["podman", "docker"] : [options.runtime];
+          for (const candidate of candidates) {
+            if ((await runCommand(candidate, ["version"])).success) {
+              runtime = candidate;
+              break;
+            }
+          }
+          if (!runtime)
+            throw new Error(deployM("deploy_bundleRuntimeRequired"));
+        }
+        if (!(await runCommand(runtime, ["image", "inspect", reference])).success) {
+          const pulled = await runCommand(runtime, ["pull", reference], { timeoutMs: 6e5 });
+          if (!pulled.success)
+            throw new Error(pulled.error.message);
+        }
+        const saved = await runCommand(runtime, ["save", ...runtime === "podman" ? ["--format", "docker-archive"] : [], "-o", join(staging, "images", file), reference], { timeoutMs: 6e5 });
+        if (!saved.success)
+          throw new Error(saved.error.message);
+      }
+      files.push(`images/${file}`);
+      imageList.push(`${file} ${reference}`);
+    }
+    put(".env.runtime", readFileSync(join(directory, ".env.runtime"), "utf8"));
+    put("middleware.env", options.middlewareEnv);
+    if (selected.includes("web"))
+      put("web.conf", readFileSync(join(directory, "web.conf"), "utf8"));
+    put("manifest.json", `${JSON.stringify({ ...artifact, images: artifact.images.filter((image) => references.has(image.imageRef)), deploymentId: options.deploymentId, selectedServices: selected, partial: options.partial }, null, 2)}
+`);
+    put("layout", `${config.expose.hostPort}:${options.containerPort}:${options.hasWeb}:${options.hasWeb ? await artifactChecksum(join(directory, "web.conf")) : ""}
+`);
+    put("image-list", `${imageList.join("\n")}
+`);
+    put("dependencies", `${[...dependencies].join("\n")}
+`);
+    if (selected.includes("storage-init"))
+      put("initialize-storage", "");
+    put("apply.sh", createApplyScript({ deploymentId: options.deploymentId, projectName, environment, directory: `${config.remote.baseDir}/${projectName}`, runtime: config.remote.runtime, partial: options.partial, selected: selected.filter((name) => name !== "storage-init"), hostPort: config.expose.hostPort, healthPaths: options.healthPaths }));
+    const instructions = deployM("deploy_bundleInstructions", { params: { file: basename(output), start: "apply.sh", images: [...references].join("\n"), compose: "compose.json" } });
+    put("README.txt", `${deployM("deploy_bundleMetadata", { params: { version: artifact.appVersion, buildId: artifact.buildId, compose: "compose.json" } })}
 ${instructions}
 `);
-    copyFileSync(join(artifactDir, "manifest.json"), join(staging, "manifest.json"));
     const checksums = [];
-    for (const file of [composeName, "manifest.json", ".env.runtime", startName, ...artifact.images.some((image) => image.name === "web") ? ["web.conf"] : [], ...artifact.images.map((image) => `images/${image.file}`)])
+    for (const file of files)
       checksums.push(`${await artifactChecksum(join(staging, file))}  ${file}`);
     writeFileSync(join(staging, "SHA256SUMS"), `${checksums.join("\n")}
 `);
@@ -893,25 +1260,33 @@ ${instructions}
     if (!tar.success)
       throw new Error(tar.error.message);
     chmodSync(temporaryTar, 384);
-    const { renameSync } = await import('fs');
     renameSync(temporaryTar, output);
-    return { bundlePath: output, instructions, startName };
+    const upload = createUploadScripts(config, basename(output), projectName);
+    const scripts = `${output.slice(0, -4)}-deploy`;
+    mkdirSync(scripts, { recursive: true, mode: 448 });
+    writeFileSync(join(scripts, "deploy.sh"), upload.sh.replace('cd "$(dirname "$0")"', 'cd "$(dirname "$0")/.."'), { mode: 448 });
+    writeFileSync(join(scripts, "deploy.ps1"), upload.ps1.replace("Set-Location -LiteralPath $PSScriptRoot", "Set-Location -LiteralPath (Split-Path -Parent $PSScriptRoot)").replace("'./deploy-target.json'", "(Join-Path $PSScriptRoot 'deploy-target.json')"));
+    writeFileSync(join(scripts, "deploy-target.json"), `${JSON.stringify({ ...config.ssh, host: config.ssh?.host ?? "SERVER_HOST", username: config.ssh?.username ?? "deploy", port: config.ssh?.port ?? 22, directory: `${config.remote.baseDir}/${projectName}`, bundle: basename(output) }, null, 2)}
+`);
+    writeFileSync(join(scripts, "README.txt"), instructions);
+    return { bundlePath: output, instructions: `${instructions}
+${scripts}`, startName: "apply.sh" };
   } finally {
     rmSync(staging, { recursive: true, force: true });
     rmSync(temporaryTar, { force: true });
   }
 }
 var IMAGES = {
-  postgres: "postgres:16-alpine",
-  mysql: "mysql:8.4",
-  redis: "redis:7-alpine",
+  postgres: "docker.io/library/postgres:16.15-alpine",
+  mysql: "docker.io/library/mysql:8.4.11",
+  redis: "docker.io/library/redis:7.4.11-alpine",
   rustfs: "ghcr.io/rustfs/rustfs:1.0.1",
   minio: "ghcr.io/coollabsio/minio:RELEASE.2025-10-15T17-29-55Z",
-  qdrant: "qdrant/qdrant:v1.12.4",
-  pgvector: "pgvector/pgvector:pg17",
-  chroma: "chromadb/chroma:1.5.5",
+  qdrant: "docker.io/qdrant/qdrant:v1.19.2",
+  pgvector: "docker.io/pgvector/pgvector:0.8.0-pg17",
+  chroma: "docker.io/chromadb/chroma:1.5.5",
   ldap: "docker.io/osixia/openldap:1.5.0",
-  smtp: "axllent/mailpit:v1.27.4"
+  smtp: "docker.io/axllent/mailpit:v1.27.4"
 };
 function generatePassword() {
   return randomBytes(24).toString("base64url");
@@ -920,8 +1295,12 @@ function resolveSidecarSecrets(appDir, projectName) {
   const secretFile = join(appDir, ".hai", "deploy", "runtime", `${projectName}.secrets.json`);
   if (existsSync(secretFile)) {
     try {
-      return JSON.parse(readFileSync(secretFile, "utf-8"));
+      const saved = JSON.parse(readFileSync(secretFile, "utf-8"));
+      if (!saved || !["dbPassword", "storagePassword", "ldapPassword"].every((key) => typeof saved[key] === "string" && saved[key].length > 0))
+        throw new Error("Invalid credentials");
+      return saved;
     } catch {
+      throw new Error(deployM("deploy_secretsInvalid", { params: { path: secretFile } }));
     }
   }
   const secrets = {
@@ -1089,6 +1468,28 @@ function planChromaVecdb(plan, projectName, net) {
   plan.env.HAI_VECDB = JSON.stringify({ type: "chroma", url: "http://vecdb:8000" });
 }
 function planSidecars(appDir, projectName, scan, provisionEnv, options, s3Engine = "rustfs") {
+  const serviceModes = { ...options?.serviceModes };
+  for (const requirement of scan.middlewares ?? []) {
+    if (options?.selectedServices && !options.selectedServices.includes(requirement.service))
+      continue;
+    const mode = serviceModes[requirement.envPrefix] ?? serviceModes[requirement.service];
+    if (mode !== "keep")
+      continue;
+    const endpoint = requirement.config.url ?? requirement.config.endpoint;
+    let host = requirement.config.host;
+    if (typeof endpoint === "string") {
+      try {
+        host = new URL(endpoint).hostname;
+      } catch {
+        continue;
+      }
+    }
+    if (host === requirement.service || ["sqlite", "local", "memory", "lancedb"].includes(requirement.backend)) {
+      serviceModes[requirement.envPrefix] = "default";
+      serviceModes[requirement.service] = "default";
+    }
+  }
+  options = { ...options, serviceModes };
   const plan = {
     services: [],
     composeServices: {},
@@ -1215,23 +1616,6 @@ function generateComposeFile(options) {
   };
   if (Object.keys(sidecar.volumes).length > 0)
     compose.volumes = sidecar.volumes;
-  if (options.previousCompose && options.serviceModes) {
-    const previous = parse(options.previousCompose);
-    for (const [service, mode] of Object.entries(options.serviceModes)) {
-      if (mode !== "keep")
-        continue;
-      for (const name of [service, `${service}-init`]) {
-        if (previous.services?.[name]) {
-          services[name] = previous.services[name];
-          app.depends_on = [.../* @__PURE__ */ new Set([...app.depends_on ?? [], service])];
-        }
-      }
-    }
-    const previousMounts = previous.services?.app?.volumes;
-    if (Array.isArray(previousMounts) && Object.values(options.serviceModes).includes("keep"))
-      app.volumes = [.../* @__PURE__ */ new Set([...app.volumes ?? [], ...previousMounts])];
-    compose.volumes = { ...previous.volumes, ...sidecar.volumes };
-  }
   if (services["storage-init"]) {
     app.depends_on = {
       ...Object.fromEntries((app.depends_on ?? []).map((name) => [name, { condition: "service_started" }])),
@@ -1318,14 +1702,15 @@ function buildScpUploadArgs(config, localPath, remotePath) {
     "-P",
     String(config.port),
     localPath,
-    `${config.username}@${config.host}:${remotePath}`
+    `${config.username}@${config.host.includes(":") ? `[${config.host}]` : config.host}:${remotePath}`
   ];
 }
 function createSshExecutor(config) {
   const exec = async (remoteCommand, options) => {
     return runCommand("ssh", buildSshExecArgs(config, remoteCommand), {
       timeoutMs: options?.timeoutMs,
-      secrets: options?.secrets
+      secrets: options?.secrets,
+      onOutput: options?.onOutput
     });
   };
   const upload = async (localPath, remotePath) => {
@@ -1414,11 +1799,23 @@ function createDockerSshProvider(config, container) {
     const images = artifact.images;
     const web = images.find((image) => image.name === "web");
     const app = images.find((image) => image.name === "app");
-    const containerPort = app.containerPort ?? config.expose.containerPort;
-    const url = config.ssh ? `http://${config.ssh.host}:${hostPort}` : `http://SERVER_HOST:${hostPort}`;
+    if (options?.selectedServices) {
+      const available = [...images.map((image) => image.name), ...scan.requiredServices];
+      const invalid = options.selectedServices.find((name) => !available.includes(name));
+      if (!options.selectedServices.length || new Set(options.selectedServices).size !== options.selectedServices.length || invalid)
+        return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_selectionInvalid", { params: { service: invalid ?? options.selectedServices.join(", ") } }));
+    }
+    const hasWeb = artifact.hasWeb || !!web;
+    const partial = artifact.partial || options?.selectedServices !== void 0;
+    const containerPort = app?.containerPort ?? artifact.appContainerPort ?? config.expose.containerPort;
+    const webContainerPort = web?.containerPort ?? artifact.webContainerPort ?? 8080;
+    const host = config.ssh?.host;
+    const url = host ? `http://${host.includes(":") ? `[${host}]` : host}:${hostPort}` : `http://SERVER_HOST:${hostPort}`;
     const { env, sidecar } = buildRuntimeEnv(appDir, projectName, scan, provisionEnv, containerPort, options, appEnv, container?.s3Engine);
+    if (sidecar.composeServices["storage-init"] && !app && options?.selectedServices?.includes("storage"))
+      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_storageArtifactRequired"));
     let webProxy;
-    if (web) {
+    if (hasWeb) {
       const server = loadDeploymentConfig("serv", join(appDir, "config", "_serv.yml"), env);
       if (!server.success)
         return server;
@@ -1427,12 +1824,10 @@ function createDockerSshProvider(config, container) {
       const apiPrefix = http?.apiPrefix ?? "/api/v1";
       if (typeof apiPrefix !== "string" || !/^\/[\w/-]+$/.test(apiPrefix))
         return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_webProxyInvalid"));
-      webProxy = generateWebProxyConfig(containerPort, apiPrefix, web.containerPort ?? 8080);
+      webProxy = generateWebProxyConfig(containerPort, apiPrefix, webContainerPort);
       env.HAI_SERV = JSON.stringify({ ...server.data, cors: { ...cors, origin: (!cors?.origin || cors.origin === "*") && config.ssh ? url : cors?.origin ?? "*" } });
     }
     const envPath = join(artifactDir, ".env.runtime");
-    const previousEnv = existsSync(envPath) ? parseEnv(readFileSync(envPath, "utf8")) : {};
-    Object.assign(env, { ...previousEnv, ...env });
     writeFileSync(envPath, serializeEnvFile(env), { mode: 384 });
     if (options?.environment) {
       const environment = loadDeploymentEnvironment({ environment: options.environment, envDir: options.envDir ?? scan.envDir ?? appDir });
@@ -1443,36 +1838,46 @@ function createDockerSshProvider(config, container) {
         return saved;
     }
     const composeName = `docker-compose-${artifact.appVersion}.yml`;
-    const latestPath = join(artifactDir, "latest");
-    const previousName = existsSync(latestPath) ? readFileSync(latestPath, "utf8").trim() : "";
-    const previousPath = /^[\w.+-]+\.yml$/.test(previousName) ? join(artifactDir, previousName) : void 0;
     const composeContent = generateComposeFile({
       projectName,
       appVersion: artifact.appVersion,
-      imageRef: app.imageRef,
+      imageRef: app?.imageRef ?? "localhost/hai-unselected:0",
       hostPort,
       containerPort,
       sidecar,
-      web: web ? { imageRef: web.imageRef, containerPort: web.containerPort ?? 8080 } : void 0,
-      serviceModes: options?.serviceModes,
-      previousCompose: previousPath && existsSync(previousPath) ? readFileSync(previousPath, "utf8") : void 0
+      web: hasWeb ? { imageRef: web?.imageRef ?? "localhost/hai-unselected:0", containerPort: webContainerPort } : void 0
     });
     const composePath = join(artifactDir, composeName);
     writeFileSync(composePath, composeContent);
     if (webProxy)
       writeFileSync(join(artifactDir, "web.conf"), webProxy);
+    const selected = options?.selectedServices ? [...options.selectedServices] : artifact.partial ? images.map((image) => image.name) : [...images.map((image) => image.name), ...Object.keys(sidecar.composeServices)];
+    if (!selected.length || selected.some((name) => !/^[a-z][a-z0-9-]*$/.test(name)) || new Set(selected).size !== selected.length)
+      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_selectionInvalid", { params: { service: selected.join(", ") } }));
+    for (const name of selected) {
+      if (["app", "web"].includes(name) && !images.some((image) => image.name === name))
+        return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_selectionInvalid", { params: { service: name } }));
+    }
+    if (selected.includes("storage") && sidecar.composeServices["storage-init"] && !selected.includes("storage-init"))
+      selected.push("storage-init");
+    options?.onProgress?.("packaging");
     const bundle = await createDeploymentBundle({
       directory: artifactDir,
       artifactDir: resolvedBuildDir,
       artifact,
       projectName,
       environment: options?.environment ?? "prod",
-      runtime: config.remote.runtime,
-      coreEnv: env.HAI_CORE_ENV ?? "production",
+      deploymentId,
+      config,
+      runtime: options?.runtime ?? "auto",
+      selected,
+      partial,
+      hasWeb,
+      containerPort,
+      middlewareEnv: serializeEnvFile(sidecar.env),
+      healthPaths: hasWeb ? ["/health", "/_hai/web-health", "/"] : [scan.isSvelteKit ? "/" : "/health"],
       output: options?.output ?? join(artifactDir, `bundle-${projectName}-${deploymentId}-${artifact.appVersion}.tar`)
     });
-    writeFileSync(latestPath, `${composeName}
-`);
     if (options?.bundleOnly)
       return ok({ url: "", deploymentId, status: "packaged", provider: "docker-ssh", healthCheck: "skipped", envVarsSet: Object.keys(env), ...bundle });
     if (!ssh)
@@ -1484,22 +1889,31 @@ function createDockerSshProvider(config, container) {
     if (!remoteRuntime.success)
       return remoteRuntime;
     const remoteDir = `${baseDir}/${projectName}`;
-    const remoteTar = `${remoteDir}/${basename(bundle.bundlePath)}`;
-    const prepared = await ssh.exec(`mkdir -p -- ${shellArgument(remoteDir)} && chmod 700 -- ${shellArgument(remoteDir)}`);
+    const remoteTar = `${remoteDir}/incoming/${basename(bundle.bundlePath)}`;
+    const prepared = await ssh.exec(`mkdir -p -- ${shellArgument(`${remoteDir}/incoming`)} && chmod 700 -- ${shellArgument(remoteDir)} ${shellArgument(`${remoteDir}/incoming`)}`);
     if (!prepared.success)
       return prepared;
     const uploaded = await ssh.upload(bundle.bundlePath, remoteTar);
     if (!uploaded.success)
       return uploaded;
+    let pendingOutput = "";
     const started = await ssh.exec(
-      `cd ${shellArgument(remoteDir)} && chmod 600 ${shellArgument(remoteTar)} && tar -xf ${shellArgument(remoteTar)} && HAI_DEPLOY_PROVIDER_REMOTE_RUNTIME=${shellArgument(remoteRuntime.data)} sh ${shellArgument(bundle.startName)}`,
-      { timeoutMs: 3e5, secrets: sidecar.secrets }
+      `mkdir -p ${shellArgument(`${remoteTar}.contents`)} && chmod 600 ${shellArgument(remoteTar)} && tar -xf ${shellArgument(remoteTar)} -C ${shellArgument(`${remoteTar}.contents`)} && sh ${shellArgument(`${remoteTar}.contents/${bundle.startName}`)} ${shellArgument(remoteDir)}`,
+      { timeoutMs: 6e5, secrets: sidecar.secrets, onOutput: (output) => {
+        pendingOutput += output;
+        const lines = pendingOutput.split("\n");
+        pendingOutput = lines.pop() ?? "";
+        for (const line of lines) {
+          const stage = /^\[(preflight|images|dependencies|start|health|complete)\]/.exec(line)?.[1];
+          if (stage)
+            options?.onProgress?.(stage);
+        }
+      } }
     );
     if (!started.success)
       return started;
-    await ssh.exec(`rm -f -- ${shellArgument(remoteTar)} ${images.map((image) => shellArgument(`${remoteDir}/images/${image.file}`)).join(" ")}`);
     logger5.info("Running health check", { url });
-    const healthy = await healthCheck(`${url}${!web && scan.isSvelteKit ? "/" : "/health"}`) && (!web || await healthCheck(`${url}/_hai/web-health`) && await healthCheck(`${url}/`));
+    const healthy = await healthCheck(`${url}${!hasWeb && scan.isSvelteKit ? "/" : "/health"}`) && (!hasWeb || await healthCheck(`${url}/_hai/web-health`) && await healthCheck(`${url}/`));
     if (!healthy) {
       return err(
         HaiDeployError.HEALTH_CHECK_FAILED,
@@ -1523,7 +1937,8 @@ function createDockerSshProvider(config, container) {
       return await deploy2(context);
     } catch (error) {
       logger5.error("Deployment bundle failed", { error });
-      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_artifactInvalid"), error);
+      const reason = error instanceof Error ? error.message : String(error);
+      return err(HaiDeployError.DEPLOY_FAILED, deployM("deploy_bundleFailed", { params: { reason: maskSecrets(reason, Object.values(context.appEnv ?? {}).filter((value) => value.length > 6)) } }), error);
     }
   };
   return { name: "docker-ssh", deploy: deploySafely };
@@ -2502,11 +2917,19 @@ var deploy = {
       ...scanOptions.environment ? { environment: environment.data.environment } : {},
       ...options?.skipMiddleware ? { serviceModes: Object.fromEntries(scan.requiredServices.map((service) => [service, "keep"])) } : {}
     };
+    if (options.selectedServices) {
+      options.serviceModes = {
+        ...options.serviceModes,
+        ...Object.fromEntries(scan.requiredServices.filter((service) => !options.selectedServices.includes(service)).map((service) => [service, "keep"]))
+      };
+    }
     if (currentContainerProvider) {
       return deployContainerApp(currentContainerProvider, appDir, scan, projectName, options, appEnv);
     }
     if (options?.bundleOnly)
       return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_bundleOnlyContainer"));
+    if (options.selectedServices)
+      return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_selectedContainerOnly"));
     if (!currentProvider) {
       return notInitialized.result();
     }
@@ -2579,6 +3002,17 @@ async function deployContainerApp(provider, appDir, scan, rawProjectName, option
   } catch {
     return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_artifactInvalid"));
   }
+  if (artifact.partial && !options?.selectedServices) {
+    const selectedServices = artifact.images.map((image) => image.name);
+    options = {
+      ...options,
+      selectedServices,
+      serviceModes: {
+        ...options?.serviceModes,
+        ...Object.fromEntries(scan.requiredServices.map((service) => [service, "keep"]))
+      }
+    };
+  }
   if (!options?.bundleOnly && currentConfig?.provider.type === "docker-ssh" && !currentConfig.provider.ssh)
     return err(HaiDeployError.CONFIG_ERROR, deployM("deploy_sshRequired"));
   let provisionEnv = {};