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 optionDescription
technicalEligibilityPass/fail gate with blockers and a percentage.
retrievalAlignmentStructural, topical, and query-alignment measurements.
citationFitnessDirectness, grounding, relevance, freshness, and conditional gates.
provenanceAuthorship 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.