Add HWLAB v0.3 lane expansion config

2026-06-08 14:08:18 +08:00
parent 34ee947285
commit 6c5166d816
12 changed files with 852 additions and 149 deletions
@@ -89,6 +89,7 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥
 ## 规格

 - 规格文档是微服务、稳定外部服务、短连接 CLI 和系统能力的权威出处；代码开发和测试代码编写必须先对齐对应 `docs/reference/spec-*.md`，再修改实现或测试。
+- 平行 runtime lane 扩容规格、`v0.3` 之后 `v0.4`/`v0.5`/`v0.6` 只改 `deploy/deploy.yaml` 配置并通过 repo-owned CLI 扩容的规则：[docs/reference/spec-lane-expansion.md](docs/reference/spec-lane-expansion.md)。
 - v0.2 服务规格总览、保留服务清单、稳定外部服务边界和废弃范围：[docs/reference/spec-v02-services.md](docs/reference/spec-v02-services.md)；`hwlab-gateway-simu`、`hwlab-box-simu` 和 `hwlab-patch-panel` 已废弃，不再保留 spec。
 - v0.2 登录与鉴权规格、Keycloak OIDC、Web session 和 CLI API key：[docs/reference/spec-v02-auth.md](docs/reference/spec-v02-auth.md)。
 - v0.2 用户和权限管理规格、code agent session 归属和工具能力授权：[docs/reference/spec-user-access.md](docs/reference/spec-user-access.md)。
@@ -148,6 +149,8 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥
 - G14 artifact build helper：`node scripts/g14-artifact-publish.mjs --publish ...`，只能由 G14 Tekton task 携带 CI artifact identity 调用；人工发布走 G14 poller/GitOps，不走 legacy CLI CD。
 - G14 monorepo 组件计划：`node scripts/g14-ci-plan.mjs --base-ref <ref> --target-ref <ref> --pretty`，只读分析 affected/reused services，基于内建 service-path component model 与 `deploy/deploy.yaml`；细则见 [docs/reference/g14-gitops-cicd.md](docs/reference/g14-gitops-cicd.md)。
 - G14 GitOps 渲染：`npm run g14:gitops:render`；source 分支不再运行生成物 drift check，发布态由 Tekton 写入 `G14-gitops`。
+- 平行 lane 配置扩容：`npm run lane:expand -- configure --lane v03 --from v02 --write`，只写 `deploy/deploy.yaml` 的新 lane 声明，后续 `v04`/`v05`/`v06` 复用同一入口。
+- GitOps lane 严格 TS 检查：`npm run gitops:ts:check`；新拆 GitOps 模块直接进入 `scripts/src/*.ts` 和 `tsconfig.gitops.json`，不要继续堆进单个 `.mjs`。
 - DEV 依赖 runtime base 构建：`npm run dev-runtime-base:build`
 - Legacy D601 DEV CD：旧脚本入口已删除；事故回放只读历史 issue/commit，不恢复旧命令。
 - v0.2 WEB 等价短连接 CLI：在 `G14:/root/hwlab-v02` 或当前 v0.2 worktree 直接运行 `bun tools/hwlab-cli/bin/hwlab-cli.ts client ... --base-url http://74.48.78.17:19666`，默认走 Cloud Web 同源 API；细则见 [docs/reference/spec-v02-hwlab-cli.md](docs/reference/spec-v02-hwlab-cli.md)。