SOURCE VIEWER

README.md

Original bytes preserved. This is a browser-readable view.

DOWNLOAD ORIGINAL ↓

# 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`.