@voxslopuli/teamdynamix-mcp 0.4.2 → 0.5.0
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 +42 -0
- package/index.js +483 -852
- package/index.js.map +1 -1
- package/package.json +1 -1
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` |
|