@pm_zhousl/xinyun-ai-init 1.7.0 → 1.7.2

package/test-scenarios/review-template.md

@@ -73,7 +73,7 @@
 | 51. v1.6-D 输入可信边界测试 | 待填写 | 待填写 | 待填写 |
 | 52. v1.6-D 敏感信息脱敏测试 | 待填写 | 待填写 | 待填写 |
 | 53. v1.6 tarball 自包含与 CLI 边界测试 | 待填写 | 待填写 | 待填写 |
-| 54. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
+| 54. Skill 触发测试（历史观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
 
 ## 详细问题
 
@@ -91,7 +91,7 @@
 - 可以后续优化：
 - 不建议纳入本版本：
 
-说明：Skill 触发测试是观察项。除非它影响 1-53 的必测场景，否则不作为当前版本不可发布的理由。
+说明：历史 Skill 触发测试是观察项。当前版本发布阻断以 1-87 必测场景为准。
 ## v1.7 审查增量行
 
 | 场景 | 结果 | 证据 | 是否阻断 |
@@ -111,6 +111,25 @@
 | 67. HTML 任务级 schema | 待填写 | 待填写 | 待填写 |
 | 68. 试点越界暂停 | 待填写 | 待填写 | 待填写 |
 | 69. verify:rules JSON schema 和重复执行 | 待填写 | 待填写 | 待填写 |
-| 70. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
+| 71. v1.7.1 主任务命名 | 待填写 | 待填写 | 待填写 |
+| 72. v1.7.1 主任务字段一致性 | 待填写 | 待填写 | 待填写 |
+| 73. v1.7.1 五个角色子任务 | 待填写 | 待填写 | 待填写 |
+| 74. v1.7.1 角色任务字段和空绑定 | 待填写 | 待填写 | 待填写 |
+| 75. v1.7.1 角色登记与执行资格分离 | 待填写 | 待填写 | 待填写 |
+| 76. v1.7.1 初始化任务归档 | 待填写 | 待填写 | 待填写 |
+| 77. v1.7.1 归档原子性和任务索引 | 待填写 | 待填写 | 待填写 |
+| 78. v1.7.1 归档事务异常裁决 | 待填写 | 待填写 | 待填写 |
+| 79. v1.7.1 子任务状态与主任务聚合 | 待填写 | 待填写 | 待填写 |
+| 80. v1.7.1 当前任务清理 | 待填写 | 待填写 | 待填写 |
+| 81. v1.7.1 初始化失败不归档 | 待填写 | 待填写 | 待填写 |
+| 82. v1.7.1 归档幂等 | 待填写 | 待填写 | 待填写 |
+| 83. v1.7.1 CodeGraph 首次初始化与授权边界 | 待填写 | 待填写 | 待填写 |
+| 84. v1.7.1 CodeGraph 健康复用 | 待填写 | 待填写 | 待填写 |
+| 85. v1.7.1 CodeGraph 失败矩阵 | 待填写 | 待填写 | 待填写 |
+| 86. v1.7.1 CodeGraph 状态登记与去重 | 待填写 | 待填写 | 待填写 |
+| 87. v1.7.1 普通咨询和版本回归 | 待填写 | 待填写 | 待填写 |
+| 88. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
 
-说明：Skill 触发测试是观察项。除非它影响 1-69 的必测场景，否则不作为当前版本不可发布的理由。
+说明：Skill 触发测试是观察项。除非它影响 1-87 的必测场景，否则不作为当前版本不可发布的理由。
+
+

package/test-scenarios/scenarios.md

@@ -2,10 +2,10 @@
 
 ## 测试分级说明
 
-- 必测场景：1-69，用于判断当前版本是否可以发布。
-- 观察场景：70，用于收集后续优化建议，不作为当前版本发布阻断项。
+- 必测场景：1-87，用于判断当前版本是否可以发布。
+- 观察场景：88，用于收集后续优化建议，不作为当前版本发布阻断项。
 
-当前必测场景为 1-69；当前观察场景为 70。
+当前必测场景为 1-87；当前观察场景为 88。
 
 ## 1. 初始化可用性测试
 
@@ -850,7 +850,7 @@
 - 全新临时项目执行 tarball CLI 后是否只创建 `xinyun-ai-init/`。
 - CLI 是否不创建 `xinyun-ai/` 或 `AGENTS.md`。
 - 业务基线文件哈希是否不变。
-- 生成的 `xinyun-ai-init/version.json` 是否为 `1.7.0`。
+- 生成的 `xinyun-ai-init/version.json` 是否为 `1.7.1`。
 
 ## 55. verify:rules 正常通过
 
@@ -990,7 +990,109 @@
 - 相同源目录和 tarball 重复执行结果稳定。
 - 不产生业务文件变化。
 
-## 70. Skill 触发测试（观察项）
+## 71. v1.7.1 主任务命名
+
+目标：验证初始化主任务有真实项目名称。
+
+验收：主任务标题为 `项目初始化：<项目显示名>`，不是泛化标题。
+
+## 72. v1.7.1 主任务字段一致性
+
+目标：验证 current-task、主任务、init-result、任务索引的 taskId、title、status 一致。
+
+验收：四类控制文件不出现 taskId、title 或状态冲突。
+
+## 73. v1.7.1 五个角色子任务
+
+目标：验证生成 project-owner、project-product、chief-engineer、programmer、test-reviewer 五个子任务。
+
+验收：子任务正确关联 parentTaskId，并保存到 `xinyun-ai/tasks/<taskId>/subtasks/<roleTaskId>.md`。
+
+## 74. v1.7.1 角色任务字段和空绑定
+
+目标：验证无成员、无外部会话时不虚构人员。
+
+验收：memberId、sessionId 为 null；职责确认、理解记录、executionEligible 和 blockedReason 字段可解析。
+
+## 75. v1.7.1 角色登记与执行资格分离
+
+目标：验证 initialization-record 与 role-execution 分离。
+
+验收：initialization-record 可完成登记但 executionEligible=false；role-execution 未满足成员、确认、理解或 CodeGraph 条件时不得 completed。
+
+## 76. v1.7.1 初始化任务归档
+
+目标：验证初始化控制面完成后归档。
+
+验收：任务从当前可执行列表移除，归档到 `xinyun-ai/tasks/archive/<taskId>/`，历史摘要完整。
+
+## 77. v1.7.1 归档原子性和任务索引
+
+目标：验证 archiveTransactionId、事务 phase 和 task-index 一致性。
+
+验收：phase 按 prepared / validated / moved / indexed / committed 记录；中断后可恢复。
+
+## 78. v1.7.1 归档事务异常裁决
+
+目标：验证临时目录、归档目录、索引缺失、hash 不一致和重复事务。
+
+验收：可恢复则继续；不可一致时 blocked，不静默删除历史。
+
+## 79. v1.7.1 子任务状态与主任务聚合
+
+目标：验证主任务只按初始化控制面聚合。
+
+验收：角色未绑定、确认 pending、理解 pending 不阻断 initialization-record 归档；role-execution 独立保留。
+
+## 80. v1.7.1 当前任务清理
+
+目标：验证保留其他可执行任务和无任务 idle。
+
+验收：有其他任务时 current-task 切换；无任务时 status=idle、taskId=null、title=暂无待执行任务。
+
+## 81. v1.7.1 初始化失败不归档
+
+目标：验证控制面失败、权限不足、锁阻塞或 CodeGraph 必备失败。
+
+验收：主任务为 partial/blocked，不进入完成归档。
+
+## 82. v1.7.1 归档幂等
+
+目标：验证归档后重复初始化不生成重复主任务。
+
+验收：通过幂等索引定位历史 taskId。
+
+## 83. v1.7.1 CodeGraph 首次初始化与授权边界
+
+目标：验证缺少 `.codegraph/` 且命令可用时自动执行 `codegraph init -i`。
+
+验收：不询问是否继续；只写入 `.codegraph/` 工具控制目录，不修改业务目录。
+
+## 84. v1.7.1 CodeGraph 健康复用
+
+目标：验证已有健康 `.codegraph/` 时不重复初始化。
+
+验收：复用索引，后续会话读取登记状态。
+
+## 85. v1.7.1 CodeGraph 失败矩阵
+
+目标：验证命令不可用、目录不可写、MCP 未连接、初始化失败和索引损坏。
+
+验收：分别输出 unavailable、permission-denied、unknown、failed、failed；必需任务 blocked，明确授权降级才 partial。
+
+## 86. v1.7.1 CodeGraph 状态登记与去重
+
+目标：验证 manifest 为状态源，四类控制文件引用同一 codeGraphRecordId。
+
+验收：required、status、command、version、indexPath、时间、evidence 和 failureReason 一致；相同失败状态只提示一次。
+
+## 87. v1.7.1 普通咨询和版本回归
+
+目标：验证普通咨询不创建完整角色任务树，不触发 CodeGraph 初始化；v1.5-v1.7 行为不回归。
+
+验收：不修改业务代码、数据库、API、配置、依赖或 Git。
+
+## 88. Skill 触发测试（观察项）
 
 目标：观察 AI 是否具备按任务触发 Skill 的倾向。
 
@@ -1007,3 +1109,4 @@
 - 是否触发需求理解或产品 / UI 设计前置理解。
 - 是否没有默认全量启用所有 Skill。
 - 是否先输出理解结果和改动计划。
+

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

@@ -0,0 +1,130 @@
+# v1.7.1 专属测试场景
+
+## 1. 主任务命名
+
+- 输入：项目目录名为 `20250923XZH企业管理系统-服务端`。
+- 期望：主任务标题为 `项目初始化：20250923XZH企业管理系统-服务端`，不是泛化标题。
+
+## 2. 主任务字段一致性
+
+- 输入：完成一次初始化。
+- 期望：current-task、主任务、init-result、任务索引的 taskId、title、status 一致。
+
+## 3. 五个角色子任务
+
+- 输入：初始化流程。
+- 期望：生成 project-owner、project-product、chief-engineer、programmer、test-reviewer 五个子任务，并正确关联 parentTaskId。
+
+## 4. 角色任务字段和空绑定
+
+- 输入：没有真实成员和外部会话。
+- 期望：memberId、sessionId 为 null；职责确认、理解记录、executionEligible 和 blockedReason 字段可解析，不虚构人员。
+
+## 5. 角色任务未完成状态
+
+- 输入：职责确认或理解记录仍为 pending。
+- 期望：`role-execution` 子任务不能标记为 completed 或 executionEligible=true；`initialization-record` 只允许完成登记，不得改变角色执行资格。
+
+## 5A. 角色登记与执行资格分离
+
+- 输入：五个角色未绑定成员、职责确认 pending、理解记录 pending。
+- 期望：`taskKind=initialization-record` 的任务卡可以完成登记，但 assignmentStatus/understandingStatus/confirmationStatus 和 executionEligible 独立为未就绪，不得伪造角色可执行。
+
+## 6. 初始化任务归档
+
+- 输入：主任务和五个角色子任务全部完成，锁已释放，无阻塞。
+- 期望：从当前任务列表移除，归档到 `xinyun-ai/tasks/archive/<taskId>/`，历史摘要完整。
+
+## 6A. 归档原子性和任务索引
+
+- 输入：归档过程中模拟中断、重复归档和索引更新失败。
+- 期望：生成唯一 `archiveTransactionId`，事务 phase 按 `prepared -> validated -> moved -> indexed -> committed` 记录；下次按阶段恢复，不出现 task-index 与实际文件不一致。
+
+## 6B. 归档事务异常裁决
+
+- 输入：临时目录存在、归档目录已存在但索引未更新、索引已指向但归档缺失、归档内容 hash 不一致、事务重复执行。
+- 期望：临时目录从最近阶段继续；归档目录先校验后补索引；归档缺失、hash 不一致或权限不足进入 `blocked`；已提交事务幂等复用，不重复移动、不静默删除历史。
+
+## 6C. 子任务状态与主任务聚合
+
+- 输入：五个 `initialization-record` 已完成但成员未绑定、职责确认 pending、理解记录 pending；另有一个未完成 `role-execution` 任务。
+- 期望：登记子任务 `status=completed` 且 `executionEligible=false`；初始化主任务可按控制面完成归档；`role-execution` 保持独立未完成状态，不被归档清理。
+- 输入：控制面写入失败、锁阻塞或 CodeGraph 必备能力失败。
+- 期望：主任务为 `partial` 或 `blocked`，不得归档；子任务状态遵循 v1.5/v1.6 枚举，不出现未定义状态。
+
+## 7. 保留其他可执行任务
+
+- 输入：初始化任务完成，同时存在一个 pending 业务任务。
+- 期望：初始化任务归档，current-task 切换到业务任务，业务任务不被覆盖或删除。
+
+## 8. 无其他任务
+
+- 输入：初始化任务完成，没有其他任务。
+- 期望：current-task 显示“暂无待执行任务”，不重新指向已归档任务。
+- 同时期望：`status=idle`、`taskId=null`，且 idle 不进入业务任务状态枚举。
+
+## 9. 初始化失败不归档
+
+- 输入：控制面步骤失败、权限不足、锁阻塞或 CodeGraph 必备能力失败。
+- 期望：主任务为 partial/blocked，未完成控制面步骤仍可见，不进入完成归档。
+- 输入：仅角色职责确认 pending、理解记录 pending 或 role-execution 未完成，但五个 initialization-record 和控制面均已完成。
+- 期望：初始化登记任务允许归档；角色执行任务继续保留，不得因角色未绑定而伪造 executionEligible=true。
+
+## 10. 归档幂等
+
+- 输入：归档后重复执行相同初始化请求。
+- 期望：通过幂等索引定位历史 taskId，不生成重复主任务。
+
+## 11. CodeGraph首次初始化
+
+- 输入：没有 `.codegraph/`，`codegraph` 命令和服务可用。
+- 期望：自动执行 `codegraph init -i`，不询问是否继续，并记录状态和命令结果。
+
+## 11A. CodeGraph初始化授权边界
+
+- 输入：用户已执行初始化入口，`.codegraph/` 不存在，命令可用。
+- 期望：`.codegraph/` 作为工具控制目录属于初始化授权范围；只写入 CodeGraph目录，不修改业务目录。
+
+## 12. CodeGraph健康复用
+
+- 输入：已有健康 `.codegraph/`。
+- 期望：复用索引，不重复执行初始化，后续会话读取登记状态。
+
+## 13. CodeGraph命令不可用
+
+- 输入：系统没有 `codegraph` 命令。
+- 期望：状态固定为 `unavailable`，结构理解任务 `blocked`；只有用户明确授权限定范围降级时才允许 `partial`，列出未验证范围，不自动安装、不伪造完成。
+
+## 14. CodeGraph权限、服务或初始化失败
+
+- 输入：`.codegraph/` 不可写。
+- 期望：状态固定为 `permission-denied`，current-task 和 init-result 状态一致。
+- 输入：MCP 未连接或健康状态无法确认。
+- 期望：状态固定为 `unknown`，相关必需任务 blocked，不伪造健康。
+- 输入：初始化命令失败或索引损坏。
+- 期望：状态固定为 `failed`，current-task 和 init-result 状态一致，不反复询问相同问题。
+
+## 15. CodeGraph状态登记
+
+- 输入：初始化成功、复用、失败三种场景。
+- 期望：manifest、project-index、current-task、init-result 记录 required、status、command、version、indexPath、时间、evidence 和 failureReason。
+
+## 15A. CodeGraph记录与失败矩阵
+
+- 输入：命令不可用、目录不可写、命令执行失败、MCP未连接、索引损坏和健康索引。
+- 期望：分别得到 unavailable、permission-denied、failed、unknown、failed、healthy；四类控制文件引用同一 codeGraphRecordId，必需任务 blocked，只有明确授权降级时 partial。
+
+## 15B. CodeGraph失败提示去重
+
+- 输入：相同项目、相同 codeGraphRecordId 和相同失败状态重复初始化。
+- 期望：只提示一次；命令、权限、服务或索引状态变化后才允许再次提示或重试。
+
+## 16. 普通咨询边界
+
+- 输入：普通代码问题咨询，不进入初始化或结构影响审视流程。
+- 期望：不创建完整角色任务树，不触发 CodeGraph 初始化。
+
+## 17. 版本回归
+
+- 输入：v1.5-v1.7 已有初始化、任务锁、幂等、规则校验和业务基线场景。
+- 期望：既有行为不回归，不修改业务代码、数据库、API、配置、依赖或 Git。

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

@@ -0,0 +1,51 @@
+# v1.7.2 专属测试场景
+
+## 1. 已发布 v1.7.1 项目补建角色任务
+
+- 输入：项目已升级到 v1.7.1，归档中存在命名初始化主任务和 5 个角色登记子任务，但 `activeTaskIds=[]`、`executableTaskIds=[]`、`current-task=idle`。
+- 期望：补建或恢复 5 个 `role-execution` 后续任务，任务可在 `task-index.json` 中查看，不修改业务代码。
+
+## 2. 初始化主任务与角色后续任务分离
+
+- 输入：首次初始化或升级完成。
+- 期望：`taskKind=initialization-main` 的初始化主任务和 `taskKind=initialization-record` 的登记子任务可以归档；5 个 `taskKind=role-execution` 角色后续任务独立保留，不因主任务归档被删除。
+
+## 3. 未绑定角色可见但不可执行
+
+- 输入：5 个角色任务的 `memberId`、`sessionId` 为 null，职责和理解状态为 pending。
+- 期望：角色任务属于 `activeTaskIds`，不属于 `executableTaskIds`；`executionEligible=false`，并显示待分配或待确认原因。
+
+## 4. 活动任务与可执行任务为空集区分
+
+- 输入：`activeTaskIds` 有 5 个待分配角色任务，`executableTaskIds=[]`。
+- 期望：`current-task` 不得使用 `status=idle`、`taskId=null`；应按固定优先级指向 `project-owner`，使用 `status=pending` 并输出 nextAction。
+
+## 5. 真正空闲状态
+
+- 输入：`activeTaskIds=[]` 且没有任何 pending、blocked、paused 或 executing 任务。
+- 期望：`current-task.status=idle`、`taskId=null`、标题为“暂无待执行任务”。
+
+## 6. 升级幂等补建
+
+- 输入：对同一个 v1.7.1 项目重复执行 v1.7.2 升级。
+- 期望：第一次补建 5 个角色后续任务；再次执行复用原任务，不生成重复角色任务或重复主任务。
+
+## 6A. 角色优先级和并列排序
+
+- 输入：5 个角色后续任务均待分配，或存在相同 priority 的多个任务。
+- 期望：默认优先级为 project-owner 10、project-product 20、chief-engineer 30、programmer 40、test-reviewer 50；并列按 createdAt、roleId、taskId 稳定排序，不依赖文件系统顺序。
+
+## 6B. 补建失败和索引恢复
+
+- 输入：单个角色文件写入失败、任务索引更新失败、补建过程被中断。
+- 期望：成功角色任务保留；失败角色为 blocked/write-failed；结果为 partial 或 blocked；不得清空 activeTaskIds 或伪造 idle；下次通过逐角色 idempotencyKey 恢复索引和缺失任务。
+
+## 7. 已存在角色任务保护
+
+- 输入：部分角色后续任务已经存在，且其中包含用户修改过的控制文件。
+- 期望：复用已有任务，补建缺失任务；不覆盖用户修改，不删除业务任务，冲突进入待确认或 blocked。
+
+## 8. 发布边界回归
+
+- 输入：执行 v1.7.2 升级和任务补建。
+- 期望：CodeGraph 健康状态复用；不自动创建外部会话，不执行 SQL/Git 写操作，不修改业务代码、数据库、API、配置、依赖；输出明确区分已归档、已创建、已复用、可执行和待分配任务。