# 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 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. | The build fix: `RandomStateAlt = $E4` beside `RandomState0 = $54` for the reused zero page. |

### 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. | The build fix: a `bpl` the flat disassembler had mislabelled at $FAB4, written as `bne *-$1B` to reproduce the ROM bytes. |

### 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. | The build fix: the same `bpl` mislabel, at $E811. |

### 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. | The build fix: two NMI operands that spend their byte on `$11` were emitted with the wrong shadow name. |

### 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.