Skip to main content

Verification

Every text unit in Gildea is independently verified against source evidence before being served through the API.

Trust contract

Only verdict=pass data is served. If a text unit fails verification, it’s excluded from API responses. You never see unverified or failed text units. For arguments with mixed results: if 3 or more sibling sentences/claims pass, the review and fail siblings are auto-pruned. This ensures you see the strongest parts of each argument. Thesis and summary text is always served complete — these are the article’s core narrative.

Scoring modes

Text units use two different verification methods:
ModeUsed forMethodScore range
nliClaimsAlignScore NLI entailment0.0–1.0
regressionSentencesBGE-M3 regression scoring0.0–1.0
Scores are method-specific. A 0.74 NLI score and a 0.74 regression score mean different things. Use the verdict as the primary trust signal, not the raw score.

Verification detail levels

Default (compact)

Every text unit includes compact verification:
{
  "verification": {
    "final_verdict": "pass",
    "verification_path": "auto_pass",
    "was_human_reviewed": false,
    "scoring_mode": "nli",
    "primary_score": 0.7421
  }
}

Full detail

Add verification_detail=full for complete metadata:
{
  "verification": {
    "final_verdict": "pass",
    "verification_path": "human_override_pass",
    "was_human_reviewed": true,
    "reason_codes": ["HUMAN_OVERRIDE", "RESCORED_AFTER_EDIT"],
    "scoring_mode": "nli",
    "scoring_method": "alignscore-large-nli-v1-cascade",
    "scoring_components_ran": ["entailment_forward", "contradiction"],
    "scores": {
      "primary_score_name": "entailment_forward",
      "primary_score": 0.7421,
      "entailment_forward": 0.7421,
      "contradiction": 0.0412
    },
    "score_computed": {
      "entailment_forward": true,
      "contradiction": true
    },
    "thresholds": {
      "threshold_set_id": "stage7_policy_2026-02-11",
      "values": {}
    }
  }
}

Verification paths

PathDescription
auto_passPassed automated verification
human_override_passFailed auto but passed human review
auto_pass_sibling_pruneAuto-pruned (3+ siblings passed)