docs: close the seventh audit's verified findings

[khushalsonawat]

What

Closes the five actionable findings from the seventh docs audit, every one verified against product source before a page changed.

• Mermaid diagram source now survives into llms-full.txt as fenced blocks (51 diagrams across 47 pages were stripped with the JSX)
• sdk/simulate rewritten around the SDK's single dual-mode run_test(): cloud args and local LiveKit args dispatch differently and never combine; the examples had been mixing them, which silently dropped parameters
• Guardrail status codes aligned with the gateway across 8 pages: block returns 403 with a guardrail_error/content_blocked body; warn and log return 200 plus the x-agentcc-guardrail-triggered header. The 446/246 convention never shipped
• Warnings on the caching and guardrails pages: an exact cache hit skips request-side guardrail screening; response-side checks still run
• Experiment is no longer presented as a product; those signals flow into Evaluate

Why

An independent 742-page audit surfaced five claims that break working code or misrepresent the product. Verification confirmed three fully, narrowed one (cache bypass is input-side only), and disproved parts of another (446/246 exist only in dead code and an unwired client SDK).

What cases were covered

• run_test verified against the released agent-simulate 0.1.3 wheel and its dispatch logic, not just repo source; the reference page checked out fully and was left untouched
• Status codes traced to the gateway's error construction and header-setting call sites; Protect's SDK path confirmed to return plain 200s
• Cache short-circuit traced through the plugin pipeline, including the post-stage skip list
• Mermaid conversion tested against the corpus: 51 of 51 components convert
• Four product bugs found during verification were filed separately, not papered over in docs

How

Four source-verification agents (simulate SDK, gateway pipeline, status codes, product framing) plus an extractor change, each landing the smallest edit that resolves its finding.

Recording

Not applicable: text and export changes only.

🤖 Generated with Claude Code