.gitignore

# ---------------------------------------------------------------------------
# Local secrets — NEVER push to HF Space.
# ---------------------------------------------------------------------------
.env
.env.local
.env.production

# ---------------------------------------------------------------------------
# Python build artifacts
# ---------------------------------------------------------------------------
__pycache__/
*.pyc
*.pyo
*.pyd
.Python
*.egg-info/
.pytest_cache/

# ---------------------------------------------------------------------------
# OS junk
# ---------------------------------------------------------------------------
.DS_Store
Thumbs.db
.vscode/
.idea/

# ---------------------------------------------------------------------------
# Dev-only directories — they live on the local machine but never need to
# ship to the HF Space. The Space only runs app.py + the oracles/ package
# + prompts/ + assets/sprites.
# ---------------------------------------------------------------------------

# Klein sprite generator scripts — only used at build time
modal_backend/
# Most of scripts/ is dev-only. Two are worth shipping as transparency
# tools: curate_trace (used to publish the sample trace for the
# Sharing-is-Caring badge) and mock_prompts (lets anyone inspect the
# exact LLM prompts without running the app). The directory-exclusion
# pattern below allows just those two through.
scripts/*
!scripts/curate_trace.py
!scripts/mock_prompts.py

# Training + distillation — produced the LoRA weights, not needed at runtime
training/

# Smoke / unit tests — not part of the served app
tests/

# Local LoRA adapter weights — published to HF Hub separately
lora-out/
lora-out-v2/
lora-out-tiny/

# Pre-chroma-key raw PNGs — *.png is what the app uses
assets/sprites/*_raw.png
assets/sprites/v1_backup/

# v2/ is a backup of the same sprites in the flat dir — the runtime loader
# only reads assets/sprites/{name}.png (no subdirs), so v2/ never ships.
assets/sprites/v2/

# Pipeline-demo source artifacts + model-comparison tests — not used at
# runtime. The flat demo_*.png files at assets/sprites/ ARE used and stay.
assets/sprites/demo/

# Only banner_near.png is referenced by app.py:69. The rest of the parallax
# directory (old Forest Focus assets, v1 backups) is local-only.
assets/parallax/*
!assets/parallax/banner_near.png
assets/parallax/v1_backup/

# GGUF artifacts for the local llama-cpp backend
gguf-out/
*.gguf

# Captured LLM traces. Session traces accumulate fast and are gitignored,
# BUT curated samples in traces/sample/ ARE committed — they're our
# Sharing-is-Caring badge deliverable: a public artifact showing every
# prompt + response from a real playthrough.
traces/*
!traces/sample/
!traces/sample/**
!traces/README.md
.llama_cpp_cache/
/tmp/oracles_local_llama.log

# ---------------------------------------------------------------------------
# Project pivot logs + planning docs — useful to the developer, noise to
# the Space reader. Keep on disk, don't ship.
# ---------------------------------------------------------------------------
PIVOT_LOG.md
IMPLEMENTATION_PLAN.md
CONTRACTS.md

# Mocked / debug output dirs
mock_out/
debug_out/

# Runtime-generated mock SVG scene images — produced by the
# image-fallback code in oracles/images.py when Klein output is
# unavailable. These accumulate over self-test runs and should
# never ship to the Space.
assets/generated/