@cr1992/agentkit 1.1.1 → 1.2.0

package/manage-worktrees/SKILL.md

@@ -61,7 +61,7 @@ manager 的 trace/common-dir 状态只应由受信 operator/controller 与 runti
 | 恢复/盘点 | `watch-service status` → `resume-all` → `list` → `doctor` | 常驻服务未安装时只报告并建议 `watch-service install`，不得用 `--no-watch` 顶替；`list/doctor` 只读；`UNTRACKED` 不等于无人使用；`EPHEMERAL` 优先 commit+push；任何 error 都暂停 `spawn/adopt` |
 | 碰撞扫描 | `scan --target <paths>` | `COLLIDE`、范围不确定或重做昂贵时隔离；`CLEAR` 仅在 owner 明确且改动小时共享；低置信后缀匹配先人工核对路径基准 |
 | 交付身份 | 选择复用/并存/替代 | branch、MR 或目录名不同不能单独证明独立交付；同一 agent 有存量树或需要替代时读交付身份（`agentkit docs worktree delivery-identity`） |
-| 创建/接管 | `spawn <semantic-slug>` / `adopt <path>` | 使用真实 agent-id，不猜身份；task 至少两个 lowercase 语义分词；base、root、堆叠、rebase/retarget 读创建与堆叠（`agentkit docs worktree spawn-and-stack`） |
+| 创建/接管 | `spawn <semantic-slug>` / `adopt <path>` | 使用真实 agent-id，不猜身份；task 至少两个 lowercase 语义分词；属于某次编排时带 `--ledger <id>`，好让 `agentkit status` 收窄到那一个；base、root、堆叠、rebase/retarget 读创建与堆叠（`agentkit docs worktree spawn-and-stack`） |
 | 更新/交接 | `touch` / `handoff` / `refresh-review` | `ready_for_review` 默认武装冻结 HEAD；handoff 只接受 clean、已 push 边界，禁止 stash 搬运；读评审生命周期（`agentkit docs worktree review-lifecycle`） |
 | 审计/提交 | `audit` / `submit` | portable core 不决定 MR/PR 或直推策略；先服从目标仓规则，再原子登记 change request 与 watcher target |
 | 批量集成 | `plan-batch` → `batch-integrate` → `batch-step` → `batch-result` | 同仓同 target：≥3 默认聚合，2 个仅在碰撞时；只合成冻结 SHA，不代跑门禁；合同/顺序/target 变化即重规划；读批量集成（`agentkit docs worktree batch-integration`） |

package/orchestrate-subagents/SKILL.md

@@ -10,6 +10,7 @@ metadata:
 
 提供宿主无关的拆解、派发、控制和验收协议。最强适配模型持续担任 controller，掌握
 `Plan → Delegate → Observe → Re-plan → Verify → Finish`；不得派生另一个 agent 接管控制面或最终判断。
+新会话冷启动或接手已有任务时先跑 `agentkit status`，找回本仓未终态的 ledger。
 
 ## 组合协议
 
@@ -40,7 +41,8 @@ controller 始终拥有闭环对象、完成标准、任务图、依赖/barrier
 和最终答复时更新，无活跃 worker 明示为 0，不虚构百分比。字段与状态变换见
 编排运行时（`agentkit docs orchestrate orchestration-runtime`）「派发台账的三张表」。台账也是回收清单：收口前
 确认没有孤儿 worker/worktree/运行时资源。任务图与台账只写仓库外会话状态；完整档用 mechanical
-ledger，轻量档用单一 JSON 快照，闭环后清理。
+ledger，闭环后 `agentkit orchestrate ledger close` 收口，放弃或升级后 drift 的用
+`close --abandon --reason <text>`；轻量档用单一 JSON 快照，闭环后清理。
 
 ### 档位无关的有效能力预检
 
@@ -64,7 +66,9 @@ Reflection 使用 `agentkit orchestrate reflection record/propose`，通用 Skil
 ### 完整档机械台账工具
 
 不满足轻量档时使用 `orchestration_mode: full`。先用 `agentkit contract normalize / validate / digest /
-review-view / diff` 固定公共 Task Contract，再以仓库外 state root 初始化 `agentkit orchestrate ledger`。
+review-view / diff` 固定公共 Task Contract——需求还没逼问成可冻结的契约时，先用
+`agentkit contract interview-*` 访谈（`agentkit docs orchestrate contract-interview`）——再以仓库外
+state root 初始化 `agentkit orchestrate ledger`。
 脚本不直接派发 Agent，controller 把宿主回执写入 `dispatch-record`。节点必须选择
 `worker_self_check`、`controller_recheck`、`independent_evidence`，只读 critic/scout 用
 `not_applicable`；依赖/barrier 未通过不派下游。命令、schema、`--expected-revision`、state root 信任

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cr1992/agentkit",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Agent engineering toolkit: orchestration, git worktree isolation, independent verification and bounded verify loops.",
   "license": "MIT",
   "repository": {
@@ -17,14 +17,14 @@
   },
   "type": "module",
   "bin": {
-    "agentkit": "./bin/agentkit.mjs"
+    "agentkit": "bin/agentkit.mjs"
   },
   "engines": {
     "node": ">=22"
   },
   "scripts": {
     "validate": "node tools/validate-skills.mjs",
-    "test": "node tools/validate-skills.mjs && node --test tests/*.test.mjs domains/*/*.test.mjs scripts/*.test.mjs",
+    "test": "node tools/validate-skills.mjs && node --test tests/*.test.mjs domains/*/*.test.mjs scripts/*.test.mjs evals/*/tests/*.test.mjs",
     "pack:check": "npm pack --dry-run"
   },
   "files": [

package/schemas/ledger-pointer-v1.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-skills.local/schemas/ledger-pointer-v1.schema.json",
+  "title": "Ledger Pointer v1",
+  "description": "仓级 ledger 指针，落盘于 <git-common-dir>/agentkit/ledgers/<ledger_id>.json。只回答 ledger 在哪，不是任何状态的真源：state_root 之外的字段仅用于展示与交叉核对，判定一律回读 state root 的事件链。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "ledger_id", "state_root", "contract_digest", "created_at"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "ledger_id": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9._-]+$" },
+    "state_root": { "type": "string", "minLength": 1, "description": "ledger state root 的绝对路径；ledger 目录为 <state_root>/ledgers/<ledger_id>。" },
+    "contract_digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$", "description": "init 时冻结的 Task Contract 摘要，只用于展示与交叉核对。" },
+    "created_at": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/orchestration-ledger-v1.schema.json

@@ -1,6 +1,23 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://agent-skills.local/schemas/orchestration-ledger-v1.schema.json", "title": "Orchestration Ledger v1", "type": "object", "required": ["schema_version", "runtime_version", "ledger_id", "revision", "contract_digest", "nodes", "edges", "attachments", "batches", "reflection_refs", "improvement_proposal_refs", "skill_provenance", "created_at", "updated_at"], "properties": { "schema_version": { "const": 1 }, "runtime_version": { "type": "string" }, "ledger_id": { "type": "string" }, "revision": { "type": "integer" }, "contract_digest": { "type": "string" }, "nodes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/node" } }, "edges": { "type": "array" }, "attachments": { "type": "array", "items": { "$ref": "#/$defs/attachment" } }, "batches": { "type": "object" }, "reflection_refs": { "type": "array" }, "improvement_proposal_refs": { "type": "array" }, "skill_provenance": { "type": "object" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" } }, "additionalProperties": false,
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://agent-skills.local/schemas/orchestration-ledger-v1.schema.json", "title": "Orchestration Ledger v1", "type": "object", "required": ["schema_version", "runtime_version", "ledger_id", "revision", "contract_digest", "nodes", "edges", "attachments", "batches", "reflection_refs", "improvement_proposal_refs", "skill_provenance", "created_at", "updated_at"], "properties": { "schema_version": { "const": 1 }, "runtime_version": { "type": "string" }, "ledger_id": { "type": "string" }, "revision": { "type": "integer" }, "contract_digest": { "type": "string" }, "nodes": { "type": "object", "additionalProperties": { "$ref": "#/$defs/node" } }, "edges": { "type": "array" }, "attachments": { "type": "array", "items": { "$ref": "#/$defs/attachment" } }, "batches": { "type": "object" }, "reflection_refs": { "type": "array" }, "improvement_proposal_refs": { "type": "array" }, "skill_provenance": { "type": "object" }, "created_at": { "type": "string" }, "updated_at": { "type": "string" }, "lifecycle": { "$ref": "#/$defs/lifecycle" } }, "additionalProperties": false,
   "$defs": {
+    "lifecycle": {
+      "description": "v1.2 新增的可选终态。缺省表示 ledger 仍然活跃；v1.1 及更早的快照没有这个字段，仍然合法。终态之后任务图冻结，只剩 record-reflection / propose-improvement / rebuild / doctor / status / inspect / batch-status。",
+      "type": "object",
+      "required": ["state", "closed_at", "reason", "closed_by_content_digest", "skill_drift_at_close"],
+      "properties": {
+        "state": { "enum": ["closed", "abandoned"] },
+        "closed_at": { "type": "string" },
+        "reason": { "description": "abandoned 必填非空；closed 固定为 null。", "type": ["string", "null"] },
+        "closed_by_content_digest": { "description": "写入终态事件时的 runtime 内容摘要；skill_drift_at_close 为 true 时它与 skill_provenance.content_digest 不同，标明这条终态由 drift 的 runtime 写入。", "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "skill_drift_at_close": { "type": "boolean" }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        { "if": { "properties": { "state": { "const": "abandoned" } }, "required": ["state"] }, "then": { "properties": { "reason": { "type": "string", "minLength": 1 } } } },
+        { "if": { "properties": { "state": { "const": "closed" } }, "required": ["state"] }, "then": { "properties": { "reason": { "type": "null" } } } }
+      ]
+    },
     "attachment": {
       "type": "object",
       "required": ["attachment_id", "node_id", "type", "digest", "ref"],

package/shell-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "package_name": "@cr1992/agentkit",
-  "package_version": "1.1.1",
+  "package_version": "1.2.0",
   "cli": {
     "command": "agentkit",
     "entry": "bin/agentkit.mjs"