README.md
Original bytes preserved. This is a browser-readable view.
# Chapter 03 stable/ — accepted private Random Lab r006
> **CURRENT ROM LOCATION — 2026-10-12:** The accepted listing and 64 KiB ROM reside at `stable/rom/random.{bin,lst}`; source/includes and the owner-controlled `build/` remain where they were. Exact binary/listing filenames, Drive IDs, sizes and hashes are unchanged.
> This is a file-location normalization, not a new assembly, runtime test, firmware revision, rights approval or alteration of archived evidence. Older dated paths below describe their historical checkpoints.
**Current status (2026-10-11):** owner-built, runtime accepted (“built and just works”), and independently source/listing/ROM audited. This `stable/` is the single current accepted **r006** package, not a parallel version tree. **Public distribution is not approved.** Historical SHELL r005 remains frozen under chapter `tests/`, `notes/EXPERIENCE_FINAL.md`, and a reversible former-stable snapshot.
## Source-faithful architecture
```text
stable/
README.md
MANIFEST.md
src/
random.s
build.last
random.pas
TIP.md
rom/
random.lst
random.bin
lib/
bcd_mod.inc
bcd_div.inc
bcd_mul.inc
bcd_sub.inc
bcd_from_u16.inc
bcd_add.inc
bcd_sqrt.inc
bcd_to_f32_r002.inc
pdf/ (private teaching editions)
sol/ (curated notes)
TEASER.pdf (editorial context)
```
The chapter's `src/random.s` contains eight literal `#INCLUDE (../lib/...)` references. Keeping the sibling `stable/lib/` is a **deliberate, documented legacy exception**, not an assembler constraint against the independent `rom/` output directory. All eight includes were individually compared byte-for-byte with their original chapter-level `lib/` counterparts. The source, separate preserved build report and independently stored ROM/listing retain their accepted hashes.
**Important build clarification:** `build/mk-init.sh` clears `build/` working data and copies `../src/*` into it; `build/mk.sh` then changes directory to `../src` and calls `mk-rom.sh` there. Therefore new ROM/listing/report outputs are created **directly in `src/`**, not migrated from `build/`. The owner-managed build scripts were neither changed nor rewritten.
The former `stable/src/`/`stable/rom/` historical r005 snapshot and `stable/product-r006-accepted-20261011/` wrapper were moved reversibly to chapter `trash/STABLE_LAYOUT_SUPERSEDED_20261011/`, retaining their Drive IDs and prior contents. Old r005 source/ROM/listing are still in chapter `tests/`, and frozen Experience is unchanged. Public donor-code rights and distribution audience remain separate gates. See `MANIFEST.md` and `../sol/CH03_STABLE_LAYOUT_REPAIR_20261011.md`.