Audit comment standardization + new tool (2026-10-19)
Standardized all 18 top-level projects to canonical audit comment format:
; CPU:$XXXX PRG:XXXX AA BB
Changes per project:
- CIRCUS: fixed 4,427 comments (CPU:XXXX -> CPU:$XXXX)
- Excitebike (JU): fixed 48 double-semicolon comments (; state $XX ; CPU:...)
- 9 projects received canonical comments via new audit_comment_tool.py:
Balloon Fight, Baseball, Bomberman, Burger Time, Clu Clu Land,
Defender 2, Donkey Kong 3, Donkey Kong Jr., Tennis
New tool: _tools/audit_comment_tool.py
- Uses nesdis.py tracer as ground truth for instruction bytes/addresses
- Parses source while tracking PRG offset, emits canonical comments
- Handles .byte/.word/.dword directives, instruction comments (short format)
- Carves PRG from rom.nes when prg.bin missing
Documentation updates:
- TODO.md: Updated current state, item 3 (tool built), repo conventions, tool list
- AGENTS.md: Added audit_comment_tool.py to _tools/, updated audit convention
Verification: verify_pass1.py reports all 18 projects byte-identical with 'canoni' format.
tmerritt
2ddaf102a0