收束 AGC 生命周期基础切换里程碑

更新稳定版主规范的已完成状态删除已完成里程碑的临时实施计划
2026-09-14 12:55:09 +08:00
parent 1445d1b1ab
commit deeff8d82d
3 changed files with 2 additions and 67 deletions
@@ -1,33 +0,0 @@
-# 【实施计划】AGC 客户端稳定版生命周期基础切换
-
-| 字段 | 值 |
-| --- | --- |
-| Milestone | `docs/project-memory/plans/【里程碑】AGC客户端稳定版生命周期基础切换-2026-09-14.md` |
-| Status | ready |
-| Owner | Codex |
-
-## 修改边界
-
- 允许修改：AGC client operation/auth/home、dev-stack snapshot/Vite marker、对应测试和稳定版主规范。
- 明确不修改：公开 API/schema、项目 manifest/runtime durable schema、旧项目文件和真实 Provider 服务。
-
-## 实现顺序
-
-1. 补 ClientOperation 类型、转移函数和 stale/cancel 测试。
-2. 让 auth refresh 保留 operation 投影，首页自动创建记录 draft、phase 和项目 scope。
-3. 在 dev-stack snapshot 与 Vite marker 记录 instanceId、repoRoot、processId、port、dataDir，并补复用门禁。
-4. 运行 typecheck、定向测试、dev-stack 测试、编码、文档索引和 diff 检查。
-
-## 验证命令
-
-1. `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/clientOperation.test.ts tests/clientApi.test.ts tests/clientHttp.test.ts tests/recentProjectsModel.test.ts --reporter=dot`
-2. `npm --prefix apps/ai-game-creator-shell run typecheck`
-3. `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`
-4. `npm --prefix . exec -- vitest run scripts/dev.test.ts --reporter=dot`
-5. `npm run check:doc-index`
-6. `npm run check:encoding`
-7. `git diff --check`
-
-## 风险与回滚点
-
-旧 dev-stack 文件缺少 instanceId 时必须拒绝 AGC 后端复用而不是猜测；若 marker 字段导致既有 Vite 启动链不兼容，回滚只撤销 identity 投影，不回退已完成的 body timeout/home/recent 修复。
@@ -1,33 +0,0 @@
-# 【里程碑】AGC 客户端稳定版生命周期基础切换
-
-| 字段 | 值 |
-| --- | --- |
-| Version | 1.0 |
-| Status | ready |
-| Date | 2026-09-14 |
-| Parent Spec | `docs/【技术方案】AGC客户端稳定版生命周期大切换-2026-09-14.md` |
-
-## 目标
-
-落地 ClientOperation 基础合同，接入认证 refresh 与首页自动创建，并把 dev-stack snapshot/marker 的身份字段补齐。
-
-## 范围
-
-客户端 operation 类型与 stale 判定、认证 refresh 投影、首页创建 phase 投影、dev-stack instanceId/repoRoot/processId/port/dataDir 记录与验证测试。
-
-## 不在范围内
-
-本轮不删除持久化迁移、Runtime/资源账本或公开后端接口；不重写 Planning V2、DirectProject 和资源生成的 durable executor。
-
-## 验收标准
-
- [ ] ClientOperation identity、phase、deadline、scope 和取消状态有定向测试。
- [ ] 认证 refresh 和首页创建暴露 operation 投影，切页不会丢失 operation。
- [ ] dev-stack snapshot 与 Vite marker 带工作树/进程身份字段。
- [ ] 类型、定向测试、dev-stack 测试、编码和 diff 检查通过。
-
-## 证据要求
-
- 自动化：clientOperation、clientAuth/clientApi、home、dev-stack 定向测试。
- 运行时：只读端口归属探测；必要时 AGC Vite marker smoke。
- 边界：旧状态缺字段拒绝复用，迟到 operation 不能写回，取消不自动重放。
@@ -55,7 +55,8 @@
 ## 当前实现状态

 - HTTP body-aware timeout、refresh singleflight 清理、Runner blocking worker、最近项目逐项检查和首页创建跨页防重已完成并在 PR #346 中提交。
- `ClientOperation` 基础合同、认证 refresh operation 投影、首页创建 operation 投影和 dev-stack `instanceId` 已在本轮切换中落地。
+- `ClientOperation` 基础合同、认证 refresh 与 Runner auth-transition operation 投影、首页创建 operation 投影和 dev-stack `instanceId` 已在本轮切换中落地。
+- 稳定版基础切换里程碑已完成；后续入口只允许复用该合同，不再新增 component-level busy/ref 状态机。
 - Planning/DirectProject/资源生成/预览已有各自 durable operation 或 request scope；本轮只补统一投影与身份校验，不重写其持久化账本。

 ## 验收证据