test(docs): CLI.md context/audit --quick section headers checked against real re-runs

[carlos-alm]

Problem

#2212 extended docs-drift protection to `docs/examples/CLI.md` with two tiers (static command/flag validity, and representative real execution), but neither verifies that a documented example's output content/shape still matches what the command actually produces — only that it's syntactically valid and doesn't crash.

Fix

Added a Tier 3, deliberately scoped to just the two commands whose documented output already uses clear `## Section` markdown-style headers (`context`, `audit --quick`), per the issue's own suggested starting point:

• Extract every `## Section Name` header from a block of text, normalizing away a trailing dynamic count (`## Callers (3)` → `## Callers`) — otherwise these are pure static labels, unlike the H1 title line (`# () — :`), which fully embeds dynamic content and would need real normalization rules to compare fairly (deliberately left out of scope — see below).
• Find the documented output block immediately following a specific ```bash ``` block in CLI.md.
• Run the real command against a small fixture graph (reusing the existing Tier 2 fixture, extended with one internal/non-exported symbol so `audit --quick` produces a real `## Internal` section) and compare header lists.

Real bug caught during development: the documented `context` example was missing two sections that exist in the current CLI (`## Children`, `## Complexity`) and had stale names for two others (`## Dependencies` → `## Direct Dependencies (N)`, `## Callers` → `## Callers (N)`). Fixed in this same PR, mirroring #2212's own precedent of fixing what its own new check finds. `audit --quick`'s documented headers already matched exactly — no doc change needed there.

Deliberately out of scope

• Full output-content diffing (file paths, line numbers, source snippets, dependency-list contents) — needs real dynamic-content normalization rules and a strictness-level decision, explicitly flagged in the issue as "the harder half," not decided unilaterally here.
• MCP.md's equivalent (tool-call response shape vs. a real MCP server call) — entirely different mechanics (needs standing up/driving an MCP server, not just `execFileSync`), filed as follow-up: MCP.md tool-call output structural comparison (entirely unaddressed) #2509.

Closes #2369

Test plan

• New tests pass against the current (now-fixed) CLI.md content
• Verified by hand that the old `## Dependencies`/`## Callers` (no count) headers would have failed against real current output before the doc fix
• Full `vitest run` suite (5285 passed, 328 files) after rebuilding the native addon (stale in the fresh worktree, unrelated to this change)
• `tsc --noEmit`, `biome check` clean
• TS-only test/docs change — no Rust files touched

[greptile-apps]

Greptile Summary

The PR adds a third tier of CLI documentation-drift coverage that reruns context and audit --quick, normalizes their section counts, and compares the resulting section labels with documented examples.

• Updates the context example with current Children, Complexity, Direct Dependencies, and Callers sections.
• Shares and extends the CLI fixture with an internal symbol required to exercise audit --quick.
• Adds helpers and integration tests for extracting and comparing documented versus live section headers.

Confidence Score: 5/5

The PR appears safe to merge, with no actionable correctness or security issues identified.

The updated examples match the section conditions exercised by the fixture, and the new tests consistently compare the intended documented and live CLI output shapes.

Important Files Changed

Filename	Overview
docs/examples/CLI.md	Refreshes the documented context output sections and labels to match the current CLI shape.
tests/integration/docs-examples-cli-drift.test.ts	Adds focused structural-output drift tests using a representative WASM-built fixture and normalized section-header comparisons.

_{Reviews (1): Last reviewed commit: "test(docs): cli.md context/audit --quick..." | Re-trigger Greptile}