Protokoll #4161

{
    "event": "PreToolUse",
    "tool_name": "mcp__mcp-contracts__contracts_list",
    "tool_input": {
        "compact": false,
        "limit": 50
    }
}

{
    "tool_response": [
        {
            "type": "text",
            "text": "{\n  \"success\": true,\n  \"contracts\": [\n    {\n      \"id\": 1,\n      \"uuid\": \"33e181bd-07a0-435d-941d-b23474c41ab9\",\n      \"name\": \"betriebsdokumentation-pruefung_v1.1\",\n      \"version\": \"1.0\",\n      \"status\": \"active\",\n      \"yaml_content\": \"# =============================================================================\\n# BETRIEBSDOKUMENTATION VALIDATION CONTRACT\\n# =============================================================================\\n# Normatives Dokument zur Validierung von Server- und Betriebsdokumentation\\n# Version: 1.1.0\\n# Erstellt: 2025-12-20\\n# =============================================================================\\n\\nmeta:\\n  document_type: operations_documentation_validation_contract\\n  normative: true\\n  binding: mandatory\\n  created: 2025-12-20\\n  updated: 2025-12-20\\n  author: system_generated_under_supervision\\n  supersedes: betriebsdokumentation-pruefung_v1.0.yaml\\n\\nidentity:\\n  name: betriebsdokumentation_validation\\n  version: 1.1.0\\n  status: active\\n\\n# =============================================================================\\n# SCOPE (technisch definiert)\\n# =============================================================================\\nscope:\\n  document_format: php_html\\n  file_extension: .php\\n\\n  applies_to_paths:\\n    - \/var\/www\/dev.campus.systemische-tools.de\/src\/View\/docs\/**\/*.php\\n    - \/var\/www\/prod.campus.systemische-tools.de\/src\/View\/docs\/**\/*.php\\n\\n  platform:\\n    os: Debian GNU\/Linux 13 (trixie)\\n    init_system: systemd\\n    shell: bash\\n    web_server: Apache 2.4\\n    privileges_required: root\\n\\n  excludes_paths:\\n    - \\\"**\/layout.php\\\"\\n    - \\\"**\/partials\/**\\\"\\n\\n# =============================================================================\\n# SEVERITY LEVELS (mit abgeleiteten Actions)\\n# =============================================================================\\nseverity_levels:\\n  critical:\\n    description: Dokumentation ist faktisch falsch oder gefährlich\\n    action: reject_document\\n    examples:\\n      - Falscher Dateipfad für Konfiguration\\n      - Befehl mit falscher Syntax\\n      - Falsche Portnummer für Dienst\\n\\n  major:\\n    description: Dokumentation ist unvollständig oder veraltet\\n    action: flag_for_revision\\n    examples:\\n      - Fehlende Einleitung\\n      - Veraltete Versionsnummer\\n      - Fehlender wichtiger Befehl\\n\\n  minor:\\n    description: Kosmetische oder stilistische Probleme\\n    action: log_only\\n    examples:\\n      - Inkonsistente Formatierung\\n      - Fehlender Breadcrumb\\n      - Uneinheitliche Begriffe\\n\\n# Action wird IMMER aus severity abgeleitet:\\n# critical -> reject_document\\n# major -> flag_for_revision\\n# minor -> log_only\\n\\n# =============================================================================\\n# PASS THRESHOLD (explizite Operatoren)\\n# =============================================================================\\npass_threshold:\\n  critical_violations_max: 0      # 0 erlaubt, ab 1 rejected\\n  major_violations_max: 2         # 0-2 erlaubt, ab 3 revision required\\n  minor_violations_max: 5         # 0-5 erlaubt, ab 6 approved with notes\\n\\n  outcome_logic:\\n    - condition: \\\"critical_violations > 0\\\"\\n      result: document_rejected\\n    - condition: \\\"major_violations > 2\\\"\\n      result: revision_required\\n    - condition: \\\"minor_violations > 5\\\"\\n      result: approved_with_notes\\n    - condition: \\\"all within limits\\\"\\n      result: document_approved\\n\\n# =============================================================================\\n# VALIDATION FACTORS\\n# =============================================================================\\nvalidation_factors:\\n\\n  path_existence:\\n    priority: 1\\n    severity: critical\\n    # Action: reject_document (abgeleitet aus severity)\\n    description: Alle dokumentierten Dateipfade müssen auf dem System existieren.\\n    validation:\\n      method: filesystem_verification\\n      scope: \\\"Pfade in <td> und <code> Tags, die mit \/ beginnen\\\"\\n      verification_approach: \\\"Prüfung ob Datei oder Verzeichnis existiert\\\"\\n      excludes:\\n        - Platzhalter wie {name}, PORT, PASSWORD\\n        - Relative Pfade\\n        - URLs\\n    examples:\\n      valid:\\n        - \\\"\/etc\/ssh\/sshd_config.d\/99-custom.conf\\\"\\n        - \\\"\/opt\/scripts\/backup.sh\\\"\\n      invalid:\\n        - \\\"\/etc\/ssh\/custom.conf\\\"  # Existiert nicht\\n\\n  command_validity:\\n    priority: 2\\n    severity: critical\\n    # Action: reject_document (abgeleitet aus severity)\\n    description: Dokumentierte Befehle müssen syntaktisch plausibel sein.\\n    validation:\\n      method: syntactic_plausibility_check\\n      scope: \\\"Befehle in <pre><code> Blöcken\\\"\\n      checks:\\n        - Befehlsname ist ein bekanntes Executable oder Builtin\\n        - Keine offensichtlichen Tippfehler\\n        - Grundlegende Optionssyntax (-- oder -)\\n      does_not_check:\\n        - Funktionale Korrektheit zur Laufzeit\\n        - Alle möglichen Optionskombinationen\\n        - Exit-Codes\\n    examples:\\n      valid:\\n        - \\\"systemctl status apache2\\\"\\n        - \\\"certbot renew --dry-run\\\"\\n      invalid:\\n        - \\\"systemctl status apche2\\\"  # Tippfehler\\n        - \\\"cerbot renew\\\"  # Falscher Befehlsname\\n\\n  service_accuracy:\\n    priority: 3\\n    severity: critical\\n    # Action: reject_document (abgeleitet aus severity)\\n    description: Dienst-Informationen müssen mit laufendem System übereinstimmen.\\n    platform_requirement: \\\"Debian 13 mit Systemd, Root-Rechte\\\"\\n    validation:\\n      method: service_state_verification\\n      checks:\\n        port:\\n          description: \\\"Dokumentierter Port muss vom Dienst genutzt werden\\\"\\n          tolerance: none\\n        version:\\n          description: \\\"Major.Minor Version muss stimmen\\\"\\n          tolerance: patch_version  # 8.4.x ist ok wenn 8.4 dokumentiert\\n        status:\\n          description: \\\"Dokumentierter Status muss aktuell sein\\\"\\n          tolerance: none\\n\\n  config_correctness:\\n    priority: 4\\n    severity: major\\n    # Action: flag_for_revision (abgeleitet aus severity)\\n    description: Konfigurationsbeispiele müssen mit echten Dateien übereinstimmen.\\n    validation:\\n      method: config_comparison\\n      scope: \\\"Konfig-Blöcke in <pre><code> mit referenziertem Dateipfad\\\"\\n      tolerance:\\n        whitespace: ignore\\n        comments: ignore\\n        order: flexible\\n      allowed_placeholders:\\n        - \\\"{{REDACTED}}\\\"\\n        - \\\"PASSWORD\\\"\\n        - \\\"SECRET\\\"\\n        - \\\"your-value-here\\\"\\n      note: \\\"Dokumentation darf bewusst reduzierte oder anonymisierte Konfigs zeigen\\\"\\n\\n  structure_compliance:\\n    priority: 5\\n    severity: major\\n    # Action: flag_for_revision (abgeleitet aus severity)\\n    description: Module müssen die PHP\/HTML-Strukturvorgaben einhalten.\\n    format: php_html\\n    required_elements:\\n      breadcrumb:\\n        element: \\\"nav.breadcrumb\\\"\\n        contains: \\\"Links zu \/docs und Kategorie\\\"\\n      title:\\n        element: \\\"h1\\\"\\n        content: \\\"Modulname\\\"\\n      introduction:\\n        element: \\\"p\\\"\\n        position: \\\"Direkt nach h1\\\"\\n        content: \\\"1-2 Sätze Erklärung\\\"\\n      info_table:\\n        element: \\\"table\\\"\\n        contains: \\\"Mindestens Version\/Port\/Pfad\\\"\\n      commands:\\n        element: \\\"pre > code\\\"\\n        content: \\\"Wichtigste Verwaltungsbefehle\\\"\\n    optional_elements:\\n      - \\\"h2 Subsections\\\"\\n      - \\\"Zusätzliche Tabellen\\\"\\n      - \\\"Listen (ul\/ol)\\\"\\n\\n  link_integrity:\\n    priority: 6\\n    severity: major\\n    # Action: flag_for_revision (abgeleitet aus severity)\\n    description: Interne Links müssen zu existierenden Routen führen.\\n    validation:\\n      method: route_verification\\n      scope: 'href Attribute die mit \\\"\/docs\\\" beginnen'\\n      checks:\\n        - Route existiert im DocsController\\n        - Ziel-View-Datei existiert\\n\\n  terminology:\\n    priority: 7\\n    severity: minor\\n    # Action: log_only (abgeleitet aus severity)\\n    description: Begriffe im Fließtext sollten einheitlich sein.\\n    validation:\\n      method: terminology_consistency\\n      scope: \\\"Nur Fließtext (p, li), NICHT code, pre, td mit Pfaden\\\"\\n      preferred_terms:\\n        - prefer: \\\"Dienst\\\"\\n          avoid: \\\"Service\\\"\\n          context: \\\"Fließtext\\\"\\n        - prefer: \\\"Befehl\\\"\\n          avoid: \\\"Command\\\"\\n          context: \\\"Fließtext\\\"\\n      exceptions:\\n        - \\\"Service in englischen Eigennamen (systemd service)\\\"\\n        - \\\"Technische Begriffe in Code-Kontexten\\\"\\n\\n# =============================================================================\\n# ENFORCEMENT (harte Regeln)\\n# =============================================================================\\nenforcement:\\n  on_sync_to_prod:\\n    rule: \\\"BLOCKIERT bei critical_violations > 0\\\"\\n    process:\\n      1: \\\"Validierung vor \/opt\/scripts\/sync-dev-prod.sh\\\"\\n      2: \\\"Bei critical violation: Sync wird NICHT ausgeführt\\\"\\n      3: \\\"Fehler müssen erst behoben werden\\\"\\n\\n  on_new_module:\\n    rule: \\\"Alle required_elements aus structure_compliance müssen vorhanden sein\\\"\\n\\n  periodic_review:\\n    frequency: monthly\\n    scope: all_modules\\n    focus: \\\"service_accuracy (Versionen, Ports)\\\"\\n\\n# =============================================================================\\n# REPORT TEMPLATE (empfohlen, nicht normativ)\\n# =============================================================================\\nreport_template:\\n  note: \\\"Dieses Template ist eine Empfehlung, keine Pflicht\\\"\\n  fields:\\n    - module_name\\n    - validation_date\\n    - critical_count\\n    - major_count\\n    - minor_count\\n    - outcome\\n    - findings_list\\n\",\n      \"scope_description\": \"\",\n      \"created_at\": \"2025-12-20T10:59:58\",\n      \"created_by\": \"migration\",\n      \"updated_at\": \"2025-12-20T10:59:58\"\n    },\n    {\n      \"id\": 9,\n      \"uuid\": \"e5192b8b-7dc0-4a9d-9c98-a3ba37b7f1bc\",\n      \"name\": \"code-quality-standards\",\n      \"version\": \"1.0\",\n      \"status\": \"active\",\n      \"yaml_content\": \"name: Code Quality Standards\\nv... [TRUNCATED-76338307360d845d]"
        }
    ]
}