Matthew Stanley c94fcd5e1a docs: add COMPILING_OVERLAYS how-to (overlay_captures.json -> shards) ...

User-facing guide for turning overlay_captures.json into native code:
developer-first framing (ship a full gcc cache), the manual gcc cache
build, the --static bake-into-binary path, and the staleness guard.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-11 14:19:16 -07:00

..

assets

chore: remove game-specific Kula World content from framework repo

2026-07-06 14:53:47 -07:00

internal

opengl: sustain full-rate gameplay and FMV presentation

2026-07-11 14:07:17 -07:00

ARCHITECTURE.md

docs: production-friendly contributor docs + declutter root

2026-07-07 18:25:16 -07:00

ASYNC_OVERLAY_COMPILE.md

overlay(async): gcc-only on gcc boxes (mutually exclusive with sljit) + async-compile is built

2026-06-18 13:54:57 -07:00

audit_inventory.md

Phase B: config-driven unified runtime + BIOS shell boot restored

2026-05-13 01:31:27 -07:00

beetle_cdcmd_trace_hook.patch

debug: PSX_FNTRACE_ALL boot trace; root mechanism of Kula bug 3 found

2026-07-02 20:48:04 +00:00

beetle_sio_trace_hook.patch

docs+patch: psx-beetle oracle on Linux (pinned beetle-psx base + SIO trace hook)

2026-07-02 17:08:19 +00:00

beetle_wtrace_hook.patch

phase 4: fix mc_flag persistence so multi-sector card reads work

2026-05-03 16:43:07 -07:00

beetle-linux.md

oracle: CD-command trace hook + live-diff localizes Kula World bug 3

2026-07-02 19:05:47 +00:00

bios-hardening.md

Move disc_speed docs to psxrecomp README; add B+A as #3 in bios-hardening

2026-05-30 00:13:44 -07:00

BUILDING.md

docs: production-friendly contributor docs + declutter root

2026-07-07 18:25:16 -07:00

CASE_A_AOT_GAP.md

phase 4: fix mc_flag persistence so multi-sector card reads work

2026-05-03 16:43:07 -07:00

COMPILING_OVERLAYS.md

docs: add COMPILING_OVERLAYS how-to (overlay_captures.json -> shards)

2026-07-11 14:19:16 -07:00

config_schema.md

docs: production-friendly contributor docs + declutter root

2026-07-07 18:25:16 -07:00

CYCLE_TIMING_ARCH.md

phase1.0e-a: psx_cycle_count scaffold + cycle-timing arch doc

2026-04-29 19:04:11 -07:00

disc-speed.md

Add design docs and Tomba miss dump tool

2026-05-30 00:02:33 -07:00

dynamic_handler_install.md

phase4: freeze_check diagnostic + accumulated overnight infra

2026-04-28 21:29:19 -07:00

EXECUTION_MODEL.md

docs: production-friendly contributor docs + declutter root

2026-07-07 18:25:16 -07:00

FEATURES.md

overlay: restore overlay DLL cache + capture (faithful port of codex/cache-discovery)

2026-06-07 12:32:19 -07:00

OVERLAY_CACHE_V2.md

docs(overlay-cache v2): interior-entry fragments IMPLEMENTED + runtime-stable

2026-06-25 23:21:50 -07:00

overlay-discovery.md

overlay: restore overlay DLL cache + capture (faithful port of codex/cache-discovery)

2026-06-07 12:32:19 -07:00

overlay-plan.md

overlay: restore overlay DLL cache + capture (faithful port of codex/cache-discovery)

2026-06-07 12:32:19 -07:00

overlay-recompilation-design.md

runtime: fix Bug A — interp jal/jalr must honor the call contract for native overlay callees

2026-06-09 12:25:03 -07:00

overlay-status.md

overlay: mark OV-1 fixed (Inc1-D verified) + flag Inc2 reload-on-return next

2026-06-07 15:46:06 -07:00

psx_bios_disasm.txt

phase4: freeze_check diagnostic + accumulated overnight infra

2026-04-28 21:29:19 -07:00

RECURSION_BUG.md

cleanup: genericize hardcoded dev-machine paths in tracked docs/tools

2026-07-06 11:51:36 -07:00

RELOCATION_MANIFEST_FORMAT.md

phase 4: fix mc_flag persistence so multi-sector card reads work

2026-05-03 16:43:07 -07:00

SHADOW_ENHANCEMENTS.md

cleanup: genericize hardcoded dev-machine paths in tracked docs/tools

2026-07-06 11:51:36 -07:00

STRING_TRANSLATION.md

docs: Appendix Z — full 37-entry vram_patch coverage + palette-family notes

2026-07-06 01:51:23 -07:00

TOMBA2_EXC_CONSULT_RESPONSE.md

docs: Recomp GPT consult response — Option A dual-mode EPC design + safety rails

2026-06-25 23:16:12 -07:00