Matthew Stanley 42a69624b1 fix(tools,docs): diagnose unconfigured recompiler build dirs in regen_bios ...

A contributor bringing up a new title hit four dead-ends in a row, three of
which were the same missing step wearing different masks: `regen_bios.sh`
builds the BIOS emitter but never configures it, and nothing said so.

- "no recompiler build dir found (set PSXRECOMP_BIOS_BUILD)" pointed at an
  env var when a fresh clone has no CMake tree to point it at. Both discovery
  failure and an explicit override now name the actual missing step and print
  the configure command.
- Setting PSXRECOMP_BIOS_BUILD skipped the CMakeCache.txt check that discovery
  applies, so an unconfigured directory reached `cmake --build` and died with
  cmake's bare "Error: could not load cache". Validate the override too.
- A CMake configure that FAILS still writes CMakeCache.txt — the cache lands
  before the generate step, which never runs after a FATAL_ERROR. So "has a
  cache" did not mean "is buildable": the directory left behind by his failed
  SDL and BIOS-backend configures had a cache and no build.ninja, and the
  build reported only `ninja: error: loading 'build.ninja': GetLastError() =
  2`. Read the generator out of the cache, check for its build files, and say
  what happened. Discovery skips such a directory and keeps looking rather
  than selecting it and dying; an unrecognized generator falls through to
  cmake instead of inventing a failure.

All errors now go to stderr (the old one went to stdout).

Docs: the README's framework build block configured the recompiler and jumped
straight to the runtime build, omitting the required BIOS regen between them —
exactly the hole he fell into. It is now the same numbered 1/2/3 sequence
docs/BUILDING.md already used. BUILDING.md gains troubleshooting entries for
the two CMake half-configured-directory errors, the fresh-clone "No recompiled
BIOS backend available", and PSXRECOMP_BIOS_BUILD being resolved relative to
the framework root rather than the shell's cwd.

Verified: both new failure paths and the half-configured-directory case
reproduce and now self-explain; discovery precedence (build-t2 over build),
explicit-override precedence, Ninja/Makefiles/unknown generators, and a CRLF
cache all behave; end-to-end `regen_bios.sh --config bios/OpenBIOS.toml`
still emits (Dispatch entries: 3911).

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

2026-08-05 18:03:03 -07:00

..

aot_overlay_spike

aot: deduplicate complete shard pairs safely

2026-07-20 14:13:46 -07:00

cycle_testrom

runtime: HLE tier wiring + carried instrumentation from the card-load hunt

2026-07-02 16:27:57 -07:00

divergence

tools/divergence: persist the native-vs-interp first-divergence toolkit

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

duckstation

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

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

mdec_pin

fix(mdec): truncate 15bpp channel to uint8 before RGB555 (the rainbow bug)

2026-06-27 21:06:04 -07:00

_arm_button_table.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_arm_gate.py

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

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

_arm_modal_v2.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_arm_modal.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_beetle_smoke.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_bmp_stats.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_capture_button_press.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_capture_repro.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_card_read_summary.py

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

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

_card_txn_range.py

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

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

_card_txn.py

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

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

_card_writes.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_chain_diag2.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_chain_diag.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_a180.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_bfc1a1bc.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_dispatcher_path.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_fn19a58.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_fn24f00.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_full_ring.py

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

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

_check_gate.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_press_path.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_check_wtrace.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_debug_seeds.py

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

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

_decode_strs.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_decode_substate_jt.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_demo_branch_emit.py

Phase 1 complete: recompiler proven correct on SCPH1001.BIN

2026-04-11 21:26:04 -07:00

_dirty_block_log.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dispatch_check_v2.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dispatch_check_v3.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dispatch_check.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dispatch_tail.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_diverge_table.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dual_smoke.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dump_all_state_entries.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_beetle_tail.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dump_cursor_writes.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_inventory.py

Phase 1 complete: recompiler proven correct on SCPH1001.BIN

2026-04-11 21:26:04 -07:00

_dump_missing_funcs.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_modal_stubs.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_ram_caller.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_recomp_tail.py

two-process refactor: replace embedded oracle with independent psx-runtime + psx-beetle

2026-05-05 21:06:44 -07:00

_dump_state6_entry.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_state6.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_state7.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_dump_suspect.py

Phase 1 complete: recompiler proven correct on SCPH1001.BIN

2026-04-11 21:26:04 -07:00

_dump_unknown.py

Phase 1 complete: recompiler proven correct on SCPH1001.BIN

2026-04-11 21:26:04 -07:00

_examine_handler.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_extract_trampoline_seeds.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_find_428f0.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_find_1005a910.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_find_dispatcher_caller.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_fn_a1.py

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

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

_fn_entry_v0.py

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

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

_fn_exit.py

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

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

_fn_stats.py

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

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

_fntrace_smoke.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_freeze_diag2.py

recompiler: seed missing modal_stub function (BFC1A1BC), add unknown_dispatch_log ring

2026-05-05 22:13:06 -07:00

_freeze_diag.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_freeze_sample.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_full_scan.py

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

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

_func_histogram.py

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

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

_hist_window.py

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

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

_irq_tail.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_list_cmds.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_loop_caller.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_missing_funcs.json

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_modal_state.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_pad_txns.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_parse_crash.py

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

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

_ping.py

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

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

_press_cross.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_probe_one.py

SPU ADSR + free-voice CURVOL fix: chime fans across all 24 voices

2026-05-09 19:09:48 -07:00

_psx_header_dump.py

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

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

_recent_entries.py

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

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

_recomp_dispatch_during_press.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_recomp_fn_entry_correct.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_recomp_press_full.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_rss_poll.sh

checkpoint: options/new-game diagnostics handoff

2026-05-17 11:29:26 -07:00

_scan_widget_table.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_screenshot_meta.py

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

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

_slot_summary.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_spu_capture.py

SPU ADSR + free-voice CURVOL fix: chime fans across all 24 voices

2026-05-09 19:09:48 -07:00

_spu_probe.py

SPU ADSR + free-voice CURVOL fix: chime fans across all 24 voices

2026-05-09 19:09:48 -07:00

_spu_ring_diff.py

SPU ADSR + free-voice CURVOL fix: chime fans across all 24 voices

2026-05-09 19:09:48 -07:00

_tail_rings.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_tomba_bios_thunks.py

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

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

_tomba_probe.py

runtime + recompiler: Tomba boot through BIOS into Whoopee Camp FMV

2026-05-11 12:34:49 -07:00

_top_funcs_recent.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_trace_cross_state6.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_trace_input_handler.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_unknown_dispatch.py

recompiler: seed missing modal_stub function (BFC1A1BC), add unknown_dispatch_log ring

2026-05-05 22:13:06 -07:00

_watch_bc0.py

Preserve PSX memory-card debug state

2026-05-07 17:57:34 -07:00

_wtrace_dump.py

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

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

add_ds_bios_paths.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

add_ds_setup_bypass.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

add_gte_seeds.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

add_trampoline_seeds.py

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

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

analyze_bc0.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

analyze_evcb_writes.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

analyze_sio_trace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

analyze_sio.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

analyze_sm.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

audio_ab_diff.py

audio: always-on PCM tap rings + oracle WAV capture (SNES-campaign port)

2026-07-10 00:00:09 -07:00

audio_analyze.py

audio: always-on PCM tap rings + oracle WAV capture (SNES-campaign port)

2026-07-10 00:00:09 -07:00

audio_archive_ab.py

spu/cdrom: live voice loop-address + CD-audio volume matrix (X5 +11dB fix)

2026-07-10 01:54:46 -07:00

audio_capture_ab.py

audio: always-on PCM tap rings + oracle WAV capture (SNES-campaign port)

2026-07-10 00:00:09 -07:00

audio_pair_segments.py

spu/cdrom: live voice loop-address + CD-audio volume matrix (X5 +11dB fix)

2026-07-10 01:54:46 -07:00

audio_spectral_ab.py

audio: always-on PCM tap rings + oracle WAV capture (SNES-campaign port)

2026-07-10 00:00:09 -07:00

audit_config.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

bios_emitter_fingerprint.sh

feat: OpenBIOS support — profile-driven BIOS recompilation

2026-07-23 17:10:23 -03:00

bmp_to_png.py

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

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

build_cli.py

fix: repair CLI BIOS and launcher builds

2026-07-28 22:46:55 -07:00

build_instruction_coverage.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

build_instruction_inventory.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

build_oracle.sh

Make SDL3 the default runtime backend

2026-07-28 09:22:28 -07:00

check_a0_table_full.py

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

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

check_b0_table.py

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

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

check_c0_table.py

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

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

check_card_mode.py

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

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

check_card.py

fix: per-slot card SIO state + card-specific IRQ delay

2026-04-26 00:36:15 -07:00

check_chain_init.py

seeds: 5 dispatch_miss entries for chain writer PCs (vertical slice partial)

2026-04-30 14:26:19 -07:00

check_dispatch.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

check_ds_patch.py

duckstation oracle: document post-rebuild boot-failure investigation

2026-04-14 02:03:14 -07:00

check_gates.py

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

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

check_pc_dispatch.py

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

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

check_postfix_state.py

seeds: 5 dispatch_miss entries for chain writer PCs (vertical slice partial)

2026-04-30 14:26:19 -07:00

check_sector_state.py

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

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

check_setup_dispatch.py

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

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

check_shell_state.py

seeds: 5 dispatch_miss entries for chain writer PCs (vertical slice partial)

2026-04-30 14:26:19 -07:00

check_trampoline_seeds.py

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

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

check_vectors2.py

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

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

check_vectors_and_vtable.py

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

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

click_launcher.ps1

launcher: Phase 5 — controller device picker + DualShock toggle

2026-06-12 15:15:08 -07:00

codegen_audit_game.py

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

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

codegen_audit.py

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

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

collect_game_misses.py

SIO alias dispatch + instant disc speed + game miss collector

2026-05-29 23:42:16 -07:00

compile_overlays.py

fix: make overlay autocompile cache-safe

2026-07-26 09:39:24 -07:00

cosim.py

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

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

coverage_vault.py

integrate interpreter hotpath and AOT sharding

2026-07-20 15:58:43 -07:00

create_release_zip.py

feat(runtime): add CHD discs and mod-owned loading modes

2026-08-03 22:32:17 -07:00

cycle_compare.py

feat(timing): two-anchor REGION mode for cyc_watch — validated stable gate

2026-06-26 21:18:26 -07:00

debug_client.py

feat(debug): screenshot_hires — capture the surface the player actually sees

2026-08-05 15:36:27 -07:00

decode_ctrl_window.py

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

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

decode_evcb.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

decode_handlers.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

decode_insn.py

fix: conditional branch fall-through + Tier 1 reverse debugger

2026-04-21 14:23:09 -07:00

decode_jt.py

fix: conditional branch fall-through + Tier 1 reverse debugger

2026-04-21 14:23:09 -07:00

decode_jtable.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

devtrace_diff.py

tools: label CD known-divergence in devtrace_diff (+ACCURACY_BURNDOWN); keep Beetle oracle unpatched

2026-07-06 11:21:20 -07:00

diff_images.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

disasm_helper.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

disasm_ram.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

drs_filter.py

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

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

ds_screenshot.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

ds_stitch2.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

ds_stitch.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

duck_query2.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

duck_query3.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

duck_query4.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

duck_query5.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

duck_query.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

duck_search.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

dump_data.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

dump_dir_buffers_recomp.py

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

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

dump_evcb_raw.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

dump_imask_trace.py

fix: per-slot card SIO state + card-specific IRQ delay

2026-04-26 00:36:15 -07:00

dump_jtable.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

dump_overlays.py

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

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

dump_recomp_wtrace.py

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

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

dump_sio_trace.py

fix: per-slot card SIO state + card-specific IRQ delay

2026-04-26 00:36:15 -07:00

dump_tomba_misses.py

Add design docs and Tomba miss dump tool

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

dump_wtrace_raw.py

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

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

dump_wtrace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

embed_spirv.py

feat(video): opt-in sub-pixel vertex precision + perspective-correct textures

2026-08-05 14:02:58 -07:00

extract_overlays.py

tools: make large disc reads linear

2026-07-18 06:30:37 -07:00

find_callers.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

find_const.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

find_divergence.py

perf: read_ram 16KB cap + 4KB divergence chunks + send_fmt 64KB buffer

2026-04-23 17:50:47 -07:00

find_evcb_card.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

find_gte_callers2.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

find_gte_callers.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

find_gte_seeds.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

find_long_txn.py

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

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

find_ptr.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

fix_ds_settings.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

fix_duckstation_deps_paths.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

func_size.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

gen_bios_seeds_from_elf.py

Revert "ok"

2026-07-29 03:18:10 -04:00

gen_phase2_seeds.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

gen_tcp_commands.py

Revert "ok"

2026-07-29 03:18:10 -04:00

gpu_info.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

gte_audit.py

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

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

gte_coverage.py

Fix Tomba visual rendering issues

2026-05-17 21:58:55 -07:00

host_thread_probe.py

runtime: fmv_skip_no_xa detection key + host_thread_probe tool

2026-07-02 22:42:26 -07:00

html2txt.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

inspect_card.py

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

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

inspect_dispatch_ring.py

seeds: 5 dispatch_miss entries for chain writer PCs (vertical slice partial)

2026-04-30 14:26:19 -07:00

launch_tomba2_interp_perf.ps1

autocompile: survive quoted interpreter paths + pin Windows Python in launcher

2026-07-20 00:07:33 -07:00

load_probe.py

load: add opt-in event horizon, warm routes, and audio sink

2026-07-14 22:44:31 -07:00

mmio_tally.py

fix: conditional branch fall-through + Tier 1 reverse debugger

2026-04-21 14:23:09 -07:00

overlay_xref.py

Revert "ok"

2026-07-29 03:18:10 -04:00

package_release_macos.sh

feat(tools): shared macOS release packager for game repos

2026-08-03 18:19:34 -07:00

package_release.ps1

Make SDL3 the default runtime backend

2026-07-28 09:22:28 -07:00

parity_diff.py

parity_trace: per-watch-word LAST-WRITER provenance (name the early producer)

2026-06-29 20:43:40 -07:00

parse_dtail.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

parse_sio_trace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

parse_state_trace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

parse_wtrace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

peek_cards.py

runtime: card-read summary + card-data-writes diagnostic rings

2026-04-29 22:20:55 -07:00

press_into_card_view_recomp.py

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

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

press_recomp.py

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

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

print_wtrace.py

Phase 4: seed VBlank chain handler + add RAM write-trace

2026-04-13 21:19:32 -07:00

probe_card_reads.py

runtime: card-read summary + card-data-writes diagnostic rings

2026-04-29 22:20:55 -07:00

probe_card_writes_raw.py

runtime: card-read summary + card-data-writes diagnostic rings

2026-04-29 22:20:55 -07:00

probe_card_writes.py

runtime: card-read summary + card-data-writes diagnostic rings

2026-04-29 22:20:55 -07:00

probe_dirty_ram.py

Seed verified BIOS kernel function 0xBFC15F1C (SIO/PAD interrupt handler)

2026-05-29 23:29:05 -07:00

probe_txn.py

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

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

probe_wtrace.py

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

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

psxmod_pack.py

Revert "ok"

2026-07-29 03:18:10 -04:00

ram2rom.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

rapid_poll.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

raw_dispatch.py

fix: exception handler chain walk + shell reaches Memory Card/CD-ROM screen

2026-04-21 18:13:51 -07:00

raw_summary.py

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

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

raw_tcp_long.py

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

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

raw_tcp.py

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

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

read_evcb.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

read_table.py

feat: 46 GTE library seeds + DuckStation oracle SW readback + debug tooling

2026-04-24 00:29:06 -07:00

readram_test.py

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

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

regen_bios.sh

fix(tools,docs): diagnose unconfigured recompiler build dirs in regen_bios

2026-08-05 18:03:03 -07:00

sample_ra_long.py

Phase 4: seed VBlank chain handler + add RAM write-trace

2026-04-13 21:19:32 -07:00

sample_ra.py

Phase 4: seed VBlank chain handler + add RAM write-trace

2026-04-13 21:19:32 -07:00

scan_branch_delay_hazards.py

Remove all psxrecomp-v4 naming — rename to psxrecomp throughout

2026-05-29 21:14:30 -07:00

scan_evcb.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

scan_f2_sites.py

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

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

scan_imm.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

scan_literal.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

scan_lui.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

scan_range.py

Restructure duckstation as submodule + patch; salvage TCP docs + debug_client

2026-04-14 01:34:27 -07:00

search_ram.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

search_ram.sh

phase4: freeze_check diagnostic + accumulated overnight infra

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

setup_dev.sh

Make SDL3 the default runtime backend

2026-07-28 09:22:28 -07:00

shot_launcher.ps1

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

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

show_ranges.py

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

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

show_wtrace.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

sio_compact.py

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

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

sio_flip_trace.py

runtime: Tomba "Hybrid" legacy pad-config compatibility (per-game opt-in)

2026-06-21 13:43:34 -07:00

sio_tx_dist.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

starvation_walk.py

runtime: drive SIO TX via cycle-paced shifter

2026-04-29 21:15:09 -07:00

step_audit2.py

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

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

step_audit.py

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

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

summarize_reads.py

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

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

test_compile_overlays_additive.py

Harden additive overlay shards and speed interpreter fetch

2026-07-19 12:11:56 -07:00

test_coverage_vault.py

aot: close cross-variant coverage deterministically

2026-07-20 14:06:26 -07:00

tomba_loadtest.py

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

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

trace_audit.py

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

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

trace_range.py

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

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

txn_bytes.py

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

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

txn_dist.py

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

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

txn_summary.py

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

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

verify_audit_schema.py

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

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

verify_card_buffer.py

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

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

verify_ram_exec.py

case A: Beetle wtrace + recomp verification → memcard blocked on AOT gap

2026-04-30 13:10:05 -07:00

verify_with_cross.py

case A: Beetle wtrace + recomp verification → memcard blocked on AOT gap

2026-04-30 13:10:05 -07:00

vet_seeds.py

vet_seeds: show all REJECTs in summary; handle non-nop delay slots

2026-05-30 12:06:59 -07:00

vram_tile.py

phase4: freeze_check diagnostic + accumulated overnight infra

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

window_capture.py

dispatch: Class-A shell-window fix covers OVERLAY code — Tomba2 Whoopee-logo wedge

2026-07-03 09:04:17 -07:00

wtrace_filter.py

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

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