C64-dev/newLang/planning/claims/E01-S01.md

---

story: E01-S01 owner: e01_native_prg status: done started: 2026-11-07 depends-on: [E00-S01]

E01-S01 Claim

Intended change

Create and verify the smallest ca65/ld65 PRG that starts in C128 native mode, prints a deterministic signature, records a machine-readable success byte, and returns cleanly to BASIC.

File area

• src/platform/minimal.s
• cfg/minimal-c128.cfg
• scripts/build-minimal.ps1
• scripts/run-minimal.ps1
• monitor/minimal-debug.txt
• generated files under build/

Acceptance evidence

• ca65/ld65 builds from a clean workspace.
• x128 autostarts the PRG in C128 native mode.
• The PRG writes an expected screen/message and machine-readable result.
• A monitor script reaches the documented entry point.

Coordination notes

This story will not establish MMU/common-RAM behavior or final compiler memory addresses; those belong to E01-S02 and E01-S05.

Work log

• Claim created after confirming E00-S01 is complete.
• Added a 64-byte PRG with a BASIC 7 SYS 7181 header and documented 6502 instructions only.
• Added a bounded linker layout used only by this platform proof.
• Added clean build, screenshot run, remote-monitor verification, interactive debug, and non-stopping trace paths.
• Observed the C128 BASIC 7 banner followed by NOVA128 C128 NATIVE OK and a return to READY. in build/minimal-vicii.png.
• Verified trace hits at entry $1C0D and completion $1C24; remote monitor read $A5 from minimal_result at $1C3E.

Completion

• Tests run: scripts/build-minimal.ps1 twice; scripts/run-minimal.ps1 -LimitCycles 30000000; scripts/verify-minimal.ps1; tests/grammar/validate.ps1 as a coordination regression.
• Results: repeatable build; x128 native autostart and visible signature pass; monitor trace contains $1C0D and $1C24; result byte is $A5; grammar fixtures still report 7 accepted, 12 rejected.
• Files changed: src/platform/minimal.s, cfg/minimal-c128.cfg, three platform scripts, two monitor command files, and this claim.
• Remaining risks: the load address and result location are probe-local, not the final compiler map; MMU/common-RAM behavior is intentionally untested and belongs to E01-S02.