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:
- fully grounded request;
- text mismatch;
- missing page;
- missing element;
- missing span capability;
- missing table capability;
- table-cell mismatch;
- stale fingerprint;
- missing fingerprint capability;
- unknown coordinate origin;
- unsupported claim kind;
- malformed citation request;
- partial report with one reusable check;
- 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
Free Tool
PDF to JSON
Turn PDFs into structured, source-aware data for RAG, review, and automation.
Try PDF to JSONDocuShell 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.



