# Technical documentation

Start with [current status](STATUS.md), [prebuilt installation](INSTALL.md), [building and tests](BUILD.md), [screenshots](SCREENSHOTS.md), and [publication audit](AUDIT.md).

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](ARCHITECTURE.md)
- [Synthetic BIOS implementation](BIOS_IMPLEMENTATION.md)
- [Clock and interrupt boundary optimization](BOUNDARY_PERFORMANCE_20261015.md)
- [Canonical CGA cursor presentation](CGA_CURSOR.md)
- [Native CGA presentation](CGA_RENDERER_IMPLEMENTATION.md)
- [Original XT guest clock BIOS](CLOCK_IMPLEMENTATION.md)
- [Original-8088 execution checkpoint](CPU_IMPLEMENTATION.md)
- [REU floppy sector implementation](DISK_IMPLEMENTATION.md)
- [DOS disk inspection and fixture creation](DISK_TOOLS.md)
- [Text, CGA, and keyboard](DISPLAY_INPUT.md)
- [Existing emulator references](EXISTING_EMULATORS.md)
- [Native Ultimate file commands](FILES_IMPLEMENTATION.md)
- [Independent A/B floppy core](FLOPPY_CORE.md)
- [Standalone native floppy export fixture](FLOPPY_EXPORT_PROTOTYPE.md)
- [User floppy media, save and swap — implementation boundaries2026-10-17](FLOPPY_MEDIA_DESIGN.md)
- [Genuine DOS CGA application gate](GENUINE_CGA_WORKFLOW.md)
- [Genuine GW-BASIC ASCII hangman](GWBASIC_HANGMAN_DEMO.md)
- [A+C development workflow](HARDWARE_AC_WORKFLOW.md)
- [Development recovery and fixture preparation](HARDWARE_RECOVERY_IMPLEMENTATION.md)
- [Physical C64U cache verification](HARDWARE_TESTING.md)
- [Native alarm hints: research only](HARDWARE_TIMER_RESEARCH_20261015.md)
- [Retaining HD failure evidence](HD_FAILURE_EVIDENCE.md)
- [Hard-disk implementation and copied code](HD_IMPLEMENTATION.md)
- [Native C64 keyboard input](HOST_INPUT_IMPLEMENTATION.md)
- [Standalone IEC / D81 development helper](IEC_STANDALONE_IMPLEMENTATION.md)
- [Cold whole-floppy import](IMAGE_IMPORT_IMPLEMENTATION.md)
- [Original XT keyboard BIOS and bounded waiting](KEYBOARD_IMPLEMENTATION.md)
- [Memory, paging, and coherence](MEMORY.md)
- [](MEMORY_BUDGET.md)
- [Guest memory implementation checkpoint](MEMORY_IMPLEMENTATION.md)
- [V1 native disk controls: measured integration checkpoint](MODAL_MEDIA_ARCHITECTURE.md)
- [Genuine MODE hardware workflow](MODE_HARDWARE_WORKFLOW.md)
- [Native CIA2 elapsed clock](NATIVE_CLOCK_IMPLEMENTATION.md)
- [Opt-in native whole-file REU recovery](NATIVE_FILE_RECOVERY.md)
- [Matched INI release build](NATIVE_INI_BUNDLE.md)
- [Native Ultimate installer and folder launcher — research proposal](NATIVE_INSTALLER_DESIGN.md)
- [Native startup interface diagnosis](NATIVE_LAUNCH_DIAGNOSIS.md)
- [Optional native media tests](NATIVE_MEDIA_TESTS.md)
- [Configured native startup and runtime](NATIVE_RUNTIME_IMPLEMENTATION.md)
- [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_SAVE_IMPLEMENTATION.md)
- [Native SETUP configuration codec](NATIVE_SETUP_CONFIG.md)
- [Native SETUP build and current scope](NATIVE_SETUP_INSTALLER.md)
- [Native START / main handoff ABI 1](NATIVE_START_HANDOFF.md)
- [Physical native SAVE write investigation](NATIVE_WRITE_DIAGNOSIS.md)
- [Native FILE/TEXT/INPUT/PIT/GFX code overlays](OVERLAYS_IMPLEMENTATION.md)
- [> V1 steering, 2026-10-17: further performance work is deferred until after the [V1 endpoint](V1_ENDPOINT.md). The 50%/85% targets below remain post-V1 objectives, not V1 release gates. Existing measurements and correctness constraints are retained.](PERFORMANCE.md)
- [XT performance assessment — 2026-10-15](PERFORMANCE_ASSESSMENT_20261015.md)
- [Next performance architecture: measured feasibility, not implementation approval](PERFORMANCE_RESEARCH_20261015.md)
- [Implementation plan for review](PLAN.md)
- [PC port implementation](PORTS_IMPLEMENTATION.md)
- [Documentation websites](PROGRESS_SITE.md)
- [Coherent guest and REU range transfers](RANGE_IMPLEMENTATION.md)
- [User requirement coverage](REQUIREMENTS.md)
- [Research record and source register](RESEARCH.md)
- [REU allocation and performance](REU_ALLOCATION_POLICY.md)
- [REU transfer slice](REU_IMPLEMENTATION.md)
- [Sector storage and persistence](STORAGE.md)
- [Behavior tests and end-user acceptance](TESTING.md)
- [Native text presentation](TEXT_RENDERER_IMPLEMENTATION.md)
- [Native elapsed time, PIT and original-8088 IRQ delivery](TIMER_IRQ_IMPLEMENTATION.md)
- [Turbo Pascal](TURBO_PASCAL.md)
- [Bounded asynchronous Ultimate transport](UCI_IMPLEMENTATION.md)
- [Optional hardware automation](UPSTREAM_HARDWARE_TOOLS.md)
- [Source-built development candidate](V1_CANDIDATE.md)
- [V1 endpoint: install, use and keep your work](V1_ENDPOINT.md)
- [V1 human acceptance checklist](V1_HUMAN_CHECKLIST.md)
