TIP.md
Original bytes preserved. This is a browser-readable view.
# 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.