saphira-bcpl — LOCAL ENGINEERING TREE (not for public push)

Licence boundary (binding until Martin Richards replies): All upstream-derived material in this tree — verbatim files, modified files, AND patch/diff files — is LOCAL-ONLY. Do not git push this tree anywhere. See UPSTREAM-NOTICE.md and MANIFEST.md.

Boring UX (target)

# preparation (separate step, may use network or a local copy):
./tools/prepare-upstream.sh --archive /path/to/bcpl.tgz
# afterwards everything is offline:
make
make check
sudo make install
bcpl hello.b -o hello
./hello

• make must not access the network.
• No prebuilt cintsys64, cin64/*, *.o, or generated seeds in git. The pristine archive is consumed from outside the repo; its shipped Cintcode images (cin*/, ender*) are upstream's own documented bootstrap, extracted under build/ (git-ignored), never committed.
• CC=, CFLAGS=, LDFLAGS=, PREFIX=/usr/local, DESTDIR= supported.

Layout

• driver/bcpl — public driver (AKADATA-authored).
• runtime/native/ — default modern Linux runtime (AKADATA-authored).
• runtime/upstream/NOTES.md — factual notes on preserved upstream runtime; no rewrite.
• examples/modern/ — 9 AKADATA demonstration programs.
• examples/classic/ — reserved; classic originals stay local-only for now.
• patches/sial-amd64b64/ — LOCAL-ONLY ordered fixes 001..005.
• tools/prepare-upstream.sh — verify SHA-256 + extract pristine archive.
• tests/ — make check harness.
• build/ — git-ignored; pristine extract + bootstrap outputs.
• EMAIL-MARTIN-DRAFT.md — local draft, not sent by tooling.

Current phase gates

A. hosted native hello ELF, exit path via program output B. factorial proves 720 via program output / 64-bit harness (NEVER exit status) C. bcpl --emit-sial, -S, -c, default link D. no Cintcode execution layer for native programs E. repeatable from prepare-upstream.sh + make F. all shipped modern examples compile/run G. Homer green, then clean checkout + pristine archive green on egg/musl H. STOP before any git push; report.