dsh-live-teams
Host half of DSH Live Teams.
The Team tab's card geometry, type scale and interaction patterns are adapted from
dsh-context v0.52.1 by bowenliang123,
Copyright 2025, under the Apache License 2.0; the implementation is transcribed and
modified for dsh-live-teams.
Install
dsh plugin --profile <profile> add dsh-live-teams
Then enable it in that profile's cordis.patch.yml row (DSH_LIVE_TEAMS=1) and restart DSH. From a
checkout instead of the registry:
dsh plugin --profile <profile> add github:Gdenich/dsh-live-teams
Requirements: DSH Desktop 0.1.5-rc.1 or newer. The plugin checks the host when it mounts and turns
the team off with a readable reason if a required service is missing, so a DSH update cannot leave it
half-working. Supported releases are declared in package.json under dsh.compatibility.dshReleases.
What it does today: durable workspace-owned team state; a narrow Session port; a
deduplicating command queue; the Session-scoped context provider; tasks with attempts,
declared paths, review and acceptance; a reconciling dispatcher that starts what the lead
assigned and shows silence instead of guessing; Git-bound submissions whose review is a
commit range and whose integration is a compare-and-swap; and a human task surface in the
panel that creates, edits and releases work directly. The decisions behind each are in
docs/decisions/ (ADR 0001–0012) and the live evidence in
docs/implementation/pilot-findings.md.
Mounting is opt-in through this package's Cordis patch. The row is disabled unless the
composition sets DSH_LIVE_TEAMS=1, and enabling it without a workspace path fails
loudly instead of running half-wired.
Layout
TypeScript sources live in src/; lib/ is the build output and is not edited by hand.
The package follows the first-party DSH conventions: ESM lib/<entry>.js, declarations
next to it, exports with types/default pairs, files, peer dependencies on the
Harness packages, and dsh.bundle.patch.
The build is unbundled on purpose: each entry is self-contained, so no hashed shared
chunk can fall outside the published files list, and lib/ mirrors src/.
Modules
| Module | Responsibility |
|---|
errors.ts | Domain taxonomy, platform error translation, audit-only detail |
storage.ts | Atomic publish (temp file, fsync, rename, directory fsync) and a process-local lock |
team-store.ts | Team state under <workspace>/.dsh-live-teams, revision CAS, bindingGeneration, tolerant events.jsonl |
session-bridge.ts | The eight-method Session port from the architecture document §9 |
command-queue.ts | Durable admission, semantic deduplication, generation fencing, retry |
context-provider.ts | Session-scoped membership context for systemPrompt.context(...) |
Invariants enforced here
- Member identity, Session identity, role and model route are independent values.
- Every plugin-originated command is admitted by
command-queue before it reaches the port.
- Admission is idempotent on
idempotencyKey. The platform seam is not: two prompt
calls sharing one requestId were both accepted in the compatibility spike.
- A command records the
bindingGeneration it was admitted for and is refused when the
member was rebound.
interrupt cancels a turn and never touches task attempt ownership.- Team context is recomputed from authoritative state on every assembly and is never cached.
- Model selection is deliberately not implemented: the platform call also rewrites the
deployment-wide default model, and that policy needs an explicit human decision.
Tests
pnpm --filter dsh-live-teams check
pnpm --filter dsh-live-teams build
pnpm --filter dsh-live-teams test
Test files cover the error taxonomy, the store, the bridge, the queue, the context
provider, and one integration file that drives the real store through the provider and
the bridge on temporary workspaces.
