@pm_zhousl/xinyun-ai-init 1.7.1 → 1.7.3

package/README.md

@@ -24,7 +24,7 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 npm run verify:init
 npm run verify:rules
 npm run verify:rules -- --json
-npm run verify:rules -- --tarball ./pm_zhousl-xinyun-ai-init-1.7.1.tgz
+npm run verify:rules -- --tarball ./pm_zhousl-xinyun-ai-init-1.7.3.tgz
 ```
 
 `verify:rules` 为只读规则包一致性检查，不自动修复、不安装依赖、不修改 Git 或业务代码。

package/init/xinyun-ai-init/README.md

@@ -2,7 +2,7 @@
 
 本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
-当前规则版本：`1.7.1`。
+当前规则版本：`1.7.3`。
 
 ## Codex 一句话入口
 
@@ -18,6 +18,10 @@ AI 读取本文件后，必须把本 README、`rules/`、`templates/` 作为执
 npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 ```
 
+v1.7.2 fixed task contract keys: `taskKind=initialization-main`, `taskKind=initialization-record`, `taskKind=role-execution`.
+v1.7.3 fixed Codex role session contract keys: `provider=codex`, `sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`, `roleSessionIdempotency={taskId,roleId,provider,targetVersion}`.
+v1.7.3 Codex role session orchestration is host-level only; CLI still only creates `xinyun-ai-init/`.
+
 执行上面的命令后，会生成 `xinyun-ai-init/`。随后让 AI 读取 `xinyun-ai-init/README.md` 即可。
 
 ## AI 执行入口
@@ -1013,6 +1017,24 @@ CodeGraph 状态只能是 `initialized`、`healthy`、`missing`、`unavailable`
 
 CodeGraph 失败时，不自动安装 CodeGraph，不修改系统环境，不修改业务代码、数据库、API、配置、依赖或 Git。相同项目、相同 `codeGraphRecordId` 和相同失败状态只提示一次；命令、权限、服务或索引状态变化后才允许再次提示或重试。
 
+## v1.7.3 Codex 角色会话自动创建与绑定
+
+v1.7.3 在 v1.7.2 已创建或恢复 5 个 `role-execution` 本地任务之后，由 Codex 主会话尝试创建 5 个真实角色子会话：`project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer`。这是 Codex 宿主编排规则，不是 npm CLI 行为；CLI 边界保持不变，只创建 `xinyun-ai-init/`。
+
+会话绑定固定登记到 `xinyun-ai/sessions/role-session-bindings.json`，角色会话目录为 `xinyun-ai/sessions/roles/`，模板为 `xinyun-ai-init/templates/role-session-binding.template.json`。`manifest.json`、`project-index.json`、`task-index.json`、角色任务和 `assignments.json` 必须引用同一绑定记录。
+
+每个绑定至少记录：`bindingId`、`taskId`、`roleId`、`sessionId`、`parentSessionId`、`provider`、`targetVersion`、`sessionStatus`、`understandingStatus`、`confirmationStatus`、`executionEligible`、`idempotencyKey`、`hostCapability`、`createdAt`、`updatedAt`、`failure`、`degradation` 和 `audit`。
+
+`provider=codex`。`sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`。会话幂等键固定为 `taskId + roleId + provider + targetVersion` 的 JCS-SHA-256；重复升级或重复初始化必须优先复用已有真实会话和绑定，不得创建重复角色会话。
+
+真实 `sessionId` 必须来自 Codex 宿主创建会话后的返回值；不得伪造 sessionId，不得用任务 ID、角色 ID、占位符或历史摘要冒充真实会话。Codex 宿主不支持创建子会话、创建接口不可用或权限不足时，只能记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，并写入 `sessionStatus=blocked` 或 `failed`、`degradation.reason` 和 `nextAction`。
+
+创建成功后角色会话先进入 `onboarding`，且只读读取入口规则、角色任务、职责确认和角色理解资料。`sessionStatus=ready` 只有在真实 sessionId 已回写、职责理解完成、职责确认完成、成员/会话绑定有效、确认门禁和执行资格全部满足后才允许写入。创建成功不等于业务代码修改授权。
+
+会话创建成功但回写失败时，必须记录 `created-but-writeback-failed`、可查询恢复线索和真实 `sessionId` 来源；下次按幂等键查询并恢复绑定。单角色创建、回写或 onboarding 失败不得影响其他角色，失败角色单独进入 `blocked` 或 `failed`。
+
+任务界面、`current-task.md`、`init-result.json` 和项目索引必须展示 5 个角色会话入口、`sessionId`、`sessionStatus`、理解进度和阻塞原因。普通咨询不创建角色会话，不写绑定文件，不创建外部账号或第三个会话。
+
 ## 自我学习
 
 AI 可以沉淀项目经验，但不能自己升级正式规则。
@@ -1066,3 +1088,17 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 - 说明验证命令和结果；未验证时说明原因。
 - 说明风险、未完成事项和下一步动作。
 - 少复述规则，不输出明显 AI 话术，不把原型说明文案带入生产页面。
+
+## v1.7.2 初始化后角色任务可见性与执行任务分离
+
+`initialization-record` 只表示初始化控制面登记，可以随已完成主任务归档；它不表示角色已经理解、确认、绑定或完成执行。
+
+初始化登记归档时，必须为五个角色补建或保留独立的 `role-execution` 后续任务，保存到 `xinyun-ai/tasks/role-execution/<roleTaskId>.md`。每个任务必须包含 `taskId`、`roleTaskId`、`parentTaskId`、`roleId`、`taskKind`、`title`、`priority`、`status`、`assignmentStatus`、`understandingStatus`、`confirmationStatus`、`memberId`、`sessionId`、`executionEligible`、`blockedReason`、`nextAction`、`sourceTaskId`、`idempotencyKey`、`createdAt` 和 `updatedAt`。
+
+五个角色默认优先级为：`project-owner=10`、`project-product=20`、`chief-engineer=30`、`programmer=40`、`test-reviewer=50`；任务按 `priority` 升序、`createdAt` 升序、`roleId` Unicode 字典序、`taskId` 字典序排序（`priority ASC`）。
+
+`activeTaskIds` 必须包含所有未完成的角色后续任务，`executableTaskIds` 只包含满足成员绑定、职责确认、理解完成、确认人不冲突和 CodeGraph 条件的任务。`executableTaskIds` 可以为空，但只要 `activeTaskIds` 非空，`current-task.md` 就不得使用 `status=idle` 或 `taskId=null`，必须指向排序最高的活动任务；待分配使用 `status=pending`，权限、冲突或失败使用 `status=blocked`，并填写 `blockedReason` 或 `nextAction`。
+
+每个角色的幂等键是对 `{sourceTaskId, roleId, taskKind, targetVersion}` 使用 v1.6 JCS 规范化 JSON 后计算的 SHA-256，规范化算法为 `JCS-SHA-256`。同一幂等键只对应一个 `role-execution` 任务；重复升级复用已有任务并补齐索引，不覆盖用户控制文件或业务文件。
+
+补建使用逐角色临时文件、完整校验、原子重命名和任务索引原子更新。单角色写入失败记录 `status=blocked`、`blockedReason=write-failed`；部分成功为 `partial`，全失败为 `blocked`。索引更新中断时不得清空 `activeTaskIds` 或伪造 `idle`，下次按幂等键恢复。

package/init/xinyun-ai-init/rules/directory-self-completion.md

@@ -42,3 +42,18 @@
 - 归档事务文件必须使用 `xinyun-ai/tasks/.archive-transactions/<archiveTransactionId>.json`，不得放入业务目录。
 - `.codegraph/` 是工具控制目录，属于一句话初始化授权范围；CodeGraph 状态源为 `manifest.json`，其他控制文件只引用同一 `codeGraphRecordId`。
 - 普通咨询不创建完整主任务、五角色任务树或触发 CodeGraph 初始化。
+
+## v1.7.2 任务可见性目录
+
+- 需要补建角色后续任务时创建 `xinyun-ai/tasks/role-execution/`，不得把 `role-execution` 文件写入业务目录。
+- 同步校验 `task-index.json`、`current-task.md`、`manifest.json` 和 `project-index.json` 的角色执行任务路径与索引。
+- 活动角色任务不可执行时仍保留在 `activeTaskIds`；只有活动列表为空才允许 current-task 为 idle/null。
+- 逐角色临时文件和索引必须原子写入；发现中断、冲突或写入失败时保留恢复记录，不清空活动任务。
+
+## v1.7.3 角色会话绑定目录
+
+- Codex 角色会话绑定触发后，按需补齐 `xinyun-ai/sessions/`、`xinyun-ai/sessions/roles/` 和 `xinyun-ai/sessions/role-session-bindings.json`。
+- 绑定模板来源固定为 `xinyun-ai-init/templates/role-session-binding.template.json`。
+- `manifest.json`、`project-index.json` 和 `task-index.json` 必须登记 `roleSessions`、`roleSessionBindingIds`、`roleSessionBindings`、`provider=codex` 和 `sessionStatus` 枚举。
+- 绑定目录只保存 Codex 宿主返回的真实 `sessionId` 摘要、onboarding 状态、失败原因和 audit，不保存伪造 sessionId。
+- 宿主不支持创建子会话时，仍可补齐本地目录和降级记录，状态使用 `local-degraded-no-fake-session-id`。

package/init/xinyun-ai-init/rules/init-rules.md

@@ -55,3 +55,22 @@
 - 命令不存在=`unavailable`；目录不可写=`permission-denied`；MCP 未连接或健康状态无法确认=`unknown`；初始化命令失败或索引损坏=`failed`。
 - CodeGraph 必需任务失败时进入 `blocked`；只有用户明确授权限定范围降级时才允许 `partial`。
 - 不自动安装 CodeGraph，不修改系统环境、业务代码、数据库、API、配置、依赖或 Git。
+
+## v1.7.2 角色后续任务可见性
+
+- 初始化主任务使用 `taskKind=initialization-main`；角色登记使用 `taskKind=initialization-record`；后续执行任务使用 `taskKind=role-execution`。
+- 登记归档时必须保留五个 `xinyun-ai/tasks/role-execution/<roleTaskId>.md`，它们的 `sourceTaskId` 指向已归档初始化主任务，不能随登记归档清理。
+- `activeTaskIds` 包含未完成角色任务；`executableTaskIds` 只包含真正满足执行条件的任务。活动任务非空时不得写 `current-task.status=idle` 或 `taskId=null`。
+- 任务选择按 priority、createdAt、roleId、taskId 稳定排序；角色默认 priority 为 10、20、30、40、50。
+- 重复升级按逐角色 JCS-SHA-256 幂等键复用任务。写入失败记录 `blockedReason=write-failed`；部分成功为 `partial`，全失败为 `blocked`；索引失败时保留活动任务并在下次恢复。
+
+## v1.7.3 Codex 角色会话初始化
+
+- 只有 5 个 `role-execution` 本地任务已存在或已按幂等键恢复后，才允许 Codex 主会话尝试创建真实角色子会话。
+- 角色会话固定为 `project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer` 五个，不创建第三个类型的会话。
+- 会话创建属于 Codex 宿主编排规则，CLI 仍只创建 `xinyun-ai-init/`。
+- 创建或恢复绑定时写入 `xinyun-ai/sessions/role-session-bindings.json` 和 `xinyun-ai/sessions/roles/` 摘要，并同步 `manifest.json`、`project-index.json`、`task-index.json`、`assignments.json`、`current-task.md`、`init-result.json`。
+- 绑定必须使用 `provider=codex`，`sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`。
+- 幂等键固定为 `taskId + roleId + provider + targetVersion` 的 JCS-SHA-256。
+- 真实 `sessionId` 必须来自 Codex 宿主返回值；不得伪造 sessionId。宿主不支持时记录 `local-degraded-no-fake-session-id`，`sessionId=null`。
+- 创建成功后先进入只读 `onboarding`；`sessionStatus=ready` 必须等待职责理解、职责确认、成员 / 会话绑定和执行资格全部满足。

package/init/xinyun-ai-init/rules/session-workbench.md

@@ -248,3 +248,31 @@ HTML 迁移只允许评估和单页面 / 区块试点计划；实际代码迁移
 - `degradationAuthorized`
 
 `initialization-record` 登记完成不代表 `role-execution` 完成；执行会话不得把未绑定成员、未确认职责或未完成理解的角色任务标记为可执行。归档或 CodeGraph 状态冲突时必须暂停复核或进入 `blocked`，不得静默覆盖历史。
+
+## v1.7.2 角色执行任务补充字段
+
+- `roleExecutionPath`：xinyun-ai/tasks/role-execution/<roleTaskId>.md
+- `roleExecutionTaskKind`：role-execution
+- `sourceTaskId`、`idempotencyKey`、`priority`、`blockedReason`、`nextAction`
+- `activeTaskIds`、`executableTaskIds`、`currentTaskId`
+- `roleExecutionResult`：created / reused / blocked / write-failed
+- 活动任务非空时，交接单必须说明不可执行原因和下一步，不得写成“暂无待执行任务”。
+
+## v1.7.3 角色会话交接字段
+
+涉及 Codex 真实角色会话创建、绑定、恢复或降级时，任务单、交接单和行为证据必须补充：
+
+- `provider`：固定为 codex
+- `parentSessionId`
+- `sessionId`：必须为 Codex 宿主返回的真实值；不得伪造 sessionId
+- `sessionStatus`：pending / creating / created / onboarding / ready / blocked / failed / closed
+- `sessionBindingId`
+- `sessionBindingPath`：xinyun-ai/sessions/role-session-bindings.json
+- `roleSessionPath`：xinyun-ai/sessions/roles/<roleId>.md
+- `roleSessionIdempotency`：taskId + roleId + provider + targetVersion
+- `hostCapability`：available / unavailable / permission-denied / unknown / failed
+- `degradationReason`：local-degraded-no-fake-session-id / none
+- `onboardingStatus`
+- `created-but-writeback-failed` 恢复线索
+
+会话创建成功只代表可进入只读 onboarding；不得把 `created` 直接写成 `ready`，不得因此获得业务代码修改授权。普通咨询不创建角色会话，也不写 `role-session-bindings.json`。

package/init/xinyun-ai-init/rules/upgrade-rules.md

@@ -93,3 +93,21 @@
 - 缺少 CodeGraph 状态闭环时，补齐 `manifest.json` 的 `codeGraphRecordId` 状态源，并让 `project-index.json`、`current-task.md`、`init-result.json` 引用同一记录。
 - `.codegraph/` 缺失且命令可用时，初始化流程可执行一次 `codegraph init -i`；升级规则不得自动安装 CodeGraph 或修改系统环境。
 - CodeGraph 命令不可用、目录不可写、MCP 未连接、初始化失败或索引损坏时，按 `unavailable`、`permission-denied`、`unknown`、`failed` 固定矩阵登记，必需任务保持 `blocked`。
+
+## v1.7.2 升级补建角色后续任务
+
+- 已发布 v1.7.1 项目升级时，归档中存在五个登记任务但活动索引缺少角色后续任务的，补建五个 `role-execution` 任务到 `xinyun-ai/tasks/role-execution/`。
+- 每个任务必须关联 `sourceTaskId`、`parentTaskId` 和 `roleId`，并使用 `{sourceTaskId, roleId, taskKind, targetVersion}` 的 JCS-SHA-256 幂等键。
+- 已有任务直接复用，缺失任务逐角色补建；不得覆盖用户修改的控制文件、业务任务或业务代码。
+- `activeTaskIds` 非空时，即使 `executableTaskIds=[]`，也必须让 `current-task.md` 指向最高优先级活动任务，不能显示 `idle`。
+- 单角色写入失败为 `blocked/write-failed`，部分成功为 `partial`，全失败为 `blocked`；索引更新失败不得清空活动索引，下次按幂等键恢复。
+
+## v1.7.3 升级创建和绑定真实角色会话
+
+- 升级到 v1.7.3 时，先确认 5 个 `role-execution` 本地任务已存在；缺失时按 v1.7.2 幂等规则补齐，再处理真实会话创建。
+- Codex 主会话可为 5 个角色任务创建真实角色子会话，并把真实 `sessionId` 回写到角色任务、`assignments.json`、`task-index.json`、`manifest.json`、`project-index.json` 和 `xinyun-ai/sessions/role-session-bindings.json`。
+- 会话绑定幂等键固定为 `taskId + roleId + provider + targetVersion`；重复升级必须复用已有绑定和真实 `sessionId`。
+- 如果会话已创建但回写失败，下一次升级必须先查询宿主已有会话并恢复绑定，记录 `created-but-writeback-failed` 和 audit，不得再次创建重复会话。
+- 单角色创建或回写失败不得影响其他角色；失败角色进入 `blocked` 或 `failed` 并记录 `blockedReason` / `failureReason` / `nextAction`。
+- Codex 宿主不支持创建子会话、权限不足或接口不可用时，使用本地降级 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，不得伪造 sessionId。
+- 创建成功后的角色会话为只读 `onboarding`，不得直接获得业务代码、数据库、API、配置、依赖、Git 写操作或发布授权。

package/init/xinyun-ai-init/templates/AGENTS.template.md

@@ -178,6 +178,24 @@ HTML 整站转微信小程序或 uni-app 的迁移评估与单页面 / 区块试
 
 CodeGraph 为必需能力时，只有 `initialized` 或 `healthy` 才能将结构理解或影响审视标记为完成；失败时相关任务进入 `blocked`，只有用户明确授权限定范围降级才允许 `partial`。不得自动安装 CodeGraph、修改系统环境、业务代码、数据库、API、配置、依赖或 Git。
 
+## v1.7.2 角色后续任务可见性
+
+- `initialization-main` 是初始化主任务；`initialization-record` 是可归档登记；`role-execution` 是独立后续任务。
+- 登记归档后必须保留五个 `xinyun-ai/tasks/role-execution/<roleTaskId>.md`，并关联已归档主任务的 `sourceTaskId`。
+- `activeTaskIds` 非空时不得把 `current-task.md` 写成 idle/null；不可执行任务使用 pending 或 blocked，并显示 blockedReason/nextAction。
+- 重复升级按逐角色幂等键复用任务；写入或索引失败时保留活动任务并恢复，不得清空索引。
+
+## v1.7.3 Codex 角色会话自动创建与绑定
+
+- v1.7.3 在 5 个 `role-execution` 本地任务创建或恢复后，由 Codex 主会话尝试创建 5 个真实角色子会话；这是 Codex 宿主编排规则，不是 npm CLI 行为。
+- CLI 仍只创建 `xinyun-ai-init/`，不得直接创建 `xinyun-ai/`、业务代码或真实角色会话。
+- 绑定文件固定为 `xinyun-ai/sessions/role-session-bindings.json`，角色会话目录固定为 `xinyun-ai/sessions/roles/`，模板为 `xinyun-ai-init/templates/role-session-binding.template.json`。
+- 每个角色绑定必须记录 `provider=codex`、`parentSessionId`、真实 `sessionId`、`sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`、理解进度、确认进度和阻塞原因。
+- 会话幂等键固定为 `taskId + roleId + provider + targetVersion`；重复升级复用已有真实会话和绑定。
+- 真实 `sessionId` 必须来自 Codex 宿主返回值；不得伪造 sessionId。宿主不支持时记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`。
+- 创建后的角色会话先进入只读 `onboarding`；只有职责理解、职责确认、成员 / 会话绑定、确认门禁和执行资格都满足后才允许 `sessionStatus=ready`。
+- 创建成功不等于业务代码修改授权；普通咨询不创建角色会话，不写绑定文件，不创建外部账号或第三个会话。
+
 AI 接手本项目时，请先读取：
 
 - `xinyun-ai/README.md`

package/init/xinyun-ai-init/templates/core-rules.template.md

@@ -425,6 +425,29 @@
 | `completed` | `applied` / `not-started` | `released` |
 | `cancelled` | `failed` / `not-started` | `released` |
 
+v1.7.2 fixed task contract keys: `taskKind=initialization-main`, `taskKind=initialization-record`, `taskKind=role-execution`.
+The fixed task ordering expression is `priority ASC`, followed by `createdAt ASC`, roleId Unicode order, and taskId order.
+A single-role write failure records `status=blocked` and `blockedReason=write-failed`.
+v1.7.3 Codex role session orchestration is host-level only; CLI still only creates `xinyun-ai-init/`.
+v1.7.3 fixed Codex role session contract keys: `provider=codex`, `sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`, `roleSessionIdempotency={taskId,roleId,provider,targetVersion}`.
+
+## v1.7.3 Codex 角色会话自动创建与绑定
+
+- v1.7.3 只在 5 个 `role-execution` 本地任务已经创建或恢复后，才由 Codex 主会话尝试创建 5 个真实角色子会话：`project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer`。
+- 这是 Codex 宿主编排规则，不是 npm CLI 行为；CLI 边界保持不变，只创建 `xinyun-ai-init/`，不得直接创建 `xinyun-ai/`、业务代码或真实会话。
+- 会话绑定固定登记到 `xinyun-ai/sessions/role-session-bindings.json`，角色会话目录为 `xinyun-ai/sessions/roles/`，绑定模板为 `xinyun-ai-init/templates/role-session-binding.template.json`。
+- `manifest.json`、`project-index.json`、`task-index.json`、`role-execution` 任务、`assignments.json` 和 `init-result.json` 必须引用同一 `bindingId` / `sessionId` / `sessionStatus` 摘要。
+- `provider=codex`；`sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`。
+- 会话幂等键固定为 `taskId + roleId + provider + targetVersion` 的 JCS-SHA-256；重复升级必须复用已有真实会话和绑定，不得重复创建同一角色会话。
+- 真实 `sessionId` 必须来自 Codex 宿主创建会话后的返回值；不得伪造 sessionId，不得用任务 ID、角色 ID、占位符或历史摘要冒充真实会话。
+- Codex 宿主不支持创建子会话、创建接口不可用或权限不足时，只能记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，并写入 `sessionStatus=blocked` 或 `failed`、`degradation.reason` 和 `nextAction`。
+- 创建成功后角色会话先进入 `onboarding` 且只读读取入口规则、角色任务、职责确认和角色理解资料；`sessionStatus=ready` 必须等待真实 sessionId 回写、职责理解完成、职责确认完成、成员 / 会话绑定有效、确认门禁和执行资格全部满足。
+- 创建成功不等于业务代码修改授权；任何业务代码、数据库、API、配置、依赖、Git 写操作或发布仍需独立计划和用户确认。
+- 会话创建成功但回写失败时，必须记录 `created-but-writeback-failed`、真实 `sessionId` 来源、恢复线索和 audit；下次按幂等键查询并恢复绑定。
+- 单角色创建、回写或 onboarding 失败不得影响其他角色；失败角色单独进入 `blocked` 或 `failed`。
+- 任务界面、`current-task.md`、`init-result.json` 和项目索引必须展示 5 个角色会话入口、`sessionId`、`sessionStatus`、理解进度和阻塞原因。
+- 普通咨询不创建角色会话，不写绑定文件，不创建外部账号，不创建第三个会话。
+
 - `current-task.md`、`tasks/<taskId>.md`、`init-result.json` 和 `task-lock.json` 的 `taskId`、`executionId`、`attempt`、状态和时间必须一致。
 - 任意文件出现不在表内的组合，主会话必须将任务改为 `blocked`，写入冲突原因并停止继续写入。
 
@@ -528,6 +551,17 @@
 - 不自动安装 CodeGraph，不修改系统环境、业务代码、数据库、API、配置、依赖或 Git。
 - 相同项目、相同 `codeGraphRecordId` 和相同失败状态只提示一次；命令、权限、服务或索引状态变化后才允许再次提示或重试。
 
+## v1.7.2 初始化后角色任务可见性与执行任务分离
+
+- `initialization-main` 是初始化主任务；`initialization-record` 只表示角色登记控制面完成；`role-execution` 才表示角色后续执行任务。
+- 初始化登记归档时必须补建或保留五个 `role-execution` 任务，路径为 `xinyun-ai/tasks/role-execution/<roleTaskId>.md`，`sourceTaskId` 指向已归档初始化主任务。
+- `role-execution` 最小字段为 `taskId`、`roleTaskId`、`parentTaskId`、`roleId`、`taskKind`、`title`、`priority`、`status`、`assignmentStatus`、`understandingStatus`、`confirmationStatus`、`memberId`、`sessionId`、`executionEligible`、`blockedReason`、`nextAction`、`sourceTaskId`、`idempotencyKey`、`createdAt`、`updatedAt`。
+- `activeTaskIds` 包含所有未完成角色任务；`executableTaskIds` 只包含满足执行前置条件的任务。活动任务存在时 `current-task.md` 不得为 `idle/null`。
+- 默认优先级为 project-owner 10、project-product 20、chief-engineer 30、programmer 40、test-reviewer 50；排序为 priority、createdAt、roleId Unicode 字典序、taskId 字典序。
+- 待分配任务使用 `status=pending`；权限、冲突或失败使用 `status=blocked`，并填写 `blockedReason` 或 `nextAction`。
+- 幂等键固定为 `{sourceTaskId, roleId, taskKind, targetVersion}` 的 JCS-SHA-256；同键复用同一任务。
+- 单角色写入失败为 `blocked/write-failed`，部分成功为 `partial`，全失败为 `blocked`；索引更新中断时保留活动任务并按幂等键恢复，不得伪造 `idle`。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

package/init/xinyun-ai-init/templates/current-task.template.md

@@ -125,8 +125,33 @@
   - executionEligible：false
   - memberId：null
   - sessionId：null
+  - parentSessionId：null
+  - provider：codex
+  - sessionStatus：pending / creating / created / onboarding / ready / blocked / failed / closed
+  - sessionBindingId：
+  - sessionBindingPath：xinyun-ai/sessions/role-session-bindings.json
   - taskIndex：xinyun-ai/tasks/task-index.json
   - currentTaskIdleStatus：status=idle, taskId=null, title=暂无待执行任务
+- Codex 角色会话：
+  - provider：codex
+  - parentSessionId：
+  - requiredRoleCount：5
+  - createdCount：
+  - reusedCount：
+  - failedCount：
+  - blockedCount：
+  - localDegradedCount：
+  - bindingsPath：xinyun-ai/sessions/role-session-bindings.json
+  - sessionStatusEnum：pending / creating / created / onboarding / ready / blocked / failed / closed
+  - 角色会话入口：
+    - roleId：
+    - taskId：
+    - sessionId：
+    - sessionStatus：
+    - understandingStatus：
+    - blockedReason：
+  - 宿主能力：
+  - 降级原因：
 - 任务归档：
   - archiveTransactionId：
   - archivePath：xinyun-ai/tasks/archive/<taskId>/

package/init/xinyun-ai-init/templates/init-result.template.json

@@ -7,7 +7,7 @@
   "mode": "initialization",
   "status": "pending",
   "currentVersion": null,
-  "targetVersion": "1.7.1",
+  "targetVersion": "1.7.3",
   "idempotencyKey": null,
   "createdFiles": [],
   "updatedFiles": [],
@@ -31,6 +31,19 @@
     "archiveTransactionId": null,
     "archiveStatus": "not-started"
   },
+  "roleSessions": {
+    "provider": "codex",
+    "parentSessionId": null,
+    "requiredRoleCount": 5,
+    "createdCount": 0,
+    "reusedCount": 0,
+    "failedCount": 0,
+    "blockedCount": 0,
+    "localDegradedCount": 0,
+    "bindings": [],
+    "hostCapability": "unknown",
+    "degradationReason": null
+  },
   "codeGraph": {
     "codeGraphRecordId": null,
     "required": true,

package/init/xinyun-ai-init/templates/managed-baseline.template.json

@@ -3,13 +3,13 @@
   "hashAlgorithm": "sha256",
   "contentEncoding": "utf8-normalized",
   "managedBy": "@pm_zhousl/xinyun-ai-init",
-  "lastAppliedVersion": "1.7.1",
+  "lastAppliedVersion": "1.7.3",
   "files": [
     {
       "path": "xinyun-ai/rules/core-rules.md",
       "baselineHash": null,
       "templateHash": null,
-      "lastAppliedVersion": "1.7.1",
+      "lastAppliedVersion": "1.7.3",
       "managedBy": "@pm_zhousl/xinyun-ai-init",
       "status": "unknown"
     }

package/init/xinyun-ai-init/templates/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.7.1",
-  "scriptVersion": "2026.07.20",
+  "xinyunAiVersion": "1.7.3",
+  "scriptVersion": "2026.07.22",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -44,7 +44,9 @@
     "htmlToClientMigrationPreparation": true,
     "namedInitializationTaskTree": true,
     "taskArchiveTransactions": true,
-    "codeGraphRequiredInitialization": true
+    "codeGraphRequiredInitialization": true,
+    "roleExecutionVisibility": true,
+    "codexRoleSessionOrchestration": true
   },
   "tasking": {
     "currentTask": "xinyun-ai/current-task.md",
@@ -61,7 +63,43 @@
     "mainTaskTemplate": "xinyun-ai-init/templates/task-main.template.md",
     "roleSubtaskTemplate": "xinyun-ai-init/templates/role-subtask.template.md",
     "taskIndexTemplate": "xinyun-ai-init/templates/task-index.template.json",
-    "archiveTransactionTemplate": "xinyun-ai-init/templates/archive-transaction.template.json"
+    "archiveTransactionTemplate": "xinyun-ai-init/templates/archive-transaction.template.json",
+    "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
+    "roleExecutionTemplate": "xinyun-ai-init/templates/role-execution.template.md",
+    "roleSessionBindings": "xinyun-ai/sessions/role-session-bindings.json",
+    "roleSessionBindingTemplate": "xinyun-ai-init/templates/role-session-binding.template.json"
+  },
+  "roleSessions": {
+    "enabled": true,
+    "provider": "codex",
+    "directory": "xinyun-ai/sessions/roles/",
+    "bindings": "xinyun-ai/sessions/role-session-bindings.json",
+    "bindingTemplate": "xinyun-ai-init/templates/role-session-binding.template.json",
+    "parentSessionId": null,
+    "targetVersion": "1.7.3",
+    "requiredRoleCount": 5,
+    "statusEnum": [
+      "pending",
+      "creating",
+      "created",
+      "onboarding",
+      "ready",
+      "blocked",
+      "failed",
+      "closed"
+    ],
+    "idempotency": {
+      "keyFields": [
+        "taskId",
+        "roleId",
+        "provider",
+        "targetVersion"
+      ],
+      "algorithm": "JCS-SHA-256",
+      "duplicatePolicy": "reuse"
+    },
+    "hostUnsupportedPolicy": "local-degraded-no-fake-session-id",
+    "readyPolicy": "created session enters onboarding first; ready requires role understanding, responsibility confirmation, and execution eligibility gates."
   },
   "taskTree": {
     "enabled": true,
@@ -71,7 +109,18 @@
     "taskIndex": "xinyun-ai/tasks/task-index.json",
     "archiveDirectory": "xinyun-ai/tasks/archive/",
     "archiveTransactionsDirectory": "xinyun-ai/tasks/.archive-transactions/",
-    "roleTaskCount": 5
+    "roleTaskCount": 5,
+    "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
+    "roleExecutionPathPattern": "xinyun-ai/tasks/role-execution/<roleTaskId>.md",
+    "roleExecutionTaskKind": "role-execution",
+    "roleExecutionPriority": {
+      "project-owner": 10,
+      "project-product": 20,
+      "chief-engineer": 30,
+      "programmer": 40,
+      "test-reviewer": 50
+    },
+    "taskSortOrder": ["priority", "createdAt", "roleId", "taskId"]
   },
   "codeGraphRequired": {
     "codeGraphRecordId": null,

package/init/xinyun-ai-init/templates/project-check.template.md

@@ -117,6 +117,28 @@
 - 是否未自动安装 CodeGraph、修改系统环境、业务代码、数据库、API、配置、依赖或 Git：待填写
 ## v1.7 machine-readable enum anchors
 
+## v1.7.2 checks
+
+- 归档后是否保留五个 role-execution 活动任务：待填写
+- activeTaskIds 非空且 executableTaskIds 为空时是否指向最高优先级任务：待填写
+- 重复升级是否按逐角色 JCS-SHA-256 幂等键复用：待填写
+- 单角色失败是否为 blocked/write-failed，索引中断是否可恢复：待填写
+
+## v1.7.3 checks
+
+- 是否创建或复用 5 个 Codex 真实角色会话：待填写
+- `provider=codex` 是否一致：待填写
+- `xinyun-ai/sessions/role-session-bindings.json` 是否可解析：待填写
+- `xinyun-ai/sessions/roles/` 是否登记五个角色入口：待填写
+- `sessionStatus` 是否只使用 pending / creating / created / onboarding / ready / blocked / failed / closed：待填写
+- `roleSessionIdempotency` 是否为 taskId + roleId + provider + targetVersion：待填写
+- 真实 `sessionId` 是否来自宿主返回值：待填写
+- 是否不存在伪造 sessionId：待填写
+- 创建后是否先进入只读 onboarding，未直接 ready：待填写
+- 宿主不支持时是否记录 local-degraded-no-fake-session-id 且 sessionId=null：待填写
+- created-but-writeback-failed 是否可恢复：待填写
+- 普通咨询是否未创建角色会话或第三个会话：待填写
+
 - frameworkStatus=confirmed/inferred/not-found/unknown/detected-unsupported
 - moduleStatus=loaded/not-loaded
 - activation=loaded/not-loaded

package/init/xinyun-ai-init/templates/project-guide.template.md

@@ -201,6 +201,27 @@
 - scope/unverifiedScope：每项至少包含 itemId / path / itemType / reason / checkedAt。
 ## v1.7 machine-readable enum anchors
 
+## v1.7.2 role execution anchors
+
+- role-execution：xinyun-ai/tasks/role-execution/<roleTaskId>.md
+- activeTaskIds / executableTaskIds：活动任务与可执行任务分离
+- priority ASC / createdAt ASC / roleId Unicode / taskId：稳定排序
+- idempotencyKey：JCS-SHA-256(sourceTaskId, roleId, taskKind, targetVersion)
+- activeTaskIds 非空时 current-task 不得为 idle/null
+
+## v1.7.3 Codex role session anchors
+
+- role session provider：provider=codex
+- role session bindings：xinyun-ai/sessions/role-session-bindings.json
+- role session directory：xinyun-ai/sessions/roles/
+- sessionStatus：pending / creating / created / onboarding / ready / blocked / failed / closed
+- roleSessionIdempotency：JCS-SHA-256(taskId, roleId, provider, targetVersion)
+- parentSessionId：待填写
+- real sessionId：待填写；不得伪造 sessionId
+- onboarding：created 后先只读 onboarding，不能直接 ready
+- host unsupported：local-degraded-no-fake-session-id
+- created-but-writeback-failed：待填写恢复线索
+
 - frameworkStatus=confirmed/inferred/not-found/unknown/detected-unsupported
 - moduleStatus=loaded/not-loaded
 - activation=loaded/not-loaded

package/init/xinyun-ai-init/templates/project-index.template.json

@@ -92,6 +92,7 @@
     "archiveDirectory": "xinyun-ai/tasks/archive/",
     "archiveTransactionsDirectory": "xinyun-ai/tasks/.archive-transactions/",
     "archiveTempDirectory": "xinyun-ai/tasks/.archive-tmp/",
+    "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
     "initResult": "xinyun-ai/init-result.json",
     "taskLock": "xinyun-ai/task-lock.json",
     "managedBaseline": "xinyun-ai/index/managed-baseline.json",
@@ -111,14 +112,46 @@
     "taskIndex": "xinyun-ai/tasks/task-index.json",
     "mainTaskPathPattern": "xinyun-ai/tasks/<taskId>.md",
     "roleSubtaskPathPattern": "xinyun-ai/tasks/<taskId>/subtasks/<roleTaskId>.md",
+    "roleExecutionPathPattern": "xinyun-ai/tasks/role-execution/<roleTaskId>.md",
     "archiveDirectory": "xinyun-ai/tasks/archive/",
     "archiveTransactionsDirectory": "xinyun-ai/tasks/.archive-transactions/",
     "currentTaskIdle": {
       "status": "idle",
       "taskId": null,
       "title": "暂无待执行任务"
+    },
+    "roleExecution": {
+      "directory": "xinyun-ai/tasks/role-execution/",
+      "taskKind": "role-execution",
+      "priority": {
+        "project-owner": 10,
+        "project-product": 20,
+        "chief-engineer": 30,
+        "programmer": 40,
+        "test-reviewer": 50
+      },
+      "sortOrder": ["priority", "createdAt", "roleId", "taskId"]
     }
   },
+  "roleSessions": {
+    "enabled": true,
+    "provider": "codex",
+    "directory": "xinyun-ai/sessions/roles/",
+    "bindings": "xinyun-ai/sessions/role-session-bindings.json",
+    "bindingTemplate": "xinyun-ai-init/templates/role-session-binding.template.json",
+    "requiredRoleCount": 5,
+    "statusEnum": [
+      "pending",
+      "creating",
+      "created",
+      "onboarding",
+      "ready",
+      "blocked",
+      "failed",
+      "closed"
+    ],
+    "records": []
+  },
   "codeGraphRequired": {
     "codeGraphRecordId": null,
     "required": true,

package/init/xinyun-ai-init/templates/role-execution.template.md

@@ -0,0 +1,53 @@
+# 角色后续执行任务
+
+- taskId：role-execution-task-template
+- roleTaskId：role-task-template
+- parentTaskId：task-template
+- roleId：project-owner
+- taskKind：role-execution
+- title：角色后续执行：project-owner
+- priority：10
+- status：pending
+- assignmentStatus：pending
+- understandingStatus：pending
+- confirmationStatus：pending
+- memberId：null
+- sessionId：null
+- parentSessionId：null
+- provider：codex
+- sessionStatus：pending
+- sessionBindingId：
+- sessionBindingPath：xinyun-ai/sessions/role-session-bindings.json
+- executionEligible：false
+- blockedReason：member-unassigned
+- nextAction：绑定成员、完成职责确认和项目理解后再执行
+- sourceTaskId：task-template
+- idempotencyKey：
+- sessionIdempotencyKey：
+- createdAt：2026-07-21T00:00:00.000Z
+- updatedAt：2026-07-21T00:00:00.000Z
+
+## 状态与可见性
+
+- `taskKind=role-execution` 表示角色后续实际执行任务，不表示已经获得业务代码修改授权。
+- 未绑定成员、职责确认待处理或理解未完成时，任务仍属于 `activeTaskIds`，但不得进入 `executableTaskIds`。
+- `executionEligible=true` 必须同时满足成员绑定、角色 ready、职责 confirmed、理解 ready、确认人不冲突和 CodeGraph 必备条件。
+- 待分配任务使用 `status=pending`；权限、冲突、写入失败或不可恢复错误使用 `status=blocked`，并填写 `blockedReason` 和 `nextAction`。
+- `sourceTaskId` 指向已经归档的初始化主任务；角色任务完成前不得加入 `archivedTaskIds`。
+
+## Codex 真实角色会话绑定
+
+- v1.7.3 中，Codex 主会话在 5 个 `role-execution` 本地任务创建或恢复后，可以为 `project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer` 固定创建 5 个真实角色子会话。
+- 真实 `sessionId` 只能来自 Codex 宿主创建子会话后的返回值；不得使用 `taskId`、`roleTaskId`、随机占位字符串或本地模拟值冒充。
+- 会话绑定字段至少包含 `taskId`、`roleId`、`sessionId`、`parentSessionId`、`provider`、`sessionStatus`、`createdAt`、`updatedAt`。
+- 会话状态固定为 `pending/creating/created/onboarding/ready/blocked/failed/closed`。
+- 会话创建成功后先进入 `sessionStatus=onboarding`，只读职责范围内资料并生成角色理解记录；不得因会话创建成功直接把任务标为 `ready` 或获得业务代码修改授权。
+- 只有角色理解完成、职责确认完成、成员/会话绑定满足、确认人关系无冲突且执行门禁满足时，才允许 `sessionStatus=ready` 与 `executionEligible=true`。
+- Codex 宿主不支持创建子会话、权限不足或创建失败时，必须保留 `sessionId=null`，记录 `sessionStatus=blocked/failed`、失败原因和本地降级说明，不得伪造会话。
+
+## 幂等
+
+- `idempotencyKey` 是对 `{sourceTaskId, roleId, taskKind, targetVersion}` 使用 v1.6 JCS 规范化 JSON 后计算的 SHA-256。
+- 同一幂等键只允许对应一个角色后续任务；重复升级必须复用任务并补齐索引。
+- `sessionIdempotencyKey` 是对 `{taskId, roleId, provider, targetVersion}` 使用 JCS 规范化 JSON 后计算的 SHA-256。
+- 同一 `sessionIdempotencyKey` 只允许绑定一个有效真实角色会话；会话已创建但本地回写失败时，下次升级必须按该键查询并补齐绑定，不得创建第二个会话。

package/init/xinyun-ai-init/templates/role-session-binding.template.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": 1,
+  "bindingId": "role-session-binding-template",
+  "taskId": "role-execution-task-template",
+  "roleId": "project-owner",
+  "sessionId": null,
+  "parentSessionId": null,
+  "provider": "codex",
+  "targetVersion": "1.7.3",
+  "sessionStatus": "pending",
+  "understandingStatus": "pending",
+  "confirmationStatus": "pending",
+  "executionEligible": false,
+  "idempotencyKey": null,
+  "hostCapability": "unknown",
+  "createdAt": "2026-07-22T00:00:00.000Z",
+  "updatedAt": "2026-07-22T00:00:00.000Z",
+  "createdBy": "main-session",
+  "onboarding": {
+    "readOnly": true,
+    "startedAt": null,
+    "completedAt": null,
+    "understandingRecord": null,
+    "readyRequires": [
+      "real sessionId returned by host",
+      "role understanding ready",
+      "responsibility confirmation confirmed",
+      "execution eligibility gates satisfied"
+    ]
+  },
+  "failure": {
+    "blockedReason": null,
+    "failureReason": null,
+    "retryCount": 0,
+    "nextAction": null
+  },
+  "degradation": {
+    "localOnly": false,
+    "reason": null,
+    "fakeSessionIdProhibited": true
+  },
+  "audit": []
+}