{
"tool_response": [
{
"type": "text",
"text": "{\n \"success\": true,\n \"doc\": {\n \"id\": 59,\n \"parent_id\": 55,\n \"slug\": \"contracts\",\n \"path\": \"\/betrieb\/contracts\",\n \"title\": \"Contracts\",\n \"description\": \"Contracts sind normative YAML-Dokumente, die verbindliche Regeln für Code, Architektur und Dokumentation definieren. Sie ermöglichen automatisierte Validierung und stellen Qualitätsstandards sicher.\",\n \"content\": \"<nav class=\\\"breadcrumb\\\">\\n <a href=\\\"\/docs\\\">Dokumentation<\/a> » Contracts\\n<\/nav>\\n\\n<h1>Contracts<\/h1>\\n<p>Contracts sind normative YAML-Dokumente, die verbindliche Regeln für Code, Architektur und Dokumentation definieren. Sie ermöglichen automatisierte Validierung und stellen Qualitätsstandards sicher.<\/p>\\n\\n<h2>Was sind Contracts?<\/h2>\\n<ul>\\n <li><strong>Normativ:<\/strong> Verbindliche Regeln, keine Empfehlungen<\/li>\\n <li><strong>Maschinenlesbar:<\/strong> YAML-Format für automatisierte Prüfung<\/li>\\n <li><strong>Versioniert:<\/strong> Änderungen erfordern explizite Versionierung<\/li>\\n <li><strong>Validierbar:<\/strong> Klare Pass\/Fail-Kriterien<\/li>\\n<\/ul>\\n\\n<h2>Wann werden Contracts geprüft?<\/h2>\\n<table>\\n <tr><th>Zeitpunkt<\/th><th>Contract<\/th><th>Aktion bei Violation<\/th><\/tr>\\n <tr><td>Vor Sync zu Prod<\/td><td>Alle aktiven<\/td><td>Sync blockiert<\/td><\/tr>\\n <tr><td>Nach Dateiänderung<\/td><td>Betriebsdokumentation<\/td><td>Warnung<\/td><\/tr>\\n <tr><td>Bei neuem Modul<\/td><td>Layered Architecture<\/td><td>Ablehnung<\/td><\/tr>\\n<\/table>\\n\\n<h2>Contract-Management<\/h2>\\n<p>Contracts werden in der Datenbank verwaltet und sind über Web-UI und MCP-API zugänglich.<\/p>\\n\\n<table>\\n <tr><th>Web-UI<\/th><td><a href=\\\"\/contracts\\\">\/contracts<\/a><\/td><\/tr>\\n <tr><th>Datenbank<\/th><td><code>ki_protokoll.contracts<\/code><\/td><\/tr>\\n <tr><th>MCP-Server<\/th><td>mcp-tasks (contracts_* Tools)<\/td><\/tr>\\n <tr><th>Legacy-Pfad<\/th><td><code>\/var\/www\/docs\/contracts\/<\/code> (migriert)<\/td><\/tr>\\n<\/table>\\n\\n<h3>Web-UI Features<\/h3>\\n<ul>\\n <li><a href=\\\"\/contracts\\\">\/contracts<\/a> - Liste aller Contracts mit Filter<\/li>\\n <li><a href=\\\"\/contracts\/new\\\">\/contracts\/new<\/a> - Neuen Contract erstellen<\/li>\\n <li>\/contracts\/{id} - Contract-Details, YAML-Inhalt, Validierungshistorie<\/li>\\n <li>\/contracts\/{id}\/edit - Contract bearbeiten (erzeugt neue Version)<\/li>\\n <li>Validierung direkt aus der UI auslösen<\/li>\\n <li>Versionshistorie mit Diff-Ansicht<\/li>\\n<\/ul>\\n\\n<h3>MCP-Tools (mcp-tasks)<\/h3>\\n<table>\\n <tr><th>Tool<\/th><th>Beschreibung<\/th><\/tr>\\n <tr><td><code>contracts_list<\/code><\/td><td>Alle Contracts auflisten<\/td><\/tr>\\n <tr><td><code>contracts_get<\/code><\/td><td>Contract nach ID\/Name abrufen<\/td><\/tr>\\n <tr><td><code>contracts_create<\/code><\/td><td>Neuen Contract anlegen<\/td><\/tr>\\n <tr><td><code>contracts_update<\/code><\/td><td>Contract aktualisieren (neue Version)<\/td><\/tr>\\n <tr><td><code>contracts_validate<\/code><\/td><td>Validierung ausführen<\/td><\/tr>\\n <tr><td><code>contracts_history<\/code><\/td><td>Änderungshistorie abrufen<\/td><\/tr>\\n <tr><td><code>contracts_violations<\/code><\/td><td>Letzte Violations abrufen<\/td><\/tr>\\n <tr><td><code>contracts_deprecate<\/code><\/td><td>Contract als deprecated markieren<\/td><\/tr>\\n<\/table>\\n\\n<h3>Datenbankschema<\/h3>\\n<pre><code>-- Contracts mit YAML-Content und Versionierung\\nki_protokoll.contracts\\n├── id, uuid, name, version, status\\n├── yaml_content, scope_description\\n└── created_at, created_by, updated_at\\n\\n-- Änderungshistorie\\nki_protokoll.contract_history\\n├── contract_id, previous_yaml, previous_version\\n└── change_description, changed_at, changed_by\\n\\n-- Validierungsläufe\\nki_protokoll.contract_validations\\n├── contract_id, result (passed\/failed)\\n├── critical_count, major_count, minor_count\\n└── violations (JSON), triggered_by, duration_ms<\/code><\/pre>\\n\\n<h2>Aktive Contracts<\/h2>\\n\\n<h3>Betriebsdokumentation v1.1<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>betriebsdokumentation-pruefung_v1.1.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/src\/View\/docs\/**\/*.php<\/td><\/tr>\\n<\/table>\\n<p>Validiert Server- und Betriebsdokumentation:<\/p>\\n<ul>\\n <li>Dateipfade müssen existieren<\/li>\\n <li>Befehle müssen syntaktisch korrekt sein<\/li>\\n <li>Ports\/Versionen müssen aktuell sein<\/li>\\n <li>Struktur: Breadcrumb, h1, Intro, Tabelle, Commands<\/li>\\n<\/ul>\\n\\n<h3>Layered Architecture v1.0<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>layered-architecture-pruefung_v1.0.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/src\/**\/*.php, \/app\/**\/*.php<\/td><\/tr>\\n <tr><th>Tool<\/th><td><a href=\\\"\/docs\/modul\/php-quality\\\">PHPStan<\/a><\/td><\/tr>\\n<\/table>\\n<p>Validiert die Schichtenarchitektur:<\/p>\\n<ul>\\n <li>\/src (MVC): Framework, Controller, Domain, UseCases, Infrastructure, View<\/li>\\n <li>\/app (MVP): Presenter, View<\/li>\\n <li>Dependency Rules zwischen Layern<\/li>\\n <li>Verbotene Imports und Platzierungen<\/li>\\n<\/ul>\\n\\n<h3>HTML Tables Contract v1.0<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>html-tables-contract_v1.0.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/src\/View\/**\/*.php, \/public\/js\/**\/*.js<\/td><\/tr>\\n <tr><th>Tool<\/th><td><a href=\\\"\/docs\/modul\/frontend-quality\\\">HTMLHint<\/a><\/td><\/tr>\\n<\/table>\\n<p>Validiert HTML-Tabellen nach DRY\/KISS\/SRP-Prinzipien:<\/p>\\n<ul>\\n <li>Keine \\\"Aktionen\\\"-Spalte mit Details-Button - ID\/Titel verlinken<\/li>\\n <li>Keine Modals - echte URLs verwenden<\/li>\\n <li>Alle Spalten sortierbar (data-sort Attribut)<\/li>\\n <li>Suchfeld für jede Tabelle<\/li>\\n <li>Wiederverwendbare DataTable-Komponente<\/li>\\n<\/ul>\\n\\n<h3>CSS Contract v1.0<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>css-contract_v1.0.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/src\/View\/**\/*.php, \/public\/css\/**\/*.css<\/td><\/tr>\\n <tr><th>Tool<\/th><td><a href=\\\"\/docs\/modul\/frontend-quality\\\">Stylelint<\/a><\/td><\/tr>\\n<\/table>\\n<p>Validiert CSS nach WCAG 2.1 AA Accessibility-Standards:<\/p>\\n<ul>\\n <li>Farbkontrast min. 4.5:1 für Text (A11Y-001)<\/li>\\n <li>Vordergrundfarbe immer mit Hintergrundfarbe definieren (COL-001)<\/li>\\n <li>Focus-Styles niemals entfernen (A11Y-004)<\/li>\\n <li>Mindestschriftgröße 16px für Fließtext (TYP-001)<\/li>\\n <li>CSS-Variablen für Farben verwenden (COL-002)<\/li>\\n <li>Kein !important außer für Utility-Klassen (FRB-001)<\/li>\\n<\/ul>\\n\\n<h3>JS Browser Architecture v2<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>js-browser-architecture-contract_v2.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/public\/js\/**\/*.js<\/td><\/tr>\\n <tr><th>Tool<\/th><td><a href=\\\"\/docs\/modul\/frontend-quality\\\">ESLint + Prettier<\/a><\/td><\/tr>\\n<\/table>\\n<p>Validiert JavaScript für Browser-Anwendungen:<\/p>\\n<ul>\\n <li>ES Modules ohne Build-Tools (ECMAScript 2024)<\/li>\\n <li>Strikte Gleichheit (===)<\/li>\\n <li>const\/let statt var<\/li>\\n <li>Double Quotes, Semikolons, 2 Spaces<\/li>\\n <li>Keine eval(), no-implied-eval (Security)<\/li>\\n<\/ul>\\n\\n<h3>Python Pipeline Contract v1.0<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>python-pipeline-contract_v1.0.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>\/opt\/scripts\/pipeline\/**\/*.py<\/td><\/tr>\\n <tr><th>Tool<\/th><td><a href=\\\"\/docs\/modul\/php-quality\\\">Ruff + mypy<\/a><\/td><\/tr>\\n<\/table>\\n<p>Validiert Python-Code in der KI-Pipeline:<\/p>\\n<ul>\\n <li>Type Hints für alle Funktionen (Parameter + Return)<\/li>\\n <li>Docstrings für Module, Klassen, Public Functions<\/li>\\n <li>Keine bare except, keine silent failures<\/li>\\n <li>Security: Keine hardcoded Credentials, kein eval()<\/li>\\n <li>Imports sortiert, keine Wildcards<\/li>\\n<\/ul>\\n\\n<h3>View Structure Contract v1.0<\/h3>\\n<table>\\n <tr><th>Datei<\/th><td>view-structure-contract_v1.0.yaml<\/td><\/tr>\\n <tr><th>Status<\/th><td>active<\/td><\/tr>\\n <tr><th>Scope<\/th><td>CRUD-Ressourcen: \/src\/View\/tasks\/*, \/src\/View\/content\/*<\/td><\/tr>\\n<\/table>\\n<p>Validiert die Struktur von CRUD-Views (index, show, new, edit):<\/p>\\n<ul>\\n <li>RESTful URLs: \/{resource}, \/{resource}\/new, \/{resource}\/{id}, \/{resource}\/{id}\/edit<\/li>\\n <li>Seitenaufbau: Breadcrumb → h1 → Tabelle\/Content → Actions<\/li>\\n <li>Keine page-container, Cards oder verschachtelte Strukturen<\/li>\\n <li>Formulare: class=\\\"form\\\", max-width: 600px, flache form-group<\/li>\\n <li>Referenz: \/src\/View\/tasks\/* als Vorlage<\/li>\\n<\/ul>\\n<p><strong>Gilt nicht für:<\/strong> \/docs (eigener Contract), \/chat (interaktives Tool), \/home (Landing Pages)<\/p>\\n\\n<h4>Neue CRUD-Ressource hinzufügen<\/h4>\\n<ol>\\n <li>Verzeichnis erstellen: <code>\/src\/View\/{resource}\/<\/code><\/li>\\n <li>Views anlegen: <code>index.php<\/code>, <code>show.php<\/code>, <code>new.php<\/code>, <code>edit.php<\/code><\/li>\\n <li>Contract-Scope erweitern: <code>includes += \\\"\/src\/View\/{resource}\/*.php\\\"<\/code><\/li>\\n <li>Vorlage: <code>\/src\/View\/tasks\/*<\/code> kopieren und anpassen<\/li>\\n<\/ol>\\n\\n<h2>Zukünftige Contracts<\/h2>\\n<p>Geplante Contracts für zukünftige Erweiterungen:<\/p>\\n<ul>\\n <li>API Contract - OpenAPI\/Swagger Validierung<\/li>\\n<\/ul>\\n\\n<h2>Severity Levels<\/h2>\\n<table>\\n <tr><th>Level<\/th><th>Bedeutung<\/th><th>Aktion<\/th><\/tr>\\n <tr><td>critical<\/td><td>Faktisch falsch<\/td><td>Dokument abgelehnt<\/td><\/tr>\\n <tr><td>major<\/td><td>Unvollständig<\/td><td>Überarbeitung nötig<\/td><\/tr>\\n <tr><td>minor<\/td><td>Kosmetisch<\/td><td>Nur protokolliert<\/td><\/tr>\\n<\/table>\\n\\n<h2>Pass-Schwelle<\/h2>\\n<ul>\\n <li>0 critical violations (sonst: rejected)<\/li>\\n <li>max 2 major violations (sonst: revision required)<\/li>\\n <li>max 5 minor violations (sonst: approved with notes)<\/li>\\n<\/ul>\\n\\n<h2>Automatische Validierung<\/h2>\\n<p>Alle Contracts werden automatisch vor dem Sync zu Produktion geprüft.<\/p>\\n\\n<h3>Pre-Sync Hook<\/h3>\\n<table>\\n <tr><th>Script<\/th><td><code>\/opt\/scripts\/cont... [TRUNCATED-b315c92c2f2afbfd]"
}
]
}