README.md

Dokumentacja fixOS

Ta dokumentacja dotyczy narzędzia do diagnostyki i naprawy systemu fixOS.

Dla użytkownika

• Pierwsze kroki — instalacja, szybka analiza i bezpieczne czyszczenie.
• Konfiguracja — providery LLM, tryby pracy i zmienne środowiskowe.
• README projektu — pełna lista komend i przykładów.

Dla programisty

• Architektura — przepływ szybkiej i pogłębionej diagnostyki.
• API i moduły — dokumentacja generowana z kodu.
• Graf zależności i pokrycie — raporty generowane; przed publikacją należy je odświeżyć.
• CONTRIBUTING — uruchamianie testów i zasady zmian.
• TODO — wyłącznie aktywne, ręcznie zweryfikowane zadania.

Standardy i diagnostyka

• Standardy Wellmanifest w fixos — wellman, ssot, nohardcode, reuse, semver, uriprocess.
• Decyzje SSOT — wersja pakietu i adres Ollamy.
• Rozwiązywanie problemów — runbook.

Zmiany (wellmanifest/docs v2)

• BUGFIX: zwolnione miejsce przy hardlinkach — space_freed_gb liczy tylko bloki zwrócone systemowi plików.
• SERVICE: wydajność skanów — budżet czasu fixos quick i jednorazowy pomiar /tmp.

Ważne

Strony api.md, modules.md, coverage.md i dependency-graph.md mogą być regenerowane automatycznie. Strony README.md, getting-started.md i architecture.md są utrzymywane ręcznie i generator nie powinien ich nadpisywać.