# CS617 Chapter 11 - human-NOTES solver r004a source/build handoff

Status: FINAL ACCEPTED HUMAN REVISION; NF-05 only; exact r004a source/build/emission audit complete; Alex runtime observation accepted 2026-10-07.

## Scope

r004a retains the r004 NF-05 dirty-region implementation exactly and repairs only an HD61 assembler-visible symbol-length violation found by the first authoritative r004 build. No intended runtime behavior changes from r004.

## Preserved failed predecessor

`../r004_fail001_source/` freezes the exact failed r004 source closure and its contemporaneous TIP. `../R004_BUILD_FAILURE_001.md` records the returned assembler failure.

## Canonical assembler input

Assemble only `ch11_main.s` with HD61700 ASSEMBLER Rev. 0.45. Include closure: `defs.s`, `header.s`, `bridge.s`, `vectors.s`, `app.s`, `vt.s`, `queens.s`, `hanoi.s`, `keytab.s`.

## Expected source identities

```text
181d95e709b1955aa8c296ccb749eadc056a0069cd87bf91f5f8948561f1317c  ch11_main.s  (779 bytes)
8ebbffc4c8b4a0c5f7545f1a735f9e2ca69dd4bec22fc9c329a5ab0eeeee0ff4  defs.s  (2909 bytes)
77946e1f8eff8018204acb4dc6a8dcea5ac88148e47f5f5862e56c63c19b6870  header.s  (654 bytes)
553e0a56fd6cebdee9a0e65b57be6750047acc202d85507d53244e1dab8282be  bridge.s  (1870 bytes)
3c47a8a5b21f4979f030e6014806330ed745d57857e0d7ba8823817bcab26fcf  vectors.s  (890 bytes)
e8e044f11521f9e16fdf8252900987a84ee24849125c69dbc97e513ddec92c84  app.s  (14486 bytes)
eaa9062a8ab66c804d56d8e57ab3b37c9321957833f14ea18b191bb510730c64  vt.s  (6298 bytes)
cc773d7f6178fa42457001de0e2e500e0d8ac40c8fc83cd5b2b237622d3d84fe  queens.s  (10755 bytes)
0aeeb3176f6b8f8c1fd0b6c6021f92c2a863ac22a668ada73cfcbe58e566b78c  hanoi.s  (9591 bytes)
385e6fdc71d6039abf2be0e53c49efead49165a8f4d6ea25c0af222fd438ae55  keytab.s  (1031 bytes)
```

## Assembler correction

The first r004 build failed at:

```text
CAL Q_PROGRESS_UPDATE
ERROR CODE:009 Illegal Operand
```

because `Q_PROGRESS_UPDATE` is 17 characters. r004a renames only that assembler-visible symbol to `Q_PROGRESS_UPD` (14 characters). A full label/`EQU` scan of all ten inputs now finds zero symbols longer than 16 characters.

## NF-05 implementation retained

- `Q_PROGRESS_INIT` draws the static Queens progress screen on a real screen transition.
- `Q_PROGRESS_UPD` overwrites only a five-character count field and the spinner cell.
- `Q_SERVICE` keeps the established 64-candidate throttle and MENU/BRK poll, but calls only the dirty update.
- After a view-mode solution page, Q continuation calls `Q_PROGRESS_INIT` once because VT -> progress is a real screen transition.
- Count/view recursion, solution pages, final page, N state, Hanoi, VT and all other r003 behavior are unchanged.

## Accepted build and runtime evidence

The connected `build/` source closure matches every expected source identity above.

```text
e03c74a61d912bc275b8f792b342118d4ae23f0655657b6555c44dc582dbb2be  ch11_main.lst  (114142 bytes)
657c7af525bd25e1ef079f2f8804123d8ff14fb6b64e2ac602e9926777898d89  ch11_main.bin  (65536 bytes)
```

HD61700 ASSEMBLER Rev. 0.45 reports `ASSEMBLY COMPLETE, NO ERRORS FOUND` and execute address `0000h`. Independent listing-to-ROM audit: 1,424 emission records, 4,007 unique emitted byte positions, zero conflicting emissions, zero ROM mismatches.

Alex's runtime observation for the NF-05 target was: **"the result is a smooth spinner."** This is accepted as the human runtime judgment that the repeated full-screen flicker has been removed. r003 remains the accepted baseline for all other UI/functionality; r004a changes only NF-05 plus the assembler-label repair.

No further r004a build is requested. `../R004A_RUNTIME_RESULT.md` is the scoped acceptance record. `../HUMAN_NOTES_SOLVER_CLOSEOUT.md` closes the human-NOTES solver run before the separate Angelical solver experiment.

## Runtime focus (satisfied for the NF-05 target)

1. Queens count N=8: no repeated full-screen flash during progress; final total remains 92.
2. Count field and spinner update correctly in place.
3. MENU/BRK responsiveness remains unchanged.
4. Queens view: solution pages remain unchanged; after Q continuation the progress screen is restored cleanly and search continues.
5. No regression in r003 presentation.

## Final human-run status

r004a is the final accepted human-NOTES solver revision. This exact closure and accepted TIP are frozen in `../r004a_source/` per the Law of Sol.
