Matthew Stanley e03c743e87 tools: add Linux macOS dev setup helper ...

Add a conservative source-checkout setup helper based on the Linux quick-start intent from PR #54.

The script builds the CLI/recompiler tools, refreshes BIOS C when a BIOS is present, and builds the BIOS-only runtime only when BIOS/generated sources are available. It deliberately leaves game project creation to the existing CLI generator.

Co-authored-by: Keeganator <keegan.pan@gmail.com>

2026-07-21 17:02:05 -07:00

..

assets

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

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

internal

launcher: expose the Vulkan renderer

2026-07-21 15:55:16 -07:00

AOT_OVERLAY_PLAN.md

aot: deduplicate complete shard pairs safely

2026-07-20 14:13:46 -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

tools: add Linux macOS dev setup helper

2026-07-21 17:02:05 -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

runtime: keep Vulkan opt-in and remove old launcher

2026-07-21 16:31:36 -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

DATA_SHARDS.md

data-shards spike: memoized pure-function replay (capture/verify/replay + cycle-faithful credit)

2026-07-14 11:08:02 -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

ecosystem-watch.md

docs: credit PR16 Vulkan source developer

2026-07-21 16:42:54 -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

LOAD_TIME_ZERO.md

docs: record MMX5 and MMX6 load smoke passes

2026-07-14 23:59:50 -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

runtime: keep Vulkan opt-in and remove old launcher

2026-07-21 16:31:36 -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