build-small-hackathon/the-apprentice

1# ---------------------------------------------------------------------------2# Local secrets — NEVER push to HF Space.3# ---------------------------------------------------------------------------4.env5.env.local6.env.production7 8# ---------------------------------------------------------------------------9# Python build artifacts10# ---------------------------------------------------------------------------11__pycache__/12*.pyc13*.pyo14*.pyd15.Python16*.egg-info/17.pytest_cache/18 19# ---------------------------------------------------------------------------20# OS junk21# ---------------------------------------------------------------------------22.DS_Store23Thumbs.db24.vscode/25.idea/26 27# ---------------------------------------------------------------------------28# Dev-only directories — they live on the local machine but never need to29# ship to the HF Space. The Space only runs app.py + the oracles/ package30# + prompts/ + assets/sprites.31# ---------------------------------------------------------------------------32 33# Klein sprite generator scripts — only used at build time34modal_backend/35# Most of scripts/ is dev-only. Two are worth shipping as transparency36# tools: curate_trace (used to publish the sample trace for the37# Sharing-is-Caring badge) and mock_prompts (lets anyone inspect the38# exact LLM prompts without running the app). The directory-exclusion39# pattern below allows just those two through.40scripts/*41!scripts/curate_trace.py42!scripts/mock_prompts.py43 44# Training + distillation — produced the LoRA weights, not needed at runtime45training/46 47# Smoke / unit tests — not part of the served app48tests/49 50# Local LoRA adapter weights — published to HF Hub separately51lora-out/52lora-out-v2/53lora-out-tiny/54 55# Pre-chroma-key raw PNGs — *.png is what the app uses56assets/sprites/*_raw.png57assets/sprites/v1_backup/58 59# v2/ is a backup of the same sprites in the flat dir — the runtime loader60# only reads assets/sprites/{name}.png (no subdirs), so v2/ never ships.61assets/sprites/v2/62 63# Pipeline-demo source artifacts + model-comparison tests — not used at64# runtime. The flat demo_*.png files at assets/sprites/ ARE used and stay.65assets/sprites/demo/66 67# Only banner_near.png is referenced by app.py:69. The rest of the parallax68# directory (old Forest Focus assets, v1 backups) is local-only.69assets/parallax/*70!assets/parallax/banner_near.png71assets/parallax/v1_backup/72 73# GGUF artifacts for the local llama-cpp backend74gguf-out/75*.gguf76 77# Captured LLM traces. Session traces accumulate fast and are gitignored,78# BUT curated samples in traces/sample/ ARE committed — they're our79# Sharing-is-Caring badge deliverable: a public artifact showing every80# prompt + response from a real playthrough.81traces/*82!traces/sample/83!traces/sample/**84!traces/README.md85.llama_cpp_cache/86/tmp/oracles_local_llama.log87 88# ---------------------------------------------------------------------------89# Project pivot logs + planning docs — useful to the developer, noise to90# the Space reader. Keep on disk, don't ship.91# ---------------------------------------------------------------------------92PIVOT_LOG.md93IMPLEMENTATION_PLAN.md94CONTRACTS.md95 96# Mocked / debug output dirs97mock_out/98debug_out/99 100# Runtime-generated mock SVG scene images — produced by the101# image-fallback code in oracles/images.py when Klein output is102# unavailable. These accumulate over self-test runs and should103# never ship to the Space.104assets/generated/105