{
"event": "PreToolUse",
"tool_name": "mcp__mcp-docs__docs_update",
"tool_input": {
"id": 59,
"content": "<nav class=\"breadcrumb\">\n <a href=\"\/docs\">Dokumentation<\/a> » <a href=\"\/docs\/betrieb\">Betrieb<\/a> » Contracts\n<\/nav>\n\n<h1>Contracts<\/h1>\n<p class=\"doc-meta\"><strong>Erstellt:<\/strong> 2025-12-20 | <strong>Aktualisiert:<\/strong> 2025-12-31<\/p>\n\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_dev.contracts<\/code><\/td><\/tr>\n <tr><th>MCP-Server<\/th><td><a href=\"\/docs\/mcp\/mcp-contracts\">mcp-contracts<\/a> (contracts_* Tools)<\/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-contracts)<\/h3>\n<p>Für Details siehe <a href=\"\/docs\/mcp\/mcp-contracts\/mcp-contracts-tools\">MCP-Contracts Tools<\/a>.<\/p>\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<h2>Aktive Contracts (15)<\/h2>\n<table>\n <tr><th>ID<\/th><th>Name<\/th><th>Version<\/th><th>Scope<\/th><\/tr>\n <tr><td>1<\/td><td>betriebsdokumentation-pruefung<\/td><td>2.0<\/td><td>Docs-Struktur<\/td><\/tr>\n <tr><td>2<\/td><td>CSS Contract<\/td><td>2.0<\/td><td>Stylelint-Regeln<\/td><\/tr>\n <tr><td>3<\/td><td>HTML Tables Contract<\/td><td>2.0<\/td><td>Tabellen-Struktur<\/td><\/tr>\n <tr><td>4<\/td><td>js-browser-architecture-contract<\/td><td>2.0<\/td><td>JavaScript ES Modules<\/td><\/tr>\n <tr><td>5<\/td><td>layered-architecture-pruefung<\/td><td>3.2<\/td><td>Layer-Grenzen<\/td><\/tr>\n <tr><td>6<\/td><td>python-pipeline-contract<\/td><td>2.0<\/td><td>Python Code Quality<\/td><\/tr>\n <tr><td>7<\/td><td>View Structure Contract<\/td><td>2.0<\/td><td>CRUD-Views<\/td><\/tr>\n <tr><td>8<\/td><td>db-access-security-protocol<\/td><td>2.0<\/td><td>DB Security<\/td><\/tr>\n <tr><td>9<\/td><td>code-quality-standards<\/td><td>2.1<\/td><td>Code Quality<\/td><\/tr>\n <tr><td>10<\/td><td>critic-workflow<\/td><td>1.0<\/td><td>Review-Workflow<\/td><\/tr>\n <tr><td>11<\/td><td>architecture-gate-contract<\/td><td>1.1<\/td><td>PHP File Analysis<\/td><\/tr>\n <tr><td>12<\/td><td>taxonomy-mapping-contract<\/td><td>1.0.0<\/td><td>Taxonomie-Mapping<\/td><\/tr>\n <tr><td>13<\/td><td>text-quality-standards<\/td><td>1.0<\/td><td>Text-Qualität<\/td><\/tr>\n <tr><td>14<\/td><td>htmx-patterns-contract<\/td><td>1.0<\/td><td>HTMX-Patterns<\/td><\/tr>\n <tr><td>15<\/td><td>SemanticExplorerController<\/td><td>1.0<\/td><td>Semantic Explorer<\/td><\/tr>\n<\/table>\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>\/var\/www\/scripts\/contract-check.sh<\/code><\/td><\/tr>\n <tr><th>Aufruf<\/th><td><code>\/var\/www\/scripts\/contract-check.sh [path]<\/code><\/td><\/tr>\n <tr><th>Integration<\/th><td><code>\/var\/www\/scripts\/sync-dev-prod.sh<\/code><\/td><\/tr>\n <tr><th>Exit-Codes<\/th><td>0 = OK, 1 = Critical, 2 = Major<\/td><\/tr>\n<\/table>\n\n<h3>Manuell ausführen<\/h3>\n<pre><code># Alle Contracts prüfen\n\/var\/www\/scripts\/contract-check.sh\n\n# Mit spezifischem Pfad\n\/var\/www\/scripts\/contract-check.sh \/var\/www\/dev.campus.systemische-tools.de<\/code><\/pre>\n\n<h2>Verwandte Themen<\/h2>\n<ul>\n <li><a href=\"\/docs\/mcp\/mcp-contracts\">MCP-Contracts Server<\/a> - Technische Dokumentation<\/li>\n <li><a href=\"\/docs\/qualitaet\">Qualität<\/a> - Quality Gates und Code Hygiene<\/li>\n<\/ul>"
}
}
{
"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> » <a href=\\\"\/docs\/betrieb\\\">Betrieb<\/a> » Contracts\\n<\/nav>\\n\\n<h1>Contracts<\/h1>\\n<p class=\\\"doc-meta\\\"><strong>Erstellt:<\/strong> 2025-12-20 | <strong>Aktualisiert:<\/strong> 2025-12-31<\/p>\\n\\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_dev.contracts<\/code><\/td><\/tr>\\n <tr><th>MCP-Server<\/th><td><a href=\\\"\/docs\/mcp\/mcp-contracts\\\">mcp-contracts<\/a> (contracts_* Tools)<\/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-contracts)<\/h3>\\n<p>Für Details siehe <a href=\\\"\/docs\/mcp\/mcp-contracts\/mcp-contracts-tools\\\">MCP-Contracts Tools<\/a>.<\/p>\\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<h2>Aktive Contracts (15)<\/h2>\\n<table>\\n <tr><th>ID<\/th><th>Name<\/th><th>Version<\/th><th>Scope<\/th><\/tr>\\n <tr><td>1<\/td><td>betriebsdokumentation-pruefung<\/td><td>2.0<\/td><td>Docs-Struktur<\/td><\/tr>\\n <tr><td>2<\/td><td>CSS Contract<\/td><td>2.0<\/td><td>Stylelint-Regeln<\/td><\/tr>\\n <tr><td>3<\/td><td>HTML Tables Contract<\/td><td>2.0<\/td><td>Tabellen-Struktur<\/td><\/tr>\\n <tr><td>4<\/td><td>js-browser-architecture-contract<\/td><td>2.0<\/td><td>JavaScript ES Modules<\/td><\/tr>\\n <tr><td>5<\/td><td>layered-architecture-pruefung<\/td><td>3.2<\/td><td>Layer-Grenzen<\/td><\/tr>\\n <tr><td>6<\/td><td>python-pipeline-contract<\/td><td>2.0<\/td><td>Python Code Quality<\/td><\/tr>\\n <tr><td>7<\/td><td>View Structure Contract<\/td><td>2.0<\/td><td>CRUD-Views<\/td><\/tr>\\n <tr><td>8<\/td><td>db-access-security-protocol<\/td><td>2.0<\/td><td>DB Security<\/td><\/tr>\\n <tr><td>9<\/td><td>code-quality-standards<\/td><td>2.1<\/td><td>Code Quality<\/td><\/tr>\\n <tr><td>10<\/td><td>critic-workflow<\/td><td>1.0<\/td><td>Review-Workflow<\/td><\/tr>\\n <tr><td>11<\/td><td>architecture-gate-contract<\/td><td>1.1<\/td><td>PHP File Analysis<\/td><\/tr>\\n <tr><td>12<\/td><td>taxonomy-mapping-contract<\/td><td>1.0.0<\/td><td>Taxonomie-Mapping<\/td><\/tr>\\n <tr><td>13<\/td><td>text-quality-standards<\/td><td>1.0<\/td><td>Text-Qualität<\/td><\/tr>\\n <tr><td>14<\/td><td>htmx-patterns-contract<\/td><td>1.0<\/td><td>HTMX-Patterns<\/td><\/tr>\\n <tr><td>15<\/td><td>SemanticExplorerController<\/td><td>1.0<\/td><td>Semantic Explorer<\/td><\/tr>\\n<\/table>\\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>\/var\/www\/scripts\/contract-check.sh<\/code><\/td><\/tr>\\n <tr><th>Aufruf<\/th><td><code>\/var\/www\/scripts\/contract-check.sh [path]<\/code><\/td><\/tr>\\n <tr><th>Integration<\/th><td><code>\/var\/www\/scripts\/sync-dev-prod.sh<\/code><\/td><\/tr>\\n <tr><th>Exit-Codes<\/th><td>0 = OK, 1 = Critical, 2 = Major<\/td><\/tr>\\n<\/table>\\n\\n<h3>Manuell ausführen<\/h3>\\n<pre><code># Alle Contracts prüfen\\n\/var\/www\/scripts\/contract-check.sh\\n\\n# Mit spezifischem Pfad\\n\/var\/www\/scripts\/contract-check.sh \/var\/www\/dev.campus.systemische-tools.de<\/code><\/pre>\\n\\n<h2>Verwandte Themen<\/h2>\\n<ul>\\n <li><a href=\\\"\/docs\/mcp\/mcp-contracts\\\">MCP-Contracts Server<\/a> - Technische Dokumentation<\/li>\\n <li><a href=\\\"\/docs\/qualitaet\\\">Qualität<\/a> - Quality Gates und Code Hygiene<\/li>\\n<\/ul>\",\n \"status\": \"published\",\n \"sort_order\": 4,\n \"depth\": 1,\n \"created_at\": \"2025-12-20T11:13:58\",\n \"updated_at\": \"2025-12-31T04:09:15\"\n },\n \"message\": \"Document #59 updated\"\n}"
}
]
}