@pm_zhousl/xinyun-ai-init 1.7.0 → 1.7.2

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

@@ -90,8 +90,40 @@
 - coverage 是否为 full / partial / unknown：待填写
 - scope/unverifiedScope 是否包含 itemId / path / itemType / reason / checkedAt：待填写
 - 越界是否进入 `status=paused` + `pauseReason=out-of-scope`：待填写
+
+## v1.7.1 检查
+
+- 主任务标题是否为 `项目初始化：<项目显示名>`：待填写
+- current-task、主任务、init-result、task-index 的 taskId/title/status 是否一致：待填写
+- 是否生成 5 个角色子任务：待填写
+- 子任务是否包含 roleTaskId、parentTaskId、taskKind、memberId、sessionId：待填写
+- 未绑定成员或会话是否使用 null：待填写
+- initialization-record 是否与 role-execution 分离：待填写
+- executionEligible 是否未被伪造为 true：待填写
+- `xinyun-ai/tasks/task-index.json` 是否可解析：待填写
+- activeTaskIds / executableTaskIds / archivedTaskIds / currentTaskId 是否一致：待填写
+- 初始化控制面完成后是否归档：待填写
+- `xinyun-ai/tasks/.archive-transactions/<archiveTransactionId>.json` 是否存在：待填写
+- archive phase 是否为 prepared / validated / moved / indexed / committed / recovery-required / blocked：待填写
+- 归档中断恢复是否不丢历史、不重复移动：待填写
+- 无任务时 current-task 是否为 status=idle、taskId=null、title=暂无待执行任务：待填写
+- `.codegraph/` 是否按授权边界处理：待填写
+- CodeGraph 首次缺失且命令可用时是否执行 `codegraph init -i`：待填写
+- 健康 CodeGraph 索引是否复用：待填写
+- CodeGraph 状态是否为 initialized / healthy / missing / unavailable / permission-denied / failed / unknown：待填写
+- manifest 是否为 CodeGraph 状态源：待填写
+- project-index/current-task/init-result 是否引用同一 codeGraphRecordId：待填写
+- CodeGraph 失败矩阵是否正确进入 blocked 或明确授权 partial：待填写
+- 是否未自动安装 CodeGraph、修改系统环境、业务代码、数据库、API、配置、依赖或 Git：待填写
 ## v1.7 machine-readable enum anchors
 
+## v1.7.2 checks
+
+- 归档后是否保留五个 role-execution 活动任务：待填写
+- activeTaskIds 非空且 executableTaskIds 为空时是否指向最高优先级任务：待填写
+- 重复升级是否按逐角色 JCS-SHA-256 幂等键复用：待填写
+- 单角色失败是否为 blocked/write-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

@@ -179,9 +179,36 @@
 - decision：direct-map / rewrite-required / backend-required / unsupported / pending / unknown。
 - status：planned / assessing / partial / blocked / paused / completed。
 - coverage：full / partial / unknown。
+
+## v1.7.1 初始化任务树、归档与 CodeGraph
+
+- 主任务标题：项目初始化：<项目显示名>
+- 主任务文件：`xinyun-ai/tasks/<taskId>.md`
+- 角色子任务目录：`xinyun-ai/tasks/<taskId>/subtasks/`
+- 角色子任务数量：5
+- taskKind：initialization-record / role-execution
+- executionEligible：false / true
+- task-index.json：`xinyun-ai/tasks/task-index.json`
+- 当前任务空闲状态：status=idle, taskId=null, title=暂无待执行任务
+- 归档目录：`xinyun-ai/tasks/archive/<taskId>/`
+- 归档事务：`xinyun-ai/tasks/.archive-transactions/<archiveTransactionId>.json`
+- archive phase：prepared / validated / moved / indexed / committed / recovery-required / blocked
+- codeGraphRecordId：待填写
+- CodeGraph required：true
+- CodeGraph status：initialized / healthy / missing / unavailable / permission-denied / failed / unknown
+- CodeGraph command：codegraph init -i
+- CodeGraph 降级授权：degradationAuthorized=true / false
 - scope/unverifiedScope：每项至少包含 itemId / path / itemType / reason / checkedAt。
 ## v1.7 machine-readable enum anchors
 
+## v1.7.2 role execution anchors
+
+- role-execution：xinyun-ai/tasks/role-execution/<roleTaskId>.md
+- activeTaskIds / executableTaskIds：活动任务与可执行任务分离
+- priority ASC / createdAt ASC / roleId Unicode / taskId：稳定排序
+- idempotencyKey：JCS-SHA-256(sourceTaskId, roleId, taskKind, targetVersion)
+- activeTaskIds 非空时 current-task 不得为 idle/null
+
 - 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

@@ -88,6 +88,11 @@
     "currentTask": "xinyun-ai/current-task.md",
     "tasksDirectory": "xinyun-ai/tasks/",
     "idempotencyDirectory": "xinyun-ai/tasks/.idempotency/",
+    "taskIndex": "xinyun-ai/tasks/task-index.json",
+    "archiveDirectory": "xinyun-ai/tasks/archive/",
+    "archiveTransactionsDirectory": "xinyun-ai/tasks/.archive-transactions/",
+    "archiveTempDirectory": "xinyun-ai/tasks/.archive-tmp/",
+    "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
     "initResult": "xinyun-ai/init-result.json",
     "taskLock": "xinyun-ai/task-lock.json",
     "managedBaseline": "xinyun-ai/index/managed-baseline.json",
@@ -100,6 +105,49 @@
       "lockStatus": ["active", "waiting", "blocked", "unknown", "released"]
     }
   },
+  "taskTree": {
+    "enabled": true,
+    "mainTaskTitlePattern": "项目初始化：<项目显示名>",
+    "roleTaskCount": 5,
+    "taskIndex": "xinyun-ai/tasks/task-index.json",
+    "mainTaskPathPattern": "xinyun-ai/tasks/<taskId>.md",
+    "roleSubtaskPathPattern": "xinyun-ai/tasks/<taskId>/subtasks/<roleTaskId>.md",
+    "roleExecutionPathPattern": "xinyun-ai/tasks/role-execution/<roleTaskId>.md",
+    "archiveDirectory": "xinyun-ai/tasks/archive/",
+    "archiveTransactionsDirectory": "xinyun-ai/tasks/.archive-transactions/",
+    "currentTaskIdle": {
+      "status": "idle",
+      "taskId": null,
+      "title": "暂无待执行任务"
+    },
+    "roleExecution": {
+      "directory": "xinyun-ai/tasks/role-execution/",
+      "taskKind": "role-execution",
+      "priority": {
+        "project-owner": 10,
+        "project-product": 20,
+        "chief-engineer": 30,
+        "programmer": 40,
+        "test-reviewer": 50
+      },
+      "sortOrder": ["priority", "createdAt", "roleId", "taskId"]
+    }
+  },
+  "codeGraphRequired": {
+    "codeGraphRecordId": null,
+    "required": true,
+    "status": "unknown",
+    "statusEnum": ["initialized", "healthy", "missing", "unavailable", "permission-denied", "failed", "unknown"],
+    "command": "codegraph init -i",
+    "version": null,
+    "indexPath": ".codegraph/",
+    "initializedAt": null,
+    "checkedAt": null,
+    "evidence": [],
+    "failureReason": null,
+    "degradationAuthorized": false,
+    "statusSource": "xinyun-ai/manifest.json"
+  },
   "delivery": {
     "confirmationGate": true,
     "productionCopyMode": "restrained",

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

@@ -0,0 +1,35 @@
+# 角色后续执行任务
+
+- taskId：role-execution-task-template
+- roleTaskId：role-task-template
+- parentTaskId：task-template
+- roleId：project-owner
+- taskKind：role-execution
+- title：角色后续执行：project-owner
+- priority：10
+- status：pending
+- assignmentStatus：pending
+- understandingStatus：pending
+- confirmationStatus：pending
+- memberId：null
+- sessionId：null
+- executionEligible：false
+- blockedReason：member-unassigned
+- nextAction：绑定成员、完成职责确认和项目理解后再执行
+- sourceTaskId：task-template
+- idempotencyKey：
+- createdAt：2026-07-21T00:00:00.000Z
+- updatedAt：2026-07-21T00:00:00.000Z
+
+## 状态与可见性
+
+- `taskKind=role-execution` 表示角色后续实际执行任务，不表示已经获得业务代码修改授权。
+- 未绑定成员、职责确认待处理或理解未完成时，任务仍属于 `activeTaskIds`，但不得进入 `executableTaskIds`。
+- `executionEligible=true` 必须同时满足成员绑定、角色 ready、职责 confirmed、理解 ready、确认人不冲突和 CodeGraph 必备条件。
+- 待分配任务使用 `status=pending`；权限、冲突、写入失败或不可恢复错误使用 `status=blocked`，并填写 `blockedReason` 和 `nextAction`。
+- `sourceTaskId` 指向已经归档的初始化主任务；角色任务完成前不得加入 `archivedTaskIds`。
+
+## 幂等
+
+- `idempotencyKey` 是对 `{sourceTaskId, roleId, taskKind, targetVersion}` 使用 v1.6 JCS 规范化 JSON 后计算的 SHA-256。
+- 同一幂等键只允许对应一个角色后续任务；重复升级必须复用任务并补齐索引。

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

@@ -0,0 +1,28 @@
+# 角色子任务
+
+- taskId：role-task-template
+- roleTaskId：role-task-template
+- parentTaskId：task-template
+- title：角色登记：project-owner
+- roleId：project-owner
+- memberId：null
+- sessionId：null
+- taskKind：initialization-record
+- assignmentStatus：completed
+- status：completed
+- readScope：xinyun-ai/team/; xinyun-ai/project/; xinyun-ai/current-task.md
+- understandingStatus：pending
+- understandingRecordId：xinyun-ai/team/understandings/project-owner.md
+- confirmationStatus：pending
+- confirmationRecordId：xinyun-ai/team/confirmations/project-owner.md
+- executionEligible：false
+- blockedReason：null
+- createdAt：2026-07-20T00:00:00.000Z
+- updatedAt：2026-07-20T00:00:00.000Z
+
+## 状态说明
+
+- taskKind=initialization-record 只表示角色任务登记完成。
+- taskKind=role-execution 才表示角色实际执行任务。
+- memberId 或 sessionId 未绑定时必须使用 null，不得虚构人员或外部会话。
+- 登记完成不等于职责确认完成、角色理解完成或 executionEligible=true。

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

@@ -11,7 +11,7 @@
 - attempt：1
 - 用户原始入口：不落盘原始敏感内容；仅记录入口摘要或 hash
 - 初始化版本：
-- 目标版本：1.7.0
+- 目标版本：1.7.1
 - 已创建文件：[]
 - 未创建内容：[]
 - 是否修改业务代码：unknown

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

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": 1,
+  "activeTaskIds": [],
+  "executableTaskIds": [],
+  "archivedTaskIds": [],
+  "currentTaskId": null,
+  "roleExecutionDirectory": "xinyun-ai/tasks/role-execution/",
+  "roleExecutionTaskIds": [],
+  "roleExecutionStatusEnum": ["pending", "assigned", "accepted", "executing", "paused", "blocked", "completed", "cancelled"],
+  "roleExecutionPriority": {
+    "project-owner": 10,
+    "project-product": 20,
+    "chief-engineer": 30,
+    "programmer": 40,
+    "test-reviewer": 50
+  },
+  "taskSortOrder": ["priority", "createdAt", "roleId", "taskId"],
+  "currentTaskPolicy": {
+    "idleWhenActiveTaskIdsEmpty": true,
+    "activeButNotExecutableStatus": ["pending", "blocked"],
+    "idleTaskId": null
+  },
+  "idempotency": {
+    "keyFields": ["sourceTaskId", "roleId", "taskKind", "targetVersion"],
+    "algorithm": "JCS-SHA-256",
+    "duplicatePolicy": "reuse"
+  },
+  "tasks": [],
+  "archiveTransactions": [],
+  "statusEnum": ["pending", "executing", "partial", "blocked", "completed", "cancelled"],
+  "idleCurrentTask": {
+    "status": "idle",
+    "taskId": null,
+    "title": "暂无待执行任务"
+  },
+  "updatedAt": "2026-07-20T00:00:00.000Z"
+}

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

@@ -0,0 +1,32 @@
+# 项目初始化主任务
+
+- taskId：task-template
+- title：项目初始化：当前项目
+- taskType：workspace-initialization
+- projectName：当前项目
+- status：pending
+- taskKind：initialization-main
+- roleCount：5
+- childTaskIds：[]
+- createdFiles：[]
+- nextAction：
+- codeGraphRecordId：null
+- codeGraphStatus：unknown
+- archiveTransactionId：null
+- createdAt：2026-07-20T00:00:00.000Z
+- updatedAt：2026-07-20T00:00:00.000Z
+
+## 子任务汇总
+
+- project-owner：
+- project-product：
+- chief-engineer：
+- programmer：
+- test-reviewer：
+
+## 归档摘要
+
+- archivePath：
+- archiveReason：
+- completedAt：
+- historyPreserved：true

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pm_zhousl/xinyun-ai-init",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "description": "欣芸技术开发 Agent 流初始化包",
   "bin": {
     "xinyun-ai-init": "bin/xinyun-ai-init.js"
@@ -30,4 +30,4 @@
   "engines": {
     "node": ">=16"
   }
-}
+}