How Ethos Detects Wrong, Missing, and Stale Citations
Developer Guides

How Does Ethos Detect Wrong, Missing, and Stale AI Citations?

DocuShell TeamJuly 6, 202613 min read

Direct answer

Ethos detects wrong, missing, and stale citations by separating target resolution, evidence matching, fingerprint freshness, and source capability into structured checks. A citation can be Grounded, Mismatch, NotFound, Stale, CapabilityBlocked, unsupported, or erroneous depending on what the verifier can establish.

This taxonomy is more useful than a generic hallucination score. It tells an application whether to regenerate a locator, refresh the source, fix malformed input, obtain stronger parsing, route to review, or block the claim.

The Ethos citation-verification walkthrough explains the complete flow. This article focuses on failure classification.

Verification is a sequence, not one comparison

validate request
  -> check source fingerprint
  -> resolve page / element / span / bbox / table cell
  -> verify source capability
  -> compare quote, value, presence, or structured evidence
  -> compute overall grounding state
  -> derive proof summary

Earlier failures constrain later claims. A stale report cannot become reusable merely because one quotation still matches.

Grounded: the positive state

A supported claim is grounded when the requested target resolves, the required source capability exists, the evidence matches according to the active verification rules, and no report-level invalidator such as a stale fingerprint prevents certification.

Grounded is still a citation-level result. It does not automatically mean:

  • the evidence is relevant to the user’s question;
  • the source is authoritative under business policy;
  • the answer’s synthesis is valid;
  • a calculation is correct;
  • all claims in the answer are covered.

Applications should use the canonical check plus relevance and claim-type policy before release.

Mismatch: the target exists but evidence differs

Mismatch means Ethos found a relevant target but the requested evidence did not match. Common examples include:

  • altered quotation;
  • missing or inserted negation;
  • correct element ID with different text;
  • wrong value at an otherwise valid target;
  • table cell resolves but contains another value;
  • bounding region differs from the requested region under verification rules.
Example Why it is a mismatch
Source says “must not exceed” but citation says “may exceed” Material text difference
Cited cell is FY2024 but claim provides FY2025 value Structured evidence differs
Correct paragraph, wrong amount Locator exists but expected value fails
Similar quote with missing qualifier Exact evidentiary proposition is not satisfied

Do not let fuzzy search silently turn a mismatch into a pass. A correction workflow may suggest another target, but the original citation remains wrong.

NotFound: the target cannot be resolved

NotFound identifies missing evidence targets. Ethos reason codes can distinguish:

  • missing locator;
  • page not found;
  • element not found;
  • span not found;
  • bounding box not found;
  • table not found;
  • table cell not found.

This distinction helps identify the failing subsystem:

NotFound reason Likely cause
Missing locator Generator or request-schema defect
Page not found Page-number convention or stale document
Element not found Parser/index version drift or fabricated ID
Span not found Changed offsets, weak adapter mapping, or fabricated span
Bbox not found Geometry mismatch or invalid region
Table not found Parser did not map intended table or ID drifted
Table cell not found Wrong row/column locator or table structure changed

Unknown evidence IDs must fail closed. They should never be treated as optional citations that the application quietly drops.

Stale: the citation belongs to another source version

When staleness policy requires fingerprint matching, Ethos compares the citation envelope’s document fingerprint with the trusted grounding source fingerprint.

A mismatch sets report-level staleness and prevents all_evidence_grounded from becoming true. Even an otherwise grounded individual check is not reusable while the report fingerprint is stale.

This is important because old and new source versions can contain identical text. Matching words do not prove that the citation was created from the approved version.

The stale RAG citation guide covers source authority and effective-date policy.

CapabilityBlocked: the source cannot prove the request

CapabilityBlocked means the verification request is meaningful, but the grounding source lacks necessary evidence. Examples include:

  • span claim against a source without spans;
  • table-cell claim against flattened text;
  • fingerprint-required policy against a source without fingerprint support;
  • bounding-box claim when coordinate origin is unknown;
  • crop request against a source without crop support.

Capability-blocked is not the same as mismatch. The verifier did not prove that the evidence is wrong; it proved that the available source cannot establish it.

Do not coerce unknown into false certainty. Route capability-blocked claims to stronger parsing, manual review, or a policy-approved lower-confidence path.

Unsupported claim kinds and errors

A verifier should also distinguish unsupported evidence types from operational errors.

  • Unsupported claim kind: the current contract does not know how to verify the requested proposition.
  • Error: processing did not produce a valid evidence result.
  • Invalid request: malformed schema, locator, or configuration prevented verification.

These results should not count as grounded and should not be averaged into a neutral score that appears safe.

Overall certification

The report-level all_evidence_grounded gate is intentionally strict. A request is not certified when:

  • a required check is not grounded;
  • the source fingerprint is stale;
  • a claim kind is unsupported;
  • a check is semantically unverified under the contract;
  • there are no usable supported checks.

An application may derive:

Proof status Meaning
Verified The submitted request is certified by the grounding gate
Partially verified Some grounded checks are reusable, but the request is not certified as submitted
Unverified No check is reusable for proof

The proof summary is a communication layer. The canonical verification report retains the exact failure evidence.

Failure precedence matters

When multiple issues exist, the verifier needs stable precedence. For example, a stale source is a report-level invalidator. A target that cannot be found should not become a text mismatch merely because expected text was supplied.

Stable precedence improves:

  • deterministic CI results;
  • support diagnostics;
  • alert routing;
  • audit explanations;
  • compatibility across adapters;
  • regression testing.

Do not build application logic by parsing human-readable messages. Use structured status and reason fields.

Application response matrix

Ethos result Application action User-facing treatment
Grounded Continue to relevance and claim-type policy Show evidence if claim passes
Mismatch Block or regenerate citation “The cited evidence did not match”
NotFound Block and inspect locator “The cited source location could not be verified”
Stale Refresh source/index and regenerate “The answer used an outdated source version”
CapabilityBlocked Obtain stronger evidence or review “This source cannot prove the requested detail”
Unsupported Change claim contract or review “This evidence type is not currently verifiable”
Error/invalid Retry only if appropriate; fix integration Do not present as a factual result

Avoid showing internal IDs or sensitive diagnostics directly to end users. Preserve them in controlled audit artifacts.

Examples by evidence type

Quote claim

  • element exists and text matches: grounded;
  • element exists and text differs: mismatch;
  • element missing: not found;
  • span required but unavailable: capability blocked.

Table-cell claim

  • table and cell resolve with expected value: grounded;
  • cell resolves with different value: mismatch;
  • table or cell missing: not found;
  • tables unsupported: capability blocked.

Region claim

  • page and bounded geometry resolve: grounded;
  • requested geometry differs materially: mismatch or not found under contract;
  • coordinate origin unknown: capability blocked;
  • page missing: not found.

Fingerprint-pinned request

  • fingerprint matches: continue checks;
  • fingerprint differs: stale;
  • fingerprint required but unavailable: capability limitation or policy failure.

CI fixtures for every state

Build fixtures for:

  1. fully grounded request;
  2. text mismatch;
  3. missing page;
  4. missing element;
  5. missing span capability;
  6. missing table capability;
  7. table-cell mismatch;
  8. stale fingerprint;
  9. missing fingerprint capability;
  10. unknown coordinate origin;
  11. unsupported claim kind;
  12. malformed citation request;
  13. partial report with one reusable check;
  14. stale report containing an otherwise grounded check.

Assert status, reason, report-level certification, proof summary, and release action.

How the taxonomy improves operations

  • Product: safer final, partial, review, and abstention states.
  • Engineering: failures route to parser, generator, adapter, source, or policy owners.
  • QA: exact negative fixtures replace vague score thresholds.
  • Security: unknown IDs and stale sources fail closed.
  • Compliance: reports explain what was and was not proven.
  • Users: evidence warnings are more precise than “AI may be wrong.”

Definitive verdict

Ethos detects wrong, missing, and stale citations by treating them as different evidence failures. Mismatch means evidence differs at a resolved target. NotFound means the locator cannot be resolved. Stale means source identity drifted. CapabilityBlocked means the source cannot prove the request.

Use DocuShell Parse PDF for source-aware evidence, Ethos for structured classification, the RAG citation CI/CD guide for regression coverage, and the DocuShell hallucination index for broader model-risk context.

Primary keyword: Ethos wrong missing stale citations
Optimized meta title: How Ethos Detects Wrong and Stale Citations
Optimized meta description: Learn how Ethos classifies mismatched, missing, stale, unsupported, and capability-blocked AI citations.
Proposed URL slug: how-does-ethos-detect-wrong-missing-and-stale-ai-citations

Frequently Asked Questions

Ethos resolves the submitted target and compares the requested evidence with the trusted source. A text or table-cell difference produces a mismatch rather than a grounded result.
NotFound means the requested page, element, span, region, table, cell, or required locator could not be resolved in the grounding source.
When fingerprint matching is required, Ethos compares the citation fingerprint with the grounding source fingerprint and marks the report stale when they differ.
CapabilityBlocked means the grounding source lacks evidence required for the requested check, such as spans, tables, a fingerprint, or a known coordinate origin.

Free Tool

PDF to JSON

Turn PDFs into structured, source-aware data for RAG, review, and automation.

Try PDF to JSON
Ethos citation statuseswrong AI citationsmissing citationsstale citationssource fingerprintscitation verification
D

DocuShell Team

The DocuShell editorial group writes and maintains guides for everyday PDF workflows, with updates made when tool behavior or documented limits change. See our editorial standards for the process behind each article.

Focus: Ethos verification contracts, document evidence, source fingerprints, and citation failure analysis

Questions or feedback? Get in touch.

Related Articles