verify_citation

Added value: +{
+  "description": "URL the link ended at after redirects. Present only when it differs from the input URL.",
+  "type": "string"
+}

Previous value: -"Live HTTP status for a URL input (0 = unreachable)."New value: +"Live HTTP status for a URL input (0 = no HTTP response; see linkFailure)."

Added value: +{
+  "description": "Why no HTTP response arrived (httpStatus 0). dns_failure means the host does not resolve (dead); the others may be temporary.",
+  "enum": [
+    "dns_failure",
+    "timeout",
+    "connection_reset",
+    "connection_refused",
+    "tls_error",
+    "ssrf_blocked",
+    "other"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Link-check result. live = resolved on the requested page (the only outcome that confirms existence); dead = HTTP error or DNS failure (evidence of absence); blocked = 403/429/503, the server refused the check so existence is unknown; redirected_to_root = a deep URL ended at a site root or generic landing page (page likely removed); unreachable = no HTTP response (timeout, reset, refused, TLS), which may be temporary. Only live gives verificationStatus confirmed; blocked, redirected_to_root and unreachable give uncertain.",
+  "enum": [
+    "live",
+    "dead",
+    "blocked",
+    "redirected_to_root",
+    "unreachable"
+  ],
+  "type": "string"
+}

Previous value: -"The academic record the citation matched (title, authors, year, DOI, …), present only when verificationStatus is \"confirmed\". A medium/low-confidence free-text candidate is never attached here — see possibleMatch."New value: +"The academic record the citation matched (title, authors, year, DOI, …), present when the DOI/URL resolved to an exact record or a free-text match is high confidence (so it can accompany a title_mismatch). A medium/low-confidence free-text candidate is never attached here — see possibleMatch."

Added value: +{
+  "description": "Always present. \"clear\" = Crossref answered and lists no retraction/correction/concern notice; \"retracted\" = a retraction notice exists; \"flagged\" = a correction or expression of concern (see retractionStatus.kind); \"unchecked\" = NO integrity information, never read it as clear (see retractionCheckReason). For a free-text reference it describes the matched or possible record's DOI.",
+  "enum": [
+    "clear",
+    "retracted",
+    "flagged",
+    "unchecked"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Present only when retractionCheck is \"unchecked\": lookup_error = Crossref call failed; not_in_crossref = Crossref has no record of this DOI (e.g. arXiv/DataCite); not_a_doi = the input had no DOI to look up; resolver_unavailable = no retraction resolver is configured.",
+  "enum": [
+    "lookup_error",
+    "not_in_crossref",
+    "not_a_doi",
+    "resolver_unavailable"
+  ],
+  "type": "string"
+}

Previous value: -"Crossref integrity status when the DOI is retracted/corrected; omitted when clean."New value: +"Crossref integrity status when the DOI is retracted/corrected/under an expression of concern; omitted when clean OR when the lookup did not run. Use retractionCheck to tell those apart."

Previous value: -"Whether a title (text supplied alongside a DOI, or a scholarly page's own title for a URL input) matches the matched record's actual title (token-overlap heuristic). 'match' = strong overlap; 'mismatch' = ≥2 substantive title tokens that are absent from the record title — possibly the wrong paper; 'not_checked' = no title text or single-token ambiguous text (not enough to judge). Present only when a record was matched by exact DOI (DOI inputs, or URL inputs resolving to a scholarly DOI)."New value: +"Whether a title (text supplied alongside a DOI, or a scholarly page's own title for a URL input) matches the matched record's actual title (token-overlap heuristic). 'match' = strong overlap; 'mismatch' = the supplied title clearly diverges (≥2 substantive tokens, most of the title, absent from the record; case, punctuation, diacritics and a dropped subtitle are ignored) — possibly the wrong paper, and for a DOI input verificationStatus becomes \"uncertain\" with verificationReason \"title_mismatch\" (a translated title can trigger this); 'not_checked' = no title text or single-token ambiguous text (not enough to judge). Present only when a record was matched by exact DOI (DOI inputs, or URL inputs resolving to a scholarly DOI)."

Added value: +{
+  "description": "Why verificationStatus is \"uncertain\" when the DOI itself resolved: \"title_mismatch\" = the title supplied alongside the DOI does not match the DOI's real title (the DOI exists; the citation may be misattributed). A translated title has little lexical overlap and can trigger this, so compare it to matchedRecord.title yourself. Omitted otherwise.",
+  "enum": [
+    "title_mismatch"
+  ],
+  "type": "string"
+}

Previous value: -"The tri-state companion to exists (#510): \"confirmed\" = exists:true (an authoritative DOI/URL check, or a high-confidence free-text match); \"not_found\" = exists:false with no candidate at all; \"uncertain\" = exists:false but a free-text match DID surface a candidate below the high-confidence bar — see possibleMatch. Check this field, not just exists, before treating a free-text citation as real."New value: +"The tri-state companion to exists (#510): \"confirmed\" = exists:true (an authoritative DOI/URL check, or a high-confidence free-text match); \"not_found\" = exists:false with no candidate at all; \"uncertain\" = either (a) exists:false but a free-text match DID surface a candidate below the high-confidence bar (see possibleMatch), or (b) exists:true for a DOI whose supplied title does not match the record (verificationReason:\"title_mismatch\"). Check verificationReason to tell them apart. For a URL input, \"uncertain\" also covers a link that could not be verified (linkOutcome blocked, redirected_to_root or unreachable), never confirmed. Check this field, not just exists, before treating a free-text citation as real."

Added value: +{
+  "description": "Present only for a DOI input whose verificationStatus is \"confirmed\" but titleMatch is \"not_checked\" (a bare DOI with no title text to compare) — a reminder that existence/retraction were confirmed via DOI record lookup only, with no title/authenticity comparison performed. Pass title text alongside the DOI to enable that check and clear this caveat.",
+  "type": "string"
+}

Added value: +{
+  "description": "Present when claimSupport is source_unavailable because the fetch itself failed (network error, blocked/bot-wall, redirect-cap abort, parse error) — as opposed to no fetch being attempted (no URL/DOI to try). Lets you tell a genuine fetch failure apart from a source that was never reachable.",
+  "type": "string"
+}

Previous value: -"Whether the citation resolved to a real record / live resource. Evidence, not a verdict."New value: +"Whether the citation resolved to a real record / live resource, at high confidence. Evidence, not a verdict. For a free-text reference match (#510), true requires matchConfidence:\"high\" — a medium/low-confidence match is reported as possibleMatch with exists:false and verificationStatus:\"uncertain\" instead, so a fabricated citation coincidentally near a real-but-unrelated paper is never read as confirmed. DOI and URL inputs are unaffected: their existence signal is already authoritative (exact-DOI entity lookup, Crossref, the doi.org handle registry, or link liveness)."

Previous value: -"Confidence the matched record is the cited work (high for an exact DOI; heuristic for free-text)."New value: +"Confidence the matched/possible record is the cited work (high for an exact DOI; heuristic for free-text). For a free-text reference, only \"high\" backs exists:true — \"medium\"/\"low\" describe possibleMatch instead."

Previous value: -"The academic record the citation matched (title, authors, year, DOI, …) when one was found."New value: +"The academic record the citation matched (title, authors, year, DOI, …), present only when verificationStatus is \"confirmed\". A medium/low-confidence free-text candidate is never attached here — see possibleMatch."

Added value: +{
+  "description": "Present only for a free-text reference whose best academic match was medium/low confidence (verificationStatus:\"uncertain\") — the candidate record (title, authors, year, DOI, …) that partially matched, surfaced as evidence for you to judge, NOT confirmation the citation is real. Pair with matchConfidence to see how strong the overlap was.",
+  "type": "object"
+}

Added value: +{
+  "description": "The tri-state companion to exists (#510): \"confirmed\" = exists:true (an authoritative DOI/URL check, or a high-confidence free-text match); \"not_found\" = exists:false with no candidate at all; \"uncertain\" = exists:false but a free-text match DID surface a candidate below the high-confidence bar — see possibleMatch. Check this field, not just exists, before treating a free-text citation as real.",
+  "enum": [
+    "confirmed",
+    "uncertain",
+    "not_found"
+  ],
+  "type": "string"
+}

Previous value: -"Claim-relevant sentences extracted from the source, in document order. Evidence for you to judge direction — not a verdict."New value: +"Claim-relevant sentences extracted from the source, in document order. Evidence for you to judge direction — not a verdict. English-keyword heuristic (#390): an empty/false/absent value on non-English text means the heuristic didn't match, not that the signal is confirmed absent — read the underlying text yourself for non-English sources."

Previous value: -"Present when the author has a detected financial stake in the cited entity. Employment / funding / equity connections that create a conflict. Omitted when no conflict is detected."New value: +"Present when the author has a detected financial stake in the cited entity. Employment / funding / equity connections that create a conflict. Omitted when no conflict is detected. English-keyword heuristic (#390): an empty/false/absent value on non-English text means the heuristic didn't match, not that the signal is confirmed absent — read the underlying text yourself for non-English sources."

Previous value: -"Present (true) when a claim-relevant source sentence carries a negation/contrast cue — the source may REFUTE the claim despite sharing its terms. Read the evidence yourself; this is a heads-up, never a refutes verdict."New value: +"Present (true) when a claim-relevant source sentence carries a negation/contrast cue — the source may REFUTE the claim despite sharing its terms. Read the evidence yourself; this is a heads-up, never a refutes verdict. English-keyword heuristic (#390): an empty/false/absent value on non-English text means the heuristic didn't match, not that the signal is confirmed absent — read the underlying text yourself for non-English sources."

Previous value: -"Optional: the assertion this citation is cited for. When set, the source (live URL or its Internet-Archive snapshot) is fetched and checked for whether it actually addresses the claim — surfacing evidence sentences and flagging mischaracterization (claim absent from the source). Coverage + evidence, never a support/refute verdict. Off unless provided; adds a fetch."New value: +"Optional: the assertion this citation is cited for. When set, the source (live URL or its Internet-Archive snapshot) is fetched and checked for whether it actually addresses the claim — surfacing evidence sentences and flagging mischaracterization (claim absent from the source). Coverage + evidence, never a support/refute verdict. Off unless provided; adds a fetch. Without this parameter, the tool checks existence and retraction only — mischaracterization (whether the source supports what it is cited for) is not checked."

Added value: +{
+  "description": "Present (true) when no `claim` was supplied — existence and retraction were checked, but mischaracterization was not.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Why the claim check was skipped, present alongside claimCheckSkipped.",
+  "type": "string"
+}

Added value: +{
+  "description": "Words in the fetched source content, present alongside sparsityNote when the claim check ran against thin content.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Present when the source fetched for the claim check was thin (< 150 words, e.g. a paywall/bot-wall stub) — claimSupport may not reflect the full document. Annotates claimSupport; never changes its value.",
+  "type": "string"
+}

Added value: +{
+  "description": "Present when the author has a detected financial stake in the cited entity. Employment / funding / equity connections that create a conflict. Omitted when no conflict is detected.",
+  "properties": {
+    "authorAffiliation": {
+      "description": "Company/entity the author is affiliated with",
+      "type": "string"
+    },
+    "citedEntityName": {
+      "description": "Entity mentioned in the citation text",
+      "type": "string"
+    },
+    "confidence": {
+      "description": "Confidence in the detected conflict",
+      "enum": [
+        "high",
+        "medium",
+        "low"
+      ],
+      "type": "string"
+    },
+    "conflictType": {
+      "description": "Type of conflict",
+      "enum": [
+        "employment",
+        "funded_by",
+        "owns_equity"
+      ],
+      "type": "string"
+    },
+    "detected": {
+      "type": "boolean"
+    },
+    "evidence": {
+      "description": "Specific evidence of the conflict",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "For a URL input that resolves to a scholarly article: the DOI extracted from the page (citation_doi meta, the URL path, or references-safe front matter). Lets a URL be checked for retraction and title match like a DOI input. Omitted when no scholarly DOI was found.",
+  "type": "string"
+}

Previous value: -"For DOI inputs only: whether the title text supplied alongside the DOI matches the record's actual title (token-overlap heuristic). 'match' = strong overlap; 'mismatch' = ≥2 substantive title tokens supplied that are absent from the record title — the caller may have the wrong paper; 'not_checked' = bare DOI only or single-token ambiguous text (not enough to judge). Omitted for URL/reference inputs."New value: +"Whether a title (text supplied alongside a DOI, or a scholarly page's own title for a URL input) matches the matched record's actual title (token-overlap heuristic). 'match' = strong overlap; 'mismatch' = ≥2 substantive title tokens that are absent from the record title — possibly the wrong paper; 'not_checked' = no title text or single-token ambiguous text (not enough to judge). Present only when a record was matched by exact DOI (DOI inputs, or URL inputs resolving to a scholarly DOI)."

Added value: +{
+  "description": "Optional: the assertion this citation is cited for. When set, the source (live URL or its Internet-Archive snapshot) is fetched and checked for whether it actually addresses the claim — surfacing evidence sentences and flagging mischaracterization (claim absent from the source). Coverage + evidence, never a support/refute verdict. Off unless provided; adds a fetch.",
+  "type": "string"
+}

Added value: +{
+  "description": "Echoed when a claim was provided.",
+  "type": "string"
+}

Added value: +{
+  "description": "Claim-relevant sentences extracted from the source, in document order. Evidence for you to judge direction — not a verdict.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "The URL actually fetched for the claim check (the live URL, or its Wayback snapshot).",
+  "type": "string"
+}

Added value: +{
+  "description": "Claim COVERAGE (not a support/refute verdict): addressed = strong topical overlap, claim-relevant sentences in claimEvidence; partially_addressed = some overlap, evidence shown but not flagged (ambiguous — you judge); not_addressed = source fetched but addresses none of the claim (mischaracterization); source_unavailable = no fetchable source.",
+  "enum": [
+    "addressed",
+    "partially_addressed",
+    "not_addressed",
+    "source_unavailable"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Present (true) when a claim-relevant source sentence carries a negation/contrast cue — the source may REFUTE the claim despite sharing its terms. Read the evidence yourself; this is a heads-up, never a refutes verdict.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "For DOI inputs only: whether the title text supplied alongside the DOI matches the record's actual title (token-overlap heuristic). 'match' = strong overlap; 'mismatch' = ≥2 substantive title tokens supplied that are absent from the record title — the caller may have the wrong paper; 'not_checked' = bare DOI only or single-token ambiguous text (not enough to judge). Omitted for URL/reference inputs.",
+  "enum": [
+    "match",
+    "mismatch",
+    "not_checked"
+  ],
+  "type": "string"
+}