validate-bib

name	validate-bib
description	Validate bibliography entries against citations in all document files (.tex, .qmd, .typ). Find missing entries and unused references.
allowed-tools	["Read","Grep","Glob"]

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:

Slides/*.tex
Quarto/*.qmd
**/*.typ

Bibliography location:

Bibliography_base.bib  (repo root)