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.
This commit is contained in:
tmerritt committed 2026-10-19 09:07:14 -04:00
1 parent 8f718c0b9b
commit 2ddaf102a0
26 files changed
+83342 -60919

No files matched your search

-425
View File
@@ -1,425 +0,0 @@
al 00FFFA .Label_FFFA
al 00FF74 .Label_FF74
al 00FF69 .Label_FF69
al 00FF67 .Label_FF67
al 00FF57 .Label_FF57
al 00FF50 .Label_FF50
al 00FF4E .Label_FF4E
al 00FF4C .Label_FF4C
al 00FF49 .Label_FF49
al 00FF3E .Label_FF3E
al 00FF2F .Label_FF2F
al 00FF00 .Label_FF00
al 00F942 .Label_F942
al 00F941 .Label_F941
al 00F93C .Label_F93C
al 00F929 .Label_F929
al 00F922 .Label_F922
al 00F914 .Label_F914
al 00F908 .Label_F908
al 00F8EF .Label_F8EF
al 00F8D8 .Label_F8D8
al 00F8C5 .Label_F8C5
al 00F8BC .Label_F8BC
al 00F8C0 .Label_F8C0
al 00F8B2 .Label_F8B2
al 00F8AD .Label_F8AD
al 00F8A2 .Label_F8A2
al 00F8C4 .Label_F8C4
al 00F8DD .Label_F8DD
al 00F89A .Label_F89A
al 00F897 .Label_F897
al 00F894 .Label_F894
al 00F891 .Label_F891
al 00EDBF .Label_EDBF
al 00EDB7 .Label_EDB7
al 00ED6E .Label_ED6E
al 00E276 .Label_E276
al 00E275 .Label_E275
al 00E26F .Label_E26F
al 00E26E .Label_E26E
al 00E268 .Label_E268
al 00E267 .Label_E267
al 00E261 .Label_E261
al 00E260 .Label_E260
al 00E25A .Label_E25A
al 00E24F .Label_E24F
al 00E259 .Label_E259
al 00E249 .Label_E249
al 00E236 .Label_E236
al 00E240 .Label_E240
al 00E226 .Label_E226
al 00E230 .Label_E230
al 00E220 .Label_E220
al 00E20B .Label_E20B
al 00E215 .Label_E215
al 00E1FB .Label_E1FB
al 00E1E9 .Label_E1E9
al 00E1D4 .Label_E1D4
al 00E1B7 .Label_E1B7
al 00E1A8 .Label_E1A8
al 00E1A1 .Label_E1A1
al 00E195 .Label_E195
al 00E161 .Label_E161
al 00E173 .Label_E173
al 00E156 .Label_E156
al 00E13E .Label_E13E
al 00E121 .Label_E121
al 00E117 .Label_E117
al 00E10E .Label_E10E
al 00E103 .Label_E103
al 00E0FC .Label_E0FC
al 00E0F0 .Label_E0F0
al 00E0BC .Label_E0BC
al 00E0CE .Label_E0CE
al 00E0B1 .Label_E0B1
al 00E099 .Label_E099
al 00E07C .Label_E07C
al 00E072 .Label_E072
al 00E069 .Label_E069
al 00E05E .Label_E05E
al 00E057 .Label_E057
al 00E04B .Label_E04B
al 00E017 .Label_E017
al 00E029 .Label_E029
al 00E00C .Label_E00C
al 00DFD5 .Label_DFD5
al 00DFF4 .Label_DFF4
al 00DFBF .Label_DFBF
al 00DFB5 .Label_DFB5
al 00DFAC .Label_DFAC
al 00DFA1 .Label_DFA1
al 00DF9A .Label_DF9A
al 00DF89 .Label_DF89
al 00DF8E .Label_DF8E
al 00DF80 .Label_DF80
al 00DF3E .Label_DF3E
al 00DF30 .Label_DF30
al 00DF29 .Label_DF29
al 00DF14 .Label_DF14
al 00DEFF .Label_DEFF
al 00DF0E .Label_DF0E
al 00DECB .Label_DECB
al 00DEBB .Label_DEBB
al 00DEA9 .Label_DEA9
al 00DE9A .Label_DE9A
al 00D7F3 .Label_D7F3
al 00D7EB .Label_D7EB
al 00D7E3 .Label_D7E3
al 00D7D7 .Label_D7D7
al 00D7C5 .Label_D7C5
al 00D7B6 .Label_D7B6
al 00D79D .Label_D79D
al 00D793 .Label_D793
al 00D78A .Label_D78A
al 00D72E .Label_D72E
al 00D72D .Label_D72D
al 00D72C .Label_D72C
al 00D6FD .Label_D6FD
al 00D6F6 .Label_D6F6
al 00D6E7 .Label_D6E7
al 00D6D6 .Label_D6D6
al 00D720 .Label_D720
al 00D6C9 .Label_D6C9
al 00D6BB .Label_D6BB
al 00D6B2 .Label_D6B2
al 00D6AC .Label_D6AC
al 00D69C .Label_D69C
al 00D679 .Label_D679
al 00D66D .Label_D66D
al 00D655 .Label_D655
al 00D63B .Label_D63B
al 00D632 .Label_D632
al 00D5D5 .Label_D5D5
al 00D5CA .Label_D5CA
al 00D5AD .Label_D5AD
al 00D59A .Label_D59A
al 00D57A .Label_D57A
al 00D56B .Label_D56B
al 00D556 .Label_D556
al 00D555 .Label_D555
al 00D54A .Label_D54A
al 00D530 .Label_D530
al 00D520 .Label_D520
al 00D512 .Label_D512
al 00D510 .Label_D510
al 00D50A .Label_D50A
al 00D4EE .Label_D4EE
al 00D4C5 .Label_D4C5
al 00D4BB .Label_D4BB
al 00D4B7 .Label_D4B7
al 00D47F .Label_D47F
al 00D488 .Label_D488
al 00D476 .Label_D476
al 00D467 .Label_D467
al 00D45E .Label_D45E
al 00D45A .Label_D45A
al 00D43E .Label_D43E
al 00D42E .Label_D42E
al 00D424 .Label_D424
al 00D41D .Label_D41D
al 00D3BB .Label_D3BB
al 00D3B7 .Label_D3B7
al 00D3B5 .Label_D3B5
al 00D3A1 .Label_D3A1
al 00D320 .Label_D320
al 00D2ED .Label_D2ED
al 00D2BF .Label_D2BF
al 00D2AB .Label_D2AB
al 00D2A4 .Label_D2A4
al 00D2A0 .Label_D2A0
al 00D27F .Label_D27F
al 00D265 .Label_D265
al 00D260 .Label_D260
al 00D257 .Label_D257
al 00D253 .Label_D253
al 00D24A .Label_D24A
al 00D248 .Label_D248
al 00D23A .Label_D23A
al 00D237 .Label_D237
al 00D227 .Label_D227
al 00D21C .Label_D21C
al 00D20E .Label_D20E
al 00D1FD .Label_D1FD
al 00D1EC .Label_D1EC
al 00D1D7 .Label_D1D7
al 00D1BB .Label_D1BB
al 00D1B2 .Label_D1B2
al 00D1AA .Label_D1AA
al 00D193 .Label_D193
al 00D190 .Label_D190
al 00D185 .Label_D185
al 00D16A .Label_D16A
al 00D15E .Label_D15E
al 00D15B .Label_D15B
al 00D146 .Label_D146
al 00D134 .Label_D134
al 00D13C .Label_D13C
al 00D10D .Label_D10D
al 00D105 .Label_D105
al 00D0F5 .Label_D0F5
al 00D0F8 .Label_D0F8
al 00D0DF .Label_D0DF
al 00D0D3 .Label_D0D3
al 00D0C5 .Label_D0C5
al 00D0C3 .Label_D0C3
al 00D0B0 .Label_D0B0
al 00D0AD .Label_D0AD
al 00D0AC .Label_D0AC
al 00D0A0 .Label_D0A0
al 00D0B6 .Label_D0B6
al 00D087 .Label_D087
al 00D0B8 .Label_D0B8
al 00D080 .Label_D080
al 00D085 .Label_D085
al 00D074 .Label_D074
al 00D050 .Label_D050
al 00D04A .Label_D04A
al 00D040 .Label_D040
al 00D03D .Label_D03D
al 00D036 .Label_D036
al 00D02A .Label_D02A
al 00D021 .Label_D021
al 00CFFF .Label_CFFF
al 00CFFA .Label_CFFA
al 00D020 .Label_D020
al 00CFC7 .Label_CFC7
al 00CFC4 .Label_CFC4
al 00CF90 .Label_CF90
al 00CF74 .Label_CF74
al 00CF67 .Label_CF67
al 00CF98 .Label_CF98
al 00CF55 .Label_CF55
al 00CF29 .Label_CF29
al 00CF35 .Label_CF35
al 00CF14 .Label_CF14
al 00CF10 .Label_CF10
al 00CF0E .Label_CF0E
al 00CF02 .Label_CF02
al 00CEF6 .Label_CEF6
al 00CEEB .Label_CEEB
al 00CEE0 .Label_CEE0
al 00CED6 .Label_CED6
al 00CED3 .Label_CED3
al 00CEA8 .Label_CEA8
al 00CEA0 .Label_CEA0
al 00CE96 .Label_CE96
al 00CE9D .Label_CE9D
al 00CE7B .Label_CE7B
al 00CE78 .Label_CE78
al 00CE66 .Label_CE66
al 00CE5E .Label_CE5E
al 00CE54 .Label_CE54
al 00CE5B .Label_CE5B
al 00CE35 .Label_CE35
al 00CE32 .Label_CE32
al 00CE22 .Label_CE22
al 00CE1A .Label_CE1A
al 00CE17 .Label_CE17
al 00CE14 .Label_CE14
al 00CDDC .Label_CDDC
al 00CDC0 .Label_CDC0
al 00CDBD .Label_CDBD
al 00CDAC .Label_CDAC
al 00CDA4 .Label_CDA4
al 00CD97 .Label_CD97
al 00CD8A .Label_CD8A
al 00CD85 .Label_CD85
al 00CD80 .Label_CD80
al 00CD75 .Label_CD75
al 00CD72 .Label_CD72
al 00CD43 .Label_CD43
al 00CD27 .Label_CD27
al 00CD24 .Label_CD24
al 00CD23 .Label_CD23
al 00CD18 .Label_CD18
al 00CD07 .Label_CD07
al 00CCEE .Label_CCEE
al 00CCE5 .Label_CCE5
al 00CCCD .Label_CCCD
al 00CCB8 .Label_CCB8
al 00CCB1 .Label_CCB1
al 00CCA5 .Label_CCA5
al 00CCA8 .Label_CCA8
al 00CC90 .Label_CC90
al 00CC8B .Label_CC8B
al 00CC73 .Label_CC73
al 00CC56 .Label_CC56
al 00CC5C .Label_CC5C
al 00CC71 .Label_CC71
al 00CC3D .Label_CC3D
al 00CC11 .Label_CC11
al 00CBF9 .Label_CBF9
al 00CBE5 .Label_CBE5
al 00CBC1 .Label_CBC1
al 00CBDC .Label_CBDC
al 00CBAD .Label_CBAD
al 00CB99 .Label_CB99
al 00CB82 .Label_CB82
al 00CB6C .Label_CB6C
al 00CB68 .Label_CB68
al 00CAF3 .Label_CAF3
al 00CAAA .Label_CAAA
al 00CA80 .Label_CA80
al 00CA41 .Label_CA41
al 00CA97 .Label_CA97
al 00CA68 .Label_CA68
al 00CA32 .Label_CA32
al 00CA61 .Label_CA61
al 00CA1D .Label_CA1D
al 00C9A7 .Label_C9A7
al 00C95A .Label_C95A
al 00C934 .Label_C934
al 00C932 .Label_C932
al 00C90D .Label_C90D
al 00C8D0 .Label_C8D0
al 00C8F2 .Label_C8F2
al 00C8A4 .Label_C8A4
al 00C8B8 .Label_C8B8
al 00C897 .Label_C897
al 00C835 .Label_C835
al 00C815 .Label_C815
al 00C80A .Label_C80A
al 00C805 .Label_C805
al 00C800 .Label_C800
al 00C714 .Label_C714
al 00C614 .Label_C614
al 00C609 .Label_C609
al 00C585 .Label_C585
al 00C56D .Label_C56D
al 00C548 .Label_C548
al 00C536 .Label_C536
al 00C52E .Label_C52E
al 00C52A .Label_C52A
al 00C50A .Label_C50A
al 00C4FD .Label_C4FD
al 00C4EB .Label_C4EB
al 00C4E4 .Label_C4E4
al 00C4D9 .Label_C4D9
al 00C4D1 .Label_C4D1
al 00C4C7 .Label_C4C7
al 00C4C0 .Label_C4C0
al 00C4B8 .Label_C4B8
al 00C43E .Label_C43E
al 00C3FE .Label_C3FE
al 00C3FD .Label_C3FD
al 00C3FA .Label_C3FA
al 00C3F0 .Label_C3F0
al 00C3EF .Label_C3EF
al 00C3EB .Label_C3EB
al 00C3E7 .Label_C3E7
al 00C3E3 .Label_C3E3
al 00C3D8 .Label_C3D8
al 00C3C7 .Label_C3C7
al 00C3B8 .Label_C3B8
al 00C3A6 .Label_C3A6
al 00C392 .Label_C392
al 00C386 .Label_C386
al 00C384 .Label_C384
al 00C36D .Label_C36D
al 00C35F .Label_C35F
al 00C34A .Label_C34A
al 00C341 .Label_C341
al 00C347 .Label_C347
al 00C32C .Label_C32C
al 00C31B .Label_C31B
al 00C317 .Label_C317
al 00C300 .Label_C300
al 00C201 .Label_C201
al 00C1FB .Label_C1FB
al 00C1F6 .Label_C1F6
al 00C1EF .Label_C1EF
al 00C1EA .Label_C1EA
al 00C1E2 .Label_C1E2
al 00C1D7 .Label_C1D7
al 00C1D6 .Label_C1D6
al 00C1D0 .Label_C1D0
al 00C1C9 .Label_C1C9
al 00C1C4 .Label_C1C4
al 00C1C1 .Label_C1C1
al 00C1BA .Label_C1BA
al 00C1B6 .Label_C1B6
al 00C198 .Label_C198
al 00C192 .Label_C192
al 00C188 .Label_C188
al 00C16A .Label_C16A
al 00C160 .Label_C160
al 00C155 .Label_C155
al 00C139 .Label_C139
al 00C15B .Label_C15B
al 00C127 .Label_C127
al 00C122 .Label_C122
al 00C11B .Label_C11B
al 00C10D .Label_C10D
al 00C0FB .Label_C0FB
al 00C0ED .Label_C0ED
al 00C0DB .Label_C0DB
al 00C0CD .Label_C0CD
al 00C0B9 .Label_C0B9
al 00C0AD .Label_C0AD
al 00C0A0 .Label_C0A0
al 00C0B3 .Label_C0B3
al 00C0A8 .Label_C0A8
al 00C090 .Label_C090
al 00C063 .Label_C063
al 00C054 .Label_C054
al 00C051 .Label_C051
al 00C04E .Label_C04E
al 00C04B .Label_C04B
al 00C048 .Label_C048
al 00C042 .Label_C042
al 00C03F .Label_C03F
al 00C03C .Label_C03C
al 00C02A .Label_C02A
al 00C027 .Label_C027
al 00C01E .Label_C01E
al 00C01B .Label_C01B
al 00C018 .Label_C018
al 00C015 .Label_C015
al 00C012 .Label_C012
al 00C00F .Label_C00F
al 00C00C .Label_C00C
al 00C009 .Label_C009
al 00C006 .Label_C006
al 00C003 .Label_C003
al 00C000 .Label_C000
@@ -1,26 +0,0 @@
Modules list:
-------------
prg.o:
PRG Offs=000000 Size=004000 Align=00001 Fill=0000
Segment list:
-------------
Name Start End Size Align
----------------------------------------------------
PRG 00C000 00FFFF 004000 00001
Exports list by name:
---------------------
Exports list by value:
----------------------
Imports list:
-------------
Binary file not shown.