docs(compression): match caveman output mode notes to code - #15297

Summary

• Corrects the caveman output mode and output-styles passages in docs/compression/COMPRESSION_GUIDE.md against open-sse/services/compression/outputMode.ts, open-sse/services/compression/outputStyles/{apply,backCompat,catalog}.ts and open-sse/handlers/chatCore.ts.

• When to use: the guide showed a routing-combo config.auto.outputMode: "caveman" setting. The only .outputMode reads in src/ and open-sse/ are the compression combo's boolean (applyCompressionComboConfig() in open-sse/handlers/chatCore.ts, src/lib/db/compressionCombos.ts:16) and the omniroute_set_compression_engine MCP tool's boolean argument (open-sse/mcp-server/tools/compressionTools.ts:464). The section now shows cavemanOutputMode.enabled together with the master enabled switch it depends on (off by default per types.ts:421-422, checked in chatCore.ts before resolveOutputStyleSelection()), names those two switches, and notes that a non-empty outputStyles selection takes precedence (backCompat.ts:21-23).

• Back-compat: the guide said the mapping to terse-prose is byte-identical to the old injection in every legacy language. Running the legacy applyCavemanOutputMode() side by side with the live resolveOutputStyleSelection() → applyOutputStyles() path for all 12 legacy languages at all 3 levels shows:

  • the marker line differs in every language ([OmniRoute Caveman Output Mode] vs [OmniRoute Output Styles]);
  • the text below it matches in en, pt-BR, es, de, fr, it, ru, id and vi;
  • ja and zh gain one space before the boundaries clause (apply.ts:167 joins the instruction and the boundary block with a space; those two legacy texts have none);
  • hu gets the English text, because CAVEMAN_INSTRUCTION_BY_LANGUAGE has hu (outputMode.ts:42-46) and the terse-prose i18n map (catalog.ts:52-63) leaves it out. A Hungarian user message resolves to hu through resolveOutputStyleLanguage(), so this is reachable.

  The sentence now states that, and that the mapping applies while outputStyles is empty (backCompat.ts:21-27).

• Boundaries: SHARED_BOUNDARIES (outputMode.ts:28-29) lists code blocks, file paths, commands, errors and URLs; identifiers come from the terse-prose and terse-cjk level texts. The "appends the boundaries clause once" sentence also gains the SAFETY_BOUNDARIES clause that less-code and ponytail add (apply.ts:129-139, from fix(compression): honor per-style boundaries and add the ponytail safety carve-out #13938).

• Auto-Clarity: the guide said the content bypass runs whatever the Auto-Clarity Bypass toggle is set to. The bypass runs while the toggle is on (apply.ts:206; on by default per types.ts:466), and turning it off skips the keyword check (from fix(compression): honor the Auto-Clarity toggle on the output-styles path #14551). "How to enable" now points to the toggle's home, the Caveman page's Output Mode card (/dashboard/context/caveman, CavemanContextPageClient.tsx:249-263), and uses the sidebar labels for the Compression Settings page (sections.ts:91-120).

Related Issues

• Related to docs(compression): match output-style injection to code #14589 (the previous pass over this section), fix(compression): honor the Auto-Clarity toggle on the output-styles path #14551 (connected the Auto-Clarity Bypass toggle to the bypass) and fix(compression): honor per-style boundaries and add the ponytail safety carve-out #13938 (added the per-style safety clause).

Validation

• Change type: other (docs only)
• Focused checks: npm run check:docs-all passes, and so does each of its gates run on its own (check:docs-sync, check:docs-frontmatter, check:docs-counts, check:env-doc-sync, check:deprecated-versions, check:doc-links, check:fabricated-docs) plus check:docs-symbols. All of them also pass on the base tip before the edit.
• npm run lint (docs-only change)
• Reconciled with the current active release base (release/v3.8.52 at 5282351, merged into this branch); check:docs-all rerun afterward and passes
• Production-code changes include a new or updated automated test in this PR (docs-only change)
• Behavior claims were checked by running code, not only by reading it: the legacy injector against the live output-styles path (every legacy language at every level), the bypass with Auto-Clarity on, off and unset, and a Hungarian message through resolveOutputStyleLanguage(). A second claim-by-claim pass against the sources tightened four sentences (second commit).

Tests Added Or Updated

• No production code changed.

Coverage Notes

• This PR touches only docs/compression/COMPRESSION_GUIDE.md and its changelog fragment.

Reviewer Notes

• i18n: this PR changes the English guide only; its 66 mirrors wait for the next mirror refresh. The blocking i18n docs drift step (scripts/i18n/check-translation-drift.mjs) lists this guide until that refresh. On the base tip (5282351) it already lists six other core docs: docs/architecture/QUALITY_GATES.md, docs/frameworks/ACP.md, docs/frameworks/AGENT_PROTOCOLS_GUIDE.md, docs/guides/CLI-INTEGRATIONS.md, docs/reference/API_REFERENCE.md and docs/reference/ENVIRONMENT.md.

⚠️ base-red inherited: #15306