generated from GarandPLG/rust-flake-template
GarandPLG
9bc42dc898
Introduce AGENTS.md as an entry point for agents, add CODE_MAP.md with a module overview and diagrams, and create PROGRESS.md to log work progress. Update flake.lock to reflect dependency revisions.
31 lines
2.0 KiB
Markdown
31 lines
2.0 KiB
Markdown
# Dziennik prac
|
|
|
|
## 2026-10-18 — obowiązek poprawnej kompilacji
|
|
|
|
Dopisano do `docs/AGENTS.md` zakaz kończenia zadania z błędami kompilacji Rust oraz obowiązek wykonania `nix develop -c cargo check --all-targets` i usunięcia błędów przed zakończeniem. Zmiana dotyczy wyłącznie dokumentacji.
|
|
|
|
Weryfikacja: `nix develop -c cargo check --all-targets` zakończone sukcesem. Nie powtarzano testów działania gry przy zmianie samej dokumentacji.
|
|
|
|
## 2026-10-18 — przygotowanie kontekstu repozytorium
|
|
|
|
Cel: rozpoznać architekturę i przepływy oraz przygotować trwały kontekst do kolejnych zadań.
|
|
|
|
Wykonano:
|
|
|
|
- Przejrzano źródła Rust, manifest, konfigurację Nix, README, strukturę zasobów i szkiców UI.
|
|
- Przygotowano `docs/CODE_MAP.md`: odpowiedzialności modułów, diagramy uruchomienia i renderowania, przepływ klawiszy i zadań, audio, pakowanie oraz miejsca rozszerzeń.
|
|
- Przygotowano `docs/AGENTS.md`: punkt wejścia dla agentów, zasady pracy, polecenia i ograniczenia weryfikacji.
|
|
- Oddzielono działające ścieżki od placeholderów i niepodłączonej symulacji. Zapisano ryzyka w kodzie kopania do sprawdzenia przed jego aktywacją.
|
|
- Nie zmieniano źródeł gry ani konfiguracji. Zastana modyfikacja `flake.lock` należy do wcześniejszego stanu roboczego.
|
|
|
|
Weryfikacja przez środowisko Nix:
|
|
|
|
| Polecenie | Wynik |
|
|
|---|---|
|
|
| `nix develop -c cargo test --all-targets` | Sukces; oba targety wykonują 0 testów |
|
|
| `nix develop -c cargo fmt --all -- --check` | Sukces |
|
|
| `nix develop -c cargo clippy --all-targets` | Sukces z 54 ostrzeżeniami dla biblioteki, raportowanymi też dla targetu testowego |
|
|
| `cargo run -- -h` wykonywane automatycznie przez shellHook | Kompilacja i pomoc CLI działają |
|
|
|
|
Nie wykonano: interaktywnej rozgrywki, odtwarzania audio, budowy pakietów Nix ani napraw znalezionych problemów. Brak testów oznacza, że pomyślna kompilacja nie potwierdza poprawności mechanik. Kolejne zmiany należy dopisywać jako osobne wpisy z ich walidacją.
|