Reports citations into docs/adr/ that no longer point at the text they were
written against.
Records cite each other by path and line - docs/adr/0002-...md:4108, then
`:4121-4122` for the same file - and the plans and CLAUDE.md cite the
records the same way. An insert or a re-wrap above a cited line moves it, and
the citing document, untouched on main, silently points at different text.
This task is the check for that; the reasoning, the documents it scans and
the three layers it runs are in Mix.StatifierBlocks.AdrCites.
It runs as the ADR cites custom stage of mix quality, so the drift is a
named gate failure rather than something review has to catch.
Usage
mix adr.cites
mix adr.cites --format json
mix adr.cites --updateOptions
--format json- print the ExQuality finding contract instead of prose--update- rewritedocs/adr/.cite-baseline.jsonfrom the current tree
--update is what a request that legitimately moves a cited line runs, in
that same request, so the move is reviewed as a diff of the recorded text
rather than discovered by the next record to be edited.
Exit status is 0 when nothing failed and 1 when something did. Advisory findings - an unanchored paragraph, a citation the baseline has not yet seen
- are reported and do not change the status.