@pm_zhousl/xinyun-ai-init 1.7.2 → 1.8.0

package/test-scenarios/README.md

@@ -2,6 +2,8 @@
 
 本目录用于让其他 AI 或人工审查员测试 `@pm_zhousl/xinyun-ai-init` 初始化包的真实使用效果。
 
+当前版本必测场景为 `scenarios.md` 的 1-105，106 为观察项。
+
 ## 使用方式
 
 ### 1. 本地待发布版本测试
@@ -37,7 +39,7 @@ npm pack
 随后在临时项目中使用 tarball 测试。注意不要直接执行 `npx <tarball> --force`，该形式可能不会正确调用 bin。推荐：
 
 ```powershell
-npx --yes --package E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm\pm_zhousl-xinyun-ai-init-1.7.2.tgz xinyun-ai-init --force --no-version-check
+npx --yes --package E:\ai-fabu-xiangmu\AI开发初始化脚本\xinyun-ai-init-npm\pm_zhousl-xinyun-ai-init-1.8.0.tgz xinyun-ai-init --force --no-version-check
 ```
 
 ### 3. 线上回归测试
@@ -59,9 +61,9 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 - 必测场景：用于判断当前版本是否可以发布。
 - 观察场景：用于收集后续优化建议，不作为当前版本发布阻断项。
 
-当前必测场景为 `scenarios.md` 的 1-87。
+当前必测场景为 `scenarios.md` 的 1-96。
 
-当前观察场景为 `scenarios.md` 的 88。Skill 触发机制仍在后续候选池中，不进入当前可发布范围。
+当前观察场景为 `scenarios.md` 的 97。Skill 触发机制仍在后续候选池中，不进入当前可发布范围。
 
 ## v1.7 规则包一致性校验
 
@@ -70,7 +72,7 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 ```powershell
 npm run verify:rules
 npm run verify:rules -- --json
-npm run verify:rules -- --tarball .\pm_zhousl-xinyun-ai-init-1.7.2.tgz
+npm run verify:rules -- --tarball .\pm_zhousl-xinyun-ai-init-1.8.0.tgz
 npm run verify:rules:security
 ```
 
@@ -89,8 +91,16 @@ npm run verify:init
 
 除 `scenarios.md` 外，发布前必须逐条执行 `v1.7.2-scenarios.md`。重点验证已归档的 v1.7.1 项目能补建 5 个 `role-execution` 任务，活动任务不被错误显示为 idle，重复升级按逐角色幂等键复用，索引中断后可恢复。
 
+## v1.7.3 Codex 角色会话回归
+
+除 `scenarios.md` 外，发布前必须逐条执行 `v1.7.3-scenarios.md`。重点验证 Codex 主会话在 5 个 `role-execution` 本地任务之后创建或明确降级 5 个真实角色子会话，真实 `sessionId` 回写一致，创建后先进入只读 onboarding，重复升级复用，宿主不支持时使用 `local-degraded-no-fake-session-id` 且不得伪造 sessionId。
+
 ## 审查原则
 
+## v1.8 多会话协作回归
+
+除 `scenarios.md` 外，发布前必须逐条执行 `v1.8.0-scenarios.md`。重点验证四个阶段分别通过：A 的共享事实/事务状态，B 的 Skill 路由和 `assignmentStatus` 映射，C 的前端 audit-only/refactor-now 边界，D 的临时会话并发/occupancy 恢复。真实 AI 行为报告必须保存 before/after、changedFiles、禁止操作和敏感扫描结果。
+
 - 重点看 AI 行为是否符合规则，不只看文件是否生成。
 - 初始化应轻量，不做全量扫描。
 - 改代码前必须先出方案并等待确认。

package/test-scenarios/review-template.md

@@ -1,5 +1,7 @@
 # 测试审查记录模板
 
+当前版本 1-105 必测，106 为观察项。
+
 ## 基本信息
 
 - 测试项目：
@@ -91,7 +93,7 @@
 - 可以后续优化：
 - 不建议纳入本版本：
 
-说明：历史 Skill 触发测试是观察项。当前版本发布阻断以 1-87 必测场景为准。
+说明：历史 Skill 触发测试是观察项。当前版本发布阻断以 1-96 必测场景为准。
 ## v1.7 审查增量行
 
 | 场景 | 结果 | 证据 | 是否阻断 |
@@ -128,8 +130,26 @@
 | 85. v1.7.1 CodeGraph 失败矩阵 | 待填写 | 待填写 | 待填写 |
 | 86. v1.7.1 CodeGraph 状态登记与去重 | 待填写 | 待填写 | 待填写 |
 | 87. v1.7.1 普通咨询和版本回归 | 待填写 | 待填写 | 待填写 |
-| 88. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
+| 89. v1.7.3 Codex 真实角色会话创建 | 待填写 | 待填写 | 待填写 |
+| 90. v1.7.3 会话绑定回写一致性 | 待填写 | 待填写 | 待填写 |
+| 91. v1.7.3 onboarding 只读边界 | 待填写 | 待填写 | 待填写 |
+| 92. v1.7.3 会话幂等复用 | 待填写 | 待填写 | 待填写 |
+| 93. v1.7.3 宿主不支持本地降级 | 待填写 | 待填写 | 待填写 |
+| 94. v1.7.3 创建成功但回写失败恢复 | 待填写 | 待填写 | 待填写 |
+| 95. v1.7.3 单角色失败隔离 | 待填写 | 待填写 | 待填写 |
+| 96. v1.7.3 普通咨询边界 | 待填写 | 待填写 | 待填写 |
+| 97. Skill 触发测试（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
+
+| 98. v1.8-A 状态域和来源一致性 | 待填写 | 待填写 | 待填写 |
+| 99. v1.8-A 协调事务恢复 | 待填写 | 待填写 | 待填写 |
+| 100. v1.8-B Skill 路由和状态映射 | 待填写 | 待填写 | 待填写 |
+| 101. v1.8-C 前端耦合审计 | 待填写 | 待填写 | 待填写 |
+| 102. v1.8-D 临时会话队列和并发 | 待填写 | 待填写 | 待填写 |
+| 103. v1.8-D occupancy 恢复 | 待填写 | 待填写 | 待填写 |
+| 104. v1.8 跨会话冲突追溯 | 待填写 | 待填写 | 待填写 |
+| 105. v1.8 敏感信息边界 | 待填写 | 待填写 | 待填写 |
+| 106. Skill 自动触发倾向（观察项，不阻断发布） | 待填写 | 待填写 | 待填写 |
 
-说明：Skill 触发测试是观察项。除非它影响 1-87 的必测场景，否则不作为当前版本不可发布的理由。
+说明：Skill 触发测试是观察项。除非它影响 1-96 的必测场景，否则不作为当前版本不可发布的理由。
 
 

package/test-scenarios/scenarios.md

@@ -2,10 +2,10 @@
 
 ## 测试分级说明
 
-- 必测场景：1-87，用于判断当前版本是否可以发布。
-- 观察场景：88，用于收集后续优化建议，不作为当前版本发布阻断项。
+- 必测场景：1-105，用于判断当前版本是否可以发布。
+- 观察场景：106，用于收集后续优化建议，不作为当前版本发布阻断项。
 
-当前必测场景为 1-87；当前观察场景为 88。
+当前必测场景为 1-105；当前观察场景为 106。
 
 ## 1. 初始化可用性测试
 
@@ -1092,7 +1092,79 @@
 
 验收：不修改业务代码、数据库、API、配置、依赖或 Git。
 
-## 88. Skill 触发测试（观察项）
+## 89. v1.7.3 Codex 真实角色会话创建
+
+目标：验证 5 个 `role-execution` 本地任务存在后，Codex 主会话能创建或明确降级 5 个真实角色子会话。
+
+验收：
+- 覆盖 `project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer`。
+- 真实 `sessionId` 来自 Codex 宿主返回值。
+- CLI 仍只创建 `xinyun-ai-init/`。
+
+## 90. v1.7.3 会话绑定回写一致性
+
+目标：验证角色会话绑定同步到所有控制文件。
+
+验收：
+- `xinyun-ai/sessions/role-session-bindings.json` 可解析。
+- 角色任务、assignments、task-index、manifest、project-index、init-result 引用同一 binding/session 摘要。
+- 包含 `provider=codex`、`parentSessionId` 和 `sessionStatus`。
+
+## 91. v1.7.3 onboarding 只读边界
+
+目标：验证新建角色会话不会直接获得执行授权。
+
+验收：
+- 创建成功后先进入 `sessionStatus=onboarding`。
+- 未完成职责理解、职责确认、成员 / 会话绑定和确认门禁前不得 `ready`。
+- 不修改业务代码、数据库、API、配置、依赖或 Git。
+
+## 92. v1.7.3 会话幂等复用
+
+目标：验证重复升级不会重复创建角色会话。
+
+验收：
+- 幂等键为 `taskId + roleId + provider + targetVersion`。
+- 已有真实 sessionId 和 binding 被复用。
+- 不出现重复 roleId/taskId/provider/targetVersion 绑定。
+
+## 93. v1.7.3 宿主不支持本地降级
+
+目标：验证无法创建子会话时不得伪造 sessionId。
+
+验收：
+- `sessionId=null`。
+- 写入 `local-degraded-no-fake-session-id`。
+- `sessionStatus=blocked` 或 failed，并记录 reason/nextAction。
+
+## 94. v1.7.3 创建成功但回写失败恢复
+
+目标：验证 created-but-writeback-failed 可追溯和可恢复。
+
+验收：
+- 记录真实 sessionId 来源、失败文件和 audit。
+- 下次按幂等键查询并恢复绑定。
+- 不重复创建同一角色会话。
+
+## 95. v1.7.3 单角色失败隔离
+
+目标：验证单角色失败不影响其他角色。
+
+验收：
+- 失败角色单独 blocked 或 failed。
+- 其他角色继续 created/onboarding/ready 流程。
+- init-result 统计 createdCount/reusedCount/failedCount/blockedCount/localDegradedCount。
+
+## 96. v1.7.3 普通咨询边界
+
+目标：验证普通咨询不触发角色会话链。
+
+验收：
+- 不创建角色会话。
+- 不写 `xinyun-ai/sessions/role-session-bindings.json`。
+- 不创建外部账号、第三个会话或业务任务链。
+
+## 97. Skill 触发测试（观察项）
 
 目标：观察 AI 是否具备按任务触发 Skill 的倾向。
 
@@ -1109,4 +1181,40 @@
 - 是否触发需求理解或产品 / UI 设计前置理解。
 - 是否没有默认全量启用所有 Skill。
 - 是否先输出理解结果和改动计划。
+
+## 98. v1.8-A 状态域和来源一致性
+
+验证 `factStatus`、`changeStatus`、`conflictStatus`、`taskStatus`、`refreshStatus` 分域，非法组合或 revision 不一致统一 blocked；`queued` 只能属于临时会话状态。
+
+## 99. v1.8-A 协调事务恢复
+
+验证 `coordinationTransactionId`、JCS-SHA-256 幂等、事务阶段、目标文件哈希、崩溃恢复、权限失败和重复提交不覆盖历史。
+
+## 100. v1.8-B Skill 路由和状态映射
+
+验证已确认/未识别框架、Skill 排序、依赖缺失、权限不足和未审核 Skill；确认 `assignmentStatus` 与 `usageStatus` 映射，失败必须 blocked 并记录原因和下一步。
+
+## 101. v1.8-C 前端耦合审计
+
+验证 audit-only 零 diff，refactor-now 的计划/确认/允许路径/哈希/diff/测试证据，以及预算超限的 partial/unknown。
+
+## 102. v1.8-D 临时会话队列和并发
+
+验证临时程序员会话合法流转、单变更域互斥、最多 3 个运行会话、队列稳定排序和 occupancy 初始状态。
+
+## 103. v1.8-D occupancy 恢复
+
+验证崩溃、锁损坏、不可读会话进入 `occupancyStatus=unknown` 并持续占用，人工释放必须有完整 `releaseAudit`。
+
+## 104. v1.8 跨会话冲突追溯
+
+验证共享事实、改动台账、冲突记录、刷新状态和三道协调门禁可相互追溯，单会话不得自动合并。
+
+## 105. v1.8 敏感信息边界
+
+验证 Skill、事务、审计和会话交接中的 Token、密码、私钥、`.env`、连接串和 Authorization 原文均被脱敏，禁止操作和业务基线证据完整。
+
+## 106. Skill 自动触发倾向（观察项）
+
+观察已登记 Skill 是否被合理选择，不要求实现完整自动调度，不作为 v1.8 发布阻断项。
 

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。

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

@@ -0,0 +1,39 @@
+# v1.8.0 专属行为场景
+
+以下场景必须在独立夹具中执行，逐项保存 `input`、`before`、`after`、`result`、`changedFiles`、`forbiddenOperations`、`evidence` 和 `sensitiveScan`。不能以文本断言替代真实 AI 行为。
+
+## v1.8-01 状态域和来源一致性
+
+构造任务、改动、冲突和刷新记录的合法/非法组合。验证 `factStatus`、`changeStatus`、`conflictStatus`、`taskStatus`、`refreshStatus` 各自裁决，非法枚举或 revision 不一致统一进入 `taskStatus=blocked`、`blockedReason=status-inconsistent`；`queued` 不出现在 changeStatus。
+
+## v1.8-02 协调事务恢复
+
+重复提交、崩溃、部分重命名、索引/事实不同步、哈希不一致和权限失败。验证 `coordinationTransactionId` 幂等复用、事务阶段、每个 targetFiles 的 path/tempPath/beforeHash/afterHash/targetRevision，以及最终 `committed` 或 `blocked`，不得只更新索引或删除历史。
+
+## v1.8-03 Skill 路由与降级
+
+准备 ThinkPHP、uni-app、微信小程序、HTML、未识别框架、多 Skill 同级、依赖缺失、权限不足和未审核外部 Skill 夹具。验证 availabilityStatus/trustStatus 独立，排序稳定，`assignmentStatus` 与 `usageStatus` 严格映射；失败映射 blocked 并有 failureReason/nextAction，不安装依赖、不伪造执行。
+
+## v1.8-04 前端审计边界
+
+执行微信小程序、uni-app、HTML 页面耦合审计。验证 audit-only 零 diff；refactor-now 只有在计划、用户确认、允许路径、前后哈希、diff 和测试证据齐全时才可执行；超预算/权限失败进入 partial/unknown 并填写 unverifiedScope。
+
+## v1.8-05 临时会话状态和队列
+
+验证 `pending -> creating -> onboarding -> executing`、容量不足 `onboarding -> queued -> creating`、容量可用时 onboarding 直达 executing。检查单变更域不重复创建、并发上限 3、确认时间/优先级/taskId 稳定排序及初始 occupancy。
+
+## v1.8-06 occupancy 恢复和人工释放
+
+模拟崩溃、锁损坏、会话不可读和人工释放。验证 `occupancyStatus=unknown` 持续占用，失败不自动重试或关闭；只有包含 auditId/releasedBy/releasedAt/reason/evidence 的 releaseAudit 才能释放额度。
+
+## v1.8-07 跨会话冲突
+
+前端任务修改服务端 API 或字段时，验证领取前、写入前、完成后三道门禁，project-facts、change-ledger、conflict-records 和 refreshStatus 可相互追溯；单会话不能自动合并或裁决。
+
+## v1.8-08 敏感信息边界
+
+将 Token、密码、私钥、`.env`、连接串和 Authorization 值放入 Skill 输入、事务错误、审计证据和会话交接。验证 JSON、Markdown、日志、stdout/stderr 和快照无敏感原文，只保留脱敏结果、路径类别或哈希。
+
+## v1.8 禁止操作
+
+所有场景必须证明未修改业务代码、数据库、API、依赖、系统环境或 Git，未执行 npm publish，未自动安装依赖，业务基线哈希不变。