@voxslopuli/teamdynamix-mcp 0.4.2 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -158,6 +158,48 @@ Each gateway tool accepts:
158
158
 
159
159
  All write/mutating actions require `TEAMDYNAMIX_ENABLE_WRITE_TOOLS=true`.
160
160
 
161
+ ## Workspace watch tools
162
+
163
+ A local, hash-diff ledger of tickets the agent manages (issue #19), plus local-only notes —
164
+ the server's own memory. Strictly read-only toward TeamDynamix: none of these tools write to
165
+ the API; drafts and sends stay human-owned.
166
+
167
+ | Tool | Behavior |
168
+ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
169
+ | `teamdynamix_watch_check` | Diff pass: queue sweep per app, deep-fetch only changed tickets, classified deltas (status, new-entry, hidden-reply, ownership, sla, hold-window) |
170
+ | `teamdynamix_watch_status` | Ledger summary (counts, ball-in-court, oldest freshness). No TDX calls. |
171
+ | `teamdynamix_watch_register` | Add/update a ledger row (lane, ball-in-court override, next action). Never calls TDX. |
172
+ | `teamdynamix_watch_archive` | Move a row to the archive; notes preserved. Never calls TDX. |
173
+ | `teamdynamix_watch_notes` | Local notes CRUD on ledgered tickets (`op: add \| update \| delete \| list`). Never written to TDX. |
174
+
175
+ - Ledger file: `$TDX_WATCH_LEDGER` (default `./.tdx-watch-ledger.json`). Atomic writes;
176
+ corrupt files fail closed rather than being silently recreated.
177
+ - Ball-in-court (`us`/`them`) is auto-inferred from the last feed entry's author; a manual
178
+ `ball` passed to `watch_register` wins permanently.
179
+ - `TEAMDYNAMIX_US_UIDS` (comma-separated) defines "us"; `TEAMDYNAMIX_AUTO_OBSERVE=true`
180
+ enables bounded auto-observations on deep reads (default off).
181
+ - Note text is capped at 4000 chars; report bodies are length-capped and redacted
182
+ (emails, phone-like runs).
183
+ - Scheduled use: run `watch_check` ~2×/day (e.g. `opencode run` with a watch-check prompt).
184
+
185
+ ### Automated sweep + background triage
186
+
187
+ - `TEAMDYNAMIX_TICKET_GROUP_IDS` (optional, comma-separated): restricts ticket searches
188
+ **globally** to those groups — applied client-side (the API does not apply `GroupIDs`
189
+ server-side on queue searches).
190
+ - `TEAMDYNAMIX_WATCH_APP_IDS`, `TEAMDYNAMIX_WATCH_STATUS_IDS`: scope new-unassigned discovery
191
+ and the sweep's status filter.
192
+ - `teamdynamix_watch_sweep`: cheap sweep (no deep fetches) that maintains a local
193
+ `pendingTriage` queue: changed ledgered tickets + new unassigned tickets in the team's
194
+ queues. `teamdynamix_watch_triage` (`op: queue | done`) lists/clears it after the agent
195
+ has reviewed a ticket and updated its notes.
196
+ - In-session: `TEAMDYNAMIX_WATCH_SWEEP_SECS=900` runs the same sweep on a timer while the
197
+ MCP server is alive (only during sessions).
198
+ - Off-session: `tdx-watch-sweep` CLI (headless, no LLM) + `scripts/triage-prompt.md` +
199
+ `scripts/org.voxslopuli.tdx-watch-sweep.plist` (launchd, every 15 min): sweep, then run
200
+ the harness triage prompt only when the queue is non-empty. Triage is read-only toward
201
+ TDX — findings go to local notes; a human sends.
202
+
161
203
  ## Safety defaults
162
204
 
163
205
  | Flag | Default | Effect when `true` |