Matthew Stanley f89dadc22e docs: overlay cache v2 rearchitecture spec ...

Audit of the current overlay-cache subsystem (loader, capture, autocompile,
compile tool) plus the design target. Key finding: the correctness model is
sound (dispatch re-validates live RAM vs per-function code_crc every call, so
no stale execution) -- the problems are efficiency: whole-region-CRC build
keying causes redundant DLLs, a per-dispatch full CRC32 taxes warm code, and
capture/dlopen/JIT run on the main thread. Phased plan P1-P5.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

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

..

assets

README: add PSXRecomp logo at top

2026-05-20 12:31:11 -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_wtrace_hook.patch

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

2026-05-03 16:43:07 -07: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

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

config_schema.md

Ape Escape support: framework WIP snapshot (safe haven)

2026-06-04 12:48:38 -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

FEATURES.md

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

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

MEMCARD_AUDIT_2026_04_28.md

phase4: SELECT-deassert protocol reset + slot-state instrumentation

2026-04-29 14:46:26 -07:00

OVERLAY_CACHE_V2.md

docs: overlay cache v2 rearchitecture spec

2026-06-25 23:16:17 -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

recursion: make CPS the DEFAULT (opt-out via PSX_CPS=0)

2026-06-18 14:10:44 -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

feat(psx): verified-enhancement shadow — SPU audio + 15-bit CRT LUT

2026-06-12 04:25:56 -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

TOMBA2_EXC_CONSULT.md

docs: confirm frame-1997 root cause with live data (EPC sentinel in TCB) + fix design + consult package

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

TOMBA2_SPLASH_ATTRACT_PLAN.md

docs: CORRECTION — CD streaming is NOT the immediate blocker (directory traversal works)

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

TOMBA2_WHOOPEE_BAIL.md

docs: splash->attract is first-divergence (CD RULED OUT) + ~17k crash note

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