validate-bib

Validate Bibliography

Cross-reference all citations in lecture files against bibliography entries.

Steps

1. Read the bibliography file and extract all citation keys

2. Scan all document files for citation keys:

   • .tex files: look for \cite{, \citet{, \citep{, \citeauthor{, \citeyear{
   • .qmd files: look for @key, [@key], [@key1; @key2]
   • .typ files: look for @key references (Typst uses @key syntax, no \citet/\citep distinction)
   • Also check for #bibliography("refs.bib") or #bibliography("refs.yml") (Hayagriva format) in .typ files
   • Note: some Typst projects use inline links instead of bibliography — detect and report
   • Extract all unique citation keys used

3. Cross-reference:

   • Missing entries: Citations used in lectures but NOT in bibliography
   • Unused entries: Entries in bibliography not cited anywhere
   • Potential typos: Similar-but-not-matching keys

4. Check entry quality for each bib entry:

   • Required fields present (author, title, year, journal/booktitle)
   • Author field properly formatted
   • Year is reasonable
   • No malformed characters or encoding issues

5. Report findings:

   • List of missing bibliography entries (CRITICAL)
   • List of unused entries (informational)
   • List of potential typos in citation keys
   • List of quality issues

Files to scan

All .tex, .qmd, and .typ files in the project.

Bibliography location

Whatever the documents reference: \bibliography{} / \addbibresource{}, bibliography: in Quarto YAML, or #bibliography(...) in Typst. If nothing is referenced and several .bib/.yml files exist, ask which one.