@pm_zhousl/xinyun-ai-init 1.13.1 → 1.14.0

package/README.md

@@ -55,6 +55,7 @@ npm run publish:token
 ```
 
 脚本会提示输入 npm token，临时写入 `.npmrc`，发布完成或失败后自动删除 `.npmrc`。
+发布脚本会先执行 `npm run verify:release`；当前 v1.14 支持明确的 `local-degraded` 证据模式，允许发布规则包但不会把项目标记为 `ready`。
 
 如果需要让 AI 代执行，可先在当前终端设置临时环境变量：
 
@@ -67,5 +68,6 @@ $env:NPM_TOKEN=$null
 发布前预演：
 
 ```powershell
+npm run verify:release
 npm run publish:token:dry
 ```

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

@@ -2,7 +2,7 @@
 
 本目录是“欣芸技术开发 Agent 流”的初始化包，负责把完整 AI 执行要求下发到目标项目。
 
-当前规则版本：`1.13.1`。
+当前规则版本：`1.14.0`。
 
 ## Codex 一句话入口
 
@@ -22,6 +22,8 @@ v1.7.2 fixed task contract keys: `taskKind=initialization-main`, `taskKind=initi
 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.10.x takeover gates are authoritative for project readiness.
 v1.7.3 Codex role session orchestration is host-level only; CLI still only creates `xinyun-ai-init/`.
 
+v1.14.0 adds the agent profile/capability declaration, aggregate takeover gate, orchestrator task graph, shared-fact handoffs, safe session naming/reuse, and final delivery gate. These controls are additive to v1.13.1; `providerSessionId` remains the only canonical provider identity in provider mode. When the host API is unavailable, `sessionIdentityMode=local-degraded` may use a control-plane `localSessionId` for local correlation only; it never makes the project `ready` or `executionEligible`.
+
 执行上面的命令后，会生成 `xinyun-ai-init/`。随后让 AI 读取 `xinyun-ai-init/README.md` 即可。
 
 ## AI 执行入口
@@ -56,6 +58,9 @@ AI 读取本文件后，必须按以下方式执行：
 26. 完成后用中文输出初始化或升级结果、项目导读、团队责任状态、任务状态、CodeGraph 状态、待确认问题和后续短指令。
 27. v1.10.2 必须区分宿主线程、宿主会话、项目会话和主调度会话；真实 sessionId 只能来自宿主返回值，无法验证时保持 blocked。
 28. v1.11.0 使用固定模板物化、阶段状态、项目快照、24 小时缓存和最多 3 个角色并发；缓存命中不能跳过必要会话、授权或最终门禁。
+29. v1.14.0 必须创建或补齐智能体档案、能力矩阵、接管门禁、主会话总控、任务图、交接记录和最终交付记录；任务状态使用 v1.13 机器状态并同步中文展示状态。
+30. v1.14.0 任务开始前读取公共快照、任务索引、近期变更、交接、契约和占用；任务结束后写回实际改动、跨任务影响、未完成事项和证据。
+31. v1.14.0 只有所有接管门禁、真实 provider 会话证据、共享事实一致性、冲突检查、敏感扫描、测试和审查通过后才允许 `ready`；没有宿主 API 时可使用 `local-degraded` 与 `localSessionId` 继续控制面工作，但状态必须保持 `partial`、`blocked` 或 `manual-required`。
 
 ## 初始化授权边界
 

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

@@ -77,6 +77,16 @@ Run the seven-capability host preflight before role sessions. Materialize the ma
 - `businessCodeChanged.value=no` requires structured evidence; without evidence it must be `unknown`. Missing real behavior evidence cannot produce `ready`.
 - v1.11 stages are `preflight`, `fixed-materialization`, `control-plane`, `codegraph`, `bootstrap-snapshot`, `role-sessions`, `onboarding`, and `final-gate`. Fixed templates, a bounded project snapshot, a 24-hour cache, and at most three role sessions may reduce repeated work but cannot bypass the final gate.
 
+## v1.14.0 agent core
+
+- Create `agent-profile.json`, `agent-capabilities.json`, `takeover-gate.json`, `tasks/orchestrator.json`, `tasks/task-graph.json`, `handoffs/` and `final-delivery.json` as control-plane records.
+- Agent capability status is `ready/partial/blocked/manual-required`; missing provider evidence or unresolved required gates cannot be `ready`.
+- The orchestrator owns requirement understanding, task decomposition, assignment, dependencies, result aggregation, conflict routing, test review and final delivery. Task creation is not task completion.
+- Task records retain v1.13 machine statuses and add `statusCode`/`statusLabel`; the display labels are `待分析/待分配/执行中/待审查/待确认/已完成/阻塞/已取消`.
+- Before execution, read the shared snapshot, active task index, recent changes, handoffs, contract snapshots and occupancy. After execution, write actual files, API/field/component/process impacts, unfinished work and evidence.
+- Same-file, API, field, component or business-flow conflicts pause the affected task and require orchestrator/chief-engineer resolution.
+- Final delivery must list completed, unfinished, blocked, changed files, business-code change status, tests, review, risks and next actions. Only all gates and evidence may produce `ready`.
+
 ## v1.7.2 角色后续任务可见性
 
 - 初始化主任务使用 `taskKind=initialization-main`；角色登记使用 `taskKind=initialization-record`；后续执行任务使用 `taskKind=role-execution`。

package/init/xinyun-ai-init/rules/v1.14.0-agent-core.md

@@ -0,0 +1,31 @@
+# v1.14.0 agent core
+
+## Agent identity and capability declaration
+
+Every initialized control plane records one `agent-profile.json` and one `agent-capabilities.json`. The profile identifies the agent, package version, project identity, service goal, configured roles, supported stacks/tools, allowed operations, forbidden operations, and ready prerequisites. Capability records must include detection method, status, dependency status, evidence, fallback plan, and unverified scope.
+
+When the host does not expose a canonical provider API, the control plane may use `sessionIdentityMode=local-degraded` and a control-plane-generated `localSessionId` for local correlation. `localSessionId` is never a provider identity, never makes `sessionId` non-null, and never grants `ready` or `executionEligible`. Real provider mode continues to require `providerSessionId` and the v1.13 host evidence contract.
+
+Agent capability status is `ready`, `partial`, `blocked`, or `manual-required`. Missing canonical provider evidence, unknown required host capability, or an unresolved high-risk conflict cannot be `ready`.
+
+## Takeover gate
+
+`takeover-gate.json` is the aggregate decision for project control-plane readiness. It must verify the control plane, named main task, five role tasks, team responsibility records, CodeGraph status, provider session bindings, orchestrator registration, recovery records, indexes, shared facts, conflict checks, and sensitive scanning. Missing evidence produces `partial`, `blocked`, or `manual-required`; it never produces `ready`. Local-degraded operation may publish the package and continue read-only control-plane work, but the project remains non-ready until real provider evidence is bound.
+
+## Orchestrator and task graph
+
+The main session owns requirement understanding, task decomposition, role assignment, dependency management, result aggregation, conflict routing, test review, and final delivery. `orchestrator.json` stores its identity and evidence. `task-graph.json` stores nodes and dependency edges.
+
+Task records keep the v1.13 machine status and add `statusCode`/`statusLabel` for the unified workflow: `待分析`, `待分配`, `执行中`, `待审查`, `待确认`, `已完成`, `阻塞`, `已取消`. A task is complete only after its result, evidence, reviewer, and required write-backs pass validation.
+
+## Shared facts and handoff
+
+Before execution, read the public project snapshot, active task index, recent change ledger, other handoffs, API/database/component records, and file/workflow occupancy. After execution, write back actual files and impacts, unfinished work, confirmations, evidence, and the next action. Same-file, API, field, component, or business-flow conflicts pause the task and require orchestrator/chief-engineer resolution.
+
+## Session naming and reuse
+
+Display names follow `项目名｜角色｜职责或工作流`. Discovery and reuse require matching project identity, role, task scope, title, cwd, occupancy, idempotency key, and canonical `providerSessionId` evidence. Cross-project candidates are rejected and historical records are preserved. Host thread IDs, task IDs, filenames, titles, and history summaries remain evidence only and can never become a session ID.
+
+## Final delivery gate
+
+The final delivery record must list completed and unfinished work, blocked tasks, actual changed files, business-code change status, tests, review results, risks, next actions, and all gate/evidence references. `ready` requires every required gate, provider evidence, shared-fact consistency, conflict check, sensitive scan, and reviewer result to pass.

package/init/xinyun-ai-init/templates/agent-capabilities.template.json

@@ -0,0 +1,27 @@
+{
+  "schemaVersion": 1,
+  "agentId": "xinyun-ai-agent",
+  "capabilities": [
+    {
+      "capabilityId": "capability-template",
+      "name": "能力模板",
+      "category": "control-plane",
+      "required": true,
+      "detectionMethod": "not-checked",
+      "status": "unknown",
+      "statusEnum": ["ready", "partial", "blocked", "manual-required", "unknown"],
+      "dependencyStatus": "unknown",
+      "evidence": [],
+      "fallbackPlan": "blocked; preserve task IDs and emit next action",
+      "usedTools": [],
+      "unusedTools": [],
+      "unverifiedScope": [],
+      "failureReason": null,
+      "checkedAt": null
+    }
+  ],
+  "aggregateStatus": "manual-required",
+  "aggregateStatusEnum": ["ready", "partial", "blocked", "manual-required"],
+  "aggregateRule": "required capabilities and evidence must pass before ready; local-degraded may run with localSessionId but remains manual-required",
+  "updatedAt": null
+}

package/init/xinyun-ai-init/templates/agent-profile.template.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "agentId": "xinyun-ai-agent",
+  "name": "欣芸技术开发 Agent",
+  "version": "1.14.0",
+  "packageVersion": "1.14.0",
+  "projectIdentity": {
+    "projectRootHash": null,
+    "workspaceScope": "xinyun-ai-control",
+    "repositoryScopeHash": null,
+    "workstream": "project-control-plane"
+  },
+  "serviceGoal": "按用户确认的范围协作完成软件开发任务并提供可审计交付结论",
+  "configuredRoles": ["project-owner", "project-product", "chief-engineer", "programmer", "test-reviewer"],
+  "supportedStacks": [],
+  "supportedTools": [],
+  "allowedOperations": ["read-project-files", "write-control-plane", "run-approved-verification"],
+  "forbiddenOperations": ["fake-session-id", "database-connection", "sql-execution", "business-code-without-confirmation", "git-write", "dependency-install", "host-login", "npm-publish"],
+  "readyPrerequisites": ["control-plane", "task-tree", "team-responsibility", "codegraph", "provider-session-evidence", "orchestrator", "recovery-and-index-consistency", "sensitive-scan", "conflict-free"],
+  "capabilityStatus": "manual-required",
+  "capabilityStatusEnum": ["ready", "partial", "blocked", "manual-required"],
+  "evidence": [],
+  "unverifiedScope": ["real provider canonical session behavior"],
+  "createdAt": null,
+  "updatedAt": null
+}

package/init/xinyun-ai-init/templates/control-plane-index.template.json

@@ -6,6 +6,13 @@
   "sessionIndex": "xinyun-ai/sessions/role-session-bindings.json",
   "roleIndex": "xinyun-ai/team/assignments.json",
   "factIndex": "xinyun-ai/coordination/project-facts.json",
+  "agentProfile": "xinyun-ai/agent-profile.json",
+  "agentCapabilities": "xinyun-ai/agent-capabilities.json",
+  "takeoverGate": "xinyun-ai/takeover-gate.json",
+  "orchestrator": "xinyun-ai/tasks/orchestrator.json",
+  "taskGraph": "xinyun-ai/tasks/task-graph.json",
+  "handoffsDirectory": "xinyun-ai/handoffs/",
+  "finalDelivery": "xinyun-ai/final-delivery.json",
   "evidenceIndex": "xinyun-ai/index/evidence-index.json",
   "eventLog": "xinyun-ai/events/events.jsonl",
   "lockFile": "xinyun-ai/task-lock.json",

package/init/xinyun-ai-init/templates/coordination-change-ledger.template.json

@@ -1,6 +1,8 @@
 {
   "schemaVersion": 1,
   "changes": [],
+  "occupancy": [],
+  "conflictKeys": ["path", "api", "database-field", "component", "business-flow"],
   "recordContract": {
     "requiredFields": ["schemaVersion", "changeId", "taskId", "sessionId", "actor", "role", "changeDomain", "targetPaths", "baselineHash", "changeStatus", "evidence", "createdAt", "updatedAt"],
     "changeStatusEnum": ["proposed", "reserved", "in-progress", "completed", "conflict-pending", "blocked", "cancelled"],

package/init/xinyun-ai-init/templates/coordination-project-facts.template.json

@@ -1,6 +1,15 @@
 {
   "schemaVersion": 1,
   "facts": [],
+  "publicSnapshot": {
+    "snapshotId": null,
+    "snapshotHash": null,
+    "sourceRevision": null,
+    "refreshedAt": null,
+    "refreshTriggers": ["business-change", "control-plane-change", "codegraph-change", "source-revision-change"]
+  },
+  "executionReadContract": ["publicSnapshot", "taskIndex", "recentChanges", "handoffs", "contractSnapshots", "occupancy"],
+  "executionWriteContract": ["changedFiles", "apiChanges", "databaseFieldChanges", "componentChanges", "businessFlowChanges", "unfinishedWork", "pendingConfirmations", "evidence"],
   "recordContract": {
     "requiredFields": ["schemaVersion", "factId", "factType", "scope", "valueHash", "source", "taskId", "sessionId", "evidence", "confidence", "factStatus", "revision", "observedAt", "updatedAt"],
     "factStatusEnum": ["proposed", "confirmed", "superseded", "unknown", "blocked"]

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

@@ -618,6 +618,17 @@ Skill 分配使用 `assignmentStatus`，使用记录使用 `usageStatus`。固
 
 数据库正式 databaseAccessMode=local-files-read-only，legacyDatabaseAccessMode=sql-only 仅为兼容标识，sqlExecutionMode=generate-only。普通初始化不读取数据库文件；数据库相关任务仅可读取项目内受限的 SQL/schema/migration/model 文本文件。严禁连接本地或线上数据库、查询真实数据、执行 SQL、migration、seed 或数据修改。连接、只读查询、结构变更、数据修改分别授权，四类授权状态固定为 not-requested/requested/authorized/denied/expired/failed/unknown，redactionStatus 固定为 verified/unverified/failed；SQL 仅用于 review 计划，需校验规范化 SQL、参数、方言、targetEnvironment、授权范围生成的 statementHash。授权或输入变化时回到 needs-confirmation，并追加包含 auditId、action、actorType、actorId、authorizationType、statementHash、targetEnvironment、resultStatus、redactionStatus、evidence、at 的 audit。
 
+## v1.14.0 智能体核心能力
+
+- 必须登记 `agent-profile.json` 和 `agent-capabilities.json`。智能体状态固定为 `ready/partial/blocked/manual-required`；宿主 canonical provider 证据缺失时不得 ready。宿主 API 不可用时允许显式 `sessionIdentityMode=local-degraded`，使用控制面生成的 `localSessionId` 做本地关联，但不得把它写入 `providerSessionId` 或把项目标记为 ready。
+- 必须登记 `takeover-gate.json`、`tasks/orchestrator.json`、`tasks/task-graph.json`、`handoffs/` 和 `final-delivery.json`，并在 manifest、project-index、init-result 和 control-plane-index 中引用。
+- 主会话负责需求理解、任务拆分、角色分配、依赖管理、结果汇总、冲突处理、测试审查和最终交付；任务创建不等于任务完成。
+- 任务保留既有机器状态，并同步 `statusCode/statusLabel`：`待分析/待分配/执行中/待审查/待确认/已完成/阻塞/已取消`。
+- 任务开始前必须读取公共快照、活动任务索引、近期变更、其他交接、契约快照和文件/工作流占用；完成后必须写回实际文件、API/字段/组件/流程影响、未完成事项、待确认项和证据。
+- 同文件、接口、字段、组件或业务流程冲突时，相关任务进入 `conflict-pending` 或 `blocked`，由主会话/总工处理，不得静默覆盖。
+- 会话展示名使用 `项目名｜角色｜职责或工作流`；provider 模式的发现和复用必须验证项目身份、职责、任务范围、cwd、占用、幂等键和 canonical `providerSessionId`。local-degraded 模式只能使用 `localSessionId` 做控制面关联，不能进行真实宿主复用，历史不得覆盖或删除。
+- 最终交付必须列出已完成、未完成、阻塞任务、实际修改文件、业务代码变更、测试、审查、风险和下一步；所有接管门禁、会话证据、共享事实、冲突检查和敏感扫描通过后才可 ready。
+
 ## 自我学习
 
 发现可复用经验时，先记录为候选经验。候选经验必须标注来源、适用范围、可信度、状态和最后验证时间。用户确认后，才能合并进正式规则。

package/init/xinyun-ai-init/templates/final-delivery.template.json

@@ -0,0 +1,22 @@
+{
+  "schemaVersion": 1,
+  "deliveryId": "delivery-template",
+  "taskId": null,
+  "orchestratorSessionId": null,
+  "status": "blocked",
+  "statusEnum": ["pending", "partial", "blocked", "ready"],
+  "completedItems": [],
+  "unfinishedItems": [],
+  "blockedTasks": [],
+  "changedFiles": [],
+  "businessCodeChanged": "unknown",
+  "tests": [],
+  "reviewResults": [],
+  "risks": [],
+  "nextActions": [],
+  "gateReferences": [],
+  "evidence": [],
+  "readyRule": "all required takeover gates, session evidence, shared facts, conflict checks, sensitive scan, tests and reviewer results must pass",
+  "createdAt": null,
+  "updatedAt": null
+}

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

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": 1,
+  "handoffId": "handoff-template",
+  "taskId": null,
+  "roleId": null,
+  "sessionId": null,
+  "fromActor": null,
+  "toActor": null,
+  "status": "pending",
+  "statusEnum": ["pending", "accepted", "blocked", "closed"],
+  "readBeforeExecution": {
+    "projectSnapshotHash": null,
+    "taskIndexRevision": null,
+    "recentChangeIds": [],
+    "otherHandoffIds": [],
+    "contractSnapshotIds": [],
+    "occupancyEvidence": []
+  },
+  "completedWork": [],
+  "changedFiles": [],
+  "apiChanges": [],
+  "databaseFieldChanges": [],
+  "componentChanges": [],
+  "businessFlowChanges": [],
+  "impactOnOtherTasks": [],
+  "unfinishedWork": [],
+  "pendingConfirmations": [],
+  "evidence": [],
+  "nextAction": null,
+  "createdAt": null,
+  "updatedAt": null
+}

package/init/xinyun-ai-init/templates/host-capabilities.template.json

@@ -7,6 +7,8 @@
   "statusEnum": ["available", "available-with-dependency", "unavailable", "permission-denied", "unknown", "not-checked", "not-verified", "failed"],
   "dependencyStatusEnum": ["not-required", "required", "authorized", "not-authorized", "unknown"],
   "capabilityRequiredFields": ["capabilityId", "detectionMethod", "status", "evidence", "dependencyStatus", "fallbackPlan", "usedTools", "unusedTools", "unverifiedScope", "failureReason", "checkedAt"],
+  "historicalCapabilityContract": { "version": "1.10", "requiredCount": 6, "status": "legacy-compatible" },
+  "currentProviderCapabilityContract": { "version": "1.13.1", "requiredCount": 8, "source": "host-preflight.template.json", "requiredCapabilities": ["createRealSession", "reuseExistingSession", "sendTask", "receiveResult", "querySessionStatus", "recoverSession", "closeSession", "controlFileReadWrite"] },
   "evidenceRequiredFields": ["evidenceType", "source", "summaryOrHash", "checkedAt"],
   "unknownPolicy": "unknown-means-no-verifiable-evidence; never report verified or unavailable without evidence",
   "checkedAt": null,

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

@@ -9,7 +9,19 @@
   "statusEnum": ["pending", "initializing", "completed", "partial", "blocked", "unknown", "failed", "cancelled"],
   "statusSource": "xinyun-ai/current-task.md",
   "currentVersion": null,
-  "targetVersion": "1.13.1",
+  "targetVersion": "1.14.0",
+  "agentCore": {
+    "version": "1.14.0",
+    "profilePath": "xinyun-ai/agent-profile.json",
+    "capabilitiesPath": "xinyun-ai/agent-capabilities.json",
+    "takeoverGatePath": "xinyun-ai/takeover-gate.json",
+    "orchestratorPath": "xinyun-ai/tasks/orchestrator.json",
+    "taskGraphPath": "xinyun-ai/tasks/task-graph.json",
+    "finalDeliveryPath": "xinyun-ai/final-delivery.json",
+    "agentStatus": "manual-required",
+    "takeoverStatus": "blocked",
+    "taskStatusLabelMapVersion": "1.14.0"
+  },
   "idempotencyKey": null,
   "createdFiles": [],
   "updatedFiles": [],
@@ -124,6 +136,16 @@
       "sessionIdsRemainNullUntilDecision": true
     }
   },
+  "v114": {
+    "handoffsDirectory": "xinyun-ai/handoffs/",
+    "finalDeliveryPath": "xinyun-ai/final-delivery.json",
+    "requiredRoleCount": 5,
+    "orchestratorSessionId": null,
+    "taskGraphStatus": "blocked",
+    "takeoverGateStatus": "blocked",
+    "readyRequiresAllGates": true,
+    "realProviderEvidenceRequired": true
+  },
   "v19": {
     "projectIdentityPath": "xinyun-ai/project-identity.json",
     "technicalLandscapePath": "xinyun-ai/technical-landscape.json",

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

@@ -1,6 +1,6 @@
 {
   "projectName": "",
-  "xinyunAiVersion": "1.13.1",
+  "xinyunAiVersion": "1.14.0",
   "scriptVersion": "2026.07.23",
   "schemaVersion": "1",
   "initializationMode": "fast",
@@ -14,6 +14,18 @@
     "git": "unknown"
   },
   "codegraph": { "enabled": false, "status": "unknown" },
+  "agentCore": {
+    "version": "1.14.0",
+    "profile": "xinyun-ai/agent-profile.json",
+    "capabilities": "xinyun-ai/agent-capabilities.json",
+    "takeoverGate": "xinyun-ai/takeover-gate.json",
+    "orchestrator": "xinyun-ai/tasks/orchestrator.json",
+    "taskGraph": "xinyun-ai/tasks/task-graph.json",
+    "handoffsDirectory": "xinyun-ai/handoffs/",
+    "finalDelivery": "xinyun-ai/final-delivery.json",
+    "statusEnum": ["ready", "partial", "blocked", "manual-required"],
+    "status": "manual-required"
+  },
   "index": { "primary": "json_markdown", "sqlite": "optional" },
   "capabilities": {
     "confirmationGate": true,
@@ -107,7 +119,7 @@
     "providerSessionBindingTemplate": "xinyun-ai-init/templates/provider-session-binding.template.json",
     "providerSessionBindings": "xinyun-ai/sessions/provider-session-bindings.json",
     "parentSessionId": null,
-    "targetVersion": "1.13.1",
+    "targetVersion": "1.14.0",
     "requiredRoleCount": 5,
     "statusEnum": [
       "pending",
@@ -333,6 +345,22 @@
     "manualBindingConfirmationPhrase": "已创建，继续绑定",
     "noChoicePolicy": "remain-blocked-without-repeat-prompt"
   },
+  "v114": {
+    "status": "implemented-in-package",
+    "capability": "agentCoreAndTakeoverControl",
+    "agentProfile": "xinyun-ai/agent-profile.json",
+    "agentCapabilities": "xinyun-ai/agent-capabilities.json",
+    "takeoverGate": "xinyun-ai/takeover-gate.json",
+    "orchestrator": "xinyun-ai/tasks/orchestrator.json",
+    "taskGraph": "xinyun-ai/tasks/task-graph.json",
+    "handoffsDirectory": "xinyun-ai/handoffs/",
+    "finalDelivery": "xinyun-ai/final-delivery.json",
+    "agentStatusEnum": ["ready", "partial", "blocked", "manual-required"],
+    "takeoverStatusEnum": ["not-started", "assessing", "partial", "blocked", "manual-required", "ready"],
+    "taskStatusCodeEnum": ["captured", "pending", "executing", "waiting-review", "awaiting-confirmation", "completed", "blocked", "cancelled"],
+    "taskStatusLabelMap": {"captured": "待分析", "pending": "待分配", "executing": "执行中", "waiting-review": "待审查", "awaiting-confirmation": "待确认", "completed": "已完成", "blocked": "阻塞", "cancelled": "已取消"},
+    "readyRequires": ["controlPlane", "mainTask", "roleTasks", "teamResponsibility", "codeGraph", "roleSessions", "orchestrator", "recovery", "indexes", "sharedFacts", "conflicts", "sensitiveScan"]
+  },
   "v111": {
     "status": "implemented-in-package",
     "capability": "initializationAcceleration",

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

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "orchestratorId": "orchestrator-template",
+  "orchestratorSessionId": null,
+  "provider": "codex",
+  "parentTaskId": null,
+  "projectRootHash": null,
+  "workspaceScope": "xinyun-ai-control",
+  "responsibilities": ["requirement-understanding", "task-decomposition", "role-assignment", "dependency-management", "result-aggregation", "conflict-routing", "test-review", "final-delivery"],
+  "status": "blocked",
+  "statusEnum": ["pending", "active", "blocked", "closed"],
+  "identityEvidence": [],
+  "dispatchEvidence": [],
+  "taskGraphPath": "xinyun-ai/tasks/task-graph.json",
+  "nextAction": "obtain canonical orchestrator session evidence",
+  "createdAt": null,
+  "updatedAt": null
+}

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

@@ -1,5 +1,16 @@
 {
   "projectSummary": "",
+  "agentCore": {
+    "version": "1.14.0",
+    "profile": "xinyun-ai/agent-profile.json",
+    "capabilities": "xinyun-ai/agent-capabilities.json",
+    "takeoverGate": "xinyun-ai/takeover-gate.json",
+    "orchestrator": "xinyun-ai/tasks/orchestrator.json",
+    "taskGraph": "xinyun-ai/tasks/task-graph.json",
+    "handoffsDirectory": "xinyun-ai/handoffs/",
+    "finalDelivery": "xinyun-ai/final-delivery.json",
+    "status": "manual-required"
+  },
   "projectIdentity": {
     "path": "xinyun-ai/project-identity.json",
     "projectRootHash": null,
@@ -340,6 +351,17 @@
     "manualBindingConfirmationPhrase": "已创建，继续绑定",
     "noChoicePolicy": "remain-blocked-without-repeat-prompt"
   },
+  "v114": {
+    "status": "implemented-in-package",
+    "agentStatus": "manual-required",
+    "takeoverGateStatus": "blocked",
+    "taskGraph": "xinyun-ai/tasks/task-graph.json",
+    "orchestrator": "xinyun-ai/tasks/orchestrator.json",
+    "handoffsDirectory": "xinyun-ai/handoffs/",
+    "finalDelivery": "xinyun-ai/final-delivery.json",
+    "taskStatusLabelMap": {"captured": "待分析", "pending": "待分配", "executing": "执行中", "waiting-review": "待审查", "awaiting-confirmation": "待确认", "completed": "已完成", "blocked": "阻塞", "cancelled": "已取消"},
+    "readyRequires": ["controlPlane", "mainTask", "roleTasks", "teamResponsibility", "codeGraph", "roleSessions", "orchestrator", "recovery", "indexes", "sharedFacts", "conflicts", "sensitiveScan"]
+  },
   "v111": {
     "status": "implemented-in-package",
     "capability": "initializationAcceleration",

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

@@ -3,8 +3,14 @@
   "projectStatus": "not-started",
   "projectStatusEnum": ["not-started", "initializing", "partial", "blocked", "ready"],
   "executionEligible": false,
+  "agentStatus": "manual-required",
+  "agentStatusEnum": ["ready", "partial", "blocked", "manual-required"],
+  "takeoverGateStatus": "blocked",
+  "takeoverGatePath": "xinyun-ai/takeover-gate.json",
   "blockedReasons": [],
   "requiredGates": [
+    "agentProfile",
+    "agentCapabilities",
     "projectIdentity",
     "codeGraph",
     "baseline",
@@ -18,6 +24,8 @@
     "noHighRiskBlocker"
   ],
   "gates": {
+    "agentProfile": { "status": "unknown", "passed": false },
+    "agentCapabilities": { "status": "unknown", "passed": false },
     "projectIdentity": { "status": "unknown", "passed": false },
     "codeGraph": { "status": "unknown", "passed": false },
     "baseline": { "status": "unknown", "passed": false },

package/init/xinyun-ai-init/templates/provider-adapter.template.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "adapterId": "provider-adapter-template",
   "provider": "codex",
-  "adapterVersion": "1.13.1",
+  "adapterVersion": "1.14.0",
   "status": "not-checked",
   "statusEnum": ["not-checked", "checking", "available", "available-with-dependency", "unavailable", "permission-denied", "unknown", "failed", "not-verified"],
   "canonicalSessionIdField": "providerSessionId",

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

@@ -8,6 +8,18 @@
 - title：角色后续执行：project-owner
 - priority：10
 - status：pending
+- statusCode：pending
+- statusLabel：待分配
+- goal：在已确认范围内完成角色职责
+- parentTaskId：task-template
+- dependencies：[]
+- technologyStacks：[]
+- affectedPorts：[]
+- affectedRepositories：[]
+- expectedFiles：[]
+- acceptanceReviewer：test-reviewer
+- resultId：null
+- evidence：[]
 - assignmentStatus：pending
 - understandingStatus：pending
 - confirmationStatus：pending

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

@@ -6,6 +6,10 @@
   "roleId": "project-owner",
   "sessionId": null,
   "sessionIdSemantics": "project compatibility alias; null until providerSessionId is verified",
+  "localSessionId": null,
+  "sessionIdentityMode": "provider-canonical",
+  "sessionIdentityModeEnum": ["provider-canonical", "local-degraded"],
+  "localSessionIdSemantics": "control-plane correlation ID only; it never authorizes ready or substitutes for providerSessionId",
   "providerSessionId": null,
   "providerSessionIdType": "provider-canonical-session",
   "parentSessionId": null,
@@ -38,7 +42,7 @@
     "creationEvidence": [],
     "requiredHostEvidence": ["create-or-reuse", "send", "receive", "query-status", "recover", "close"]
   },
-  "targetVersion": "1.13.1",
+  "targetVersion": "1.14.0",
   "projectRootHash": null,
   "workspaceScope": {"scopeType": "project-root", "scopePathHashes": [], "scopeRevision": null},
   "repositoryScopeHash": null,
@@ -78,15 +82,18 @@
   "degradation": {
     "localOnly": false,
     "reason": null,
-    "fakeSessionIdProhibited": true
+    "readyEligible": false,
+    "fakeSessionIdProhibited": true,
+    "localSessionIdAllowed": true
   },
   "audit": [],
   "behaviorEvidence": [],
   "renameAudit": null,
   "displayName": null,
+  "displayNamePattern": "项目名｜角色｜职责或工作流",
   "projectDisplayName": null,
   "roleDisplayName": null,
   "responsibilityLabel": null,
   "titleSource": "role-contract",
-  "titleVersion": "1.13.1"
+  "titleVersion": "1.14.0"
 }

package/init/xinyun-ai-init/templates/takeover-gate.template.json

@@ -0,0 +1,17 @@
+{
+  "schemaVersion": 1,
+  "gateId": "takeover-gate-template",
+  "agentProfilePath": "xinyun-ai/agent-profile.json",
+  "agentCapabilitiesPath": "xinyun-ai/agent-capabilities.json",
+  "status": "blocked",
+  "statusEnum": ["not-started", "assessing", "partial", "blocked", "manual-required", "ready"],
+  "executionEligible": false,
+  "requiredGates": ["controlPlane", "mainTask", "roleTasks", "teamResponsibility", "codeGraph", "roleSessions", "orchestrator", "recovery", "indexes", "sharedFacts", "conflicts", "sensitiveScan"],
+  "gates": {},
+  "sessionIdentityModes": ["provider-canonical", "local-degraded"],
+  "missingEvidence": ["real provider canonical session evidence for ready"],
+  "blockedReasons": ["required-role-session-not-created"],
+  "nextActions": ["manual-create or defer or redetect; local-degraded may continue with localSessionId"],
+  "evidence": [],
+  "updatedAt": null
+}

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

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "graphId": "task-graph-template",
+  "orchestratorId": "orchestrator-template",
+  "nodes": [],
+  "edges": [],
+  "edgeTypeEnum": ["depends-on", "blocks", "produces", "reviews"],
+  "taskStatusCodeEnum": ["captured", "pending", "executing", "waiting-review", "awaiting-confirmation", "completed", "blocked", "cancelled"],
+  "taskStatusLabelMap": {
+    "captured": "待分析",
+    "pending": "待分配",
+    "executing": "执行中",
+    "waiting-review": "待审查",
+    "awaiting-confirmation": "待确认",
+    "completed": "已完成",
+    "blocked": "阻塞",
+    "cancelled": "已取消"
+  },
+  "acyclic": true,
+  "updatedAt": null
+}

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

@@ -4,6 +4,12 @@
   "executableTaskIds": [],
   "archivedTaskIds": [],
   "currentTaskId": null,
+  "orchestratorPath": "xinyun-ai/tasks/orchestrator.json",
+  "taskGraphPath": "xinyun-ai/tasks/task-graph.json",
+  "handoffsDirectory": "xinyun-ai/handoffs/",
+  "taskStatusCodeEnum": ["captured", "pending", "executing", "waiting-review", "awaiting-confirmation", "completed", "blocked", "cancelled"],
+  "taskStatusLabelMap": {"captured": "待分析", "pending": "待分配", "executing": "执行中", "waiting-review": "待审查", "awaiting-confirmation": "待确认", "completed": "已完成", "blocked": "阻塞", "cancelled": "已取消"},
+  "taskGraphAcyclic": true,
   "initializationTaskFirst": {
     "mainTaskCreatedBeforeSession": true,
     "roleTasksCreatedBeforeSession": true,

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

@@ -5,7 +5,22 @@
 - taskType：workspace-initialization
 - projectName：当前项目
 - status：pending
+- statusCode：captured
+- statusLabel：待分析
 - taskKind：initialization-main
+- goal：建立并验证当前项目 AI 控制面
+- parentTaskId：null
+- dependencies：[]
+- assignedRole：project-owner
+- technologyStacks：[]
+- affectedPorts：[]
+- affectedRepositories：[]
+- expectedFiles：[]
+- acceptanceReviewer：test-reviewer
+- sessionId：null
+- resultId：null
+- evidence：[]
+- blockedReason：null
 - roleCount：5
 - childTaskIds：[]
 - createdFiles：[]

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

@@ -1,7 +1,7 @@
 {
   "packageName": "xinyun-ai-init",
   "displayName": "欣芸技术开发 Agent 流初始化包",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "scriptVersion": "2026.07.23",
   "schemaVersion": "1",
   "defaultMode": "fast-init",