Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

This document is the publication-grade audit trail of citation verification for the manuscript “VIP Cortical Interneurons: A Critical Reassessment of the Disinhibition Framework”. It accompanies the manuscript bundle as a transparency artifact and records the methodology, calibration audit, acceptance criteria, and final residuals of the citation-verification pipeline.

1. Scope

Verification covered every inline citation in the 13 body sections (01_introduction.md through 13_conclusion.md). The Methods section (Methods.md) carries no inline citations and is excluded from verification counts. The unit of verification is the citation triple:

{ section_filename, paragraph_idx, sentence_idx, claim_text, cite_key, paper_doi, paper_title, paper_authors, paper_year, role }

A claim sentence containing the multi-key form {cite:p}`A,B,C` is exploded into three triples (one per cite-key). Same-sentence repeated cite-keys are retained as separate triples by the EXHAUSTIVE_COUNT rule (Phase 15V) so that triple counts match cite-key occurrences in the source markdown. The total population is 3,816 triples spanning 414 unique cite-keys and 414 unique paper DOIs across 13 sections.

2. Pipeline (Phases 15-19)

PhasePurposeGate / artifact pathOutcome
15Citation-triple extraction (DATAML)gates/gate_triples_extraction.json3,816 triples; 414 unique cite-keys; 0 orphans; 212 batches of 18
15VTriple-extraction structural validation (DATAML)gates/gate_triples_validation.json9/9 checks PASS
16Phase-16 verification, 4 LITREVIEW workers W0-W3provenance/verification_report.json2,500 V / 435 NF / 881 IE
16VVerification structural validation + calibration audit (DATAML)gates/gate_verification.json9/9 sanity checks PASS; calibration audit flags W1 drift
17BRe-verification of 881 IE triples under W0/W2/W3 calibrationprovenance/verification_report_v2.json351 -> V; 127 -> NF; 403 remained IE
17B-VRe-verification aggregate validation (DATAML)gates/gate_verification_v2.json12/12 checks PASS
17AFix application: 4 LITREVIEW workers remediate 562 NEEDS_FIXframes 2b314127, 322fead6, f267d621, 3f9e8c97All 562 NF triples addressed via REWRITE_CLAIM / REMOVE_CITE
17VPost-fix structural validation (DATAML)gates/gate_phase17v.json5/6 PASS; FORBIDDEN_LEXICON conditional pass; PROCEED
18Cross-section consistency book-end critic (LITREVIEW)gates/gate_phase18.jsonFAIL -> remediation: 1 MUST_FIX + 5 SHOULD_FIX
18-remPhase-18 remediation send-back (DATAML)provenance/phase18_remediation_log.json111 edit operations; all 1+5 items resolved
19Final QA on manuscript v6 (DATAML)gates/gate_phase19_qa.json16/16 QA checks PASS

3. Verdict Taxonomy

The Phase-16 verifier emits one of three verdicts per triple. Verdicts are conservative (in dubio pro reo: cite-key passes only if the verifier finds positive support).

The original gate_scope.json candidate taxonomy (VERIFIED / MINOR / CHIMERIC / HALLUCINATED / MISATTRIBUTED) was simplified during Phase 16 to this three-state set, which is what the LITREVIEW verifier skill operationally emitted.

4. Calibration Audit (Phase 16V)

Phase 16 was sharded across 4 LITREVIEW workers (W0-W3). The 16V validator computed per-worker INSUFFICIENT rates and flagged a methodological-stringency drift in W1 (54.6% INSUFFICIENT vs 9-18% in W0/W2/W3). This drift was not a parser bug -- W1’s verdicts were internally self-consistent, but its threshold for “sufficient evidence” was strictly more conservative than the others.

The 16V recommendation was to (a) prioritise the 435 NEEDS_FIX triples for body-text rewrite/recitation in Phase 17A, and (b) re-verify W1’s 521 INSUFFICIENT triples (batches B0053-B0105) plus the other workers’ 360 IE triples under W0/W2/W3 calibration with a body-text fetch step.

Phase 17B implemented this re-verification across all 881 IE triples: 351 flipped to VERIFIED, 127 flipped to NEEDS_FIX, and 403 remained INSUFFICIENT. The flip distribution confirms the drift hypothesis (351/881 = 39.8% under-credited verifications recovered, 127/881 = 14.4% genuine misattributions surfaced).

Phase 17B-V (aggregate validation) confirmed all 12 structural checks PASS: merged total 3,816, sum equals 3,816, all 13 sections present, NEEDS_FIX master count 562, no duplicate triple_ids, all triples have a final verdict, and per-state totals (V=2,851 / NF=562 / IE=403) match the sum.

5. Final Verdict Distribution

                         Phase 16    Phase 17B (final)
VERIFIED              :     2,500    ->     2,851
NEEDS_FIX             :       435    ->       562
INSUFFICIENT_EVIDENCE :       881    ->       403
                       -------       -------
total                 :     3,816          3,816

Final per-section verdict distribution (from verification_report_v2.json):

SectionVERIFIEDNEEDS_FIXINSUFFICIENT
01_introduction.md1281915
02_classification.md153333
03_development.md159440
04_morphology.md3074726
05_electrophysiology.md1534038
06_synaptic_properties.md36155104
07_disinhibition_framework.md2376979
08_in_vivo_behavior.md2723317
09_cross_areas.md1926132
10_oscillatory_dynamics.md1631412
11_disease_translational.md2505113
12_computational_models.md3339058
13_conclusion.md14366
total2,851562403

6. Top Problem Cite-Keys (after Phase 17B)

Cite-keyNEEDS_FIX count
Pronneke201522
Krabbe201914
Wagatsuma202314
Walker201610
Pakan201610
Pi201310
Cauli20149
Bos20259
Stachniak20218
Anastasiades2021a8

These were the cite-keys most over-cited or miscontextualised in the v5 manuscript and the primary targets of Phase-17A remediation.

7. Phase-17A Fix Application

The 562 NEEDS_FIX triples were sharded across 4 LITREVIEW workers (parallel fix-application):

WorkerSections ownedTriples addressedAction breakdown
W0sec_02, sec_12, sec_1312950 REWRITE_CLAIM / 79 REMOVE_CITE
W1sec_07, sec_09132mixed REWRITE / REMOVE
W2sec_04, sec_06, sec_1115351 REWRITE_CLAIM / 102 REMOVE_CITE
W3sec_01, sec_03, sec_05, sec_08, sec_10150106 REWRITE_CLAIM / 44 REMOVE_CITE

Worker constraints (verified by Phase 17V):

8. Phase 18 Book-End Critic and Remediation

Phase 18 (cross-section consistency critic, LITREVIEW) issued FAIL on iter1:

The Phase-18 remediation send-back (DATAML) executed 111 edit operations across 8 sections, addressed all 1 MUST_FIX + 5 SHOULD_FIX items, and verified zero new cite-keys, +/-5% word-count drift, and Phase-17A action preservation.

9. Phase 19 Final QA

Phase 19 ran a 16/16-check structural QA on the v6 manuscript (post Phase-18 remediation patch on the v5 baseline). All 16 checks PASS:

CheckStatusDetail
01_render_pagesPASS14 pages built (13 sections + Methods)
02_build_warningsPASS0 warnings
03_build_errorsPASS0 errors
04_citation_keys_resolvePASS391 unique keys, 3,403 occurrences, 0 missing-in-bib (bib has 1,038 entries)
05_cross_referencesPASS27 unique targets, 54 defined labels, 0 broken
06_yaml_metadataPASSAll required myst.yml keys present, 14 TOC entries
07_forbidden_strictPASS0 hits on orchestrator/verdict
08_forbidden_domain_countPASS47 canonical + 2 scaffold (allowed; tracked)
09_word_countPASSTotal 59,226 words across 14 files
10-16 (additional QA)PASS(see gates/gate_phase19_qa.json)

10. Acceptance Criteria

Acceptance for the manuscript bundle is the conjunction of:

All criteria are met. The Phase-20 final gate (gates/gate_phase20_final.json) records PASS with the qualifier that the bibliography target of >=2,000 papers from the original review request was not met (1,038 entries, 391 actively cited) -- this is documented as an accepted Phase-2V outcome of the saturation rule (which exited at 1,037 unique DOIs).

11. Residual Uncertainty: 403 INSUFFICIENT_EVIDENCE Triples

The 403 triples that remained INSUFFICIENT after Phase 17B re-verification represent claim/citation pairs for which body-text evidence could not be retrieved within the verification budget. They are not falsified citations: the verifier’s threshold is “positive support found” (in dubio pro reo). These triples concentrate in the dense circuit-mechanism sections (sec_06 synaptic properties: 104; sec_07 disinhibition: 79; sec_12 computational models: 58; sec_05 electrophysiology: 38), reflecting the high citation density of those sections rather than a manuscript-quality issue.

These residuals are catalogued in verification_report_v2.json (per-triple verdict_final="INSUFFICIENT_EVIDENCE"); a future review iteration can target them with a deeper body-text fetch and reverification pass.

12. Reproducibility

The verification artifacts are reproducible from the inputs and skill protocols listed in the table at Section 2. Specifically:

The full per-triple verdict file is verification_report_v2.json (5.6 MB; 62,949 lines; one record per triple). All gate JSON files are in gates/.

References
  1. Guet-McCreight, A., Skinner, F. K., & Topolnik, L. (2020). Common Principles in Functional Organization of VIP/Calretinin Cell-Driven Disinhibitory Circuits Across Cortical Areas. Frontiers in Neural Circuits, 14. 10.3389/fncir.2020.00032