Metadata-Version: 2.4
Name: rytm-regulatory-monitor
Version: 0.4.3
Summary: Evidence-backed Polish/EU regulatory monitor
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: pypdf==6.21.4
Requires-Dist: tzdata==2026.5; sys_platform == "win32"
Provides-Extra: test
Requires-Dist: pytest==9.1.1; extra == "test"

# Rytm 0.4.3 — monitoring regulacyjny Polska / Śląsk / UE

Rytm pobiera publikacje z urzędowych źródeł i przygotowuje polski raport o nowościach istotnych dla producenta aerozoli i pianek PUR. Raport zawiera cytaty, linki, daty i jawne luki źródłowe. Możesz czytać go lokalnie albo odbierać przez Telegram lub Discord. Bot Telegram udostępnia ostatni raport i stan pracy.

**To narzędzie pomocnicze, nie opinia prawna ani gwarancja kompletności monitoringu.** Brak danych ze źródła nie oznacza braku zmian. Przed podjęciem decyzji sprawdź dokument urzędowy i stosowalność do swojego zakładu.

**Wersja 0.4.3:** raport tygodniowy ma trzy części: „Nowe przepisy” (nowe akty i projekty aktów z okresu raportu, dopasowane do profilu zakładu), „Inne komunikaty” i „Do sprawdzenia”. Każdą tezę raportu AI sprawdza niezależnie drugi model innego producenta, a profil zakładu jest prywatnym plikiem konfiguracji, nie częścią pakietu. Aktualizację z wersji 0.3.x opisuje sekcja „Aktualizacja”. Po aktualizacji sprawdź działanie na swoim komputerze poleceniem `rytm doctor`. Wersja 0.4.1 poprawiła aktualizację z 0.3.x na Windows (ustawienia zapisane przez starszą wersję są znów czytelne), a 0.4.2 i 0.4.3 naprawiają odświeżanie raportu poleceniem `/odswiez` w Telegramie: działa od razu po aktualizacji, a nieudana próba bez wywołania modelu nie blokuje kolejnej.

## Wymagania i koszty

- Windows 10/11 lub Linux; dostęp do Internetu podczas pobierania, pracy AI i komunikacji.
- Zalecany Python **3.12–3.14** z [python.org](https://www.python.org/downloads/). Metadane pakietu dopuszczają 3.12+, ale nie jest to deklaracja pełnego wsparcia każdego nowszego interpretera.
- Klucz OpenRouter do raportów AI. Samo `collect` nie wywołuje płatnego modelu.
- Opcjonalnie token bota Telegram z @BotFather albo webhook Discord.

Domyślna konfiguracja 0.4.x dopuszcza **do 3 prób** przygotowania raportu z limitem **1,50 USD na całe zadanie**, nie na każdą próbę. Próby kończą się po pierwszej publikacji albo po wyczerpaniu limitów. Nieudana próba też może kosztować. Program kontroluje budżet i rezerwacje na podstawie parametrów dostawcy; nie gwarantuje wysokości jego końcowego rachunku ani powstania raportu. Zachowane własne konfiguracje mogą mieć inne limity: przed zgodą przeczytaj wartość wyświetloną przez `rytm report`.

## Instalacja na Windows

1. Zainstaluj zalecanego Pythona i zaznacz **Add python.exe to PATH**. Otwórz nowe okno PowerShell na swoim koncie Windows.
2. Zainstaluj aplikację:

```powershell
py --version
py -0p
py -m pip install rytm-regulatory-monitor
rytm --version
```

Oczekiwany wynik ostatniej komendy: `rytm 0.4.3`. Jeżeli `rytm` nie jest rozpoznawany, używaj `py -m rytm_monitor.app_cli` zamiast `rytm`, np. `py -m rytm_monitor.app_cli --version`. Nie mieszaj instalacji różnych interpreterów.

3. Uruchom kreator i kontrolę:

```powershell
rytm configure
rytm doctor
```

`doctor` sprawdza lokalną konfigurację, sondę Pythona i wybraną automatykę; nie uruchamia AI ani wysyłki raportu. Gotowa konfiguracja nie dowodzi działającego bota. Jeśli go włączyłeś, wymagaj również aktywnego pollera i odpowiedzi w Telegramie.

### Python 3.15

Linux Python 3.15.2 ma dodatni dowód zgodności kodu produktu po naprawie jawnego limitu głębokości JSON. Pełny replay nie jest bezwarunkowo zielony: cztery przypadki narzędzi bramki odmawiają, bo wymagają dokładnie 3.12. Nie jest to natywny odbiór Windows 3.15; klasyfikatory nadal kończą się na 3.14.

Na części środowisk Windows Python 3.15.2 ma usterkę `calendar/strptime`. `doctor` wykrywa ją komunikatem **„Wykryto problem: usterka interpretera (calendar/strptime)”** i wskazówką **„zainstaluj Python 3.14 i użyj py -3.14”**. Nie poprawiaj ręcznie biblioteki standardowej.

Zainstaluj [Python 3.14.10 dla Windows x64](https://www.python.org/ftp/python/3.14.10/python-3.14.10-amd64.exe) **obok**, bez usuwania 3.15. Zatrzymaj wcześniej zadania i procesy Rytm według procedury aktualizacji poniżej. Potem:

```powershell
py -0p
py -3.14 -m pip install --upgrade rytm-regulatory-monitor
py -3.14 -m rytm_monitor.app_cli --version
py -3.14 -m rytm_monitor.app_cli service start
py -3.14 -m rytm_monitor.app_cli doctor
py -3.14 -m rytm_monitor.app_cli service status
```

**W tej ścieżce używaj konsekwentnie `py -3.14 -m rytm_monitor.app_cli` przy każdym poleceniu.** Gołe `rytm` może nadal wskazywać katalog Scripts Pythona 3.15. `service start` rejestruje zadania z launcherem interpretera, który wykonuje tę komendę. Jeżeli aplikacja nie była jeszcze skonfigurowana, najpierw wykonaj kreator przez ten sam moduł.

## Kreator: sześć kroków

1. Katalog roboczy (workspace): lokalny katalog, np. `C:\Users\Jan\rytm-work`. **Nie wybieraj OneDrive, udziału UNC ani dysku sieciowego.** Pulpit może być przekierowany do OneDrive; bezpieczniejszy jest proponowany katalog w profilu. Istniejący workspace w chmurze wymaga kontroli operatora; aktualizacja nie przenosi go automatycznie.
2. Model: Enter zachowuje domyślne ID `deepseek/deepseek-v4.1-flash` i skonfigurowanego dostawcę. To pole na ID, nie na klucz.
3. Klucz OpenRouter: ukryte pole, w którym nie widać wpisywanych znaków.
4. Kanał wysyłki: Telegram, Discord albo brak.
5. Raport tygodniowy: dzień, godzina oraz oddzielna zgoda na przyszłe płatne raporty. Nowa zgoda, enabled i termin są utrwalane wyłącznie po potwierdzonej aktywacji; błąd aktywacji nie nadaje nowej zgody. W pytaniu kreatora domyślna odpowiedź „tak” pozostaje bez zmian: Enter zatwierdza zgodę po pokazaniu limitu; wybierz „nie”, jeśli jej nie udzielasz.
6. Bot na żądanie: osobna zgoda na włączenie; płatne `/odswiez` możesz pozostawić wyłączone.

W polu ścieżki kreatora wpisuj katalog **bez cudzysłowów**, również ze spacjami. Sekrety w klasycznym PowerShell wklejaj prawym przyciskiem myszy. Cudzysłowy są natomiast potrzebne przy ścieżkach ze spacjami w argumentach poleceń, np. `rytm send "C:\Users\Jan\rytm-work\reports\demo" --dry-run`.

Przed zapisem sprawdź podsumowanie. Odpowiedź „nie” lub Ctrl+C **przed zatwierdzeniem** nie zapisuje konfiguracji. Po zatwierdzeniu zapis lub instalacja zadań mogły już nastąpić; sprawdź `rytm config show` i `rytm doctor`.

### Profil zakładu i kontrole offline — wave 2

Profil zakładu jest osobną konfiguracją. Operator przygotowuje go poza publiczną paczką, z pochodzeniem danych; plik klienta **nie jest dołączany do wheel**. Import:

```powershell
rytm configure --facility-profile "C:\Users\Jan\profil.json"
rytm doctor --json
```

Własny katalog konfiguracji wskaż przed poleceniem: `rytm --home "C:\Users\Jan\rytm-config" configure --facility-profile "C:\Users\Jan\profil.json"`. Plik wynikowy to `facility_profile.json` w katalogu konfiguracji (domyślnie `%APPDATA%\rytm-monitor` lub `~/.config/rytm-monitor`), nie w workspace. Import sprawdza ścisły schemat v1, odrzuca dodatkowe/zdublowane klucze i niepoprawne wartości; do odczytu dopuszcza 2 MiB, ale zapisany JSON może mieć najwyżej **262144 bajty**. Wymaga własnego zwykłego pliku i prywatnego miejsca docelowego. Sam import profilu nie pyta o klucz, nie zmienia innych ustawień i nie uruchamia automatyki. Nie jest transakcją wielu plików odporną na utratę zasilania.

Wartość cechy `unknown` oznacza brak ustalenia, nigdy `false` ani „nie dotyczy”. Deterministyczny raport pokazuje takie rekordy do sprawdzenia. Profil może zawierać informacje o zakładzie i cytaty z dokumentów: przechowuj tylko potrzebne dane, bez receptur; kopie też są prywatne. Status w `doctor`: `facility_profile.status` i `profile_status` = `loaded`, `missing` lub `invalid`. Brak profilu nie blokuje samego pobierania; nie daje jednak podstawy do uznania dopasowania za ustalone.

`doctor` wykonuje lokalny **samotest PDF** (`pdf_worker`) na małym wbudowanym pliku przez właściwy proces parsera. Sprawdza też konfigurację trasy weryfikatora (`verifier`): `configured` to poprawna konfiguracja, **network_verified=false**, nie udane wywołanie modelu. Nie uruchamia płatnego AI ani wysyłki. Otwiera bazę przez guarded Store: po przerwanym zapisie może odzyskać hot journal pod `.collect.lock`; gdy to niemożliwe, podaje `database_status=recovery_required`, nie udaje uszkodzenia. **Nie usuwaj bazy ani dziennika**; zatrzymaj zapisujących, zachowaj spójną kopię `state` z sidecarami i ponów kontrolę z operatorem. Samotest na Linux nie jest natywnym odbiorem Windows ani pomiarem dużych PDF na komputerze klienta.

`doctor` wykonuje **najpierw sondę interpretera**, przed importami zależnymi od dat. Jej odmowa daje `diagnostics_complete=false`, brak gotowości i **kod 2**, także w widoku tekstowym, nie pozorny błąd konfiguracji. Kontrola profilu sprawdza **dokładnie raz odczytane bajty** prywatnego pliku; **nie otwiera ponownie nazwy** po sprawdzeniu. Plik później podmieniony lub usunięty nie zmienia wyniku tej kontroli.

Raport AI ma już niezależną kontrolę każdej tezy przez model innego producenta oraz wspólny limit **1,00 USD na próbę / 1,50 USD na raport**, także po restarcie tego samego zadania. Niezgodna, niepotwierdzona lub spóźniona ocena jest wstrzymywana; brak poparcia wymaganego elementu usuwa całą kartę AI, nie ukrywa samej pozycji. „Nowe przepisy” obejmują dopasowane nowe akty i projekty z datą publikacji w okresie; „Inne komunikaty” zawierają tylko dane pozycji, bez ocen AI; „Do sprawdzenia” pokazuje nieustalone dopasowanie, nie potwierdzone obowiązki. Linki tworzy kod z zachowanego rekordu i listy urzędowych domen, nigdy model. Lokalny `do-weryfikacji.json` jest tylko dla operatora i nigdy nie trafia do odbiorcy. To kontrola programu, nie gwarancja poprawności prawnej lub pełnego pokrycia. Przekroczenie czasu tygodniówki daje jawny wynik częściowy; nie kasuj rejestru, by uruchomić ją ponownie.

### Telegram od początku

1. W Telegramie otwórz zweryfikowanego **@BotFather**, wyślij `/newbot` i wybierz nazwę oraz wolny username kończący się `bot`.
2. Token wpisz wyłącznie w ukrytym polu kreatora. Nie wklejaj go do PowerShell jako argumentu, czatu ani zgłoszenia serwisowego.
3. Przy zatrzymanym pollerze kreator albo `rytm bot pair` wyświetli jednorazowy kod w terminalu. Wyślij osobiście `/start KOD` z prywatnego czatu z utworzonym botem, zastępując KOD wyświetloną wartością, i zatwierdź wybór. Samo `/start` bez kodu nie potwierdza właściciela. Kod jest ważny **10 minut od wydania**; odpowiedź Telegrama ani wybór czatu go nie odnawia. Po wygaśnięciu wykonaj ponownie `rytm bot pair` i wyślij nowy kod.
4. Po włączeniu bota sprawdź `rytm bot status`, wyślij ponownie `/start` i oczekuj odpowiedzi z listą komend w ciągu kilku sekund. Samo parowanie nie uruchamia bota.

Rytm obsługuje wyłącznie czaty prywatne: grupy, supergrupy i kanały są odrzucane podczas parowania i nie są obsługiwanym celem bota. Jeśli zapisano dawniej cel nieprywatny, zatrzymaj poller, wybierz prywatny czat i ponownie sprawdź konfigurację.

Bot korzysta z połączeń wychodzących; nie wymaga serwera WWW ani otwierania portu na komputerze. Dla tego samego tokena nie uruchamiaj drugiego pollera ani innej aplikacji z webhookiem.

## Instalacja na Linux

Użyj interpretera 3.12–3.14 i prywatnego środowiska wirtualnego:

```sh
python3 -m venv ~/.venv/rytm
~/.venv/rytm/bin/python -m pip install rytm-regulatory-monitor
~/.venv/rytm/bin/rytm --version
~/.venv/rytm/bin/rytm configure
~/.venv/rytm/bin/rytm doctor
```

W dalszych przykładach zastąp `rytm` pełną ścieżką `~/.venv/rytm/bin/rytm`, jeśli nie jest w PATH. Automatyka korzysta z systemd użytkownika; jej praca po wylogowaniu wymaga osobno skonfigurowanego utrzymywania sesji użytkownika.

## Najważniejsze polecenia

| Polecenie | Działanie |
|---|---|
| `rytm` | Stan instalacji i następny krok. |
| `rytm configure` | Kreator konfiguracji. |
| `rytm config show` | Ustawienia; zamiast wartości sekretów tylko status. |
| `rytm doctor` | Kontrola lokalna bez kosztów AI. |
| `rytm sources` | Rzeczywisty katalog źródeł i jawne ograniczenia. |
| `rytm collect` | Pobranie danych z włączonych źródeł. |
| `rytm report` | Płatny raport z już pobranych danych; w terminalu pyta o zgodę. Nie wysyła raportu. |
| `rytm send KATALOG_RAPORTU --dry-run` | Walidacja i podgląd bez wysyłki. |
| `rytm send KATALOG_RAPORTU` | Wysyłka opublikowanego raportu. |
| `rytm weekly` | Pełny cykl teraz; może kosztować i wykorzystuje próbę bieżącego tygodnia. Nie służy jako test. |
| `rytm service stop` | Zatrzymanie automatyki i kopia małego stanu przed aktualizacją. |
| `rytm service start` | Odtworzenie wybranej wcześniej automatyki i kontrola nowego bota. |
| `rytm service status` | Odczyt stanu zadań oraz wersji i PID pollera. |

Bez dat `collect` i `report` obejmują to samo okno według Europe/Warsaw: siedem poprzednich dat **wraz z dniem bieżącym**, od dzisiaj−7 do jutra (koniec wyłączny). To inne okno niż siedem zakończonych dni cyklu `weekly`. Możesz podać własny okres, zawsze parą dat; `--until` jest końcem wyłącznym:

```powershell
rytm collect --since 2026-10-19 --until 2026-10-27
rytm report --since 2026-10-19 --until 2026-10-27
```

Kod `2` z pobierania oznacza luki, nie dowód braku zmian. Pełny katalog może wymagać znacznie więcej czasu niż kilka źródeł. Raport czytaj w pliku `client-report.html` w katalogu wskazanym przez program; wysyłaj cały opublikowany katalog, nie katalog nieudanej próby.

## PDF: limity i granica izolacji

Parser pracuje w osobnym procesie. Domyślne limity są następujące (MB to milion bajtów; pamięć w bajtach):

| Parametr | Wartość | Znaczenie |
|---|---:|---|
| `max_input_bytes` | 32000000 | Wejściowy PDF: 32 MB |
| `max_pages` | 1000 | Maksymalna liczba stron |
| `max_output_bytes` | 8000000 | Tekst UTF-8: 8 MB |
| `wall_seconds` | 120 | Czas rzeczywisty; po limicie kill/reap |
| `cpu_seconds` | 60 | Budżet CPU |
| `memory_bytes` | 536870912 | Pamięć: 512 MiB |

Podstawa doboru: pomiar trzech rzeczywistych aktów Dz.U. 2026 poz. 60/62/68 na serwerze Linux, Python 3.12 z pypdf 6.21.2: 10,6–12,7 s CPU i mniej niż 100 MB RSS. To historyczna kalibracja, nie pomiar na komputerze użytkownika ani obietnica czasu każdego PDF. Budżet źródła może skrócić czas parsera, a jego własny limit odpowiedzi nadal obowiązuje.

Windows wymaga **Job Object** przed importem parsera i odczytem wejścia: limit pamięci procesu, czasu CPU użytkownika, jeden aktywny proces oraz kill-on-close. Brak możliwości założenia limitów kończy worker błędem; nie ma cichego trybu bez ograniczeń. POSIX używa `rlimit`. To **nie jest sandboxem** uprawnień systemowych ani sieciowych. Testy Linux z atrapą WinAPI nie potwierdzają natywnego działania Job Object na Windows; wymagany jest osobny odbiór.

Błędy parsera zachowują tylko typ i dopuszczony stały opis, bez dowolnego tekstu dokumentu/wyjątku. Czytelne strony pozostają zachowane, ale `ocr_required` lub `empty_unverified` blokuje uznanie całości za complete. OCR nie jest zaimplementowany.

## Harmonogram i bot w tle

```powershell
rytm schedule enable --day pon --time 07:00 --accept-cost
rytm schedule status
rytm bot config --enable --no-allow-refresh
rytm bot install
rytm bot status
```

Pierwsza komenda oznacza zgodę na kolejne płatne raporty. Windows tworzy zadania `Rytm\Weekly` i `Rytm\Bot`, uruchamiane w zalogowanej sesji tego samego użytkownika przez `rytmw.exe`, bez dodatkowej konsoli. Ustaw strefę Windows na Warszawę.

- Komputer musi być włączony, a użytkownik zalogowany; zablokowany ekran nie przeszkadza. Bot nie odpowiada podczas wyłączenia, uśpienia ani po wylogowaniu.
- Zadania mogą działać na baterii. Harmonogram nie wybudza komputera.
- Pominięty termin tygodniowy może zostać uruchomiony po powrocie dostępnego komputera i sesji. **To nie jest automatyczne odtworzenie wszystkich opuszczonych tygodni**: aplikacja podaje niepokryty okres jawnie.
- Restart bota po awarii ma odstęp jednej minuty i do 255 prób. Utworzenie zadania nie zastępuje kontroli heartbeat i odpowiedzi `/start`.

W Telegramie: `/start` lub `/pomoc` pokazuje pomoc, `/status` stan, `/nowosci` ostatni opublikowany raport bez nowej inferencji. `/odswiez` uruchamia pobranie i płatny raport tylko po osobnym włączeniu; do pokazu go nie potrzebujesz.

Wyłączenie: `rytm schedule disable` oraz `rytm bot remove`. Aby zabronić tylko płatnego odświeżania: `rytm bot config --no-allow-refresh`.

## Aktualizacja

### Z 0.3.4 i kolejnych wersji z poleceniem service

W osobnym PowerShell, na tym samym koncie:

```powershell
rytm service stop
```

Reguła organizacyjna: **bez ręcznych komend podczas aktualizacji** — nie uruchamiaj `collect`, `weekly` ani `bot run` w innym terminalu; ręczne collect/report nie są globalnie drainowane.

**Dopiero przy kodzie `0` i potwierdzonym zatrzymaniu** przejdź dalej. Kod `2` oznacza trwającą pracę: poczekaj i ponów stop, bez zabijania analizy.

```powershell
py -m pip install --upgrade rytm-regulatory-monitor
rytm --version
rytm service start
rytm doctor
rytm service status
```

Po każdym błędzie przerwij; nie wykonuj automatycznie kolejnych komend. Na Linux aktualizuj przez Python właściwego venv. W ścieżce Python 3.14 używaj jawnie `py -3.14 -m pip` i modułu CLI 3.14.

### Pierwsza aktualizacja z 0.2.1

**0.2.1 nie ma `rytm service stop`.** Najpierw w niezależnym PowerShell tego samego użytkownika, po zakończeniu bieżącej pracy, zatrzymaj stare zadania natywnie:

```powershell
Get-ScheduledTask -TaskPath '\Rytm\'
Disable-ScheduledTask -TaskPath '\Rytm\' -TaskName 'Weekly'
Disable-ScheduledTask -TaskPath '\Rytm\' -TaskName 'Bot'
Stop-ScheduledTask -TaskPath '\Rytm\' -TaskName 'Weekly'
Stop-ScheduledTask -TaskPath '\Rytm\' -TaskName 'Bot'
Get-ScheduledTask -TaskPath '\Rytm\' | Select-Object TaskName,State
Get-Process rytm* -ErrorAction SilentlyContinue
```

Oczekuj obu zadań wyłączonych i **braku procesów `rytm*`**; sprawdź również, czy nie pozostała ręczna instancja `py -m rytm_monitor.app_cli`. Nie kończ wszystkich procesów Python. Gdy nie potrafisz potwierdzić stopu, nie uruchamiaj pip.

Następnie wykonaj instalację, kontrolę wersji **0.4.3**, `service start`, `doctor` i `service status` jak wyżej. `service start` obsługuje przejście z 0.2.1 na podstawie zapisanych zgód. Wyślij `/start` w Telegramie i sprawdź odpowiedź oraz świeży heartbeat bota wersji 0.4.3.

Aktualizacja pakietu sama nie zmienia workspace. Od 0.4.0 frontdoor rozpoznaje niezmienione stare defaults z 0.3.x przez `config_history.json` i aktualizuje je przy `service start`, `collect`, `report`, `weekly` lub `init`, z kopią w `workspace/config/backup-<UTC>/`. `sources.json` wymaga zgodności dokładnych bajtów; własne zmiany nie są nadpisywane. `doctor --json` tylko sprawdza `config_defaults`: `would_upgrade`, `current`, `customized`, `missing` lub `unknown`. Przed i po zastosowaniu wymagaj właściwego statusu i kopii; sukces pip ani samej komendy nie dowodzi aktualizacji katalogu. Własny katalog/parametry AI uzgodnij z operatorem, bez resetu ustawień. Instaluj wyłącznie zatwierdzone wydanie z PyPI albo zatwierdzony wheel.

Kopia z `service stop` obejmuje mały stan, a nie całe archiwum. **Nie cofaj samego pakietu do 0.2.1 na stanie użytym już przez nową wersję.** Powrót wymaga właściwej kopii sprzed pierwszego startu nowej wersji i nadzoru operatora. Nie ma automatycznego rollbacku: zatrzymaj obie automatyki, potwierdź brak procesów, zachowaj bieżące dane i odtwarzaj wyłącznie spójną, sprawdzoną kopię sprzed pierwszego startu nowej wersji do tych samych ścieżek. Po nowych skutkach zewnętrznych lub przy niepewnym stanie przerwij i skorzystaj z pomocy operatora; samo obniżenie wersji pip nie cofa offsetów ani wysłanych wiadomości.

## Dane i diagnostyka

Konfiguracja i jawny lokalny plik sekretów są domyślnie w `%APPDATA%\rytm-monitor` na Windows albo `~/.config/rytm-monitor` na Linux (`XDG_CONFIG_HOME` może zmienić lokalizację). Windows stosuje zasadę **fail-closed**: katalog konfiguracji i prywatne pliki muszą mieć potwierdzoną chronioną DACL tylko bieżącego użytkownika. Nowe katalogi i puste pliki są zabezpieczane przed zapisem danych. Od 0.4.1 istniejący katalog lub plik Rytm należący do Ciebie, w którym dostęp mają tylko Twoje konto, SYSTEM i Administratorzy (tak zostawia go wersja 0.3.x), jest przy pierwszym użyciu zawężany do Twojego konta i sprawdzany odczytem zwrotnym; niepotwierdzona zmiana blokuje dostęp. Zbyt szeroki istniejący katalog — z dostępem innych kont, np. Wszyscy lub Użytkownicy — jest odrzucany, nie przejmowany ani automatycznie naprawiany. Operator musi wtedy najpierw zatrzymać automatykę, zabezpieczyć spójną kopię i poprawić DACL z odczytem zwrotnym. Własny stary `secrets.json` może być naprawiony przy odczycie, ale nieudana lub niepotwierdzona naprawa blokuje dostęp. Importowany plik sekretu musi już być prywatny; obcy właściciel jest odrzucany. To **nie szyfrowany sejf**. Workspace zawiera pobrane dokumenty, bazę, raporty i rejestry wysyłki; logi: `logs\bot.log` i `logs\weekly.log`.

AI wysyła fragmenty i metadane dokumentów do OpenRouter oraz dostawcy modelu; Telegram/Discord otrzymuje wiadomości i załączniki. Publikacje urzędowe mogą zawierać dane osobowe. Nie przekazuj aplikacji receptur ani poufnych danych zakładu. Poniższa sekcja podaje zasady przechowywania i usuwania bez potrzeby pobierania dokumentów z repozytorium.

| Objaw | Co sprawdzić / zrobić |
|---|---|
| `rytm` nie jest rozpoznawany lub ma starą wersję | `py -0p`, `Get-Command rytm -All`, wersja przez moduł. Wybierz jeden interpreter; przy braku zatwierdzonej 0.4.3 na PyPI przerwij aktualizację. |
| pip zgłasza WinError 5/32 | Stary proces lub launcher nadal działa. Potwierdź zatrzymanie obu zadań i ich procesów; nie wyłączaj Defendera. |
| doctor: usterka `calendar/strptime` | Python 3.14 obok; wszystkie polecenia przez `py -3.14 -m rytm_monitor.app_cli`. |
| doctor: DACL (`broad`, `error`, `not_checked`) | Brak potwierdzonej ochrony nie jest zgodą na pracę. Przerwij uruchamianie, zabezpiecz kopię i zleć operatorowi poprawę praw wraz z odczytem zwrotnym; nie dawaj Everyone dostępu. |
| `/start` bez odpowiedzi | `rytm bot status`, `rytm doctor`, Internet, właściwy bot i czat. Stan Running zadania sam nie wystarcza. |
| 401 / `auth` | Token unieważniony lub błędny. Zatrzymaj usługę, zapisz nowy token w kreatorze i uruchom ponownie. |
| 409 / konflikt | Drugi poller lub webhook. Uzgodnij właściciela tokena; Rytm nie kasuje webhooka automatycznie. |
| `collect` kod 2 | Przeczytaj luki źródeł; nie obchodź blokad 403/429 ani limitów. |
| Raport nie powstał | Sprawdź zgodę, klucz, dane i komunikat limitu/walidacji. Nie uruchamiaj płatnej pętli ponowień. |
| Log przestał się dopisywać | Logi UTF-8 są dopisywane i rotowane przy około 1 MiB: bieżący plik i dwie rotacje na komponent. Sprawdź wolne miejsce, prawa zapisu, `rytm doctor`, heartbeat bota i harmonogram; nie kasuj stanu w celu „naprawy”. Brak linii nie dowodzi bezczynności. |
| `send`: `duplicate`, `partial` lub `unknown` | Sprawdź czat i poprzedni wynik. Niepewnej wysyłki nie ponawiaj w ciemno; nie kasuj rejestrów. `duplicate` nie dowodzi dostarczenia. |
| Poniedziałek minął bez raportu | `rytm schedule status`, sesja użytkownika, czas Windows i log `weekly.log`. Powiadomienie o błędzie również może nie dotrzeć przy braku sieci. |

Na terminalu wynik jest czytelny dla człowieka; w potoku lub z `--json` zwykłe wyniki i błędy parsera mają JSON. Pomoc i wersja pozostają tekstowe. Kody: `0` sukces, `1` błąd/odmowa, `2` wynik częściowy albo niegotowość (dla service: zajęte), `3` wyłączony `bot run` albo już zapisana próba tygodniowa `weekly` (`already_done`), `130` przerwanie. Ich dokładne znaczenie zależy od polecenia.

## Dane, retencja i usuwanie

- Konfiguracja zawiera ustawienia, zgody i jawny lokalny plik sekretów. Workspace przechowuje dokumenty SQLite/raw, raporty i nieudane próby AI, historię wysyłek/offsety oraz logi. Kopie `backups` mogą zawierać sekrety; kopia małego stanu nie jest kopią całego korpusu.
- Retencja: **brak automatycznego TTL** dla dokumentów, raportów, prób, rejestrów i backupów. Logi mają bieżący plik i dwie rotacje, każda około 1 MiB. Administrator ustala czas przechowywania i kontroluje miejsce. Publiczne dokumenty także mogą zawierać dane osobowe.
- OpenRouter i dostawca modelu otrzymują instrukcje, metadane oraz odczytane fragmenty dokumentów, nie automatycznie całą bazę. Telegram lub Discord otrzymuje wiadomości i raport przeznaczony do wysyłki. Parametr `data_collection=deny` nie gwarantuje zero-retention ani określonego kraju przetwarzania; oceń zasady i umowy dostawców.
- Przed usuwaniem zatrzymaj automatykę i wszystkie ręczne procesy. Nie kasuj selektywnie raw, offsetów, ksiąg ani rejestrów wysyłki: może to uszkodzić dowody lub odblokować ponowny koszt/wysyłkę. Nie ma automatycznej bezpiecznej komendy czyszczenia.
- Odinstalowanie przez pip **nie usuwa** konfiguracji, workspace, raportów, sekretów ani backupów. Wycofaj poświadczenia u dostawców, rozstrzygnij obowiązek zachowania danych i dopiero wtedy zaplanuj lokalne usunięcie. Usunięcie lokalne nie usuwa kopii u modelu, komunikatora, odbiorcy lub w backupie.
- Zgłaszając błąd, podaj wersję i bezpieczny komunikat, nie pełny trace, bazę, plik sekretów lub backup. Przejrzyj także ścieżki konta i identyfikatory czatu.

Licencja: wszelkie prawa zastrzeżone; brak licencji open source.
