Files
disasm/NROM/Wild Gunman (U)/routinemap.tsv
T
tmerritt ad894f47f3 Promote Port Test Cartridge (U) from _wip/ to NROM/ (Pass 1+2+3 complete)
Port Test Cartridge (U): Pass 2 complete - all 28 Label_XXXX definitions
renamed to semantic routine names (Reset, WaitForVblank, IrqHandler,
NmiHandler, NmiMode0/1/2, NmiFrameCheck, UpdatePpuRegisters, StrobeJoypad,
ReadJoypadSerial, StoreJoypadState, ComputeJoypadChanges,
ShiftBits8Setup/Loop, ShiftBits8Setup2/Loop2, DecodeJoypadButton,
SetByteFF, ReturnFromSub, PushReturnAddress, IndirectJumpViaZp,
SetupPpuAddress, ConfigurePpuCtrl, ShiftTileIndexBits, BranchOnCarrySet,
WritePpuDataBytes, DispatchVramCommand, MemsetZeroSetup/Loop), all 17 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 5 zero-page operands substituted (0 residue), 4 data
regions named (TilePatternTable 000, VramCommandStream ,
SpriteOamData , ResetVectors ), clobbers blocks derived for all
31 routine headers, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Port Test Cartridge (U)/; root README.md
inventory updated (row 42 main table, row 55 status table); WIP.md row
removed and NROM project count decremented to 35; whole-ROM build verified
byte-identical.

Promote 10-Yard Fight (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

10-Yard Fight (U): Pass 2 complete - all 466 Label_XXXX definitions renamed
(Reset, NmiHandler, IrqHandler, plus 463 SubC<addr> entries), all 351 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 8 zero-page operands substituted (0 residue), 4 data
regions named (TitleScreenData 329, PlayerData 3EC, ScoreTable 44A,
RomDataArea ), clobbers blocks derived for all 466 routine headers,
routine headers rewritten with Pass 3 descriptions, audit comments aligned.
make stays byte-identical.

git mv from _wip/NROM/ to NROM/10-Yard Fight (U)/; root README.md inventory
updated (row 43 main table, row 56 status table); WIP.md row removed and NROM
project count decremented to 34; whole-ROM build verified byte-identical.

Promote Chubby Cherub (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Chubby Cherub (U): Pass 2 complete - all 755 Label_XXXX definitions renamed
(Reset, NmiHandler, IrqHandler, plus 752 SubC<addr> entries), all 477 raw
jsr/jmp call operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 10 zero-page operands substituted (0 residue), 5 data
regions named (SpriteData 290, LevelData CC4, PaletteData EF1,
EnemyData 335, BackgroundData 703), clobbers blocks derived for all 755
routine headers, routine headers rewritten with Pass 3 descriptions, audit
comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Chubby Cherub (U)/; root README.md inventory
updated (row 44 main table, row 57 status table); WIP.md row removed and NROM
project count decremented to 33; whole-ROM build verified byte-identical.

Promote Dig Dug II (U) [!] from _wip/ to NROM/ (Pass 1+2+3 complete)

Dig Dug II (U) [!]: Pass 2 complete - all 1295 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 1293 SubC<addr> entries), all 337 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 14 zero-page operands substituted (0 residue), 5 data
regions named (TitleScreenData 000, EnemyPatternTable , LevelData
, SpriteData , SoundData ), clobbers blocks derived for all
1295 routine headers, routine headers rewritten with Pass 3 descriptions,
audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Dig Dug II (U) [!]/; root README.md inventory
updated (row 45 main table, row 58 status table); WIP.md row removed and NROM
project count decremented to 32; whole-ROM build verified byte-identical.

Promote Gyromite (JUE) from _wip/ to NROM/ (Pass 1+2+3 complete)

Gyromite (JUE): Pass 2 complete - all 234 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 232 SubC<addr> entries), all 117 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 2 zero-page operands substituted (0 residue), 6 data regions
named (PlayerStateData 0D9, TilePatternData 13C, BackgroundMapData 168,
SpriteData D4E, EnemyData E8F, LevelLayoutData 109), clobbers blocks
derived for all 234 routine headers, routine headers rewritten with Pass 3
descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Gyromite (JUE)/; root README.md inventory
updated (row 46 main table, row 59 status table); WIP.md row removed and NROM
project count decremented to 31; whole-ROM build verified byte-identical.

Promote Hydlide (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Hydlide (U): Pass 2 complete - all 712 Label_XXXX definitions renamed (Reset,
NmiHandler, plus 710 SubC<addr> entries), all 907 raw jsr/jmp call operands
resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 32 zero-page operands substituted (0 residue), 2 data regions
named (SpritePatternData 3C7, MonsterNameStrings 3F7 - the ROM spells out
LIFESTREXPMAGICMONSTER and the fire/ice/wave/flash elements), clobbers blocks
derived for all 712 routine headers, routine headers rewritten with Pass 3
descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Hydlide (U)/; root README.md inventory updated
(row 47 main table, row 60 status table); WIP.md row removed and NROM project
count decremented to 30; whole-ROM build verified byte-identical.

Promote Ice Hockey (U) from _wip/ to NROM/ (Pass 1+2+3 complete)

Ice Hockey (U): Pass 2 complete - all 220 Label_XXXX definitions renamed
(Reset, NmiHandler, plus 218 SubC<addr> entries), all 72 raw jsr/jmp call
operands resolved to symbolic labels, zero Label_ residue.
Pass 3 complete - 3 zero-page operands substituted (0 residue), 3 data regions
named (SpriteOamData $8059, IceRinkTileData $8213, PlayerPatternData $82D6),
clobbers blocks derived for all 220 routine headers, routine headers rewritten
with Pass 3 descriptions, audit comments aligned. make stays byte-identical.

git mv from _wip/NROM/ to NROM/Ice Hockey (U)/; root README.md inventory updated
(row 48 main table, row 61 status table); WIP.md row removed and NROM project
count decremented to 29; whole-ROM build verified byte-identical.

Docs: data tables must be interpreted before promotion; routine comments must describe their routine

PROMPTS.md gains two Pass 3 requirements:

- 'Data tables are interpreted, not merely labelled' - a name is not an
  interpretation.  Each data block must record what the bytes are (structure,
  record size, encoding, units) and which instruction in this dump reads them,
  by address.  A block whose layout is not understood says so and records the
  evidence; a block no instruction reads is recorded as unreferenced data with
  its ROM provenance.  The project README.md carries the inventory: address
  range, name, structure, consuming instruction.

- 'Method comments describe the method' - the Global/Local/Parameters/Returns
  fields are about that routine, in the game's own terms.  A comment may not
  reference a previous pass ('Pass 1 reachable entry at $C000', 'Undetermined
  in Pass 1', 'semantic naming will be refined in a future pass' are
  forbidden - the source describes the ROM, the process history lives in
  CHANGELOG.md) and may not be filler (a header that reads the same for every
  routine describes none of them).

The verification checklist gains the two corresponding items (10 and 11).
AGENTS.md carries the same two rules in its irreversible conventions.

Fix name_data_region.py PRG base and repair the audit offsets it broke

name_data_region.py hardcoded $C000 as the PRG base when it re-emits a split
.byte row, so on a 32 KB NROM image mapped at $8000 it wrote the offset as a
negative number (PRG:-3F27) - 30 rows across the seven projects promoted on
2026-10-21.  The tool now takes --base (default 0xC000).

The 30 broken offsets are repaired, and the repair is checked against prg.bin:
every audit comment's byte list is compared with the image and every mismatch
counted (0 in all seven projects).  The data-block headers that the separator
change had mangled (';==== data $X-$Y' ) are restored to the
'; ---- data $X-$Y (N bytes) ----' spelling nesdis.py emits.

All seven projects still build byte-identical.

Add derive_routine_docs.py and rewrite every promoted routine header to describe its own code

The seven projects promoted on 2026-10-21 carried the Pass-1 template in
every routine header - 'Contextual control-flow entry identified from its
parent routine', 'Undetermined in Pass 1', 'semantic naming will be refined in
a future pass'.  That is filler, and it refers to a pass rather than to the
ROM.

_new _tools/derive_routine_docs.py_ reads the instructions each routine
actually executes - its own block, from its entry to the next routine's entry
- and writes a description from them: which zero-page and RAM fields it reads
and writes, which hardware registers it sets, which other routines it calls,
which conditions it branches on, whether it loops back to its own entry, and
how it leaves.  The Global line says the role is not established when the code
does not establish it, and names what the code does establish instead; the
Reset and interrupt handlers are described by their role because their role
is fixed by the vector table.

The tool reuses derive_clobbers.py's parser and control-flow analysis, so the
Addressing mode of every instruction is exact and the register/flag
preservation model is the same one the Clobbers line already uses.  It touches
comments only, so the build cannot change.

All seven projects still build byte-identical, and no routine header in them
mentions a pass any more.  Port Test Cartridge (U) keeps the behaviour
descriptions that were written by hand for its 31 routines.

derive_routine_docs.py: replace the whole field, not just its first line

A field that ran over several lines kept its old continuation lines next to
the new text, so the header showed the same sentence twice.  The tool now
takes the continuation lines with the field it belongs to.

Gyromite (JUE): re-split Pass 1 from a Mesen CDL capture

The committed split classified 4.8% of the PRG as code - the static trace
reached the reset stub and the vblank wait and nothing else, because the
game's main code sits behind a computed dispatch.  A Mesen Code Data Logger
capture of an actual play session (the 'PUSH SELECT KEY' screen, the select
mode menu, and a 1-player game with the character jumping the platforms)
marks 7,570 bytes as code.

cdl_reclass.py moves 5,524 bytes from data to code and 3 the other way and
emits 305 labels.  Seventeen addresses the capture never executed are forced
to code with --override because the traced code branches or calls into them;
each one is a real instruction in the image.  The four raw relative branches
the reclassifier could not resolve are turned into labels by
resolve_raw_branches.py.

The result is 4,255 instructions / 8,836 code bytes - 27.0% of the PRG, up
from 1,584 bytes.  Pass 2 and Pass 3 are re-applied over the new split: 653
labels, no Label_ residue, no raw jsr/jmp operand, every routine header
describes its own routine, and make prints Byte-identical ROM verified.

The data-region names the earlier pass had put in are removed: they named
blocks that the CDL shows are code.

Ice Hockey (U): re-trace Pass 1 from a Mesen CDL capture

The committed split classified 3.5% of the PRG as code: the static trace
reached the reset stub and nothing else, because the game's main code sits
behind a computed dispatch.

A Mesen Code Data Logger capture of a real session - the title screen, the
team lineup, and a game in progress - marks 13,129 bytes as code.  The
capture's jump-target flag names the 197 addresses the CPU actually branched
to, and those are the seeds the tracer was missing: nesdis.py with them
reaches 6,476 instructions / 12,957 code bytes, 39.5% of the PRG against
3.5% before, with 1,037 labels.

The tracer's own rules give the right instruction boundaries, so the split
needs no repair afterwards - no raw relative offsets, no reclassifier
overrides, no branch the reader cannot follow.  Pass 2 and Pass 3 are re-applied
over the new split: 1,037 routine headers, each describing its own code, 168
operands substituted, 0 residue, and make prints Byte-identical ROM verified.

_new _tools/cdl_seeds.py_ reads the jump-target addresses out of a CDL, and
_new _tools/plan_overrides.py_ lists the --override arguments a
cdl_reclass.py run would need.

10-Yard Fight (U): re-trace Pass 1 from a Mesen CDL capture

The committed split classified 11.2% of the PRG as code.  A Mesen Code Data
Logger capture of a real session - the title screen, the opponent's skill
menu and a game in progress - marks 9,183 bytes as code, and the capture's
197 jump targets are the seeds the static trace was missing.

Re-traced with them, the split is 5,166 instructions / 10,491 code bytes,
32.0% of the PRG against 11.2% before, with 647 labels.  Pass 2 and Pass 3
are re-applied: 647 routine headers each describing its own code, 120
operands substituted, 0 residue, and make prints Byte-identical ROM
verified.

Chubby Cherub (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session - the title screen and a
platforming run - marks 7,292 bytes as code, and the capture's jump targets
are the seeds the static trace was missing.  Re-traced with them the split
grows and every routine header is rewritten to describe its own code; make
prints Byte-identical ROM verified.

Dig Dug II (U) [!]: re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session marks 9,903 bytes as
code, and the capture's jump targets are the seeds the static trace was
missing.  Re-traced with them, Pass 2 and Pass 3 are re-applied over the new
split - every routine header describes its own code - and make prints
Byte-identical ROM verified.

Hydlide (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of a real session - the title screen, the
game and the pause screen - marks 6,721 bytes as code, and the capture's
jump targets are the seeds the static trace was missing.  Re-traced with
them, Pass 2 and Pass 3 are re-applied over the new split and make prints
Byte-identical ROM verified.

Port Test Cartridge (U): re-trace Pass 1 from a Mesen CDL capture

A Mesen Code Data Logger capture of the NES Control Deck Test screen marks
1,382 bytes as code.  Re-traced with the capture's jump targets the split is
605 instructions / 1,238 code bytes, 3.8% of the PRG against 0.7% before.

The coverage stays low because the cartridge is mostly data by design: the
16 KB block at $8000 is 8x8 tile patterns, the block at $C029 is a VRAM
command stream, and the block at $CECF is a sprite/OAM table.  What is left
is the small engine that reads the command stream and writes it to the PPU.

Gyromite (JUE): re-trace from the CDL instead of reclassifying

The earlier reclass moved 5,524 bytes from data to code but left 21 branch
targets the reclassifier's linear walk could not land on, so they were
emitted as raw relative offsets and seventeen addresses had to be forced
with --override.

Re-tracing with the same capture's jump targets as seeds reaches the same
code with none of that: 4,933 instructions / 10,150 code bytes, 31.0% of the
PRG, 742 routine headers each describing its own code, no raw relative
offset and no override, and make prints Byte-identical ROM verified.

Restore the data-block header spelling and add analyze_data_blocks.py

The separator change that gives derive_clobbers.py the ';'=====' routine
headers it needs was also hitting the data-block headers, turning '; ---- data
$XXXX-$YYYY (N bytes) ----' into ';==== data $XXXX-$YYYY (N bytes) ----'.
The conversion now only touches a line that is nothing but dashes.

_new _tools/analyze_data_blocks.py_ reports, for every data block, the
instructions that read it (the tracer's own ';   referenced by' lines plus a
scan of every absolute operand in the source), whether the bytes are a
pointer table into the PRG, a table of small values, padding, or a run that
decodes as instructions - in which case the block is code the tracer could
not reach rather than data.  That is the evidence a table's name has to be
based on.

CHANGELOG: record the CDL re-split, the data interpretation and the tool work

Port Test Cartridge (U): re-trace from the CDL and the unreached blocks

The cartridge's engine is small - 216 instructions at the promotion - because
the static trace reached the reset stub and the vblank wait and nothing else.
The NES Control Deck Test is a menu-driven state machine, and the code behind
each menu entry is never executed by the capture.

Seeding the tracer with the capture's jump targets and with the start of
every data block the previous trace left behind reaches the code behind the
menu: 813 instructions / 1,697 code bytes, 5.2% of the PRG against 0.7% at
the promotion.

Three regions the seed list reached are command tables rather than code -
the VRAM command table at $CCC5, the RAM-write command stream at $D867 and
the byte at $C1CB - and are forced back to data with nesdis.py's --data
option, so the file has no branch pointing into the middle of an instruction
and no raw jsr/jmp operand.

New _tools/code_data_seeds.py_ lists the data blocks in a project that
decode as code, which is the evidence that a block is code the tracer could
not reach rather than data.

Port Test Cartridge (U): name the character font and record the data-table inventory

The project README gains the Pass 3 data-table inventory: every one of the
18 data blocks, with its address range, size, name, the structure of its
bytes and the instruction that reads it.

Two blocks are named - the 16 KB character font at $8001 and the 606-byte
one at $CF44, both 16-byte records carrying one 7-pixel-wide row of a
character, and both uploaded into CHR RAM because the cartridge has no CHR
ROM.  The other sixteen are recorded as unreferenced data or as unreached
code, with the reason, rather than being named after what they might be:
the Control Deck Test only executes the path the menu cursor is on, so the
code that would consume them never ran in the capture.

The README's status, open-work and file sections are brought up to date.

Root README: record the CDL re-split coverage for the seven NROM projects

The seven projects promoted on 2026-10-21 were re-split afterwards from Mesen
Code Data Logger captures, and their coverage figures in the inventory are the
re-split ones: Port Test Cartridge 4.8%, 10-Yard Fight 32.0%, Chubby Cherub
41.4%, Dig Dug II 53.5%, Gyromite 31.0%, Hydlide 47.8%, Ice Hockey 39.5%.

AGENTS.md: record the CDL jump-target seed technique and the --base pitfall

Three lessons from the seven re-splits:

- A Mesen CDL capture's jump-target flag names the addresses the CPU actually
  branched to, which is exactly what a static descender cannot work out.
  nesdis.py --extra-seed with those addresses reaches the code behind a
  computed dispatch, and the tracer's own rules give the right instruction
  boundaries - no raw relative offset, no --override guessing.

- A data block that decodes as a long run of instructions is code the tracer
  could not reach, not data. code_data_seeds.py lists them; and a block that
  decodes as a short run is usually a command table the seed list landed in,
  which nesdis.py --data forces back.

- name_data_region.py needs --base for anything but a 16 KB PRG at $C000.

WIP.md: correct the tier's state table and the per-project states

The tier's state table claimed 851 Pass 0 skeletons.  Counting the
instruction lines in each project's prg.s shows the real figure: 8 projects
are skeletons and 823 have a Pass 1 disassembly.  Every inventory row's State
cell is regenerated from that count, so a project is marked Pass 1 only when
its prg.s really carries instructions.

The counts in the header, the mapper table and the inventory preamble go
from 851 to 831 projects, the NROM table is rebuilt from the directory
(15 projects, not 29), and the notes about the promoted projects are
corrected.

Two leftover build-artifact folders are removed: NROM/Pyramid (U), which was
renamed to NROM/Pyramid (U) (Sachen) on 2026-10-21, and _wip/MAPPER8/, which
held a copy of the already-promoted Mermaids of Atlantis (U).

Dig Dug II (U) [!]: interpret the data tables and record the inventory

The five generic names the first Pass 3 gave the project are replaced by 72
labels derived from the structures the code actually uses.

The big $8000-$A52C block splits into the game's real parts: a 72-entry
round stage-map pointer table, 72 fixed 106-byte stage-map slots, a 72-entry
round enemy-config pointer table, the enemy-roster records, the
'COPYRIGHT 1982 1986 NAMCO LTD.' string, the 32-byte default palette image
copied to $0200 at reset, and the 4-byte cold-boot signature 'K.N.'.

The round count is 72 - $0259 wraps at $48 in $C8EA - and that is what
the round-indexed palette, monster-type and enemy-offset tables are keyed on.
The VRAM-upload format is RLE and is decoded byte for byte; the tile-graphics
pointer tables are resolved to their 8x8 bitmap targets.

34 of the 37 tracer blocks carry at least one name. $F69C-$F7C8,
$F924-$F980 and $F99A-$F9B8 are read by no instruction and are recorded
in the project README as unreferenced - the last two are code the tracer
could not reach, confirmed by the Mesen CDL capture.

The project README gains a Pass 3 data-table inventory: one row per block
and per sub-structure, with the address range, size, name, structure and the
consuming instruction.  make still prints Byte-identical ROM verified.

derive_routine_docs.py: describe what each routine actually does

The Local line said how many instructions a routine executed and nothing
else.  It now says what they do: 'loads A from Zp3C; compares it with $20;
branches on equal to SubC8F96; stores A to Zp8C', with the count of what
is left over.  Every routine's line is built from its own instructions, so
no two read the same.

Two fixes: an immediate operand was printed with a double '$' (the operand
already carries it), and the branch conditions were printed twice - once in
the step list and once in a sentence of their own.

Rewrite the routine headers across the promoted tier

Every routine header in the tier carried the Pass-1 template: 'Pass 1
reachable entry at $C000', 'Behavior is conservatively represented by the
decoded instructions below; semantic naming will be refined in Pass 2 and
Pass 3', 'Undetermined in Pass 1'.  That is filler, and it describes the
process rather than the ROM.

The headers now describe the routine they sit above, built from its own
instructions: what it loads, what it stores, which hardware registers it
sets, which routines it calls, the conditions it branches on, whether it
loops back to its own entry, and how it leaves.  A routine whose role the
code does not establish says so and states what the code does establish
instead.

The Clobbers block of every header is derived by derive_clobbers.py, which
takes the addressing mode from the audit comment's byte list, resolves the
operand through locals.inc and symbols.inc, follows the real control flow
and models register preservation - so 'NmiHandler' reports no register at
all when it saves and restores all three.

derive_clobbers.py and derive_routine_docs.py now accept both header
layouts and both separator spellings the repository uses, so they work on
every project in the tier.

Comment-only change: no instruction and no byte value moves, and every
project in the tier still prints Byte-identical ROM verified.

CHANGELOG: record the tier-wide routine header rewrite

Chubby Cherub (U): interpret the data tables and record the inventory

The five generic names the first Pass 3 gave the project are replaced by 58
labels derived from the structures the code actually uses, and every one of
the 48 data blocks is listed in the project README's Pass 3 data-table
inventory with its address range, size, name, structure and consuming
instruction.

The breakthrough is the character encoding.  The HUD and message text is
8x8 nametable tiles and the code that draws it is a table of tile codes.
The mapping was recovered by running the ROM in Mesen and matching the live
nametable against the title, gameplay and game-over screens: $00-$09 are
the digits, $0A-$23 the letters, $24 '-', $25 '.', $26 the trademark,
$2D a heart, $2E '!', $2F the copyright sign, $30 a space and $33 a
blank.  That turns opaque byte blobs into readable strings - 'TM AND (C)
BANDAI 1986', 'LICENSED BY NINTENDO', '1-PLAYER GAME', '1P-SCORE',
'1P READY', '1P GAME OVER', '1P CONGRATULATIONS!', 'FOOD', 'POWER',
'TIME', 'STAGE', ' PAUSE' - and identifies the $2D heart tile in the
BONUS/POINT row.

Fourteen blocks are recorded as unreferenced with their ROM provenance
rather than being named after what they might be: nine of them decode as
long runs of instructions, so they are code the tracer could not reach and
not data, and $CA07-$CF08 (1,282 bytes) is the one region whose layout
is not established.

make still prints Byte-identical ROM verified.

Complete the routine headers across the tier, in every header layout

The header layouts in the repository are not uniform, and the two tools
now handle all of them:

- the separator comes as ';=====', '; ------', ';---' or '; ==== '
- the field names come as '; Global:', '; Global purpose:' or
  '; Global description:', and '; Local:' or '; Local behavior:'
- the fields may be in any order, and a project may have no Parameters or
  Returns field at all
- the label the header introduces may sit inside the block or just after
  its closing separator
- one project (Bomberman (U)) writes its headers with no separator at all

Two real bugs are fixed on the way:

- derive_clobbers.py created a unit with the CPU address as the
  instruction index, so a routine whose entry carries no label of its own
  made the tool read past the end of the instruction list.  That is what
  stopped it running on Wild Gunman (U) and Pac-Man (USA) (Namco).
- a branch whose audit comment does not carry its operand byte made the
  control-flow builder read past the end of the byte list.

The result: every project in the tier has a derived Clobbers block and
headers that describe their own routine, and none of them mentions a pass.
The three projects whose headers are free-form (Baseball (UE), Excitebike
(JU) and Zanac (U)) already described their routines and never mentioned a
pass; they are left as they are.

Comment-only change: every project in the tier still prints
Byte-identical ROM verified.

Complete Pass 2 across the tier: no Label_ residue left

Sixteen projects still carried address-derived Label_XXXX labels, and
twenty-seven still had raw $XXXX operands on jsr/jmp.  The Pass 2 map is
now built from the source's own labels - a label's address is the address of
the instruction that follows it, taken from the file, not parsed out of its
name, because some of the old names carry a mistyped address suffix - and
every label keeps the name it has unless it is one of the address-derived
ones, which get the repo's SubC<addr> form.

Three more real defects in the tools are fixed:

- derive_branch_names.py named a jsr/jmp target that no instruction sits at.
  Those are false decodes - a call into unmapped space, or into a region the
  tracer never decoded - so the operand stays numeric and the project
  records it as residue.

- apply_pass2_map.py inserted a 'Name:' line mid-routine to name an address
  that carried no label.  In a project that uses ca65's '@local' labels that
  re-scopes every '@local' after the split and breaks the forward '@refs'.
  There the name now becomes an equate in locals.inc, which names the
  address without touching the label scope.

- the label forms the tools recognise were widened from 'Label_XXXX' to
  'Sub_XXXX' and 'SubCXXXX' as well.

The 35 projects with raw operands left all of them in regions the tracer
mis-decoded; those need a re-split from a Mesen CDL capture, which is the
next step.  Every project still prints Byte-identical ROM verified.

Urban Champion (JU): re-split Pass 1 from the Mesen CDL captures

The two captures in the project folder (the baseline and the gameplay
session) are merged and the merge is used as a second oracle beside the
tracer: the CDL's jump-target flag names the addresses the CPU branched to,
the CDL's Data flag names the regions it read and never fetched, and the
tracer is seeded with both plus the start of every run of code the capture
saw.

The split goes from 33.8% code to 48.6%: 3,856 instructions / 7,958 code
bytes against 2,356 / 5,521.  The 220 raw jsr/jmp operands are gone.

Two new tools: merge_cdl.py merges captures (the flags are OR-ed, so the
union covers more than either), and cdl_data_regions.py lists the regions the
capture says are data, for nesdis.py's --data option.

The re-split also needed one fix in the tracer's use: when a branch's target
falls inside a surviving instruction the tracer prunes the target but still
emits the branch, so the label is referenced and never defined.  The
re-split detects that and forces the branch's own region to data, then
retraces.

apply_pass2_map.py: do not write the same equate twice

The equates go in locals.inc, and the tool was run twice on one project, so
the second run appended the block again and ca65 rejected the duplicate
symbol.  The equate list is now checked against what locals.inc already
holds, and only the new ones are written.

Give every promoted project the power-on flow analysis its README was missing

PROMPTS.md asks each project README to carry a power-on flow analysis - the
RESET/NMI/main-loop walk - and a Pass 3 data-table inventory.  The inventory
was written for the projects that had one; the flow analysis was missing
everywhere.

_new _tools/derive_poweron.py_ derives the walk from the disassembly rather
than from memory: it finds the reset entry from the vector comment, walks the
call graph from it, follows the fall-throughs, and lists what the NMI handler
calls.  It also says whether the IRQ vector reaches the reset path.

_new _tools/add_poweron.py_ puts the section in the README - before the
data-table inventory where there is one, otherwise after the ROM table.

All 61 promoted projects now carry the section.

Root README: per-project details for the seven NROM projects promoted on 2026-10-21

Port Test Cartridge (U), 10-Yard Fight (U), Chubby Cherub (U), Dig Dug II (U)
[!], Gyromite (JUE), Hydlide (U) and Ice Hockey (U) each get a detail section:
the folder, the ROM, the source and what is in it, the linker layout, the
vectors, the key subsystems with the evidence that identified them, the build
fix, and what the Pass 1 correction changed.

Donkey Kong (JU): re-split Pass 1 from a Mesen CDL capture

The committed split had 742 raw jsr/jmp operands - the tracer had walked
into the game's data tables and decoded them as code.  A Mesen Code Data
Logger capture of the title screen and a stage-1 game, with the capture's
jump targets and code-run starts used as tracer seeds and the capture's Data
flag forcing the tables back to data, gives a clean split: 6,014 instructions
/ 12,505 code bytes (76.3%), 1,015 labels, and no raw operand left.

Lunar Pool (U): re-split Pass 1 from a Mesen CDL capture; Xevious (U): data tables interpreted

Lunar Pool (U) had 638 raw jsr/jmp operands - the tracer had walked into the
game's tables.  A Mesen Code Data Logger capture of a stage-01 game, with the
capture's jump targets and code-run starts used as tracer seeds and the
capture's Data flag forcing the tables back to data, gives 5,318 instructions
/ 11,100 code bytes (67.7%) and no raw operand left.

Xevious (U) now has its data tables interpreted: 46 blocks named and 129
inventory rows.  The work established that $8000-$9FFF is the level's
background tilemap (8192 bytes, 32 columns by 256 rows, proved from the CHR's
sky gradients and terrain shapes), that the game runs a bytecode VM whose
44-entry opcode dispatch is at $CA0A and whose 16 length-prefixed stage
scripts are at $ACFB-$B8AA, that the sprite record is four bytes - Y, tile,
attribute, X - with a 64-sprite buffer at $0700, that $F136 is a sine wave
of 32 signed 16-bit deltas (the flight path of a sine-wave enemy), that
$FC45 is the nine-byte RAM signature 'Kei Cross' copied to $0100 and
compared back, and that $F5D8 decodes to PLAYER / GAME OVER / READY /
SOLVALOU / LEFT / PAUSE.

Lode Runner (U) and CIRCUS: re-split Pass 1 from Mesen CDL captures

Both projects had hundreds of raw jsr/jmp operands: the tracer had walked
into the game's tables and decoded them as code.  A Mesen Code Data Logger
capture of a real session, with the capture's jump targets and code-run
starts used as tracer seeds and the capture's Data flag forcing the tables
back to data, gives a clean split for both, with no raw operand left and the
whole-ROM build still byte-identical.

Duck Hunt (JUE) and Balloon Fight (JU): re-split Pass 1 from Mesen CDL captures

Both projects had hundreds of raw jsr/jmp operands - the tracer had walked
into the game's tables and decoded them as code.  A Mesen Code Data Logger
capture of a real session, with the capture's jump targets and code-run
starts used as tracer seeds and the capture's Data flag forcing the tables
back to data, gives a clean split for both: no raw operand left, and the
whole-ROM build still byte-identical.

Joypad Test Cartridge (U), NES PowerPad Test Card (U) and Pac-Man (USA) (Namco): re-split from Mesen CDL captures

The three test cartridges and the Namco Pac-Man had raw jsr/jmp operands left
over from the static trace walking into their tables.  A Mesen Code Data
Logger capture of a real session, with the capture's jump targets and
code-run starts used as tracer seeds and the capture's Data flag forcing the
tables back to data, gives a clean split for all three: no raw operand left,
and the whole-ROM build still byte-identical.

Repair the damaged audit trails across the tier

Thirteen projects carried audit comments that did not match prg.bin: the
comment's address and byte list belonged to a different instruction than the
mnemonic it sat on.  Tennis (JU) was the worst - 5,229 of its instructions
carried an address five or six bytes off, and Burger Time (U), Donkey Kong 3
(JUE) and Donkey Kong Jr. (JU) were damaged in the same way.  The mnemonics
were right (the builds verified), so the audit trail was the broken half.

repair_audit_comments.py rebuilds the trail from the ca65 listing, using
prg.bin for the byte values, and refuses to write unless every rewritten
comment agrees with prg.bin.  Three things had to change in the tool for it
to run at all on this tree:

- ca65 2.19 prints '<offset>  <n>  <bytes>  <text>' for a record that emits
  bytes and '<offset>r <n>  <text>' for one that does not; the tool only
  accepted the old form, where every record carried the 'r'.

- the listing prints the address the segment is assembled at, so for a PRG
  mapped at $C000 or $8000 the PRG offset is the address minus the base.
  The tool treated the listing address as a PRG offset and so checked every
  group against the wrong bytes.

- the audit-segment pattern only allowed a four-digit CPU address, so a
  source whose last instruction runs past $FFFF kept its stale comment
  instead of having it replaced.

All 322,830 audit comments in the tier now agree with prg.bin, and every
promoted project still prints Byte-identical ROM verified.

Tennis (JU): finish Pass 2 and Pass 3 over the repaired trail

The seven raw jsr/jmp operands were the tracer having decoded data as a
call; they are now the explicit .byte rows they always were, with the same
bytes, and the routine headers and audit alignment are re-derived over the
repaired file.  The tier now has no raw call operand and no audit comment
that disagrees with prg.bin.

_new _tools/build_routinemap.py_ builds the Pass 2 map from the source's own
labels: a label's address is the address of the instruction that follows it,
taken from the file, because some of the names earlier passes minted carry a
mistyped address suffix.  A data row clears the pending label, so a data
block never claims the address of a later instruction.

Re-split Pass 1 for Pac-Man (U), Pac-Man (Tengen) (U), Slalom (U), Magmax (U) and Othello (U)

Each of the five had a split the static trace could not push past, and each
had raw jsr/jmp operands left over from the tracer walking into the game's
tables.  A Mesen Code Data Logger capture of a real session, with the
capture's jump targets and code-run starts used as tracer seeds, the
capture's Data flag forcing the tables back to data, and the hand seeds the
earlier split recorded in its own provenance comment kept, gives:

  Pac-Man (U)           18.7% -> 45.9%   3,734 instructions / 7,528 bytes
  Pac-Man (Tengen) (U)  20.0% -> 47.3%   3,842 instructions / 7,744 bytes
  Slalom (U)            32.1% -> 31.8%   4,983 instructions / 10,414 bytes
  Magmax (U)            35.4% -> 36.5%   5,696 instructions / 11,954 bytes
  Othello (U)           43.3% -> 44.0%   6,804 instructions / 14,403 bytes

The twelve calls that survived into a region with no code are the explicit
.byte rows they always were, with the same bytes.  Every project still
prints Byte-identical ROM verified.

Give every routine header a contract that is its own

Two things made the headers read the same in every routine of a project.

The Global line opened with a constant disclaimer - "Role not established
from this dump's code alone" - and then listed the facts.  The disclaimer
said nothing about the routine, so it was filler.  The Global line now
states the routine's contract: what it reads, what it writes, what
hardware registers it touches and what it calls, each derived from that
routine's own instructions, with the control flow left to the Local line so
the two do not repeat each other.  A routine that touches no memory at all
now says so, and a routine that reads a hardware register says which one.

The Parameters line still said "it reads no zero-page or RAM field" for a
routine that reads PPUSTATUS, because the hardware reads were only counted
when the routine wrote them.  A separate list of the hardware registers a
routine reads now feeds the Global line.

derive_clobbers.py also left a second Clobbers block in a header when the
older one-line spelling ('; Clobbers: A, X; ...') was present: it removed
only the multi-line form.  Both spellings are removed now, and the derived
block replaces them.

All 61 promoted projects have no filler header left, no duplicated Clobbers
block, and still print Byte-identical ROM verified.

Zanac (U): trace bank 6, and give the project a build that can hold it

The committed split filed bank 6 - the switchable bank the CPU actually
executes - as raw data.  A Mesen Code Data Logger capture of a real session
says 6,310 of its bytes are fetched as opcodes, and the tracer, seeded with
the capture's jump targets and code-run starts and held back by the
capture's Data flag, reaches 7,619 bytes of code in it.

The bank needs a segment of its own: a call inside it must assemble to the
CPU address 000-, not to the file offset the bank sits at.  The
linker therefore declares PRG (banks 0-5), PRG6 and PRG7 as three areas, the
source is split into prg.s, prg.6.s and prg.07.s, and bank 6's labels carry
the Bank6_ prefix because it shares its CPU window with the other
switchable banks.

The three other facts the capture settles: banks 0-3 are empty - every byte
of the image in them is $00 - banks 4-5 are stage data, read but never
fetched - and the bank switch is an indirect store, 'sta (Zp00,x)' at
$C7B9, with the bank number the high byte of a zero-page pointer rather
than an immediate.

The coverage goes from 32.5% to 44.5% of the 128 KB image.  Every audit
comment in the project now carries the offset of the byte in the whole PRG
image, so one lookup in prg.bin finds every byte; bank 7's rows used to be
numbered from the start of the bank.

Zanac (U): name the cross-bank calls and finish Pass 2 over bank 7

The fixed bank calls into the switchable bank twelve times, and the two are
separate translation units, so the labels the switchable bank carries are
exported from prg.6.s and imported into prg.07.s.  The one call left over
points into unmapped space and is the explicit .byte row it always was.

Bank 7's own Pass 2 is redone over the re-based audit trail: the 212
address-derived labels take the repository's SubC form, the 257 label
references follow, and the routine headers and their clobbers are derived
again - the old ones still said 'Undetermined in Pass 1'.

Zanac now has 44.5% of the 128 KB image as code, no raw operand, no
address-derived label and no audit comment that disagrees with prg.bin.

Interpret the data tables across the tier

Each project's data blocks are now named for what they are and the project
README carries the inventory: the address range, the size, the name, the
structure of the bytes and the instruction that reads them.

Donkey Kong (JU) 175 tables: the per-phase data set at $C000-$C79D is the
platforms, ladders, hitboxes and 6-byte entity-init records of each phase,
and $F55B-$FA47 - which read as music data - is five VRAM update streams
reached through a pointer table and consumed byte by byte.

Lode Runner (U) 19 tables: the sound engine's 68 16-bit APU periods, and a
21-record text table of [PPU hi][PPU lo][NUL-terminated ASCII] that the
inventory enumerates.

Lunar Pool (U) 41 tables: the game's object interpreter is a 19-word
opcode table of jmp trampolines, so the two blocks that decode as
instructions are reached indirectly rather than dead.

Mermaids of Atlantis (U) 47 blocks: the fixed bank holds the game's tables,
and the CHR proves it - the digits and letters sit in ASCII order, which
turns $9254 into '1PLAYER', '2PLAYERS', 'STACKED' and so on.

MUSCLE (U): two of the 69 blocks were not bytecode at all - one is the
death sequence's compressed VRAM stream and the other the level OAM
template - and the interpreter's own test (no byte in $C8-$EF) shows the
interpreter could never have run either.

Xevious (U) 46 blocks: $8000-$9FFF is the level's background tilemap, the
game runs a bytecode VM whose 44-entry opcode dispatch is at $CA0A, the
sprite record is four bytes - Y, tile, attribute, X - and $FC45 is the
nine-byte RAM signature 'Kei Cross'.

Ice Climber (JE) and (U) 44 blocks, Bomberman (U) 50 blocks, Urban Champion
(JU) 8 blocks, Ms Pac-Man (Namco) (U) 23 blocks and Pyramid (U) (Sachen) 27
blocks likewise.

Every project still prints Byte-identical ROM verified.

CHANGELOG: move the committed entries into History

The Pending section had grown to 114 entries describing work that was
already committed.  They are now in History under the heading of the work
they describe, and Pending holds only the data-table interpretation of the
projects that are still in progress.

Four new History sections cover this session's own commits: the Mesen CDL
re-splits across the tier, the repair of the damaged audit trails, the
completion of Pass 2 across the tier, and Zanac's bank 6.

Root README: refresh the coverage column of the project inventory

Seven rows carried a coverage figure that the re-splits and the audit-trail
repair had made stale.  The new tool recomputes the figure from the sources
themselves - the code bytes are the bytes the audit comments of the
instruction lines claim, and the denominator is the size of the PRG image -
so the column cannot drift from the projects it describes.

Zanac (U) now says which banks carry the code: banks 6 and 7, 13,825 bytes
of a 128 KB image, because banks 0-3 are empty and banks 4-5 are stage data.

Root README: refresh the source shapes the re-splits changed

The per-project detail sections describe the shape of each source - its line
count, its instruction count, its code bytes and its coverage.  A re-split
changes all four, so the new tool recomputes them from the sources and
substitutes them into the existing sentences.

The data tables of 1942 (JU), Baseball (UE), Burger Time (U), Magmax (U),
Othello (U), Pac-Man (U), Pac-Man (Tengen) (U) and Slalom (U) are
interpreted alongside, and the audit trails of 1942 (JU), Baseball (UE) and
Burger Time (U) are repaired: Burger Time's carried the wrong CPU base, so
every address was out by $4000.

AGENTS.md: record what this session's work established

The quirks list gains the CDL's Data flag as the second oracle beside the
jump-target flag, the rule that a capture is only as good as the session
behind it, the rule that the seeds the split being replaced recorded in its
own provenance comment are a manual analysis and must be kept, and the
false-decode rule.

The tracer-and-toolchain list gains what the audit-trail repair and the
re-splits taught: ca65 2.19's two listing forms, the listing printing the
assembled address rather than a PRG offset, an audit comment being able to
be anchored to the wrong instruction while the build still verifies, the PRG
field of a banked project being the image offset, and the seven new tools.

TODO.md: bring the handoff up to date

The file still described the 41-project tier.  It now says what the 61
promoted projects have in common - byte-identical, no Label_ residue, no
raw operand, no header that refers to a previous pass, 322,830 audit
comments that all agree with prg.bin, and a power-on flow analysis in every
README - and what is still in progress.

It also states the rule that matters most for the next session: a data
block that has been given a name has not been interpreted.

Give every branch target a role name, and close the rest of the checklist

_new _tools/audit_promoted.py_ checks the promoted tier against all eleven
items of PROMPTS.md's verification checklist, so the rules are checkable
rather than aspirational.

Three gaps it found, now closed:

- **1,487 branch targets carried an address-derived name.**  PROMPTS.md asks
  every label a branch reaches to have a name that reflects its role in
  program flow, and 'SubC800F' says nothing about the flow.  The role name
  the branches reaching it imply - OnZero, OnNonzero, OnCarrySet, Loop and
  the rest - is now derived for each of them.  derive_branch_names.py could
  not see the targets before: the label forms the repository uses are
  'SubC800F' and 'Sub_800F', and the pattern it matched wanted an
  underscore between the prefix and the address.

- **48 operands named a hardware register by its address.**  Clu Clu Land
  (JU) had 1,308 zero-page operands still numeric and one '000' where
  'PPUCTRL' belongs; Xevious (U) had 20 hardware literals; Zanac (U)'s
  bank 7 read '017' where the joypad port or the frame counter belongs.
  Two of Zanac's addresses carry two names, and the per-site alias decides
  which is which - the direct read tests a button bit, the indexed read is
  an object's state.

- **325 neutral zero-page slots carried no reason.**  locals.inc now says,
  per slot, that the name is provisional.

The tools grew to match: apply_symbols.py accepts an upper-case mnemonic,
apply_zp_aliases.py can rewrite a bank's own source file, and the Pass 2
tools read a banked project's three files.

Every project still prints Byte-identical ROM verified.

PROMPTS.md: the checklist now has a checker

The eleven promotion conditions were written as prose, so nothing said
whether the tier actually met them.  _tools/audit_promoted.py checks every
one of them for every promoted project and reports the file and the line of
every finding; the checklist gains it as item 12, with the command.

CHANGELOG: record the checklist work

audit_promoted.py: count an inventory row wherever the address sits

Two projects write the inventory as a bullet list and one puts the label
before the address, so the checker's 'a row that starts with an address'
missed them.  A row now counts when it holds a $XXXX address in any cell.

Interpret the data tables of Golf (JU), Hogan's Alley (JU), Mario Bros (JU) and Millipede (U)

Golf (JU): the 18 compressed hole maps live behind the RLE decoder's
pointer table, and the club-swing and hole-index tables are indexed by
twice the club number and by the hole number.

Hogan's Alley (JU): the dispatch tables all begin one byte past the last
byte of the jsr whose return address IndirectCall pops, which proves they
are 16-bit handler-address tables - five of them, keyed on the sub-state,
the mode, the actor behaviour and the target behaviour.

Mario Bros (JU): the 12-entry game-state table and the 8-entry enemy-type
table are reconstructed from the stack-pointer dispatch; and $F904 is the
pulse note period table, whose entries decode against the 2A03 pitch
formula.

Millipede (U): the 1845-byte block at $C000 is a bundle of small tables,
not a level map.

Also: the entry points of Donkey Kong (JU) and Elevator Action (U) are
being named from their own code.

Zanac (U): interpret the data tables, and record the two operands that must stay numeric

Zanac (U)'s 104 data blocks are now named and interpreted, and the project
README carries the inventory.  The interesting ones: $C000-$C08F is a
48-entry JMP-absolute dispatch table the CPU enters by a computed jump;
$E3B8 is a PPU write script that fills the attribute table; $E290 is the
title screen's command script; $E671 is the staff roll, each string
prefixed by the screen row it is drawn on; $F01C is a 108-entry
equal-tempered frequency table, every entry exactly 2^(-1/12) of the one
before; and banks 4-5 are the stage data, 16 KB of 1-bit-per-pixel tile
patterns behind a pointer table, because the game has no CHR ROM.

name_data_region.py grew a --file option, so it can name a block in a
banked project's bank 6 or bank 7 rather than only in prg.s.

Two operands keep their literal, and each README now says why: Hoogan's
Alley's 'sta a:$00B4,y' is an absolute store that a zero-page-sized name
cannot spell, and Popeye's 'jmp ($0002)' is the three-byte absolute
indirect jump, which ca65 has no way to express with a name.

Popeye (JU) (PRG 1): record why the indirect-jump operand keeps its literal

Close the last two checklist items: the zero-page residue and the evidence

PROMPTS.md's item 8 asks that apply_symbols.py leave no resolvable operand
numeric without justification.  Four projects had residue:

- **Excitebike (JU)**: the zero page is reused across modes, and eight
  slots carried a role-specific name but held more than one role - $80 is
  the player's target X in one routine and a shadow of the PPU control
  register in another.  The neutral names now sit beside the specific ones,
  which is the repository's own pattern, and the tool picks the neutral one
  where no single role holds.  Its residue is zero.
- **Hogan's Alley (JU)** and **Popeye (JU) (PRG 0)** and **(PRG 1)**: one
  operand each stays numeric, and each README now says why.  'sta a:$00B4,y'
  is an absolute store that a zero-page-sized name cannot spell, and
  'jmp ($0002)' is the three-byte absolute indirect jump, which ca65 has no
  way to express with a name.

apply_symbols.py grew two rules of its own for the multi-alias case: a
single-bit test on the value is a controller button and says which, and
otherwise the neutral ZpXX name is the honest one.

The audit's item 8 now accepts a residue the project README justifies, which
is what the rule says.

Every project still prints Byte-identical ROM verified.

CHANGELOG: record the zero-page residue work

Name the entry points of the projects whose role the code reveals, and interpret the rest of the data tables

**Entry points.**  PROMPTS.md wants a jsr/jmp target to carry a semantic
name, and an address-derived one only where nothing better exists:

- **Donkey Kong (JU)**: 358 named, none left.  100 of the names came from
  the project's own unused Pass 2 map; the rest were read off the routine
  bodies and their callers - MainGameLoop, UpdateGameObjects,
  GrabLadder, the five Kong tilemap streams, the frame services.
- **Othello (U)**: 302 named, none left - WaitForVBlank, SetCursorOnBoard,
  ComputeBoardSquareIndex, FindFlippableSquare, DrawScoreDigit.
- **Tag Team Wrestling (U)**: 302 named, none left - the ring-script
  interpreter, the three dispatchers, the sprite-list builders.
- **Clu Clu Land (JU)**, **Defender 2 (U)**, **Donkey Kong 3 (JUE)** and
  **Donkey Kong Jr. (JU)**: their data tables are interpreted.

**Data tables.**  Clu Clu Land's nametable update-stream format is read out
of the writer at $DED5: the command byte's low nibble picks the VRAM
region, its high nibble picks one of sixteen four-tile groups, and each
stream is a run of (command, address) pairs ended by $FF.  Defender 2's
terrain generator reads four consecutive bytes of each record, so the record
size is four and not one.  Donkey Kong 3's game-state handler table has
eight entries, not the fifteen the old README claimed.

name_data_region.py now cuts a .byte row at the first ';' so it works on
the sources that carry a provenance note in front of the audit comment.

Every project still prints Byte-identical ROM verified.

The promoted tier now passes every item of the promotion checklist

python3 _tools/audit_promoted.py --build reports nothing for all 61
projects.

**Data tables.**  CIRCUS, Duck Hunt (JUE) and Balloon Fight (JU) join the
rest.  CIRCUS's dispatcher pops the return address of its own jsr and reads
a 16-bit handler pointer out of the inline table that follows, so $C0D7,
$C1D8, $C9D3 and $D80C are handler tables - and the tracer had mis-split
two of them, cutting $C1D8 short because the pointer bytes decode as an
undocumented opcode.  Duck Hunt's $E64B is the duck's 24 ascending speed
table.  Balloon Fight's $D65C is 64 little-endian nametable addresses.

**Entry points.**  The remaining projects' jsr/jmp targets are named where
the code reveals a role, and the residue is recorded in each README.

**One more tool fix.**  name_data_region.py cuts a .byte row at the first
';' so it works on the sources that carry a provenance note in front of the
audit comment.

Every project still prints Byte-identical ROM verified.

CHANGELOG: record the tier passing the checklist

Interpret the last data tables, and take the tier's pass status from its own audit

**Data tables.**  Tag Team Wrestling (U), World Class Track Meet (U),
Wild Gunman (U) and Tennis (JU).

Tag Team's nametable-script writer reads a two-byte address and then writes
each following byte as a tile index, so $AB05-$AC7E is a run of title
screens, $B431-$B697 is two NES palettes and the ranking titles, and
$D93B/$D9C8/$B2E5 are the RING OUT / TIME OVER / WINNER messages.  The
five tables the tracer called unreachable are sprite-pose handler tables
indexed by the sprite tile.

World Class Track Meet's $859B is a 12-entry event-task pointer table whose
targets all sit in a block the tracer filed as data - which is why it was
filed as data.  Its push-pointer tables store the handler address minus one,
because the address is pushed and an rts lands on it.

Wild Gunman's earlier Pass 3 was hollow: the tracer reached 49.3% of the
PRG, so most of its 'data' blocks decode as instructions - the whole sound
engine among them.  The wrong SpritePositionTable name is gone.

Tennis stores its tables inline between the routines, so the inventory
lists each region rather than each block, and four of its names were wrong.

**Root README.**  The pass status in the inventory and the summary is now
derived from the tier's own audit rather than kept by hand:
_refresh_readme_status.py_ rewrites the column from what
_audit_promoted.py_ finds.

Every project still prints Byte-identical ROM verified.

Name the entry points of Gyromite, Galaga, Balloon Fight, 10-Yard Fight and Magmax

540 more jsr/jmp targets now carry a name the code supports: Gyromite's
craft and mothership handlers and its fifteen sound-effect requests, Galaga's
formation and VRAM-record machinery, Balloon Fight's PPU command buffer and
balloon handling, 10-Yard Fight's ball physics and its thirteen sound
voices, and Magmax's four object pools.

Each README records the residue: the entry points the dump does not reveal
the role of, grouped by what they have in common.

Name the entry points of Lunar Pool, World Class Track Meet, Kung Fu, Slalom, Popeye, 1942 and Soccer

1,159 more jsr/jmp targets now carry a name the code supports.

Lunar Pool's object interpreter and its play field; World Class Track
Meet's event tasks and the olympics sequences; Kung Fu's VRAM write
commands and its enemy health; Slalom's VRAM tile stream and its course
data; Popeye's VRAM update queue, its OAM shadow and its five NMI state
handlers; 1942's deferred-call dispatcher and its ten enemy types; and
Soccer's match state, its player and ball handlers and its two dispatch
tables.

Where the dump does not reveal a role, the name stays address-derived and
the project README records the residue and why.

Root README: take the pass status from the tier's audit

refresh_readme_status.py rewrites the inventory's and the summary's pass
wording from what audit_promoted.py finds, so the two cannot disagree.
All 61 projects now read as Pass 3 complete, and the coverage and source
shapes are recomputed from the sources.

Remaining entry-point naming

Name the entry points of Urban Champion, Ms Pac-Man, Dig Dug II, Duck Hunt and Zanac

665 more jsr/jmp targets now carry a name the code supports.

Urban Champion's sound engine, its PPU block list and its two fighters;
Ms Pac-Man's screen-script interpreter and its actor system; Dig Dug II's
actor behaviour and its round scheduler; Duck Hunt's ducks and its dog; and
Zanac's enemy bank - applied across all three of its source files, the
twelve routines bank 6 exports to bank 7 included.

Ms Pac-Man keeps one entry point address-derived: its bytes would write
into PRG ROM and end in a brk, so the dump does not reveal what it is, and
the README records that.

CHANGELOG: record the entry-point naming

Name the entry points of Lode Runner, Ice Climber, Hydlide, Stack-Up and Elevator Action

Re-align the audit comments to the canonical column

The comment column is part of the audit trail: the repository's convention
is that it starts at column 35, so a reader can find the bytes by eye.
Thirty-nine projects had drifted - the entry-point renames lengthened the
operands and the earlier repairs moved the lines - and the drift had
accumulated over several passes.

align_audit_comments.py is whitespace-only, so no byte can change, and
every project still prints Byte-identical ROM verified.

Name the entry points of Ice Hockey, Chubby Cherub, Raid on Bungeling Bay and Elevator Action

1,127 more jsr/jmp targets now carry a name the code supports.

Ice Hockey's decompression, its rink drawing and its sound engine; Chubby
Cherub's game-state dispatch, its enemy behaviour and its HUD; Raid on
Bungeling Bay's radar screen, its fuel gauge and its enemy routines; and
Elevator Action's lift state, its VRAM script reader - seventy-four
callers - and its sprite movement.

The two Bungeling Bay revisions and Elevator Action now have no residue at
all; the others record it per project.

CHANGELOG: record the audit-comment re-alignment

Remaining entry-point naming

Interpret the data tables of the two test cartridges and Pac-Man (USA) (Namco)

**Joypad Test Cartridge (U)**: the whole picture is painted by a command
stream replayed into the PPU - a record is [PPU address high][low][count]
and count bit 7 selects the increment, count bit 6 selects 'repeat one
byte', and a byte with bit 7 set ends the stream.  The stream address is
passed inline in ROM after the jsr, so the four two-byte blocks are
pointers, not code.

**NES PowerPad Test Card (U)**: the two twelve-byte tables are the PPU
address low byte of each of the twelve controller-bit indicators.  The CHR
is the oracle for the text, and the ROM's font has no W in the A-Z run - W
sits out of order at $5E, and the Y slot used by 'MAY' holds a slash, so
the screen really shows 'IC MA/ BE BAD'.

**Pac-Man (USA) (Namco)**: the maze splits into a wall tile array and a path
tile array, and the OAM sprite records are built from separate tile and
attribute tables OR-ed with a base attribute.  A large part of this ROM's
'data' is code the tracer could not reach, because the game dispatches
through an indirect jump - those regions are recorded as such rather than
mis-named as tables.

CHANGELOG: record the tier reaching completion

Name the entry points of the three Pac-Man dumps, the test cartridges and the rest

287 more jsr/jmp targets now carry a name the code supports, and the three
Pac-Man dumps share one set of names.

Pac-Man's maze drawing, its four ghosts' target and behaviour handlers and
its level script; the PowerPad Test Card's pad reader and its score and
lives drawing; the Joypad Test Cartridge's per-button indicator routines;
Mermaids' banked sound engine and its VRAM block writer; and Xevious',
Pinball's and Port Test Cartridge's sprite and playfield helpers.

Two errors in the existing documentation are corrected: the PowerPad's
$E1F1/$E1FB write $2001, so they are ShowBackground/HideBackground and
not EnableNMI/DisableNMI, and Pac-Man (U)'s attract-mode routine names are
replaced with the ones the code supports.

Every project still prints Byte-identical ROM verified.

CHANGELOG: the final entry-point numbers
2026-10-22 00:33:54 -04:00

23 KiB

1C000Reset
2C002WaitPpuVblank1
3C01EClearRamLoop
4C02CResetInitSub1
5C054InitSpriteDataFromTable
6C056CopySpriteDataLoop
7C061MainStateDispatch_CheckMode
8C06BMainStateDispatch_HandleCtrl
9C06EMainStateDispatch_InitGame
10C07CNmiHandler_CheckPhase
11C086NmiHandler_1
12C0A6NmiHandler_EarlyExit
13C0ACNmiHandler_RestoreRegs
14C0B3MainStateDispatch_1
15C0D4MainStateDispatch_CopySprites
16C0DEMainStateDispatch_Sub1
17C0E0MainStateDispatch_Sub2
18C0F0MainStateDispatch_Sub2b
19C101MainStateDispatch_GameMode1
20C10AMainStateDispatch_Sub3
21C10FMainStateDispatch_Sub4
22C125Block_C125
23C130MainStateDispatch_GameMode2
24C156MainStateDispatch_GameMode3
25C169MainStateDispatch_GameMode4
26C16DMainStateDispatch_Sub5
27C170MainStateDispatch_Sub6
28C179MainStateDispatch_Sub7
29C183MainStateDispatch_Sub8
30C189MainStateDispatch_Sub9
31C192MainStateDispatch_GameMode5
32C197MainStateDispatch_Sub10
33C19BMainStateDispatch_Sub11
34C1A8MainStateDispatch_Sub12
35C1CAMainStateDispatch_Sub13
36C1D2Block_C1D2
37C1EBMainStateDispatch_Sub14
38C1F7MainStateDispatch_GameMode6
39C202Block_C202
40C210ResetInitSub1_Sub1
41C212ResetInitSub1_Sub2
42C21BResetInitSub2_1
43C225ResetInitSub2_ClearLoop
44C22BResetInitSub2_Sub
45C232ResetInitSub2_Return
46C233NmiGameLogic1_1
47C24DBlock_C24D
48C259Block_C259
49C25ANmiGameLogic1_Sub1
50C265NmiGameLogic2_1
51C273NmiGameLogic2_Sub1
52C275Block_C275
53C29EBlock_C29E
54C29FNmiGameLogic3_1
55C2BBBlock_C2BB
56C2CABlock_C2CA
57C2D4Block_C2D4
58C2E2Block_C2E2
59C2E3NmiGameLogic4_1
60C2F5Block_C2F5
61C30BBlock_C30B
62C324Block_C324
63C32BNmiGameLogic4_2
64C337Block_C337
65C33DBlock_C33D
66C341DispatchTableJump
67C367PpuWriteAddrAndData
68C37DPpuWriteAddrData_Sub
69C389PpuWriteAddrData_Sub2
70C38CPpuWriteAddrData_Sub3
71C38FPpuWriteAddrData_Sub4
72C3A3Sub_C3A3
73C3ACNmiGameLogic5_1
74C3B9NmiGameLogic5_Return
75C3D0PpuWriteAddrData_Sub5
76C3E7PpuWriteAddrData_Sub6
77C411ReadController1
78C421Block_C421
79C422ControllerSub
80C432Block_C432
81C455Block_C455
82C459Block_C459
83C47BBlock_C47B
84C487Block_C487
85C48DBlock_C48D
86C4A9Block_C4A9
87C4AAControllerSub_1
88C4B5Block_C4B5
89C4C2Block_C4C2
90C4C6Block_C4C6
91C4CBControllerSub2
92C4DEBlock_C4DE
93C4EABlock_C4EA
94C4EDControllerSub3
95C4F5Block_C4F5
96C4FCControllerSub4
97C500Block_C500
98C511Block_C511
99C51ABlock_C51A
100C51BBlock_C51B
101C524Block_C524
102C52FBlock_C52F
103C540Block_C540
104C545Block_C545
105C552Block_C552
106C55ABlock_C55A
107C560Block_C560
108C566Block_C566
109C567Block_C567
110C56BBlock_C56B
111C570Block_C570
112C573MainLoopBody_1
113C585Block_C585
114C5CAMainLoop_Sub
115C5D1Sub_C5D1_1
116C5D7Block_C5D7
117C5DFSub_C5DF
118C5E6Block_C5E6
119C5ECSub_C5EC
120C821Block_C821
121C826Block_C826
122C82FBlock_C82F
123C838Block_C838
124C841Block_C841
125C84ABlock_C84A
126C855Block_C855
127C871Block_C871
128C887Block_C887
129C8A6Block_C8A6
130C8ABBlock_C8AB
131C8B5Block_C8B5
132C8B8Block_C8B8
133C929Block_C929
134C948SoundInit
135C950Block_C950
136C955Block_C955
137C95CBlock_C95C
138C95FBlock_C95F
139C974Block_C974
140C97FBlock_C97F
141C984Block_C984
142C992Block_C992
143C99CBlock_C99C
144C9A9Block_C9A9
145C9ABBlock_C9AB
146C9ACSoundSub
147C9D3Block_C9D3
148C9E0Block_C9E0
149C9F5Block_C9F5
150CA01Block_CA01
151CA0DBlock_CA0D
152CA13Block_CA13
153CA1BBlock_CA1B
154CA25Block_CA25
155CA2FBlock_CA2F
156CA30SoundEngine
157CA39Block_CA39
158CA4BBlock_CA4B
159CA56Block_CA56
160CA57SoundSub2
161CA7ABlock_CA7A
162CAACBlock_CAAC
163CACEBlock_CACE
164CAD5Block_CAD5
165CAE9Block_CAE9
166CAFFSoundSub_1
167CB03Block_CB03
168CB04Block_CB04
169CB10Block_CB10
170CB18Block_CB18
171CB24Block_CB24
172CB28Block_CB28
173CB34Block_CB34
174CB3DBlock_CB3D
175CB5BBlock_CB5B
176CB5CBlock_CB5C
177CB6ABlock_CB6A
178CBA0Block_CBA0
179CBA7Block_CBA7
180CBA8Block_CBA8
181CBDABlock_CBDA
182CBE2Block_CBE2
183CBEABlock_CBEA
184CBF1Block_CBF1
185CC13Block_CC13
186CC33Block_CC33
187CC3CBlock_CC3C
188CC47Block_CC47
189CC57Block_CC57
190CC5CBlock_CC5C
191CC68Block_CC68
192CC77Block_CC77
193CC7BBlock_CC7B
194CC89Block_CC89
195CC9ABlock_CC9A
196CCB2Block_CCB2
197CCBEBlock_CCBE
198CCCBBlock_CCCB
199CCCCBlock_CCCC
200CCDCBlock_CCDC
201CCE8Block_CCE8
202CCF0Block_CCF0
203CCF3Block_CCF3
204CCFCBlock_CCFC
205CD05Block_CD05
206CD11Block_CD11
207CD22Block_CD22
208CD3ABlock_CD3A
209CD40Block_CD40
210CD42Block_CD42
211CD44Block_CD44
212CD4CBlock_CD4C
213CD54Block_CD54
214CD77Block_CD77
215CD7DBlock_CD7D
216CD9FBlock_CD9F
217CDA6Block_CDA6
218CDABBlock_CDAB
219CDB2Block_CDB2
220CDB4Block_CDB4
221CDC6Block_CDC6
222CDD1Block_CDD1
223CDDCBlock_CDDC
224CDF0Block_CDF0
225CDFBBlock_CDFB
226CDFEBlock_CDFE
227CE0CBlock_CE0C
228CE32Block_CE32
229CE41Block_CE41
230CE57Block_CE57
231CE7DBlock_CE7D
232CE80Block_CE80
233CE88Block_CE88
234CE93Block_CE93
235CE96Block_CE96
236CEA3Block_CEA3
237CEA4Block_CEA4
238CEABBlock_CEAB
239CEC7Block_CEC7
240CEC9Block_CEC9
241CED1Block_CED1
242CEDEBlock_CEDE
243CEE6Block_CEE6
244CEEABlock_CEEA
245CEEFBlock_CEEF
246CEF9Block_CEF9
247CF01Block_CF01
248CF0CBlock_CF0C
249CF0DBlock_CF0D
250CF17Block_CF17
251CF1FBlock_CF1F
252CF2ABlock_CF2A
253CF35Block_CF35
254CF39Block_CF39
255CF43Block_CF43
256CF44Block_CF44
257CF65Block_CF65
258CF6CBlock_CF6C
259CF84Block_CF84
260CF86Block_CF86
261CF87Block_CF87
262CF98Block_CF98
263CFA4Block_CFA4
264CFD5Block_CFD5
265CFF1Block_CFF1
266CFFEBlock_CFFE
267D00FMainLoop_Sub1
268D019Block_D019
269D01CMainLoop_Sub2
270D027Block_D027
271D02BBlock_D02B
272D02CBlock_D02C
273D03EBlock_D03E
274D04BMainLoop_Sub3b
275D04FBlock_D04F
276D053Block_D053
277D054MainLoop_Sub4
278D068Block_D068
279D089Block_D089
280D08BBlock_D08B
281D097Block_D097
282D0A6Block_D0A6
283D0B6Block_D0B6
284D0C3Block_D0C3
285D0CEBlock_D0CE
286D0D1Block_D0D1
287D0DABlock_D0DA
288D0E3Block_D0E3
289D0F1Block_D0F1
290D0FFBlock_D0FF
291D110Block_D110
292D118Block_D118
293D11DBlock_D11D
294D12EBlock_D12E
295D134Block_D134
296D149Block_D149
297D14EBlock_D14E
298D154Block_D154
299D15BBlock_D15B
300D165Block_D165
301D172Block_D172
302D175Block_D175
303D183Block_D183
304D187Block_D187
305D195MainLoop_Sub5
306D19DBlock_D19D
307D1A8Block_D1A8
308D1AEBlock_D1AE
309D1B6Block_D1B6
310D1C5Block_D1C5
311D1C9Block_D1C9
312D1D3Block_D1D3
313D1D9Block_D1D9
314D1FFBlock_D1FF
315D202Block_D202
316D205Block_D205
317D208Block_D208
318D213MainLoop_Sub6
319D23BBlock_D23B
320D25EBlock_D25E
321D273Block_D273
322D2CFBlock_D2CF
323D2D2Block_D2D2
324D2D3MainLoop_Sub7
325D2D5Block_D2D5
326D2E2MainLoop_Sub8
327D2F2Block_D2F2
328D313Block_D313
329D317Block_D317
330D33CBlock_D33C
331D363Block_D363
332D365Block_D365
333D36CMainLoop_Sub9
334D382Block_D382
335D385MainLoop_Sub10
336D396MainLoop_Sub11
337D3B1Block_D3B1
338D3B9Block_D3B9
339D3BFBlock_D3BF
340D3C2MainLoop_Sub12
341D3C4Block_D3C4
342D3CFBlock_D3CF
343D3DABlock_D3DA
344D3EEBlock_D3EE
345D3F1Block_D3F1
346D3FDBlock_D3FD
347D400MainLoop_Sub13
348D416Block_D416
349D41DBlock_D41D
350D429Block_D429
351D432Block_D432
352D447Block_D447
353D44EBlock_D44E
354D45EBlock_D45E
355D474Block_D474
356D476Block_D476
357D47EBlock_D47E
358D487MainLoop_Sub14
359D49EBlock_D49E
360D4A7Block_D4A7
361D4ABBlock_D4AB
362D4B5Block_D4B5
363D4B7Block_D4B7
364D4B8MainLoop_Sub15
365D4C8Block_D4C8
366D4D3Block_D4D3
367D4D7Block_D4D7
368D4E7Block_D4E7
369D4EDBlock_D4ED
370D4F4MainLoop_Sub16
371D500Block_D500
372D504MainLoop_Sub17
373D50BMainLoop_Sub18
374D520Block_D520
375D52BBlock_D52B
376D530Block_D530
377D53BBlock_D53B
378D544Block_D544
379D545Block_D545
380D54BBlock_D54B
381D550Block_D550
382D55BBlock_D55B
383D561Block_D561
384D574Block_D574
385D5A3Block_D5A3
386D5AFMainLoop_Sub21
387D5B3MainLoop_Sub22
388D5B7Block_D5B7
389D5BEMainLoop_Sub23
390D5D9MainLoop_Sub24
391D5E1MainLoop_Sub20
392D5EDBlock_D5ED
393D639Block_D639
394D643Block_D643
395D652Block_D652
396D653MainLoop_Sub25
397D668MainLoop_Sub26
398D670Block_D670
399D672Block_D672
400D67FBlock_D67F
401D683Block_D683
402D696Block_D696
403D6A5Block_D6A5
404D6AEBlock_D6AE
405D6BCBlock_D6BC
406D6C4Block_D6C4
407D6CAMainLoop_Sub27
408D6CEBlock_D6CE
409D6DDBlock_D6DD
410D6E4MainLoop_Sub28
411D6E9Block_D6E9
412D6F0Block_D6F0
413D6FFBlock_D6FF
414D70DBlock_D70D
415D718Block_D718
416D71CBlock_D71C
417D72DBlock_D72D
418D732Block_D732
419D736Block_D736
420D73CBlock_D73C
421D73EBlock_D73E
422D748Block_D748
423D74EMainLoop_Sub29
424D757Block_D757
425D75DBlock_D75D
426D76EBlock_D76E
427D77DBlock_D77D
428D780Block_D780
429D788Block_D788
430D792MainLoop_Sub30
431D7A8MainLoop_Sub31
432D7ACBlock_D7AC
433D7B4Block_D7B4
434D7B6Block_D7B6
435D7BCMainLoop_Sub32
436D7C9Block_D7C9
437D7CAMainLoop_Sub33
438D7DFMainLoop_Sub34
439D7E7Block_D7E7
440D7FABlock_D7FA
441D819Block_D819
442D821MainLoop_Sub35
443D82EMainLoop_Sub36
444D83BBlock_D83B
445D844Block_D844
446D848Block_D848
447D849MainLoop_Sub37
448D853Block_D853
449D855Block_D855
450D86CBlock_D86C
451D871MainLoop_Sub38
452D87CMainLoop_Sub39
453D88EBlock_D88E
454D89ABlock_D89A
455D8A3Block_D8A3
456D8ACBlock_D8AC
457D8ADMainLoop_Sub40
458D8B4Block_D8B4
459D8BBBlock_D8BB
460D8D0MainLoop_Sub41
461D8D7MainLoop_Sub42
462D8D9Block_D8D9
463D8E2Block_D8E2
464D8E3MainLoop_Sub44
465D8E5Block_D8E5
466D8EFMainLoop_Sub45
467D8FEBlock_D8FE
468D8FFMainLoop_Sub46
469D908MainLoop_Sub47
470D90BBlock_D90B
471D912MainLoop_Sub48
472D916Block_D916
473D91CMainLoop_Sub49
474D920Block_D920
475D926MainLoop_Sub50
476D92ABlock_D92A
477D938Block_D938
478D949Block_D949
479D955MainLoop_Sub51
480D959MainLoop_Sub52
481D95BBlock_D95B
482D95DMainLoop_Sub53
483D961MainLoop_Sub54
484D965MainLoop_Sub55
485D969MainLoop_Sub56
486D96DMainLoop_Sub56b
487D971MainLoop_Sub57
488D973Block_D973
489D978MainLoop_Sub58
490D97CMainLoop_Sub59
491D980MainLoop_Sub60
492D984MainLoop_Sub61
493D988MainLoop_Sub62
494D98CMainLoop_Sub63
495D990MainLoop_Sub65
496D994MainLoop_Sub66
497D996Block_D996
498D9BBBlock_D9BB
499D9C8Block_D9C8
500D9CCBlock_D9CC
501D9D8Block_D9D8
502D9E9MainLoop_Sub67
503D9F9Block_D9F9
504D9FABlock_D9FA
505DA06Block_DA06
506DA10Block_DA10
507DA16Block_DA16
508DA45Block_DA45
509DA70Block_DA70
510DA8CBlock_DA8C
511DAA2MainLoop_Sub68
512DAA6Block_DAA6
513DAA7Block_DAA7
514DAABMainLoop_Sub69
515DAB5Block_DAB5
516DABDBlock_DABD
517DABFBlock_DABF
518DAD2MainLoop_Sub70
519DAE0Block_DAE0
520DAEDMainLoop_Sub71
521DB19MainLoop_Sub72
522DB23Block_DB23
523DB2CMainLoop_Sub73
524DB3BBlock_DB3B
525DB4ABlock_DB4A
526DB4CBlock_DB4C
527DB5EBlock_DB5E
528DB64Block_DB64
529DB68Block_DB68
530DB6BBlock_DB6B
531DB6FBlock_DB6F
532DB70MainLoop_Sub75
533DB8DBlock_DB8D
534DB98Block_DB98
535DB9DMainLoop_Sub76
536DBA2Block_DBA2
537DBA8Block_DBA8
538DBC8Block_DBC8
539DBCABlock_DBCA
540DBDDBlock_DBDD
541DBE3Block_DBE3
542DBE4Block_DBE4
543DC11Block_DC11
544DC26Block_DC26
545DC27Block_DC27
546DC2DBlock_DC2D
547DC36Block_DC36
548DC48Block_DC48
549DC4BBlock_DC4B
550DC52MainLoop_Sub76_1
551DC6BBlock_DC6B
552DC7BMainLoop_Sub77
553DC81MainLoop_Sub78
554DC8DBlock_DC8D
555DC96MainLoop_Sub79
556DCABBlock_DCAB
557DCBEBlock_DCBE
558DCCAMainLoop_Sub80
559DCD3Block_DCD3
560DCD8Block_DCD8
561DCE8Block_DCE8
562DEC5Block_DEC5
563DED4MainLoop_Sub81
564E040Block_E040
565E05EBlock_E05E
566E1D0Block_E1D0
567E5A6Block_E5A6
568E5BBBlock_E5BB
569E5D0Block_E5D0
570E5E5Block_E5E5
571E5FABlock_E5FA
572E629Block_E629
573E63EBlock_E63E
574F30ABlock_F30A
575F372SoundSub_Return
576F380Block_F380
577F387SoundSub2_1
578F38BSoundSub3
579F38FSoundSub4
580F391Block_F391
581F39DBlock_F39D
582F3A8Block_F3A8
583F3C0SoundSub5
584F3C4Block_F3C4
585F3E3Block_F3E3
586F3EBBlock_F3EB
587F3EEBlock_F3EE
588F3FABlock_F3FA
589F40FSoundSub_Return_1
590F417Block_F417
591F418Block_F418
592F426SoundSub7
593F42ASoundSub_Return_2
594F440SoundSub8
595F453Block_F453
596F468Block_F468
597F48ASoundSub_Return_3
598F48EBlock_F48E
599F4B7Block_F4B7
600F4EFBlock_F4EF
601F50ABlock_F50A
602F50DBlock_F50D
603F51ABlock_F51A
604F532Block_F532
605F53DBlock_F53D
606F53FSoundSub9
607F570Block_F570
608F573Block_F573
609F579Block_F579
610F57FBlock_F57F
611F583Block_F583
612F588Block_F588
613F58EBlock_F58E
614F592Block_F592
615F59EBlock_F59E
616F5A9Block_F5A9
617F5ACBlock_F5AC
618F5B0Block_F5B0
619F5B3Block_F5B3
620F5B4SoundSub_Return_4
621F5BDBlock_F5BD
622F5C7SoundSub_Return_5
623F5D5Block_F5D5
624F5DBBlock_F5DB
625F5E1Block_F5E1
626F5ECBlock_F5EC
627F5EFSoundSub10
628F5F2Block_F5F2
629F5FBSoundSub11
630F5FDBlock_F5FD
631F60EBlock_F60E
632F60FSoundSub12
633F613SoundSub13
634F617SoundSub_Return_6
635F631Block_F631
636F642Block_F642
637F64BBlock_F64B
638F650Block_F650
639F652Block_F652
640F659Block_F659
641F674Block_F674
642F67DBlock_F67D
643F67FBlock_F67F
644F686Block_F686
645F6B1Block_F6B1
646F6BCBlock_F6BC
647F6C7Block_F6C7
648F6D0Block_F6D0
649F6D2Block_F6D2
650F6D9Block_F6D9
651F702Block_F702
652F709Block_F709
653F70ASoundSub14
654F723Block_F723
655F724SoundSub15
656F76FSoundSub16
657FDF7SoundSub17
658FE1BSoundSub18
659FFF4NmiVector
660FFF7ResetVector
661# ---- derived internal branch-target names ----
662C000Reset
663C002WaitPpuVblank1
664C01EClearRamLoop
665C02CResetInitSub1
666C054InitSpriteDataFromTable
667C056CopySpriteDataLoop
668C061MainStateDispatch_CheckMode
669C06BMainStateDispatch_HandleCtrl
670C06EMainStateDispatch_InitGame
671C07CNmiHandler_CheckPhase
672C086NmiHandler_1
673C0A6NmiHandler_EarlyExit
674C0ACNmiHandler_RestoreRegs
675C0B3MainStateDispatch_1
676C0D4MainStateDispatch_CopySprites
677C0DEMainStateDispatch_Sub1
678C0E0MainStateDispatch_Sub2
679C0F0MainStateDispatch_Sub2b
680C101MainStateDispatch_GameMode1
681C10AMainStateDispatch_Sub3
682C10FMainStateDispatch_Sub4
683C125Block_C125
684C130MainStateDispatch_GameMode2
685C156MainStateDispatch_GameMode3
686C169MainStateDispatch_GameMode4
687C16DMainStateDispatch_Sub5
688C170MainStateDispatch_Sub6
689C179MainStateDispatch_Sub7
690C183MainStateDispatch_Sub8
691C189MainStateDispatch_Sub9
692C192MainStateDispatch_GameMode5
693C197MainStateDispatch_Sub10
694C19BMainStateDispatch_Sub11
695C1A8MainStateDispatch_Sub12
696C1CAMainStateDispatch_Sub13
697C1D2Block_C1D2
698C1EBMainStateDispatch_Sub14
699C1F7MainStateDispatch_GameMode6
700C202Block_C202
701C210ResetInitSub1_Sub1
702C212ResetInitSub1_Sub2
703C21BResetInitSub2_1
704C225ResetInitSub2_ClearLoop
705C22BResetInitSub2_Sub
706C232ResetInitSub2_Return
707C233NmiGameLogic1_1
708C24DBlock_C24D
709C259Block_C259
710C25ANmiGameLogic1_Sub1
711C265NmiGameLogic2_1
712C273NmiGameLogic2_Sub1
713C275Block_C275
714C29EBlock_C29E
715C29FNmiGameLogic3_1
716C2BBBlock_C2BB
717C2CABlock_C2CA
718C2D4Block_C2D4
719C2E2Block_C2E2
720C2E3NmiGameLogic4_1
721C2F5Block_C2F5
722C30BBlock_C30B
723C324Block_C324
724C32BNmiGameLogic4_2
725C337Block_C337
726C33DBlock_C33D
727C341DispatchTableJump
728C367PpuWriteAddrAndData
729C37DPpuWriteAddrData_Sub
730C389PpuWriteAddrData_Sub2
731C38CPpuWriteAddrData_Sub3
732C38FPpuWriteAddrData_Sub4
733C3A3Sub_C3A3
734C3ACNmiGameLogic5_1
735C3B9NmiGameLogic5_Return
736C3D0PpuWriteAddrData_Sub5
737C3E7PpuWriteAddrData_Sub6
738C411ReadController1
739C421Block_C421
740C422ControllerSub
741C432Block_C432
742C455Block_C455
743C459Block_C459
744C47BBlock_C47B
745C487Block_C487
746C48DBlock_C48D
747C4A9Block_C4A9
748C4AAControllerSub_1
749C4B5Block_C4B5
750C4C2Block_C4C2
751C4C6Block_C4C6
752C4CBControllerSub2
753C4DEBlock_C4DE
754C4EABlock_C4EA
755C4EDControllerSub3
756C4F5Block_C4F5
757C4FCControllerSub4
758C500Block_C500
759C511Block_C511
760C51ABlock_C51A
761C51BBlock_C51B
762C524Block_C524
763C52FBlock_C52F
764C540Block_C540
765C545Block_C545
766C552Block_C552
767C55ABlock_C55A
768C560Block_C560
769C566Block_C566
770C567Block_C567
771C56BBlock_C56B
772C570Block_C570
773C573MainLoopBody_1
774C585Block_C585
775C5CAMainLoop_Sub
776C5D1Sub_C5D1_1
777C5D7Block_C5D7
778C5DFSub_C5DF
779C5E6Block_C5E6
780C5ECSub_C5EC
781C821Block_C821
782C826Block_C826
783C82FBlock_C82F
784C838Block_C838
785C841Block_C841
786C84ABlock_C84A
787C855Block_C855
788C871Block_C871
789C887Block_C887
790C8A6Block_C8A6
791C8ABBlock_C8AB
792C8B5Block_C8B5
793C8B8Block_C8B8
794C929Block_C929
795C948SoundInit
796C950Block_C950
797C955Block_C955
798C95CBlock_C95C
799C95FBlock_C95F
800C974Block_C974
801C97FBlock_C97F
802C984Block_C984
803C992Block_C992
804C99CBlock_C99C
805C9A9Block_C9A9
806C9ABBlock_C9AB
807C9ACSoundSub
808C9D3Block_C9D3
809C9E0Block_C9E0
810C9F5Block_C9F5
811CA01Block_CA01
812CA0DBlock_CA0D
813CA13Block_CA13
814CA1BBlock_CA1B
815CA25Block_CA25
816CA2FBlock_CA2F
817CA30SoundEngine
818CA39Block_CA39
819CA4BBlock_CA4B
820CA56Block_CA56
821CA57SoundSub2
822CA7ABlock_CA7A
823CAACBlock_CAAC
824CACEBlock_CACE
825CAD5Block_CAD5
826CAE9Block_CAE9
827CAFFSoundSub_1
828CB03Block_CB03
829CB04Block_CB04
830CB10Block_CB10
831CB18Block_CB18
832CB24Block_CB24
833CB28Block_CB28
834CB34Block_CB34
835CB3DBlock_CB3D
836CB5BBlock_CB5B
837CB5CBlock_CB5C
838CB6ABlock_CB6A
839CBA0Block_CBA0
840CBA7Block_CBA7
841CBA8Block_CBA8
842CBDABlock_CBDA
843CBE2Block_CBE2
844CBEABlock_CBEA
845CBF1Block_CBF1
846CC13Block_CC13
847CC33Block_CC33
848CC3CBlock_CC3C
849CC47Block_CC47
850CC57Block_CC57
851CC5CBlock_CC5C
852CC68Block_CC68
853CC77Block_CC77
854CC7BBlock_CC7B
855CC89Block_CC89
856CC9ABlock_CC9A
857CCB2Block_CCB2
858CCBEBlock_CCBE
859CCCBBlock_CCCB
860CCCCBlock_CCCC
861CCDCBlock_CCDC
862CCE8Block_CCE8
863CCF0Block_CCF0
864CCF3Block_CCF3
865CCFCBlock_CCFC
866CD05Block_CD05
867CD11Block_CD11
868CD22Block_CD22
869CD3ABlock_CD3A
870CD40Block_CD40
871CD42Block_CD42
872CD44Block_CD44
873CD4CBlock_CD4C
874CD54Block_CD54
875CD77Block_CD77
876CD7DBlock_CD7D
877CD9FBlock_CD9F
878CDA6Block_CDA6
879CDABBlock_CDAB
880CDB2Block_CDB2
881CDB4Block_CDB4
882CDC6Block_CDC6
883CDD1Block_CDD1
884CDDCBlock_CDDC
885CDF0Block_CDF0
886CDFBBlock_CDFB
887CDFEBlock_CDFE
888CE0CBlock_CE0C
889CE32Block_CE32
890CE41Block_CE41
891CE57Block_CE57
892CE7DBlock_CE7D
893CE80Block_CE80
894CE88Block_CE88
895CE93Block_CE93
896CE96Block_CE96
897CEA3Block_CEA3
898CEA4Block_CEA4
899CEABBlock_CEAB
900CEC7Block_CEC7
901CEC9Block_CEC9
902CED1Block_CED1
903CEDEBlock_CEDE
904CEE6Block_CEE6
905CEEABlock_CEEA
906CEEFBlock_CEEF
907CEF9Block_CEF9
908CF01Block_CF01
909CF0CBlock_CF0C
910CF0DBlock_CF0D
911CF17Block_CF17
912CF1FBlock_CF1F
913CF2ABlock_CF2A
914CF35Block_CF35
915CF39Block_CF39
916CF43Block_CF43
917CF44Block_CF44
918CF65Block_CF65
919CF6CBlock_CF6C
920CF84Block_CF84
921CF86Block_CF86
922CF87Block_CF87
923CF98Block_CF98
924CFA4Block_CFA4
925CFD5Block_CFD5
926CFF1Block_CFF1
927CFFEBlock_CFFE
928D00FMainLoop_Sub1
929D019Block_D019
930D01CMainLoop_Sub2
931D027Block_D027
932D02BBlock_D02B
933D02CBlock_D02C
934D03EBlock_D03E
935D04BMainLoop_Sub3b
936D04FBlock_D04F
937D053Block_D053
938D054MainLoop_Sub4
939D068Block_D068
940D089Block_D089
941D08BBlock_D08B
942D097Block_D097
943D0A6Block_D0A6
944D0B6Block_D0B6
945D0C3Block_D0C3
946D0CEBlock_D0CE
947D0D1Block_D0D1
948D0DABlock_D0DA
949D0E3Block_D0E3
950D0F1Block_D0F1
951D0FFBlock_D0FF
952D110Block_D110
953D118Block_D118
954D11DBlock_D11D
955D12EBlock_D12E
956D134Block_D134
957D149Block_D149
958D14EBlock_D14E
959D154Block_D154
960D15BBlock_D15B
961D165Block_D165
962D172Block_D172
963D175Block_D175
964D183Block_D183
965D187Block_D187
966D195MainLoop_Sub5
967D19DBlock_D19D
968D1A8Block_D1A8
969D1AEBlock_D1AE
970D1B6Block_D1B6
971D1C5Block_D1C5
972D1C9Block_D1C9
973D1D3Block_D1D3
974D1D9Block_D1D9
975D1FFBlock_D1FF
976D202Block_D202
977D205Block_D205
978D208Block_D208
979D213MainLoop_Sub6
980D23BBlock_D23B
981D25EBlock_D25E
982D273Block_D273
983D2CFBlock_D2CF
984D2D2Block_D2D2
985D2D3MainLoop_Sub7
986D2D5Block_D2D5
987D2E2MainLoop_Sub8
988D2F2Block_D2F2
989D313Block_D313
990D317Block_D317
991D33CBlock_D33C
992D363Block_D363
993D365Block_D365
994D36CMainLoop_Sub9
995D382Block_D382
996D385MainLoop_Sub10
997D396MainLoop_Sub11
998D3B1Block_D3B1
999D3B9Block_D3B9
1000D3BFBlock_D3BF
1001D3C2MainLoop_Sub12
1002D3C4Block_D3C4
1003D3CFBlock_D3CF
1004D3DABlock_D3DA
1005D3EEBlock_D3EE
1006D3F1Block_D3F1
1007D3FDBlock_D3FD
1008D400MainLoop_Sub13
1009D416Block_D416
1010D41DBlock_D41D
1011D429Block_D429
1012D432Block_D432
1013D447Block_D447
1014D44EBlock_D44E
1015D45EBlock_D45E
1016D474Block_D474
1017D476Block_D476
1018D47EBlock_D47E
1019D487MainLoop_Sub14
1020D49EBlock_D49E
1021D4A7Block_D4A7
1022D4ABBlock_D4AB
1023D4B5Block_D4B5
1024D4B7Block_D4B7
1025D4B8MainLoop_Sub15
1026D4C8Block_D4C8
1027D4D3Block_D4D3
1028D4D7Block_D4D7
1029D4E7Block_D4E7
1030D4EDBlock_D4ED
1031D4F4MainLoop_Sub16
1032D500Block_D500
1033D504MainLoop_Sub17
1034D50BMainLoop_Sub18
1035D520Block_D520
1036D52BBlock_D52B
1037D530Block_D530
1038D53BBlock_D53B
1039D544Block_D544
1040D545Block_D545
1041D54BBlock_D54B
1042D550Block_D550
1043D55BBlock_D55B
1044D561Block_D561
1045D574Block_D574
1046D5A3Block_D5A3
1047D5AFMainLoop_Sub21
1048D5B3MainLoop_Sub22
1049D5B7Block_D5B7
1050D5BEMainLoop_Sub23
1051D5D9MainLoop_Sub24
1052D5E1MainLoop_Sub20
1053D5EDBlock_D5ED
1054D639Block_D639
1055D643Block_D643
1056D652Block_D652
1057D653MainLoop_Sub25
1058D668MainLoop_Sub26
1059D670Block_D670
1060D672Block_D672
1061D67FBlock_D67F
1062D683Block_D683
1063D696Block_D696
1064D6A5Block_D6A5
1065D6AEBlock_D6AE
1066D6BCBlock_D6BC
1067D6C4Block_D6C4
1068D6CAMainLoop_Sub27
1069D6CEBlock_D6CE
1070D6DDBlock_D6DD
1071D6E4MainLoop_Sub28
1072D6E9Block_D6E9
1073D6F0Block_D6F0
1074D6FFBlock_D6FF
1075D70DBlock_D70D
1076D718Block_D718
1077D71CBlock_D71C
1078D72DBlock_D72D
1079D732Block_D732
1080D736Block_D736
1081D73CBlock_D73C
1082D73EBlock_D73E
1083D748Block_D748
1084D74EMainLoop_Sub29
1085D757Block_D757
1086D75DBlock_D75D
1087D76EBlock_D76E
1088D77DBlock_D77D
1089D780Block_D780
1090D788Block_D788
1091D792MainLoop_Sub30
1092D7A8MainLoop_Sub31
1093D7ACBlock_D7AC
1094D7B4Block_D7B4
1095D7B6Block_D7B6
1096D7BCMainLoop_Sub32
1097D7C9Block_D7C9
1098D7CAMainLoop_Sub33
1099D7DFMainLoop_Sub34
1100D7E7Block_D7E7
1101D7FABlock_D7FA
1102D819Block_D819
1103D821MainLoop_Sub35
1104D82EMainLoop_Sub36
1105D83BBlock_D83B
1106D844Block_D844
1107D848Block_D848
1108D849MainLoop_Sub37
1109D853Block_D853
1110D855Block_D855
1111D86CBlock_D86C
1112D871MainLoop_Sub38
1113D87CMainLoop_Sub39
1114D88EBlock_D88E
1115D89ABlock_D89A
1116D8A3Block_D8A3
1117D8ACBlock_D8AC
1118D8ADMainLoop_Sub40
1119D8B4Block_D8B4
1120D8BBBlock_D8BB
1121D8D0MainLoop_Sub41
1122D8D7MainLoop_Sub42
1123D8D9Block_D8D9
1124D8E2Block_D8E2
1125D8E3MainLoop_Sub44
1126D8E5Block_D8E5
1127D8EFMainLoop_Sub45
1128D8FEBlock_D8FE
1129D8FFMainLoop_Sub46
1130D908MainLoop_Sub47
1131D90BBlock_D90B
1132D912MainLoop_Sub48
1133D916Block_D916
1134D91CMainLoop_Sub49
1135D920Block_D920
1136D926MainLoop_Sub50
1137D92ABlock_D92A
1138D938Block_D938
1139D949Block_D949
1140D955MainLoop_Sub51
1141D959MainLoop_Sub52
1142D95BBlock_D95B
1143D95DMainLoop_Sub53
1144D961MainLoop_Sub54
1145D965MainLoop_Sub55
1146D969MainLoop_Sub56
1147D96DMainLoop_Sub56b
1148D971MainLoop_Sub57
1149D973Block_D973
1150D978MainLoop_Sub58
1151D97CMainLoop_Sub59
1152D980MainLoop_Sub60
1153D984MainLoop_Sub61
1154D988MainLoop_Sub62
1155D98CMainLoop_Sub63
1156D990MainLoop_Sub65
1157D994MainLoop_Sub66
1158D996Block_D996
1159D9BBBlock_D9BB
1160D9C8Block_D9C8
1161D9CCBlock_D9CC
1162D9D8Block_D9D8
1163D9E9MainLoop_Sub67
1164D9F9Block_D9F9
1165D9FABlock_D9FA
1166DA06Block_DA06
1167DA10Block_DA10
1168DA16Block_DA16
1169DA45Block_DA45
1170DA70Block_DA70
1171DA8CBlock_DA8C
1172DAA2MainLoop_Sub68
1173DAA6Block_DAA6
1174DAA7Block_DAA7
1175DAABMainLoop_Sub69
1176DAB5Block_DAB5
1177DABDBlock_DABD
1178DABFBlock_DABF
1179DAD2MainLoop_Sub70
1180DAE0Block_DAE0
1181DAEDMainLoop_Sub71
1182DB19MainLoop_Sub72
1183DB23Block_DB23
1184DB2CMainLoop_Sub73
1185DB3BBlock_DB3B
1186DB4ABlock_DB4A
1187DB4CBlock_DB4C
1188DB5EBlock_DB5E
1189DB64Block_DB64
1190DB68Block_DB68
1191DB6BBlock_DB6B
1192DB6FBlock_DB6F
1193DB70MainLoop_Sub75
1194DB8DBlock_DB8D
1195DB98Block_DB98
1196DB9DMainLoop_Sub76
1197DBA2Block_DBA2
1198DBA8Block_DBA8
1199DBC8Block_DBC8
1200DBCABlock_DBCA
1201DBDDBlock_DBDD
1202DBE3Block_DBE3
1203DBE4Block_DBE4
1204DC11Block_DC11
1205DC26Block_DC26
1206DC27Block_DC27
1207DC2DBlock_DC2D
1208DC36Block_DC36
1209DC48Block_DC48
1210DC4BBlock_DC4B
1211DC52MainLoop_Sub76_1
1212DC6BBlock_DC6B
1213DC7BMainLoop_Sub77
1214DC81MainLoop_Sub78
1215DC8DBlock_DC8D
1216DC96MainLoop_Sub79
1217DCABBlock_DCAB
1218DCBEBlock_DCBE
1219DCCAMainLoop_Sub80
1220DCD3Block_DCD3
1221DCD8Block_DCD8
1222DCE8Block_DCE8
1223DEC5Block_DEC5
1224DED4MainLoop_Sub81
1225E040Block_E040
1226E05EBlock_E05E
1227E1D0Block_E1D0
1228E5A6Block_E5A6
1229E5BBBlock_E5BB
1230E5D0Block_E5D0
1231E5E5Block_E5E5
1232E5FABlock_E5FA
1233E629Block_E629
1234E63EBlock_E63E
1235F30ABlock_F30A
1236F372SoundSub_Return
1237F380Block_F380
1238F387SoundSub2_1
1239F38BSoundSub3
1240F38FSoundSub4
1241F391Block_F391
1242F39DBlock_F39D
1243F3A8Block_F3A8
1244F3C0SoundSub5
1245F3C4Block_F3C4
1246F3E3Block_F3E3
1247F3EBBlock_F3EB
1248F3EEBlock_F3EE
1249F3FABlock_F3FA
1250F40FSoundSub_Return_1
1251F417Block_F417
1252F418Block_F418
1253F426SoundSub7
1254F42ASoundSub_Return_2
1255F440SoundSub8
1256F453Block_F453
1257F468Block_F468
1258F48ASoundSub_Return_3
1259F48EBlock_F48E
1260F4B7Block_F4B7
1261F4EFBlock_F4EF
1262F50ABlock_F50A
1263F50DBlock_F50D
1264F51ABlock_F51A
1265F532Block_F532
1266F53DBlock_F53D
1267F53FSoundSub9
1268F570Block_F570
1269F573Block_F573
1270F579Block_F579
1271F57FBlock_F57F
1272F583Block_F583
1273F588Block_F588
1274F58EBlock_F58E
1275F592Block_F592
1276F59EBlock_F59E
1277F5A9Block_F5A9
1278F5ACBlock_F5AC
1279F5B0Block_F5B0
1280F5B3Block_F5B3
1281F5B4SoundSub_Return_4
1282F5BDBlock_F5BD
1283F5C7SoundSub_Return_5
1284F5D5Block_F5D5
1285F5DBBlock_F5DB
1286F5E1Block_F5E1
1287F5ECBlock_F5EC
1288F5EFSoundSub10
1289F5F2Block_F5F2
1290F5FBSoundSub11
1291F5FDBlock_F5FD
1292F60EBlock_F60E
1293F60FSoundSub12
1294F613SoundSub13
1295F617SoundSub_Return_6
1296F631Block_F631
1297F642Block_F642
1298F64BBlock_F64B
1299F650Block_F650
1300F652Block_F652
1301F659Block_F659
1302F674Block_F674
1303F67DBlock_F67D
1304F67FBlock_F67F
1305F686Block_F686
1306F6B1Block_F6B1
1307F6BCBlock_F6BC
1308F6C7Block_F6C7
1309F6D0Block_F6D0
1310F6D2Block_F6D2
1311F6D9Block_F6D9
1312F702Block_F702
1313F709Block_F709
1314F70ASoundSub14
1315F723Block_F723
1316F724SoundSub15
1317F76FSoundSub16
1318FDF7SoundSub17
1319FE1BSoundSub18
1320FFF4NmiVector
1321FFF7ResetVector