# 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

```bash
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.