建立 AGC 稳定版生命周期基础合同 #348

2026-09-14T12:55:50+08:00

kdletters commented

2026-09-14 12:55:50 +08:00

变更内容

这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重：

新增统一 ClientOperation 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定；
认证 refresh 投影 auth-refresh operation；登录、401 refresh、退出共用平台 session generation，并由 auth-transition 投影 Runner phase/成功/失败/不确定状态；
首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation；
.app/dev-stack.json 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用；
新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。

验证

npm --prefix apps/ai-game-creator-shell run typecheck
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 tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot（61 passed，2 skipped）
npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot（423/423 passed）
node --check scripts/dev.mjs
node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs
npm run check:doc-index
npm run check:encoding
git diff --check

scripts/dev.test.ts 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。

## 变更内容这是基于 PR #346 的稳定版生命周期基础切换，承接已完成的 HTTP body timeout、Runner blocking worker、最近项目逐项刷新和首页跨页防重： - 新增统一 `ClientOperation` 合同，固定 operationId、requestId、phase、deadline、scope、cancellable 和 stale 判定； - 认证 refresh 投影 `auth-refresh` operation；登录、401 refresh、退出共用平台 session generation，并由 `auth-transition` 投影 Runner phase/成功/失败/不确定状态； - 首页自动创建记录 draft、startMode、phase 和建项后的 project scope，页面卸载不会释放 operation； - `.app/dev-stack.json` 增加 instanceId、repoRoot、服务级 dataDir/instanceId，AGC Vite marker 增加 repoRoot/processId/port；缺身份的旧状态拒绝 AGC 后端复用； - 新增稳定版生命周期主规范、开发运维口径和 shared pitfalls。 ## 验证 - `npm --prefix apps/ai-game-creator-shell run typecheck` - `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 tests/start-dev-stack.test.ts tests/dev-port.test.ts --reporter=dot`（61 passed，2 skipped） - `npm --prefix apps/ai-game-creator-shell exec -- vitest run tests/appSurface.test.ts --reporter=dot`（423/423 passed） - `node --check scripts/dev.mjs` - `node --check apps/ai-game-creator-shell/scripts/start-dev-stack.mjs` - `npm run check:doc-index` - `npm run check:encoding` - `git diff --check` `scripts/dev.test.ts` 全量仍有 1 个 Windows 文件权限相关既有失败：bootstrap secret 测试在 Windows 上无法通过 chmod 模拟 0600；本变更未触及该逻辑。

kdletters changed target branch from codex/agc-async-recovery to master

2026-09-14 13:19:15 +08:00

kdletters added 4 commits 2026-09-14 13:22:35 +08:00

建立 AGC 稳定版生命周期基础合同 3d5349057a

新增 ClientOperation 状态、身份和 stale-result 规则

让认证 refresh 与首页创建记录统一 operation phase 和 scope

为 dev-stack 与 AGC Vite marker 增加工作树和实例身份门禁

补充稳定版切换主规范、里程碑计划和开发运维踩坑文档

统一 AGC 平台会话转移状态 91260a4bad

让登录、refresh 和退出共享 auth-transition operation 投影

保留 generation、Runner phase、成功、失败和不确定状态

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

更新稳定版主规范的已完成状态

删除已完成里程碑的临时实施计划

补齐 AGC 稳定版边界审计

Project CI / Repository checks (pull_request) Successful in 2m58s

Details

Project CI / Frontend tests (pull_request) Successful in 3m36s

Details

Project CI / Backend tests (pull_request) Successful in 6m11s

Details

Project CI / Native shell tests (pull_request) Successful in 19m26s

Details

adc3302c13

记录本地数据、资源账本、Runtime 和公开契约的迁移边界

补充平台会话 auth-transition operation 的审计结论

kdletters force-pushed codex/agc-stable-lifecycle from edfb2b5c2c to adc3302c13

2026-09-14 13:22:35 +08:00

Compare

kdletters added 1 commit 2026-09-14 13:56:45 +08:00

Merge branch 'master' into codex/agc-stable-lifecycle

Project CI / Repository checks (pull_request) Has been cancelled

Details

Project CI / Frontend tests (pull_request) Has been cancelled

Details

Project CI / Backend tests (pull_request) Has been cancelled

Details

Project CI / Native shell tests (pull_request) Has been cancelled

Details

70a7840cf0

kdletters merged commit c146f7f99c into master

2026-09-14 13:56:56 +08:00

kdletters deleted branch codex/agc-stable-lifecycle

2026-09-14 13:56:56 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GenarrativeAI/Genarrative#348