stack: Telemetrie-Default nach Installationsform, Byte-Deckel und Session-Retention (schliesst #55)
CI / verify (push) Successful in 53s
Release / release (push) Successful in 36s

Files changed:
- .gitea/workflows/ci.yml
- .gitignore
- CHANGES.md
- EVALS.md
- INSTALL-MCP.md
- INSTALL.md
- VERSION
- instructions/setup-instance.md
- reports/CONTRACT.md
- tools/CONTRACT.md
- tools/chemenu/commands/doctor.py
- tools/chemenu/config.py
- tools/chemenu/mcp/server.py
- tools/chemenu/telemetry/policy.py
- tools/chemenu/telemetry/schema.py
- tools/chemenu/telemetry/writer.py
- tools/chemenu/tests/conftest.py
- tools/chemenu/tests/test_doctor.py
- tools/chemenu/tests/test_mcp_server.py
- tools/chemenu/tests/test_telemetry_emit.py
- tools/chemenu/tests/test_telemetry_policy.py
- tools/chemenu/version.py
This commit is contained in:
2026-09-10 23:38:22 +02:00
parent 71446c0f29
commit 82a22eaa93
22 changed files with 801 additions and 44 deletions
+11 -4
View File
@@ -43,9 +43,13 @@ WIKI_TRACE=0 tools/.venv/bin/python -m chemenu.mcp
Der Prozess spricht MCP über stdin/stdout und gibt für sich genommen nichts aus — das ist
richtig so. Gestartet wird er normalerweise nicht von Hand, sondern vom Client (Schritt 3).
**`WIKI_TRACE=0` ist nicht optional.** Telemetrie ist per Default an und schreibt nach
`reports/telemetry/` im Repo. Der Server **verweigert den Start**, solange das so ist, statt
still umzuleiten:
**Das `WIKI_TRACE=0` oben ist in einer ausgelieferten Instanz meist redundant, aber trotzdem
richtig.** Telemetrie-Default hängt vom Installationsweg ab
([INSTALL.md](INSTALL.md) § Konfiguration): in einer per `dist export` ausgelieferten Instanz
steht er auf **aus**, in einem Git-Clone dieses Repos (Testbett/Demo) auf **an**. Der Server
prüft nicht `WIKI_TRACE` direkt, sondern denselben `chemenu.telemetry.policy`, den auch
`wikitool doctor` und der Writer befragen - läuft Telemetrie danach, **verweigert der Server den
Start**, statt still umzuleiten:
```
ERROR Telemetry is on and would write into the served checkout (...). Set WIKI_TRACE=0,
@@ -53,7 +57,10 @@ or point WIKI_TRACE_DIR outside the corpus.
```
Beide Auswege sind gleichwertig: `WIKI_TRACE=0` schaltet ab, `WIKI_TRACE_DIR=/var/log/chemenu`
lenkt um. Der Grund steht in Schritt 6 — der Sync darf `reports/` wegräumen.
lenkt um. Der Grund steht in Schritt 6 — der Sync darf `reports/` wegräumen. Das explizite
`WIKI_TRACE=0` in den Befehlen dieses Dokuments bleibt der sichere Default: es ist korrekt, egal
welchen Weg die bediente Instanz genommen hat, und macht die Prüfung oben gegenstandslos, statt
sich auf den Installationsweg zu verlassen.
## Schritt 3: Einen Client einbinden