Multiplayer agent harness for work.
Wall of shame: credential handle prefix band-aid (#2257)
Regan Bellf2db532574d9
diff --git a/docs/SPEC.md b/docs/SPEC.mdindex 96e750504..b33073419 100644--- a/docs/SPEC.md+++ b/docs/SPEC.md@@ -47,10 +47,11 @@ Past mistakes and examples:- **Harness/model selection** (2026-07-17): A selector grew into a proposed "agent profile" platform with its own catalog, preference layers, upgrade acknowledgments, readiness handling, and cohort rollout. The smaller solution extended the existing scoped setting with a `{ harness, model }` pair and reused the existing configuration and picker machinery. [qm#2134](https://github.com/yc-software/qm/pull/2134).- **Admin tool** (2026-09-17–18): Concern about oversized responses grew into a 43-file, roughly 4,580-line patch with field limits, custom JSON validation, layered timeouts, duplicate concurrency limits, and a special handshake. Only after pushback did the agent inventory actual calls and identify large transcripts as the concrete risk. The replacement used bounded transcript pagination and a thin read-only tool: 9 files, +329/−18. _Source/status:_ original transcript and patch not yet recovered; size and rejection claims are unverified.-### Band-aid fixes (always reviewed, 10 examples)+### Band-aid fixes (always reviewed, 11 examples)Hiding a symptom while leaving its true cause unfixed. Smells here are special cases (string matching and regex are especially bad), many-branched conditionals acquiring _yet another_ branch. A bug isn't a problem to fix, it is useful evidence that the system we have built is flawed.+- **Credential handle prefix:** The prompt lists shared credentials as `service_gitlab`, and `execute.credentials` takes that name, but the credential broker matches the bare slug `gitlab` and answers the prefixed name with `403 not_entitled`. QM read that as a missing grant. The proposed fix stripped a leading `service_` in the broker, so both spellings would work. That teaches one more caller to tolerate two names instead of removing the second name: a credential should have one name across the prompt, `execute.credentials`, and the broker. (2026-10-13)- **Slack task completion:** A proposed acknowledgment fix reconstructed completion from descendant runs, mailbox returns, the latest conversation turn, and delivery-key prefixes. Core needed to own request completion through delegation and final delivery, then expose that state to Slack; moving the same guesses into a helper would not fix the missing ownership. [qm#2135](https://github.com/yc-software/qm/pull/2135).- **Transcript row grouping:** A proposed UI fix joined adjacent assistant rows only when the second contained subagent activity. Multiple commentary messages, intervening tools, and resumed turns defeated the special case. Grouping events by their actual turn/run identity would give streaming and reloaded history the same response structure. [qm#2136](https://github.com/yc-software/qm/pull/2136).- **Credential capture:** Indiscriminate credential collection swept up oversized browser profiles. The proposed fix recognized browser-profile marker files and skipped those directories, adding another exception to the sweep. The deeper fix was to let the agent identify which credential files to preserve, or explicitly request capture of changes from an authentication turn. [qm#2137](https://github.com/yc-software/qm/pull/2137).