[hmziqagent]

Summary

All 20 Starlight pages under web/src/content/docs/docs/ were audited against the current crate source (crates/**, crate Cargo.tomls, README, CHANGELOG) and brought back in sync. 80 stale claims were found; all 80 are fixed here.

The audit ran as a multi-agent pass: one blind auditor per docs section, every finding re-verified by an independent second checker that read the cited doc and source lines itself (0 of 80 failed that check), fixes applied per section, the site build gating each round, and fresh cold re-audits after each fix round.

What was wrong

• Code samples that do not compile against 0.3: positional use_query(key, cache_policy, request_policy, fetcher, cx) and bare use_mutation(cx) calls, QueryClient::new(cache_policy, request_policy) (real form: new() + with_policies), client.force_fetch_query(...) (only exists in the excluded legacy crate)
• Legacy-only APIs documented as current: display_data(), placeholder_data() / initial_data() and their setters
• The DevTools page documented QueryDiagnostic / ClientDiagnostic with almost entirely wrong fields, so every example on it failed to compile
• Wrong versions and missing surface: the skills page said the packs track v0.2.0 (they are on 0.3.0), the API reference omitted use_query_with_policy / fetch_query_with_policy and (persist) markers on three rows, and the serializer registry was described as (T, E)-keyed when it is keyed on T alone
• Semantics: Cancelled vs superseded requests, observer re-render conditions (status or data-epoch change, not any state change), is_page_data_valid() false cases missing LoadingEmpty, on_error firing on cancel/reset/drop and not only after exhausted retries, and Force mode only applying to a fetch from Idle

Verification

• bun run build in web/ (og images, astro build, pagefind, llms.txt, page alternates) passes on this branch
• Every finding carries doc path:line and source path:line evidence and was reproduced by a second checker before fixing
• Not covered: runtime behavior of documented APIs (no example was compiled or executed beyond the mdx build itself)

Also updates PERSIST_VERSION 1 to 2 in skills/gpui-query-extensions/SKILL.md to match client/persist.rs, and adds out/ + mutants.out/ to .gitignore.