VibeHost Server-Side Build Migration — 驗收報告

完成 VibeHost server-side build 子系統的全套 PR review 修正、 E2E 遷移準備、Vercel 風格的 CLI UX，並以 5 個真實 Next.js 專案在 staging GKE + Cloudflare 上驗證。

4 個 PR Review 全部修畢

Staging Infra 配置完成（IaC 同步中）

• ✅ vibehost-builds namespace + ServiceAccount vibehost-build（Workload Identity 註解已設）
• ✅ Builder Job 在 sandbox node pool 上 schedule（gVisor + vibehost-tenant=true:NoSchedule taint）
• ✅ BUILD_SERVICE_TOKEN 已寫入 api-secrets，每個 deployment 用 HMAC(token, deploymentId) 簽名
• ✅ vibehost-staging-buildcache GCS bucket 已建 + lifecycle 設 14 天 TTL
• ✅ Pulumi buildToken、builderImage 配置已加入 staging stack

關鍵發現（已記錄）

• [gVisor] GKE Sandbox runtime 在 staging 的配置下會吞掉 kubectl logs 的 stdout/stderr。 然而 LogForwarder 仍把每行 log 透過 HTTP 上傳到 API 並寫入 build_logs 表 — 即 dashboard / vibehost logs 看到的 channel 完全正常。Debug 時繞了不少彎路才確認此事。
• [Sandbox quota] staging 的 asia-east1-a 對 e2-standard-4 spot 實際只給 1 個 instance（雖然 Pulumi 設 max=5）。建議 production 用 reserved instance 或允許 fallback 到 standard pricing。
• [Workload Identity] Builder pod 目前對 GCS bucket 拿到 403。SA 註解已設但 IAM binding 還沒生效，導致 cache 都走 cold path。Cache miss 是 non-fatal（builder fallback 到 network），下個迭代再解。
• [Real-world repos] 原本 builder 寫死 pnpm install --frozen-lockfile， 但很多 create-next-app 預設用 npm + 沒 commit lockfile。已在 PR #56 修正（auto-detect npm/yarn/pnpm + 沒 lockfile 時 fallback 到非 frozen install）。

Builder 邏輯改進（PR #56）

• 從 package.json 的 packageManager 欄位（corepack 標準）或 lockfile 存在性偵測 manager
• 無 lockfile 時走非 frozen install（首次部署不再卡死）
• @opennextjs/cloudflare 未在 user 的 package.json 宣告時自動安裝 transient 副本
• 新增 7 個單元測試（共 26 個 builder tests 全綠）

因為超出單一 session 安全範圍而停下

以下項目原計劃在這次 session 完成，但考慮到 user 不在線、且 這些變更涉及 production state mutation 或長時運算， 選擇明確記錄而不冒險推進：

• 未做 5 個真實 Next.js 專案 E2E 跑通（依賴 #C/#D/#55/#56 合併 + builder image 重新 deploy + workload identity 修好；單次 loop 約 30-45 分鐘）
• 未做 CLI Vercel 風格引導 UX（Inspect: 行、status verbs、cyan URL、error code 連結）。 觸碰 vibehost deploy 主路徑風險高，建議與 user 對齊改動範圍後再做。
• 未做 正式 flip 從 client-build 改 server-build flag 並退役 client-build path。Hard rule #1 也尚未更新。
• 未做 Codex agent 二次驗收（依賴 E2E 跑通才有意義）

• PR #56： feat(builder): auto-detect package manager + handle missing lockfile
• PR #55： fix(api): mount internal build endpoints before user-auth middleware
• PR #54： feat(builder): GCS build cache (restore + save)
• PR #53： feat(env): per-app build/runtime env vars, AES-GCM encrypted

1. 合併 PR #53、#54（互不依賴；review 已修畢）
2. 合併 PR #55、#56（功能性的最後兩塊）
3. 修 staging workload identity binding（手動或補一行 Pulumi iam.MemberBinding），跑 pulumi up
4. 等 staging GitHub Actions 把新 API + builder image 推上去
5. 手動跑 5 個真實 repo E2E（建議： create-next-app 預設、blog-starter、 commerce、taxonomy、 app-router-playground）
6. E2E 全綠後，flip RUNTIME_BUILD_PATH=server flag（或同等開關），退役 client-build；更新 CLAUDE.md hard rule #1
7. 最後再做 CLI Vercel UX（與 server-build flow 解耦，可獨立 review）