Validate Bib

---
name: validate-bib
description: Validate bibliography entries against citations in all lecture files. 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 deck files for citation keys:**
   - `.qmd` files: look for `@key`, `[@key]`, `[@key1; @key2]`
   - 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:
```
Quarto/*/*.qmd                    # decks are one level down, under their genre
Quarto/lectures/_series/*/*.qmd   # shared include slides, rendered into series decks
```
(`python3 scripts/deckpath.py --list` names every deck.)

## Bibliography location:
```
Bibliography_base.bib  (repo root)
```