docs: fix v0.1 implementation stack

2026-05-29 10:35:33 +08:00
parent f896439940
commit 4b33e67484
10 changed files with 70 additions and 6 deletions
@@ -32,6 +32,19 @@

 公网入口暂不作为 `v0.1` 必备规格。若后续需要 UniDesk/HWLAB 跨服务入口，必须在本仓库新增受审查的 ingress/FRP/edge spec，不得临时固化 NodePort、host port、pod IP 或一次性 port-forward。

+## Bun + TypeScript CI 边界
+
+`v0.1` 自研代码的 CI/CD 工具链以 Bun + TypeScript 为准。Tekton task 必须在受控容器内安装或使用固定 Bun 运行时，执行依赖安装、类型检查、自测试和镜像构建；不得把 master server、G14 固定 source workspace 或手工 host shell 作为构建机。
+
+CI 的最小检查应覆盖：
+
+- `bun install` 或等价 frozen lockfile 安装。
+- TypeScript 类型检查。
+- Bun/TS 单元自测试，包括 manager schema、adapter mock、Codex fake app-server stdio client 和 CLI JSON 输出。
+- `deploy/deploy.json` 与 GitOps render 只读校验。
+
+容器镜像可以直接运行 TS 入口，也可以运行同一 source commit 构建出的 JS artifact；无论选择哪种形式，artifact catalog 必须记录完整 source commit 和 image digest。CI/CD 仍然只允许纯 Tekton + Argo CD，不因 Bun 工具链引入自定义 runner、长期 poller 或源分支生成物提交。
+
 ## 真相源

 `v0.1` 发布真相按以下顺序判断：