@pm_zhousl/xinyun-ai-init 1.7.2 → 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.2.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.2`。
+当前规则版本：`1.7.3`。
 
 ## Codex 一句话入口
 
@@ -19,6 +19,8 @@ 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` 即可。
 
@@ -1015,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 可以沉淀项目经验，但不能自己升级正式规则。

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

@@ -49,3 +49,11 @@
 - 同步校验 `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

@@ -63,3 +63,14 @@
 - `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

@@ -257,3 +257,22 @@ HTML 迁移只允许评估和单页面 / 区块试点计划；实际代码迁移
 - `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

@@ -101,3 +101,13 @@
 - 已有任务直接复用，缺失任务逐角色补建；不得覆盖用户修改的控制文件、业务任务或业务代码。
 - `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

@@ -185,6 +185,17 @@ CodeGraph 为必需能力时，只有 `initialized` 或 `healthy` 才能将结
 - `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

@@ -428,6 +428,25 @@
 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`，写入冲突原因并停止继续写入。

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.2",
+  "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.2",
+  "lastAppliedVersion": "1.7.3",
   "files": [
     {
       "path": "xinyun-ai/rules/core-rules.md",
       "baselineHash": null,
       "templateHash": null,
-      "lastAppliedVersion": "1.7.2",
+      "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.2",
-  "scriptVersion": "2026.07.20",
+  "xinyunAiVersion": "1.7.3",
+  "scriptVersion": "2026.07.22",
   "schemaVersion": "1",
   "initializationMode": "fast",
   "expansionMode": "triggered",
@@ -44,8 +44,9 @@
     "htmlToClientMigrationPreparation": true,
     "namedInitializationTaskTree": true,
     "taskArchiveTransactions": true,
-    "codeGraphRequiredInitialization": true
-    ,"roleExecutionVisibility": true
+    "codeGraphRequiredInitialization": true,
+    "roleExecutionVisibility": true,
+    "codexRoleSessionOrchestration": true
   },
   "tasking": {
     "currentTask": "xinyun-ai/current-task.md",
@@ -62,9 +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"
-    ,"roleExecutionDirectory": "xinyun-ai/tasks/role-execution/"
-    ,"roleExecutionTemplate": "xinyun-ai-init/templates/role-execution.template.md"
+    "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,

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

@@ -124,6 +124,21 @@
 - 重复升级是否按逐角色 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

@@ -209,6 +209,19 @@
 - 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

@@ -133,6 +133,25 @@
       "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

@@ -13,11 +13,17 @@
 - 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
 
@@ -29,7 +35,19 @@
 - 待分配任务使用 `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": []
+}

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

@@ -6,7 +6,9 @@
   "currentTaskId": null,
   "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
   "roleExecutionTaskIds": [],
+  "roleSessionBindingIds": [],
   "roleExecutionStatusEnum": ["pending", "assigned", "accepted", "executing", "paused", "blocked", "completed", "cancelled"],
+  "roleSessionStatusEnum": ["pending", "creating", "created", "onboarding", "ready", "blocked", "failed", "closed"],
   "roleExecutionPriority": {
     "project-owner": 10,
     "project-product": 20,
@@ -25,7 +27,13 @@
     "algorithm": "JCS-SHA-256",
     "duplicatePolicy": "reuse"
   },
+  "roleSessionIdempotency": {
+    "keyFields": ["taskId", "roleId", "provider", "targetVersion"],
+    "algorithm": "JCS-SHA-256",
+    "duplicatePolicy": "reuse"
+  },
   "tasks": [],
+  "roleSessionBindings": [],
   "archiveTransactions": [],
   "statusEnum": ["pending", "executing", "partial", "blocked", "completed", "cancelled"],
   "idleCurrentTask": {

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

@@ -9,6 +9,16 @@
 - `confirmations/<roleId>.md` 和 `understandings/<roleId>.md` 的 `createdAt`、`updatedAt` 必须存在且为 ISO 8601 时间；首次落盘可使用模板初始时间或替换为当前时间，但不得留空。
 - `xinyun-ai/team/**` 属于 AI 工作区控制文件，不授权修改业务代码、数据库、API、依赖、构建脚本或执行发布操作。
 
+## Codex 角色会话绑定
+
+- v1.7.3 起，在 Codex 宿主支持创建子会话时，主会话可以为五个默认角色自动创建真实角色子会话，并把真实 `sessionId` 回写到角色任务、`assignments.json`、`task-index.json`、`manifest.json`、`project-index.json` 和 `xinyun-ai/sessions/role-session-bindings.json`。
+- 固定角色为 `project-owner`、`project-product`、`chief-engineer`、`programmer`、`test-reviewer`，不得因为初始化或升级创建超过 5 个角色会话。
+- `sessionId` 必须来自 Codex 宿主返回值，不得使用任务 ID、随机占位字符串、本地文件名或历史会话记忆冒充。
+- 会话绑定最小字段为 `taskId`、`roleId`、`sessionId`、`parentSessionId`、`provider`、`sessionStatus`、`createdAt`、`updatedAt`。
+- 会话状态固定为 `pending/creating/created/onboarding/ready/blocked/failed/closed`。
+- 创建成功后先进入 `onboarding`，只允许只读理解职责范围和项目资料；职责理解、确认关系和执行门禁满足后才允许 `ready`。
+- Codex 宿主不支持创建子会话、权限不足或创建失败时，必须进入本地降级：保留 `sessionId=null`，记录 `sessionStatus=blocked/failed`、失败原因和下一步动作，不得伪造会话。
+
 ## 默认角色
 
 - `project-owner`：项目负责人，负责需求最终确认、业务验收和发布授权。

package/init/xinyun-ai-init/templates/team/assignments.json

@@ -10,6 +10,10 @@
       "assignmentId",
       "taskId",
       "roleId",
+      "sessionId",
+      "parentSessionId",
+      "provider",
+      "sessionStatus",
       "memberId",
       "workstream",
       "scope",
@@ -27,7 +31,8 @@
     ],
     "pausedRule": "status=paused requires pauseReason; other statuses require pauseReason=null.",
     "blockedRule": "status=blocked requires blockedReason=approver-unavailable or member-conflict.",
-    "executionEligibility": "member bound, role ready, responsibility confirmed, understanding ready, and executor memberId not equal to final approver member IDs."
+    "executionEligibility": "member bound, role ready, sessionStatus=ready, responsibility confirmed, understanding ready, and executor memberId not equal to final approver member IDs.",
+    "sessionBindingRule": "sessionId must be a real host-returned value when provider=codex; if the host cannot create sessions, sessionId remains null and sessionStatus=blocked or failed with a local degradation reason."
   },
   "updatedAt": ""
 }

package/init/xinyun-ai-init/version.json

@@ -1,8 +1,8 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.7.2",
-  "scriptVersion": "2026.07.20",
+  "version": "1.7.3",
+  "scriptVersion": "2026.07.22",
   "schemaVersion": "1",
   "defaultMode": "fast-init",
   "targetWorkspace": "xinyun-ai",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"