disasm/CHANGELOG.md

Changelog

A running log of every change made in this repository. It covers all of the projects - the promoted tier and the _wip/ tier alike - and it is also the staging area for the next commit.

How this file is used

1. As work lands, a line goes into Pending: the project it touches and what changed. Nothing else is needed - the entry is the record.
2. At commit time, the commit's message is written from the entries in Pending. The entries are the summary of what the commit contains, so the message and the log cannot drift apart.
3. After the commit, the entries move to History under the commit they went in with, and Pending starts again empty.

Pending - the list of changes to be put in the next git commit. History - the running log of the commits that have already been made. The milestone index at the end - the per-project pass history: which of the four milestones each project has reached, and when. That part is a status table rather than a log, and it is what PROMPTS.md asks for when a project reaches a milestone.

Pending

• Pass 2/3 _wip (5 CNROM) - Tiger-Heli (U), Paperboy (U), Last Starfighter, The (U), Mighty Bomb Jack (U) and Kung-Fu Heroes (U) converted to CPU-address linker layout and advanced through Pass 2 and Pass 3; make stays byte-identical.

• Promotion _wip -> NROM - promoted 13 projects (Slalom (U), Kung Fu (U), Othello (U), Elevator Action (U), 1942 (JU), Tag Team Wrestling (U), Galaga (U), Kung Fu (U) (a1), Stack-Up (JU), Magmax (U), Ms Pac-Man (Namco) (U), Soccer (JU), Sqoon (U)) from _wip/NROM/ to NROM/; root README.md inventory updated (rows 42-54).

• Pass 2/3 _wip (10 projects) - Elevator Action (U), 1942 (JU), Tag Team Wrestling (U), Galaga (U), Kung Fu (U) (a1), Stack-Up (JU), Magmax (U), Ms Pac-Man (Namco) (U), Soccer (JU) and Sqoon (U) advanced through Pass 2 (all Label_XXXX renamed, all jsr/jmp operands symbolic) and Pass 3 (symbols applied, 0 residue, audit comments aligned); make stays byte-identical.

• Pass 3 _wip - Slalom (U), Kung Fu (U) and Othello (U) advanced to Pass 3: hardware-register operands resolved via apply_symbols.py (0 residue), zero-page slots documented in locals.inc, audit comments aligned; make stays byte-identical.

• Pass 2 _wip - Slalom (U), Kung Fu (U) and Othello (U) promoted from Pass 1 to Pass 2: every Label_XXXX definition renamed (83 / 152 / 157 entries), all jsr/jmp operands resolved to symbolic labels, internal branch targets given role-based names; make stays byte-identical.

• Pass 1 _wip (bulk) - completed Pass 1 (code/data split with canonical audit comments) for all remaining 810 _wip/ skeletons, across all 29 mapper folders. Every project now rebuilds byte-identical (make wip: 851 of 851 passed). nesdis.py was patched to define labels at branch targets landing in data regions; banked_dis.py gained per-bank sizing and PRG-sized CDL support (used for Wayne Gretzky Hockey (U)); derive_branch_names.py and apply_pass2_map.py learned the banked BANK: audit field. Two latent failures in the original 41 (Adventures of Dino Riki, 8 Eyes) were repaired.

• Docs - tier counts refreshed to the post-promotion state across AGENTS.md, root README.md, WIP.md, TODO.md and CHANGELOG.md: 41 promoted projects (38 under NROM/, plus CNROM/World Class Track Meet (U), UNROM/Zanac (U) and MAPPER8/Mermaids of Atlantis (U)) and 851 _wip/ projects, every one of them a Pass 0 skeleton. The stale "39/40 promoted", "853 _wip", "Golf (JU) is still in _wip/" and "Golf (JU) is the last pre-canonical project" statements are corrected.

• Root README.md - the promoted inventory gained the missing World Class Track Meet (U) row (row 41, mapper 3, 32 KB PRG / 32 KB CHR), and the "All 38 are mapper 0 / 16 KB PRG" sentence is replaced with the actual split (36 of the 41 rows are mapper 0 / 16 KB; Xevious (U) and Volleyball (U) are 32 KB, World Class Track Meet (U) is mapper 3, Zanac (U) mapper 2 and Mermaids of Atlantis (U) mapper 8).

• WIP.md - twenty-nine projects updated from Pass 0 to Pass 1: 1942 (JU), Hydlide (U), Othello (U), Ice Hockey (U), Super Mario Bros (JU) (PRG 0), Tag Team Wrestling (U), Soccer (JU), Slalom (U), Seicross (U), Spy Vs Spy (U), Sqoon (U), Spelunker (U) [!], 10-Yard Fight (U), Chubby Cherub (U), Dig Dug II (U) [!], Elevator Action (U), Gyromite (JUE), Kung Fu (U) (a1), Mach Rider (JU), Mach Rider (JU) (a1), Magmax (U), Magmax (U) (Prototype), Ms Pac-Man (Namco) (U), Ms Pac-Man (U), NES Test Cart (Official Nintendo) (U), Port Test Cartridge (U), Pro Action Replay (No Cart Present) (U), Pro Action Replay (Rev B) (U), Stack-Up (JU).

• _wip/NROM/1942 (JU)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Hydlide (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Othello (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Ice Hockey (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Super Mario Bros (JU) (PRG 0)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Tag Team Wrestling (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Soccer (JU)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Slalom (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Seicross (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Spy Vs Spy (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Sqoon (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Spelunker (U) [!]/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Pipe Dream (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/10-Yard Fight (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Chubby Cherub (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Dig Dug II (U) [!]/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Elevator Action (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Gyromite (JUE)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Kung Fu (U) (a1)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Mach Rider (JU)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Mach Rider (JU) (a1)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Magmax (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Magmax (U) (Prototype)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Ms Pac-Man (Namco) (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Ms Pac-Man (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/NES Test Cart (Official Nintendo) (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Port Test Cartridge (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Pro Action Replay (No Cart Present) (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Pro Action Replay (Rev B) (U)/README.md - updated from Pass 0 to Pass 1.

• _wip/NROM/Stack-Up (JU)/README.md - updated from Pass 0 to Pass 1.

• 1942 (JU) - Pass 1 complete. Code/data split: 877 instructions / 1728 bytes (5.3%). Vectors: NMI=$C030 RESET=$BF90 IRQ=$BF90. 52 zero-page aliases generated. make produces byte-identical ROM.

• Hydlide (U) - Pass 1 complete. Code/data split: 7318 instructions / 14885 bytes (45.4%). Vectors: NMI=$8003 RESET=$8000 IRQ=$8003. 175 zero-page aliases generated. make produces byte-identical ROM.

• Othello (U) - Pass 1 complete. Code/data split: 1042 instructions / 2178 bytes (6.6%). Vectors: NMI=$D6B4 RESET=$8000 IRQ=$804E. 41 zero-page aliases generated. make produces byte-identical ROM.

• Ice Hockey (U) - Pass 1 complete. Code/data split: 1160 instructions / 2524 bytes (7.7%). Vectors: NMI=$805A RESET=$8000 IRQ=$8000. 34 zero-page aliases generated. make produces byte-identical ROM.

• Super Mario Bros (JU) (PRG 0) - Pass 1 complete. Code/data split: 1067 instructions / 2320 bytes (7.1%). Vectors: NMI=$8082 RESET=$8000 IRQ=$FFF0. 24 zero-page aliases generated. make produces byte-identical ROM.

• Tag Team Wrestling (U) - Pass 1 complete. Code/data split: 799 instructions / 1756 bytes (5.4%). Vectors: NMI=$FFCD RESET=$FD43 IRQ=$FD43. 49 zero-page aliases generated. make produces byte-identical ROM.

• Soccer (JU) - Pass 1 complete. Code/data split: 1212 instructions / 2462 bytes (7.5%). Vectors: NMI=$809F RESET=$8000 IRQ=$8000. 83 zero-page aliases generated. make produces byte-identical ROM.

• Slalom (U) - Pass 1 complete. Code/data split: 678 instructions / 1461 bytes (4.5%). Vectors: NMI=$8123 RESET=$8050 IRQ=$FEDF. 33 zero-page aliases generated. make produces byte-identical ROM.

• Seicross (U) - Pass 1 complete. Code/data split: 2260 instructions / 4848 bytes (14.8%). Vectors: NMI=$8858 RESET=$8000 IRQ=$FD0E. 93 zero-page aliases generated. make produces byte-identical ROM.

• Spy Vs Spy (U) - Pass 1 complete. Code/data split: 7914 instructions / 16263 bytes (49.6%). Vectors: NMI=$8066 RESET=$8000 IRQ=$FFC7. 190 zero-page aliases generated. make produces byte-identical ROM.

• Sqoon (U) - Pass 1 complete. Code/data split: 1568 instructions / 3138 bytes (9.6%). Vectors: NMI=$8014 RESET=$8000 IRQ=$80F1. 101 zero-page aliases generated. make produces byte-identical ROM.

• Spelunker (U) [!] - Pass 1 complete. Code/data split: 5418 instructions / 11052 bytes (33.7%). Vectors: NMI=$84C6 RESET=$8000 IRQ=$8513. 179 zero-page aliases generated. make produces byte-identical ROM.

• Pipe Dream (U) - Pass 1 complete. Code/data split: 7892 instructions / 16527 bytes (50.4%). Vectors: NMI=$8FEA RESET=$8000 IRQ=$912B. 224 zero-page aliases generated. make produces byte-identical ROM.

• 10-Yard Fight (U) - Pass 1 complete. Code/data split: 3674 instructions / 7541 bytes (23.0%). Vectors: NMI=$8471 RESET=$8000 IRQ=$84FF. 128 zero-page aliases generated. make produces byte-identical ROM.

• Chubby Cherub (U) - Pass 1 complete. Code/data split: 6589 instructions / 13471 bytes (41.1%). Vectors: NMI=$82B7 RESET=$8000 IRQ=$8331. 149 zero-page aliases generated. make produces byte-identical ROM.

• Dig Dug II (U) [!] - Pass 1 complete. Code/data split: 8146 instructions / 17500 bytes (53.4%). Vectors: NMI=$A749 RESET=$A52D IRQ=$A52D. 91 zero-page aliases generated. make produces byte-identical ROM.

• Elevator Action (U) - Pass 1 complete. Code/data split: 741 instructions / 1431 bytes (4.4%). Vectors: NMI=$8081 RESET=$8000 IRQ=$8000. 51 zero-page aliases generated. make produces byte-identical ROM.

• Gyromite (JUE) - Pass 1 complete. Code/data split: 1584 instructions / 3314 bytes (10.1%). Vectors: NMI=$8079 RESET=$8000 IRQ=$8000. 67 zero-page aliases generated. make produces byte-identical ROM.

• Kung Fu (U) (a1) - Pass 1 complete. Code/data split: 893 instructions / 1931 bytes (5.9%). Vectors: NMI=$82D6 RESET=$8258 IRQ=$FFF0. 48 zero-page aliases generated. make produces byte-identical ROM.

• Mach Rider (JU) - Pass 1 complete. Code/data split: 6174 instructions / 12738 bytes (38.9%). Vectors: NMI=$8070 RESET=$8000 IRQ=$8147. 199 zero-page aliases generated. make produces byte-identical ROM.

• Mach Rider (JU) (a1) - Pass 1 complete. Code/data split: 6174 instructions / 12738 bytes (38.9%). Vectors: NMI=$8070 RESET=$8000 IRQ=$8147. 199 zero-page aliases generated. make produces byte-identical ROM.

• Magmax (U) - Pass 1 complete. Code/data split: 1387 instructions / 2900 bytes (8.9%). Vectors: NMI=$BD33 RESET=$BC33 IRQ=$BC33. 63 zero-page aliases generated. make produces byte-identical ROM.

• Magmax (U) (Prototype) - Pass 1 complete. Code/data split: 1387 instructions / 2900 bytes (8.9%). Vectors: NMI=$BD33 RESET=$BC33 IRQ=$BC33. 63 zero-page aliases generated. make produces byte-identical ROM.

• Ms Pac-Man (Namco) (U) - Pass 1 complete. Code/data split: 1399 instructions / 2950 bytes (9.0%). Vectors: NMI=$C107 RESET=$FFF7 IRQ=$C198. 53 zero-page aliases generated. make produces byte-identical ROM.

• Ms Pac-Man (U) - Pass 1 complete. Code/data split: 4179 instructions / 8726 bytes (26.6%). Vectors: NMI=$FB86 RESET=$FEE0 IRQ=$FBE1. 85 zero-page aliases generated. make produces byte-identical ROM.

• NES Test Cart (Official Nintendo) (U) - Pass 1 complete. Code/data split: 1706 instructions / 3603 bytes (11.0%). Vectors: NMI=$8328 RESET=$8370 IRQ=$8370. 47 zero-page aliases generated. make produces byte-identical ROM.

• Port Test Cartridge (U) - Pass 1 complete. Code/data split: 216 instructions / 439 bytes (1.3%). Vectors: NMI=$CC49 RESET=$C000 IRQ=$CC17. 28 zero-page aliases generated. make produces byte-identical ROM.

• Pro Action Replay (No Cart Present) (U) - Pass 1 complete. Code/data split: 0 instructions / 0 bytes (0.0%). Vectors: NMI=$0000 RESET=$0000 IRQ=$0000. 1 label generated. make produces byte-identical ROM.

• Pro Action Replay (Rev B) (U) - Pass 1 complete. Code/data split: 5156 instructions / 6321 bytes (19.3%). Vectors: NMI=$F021 RESET=$808A IRQ=$F020. 126 zero-page aliases generated. make produces byte-identical ROM.

• Stack-Up (JU) - Pass 1 complete. Code/data split: 1086 instructions / 2260 bytes (6.9%). Vectors: NMI=$81AD RESET=$8100 IRQ=$81E6. 63 zero-page aliases generated. make produces byte-identical ROM.

History

Entries move here when the commit they describe is made, newest first. The commit subject is the heading; the entries are the changes it carried.

2026-10-21 - Xevious (U): re-split Pass 1 from the Mesen CDL and decode the data tables

• Xevious (U) - Pass 1 re-split from the Mesen CDL (xevious_mesen.cdl) with _tools/cdl_reclass.py: 1,158 bytes data→code, 48 code→data, 42 labels emitted and 3 branch targets labelled; code 11,321→12,455 bytes (34.5%→38.0%), instructions 5,513→6,002. The 45 recovered entry points are named Sub_XXXX, so no Label_XXXX remains; six CDL-silent raw call operands are documented as residue.
• Xevious (U) - the 4,448-byte block at $A74B-$B8AA is split into six proven tables: VramWritePtrTable (15 pointers), VramWriteData (descriptors written to $2006/$2007), DataStreamPtrTable (16 pointers), ObjTilePtrTable (99 pointers), ObjTileData and DataStreamData. The $D833 pointer table is corrected to base $D833 (4 entries; the old ObjCodePtrTable at $D834 was one byte late). $F957-$FAF5 is split into ObjSpeedTable, ObjSpeedTable2, SpriteLayoutPtrTable (19 pointers) and SpriteLayoutData; $FEE6-$FF1C into PaletteData and OamAttrTable. $F5D8 is decoded as TextTileData (font tile indices: PLAYER, GAME OVER, READY, SOLVALOU, LEFT, PAUSE); $F53C becomes AttrAddrTable, $F89E HandlerPtrTable and $EF3B SpriteLayoutData2. Project README rewritten with the corrected stats, a 32-entry table inventory and the Pass 1 residue.
• _tools/cdl_reclass.py - preserve the data label(s) that sit between a ; ---- data header and its first .byte row when the block stays data. The $DF78 split dropped Data_DF78, which unchanged code still referenced, so the rebuild failed with an undefined symbol.
• _tools/resolve_raw_branches.py - handle negative relative offsets (beq *-$0B); the pattern only matched *+$NN and *$NN, so backward branches could not be resolved.

2026-10-21 - Golf (JU) and World Class Track Meet (U): Pass 2/3 complete, promoted from _wip/

• World Class Track Meet (U) - Pass 2 complete: all 884 Label_<addr> definitions replaced (651 semantic routine names + 233 Sub_<addr>), all 731 raw $XXXX jsr/jmp call operands resolved to symbolic labels, all branch targets given role-based names; routinemap.tsv added; make stays byte-identical.
• World Class Track Meet (U) - Pass 3 complete: 24 semantic zero-page aliases applied via apply_symbols.py (0 residue), 78 neutral ZpXX slots documented with reasons in locals.inc, all hardware-register operands use symbols.inc names, project README rewritten with Pass 2/Pass 3 sections and data-table inventory; project is ready for promotion out of _wip/CNROM/.
• World Class Track Meet (U) - project README now says what the five entries of the event table at $F796 line up with (the five single events of the six-item menu) and marks the sixth item, the "olympics", as not yet proven: the menu's own code is still outside the traced set, so the mode that schedules several of the five task slots at once is the expected answer, not a proven one.
• Golf (JU) - audit comments converted from pre-canonical (; C000: A9 00) to the canonical ; CPU:$C000 PRG:0000 A9 00 form at column 35 via _tools/repair_audit_comments.py then _tools/align_audit_comments.py; 4,156 comments re-aligned, comment/whitespace only, whole-ROM build stays byte-identical.
• Golf (JU) - 339 internal branch-target Label_ labels given role-based names (<Routine>_Loop, <Routine>_OnZero, …) via _tools/derive_branch_names.py from routinemap.tsv and applied with _tools/apply_pass2_map.py; 10 fall-through-only labels keep their Label_<addr> definitions; 0 raw $XXXX branch/jump operands remain.
• Golf (JU) - 275 zero-page operands substituted with locals.inc aliases via apply_symbols.py; all hardware-register operands already symbolic; 0 multi-alias residue; no unexplained numeric operands left.
• Golf (JU) - project README updated: Pass 2/Pass 3 marked complete, audit-comment and Pass 3 sections rewritten, routinemap.tsv added; project is ready for promotion out of _wip/NROM/.
• Golf (JU) and World Class Track Meet (U) - promoted out of _wip/ (git mv to NROM/Golf (JU)/ and CNROM/World Class Track Meet (U)/); leftover _wip/ folders removed; root README.md inventory rows added; WIP.md rows removed.
• Xevious (U) - runs of $FF padding replaced with .res <count>, $FF in prg.s; whole-ROM build stays byte-identical.

2026-10-21 - World Class Track Meet (U): Pass 1, the code/data split

• World Class Track Meet (U) - Pass 1 done. The code/data split is 8,400
• World Class Track Meet (U) - four dispatch tables had to be seeded by
• World Class Track Meet (U) - the tracer runs with --undocumented: the
• World Class Track Meet (U) - $C0BE-$C0C5 is forced back to data: the
• World Class Track Meet (U) - make pass1 regenerates prg.s and
• _tools/nesdis.py - new --mapping-note option, so the header's "PRG
• Docs - the project README records the split, the four dispatch tables, the

2026-10-21 - Balloon Fight (JU): repair the audit trail and complete the routine headers

• Balloon Fight (JU) - the per-instruction audit trail was repaired. 5,944 of the 6,007 comments had been stale by two bytes since the three-byte .byte "HAL" signature at $C082-$C084 was counted as one, so every comment from ResetInitializationData ($C085) onward named the wrong CPU address and PRG offset; the routine headers and the linker labels were right, so the source and its own headers disagreed. The trail was rebuilt from the ca65 -l listing with _tools/repair_audit_comments.py and every rewritten comment was re-checked against prg.bin.
• Balloon Fight (JU) - the audit comments were moved into the canonical column-35 field. They had sat two spaces after the mnemonic, with no column discipline at all, unlike every other promoted project.
• Balloon Fight (JU) - all 63 routine headers now carry a ; Clobbers: block, so the headers carry the full template AGENTS.md describes. The blocks are derived, not written by hand: _tools/derive_clobbers.py takes the opcode from the audit comment's byte list, resolves the operand through locals.inc and symbols.inc to name what is written, follows the real control flow, and models register preservation - so NmiHandler reports no register and FlushPpuCommandPreserved reports only A.
• Balloon Fight (JU) - ReflectObjectYVelocity and UpdateSpecialObjectSystem moved out of locals.inc and became labels in prg.s at their real addresses.
• _tools - new derive_clobbers.py, which fills in the ; Clobbers: block of every routine header from the source.
• _tools - align_audit_comments.py had an off-by-one: it tested the indented code length against 31 instead of against 35, so code texts of 28-31 characters were never padded into the column.
• Docs - the project README gains the audit-trail and clobber sections, the root README and TODO.md carry the same news, AGENTS.md and PROMPTS.md describe this changelog's new shape, and CHANGELOG.md itself becomes the running log with a pending list.
• WIP.md - _wip/MAPPER8/ is gone; it held a copy of Mermaids of Atlantis (U) that had already been promoted.

---

The milestone index

The four milestones every project walks through, and the state of each project against them.

The four milestones

Milestone	What it does	How it is checked
Pass 1	The code/data split: every ROM byte is classified as an instruction or as data, with the audit comment (; CPU:$C123 PRG:0123 AD 21 03) on every instruction.	Every byte of the PRG image is accounted for exactly once, and the audit comments re-check against prg.bin.
Pass 2	The labels are replaced by names: the address-derived Label_XXXX definitions become semantic routine names, and the internal branch targets get role names (<Routine>_OnNonzero, <Routine>_Loop).	No Label_XXXX definition is left, no branch or jump operand is a raw $XXXX, and every label is defined exactly once.
Pass 3	The semantic naming: the data tables, the zero-page aliases and the hardware register operands get the names the dump proves, and the routine headers are written.	apply_symbols.py reports no unexplained residue, and every alias that is not proven is recorded with its reason.
Promotion	The project moves out of _wip/ into its mapper folder with the whole-ROM build in place.	make in the project folder prints Byte-identical ROM verified. against rom.nes.

A project is only promoted when Pass 2 and Pass 3 are done, the promotion requirements in PROMPTS.md are met, and the whole ROM rebuilds byte for byte. PROMPTS.md is the contract; this file is the history.

On the dates. A date is the day the repository records the milestone: the commit that carried it, or the day the project README dates the work. Where neither does, the milestone is dated to the wave it was committed with - the 2026-10-15 build standardisation, the 2026-10-18 _wip pass-1 wave, the 2026-10-19 naming wave, or the 2026-10-20 promotion wave. A milestone that is still open says so in the row.

The tiers

• Promoted — 41 projects in the top level NROM/, CNROM/, UNROM/ and MAPPER8/ folders. Each one below has been through all four milestones unless its entry says otherwise.
• _wip/ — 851 projects that are still Pass 0 skeletons: prg.s is a single .incbin "prg.bin". They have a build and a byte-identical rebuild, but no disassembly yet. Golf (JU) and World Class Track Meet (U) were the tier's last two real disassemblies and were both promoted on 2026-10-21, so no project in the tier carries one now.

Balloon Fight (JU) — NROM/Balloon Fight (JU)/

Milestone	Date	Note
Pass 1	2026-10-16	First disassembly 2026-10-09; verified complete on the 16th: 5,303 instructions / 11,260 code bytes (68.7 %). The last two .incbin spans were turned into explicit classified bytes, so no ROM byte is hidden.
Pass 2	2026-10-19	Every label renamed; the zero-page aliases written into locals.inc.
Pass 3	2026-10-19	125 hardware and 797 of 813 zero-page operands substituted; the 16 that stay numeric are recorded. 2026-10-21: the audit trail was repaired - 5,944 comments had been stale by two bytes since a three byte .byte "HAL" signature had been counted as one. 2026-10-21: every routine header now carries a derived ; Clobbers: block (63 of 63), so the headers carry the full template - global, local, parameters, returns, clobbers.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Baseball (UE) — NROM/Baseball (UE)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly; prg.s is the largest source in the set at 21,624 lines.
Pass 2	2026-10-19	Labels renamed in the audit-comment standardisation wave.
Pass 3	2026-10-19	121 operands substituted (85 single-name + 36 hardware), zero residue.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Bomberman (U) — NROM/Bomberman (U)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	354 single-name and 8 site-resolved multi-alias operands applied, 24 table labels taken from the linker map. Residue recorded: 758 unnamed operands over 179 distinct addresses.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Burger Time (U) — NROM/Burger Time (U)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly; byte identical out of the box.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	Symbols applied.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

CIRCUS — NROM/CIRCUS/

Milestone	Date	Note
Pass 1	2026-10-16	Full code/data classification; the main loop is a spin loop at $C057 and every frame's work runs in the NMI.
Pass 2	2026-10-16	Semantic routine naming.
Pass 3	2026-10-19	118 operands substituted (38 single-name + 80 hardware); 23 multi-alias residues recorded.
Promotion	2026-10-16	Promoted out of _wip/; the menu text table at $C763 and the variant object machine at $DC3F-$FE7B documented.

Clu Clu Land (JU) — NROM/Clu Clu Land (JU)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	Symbols applied.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Defender 2 (U) — NROM/Defender 2 (U)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	Symbols applied.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Donkey Kong (JU) — NROM/Donkey Kong (JU)/

Milestone	Date	Note
Pass 1	2026-10-18	6,014 instructions / 12,505 code bytes (76.3 %); the reset entry is at $C79E, not $C000.
Pass 2	2026-10-19	All 919 Label_XXXX definitions named: 102 semantic routine names, 217 SubC<addr> entries and 600 derived internal branch targets.
Pass 3	2026-10-19	10 named data regions, 75 operands substituted.
Promotion	2026-10-19	git mv out of _wip/; the mirroring was corrected from Vertical to Horizontal (header byte 6 = $00).

Donkey Kong 3 (JUE) — NROM/Donkey Kong 3 (JUE)/

Milestone	Date	Note
Pass 1	2026-10-16	The build was split into header.s / prg.s / chr.s, and a one byte branch-target bug was fixed: the bne at $C14C was labelled StoreSelectedPlayerAndScreenFlags instead of the routine at $C160, so the project had never actually built byte identical.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	Symbols applied.
Promotion	2026-10-15	Top-level wave: the build was standardised and the project got its power-on README.

Donkey Kong Jr. (JU) — NROM/Donkey Kong Jr. (JU)/

Milestone	Date	Note
Pass 1	2026-10-16	Verified complete by a byte-accounting audit: all 16,384 PRG bytes are emitted exactly once (6,135 instructions + 3,889 .byte + 16 .word), with no audit-comment mismatch and no .incbin left. 75.4 % code.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	The tables named - DeferredTaskHandlerTable, HudDigitDescriptorTable and the rest.
Promotion	2026-10-16	Promoted out of _wip/. Architecturally different from the rest: the reset idles in a PRNG loop and the whole frame state machine runs inside the NMI.

Donkey Kong Jr. Math (U) — NROM/Donkey Kong Jr. Math (U)/

Milestone	Date	Note
Pass 1	2026-10-19	6,589 instructions / 13,416 code bytes (81.9 %).
Pass 2	2026-10-19	Restarted from the committed split after the 2026-10-18 draft map was audited and found to have no safely applicable row; 1,035 labels named (64 semantic + 295 SubC<addr> + 676 internal).
Pass 3	2026-10-19	18 data tables named, 13 semantic zero-page aliases, all multi-alias operands substituted.
Promotion	2026-10-19	Top level; the whole-ROM verify closed on 2026-10-20 after four call sites that named a back-branch block instead of the routine it belongs to were repointed.

Duck Hunt (JUE) — NROM/Duck Hunt (JUE)/

Milestone	Date	Note
Pass 1	2026-10-19	3,058 instructions / 6,152 code bytes (37.5 %).
Pass 2	2026-10-19	Restarted from the committed split; 472 labels named (30 semantic + 428 SubC<addr> + 293 internal).
Pass 3	2026-10-19	20 data tables named, 18 semantic zero-page aliases.
Promotion	2026-10-19	Top level.

Excitebike (JU) — NROM/Excitebike (JU)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	The audit comments were completed - 1,013 lines had none. 2026-10-20: the trail was re-anchored from the ca65 listing (6,339 shifted comments and 4,401 doubled ?? forms) and all 58 raw jsr/jmp operands were given routine names.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Golf (JU) — _wip/NROM/Golf (JU)/ — ready for promotion out of _wip/

Milestone	Date	Note
Pass 1	2026-10-20	The whole-ROM compare was added: the project builds byte identical. 4,217 reachable instructions in prg.s (13,541 lines); all remaining .incbin spans confirmed data with zero code entry points.
Pass 2	2026-10-21	All 112 subroutine entries named (4 semantic + 108 SubC<addr>); all jsr/jmp call sites symbolic, 0 raw $XXXX call operands; 339 of 349 internal branch targets given role-based names (<Routine>_Loop, <Routine>_OnZero, …); 10 fall-through-only labels keep their Label_<addr> definitions.
Pass 3	2026-10-21	Audit comments canonical at column 35 (4,156 re-aligned via _tools/repair_audit_comments.py + _tools/align_audit_comments.py); all hardware-register operands use symbols.inc names; 275 zero-page operands substituted with locals.inc aliases via apply_symbols.py, 0 residue; every branch/jump target symbolic.
Promotion	—	Outstanding (awaiting git mv to NROM/Golf (JU)/ plus root README.md inventory row).

World Class Track Meet (U) — _wip/CNROM/World Class Track Meet (U)/ — ready for promotion out of _wip/

Milestone	Date	Note
Pass 1	2026-10-21	The code/data split is done: 8,400 instructions / 18,028 code bytes (55.0 %) of the 32 KB PRG, 884 routine entries, 55 data blocks, 102 zero-page aliases. The PRG is CNROM (mapper 3) and maps whole at $8000-$FFFF, so the linker moved the PRG segment from a file offset to $8000. Four dispatch tables had to be seeded by hand: the event table at $F796 (5 entries, read at $F780 and jumped to through jmp ($001F)) and three push-pointer tables - $BFC4 (16), $BFE4 (2) and $E5F2 (7) - which store the handler address minus one, because the handler is pushed and an rts lands on it. The tracer runs with --undocumented: the code uses undocumented NMOS opcodes as ordinary code. Seeding the tables takes the coverage from 27.8 % to 55.0 %. The rebuild is byte identical.
Pass 2	2026-10-21	All 884 Label_XXXX definitions replaced: 651 semantic routine names (Reset, NmiHandler, MainLoop, TaskDispatch, EventInit, EventTaskRun, SpriteSetup, ObjectState, SoundNote, OlympicsScheduler, …) plus 233 Sub_<addr> address-derived residue. All 731 raw $XXXX jsr/jmp call operands resolved to symbolic labels; every branch target given a role-based name (_Loop, _OnZero, _OnNonzero, …); routinemap.tsv holds the address→name map.
Pass 3	2026-10-21	24 semantic zero-page aliases applied via apply_symbols.py (0 residue), 78 neutral ZpXX slots documented with reasons in locals.inc, all hardware-register operands use symbols.inc names, data-table inventory documented in the project README.
Promotion	—	Outstanding (awaiting git mv to CNROM/World Class Track Meet (U)/ plus root README.md inventory row).

Hogan's Alley (JU) — NROM/Hogan's Alley (JU)/

Milestone	Date	Note
Pass 1	2026-10-20	The static trace had classified only 41.8 % of the PRG as code. A merged Mesen CDL capture (five captures, 6,544 code bytes) moved 1,216 bytes from data to code and five the other way, taking the split to 49.1 %.
Pass 2	2026-10-20	A fresh map from this dump's own committed split: 206 routine entries hand-named and 413 internal branch targets derived.
Pass 3	2026-10-20	60 semantic zero-page aliases, each applied only where its role is proven.
Promotion	2026-10-20	Top level.

Ice Climber (JE) — NROM/Ice Climber (JE)/

Milestone	Date	Note
Pass 1	2026-10-19	6,112 instructions / 12,230 code bytes (74.6 %).
Pass 2	2026-10-19	Restarted from the committed split; 973 labels named (76 semantic + 212 SubC<addr> + 685 internal).
Pass 3	2026-10-19	9 semantic zero-page aliases, the hardware operands substituted, the data tables named.
Promotion	2026-10-19	Top level. The PRG and the header are byte identical to the (U) dump; only the CHR differs.

Ice Climber (U) — NROM/Ice Climber (U)/

Milestone	Date	Note
Pass 1	2026-10-19	6,112 instructions / 12,230 code bytes (74.6 %) - the same PRG as the (JE) dump.
Pass 2	2026-10-19	973 labels named.
Pass 3	2026-10-19	9 semantic zero-page aliases and the hardware operands substituted.
Promotion	2026-10-19	Top level, together with the (JE) dump.

Joypad Test Cartridge (U) — NROM/Joypad Test Cartridge (U)/

Milestone	Date	Note
Pass 1	2026-10-16	Redone: the first pass claimed 282 instructions / 580 bytes (3.5 %), because the tracer halted on DCP $3C20 - an undocumented opcode used as ordinary code - and filed 3,256 bytes of real code as data. Now 1,773 instructions / 3,836 bytes (23.4 %).
Pass 2	2026-10-19	All 202 labels renamed and all 202 routine headers rewritten; the zero-page aliases written.
Pass 3	2026-10-19	47 hardware operands substituted, the data blocks named.
Promotion	2026-10-16	Promoted out of _wip/.

Lode Runner (U) — NROM/Lode Runner (U)/

Milestone	Date	Note
Pass 1	2026-10-18	11,057 lines, 627 label definitions, 52.6 % code, canonical audit comments.
Pass 2	2026-10-20	All 627 labels renamed: 196 semantic routine entries plus 431 derived internal branch targets.
Pass 3	2026-10-20	85 operands substituted, 2 semantic zero-page aliases, the data tables named.
Promotion	2026-10-20	The whole-ROM build was added and the _tools paths moved.

Lunar Pool (U) — NROM/Lunar Pool (U)/

Milestone	Date	Note
Pass 1	2026-10-18	The split was re-derived from a Mesen CDL capture (10,028 bytes of code) after a static trace alone had left most of the game unclassified: now 5,300 instructions / 11,077 bytes (67.6 %).
Pass 2	2026-10-18	705 labels named, zero Label_ residue.
Pass 3	2026-10-18	33 data tables named, 38 semantic zero-page aliases; 45 operands substituted on 2026-10-19.
Promotion	2026-10-18	git mv out of _wip/; the power-on flow and the print-inline-string helper documented.

Mario Bros (JU) — NROM/Mario Bros (JU)/

Milestone	Date	Note
Pass 1	2026-10-20	The committed split was a strict subset of the correct one - only 72.0 % was classified as code. A Mesen CDL capture (10,915 code bytes) showed 1,010 bytes the tracer had left as data were code, and two branch targets the capture never reached were forced by hand, so 1,067 bytes moved from data to code: 78.4 %. The engine's handler tables sit inline, right behind the jsr that reads them.
Pass 2	2026-10-20	206 routine entries and 519 internal branch targets, 931 Label_XXXX definitions gone, 51 raw call operands resolved.
Pass 3	2026-10-20	25 semantic zero-page aliases, each applied only where its role is proven.
Promotion	2026-10-20	Top level.

Millipede (U) — NROM/Millipede (U)/

Milestone	Date	Note
Pass 1	2026-10-18	14,744 lines, canonical audit comments, 74.6 % code.
Pass 2	2026-10-20	All 839 address-derived labels renamed: 12 semantic routine names, 264 SubC<addr> entries and 577 internal branch targets.
Pass 3	2026-10-20	8 semantic zero-page aliases; the data tables named - LevelData, ObjectInitData, AudioData, VectorPageData.
Promotion	2026-10-20	The whole-ROM build was added and the _tools paths moved.

MUSCLE (U) — NROM/MUSCLE (U)/

Milestone	Date	Note
Pass 1	2026-10-16	The bytecode VM layer was decoded: 40 opcodes handled through a table at $9237, so the "data" under the bytecode is code. 5,253 instructions.
Pass 2	2026-10-18	The Pass 1/2/3 output written with the 42 bytecode listings above the .byte data.
Pass 3	2026-10-16	The data names and the structures written. 2026-10-19: 220 operands substituted, zero residue.
Promotion	2026-10-16	Promoted out of _wip/. The one ROM in the set mapped low (PRG at $8000), and the only project with a make regen target that reproduces prg.s byte for byte.

NES PowerPad Test Card (U) — NROM/NES PowerPad Test Card (U)/

Milestone	Date	Note
Pass 1	2026-10-16	A minimal test cartridge: the NMI reads the PowerPad over $4016 and updates the score and the lives, 7.2 % code.
Pass 2	2026-10-19	Labels renamed with the PowerPad group.
Pass 3	2026-10-16	The data tables and the VramWrite streams named. 2026-10-19: 89 hardware operands substituted, zero residue.
Promotion	2026-10-16	Promoted out of _wip/.

Pac-Man (Tengen) (U) — NROM/Pac-Man (Tengen) (U)/

Milestone	Date	Note
Pass 1	2026-10-20	Six command handlers recovered - 120 bytes the tracer had left as data, two of them mis-split across the jmp $EF61 at $F01F and $F04F. 1,637 instruction lines covering 3,273 code bytes (20.0 %). The boot sequence is inline at $C033: this build has no boot code at $FF00.
Pass 2	2026-10-20	A fresh map from this dump's own committed split - no name, map or file was carried over from the other Pac-Man dump. 227 labels (199 routine entries + 28 branch targets), zero Label_ residue.
Pass 3	2026-10-20	30 semantic zero-page aliases, each applied only at the sites where the role is proven.
Promotion	2026-10-20	git mv out of _wip/NROM/.

Pac-Man (U) — NROM/Pac-Man (U)/

Milestone	Date	Note
Pass 1	2026-10-20	19.6 % code; the boot code sits at $FF00, unlike the Tengen build.
Pass 2	2026-10-20	194 Label_XXXX definitions renamed to semantic routine entries plus derived internal branch targets, and all 49 jsr/jmp call sites resolved.
Pass 3	2026-10-20	119 operands substituted (101 hardware + 11 single-name + 7 multi-alias resolved per site).
Promotion	2026-10-20	git mv out of _wip/NROM/.

Pac-Man (USA) (Namco) — NROM/Pac-Man (USA) (Namco)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	524 single-name operands substituted; 727 multi-alias residues left numeric and recorded (an address with two or more aliases, e.g. $00 = workPtr0/Zp00).
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Pinball (JU) — NROM/Pinball (JU)/

Milestone	Date	Note
Pass 1	2026-10-18	4,734 instructions / 9,756 code bytes (59.5 %) - a real disassembly, not a skeleton.
Pass 2	2026-10-18	Substantial: 180 of 681 labels carry semantic names. The "Pass 2 complete" claim of that day was corrected on 2026-10-19 after an audit of the map.
Pass 3	—	Drafted only: the zero-page aliases are not in locals.inc yet.
Promotion	2026-10-20	The whole-ROM build was added; the pass work is still open.

Popeye (JU) (PRG 0) — NROM/Popeye (JU) (PRG 0)/

Milestone	Date	Note
Pass 1	2026-10-18	14,875 lines, canonical audit comments, 72.3 % code, six routine entries seeded from table references.
Pass 2	2026-10-20	All 878 labels renamed: 2 semantic entry names, 315 SubC<addr> entries and 561 internal branch targets.
Pass 3	2026-10-20	4 semantic zero-page aliases, 79 operands substituted, the data tables named - LevelData, AudioData, VectorPageData.
Promotion	2026-10-15	Top-level wave: the build was standardised and the project got its power-on README.

Popeye (JU) (PRG 1) — NROM/Popeye (JU) (PRG 1)/

Milestone	Date	Note
Pass 1	2026-10-18	As the PRG 0 dump, but a different PRG binary.
Pass 2	2026-10-20	All 878 labels renamed.
Pass 3	2026-10-20	4 semantic zero-page aliases and the data tables named.
Promotion	2026-10-20	Promoted out of _wip/.

Pyramid (U) (Sachen) — NROM/Pyramid (U) (Sachen)/

Milestone	Date	Note
Pass 1	2026-10-20	The committed split was a strict subset of the correct one: 828 bytes of code were still marked as data, because the tracer cannot follow a jmp that sits inside a data region. Re-tracing with the sixteen jmp-table targets, the $C800 boot mainline and six further hand-seeded starts recovered them, and lost no committed code byte. 39.6 % code.
Pass 2	2026-10-20	431 routine entries and the 32 data blocks named, 428 Label_XXXX definitions gone, 320 raw call operands resolved.
Pass 3	2026-10-20	24 semantic zero-page aliases, each applied only where its role is proven.
Promotion	2026-10-20	Top level; renamed to Pyramid (U) (Sachen) on 2026-10-21. The unlicensed boot pokes a mapper unlock at $4100 and dispatches through two queued-event tables.

Raid on Bungeling Bay (U) — NROM/Raid on Bungeling Bay (U)/

Milestone	Date	Note
Pass 1	2026-10-20	64.6 % code.
Pass 2	2026-10-20	Labels renamed in the same wave as the other 2026-10-20 promotions.
Pass 3	2026-10-20	11 semantic zero-page aliases added to locals.inc.
Promotion	2026-10-20	Top level.

Raid on Bungeling Bay (U) [a2] — NROM/Raid on Bungeling Bay (U) [a2]/

Milestone	Date	Note
Pass 1	2026-10-20	64.3 % code. A different PRG from the other dump - the two differ in mirroring only per the header, but the PRGs are separate builds.
Pass 2	2026-10-20	Labels renamed.
Pass 3	2026-10-20	15 semantic zero-page aliases added to locals.inc.
Promotion	2026-10-20	Top level.

Tennis (JU) — NROM/Tennis (JU)/

Milestone	Date	Note
Pass 1	2026-10-09	First disassembly; byte identical out of the box.
Pass 2	2026-10-19	Labels renamed.
Pass 3	2026-10-19	18 single-name operands substituted, zero residue.
Promotion	2026-10-09	In the top level from the start - there was no _wip/ tier yet. The build and the per-project power-on README were standardised on 2026-10-15.

Urban Champion (JU) — NROM/Urban Champion (JU)/

Milestone	Date	Note
Pass 1	2026-10-18	2,716 instructions, 33.9 % code.
Pass 2	2026-10-18	436 labels named.
Pass 3	2026-10-19	10 semantic zero-page aliases, 70 operands substituted.
Promotion	2026-10-18	Promoted with the full-ROM build.

Volleyball (U) — NROM/Volleyball (U)/

Milestone	Date	Note
Pass 1	2026-10-21	Every byte of the 32 KB PRG image accounted for as an instruction or an explicit .byte block: 11,395 instructions / 23,926 code bytes (73.0 %).
Pass 2	2026-10-21	1,989 labels named.
Pass 3	2026-10-21	37 named data blocks, zero residue.
Promotion	2026-10-21	Promoted out of _wip/NROM/.

Wild Gunman (U) — NROM/Wild Gunman (U)/

Milestone	Date	Note
Pass 1	2026-10-16	Redone: the original tracer followed only the vectors and the direct calls and knew just the 151 documented opcodes, so it missed the runtime dispatch - the pla based computed goto puts the jump table inline right after the jsr - and filed about 4.9 KB of real code as data. 1,597 instructions / 3,352 bytes (20.5 %) became 3,956 / 8,085 (49.3 %).
Pass 2	2026-10-19	All 733 labels carry names; zero Label_Cxxxx or SubCxxxx remain, and every entry point has a routine header.
Pass 3	2026-10-19	The data tables named - SpriteAttributeTable, NoteVolumeTable, VolumeEnvelopeTable, SpritePositionTable; 76 operands substituted, zero residue.
Promotion	2026-10-16	Promoted out of _wip/.

Xevious (U) — NROM/Xevious (U)/

Milestone	Date	Note
Pass 1	2026-10-20	The static trace from the vectors reached only 13.6 % of the PRG. Declaring both jump tables with --table plus 92 hand-seeded entry points recovered the code behind the computed dispatch, reaching 34.5 %. Re-split on 2026-10-21 from the Mesen CDL (_tools/cdl_reclass.py): 1,158 data→code bytes, 38.0 % code, 6,002 instructions.
Pass 2	2026-10-20	Every routine entry point has a semantic name and every raw $XXXX call operand was replaced. Re-checked after the 2026-10-21 re-split: the 45 recovered entries are named Sub_XXXX; six CDL-silent raw operands remain and are documented in the project README.
Pass 3	2026-10-20	32 named data tables (the $A74B-$B8AA block split into six proven tables on 2026-10-21) and about 20 semantic zero-page aliases.
Promotion	2026-10-20	Promoted out of _wip/.

Zanac (U) — UNROM/Zanac (U)/

Milestone	Date	Note
Pass 1	2026-10-20	The static trace from the vectors reached only 37.9 % of bank 7; banks 0-6 are still raw .byte data, pending the bank-switch analysis.
Pass 2	2026-10-20	133 semantic entry points.
Pass 3	2026-10-20	26 named data tables and 14 semantic zero-page aliases.
Promotion	2026-10-20	Promoted out of _wip/; the only promoted UxROM project, with the fixed bank in its own segment.

Mermaids of Atlantis (U) — MAPPER8/Mermaids of Atlantis (U)/

Milestone	Date	Note
Pass 1	2026-10-21	Redone, bank-aware: the 64 KB PRG is eight 8 KB MMC3 banks, and each is traced separately with the CPU window it is visible at, seeded from a Mesen CDL capture. 8,075 bytes of code (12.3 %) in 494 routines, up from about 200 bytes. The image carries the reset stub and the vector table twice, and the fixed bank is the fourth 8 KB bank rather than the last.
Pass 2	2026-10-21	Every label named, no Label_XXXX left and no raw $XXXX branch or jump operand left; the banks that share a CPU window carry a Bank4_ .. Bank7_ prefix.
Pass 3	2026-10-21	13 semantic zero-page aliases, the routine headers written, the data tables listed in the project README.
Promotion	2026-10-20	Promoted - but the build was broken: a half-applied Pass 2 rename left eight undefined symbols. Rebuilt and verified on 2026-10-21.

---

Adding an entry

For a change to any project, add a line to Pending at the top of this file: name the project, and say what changed. When the commit is made, its message is written from those lines, and they move to History.

For a project that reaches a milestone, the milestone also gets a row in the milestone index below, with the date and a sentence saying what the milestone produced. The numbers that go in the row are the ones the project README and the root README.md already carry: the instruction count, the code coverage, the number of named labels, the number of semantic zero-page aliases and the number of named data tables. A milestone that has not happened gets a - in the date column and a note saying what is still open - the point of the table is that a reader can see at a glance which projects are done and which are not.