TIP.md
Original bytes preserved. This is a browser-readable view.
# Chapter 03 r006 -- source handoff for maintainers CURRENT: `src/random.s` is the **owner-accepted, independently audited** post-delivery UI/startup release source, 34,594 bytes, SHA-256 `1247d70622f2033b2a8f726ab877f5816ce23c88e808172a07a7aa1f7b815795`. It is assembled (Rev. 0.45, no errors) and owner runtime accepted; exact emitted listing/ROM in `src/` are SHA-pinned in `../sol/BUILD_AUDIT_r006_20261011.md` and the private release lives at `../stable/src/` (complete eight-file BCD closure at sibling `../stable/lib/`). The owner did not enumerate exhaustive numerical/hardware tests. The accepted historical SHELL r005 source is preserved byte-for-byte in `../tests/random.s` and in the reversible former-stable snapshot (SHA-256 `2db2da104c2bf2b43b73e3b49d35e7ba56d153040c8b4d48f989ca1b18460a81`), together with its ROM/listing under `../tests/`, the reversible former-stable snapshot and the frozen Experience. **Why a behavior change:** the r005 splash asked `PRESS EXE` and `APP_START` awaited `WAIT_EXE`. Removing the instruction without the gate would leave an apparently unresponsive program. r006 deliberately calls `WAIT_SPLASH_R006` for startup, using three stabilized TM transitions. Error screens still require the **original `WAIT_EXE`**. This is UI + startup maintenance, not a strings-only transformation. See `../sol/DECISION_RECORD_CH03_UI_r006_20261011.md`. For reproduction / maintenance: from chapter root run `python3 sol/verify_ch03_ui_r006.py`, check the exact SHA, then use the intended HD61700 Rev. 0.45 assembler. **Do not move `src/random.s`.** Check the build script's actual working/output directory; do not assume `build/` holds current `.lst`/`.bin`. The owner controls `build/`; Sol should not alter it. Return source, listing, 64-KiB ROM and `build.last` hashes, plus observed splash auto-advance, error EXE acknowledgment, editing cursor (`Value: ` starts value at col 7), one-step NEXT, reproducible SIM N=100 and 1000 and BRK/ON behavior. Numerical includes and donor provenance remain unchanged. The r006 private internal release is now the single current `../stable/src/` snapshot, with eight byte-identical BCD include copies in sibling `../stable/lib/`. Historical r005 stable snapshots and the redundant r006 wrapper were moved reversibly into `../trash/STABLE_LAYOUT_SUPERSEDED_20261011/`; the original r005 source/ROM and frozen Experience remain unchanged. A product UI update is not third-party redistribution clearance. The include-copy gate is now **PASS**; donor-code rights/audience gates remain separate and open. **Build script clarification (2026-10-11):** From `build/`, `mk.sh` calls Unison sync, then `mk-init.sh` copies `../src/*` *into build/* as a disposable mirror, then `mk.sh` changes directory to `../src` and runs `mk-rom.sh`. New `.lst`, `.bin`, and `build.last` are therefore emitted directly in `src/`, not moved there from `build/`. Unison sync runs once more. Copies inside `build/` may be stale. This unusual implementation is documented, **not an idealized claim that compilation occurs in build/**. Changing the owner-controlled scripts is a separate future decision. See `../sol/CH03_STABLE_LAYOUT_REPAIR_20261011.md`.