@pm_zhousl/xinyun-ai-init 1.7.2 → 1.7.3

package/test-scenarios/v1.7.3-scenarios.md

@@ -0,0 +1,79 @@
+# v1.7.3 专属测试场景
+
+本文件用于 v1.7.3 真实 Codex 角色会话创建与绑定回归。测试时必须使用本地待发布 tarball 或已确认版本的初始化规则，不得执行 `npm publish`、Git commit/tag/push、数据库、API、依赖或业务代码修改。
+
+## 1. 五个真实角色子会话创建
+
+输入：对已经具备 5 个 `role-execution` 本地任务的项目执行 v1.7.3 升级。
+
+验收：
+- Codex 主会话尝试创建 `project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer` 五个真实角色子会话。
+- 真实 `sessionId` 来自 Codex 宿主返回值。
+- 写入 `xinyun-ai/sessions/role-session-bindings.json` 和 `xinyun-ai/sessions/roles/`。
+- CLI 仍只创建或更新 `xinyun-ai-init/`，不直接创建真实会话。
+
+## 2. 会话绑定回写一致性
+
+输入：角色会话创建成功后检查控制文件。
+
+验收：
+- 角色任务、`assignments.json`、`task-index.json`、`manifest.json`、`project-index.json`、`init-result.json` 引用同一 `bindingId`、`sessionId`、`parentSessionId`、`provider=codex`。
+- `sessionStatus` 只使用 pending / creating / created / onboarding / ready / blocked / failed / closed。
+- 任务界面能展示 5 个角色会话入口、sessionId、状态、理解进度和阻塞原因。
+
+## 3. onboarding 只读边界
+
+输入：创建成功后的角色子会话读取角色任务和项目规则。
+
+验收：
+- 创建成功后先进入 `sessionStatus=onboarding`。
+- 子会话只读读取入口规则、角色任务、职责确认和角色理解记录。
+- 未完成职责理解、职责确认、成员 / 会话绑定和确认门禁前，不得写成 `sessionStatus=ready`。
+- 创建成功不等于业务代码修改授权。
+
+## 4. 幂等复用
+
+输入：对同一项目重复执行 v1.7.3 升级。
+
+验收：
+- 按 `taskId + roleId + provider + targetVersion` 计算 `roleSessionIdempotency`。
+- 已有真实会话和绑定被复用，不重复创建同一角色会话。
+- `role-session-bindings.json` 不出现重复 roleId/taskId/provider/targetVersion 记录。
+
+## 5. 宿主不支持时本地降级
+
+输入：模拟 Codex 宿主不支持创建子会话、权限不足或创建接口不可用。
+
+验收：
+- 不伪造 sessionId。
+- `sessionId=null`。
+- 写入 `local-degraded-no-fake-session-id`。
+- `sessionStatus=blocked` 或 failed，并记录 `degradation.reason`、`failureReason`、`nextAction`。
+
+## 6. 创建成功但回写失败恢复
+
+输入：模拟角色会话创建成功，但 `role-session-bindings.json` 或索引回写失败。
+
+验收：
+- 记录 `created-but-writeback-failed`、真实 sessionId 来源、失败文件和 audit。
+- 下次执行按幂等键查询宿主已有会话并恢复绑定。
+- 不重复创建同一角色会话。
+
+## 7. 单角色失败不影响其他角色
+
+输入：模拟其中一个角色创建或 onboarding 失败。
+
+验收：
+- 失败角色单独进入 blocked 或 failed。
+- 其他角色继续创建、回写或 onboarding。
+- 总体结果记录 createdCount / reusedCount / failedCount / blockedCount / localDegradedCount。
+
+## 8. 普通咨询边界
+
+输入：普通咨询、只读问答或与角色协作无关的问题。
+
+验收：
+- 不创建角色会话。
+- 不写 `xinyun-ai/sessions/role-session-bindings.json`。
+- 不创建外部账号、第三个会话或业务任务链。
+- 不修改业务代码、数据库、API、配置、依赖或 Git。