cmos/README.md

cmos — Chicago Manual of Style 18 bibliography reformatter

A Python tool that reformats the bibliography section of an English-language markdown draft to CMOS 18th edition, notes-and-bibliography form.

Accuracy-first, iterative, built with a karpathy/autoresearch-style dev loop.

Quick start

uv sync
uv run pytest
uv run cmos format path/to/draft.md > out.md

Layout

• src/cmos/formatter.py — the iterable artifact (edited every loop iteration).
• src/cmos/parser.py — extracts the bibliography section from a draft.
• src/cmos/linter.py — deterministic CMOS 18 rule checks (versioned).
• src/cmos/cli.py — cmos format entry point.
• harness/score.py, harness/diff.py — frozen scoring.
• exemplars/ — TOML test corpus.
• tests/ — pytest suite (linter, parser, formatter, cli).
• rough_drafts/ — user-supplied messy drafts for ad-hoc iteration.
• logs/ — per-run scores, model ids, linter version hashes.