patch 12

COMMAND_REF.md

@@ -16,6 +16,10 @@ Diese Referenz ist gegen den realen Codebestand abgeglichen und ersetzt die vera
 | `mto:agent:ingest:version` | Ingest | Startet einen Ingest für eine konkrete Dokumentversion |
 | `mto:agent:ingest:run` | Ingest Jobs | Führt einen vorhandenen `IngestJob` aus |
 | `mto:agent:system:rebuild` | System | Globaler Hard-Rebuild von Chunks, Vektorindex, Tags und optional Service-Reload |
+| `mto:agent:config:validate` | Config / Governance | Validiert die effektive RetrieX-Konfiguration |
+| `mto:agent:config:audit-source` | Config / Governance | Auditiert YAML-Mappings gegen PHP-Fallbacks und Defaults |
+| `mto:agent:config:dump-effective` | Config / Governance | Gibt die effektive Konfigurationsinventur aus |
+| `mto:agent:regression:test` | Config / Governance | Fuehrt Offline-Regression-Guards fuer stabile Pfade aus |
 | `mto:agent:vector:rebuild` | Vector | Baut den Chunk-Vektorindex aus `index.ndjson` neu |
 | `mto:agent:vector:control` | Vector Service | Install, Start, Stop, Reload und Status des Python-Vector-Service |
 | `mto:agent:vector:health` | Vector | Konsistenzcheck für Chunk-NDJSON und Vektorindex |
@@ -480,9 +484,71 @@ Die bisherige Datei war in mehreren Punkten nicht mehr codekonform. Wesentliche
 
 ---
 
-## 11. Fazit
 
-Der aktuelle Custom-CLI-Umfang des Systems besteht aus **14 projektspezifischen Commands**. Für den operativen Betrieb sind besonders relevant:
+## 11. Config-Governance / YAML-only Guardrails
+
+These commands are mandatory for changes that touch YAML-backed configuration, prompt/retrieval behavior, intent detection, commerce/shop logic or regression-sensitive answer paths.
+
+### `mto:agent:config:validate`
+
+Validates the effective RetrieX configuration.
+
+**Signature**
+```bash
+bin/console mto:agent:config:validate [--json]
+```
+
+**Expected result before merge**
+- status `OK`
+- no errors
+
+### `mto:agent:config:audit-source`
+
+Audits YAML-backed configuration against remaining PHP defaults, fallback accessors and constructor defaults.
+
+**Signature**
+```bash
+bin/console mto:agent:config:audit-source [--details] [--json]
+```
+
+**Expected result before merge**
+- no missing YAML mappings
+- no new undocumented PHP-only semantic constants
+- no constructor defaults without YAML/service-parameter mapping
+
+Use `--details` for reviewable console output and `--json` for machine-readable CI output.
+
+### `mto:agent:config:dump-effective`
+
+Dumps the effective RetrieX configuration inventory.
+
+**Signature**
+```bash
+bin/console mto:agent:config:dump-effective [--summary]
+```
+
+Use `--summary` for a compact review view.
+
+### `mto:agent:regression:test`
+
+Runs offline regression guards for stable configuration paths.
+
+**Signature**
+```bash
+bin/console mto:agent:regression:test [--json]
+```
+
+**Expected result before merge**
+- status `OK`
+- all checks pass
+
+This command protects the regression-sensitive 1.4.2/1.5.0 baseline, especially the Testomat 808 / 0,02 deg dH / indicator type 300 flow and related configuration paths.
+
+---
+
+## 12. Fazit
+
+Der aktuelle Custom-CLI-Umfang des Systems besteht aus mindestens **18 projektspezifischen Commands**. Für den operativen Betrieb sind besonders relevant:
 
 - `mto:agent:ingest:run`
 - `mto:agent:system:rebuild`