Protokoll #6622

{
    "event": "PreToolUse",
    "tool_name": "Write",
    "tool_input": {
        "file_path": "\/var\/www\/dev.campus.systemische-tools.de\/docs\/plan-5-ebenen-architektur-sicherung.md",
        "content": "# Plan: 5-Ebenen Architektur-Sicherung\n\n## Ziele (nicht verhandelbar)\n\n1. Konsistenz\n2. Kohärenz\n3. Modularität\n4. Wartbarkeit\n5. Stabilität\n6. Sicherheit\n7. Erweiterbarkeit\n\n---\n\n## Die 5 Ebenen\n\n| Ebene | Zweck | Status |\n|-------|-------|--------|\n| 1 | Architecture Gate | ✓ Aktiv (H1-H5) |\n| 2 | Layer Invariants | Offen |\n| 3 | Verantwortungs-Grenzen pro Datei | Offen |\n| 4 | Erosions-Detektion | Offen |\n| 5 | Change-Governance | Offen |\n\n---\n\n## Ebene 1: Architecture Gate\n\n**Status:** Implementiert\n\n**Was es tut:**\n- Blockiert strukturellen Müll vor Entstehung\n- 5 harte Regeln (H1-H5)\n- Pre-Hook, deterministisch\n\n**Was es sichert:**\n- Konsistenz ✓\n- Kohärenz ✓\n- Grundstabilität ✓\n\n**Was es NICHT sichert:**\n- Inhalt der Dateien\n- Layer-Grenzen vollständig\n- Langzeit-Erosion\n\n---\n\n## Ebene 2: Layer Invariants\n\n**Status:** Offen\n\n**Was es tut:**\n- Erzwingt Verbote pro Layer\n- Pfadbasiert, Regex, blockierend\n\n**Neue Regeln (H6-H15):**\n\n| ID | Layer | Verbot |\n|----|-------|--------|\n| H6 | Domain | Kein IO, HTTP, Infrastructure, Globals |\n| H7 | Domain | Keine DB-Artefakte (SELECT, PDO, etc.) |\n| H8 | Controller | Keine direkte Persistenz |\n| H9 | Controller | Keine Transaktionssteuerung |\n| H10 | Controller | Kein new Infrastructure\\*Repository\/Client\/Gateway |\n| H11 | Alle | strict_types (existiert als H1) |\n| H12 | Alle | Namespace = Pfad (existiert) |\n| H13 | Nur Factory | DatabaseFactory erlaubt (existiert als H3) |\n| H14 | UseCase | Kein new Infrastructure, kein DatabaseFactory |\n| H15 | UseCase | Keine Presentation-Imports |\n\n**Layer-Pfade:**\n\n```\nDomain:       \/Domain\/, \/domain\/\nApplication:  \/UseCases\/, \/Application\/\nInfrastructure: \/Infrastructure\/\nPresentation: \/Controller\/, \/View\/\nFactory:      \/Factory\/\nTest:         \/tests\/, \/Test\/\n```\n\n**Umsetzung:**\n- Erweiterung architecture_guard.py\n- Scope-Funktion pro Layer\n- Pattern-Liste pro Regel\n\n---\n\n## Ebene 3: Verantwortungs-Grenzen pro Datei\n\n**Status:** Offen\n\n**Was es tut:**\n- Jede Datei deklariert ihre Verantwortung\n- Maschinenlesbar, prüfbar\n\n**Format (am Dateianfang):**\n\n```php\n<?php\ndeclare(strict_types=1);\n\n\/\/ @responsibility: chat-message-orchestration\n\/\/ @forbidden: persistence, io, infrastructure\n```\n\n**Prüfung:**\n- `@responsibility` genau einmal vorhanden\n- `@forbidden` Begriffe nicht im Code\n\n**Umsetzung:**\n- Neuer Hook oder Erweiterung architecture_guard.py\n- Regex auf Kommentar-Header\n- Abgleich forbidden vs. Code-Inhalt\n\n---\n\n## Ebene 4: Erosions-Detektion\n\n**Status:** Offen\n\n**Was es tut:**\n- Misst Trends über Zeit\n- Warnt bei schleichender Verschlechterung\n\n**Metriken:**\n\n| Metrik | Schwellwert | Aktion |\n|--------|-------------|--------|\n| Dateigröße | > 300 LOC | Warn |\n| Constructor-Parameter | > 5 | Warn |\n| Abhängigkeiten (use) | > 10 | Warn |\n| Allowlist-Einträge | Zunahme | Review |\n\n**Umsetzung:**\n- Post-Hook (nicht blockierend)\n- Zählwerte in DB speichern\n- Zeitreihe für Trend-Analyse\n\n---\n\n## Ebene 5: Change-Governance\n\n**Status:** Offen\n\n**Was es tut:**\n- Regelt wer Contract ändern darf\n- Dokumentiert jede Änderung\n\n**Regeln:**\n\n1. Contract-Änderung braucht:\n   - Grund\n   - Risiko\n   - Kompensation\n\n2. Allowlist-Eintrag braucht:\n   - Begründung\n   - Scope\n   - Ablaufdatum oder Review-Punkt\n\n3. H-Regeln sind Invarianten:\n   - Nur per Contract-Version änderbar\n   - Nicht projektlokal verhandelbar\n\n**Umsetzung:**\n- Contract-History in DB (existiert)\n- Änderungs-Template (neu)\n- Review-Pflicht dokumentieren\n\n---\n\n## Umsetzungs-Reihenfolge\n\n| Phase | Ebene | Aufwand | Priorität |\n|-------|-------|---------|-----------|\n| 1 | Ebene 2: Layer Invariants | 1 Tag | HOCH |\n| 2 | Ebene 5: Change-Governance | 0.5 Tag | HOCH |\n| 3 | Ebene 3: Verantwortungs-Grenzen | 1 Tag | MITTEL |\n| 4 | Ebene 4: Erosions-Detektion | 1 Tag | MITTEL |\n\n---\n\n## Konkrete nächste Schritte\n\n### Schritt 1: Layer Invariants (H6-H15)\n- [ ] architecture_guard.py erweitern\n- [ ] Scope-Funktionen für alle Layer\n- [ ] 10 neue Regeln implementieren\n- [ ] Tests für alle Regeln\n- [ ] Contract auf v1.2 updaten\n\n### Schritt 2: Change-Governance\n- [ ] Änderungs-Template erstellen\n- [ ] Contract um Governance-Abschnitt erweitern\n- [ ] Allowlist-Dokumentation erzwingen\n\n### Schritt 3: Verantwortungs-Grenzen\n- [ ] Header-Format definieren\n- [ ] Prüf-Hook implementieren\n- [ ] Bestehende Dateien migrieren\n\n### Schritt 4: Erosions-Detektion\n- [ ] Metriken-Tabelle in DB\n- [ ] Post-Hook für Messung\n- [ ] Dashboard oder Report\n\n---\n\n## Was jede Ebene sichert\n\n| Ziel | E1 | E2 | E3 | E4 | E5 |\n|------|----|----|----|----|-----|\n| Konsistenz | ✓ | ✓ | ✓ | | ✓ |\n| Kohärenz | ✓ | ✓ | ✓ | | |\n| Modularität | | ✓ | ✓ | | |\n| Wartbarkeit | | ✓ | ✓ | ✓ | |\n| Stabilität | ✓ | ✓ | | ✓ | ✓ |\n| Sicherheit | | ✓ | | | ✓ |\n| Erweiterbarkeit | | ✓ | ✓ | | |\n\n---\n\n## Zusammenfassung\n\n**Aktuell:** 1 von 5 Ebenen implementiert.\n\n**Risiko:** Ohne Ebene 2-5 erodiert Ebene 1 innerhalb von 6 Monaten.\n\n**Lösung:** Ebene 2 und 5 sofort, Ebene 3 und 4 innerhalb 2 Wochen.\n\n**Keine Theorie. Nur Zwang zur Ordnung.**\n"
    }
}

{
    "tool_response": {
        "type": "create",
        "filePath": "\/var\/www\/dev.campus.systemische-tools.de\/docs\/plan-5-ebenen-architektur-sicherung.md",
        "content": "# Plan: 5-Ebenen Architektur-Sicherung\n\n## Ziele (nicht verhandelbar)\n\n1. Konsistenz\n2. Kohärenz\n3. Modularität\n4. Wartbarkeit\n5. Stabilität\n6. Sicherheit\n7. Erweiterbarkeit\n\n---\n\n## Die 5 Ebenen\n\n| Ebene | Zweck | Status |\n|-------|-------|--------|\n| 1 | Architecture Gate | ✓ Aktiv (H1-H5) |\n| 2 | Layer Invariants | Offen |\n| 3 | Verantwortungs-Grenzen pro Datei | Offen |\n| 4 | Erosions-Detektion | Offen |\n| 5 | Change-Governance | Offen |\n\n---\n\n## Ebene 1: Architecture Gate\n\n**Status:** Implementiert\n\n**Was es tut:**\n- Blockiert strukturellen Müll vor Entstehung\n- 5 harte Regeln (H1-H5)\n- Pre-Hook, deterministisch\n\n**Was es sichert:**\n- Konsistenz ✓\n- Kohärenz ✓\n- Grundstabilität ✓\n\n**Was es NICHT sichert:**\n- Inhalt der Dateien\n- Layer-Grenzen vollständig\n- Langzeit-Erosion\n\n---\n\n## Ebene 2: Layer Invariants\n\n**Status:** Offen\n\n**Was es tut:**\n- Erzwingt Verbote pro Layer\n- Pfadbasiert, Regex, blockierend\n\n**Neue Regeln (H6-H15):**\n\n| ID | Layer | Verbot |\n|----|-------|--------|\n| H6 | Domain | Kein IO, HTTP, Infrastructure, Globals |\n| H7 | Domain | Keine DB-Artefakte (SELECT, PDO, etc.) |\n| H8 | Controller | Keine direkte Persistenz |\n| H9 | Controller | Keine Transaktionssteuerung |\n| H10 | Controller | Kein new Infrastructure\\*Repository\/Client\/Gateway |\n| H11 | Alle | strict_types (existiert als H1) |\n| H12 | Alle | Namespace = Pfad (existiert) |\n| H13 | Nur Factory | DatabaseFactory erlaubt (existiert als H3) |\n| H14 | UseCase | Kein new Infrastructure, kein DatabaseFactory |\n| H15 | UseCase | Keine Presentation-Imports |\n\n**Layer-Pfade:**\n\n```\nDomain:       \/Domain\/, \/domain\/\nApplication:  \/UseCases\/, \/Application\/\nInfrastructure: \/Infrastructure\/\nPresentation: \/Controller\/, \/View\/\nFactory:      \/Factory\/\nTest:         \/tests\/, \/Test\/\n```\n\n**Umsetzung:**\n- Erweiterung architecture_guard.py\n- Scope-Funktion pro Layer\n- Pattern-Liste pro Regel\n\n---\n\n## Ebene 3: Verantwortungs-Grenzen pro Datei\n\n**Status:** Offen\n\n**Was es tut:**\n- Jede Datei deklariert ihre Verantwortung\n- Maschinenlesbar, prüfbar\n\n**Format (am Dateianfang):**\n\n```php\n<?php\ndeclare(strict_types=1);\n\n\/\/ @responsibility: chat-message-orchestration\n\/\/ @forbidden: persistence, io, infrastructure\n```\n\n**Prüfung:**\n- `@responsibility` genau einmal vorhanden\n- `@forbidden` Begriffe nicht im Code\n\n**Umsetzung:**\n- Neuer Hook oder Erweiterung architecture_guard.py\n- Regex auf Kommentar-Header\n- Abgleich forbidden vs. Code-Inhalt\n\n---\n\n## Ebene 4: Erosions-Detektion\n\n**Status:** Offen\n\n**Was es tut:**\n- Misst Trends über Zeit\n- Warnt bei schleichender Verschlechterung\n\n**Metriken:**\n\n| Metrik | Schwellwert | Aktion |\n|--------|-------------|--------|\n| Dateigröße | > 300 LOC | Warn |\n| Constructor-Parameter | > 5 | Warn |\n| Abhängigkeiten (use) | > 10 | Warn |\n| Allowlist-Einträge | Zunahme | Review |\n\n**Umsetzung:**\n- Post-Hook (nicht blockierend)\n- Zählwerte in DB speichern\n- Zeitreihe für Trend-Analyse\n\n---\n\n## Ebene 5: Change-Governance\n\n**Status:** Offen\n\n**Was es tut:**\n- Regelt wer Contract ändern darf\n- Dokumentiert jede Änderung\n\n**Regeln:**\n\n1. Contract-Änderung braucht:\n   - Grund\n   - Risiko\n   - Kompensation\n\n2. Allowlist-Eintrag braucht:\n   - Begründung\n   - Scope\n   - Ablaufdatum oder Review-Punkt\n\n3. H-Regeln sind Invarianten:\n   - Nur per Contract-Version änderbar\n   - Nicht projektlokal verhandelbar\n\n**Umsetzung:**\n- Contract-History in DB (existiert)\n- Änderungs-Template (neu)\n- Review-Pflicht dokumentieren\n\n---\n\n## Umsetzungs-Reihenfolge\n\n| Phase | Ebene | Aufwand | Priorität |\n|-------|-------|---------|-----------|\n| 1 | Ebene 2: Layer Invariants | 1 Tag | HOCH |\n| 2 | Ebene 5: Change-Governance | 0.5 Tag | HOCH |\n| 3 | Ebene 3: Verantwortungs-Grenzen | 1 Tag | MITTEL |\n| 4 | Ebene 4: Erosions-Detektion | 1 Tag | MITTEL |\n\n---\n\n## Konkrete nächste Schritte\n\n### Schritt 1: Layer Invariants (H6-H15)\n- [ ] architecture_guard.py erweitern\n- [ ] Scope-Funktionen für alle Layer\n- [ ] 10 neue Regeln implementieren\n- [ ] Tests für alle Regeln\n- [ ] Contract auf v1.2 updaten\n\n### Schritt 2: Change-Governance\n- [ ] Änderungs-Template erstellen\n- [ ] Contract um Governance-Abschnitt erweitern\n- [ ] Allowlist-Dokumentation erzwingen\n\n### Schritt 3: Verantwortungs-Grenzen\n- [ ] Header-Format definieren\n- [ ] Prüf-Hook implementieren\n- [ ] Bestehende Dateien migrieren\n\n### Schritt 4: Erosions-Detektion\n- [ ] Metriken-Tabelle in DB\n- [ ] Post-Hook für Messung\n- [ ] Dashboard oder Report\n\n---\n\n## Was jede Ebene sichert\n\n| Ziel | E1 | E2 | E3 | E4 | E5 |\n|------|----|----|----|----|-----|\n| Konsistenz | ✓ | ✓ | ✓ | | ✓ |\n| Kohärenz | ✓ | ✓ | ✓ | | |\n| Modularität | | ✓ | ✓ | | |\n| Wartbarkeit | | ✓ | ✓ | ✓ | |\n| Stabilität | ✓ | ✓ | | ✓ | ✓ |\n| Sicherheit | | ✓ | | | ✓ |\n| Erweiterbarkeit | | ✓ | ✓ | | |\n\n---\n\n## Zusammenfassung\n\n**Aktuell:** 1 von 5 Ebenen implementiert.\n\n**Risiko:** Ohne Ebene 2-5 erodiert Ebene 1 innerhalb von 6 Monaten.\n\n**Lösung:** Ebene 2 und 5 sofort, Ebene 3 und 4 innerhalb 2 Wochen.\n\n**Keine Theorie. Nur Zwang zur Ordnung.**\n",
        "structuredPatch": [],
        "originalFile": null
    }
}