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

---

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

E07-S01 Claim

Intended change

Create and verify a PowerShell builder that always starts from a fresh copy of the existing Vim work D81, injects currently available Nova128 artifacts, and never changes the source image.

File area

• scripts/prepare-disk.ps1
• tests/disk/prepare-disk.tests.ps1
• generated files under build/
• this claim

Acceptance evidence

• Copies ../vim/work.d81; never writes the original.
• Injects compiler/examples deterministically with c1541.
• Rebuilding starts from a known clean image.
• Script clearly reports missing tools and source images.

Coordination notes

• E01-S01 is complete and provides build/minimal.prg, the only current Nova128 executable artifact.
• E01-S02 is active in separate platform-probe files.
• This story does not add editor/compiler launchers.

Work log

• Confirmed source D81 SHA-256 before work: CE4FAE640A8558977C9C0AF2FD76769C1EF997E7445000C4C7C04638D05D6081.
• Confirmed VICE 3.10 c1541.exe is installed.
• Added prepare-disk.ps1 with validated defaults, explicit source/output separation, fresh-copy rebuilds, optional-artifact warnings, and verified c1541 directory entries.
• Added deterministic ASCII-to-PETSCII SEQ conversion for future .n8 examples, sorted by filename.
• Added an integration test that injects a compiler-shaped PRG, the E01-S01 probe, and a generated example into a disposable image.
• Deliberately damaged the first output, rebuilt it, and obtained the same SHA-256 from the clean source copy.
• Exercised missing source, missing tool, source/output alias rejection, and absent optional artifact paths.

Completion

• Tests run: tests/disk/prepare-disk.tests.ps1; tests/grammar/validate.ps1; PowerShell parser validation for both scripts; default scripts/prepare-disk.ps1; c1541 -list and read-back inspection
• Results: tests passed; two clean preparations produced SHA-256 208EF297611453CE739B78AF4F7DF59455107A549C1CA15E9EF6B949D56FDB68; source SHA-256 remained CE4FAE640A8558977C9C0AF2FD76769C1EF997E7445000C4C7C04638D05D6081; directory entries n128c (PRG), n128probe (PRG), and demo.n8 (SEQ) were verified
• Files changed: scripts/prepare-disk.ps1, tests/disk/prepare-disk.tests.ps1, and this claim
• Remaining risks: the real N128C.PRG and production examples do not exist yet, so the test uses the verified E01-S01 PRG as a compiler-shaped fixture; the default run warns and continues until those optional artifacts are built