@stofone/dsh-agent-roster 0.9.2 → 0.10.1

package/examples-orchestration/dist/core-review-1.0.0.json

@@ -0,0 +1,185 @@
+{
+  "kind": "dsh-agent-roster/compiled@1",
+  "source": {
+    "roster": "core-review",
+    "version": "1.0.0",
+    "title": "核心评审组",
+    "repo": "dsh-agent-roster/dsh-agent-roster",
+    "ref": "main",
+    "lock": null,
+    "file": "roster.yaml"
+  },
+  "targets": [
+    "agent-teams/members"
+  ],
+  "captain": {
+    "role": "lead@1.0.0",
+    "provider": "deepseek",
+    "model": "deepseek-v4.1-flash",
+    "reasoningEffort": "high",
+    "persona": "你负责推进，不负责写代码。每张卡先写清验收标准再派出去；收到回报先核对证据，再决定收口还是打回。\n遇到需要用户拍板的事，直接说清选项与代价，不要替他选。",
+    "personaPath": null,
+    "personaChars": 76,
+    "personaSha256": "9ea2862bd577f049067484509b710f32f7b8a95abcb2ae569de0ff25f4f5c5ae"
+  },
+  "members": [
+    {
+      "name": "reviewer",
+      "role": "代码评审",
+      "roleRef": "reviewer@1.0.0",
+      "roleName": "reviewer",
+      "roleVersion": "1.0.0",
+      "provider": "deepseek",
+      "model": "deepseek-v4.1-flash",
+      "reasoningEffort": "high",
+      "toolPolicy": "member-safe",
+      "executionPrompt": "你是这个团队的代码评审。你的读者是写这段代码的人，他比你更了解背景，但没你冷静。\n\n先说结论：这段改动能不能合、卡在哪一条。再按严重度从高到低列问题，每条给出文件、行号与具体改法。\n没有把握的地方标成「猜测」，不要用肯定的语气说出来。\n\n## 检查清单\n\n1. 边界：空值、空数组、零、负数、超长输入。\n2. 错误：失败时调用方能不能分辨「没数据」与「坏了」。\n3. 并发：有没有共享可变状态；重入会不会踩同一份缓存。\n4. 契约：改了返回形状就要在同一次改动里改所有调用点。\n",
+      "promptStats": {
+        "chars": 239,
+        "parts": [
+          {
+            "path": "roles/reviewer/AGENT.md",
+            "kind": "body+parts"
+          },
+          {
+            "path": "body",
+            "kind": "part"
+          },
+          {
+            "path": "parts/checklist.md",
+            "kind": "part"
+          }
+        ],
+        "sha256": "821be94c03087f86f9eb42620933c05a6a6a257101abfdba2abe19e77bedcb78"
+      },
+      "provenance": {
+        "role": "reviewer@1.0.0",
+        "sha256": "8c331102"
+      }
+    },
+    {
+      "name": "fixer",
+      "role": "修复",
+      "roleRef": "fixer@1.0.0",
+      "roleName": "fixer",
+      "roleVersion": "1.0.0",
+      "provider": "deepseek",
+      "model": "deepseek-v4.1-flash",
+      "reasoningEffort": "high",
+      "toolPolicy": "member-safe",
+      "executionPrompt": "只改评审指出的问题。每改一条说明改了哪个文件、为什么这样改、怎么验证的。\n发现意见本身不对时先说明，不要默默按错的方向改。\n\n在这个团队里，你还要顺带跑一次 `node --test`，把失败用例贴进回报里。",
+      "promptStats": {
+        "chars": 104,
+        "parts": [
+          {
+            "path": "roles/fixer/AGENT.md",
+            "kind": "body+parts"
+          },
+          {
+            "path": "body",
+            "kind": "part"
+          },
+          {
+            "path": "在这个团队里，你还要顺带跑一次 `node --test`，把失败用例贴进回报里。",
+            "kind": "append"
+          }
+        ],
+        "sha256": "ae95875f1ce3098b29475dd4a13609a8da5eac0a95a71bbe0be5cac92f2ec3ce"
+      },
+      "provenance": {
+        "role": "fixer@1.0.0",
+        "sha256": "a50981a7"
+      }
+    }
+  ],
+  "orchestration": {
+    "shape": "gate-pipeline",
+    "stages": [
+      {
+        "id": "build",
+        "parallel": [],
+        "serial": [
+          "fixer"
+        ],
+        "join": null,
+        "on": null,
+        "role": null,
+        "maxRounds": 1
+      },
+      {
+        "id": "audit",
+        "parallel": [
+          "reviewer"
+        ],
+        "serial": [],
+        "join": null,
+        "on": null,
+        "role": null,
+        "maxRounds": 1
+      }
+    ],
+    "gates": [
+      {
+        "id": "tests-pass",
+        "after": [
+          "audit"
+        ],
+        "requires": [
+          "现有测试全部通过",
+          "没有新增未覆盖的分支"
+        ],
+        "verify": [
+          {
+            "command": "node --test",
+            "expectExit": 0
+          },
+          {
+            "command": "node bin/cli.mjs validate --dir examples",
+            "expectExit": 0
+          }
+        ],
+        "by": "reviewer"
+      }
+    ],
+    "status": "declaration"
+  },
+  "declarations": [
+    {
+      "scope": "roster",
+      "field": "defaults.route",
+      "note": "materialized：已展开成每个成员的显式值"
+    },
+    {
+      "scope": "roster",
+      "field": "defaults.route",
+      "note": "materialized：已展开成每个成员的显式值"
+    },
+    {
+      "scope": "member",
+      "member": "fixer",
+      "field": "prompt.append/prepend",
+      "note": "materialized：已拼进 executionPrompt"
+    },
+    {
+      "scope": "captain",
+      "field": "route",
+      "note": "config：队长的路由只能由 profile 的 agent-default-model 落地，插件不写运行时"
+    },
+    {
+      "scope": "captain",
+      "field": "persona",
+      "note": "config：需要落到 profile preset 的 persona"
+    },
+    {
+      "scope": "orchestration",
+      "field": "stages/gates",
+      "note": "declaration：运行时不会执行这份编排；它先作为可校验的计划存在，编译成任务 DAG 是下一步"
+    }
+  ],
+  "requires": {
+    "skills": [],
+    "toolPolicies": [
+      "member-safe"
+    ]
+  }
+}

package/examples-orchestration/dist/core-review-1.0.0.tasks.json

@@ -0,0 +1,76 @@
+{
+  "kind": "dsh-agent-roster/plan@1",
+  "roster": {
+    "id": "core-review",
+    "version": "1.0.0"
+  },
+  "shape": "gate-pipeline",
+  "executor": "captain",
+  "tasks": [
+    {
+      "id": "build",
+      "kind": "stage",
+      "stage": "build",
+      "member": "fixer",
+      "subject": "核心评审组 · build · fixer",
+      "description": "阶段 build：fixer（修复）负责。\n这是第一个阶段，没有前置卡片。\n完成后把结果写进任务输出；不要自行判定门。",
+      "dependencies": [],
+      "gate": null
+    },
+    {
+      "id": "audit",
+      "kind": "stage",
+      "stage": "audit",
+      "member": "reviewer",
+      "subject": "核心评审组 · audit · reviewer",
+      "description": "阶段 audit：reviewer（代码评审）负责。\n前置：build。\n完成后把结果写进任务输出；不要自行判定门。",
+      "dependencies": [
+        "build"
+      ],
+      "gate": null
+    },
+    {
+      "id": "tests-pass",
+      "kind": "gate",
+      "stage": null,
+      "member": "reviewer",
+      "subject": "核心评审组 · 判定 · tests-pass",
+      "description": "门 tests-pass：由 reviewer 判定，必须先跑完下面的命令。\n  $ node --test\n    期望退出码 0\n  $ node bin/cli.mjs validate --dir examples\n    期望退出码 0\n此外还要满足（人读判据，不能替代上面的命令）：\n  - 现有测试全部通过\n  - 没有新增未覆盖的分支\n判定结论写进任务输出；不通过时在 reviewer 的结论里写清哪条命令失败、失败输出前 20 行。",
+      "dependencies": [
+        "audit"
+      ],
+      "gate": {
+        "id": "tests-pass",
+        "requires": [
+          "现有测试全部通过",
+          "没有新增未覆盖的分支"
+        ],
+        "verify": [
+          {
+            "command": "node --test",
+            "expectExit": 0
+          },
+          {
+            "command": "node bin/cli.mjs validate --dir examples",
+            "expectExit": 0
+          }
+        ],
+        "by": "reviewer"
+      }
+    }
+  ],
+  "loop": {
+    "onGateFailure": {
+      "retry": "build",
+      "maxRounds": 1
+    },
+    "runRecord": "dist/core-review-1.0.0.run.json"
+  },
+  "notes": [
+    "插件不调用任何 agent_teams_* 工具：这份文件是给队长会话的施工图。",
+    "卡片真正的 id 由团队分配；这里的 id 只在施工图内部表达依赖。",
+    "门必须先跑 verify 里的命令，全部满足期望退出码才算通过；requires 是给人读的补充判据，不能替代 verify。",
+    "失败意见写进 runRecord 指向的文件，下一次编译会把它带进重试卡。",
+    "orchestration.status = declaration：施工图描述的是「打算怎么跑」，不是「已经跑过」。"
+  ]
+}

package/examples-orchestration/roles/fixer/AGENT.md

@@ -0,0 +1,18 @@
+---
+kind: dsh-agent-roster/role@1
+name: fixer
+version: 1.0.0
+role: 修复
+title: 只修被指出的那几条
+description: 按评审意见改，不做顺手重构；改完给出复跑结果。
+tags: [fix]
+route:
+  provider: deepseek
+  model: deepseek-v4.1-flash
+  reasoningEffort: medium
+tools:
+  policy: member-safe
+---
+
+只改评审指出的问题。每改一条说明改了哪个文件、为什么这样改、怎么验证的。
+发现意见本身不对时先说明，不要默默按错的方向改。

package/examples-orchestration/roles/lead/AGENT.md

@@ -0,0 +1,18 @@
+---
+kind: dsh-agent-roster/role@1
+name: lead
+version: 1.0.0
+role: 队长
+title: 拆任务与收口的那个会话
+description: 把目标拆成可验收的卡，逐张派给成员，验收后收口；不亲自实现。
+tags: [lead]
+route:
+  provider: deepseek
+  model: deepseek-v4.1-flash
+  reasoningEffort: high
+tools:
+  policy: member-safe
+---
+
+你负责推进，不负责写代码。每张卡先写清验收标准再派出去；收到回报先核对证据，再决定收口还是打回。
+遇到需要用户拍板的事，直接说清选项与代价，不要替他选。

package/examples-orchestration/roles/reviewer/AGENT.md

@@ -0,0 +1,23 @@
+---
+kind: dsh-agent-roster/role@1
+name: reviewer
+version: 1.0.0
+role: 代码评审
+title: 严格但不啰嗦的评审
+description: 只对 diff 里真实存在的风险发言，按严重度排序，给可执行的修法。
+tags: [review, quality]
+route:
+  provider: deepseek
+  model: deepseek-v4.1-flash
+  reasoningEffort: high
+tools:
+  policy: member-safe
+prompt:
+  parts: [parts/checklist.md]
+  budget: 4000
+---
+
+你是这个团队的代码评审。你的读者是写这段代码的人，他比你更了解背景，但没你冷静。
+
+先说结论：这段改动能不能合、卡在哪一条。再按严重度从高到低列问题，每条给出文件、行号与具体改法。
+没有把握的地方标成「猜测」，不要用肯定的语气说出来。

package/examples-orchestration/roles/reviewer/parts/checklist.md

@@ -0,0 +1,6 @@
+## 检查清单
+
+1. 边界：空值、空数组、零、负数、超长输入。
+2. 错误：失败时调用方能不能分辨「没数据」与「坏了」。
+3. 并发：有没有共享可变状态；重入会不会踩同一份缓存。
+4. 契约：改了返回形状就要在同一次改动里改所有调用点。

package/examples-orchestration/rosters/core-review/overrides/fixer.md

@@ -0,0 +1 @@
+在这个团队里，你还要顺带跑一次 `node --test`，把失败用例贴进回报里。

package/examples-orchestration/rosters/core-review/roster.yaml

@@ -0,0 +1,43 @@
+kind: dsh-agent-roster/roster@2
+id: core-review
+version: 1.0.0
+title: 核心评审组
+description: 一个小团队：队长拆任务，评审把关，修复收尾。用来演示 v2 的引用式成员与声明式编排。
+license: MIT
+maintainers: [stofone]
+tags: [review, example]
+defaults:
+  route:
+    provider: deepseek
+    model: deepseek-v4.1-flash
+    reasoningEffort: high
+targets: [agent-teams/members]
+members:
+  - as: reviewer
+    role: reviewer@1.0.0
+  - as: fixer
+    role: fixer@1.0.0
+    prompt:
+      append: overrides/fixer.md
+captain:
+  role: lead@1.0.0
+orchestration:
+  shape: gate-pipeline
+  stages:
+    - id: build
+      serial: [fixer]
+    - id: audit
+      parallel: [reviewer]
+  gates:
+    - id: tests-pass
+      after: [audit]
+      by: reviewer
+      requires: [现有测试全部通过, 没有新增未覆盖的分支]
+      verify:
+        - command: node --test
+          expectExit: 0
+        - command: node bin/cli.mjs validate --dir examples
+          expectExit: 0
+requires:
+  toolPolicies: [member-safe]
+onMissing: refuse

package/index.js

@@ -20,7 +20,9 @@ import { configView } from "./lib/config-view.js";
 import { applyCaptain, listSessions } from "./lib/apply.js";
 import { collectLibrary } from "./lib/library.js";
 import { parseDocumentText } from "./lib/parse.js";
+import { ROSTER2_KIND } from "./lib/format-v2.js";
 import { validateRoster } from "./lib/validate.js";
+import { validateRoster2 } from "./lib/roster2.js";
 import { sendError, sendJson, createAuthGate, readJsonBody, requireMethod } from "./lib/http.js";
 import { buildPanelSnapshot, installCollection, loadRemotePanel, resolveRoots } from "./lib/service.js";
 import { fetchCollection } from "./lib/remote.js";
@@ -203,7 +205,12 @@ export function apply(ctx, config) {
         }
         // 编辑表单需要人设原文：解析一份给编辑器用，解析失败也不挡"看源码"这条路。
         const parsed = parseDocumentText(result.text, { file: result.file, format: result.format });
-        const validated = parsed.ok ? validateRoster(parsed.value, { file: result.file }) : null;
+        const isV2 = parsed.ok && parsed.value?.kind === ROSTER2_KIND;
+        const validated = parsed.ok
+          ? isV2
+            ? validateRoster2(parsed.value, { file: result.file })
+            : validateRoster(parsed.value, { file: result.file })
+          : null;
         sendJson(res, 200, {
           ok: true,
           file: result.file,