@h-ai/deploy 1.0.0-beta.17 → 1.0.0-beta.18

package/README.en.md

@@ -27,6 +27,8 @@ pnpm build --target image --images web
 pnpm build --target desktop --platform windows --arch x64
 ```
 
+Automation can select the exact build using `artifactDir` from `hai build --target image --json`. `readDeploymentArtifact` verifies archive paths and SHA-256 checksums, and returns source commit, dirty state and image platforms when present. Older manifests may omit those fields.
+
 #### Build options
 
 `--target` selects compile (default), image, app or desktop. `--images serv|web|serv,web` selects images. `--runtime auto|podman|docker` selects the local engine; auto prefers reachable Podman. `--network` overrides build networking, `--no-http-proxy` disables this build proxy (same as --proxy-mode none), and `--sqlite-prebuild-mirror` selects a trusted HTTP(S) binary mirror. Native `--platform` and `--arch` require the matching host SDK and Rust toolchain. Builds do not load deployment environments or runtime secrets.

package/README.ja.md

@@ -27,6 +27,8 @@ pnpm build --target image --images web
 pnpm build --target desktop --platform windows --arch x64
 ```
 
+自動化では `hai build --target image --json` の `artifactDir` で今回の成果物を指定できます。`readDeploymentArtifact` はアーカイブのパスと SHA-256 を検証し、マニフェストに含まれるソースコミット、変更状態、イメージのプラットフォームを返します。過去のマニフェストではこれらの項目を省略できます。
+
 #### build のオプション
 
 `--target` は compile（既定）、image、app、desktop を選択します。`--images serv|web|serv,web` は対象イメージを、`--runtime auto|podman|docker` はローカルエンジンを選択します。auto は接続可能な Podman を優先します。`--network` は構築ネットワーク、`--no-http-proxy` は 今回のビルドのプロキシ無効（none と同じ）、`--sqlite-prebuild-mirror` は信頼できる HTTP(S) バイナリ配布元です。ネイティブ配布物には対象 OS の SDK と Rust ツールチェーンが必要です。構築時にデプロイ環境や秘密情報を読み込みません。

package/README.md

@@ -27,6 +27,8 @@ pnpm build --target image --images web
 pnpm build --target desktop --platform windows --arch x64
 ```
 
+自动化可使用 `hai build --target image --json` 的 `artifactDir` 指定本次构建。`readDeploymentArtifact` 校验归档路径及 SHA-256，并返回清单中的来源提交、工作区状态和镜像平台；历史清单可以省略这些字段。
+
 源码编译、镜像构建、桌面打包分别对应 compile/image/desktop。构建不选择部署环境、不注入运行期密钥。原生安装包在对应操作系统准备 SDK 与 Rust 工具链后构建。
 
 #### build 的可选参数

package/dist/index.d.ts

@@ -24,6 +24,10 @@ declare const DeploymentArtifactSchema: z.ZodObject<{
     }>;
     appVersion: z.ZodString;
     buildId: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        commit: z.ZodString;
+        dirty: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strip>>;
     partial: z.ZodDefault<z.ZodBoolean>;
     hasWeb: z.ZodDefault<z.ZodBoolean>;
     webBasePath: z.ZodOptional<z.ZodString>;
@@ -37,6 +41,7 @@ declare const DeploymentArtifactSchema: z.ZodObject<{
         file: z.ZodString;
         imageRef: z.ZodString;
         sha256: z.ZodString;
+        platform: z.ZodOptional<z.ZodString>;
         containerPort: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/index.js

@@ -29,6 +29,13 @@ var DeploymentArtifactSchema = z.object({
   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),
   /** 本次构建标识；同一应用版本允许重复构建。 */
   buildId: z.string().max(128).regex(/^[a-z0-9][\w.+-]*$/i),
+  /** 构建启动时观察到的 Git 来源；历史清单可以省略。 */
+  source: z.object({
+    /** 工程 package.json 所在仓库的提交 SHA；无法确定时为 unknown。 */
+    commit: z.string().regex(/^(?:[a-f0-9]{40}|[a-f0-9]{64}|unknown)$/),
+    /** 工程目录有未提交改动时为 true；无法检查时为 null。 */
+    dirty: z.boolean().nullable()
+  }).optional(),
   /** 只包含所选镜像的构建不能用于首次安装。 */
   partial: z.boolean().default(false),
   /** 是否包含浏览器端；仅构建 serv 时也保留完整工程的 Web 拓扑。 */
@@ -49,6 +56,8 @@ var DeploymentArtifactSchema = z.object({
     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}$/),
+    /** 引擎实际构建的镜像 OS/架构；历史清单可以省略。 */
+    platform: z.string().regex(/^[a-z0-9][a-z0-9_.-]*\/[a-z0-9][a-z0-9_.-]*$/).optional(),
     /** 容器内部监听端口；服务器公开端口由部署选择。 */
     containerPort: z.number().int().min(1).max(65535).optional()
   })).min(1).max(2).refine((images) => new Set(images.map((image) => image.name)).size === images.length)
@@ -2483,6 +2492,18 @@ var deploy_config_shapes_default = {
                     type: "string",
                     pattern: "^[A-Z_]\\w*$"
                   }
+                },
+                gitEnvironmentRefs: {
+                  default: {},
+                  type: "object",
+                  propertyNames: {
+                    type: "string",
+                    pattern: "^[A-Z_]\\w*$"
+                  },
+                  additionalProperties: {
+                    type: "string",
+                    pattern: "^[A-Z_]\\w*$"
+                  }
                 }
               },
               required: [