diff --git a/docs/project-memory/plans/【实施计划】AGC客户端稳定版生命周期基础切换-2026-09-14.md b/docs/project-memory/plans/【实施计划】AGC客户端稳定版生命周期基础切换-2026-09-14.md deleted file mode 100644 index 7c2ab91f2..000000000 --- a/docs/project-memory/plans/【实施计划】AGC客户端稳定版生命周期基础切换-2026-09-14.md +++ /dev/null @@ -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 修复。 diff --git a/docs/project-memory/plans/【里程碑】AGC客户端稳定版生命周期基础切换-2026-09-14.md b/docs/project-memory/plans/【里程碑】AGC客户端稳定版生命周期基础切换-2026-09-14.md deleted file mode 100644 index 71eb02a07..000000000 --- a/docs/project-memory/plans/【里程碑】AGC客户端稳定版生命周期基础切换-2026-09-14.md +++ /dev/null @@ -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 不能写回,取消不自动重放。 diff --git a/docs/【技术方案】AGC客户端稳定版生命周期大切换-2026-09-14.md b/docs/【技术方案】AGC客户端稳定版生命周期大切换-2026-09-14.md index 3b4934cc8..2389eb7d3 100644 --- a/docs/【技术方案】AGC客户端稳定版生命周期大切换-2026-09-14.md +++ b/docs/【技术方案】AGC客户端稳定版生命周期大切换-2026-09-14.md @@ -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;本轮只补统一投影与身份校验,不重写其持久化账本。 ## 验收证据