docs/learnings/F007-gotchas.md

• Hardcoding port 8000 in container startup or health checks can cause false-negative readiness on HuggingFace Spaces where PORT=7860 is injected at runtime (F007)
• API health checks can report green while episodes still fail unless probes also assert at least one bundled *.sqlite file exists under data/databases (F007)
• uv run openenv validate --verbose can fail non-docker modes on missing callable main() while still reporting Docker mode as supported, so Space submissions should evaluate readiness by deployment mode matrix instead of a binary pass/fail read (F007)