← Notes

citesure 0.5.58: pre-submit gate presets

2026-07-23 · SybilGambleyyu

LLM-written bibliographies fail in boring, predictable ways: placeholder DOIs, DOIs buried in url=, missing volumes, ALL-CAPS titles, citation keys that break LaTeX. Live verification catches fabrications and retractions — but only after you pay network latency and only for the keys that still parse.

Serious work needs a single pre-submit command with one exit code: offline floors first, then multi-source verify of what the manuscript actually cites.

The gate

# Opinionated presets (0.5.58+)
citesure gate refs.bib --preset ci                 # offline PR floor
citesure gate refs.bib -m paper.tex --preset arxiv
citesure gate refs.bib -m paper.tex --preset journal -f html -o gate.html

# Or set floors by hand
citesure gate refs.bib --offline --fail-on-warning --min-hard-id-pct 80

What it runs:

  1. Soft-lint — offline shape checks (DOI/ORCID/year/ISBN/title/author/venue/volume/pages/URLs/keys/duplicates).
  2. Health — coverage of hard IDs (DOI/arXiv/PMID/ISBN) with an optional floor.
  3. Promote-ids dry-run — count of buried DOIs/arXiv/PMIDs still sitting in url=/note.
  4. Live verify — Crossref, doi.org, arXiv, PubMed, Europe PMC, DataCite, OpenAlex, CourtListener, … scoped to used keys when manuscripts are provided.

Exit non-zero when any configured floor fails. That is the entire contract for CI.

Why offline first

Most LLM bibliography defects do not need Crossref. Soft-lint catches them in milliseconds, without API rate limits, and works on air-gapped laptops and pre-commit hooks. Network verification is for existence, metadata mismatch, and retractions — the expensive layer.

Evidence (v0.5.58)

Install

pip install https://github.com/SybilGambleyyu/citesure/releases/download/v0.5.58/citesure-0.5.57-py3-none-any.whl
citesure gate refs.bib -m paper.tex --fail-on-warning --min-hard-id-pct 80

Source: github.com/SybilGambleyyu/citesure · Demo: citesure.sybilgambleyyu.workers.dev