Documentation
Report schema
The fields in a JSON report, from overall scores to individual findings and their evidence.
Jeff Patterson / Agency Enterprise. Updated August 30, 2026.
Top-level result
{
"schemaVersion": 2,
"url": "https://example.com",
"overallScore": 68,
"grade": "D+",
"stages": { "technicalEligibility": {}, "retrievalAlignment": {} },
"categories": {},
"recommendations": [],
"rawData": {}
}Pipeline stages
| Field or option | Description |
|---|---|
technicalEligibility | Pass/fail gate with blockers and a percentage. |
retrievalAlignment | Structural, topical, and query-alignment measurements. |
citationFitness | Directness, grounding, relevance, freshness, and conditional gates. |
provenance | Authorship and organization-identity hygiene. |
Factor records
Each factor includes a name, score, maximum score, observed value, status, evidence tier, and paper citation identifiers. Diagnostics show 0/0 points and stay outside score denominators.
Recommendations
Each recommendation includes its category, factor, current value, priority, auditPoints, evidence, and citations. It may also include a direction, steps, code example, or link. auditPoints are internal weights, not additive citation gains.