Protokoll #23905

{
    "event": "PreToolUse",
    "tool_name": "mcp__mcp-docs__docs_update",
    "tool_input": {
        "id": 80,
        "content": "<nav class=\"breadcrumb\">\n    <a href=\"\/docs\">Dokumentation<\/a> &raquo; <a href=\"\/docs\/betrieb\">Betrieb<\/a> &raquo; Claude Hooks\n<\/nav>\n\n<h1>Claude Hooks<\/h1>\n<p>Python-Hooks für Claude Code Integration mit Protokollierung, Backup, Task-Erstellung, Workflow-Validierung und Architektur-Guards.<\/p>\n\n<table>\n    <tr><th>Pfad<\/th><td>\/var\/www\/tools\/ki-protokoll\/claude-hook\/<\/td><\/tr>\n    <tr><th>Konfiguration<\/th><td>\/root\/.claude\/settings.json<\/td><\/tr>\n    <tr><th>Datenbank<\/th><td>ki_dev<\/td><\/tr>\n<\/table>\n\n<h2>Übersicht<\/h2>\n<table>\n    <tr><th>Hook<\/th><th>Trigger<\/th><th>Funktion<\/th><\/tr>\n    <tr><td>log_to_db.py<\/td><td>Alle Events<\/td><td>Protokollierung in DB<\/td><\/tr>\n    <tr><td>file_backup_hook.py<\/td><td>PreToolUse (Edit, Write)<\/td><td>Datei-Backup vor Änderung<\/td><\/tr>\n    <tr><td>task_hook.py<\/td><td>UserPromptSubmit<\/td><td>Auto-Task-Erstellung<\/td><\/tr>\n    <tr><td>task_completion_guard.py<\/td><td>PreToolUse (tasks_status)<\/td><td>Blockiert Task-Completion ohne Result<\/td><\/tr>\n    <tr><td>block_direct_db.py<\/td><td>PreToolUse (Bash)<\/td><td>Blockiert direkte DB-Zugriffe (mysql\/mariadb)<\/td><\/tr>\n    <tr><td>architecture_guard.py<\/td><td>PreToolUse (Write)<\/td><td>Prüft Architektur-Regeln<\/td><\/tr>\n    <tr><td>hook_dispatcher.py<\/td><td>PreToolUse, PostToolUse<\/td><td>Quality-Gates Dispatcher<\/td><\/tr>\n<\/table>\n\n<p><strong>Prozess-Dokumentation:<\/strong> <a href=\"\/docs\/prozesse\/claude-hooks-prozess\">Claude Pre-\/Post-Hook Prozess<\/a><\/p>\n\n<h2>log_to_db.py<\/h2>\n<p>Protokolliert alle Claude Code Events in der Datenbank.<\/p>\n\n<h3>Features<\/h3>\n<ul>\n    <li><strong>Request\/Response-Pairing:<\/strong> PreToolUse → PostToolUse werden verknüpft<\/li>\n    <li><strong>Duration-Tracking:<\/strong> Millisekunden-genaue Zeiterfassung<\/li>\n    <li><strong>Token-Schätzung:<\/strong> ~4 Zeichen = 1 Token<\/li>\n    <li><strong>Sensible Daten:<\/strong> Automatische Maskierung (Passwörter, API-Keys, JWTs)<\/li>\n    <li><strong>Session-Tracking:<\/strong> Temporäre Dateien in \/tmp\/claude_hooks\/<\/li>\n<\/ul>\n\n<h3>Verarbeitete Events<\/h3>\n<table>\n    <tr><th>Event<\/th><th>Verarbeitung<\/th><\/tr>\n    <tr><td>UserPromptSubmit<\/td><td>Prompt speichern<\/td><\/tr>\n    <tr><td>PreToolUse<\/td><td>Tool-Name + Input speichern, pending<\/td><\/tr>\n    <tr><td>PostToolUse<\/td><td>Response zu PreToolUse matchen, completed<\/td><\/tr>\n    <tr><td>SessionStart\/End<\/td><td>Session-Lifecycle loggen<\/td><\/tr>\n    <tr><td>Stop\/SubagentStop<\/td><td>Abschluss loggen<\/td><\/tr>\n<\/table>\n\n<h3>Datenbank-Tabelle<\/h3>\n<pre><code>ki_dev.protokoll\n├── id, timestamp\n├── request_ip, client_name\n├── request, request_timestamp\n├── response, response_timestamp\n├── duration_ms\n├── tokens_input, tokens_output, tokens_total\n├── model_name, status<\/code><\/pre>\n\n<h2>file_backup_hook.py<\/h2>\n<p>Sichert Dateien automatisch BEVOR sie geändert werden.<\/p>\n\n<h3>Trigger<\/h3>\n<ul>\n    <li>PreToolUse → Edit<\/li>\n    <li>PreToolUse → Write<\/li>\n<\/ul>\n\n<h3>Backup-Verzeichnisse<\/h3>\n<pre><code>\/var\/www\/dev.campus.systemische-tools.de\/src\n\/var\/www\/dev.campus.systemische-tools.de\/public\n\/var\/www\/dev.campus.systemische-tools.de\/scripts\n\/var\/www\/dev.campus.systemische-tools.de\/config\n\/var\/www\/prod.campus.systemische-tools.de\/src\n...<\/code><\/pre>\n\n<h3>Features<\/h3>\n<ul>\n    <li><strong>Versionierung:<\/strong> Automatische Version pro Datei<\/li>\n    <li><strong>Hash-Prüfung:<\/strong> Skip bei unveränderter Datei<\/li>\n    <li><strong>Größenlimit:<\/strong> Max 10 MB pro Datei<\/li>\n    <li><strong>Non-Blocking:<\/strong> Hook blockiert nie<\/li>\n<\/ul>\n\n<h3>Datenbank-Tabelle<\/h3>\n<pre><code>ki_dev.file_backup_history\n├── id, file_path, version\n├── file_content, content_hash, file_size\n├── change_type, changed_by, reason\n├── created_at<\/code><\/pre>\n\n<h2>task_hook.py<\/h2>\n<p>Erstellt automatisch Tasks aus Patterns in User-Prompts.<\/p>\n\n<h3>Erkannte Patterns<\/h3>\n<pre><code>TODO: &lt;text&gt;    → Task erstellen\nTASK: &lt;text&gt;    → Task erstellen\n@task &lt;text&gt;    → Task erstellen\n#task &lt;text&gt;    → Task erstellen<\/code><\/pre>\n\n<h2>task_completion_guard.py<\/h2>\n<p>Blockiert <code>tasks_status(completed)<\/code> wenn kein Result existiert. Erzwingt korrekten Workflow.<\/p>\n\n<h3>Trigger<\/h3>\n<ul>\n    <li>PreToolUse → mcp__mcp-tasks__tasks_status<\/li>\n    <li>Nur bei status=\"completed\"<\/li>\n<\/ul>\n\n<h3>Prüflogik<\/h3>\n<ol>\n    <li>Prüft ob <code>status == \"completed\"<\/code><\/li>\n    <li>DB-Query: <code>SELECT COUNT(*) FROM task_results WHERE task_id = ?<\/code><\/li>\n    <li>Wenn count = 0 → Block mit Exit-Code 2<\/li>\n<\/ol>\n\n<p>Details: <a href=\"\/docs\/prozesse\/claude-hooks-prozess\/task-completion-guard\">Task-Completion Guard Prozess<\/a><\/p>\n\n<h2>block_direct_db.py<\/h2>\n<p>Blockiert direkte Datenbank-Zugriffe via Bash. Erzwingt Nutzung von MCP-DB.<\/p>\n\n<h3>Trigger<\/h3>\n<ul>\n    <li>PreToolUse → Bash<\/li>\n    <li>Prüft Command auf mysql\/mariadb-Patterns<\/li>\n<\/ul>\n\n<h3>Blockierte Patterns<\/h3>\n<pre><code>mysql ...\nmariadb ...\nsudo mysql ...\nsudo mariadb ...<\/code><\/pre>\n\n<h3>Erlaubt<\/h3>\n<p>MCP-Tools: <code>mcp__mcp-db__db_select<\/code>, <code>mcp__mcp-db__db_insert<\/code>, etc.<\/p>\n\n<h2>architecture_guard.py<\/h2>\n<p>Prüft Architektur-Regeln bei PHP-Datei-Erstellung.<\/p>\n\n<h3>Trigger<\/h3>\n<ul>\n    <li>PreToolUse → Write (*.php)<\/li>\n<\/ul>\n\n<h3>Geprüfte Regeln<\/h3>\n<ul>\n    <li>Layer-Grenzen (Controller darf nicht direkt auf Repository zugreifen)<\/li>\n    <li>Namespace-Konventionen<\/li>\n    <li>Dependency Injection Patterns<\/li>\n<\/ul>\n\n<h2>hook_dispatcher.py<\/h2>\n<p>Zentraler Dispatcher für Quality-Gates. Lädt Regeln dynamisch.<\/p>\n\n<h3>Trigger<\/h3>\n<ul>\n    <li>PreToolUse → Write (BLOCK-Regeln)<\/li>\n    <li>PostToolUse → Write, Edit (WARN-Regeln)<\/li>\n<\/ul>\n\n<h3>Quality-Regeln<\/h3>\n<pre><code>quality\/\n├── pre_rules.py        ← BLOCK-Regeln\n├── post_rules.py       ← WARN-Regeln\n└── task_creator.py     ← Violations → Tasks<\/code><\/pre>\n\n<p>Details: <a href=\"\/docs\/prozesse\/quality-gates\">Quality Gates<\/a><\/p>\n\n<h2>Konfiguration<\/h2>\n<p>Hooks werden in <code>\/root\/.claude\/settings.json<\/code> registriert:<\/p>\n<pre><code>{\n  \"hooks\": {\n    \"UserPromptSubmit\": [...],\n    \"PreToolUse\": [\n      {\"matcher\": \"Bash\", \"hooks\": [...]},\n      {\"matcher\": \"mcp__mcp-tasks__tasks_status\", \"hooks\": [\n        {\"type\": \"command\", \"command\": \"...\/task_completion_guard.py\", \"timeout\": 5}\n      ]},\n      {\"matcher\": \"Edit|Write\", \"hooks\": [...]},\n      {\"matcher\": \"\", \"hooks\": [...]}\n    ],\n    \"PostToolUse\": [...]\n  }\n}<\/code><\/pre>\n\n<h2>Environment-Variablen<\/h2>\n<p>In <code>.env<\/code> im Hook-Verzeichnis:<\/p>\n<pre><code>CLAUDE_DB_HOST=localhost\nCLAUDE_DB_PORT=3306\nCLAUDE_DB_USER=root\nCLAUDE_DB_PASSWORD=***\nCLAUDE_DB_NAME=ki_dev<\/code><\/pre>\n\n<h2>Verwandte Themen<\/h2>\n<ul>\n    <li><a href=\"\/docs\/prozesse\/claude-hooks-prozess\">Claude Hooks Prozess<\/a> - Ablaufdiagramme und Workflow<\/li>\n    <li><a href=\"\/docs\/prozesse\/quality-gates\">Quality Gates<\/a> - Code-Qualitätsprüfung<\/li>\n    <li><a href=\"\/docs\/betrieb\/file-backup-hook\">File Backup Hook<\/a> - Detaillierte Backup-Dokumentation<\/li>\n<\/ul>"
    }
}

{
    "tool_response": [
        {
            "type": "text",
            "text": "{\n  \"success\": true,\n  \"doc\": {\n    \"id\": 80,\n    \"parent_id\": 55,\n    \"slug\": \"claude-hooks\",\n    \"path\": \"\/betrieb\/claude-hooks\",\n    \"title\": \"Claude Hooks\",\n    \"description\": \"Claude Code Hooks für Logging, Backup und Task-Erstellung\",\n    \"content\": \"<nav class=\\\"breadcrumb\\\">\\n    <a href=\\\"\/docs\\\">Dokumentation<\/a> &raquo; <a href=\\\"\/docs\/betrieb\\\">Betrieb<\/a> &raquo; Claude Hooks\\n<\/nav>\\n\\n<h1>Claude Hooks<\/h1>\\n<p>Python-Hooks für Claude Code Integration mit Protokollierung, Backup, Task-Erstellung, Workflow-Validierung und Architektur-Guards.<\/p>\\n\\n<table>\\n    <tr><th>Pfad<\/th><td>\/var\/www\/tools\/ki-protokoll\/claude-hook\/<\/td><\/tr>\\n    <tr><th>Konfiguration<\/th><td>\/root\/.claude\/settings.json<\/td><\/tr>\\n    <tr><th>Datenbank<\/th><td>ki_dev<\/td><\/tr>\\n<\/table>\\n\\n<h2>Übersicht<\/h2>\\n<table>\\n    <tr><th>Hook<\/th><th>Trigger<\/th><th>Funktion<\/th><\/tr>\\n    <tr><td>log_to_db.py<\/td><td>Alle Events<\/td><td>Protokollierung in DB<\/td><\/tr>\\n    <tr><td>file_backup_hook.py<\/td><td>PreToolUse (Edit, Write)<\/td><td>Datei-Backup vor Änderung<\/td><\/tr>\\n    <tr><td>task_hook.py<\/td><td>UserPromptSubmit<\/td><td>Auto-Task-Erstellung<\/td><\/tr>\\n    <tr><td>task_completion_guard.py<\/td><td>PreToolUse (tasks_status)<\/td><td>Blockiert Task-Completion ohne Result<\/td><\/tr>\\n    <tr><td>block_direct_db.py<\/td><td>PreToolUse (Bash)<\/td><td>Blockiert direkte DB-Zugriffe (mysql\/mariadb)<\/td><\/tr>\\n    <tr><td>architecture_guard.py<\/td><td>PreToolUse (Write)<\/td><td>Prüft Architektur-Regeln<\/td><\/tr>\\n    <tr><td>hook_dispatcher.py<\/td><td>PreToolUse, PostToolUse<\/td><td>Quality-Gates Dispatcher<\/td><\/tr>\\n<\/table>\\n\\n<p><strong>Prozess-Dokumentation:<\/strong> <a href=\\\"\/docs\/prozesse\/claude-hooks-prozess\\\">Claude Pre-\/Post-Hook Prozess<\/a><\/p>\\n\\n<h2>log_to_db.py<\/h2>\\n<p>Protokolliert alle Claude Code Events in der Datenbank.<\/p>\\n\\n<h3>Features<\/h3>\\n<ul>\\n    <li><strong>Request\/Response-Pairing:<\/strong> PreToolUse → PostToolUse werden verknüpft<\/li>\\n    <li><strong>Duration-Tracking:<\/strong> Millisekunden-genaue Zeiterfassung<\/li>\\n    <li><strong>Token-Schätzung:<\/strong> ~4 Zeichen = 1 Token<\/li>\\n    <li><strong>Sensible Daten:<\/strong> Automatische Maskierung (Passwörter, API-Keys, JWTs)<\/li>\\n    <li><strong>Session-Tracking:<\/strong> Temporäre Dateien in \/tmp\/claude_hooks\/<\/li>\\n<\/ul>\\n\\n<h3>Verarbeitete Events<\/h3>\\n<table>\\n    <tr><th>Event<\/th><th>Verarbeitung<\/th><\/tr>\\n    <tr><td>UserPromptSubmit<\/td><td>Prompt speichern<\/td><\/tr>\\n    <tr><td>PreToolUse<\/td><td>Tool-Name + Input speichern, pending<\/td><\/tr>\\n    <tr><td>PostToolUse<\/td><td>Response zu PreToolUse matchen, completed<\/td><\/tr>\\n    <tr><td>SessionStart\/End<\/td><td>Session-Lifecycle loggen<\/td><\/tr>\\n    <tr><td>Stop\/SubagentStop<\/td><td>Abschluss loggen<\/td><\/tr>\\n<\/table>\\n\\n<h3>Datenbank-Tabelle<\/h3>\\n<pre><code>ki_dev.protokoll\\n├── id, timestamp\\n├── request_ip, client_name\\n├── request, request_timestamp\\n├── response, response_timestamp\\n├── duration_ms\\n├── tokens_input, tokens_output, tokens_total\\n├── model_name, status<\/code><\/pre>\\n\\n<h2>file_backup_hook.py<\/h2>\\n<p>Sichert Dateien automatisch BEVOR sie geändert werden.<\/p>\\n\\n<h3>Trigger<\/h3>\\n<ul>\\n    <li>PreToolUse → Edit<\/li>\\n    <li>PreToolUse → Write<\/li>\\n<\/ul>\\n\\n<h3>Backup-Verzeichnisse<\/h3>\\n<pre><code>\/var\/www\/dev.campus.systemische-tools.de\/src\\n\/var\/www\/dev.campus.systemische-tools.de\/public\\n\/var\/www\/dev.campus.systemische-tools.de\/scripts\\n\/var\/www\/dev.campus.systemische-tools.de\/config\\n\/var\/www\/prod.campus.systemische-tools.de\/src\\n...<\/code><\/pre>\\n\\n<h3>Features<\/h3>\\n<ul>\\n    <li><strong>Versionierung:<\/strong> Automatische Version pro Datei<\/li>\\n    <li><strong>Hash-Prüfung:<\/strong> Skip bei unveränderter Datei<\/li>\\n    <li><strong>Größenlimit:<\/strong> Max 10 MB pro Datei<\/li>\\n    <li><strong>Non-Blocking:<\/strong> Hook blockiert nie<\/li>\\n<\/ul>\\n\\n<h3>Datenbank-Tabelle<\/h3>\\n<pre><code>ki_dev.file_backup_history\\n├── id, file_path, version\\n├── file_content, content_hash, file_size\\n├── change_type, changed_by, reason\\n├── created_at<\/code><\/pre>\\n\\n<h2>task_hook.py<\/h2>\\n<p>Erstellt automatisch Tasks aus Patterns in User-Prompts.<\/p>\\n\\n<h3>Erkannte Patterns<\/h3>\\n<pre><code>TODO: &lt;text&gt;    → Task erstellen\\nTASK: &lt;text&gt;    → Task erstellen\\n@task &lt;text&gt;    → Task erstellen\\n#task &lt;text&gt;    → Task erstellen<\/code><\/pre>\\n\\n<h2>task_completion_guard.py<\/h2>\\n<p>Blockiert <code>tasks_status(completed)<\/code> wenn kein Result existiert. Erzwingt korrekten Workflow.<\/p>\\n\\n<h3>Trigger<\/h3>\\n<ul>\\n    <li>PreToolUse → mcp__mcp-tasks__tasks_status<\/li>\\n    <li>Nur bei status=\\\"completed\\\"<\/li>\\n<\/ul>\\n\\n<h3>Prüflogik<\/h3>\\n<ol>\\n    <li>Prüft ob <code>status == \\\"completed\\\"<\/code><\/li>\\n    <li>DB-Query: <code>SELECT COUNT(*) FROM task_results WHERE task_id = ?<\/code><\/li>\\n    <li>Wenn count = 0 → Block mit Exit-Code 2<\/li>\\n<\/ol>\\n\\n<p>Details: <a href=\\\"\/docs\/prozesse\/claude-hooks-prozess\/task-completion-guard\\\">Task-Completion Guard Prozess<\/a><\/p>\\n\\n<h2>block_direct_db.py<\/h2>\\n<p>Blockiert direkte Datenbank-Zugriffe via Bash. Erzwingt Nutzung von MCP-DB.<\/p>\\n\\n<h3>Trigger<\/h3>\\n<ul>\\n    <li>PreToolUse → Bash<\/li>\\n    <li>Prüft Command auf mysql\/mariadb-Patterns<\/li>\\n<\/ul>\\n\\n<h3>Blockierte Patterns<\/h3>\\n<pre><code>mysql ...\\nmariadb ...\\nsudo mysql ...\\nsudo mariadb ...<\/code><\/pre>\\n\\n<h3>Erlaubt<\/h3>\\n<p>MCP-Tools: <code>mcp__mcp-db__db_select<\/code>, <code>mcp__mcp-db__db_insert<\/code>, etc.<\/p>\\n\\n<h2>architecture_guard.py<\/h2>\\n<p>Prüft Architektur-Regeln bei PHP-Datei-Erstellung.<\/p>\\n\\n<h3>Trigger<\/h3>\\n<ul>\\n    <li>PreToolUse → Write (*.php)<\/li>\\n<\/ul>\\n\\n<h3>Geprüfte Regeln<\/h3>\\n<ul>\\n    <li>Layer-Grenzen (Controller darf nicht direkt auf Repository zugreifen)<\/li>\\n    <li>Namespace-Konventionen<\/li>\\n    <li>Dependency Injection Patterns<\/li>\\n<\/ul>\\n\\n<h2>hook_dispatcher.py<\/h2>\\n<p>Zentraler Dispatcher für Quality-Gates. Lädt Regeln dynamisch.<\/p>\\n\\n<h3>Trigger<\/h3>\\n<ul>\\n    <li>PreToolUse → Write (BLOCK-Regeln)<\/li>\\n    <li>PostToolUse → Write, Edit (WARN-Regeln)<\/li>\\n<\/ul>\\n\\n<h3>Quality-Regeln<\/h3>\\n<pre><code>quality\/\\n├── pre_rules.py        ← BLOCK-Regeln\\n├── post_rules.py       ← WARN-Regeln\\n└── task_creator.py     ← Violations → Tasks<\/code><\/pre>\\n\\n<p>Details: <a href=\\\"\/docs\/prozesse\/quality-gates\\\">Quality Gates<\/a><\/p>\\n\\n<h2>Konfiguration<\/h2>\\n<p>Hooks werden in <code>\/root\/.claude\/settings.json<\/code> registriert:<\/p>\\n<pre><code>{\\n  \\\"hooks\\\": {\\n    \\\"UserPromptSubmit\\\": [...],\\n    \\\"PreToolUse\\\": [\\n      {\\\"matcher\\\": \\\"Bash\\\", \\\"hooks\\\": [...]},\\n      {\\\"matcher\\\": \\\"mcp__mcp-tasks__tasks_status\\\", \\\"hooks\\\": [\\n        {\\\"type\\\": \\\"command\\\", \\\"command\\\": \\\"...\/task_completion_guard.py\\\", \\\"timeout\\\": 5}\\n      ]},\\n      {\\\"matcher\\\": \\\"Edit|Write\\\", \\\"hooks\\\": [...]},\\n      {\\\"matcher\\\": \\\"\\\", \\\"hooks\\\": [...]}\\n    ],\\n    \\\"PostToolUse\\\": [...]\\n  }\\n}<\/code><\/pre>\\n\\n<h2>Environment-Variablen<\/h2>\\n<p>In <code>.env<\/code> im Hook-Verzeichnis:<\/p>\\n<pre><code>CLAUDE_DB_HOST=localhost\\nCLAUDE_DB_PORT=3306\\nCLAUDE_DB_USER=root\\nCLAUDE_DB_PASSWORD=***\\nCLAUDE_DB_NAME=ki_dev<\/code><\/pre>\\n\\n<h2>Verwandte Themen<\/h2>\\n<ul>\\n    <li><a href=\\\"\/docs\/prozesse\/claude-hooks-prozess\\\">Claude Hooks Prozess<\/a> - Ablaufdiagramme und Workflow<\/li>\\n    <li><a href=\\\"\/docs\/prozesse\/quality-gates\\\">Quality Gates<\/a> - Code-Qualitätsprüfung<\/li>\\n    <li><a href=\\\"\/docs\/betrieb\/file-backup-hook\\\">File Backup Hook<\/a> - Detaillierte Backup-Dokumentation<\/li>\\n<\/ul>\",\n    \"status\": \"published\",\n    \"sort_order\": 6,\n    \"depth\": 1,\n    \"created_at\": \"2025-12-20T13:41:35\",\n    \"updated_at\": \"2025-12-27T15:32:21\"\n  },\n  \"message\": \"Document #80 updated\"\n}"
        }
    ]
}