feat(seo-data): W1 — surface rich_results, the data inspect already threw away

google_seo.py:129 read only indexStatusResult out of the URL Inspection
response and discarded the rest. richResultsResult was already on the wire:
same call, same OAuth scope (webmasters.readonly), same quota. Google's own
structured-data verdict on the live indexed URL was being downloaded and
binned.

Plan correction: the TODO said "richresults verb". Wrong — a new verb means
a second POST to the same endpoint for a payload already received, on a
per-site quota, and nobody wants rich results without index status. Extended
inspect() instead; fetch.sh unchanged, no new verb, no new scope.

Design driven by the published schema, not by guesswork — two details I
would have got wrong:
- richResultsResult is OMITTED when Google detects none ("absent if none
  found"). Surfaced as synthetic verdict ABSENT rather than a missing key: a
  caller cannot tell an absent key from a check that never ran. ABSENT means
  "none detected", never "invalid". The KeyError path is the real risk here,
  so it has its own fixture dir (fixtures-norich/) and its own tests.
- PARTIAL is "Reserved, unused" per the API docs. The draft emitted it. It
  never emits it now, and a test asserts the absence.

issues[] deduped (the same issueMessage repeats across every affected item),
errors/warnings count instances — scale from the counter, cause from the
message.

seo-analyzer STEP 4 consumes it as the system's only programmatic JSON-LD
validation, bounded honestly: index:inspect is per-URL, quota'd, and needs a
verified property, so its reach is the STEP 9 COVERAGE ratio, not the site.
Replacing a fake validator with a fake coverage promise would be no better.

This is what beats claude-seo: their README's "dual validator (Rich Results
Test + Schema Markup Validator)" is two hyperlinks a human clicks — grep of
their .py finds zero calls. This is Google's verdict, via auth already held.

Note: the new dedupe assertion trips SC2015 (A && B || C), same as the
pre-existing line 27; ok() ends on an assignment so it cannot fail. Kept for
house-style consistency — lib/seo-data/*.sh is outside the lib/*.sh
shellcheck glob anyway.

Verified: seo-data 85 -> 95 pass, 0 fail; both paths exercised end-to-end
and output inspected by hand; make test 35 GREEN / 0 RED; py_compile clean.

agents/seo-analyzer.md

@@ -339,6 +339,35 @@ and 10 AND high impressions (candidates to push onto page 1 with a
 title/meta/content tweak). Report index coverage from `inspect`. All
 emitted into SEO.md §2 (technical) and §8 (quick wins).
 
+**`inspect` also returns `rich_results` — Google's own structured-data
+verdict on the live indexed URL.** It rides the same response (no extra
+call, no extra quota). This is the only programmatic JSON-LD validation in
+the system; everything else about schema is read by eye.
+
+```
+rich_results.verdict : PASS | FAIL | NEUTRAL | VERDICT_UNSPECIFIED | ABSENT
+rich_results.types[] : {type, items, errors, warnings, issues[]}
+```
+
+- `FAIL` + a type carrying `errors > 0` → that type **cannot show as a rich
+  result**. Bundle item, cite the `issues[]` message verbatim — it is
+  Google's wording, not ours, and geo-analyzer owns the JSON-LD fix
+  (CROSS-AGENT NOTE).
+- `warnings` → recommended fields missing. Report, do not gate on them.
+- **`ABSENT` means Google detected no rich results on this URL** — the key
+  is omitted upstream when nothing is found. It is NOT an error and NOT
+  proof the markup is broken: a page with no structured data reads the same
+  as one whose markup Google never parsed. Say "none detected", never
+  "invalid".
+- `ABSENT` while the repo clearly ships JSON-LD → real finding: the markup
+  is not reaching Google (SPA-rendered, blocked, or malformed). Cross-check
+  before claiming it.
+
+**Bound this honestly.** `index:inspect` is per-URL, quota'd, and works only
+on a GSC-verified property. It validates the URLs you sampled — not the
+site. Its reach is the STEP 9 COVERAGE ratio, and §14 must say so rather
+than let one PASS imply site-wide valid markup.
+
 If `status=degraded` → note it in §2 and emit the §11 user action
 "Connecter GSC: `make seo-connect`".