fixplesk 0.6.1__tar.gz

fixplesk-0.6.1/.dockerignore

@@ -0,0 +1,17 @@
+.git
+.venv
+__pycache__
+*.pyc
+.pytest_cache
+.coverage
+htmlcov
+build
+*.egg-info
+dist
+test-results
+
+.env
+.env.*
+secrets
+private
+*-live.json

fixplesk-0.6.1/.github/workflows/docker.yml

@@ -0,0 +1,38 @@
+name: isolated-digital-twin
+on: [push, pull_request, workflow_dispatch]
+permissions:
+  contents: read
+jobs:
+  synthetic-twin:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+      - run: bash scripts/test_twin_docker.sh
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: synthetic-twin-results
+          path: test-results/
+  real-wordpress:
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@v4
+      - run: bash scripts/test_wordpress_docker.sh
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: wordpress-results
+          path: test-results/
+  twin-demo:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - run: bash scripts/demo_twin.sh
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: twin-demo-log
+          path: test-results/

fixplesk-0.6.1/.github/workflows/offline.yml

@@ -0,0 +1,16 @@
+name: offline decision and docroot twin
+on: [push, pull_request, workflow_dispatch]
+permissions:
+  contents: read
+jobs:
+  offline-docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build with dependencies, then test without a network
+        run: bash scripts/test_offline_docker.sh
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: offline-docker-log
+          path: test-results/offline-docker.txt

fixplesk-0.6.1/.github/workflows/tests.yml

@@ -0,0 +1,25 @@
+name: tests
+on: [push, pull_request]
+permissions:
+  contents: read
+jobs:
+  python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '${{ matrix.python }}'
+      - run: python -m pip install -e '.[dev]'
+      - run: python -m ruff check .
+      - run: python -m compileall -q src tests
+      - run: pytest --cov=fixplesk --cov-report=term-missing
+      - run: python scripts/build_release.py
+  php:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: find integrations -type f \( -name '*.php' -o -name '*.phtml' \) -print0 | xargs -0 -n1 php -l

fixplesk-0.6.1/CHANGELOG.md

@@ -0,0 +1,100 @@
+# 0.6.0 — 2026-09-16
+
+## [Unreleased]
+
+## [0.6.1] - 2026-09-17
+
+### Docs
+- Update README.md
+
+### Test
+- Update tests/assurance/test_cli_wpdata.py
+- Update tests/assurance/test_feeds_breaches.py
+- Update tests/assurance/test_files.py
+- Update tests/assurance/test_runtime_permissions.py
+- Update tests/conftest.py
+- Update tests/offline/test_backends.py
+- Update tests/offline/test_cli_offline.py
+- Update tests/offline/test_docroot.py
+- Update tests/offline/test_evidence.py
+- Update tests/secops/test_security_engine.py
+- ... and 10 more files
+
+### Other
+- Update lab/client.py
+- Update scripts/benchmark_llm.py
+- Update scripts/demo_guard.py
+- Update scripts/generate_reference.py
+- Update scripts/generate_runbook_reference.py
+- Update scripts/llm_providers.py
+- Update scripts/make_data.py
+- Update scripts/make_offline_examples.py
+- Update scripts/make_security_examples.py
+
+
+- Natywne DeepSeek Chat Completions: V4.1 Flash i V4 Pro, osobny klucz i stały endpoint.
+- Kontrola thinking/effort, większy ograniczony budżet tokenów, JSON i odrzucanie częściowych wyników.
+- Strict obowiązkowy w DeepSeek, jawna akceptacja braku wymuszenia ZDR po stronie adaptera.
+- Bez zapisu reasoning_content, surowych błędów API i automatycznego fallbacku między operatorami.
+- `llm-info`, metadane dostawcy w `llm-preview`/`doctor` oraz nowe przykłady i testy.
+- Zachowano moduły 0.5.0, nie dodano autonomicznych napraw ani Z.ai direct.
+
+# 0.5.0 — evidence cache, local assurance and transparent scripts
+
+- Retains prior Python modules, integrations, labs and command groups. Archives the 0.4.0 README, validation and distributions in the full project ZIP.
+- Adds `guard`: scoped no-follow file scanning, content-free anomaly signals, differences, official core checksum comparison and exact SHA-256 indicator CSV/JSON import.
+- Adds explicit data sync/import/status for CISA KEV, EPSS, Wordfence v3 and WordPress core checksums; bounded immutable snapshots with metadata and freshness. SHA-256 is not a publisher signature.
+- Adds constrained Wordfence numeric version-range matching, unknown/conflict handling and exact CVE KEV/EPSS enrichment; no generic package-version or full vulnerability oracle.
+- Adds opt-in HIBP email k-anonymity and separately a prompted-password range/local-corpus check; never verifies account-password association, cracks password hashes or stores plaintext credentials.
+- Adds selected offline WP data export checks without executing SQL/PHP or storing raw matched content.
+- Adds private `/tmp` script sessions, closed read-only DSL, review/approval by digest, sealed memfd execution, permanent artifacts and journal. This is not an arbitrary-code sandbox or automatic new LLM integration.
+- Adds approved single-file restrictive fchmod, no ACL/hardlink/symlink, pre/post HTTP/service/log observation, conflict checks, optional restoration and recovery quarantine. No blanket recursive chmod, malware deletion or host upgrades.
+- New tests exercise filesystem operations, generated scripts, rollback and actual SIGKILL interruptions. Live Plesk/paid API/Docker validation remains separate.
+
+# Zmiany 0.4.0 — 2026-09-15
+
+- Dodano odrębny moduł `secops`: 23 procedury offline, 20 narzędzi reuse, 36 źródeł.
+- Dodano import wybranych pól zapisanych raportów Grype/Trivy oraz agregację Postfix JSON.
+- Zachowano konflikty, niewiadome, granice tenant/host i TTL; brak automatycznego potwierdzania źródeł.
+- Dodano wybór problemów do dokumentu doradczego i minimalny eksport agregatów.
+- Nie dodano synchronizatora CVE, nowych napraw live ani nowych zależności runtime.
+- Dodano testy secops i profil Docker bez sieci w runtime; profil nieuruchomiony tutaj.
+- Zachowano wcześniejsze funkcje i dodatki PHP 0.3.0 bez rozbudowy ich bezpieczeństwa.
+
+## Historia wcześniejszych wydań
+
+# Historia zmian
+
+## 0.3.0 — 2026-09-15
+
+Lokalny, wyjaśnialny silnik 22 procedur / 52 hipotez / 61 kontroli. Fakty ze ścisłymi
+wartościami bool, TTL, kontrolą tenant/subskrypcji i stanami UNKNOWN/STALE/CONFLICT.
+Nowe triage, eksport samego advice, raporty JSON/Markdown/HTML i diagnose --offline.
+Propozycja docroot z analizą zapisanej pomocy site/subdomain, -www-root względnym
+do subskrypcji, blokadą niejednoznacznych ścieżek i ręczną kompensacją parametru.
+Bez automatycznego apply docroot. 6 nowych sygnatur, 4 nowe reguły, 10 źródeł.
+Opcjonalne graphlib/NetworkX, lokalne TF-IDF/scikit-learn, opisowy MAD i prosty
+adapter Z3 (runtime tutaj nietestowany). Model protokołu i stanowy twin docroot
+w pamięci, profil Docker bez sieci podczas testów, dodatkowe schematy i przykłady.
+Zachowane prywatność LLM, trwały Executor/Store i jego granice kompensacji.
+
+## 0.2.0 — 2026-09-15
+
+Nowa nazwa dystrybucji/modułu/CLI **fixplesk** (wcześniej pleskme).
+Obowiązkowa granica prywatności LLM z strict allowlist, HMAC, leak guard i
+preferencjami ZDR; jawny preview. Awaria LLM zachowuje lokalną diagnozę.
+Wyjaśnienia dry-run, osobny live preflight, pre/postconditions i inventory binding.
+Trwały journal przed dispatch; brak retry mutacji; kwarantanna domen/celu klonu
+oraz operacji współdzielonych, kill switch, jawne uzgodnienie po awarii.
+Kompensacje stanów plugin/maintenance z kontrolą wersji i ponownym odczytem.
+Weryfikacja lokalnego artefaktu backupu; brak ogólnego automatycznego restore.
+Trzy nowe read tools, 52 wpisy rejestru (49 adapterów, 3 unavailable).
+Stanowy HTTP twin, 2 profile Docker, testy utraty odpowiedzi/rollbacku/izolacji
+oraz read-only adapter URI-twin. Dokumentacja granic i migracji.
+
+## 0.1.0 — 2026-09-15 (pleskme)
+
+Pierwszy rdzeń: 9 kolektorów, transporty lokalne/SSH/HTTPS, normalizacja,
+28 reguł, 49 pozycji rejestru (46 adapterów, 3 unavailable), 25 źródeł, LLM,
+raporty, audyt oraz dodatki PHP. Nie miał automatycznej kompensacji ani
+weryfikacji bajtów backupu. Wyniki tego wydania nie są wynikami0.2.0.

fixplesk-0.6.1/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 fixplesk contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The WordPress agent in integrations/wordpress/fixplesk-agent is separately
+licensed under GPL-2.0-or-later; see its header and LICENSE. The original user
+specifications and linked third-party documentation retain their own rights.

fixplesk-0.6.1/MANIFEST.in

@@ -0,0 +1,12 @@
+include README.md LICENSE CHANGELOG.md .dockerignore
+recursive-include docs *.md *.json *.xml *.txt *.yml
+recursive-include examples *.json *.ndjson *.toml *.yml *.log *.md *.html *.dot *.csv *.txt *.py
+recursive-include integrations *.php *.phtml *.xml *.md *.txt *.service *.timer LICENSE
+recursive-include scripts *.py *.sh *.mjs
+recursive-include tests *.py
+recursive-include lab *.py *.sh *.php
+recursive-include docker *.yml Dockerfile.*
+recursive-include .github/workflows *.yml
+prune **/__pycache__
+global-exclude *.pyc
+recursive-include history *.md *.txt

fixplesk-0.6.1/PKG-INFO

@@ -0,0 +1,321 @@
+Metadata-Version: 2.4
+Name: fixplesk
+Version: 0.6.1
+Summary: Tenant-scoped Plesk and WordPress diagnostics, declarative playbooks, and guarded remediation
+Author: fixplesk contributors
+Author-email: Tom Sapletta <tom@sapletta.com>
+License-Expression: Apache-2.0
+Keywords: plesk,wordpress,diagnostics,wp-cli,openrouter,litellm,deepseek
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic<3,>=2.7
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: PyYAML<7,>=6.0.1
+Requires-Dist: packaging<27,>=24
+Requires-Dist: defusedxml<1,>=0.7.1
+Provides-Extra: llm
+Requires-Dist: litellm<2,>=1.70; extra == "llm"
+Provides-Extra: graphs
+Requires-Dist: networkx<4,>=3.2; extra == "graphs"
+Provides-Extra: analysis
+Requires-Dist: scikit-learn<2,>=1.4; extra == "analysis"
+Provides-Extra: solver
+Requires-Dist: z3-solver<5,>=4.13; extra == "solver"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-cov<8,>=5; extra == "dev"
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: ruff<1,>=0.11; extra == "dev"
+Requires-Dist: setuptools>=77; extra == "dev"
+Requires-Dist: goal>=2.1.0; python_version >= "3.12" and extra == "dev"
+Requires-Dist: costs>=0.1.53; python_version >= "3.9" and extra == "dev"
+Dynamic: license-file
+
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128" role="img"><title>ticket-146: feat(dashboard): add --web flag and SSE live log streaming (ticket-146)</title><rect width="128" height="128" rx="12" fill="#f8fafc"/><g stroke-width="1"><polygon points="64,55 72,61 69,71 59,71 56,61" fill="none" stroke="#d7dde5"/><polygon points="64,47 80,59 74,78 54,78 48,59" fill="none" stroke="#d7dde5"/><polygon points="64,38 89,56 79,85 49,85 39,56" fill="none" stroke="#d7dde5"/><polygon points="64,30 97,53 84,92 44,92 31,53" fill="none" stroke="#d7dde5"/><polygon points="64,21 105,51 89,99 39,99 23,51" fill="none" stroke="#d7dde5"/><line x1="64" y1="64" x2="64" y2="21" stroke="#aab4c0"/><line x1="64" y1="64" x2="105" y2="51" stroke="#aab4c0"/><line x1="64" y1="64" x2="89" y2="99" stroke="#aab4c0"/><line x1="64" y1="64" x2="39" y2="99" stroke="#aab4c0"/><line x1="64" y1="64" x2="23" y2="51" stroke="#aab4c0"/></g><polygon points="64,21 105,51 79,85 54,78 39,56" fill="#fb923c" fill-opacity="0.45" stroke="#c2410c" stroke-width="2"/><circle cx="64" cy="64" r="3" fill="#c2410c"/><g font-family="sans-serif" font-size="7" fill="#334155"><text x="64" y="11" text-anchor="middle">SCO</text><text x="114" y="48" text-anchor="middle">COU</text><text x="95" y="107" text-anchor="middle">UNC</text><text x="33" y="107" text-anchor="middle">VAL</text><text x="14" y="48" text-anchor="middle">DEL</text></g><text x="64" y="124" text-anchor="middle" font-family="sans-serif" font-size="8" fill="#0f172a">L · 129m</text></svg>
+# fixplesk 0.6.0
+
+
+## AI Cost Tracking
+
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.6.1-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$1.67-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-5.8h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+
+- 🤖 **LLM usage:** $1.6723 (10 commits)
+- 👤 **Human dev:** ~$580 (5.8h @ $100/h, 30min dedup)
+
+Generated on 2026-09-17 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+
+---
+
+
+
+Diagnostyka Plesk/WordPress oparta na dowodach, z opcjonalnym LLM i kontrolowanym wykonaniem.
+**Wydanie rozwojowe. Nie jest certyfikowanym skanerem ani autonomicznym administratorem serwera.**
+
+Wersja 0.6.0 rozwija poprzedni pakiet 0.5.0 (jego moduł `guard` pozostaje bez zmian). Zachowano wcześniejsze moduły diagnostyki,
+DSL, kolektory, prywatność LLM, Executor, SQLite, security/offline, dokumentację i laboratoria.
+Nowa grupa poleceń `guard` nie zastępuje `security`, `diagnose`, `triage` ani `apply`.
+
+## Nowe w 0.6.0: bezpośrednie DeepSeek API
+
+`backend="deepseek"`, własny `DEEPSEEK_API_KEY`, oficjalny endpoint, bez SDK i bez
+pośrednictwa OpenRouter. Profile `deepseek-flash` (V4.1 Flash według dokumentacji
+z 2026-09-10) i `deepseek-v4-pro`. Tryby thinking, poziomy `low/high/max`, JSON,
+ograniczone odpowiedzi, brak zapisu reasoning_content. Dane nadal przechodzą strict.
+Zgoda na bezpośrednie API **nie jest gwarancją ZDR**. Domyślnie nie przełączamy
+istniejących konfiguracji; szczegółowe warunki są w `docs/DEEPSEEK.md`.
+
+## Nowe: bezpośrednie Z.ai API (backend `zai`)
+
+`backend="zai"`, własny `ZAI_API_KEY`, stały endpoint `https://api.z.ai/api/paas/v4`,
+bez SDK i bez pośrednictwa OpenRouter. Modele potwierdzone żywą listą `/models`
+(2026-09-16): `glm-5.3`, `glm-5.3-flash` (profile `accurate`/`fast`) oraz starsze
+GLM-5.x. Te same jawne zgody co DeepSeek (`require_zdr=false`,
+`accept_provider_data_policy=true`); szczegóły w `docs/ZAI.md`,
+konfiguracja w `examples/zai/`.
+
+```bash
+fixplesk --config config.toml llm-info
+fixplesk --config config.toml llm-preview --snapshot snapshot.json --output payload.json
+```
+
+### Domyślne modele per provider i kolejność według dostępności
+
+Skrypty (`scripts/demo_llm_twin.py`, `scripts/benchmark_llm.py`) czytają z `.env`:
+`LLM_PROVIDER_ORDER` (kolejność providerów wg dostępności klucza), `LLM_MODEL_DEEPSEEK`/`_ALT`,
+`LLM_MODEL_ZAI`/`_ALT`, `LLM_MODEL_OPENROUTER`/`_ALT`. Przy porażce modelu skrypt jawnie
+przechodzi na alternatywę **tego samego** providera, potem do następnego w kolejności;
+każdy hop jest logowany. Rdzeń silnika fixplesk nadal nie robi cichego fallbacku.
+`LLM_MODEL` pozostaje pojedynczym domyślnym modelem narzędzia `costs`.
+
+Konfiguracja: `examples/deepseek/llm-section.toml`; pełne demo:
+`examples/deepseek/config.toml`. Poprzednie artefakty: `history/0.5.0/dist/`.
+Wyniki bieżącej weryfikacji: `docs/TESTING_0.6.0.md`.
+
+## Laboratorium Docker: cyfrowy bliźniak i doradca LLM jedną komendą
+
+`bash scripts/demo_twin.sh` uruchamia w izolowanym Dockerze deterministyczny bliźniak
+Plesk/WordPress (sieć wewnętrzna, read-only, `cap_drop: ALL`) i kontener demo, który
+wstrzykuje usterkę, wykonuje offline diagnozę, a po podaniu klucza wysyła jeden
+zminimalizowany payload doradczy do wybranego modelu. Bez kluczy przepływ jest w pełni
+offline i kończy się podglądem kontraktu dostawcy (`llm-preview`).
+
+```bash
+DEEPSEEK_API_KEY=sk-... bash scripts/demo_twin.sh        # deepseek-flash (V4.1 Flash, direct)
+ZAI_API_KEY=... bash scripts/demo_twin.sh                 # glm-5.3 (Z.ai direct)
+OPENROUTER_API_KEY=sk-or-... bash scripts/demo_twin.sh    # openrouter/z-ai/glm-5.3 (ZDR)
+bash scripts/demo_twin.sh                                 # offline + preview, bez kluczy
+```
+
+Pozostałe profile izolowane: `scripts/test_offline_docker.sh` (network_mode: none),
+`scripts/test_twin_docker.sh` (pełny pakiet testów wobec bliźniaka),
+`scripts/test_guard_docker.sh`, `scripts/test_security_docker.sh`,
+`scripts/test_wordpress_docker.sh` (prawdziwy WordPress). Szczegóły: `docs/DIGITAL_TWIN.md`.
+
+## Benchmark doradczy LLM: DeepSeek vs z.ai
+
+`scripts/benchmark_llm.py` porównuje silniki na tych samych scenariuszach (załączone
+snapshoty + usterki syntetycznego bliźniaka), mierząc skuteczność walidacji `Advice`,
+latencję, zużycie tokenów i koszt. Podczas pomiaru każdy przebieg raportuje na bieżąco
+(czas, tokeny, status), więc długie żądania są zawsze widoczne. Ceny wariantów OpenRouter
+pobierane są na żywo; klucze tylko ze środowiska.
+
+```bash
+python scripts/benchmark_llm.py --selftest                        # bez sieci i kluczy
+DEEPSEEK_API_KEY=... ZAI_API_KEY=... \
+  python scripts/benchmark_llm.py --repeats 2                     # właściwy pomiar
+```
+
+Wynik (2026-09-16, kontrakt strict): **deepseek-v4-pro 90%** skutecznych porad (47 s śr.),
+zai-glm-5.3 60% (157 s, plan coding), oba flashe 30%. Pełne tabele: `test-results/`
+i `docs/analysis/llm-benchmark.md`.
+
+## Funkcje zachowane z 0.5.0
+
+| Funkcja | Implementacja | Granica |
+|---|---|---|
+| Pliki i katalogi | Lokalny skan document_root widocznych domen, metadane, hash, podejrzane wzorce, porównanie przebiegów | Bez dekodowania/wykonania PHP, usuwania i automatycznej kwarantanny |
+| Integralność WP | Cache oficjalnych sum core dla wybranej wersji i locale oraz lokalne porównanie | Wersję wskazuje operator; brak potwierdzenia inventory i pełnej obsługi sum wtyczek premium |
+| Bazy danych o zagrożeniach | Pobieranie KEV JSON, EPSS CSV.gz, Wordfence v3 JSON, sum WP; walidacja, historia, SHA-256, TTL | Bez podpisów producenta/TUF; import lokalny nie jest uwierzytelniony |
+| Wersje WP | Dopasowanie core/plugin/theme do zakresów Wordfence; dołączenie cached KEV/EPSS po CVE | Komparator celowo obsługuje tylko numeryczne wersje; sufiksy oznaczają niepewność |
+| Wskaźniki plików | Import własnych list SHA-256 CSV/JSON; zgodność i sprzeczności źródeł | Trafienie nie uruchamia usuwania |
+| Wycieki kont | HIBP k-anon e-mail oraz osobna kontrola hasła online/offline | Bez łączenia kont z hasłami, łamania hashy i prób logowania |
+| Dane WP | Odczytowy audyt wybranych wyeksportowanych pól opcji/postów i deklarowanych ról | Bez nowego połączenia SQL, automatycznego eksportu tabel i odczytu user_pass |
+| Skrypty runtime | Prywatne pliki w `/tmp`, zamknięty DSL read-only, SHA-256, akceptacja, wynik, kopia trwała | Tylko `file.stat` i `file.sha256`; dowolny kod LLM nie jest wykonywany |
+| Prawa pliku | Plan ograniczenia praw grupy/other jednego pliku; realny `fchmod` po akceptacji | Bez chown/rekurencji/ACL/dowiązań; tylko lokalny host |
+| Obserwacje zmiany | HTTP GET, wybrane jednostki systemd, przyrost logów, diff i trwały dziennik | To jawnie wybrany zakres; nie test wszystkich usług i transakcji biznesowych |
+
+## Instalacja
+
+Wymagania: Python 3.11+, Linux/POSIX. Wykonanie skryptów przez sealed memfd wymaga Linuksa.
+Nie opublikowano paczki w PyPI.
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install ./dist/fixplesk-0.6.0-py3-none-any.whl
+fixplesk --version
+fixplesk guard --help
+```
+
+Instalacja zależności wymaga internetu albo przygotowanego repozytorium lokalnego.
+Analiza zapisanych danych działa bez LLM i bez sieci. Nowe pobrania i sondy wymagają `--allow-network`.
+
+## Skan jednej domeny lub widocznych domen
+
+Najpierw utwórz i sprawdź zaufane inventory. Opcja `--config` występuje **przed** podkomendą.
+Nie używaj inventory pochodzącego od niezaufanego klienta HTTP. Uprawnienia deklarowane w pliku nie nadają uprawnień systemowych.
+
+```bash
+fixplesk init
+fixplesk --config config.toml guard files scan --domain example.com --output scan-before.json
+fixplesk --config config.toml guard files scan --all --output scan-all.json
+fixplesk guard files compare --before scan-before.json --after scan-after.json --output diff.json
+```
+
+Zastąp `example.com` własnym celem istniejącym w konfiguracji. `--all` oznacza wyłącznie widoczne
+w inventory cele, nie automatyczne odkrycie wszystkich domen serwera. Nie skanuj całego `/` jako root.
+Nowe lokalne funkcje odmówią działania przy aktywnej konfiguracji SSH, zamiast czytać przypadkowo host lokalny.
+
+Skan nie podąża za dowiązaniami; nie czyta hardlinków, urządzeń ani FIFO, nie przechodzi na inny filesystem.
+Ma limity plików, bajtów, głębokości i czasu. Brak dostępu, rotacja czy limit trafia do `gaps`.
+Odczyt nie jest atomowym snapshotem i może zmienić atime. Prawa POSIX nie dowodzą dostępności HTTP.
+Nie jest oceniana pełna semantyka ACL/SELinux/nginx/Apache. Raportów nie zapisuj pod katalogiem witryny.
+
+## Pobieranie i import baz
+
+```bash
+fixplesk guard feeds list
+fixplesk guard feeds sync --source cisa-kev --allow-network
+fixplesk guard feeds sync --source epss --allow-network
+# WORDFENCE_API_KEY ustaw w chronionym środowisku procesu, nie w argv.
+fixplesk guard feeds sync --source wordfence --allow-network
+fixplesk guard feeds status --source wordfence
+fixplesk guard wp-match --inventory components.json --output vulnerabilities.json
+```
+
+`components.json` jest tablicą: `id`, `domain`, `type` (`core`/`plugin`/`theme`), `slug`, `version`,
+`observed_at` (ISO8601 ze strefą), `identity_verified` (bool). Ostatnie pole jest deklaracją operatora,
+nie zdalnym poświadczeniem tożsamości. Nie kopiuj daty z zegara bez rzeczywistego odczytu.
+
+Cache zachowuje całe źródło i jego informacje licencyjne. Domyślnie trafia do `~/.cache/fixplesk/feeds`.
+Import lokalny: `guard feeds import --source ... --input ... --obtained-at ...`.
+Nieudany nowy import nie przełącza wskaźnika na niepoprawne dane. Nie ma automatycznej aktualizacji aplikacji ani pakietów serwera.
+Opcjonalny przykład timera odświeżającego **dane** jest w `integrations/systemd`; nie jest instalowany ani włączany.
+
+Przykład sum **historycznej, jawnie wybranej** wersji, nie rekomendacja aktualnej wersji WordPressa:
+
+```bash
+fixplesk guard feeds sync --source wp-checksums --version 6.8.1 --locale en_US --allow-network
+fixplesk --config config.toml guard files scan --domain example.com \
+  --checksum-version 6.8.1 --checksum-locale en_US --output integrity.json
+```
+
+Nie przypisuj tych samych sum witrynom o różnych wersjach. Niezgodność jest dowodem różnicy,
+a nie automatycznie dowodem malware. Pierwszy własny skan nie stanowi zaufanej czystej bazy.
+
+## Kontrola kont i haseł
+
+```bash
+# HIBP_API_KEY w chronionym środowisku. Ukryty prompt e-mail; bez adresu w argv.
+fixplesk guard breach email --account-ref mail-001 --consent --allow-network
+
+# Osobne pytanie o hasło. Wymagany lokalny TTY; bez potoku, pliku ani argumentu z hasłem.
+fixplesk guard breach password --online --consent --allow-network
+
+# Offline: legalnie pozyskany korpus SHA1:count i jego rzeczywista data.
+fixplesk guard breach password --offline-hashes /secure/pwned-passwords.txt \
+  --corpus-date 2026-09-15T00:00:00Z --consent
+```
+
+Kontrola e-maila używa k-anon z prefiksem 6 znaków; wymaga odpowiedniego planu HIBP.
+Kontrola hasła używa prefiksu 5 znaków i paddingu. Nie ma fallbacku do wysłania całego adresu/hasła.
+Nie są przechowywane surowe odpowiedzi dotyczące innych kont. Szczegóły i granice w `docs/guard/BREACHES.md`.
+Podana data korpusu jest przykładem składni — musi odpowiadać faktycznemu źródłu.
+
+## Jawne skrypty tworzone podczas działania
+
+```bash
+fixplesk --config config.toml guard session create --domain example.com --output session.json
+# Podstaw rzeczywistą ścieżkę zwróconą w session.json.
+fixplesk --config config.toml guard session stage --domain example.com \
+  --session /tmp/fixplesk-UID-IDENTYFIKATOR --spec script-spec.json --output staged.json
+fixplesk --config config.toml guard session list --domain example.com \
+  --session /tmp/fixplesk-UID-IDENTYFIKATOR
+```
+
+`script-spec.json` może być propozycją LLM lub operatora:
+
+```json
+{"schema_version":1,"origin":"llm","operation":"file.sha256","path":"index.php","purpose":"Sprawdź pełną sumę pliku bez wykonywania PHP"}
+```
+
+`guard session run --script ID --approve SHA256` to podgląd. Dopiero dodanie `--execute` uruchamia
+zamknięty szablon. Skrypt musi pozostać bajt w bajt zgodny z generatorem. Wykonanie używa `python -I`
+i zapieczętowanych bajtów memfd, a nie dowolnej zawartości pod zmienną nazwą w `/tmp`.
+Nie jest to sandbox dla arbitralnego kodu. Nie ma tu nowej automatycznej rozmowy z LLM: przyjmowany jest
+walidowany JSON propozycji. Dotychczasowa integracja LLM paczki nadal istnieje oddzielnie.
+
+Kopia skryptów, manifestów, rollbacków i wyników jest pod `state_dir/guard-sessions/ID`.
+Audyt zdarzeń znajduje się we wspólnym SQLite. `guard session export` tworzy prywatny ZIP.
+Nie wysyłaj całego katalogu sesji do LLM ani do publicznego zgłoszenia.
+
+## Ograniczenie praw jednego pliku
+
+Zapis wymaga `allow_mutations=true` w zaufanym celu inventory oraz uprawnień OS. Nie rozszerzaj uprawnień procesu tylko po to,
+żeby test przeszedł. Nowa operacja nie próbuje zgadywać docelowego właściciela ani zastępować natywnych napraw konfiguracji Pleska.
+
+```bash
+fixplesk --config config.toml guard permissions plan --domain example.com \
+  --path backup.sql --mode 0640 --policy checks.json \
+  --why "Usuń zbędny zapis dla innych kont po przeglądzie uprawnień" --output permission-plan.json
+fixplesk guard permissions run --plan permission-plan.json --output dry-run.json
+```
+
+Dobór 0640 jest przykładem, nie uniwersalną polityką. Pole `digest` z dry-run zatwierdza konkretny plan:
+
+```bash
+fixplesk --config config.toml guard permissions run --plan permission-plan.json \
+  --approve SHA256_PLANU --execute --allow-network --output execution.json
+```
+
+`checks.json` określa kontrolę, np. `{"http_checks":[{"path":"/","expected_status":200,"required_text":"Nazwa witryny"}],"services":[]}`.
+HTTP200 bez właściwego znacznika nie przechodzi. Zmiana treści blokuje wynik, chyba że jawnie ustawisz
+`allow_content_drift=true`. Dla usług podaj wyłącznie rzeczywiste jednostki z inventory.
+Pełny model: `fixplesk guard schema --kind policy`.
+
+Plan ważny jest 15 minut. Zmienia tylko prawa grupy/other jednego zwykłego pliku, bez rozszerzania praw.
+Odmowa przy ACL, hardlinkach, symlinkach, zmianie treści/tożsamości i nierozliczonym wcześniejszym planie.
+Brak sukcesu sondy nie powoduje domyślnie ponownego odsłonięcia starych uprawnień.
+Zgoda `--allow-restore-previous-mode` musi być częścią planu **przed** wykonaniem.
+
+Po nieznanym wyniku użyj istniejącego `recovery status` albo nowego `guard permissions reconcile --digest ... --allow-network`.
+`--acknowledge` rozlicza obserwowany stan po kontrolach; nie wznawia i nie powtarza zapisu.
+Inny wynik, zmieniona treść lub nowe inventory wymagają procedury ręcznej.
+
+## Testy, demo i plany rozwoju
+
+```bash
+python scripts/demo_guard.py --output-dir /tmp/fixplesk-guard-demo
+python -m pytest tests/assurance -q
+bash scripts/test_guard_docker.sh
+```
+
+Demo tworzy wyłącznie syntetyczne pliki i lokalne atrapowe odpowiedzi kontroli; nie diagnozuje Pleska.
+Status bieżących testów jest w `docs/TESTING_0.6.0.md`; wcześniejszy pomiar zachowano w `docs/guard/TESTING_0.5.0.md`. Docker pozostaje osobnym profilem.
+Szczegóły: `docs/guard/ARCHITECTURE.md`, `docs/guard/ROADMAP.md`, `docs/guard/SOURCES.md`.
+Poprzednia instrukcja: `docs/history/README_0.4.0.md`.
+
+
+## License
+
+Licensed under Apache-2.0.