dsh-handoff-review
OpenChamber-style handoff review for DeepSeek Harness: hand off current session changes to a linked read-only review session.
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:j7708git/dsh-handoff-review#bcea6d81eea2fdc4d85528a725fd9b9e0817636b
Handoff Review is published as dsh-handoff-review and currently resolves to version 0.1.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
A DeepSeek Harness plugin that hands the current session's changes to a linked, read-only review session — a round-by-round handoff review in the spirit of OpenChamber.
The implementation session keeps working; an ordinary review session in the same workspace reviews the change in an independent context. Its report can be sent back to the implementer, later revisions can be sent back to the reviewer, and every round is kept in a durable link record. The plugin only adds commands, routes, projections, listeners and UI slots: nothing is written into the DSH kernel, and removing the bundle removes everything it registered.
Link state, both sessions, actions and round history in the right-sidebar panel (session and link ids masked).
Reviewer route and handoff limits under Settings → Handoff Review.
/handoff-review focus on retry logic (or the
composer dock button) creates or reuses a link, opens a review session and
delivers a handoff brief: goal, review focus, changed files, unified diff,
verification and open questions.sandbox/mode: read-only session event, removal/denial of write tools on the
reviewer's scoped tool runtime, and an approval: never policy.maxRounds, per-round dedupe and a delivery rate limit keep the
loop bounded.0.2.x) with ctx.storageDomain available (the stock desktop
profile satisfies this).This is a profile bundle with a Host half and a Web Client half. The desktop profile is managed by the app, so install it through the app:
The bundle patch (cordis.patch.yml) contributes one composition row:
- insert:
- id: handoff-review
name: dsh-handoff-review
config:
maxRounds: 3
maxHandoffChars: 30000
diffPerFileChars: 6000
edit/write changes./handoff-review focus on retry logic, or click Handoff review in the
composer dock. The review session appears in the same workspace, titled
Review: <impl title> (round N).feedback_ready. In the
implementation session press Send feedback (or run
/handoff-review feedback from the review session)./handoff-review revision) — only
changes after the last handoff watermark are sent, round + 1. Past
maxRounds, the dock offers Send revision (force) and the command accepts
--force./handoff-review close). Sessions are never
deleted; the review session keeps its history.| Command | Purpose |
|---|---|
/handoff-review [focus] | create/reuse a link and deliver a handoff |
/handoff-review status | print the current link state |
/handoff-review feedback | send the reviewer's report to the implementer |
/handoff-review revision [--force] | send new changes as the next round |
/handoff-review close | close the link (history is kept) |
/handoff-review reopen | reopen a closed link |
/handoff-review --new [focus] | open another link for the same session |
/handoff-review -- <focus> | escape a focus that starts with a command word |
Enable Settings → Handoff Review → 行為 → 自動接續審查流程 once. From then on
starting a review is the only manual action: when the reviewer turn ends its
report is delivered to the implementation session, and when the implementation
turn ends the new changes are sent back to the reviewer. The loop stops at
maxRounds (no automatic --force), when there are no new changes, when a peer
session is offline, or when the link is closed. A stop injects a non-waking
[handoff-review] notice instead of looping, and automation re-arms on restart
or when a peer session is reopened.
Settings are persisted in the plugin's own storage domain
(handoff_review_settings) — no profile YAML edits.
| Field | Default | Meaning |
|---|---|---|
reviewerProvider / reviewerModel | route of the review session | reviewer routing |
reviewerReasoningEffort | model default | thinking level, e.g. high |
reviewerPreset | deployment default | agent preset for the review session |
maxRounds | 3 | revisions beyond this need --force |
autoContinue | false | run the review loop automatically |
The page also exposes maxHandoffChars (30000), diffPerFileChars (6000),
autoSummarize (off), readOnlyReviewer (on) and maxDeliveriesPerMinute (6).
A saved value applies to new reviews; an existing link keeps the reviewer route
captured when it was created.
[handoff-review] … and marks itself as data, not instructions.*_KEY, *_TOKEN, password, secret,
api[_-]?key) are redacted and .env-like files are skipped. A diff can still
contain sensitive material — treat handoffs like patches./handoff-review/api/* are exact web-server routes and apply the host
browser-trust fence themselves; no approval escalation is performed.pnpm install # or npm install
npm run check # node --check on every module
npm test # node:test unit + integration suite (92 tests)
Tests cover the handoff builder, projections, link store, delivery loop breaker, route fence, command grammar, reviewer lockdown, config admin and a fake-Cordis round trip (create → feedback → revision → close → reopen).
See DEVELOPMENT.md for the full specification, assumptions
and as-built notes.
MIT