verify_citation

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"
+}