# Scaffold .gitignore for a PSXRecomp game repository (New Project Layout).
# Aligned with docs/ci/templates/game.gitignore.

# Build outputs
/build/
/build-*/
/out/
/.happypath/

# Setup-host: players Generate game C locally (CI clears generated/).
/generated/
# psxrecomp_cli.py work areas (overlay toolchain download, static overlay
# shard evidence -- the latter holds bytes read from the disc).
/.cache/

# Release packaging
/release-stage/
/dist/
*.zip

# Local PlayStation assets (never commit dumps / BIOS)
/bios/
/isos/
/saves/
/prepared_disc/
/disc/
.settings/

# Disc / image / memcard formats
*.bin
*.cue
*.iso
*.img
*.sub
*.ccd
*.mcd
*.mcr
*.chd
*.car
SCPH*.BIN

# Local path/config stubs
bios.cfg
disc.cfg
rom.cfg
settings.toml

# Local analysis scratch — GPU frame captures / parity dumps (the default
# --out for tools/gpu_frame_*.py and gpu_parity.py) and asset rips pulled off
# the disc. Multi-hundred-MB binaries land here and are rejected by GitHub's
# 100 MB blob limit, and ripped disc content must never be committed at all.
/analysis/

# Ghidra / local analysis
/ghidra/projects/
*.gpr
*.rep/
*.lock
*.lock~

# Editor / cache
.vs/
.vscode/
*.user
*.log
.DS_Store
__pycache__/
CMakeCache.txt
CMakeFiles/
compile_commands.json

# Runtime artifacts from psx-runtime launches
psx_crash.txt
psx_last_run_report.json
psx_screenshot.bmp
psx_freeze_heartbeat.json
.psxrecomp_last_generate
.psxrecomp_write_probe
starvation_dump.jsonl

# Diagnostic dumps (root-level) — keep catalog / probe trackable
/*.json
/*.bmp
/*.png
!/catalog_identity.json
!/disc_probe.json
!/.recomp.json

# Disc file overrides (files extracted from the user's own discs, e.g. the USA maps)
disc_override/

# The developer's play folder lives in the project root: local executables,
# backups, logs and scratch files
/*.exe
/*.bat
/*.ini
*.bak
*.bak[0-9]*
/game.toml.*
/manifest.toml.*
/CMakeLists.txt.bak
/mods/state.toml*
/mods/bundled*/
/mods/README.md
/dis_*.txt
/scan*.txt
/mipsdis.py
/psx_*.txt
/psxrecomp_*.txt
/settings.toml*
/cache/
/overlay_toolchain/
/overlay_captures.json.d/
/assets/fonts/
/assets/img/
/licenses/
/tools/experiments/
/tools/pool_*_sites.txt
/tools/overclock_slider.pyw

# The disc as extracted files ([runtime] disc_folder): game data, never commit.
tsr_data/

# Release kit: versions/<name> are generated (tools/make_disc_project.py --kit)
/versions/
