dev

LLM-focused workflow for working in this repo: compile Zig, run the orchestrated test runner, consume test-report.json/html artifacts, and discover/debug ConfigFlags.

1. Aktywuj wirtualne środowisko Pythona poleceniem source .venv/bin/activate — to przygotuje zależności wymagane do pracy ze skill'em dev.
2. Skompiluj powiązania Zig i natywne rozszerzenia poleceniem ato dev compile. Ta komenda buduje grafy, typografy i powiązania sexp, które są konieczne do uruchomienia testów.
3. Uruchom testy za pomocą ato dev test --llm, które wykonuje zorganizowany test runner i generuje raporty w formatach JSON, HTML i LLM-friendly. Możesz filtrować testy flagą -k (np. ato dev test --llm -k solver).
4. Przejrzyj wygenerowane raporty testów znajdujące się w katalogu artifacts/ — test-report.json, test-report.html i test-report.llm.json zawierają szczegółowe wyniki.
5. Odkryj i zweryfikuj flagi konfiguracyjne w całym repozytorium poleceniem ato dev flags. Flagi te kontrolują zachowanie kompilacji (np. ZIG_NORECOMPILE, ZIG_RELEASEMODE) i znajdują się w src/faebryk/libs/util.py.
6. Dla zaawansowanego debugowania użyj opcji --view HEAD --open do porównania wyników z bieżącą gałęzią lub --reuse --baseline HEAD~1 do porównania z poprzednią wersją kodu.