# Xbox DVD Tools / Project Frankenstein
#
# Canonical Git repository: xbox-dvd-tools
#
# Git contains source code, scripts, hand-maintained configuration,
# documentation, schemas, and deliberately selected small fixtures.
#
# Firmware, dumps, media images, generated analyzer output, emulator run
# output, and bulk evidence belong under /srv/project-frankenstein/artifacts.

# ---------------------------------------------------------------------------
# Local Git-import audit state
# ---------------------------------------------------------------------------
/_git_import_audit/
/xbox-dvd-tools-git-import-audit.zip
/xbox-dvd-tools-import-preflight.*
/.gitignore.before-import-prep.*
/.gitattributes.before-import-prep.*

# ---------------------------------------------------------------------------
# Python caches and local tool state
# ---------------------------------------------------------------------------
__pycache__/
*.py[cod]
.pytest_cache/
.mypy_cache/
.ruff_cache/
.coverage
htmlcov/

# ---------------------------------------------------------------------------
# IDE/editor state
# ---------------------------------------------------------------------------
.idea/
.vs/
*.user
*.suo
*.VC.db
*.VC.opendb
*.code-workspace.user

# Keep selected shared VS Code project configuration reviewable.
.vscode/*
!.vscode/tasks.json
!.vscode/settings.json
!.vscode/extensions.json
!.vscode/launch.json

# ---------------------------------------------------------------------------
# Native and package build products
# ---------------------------------------------------------------------------
/build/
/dist/
/bin/
*.obj
*.o
*.pdb
*.ilk
*.exp
*.lib
*.dll
*.exe
*.egg-info/
wheels/

# ---------------------------------------------------------------------------
# Archives, update packages, and transfer/result bundles
# ---------------------------------------------------------------------------
/dl/
*.zip
*.7z
*.rar
*.tar
*.tar.gz
*.tgz

# ---------------------------------------------------------------------------
# Disc/media images
# ---------------------------------------------------------------------------
/disc_dumps/
*.iso
*.cci
*.img
*.raw
*.vhd
*.vhdx

# ---------------------------------------------------------------------------
# Firmware, ROM/RAM captures, extracted payloads, and binary evidence
# ---------------------------------------------------------------------------
#
# Deliberately ignore binary captures everywhere. A small deterministic test
# fixture may be admitted later with a narrow !path/to/file.bin exception
# after provenance and licensing review.
*.bin
*.dld
*.rom
*.ram
*.fw

/artifacts/
/dumps/
/firmware/
/firmwarehq_LG/
/hitmem_dumps/
/memdumps/
/patched_firmware/
/extractor_work/
/staging/
/staging_candidates/
/normalized_payloads/
/decrypted_payloads/
/stage1_payloads/

# ---------------------------------------------------------------------------
# Analyzer/disassembler generated trees
# ---------------------------------------------------------------------------
/audit_reports/
/disassembly/
/disassembly_hitmem_direct_plaintext/
/stage5b_findings/
/stage5b_v25_hitmem_passthrough_full/
/payload_region_maps/
/hitmem_map_probes/
/logs/
/results/
/docs/debug/
/docs/reports/
/device_profiles/

# Generated runtime/integration experiment trees
/resident_strategy_stage6r_runtime_integration/
/payload_region_classifier/decompressed_records/

# ---------------------------------------------------------------------------
# MN103S emulator generated runs and probe output
# ---------------------------------------------------------------------------
/scripts/toolchain/mn103s_emu_trace_v17/emutests/

# Versioned response captures copied out of live runs
/scripts/toolchain/mn103s_emu_trace_v17/*_responses/
/scripts/toolchain/mn103s_emu_trace_v17/*_live_responses/

# Generated per-case probe/output directories
/scripts/toolchain/mn103s_emu_trace_v17/*_report_cases/
/scripts/toolchain/mn103s_emu_trace_v17/**/*_report_cases/

# Generated trace/log/stdout/stderr files anywhere in the emulator tree
/scripts/toolchain/mn103s_emu_trace_v17/**/*.trace.csv
/scripts/toolchain/mn103s_emu_trace_v17/**/*.trace.jsonl
/scripts/toolchain/mn103s_emu_trace_v17/**/*.run.log
/scripts/toolchain/mn103s_emu_trace_v17/**/stdout.txt
/scripts/toolchain/mn103s_emu_trace_v17/**/stderr.txt

# Generated emulator reports. README, handoff, source, configs, and launch
# scripts remain eligible unless excluded by another rule.
/scripts/toolchain/mn103s_emu_trace_v17/**/*_report.json
/scripts/toolchain/mn103s_emu_trace_v17/**/*_report.md
/scripts/toolchain/mn103s_emu_trace_v17/**/*_summary.json
/scripts/toolchain/mn103s_emu_trace_v17/**/*_summary.md

# Generic generated runtime folders
**/backups/
**/stdout/
**/stderr/
**/traces/
**/trace/
**/run_output/
**/run_outputs/
**/live_responses/
**/report_cases/

# ---------------------------------------------------------------------------
# Generated chain inventories/manifests and large analysis products
# ---------------------------------------------------------------------------
/stage[0-9]*_*.csv
/stage[0-9]*_*.json
/stage[0-9]*_*.jsonl
/checksum_candidate_shape_report.*
/checksum_outlier_probe.*
/checksum_outlier_probe_contexts.md
/checksum_outlier_probe_details.csv
/family_deep_report.*
/outlier_analysis_report.*
/profile_verification_report.*
/target_outlier_dossiers*
/directory_listing.txt
/fleet_manifest.txt
/orchestrator_log.txt
/unpack_fleet.log
/flash_log.txt
/flasher_debug.log
/vector_smc_log.txt
/status.txt

# ---------------------------------------------------------------------------
# Vendored references and binary documents
# ---------------------------------------------------------------------------
#
# Keep textual project documentation in Git. Store third-party PDFs and other
# heavyweight reference documents in the artifact catalog.
*.pdf

# ---------------------------------------------------------------------------
# Local server/storage preflight material
# ---------------------------------------------------------------------------
/pf_*preflight*
/pf_gitweb_*
/pf_storage_*

# ---------------------------------------------------------------------------
# Temporary packaging and scratch state
# ---------------------------------------------------------------------------
/_stage/
/_extract/
/tmp/
*.tmp
*.temp
*.bak
*.swp
*~
.DS_Store
Thumbs.db

# ---------------------------------------------------------------------------
# Additional generated-output exclusions confirmed by the v3 audit
# ---------------------------------------------------------------------------

# Build, validation, normalization, and emulator logs
*.log

# Generated emulator result files kept beside source/configuration
/scripts/toolchain/mn103s_emu_trace_v17/*_trace.csv
/scripts/toolchain/mn103s_emu_trace_v17/*.output.txt
/scripts/toolchain/mn103s_emu_trace_v17/*_live.jsonl
/scripts/toolchain/mn103s_emu_trace_v17/test_cands.csv

# Generated bulk reports/maps that can be reproduced from source inputs
/payload_region_classifier/
/scripts/shared/fleet_profiles.json
/docs/xbox_PCJD4_dependency_tree.txt
/docs/analyzer_log.txt

# Generated CSV products in research/audit helper directories
/scripts/toolchain/research/bh/*.csv
/scripts/toolchain/stage5_region_overlap_audit/*.csv

# ---------------------------------------------------------------------------
# Images pending provenance/classification review
# ---------------------------------------------------------------------------
#
# Exclude all image assets from the initial baseline. Reviewed files can later
# be admitted with narrow !path/to/file.ext allowlist rules.
*.png
*.jpg
*.jpeg
*.jpe
*.bmp
*.gif
*.ico
*.tif
*.tiff
*.webp
*.svg
*.avif
*.heic
*.heif
*.dds
*.psd
*.xcf
*.ai
*.eps
*.ppm
*.pgm
*.pbm

