feat: preflight - prerequisites checked and tool paths recorded before wikitool runs; launcher refuses without it (#151, POSIX half)

Files changed:
- .claude/settings.json
- .gitea/workflows/ci.yml
- .gitea/workflows/nightly.yml
- .gitea/workflows/release.yml
- .gitea/workflows/tracker-live.yml
- .github/hooks/wiki-trace.json
- .gitignore
- .vibe/hooks.toml
- AGENTS.md
- CHANGES.md
- EVALS.md
- INSTALL.md
- README.md
- VERSION
- instructions/bootstrap.md
- instructions/preflight.md
- instructions/setup-instance.md
- instructions/upgrade-instance.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/cli.py
- tools/chemenu/commands/dist_cmd.py
- tools/chemenu/commands/docs_verify.py
- tools/chemenu/commands/doctor.py
- tools/chemenu/commands/git_publish.py
- tools/chemenu/commands/migrate_cmd.py
- tools/chemenu/config.py
- tools/chemenu/corpus_cache.py
- tools/chemenu/prerequisites.py
- tools/chemenu/search/ripgrep.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_dist_upgrade.py
- tools/chemenu/tests/test_doctor.py
- tools/chemenu/tests/test_preflight.py
- tools/chemenu/toolpaths.py
- tools/preflight.sh
- tools/prerequisites.txt
- tools/run_wikitool.py
- tools/trace-hook
- tools/wikitool

INSTALL.md

@@ -18,6 +18,12 @@ Terminal auf dieser Maschine ist.
 - [ripgrep](https://github.com/BurntSushi/ripgrep) (`rg`) - wird von `search` und
   `sources coverage` gebraucht
 
+Ob das alles da ist, prüft der Preflight (`tools/preflight.sh`), bevor irgendein
+`wikitool`-Befehl läuft - der erste Schritt jeder Einrichtung, siehe
+[instructions/preflight.md](instructions/preflight.md). Die maßgebliche Liste steht in
+`tools/prerequisites.txt`. Fehlt etwas, hält der Agent an und zeigt eine Anleitung mit dem
+Befehl, der es behebt; installieren muss man selbst, der Agent tut es nie.
+
 ## Weg A: Release herunterladen
 
 Der kürzeste Weg zu einer eigenen Instanz - kein Checkout dieses Repos nötig. Jedes Release
@@ -114,7 +120,7 @@ git clone https://gitea.nehmer.net/torben/chemenu.git
 cd chemenu
 ```
 
-Danach den Agenten `instructions/bootstrap.md` ausführen lassen (Werkzeugumgebung + Skills
+Danach den Agenten `instructions/bootstrap.md` ausführen lassen (Preflight + Skills
 publizieren). Git-Repo, Autor-Identität und Inhalt existieren hier bereits.
 
 Ein Clone, der älter ist als die Personalization-Dateien, hat kein `USER.md`/`SOUL.md` -
@@ -319,6 +325,15 @@ export WIKITOOL_UPDATE_TOKEN="<gitea-token>"
 tools/wikitool version check
 ```
 
+**Tool-Pfade - schreibt der Preflight, nicht der Mensch.** `.wikitool-tools.json` im Repo-Root
+hält die absoluten Pfade von Python, git und ripgrep, so wie der Preflight sie auf diesem Rechner
+gefunden hat; `wikitool` startet git und rg von dort statt über `PATH`. Pro Checkout und
+gitignored - ein Pfad auf einem Rechner sagt über den nächsten nichts. Fehlt die Datei oder ist
+sie unvollständig, startet `tools/wikitool` nicht (Exit 42) und nennt den Preflight. Liegt ein
+Tool woanders, als der Preflight sucht, nennt man den Pfad mit
+`tools/preflight.sh --set rg=<pfad>`; von Hand bearbeitet wird die Datei nicht. `doctor` meldet
+unter `tool-paths`, ob alle Pfade noch stimmen.
+
 **Aufgaben-Tracker anbinden - optional.** Der Wochenrückblick (`tools/wikitool review`, Skill
 `gtd-weekly-review`) gleicht die Projektseiten unter `kb/gtd/` gegen einen Aufgaben-Tracker ab. Welcher
 das ist, steht in `.wikitool-tasks.json` im Repo-Root - der dritten Datei dieser Art neben
@@ -446,9 +461,10 @@ tools/wikitool instructions verify
 
 ## Troubleshooting
 
-- **`wikitool: venv not found`** - Schritt "Werkzeugumgebung anlegen" aus
-  [instructions/bootstrap.md](instructions/bootstrap.md) bzw.
-  [instructions/setup-instance.md](instructions/setup-instance.md) wurde noch nicht ausgeführt.
+- **`tools/wikitool` endet mit `STOP - this checkout is not set up yet` (Exit 42)** - der
+  Preflight ist in diesem Checkout noch nicht durchgelaufen, oder seit dem letzten Update nicht
+  mehr: `tools/preflight.sh` ausführen, siehe
+  [instructions/preflight.md](instructions/preflight.md).
 - **Der Agent bietet keine Skills an (`wiki-ingest`, `wiki-query`, ...)** - `.agents/skills/`
   und `.claude/skills/` sind generiert und nicht committet. `tools/wikitool instructions sync`
   ausführen, dann die Agent-Session neu starten (Harnesses lesen Skills nur beim Start).