Technical documentation
Start with current status, prebuilt installation, building and tests, screenshots, and publication audit.
The following are implementation/design notes. They describe individual slices, historical measurements or acceptance targets; current qualification is summarized in STATUS.md. Local working records and logs are not distributed.
- Architecture contract
- Synthetic BIOS implementation
- Clock and interrupt boundary optimization
- Canonical CGA cursor presentation
- Native CGA presentation
- Original XT guest clock BIOS
- Original-8088 execution checkpoint
- REU floppy sector implementation
- DOS disk inspection and fixture creation
- Text, CGA, and keyboard
- Existing emulator references
- Native Ultimate file commands
- Independent A/B floppy core
- Standalone native floppy export fixture
- User floppy media, save and swap — implementation boundaries2026-10-17
- Genuine DOS CGA application gate
- Genuine GW-BASIC ASCII hangman
- A+C development workflow
- Development recovery and fixture preparation
- Physical C64U cache verification
- Native alarm hints: research only
- Retaining HD failure evidence
- Hard-disk implementation and copied code
- Native C64 keyboard input
- Standalone IEC / D81 development helper
- Cold whole-floppy import
- Original XT keyboard BIOS and bounded waiting
- Memory, paging, and coherence
- Guest memory implementation checkpoint
- V1 native disk controls: measured integration checkpoint
- Genuine MODE hardware workflow
- Native CIA2 elapsed clock
- Opt-in native whole-file REU recovery
- Matched INI release build
- Native Ultimate installer and folder launcher — research proposal
- Native startup interface diagnosis
- Optional native media tests
- Configured native startup and runtime
- Current update,2026-10-15: production SAVE issues two256-byte WRITE requests for every512-byte sector, advances the far pointer after each successful half, and advances the logical sector after the second half.720 sectors require1440 writes; reopen/content comparison still reads512-byte sectors. Failure-half0/1 is meaningful only for WRITE phase2/3. The actual paired hardware test proved512 corruption versus exact2x256; whole-disk physical verification remains pending. ROOT d883c678/88669999 passes428+298+73 fresh checks; standalone exporter4001 bytes/f4c7cadb, twelve other helpers unchanged. Historical validation below identifies the previous union; latest evidence is agentworking/evidence/split-save-current-root-20261015.json.
- Native SETUP configuration codec
- Native SETUP build and current scope
- Native START / main handoff ABI 1
- Physical native SAVE write investigation
- Native FILE/TEXT/INPUT/PIT/GFX code overlays
- > V1 steering, 2026-10-17: further performance work is deferred until after the V1 endpoint. The 50%/85% targets below remain post-V1 objectives, not V1 release gates. Existing measurements and correctness constraints are retained.
- XT performance assessment — 2026-10-15
- Next performance architecture: measured feasibility, not implementation approval
- Implementation plan for review
- PC port implementation
- Documentation websites
- Coherent guest and REU range transfers
- User requirement coverage
- Research record and source register
- REU allocation and performance
- REU transfer slice
- Sector storage and persistence
- Behavior tests and end-user acceptance
- Native text presentation
- Native elapsed time, PIT and original-8088 IRQ delivery
- Turbo Pascal
- Bounded asynchronous Ultimate transport
- Optional hardware automation
- Source-built development candidate
- V1 endpoint: install, use and keep your work
- V1 human acceptance checklist