Pass 1 _wip: 23 projects at Pass 1, byte-identical builds verified

_wip/NROM/1942 (JU)/README.md

@@ -2,9 +2,11 @@
 
 ## Status
 
-**Pass 0 skeleton.** The project builds and verifies byte-identical to the
-original ROM, but no disassembly exists yet: `prg.s` is a single
-`.incbin "prg.bin"` of the PRG image.
+**Pass 1.** The project builds and verifies byte-identical to the
+original ROM. `prg.s` is a traced disassembly classifying bytes as
+reachable code or data, with every instruction carrying a trailing
+audit comment. Unreached bytes remain as explicit `.byte` blocks; no
+ROM byte is deleted or reformatted.
 
 `make` assembles `header.s`, `prg.s`, `chr.s`, links them with `ld65` and compares the
 result against `rom.nes`:

_wip/NROM/1942 (JU)/locals.inc

@@ -1,4 +1,58 @@
-; Zero-page aliases for this project.
-; Empty at Pass 0.  Pass 1+ adds proven semantic names here;
-; addresses whose role is not yet determined keep the neutral ZpXX
-; form.
+; 1942 (JU) application-specific RAM aliases - Pass 1
+; Generated from every direct zero-page operand in reachable code:
+; ref counts are reads/writes, `where` lists the referencing addresses.
+; ZpXX names indicate storage with a role not yet unique enough for a behavioral name;
+; Pass 2 replaces them with names derived from observed usage.
+
+Zp00                    = $00 ; 6 refs; reads=3 writes=3; used at $BFCE, C2C0, C2C9, C2DA, +2 more
+Zp02                    = $02 ; 7 refs; reads=5 writes=2; used at $C110, C123, C127, C1FF, +3 more
+Zp03                    = $03 ; 2 refs; reads=1 writes=1; used at $C22E, C2F7
+Zp22                    = $22 ; 2 refs; reads=1 writes=1; used at $C115, C119
+Zp23                    = $23 ; 2 refs; reads=1 writes=1; used at $C11B, C11F
+Zp42                    = $42 ; 1 refs; reads=1 writes=0; used at $C300
+Zp43                    = $43 ; 1 refs; reads=1 writes=0; used at $C2FD
+Zp62                    = $62 ; 4 refs; reads=2 writes=2; used at $C106, C2E8, C2F0
+Zp63                    = $63 ; 2 refs; reads=1 writes=1; used at $C030, C1AA
+Zp64                    = $64 ; 2 refs; reads=1 writes=1; used at $C032, C1A8
+Zp65                    = $65 ; 2 refs; reads=1 writes=1; used at $C034, C1A6
+Zp66                    = $66 ; 2 refs; reads=1 writes=1; used at $C1F7, C1FD
+Zp6F                    = $6F ; 2 refs; reads=1 writes=1; used at $A174, A17E
+Zp70                    = $70 ; 2 refs; reads=1 writes=1; used at $A17A, A184
+Zp72                    = $72 ; 4 refs; reads=2 writes=2; used at $A105, A113, A120
+Zp73                    = $73 ; 8 refs; reads=4 writes=4; used at $A1A2, A1AA, A1B0, A1BD, +2 more
+Zp74                    = $74 ; 13 refs; reads=8 writes=5; used at $A122, A13E, A154, A159, +7 more
+Zp75                    = $75 ; 3 refs; reads=1 writes=2; used at $9FDD, A001, A239
+Zp76                    = $76 ; 1 refs; reads=0 writes=1; used at $9FE1
+Zp77                    = $77 ; 27 refs; reads=10 writes=17; used at $9FE5, A010, A169, A1D7, +23 more
+Zp78                    = $78 ; 1 refs; reads=0 writes=1; used at $9FE9
+Zp79                    = $79 ; 3 refs; reads=2 writes=1; used at $9FEE, A393, A3A4
+Zp7A                    = $7A ; 1 refs; reads=0 writes=1; used at $9FF3
+Zp7B                    = $7B ; 5 refs; reads=1 writes=4; used at $9FF7, A202, A20C, A20E
+Zp7C                    = $7C ; 1 refs; reads=0 writes=1; used at $9FFB
+Zp7D                    = $7D ; 4 refs; reads=1 writes=3; used at $A0ED, A10F, A18E
+Zp7E                    = $7E ; 4 refs; reads=1 writes=3; used at $A0F2, A10D, A190
+Zp7F                    = $7F ; 4 refs; reads=1 writes=3; used at $A0F7, A10B, A192
+Zp80                    = $80 ; 4 refs; reads=1 writes=3; used at $A0FC, A109, A194
+Zp81                    = $81 ; 9 refs; reads=5 writes=4; used at $A101, A107, A21B, A237, +4 more
+Zp82                    = $82 ; 23 refs; reads=18 writes=5; used at $A162, A17C, A196, A1CF, +19 more
+Zp83                    = $83 ; 12 refs; reads=5 writes=7; used at $A19C, A1E5, A1EE, A1F4, +7 more
+Zp84                    = $84 ; 8 refs; reads=3 writes=5; used at $A198, A290, A29A, A2AD, +3 more
+Zp86                    = $86 ; 6 refs; reads=2 writes=4; used at $B97E, B994, B9AA, B9C0
+Zp87                    = $87 ; 10 refs; reads=3 writes=7; used at $803E, A00C, A017, A025, +3 more
+Zp88                    = $88 ; 14 refs; reads=4 writes=10; used at $8031, A01D, A02B, B972, +10 more
+Zp89                    = $89 ; 9 refs; reads=3 writes=6; used at $802C, A021, B96E, B98E, +5 more
+Zp8A                    = $8A ; 10 refs; reads=1 writes=9; used at $8038, A0D2, A0DC, A0DF, +6 more
+Zp8B                    = $8B ; 6 refs; reads=1 writes=5; used at $A0D6, B976, B9A2, BFAF, +1 more
+Zp8C                    = $8C ; 16 refs; reads=8 writes=8; used at $801B, 801F, 8042, 8046, +12 more
+Zp8D                    = $8D ; 2 refs; reads=1 writes=1; used at $BFDA, C0F4
+Zp8F                    = $8F ; 1 refs; reads=0 writes=1; used at $BFEA
+Zp90                    = $90 ; 2 refs; reads=1 writes=1; used at $BFEF, C0EA
+Zp94                    = $94 ; 4 refs; reads=1 writes=3; used at $C1B7, C1C1, C1C9, C1D4
+Zp95                    = $95 ; 8 refs; reads=4 writes=4; used at $C1CE, C1D1, C1DA, C1DC, +3 more
+Zp98                    = $98 ; 2 refs; reads=1 writes=1; used at $C1E0, C1E4
+Zp99                    = $99 ; 2 refs; reads=0 writes=2; used at $C1E6, C1F2
+ZpCF                    = $CF ; 1 refs; reads=0 writes=1; used at $C055
+ZpD0                    = $D0 ; 4 refs; reads=2 writes=2; used at $C010, C08B, C0A4, C0AB
+ZpD1                    = $D1 ; 4 refs; reads=2 writes=2; used at $C014, C086, C0AD, C0C0
+ZpD2                    = $D2 ; 4 refs; reads=2 writes=2; used at $C008, C092, C09B, C0A2
+ZpD3                    = $D3 ; 1 refs; reads=0 writes=1; used at $C00C