@nanmicoder/dsh-agent-teams 0.1.13 → 0.1.15-alpha.1

package/README.md

@@ -7,16 +7,22 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@nanmicoder/dsh-agent-teams"><img src="https://img.shields.io/npm/v/@nanmicoder/dsh-agent-teams.svg" alt="npm version"></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@nanmicoder/dsh-agent-teams.svg" alt="MIT license"></a>
-  <img src="https://img.shields.io/badge/DeepSeek%20Harness-plugin-202724" alt="DeepSeek Harness plugin">
+  <a href="https://dshfind.com/en/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://img.shields.io/badge/recommended%20by-dshfind-FFD700?style=flat-square" alt="Recommended by dshfind"></a>
+  <a href="https://dshfind.com/en/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://dshfind.com/api/badge/NanmiCoder/dsh-agent-teams?lang=en" alt="dshfind score"></a>
+  <a href="https://dshfind.com/en/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://dshfind.com/api/badge/NanmiCoder/dsh-agent-teams?metric=downloads&amp;lang=en" alt="dshfind downloads"></a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@nanmicoder/dsh-agent-teams"><img src="https://img.shields.io/npm/v/@nanmicoder/dsh-agent-teams?style=flat-square&amp;color=5B4CF0" alt="npm version"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-0B7285?style=flat-square" alt="MIT license"></a>
+  <a href="./cordis.patch.yml"><img src="https://img.shields.io/badge/DSH-Web%20%2B%20Headless-5B4CF0?style=flat-square" alt="DSH Web and Headless"></a>
 </p>
 
 ## One prompt. A working team.
 
 `dsh-agent-teams` turns the current DeepSeek Harness session into a captain that can assemble durable sub-agents, split a goal into dependency-aware tasks, and coordinate work through direct messages.
 
-Ask in natural language. The plugin provides the team protocol, ten coordination tools, persistent state, an automatic shared-task scheduler, and a live Web UI—without requiring a separate workflow engine.
+Ask in natural language. The plugin provides the team protocol, eleven coordination tools, persistent state, an automatic shared-task scheduler, and a live Web UI—without requiring a separate workflow engine.
 
 <p align="center">
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness conversation with the AgentTeams live activity panel, members, tasks, dependencies, and reports">
@@ -24,7 +30,7 @@ Ask in natural language. The plugin provides the team protocol, ten coordination
 
 ## Releases
 
-Read the [latest release notes](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest) or browse the [complete release history](https://github.com/NanmiCoder/dsh-agent-teams/releases). The same Markdown notes are included in the npm package under `release-notes/`.
+For Harness Alpha.2, read [v0.1.15-alpha.1](https://github.com/NanmiCoder/dsh-agent-teams/releases/tag/v0.1.15-alpha.1). The [stable release](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest) remains on the older host line. Browse the [complete release history](https://github.com/NanmiCoder/dsh-agent-teams/releases); the same notes ship in the npm package under `release-notes/`.
 
 ## Why AgentTeams?
 
@@ -35,32 +41,63 @@ Read the [latest release notes](https://github.com/NanmiCoder/dsh-agent-teams/re
 | **Dependency-aware tasks** | Tasks move through explicit states and cannot be claimed before their dependencies finish. |
 | **Automatic reuse and safe takeover** | Idle members claim the next ready task; reassignment revokes stale attempts before new work starts, and cold recovery retries stranded open attempts. |
 | **Direct messaging** | Members send durable mailbox messages directly to teammates or the captain—no relay required. |
-| **Live activity panel** | The Web UI combines segmented progress, a collapsible roster, and an interactive task DAG; completed archives retain their full member and task history. |
+| **Live activity panel** | The Web UI combines segmented progress, a collapsible roster, and an interactive task DAG; running tasks show the member's model, and completed archives retain their full member and task history. |
+| **Plan before execution** | Normal `/agent-teams` runs stage an unspawned roster and DAG first. The Web panel uses the host model catalog for member routes. Returning to chat stops the planning turn, asks what should change, and revises the same draft; discarding archives the draft, aborts the turn, and explicitly prevents automatic recreation. Only **Approve & Run** creates members and starts scheduling. |
+| **Quality gates** | Opt-in quality tasks support requirements → implementation → verification → review → integration contracts, automatic repair/re-review, and explicit resume. Scope control is a completion-time audit, not host write interception. See [docs/quality-gates.md](./docs/quality-gates.md). |
 
 The conversation card and activity panel use Harness's official locale service. They follow live language changes between English and Simplified Chinese—including status labels, dynamic summaries, controls, archive markers, and accessibility text—without a page reload or a separate plugin setting.
 
 ## Install
 
-> [!NOTE]
-> Requires an existing [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) installation.
+> [!IMPORTANT]
+> **Plugin 0.1.15-alpha.1 requires DeepSeek Harness 0.1.2-alpha.2.** Updating this plugin does not update Harness. This release has no adapter for the old RC host APIs. Check the version of the instance you actually launch with `dsh --version` before installing.
+
+| Harness host | Plugin to use | Compatibility status |
+| --- | --- | --- |
+| **0.1.2-alpha.2** | **0.1.15-alpha.1** (`@alpha`) | Real API and Web UI verified on macOS arm64. |
+| **0.1.0-rc.8** | **0.1.14** | Previous dependency baseline; keep this pair if you are not upgrading Harness. |
+| Other older RC / unchanged source checkout | Keep your working plugin version; do not install `@alpha` | Do not assume every older host works with 0.1.14. |
+| Alpha.1, later Alpha versions, or other source revisions | Not verified | Match the documented host version or validate separately. |
+
+`alpha` is the opt-in channel for this migration. **`latest` remains 0.1.14** so ordinary installs do not switch older hosts to the Alpha.2 build. Optional peer dependencies are not a runtime version check: a successful install on an incompatible host does not mean the plugin can activate.
+
+See the [compatibility details](./docs/alpha2-compatibility.md) and [real business / UI acceptance report](./docs/alpha2-release-acceptance.md).
+
+### npm: Harness Alpha.2
+
+If you install Harness through npm, upgrade the host first, then install the matching plugin:
+
+```sh
+npm install --global @deepseek-ai/dsh@0.1.2-alpha.2
+dsh --version
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.15-alpha.1
+```
+
+The exact plugin version is reproducible; use `@nanmicoder/dsh-agent-teams@alpha` to follow the Alpha channel after checking its release notes. These examples target the `web` profile; use your actual profile if different. Stop and restart the running Harness process after changing either host or plugin, then refresh the browser.
+
+### Staying on an older host / rolling back
 
-### npm
+If you are keeping the previous RC host, **do not upgrade the plugin to this Alpha release**. Keep the working 0.1.14 pair or reinstall its pinned package:
 
 ```sh
-dsh plugin --profile web add @nanmicoder/dsh-agent-teams@latest
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.14
 ```
 
-### Build from source
+Restart the old host and refresh the browser. If you also upgraded Harness, restore the matching older host before using 0.1.14; rolling back only the plugin is not a supported Alpha.2 configuration. Do not delete credentials or `.agent-teams` data to fix a version mismatch.
+
+**Harness built from source:** updating this plugin repository, rebuilding it, or installing a global CLI does not upgrade a separately launched Harness checkout. Preserve your local changes, update the actual host checkout to [dsh-v0.1.2-alpha.2](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.1.2-alpha.2), follow its build instructions, and restart that host. If its source must stay old, keep the old plugin too; for a source-linked plugin use tag `v0.1.14` and its matching dependencies/build, not the current `main` branch.
+
+### Build the Alpha.2 plugin from source
 
 ```sh
-git clone https://github.com/NanmiCoder/dsh-agent-teams.git
+git clone --branch v0.1.15-alpha.1 https://github.com/NanmiCoder/dsh-agent-teams.git
 cd dsh-agent-teams
-pnpm install
+pnpm install --frozen-lockfile
 pnpm build
 dsh plugin --profile web add .
 ```
 
-Run `pnpm build` again after changing the source. The local plugin install remains linked to this checkout.
+This requires the Alpha.2 host above. Run `pnpm build` again after changing the source. The local plugin install remains linked to this checkout; pulling source alone does not rebuild that linked plugin.
 
 Validate the composed profile, restart DSH, and refresh the Web UI:
 
@@ -160,6 +197,34 @@ pnpm build
 pnpm verify
 ```
 
+## Named multi-role profiles
+
+Configure one or more complete team profiles in `cordis.patch.yml`. A profile always supplies the roster (independent provider/model/role/reasoning effort). Set `taskPlanning: captain` when the Captain should derive the DAG from the user's goal; omit it or set `taskPlanning: seed` to keep a fixed template workflow:
+
+```yaml
+profiles:
+  demo-delivery:
+    description: Ship a small feature
+    protocol: Discuss requirements, review, test, then prepare release; do not deploy automatically.
+    members:
+      - name: analyst
+        model: gpt-5.6-sol
+        role: Analyze requirements
+      - name: implementer
+        model: gpt-5.6-terra
+        role: Implement the approved solution
+    tasks:
+      - id: requirements
+        subject: Requirements discussion
+        assignee: analyst
+      - id: implementation
+        subject: Implement solution
+        assignee: implementer
+        dependencies: [requirements]
+```
+
+Use an explicit profile flag: `/agent-teams --profile demo-delivery implement the feature`. The first ordinary token is never treated as an implicit profile. Normal command runs call `agent_teams_create({ profile, approval: "required" })`: the roster and seed/Captain-designed DAG remain staged, no child session is created, and no task is claimed. Edit the plan in the activity panel using the host model catalog, return to chat so the Captain asks what to revise and then atomically updates the same draft, discard it, or click **Approve & Run**. Return/discard actions cancel any planning turn still running; discard also parks model-facing context that forbids silently creating a replacement team. Approval resolves the final provider/model/reasoning choices, atomically spawns the roster, and starts only ready tasks. A running team is stopped from its own panel header through a confirmation dialog rather than from the composer. Direct tool clients may pass `approval: "automatic"` for the legacy immediate path. Failed review/test tasks do not unlock downstream work; automatic repair/review tasks do not depend on the failed review.
+
 ## License
 
 [MIT](./LICENSE)

package/README_ZH.md

@@ -7,16 +7,22 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@nanmicoder/dsh-agent-teams"><img src="https://img.shields.io/npm/v/@nanmicoder/dsh-agent-teams.svg" alt="npm 版本"></a>
-  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@nanmicoder/dsh-agent-teams.svg" alt="MIT 许可证"></a>
-  <img src="https://img.shields.io/badge/DeepSeek%20Harness-plugin-202724" alt="DeepSeek Harness 插件">
+  <a href="https://dshfind.com/zh/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://img.shields.io/badge/%E7%94%B1%20dshfind-%E6%8E%A8%E8%8D%90-FFD700?style=flat-square" alt="由 dshfind 推荐"></a>
+  <a href="https://dshfind.com/zh/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://dshfind.com/api/badge/NanmiCoder/dsh-agent-teams?lang=zh" alt="dshfind 评分"></a>
+  <a href="https://dshfind.com/zh/plugins/NanmiCoder/dsh-agent-teams?ref=badge"><img src="https://dshfind.com/api/badge/NanmiCoder/dsh-agent-teams?metric=downloads&amp;lang=zh" alt="dshfind 下载量"></a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@nanmicoder/dsh-agent-teams"><img src="https://img.shields.io/npm/v/@nanmicoder/dsh-agent-teams?style=flat-square&amp;color=5B4CF0" alt="npm 版本"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-0B7285?style=flat-square" alt="MIT 许可证"></a>
+  <a href="./cordis.patch.yml"><img src="https://img.shields.io/badge/DSH-Web%20%2B%20Headless-5B4CF0?style=flat-square" alt="DSH Web 与 Headless"></a>
 </p>
 
 ## 一句话，拉起一支真正协作的团队
 
 `dsh-agent-teams` 让当前 DeepSeek Harness 会话成为队长：创建可续聊的子 Agent、把目标拆成有依赖的任务，并通过直达消息协调成员工作。
 
-你只需用自然语言提出目标。插件会提供团队协议、10 个协作工具、持久化状态、自动共享任务调度和实时 Web UI，不需要额外的 Workflow 引擎。
+你只需用自然语言提出目标。插件会提供团队协议、11 个协作工具、持久化状态、自动共享任务调度和实时 Web UI，不需要额外的 Workflow 引擎。
 
 <p align="center">
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness 对话与 AgentTeams 实时活动面板，展示成员、任务依赖和回报">
@@ -24,7 +30,7 @@
 
 ## 版本更新
 
-查看[最新版本说明](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest)，或浏览[完整发布历史](https://github.com/NanmiCoder/dsh-agent-teams/releases)。同一份 Markdown 说明也会随 npm 包发布到 `release-notes/` 目录。
+Harness Alpha.2 用户请查看 [v0.1.15-alpha.1](https://github.com/NanmiCoder/dsh-agent-teams/releases/tag/v0.1.15-alpha.1)。[稳定版](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest)仍保留给旧宿主使用。也可浏览[完整发布历史](https://github.com/NanmiCoder/dsh-agent-teams/releases)；同一份说明随 npm 包发布到 `release-notes/` 目录。
 
 ## 为什么需要 AgentTeams？
 
@@ -35,32 +41,62 @@
 | **带依赖的任务** | 任务有明确状态；依赖未完成时不能领取。 |
 | **自动续领与安全接管** | 成员空闲后自动领取下一项就绪任务；转派会撤销旧 attempt，冷恢复会重试遗留任务，迟到结果无法覆盖。 |
 | **成员直达消息** | 成员通过持久化邮箱直接联系队友或队长，不需要队长中转。 |
-| **实时活动面板** | Web UI 用分段进度、可折叠成员树和可交互 DAG 展示实时工作；团队结束后仍保留完整成员与任务历史。 |
+| **实时活动面板** | Web UI 用分段进度、可折叠成员树和可交互 DAG 展示实时工作；运行中的子任务会标出使用的模型，团队结束后仍保留完整成员与任务历史。 |
+| **质量门禁** | 人只提供目标和约束。默认任务顺序是需求 → 实现 → 验证 → 审查 → 集成，失败后自动修复/复审，恢复团队必须显式 resume。第一版范围控制是完成时审计，不是 host 写入拦截。详见 [docs/quality-gates.md](./docs/quality-gates.md)。 |
 
 对话卡片与活动面板接入 Harness 官方多语言服务，会随宿主在简体中文和英文之间实时切换；任务/成员状态、动态摘要、操作按钮、历史归档标识和无障碍文案都会同步更新，无需刷新页面，也不增加插件自己的语言设置。
 
 ## 安装
 
-> [!NOTE]
-> 使用前请确保已安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。
+> [!IMPORTANT]
+> **插件 0.1.15-alpha.1 对应 DeepSeek Harness 0.1.2-alpha.2。** 升级插件不会自动升级 Harness，本版也没有兼容旧 RC 宿主 API 的适配层。安装前先用 `dsh --version` 核对你实际启动的宿主版本。
+
+| Harness 宿主 | 应使用的插件 | 兼容性说明 |
+| --- | --- | --- |
+| **0.1.2-alpha.2** | **0.1.15-alpha.1**（`@alpha`） | 已在 macOS arm64 上通过真实 API 和 Web UI 验收。 |
+| **0.1.0-rc.8** | **0.1.14** | 原有依赖基线；不升级宿主时保留这一组合。 |
+| 其他旧 RC / 未更新的源码宿主 | 保留当前已能正常使用的插件，不要安装 `@alpha` | 不能推断所有旧宿主都兼容 0.1.14。 |
+| Alpha.1、后续 Alpha 或其他源码提交 | 尚未验证 | 请对齐上面明确验证的宿主版本，或单独验证。 |
+
+本次迁移通过 `alpha` 渠道主动选择安装，**`latest` 保持为 0.1.14**，普通更新不会把旧宿主切到 Alpha.2 插件。可选 peer dependencies 并不是运行时版本拦截：装得上，不代表不兼容的宿主能加载成功。
 
-### npm
+详见[兼容性记录](./docs/alpha2-compatibility.md)和[真实业务 / UI 验收报告](./docs/alpha2-release-acceptance.md)。
+
+### npm：使用 Harness Alpha.2
+
+通过 npm 安装 Harness 的用户，先升级宿主，再安装对应插件：
 
 ```sh
-dsh plugin --profile web add @nanmicoder/dsh-agent-teams@latest
+npm install --global @deepseek-ai/dsh@0.1.2-alpha.2
+dsh --version
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.15-alpha.1
 ```
 
-### 从源码构建
+上面固定版本，便于复现；确认发布说明后，也可用 `@nanmicoder/dsh-agent-teams@alpha` 跟随 Alpha 渠道。示例针对 `web` profile，其他 profile 请替换为你实际使用的名称。宿主或插件变更后，停止并重启正在运行的 Harness，再刷新浏览器。
+
+### 不升级宿主 / 回退旧版本
+
+如果仍使用原来的 RC 宿主，**不要把插件升级到本次 Alpha 版**。保留可用的 0.1.14 组合，或重新安装固定版本：
 
 ```sh
-git clone https://github.com/NanmiCoder/dsh-agent-teams.git
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.14
+```
+
+重启旧宿主并刷新浏览器即可。如果宿主也已升级，则要恢复匹配的旧宿主后再使用 0.1.14；仅回退插件不是受支持的 Alpha.2 组合。版本不匹配不需要删除凭据或 `.agent-teams` 数据。
+
+**从源码运行 Harness 的用户：** 更新本插件仓库、重新构建插件，或安装全局 CLI，都不会自动升级另一个正在运行的 Harness 源码目录。请先保留本地改动，把实际启动的宿主源码更新到 [dsh-v0.1.2-alpha.2](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.1.2-alpha.2)，按该版本说明安装依赖、构建并重启。如果宿主源码必须保持旧版，插件也应保留旧版；本地链接插件请使用 `v0.1.14` tag 及其对应依赖和构建，不要直接更新到当前 `main`。
+
+### 从源码构建 Alpha.2 插件
+
+```sh
+git clone --branch v0.1.15-alpha.1 https://github.com/NanmiCoder/dsh-agent-teams.git
 cd dsh-agent-teams
-pnpm install
+pnpm install --frozen-lockfile
 pnpm build
 dsh plugin --profile web add .
 ```
 
-修改源码后请重新执行 `pnpm build`。本地安装会继续链接到当前源码目录。
+此构建要求上面的 Alpha.2 宿主。修改源码后请重新执行 `pnpm build`；本地安装会继续链接到当前源码目录，只拉取代码不会重建已经链接的插件。
 
 检查组合配置、重启 DSH，然后刷新 Web UI：
 
@@ -150,6 +186,12 @@ pnpm build
 pnpm verify
 ```
 
+## 命名多角色团队配置
+
+在 `cordis.patch.yml` 的 `profiles` 中配置完整团队模板。每个 profile 都提供成员阵容，可独立指定 provider、model、role、reasoning_effort。`taskPlanning: captain` 表示只提供阵容和约束，由 Captain 根据用户目标设计 DAG；省略该字段或设为 `seed` 时，展开模板中的固定任务图。使用 `/agent-teams --profile <名称> <目标>` 显式激活；不会把首个普通 token 隐式识别为 profile。
+
+普通 `/agent-teams` 流程会调用 `agent_teams_create({ profile, approval: "required" })`：只落盘可编辑的成员占位和 DAG，不创建子会话、不领取任务。成员模型和推理等级直接读取 Harness 的模型目录。「返回对话修改」会终止仍在运行的规划轮次，让队长先追问修改方向，再用一次原子操作更新同一份草案；「放弃本次计划」经二次确认后会归档草案、中止轮次，并向模型注入不得自动重建团队的控制上下文。只有点击「确认并启动团队」才会按最终配置原子创建成员并启动就绪任务。运行中团队的停止入口位于该团队的面板标题，点击后需要二次确认，不再占用输入区域。直接工具调用方可显式传 `approval: "automatic"` 保留旧的立即执行路径。审查或测试失败不会解锁下游；自动 repair/review 不依赖 failed review。
+
 ## 许可证
 
 [MIT](./LICENSE)