docs(config): stop the workshop block documenting things that are not true

Three lies in one comment block, all the same family the tool sweep just
closed:

- `raw = true` was documented as a per-call bypass for output routing. It is
  not. The adaptive router takes it as `_raw_bypass` and ignores it; it is
  honoured only under the legacy CODEWHALE_CLASSIC_OUTPUT_ROUTING switch, and
  no tool advertises it. A user setting it got routing anyway, silently.
- The per-tool override example keys off `exec_shell`, `grep_files`, and
  `web_search`, all retired. An override written from this example matches
  nothing and does nothing, with no error.

Names the live tools instead and says plainly that the escape hatch is not
one. `raw` itself is left alone pending a decision on whether it should exist.
This commit is contained in:
Hmbown
2026-08-04 04:38:50 -07:00
parent d3eeb48ad2
commit 08fcefcc0a

View File

@@ -1052,17 +1052,21 @@ exponential_base = 2.0
# the raw text is stored in the workshop variable `last_tool_result` so the
# parent can call `promote_to_context` later if it needs the full content.
#
# Per-tool overrides let high-volume tools (e.g. exec_shell) use tighter
# thresholds without changing the global default.
# Per-tool overrides let high-volume tools (e.g. Bash) use tighter
# thresholds without changing the global default. Name tools by the identifiers
# the model actually sees — `exec_shell`, `grep_files`, and `web_search` were
# retired and an override keyed to them matches nothing.
#
# Add `raw = true` to any tool call to bypass routing for that invocation.
# There is no per-call `raw = true` escape. It was documented here, but
# `raw = true` on a tool call does NOT bypass routing: the adaptive router
# ignores it, and it is honoured only under the legacy
# `CODEWHALE_CLASSIC_OUTPUT_ROUTING` switch. No tool advertises it.
#
# [workshop]
# large_output_threshold_tokens = 4096
# [workshop.per_tool_thresholds]
# exec_shell = 2048 # shell output synthesised aggressively
# grep_files = 2048
# web_search = 8192 # web results can be large; give them more room
# Bash = 2048 # shell output synthesised aggressively
# Web = 8192 # web results can be large; give them more room
# ─────────────────────────────────────────────────────────────────────────────────
# Harness Profiles (preview schema; runtime consumption follows later)