team-task — long-horizon multi-agent tasks for DeepSeek Harness

A DeepSeek Harness (dsh)
plugin: a lead session plans a reviewed DAG, durable members execute
its nodes, and a resident reconciler keeps the task moving — across model
failures, interrupted turns, and harness restarts.

Built for goals that take hours, not turns.

Why

Team plugins optimized for short bursts fail on long tasks in predictable
ways. team-task's answers, in one table:

Full rationale, axioms, state machine, and the event-log-native board design:
docs/design.md.

Quick start

Prerequisites: Node ^22.19 || >=24 (Node 23 fails to boot dsh).

1. Install dsh (skip if you have it):

npm i -g @deepseek-ai/dsh

2. Add the plugin — pick one:

# npm (recommended)
dsh plugin --profile web add @ready22race/dsh-team-task

# straight from GitHub (the repo ships its build output — no build step)
dsh plugin --profile web add github:Ready22Race/dsh-team-task

# from source (contributors; installs as a link to your checkout)
git clone https://github.com/Ready22Race/dsh-team-task.git
cd dsh-team-task && pnpm install && pnpm build
dsh plugin --profile web add .

3. Verify the composition (expect an id: team-task row):

dsh --profile web --dump-config

4. Start dsh (a restart is required after plugin add — the bundle
list is cached in-process):

dsh web

5. First run — open http://127.0.0.1:3080, set a model key
(Settings → Models) and pick a workspace, then send:

用 team-task 跑一个长任务：先加载 lead playbook，规划一张带依赖和
预指派（assignee）的节点图，逐节点评审，最后合并交付。

You should see: a task card in the conversation, the board floater on the
right (segments / filters / node cards / inspector), and
<workspace>/.team-task/tasks/<id>/log.jsonl on disk. Pre-assigned nodes
auto-flow when their dependencies approve; everything else waits for your
explicit dispatch or review.

Tools

Storage

<workspace>/.team-task/
└── tasks/                                  # the task list, chronologically sorted
    └── 20260816-2145-竞品分析示例任务/       # id = created-at stamp + name slug (CJK kept)
        ├── log.jsonl        # append-only event log — the ONLY truth
        ├── snapshot.json    # latest projection (team situation + nodes + seq); derived
        └── inbox/
            ├── lead.jsonl   # per-recipient mailbox mirror; derived, human-readable
            └── <member>.jsonl

log.jsonl is the single source of truth; every surface (tools, board
routes, offline verify) folds the same events, and any historical "team
situation at time T" is a replay of the log prefix. snapshot.json and
inbox/ are write-through derived views for humans — safe to read,
never written by hand, and never read back by the code.

Configuration

- id: team-task
  config:
    stateDir: .team-task
    memberProvider: spawn      # subagent runtime backend, not an LLM provider
    memberMaxDepth: 1
    maxMembers: 8
    reconcileIntervalMs: 30000

Development

pnpm install
pnpm build
pnpm verify   # offline: fences, review gate, rework, settlement, replay determinism

Releasing (maintainers)

The repo commits lib/ so github: installs need no build step — always
publish from a clean pnpm build (the css-module hashes are repo-relative,
so the output is machine-independent).

npm login                      # account must own the @ready22race scope
npm publish --otp=<2FA code>   # prepublishOnly runs build + verify first

With 2FA enabled, npm publish alone returns 403 — pass --otp, or create
a granular access token with "bypass 2FA" scoped to this package and put it
in ~/.npmrc for tokenized publishes. After publishing, tag the release:

gh release create vX.Y.Z --title "dsh-team-task X.Y.Z" --generate-notes

Status & roadmap

• M1 (this release) — host plugin end-to-end: tools, event log, fences,
  scheduler + reconciler, runtime settlement, review/rework, playbooks, board
  data routes (/plugins/team-task/state, /plugins/team-task/log).
• M2 — the event-log-native board UI (kanban lanes + DAG overlay +
  attention strip + per-node run timeline + replay slider; design.md §6).
• M3 — consumption-acked delivery and parentless member wake (needs
  upstream seams; tracked in design.md §7), npm publish, per-run cost
  accounting.

Known limits (v0.1): member wake-ups still require the live lead Agent (an
upstream followup constraint — the reconciler resumes work when the lead
returns); message_delivered marks inbox acceptance, not turn consumption.

中文速览

team-task 是面向长任务的 dsh 多智能体插件：lead 规划一张需评审的
DAG，durable member 执行节点，常驻 reconciler 保证崩溃/重启后任务继续。

核心主张（详见 docs/design.md）：

1. 事件日志是唯一真相 —— 状态是 log.jsonl 的纯投影，看板/工具/验证
   折叠同一份事件，重放即历史。
2. 进度归运行时，表达归模型 —— 成员不调完成工具也会在 idle 边被结算；
   工具只是加速，不是闸门。
3. fence 即运行权 —— 每次派发递增 fence，旧 fence 的迟到写入在日志层
   被拒；停止 = 撤销 fence，不是发消息。
4. 投递归调度器 —— 消息先落日志（立即安全），调度器在 idle 边 / 定时
   sweep 时投递；没有"队长在线才能通信"。
5. 评审是默认闸门 —— 只有 lead approve 才解锁下游；rework 必须带
   反馈，原节点重派、attempt 历史完整保留；机械节点可声明 auto_approve
   走快速档。
6. 渐进式 playbook —— 常驻 prompt 只有 ~8 行触发器，完整协议按角色
   （lead / member / recovery）用 team_task_playbook 按需加载。

License

MIT