create-windy 0.6.6 → 0.6.7

package/dist/cli.js

@@ -3282,6 +3282,7 @@ License \u7B7E\u53D1\u4E2D\u5FC3\u3001\u72EC\u7ACB\u7B7E\u540D\u670D\u52A1\u3001
 ${includeStorage ? "- \u5927\u62A5\u544A\u5BFC\u5165\uFF1A[\u53D7\u6CBB\u7406\u7684\u5927\u62A5\u544A\u6682\u5B58](./architecture/report-staging.md)\u3002" : ""}
 ${includeOfflineLicense ? "- License \u6D88\u8D39\u7AEF\uFF1A[\u79BB\u7EBF\u6FC0\u6D3B\u4E0E\u5B89\u88C5\u534F\u8BAE](./license/license-offline-activation-code.md)\uFF1B\u8FD0\u884C\u65F6\u80FD\u529B\u7531 npm \u4F9D\u8D56 `@southwind-ai/license` \u63D0\u4F9B\u3002" : ""}
 - \u8FD0\u7EF4\uFF1A[\u53EF\u89C2\u6D4B\u6027](./operations/observability.md)${includeOperations ? " \u4E0E [\u8FD0\u7EF4\u603B\u89C8](./platform/operations-overview.md)" : ""}\u3002
+- \u4EA4\u4ED8\uFF1A[\u6309 registry digest \u4E0E OCI blob \u5DEE\u91CF\u53D1\u5E03](./operations/incremental-delivery.md)\u3002
 ${includeAgent ? "- Agent\u3001\u591A\u6A21\u6001 Runtime \u4E0E MCP\uFF1A[Agent Runtime \u63A5\u5165](./platform/agent-runtime.md)\u3001[Document AI Runtime](./platform/document-ai-runtime.md)\u3001[Speech AI Runtime](./platform/speech-ai-runtime.md)\u3001[\u53D7\u63A7\u5DE5\u5177](./platform/agent-tools.md)\u4E0E[MCP \u4E1A\u52A1\u80FD\u529B](./architecture/mcp-business-capabilities.md)\u3002" : ""}
 - \u517C\u5BB9\uFF1A[RuoYi-Vue Adapter](./adapters/ruoyi-vue-compatibility.md)\u3002
 `;
@@ -3659,6 +3660,7 @@ var templateDirectories = [
   "packages/config",
   "packages/crud-generator",
   "packages/database",
+  "packages/delivery",
   "packages/example-work-order",
   "packages/jobs",
   "packages/modules",
@@ -3694,6 +3696,7 @@ var templateDocumentationFiles = [
   "docs/development/module-lifecycle.md",
   "docs/license/license-offline-activation-code.md",
   "docs/operations/observability.md",
+  "docs/operations/incremental-delivery.md",
   "docs/platform/agent-run-attestation.md",
   "docs/platform/agent-tools.md",
   "docs/platform/agent-runtime.md",
@@ -7784,6 +7787,11 @@ var recipes = [
     id: "starter-0.6.5-to-0.6.6",
     from: "0.6.5",
     to: "0.6.6"
+  },
+  {
+    id: "starter-0.6.6-to-0.6.7",
+    from: "0.6.6",
+    to: "0.6.7"
   }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "aebc81cd3a97d7bc3f13c600afb7dc13bbf9c3d0",
-  "generatorVersion": "0.6.6",
+  "templateCommit": "dcc27b44de561eb3b4e6f9aea7869ba0f4299a62",
+  "generatorVersion": "0.6.7",
   "modules": [
     {
       "name": "system",

package/template/apps/server/Dockerfile

@@ -15,6 +15,7 @@ COPY packages/config/package.json packages/config/package.json
 COPY packages/create-windy/package.json packages/create-windy/package.json
 COPY packages/crud-generator/package.json packages/crud-generator/package.json
 COPY packages/database/package.json packages/database/package.json
+COPY packages/delivery/package.json packages/delivery/package.json
 COPY packages/example-work-order/package.json packages/example-work-order/package.json
 COPY packages/jobs/package.json packages/jobs/package.json
 COPY packages/license-sdk/package.json packages/license-sdk/package.json
@@ -35,8 +36,8 @@ RUN set -eu; \
     echo "$WINDY_DEBIAN_MIRROR" | grep -Eq '^https?://[A-Za-z0-9./:_-]+$'; \
     echo "$WINDY_DEBIAN_SECURITY_MIRROR" | grep -Eq '^https?://[A-Za-z0-9./:_-]+$'; \
     sed -i "s|http://deb.debian.org/debian-security|$WINDY_DEBIAN_SECURITY_MIRROR|g; s|http://deb.debian.org/debian|$WINDY_DEBIAN_MIRROR|g" /etc/apt/sources.list.d/debian.sources; \
-    if ! timeout --kill-after=5s 90s sh -c 'apt-get update -o Acquire::http::AllowRedirect=false -o Acquire::http::Timeout=30 -o Acquire::https::Timeout=30 -o Acquire::Retries=0 && DEBIAN_FRONTEND=noninteractive apt-get install --no-install-recommends --yes build-essential libarchive-dev libarchive-tools'; then \
-      echo "APT 包源不可用或 90 秒总时限已到：无法安装 report-staging 依赖" >&2; exit 70; \
+    if ! timeout --kill-after=5s 180s sh -c 'apt-get update -o Acquire::http::AllowRedirect=false -o Acquire::http::Timeout=30 -o Acquire::https::Timeout=30 -o Acquire::Retries=0 && DEBIAN_FRONTEND=noninteractive apt-get install --no-install-recommends --yes build-essential libarchive-dev libarchive-tools'; then \
+      echo "APT 包源不可用或 180 秒总时限已到：无法安装 report-staging 依赖" >&2; exit 70; \
     fi
 # @windy-module system.storage end
 COPY drizzle.config.ts drizzle.config.ts

package/template/apps/server/src/ai-runtime-report/actor-handle.test.ts

@@ -17,8 +17,9 @@ describe("AI Runtime Actor handle", () => {
   test("篡改或更换密钥后 fail closed", () => {
     const codec = new AiRuntimeActorHandleCodec("internal-token-for-tests");
     const handle = codec.issue("user-1");
+    const tampered = `${handle.slice(0, -1)}${handle.endsWith("A") ? "B" : "A"}`;
 
-    expect(codec.verify(`${handle.slice(0, -1)}A`)).toBeUndefined();
+    expect(codec.verify(tampered)).toBeUndefined();
     expect(
       new AiRuntimeActorHandleCodec("different-internal-token").verify(handle),
     ).toBeUndefined();

package/template/apps/web/Dockerfile

@@ -15,6 +15,7 @@ COPY packages/config/package.json packages/config/package.json
 COPY packages/create-windy/package.json packages/create-windy/package.json
 COPY packages/crud-generator/package.json packages/crud-generator/package.json
 COPY packages/database/package.json packages/database/package.json
+COPY packages/delivery/package.json packages/delivery/package.json
 COPY packages/example-work-order/package.json packages/example-work-order/package.json
 COPY packages/jobs/package.json packages/jobs/package.json
 COPY packages/license-sdk/package.json packages/license-sdk/package.json

package/template/docs/operations/incremental-delivery.md

@@ -0,0 +1,213 @@
+# 增量交付与确定性归档
+
+Windy 的交付传输层提供两条增量路径，并保留完整 bundle 作为兼容和真正离线
+fallback。传输层只改变“镜像字节如何到达目标机”，不会替代现有部署事务中的数据库
+备份、volume 冻结、migration、readiness、安装账本原子提交和失败回滚。
+
+## 不变量
+
+- release manifest 绑定完整 Git SHA、目标平台、镜像角色、镜像 config digest、registry
+  digest、Docker archive 文件图和所有内容 blob。
+- 在线镜像事实必须是 `repository@sha256:<64 hex>`；tag 仅可作为发布入口，不能写入
+  安装账本或作为已部署版本证明。
+- V2 manifest 自身在传输前计算 SHA-256，目标机在 stage 前重新计算。每个 blob 同时
+  校验声明尺寸和 SHA-256；缺失、损坏、重复路径、路径穿越或 schema 不支持都会停止。
+- blob 传输完成不等于部署完成。只有旧部署事务完成备份、镜像 load/pull、migration、
+  readiness 和账本提交后，release 才生效。
+- 失败的传输保留已校验完整 blob 和合法 partial，以便续传；失败 stage 会删除自己的
+  nonce 目录，不会删除当前 release、备份或其它 owner 的资源。
+
+## Manifest V2
+
+`DeliveryManifestV2` 使用 `schemaVersion=2` 和 `minimumReaderVersion=2`。核心字段为：
+
+- `images[]`：稳定 role、platform、Docker config digest，以及可选的 registry repository
+  与 manifest digest、layer digest/size；repository 不允许包含 tag、digest、scheme 或
+  凭据。config、manifest 和 layer descriptor 必须绑定归档中的同一内容 blob。
+- `dockerArchive`：格式固定为 `oci-image-layout-v1`；`entries[]` 绑定重建离线 OCI image
+  layout 所需的相对路径、内容 digest、size 和 mode。
+- `releaseFiles[]`：除 `images.tar` 外的完整 release 文件图；stage 会连同重建的
+  `images.tar` 一起原子落盘，不只生成镜像归档。
+- `blobs[]`：去重后的内容寻址集合；多个 archive entry 可复用同一个 blob。
+- `compatibility.fullBundle`：可选 V1 完整 bundle 的文件名、digest 和 size。
+
+reader 必须先协商能力：
+
+1. 目标支持 registry digest 且 manifest 中每个镜像都有 registry 事实时，优先在线拉取。
+2. 否则，双方支持 V2、blob delta 和 resumable transfer 时，使用 SSH blob 差量。
+3. 否则，只有 manifest 显式携带 V1 fallback 时才回退完整 bundle。
+4. 没有共同 schema 时直接失败；不得把未知 V2 当成 V1，也不得静默上传完整包。
+
+## 在线 registry 路径
+
+发布端把镜像推送到标准 OCI Registry（腾讯云 TCR 等），冻结 registry 返回的 manifest
+digest。目标机按 digest pull：
+
+```text
+ccr.ccs.tencentyun.com/example/windy-server@sha256:...
+```
+
+Docker/Containerd 会根据本地 content store 只下载缺失 layer。pull 后必须再次 inspect，
+确认目标 `repo@digest` 的 image config digest 与 manifest 一致，再把 digest-pinned image
+变量交给现有部署事务。Registry 登录由 Docker credential helper 或目标机受控 Secret
+管理；manifest、日志和统计不得包含用户名、密码、token、签名 URL 或 Docker config。
+
+在线统计以 OCI descriptor 为单位记录总 bytes/blob、已存在 bytes/blob 和 Docker 报告
+`Pull complete` 的 descriptor bytes/blob。当前 `pull-registry` 无法从 Docker CLI 审计
+部分缓存、续传及 HTTP/manifest/config 协议开销，因此 `uploadedBytes` 与
+`uploadedBlobs` 明确返回 `null`，另以 `descriptorPulledBytes` /
+`descriptorPulledBlobs` 报告 descriptor 状态；不得把它冒充精确网络字节。无法取得逐
+layer 状态时直接失败，也不用镜像虚拟大小估算。
+
+目标机执行示例：
+
+```bash
+manifest_digest="$(tr -d '\n' < ./DELIVERY-MANIFEST.sha256)"
+bun run delivery:remote -- pull-registry \
+  --manifest-digest "$manifest_digest" \
+  < ./delivery-manifest.v2.json
+```
+
+命令只接受 manifest 中的 `repository@digest`，pull 后用 Docker image config digest 二次
+验真，再输出 descriptor 总量、复用量与上述可审计性标记。镜像推送与
+digest 冻结由发布流水线的 OCI Registry adapter 完成；adapter 必须把 Registry 返回的
+manifest digest 和 descriptor size 写入 `images.json`，不能把输入 tag 当作冻结事实。
+
+## SSH / 离线 blob 差量
+
+生成物中的 `@southwind-ai/delivery` 是 Starter 私有 workspace package。远端命令入口：
+
+```bash
+bun run delivery:remote -- capabilities
+```
+
+协调器的协议顺序固定为：
+
+1. 调用 `capabilities`，协商 schema 和传输方式。
+2. 在安装根目录用原子 `mkdir` 获取 `.delivery-lock`，写入随机 owner token；并发部署失败。
+3. 把 manifest 的 blob 描述发送给 `inventory`。远端逐个重新计算尺寸和 SHA-256，损坏
+   blob 不计为复用。
+4. 对缺失 blob 调用 `partial` 获取已落盘 offset。发送端只从该 offset 继续；接收端要求
+   offset 精确相等、每段 `fsync`，完整后校验 digest 并原子 rename。
+5. `stage` 重新验证 manifest 和所有 blob，检查空间预算，在随机 nonce 目录重建确定性
+   OCI `images.tar` 与其余 release 文件，并验证 `CHECKSUMS.sha256` 的精确集合和每个
+   digest，再把包含 `release/` 与 delivery sidecar 的目录原子 rename 到
+   `releases/<releaseId>`。既有部署事务只消费其中的 `release/`，delivery sidecar 不污染
+   原 verifier 的文件集合。
+6. 释放 owner 匹配的锁。后续由项目既有 `update-offline` 或生产发布事务消费 stage 目录。
+
+远端低层命令使用 stdin 传 manifest/blob 列表和 blob bytes，不把内容放入 shell 参数。
+本地 `SshProcessTransport` 用参数数组调用 `ssh`，目标、二进制和远端路径均先做字符与
+路径边界校验。错误输出会截断并脱敏 credential marker。
+
+`packages/delivery/bin/windy-delivery` 是受管的远端 launcher；它不注册为 workspace
+package `bin`，避免 fresh `bun install` 改写受管源码的 POSIX mode。第一次启用 V2 前，
+从已验真的 Starter/release SHA 把整个 `packages/delivery` 安装到版本目录，再原子切换
+稳定入口（以下命令在目标 Linux 上执行）：
+
+```bash
+sudo install -d -m 0755 /opt/windy/runtime /opt/windy/bin
+sudo cp -R ./packages/delivery /opt/windy/runtime/delivery-0.6.7.tmp
+sudo chmod 0555 /opt/windy/runtime/delivery-0.6.7.tmp/bin/windy-delivery
+sudo mv /opt/windy/runtime/delivery-0.6.7.tmp \
+  /opt/windy/runtime/delivery-0.6.7
+sudo ln -s /opt/windy/runtime/delivery-0.6.7/bin/windy-delivery \
+  /opt/windy/bin/windy-delivery.next
+sudo mv -Tf /opt/windy/bin/windy-delivery.next \
+  /opt/windy/bin/windy-delivery
+/opt/windy/bin/windy-delivery capabilities
+```
+
+版本目录必须来自已经校验的 release，不从 registry tag、临时工作树或目标机网络重新
+生成。若目标还没有 launcher，能力探测只允许按下文显式回退 V1 完整 bundle；SSH
+鉴权、权限、摘要或原子切换失败都不得降级。保留上一版本目录，直到新 launcher 完成
+`capabilities` 与一次部署事务；回滚只需把稳定 symlink 原子切回上一版本。
+
+空间预算在上传缺失 blob 前执行，分别检查 blob store 与 install root 所在文件系统；同一
+挂载点按缺失 blob、完整 release、delivery sidecar、重建 OCI archive 的
+header/padding/payload 和 512 MiB 默认安全余量合并预算，不同挂载点分别 fail closed。
+blob store 的保留/回收策略必须以已提交 release、
+previous release 和未过期 partial 的引用闭包为依据；不得用目录 mtime 猜测后直接删除。
+
+V2 差量示例（`auto` 在具备 registry facts 时只返回 `registry-preferred`，不会暗中改走
+SSH；需要 SSH 时显式选择 `blob-delta`）：
+
+```bash
+manifest_digest="$(tr -d '\n' < ./DELIVERY-MANIFEST.sha256)"
+bun run delivery:remote -- sync-ssh \
+  --manifest ./delivery-manifest.v2.json \
+  --manifest-digest "$manifest_digest" \
+  --store . \
+  --target deploy@example.internal \
+  --remote-binary /opt/windy/bin/windy-delivery \
+  --remote-store /opt/windy/blob-store \
+  --remote-install-root /opt/windy \
+  --remote-fallback-root /opt/windy/fallback \
+  --mode blob-delta
+```
+
+旧端或显式兼容模式使用同一命令的 `--mode full-bundle --fallback
+./full-bundle.tar.gz`。fallback 同样持有 owner 锁并预检目标挂载点；完整包先传到
+owner-scoped partial，摘要核对成功后 no-clobber 原子 rename，失败只清理自己的 partial。
+远端已有同 digest 文件会复用，同名不同 digest 会 fail closed。capability 只有明确的旧端
+“命令不存在/不支持”响应才可降级；SSH 鉴权、网络、权限或畸形 JSON 一律中止。
+
+## 传输统计
+
+每次 blob 计划和实际传输输出以下不含凭据的整数：
+
+- `totalBytes` / `totalBlobs`：当前 release 的去重 blob 集合。
+- `reusedBytes` / `reusedBlobs`：远端完整 blob，加上本次从 partial 续传前已存在的 bytes。
+- `uploadedBytes` / `uploadedBlobs`：本次真正写入 SSH 的 bytes 和涉及的 blob 数。
+
+统计来自内容 descriptor 和接收端确认，不解析 registry URL，也不输出命令环境变量。
+
+## 确定性归档与 macOS
+
+正式 `.tar.gz` 和重建的 `images.tar` 由 Windy 的 ustar writer 按排序后的显式文件集合
+生成：uid/gid/mtime 固定为 0，owner/group 固定为 root，mode 归一化，不写 pax xattr、
+resource fork 或 Finder metadata。路径组件以 `._` 开头时直接拒绝。因此 macOS 上即使
+源目录具有 extended attributes，归档也不会产生 AppleDouble `._*`。
+
+不要改回普通 `tar -czf` 依赖宿主机默认行为。`COPYFILE_DISABLE=1` 只作为调用系统 tar
+读取/验收时的额外保护，不是正式修复本身。回归测试在 macOS 写入真实 xattr，再把归档
+交给无网络的 Alpine 容器解压并比较精确文件集合。
+
+## 构建与旧项目升级
+
+`create-windy@0.6.7` 候选把 `packages/delivery`、本说明和 `delivery:remote` 脚本加入
+受管 Starter。`0.6.6 -> 0.6.7` 通过连续 recipe 事务升级；现有 project-owned 发布脚本
+不会被覆盖。正式构建先准备一个完整 release 目录，其中 `images.tar` 必须是 OCI image
+layout（含 `oci-layout`、`index.json` 和 `blobs/sha256/*`），再运行：
+
+```bash
+bun run delivery:remote -- pack \
+  --release-dir ./.artifacts/release \
+  --output-dir ./.artifacts/delivery \
+  --product windy \
+  --release-id 2026.08.08-1 \
+  --git-sha "$release_git_sha" \
+  --platform linux/amd64 \
+  --created-at 2026-08-08T00:00:00.000Z \
+  --images-json ./.artifacts/images.json
+```
+
+`pack` 不改输入目录：它在临时目录重建确定性的 OCI `images.tar`，重新生成覆盖最终精确
+文件集合的 `CHECKSUMS.sha256`，并以这组相同字节同时构建 V1 与 V2。输出目录独立包含
+`full-bundle.tar.gz`、`delivery-manifest.v2.json`、
+`DELIVERY-MANIFEST.sha256` 和 `blobs/sha256/*`。`images.json` 由 Registry/OCI exporter
+生成，必须记录每个镜像的 role、platform、config digest，以及可选的 repository、
+manifest digest 和 layer digest/size。`pack` 会拒绝普通 Docker save archive、缺失 OCI
+layout、digest 路径不一致、镜像 descriptor 未绑定归档 blob 或输出目录覆盖。
+
+旧项目按以下顺序接入：
+
+1. 先让现有 build-release 生成 OCI layout，并调用 `pack` 同时产出独立 V1 完整 bundle
+   与 V2 manifest/blob store；不要用 rsync 整个 `images.tar` 伪装差量。
+2. 在线发布增加 registry push 与 digest 冻结，目标事务改用 digest-pinned refs。
+3. SSH wrapper 接入 `SshProcessTransport`，stage 成功后仍调用原 `update-offline`。
+4. 至少连续保留一个兼容周期的 V1 bundle；确认所有安装端支持 V2 后，才可由产品版本
+   决策是否停止生成 fallback。
+
+升级器的三方合并、备份和冲突处理规则不变。客户已有同名 project-owned 文件时必须
+报告真实冲突，不能用 `--force` 或手工复制覆盖。

package/template/package.json

@@ -52,6 +52,7 @@
     "test:ops:tool-sandbox": "bun run scripts/tool-sandbox-isolation-regression.ts",
     "ops:db": "bun run scripts/production-database.ts",
     "ops:release": "bun run scripts/production-release.ts",
+    "delivery:remote": "bun run packages/delivery/src/cli.ts",
     "test:merge": "bun run scripts/merge-gate.ts",
     "release:verify": "bun run scripts/release-verify.ts --full",
     "release:candidate": "bun run scripts/release-candidate.ts",
@@ -65,7 +66,7 @@
     "check:document": "uv run --directory apps/document-server ruff check . && uv run --directory apps/document-server ruff format --check . && uv run --directory apps/document-server mypy",
     "check:speech": "uv run --directory apps/speech-server ruff check . && uv run --directory apps/speech-server ruff format --check . && uv run --directory apps/speech-server mypy",
     "check:embedding": "uv run --directory apps/embedding-server ruff check . && uv run --directory apps/embedding-server ruff format --check . && uv run --directory apps/embedding-server mypy",
-    "typecheck": "bun run --cwd apps/web typecheck && bun run --cwd apps/server typecheck && bun run --cwd apps/license typecheck && bun run --cwd apps/signing-service typecheck && bun run --cwd packages/ai-client typecheck && bun run --cwd packages/license-sdk typecheck && bun run --cwd packages/jobs typecheck && bun run --cwd packages/server-sdk typecheck && bun run --cwd packages/storage typecheck && bun run --cwd packages/database typecheck && bun run --cwd packages/crud-generator typecheck && bun run --cwd packages/create-windy typecheck",
+    "typecheck": "bun run --cwd apps/web typecheck && bun run --cwd apps/server typecheck && bun run --cwd apps/license typecheck && bun run --cwd apps/signing-service typecheck && bun run --cwd packages/ai-client typecheck && bun run --cwd packages/license-sdk typecheck && bun run --cwd packages/jobs typecheck && bun run --cwd packages/server-sdk typecheck && bun run --cwd packages/storage typecheck && bun run --cwd packages/database typecheck && bun run --cwd packages/crud-generator typecheck && bun run --cwd packages/delivery typecheck && bun run --cwd packages/create-windy typecheck",
     "lint": "oxlint .",
     "format": "oxfmt",
     "check:static": "bun run lint && bun run typecheck && bun run check:agent && bun run check:document && bun run check:speech && bun run check:embedding",

package/template/packages/delivery/bin/windy-delivery

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+await import("../src/cli.ts");

package/template/packages/delivery/index.ts

@@ -0,0 +1,14 @@
+export * from "./src/archive.js";
+export * from "./src/blob-store.js";
+export * from "./src/builder.js";
+export * from "./src/checksums.js";
+export * from "./src/digest.js";
+export * from "./src/manifest.js";
+export * from "./src/negotiation.js";
+export * from "./src/registry.js";
+export * from "./src/redact.js";
+export * from "./src/staging.js";
+export * from "./src/ssh-process.js";
+export * from "./src/ssh-sync.js";
+export * from "./src/transfer.js";
+export * from "./src/types.js";

package/template/packages/delivery/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@southwind-ai/delivery",
+  "version": "0.1.0",
+  "private": true,
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "files": [
+    "bin/windy-delivery",
+    "index.ts",
+    "src/**/*.ts",
+    "!src/**/*.test.ts"
+  ],
+  "scripts": {
+    "delivery": "bun run src/cli.ts",
+    "typecheck": "tsc --noEmit --project tsconfig.json"
+  },
+  "exports": {
+    ".": "./index.ts"
+  }
+}

package/template/packages/delivery/src/archive-portability.test.ts

@@ -0,0 +1,84 @@
+import { afterEach, expect, test } from "bun:test";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createDeterministicTarGz, listTarGzEntries } from "./archive.js";
+import { listArchiveFiles } from "./builder.js";
+
+const roots: string[] = [];
+const acceptanceTest =
+  process.env.WINDY_DELIVERY_LINUX_ACCEPTANCE === "1" &&
+  process.platform === "darwin"
+    ? test
+    : test.skip;
+
+afterEach(async () => {
+  await Promise.all(
+    roots.splice(0).map((root) => rm(root, { recursive: true, force: true })),
+  );
+});
+
+acceptanceTest(
+  "macOS xattr 输入经确定性构建后在 Linux 解压保持精确文件集合",
+  async () => {
+    const root = await mkdtemp(join(tmpdir(), "windy-archive-portability-"));
+    roots.push(root);
+    const input = join(root, "input");
+    const output = join(root, "linux");
+    const archive = join(root, "bundle.tar.gz");
+    await mkdir(join(input, "bin"), { recursive: true });
+    await writeFile(join(input, "manifest.json"), "{}\n");
+    await writeFile(join(input, "bin/delivery"), "#!/bin/sh\n", {
+      mode: 0o755,
+    });
+    await run([
+      "xattr",
+      "-w",
+      "com.southwind.delivery",
+      "portable-metadata",
+      join(input, "manifest.json"),
+    ]);
+    await createDeterministicTarGz(archive, [
+      { source: join(input, "manifest.json"), path: "manifest.json" },
+      {
+        source: join(input, "bin/delivery"),
+        path: "bin/delivery",
+        mode: 0o755,
+      },
+    ]);
+    expect(await listTarGzEntries(archive)).toEqual([
+      "bin/delivery",
+      "manifest.json",
+    ]);
+    await mkdir(output);
+    await run([
+      "docker",
+      "run",
+      "--rm",
+      "--network",
+      "none",
+      "-v",
+      `${root}:/work`,
+      "alpine:3.21",
+      "sh",
+      "-eu",
+      "-c",
+      "tar -xzf /work/bundle.tar.gz -C /work/linux",
+    ]);
+    expect(await listArchiveFiles(output)).toEqual([
+      "bin/delivery",
+      "manifest.json",
+    ]);
+    expect(await readFile(join(output, "manifest.json"), "utf8")).toBe("{}\n");
+  },
+  30_000,
+);
+
+async function run(command: string[]): Promise<void> {
+  const child = Bun.spawn(command, { stdout: "pipe", stderr: "pipe" });
+  const [exitCode, stderr] = await Promise.all([
+    child.exited,
+    new Response(child.stderr).text(),
+  ]);
+  if (exitCode !== 0) throw new Error(`${command[0]} 失败：${stderr.trim()}`);
+}