fix: gedrucktem --check-config-Befehl fehlte das cd ins Installationsverzeichnis (v0.6.2)

Das Paket ist nicht pip-installiert, sondern liegt unter /opt/pdf-ocr-hotfolder
und wird nur ueber das Arbeitsverzeichnis gefunden. Der Hinweis, den update.sh
in der Zusammenfassung ausgibt, lief deshalb so wie gedruckt nicht
("No module named pdf_ocr_hotfolder"). Gleiches galt fuer die Beispiele in
README.md, docs/INSTALLATION.md, docs/UPDATE.md und docs/OS-UPGRADE.md.

Gefunden beim Update-Test v0.3.1 -> v0.6.1 auf CT 200 (Debian 12).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

AI_AGENT_BRIEFING.md

@@ -1,7 +1,7 @@
 # AI Agent Briefing — PDF OCR Hotfolder
 
 **Zuletzt aktualisiert:** 2026-09-22
-**Version:** 0.6.1
+**Version:** 0.6.2
 **Status:** Multi-Instanz-Betrieb, Preflight-Checks, Fehlerzählung, Wiederaufnahme aus `working/` und ein abgesicherter Updater (venv-Rebuild, Backup, Verifikation, Versionssprung-Meldung, Rauchtest). Test-Suite grün (152 pytest-Tests). Ein Produktiv-Einsatz ist im Repo (README/CHANGELOG) nicht dokumentiert — die bisherigen Fixes stammen aus Issues #1–#6 und aus Vorbereitungen auf Debian 13, nicht aus einem belegten Dauerbetrieb.
 
 > **Betriebsabläufe stehen nicht hier**, sondern in:

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.6.2] - 2026-09-22
+
+### Fixed
+- Der `--check-config`-Befehl, den `update.sh` in der Zusammenfassung ausgibt,
+  lief so wie gedruckt nicht (`No module named pdf_ocr_hotfolder`). Das Paket
+  wird nicht pip-installiert, sondern nach `/opt/pdf-ocr-hotfolder` kopiert und
+  nur ueber das Arbeitsverzeichnis gefunden — dem Hinweis fehlte das
+  vorangestellte `cd`. Betraf auch die Beispiele in README.md,
+  docs/INSTALLATION.md, docs/UPDATE.md und docs/OS-UPGRADE.md.
+  Gefunden beim Update-Test v0.3.1 -> v0.6.1 auf Debian 12.
+
 ## [0.6.1] - 2026-09-22
 
 > **Fuer Bestandsinstallationen wichtig.** Wer 0.6.0 bereits eingespielt hat,

README.md

@@ -93,7 +93,7 @@ deshalb `640 root:<service-gruppe>` und beim Debuggen nicht in Tickets kopieren.
 Config prüfen, ohne etwas zu verarbeiten:
 
 ```bash
-sudo /opt/pdf-ocr-hotfolder/venv/bin/python -m pdf_ocr_hotfolder \
+cd /opt/pdf-ocr-hotfolder && sudo ./venv/bin/python -m pdf_ocr_hotfolder \
     --check-config --config /etc/pdf-ocr-hotfolder/<instanz>.toml
 ```
 
@@ -158,5 +158,5 @@ MIT — © Sonith UG
 
 ---
 
-**Version:** 0.6.1
+**Version:** 0.6.2
 **Repo:** https://gitea.sonith.de/sonith_ug/pdf-ocr-hotfolder

VERSION

@@ -1 +1 @@
-0.6.1
+0.6.2

docs/INSTALLATION.md

@@ -471,7 +471,7 @@ Exit 2 heißt immer: Config oder Preflight. Die Ursache steht im journal und
 ausführlicher in:
 
 ```bash
-sudo /opt/pdf-ocr-hotfolder/venv/bin/python -m pdf_ocr_hotfolder \
+cd /opt/pdf-ocr-hotfolder && sudo ./venv/bin/python -m pdf_ocr_hotfolder \
     --check-config --config /etc/pdf-ocr-hotfolder/<instanz>.toml
 ```
 
@@ -488,7 +488,7 @@ Bestehende PDFs einer Instanz einmalig verarbeiten und beenden — greift auch
 Dateien auf, die in `working/` liegen geblieben sind:
 
 ```bash
-sudo -u pdfocr /opt/pdf-ocr-hotfolder/venv/bin/python -m pdf_ocr_hotfolder \
+cd /opt/pdf-ocr-hotfolder && sudo -u pdfocr ./venv/bin/python -m pdf_ocr_hotfolder \
     --config /etc/pdf-ocr-hotfolder/kunde-a.toml --once
 ```
 

docs/OS-UPGRADE.md

@@ -153,9 +153,9 @@ Instanz, die vorher lief, auch wieder läuft.
 **Sind die Configs sauber?**
 
 ```bash
+cd /opt/pdf-ocr-hotfolder
 for f in /etc/pdf-ocr-hotfolder/*.toml; do
-    sudo /opt/pdf-ocr-hotfolder/venv/bin/python -m pdf_ocr_hotfolder \
+    sudo ./venv/bin/python -m pdf_ocr_hotfolder --check-config --config "$f"
-        --check-config --config "$f"
 done
 ```
 

docs/UPDATE.md

@@ -284,7 +284,7 @@ Nach dem Code-Update und vor dem Start prüft `update.sh` jede Instanz-Config mi
 dem neuen Code:
 
 ```bash
-/opt/pdf-ocr-hotfolder/venv/bin/python -m pdf_ocr_hotfolder \
+cd /opt/pdf-ocr-hotfolder && ./venv/bin/python -m pdf_ocr_hotfolder \
     --check-config --config /etc/pdf-ocr-hotfolder/<instanz>.toml
 ```
 

pdf_ocr_hotfolder/__init__.py

@@ -1,3 +1,3 @@
 """PDF OCR Hotfolder — Scanner-PDFs automatisch durchsuchbar machen."""
 
-__version__ = "0.6.1"
+__version__ = "0.6.2"

update.sh

@@ -1243,7 +1243,9 @@ if [ "${#CFG_WARN[@]}" -gt 0 ]; then
     log_warn "Config-Warnungen (Exit 1) bei: ${CFG_WARN[*]}"
     log_warn "  Kein Abbruchgrund, aber bitte nachsehen:"
     for name in "${CFG_WARN[@]}"; do
-        log_warn "    $INSTALL_DIR/venv/bin/python -m pdf_ocr_hotfolder --check-config --config $CONFIG_DIR/$name.toml"
+        # Das Paket ist nicht pip-installiert, sondern liegt in $INSTALL_DIR —
+        # ohne das cd findet Python das Modul nicht.
+        log_warn "    cd $INSTALL_DIR && ./venv/bin/python -m pdf_ocr_hotfolder --check-config --config $CONFIG_DIR/$name.toml"
     done
 fi
 if [ "$APT_WARN" -eq 1 ]; then