@pm_zhousl/xinyun-ai-init 1.8.0 → 1.9.0

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

@@ -2,7 +2,7 @@
 
 本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
-当前规则版本：`1.8.0`。
+当前规则版本：`1.9.0`。
 
 ## Codex 一句话入口
 
@@ -19,7 +19,7 @@ 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 fixed Codex role session creation compatibility fields: `provider=codex`, `sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`, and legacy creation index `{taskId,roleId,provider,targetVersion}`. v1.9.0 project-isolated reuse is authoritative.
 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` 即可。
@@ -1025,7 +1025,7 @@ v1.7.3 在 v1.7.2 已创建或恢复 5 个 `role-execution` 本地任务之后
 
 每个绑定至少记录：`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；重复升级或重复初始化必须优先复用已有真实会话和绑定，不得创建重复角色会话。
+`provider=codex`。`sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`。v1.9 会话复用键固定为 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}` 的 RFC8785-JCS-SHA-256；v1.7.3 的 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只能作为创建兼容索引，绝不参与候选选择或跨项目复用。重复升级或重复初始化必须优先复用已有真实会话和绑定，不得创建重复角色会话。
 
 真实 `sessionId` 必须来自 Codex 宿主创建会话后的返回值；不得伪造 sessionId，不得用任务 ID、角色 ID、占位符或历史摘要冒充真实会话。Codex 宿主不支持创建子会话、创建接口不可用或权限不足时，只能记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，并写入 `sessionStatus=blocked` 或 `failed`、`degradation.reason` 和 `nextAction`。
 
@@ -1099,7 +1099,7 @@ npx --yes @pm_zhousl/xinyun-ai-init@latest --force
 
 `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` 任务；重复升级复用已有任务并补齐索引，不覆盖用户控制文件或业务文件。
+每个角色任务的幂等键仍按 `{sourceTaskId, roleId, taskKind, targetVersion}` 使用 v1.6 JCS 规范化 JSON；这只裁决 role-execution 任务，不裁决跨项目会话复用。会话复用必须使用包含 `projectRootHash`、`workspaceScope`、`repositoryScopeHash`、`workstream` 的 v1.9 全身份键；重复升级复用已有任务并补齐索引，不覆盖用户控制文件或业务文件。
 
 补建使用逐角色临时文件、完整校验、原子重命名和任务索引原子更新。单角色写入失败记录 `status=blocked`、`blockedReason=write-failed`；部分成功为 `partial`，全失败为 `blocked`。索引更新中断时不得清空 `activeTaskIds` 或伪造 `idle`，下次按幂等键恢复。
 
@@ -1114,3 +1114,17 @@ Skill 位于 `xinyun-ai/skills/`。分配文件必须使用 `assignmentStatus`
 前端审计位于 `xinyun-ai/frontend-audits/`。`audit-only` 不产生代码 diff；`refactor-now` 必须有计划、用户确认、允许路径、前后哈希、diff 和测试证据。预算或权限不足只能记录 `partial/unknown` 和 `unverifiedScope`。
 
 临时程序员会话必须有已确认的 `planId`、`userConfirmationId`、单一 `taskId`、规范化 `changeDomain`、允许路径和真实 `sessionId`。最多同时占用 3 个运行额度；`occupancyStatus=unknown` 不得自动释放，人工释放必须有完整 `releaseAudit`。跨文件控制面必须使用 `coordinationTransactionId`。详情见 `rules/coordination.md`、`rules/skills.md`、`rules/frontend-audit.md` 和 `rules/temporary-sessions.md`。
+
+## v1.9 项目会话隔离、总工全景与数据库授权
+
+项目身份写入 `xinyun-ai/project-identity.json`。项目根优先使用 realpath，失败时使用 lexical-fallback 并记录 `identityEvidence`；路径统一 `/`、Unicode NFC，Windows 盘符大写且按不区分大小写规范化，Unix 保持大小写敏感。`projectRootHash` 和 `repositoryScopeHash` 不包含原始绝对路径，后者对稳定排序的 repository scope 使用 RFC 8785 JCS-SHA-256。
+
+会话候选必须同时匹配项目身份、仓库范围、workstream、角色、任务幂等键和权限范围。`sessionMatchStatus` 固定为 `reusable/renamed/duplicate-not-primary/other-project/unknown/not-reusable/requires-confirmation`，只有 `reusable` 或含完整改名 audit 的 `renamed` 才能绑定；其他项目不得展示完整路径、任务内容或 sessionId。候选排序和 `selectionEvidence` 必须可追溯，重复候选保留历史且不自动删除或合并。
+
+角色展示名使用 `项目简称｜角色中文名｜职责名称`，主会话使用 `项目简称｜主会话｜项目总调度`。改名只更新宿主展示名和本地摘要，历史 sessionId、旧标题、绑定 ID 和 audit 必须保留。
+
+总工维护 `xinyun-ai/technical-landscape.json`，主会话维护 `xinyun-ai/packets/requirement-packet.json`，总工返回 `xinyun-ai/packets/technical-impact-packet.json`。技术全景只有 `coverageStatus=full`、`unverifiedScope=[]` 且核心对象都有有效证据时才可 `ready`；`partial/unknown` 不得写成 ready。两个 packet 必须关联同一 requirementId、taskId、projectRootHash 和 version，使用 RFC 8785 JCS-SHA-256；关联内容变化时写入 `blockedReason=packet-stale` 并重新确认。
+
+数据库默认 `databaseAccessMode=sql-only`。未明确授权连接时只输出 SQL，不连接、不读取真实数据、不执行 SQL、不安装驱动。连接、只读查询、结构变更和数据修改权限独立记录；四类授权状态固定为 `not-requested/requested/authorized/denied/expired/failed/unknown`，脱敏状态固定为 `verified/unverified/failed`。执行前校验规范化 SQL、参数、方言、targetEnvironment、授权范围和 `statementHash`。授权过期或输入变化时回到 `executionStatus=needs-confirmation`，受影响授权进入 `expired` 并追加 audit。
+
+v1.9 不自动复用其他项目会话、不自动连接或修改数据库、不扩大 HTML 迁移范围，不执行 Git 写操作或 npm publish。

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

@@ -64,3 +64,15 @@
 - Skill 路由任务按需补齐 `xinyun-ai/skills/registry.json`、`assignments.json` 和 `usage-records/`；分配字段必须是 `assignmentStatus`。
 - 前端审计按需补齐 `xinyun-ai/frontend-audits/`；临时程序员任务按需补齐 `xinyun-ai/sessions/temporary/`。
 - 普通咨询、首次极速初始化和不涉及这些能力的任务不创建空目录。目录补齐只修改 AI 控制面，不修改业务代码。
+- 普通咨询、首次极速初始化和不涉及这些能力的任务不创建空目录。目录补齐只修改 AI 控制面，不修改业务代码。
+
+## v1.9 按需目录
+
+- `xinyun-ai/project-identity.json`
+- `xinyun-ai/sessions/session-candidates.json`
+- `xinyun-ai/technical-landscape.json`
+- `xinyun-ai/packets/requirement-packet.json`
+- `xinyun-ai/packets/technical-impact-packet.json`
+- `xinyun-ai/database/authorization.json`
+
+小改和普通咨询不强制创建技术全景或 packet。创建后同步 manifest、project-index、current-task 和任务引用；只登记当前项目身份，不复制其他项目会话。

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

@@ -71,7 +71,7 @@
 - 会话创建属于 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。
+- v1.7.3 的 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只保留为创建兼容索引；v1.9 会话复用必须使用 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}` 的 RFC8785-JCS-SHA-256，旧字段不得参与候选选择或跨项目复用。
 - 真实 `sessionId` 必须来自 Codex 宿主返回值；不得伪造 sessionId。宿主不支持时记录 `local-degraded-no-fake-session-id`，`sessionId=null`。
 - 创建成功后先进入只读 `onboarding`；`sessionStatus=ready` 必须等待职责理解、职责确认、成员 / 会话绑定和执行资格全部满足。
 
@@ -79,4 +79,13 @@
 
 需要多会话协作时，按 A-D 顺序补齐 `xinyun-ai/coordination/`、`xinyun-ai/skills/`、`xinyun-ai/frontend-audits/` 和 `xinyun-ai/sessions/temporary/` 的最小模板。普通咨询和首次极速初始化不强制创建这些业务记录目录。
 
+## v1.9 初始化项目身份与联合门禁
+
+按需创建 `xinyun-ai/project-identity.json`、`sessions/session-candidates.json`、`technical-landscape.json`、`packets/requirement-packet.json`、`packets/technical-impact-packet.json` 和 `database/authorization.json`。项目根优先 realpath，失败使用 lexical-fallback；使用 Unicode NFC、规范化路径和 RFC 8785 JCS-SHA-256，禁止保存原始绝对路径。
+
+会话候选状态固定为 `reusable/renamed/duplicate-not-primary/other-project/unknown/not-reusable/requires-confirmation`，只有 reusable 或有完整改名 audit 的 renamed 才能绑定。其他项目会话不得展示或复用，中文展示名使用项目简称、角色中文名和职责名称。
+
+技术全景只有 full coverage、空 unverifiedScope 和核心证据完整时才可 ready；partial/unknown 不得 ready。requirementPacket 与 technicalImpactPacket 必须同项目、task、版本和 hash；失效时进入 `packet-stale` 并阻断执行。数据库默认 `sql-only`，连接、查询、结构变更和数据修改分别授权，每条 SQL 必须校验 statementHash 和目标环境。
+- v1.9 fields: `sessionMatchStatus`、`selectionEvidence`、`项目简称｜角色中文名｜职责名称`、`coverageStatus=full`、`databaseAccessMode=sql-only`、`targetEnvironment`。
+
 共享事实和 Skill 文件使用临时文件、完整校验和原子重命名。前端审计默认只读；临时会话只有用户确认的代码任务才可创建。不得修改业务代码、数据库、API、依赖、Git 或发布配置。

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

@@ -269,7 +269,7 @@ HTML 迁移只允许评估和单页面 / 区块试点计划；实际代码迁移
 - `sessionBindingId`
 - `sessionBindingPath`：xinyun-ai/sessions/role-session-bindings.json
 - `roleSessionPath`：xinyun-ai/sessions/roles/<roleId>.md
-- `roleSessionIdempotency`：taskId + roleId + provider + targetVersion
+- `roleSessionIdempotency`：v1.9 使用 projectRootHash + workspaceScope + repositoryScopeHash + workstream + taskId + roleId + provider + targetVersion 的 RFC8785-JCS-SHA-256；v1.7.3 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只作创建兼容索引，不参与候选选择或跨项目复用
 - `hostCapability`：available / unavailable / permission-denied / unknown / failed
 - `degradationReason`：local-degraded-no-fake-session-id / none
 - `onboardingStatus`
@@ -284,3 +284,12 @@ HTML 迁移只允许评估和单页面 / 区块试点计划；实际代码迁移
 涉及前端审计时记录 `couplingType`、`decision`、审计 `status`、`coverage`、props/events/slots、状态/API/路由/业务流依赖、前后哈希、diff 和测试证据。涉及临时程序员会话时记录 `taskId`、`changeDomain`、`sessionId`、会话 `status`、`occupancyStatus`、并发额度、`releaseAudit` 和 `closeEvidence`。
 
 任何跨会话冲突、状态源缺失、预算超限、权限失败或敏感信息无法确认时暂停或阻塞，不自动重试、合并、覆盖或释放。
+
+## v1.9 会话与技术交接字段
+
+会话交接记录 `projectRootHash`、`workspaceScope`、`repositoryScopeHash`、`workstream`、`roleId`、`taskId`、`permissionScope`、`sessionMatchStatus`、`hostRecoveryAvailable`、`hostRecoveryEvidence` 和 `selectionEvidence`。只有 reusable 或完成改名 audit 的 renamed 可绑定当前项目。
+
+总工交接必须引用 technical-landscape、requirementPacket 和 technicalImpactPacket 的 ID、版本、sourceRevision 和 RFC8785 JCS-SHA-256 hash；任一 hash 失效时状态为 blocked、原因 packet-stale。技术全景 partial/unknown 不得写为 ready。
+
+数据库交接必须记录 `databaseAccessMode=sql-only`、四类授权、授权状态 `not-requested/requested/authorized/denied/expired/failed/unknown`、`statementHash`、targetEnvironment、`executionStatus`、`redactionStatus=verified/unverified/failed` 和完整 audit；授权变化后不得继续执行旧 SQL，执行状态回到 `needs-confirmation`。
+- v1.9 fields: `lexical-fallback`、`duplicate-not-primary`、`项目简称｜角色中文名｜职责名称`、`coverageStatus=full`、`RFC 8785 JCS-SHA-256`。

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

@@ -106,7 +106,7 @@
 
 - 升级到 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`。
+- v1.7.3 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只作为兼容创建索引；v1.9 会话绑定幂等键固定为 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}` 的 RFC8785-JCS-SHA-256。旧四字段不得参与候选选择或跨项目复用；重复升级仅在完整项目身份键匹配时复用已有绑定和真实 `sessionId`。
 - 如果会话已创建但回写失败，下一次升级必须先查询宿主已有会话并恢复绑定，记录 `created-but-writeback-failed` 和 audit，不得再次创建重复会话。
 - 单角色创建或回写失败不得影响其他角色；失败角色进入 `blocked` 或 `failed` 并记录 `blockedReason` / `failureReason` / `nextAction`。
 - Codex 宿主不支持创建子会话、权限不足或接口不可用时，使用本地降级 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，不得伪造 sessionId。
@@ -116,4 +116,11 @@
 
 升级先校验共享事实、状态源和 coordination transaction；再校验 Skill registry、`assignmentStatus`/`usageStatus` 映射；然后处理前端 audit-only 或已确认的单页面试点；最后才创建临时程序员会话。已有用户修改的控制文件不得静默覆盖，冲突或哈希不一致进入 `blocked`/`recovery-required`。
 
+## v1.9 升级兼容与失效处理
+
+升级前按当前项目身份的 realpath/lexical-fallback 结果计算 projectRootHash，按排序 repository scope 计算 repositoryScopeHash。只有八字段身份/任务键、权限和 RFC8785 JCS-SHA-256 复用键一致时复用会话；其他项目、重复非主会话和身份未知会话不得复用。保留 v1.7.3 sessionId、旧创建索引、v1.8 共享事实和双会话文件契约。
+
+技术全景、requirementPacket 或 technicalImpactPacket 的 contentHash、版本、项目身份或 sourceRevision 变化时，相关任务进入 blocked + blockedReason=packet-stale，不得静默使用旧结果。数据库默认仍为 sql-only，授权、目标环境、参数、方言或 statementHash 变化时追加 audit 并回到 needs-confirmation。
+- v1.9 fields: `sessionMatchStatus`、`duplicate-not-primary`、`selectionEvidence`、`项目简称｜角色中文名｜职责名称`、`technical-landscape`、`coverageStatus=full`、`RFC 8785 JCS-SHA-256`、`databaseAccessMode=sql-only`、`targetEnvironment`。
+
 同一 taskId + changeDomain 不得重复创建临时会话；容量不足进入 `queued`，unknown occupancy 保持占用，失败不得自动重试。升级不自动安装 Skill 依赖，不执行业务代码、数据库、API 或 Git 写操作。

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

@@ -191,7 +191,7 @@ CodeGraph 为必需能力时，只有 `initialized` 或 `healthy` 才能将结
 - 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`；重复升级复用已有真实会话和绑定。
+- v1.7.3 的 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只作创建兼容索引；v1.9 会话复用键必须包含 `projectRootHash`、`workspaceScope`、`repositoryScopeHash`、`workstream`、`taskId`、`roleId`、`provider`、`targetVersion`，使用 RFC8785-JCS-SHA-256。旧字段不得参与候选选择或跨项目复用。
 - 真实 `sessionId` 必须来自 Codex 宿主返回值；不得伪造 sessionId。宿主不支持时记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`。
 - 创建后的角色会话先进入只读 `onboarding`；只有职责理解、职责确认、成员 / 会话绑定、确认门禁和执行资格都满足后才允许 `sessionStatus=ready`。
 - 创建成功不等于业务代码修改授权；普通咨询不创建角色会话，不写绑定文件，不创建外部账号或第三个会话。
@@ -204,7 +204,17 @@ AI 接手本项目时，请先读取：
 - `xinyun-ai/rules/core-rules.md`
 - `xinyun-ai/index/project-index.json`
 
-未获用户确认前，不要修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+未获用户确认前，不要修改业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API 行为、UI 行为或业务流程。
+
+## v1.9 当前项目会话隔离与联合门禁
+
+- 项目身份使用 `xinyun-ai/project-identity.json`；优先 realpath，失败使用 lexical-fallback，记录 `identityEvidence`，路径使用 `/` 和 Unicode NFC，`projectRootHash` 不保存原始绝对路径。
+- 会话候选必须包含 `projectRootHash`、`workspaceScope`、`repositoryScopeHash`、`workstream`、`roleId`、`taskId`、`permissionScope`、`hostRecoveryAvailable`、`hostRecoveryEvidence` 和 `sessionMatchStatus`。状态固定为 `reusable/renamed/duplicate-not-primary/other-project/unknown/not-reusable/requires-confirmation`，仅 reusable 或带完整改名 audit 的 renamed 可绑定。
+- 其他项目会话不得展示完整路径、任务内容或 sessionId；重复会话保留历史，只选择一个主会话。中文标题使用 `项目简称｜角色中文名｜职责名称`。
+- 总工维护 `technical-landscape.json`，主会话维护 `requirement-packet.json`，总工输出 `technical-impact-packet.json`。技术全景只有 full coverage、空 unverifiedScope 和完整核心证据才可 ready；partial/unknown 不得 ready。
+- 两个 packet 必须同 requirementId、taskId、projectRootHash、version，并使用 RFC8785 JCS-SHA-256。关联内容变化后进入 `blockedReason=packet-stale`，程序员不得执行。
+- 数据库默认 `sql-only`；连接、查询、结构变更、数据修改分别授权，四类授权状态固定为 `not-requested/requested/authorized/denied/expired/failed/unknown`，`redactionStatus` 固定为 `verified/unverified/failed`。每条 SQL 执行前校验规范化 `statementHash`、targetEnvironment 和权限状态，过期或变化必须进入 `needs-confirmation` 并追加 audit。
+- v1.9 fields: `selectionEvidence`、`coverageStatus=full`、`RFC 8785 JCS-SHA-256`、`databaseAccessMode=sql-only`。
 ## v1.7 machine-readable enum anchors
 
 - decision=direct-map/rewrite-required/backend-required/unsupported/pending/unknown

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

@@ -429,7 +429,7 @@ v1.7.2 fixed task contract keys: `taskKind=initialization-main`, `taskKind=initi
 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 fixed Codex role session compatibility fields: `provider=codex`, `sessionStatus=pending/creating/created/onboarding/ready/blocked/failed/closed`, and legacy creation index `{taskId,roleId,provider,targetVersion}`. The v1.9 project-isolated role session reuse contract is authoritative.
 
 ## v1.7.3 Codex 角色会话自动创建与绑定
 
@@ -438,7 +438,7 @@ v1.7.3 fixed Codex role session contract keys: `provider=codex`, `sessionStatus=
 - 会话绑定固定登记到 `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；重复升级必须复用已有真实会话和绑定，不得重复创建同一角色会话。
+- v1.9 会话复用键固定为 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}` 的 RFC8785-JCS-SHA-256；只有完整项目身份键匹配时才允许重复升级复用已有真实会话和绑定。v1.7.3 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只作创建兼容索引，不得参与候选选择、复用或跨项目身份判定。
 - 真实 `sessionId` 必须来自 Codex 宿主创建会话后的返回值；不得伪造 sessionId，不得用任务 ID、角色 ID、占位符或历史摘要冒充真实会话。
 - Codex 宿主不支持创建子会话、创建接口不可用或权限不足时，只能记录 `local-degraded-no-fake-session-id`，保持 `sessionId=null`，并写入 `sessionStatus=blocked` 或 `failed`、`degradation.reason` 和 `nextAction`。
 - 创建成功后角色会话先进入 `onboarding` 且只读读取入口规则、角色任务、职责确认和角色理解资料；`sessionStatus=ready` 必须等待真实 sessionId 回写、职责理解完成、职责确认完成、成员 / 会话绑定有效、确认门禁和执行资格全部满足。
@@ -559,7 +559,7 @@ v1.7.3 fixed Codex role session contract keys: `provider=codex`, `sessionStatus=
 - `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；同键复用同一任务。
+- 角色任务幂等键固定为 `{sourceTaskId, roleId, taskKind, targetVersion}` 的 JCS-SHA-256；它只裁决 role-execution 任务，不参与跨项目会话候选复用。v1.9 会话复用键必须包含 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}`，使用 RFC8785-JCS-SHA-256；v1.7.3 `legacyCreationIndexFields={taskId, roleId, provider, targetVersion}` 只作创建兼容索引，绝不参与候选选择或跨项目复用。
 - 单角色写入失败为 `blocked/write-failed`，部分成功为 `partial`，全失败为 `blocked`；索引更新中断时保留活动任务并按幂等键恢复，不得伪造 `idle`。
 
 ## v1.8 多会话协作规则
@@ -576,6 +576,18 @@ Skill 分配使用 `assignmentStatus`，使用记录使用 `usageStatus`。固
 
 临时程序员会话最多并行 3 个，状态与 `occupancyStatus` 分离。`occupancyStatus=unknown` 时继续占用额度。同一 changeDomain 不重复写入；unknown 占用不得自动释放，人工释放必须记录 releaseAudit。异常、超时、写回失败和测试失败不得自动重试或伪造完成。
 
+## v1.9 项目会话隔离、总工全景与数据库授权
+
+项目身份落盘于 `xinyun-ai/project-identity.json`。根目录优先 realpath，失败使用 lexical-fallback 并记录失败原因；路径统一 `/`、Unicode NFC，Windows 盘符大写且不区分大小写，Unix 保持大小写敏感。projectRootHash 使用规范化根目录 SHA-256；repository scope 按 repoRootHash、workstream、kind 排序后使用 RFC 8785 JCS-SHA-256。
+
+会话候选至少有 `sessionId/provider/projectRootHash/workspaceScope/repositoryScopeHash/workstream/roleId/taskId/sessionStatus/permissionScope/updatedAt/identityEvidence/hostRecoveryAvailable/hostRecoveryEvidence/sessionMatchStatus`。sessionMatchStatus 固定为 `reusable/renamed/duplicate-not-primary/other-project/unknown/not-reusable/requires-confirmation`，只有 reusable 或含完整 renameAudit 的 renamed 才允许绑定。候选按有效绑定、reusable、身份完整、ready、updatedAt 倒序和 sessionId Unicode 升序选择，并写入 selectionEvidence。
+
+角色展示名固定为 `项目简称｜角色中文名｜职责名称`，主会话为 `项目简称｜主会话｜项目总调度`。改名只更新宿主展示名和 displayName，历史 sessionId、旧标题、绑定 ID 和 audit 必须保留。
+
+总工维护 `xinyun-ai/technical-landscape.json`。只有 coverageStatus=full、unverifiedScope=[]、核心对象均有有效证据且无未登记冲突时才可 ready；partial/unknown 只能保持 partial/blocked。主会话维护 requirementPacket，总工输出 technicalImpactPacket；两个 packet 最小字段固定为 schemaVersion、packetId、requirementId、taskId、projectRootHash、version、status、content、evidence、sourceRevision、contentHash、createdAt、updatedAt，使用 RFC8785 JCS-SHA-256。需求、影响范围、身份、版本或 sourceRevision 变化时写 blockedReason=packet-stale。
+
+数据库默认 databaseAccessMode=sql-only。连接、只读查询、结构变更、数据修改分别授权，四类授权状态固定为 not-requested/requested/authorized/denied/expired/failed/unknown，redactionStatus 固定为 verified/unverified/failed；SQL 执行前校验规范化 SQL、参数、方言、targetEnvironment、授权范围生成的 statementHash。授权或输入变化时回到 needs-confirmation，并追加包含 auditId、action、actorType、actorId、authorizationType、statementHash、targetEnvironment、resultStatus、redactionStatus、evidence、at 的 audit。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

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

@@ -289,3 +289,15 @@
 - 前端审计 decision / audit status / coverage：
 - 临时会话 status / occupancyStatus / changeDomain：
 - 未验证范围与阻塞原因：
+
+## v1.9 当前项目与技术联合状态摘要
+
+- projectIdentity：`xinyun-ai/project-identity.json`
+- projectRootHash / repositoryScopeHash：待填写
+- 当前会话候选与 selectionEvidence：待填写
+- 技术全景状态 / coverageStatus / unverifiedScope：待填写
+- requirementPacketId / technicalImpactPacketId / 两个 contentHash：待填写
+- packet 状态：captured / clarifying / proposed / confirmed / in-progress / blocked / completed / cancelled；技术影响：not-started / assessing / ready / partial / blocked
+- packet 失效原因：packet-stale / 待填写
+- databaseAccessMode：sql-only
+- 数据库连接、查询、结构变更、数据修改授权状态：待填写

package/init/xinyun-ai-init/templates/database-authorization.template.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "databaseAccessMode": "sql-only",
+  "connectionStatus": "not-requested",
+  "connectionStatusEnum": ["not-requested", "requested", "authorized", "denied", "expired", "failed", "unknown"],
+  "queryAuthorization": "not-requested",
+  "queryAuthorizationEnum": ["not-requested", "requested", "authorized", "denied", "expired", "failed", "unknown"],
+  "schemaChangeAuthorization": "not-requested",
+  "schemaChangeAuthorizationEnum": ["not-requested", "requested", "authorized", "denied", "expired", "failed", "unknown"],
+  "dataMutationAuthorization": "not-requested",
+  "dataMutationAuthorizationEnum": ["not-requested", "requested", "authorized", "denied", "expired", "failed", "unknown"],
+  "authorizationStatusEnum": ["not-requested", "requested", "authorized", "denied", "expired", "failed", "unknown"],
+  "authorizationTransitionRules": {
+    "not-requested": ["requested", "denied"],
+    "requested": ["authorized", "denied", "failed", "unknown"],
+    "authorized": ["expired", "denied", "failed", "unknown"],
+    "denied": ["requested"],
+    "expired": ["requested"],
+    "failed": ["requested", "unknown"],
+    "unknown": ["requested", "denied"]
+  },
+  "invalidatingChanges": ["authorization-expired", "target-environment-changed", "statement-hash-changed", "parameters-changed", "dialect-changed"],
+  "invalidatingAction": "set affected authorization to expired or needs-confirmation, append audit, and prohibit execution until reauthorized",
+  "authorizationScope": [],
+  "authorizedBy": null,
+  "authorizedAt": null,
+  "targetEnvironment": null,
+  "statementHash": null,
+  "statementHashAlgorithm": "RFC8785-JCS-SHA-256",
+  "statementHashCanonicalInput": ["databaseEngine", "dialectVersion", "statements", "parameters", "transactionPlan", "targetEnvironment", "authorizationScope"],
+  "executionStatus": "not-run",
+  "executionStatusEnum": ["not-run", "needs-confirmation", "authorized", "executed", "failed", "unknown"],
+  "redactionStatus": "unverified",
+  "redactionStatusEnum": ["verified", "unverified", "failed"],
+  "audit": [],
+  "auditRequiredFields": ["auditId", "action", "actorType", "actorId", "authorizationType", "statementHash", "targetEnvironment", "resultStatus", "redactionStatus", "evidence", "at"],
+  "createdAt": "2026-07-24T00:00:00.000Z",
+  "updatedAt": "2026-07-24T00:00:00.000Z"
+}

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

@@ -7,7 +7,7 @@
   "mode": "initialization",
   "status": "pending",
   "currentVersion": null,
-  "targetVersion": "1.8.0",
+  "targetVersion": "1.9.0",
   "idempotencyKey": null,
   "createdFiles": [],
   "updatedFiles": [],
@@ -44,6 +44,15 @@
     "hostCapability": "unknown",
     "degradationReason": null
   },
+  "v19": {
+    "projectIdentityPath": "xinyun-ai/project-identity.json",
+    "technicalLandscapePath": "xinyun-ai/technical-landscape.json",
+    "requirementPacketPath": "xinyun-ai/packets/requirement-packet.json",
+    "technicalImpactPacketPath": "xinyun-ai/packets/technical-impact-packet.json",
+    "databaseAuthorizationPath": "xinyun-ai/database/authorization.json",
+    "packetHashAlgorithm": "RFC8785-JCS-SHA-256",
+    "databaseAccessMode": "sql-only"
+  },
   "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.8.0",
+  "lastAppliedVersion": "1.9.0",
   "files": [
     {
       "path": "xinyun-ai/rules/core-rules.md",
       "baselineHash": null,
       "templateHash": null,
-      "lastAppliedVersion": "1.8.0",
+      "lastAppliedVersion": "1.9.0",
       "managedBy": "@pm_zhousl/xinyun-ai-init",
       "status": "unknown"
     }

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.8.0",
+  "xinyunAiVersion": "1.9.0",
   "scriptVersion": "2026.07.23",
   "schemaVersion": "1",
   "initializationMode": "fast",
@@ -51,6 +51,10 @@
     "skillRouting": true,
     "frontendCouplingAudit": true,
     "temporaryProgrammerSessions": true
+    ,"projectSessionIsolation": true
+    ,"roleDisplayNaming": true
+    ,"technicalLandscapeCoordination": true
+    ,"databaseSqlOnlyAuthorization": true
   },
   "tasking": {
     "currentTask": "xinyun-ai/current-task.md",
@@ -80,7 +84,7 @@
     "bindings": "xinyun-ai/sessions/role-session-bindings.json",
     "bindingTemplate": "xinyun-ai-init/templates/role-session-binding.template.json",
     "parentSessionId": null,
-    "targetVersion": "1.8.0",
+    "targetVersion": "1.9.0",
     "requiredRoleCount": 5,
     "statusEnum": [
       "pending",
@@ -94,13 +98,19 @@
     ],
     "idempotency": {
       "keyFields": [
+        "projectRootHash",
+        "workspaceScope",
+        "repositoryScopeHash",
+        "workstream",
         "taskId",
         "roleId",
         "provider",
         "targetVersion"
       ],
-      "algorithm": "JCS-SHA-256",
-      "duplicatePolicy": "reuse"
+      "algorithm": "RFC8785-JCS-SHA-256",
+      "duplicatePolicy": "reuse-one-primary-preserve-history",
+      "legacyCreationIndexFields": ["taskId", "roleId", "provider", "targetVersion"],
+      "legacyCreationIndexPolicy": "compatibility lookup only; never used for candidate selection or cross-project reuse"
     },
     "hostUnsupportedPolicy": "local-degraded-no-fake-session-id",
     "readyPolicy": "created session enters onboarding first; ready requires role understanding, responsibility confirmation, and execution eligibility gates."
@@ -203,5 +213,15 @@
     "pilotPlan": "xinyun-ai/migrations/html-to-client/pilot-plan.md",
     "openIssues": "xinyun-ai/migrations/html-to-client/open-issues.md",
     "recordJson": "xinyun-ai/migrations/html-to-client/migration-record.json"
+  },
+  "v19": {
+    "projectIdentity": "xinyun-ai/project-identity.json",
+    "sessionCandidates": "xinyun-ai/sessions/session-candidates.json",
+    "technicalLandscape": "xinyun-ai/technical-landscape.json",
+    "requirementPacket": "xinyun-ai/packets/requirement-packet.json",
+    "technicalImpactPacket": "xinyun-ai/packets/technical-impact-packet.json",
+    "databaseAuthorization": "xinyun-ai/database/authorization.json",
+    "packetHashAlgorithm": "RFC8785-JCS-SHA-256",
+    "databaseAccessModeDefault": "sql-only"
   }
 }

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

@@ -131,7 +131,7 @@
 - `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：待填写
+- `roleSessionIdempotency` 是否为 v1.9 八字段 projectRootHash、workspaceScope、repositoryScopeHash、workstream、taskId、roleId、provider、targetVersion 的 RFC8785-JCS-SHA-256：待填写；旧四字段仅作创建兼容索引，不得参与候选选择或复用
 - 真实 `sessionId` 是否来自宿主返回值：待填写
 - 是否不存在伪造 sessionId：待填写
 - 创建后是否先进入只读 onboarding，未直接 ready：待填写
@@ -154,3 +154,16 @@
 - 前端 audit-only 是否零 diff，refactor-now 是否有确认、哈希、diff 和测试证据。
 - 临时会话是否遵守单变更域、并发上限 3、unknown occupancy 和 releaseAudit。
 - 是否未执行自动安装依赖、业务代码修改、数据库/API改动或 Git 写操作。
+
+## v1.9 检查
+
+- 项目身份是否使用 realpath / lexical-fallback、Unicode NFC、projectRootHash 和 repositoryScopeHash：待填写
+- 会话候选是否使用固定 sessionMatchStatus，且只有 reusable / renamed 可绑定：待填写
+- 是否记录 hostRecoveryAvailable、hostRecoveryEvidence、selectionEvidence 和改名 audit：待填写
+- 中文职责化名称是否稳定且未暴露内部资格检查文案：待填写
+- technical-landscape 是否满足 full coverage、unverifiedScope 为空和核心证据完整才 ready：待填写
+- requirementPacket / technicalImpactPacket 是否同 requirementId、taskId、projectRootHash、version 和 JCS-SHA-256 hash：待填写
+- packet 变化是否进入 `blockedReason=packet-stale`：待填写
+- 数据库默认是否为 `sql-only`：待填写
+- connectionStatus、queryAuthorization、schemaChangeAuthorization、dataMutationAuthorization 是否独立：待填写
+- statementHash、targetEnvironment、executionStatus 和 audit 是否完整：待填写

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

@@ -215,7 +215,7 @@
 - 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)
+- roleSessionIdempotency：RFC8785-JCS-SHA-256(projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion)；v1.7.3 四字段仅作创建兼容索引，不参与候选选择、复用或跨项目身份判定
 - parentSessionId：待填写
 - real sessionId：待填写；不得伪造 sessionId
 - onboarding：created 后先只读 onboarding，不能直接 ready
@@ -235,3 +235,13 @@
 - Skill 路由：`xinyun-ai/skills/`；正式字段为 `assignmentStatus` 与 `usageStatus`。
 - 前端耦合审计：`xinyun-ai/frontend-audits/`；audit-only 零 diff。
 - 临时程序员会话：最多 3 个并行运行额度；unknown occupancy 不自动释放。
+
+## v1.9 项目身份、会话复用与技术联合门禁
+
+- 项目身份文件：`xinyun-ai/project-identity.json`。
+- 项目根解析：realpath / lexical-fallback；projectRootHash：SHA-256；repositoryScopeHash：RFC8785 JCS-SHA-256。
+- 会话候选：`reusable/renamed/duplicate-not-primary/other-project/unknown/not-reusable/requires-confirmation`；只有 reusable 或完整改名审计的 renamed 可绑定。
+- 会话展示名：`项目简称｜角色中文名｜职责名称`；主会话：`项目简称｜主会话｜项目总调度`。
+- 技术全景：`xinyun-ai/technical-landscape.json`；只有 full coverage、空 unverifiedScope 和核心证据完整才可 ready。
+- packet：`requirement-packet.json` + `technical-impact-packet.json`；使用 RFC8785 JCS-SHA-256，失效时为 `packet-stale`。
+- 数据库默认 `sql-only`；连接、查询、结构变更和数据修改权限独立，执行前校验 statementHash、目标环境和 audit。

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

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "projectRootHash": null,
+  "workspaceScope": {
+    "scopeType": "project-root",
+    "scopePathHashes": [],
+    "scopeRevision": null
+  },
+  "repositoryScopeHash": null,
+  "workstream": null,
+  "identityEvidence": [],
+  "normalization": {
+    "resolutionMode": "unknown",
+    "pathSeparators": "/",
+    "unicodeNormalization": "NFC",
+    "windowsDriveCase": "upper",
+    "windowsCaseSensitivity": "insensitive",
+    "unixCaseSensitivity": "sensitive",
+    "excludedFields": ["mtime", "inode", "temporaryPath"]
+  },
+  "createdAt": "2026-07-24T00:00:00.000Z",
+  "updatedAt": "2026-07-24T00:00:00.000Z"
+}

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

@@ -1,5 +1,13 @@
 {
   "projectSummary": "",
+  "projectIdentity": {
+    "path": "xinyun-ai/project-identity.json",
+    "projectRootHash": null,
+    "workspaceScope": {"scopeType": "project-root", "scopePathHashes": [], "scopeRevision": null},
+    "repositoryScopeHash": null,
+    "identityEvidence": [],
+    "resolutionMode": "unknown"
+  },
   "understanding": {
     "overall": "quick",
     "workstreams": {},
@@ -150,6 +158,22 @@
       "failed",
       "closed"
     ],
+    "idempotency": {
+      "keyFields": [
+        "projectRootHash",
+        "workspaceScope",
+        "repositoryScopeHash",
+        "workstream",
+        "taskId",
+        "roleId",
+        "provider",
+        "targetVersion"
+      ],
+      "algorithm": "RFC8785-JCS-SHA-256",
+      "duplicatePolicy": "reuse-one-primary-preserve-history",
+      "legacyCreationIndexFields": ["taskId", "roleId", "provider", "targetVersion"],
+      "legacyCreationIndexPolicy": "compatibility lookup only; never used for candidate selection or cross-project reuse"
+    },
     "records": []
   },
   "coordination": {
@@ -224,6 +248,16 @@
     "indexFile": "xinyun-ai/global-review/index.json",
     "createOnFastInit": false
   },
+  "v19": {
+    "projectIdentity": "xinyun-ai/project-identity.json",
+    "sessionCandidates": "xinyun-ai/sessions/session-candidates.json",
+    "technicalLandscape": "xinyun-ai/technical-landscape.json",
+    "requirementPacket": "xinyun-ai/packets/requirement-packet.json",
+    "technicalImpactPacket": "xinyun-ai/packets/technical-impact-packet.json",
+    "databaseAuthorization": "xinyun-ai/database/authorization.json",
+    "packetHashAlgorithm": "RFC8785-JCS-SHA-256",
+    "databaseAccessModeDefault": "sql-only"
+  },
   "requirementParsing": {
     "enabled": true,
     "trigger": "ambiguous_or_change_or_high_risk",

package/init/xinyun-ai-init/templates/requirement-packet.template.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "packetId": "requirement-packet-template",
+  "requirementId": null,
+  "taskId": null,
+  "projectRootHash": null,
+  "version": "1.9.0",
+  "status": "captured",
+  "content": {
+    "userQuote": null,
+    "goal": null,
+    "acceptanceCriteria": [],
+    "priority": null,
+    "allowedScope": [],
+    "forbiddenScope": [],
+    "pendingQuestions": []
+  },
+  "evidence": [],
+  "sourceRevision": null,
+  "contentHash": null,
+  "createdAt": "2026-07-24T00:00:00.000Z",
+  "updatedAt": "2026-07-24T00:00:00.000Z"
+}

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

@@ -49,5 +49,5 @@
 
 - `idempotencyKey` 是对 `{sourceTaskId, roleId, taskKind, targetVersion}` 使用 v1.6 JCS 规范化 JSON 后计算的 SHA-256。
 - 同一幂等键只允许对应一个角色后续任务；重复升级必须复用任务并补齐索引。
-- `sessionIdempotencyKey` 是对 `{taskId, roleId, provider, targetVersion}` 使用 JCS 规范化 JSON 后计算的 SHA-256。
+- `sessionIdempotencyKey` 必须按 v1.9 `{projectRootHash, workspaceScope, repositoryScopeHash, workstream, taskId, roleId, provider, targetVersion}` 使用 RFC8785-JCS-SHA-256 计算；v1.7.3 四字段仅作创建兼容索引，不得参与候选选择、复用或跨项目身份判定。
 - 同一 `sessionIdempotencyKey` 只允许绑定一个有效真实角色会话；会话已创建但本地回写失败时，下次升级必须按该键查询并补齐绑定，不得创建第二个会话。

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

@@ -6,7 +6,16 @@
   "sessionId": null,
   "parentSessionId": null,
   "provider": "codex",
-  "targetVersion": "1.8.0",
+  "targetVersion": "1.9.0",
+  "projectRootHash": null,
+  "workspaceScope": {"scopeType": "project-root", "scopePathHashes": [], "scopeRevision": null},
+  "repositoryScopeHash": null,
+  "workstream": null,
+  "permissionScope": [],
+  "sessionMatchStatus": "unknown",
+  "hostRecoveryAvailable": false,
+  "hostRecoveryEvidence": [],
+  "selectionEvidence": null,
   "sessionStatus": "pending",
   "understandingStatus": "pending",
   "confirmationStatus": "pending",
@@ -39,5 +48,12 @@
     "reason": null,
     "fakeSessionIdProhibited": true
   },
-  "audit": []
+  "audit": [],
+  "renameAudit": null,
+  "displayName": null,
+  "projectDisplayName": null,
+  "roleDisplayName": null,
+  "responsibilityLabel": null,
+  "titleSource": "role-contract",
+  "titleVersion": "1.9.0"
 }

package/init/xinyun-ai-init/templates/session-candidates.template.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "candidates": [],
+  "sessionMatchStatusEnum": ["reusable", "renamed", "duplicate-not-primary", "other-project", "unknown", "not-reusable", "requires-confirmation"],
+  "reusableSessionStatusEnum": ["created", "onboarding", "ready"],
+  "selectionEvidence": {
+    "selectedSessionId": null,
+    "candidateSessionIds": [],
+    "ruleOrder": ["valid-binding", "reusable", "identity-complete", "ready", "updatedAt-desc", "sessionId-unicode-asc"],
+    "reason": null,
+    "checkedAt": null
+  },
+  "candidateRequiredFields": ["sessionId", "provider", "projectRootHash", "workspaceScope", "repositoryScopeHash", "workstream", "roleId", "taskId", "sessionStatus", "permissionScope", "updatedAt", "identityEvidence", "hostRecoveryAvailable", "hostRecoveryEvidence", "sessionMatchStatus"],
+  "reuseIdempotency": {
+    "keyFields": ["projectRootHash", "workspaceScope", "repositoryScopeHash", "workstream", "taskId", "roleId", "provider", "targetVersion"],
+    "algorithm": "RFC8785-JCS-SHA-256",
+    "duplicatePolicy": "reuse-one-primary-preserve-history"
+  }
+}