From 7f5fdef445dd0c81c5bf4a819888247c245f90ea Mon Sep 17 00:00:00 2001
From: overcuriousity <overcuriousity@posteo.org>
Date: Thu, 7 Aug 2025 08:55:29 +0200
Subject: [PATCH 1/3] fixes & consolidation

---
 src/components/AIQueryInterface.astro | 1361 ++++++++++++++++---------
 src/utils/aiPipeline.ts               |   19 -
 2 files changed, 854 insertions(+), 526 deletions(-)

diff --git a/src/components/AIQueryInterface.astro b/src/components/AIQueryInterface.astro
index b8b3969..88dae7e 100644
--- a/src/components/AIQueryInterface.astro
+++ b/src/components/AIQueryInterface.astro
@@ -3,7 +3,6 @@
 
 import { getToolsData } from '../utils/dataService.js';
 import { isToolHosted } from '../utils/toolHelpers.js';
-import { AuditTrailRenderer } from '../js/auditTrailRenderer.js';
 
 const data = await getToolsData();
 const tools = data.tools;
@@ -211,21 +210,575 @@ const domainAgnosticSoftware = data['domain-agnostic-software'] || [];
 
     <!-- Results -->
     <div id="ai-results" class="ai-results hidden">     
-      <!-- Audit trail container - managed by AuditTrailRenderer -->
       <div id="audit-trail-container"></div>
     </div>
   </div>
 </section>
 
 <script type="module" define:vars={{ tools, phases, domainAgnosticSoftware }}>
-  import { AuditTrailRenderer } from '../js/auditTrailRenderer.js';
 
+// ===================================================================
+// CONSOLIDATED UTILITIES
+// ===================================================================
+
+const Utils = {
+  // Phase configuration for audit trail
+  phaseConfig: {
+    'initialization': { icon: '🚀', displayName: 'Initialisierung' },
+    'retrieval': { icon: '🔍', displayName: 'Datensuche' },
+    'selection': { icon: '🎯', displayName: 'Tool-Auswahl' },
+    'micro-task': { icon: '⚡', displayName: 'Detail-Analyse' },
+    'validation': { icon: '✓', displayName: 'Validierung' },
+    'completion': { icon: '✅', displayName: 'Finalisierung' }
+  },
+
+  // Action translations for display
+  actionTranslations: {
+    'pipeline-start': 'Analyse gestartet',
+    'embeddings-search': 'Ähnliche Tools gesucht', 
+    'ai-tool-selection': 'Tools automatisch ausgewählt',
+    'ai-analysis': 'KI-Analyse durchgeführt',
+    'phase-tool-selection': 'Phasen-Tools evaluiert',
+    'tool-evaluation': 'Tool-Bewertung erstellt',
+    'background-knowledge-selection': 'Hintergrundwissen ausgewählt',
+    'confidence-scoring': 'Vertrauenswertung berechnet',
+    'pipeline-end': 'Analyse abgeschlossen'
+  },
+
+  getActionDisplayName(action) {
+    return this.actionTranslations[action] || action;
+  },
+
+  formatDuration(ms) {
+    if (ms < 1000) return '< 1s';
+    if (ms < 60000) return `${Math.ceil(ms / 1000)}s`;
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.ceil((ms % 60000) / 1000);
+    return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
+  },
+
+  getConfidenceColor(confidence) {
+    if (confidence >= 80) return 'var(--color-accent)';
+    if (confidence >= 60) return 'var(--color-warning)';
+    return 'var(--color-error)';
+  },
+
+  escapeHtml(text) {
+    if (typeof text !== 'string') return String(text);
+    const div = document.createElement('div');
+    div.textContent = text;
+    return div.innerHTML;
+  },
+
+  truncateText(text, maxLength) {
+    if (!text || text.length <= maxLength) return text;
+    return text.slice(0, maxLength) + '...';
+  },
+
+  sanitizeText(text) {
+    if (typeof text !== 'string') return '';
+    
+    return text
+      .replace(/^#{1,6}\s+/gm, '')
+      .replace(/^\s*[-*+]\s+/gm, '')
+      .replace(/^\s*\d+\.\s+/gm, '')
+      .replace(/\*\*(.+?)\*\*/g, '$1')
+      .replace(/\*(.+?)\*/g, '$1')
+      .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+      .replace(/```[\s\S]*?```/g, '[CODE BLOCK]')
+      .replace(/`([^`]+)`/g, '$1')
+      .replace(/<[^>]+>/g, '')
+      .replace(/\n\s*\n\s*\n/g, '\n\n')
+      .trim();
+  },
+
+  summarizeData(data) {
+    if (data === null || data === undefined) return 'null';
+    if (typeof data === 'string') {
+      return data.length > 100 ? data.slice(0, 100) + '...' : data;
+    }
+    if (typeof data === 'number' || typeof data === 'boolean') {
+      return data.toString();
+    }
+    if (Array.isArray(data)) {
+      if (data.length === 0) return '[]';
+      if (data.length <= 3) return JSON.stringify(data);
+      return `[${data.slice(0, 3).map(i => typeof i === 'string' ? i : JSON.stringify(i)).join(', ')}, ...+${data.length - 3}]`;
+    }
+    if (typeof data === 'object') {
+      const keys = Object.keys(data);
+      if (keys.length === 0) return '{}';
+      if (keys.length <= 3) {
+        return '{' + keys.map(k => `${k}: ${typeof data[k] === 'string' ? data[k].slice(0, 20) + (data[k].length > 20 ? '...' : '') : JSON.stringify(data[k])}`).join(', ') + '}';
+      }
+      return `{${keys.slice(0, 3).join(', ')}, ...+${keys.length - 3} keys}`;
+    }
+    return String(data);
+  },
+
+  // DOM utilities
+  showElement(element) {
+    if (element) {
+      element.style.display = 'block';
+      element.classList.remove('hidden');
+    }
+  },
+
+  hideElement(element) {
+    if (element) {
+      element.style.display = 'none';
+      element.classList.add('hidden');
+    }
+  }
+};
+
+// ===================================================================
+// AUDIT TRAIL PROCESSOR
+// ===================================================================
+
+class AuditTrailProcessor {
+  static processAuditTrail(rawAuditTrail) {
+    if (!rawAuditTrail || !Array.isArray(rawAuditTrail) || rawAuditTrail.length === 0) {
+      console.log('[AUDIT] No audit trail data provided');
+      return null;
+    }
+
+    try {
+      console.log('[AUDIT] Processing', rawAuditTrail.length, 'audit entries');
+
+      const totalTime = rawAuditTrail.reduce((sum, entry) => sum + (entry.processingTimeMs || 0), 0);
+      const validConfidenceEntries = rawAuditTrail.filter(entry => typeof entry.confidence === 'number');
+      const avgConfidence = validConfidenceEntries.length > 0 
+        ? Math.round(validConfidenceEntries.reduce((sum, entry) => sum + entry.confidence, 0) / validConfidenceEntries.length)
+        : 0;
+      
+      const highConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) >= 80).length;
+      const lowConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) < 60).length;
+
+      // Group entries by phase
+      const groupedEntries = rawAuditTrail.reduce((groups, entry) => {
+        const phase = entry.phase || 'unknown';
+        if (!groups[phase]) groups[phase] = [];
+        groups[phase].push(entry);
+        return groups;
+      }, {});
+
+      // Process phases
+      const phases = Object.entries(groupedEntries).map(([phase, entries]) => {
+        const phaseConfig = Utils.phaseConfig[phase] || { icon: '📋', displayName: phase };
+        const validEntries = entries.filter(entry => entry && typeof entry === 'object');
+        
+        const phaseAvgConfidence = validEntries.length > 0 
+          ? Math.round(validEntries.reduce((sum, entry) => sum + (entry.confidence || 0), 0) / validEntries.length)
+          : 0;
+        
+        const phaseTotalTime = validEntries.reduce((sum, entry) => sum + (entry.processingTimeMs || 0), 0);
+
+        return {
+          name: phase,
+          icon: phaseConfig.icon,
+          displayName: phaseConfig.displayName,
+          avgConfidence: phaseAvgConfidence,
+          totalTime: phaseTotalTime,
+          entries: validEntries.map(e => this.compressEntry(e)).filter(e => e !== null)
+        };
+      }).filter(phase => phase.entries.length > 0);
+
+      return {
+        totalTime,
+        avgConfidence,
+        stepCount: rawAuditTrail.length,
+        highConfidenceSteps,
+        lowConfidenceSteps,
+        phases,
+        summary: this.generateSummary(rawAuditTrail, avgConfidence, lowConfidenceSteps)
+      };
+      
+    } catch (error) {
+      console.error('[AUDIT] Error processing audit trail:', error);
+      return null;
+    }
+  }
+
+  static compressEntry(entry) {
+    if (!entry || typeof entry !== 'object') {
+      console.warn('[AUDIT] Invalid audit entry:', entry);
+      return null;
+    }
+
+    try {
+      return {
+        timestamp: entry.timestamp || Date.now(),
+        phase: entry.phase || 'unknown',
+        action: entry.action || 'unknown',
+        inputSummary: Utils.summarizeData(entry.input),
+        outputSummary: Utils.summarizeData(entry.output),
+        confidence: entry.confidence || 0,
+        processingTimeMs: entry.processingTimeMs || 0,
+        metadata: entry.metadata || {}
+      };
+    } catch (error) {
+      console.error('[AUDIT] Error compressing entry:', error);
+      return null;
+    }
+  }
+
+  static generateSummary(entries, avgConfidence, lowConfidenceSteps) {
+    let analysisQuality;
+    if (avgConfidence >= 85 && lowConfidenceSteps === 0) {
+      analysisQuality = 'excellent';
+    } else if (avgConfidence >= 70 && lowConfidenceSteps <= 1) {
+      analysisQuality = 'good';
+    } else if (avgConfidence >= 60 && lowConfidenceSteps <= 3) {
+      analysisQuality = 'fair';
+    } else {
+      analysisQuality = 'poor';
+    }
+
+    const keyInsights = [];
+    const embeddingsUsed = entries.some(e => e.action === 'embeddings-search');
+    if (embeddingsUsed) {
+      keyInsights.push('Semantische Suche wurde erfolgreich eingesetzt');
+    }
+
+    const toolSelectionEntries = entries.filter(e => e.action === 'ai-tool-selection');
+    if (toolSelectionEntries.length > 0) {
+      const avgSelectionConfidence = toolSelectionEntries.reduce((sum, e) => sum + e.confidence, 0) / toolSelectionEntries.length;
+      if (avgSelectionConfidence >= 80) {
+        keyInsights.push('Hohe Konfidenz bei der Tool-Auswahl');
+      }
+    }
+
+    const potentialIssues = [];
+    if (lowConfidenceSteps > 2) {
+      potentialIssues.push(`${lowConfidenceSteps} Analyseschritte mit niedriger Konfidenz`);
+    }
+
+    const longSteps = entries.filter(e => e.processingTimeMs > 5000);
+    if (longSteps.length > 0) {
+      potentialIssues.push(`${longSteps.length} Schritte benötigten mehr als 5 Sekunden`);
+    }
+
+    return { analysisQuality, keyInsights, potentialIssues };
+  }
+}
+
+// ===================================================================
+// AUDIT TRAIL RENDERER
+// ===================================================================
+
+class AuditTrailRenderer {
+  constructor(containerId, options = {}) {
+    this.containerId = containerId;
+    this.options = {
+      title: options.title || 'KI-Entscheidungspfad',
+      collapsible: options.collapsible !== false,
+      defaultExpanded: options.defaultExpanded || false,
+      ...options
+    };
+    this.componentId = `audit-trail-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`;
+  }
+
+  render(rawAuditTrail) {
+    const container = document.getElementById(this.containerId);
+    if (!container) {
+      console.error(`[AUDIT RENDERER] Container ${this.containerId} not found`);
+      return;
+    }
+
+    if (!rawAuditTrail || !Array.isArray(rawAuditTrail) || rawAuditTrail.length === 0) {
+      this.renderEmpty(container);
+      return;
+    }
+
+    try {
+      const processedAudit = AuditTrailProcessor.processAuditTrail(rawAuditTrail);
+      
+      if (processedAudit && processedAudit.phases && processedAudit.phases.length > 0) {
+        this.renderProcessed(container, processedAudit);
+        setTimeout(() => this.attachEventHandlers(), 0);
+      } else {
+        this.renderEmpty(container);
+      }
+    } catch (error) {
+      console.error('[AUDIT RENDERER] Failed to render audit trail:', error);
+      this.renderError(container, error);
+    }
+  }
+
+  renderProcessed(container, processedAudit) {
+    const detailsId = `${this.componentId}-details`;
+    
+    container.innerHTML = `
+      <div class="audit-trail-container">
+        <div class="audit-trail-header ${this.options.collapsible ? 'clickable' : ''}" 
+             ${this.options.collapsible ? `data-target="${detailsId}"` : ''}>
+          <div class="audit-trail-title">
+            <div class="audit-icon">
+              <div class="audit-icon-gradient">✓</div>
+              <h4>${this.options.title}</h4>
+            </div>
+            
+            <div class="audit-stats">
+              <div class="stat-item">
+                <div class="stat-dot stat-time"></div>
+                <span>${Utils.formatDuration(processedAudit.totalTime)}</span>
+              </div>
+              <div class="stat-item">
+                <div class="stat-dot" style="background-color: ${Utils.getConfidenceColor(processedAudit.avgConfidence)}"></div>
+                <span>${processedAudit.avgConfidence}% Vertrauen</span>
+              </div>
+              <div class="stat-item">
+                <span>${processedAudit.stepCount} Schritte</span>
+              </div>
+            </div>
+          </div>
+          
+          ${this.options.collapsible ? `
+            <div class="toggle-icon">
+              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <polyline points="6 9 12 15 18 9"/>
+              </svg>
+            </div>
+          ` : ''}
+        </div>
+        
+        <div id="${detailsId}" class="audit-trail-details ${this.options.collapsible && !this.options.defaultExpanded ? 'collapsed' : ''}">
+          ${this.renderSummary(processedAudit)}
+          ${this.renderProcessFlow(processedAudit)}
+          ${this.renderTechnicalDetails(processedAudit)}
+        </div>
+      </div>
+    `;
+  }
+
+  renderSummary(audit) {
+    return `
+      <div class="audit-summary">
+        <div class="summary-header">📊 Analyse-Qualität</div>
+        <div class="summary-grid">
+          <div class="summary-stat">
+            <div class="summary-value success">${audit.highConfidenceSteps}</div>
+            <div class="summary-label">Hohe Sicherheit</div>
+          </div>
+          <div class="summary-stat">
+            <div class="summary-value ${audit.lowConfidenceSteps > 0 ? 'warning' : 'success'}">
+              ${audit.lowConfidenceSteps}
+            </div>
+            <div class="summary-label">Unsichere Schritte</div>
+          </div>
+          <div class="summary-stat">
+            <div class="summary-value">${Utils.formatDuration(audit.totalTime)}</div>
+            <div class="summary-label">Verarbeitungszeit</div>
+          </div>
+        </div>
+        
+        ${audit.summary.keyInsights && audit.summary.keyInsights.length > 0 ? `
+          <div class="insights-section">
+            <div class="insights-header success">✓ Erkenntnisse:</div>
+            <ul class="insights-list">
+              ${audit.summary.keyInsights.map(insight => `<li>${Utils.escapeHtml(insight)}</li>`).join('')}
+            </ul>
+          </div>
+        ` : ''}
+        
+        ${audit.summary.potentialIssues && audit.summary.potentialIssues.length > 0 ? `
+          <div class="insights-section">
+            <div class="insights-header warning">⚠ Hinweise:</div>
+            <ul class="insights-list">
+              ${audit.summary.potentialIssues.map(issue => `<li>${Utils.escapeHtml(issue)}</li>`).join('')}
+            </ul>
+          </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  renderProcessFlow(audit) {
+    if (!audit.phases || audit.phases.length === 0) {
+      return '<div class="audit-process-flow"><p>Keine Phasen verfügbar</p></div>';
+    }
+
+    return `
+      <div class="audit-process-flow">
+        ${audit.phases.map((phase, index) => `
+          <div class="phase-group ${index === audit.phases.length - 1 ? 'last-phase' : ''}">
+            <div class="phase-header" style="display: flex; align-items: center; gap: 1rem; margin-bottom: 0.75rem;">
+              <div class="phase-info" style="display: flex; align-items: center; gap: 0.75rem;">
+                <span class="phase-icon" style="font-size: 1rem;">${phase.icon || '📋'}</span>
+                <span class="phase-name" style="font-size: 0.875rem; font-weight: 500; color: var(--color-text);">${phase.displayName || phase.name}</span>
+              </div>
+              <div class="phase-divider" style="flex: 1; height: 1px; background-color: var(--color-border);"></div>
+              <div class="phase-stats" style="display: flex; align-items: center; gap: 0.5rem; flex-shrink: 0;">
+                <div class="confidence-bar" style="width: 48px; height: 8px; background-color: var(--color-bg-tertiary); border-radius: 4px; overflow: hidden;">
+                  <div class="confidence-fill" 
+                      style="height: 100%; width: ${phase.avgConfidence || 0}%; background-color: ${Utils.getConfidenceColor(phase.avgConfidence || 0)}; border-radius: 4px; transition: var(--transition-fast);">
+                  </div>
+                </div>
+                <span class="confidence-text" style="font-size: 0.75rem; color: var(--color-text-secondary); min-width: 28px;">${phase.avgConfidence || 0}%</span>
+              </div>
+            </div>
+            
+            <div class="phase-entries" style="margin-left: 1.5rem; display: grid; gap: 0.5rem;">
+              ${(phase.entries || []).map(entry => this.renderAuditEntry(entry)).join('')}
+            </div>
+          </div>
+        `).join('')}
+      </div>
+    `;
+  }
+
+  renderAuditEntry(entry) {
+    return `
+      <div class="audit-entry" style="background-color: var(--color-bg); border: 1px solid var(--color-border); border-radius: 0.375rem; padding: 0.75rem; transition: var(--transition-fast);" 
+           onmouseover="this.style.backgroundColor='var(--color-bg-secondary)'" 
+           onmouseout="this.style.backgroundColor='var(--color-bg)'">
+        <div class="entry-main" style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 0.5rem;">
+          <span class="entry-action" style="font-size: 0.875rem; font-weight: 500; color: var(--color-text);">
+            ${Utils.getActionDisplayName(entry.action)}
+          </span>
+          <div class="entry-meta" style="display: flex; align-items: center; gap: 0.5rem; font-size: 0.75rem; color: var(--color-text-secondary);">
+            <div class="confidence-indicator" 
+                style="width: 8px; height: 8px; border-radius: 50%; background-color: ${Utils.getConfidenceColor(entry.confidence || 0)};">
+            </div>
+            <span class="confidence-value" style="min-width: 28px; text-align: right;">${entry.confidence || 0}%</span>
+            <span class="processing-time" style="min-width: 40px; text-align: right;">${entry.processingTimeMs || 0}ms</span>
+          </div>
+        </div>
+        
+        ${(entry.inputSummary && entry.inputSummary !== 'null') || (entry.outputSummary && entry.outputSummary !== 'null') ? `
+          <div class="entry-details" style="font-size: 0.75rem; color: var(--color-text-secondary); padding-top: 0.5rem; border-top: 1px solid var(--color-border);">
+            ${entry.inputSummary && entry.inputSummary !== 'null' ? `
+              <div class="detail-item" style="margin-bottom: 0.25rem; word-break: break-word;">
+                <strong>Input:</strong> ${Utils.escapeHtml(entry.inputSummary)}
+              </div>
+            ` : ''}
+            ${entry.outputSummary && entry.outputSummary !== 'null' ? `
+              <div class="detail-item" style="margin-bottom: 0.25rem; word-break: break-word;">
+                <strong>Output:</strong> ${Utils.escapeHtml(entry.outputSummary)}
+              </div>
+            ` : ''}
+          </div>
+        ` : ''}
+      </div>
+    `;
+  }
+
+  renderTechnicalDetails(audit) {
+    const technicalId = `${this.componentId}-technical`;
+    
+    return `
+      <div class="technical-toggle">
+        <button class="technical-toggle-btn" data-target="${technicalId}">
+          🔧 Technische Details anzeigen
+        </button>
+        <div id="${technicalId}" class="technical-details collapsed">
+          ${(audit.phases || []).map(phase => 
+            (phase.entries || []).map(entry => `
+              <div class="technical-entry">
+                <div class="technical-header">
+                  <span class="technical-phase">${entry.phase}/${entry.action}</span>
+                  <span class="technical-time">
+                    ${new Date(entry.timestamp).toLocaleTimeString('de-DE', { 
+                      hour: '2-digit', 
+                      minute: '2-digit', 
+                      second: '2-digit' 
+                    })} • ${entry.processingTimeMs || 0}ms
+                  </span>
+                </div>
+                <div class="technical-content">
+                  <div class="technical-row">
+                    <strong>Confidence:</strong> ${entry.confidence || 0}%
+                  </div>
+                  ${entry.metadata && Object.keys(entry.metadata).length > 0 ? `
+                    <div class="technical-row">
+                      <strong>Metadata:</strong> ${Utils.escapeHtml(JSON.stringify(entry.metadata))}
+                    </div>
+                  ` : ''}
+                </div>
+              </div>
+            `).join('')
+          ).join('')}
+        </div>
+      </div>
+    `;
+  }
+
+  renderEmpty(container) {
+    container.innerHTML = `
+      <div class="audit-trail-container">
+        <div class="audit-trail-header">
+          <div class="audit-trail-title">
+            <div class="audit-icon">
+              <div class="audit-icon-gradient">ⓘ</div>
+              <h4>Kein Audit-Trail verfügbar</h4>
+            </div>
+          </div>
+        </div>
+      </div>
+    `;
+  }
+
+  renderError(container, error) {
+    container.innerHTML = `
+      <div class="audit-trail-container">
+        <div class="audit-trail-header">
+          <div class="audit-trail-title">
+            <div class="audit-icon">
+              <div class="audit-icon-gradient" style="background: var(--color-error);">✗</div>
+              <h4>Audit-Trail Fehler</h4>
+            </div>
+          </div>
+        </div>
+        <div class="audit-summary">
+          <p style="color: var(--color-error);">
+            Fehler beim Laden der Audit-Informationen: ${Utils.escapeHtml(error.message)}
+          </p>
+        </div>
+      </div>
+    `;
+  }
+
+  attachEventHandlers() {
+    // Handle collapsible header
+    if (this.options.collapsible) {
+      const header = document.querySelector(`[data-target="${this.componentId}-details"]`);
+      const details = document.getElementById(`${this.componentId}-details`);
+      const toggleIcon = header?.querySelector('.toggle-icon svg');
+      
+      if (header && details && toggleIcon) {
+        header.addEventListener('click', () => {
+          const isCollapsed = details.classList.contains('collapsed');
+          details.classList.toggle('collapsed');
+          toggleIcon.style.transform = isCollapsed ? 'rotate(180deg)' : 'rotate(0deg)';
+        });
+      }
+    }
+    
+    // Handle technical details toggle
+    const technicalBtn = document.querySelector(`[data-target="${this.componentId}-technical"]`);
+    const technicalDetails = document.getElementById(`${this.componentId}-technical`);
+    
+    if (technicalBtn && technicalDetails) {
+      technicalBtn.addEventListener('click', () => {
+        const isCollapsed = technicalDetails.classList.contains('collapsed');
+        technicalDetails.classList.toggle('collapsed');
+        technicalBtn.textContent = isCollapsed ? 
+          '🔧 Technische Details ausblenden' : 
+          '🔧 Technische Details anzeigen';
+      });
+    }
+  }
+}
+
+// ===================================================================
+// MAIN AI QUERY INTERFACE
+// ===================================================================
 
 class AIQueryInterface {
   constructor() {
     this.currentMode = 'workflow';
     this.currentRecommendation = null;
-    this.auditTrailRenderer = null;
     this.enhancementTimeout = null;
     this.enhancementAbortController = null;
     this.statusInterval = null;
@@ -273,11 +826,7 @@ class AIQueryInterface {
       microTaskCounter: document.getElementById('micro-task-counter')
     };
 
-    if (!this.elements.input || !this.elements.submitBtn || !this.elements.results) {
-      console.error('[AI Interface] Critical elements not found');
-      return false;
-    }
-    return true;
+    return Object.values(this.elements).some(el => el !== null);
   }
 
   setupEventListeners() {
@@ -294,7 +843,6 @@ class AIQueryInterface {
     });
 
     this.elements.submitBtn?.addEventListener('click', () => this.handleSubmit());
-
     this.elements.dismissSuggestions?.addEventListener('click', () => this.hideSmartPrompting());
   }
 
@@ -336,28 +884,24 @@ class AIQueryInterface {
     if (this.elements.submitBtnText) this.elements.submitBtnText.textContent = config.submitText;
     if (this.elements.loadingText) this.elements.loadingText.textContent = config.loadingText;
     
-    if (this.currentMode === 'workflow') {
-      if (this.elements.toggleSlider) this.elements.toggleSlider.style.transform = 'translateX(0)';
-      if (this.elements.toggleSwitch) this.elements.toggleSwitch.style.backgroundColor = 'var(--color-primary)';
-      if (this.elements.workflowLabel) {
-        this.elements.workflowLabel.style.color = 'var(--color-primary)';
-        this.elements.workflowLabel.classList.add('active');
-      }
-      if (this.elements.toolLabel) {
-        this.elements.toolLabel.style.color = 'var(--color-text-secondary)';
-        this.elements.toolLabel.classList.remove('active');
-      }
-    } else {
-      if (this.elements.toggleSlider) this.elements.toggleSlider.style.transform = 'translateX(26px)';
-      if (this.elements.toggleSwitch) this.elements.toggleSwitch.style.backgroundColor = 'var(--color-accent)';
-      if (this.elements.toolLabel) {
-        this.elements.toolLabel.style.color = 'var(--color-accent)';
-        this.elements.toolLabel.classList.add('active');
-      }
-      if (this.elements.workflowLabel) {
-        this.elements.workflowLabel.style.color = 'var(--color-text-secondary)';
-        this.elements.workflowLabel.classList.remove('active');
-      }
+    const isWorkflow = this.currentMode === 'workflow';
+    const primaryColor = isWorkflow ? 'var(--color-primary)' : 'var(--color-accent)';
+    const secondaryColor = 'var(--color-text-secondary)';
+    
+    if (this.elements.toggleSlider) {
+      this.elements.toggleSlider.style.transform = isWorkflow ? 'translateX(0)' : 'translateX(26px)';
+    }
+    if (this.elements.toggleSwitch) {
+      this.elements.toggleSwitch.style.backgroundColor = primaryColor;
+    }
+    
+    if (this.elements.workflowLabel) {
+      this.elements.workflowLabel.style.color = isWorkflow ? primaryColor : secondaryColor;
+      this.elements.workflowLabel.classList.toggle('active', isWorkflow);
+    }
+    if (this.elements.toolLabel) {
+      this.elements.toolLabel.style.color = isWorkflow ? secondaryColor : primaryColor;
+      this.elements.toolLabel.classList.toggle('active', !isWorkflow);
     }
   }
 
@@ -441,44 +985,65 @@ class AIQueryInterface {
     const statusText = this.elements.promptingStatus.querySelector('.status-text');
     if (!statusText) return;
     
-    switch (state) {
-      case 'analyzing':
-        this.showElement(this.elements.promptingContainer);
-        this.hideElement(this.elements.smartHint);
-        statusText.textContent = 'Analysiere Eingabe...';
-        this.showElement(this.elements.promptingSpinner);
-        this.hideElement(this.elements.suggestedQuestions);
-        break;
-      case 'suggestions':
-        statusText.textContent = 'Verbesserungsvorschläge verfügbar';
-        this.hideElement(this.elements.promptingSpinner);
-        this.showElement(this.elements.suggestedQuestions);
-        break;
-      case 'rate-limited':
-        statusText.textContent = 'Nach Hauptabfrage verfügbar';
-        this.hideElement(this.elements.promptingSpinner);
-        this.hideElement(this.elements.suggestedQuestions);
-        break;
-      case 'error':
-      case 'hidden':
-        this.hideSmartPrompting();
-        break;
-    }
+    const statusMap = {
+      analyzing: {
+        text: 'Analysiere Eingabe...',
+        showSpinner: true,
+        showSuggestions: false,
+        showContainer: true,
+        hideHint: true
+      },
+      suggestions: {
+        text: 'Verbesserungsvorschläge verfügbar',
+        showSpinner: false,
+        showSuggestions: true,
+        showContainer: true,
+        hideHint: true
+      },
+      'rate-limited': {
+        text: 'Nach Hauptabfrage verfügbar',
+        showSpinner: false,
+        showSuggestions: false,
+        showContainer: true,
+        hideHint: true
+      },
+      error: {
+        showContainer: false,
+        hideHint: false
+      }
+    };
+
+    const config = statusMap[state];
+    if (!config) return;
+
+    statusText.textContent = config.text || '';
+    
+    if (config.showContainer) Utils.showElement(this.elements.promptingContainer);
+    else Utils.hideElement(this.elements.promptingContainer);
+    
+    if (config.hideHint) Utils.hideElement(this.elements.smartHint);
+    else Utils.showElement(this.elements.smartHint);
+    
+    if (config.showSpinner) Utils.showElement(this.elements.promptingSpinner);
+    else Utils.hideElement(this.elements.promptingSpinner);
+    
+    if (config.showSuggestions) Utils.showElement(this.elements.suggestedQuestions);
+    else Utils.hideElement(this.elements.suggestedQuestions);
   }
 
   displaySuggestions(suggestions) {
     if (!this.elements.questionsList || !suggestions?.length) return;
     
     this.elements.questionsList.innerHTML = suggestions.map(question => 
-      `<div class="suggestion-item">${this.escapeHtml(question)}</div>`
+      `<div class="suggestion-item">${Utils.escapeHtml(question)}</div>`
     ).join('');
     
     this.showPromptingStatus('suggestions');
   }
 
   hideSmartPrompting() {
-    if (this.elements.promptingContainer) this.hideElement(this.elements.promptingContainer);
-    if (this.elements.smartHint) this.showElement(this.elements.smartHint);
+    if (this.elements.promptingContainer) Utils.hideElement(this.elements.promptingContainer);
+    if (this.elements.smartHint) Utils.showElement(this.elements.smartHint);
   }
 
   async handleSubmit() {
@@ -541,15 +1106,17 @@ class AIQueryInterface {
   }
 
   getErrorMessage(error) {
-    if (error.message.includes('429')) {
-      return 'Zu viele Anfragen. Bitte warten Sie einen Moment.';
-    } else if (error.message.includes('401')) {
-      return 'Authentifizierung erforderlich. Bitte melden Sie sich an.';
-    } else if (error.message.includes('503')) {
-      return 'KI-Service vorübergehend nicht verfügbar.';
-    } else {
-      return `Fehler: ${error.message}`;
+    const errorMap = {
+      '429': 'Zu viele Anfragen. Bitte warten Sie einen Moment.',
+      '401': 'Authentifizierung erforderlich. Bitte melden Sie sich an.',
+      '503': 'KI-Service vorübergehend nicht verfügbar.'
+    };
+    
+    for (const [code, message] of Object.entries(errorMap)) {
+      if (error.message.includes(code)) return message;
     }
+    
+    return `Fehler: ${error.message}`;
   }
 
   resetSubmitButton() {
@@ -561,10 +1128,7 @@ class AIQueryInterface {
   }
 
   startQueueMonitoring(taskId) {
-    if (this.elements.queueStatus) {
-      this.showElement(this.elements.queueStatus);
-    }
-    
+    if (this.elements.queueStatus) Utils.showElement(this.elements.queueStatus);
     if (this.elements.taskIdDisplay) {
       this.elements.taskIdDisplay.textContent = taskId.slice(-8);
     }
@@ -587,7 +1151,7 @@ class AIQueryInterface {
       if (this.elements.queueLength) this.elements.queueLength.textContent = data.queueLength || 0;
       if (this.elements.estimatedTime) {
         this.elements.estimatedTime.textContent = data.estimatedWaitTime > 0 ? 
-          this.formatDuration(data.estimatedWaitTime) : 'Verarbeitung läuft...';
+          Utils.formatDuration(data.estimatedWaitTime) : 'Verarbeitung läuft...';
       }
       
       if (this.elements.positionBadge) {
@@ -598,11 +1162,7 @@ class AIQueryInterface {
             this.elements.progressBar.style.width = `${progress}%`;
           }
         } else {
-          const stateIcons = {
-            processing: '⚡',
-            completed: '✅', 
-            failed: '❌'
-          };
+          const stateIcons = { processing: '⚡', completed: '✅', failed: '❌' };
           this.elements.positionBadge.textContent = stateIcons[data.taskStatus] || '?';
           if (this.elements.progressBar) {
             this.elements.progressBar.style.width = data.taskStatus === 'processing' ? '100%' : '0%';
@@ -626,14 +1186,14 @@ class AIQueryInterface {
       this.microTaskInterval = null;
     }
     
-    if (this.elements.queueStatus) this.hideElement(this.elements.queueStatus);
-    if (this.elements.microTaskProgress) this.hideElement(this.elements.microTaskProgress);
+    if (this.elements.queueStatus) Utils.hideElement(this.elements.queueStatus);
+    if (this.elements.microTaskProgress) Utils.hideElement(this.elements.microTaskProgress);
   }
 
   startMicroTaskProgress() {
     if (!this.elements.microTaskProgress) return;
     
-    this.showElement(this.elements.microTaskProgress);
+    Utils.showElement(this.elements.microTaskProgress);
     this.currentMicroTaskStep = 0;
     
     const steps = ['scenario', 'approach', 'considerations', 'tools', 'knowledge', 'final'];
@@ -681,8 +1241,7 @@ class AIQueryInterface {
   }
 
   async displayResults(recommendation, originalQuery) {
-    console.log('[AI DEBUG] Full recommendation object:', recommendation);
-    console.log('[AI DEBUG] Audit trail data:', recommendation.auditTrail);
+    console.log('[AI Interface] Displaying results for mode:', this.currentMode);
     
     if (this.currentMode === 'workflow') {
       await this.displayWorkflowResults(recommendation, originalQuery);
@@ -690,16 +1249,14 @@ class AIQueryInterface {
       await this.displayToolResults(recommendation, originalQuery);
     }
     
-    // Show results first, then render audit trail
     this.showResults();
     
     // Render audit trail after DOM is ready
-    setTimeout(async () => {
+    setTimeout(() => {
       try {
-        await this.renderAuditTrail(recommendation.auditTrail);
-        console.log('[AI DEBUG] Audit trail rendered successfully');
+        this.renderAuditTrail(recommendation.auditTrail);
       } catch (error) {
-        console.error('[AI DEBUG] Failed to render audit trail:', error);
+        console.error('[AI Interface] Failed to render audit trail:', error);
       }
     }, 100);
   }
@@ -716,12 +1273,7 @@ class AIQueryInterface {
       toolsByPhase[phase] = [];
     });
 
-    console.log('[AI Results] Recommendation structure:', recommendation);
-    console.log('[AI Results] Recommended tools:', recommendation.recommended_tools);
-
     recommendation.recommended_tools?.forEach(recTool => {
-      console.log('[AI Results] Tool confidence data:', recTool.name, recTool.confidence);
-      
       if (toolsByPhase[recTool.phase]) {
         const fullTool = tools.find(t => t.name === recTool.name);
         if (fullTool) {
@@ -730,8 +1282,7 @@ class AIQueryInterface {
             recommendation: recTool,
             confidence: recTool.confidence, 
             justification: recTool.justification,
-            priority: recTool.priority,
-            recommendationStrength: recTool.recommendationStrength
+            priority: recTool.priority
           });
         }
       }
@@ -745,12 +1296,10 @@ class AIQueryInterface {
         ${this.renderWorkflowPhases(toolsByPhase, phaseOrder, phaseNames)}
         ${this.renderWorkflowSuggestion(recommendation.workflow_suggestion)}
       </div>
-        
       <div id="audit-trail-container"></div>
     `;
     
     this.elements.results.innerHTML = html;
-    await this.renderAuditTrail(recommendation.auditTrail);
   }
 
   async displayToolResults(recommendation, originalQuery) {
@@ -766,266 +1315,41 @@ class AIQueryInterface {
     `;
     
     this.elements.results.innerHTML = html;
-    await this.renderAuditTrail(recommendation.auditTrail);
   }
 
-  renderConfidenceTooltip(confidence) {
-    if (!confidence || typeof confidence.overall !== 'number') {
-      return '';
-    }
-    
-    const confidenceColor = confidence.overall >= 80 ? 'var(--color-accent)' : 
-                          confidence.overall >= 60 ? 'var(--color-warning)' : 'var(--color-error)';
-    
-    const tooltipId = `tooltip-${Math.random().toString(36).substr(2, 9)}`;
-    
-    return `
-      <span class="confidence-tooltip-trigger" 
-            style="display: inline-flex; align-items: center; gap: 0.125rem; cursor: help; margin-left: 0.25rem;"
-            onmouseenter="document.getElementById('${tooltipId}').style.display = 'block'"
-            onmouseleave="document.getElementById('${tooltipId}').style.display = 'none'"
-            onclick="event.stopPropagation();">
-        <div style="width: 6px; height: 6px; border-radius: 50%; background-color: ${confidenceColor}; flex-shrink: 0;"></div>
-        <span style="font-size: 0.625rem; color: white; font-weight: 600; text-shadow: 0 1px 2px rgba(0,0,0,0.5);">${confidence.overall}%</span>
-        
-        <div id="${tooltipId}" style="display: none; position: fixed; top: 50%; left: 50%; transform: translate(-50%, -50%); z-index: 1001; background: var(--color-bg); border: 1px solid var(--color-border); border-radius: 0.5rem; padding: 1rem; min-width: 320px; max-width: 400px; box-shadow: var(--shadow-lg); font-size: 0.75rem; color: var(--color-text);">
-          <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.75rem;">
-            <strong style="font-size: 0.875rem;">KI-Vertrauenswertung</strong>
-            <span class="badge badge-mini" style="background-color: ${confidenceColor}; color: white; font-weight: 600;">${confidence.overall}%</span>
-          </div>
-          
-          <div style="display: grid; grid-template-columns: 1fr; gap: 0.625rem; margin-bottom: 0.75rem;">
-            <div style="background: var(--color-bg-secondary); padding: 0.5rem; border-radius: 0.375rem; border-left: 3px solid var(--color-accent);">
-              <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.25rem;">
-                <span style="font-weight: 600; font-size: 0.6875rem;">🔍 Semantische Relevanz</span>
-                <strong style="color: var(--color-accent);">${confidence.semanticRelevance}%</strong>
-              </div>
-              <div style="font-size: 0.625rem; color: var(--color-text-secondary); line-height: 1.3;">
-                Wie gut die Tool-Beschreibung semantisch zu Ihrer Anfrage passt (Vektor-Ähnlichkeit)
-              </div>
-            </div>
-            
-            <div style="background: var(--color-bg-secondary); padding: 0.5rem; border-radius: 0.375rem; border-left: 3px solid var(--color-primary);">
-              <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.25rem;">
-                <span style="font-weight: 600; font-size: 0.6875rem;">🎯 Aufgaben-Eignung</span>
-                <strong style="color: var(--color-primary);">${confidence.taskSuitability}%</strong>
-              </div>
-              <div style="font-size: 0.625rem; color: var(--color-text-secondary); line-height: 1.3;">
-                KI-bewertete Eignung des Tools für Ihre spezifische forensische Aufgabenstellung
-              </div>
-            </div>
-          </div>
-          
-          ${confidence.strengthIndicators && confidence.strengthIndicators.length > 0 ? `
-            <div style="margin-bottom: 0.75rem; padding: 0.5rem; background: var(--color-oss-bg); border-radius: 0.375rem; border-left: 3px solid var(--color-accent);">
-              <strong style="color: var(--color-accent); font-size: 0.6875rem; display: flex; align-items: center; gap: 0.25rem; margin-bottom: 0.375rem;">
-                <span>✓</span> Stärken dieser Empfehlung:
-              </strong>
-              <ul style="margin: 0; padding-left: 1rem; font-size: 0.625rem; line-height: 1.4;">
-                ${confidence.strengthIndicators.slice(0, 3).map(s => `<li style="margin-bottom: 0.25rem;">${this.sanitizeText(s)}</li>`).join('')}
-              </ul>
-            </div>
-          ` : ''}
-          
-          ${confidence.uncertaintyFactors && confidence.uncertaintyFactors.length > 0 ? `
-            <div style="padding: 0.5rem; background: var(--color-hosted-bg); border-radius: 0.375rem; border-left: 3px solid var(--color-warning);">
-              <strong style="color: var(--color-warning); font-size: 0.6875rem; display: flex; align-items: center; gap: 0.25rem; margin-bottom: 0.375rem;">
-                <span>⚠</span> Mögliche Einschränkungen:
-              </strong>
-              <ul style="margin: 0; padding-left: 1rem; font-size: 0.625rem; line-height: 1.4;">
-                ${confidence.uncertaintyFactors.slice(0, 3).map(f => `<li style="margin-bottom: 0.25rem;">${this.sanitizeText(f)}</li>`).join('')}
-              </ul>
-            </div>
-          ` : ''}
-          
-          <div style="margin-top: 0.75rem; padding-top: 0.75rem; border-top: 1px solid var(--color-border); font-size: 0.625rem; color: var(--color-text-secondary); text-align: center;">
-            Forensisch fundierte KI-Analyse
-          </div>
-        </div>
-      </span>
-    `;
-  }
-
-  async renderAuditTrail(rawAuditTrail) {
-    console.log('[AI Interface] Starting audit trail render...', rawAuditTrail?.length || 0, 'entries');
-    
+  renderAuditTrail(rawAuditTrail) {
     const container = document.getElementById('audit-trail-container');
     if (!container) {
       console.error('[AI Interface] Audit container not found');
       return;
     }
 
-    // Clear previous content
     container.innerHTML = '';
 
-    // Check if we have audit data
     if (!rawAuditTrail || !Array.isArray(rawAuditTrail) || rawAuditTrail.length === 0) {
       console.log('[AI Interface] No audit trail data to render');
-      container.innerHTML = `
-        <div class="audit-trail-container">
-          <div class="audit-trail-header">
-            <div class="audit-icon">
-              <div class="audit-icon-gradient">ⓘ</div>
-              <h4>Kein Audit-Trail verfügbar</h4>
-            </div>
-          </div>
-        </div>
-      `;
       return;
     }
 
     try {
-      // Import and create renderer
-      //const { AuditTrailRenderer } = await import('../js/auditTrailRenderer.js');
-      
       const renderer = new AuditTrailRenderer('audit-trail-container', {
         title: 'KI-Entscheidungspfad',
         collapsible: true,
         defaultExpanded: false
       });
       
-      // Render synchronously (the method handles async internally)
       renderer.render(rawAuditTrail);
-      
-      console.log('[AI Interface] Audit trail render completed');
-      
     } catch (error) {
       console.error('[AI Interface] Failed to render audit trail:', error);
-      
-      container.innerHTML = `
-        <div class="audit-trail-container">
-          <div class="audit-trail-header">
-            <div class="audit-icon">
-              <div class="audit-icon-gradient" style="background: var(--color-error);">✗</div>
-              <h4>Audit-Trail Fehler</h4>
-            </div>
-          </div>
-          <div class="audit-summary">
-            <p style="color: var(--color-error);">
-              Fehler beim Laden der Audit-Informationen: ${error.message}
-            </p>
-          </div>
-        </div>
-      `;
     }
   }
 
-  renderAuditEntry(entry) {
-    const confidenceColor = entry.confidence >= 80 ? 'var(--color-accent)' : 
-                            entry.confidence >= 60 ? 'var(--color-warning)' : 'var(--color-error)';
-    
-    const formattedTime = new Date(entry.timestamp).toLocaleTimeString('de-DE', { 
-      hour: '2-digit', 
-      minute: '2-digit', 
-      second: '2-digit' 
-    });
-    
-    return `
-      <div class="border-l-2 pl-3 py-2 mb-2" style="border-left-color: ${confidenceColor};">
-        <div class="flex justify-between items-center mb-1">
-          <span class="text-xs font-medium">${entry.phase} → ${entry.action}</span>
-          <div class="flex items-center gap-2">
-            <span class="badge badge-mini" style="background-color: ${confidenceColor}; color: white;">
-              ${entry.confidence}% confidence
-            </span>
-            <span class="text-xs text-muted">${entry.processingTimeMs}ms</span>
-            <span class="text-xs text-muted">${formattedTime}</span>
-          </div>
-        </div>
-        <div class="text-xs text-muted grid-cols-2 gap-2" style="display: grid;">
-          <div><strong>Input:</strong> ${this.formatAuditData(entry.input)}</div>
-          <div><strong>Output:</strong> ${this.formatAuditData(entry.output)}</div>
-        </div>
-        ${entry.metadata && Object.keys(entry.metadata).length > 0 ? `
-          <div class="text-xs text-muted mt-1 pt-1 border-t border-dashed">
-            <strong>Metadata:</strong> ${this.formatAuditData(entry.metadata)}
-          </div>
-        ` : ''}
-      </div>
-    `;
-  }
-
-  renderWorkflowTool(tool) {
-    const hasValidProjectUrl = isToolHosted(tool);
-    const priorityColors = {
-      high: 'var(--color-error)',
-      medium: 'var(--color-warning)', 
-      low: 'var(--color-accent)'
-    };
-
-    return `
-      <div class="tool-recommendation ${this.getToolClass(tool, 'recommendation')}" onclick="window.showToolDetails('${tool.name}')" style="position: relative;">
-        <div class="tool-rec-header">
-          <h4 class="tool-rec-name">
-            ${tool.icon ? `<span style="margin-right: 0.5rem;">${tool.icon}</span>` : ''}
-            ${tool.name}
-          </h4>
-          <div class="flex items-center gap-2">
-            <span class="tool-rec-priority ${tool.recommendation ? tool.recommendation.priority : tool.priority}" 
-                  style="background-color: ${priorityColors[tool.recommendation ? tool.recommendation.priority : tool.priority]}; color: white; padding: 0.25rem 0.5rem; border-radius: 1rem; font-size: 0.75rem; position: relative;">
-              ${tool.recommendation ? tool.recommendation.priority : tool.priority}
-              ${tool.confidence ? this.renderConfidenceTooltip(tool.confidence, 'priority') : ''}
-            </span>
-          </div>
-        </div>
-        
-        <div class="tool-rec-justification" style="background-color: var(--color-bg-tertiary); padding: 0.75rem; border-radius: 0.375rem; border-left: 3px solid var(--color-primary); margin: 0.75rem 0; font-style: italic; white-space: pre-wrap; word-wrap: break-word;">
-          "${this.sanitizeText(tool.justification || (tool.recommendation && tool.recommendation.justification) || `Empfohlen für ${tool.phase}`)}"
-        </div>
-        
-        <div style="font-size: 0.75rem; color: var(--color-text-secondary);">
-          ${this.renderToolBadges(tool)}
-          <div style="margin-top: 0.5rem;">
-            ${tool.type === 'method' ? 'Methode' : tool.platforms.join(', ') + ' • ' + tool.license}
-          </div>
-        </div>
-      </div>
-    `;
-  }
-
-  renderDetailedTool(tool, recommendation, rank) {
-    const rankColors = { 1: 'var(--color-accent)', 2: 'var(--color-primary)', 3: 'var(--color-warning)' };
-    const suitabilityColors = { high: 'var(--color-accent)', medium: 'var(--color-warning)', low: 'var(--color-text-secondary)' };
-    
-    return `
-      <div class="card ${this.getToolClass(tool, 'card')}" style="cursor: pointer; position: relative;" onclick="window.showToolDetails('${tool.name}')">
-        <div style="position: absolute; top: -8px; right: -8px; width: 32px; height: 32px; background-color: ${rankColors[rank]}; color: white; border-radius: 50%; display: flex; align-items: center; justify-content: center; font-weight: bold; font-size: 1.125rem;">
-          ${rank}
-        </div>
-
-        <div style="margin-bottom: 1rem;">
-          <h3 style="margin: 0 0 0.5rem 0;">${tool.name}</h3>
-          <div style="display: flex; flex-wrap: wrap; gap: 0.5rem; align-items: center; margin-bottom: 0.75rem;">
-            <span class="badge" style="background-color: ${suitabilityColors[recommendation.suitability_score]}; color: white; position: relative;">
-              ${this.getSuitabilityText(recommendation.suitability_score, recommendation.confidence)}
-            </span>
-            ${this.renderToolBadges(tool)}
-          </div>
-        </div>
-
-        <div style="margin-bottom: 1.5rem;">
-          <h4 style="margin: 0.8rem 0 0.75rem 0; color: var(--color-accent);">Warum diese Methode?</h4>
-          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.detailed_explanation)}</div>
-          
-          ${recommendation.implementation_approach ? `
-            <h4 style="margin: 0.8rem 0 0.75rem 0; color: var(--color-primary);">Anwendungsansatz</h4>
-            <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.implementation_approach)}</div>
-          ` : ''}
-        </div>
-
-        ${this.renderProsAndCons(recommendation.pros, recommendation.cons)}
-        ${this.renderToolMetadata(tool)}
-        ${recommendation.alternatives ? this.renderAlternatives(recommendation.alternatives) : ''}
-      </div>
-    `;
-  }
-
   renderHeader(title, query) {
     return `
       <div style="text-align: center; margin-bottom: 2rem; padding: 1.5rem; background: linear-gradient(135deg, var(--color-primary) 0%, #525252 100%); color: white; border-radius: 0.75rem;">
         <h3 style="margin: 0 0 0.75rem 0; font-size: 1.5rem;">${title}</h3>
         <p style="margin: 0; opacity: 0.9; line-height: 1.5;">
-          Basierend auf Ihrer Anfrage: "<em>${this.truncateText(query, 100)}</em>"
+          Basierend auf Ihrer Anfrage: "<em>${Utils.truncateText(query, 100)}</em>"
         </p>
       </div>
     `;
@@ -1041,7 +1365,7 @@ class AIQueryInterface {
           <h4 style="margin: 0 0 1rem 0; color: var(--color-primary);">
             ${mode === 'workflow' ? 'Szenario-Analyse' : 'Problem-Analyse'}
           </h4>
-          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(analysisField)}</div>
+          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(analysisField)}</div>
         </div>
       `;
     }
@@ -1052,7 +1376,7 @@ class AIQueryInterface {
           <h4 style="margin: 0 0 1rem 0; color: var(--color-accent);">
             ${mode === 'workflow' ? 'Untersuchungsansatz' : 'Lösungsansatz'}
           </h4>
-          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.investigation_approach)}</div>
+          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(recommendation.investigation_approach)}</div>
         </div>
       `;
     }
@@ -1063,7 +1387,7 @@ class AIQueryInterface {
           <h4 style="margin: 0 0 1rem 0; color: var(--color-warning);">
             ${mode === 'workflow' ? 'Kritische Überlegungen' : 'Wichtige Voraussetzungen'}
           </h4>
-          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.critical_considerations)}</div>
+          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(recommendation.critical_considerations)}</div>
         </div>
       `;
     }
@@ -1084,7 +1408,7 @@ class AIQueryInterface {
           <span class="badge" style="background-color: var(--color-concept); color: white; font-size: 0.625rem;">Hintergrundwissen</span>
         </div>
         <div style="margin: 0; font-size: 0.8125rem; line-height: 1.5; color: var(--color-text-secondary); white-space: pre-wrap; word-wrap: break-word;">
-          ${this.sanitizeText(concept.relevance)}
+          ${Utils.sanitizeText(concept.relevance)}
         </div>
       </div>
     `).join('');
@@ -1098,36 +1422,56 @@ class AIQueryInterface {
   }
 
   renderWorkflowPhases(toolsByPhase, phaseOrder, phaseNames) {
+    const phaseColors = [
+      'var(--color-primary)', 
+      'var(--color-accent)', 
+      'var(--color-warning)',
+      'var(--color-method)',
+      'var(--color-hosted)',
+      'var(--color-concept)'
+    ];
+
     return phaseOrder.map((phase, index) => {
       const phaseTools = toolsByPhase[phase];
       if (phaseTools.length === 0) return '';
 
-      console.log(`[AI DEBUG] Phase ${phase} tools:`, phaseTools.map(t => ({name: t.name, hasConfidence: !!t.confidence})));
+      const phaseColor = phaseColors[index % phaseColors.length];
 
       return `
-        <div class="workflow-phase">
-          <div class="phase-header">
-            <div class="phase-number">${index + 1}</div>
-            <div class="phase-info">
-              <h3 class="phase-title">${phaseNames[phase]}</h3>
-              <div class="phase-tools">
-                ${phaseTools.map(tool => {
-                  console.log(`[AI DEBUG] Rendering tool ${tool.name} with confidence:`, tool.confidence);
-                  return this.renderWorkflowTool(tool);
-                }).join('')}
+        <div class="workflow-phase" style="margin-bottom: 2rem;">
+          <div class="phase-header" style="display: flex; align-items: flex-start; gap: 1rem; padding: 1.5rem; background-color: var(--color-bg); border: 2px solid var(--color-border); border-radius: 0.75rem; transition: var(--transition-medium);" 
+               onmouseover="this.style.borderColor='${phaseColor}'; this.style.boxShadow='var(--shadow-md)';"
+               onmouseout="this.style.borderColor='var(--color-border)'; this.style.boxShadow='';">
+            
+            <div class="phase-number" style="width: 2rem; height: 2rem; background: ${phaseColor}; color: white; border-radius: 50%; display: flex; align-items: center; justify-content: center; font-weight: 600; flex-shrink: 0; box-shadow: var(--shadow-sm);">
+              ${index + 1}
+            </div>
+            
+            <div class="phase-info" style="display: flex; flex-direction: column; gap: 0.75rem; flex: 1; min-width: 0;">
+              <h3 class="phase-title" style="font-weight: 600; margin: 0; color: var(--color-text); font-size: 1.25rem;">
+                ${phaseNames[phase]}
+              </h3>
+              
+              <div class="phase-tools" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 1rem;">
+                ${phaseTools.map(tool => this.renderWorkflowTool(tool)).join('')}
               </div>
             </div>
           </div>
-          ${index < phaseOrder.length - 1 ? '<div class="workflow-arrow">↓</div>' : ''}
+          
+          ${index < phaseOrder.length - 1 ? `
+            <div class="workflow-arrow" style="display: flex; justify-content: center; margin: 1rem 0; color: ${phaseColor};">
+              <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <line x1="12" y1="5" x2="12" y2="19"/>
+                <polyline points="19 12 12 19 5 12"/>
+              </svg>
+            </div>
+          ` : ''}
         </div>
       `;
     }).join('');
   }
 
   renderWorkflowTool(tool) {
-    console.log(`[AI DEBUG] renderWorkflowTool called for ${tool.name}, confidence:`, tool.confidence);
-    
-    const hasValidProjectUrl = isToolHosted(tool);
     const priorityColors = {
       high: 'var(--color-error)',
       medium: 'var(--color-warning)', 
@@ -1137,32 +1481,39 @@ class AIQueryInterface {
     const priority = tool.recommendation ? tool.recommendation.priority : tool.priority;
     const confidenceTooltip = tool.confidence ? this.renderConfidenceTooltip(tool.confidence) : '';
     
-    console.log(`[AI DEBUG] Priority: ${priority}, Confidence tooltip:`, confidenceTooltip ? 'generated' : 'empty');
-
+    const cardClass = this.getToolClass(tool, 'recommendation');
+    
     return `
-      <div class="tool-recommendation ${this.getToolClass(tool, 'recommendation')}" onclick="window.showToolDetails('${tool.name}')" style="position: relative;">
-        <div class="tool-rec-header">
-          <h4 class="tool-rec-name">
-            ${tool.icon ? `<span style="margin-right: 0.5rem;">${tool.icon}</span>` : ''}
+      <div class="tool-recommendation ${cardClass}" onclick="window.showToolDetails('${tool.name}')" 
+           style="position: relative; cursor: pointer; transition: var(--transition-fast);"
+           onmouseover="this.style.transform='translateY(-2px)'; this.style.boxShadow='var(--shadow-md)';"
+           onmouseout="this.style.transform='translateY(0)'; this.style.boxShadow='';">
+        
+        <div class="tool-rec-header" style="display: flex; justify-content: space-between; align-items: flex-start; margin-bottom: 0.75rem;">
+          <h4 class="tool-rec-name" style="font-weight: 600; font-size: 1rem; margin: 0; color: var(--color-text); flex: 1; margin-right: 0.75rem;">
+            ${tool.icon ? `<span style="margin-right: 0.5rem; font-size: 1.125rem;">${tool.icon}</span>` : ''}
             ${tool.name}
           </h4>
-          <div class="flex items-center gap-2">
+          <div style="display: flex; align-items: center; gap: 0.375rem; flex-shrink: 0;">
             <span class="tool-rec-priority ${priority}" 
-                  style="background-color: ${priorityColors[priority]}; color: white; padding: 0.25rem 0.5rem; border-radius: 1rem; font-size: 0.75rem; position: relative; display: flex; align-items: center; gap: 0.25rem;">
+                  style="background-color: ${priorityColors[priority]}; color: white; padding: 0.25rem 0.5rem; border-radius: 1rem; font-size: 0.75rem; font-weight: 500; text-transform: uppercase; position: relative; display: flex; align-items: center; gap: 0.25rem;">
               ${priority}
               ${confidenceTooltip}
             </span>
           </div>
         </div>
         
-        <div class="tool-rec-justification" style="background-color: var(--color-bg-tertiary); padding: 0.75rem; border-radius: 0.375rem; border-left: 3px solid var(--color-primary); margin: 0.75rem 0; font-style: italic; white-space: pre-wrap; word-wrap: break-word;">
-          "${this.sanitizeText(tool.justification || (tool.recommendation && tool.recommendation.justification) || `Empfohlen für ${tool.phase}`)}"
+        <div class="tool-rec-justification" style="background-color: var(--color-bg-tertiary); padding: 0.75rem; border-radius: 0.375rem; border-left: 3px solid var(--color-primary); margin: 0.75rem 0; font-style: italic; white-space: pre-wrap; word-wrap: break-word; font-size: 0.875rem; line-height: 1.5; color: var(--color-text-secondary);">
+          "${Utils.sanitizeText(tool.justification || (tool.recommendation && tool.recommendation.justification) || `Empfohlen für ${tool.phase}`)}"
         </div>
         
-        <div style="font-size: 0.75rem; color: var(--color-text-secondary);">
-          ${this.renderToolBadges(tool)}
-          <div style="margin-top: 0.5rem;">
-            ${tool.type === 'method' ? 'Methode' : tool.platforms.join(', ') + ' • ' + tool.license}
+        <div style="font-size: 0.75rem; color: var(--color-text-secondary); margin-top: auto;">
+          <div style="display: flex; flex-wrap: wrap; gap: 0.375rem; margin-bottom: 0.5rem;">
+            ${this.renderToolBadges(tool)}
+          </div>
+          <div style="display: flex; justify-content: space-between; align-items: center;">
+            <span>${tool.type === 'method' ? 'Methode' : tool.platforms.slice(0, 2).join(', ')}</span>
+            <span>${tool.skillLevel}</span>
           </div>
         </div>
       </div>
@@ -1178,18 +1529,13 @@ class AIQueryInterface {
           const fullTool = tools.find(t => t.name === toolRec.name);
           if (!fullTool) return '';
           
-          return this.renderDetailedTool(fullTool, {
-            ...toolRec,
-            confidence: toolRec.confidence 
-          }, index + 1);
+          return this.renderDetailedTool(fullTool, toolRec, index + 1);
         }).join('')}
       </div>
     `;
   }
 
   renderDetailedTool(tool, recommendation, rank) {
-    console.log(`[AI DEBUG] renderDetailedTool called for ${tool.name}, recommendation confidence:`, recommendation.confidence);
-    
     const rankColors = { 1: 'var(--color-accent)', 2: 'var(--color-primary)', 3: 'var(--color-warning)' };
     const suitabilityColors = { high: 'var(--color-accent)', medium: 'var(--color-warning)', low: 'var(--color-text-secondary)' };
     
@@ -1214,11 +1560,11 @@ class AIQueryInterface {
 
         <div style="margin-bottom: 1.5rem;">
           <h4 style="margin: 0.8rem 0 0.75rem 0; color: var(--color-accent);">Warum diese Methode?</h4>
-          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.detailed_explanation)}</div>
+          <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(recommendation.detailed_explanation)}</div>
           
           ${recommendation.implementation_approach ? `
             <h4 style="margin: 0.8rem 0 0.75rem 0; color: var(--color-primary);">Anwendungsansatz</h4>
-            <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(recommendation.implementation_approach)}</div>
+            <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(recommendation.implementation_approach)}</div>
           ` : ''}
         </div>
 
@@ -1229,6 +1575,102 @@ class AIQueryInterface {
     `;
   }
 
+  renderConfidenceTooltip(confidence) {
+    if (!confidence || typeof confidence.overall !== 'number') return '';
+    
+    const confidenceColor = Utils.getConfidenceColor(confidence.overall);
+    const tooltipId = `tooltip-${Math.random().toString(36).substr(2, 9)}`;
+    
+    return `
+      <span class="confidence-tooltip-trigger" 
+            style="display: inline-flex; align-items: center; gap: 0.125rem; cursor: help; margin-left: 0.25rem; position: relative;"
+            onmouseenter="this.querySelector('.confidence-tooltip').style.display = 'block'"
+            onmouseleave="this.querySelector('.confidence-tooltip').style.display = 'none'"
+            onclick="event.stopPropagation();">
+        <div style="width: 6px; height: 6px; border-radius: 50%; background-color: ${confidenceColor}; flex-shrink: 0;"></div>
+        <span style="font-size: 0.625rem; color: white; font-weight: 600; text-shadow: 0 1px 2px rgba(0,0,0,0.5);">${confidence.overall}%</span>
+        
+        <div class="confidence-tooltip" 
+             style="display: none; position: absolute; top: 100%; right: 0; z-index: 1001; background: var(--color-bg); border: 1px solid var(--color-border); border-radius: 0.5rem; padding: 1rem; min-width: 320px; max-width: 400px; box-shadow: var(--shadow-lg); font-size: 0.75rem; color: var(--color-text); margin-top: 0.5rem;">
+          <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.75rem;">
+            <strong style="font-size: 0.875rem; color: var(--color-primary);">KI-Vertrauenswertung</strong>
+            <span style="background-color: ${confidenceColor}; color: white; font-weight: 600; padding: 0.125rem 0.375rem; border-radius: 0.25rem; font-size: 0.625rem;">${confidence.overall}%</span>
+          </div>
+          
+          <div style="display: grid; grid-template-columns: 1fr; gap: 0.625rem; margin-bottom: 0.75rem;">
+            <div style="background: var(--color-bg-secondary); padding: 0.5rem; border-radius: 0.375rem; border-left: 3px solid var(--color-accent);">
+              <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.25rem;">
+                <span style="font-weight: 600; font-size: 0.6875rem; color: var(--color-text);">🔍 Semantische Relevanz</span>
+                <strong style="color: var(--color-accent);">${confidence.semanticRelevance}%</strong>
+              </div>
+              <div style="font-size: 0.625rem; color: var(--color-text-secondary); line-height: 1.3;">
+                Wie gut die Tool-Beschreibung semantisch zu Ihrer Anfrage passt
+              </div>
+            </div>
+            
+            <div style="background: var(--color-bg-secondary); padding: 0.5rem; border-radius: 0.375rem; border-left: 3px solid var(--color-primary);">
+              <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 0.25rem;">
+                <span style="font-weight: 600; font-size: 0.6875rem; color: var(--color-text);">🎯 Aufgaben-Eignung</span>
+                <strong style="color: var(--color-primary);">${confidence.taskSuitability}%</strong>
+              </div>
+              <div style="font-size: 0.625rem; color: var(--color-text-secondary); line-height: 1.3;">
+                KI-bewertete Eignung für Ihre spezifische Aufgabenstellung
+              </div>
+            </div>
+          </div>
+          
+          ${confidence.strengthIndicators && confidence.strengthIndicators.length > 0 ? `
+            <div style="margin-bottom: 0.75rem; padding: 0.5rem; background: var(--color-oss-bg); border-radius: 0.375rem; border-left: 3px solid var(--color-accent);">
+              <strong style="color: var(--color-accent); font-size: 0.6875rem; display: flex; align-items: center; gap: 0.25rem; margin-bottom: 0.375rem;">
+                <span>✓</span> Stärken dieser Empfehlung:
+              </strong>
+              <ul style="margin: 0; padding-left: 1rem; font-size: 0.625rem; line-height: 1.4; color: var(--color-text);">
+                ${confidence.strengthIndicators.slice(0, 3).map(s => `<li style="margin-bottom: 0.25rem;">${Utils.sanitizeText(s)}</li>`).join('')}
+              </ul>
+            </div>
+          ` : ''}
+          
+          ${confidence.uncertaintyFactors && confidence.uncertaintyFactors.length > 0 ? `
+            <div style="padding: 0.5rem; background: var(--color-hosted-bg); border-radius: 0.375rem; border-left: 3px solid var(--color-warning);">
+              <strong style="color: var(--color-warning); font-size: 0.6875rem; display: flex; align-items: center; gap: 0.25rem; margin-bottom: 0.375rem;">
+                <span>⚠</span> Mögliche Einschränkungen:
+              </strong>
+              <ul style="margin: 0; padding-left: 1rem; font-size: 0.625rem; line-height: 1.4; color: var(--color-text);">
+                ${confidence.uncertaintyFactors.slice(0, 3).map(f => `<li style="margin-bottom: 0.25rem;">${Utils.sanitizeText(f)}</li>`).join('')}
+              </ul>
+            </div>
+          ` : ''}
+          
+          <div style="margin-top: 0.75rem; padding-top: 0.75rem; border-top: 1px solid var(--color-border); font-size: 0.625rem; color: var(--color-text-secondary); text-align: center;">
+            Forensisch fundierte KI-Analyse
+          </div>
+        </div>
+      </span>
+    `;
+  }
+
+  renderWorkflowSuggestion(suggestion) {
+    if (!suggestion) return '';
+    
+    return `
+      <div class="card" style="margin-top: 2rem; border-left: 4px solid var(--color-accent);">
+        <h4 style="margin: 0 0 1rem 0; color: var(--color-accent);">Workflow-Empfehlung</h4>
+        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(suggestion)}</div>
+      </div>
+    `;
+  }
+
+  renderAdditionalConsiderations(considerations) {
+    if (!considerations) return '';
+    
+    return `
+      <div class="card" style="margin-top: 2rem; background-color: var(--color-bg-secondary); border-left: 4px solid var(--color-text-secondary);">
+        <h4 style="margin: 0 0 1rem 0; color: var(--color-text-secondary);">Zusätzliche Überlegungen</h4>
+        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(considerations)}</div>
+      </div>
+    `;
+  }
+
   renderProsAndCons(pros, cons) {
     if (!pros?.length && !cons?.length) return '';
     
@@ -1238,7 +1680,7 @@ class AIQueryInterface {
           <div style="background-color: var(--color-oss-bg); padding: 1rem; border-radius: 0.5rem; border-left: 3px solid var(--color-accent);">
             <h5 style="margin: 0 0 0.5rem 0; color: var(--color-accent); font-size: 0.875rem;">✓ Vorteile</h5>
             <ul style="margin: 0; padding-left: 1rem;">
-              ${pros.map(pro => `<li style="margin-bottom: 0.25rem;">${this.sanitizeText(pro)}</li>`).join('')}
+              ${pros.map(pro => `<li style="margin-bottom: 0.25rem;">${Utils.sanitizeText(pro)}</li>`).join('')}
             </ul>
           </div>
         ` : ''}
@@ -1246,7 +1688,7 @@ class AIQueryInterface {
           <div style="background-color: var(--color-hosted-bg); padding: 1rem; border-radius: 0.5rem; border-left: 3px solid var(--color-warning);">
             <h5 style="margin: 0 0 0.5rem 0; color: var(--color-warning); font-size: 0.875rem;">✗ Nachteile</h5>
             <ul style="margin: 0; padding-left: 1rem;">
-              ${cons.map(con => `<li style="margin-bottom: 0.25rem;">${this.sanitizeText(con)}</li>`).join('')}
+              ${cons.map(con => `<li style="margin-bottom: 0.25rem;">${Utils.sanitizeText(con)}</li>`).join('')}
             </ul>
           </div>
         ` : ''}
@@ -1258,7 +1700,7 @@ class AIQueryInterface {
     const isMethod = tool.type === 'method';
     
     return `
-      <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 0.75rem; font-size: 0.8125rem; color: var(--color-text-secondary); margin-bottom: 1rem;">
+      <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 0.75rem; font-size: 0.8125rem; color: var(--color-text-secondary); margin-bottom: 1rem; padding: 0.75rem; background-color: var(--color-bg-secondary); border-radius: 0.375rem;">
         ${!isMethod ? `<div><strong>Plattformen:</strong> ${tool.platforms.join(', ')}</div>` : ''}
         <div><strong>Skill Level:</strong> ${tool.skillLevel}</div>
         ${!isMethod ? `<div><strong>Lizenz:</strong> ${tool.license}</div>` : ''}
@@ -1271,29 +1713,7 @@ class AIQueryInterface {
     return `
       <div style="background-color: var(--color-bg-secondary); padding: 1rem; border-radius: 0.5rem; margin-bottom: 1rem;">
         <h5 style="margin: 0 0 0.5rem 0; color: var(--color-text-secondary); font-size: 0.875rem;">Alternative Ansätze</h5>
-        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(alternatives)}</div>
-      </div>
-    `;
-  }
-
-  renderWorkflowSuggestion(suggestion) {
-    if (!suggestion) return '';
-    
-    return `
-      <div class="card" style="margin-top: 2rem; border-left: 4px solid var(--color-accent);">
-        <h4 style="margin: 0 0 1rem 0; color: var(--color-accent);">Workflow-Empfehlung</h4>
-        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(suggestion)}</div>
-      </div>
-    `;
-  }
-
-  renderAdditionalConsiderations(considerations) {
-    if (!considerations) return '';
-    
-    return `
-      <div class="card" style="margin-top: 2rem; background-color: var(--color-bg-secondary); border-left: 4px solid var(--color-text-secondary);">
-        <h4 style="margin: 0 0 1rem 0; color: var(--color-text-secondary);">Zusätzliche Überlegungen</h4>
-        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${this.sanitizeText(considerations)}</div>
+        <div style="margin: 0; line-height: 1.6; white-space: pre-wrap; word-wrap: break-word;">${Utils.sanitizeText(alternatives)}</div>
       </div>
     `;
   }
@@ -1318,32 +1738,6 @@ class AIQueryInterface {
     return badges;
   }
 
-  sanitizeText(text) {
-    if (typeof text !== 'string') return '';
-    
-    return text
-      // Remove markdown headers
-      .replace(/^#{1,6}\s+/gm, '')
-      // Remove markdown lists (bullet points and numbered)
-      .replace(/^\s*[-*+]\s+/gm, '')
-      .replace(/^\s*\d+\.\s+/gm, '')
-      // Remove markdown bold/italic
-      .replace(/\*\*(.+?)\*\*/g, '$1')
-      .replace(/\*(.+?)\*/g, '$1')
-      .replace(/__(.+?)__/g, '$1')
-      .replace(/_(.+?)_/g, '$1')
-      // Remove markdown links
-      .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
-      // Remove code blocks
-      .replace(/```[\s\S]*?```/g, '[CODE BLOCK]')
-      .replace(/`([^`]+)`/g, '$1')
-      // Remove HTML tags
-      .replace(/<[^>]+>/g, '')
-      // Clean up excessive whitespace but preserve paragraphs
-      .replace(/\n\s*\n\s*\n/g, '\n\n')
-      .trim();
-  }
-
   getToolClass(tool, context = 'card') {
     const isMethod = tool.type === 'method';
     const hasValidProjectUrl = isToolHosted(tool);
@@ -1361,29 +1755,55 @@ class AIQueryInterface {
     }
   }
 
-  getSuitabilityText(score, confidence = null) {
+  getSuitabilityText(score) {
     const texts = {
       high: 'GUT GEEIGNET',
       medium: 'GEEIGNET', 
       low: 'VIELLEICHT GEEIGNET'
     };
-    const baseText = texts[score] || 'GEEIGNET';
-    
-    if (confidence) {
-      return `${baseText} ${this.renderConfidenceTooltip(confidence, 'suitability')}`;
-    }
-    return baseText;
+    return texts[score] || 'GEEIGNET';
   }
 
+  // Display state management
+  showLoading() {
+    Utils.showElement(this.elements.loading);
+  }
+
+  hideLoading() {
+    Utils.hideElement(this.elements.loading);
+  }
+
+  showResults() {
+    Utils.showElement(this.elements.results);
+  }
+
+  hideResults() {
+    Utils.hideElement(this.elements.results);
+    Utils.hideElement(this.elements.error);
+  }
+
+  showError(message) {
+    if (this.elements.errorMessage) this.elements.errorMessage.textContent = message;
+    Utils.showElement(this.elements.error);
+  }
+
+  hideError() {
+    Utils.hideElement(this.elements.error);
+  }
+
+  // Public method for restoring AI results after navigation
   restoreAIResults() {
     if (this.currentRecommendation && this.elements.results) {
       this.showResults();
       
-      // Re-render audit trail if it exists
       if (this.currentRecommendation.auditTrail) {
         setTimeout(() => {
-          this.renderAuditTrail(this.currentRecommendation.auditTrail);
-          console.log('[AI Interface] Audit trail restored successfully');
+          try {
+            this.renderAuditTrail(this.currentRecommendation.auditTrail);
+            console.log('[AI Interface] Audit trail restored successfully');
+          } catch (error) {
+            console.error('[AI Interface] Audit trail restore failed:', error);
+          }
         }, 100);
       }
       
@@ -1391,91 +1811,18 @@ class AIQueryInterface {
       this.hideError();
     }
   }
-
-  escapeHtml(text) {
-    if (typeof text !== 'string') return '';
-    const div = document.createElement('div');
-    div.textContent = text;
-    return div.innerHTML;
-  }
-
-  truncateText(text, maxLength) {
-    if (text.length <= maxLength) return text;
-    return text.slice(0, maxLength) + '...';
-  }
-
-  formatDuration(ms) {
-    if (ms < 1000) return '< 1s';
-    if (ms < 60000) return `${Math.ceil(ms / 1000)}s`;
-    return `${Math.ceil(ms / 60000)}m`;
-  }
-
-  showElement(element) {
-    if (element) {
-      element.style.display = 'block';
-      element.classList.remove('hidden');
-    }
-  }
-
-  hideElement(element) {
-    if (element) {
-      element.style.display = 'none';
-      element.classList.add('hidden');
-    }
-  }
-
-  showLoading() {
-    this.showElement(this.elements.loading);
-  }
-
-  hideLoading() {
-    this.hideElement(this.elements.loading);
-  }
-
-  showResults() {
-    this.showElement(this.elements.results);
-  }
-
-  hideResults() {
-    this.hideElement(this.elements.results);
-    this.hideElement(this.elements.error);
-  }
-
-  showError(message) {
-    if (this.elements.errorMessage) this.elements.errorMessage.textContent = message;
-    this.showElement(this.elements.error);
-  }
-
-  hideError() {
-    this.hideElement(this.elements.error);
-  }
 }
 
+// ===================================================================
+// INITIALIZATION
+// ===================================================================
+
 document.addEventListener('DOMContentLoaded', () => {
   const aiInterface = new AIQueryInterface();
   
-  // FIXED: Global restoreAIResults function with proper error handling
-  window.restoreAIResults = () => {
-    if (aiInterface.currentRecommendation && aiInterface.elements.results) {
-      aiInterface.showResults();
-      
-      // Re-render audit trail if it exists
-      if (aiInterface.currentRecommendation.auditTrail) {
-        setTimeout(() => {
-          try {
-            aiInterface.renderAuditTrail(aiInterface.currentRecommendation.auditTrail);
-            console.log('[AI Interface] Global audit trail restored');
-          } catch (error) {
-            console.error('[AI Interface] Global audit trail restore failed:', error);
-          }
-        }, 100);
-      }
-      
-      aiInterface.hideLoading();
-      aiInterface.hideError();
-    }
-  };
-  
+  // Global functions for external access
+  window.restoreAIResults = () => aiInterface.restoreAIResults();
   window.isToolHosted = window.isToolHosted || isToolHosted;
-});
-</script>
\ No newline at end of file
+  
+  console.log('[AI Interface] Initialized successfully');
+});
\ No newline at end of file
diff --git a/src/utils/aiPipeline.ts b/src/utils/aiPipeline.ts
index 79d5a39..0d1ba3b 100644
--- a/src/utils/aiPipeline.ts
+++ b/src/utils/aiPipeline.ts
@@ -209,25 +209,6 @@ class ImprovedMicroTaskAIPipeline {
     
     console.log('[AUDIT] Merged temporary entries into context');
   }
-/**
-  private summarizeForAudit(data: any): any {
-    if (this.auditConfig.detailLevel === 'minimal') {
-      if (typeof data === 'string' && data.length > 100) {
-        return data.slice(0, 100) + '...[truncated]';
-      }
-      if (Array.isArray(data) && data.length > 3) {
-        return [...data.slice(0, 3), `...[${data.length - 3} more items]`];
-      }
-    } else if (this.auditConfig.detailLevel === 'standard') {
-      if (typeof data === 'string' && data.length > 500) {
-        return data.slice(0, 500) + '...[truncated]';
-      }
-      if (Array.isArray(data) && data.length > 10) {
-        return [...data.slice(0, 10), `...[${data.length - 10} more items]`];
-      }
-    }
-    return data;
-  }**/
 
   private calculateSelectionConfidence(result: any, candidateCount: number): number {
     if (!result || !result.selectedTools) return 30;
-- 
2.39.5


From 5d05c62a555c3ac6ee6777aef36d7fb336ad6990 Mon Sep 17 00:00:00 2001
From: overcuriousity <overcuriousity@posteo.org>
Date: Thu, 7 Aug 2025 09:13:04 +0200
Subject: [PATCH 2/3] fix

---
 public/js/auditTrailRenderer.js       | 389 --------------------------
 src/components/AIQueryInterface.astro |  31 --
 src/components/ToolFilters.astro      |  15 +-
 src/pages/api/ai/enhance-input.ts     |   2 +-
 src/pages/index.astro                 |  34 ---
 src/utils/aiPipeline.ts               |  11 +-
 src/utils/auditService.ts             |  43 +--
 src/utils/embeddings.ts               |  37 +--
 src/utils/nextcloud.ts                |   2 +-
 9 files changed, 19 insertions(+), 545 deletions(-)
 delete mode 100644 public/js/auditTrailRenderer.js

diff --git a/public/js/auditTrailRenderer.js b/public/js/auditTrailRenderer.js
deleted file mode 100644
index 9aed45a..0000000
--- a/public/js/auditTrailRenderer.js
+++ /dev/null
@@ -1,389 +0,0 @@
-// src/js/auditTrailRenderer.js
-
-import { auditService } from '../../src/utils/auditService.js';
-
-export class AuditTrailRenderer {
-  constructor(containerId, options = {}) {
-    this.containerId = containerId;
-    this.options = {
-      title: options.title || 'KI-Entscheidungspfad',
-      collapsible: options.collapsible !== false,
-      defaultExpanded: options.defaultExpanded || false,
-      ...options
-    };
-    this.componentId = `audit-trail-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`;
-  }
-
-  /**
-   * Render audit trail from raw audit data
-   * FIXED: Proper Promise handling
-   */
-  render(rawAuditTrail) {
-    const container = document.getElementById(this.containerId);
-    if (!container) {
-      console.error(`[AUDIT RENDERER] Container ${this.containerId} not found`);
-      return;
-    }
-
-    if (!rawAuditTrail || !Array.isArray(rawAuditTrail) || rawAuditTrail.length === 0) {
-      this.renderEmpty();
-      return;
-    }
-
-    try {
-      console.log('[AUDIT RENDERER] Processing audit trail...', rawAuditTrail.length, 'entries');
-      
-      // Process audit trail using the centralized service (synchronous)
-      const processedAudit = auditService.processAuditTrail(rawAuditTrail);
-      
-      console.log('[AUDIT RENDERER] Processed audit:', processedAudit);
-      
-      if (processedAudit && processedAudit.phases && processedAudit.phases.length > 0) {
-        this.renderProcessed(processedAudit);
-        // Attach event handlers after DOM is updated
-        setTimeout(() => this.attachEventHandlers(), 0);
-      } else {
-        console.warn('[AUDIT RENDERER] No processed audit data');
-        this.renderEmpty();
-      }
-    } catch (error) {
-      console.error('[AUDIT RENDERER] Failed to render audit trail:', error);
-      this.renderError(error);
-    }
-  }
-  /**
-   * Render processed audit trail
-   */
-  renderProcessed(processedAudit) {
-    const container = document.getElementById(this.containerId);
-    if (!container) return;
-
-    const detailsId = `${this.componentId}-details`;
-    
-    console.log('[AUDIT RENDERER] Rendering processed audit with', processedAudit.phases.length, 'phases');
-    
-    container.innerHTML = `
-      <div class="audit-trail-container">
-        <div class="audit-trail-header ${this.options.collapsible ? 'clickable' : ''}" 
-             ${this.options.collapsible ? `data-target="${detailsId}"` : ''}>
-          <div class="audit-trail-title">
-            <div class="audit-icon">
-              <div class="audit-icon-gradient">✓</div>
-              <h4>${this.options.title}</h4>
-            </div>
-            
-            <div class="audit-stats">
-              <div class="stat-item">
-                <div class="stat-dot stat-time"></div>
-                <span>${auditService.formatDuration(processedAudit.totalTime)}</span>
-              </div>
-              <div class="stat-item">
-                <div class="stat-dot" style="background-color: ${auditService.getConfidenceColor(processedAudit.avgConfidence)}"></div>
-                <span>${processedAudit.avgConfidence}% Vertrauen</span>
-              </div>
-              <div class="stat-item">
-                <span>${processedAudit.stepCount} Schritte</span>
-              </div>
-            </div>
-          </div>
-          
-          ${this.options.collapsible ? `
-            <div class="toggle-icon">
-              <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
-                <polyline points="6 9 12 15 18 9"/>
-              </svg>
-            </div>
-          ` : ''}
-        </div>
-        
-        <div id="${detailsId}" class="audit-trail-details ${this.options.collapsible && !this.options.defaultExpanded ? 'collapsed' : ''}">
-          ${this.renderSummary(processedAudit)}
-          ${this.renderProcessFlow(processedAudit)}
-          ${this.renderTechnicalDetails(processedAudit)}
-        </div>
-      </div>
-    `;
-
-    console.log('[AUDIT RENDERER] HTML rendered successfully');
-  }
-
-  /**
-   * Render audit summary section
-   */
-  renderSummary(audit) {
-    return `
-      <div class="audit-summary">
-        <div class="summary-header">📊 Analyse-Qualität</div>
-        <div class="summary-grid">
-          <div class="summary-stat">
-            <div class="summary-value success">${audit.highConfidenceSteps}</div>
-            <div class="summary-label">Hohe Sicherheit</div>
-          </div>
-          <div class="summary-stat">
-            <div class="summary-value ${audit.lowConfidenceSteps > 0 ? 'warning' : 'success'}">
-              ${audit.lowConfidenceSteps}
-            </div>
-            <div class="summary-label">Unsichere Schritte</div>
-          </div>
-          <div class="summary-stat">
-            <div class="summary-value">${auditService.formatDuration(audit.totalTime)}</div>
-            <div class="summary-label">Verarbeitungszeit</div>
-          </div>
-        </div>
-        
-        ${audit.summary.keyInsights && audit.summary.keyInsights.length > 0 ? `
-          <div class="insights-section">
-            <div class="insights-header success">✓ Erkenntnisse:</div>
-            <ul class="insights-list">
-              ${audit.summary.keyInsights.map(insight => `<li>${this.escapeHtml(insight)}</li>`).join('')}
-            </ul>
-          </div>
-        ` : ''}
-        
-        ${audit.summary.potentialIssues && audit.summary.potentialIssues.length > 0 ? `
-          <div class="insights-section">
-            <div class="insights-header warning">⚠ Hinweise:</div>
-            <ul class="insights-list">
-              ${audit.summary.potentialIssues.map(issue => `<li>${this.escapeHtml(issue)}</li>`).join('')}
-            </ul>
-          </div>
-        ` : ''}
-      </div>
-    `;
-  }
-
-  /**
-   * Render process flow section
-   */
-  renderProcessFlow(audit) {
-    if (!audit.phases || audit.phases.length === 0) {
-      return '<div class="audit-process-flow"><p>Keine Phasen verfügbar</p></div>';
-    }
-
-    return `
-      <div class="audit-process-flow">
-        ${audit.phases.map((phase, index) => `
-          <div class="phase-group ${index === audit.phases.length - 1 ? 'last-phase' : ''}">
-            <div class="phase-header">
-              <div class="phase-info">
-                <span class="phase-icon">${phase.icon || '📋'}</span>
-                <span class="phase-name">${phase.displayName || phase.name}</span>
-              </div>
-              <div class="phase-divider"></div>
-              <div class="phase-stats">
-                <div class="confidence-bar">
-                  <div class="confidence-fill" 
-                      style="width: ${phase.avgConfidence || 0}%; background-color: ${auditService.getConfidenceColor(phase.avgConfidence || 0)}">
-                  </div>
-                </div>
-                <span class="confidence-text">${phase.avgConfidence || 0}%</span>
-              </div>
-            </div>
-            
-            <div class="phase-entries">
-              ${(phase.entries || []).map(entry => `
-                <div class="audit-entry">
-                  <div class="entry-main">
-                    <span class="entry-action">${auditService.getActionDisplayName(entry.action)}</span>
-                    <div class="entry-meta">
-                      <div class="confidence-indicator" 
-                          style="background-color: ${auditService.getConfidenceColor(entry.confidence || 0)}">
-                      </div>
-                      <span class="confidence-value">${entry.confidence || 0}%</span>
-                      <span class="processing-time">${entry.processingTimeMs || 0}ms</span>
-                    </div>
-                  </div>
-                  
-                  ${(entry.inputSummary && entry.inputSummary !== 'null') || (entry.outputSummary && entry.outputSummary !== 'null') ? `
-                    <div class="entry-details">
-                      ${entry.inputSummary && entry.inputSummary !== 'null' ? `
-                        <div class="detail-item"><strong>Input:</strong> ${this.escapeHtml(entry.inputSummary)}</div>
-                      ` : ''}
-                      ${entry.outputSummary && entry.outputSummary !== 'null' ? `
-                        <div class="detail-item"><strong>Output:</strong> ${this.escapeHtml(entry.outputSummary)}</div>
-                      ` : ''}
-                    </div>
-                  ` : ''}
-                </div>
-              `).join('')}
-            </div>
-          </div>
-        `).join('')}
-      </div>
-    `;
-  }
-
-  /**
-   * Render technical details section
-   */
-  renderTechnicalDetails(audit) {
-    const technicalId = `${this.componentId}-technical`;
-    
-    return `
-      <div class="technical-toggle">
-        <button class="technical-toggle-btn" data-target="${technicalId}">
-          🔧 Technische Details anzeigen
-        </button>
-        <div id="${technicalId}" class="technical-details collapsed">
-          ${(audit.phases || []).map(phase => 
-            (phase.entries || []).map(entry => `
-              <div class="technical-entry">
-                <div class="technical-header">
-                  <span class="technical-phase">${entry.phase}/${entry.action}</span>
-                  <span class="technical-time">
-                    ${new Date(entry.timestamp).toLocaleTimeString('de-DE', { 
-                      hour: '2-digit', 
-                      minute: '2-digit', 
-                      second: '2-digit' 
-                    })} • ${entry.processingTimeMs || 0}ms
-                  </span>
-                </div>
-                <div class="technical-content">
-                  <div class="technical-row">
-                    <strong>Confidence:</strong> ${entry.confidence || 0}%
-                  </div>
-                  ${entry.metadata && Object.keys(entry.metadata).length > 0 ? `
-                    <div class="technical-row">
-                      <strong>Metadata:</strong> ${this.escapeHtml(JSON.stringify(entry.metadata))}
-                    </div>
-                  ` : ''}
-                </div>
-              </div>
-            `).join('')
-          ).join('')}
-        </div>
-      </div>
-    `;
-  }
-
-  /**
-   * Attach event handlers for interactions
-   */
-  attachEventHandlers() {
-    console.log('[AUDIT RENDERER] Attaching event handlers...');
-    
-    // Handle collapsible header
-    if (this.options.collapsible) {
-      const header = document.querySelector(`[data-target="${this.componentId}-details"]`);
-      const details = document.getElementById(`${this.componentId}-details`);
-      const toggleIcon = header?.querySelector('.toggle-icon svg');
-      
-      if (header && details && toggleIcon) {
-        // Remove existing listeners
-        header.replaceWith(header.cloneNode(true));
-        const newHeader = document.querySelector(`[data-target="${this.componentId}-details"]`);
-        const newToggleIcon = newHeader?.querySelector('.toggle-icon svg');
-        
-        if (newHeader && newToggleIcon) {
-          newHeader.addEventListener('click', () => {
-            const isCollapsed = details.classList.contains('collapsed');
-            
-            if (isCollapsed) {
-              details.classList.remove('collapsed');
-              newToggleIcon.style.transform = 'rotate(180deg)';
-            } else {
-              details.classList.add('collapsed');
-              newToggleIcon.style.transform = 'rotate(0deg)';
-            }
-          });
-          console.log('[AUDIT RENDERER] Collapsible header handler attached');
-        }
-      }
-    }
-    
-    // Handle technical details toggle
-    const technicalBtn = document.querySelector(`[data-target="${this.componentId}-technical"]`);
-    const technicalDetails = document.getElementById(`${this.componentId}-technical`);
-    
-    if (technicalBtn && technicalDetails) {
-      // Remove existing listener
-      technicalBtn.replaceWith(technicalBtn.cloneNode(true));
-      const newTechnicalBtn = document.querySelector(`[data-target="${this.componentId}-technical"]`);
-      
-      if (newTechnicalBtn) {
-        newTechnicalBtn.addEventListener('click', () => {
-          const isCollapsed = technicalDetails.classList.contains('collapsed');
-          
-          if (isCollapsed) {
-            technicalDetails.classList.remove('collapsed');
-            newTechnicalBtn.textContent = '🔧 Technische Details ausblenden';
-          } else {
-            technicalDetails.classList.add('collapsed');
-            newTechnicalBtn.textContent = '🔧 Technische Details anzeigen';
-          }
-        });
-        console.log('[AUDIT RENDERER] Technical details handler attached');
-      }
-    }
-  }
-
-  /**
-   * Render empty state
-   */
-  renderEmpty() {
-    const container = document.getElementById(this.containerId);
-    if (container) {
-      container.innerHTML = `
-        <div class="audit-trail-container">
-          <div class="audit-trail-header">
-            <div class="audit-icon">
-              <div class="audit-icon-gradient">ⓘ</div>
-              <h4>Kein Audit-Trail verfügbar</h4>
-            </div>
-          </div>
-        </div>
-      `;
-    }
-  }
-
-  /**
-   * Render error state
-   */
-  renderError(error) {
-    const container = document.getElementById(this.containerId);
-    if (container) {
-      container.innerHTML = `
-        <div class="audit-trail-container">
-          <div class="audit-trail-header">
-            <div class="audit-icon">
-              <div class="audit-icon-gradient" style="background: var(--color-error);">✗</div>
-              <h4>Audit-Trail Fehler</h4>
-            </div>
-          </div>
-          <div class="audit-summary">
-            <p style="color: var(--color-error);">
-              Fehler beim Laden der Audit-Informationen: ${this.escapeHtml(error.message)}
-            </p>
-          </div>
-        </div>
-      `;
-    }
-  }
-
-  /**
-   * Utility method to escape HTML
-   */
-  escapeHtml(text) {
-    if (typeof text !== 'string') return String(text);
-    const div = document.createElement('div');
-    div.textContent = text;
-    return div.innerHTML;
-  }
-
-  /**
-   * Clear the audit trail display
-   */
-  clear() {
-    const container = document.getElementById(this.containerId);
-    if (container) {
-      container.innerHTML = '';
-    }
-  }
-
-  /**
-   * Get container element
-   */
-  getContainer() {
-    return document.getElementById(this.containerId);
-  }
-}
\ No newline at end of file
diff --git a/src/components/AIQueryInterface.astro b/src/components/AIQueryInterface.astro
index 88dae7e..b95e93b 100644
--- a/src/components/AIQueryInterface.astro
+++ b/src/components/AIQueryInterface.astro
@@ -217,12 +217,7 @@ const domainAgnosticSoftware = data['domain-agnostic-software'] || [];
 
 <script type="module" define:vars={{ tools, phases, domainAgnosticSoftware }}>
 
-// ===================================================================
-// CONSOLIDATED UTILITIES
-// ===================================================================
-
 const Utils = {
-  // Phase configuration for audit trail
   phaseConfig: {
     'initialization': { icon: '🚀', displayName: 'Initialisierung' },
     'retrieval': { icon: '🔍', displayName: 'Datensuche' },
@@ -232,7 +227,6 @@ const Utils = {
     'completion': { icon: '✅', displayName: 'Finalisierung' }
   },
 
-  // Action translations for display
   actionTranslations: {
     'pipeline-start': 'Analyse gestartet',
     'embeddings-search': 'Ähnliche Tools gesucht', 
@@ -316,7 +310,6 @@ const Utils = {
     return String(data);
   },
 
-  // DOM utilities
   showElement(element) {
     if (element) {
       element.style.display = 'block';
@@ -332,10 +325,6 @@ const Utils = {
   }
 };
 
-// ===================================================================
-// AUDIT TRAIL PROCESSOR
-// ===================================================================
-
 class AuditTrailProcessor {
   static processAuditTrail(rawAuditTrail) {
     if (!rawAuditTrail || !Array.isArray(rawAuditTrail) || rawAuditTrail.length === 0) {
@@ -355,7 +344,6 @@ class AuditTrailProcessor {
       const highConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) >= 80).length;
       const lowConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) < 60).length;
 
-      // Group entries by phase
       const groupedEntries = rawAuditTrail.reduce((groups, entry) => {
         const phase = entry.phase || 'unknown';
         if (!groups[phase]) groups[phase] = [];
@@ -363,7 +351,6 @@ class AuditTrailProcessor {
         return groups;
       }, {});
 
-      // Process phases
       const phases = Object.entries(groupedEntries).map(([phase, entries]) => {
         const phaseConfig = Utils.phaseConfig[phase] || { icon: '📋', displayName: phase };
         const validEntries = entries.filter(entry => entry && typeof entry === 'object');
@@ -463,10 +450,6 @@ class AuditTrailProcessor {
   }
 }
 
-// ===================================================================
-// AUDIT TRAIL RENDERER
-// ===================================================================
-
 class AuditTrailRenderer {
   constructor(containerId, options = {}) {
     this.containerId = containerId;
@@ -740,7 +723,6 @@ class AuditTrailRenderer {
   }
 
   attachEventHandlers() {
-    // Handle collapsible header
     if (this.options.collapsible) {
       const header = document.querySelector(`[data-target="${this.componentId}-details"]`);
       const details = document.getElementById(`${this.componentId}-details`);
@@ -755,7 +737,6 @@ class AuditTrailRenderer {
       }
     }
     
-    // Handle technical details toggle
     const technicalBtn = document.querySelector(`[data-target="${this.componentId}-technical"]`);
     const technicalDetails = document.getElementById(`${this.componentId}-technical`);
     
@@ -771,10 +752,6 @@ class AuditTrailRenderer {
   }
 }
 
-// ===================================================================
-// MAIN AI QUERY INTERFACE
-// ===================================================================
-
 class AIQueryInterface {
   constructor() {
     this.currentMode = 'workflow';
@@ -1251,7 +1228,6 @@ class AIQueryInterface {
     
     this.showResults();
     
-    // Render audit trail after DOM is ready
     setTimeout(() => {
       try {
         this.renderAuditTrail(recommendation.auditTrail);
@@ -1764,7 +1740,6 @@ class AIQueryInterface {
     return texts[score] || 'GEEIGNET';
   }
 
-  // Display state management
   showLoading() {
     Utils.showElement(this.elements.loading);
   }
@@ -1791,7 +1766,6 @@ class AIQueryInterface {
     Utils.hideElement(this.elements.error);
   }
 
-  // Public method for restoring AI results after navigation
   restoreAIResults() {
     if (this.currentRecommendation && this.elements.results) {
       this.showResults();
@@ -1813,14 +1787,9 @@ class AIQueryInterface {
   }
 }
 
-// ===================================================================
-// INITIALIZATION
-// ===================================================================
-
 document.addEventListener('DOMContentLoaded', () => {
   const aiInterface = new AIQueryInterface();
   
-  // Global functions for external access
   window.restoreAIResults = () => aiInterface.restoreAIResults();
   window.isToolHosted = window.isToolHosted || isToolHosted;
   
diff --git a/src/components/ToolFilters.astro b/src/components/ToolFilters.astro
index 9726b9b..72402b6 100644
--- a/src/components/ToolFilters.astro
+++ b/src/components/ToolFilters.astro
@@ -354,7 +354,6 @@ const sortedTags = Object.entries(tagFrequency)
     let semanticSearchAvailable = false;
     let lastSemanticResults = null;
     
-// Check embeddings availability
     async function checkEmbeddingsAvailability() {
       try {
         const res = await fetch('/api/ai/embeddings-status');
@@ -363,15 +362,13 @@ const sortedTags = Object.entries(tagFrequency)
 
         if (semanticSearchAvailable) {
           elements.semanticContainer.classList.remove('hidden');
-          elements.semanticCheckbox.disabled = false;   // 👈 re-enable
+          elements.semanticCheckbox.disabled = false;
         }
       } catch (err) {
         console.error('[EMBEDDINGS] Status check failed:', err);
-        // leave the checkbox disabled
       }
     }
     
-    // Semantic search function
     async function performSemanticSearch(query) {
       if (!semanticSearchAvailable || !query.trim()) {
         return null;
@@ -576,7 +573,6 @@ const sortedTags = Object.entries(tagFrequency)
       }
     }
     
-    // FIXED: Consolidated filtering logic with semantic search support
     async function filterTools() {
       const searchTerm = elements.searchInput.value.trim().toLowerCase();
       const selectedDomain = elements.domainSelect.value;
@@ -594,7 +590,6 @@ const sortedTags = Object.entries(tagFrequency)
       let filteredTools = window.toolsData;
       let semanticResults = null;
       
-      // CONSOLIDATED: Use semantic search if enabled and search term exists
       if (semanticSearchEnabled && semanticSearchAvailable && searchTerm) {
         semanticResults = await performSemanticSearch(searchTerm);
         lastSemanticResults = semanticResults;
@@ -605,7 +600,6 @@ const sortedTags = Object.entries(tagFrequency)
       } else {
         lastSemanticResults = null;
         
-        // Traditional text-based search
         if (searchTerm) {
           filteredTools = window.toolsData.filter(tool =>
             tool.name.toLowerCase().includes(searchTerm) ||
@@ -615,7 +609,6 @@ const sortedTags = Object.entries(tagFrequency)
         }
       }
       
-      // Apply additional filters to the results
       filteredTools = filteredTools.filter(tool => {
         if (selectedDomain && !(tool.domains || []).includes(selectedDomain)) {
           return false;
@@ -666,9 +659,8 @@ const sortedTags = Object.entries(tagFrequency)
         );
       }
 
-      /* existing code continues */
       const finalResults = semanticSearchEnabled && lastSemanticResults
-        ? filteredTools               // now properly re-sorted
+        ? filteredTools
         : (searchTerm && window.prioritizeSearchResults
             ? window.prioritizeSearchResults(filteredTools, searchTerm)
             : filteredTools);
@@ -726,7 +718,6 @@ const sortedTags = Object.entries(tagFrequency)
       filterTagCloud();
     }
     
-    // Event listeners
     elements.searchInput.addEventListener('input', (e) => {
       const hasValue = e.target.value.length > 0;
       elements.clearSearch.classList.toggle('hidden', !hasValue);
@@ -741,7 +732,6 @@ const sortedTags = Object.entries(tagFrequency)
       filterTools();
     });
     
-    // Semantic search checkbox handler
     if (elements.semanticCheckbox) {
       elements.semanticCheckbox.addEventListener('change', (e) => {
         semanticSearchEnabled = e.target.checked;
@@ -812,7 +802,6 @@ const sortedTags = Object.entries(tagFrequency)
     window.clearTagFilters = resetTags;
     window.clearAllFilters = resetAllFilters;
     
-    // Initialize
     checkEmbeddingsAvailability();
     initializeCollapsible();
     initTagCloud();
diff --git a/src/pages/api/ai/enhance-input.ts b/src/pages/api/ai/enhance-input.ts
index 1ebb2a8..68ada2a 100644
--- a/src/pages/api/ai/enhance-input.ts
+++ b/src/pages/api/ai/enhance-input.ts
@@ -20,7 +20,7 @@ const AI_ANALYZER_API_KEY = getEnv('AI_ANALYZER_API_KEY');
 const AI_ANALYZER_MODEL = getEnv('AI_ANALYZER_MODEL');
 
 const rateLimitStore = new Map<string, { count: number; resetTime: number }>();
-const RATE_LIMIT_WINDOW = 60 * 1000; // 1 minute
+const RATE_LIMIT_WINDOW = 60 * 1000;
 const RATE_LIMIT_MAX = 5;
 
 function sanitizeInput(input: string): string {
diff --git a/src/pages/index.astro b/src/pages/index.astro
index a9897ea..57357dc 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -198,15 +198,12 @@ const phases = data.phases;
 <script define:vars={{ toolsData: data.tools, phases: data.phases }}>
   window.toolsData = toolsData;
   
-  // CONSOLIDATED: Approach selection - Pure navigation aid
   window.selectApproach = function(approach) {
     console.log(`Selected approach: ${approach}`);
     
-    // Clear any existing AI results
     const aiResults = document.getElementById('ai-results');
     if (aiResults) aiResults.style.display = 'none';
     
-    // Update visual selection state
     document.querySelectorAll('.approach-card').forEach(card => {
       card.classList.remove('selected');
     });
@@ -214,14 +211,12 @@ const phases = data.phases;
     const selectedCard = document.querySelector(`.approach-card.${approach}`);
     if (selectedCard) selectedCard.classList.add('selected');
     
-    // Hide all approach sections first (ensures mutual exclusivity)
     const methodologySection = document.getElementById('methodology-section');
     const targetedSection = document.getElementById('targeted-section');
     
     if (methodologySection) methodologySection.classList.remove('active');
     if (targetedSection) targetedSection.classList.remove('active');
     
-    // Show the selected approach section (navigation aid only)
     if (approach === 'methodology') {
       if (methodologySection) {
         methodologySection.classList.add('active');
@@ -235,11 +230,9 @@ const phases = data.phases;
     }
   };
 
-  // CONSOLIDATED: Phase selection - Sets unified filter dropdown
   window.selectPhase = function(phase) {
     console.log(`Selected NIST phase: ${phase}`);
     
-    // Update visual selection of phase cards
     document.querySelectorAll('.phase-card').forEach(card => {
       card.classList.remove('active');
     });
@@ -249,23 +242,19 @@ const phases = data.phases;
       selectedCard.classList.add('active');
     }
     
-    // CONSOLIDATED: Set the unified phase-select dropdown
     const phaseSelect = document.getElementById('phase-select');
     if (phaseSelect) {
       phaseSelect.value = phase;
       
-      // Trigger the change event to activate unified filtering
       const changeEvent = new Event('change', { bubbles: true });
       phaseSelect.dispatchEvent(changeEvent);
     }
     
-    // Switch to grid view to show filtered results
     const gridToggle = document.querySelector('.view-toggle[data-view="grid"]');
     if (gridToggle && !gridToggle.classList.contains('active')) {
       gridToggle.click();
     }
     
-    // Scroll to filtered results
     setTimeout(() => {
       window.scrollToElementById('tools-grid');
     }, 200);
@@ -309,17 +298,14 @@ const phases = data.phases;
       const filtersSection = document.getElementById('filters-section');
       const noResults = document.getElementById('no-results');
       
-      // FIXED: Hide approach sections when switching to ANY view mode
       const methodologySection = document.getElementById('methodology-section');
       const targetedSection = document.getElementById('targeted-section');
       
-      // Hide all main content areas
       if (toolsGrid) toolsGrid.style.display = 'none';
       if (matrixContainer) matrixContainer.style.display = 'none';
       if (aiInterface) aiInterface.style.display = 'none';
       if (noResults) noResults.style.display = 'none';
       
-      // FIXED: Hide approach sections when switching to view modes
       if (methodologySection) methodologySection.classList.remove('active');
       if (targetedSection) targetedSection.classList.remove('active');
       
@@ -335,18 +321,14 @@ const phases = data.phases;
         case 'ai':
           if (aiInterface) aiInterface.style.display = 'block';
           
-          // FIXED: Show filters but hide everything except view controls
           if (filtersSection) {
             filtersSection.style.display = 'block';
             
-            // Hide all filter sections except the last one (view controls)
             const filterSections = filtersSection.querySelectorAll('.filter-section');
             filterSections.forEach((section, index) => {
               if (index === filterSections.length - 1) {
-                // Keep view controls visible
                 section.style.display = 'block';
               } else {
-                // Hide other filter sections
                 section.style.display = 'none';
               }
             });
@@ -354,7 +336,6 @@ const phases = data.phases;
           break;
       }
       
-      // FIXED: Reset filter sections visibility when not in AI view
       if (view !== 'ai' && filtersSection) {
         const filterSections = filtersSection.querySelectorAll('.filter-section');
         filterSections.forEach(section => {
@@ -363,7 +344,6 @@ const phases = data.phases;
       }
     }
 
-    // Navigation functions for AI recommendations (unchanged)
     window.navigateToGrid = function(toolName) {
       console.log('Navigating to grid for tool:', toolName);
       
@@ -485,8 +465,6 @@ const phases = data.phases;
       }, 100);
     }
 
-  // REPLACE the existing toolsFiltered event listener in index.astro with this enhanced version:
-
   window.addEventListener('toolsFiltered', (event) => {
     const { tools: filtered, semanticSearch } = event.detail;
     const currentView = document.querySelector('.view-toggle.active')?.getAttribute('data-view');
@@ -504,11 +482,9 @@ const phases = data.phases;
     if (semanticSearch && filtered.length > 0) {
       console.log('[SEMANTIC] Reordering tools by semantic similarity');
       
-      // FIXED: Create ordered array of cards based on semantic similarity
       const orderedCards = [];
       const remainingCards = [];
       
-      // First pass: collect cards in semantic order
       filtered.forEach(tool => {
         const toolName = tool.name.toLowerCase();
         const matchingCard = Array.from(allToolCards).find(card => 
@@ -520,12 +496,10 @@ const phases = data.phases;
           orderedCards.push(matchingCard);
           visibleCount++;
           
-          // Add semantic indicators if available
           if (tool._semanticSimilarity) {
             matchingCard.setAttribute('data-semantic-similarity', tool._semanticSimilarity.toFixed(3));
             matchingCard.setAttribute('data-semantic-rank', tool._semanticRank || '');
             
-            // Visual indication of semantic ranking (subtle)
             const header = matchingCard.querySelector('.tool-card-header h3');
             if (header && tool._semanticRank <= 3) {
               const existingIndicator = header.querySelector('.semantic-rank-indicator');
@@ -551,7 +525,6 @@ const phases = data.phases;
         }
       });
       
-      // Second pass: hide non-matching cards and collect them
       allToolCards.forEach(card => {
         const toolName = card.getAttribute('data-tool-name');
         if (!filteredNames.has(toolName)) {
@@ -560,18 +533,15 @@ const phases = data.phases;
         }
       });
       
-      // Reorder DOM: semantic results first, then hidden cards
       const allCards = [...orderedCards, ...remainingCards];
       allCards.forEach(card => {
         toolsContainer.appendChild(card);
       });
       
     } else {
-      // FIXED: Standard filtering without semantic ordering
       allToolCards.forEach(card => {
         const toolName = card.getAttribute('data-tool-name');
         
-        // Clean up any semantic indicators
         card.removeAttribute('data-semantic-similarity');
         card.removeAttribute('data-semantic-rank');
         const semanticIndicator = card.querySelector('.semantic-rank-indicator');
@@ -587,10 +557,8 @@ const phases = data.phases;
         }
       });
       
-      // Restore original order when not using semantic search
       if (!semanticSearch) {
         const originalOrder = Array.from(allToolCards).sort((a, b) => {
-          // Get original indices from data attributes or DOM order
           const aIndex = Array.from(allToolCards).indexOf(a);
           const bIndex = Array.from(allToolCards).indexOf(b);
           return aIndex - bIndex;
@@ -602,14 +570,12 @@ const phases = data.phases;
       }
     }
     
-    // Show/hide no results message
     if (visibleCount === 0) {
       noResults.style.display = 'block';
     } else {
       noResults.style.display = 'none';
     }
     
-    // Log semantic search info
     if (semanticSearch) {
       console.log(`[SEMANTIC] Displayed ${visibleCount} tools in semantic order`);
     }
diff --git a/src/utils/aiPipeline.ts b/src/utils/aiPipeline.ts
index 0d1ba3b..403aa4d 100644
--- a/src/utils/aiPipeline.ts
+++ b/src/utils/aiPipeline.ts
@@ -1,10 +1,10 @@
-// src/utils/aiPipeline.ts - Enhanced with Proper Confidence Scoring
+// src/utils/aiPipeline.ts 
 
 import { getCompressedToolsDataForAI } from './dataService.js';
 import { embeddingsService, type EmbeddingData, type SimilarityResult } from './embeddings.js';
 import { AI_PROMPTS, getPrompt } from '../config/prompts.js';
 import { isToolHosted } from './toolHelpers.js';
-import { auditService } from './auditService.js';  // Add this import
+import { auditService } from './auditService.js';
 
 interface AIConfig {
   endpoint: string;
@@ -188,7 +188,6 @@ class ImprovedMicroTaskAIPipeline {
       metadata
     };
 
-    // Add to context audit trail instead of temp storage
     if (!context.auditTrail) {
       context.auditTrail = [];
     }
@@ -369,7 +368,6 @@ class ImprovedMicroTaskAIPipeline {
     
     context.embeddingsSimilarities = new Map<string, number>();
     
-    // Always try to initialize embeddings - let the service decide if it should be enabled
     try {
       console.log('[AI PIPELINE] Attempting embeddings initialization...');
       await embeddingsService.waitForInitialization();
@@ -1175,7 +1173,6 @@ ${JSON.stringify(conceptsToSend, null, 2)}`;
       })) || []
     };
 
-    // Process audit trail before returning
     const processedAuditTrail = this.auditConfig.enabled && context.auditTrail 
       ? context.auditTrail 
       : [];
@@ -1218,7 +1215,7 @@ ${JSON.stringify(conceptsToSend, null, 2)}`;
         ...base,
         recommended_tools: recommendedToolsWithConfidence,
         workflow_suggestion: finalContent,
-        auditTrail: processedAuditTrail  // Always include audit trail array
+        auditTrail: processedAuditTrail
       };
     } else {
       const recommendedToolsWithConfidence = context.selectedTools?.map(st => {
@@ -1260,7 +1257,7 @@ ${JSON.stringify(conceptsToSend, null, 2)}`;
         ...base,
         recommended_tools: recommendedToolsWithConfidence,
         additional_considerations: finalContent,
-        auditTrail: processedAuditTrail  // Always include audit trail array
+        auditTrail: processedAuditTrail
       };
     }
   }
diff --git a/src/utils/auditService.ts b/src/utils/auditService.ts
index 5d51db1..9af7ce3 100644
--- a/src/utils/auditService.ts
+++ b/src/utils/auditService.ts
@@ -1,12 +1,10 @@
-// src/utils/auditService.ts - Centralized Audit Trail Management
+// src/utils/auditService.ts 
 
 
 function env(key: string, fallback: string | undefined = undefined): string | undefined {
-  // during dev/server-side rendering
   if (typeof process !== 'undefined' && process.env?.[key] !== undefined) {
     return process.env[key];
   }
-  // during client build / browser
   if (typeof import.meta !== 'undefined' && (import.meta as any).env?.[key] !== undefined) {
     return (import.meta as any).env[key];
   }
@@ -67,7 +65,6 @@ class AuditService {
   private config: AuditConfig;
   private tempEntries: AuditEntry[] = [];
   
-  // Phase configuration with German translations
   private readonly phaseConfig = {
     'initialization': { icon: '🚀', displayName: 'Initialisierung' },
     'retrieval': { icon: '🔍', displayName: 'Datensuche' },
@@ -77,7 +74,6 @@ class AuditService {
     'completion': { icon: '✅', displayName: 'Finalisierung' }
   };
 
-  // Action translations
   private readonly actionTranslations = {
     'pipeline-start': 'Analyse gestartet',
     'embeddings-search': 'Ähnliche Tools gesucht', 
@@ -95,7 +91,6 @@ class AuditService {
   }
 
     private loadConfig(): AuditConfig {
-    // use the helper if you added it
         const enabledFlag =
             (typeof import.meta !== 'undefined' &&
             (import.meta as any).env?.PUBLIC_FORENSIC_AUDIT_ENABLED) ?? 'false';
@@ -172,7 +167,6 @@ class AuditService {
     try {
         console.log('[AUDIT] Processing', rawAuditTrail.length, 'audit entries');
 
-        // Calculate summary statistics with safe defaults
         const totalTime = rawAuditTrail.reduce((sum, entry) => sum + (entry.processingTimeMs || 0), 0);
         const validConfidenceEntries = rawAuditTrail.filter(entry => typeof entry.confidence === 'number');
         const avgConfidence = validConfidenceEntries.length > 0 
@@ -182,7 +176,6 @@ class AuditService {
         const highConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) >= 80).length;
         const lowConfidenceSteps = rawAuditTrail.filter(entry => (entry.confidence || 0) < 60).length;
 
-        // Group entries by phase with safe handling
         const groupedEntries = rawAuditTrail.reduce((groups, entry) => {
         const phase = entry.phase || 'unknown';
         if (!groups[phase]) groups[phase] = [];
@@ -190,7 +183,6 @@ class AuditService {
         return groups;
         }, {} as Record<string, AuditEntry[]>);
 
-        // Process phases with error handling
         const phases = Object.entries(groupedEntries).map(([phase, entries]) => {
         const phaseConfig = this.phaseConfig[phase] || { icon: '📋', displayName: phase };
         const validEntries = entries.filter(entry => entry && typeof entry === 'object');
@@ -211,9 +203,8 @@ class AuditService {
   .map(e => this.compressEntry(e))
   .filter((e): e is CompressedAuditEntry => e !== null)
         };
-        }).filter(phase => phase.entries.length > 0); // Only include phases with valid entries
+        }).filter(phase => phase.entries.length > 0);
 
-        // Generate analysis summary
         const summary = this.generateSummary(rawAuditTrail, avgConfidence, lowConfidenceSteps);
 
         const result: ProcessedAuditTrail = {
@@ -261,12 +252,9 @@ class AuditService {
     }
   }
 
-  /**
-   * Compress data based on detail level
-   */
   private compressData(data: any): any {
     if (this.config.detailLevel === 'verbose') {
-      return data; // Keep full data
+      return data; 
     } else if (this.config.detailLevel === 'standard') {
       return this.summarizeForStorage(data);
     } else {
@@ -274,9 +262,6 @@ class AuditService {
     }
   }
 
-  /**
-   * Summarize data for display purposes
-   */
   private summarizeData(data: any): string {
     if (data === null || data === undefined) return 'null';
     if (typeof data === 'string') {
@@ -327,15 +312,11 @@ class AuditService {
     return data;
   }
 
-  /**
-   * Generate analysis summary
-   */
   private generateSummary(entries: AuditEntry[], avgConfidence: number, lowConfidenceSteps: number): {
     analysisQuality: 'excellent' | 'good' | 'fair' | 'poor';
     keyInsights: string[];
     potentialIssues: string[];
   } {
-    // Determine analysis quality
     let analysisQuality: 'excellent' | 'good' | 'fair' | 'poor';
     if (avgConfidence >= 85 && lowConfidenceSteps === 0) {
       analysisQuality = 'excellent';
@@ -347,7 +328,6 @@ class AuditService {
       analysisQuality = 'poor';
     }
 
-    // Generate key insights
     const keyInsights: string[] = [];
     const embeddingsUsed = entries.some(e => e.action === 'embeddings-search');
     if (embeddingsUsed) {
@@ -362,7 +342,6 @@ class AuditService {
       }
     }
 
-    // Identify potential issues
     const potentialIssues: string[] = [];
     if (lowConfidenceSteps > 2) {
       potentialIssues.push(`${lowConfidenceSteps} Analyseschritte mit niedriger Konfidenz`);
@@ -380,16 +359,10 @@ class AuditService {
     };
   }
 
-  /**
-   * Get translated action name
-   */
   getActionDisplayName(action: string): string {
     return this.actionTranslations[action] || action;
   }
 
-  /**
-   * Format duration for display
-   */
   formatDuration(ms: number): string {
     if (ms < 1000) return '< 1s';
     if (ms < 60000) return `${Math.ceil(ms / 1000)}s`;
@@ -398,30 +371,20 @@ class AuditService {
     return seconds > 0 ? `${minutes}m ${seconds}s` : `${minutes}m`;
   }
 
-  /**
-   * Get confidence color for UI
-   */
   getConfidenceColor(confidence: number): string {
     if (confidence >= 80) return 'var(--color-accent)';
     if (confidence >= 60) return 'var(--color-warning)';
     return 'var(--color-error)';
   }
 
-  /**
-   * Check if audit is enabled
-   */
   isEnabled(): boolean {
     return this.config.enabled;
   }
 
-  /**
-   * Get current configuration
-   */
   getConfig(): AuditConfig {
     return { ...this.config };
   }
 }
 
-// Export singleton instance
 export const auditService = new AuditService();
 export type { ProcessedAuditTrail, CompressedAuditEntry };
\ No newline at end of file
diff --git a/src/utils/embeddings.ts b/src/utils/embeddings.ts
index c14dce8..7ba3843 100644
--- a/src/utils/embeddings.ts
+++ b/src/utils/embeddings.ts
@@ -37,19 +37,17 @@ class EmbeddingsService {
   private readonly embeddingsPath = path.join(process.cwd(), 'data', 'embeddings.json');
   private readonly batchSize: number;
   private readonly batchDelay: number;
-  private enabled: boolean = false; // Make mutable again
+  private enabled: boolean = false;
 
   constructor() {
     this.batchSize = parseInt(process.env.AI_EMBEDDINGS_BATCH_SIZE || '20', 10);
     this.batchDelay = parseInt(process.env.AI_EMBEDDINGS_BATCH_DELAY_MS || '1000', 10);
     
-    // Don't call async method from constructor - handle in initialize() instead
-    this.enabled = true; // Start optimistically enabled for development
+    this.enabled = true;
   }
 
   private async checkEnabledStatus(): Promise<void> {
     try {
-      // Add debugging to see what's actually in process.env
       console.log('[EMBEDDINGS] Debug env check:', {
         AI_EMBEDDINGS_ENABLED: process.env.AI_EMBEDDINGS_ENABLED,
         envKeys: Object.keys(process.env).filter(k => k.includes('EMBEDDINGS')).length,
@@ -59,7 +57,6 @@ class EmbeddingsService {
       const envEnabled = process.env.AI_EMBEDDINGS_ENABLED;
       
       if (envEnabled === 'true') {
-        // Check if we have the required API configuration
         const endpoint = process.env.AI_EMBEDDINGS_ENDPOINT;
         const model = process.env.AI_EMBEDDINGS_MODEL;
         
@@ -74,7 +71,6 @@ class EmbeddingsService {
         return;
       }
       
-      // Check if embeddings file exists
       try {
         await fs.stat(this.embeddingsPath);
         console.log('[EMBEDDINGS] Existing embeddings file found - enabling');
@@ -103,7 +99,6 @@ class EmbeddingsService {
   }
 
   private async performInitialization(): Promise<void> {
-    // 1️⃣ Respect the on/off switch that the newer code introduced
     await this.checkEnabledStatus();
     if (!this.enabled) {
       console.log('[EMBEDDINGS] Embeddings disabled, skipping initialization');
@@ -114,14 +109,11 @@ class EmbeddingsService {
     try {
       console.log('[EMBEDDINGS] Initializing embeddings system…');
 
-      // Make sure the data folder exists
       await fs.mkdir(path.dirname(this.embeddingsPath), { recursive: true });
 
-      // Load current tools / concepts and generate a hash
       const toolsData        = await getCompressedToolsDataForAI();
-      const currentDataHash  = await this.hashToolsFile();   // <- keep the old helper
+      const currentDataHash  = await this.hashToolsFile();
 
-      // Try to read an existing file
       const existing         = await this.loadEmbeddings();
       console.log('[EMBEDDINGS] Current hash:', currentDataHash);
       console.log('[EMBEDDINGS] Existing file version:', existing?.version);
@@ -138,8 +130,7 @@ class EmbeddingsService {
         this.embeddings    = existing.embeddings;
       } else {
         console.log('[EMBEDDINGS] Generating new embeddings…');
-        // 2️⃣ Build and persist new vectors
-        await this.generateEmbeddings(toolsData, currentDataHash); // <- old helper
+        await this.generateEmbeddings(toolsData, currentDataHash);
       }
 
       this.isInitialized = true;
@@ -147,9 +138,8 @@ class EmbeddingsService {
     } catch (err) {
       console.error('[EMBEDDINGS] Failed to initialize:', err);
       this.isInitialized = false;
-      throw err;     // Let the caller know – same behaviour as before
+      throw err;
     } finally {
-      // 3️⃣ Always clear the promise so subsequent calls don't hang
       this.initializationPromise = null;
     }
   }
@@ -157,7 +147,7 @@ class EmbeddingsService {
   private async hashToolsFile(): Promise<string> {
     const file = path.join(process.cwd(), 'src', 'data', 'tools.yaml');
     const raw  = await fs.readFile(file, 'utf8');
-    return crypto.createHash('sha256').update(raw).digest('hex');   // 64-char hex
+    return crypto.createHash('sha256').update(raw).digest('hex');
   }
 
   private async loadEmbeddings(): Promise<EmbeddingsDatabase | null> {
@@ -298,7 +288,6 @@ class EmbeddingsService {
   }
 
   async waitForInitialization(): Promise<void> {
-    // Always re-check environment status first in case variables loaded after initial check
     await this.checkEnabledStatus();
     
     if (!this.enabled || this.isInitialized) {
@@ -313,7 +302,6 @@ class EmbeddingsService {
     return this.initialize();
   }
 
-  // Force re-check of environment status (useful for development)
   async forceRecheckEnvironment(): Promise<void> {
     this.enabled = false;
     this.isInitialized = false;
@@ -342,7 +330,6 @@ class EmbeddingsService {
     }
 
     try {
-      // If we have embeddings data, use it
       if (this.isInitialized && this.embeddings.length > 0) {
         console.log(`[EMBEDDINGS] Using embeddings data for similarity search: ${query}`);
         
@@ -394,7 +381,6 @@ class EmbeddingsService {
         return results;
 
       } else {
-        // Fallback: generate mock similarity results from actual tools data
         console.log(`[EMBEDDINGS] No embeddings data, using fallback text matching: ${query}`);
         
         const { getToolsData } = await import('./dataService.js');
@@ -407,17 +393,14 @@ class EmbeddingsService {
           .map((tool: any) => {
             let similarity = 0;
             
-            // Name matching
             if (tool.name.toLowerCase().includes(queryLower)) {
               similarity += 0.8;
             }
             
-            // Description matching
             if (tool.description && tool.description.toLowerCase().includes(queryLower)) {
               similarity += 0.6;
             }
             
-            // Tag matching
             if (tool.tags && Array.isArray(tool.tags)) {
               const matchingTags = tool.tags.filter((tag: string) => 
                 tag.toLowerCase().includes(queryLower) || queryLower.includes(tag.toLowerCase())
@@ -427,7 +410,6 @@ class EmbeddingsService {
               }
             }
             
-            // Word-level matching
             const toolText = `${tool.name} ${tool.description || ''} ${(tool.tags || []).join(' ')}`.toLowerCase();
             const matchingWords = queryWords.filter(word => toolText.includes(word));
             if (queryWords.length > 0) {
@@ -439,7 +421,7 @@ class EmbeddingsService {
               type: 'tool' as const,
               name: tool.name,
               content: toolText,
-              embedding: [], // Empty for fallback
+              embedding: [],
               metadata: {
                 domains: tool.domains || [],
                 phases: tool.phases || [],
@@ -465,10 +447,7 @@ class EmbeddingsService {
   }
 
   isEnabled(): boolean {
-    // If not enabled and not initialized, try re-checking environment
-    // This handles the case where environment variables loaded after initial check
     if (!this.enabled && !this.isInitialized) {
-      // Don't await this, just trigger it and return current status
       this.checkEnabledStatus().catch(console.error);
     }
     
@@ -477,7 +456,7 @@ class EmbeddingsService {
 
   getStats(): { enabled: boolean; initialized: boolean; count: number } {
     return {
-      enabled: this.enabled, // Always true during development
+      enabled: this.enabled,
       initialized: this.isInitialized,
       count: this.embeddings.length
     };
diff --git a/src/utils/nextcloud.ts b/src/utils/nextcloud.ts
index 5d2ae38..4bcb819 100644
--- a/src/utils/nextcloud.ts
+++ b/src/utils/nextcloud.ts
@@ -338,7 +338,7 @@ export class NextcloudUploader {
           info: {
             path: remotePath,
             exists: true,
-            response: text.substring(0, 200) + '...' // Truncated for safety
+            response: text.substring(0, 200) + '...'
           }
         };
       }
-- 
2.39.5


From 5795f3269f9e20f2291fa59360beb2ec99c8312c Mon Sep 17 00:00:00 2001
From: overcuriousity <overcuriousity@posteo.org>
Date: Thu, 7 Aug 2025 09:32:24 +0200
Subject: [PATCH 3/3] README, deploy script

---
 README.md | 670 ++++++++++++++++++++----------------------------------
 deploy.sh |   0
 2 files changed, 249 insertions(+), 421 deletions(-)
 create mode 100644 deploy.sh

diff --git a/README.md b/README.md
index b6f72a2..8273b37 100644
--- a/README.md
+++ b/README.md
@@ -1,232 +1,149 @@
 # ForensicPathways
 
-Ein kuratiertes Verzeichnis für Digital Forensics und Incident Response (DFIR) Tools, Methoden und Konzepte mit KI-gestützten Workflow-Empfehlungen.
+Ein umfassendes Verzeichnis digitaler Forensik- und Incident-Response-Tools mit KI-gestützten Empfehlungen basierend auf der NIST SP 800-86 Methodik.
 
-## ✨ Funktionen
+## Lizenz
 
-### 🎯 Hauptansichten
-- **Kachelansicht (Grid View):** Übersichtliche Kartenansicht aller Tools/Methoden
-- **Matrix-Ansicht:** Interaktive Matrix nach forensischen Domänen und Untersuchungsphasen (NIST Framework)
-- **Forensic-AI:** AI-gestützte Workflow-Empfehlungen basierend auf Szenario-Beschreibungen
+Dieses Projekt ist unter der BSD-3-Clause-Lizenz lizenziert.
 
-### 🔍 Navigation & Filterung
-- **Tag-System:** Intelligente Filterung nach Kategorien und Eigenschaften
-- **Volltext-Suche:** Durchsuchen von Namen, Beschreibungen und Tags
-- **Domain/Phase-Filter:** Filterung nach forensischen Bereichen und Ermittlungsphasen
+## Funktionen
 
-### 📚 Inhaltstypen
-- **Software/Tools:** Open Source und proprietäre forensische Software
-- **Methoden:** Bewährte forensische Verfahren und Prozesse
-- **Konzepte:** Grundlegendes Fachwissen und theoretische Grundlagen
+### Kernfunktionalität
+- **Umfassende Tool-Datenbank**: 100+ forensische Tools kategorisiert nach Domänen, Phasen und Skill-Levels
+- **NIST SP 800-86 Integration**: Vier-Phasen-Methodik (Sammlung → Auswertung → Analyse → Berichterstattung)
+- **Multiple Ansichtsmodi**: Kachelansicht, Matrix-Übersicht und KI-gestützte Empfehlungen
+- **Erweiterte Suche**: Textsuche, semantische Embedding-basierte Suche und Multi-Kriterien-Filterung
+- **Responsive Design**: Dark/Light-Mode-Unterstützung, mobile-optimierte Benutzeroberfläche
 
-### 📖 Knowledgebase
-- **Erweiterte Dokumentation:** Detaillierte Artikel zu Tools und Methoden
-- **Praktische Anleitungen:** Installation, Konfiguration und Best Practices
-- **Markdown-basiert:** Einfache Erstellung und Wartung von Inhalten
+### KI-gestützte Analyse
+- **Micro-Task-Pipeline**: Intelligente Tool-Auswahl durch mehrere KI-Analyseschritte
+- **Semantische Suche**: Vector-Embeddings für natürlichsprachige Tool-Entdeckung
+- **Konfidenz-Bewertung**: Transparente Vertrauensmetriken für KI-Empfehlungen
+- **Audit-Trail**: Vollständige Entscheidungstransparenz mit detaillierter Protokollierung
+- **Rate Limiting**: Intelligente Warteschlangenverwaltung und nutzerbasierte Ratenbegrenzung
 
-### 🤝 Contribution-System
-- **Tool/Methoden-Beiträge:** Webformular für neue Einträge
-- **Knowledgebase-Artikel:** Artikel-Editor mit Datei-Upload
-- **Git-Integration:** Automatische Issue-Erstellung für Review-Prozess
-- **File-Management:** Nextcloud-Integration für Medien-Uploads
+### Zusammenarbeit & Beiträge
+- **Tool-Beiträge**: Neue Tools einreichen oder bestehende über Git-Integration bearbeiten
+- **Knowledgebase**: Community-beigetragene Artikel und Dokumentation
+- **File-Upload-System**: Nextcloud-Integration für Medien-Anhänge
+- **Authentifizierung**: OIDC-Integration mit konfigurierbaren Anbietern
 
-### 🔐 Authentifizierung
-- **OIDC-Integration:** Single Sign-On mit OpenID Connect
-- **Berechtigungssteuerung:** Schutz für AI-Features und Contribution-System
-- **Session-Management:** Sichere JWT-basierte Sessions
+### Enterprise-Funktionen
+- **Warteschlangenverwaltung**: Ratenbegrenzte KI-Verarbeitung mit Echtzeit-Status-Updates
+- **Audit-Protokollierung**: Umfassender forensischer Audit-Trail für KI-Entscheidungsfindung
+- **Multi-Provider-Unterstützung**: Konfigurierbare KI-Services (Mistral AI, Ollama, OpenAI)
+- **Git-Integration**: Automatisierte Issue-Erstellung für Beiträge (Gitea, GitHub, GitLab)
 
-## 🛠 Technische Grundlage
+## Datenmodell
 
-- **Framework:** Astro 4.x mit TypeScript
-- **Styling:** CSS Custom Properties mit Dark/Light Mode
-- **API:** Node.js Backend mit Astro API Routes
-- **Datenbank:** YAML-basierte Konfiguration (tools.yaml)
+Das System verwendet eine YAML-basierte Konfiguration in `src/data/tools.yaml`:
 
-## 📋 Voraussetzungen
+```yaml
+tools:
+  - name: Tool Name
+    type: software|method|concept
+    description: Detaillierte Beschreibung
+    skillLevel: novice|beginner|intermediate|advanced|expert
+    url: https://tool-homepage.com
+    domains: [incident-response, static-investigations, ...]
+    phases: [data-collection, examination, analysis, reporting]
+    platforms: [Windows, Linux, macOS]
+    license: Lizenztyp
+    tags: [gui, commandline, ...]
+    related_concepts: [konzept1, konzept2]
+    # Optionale Felder
+    projectUrl: https://hosted-instance.com  # Für CC24-Server gehostete Tools
+    knowledgebase: true                      # Hat KB-Artikel
+    accessType: download|hosted|cloud
 
-- **Node.js:** Version 18.x oder höher
-- **npm:** Version 8.x oder höher
-- **Nginx:** Für Reverse Proxy (Produktion)
+domains:
+  - id: incident-response
+    name: Incident Response & Breach-Untersuchung
+    
+phases:
+  - id: data-collection
+    name: Datensammlung
+    description: Imaging, Akquisition, Remote-Collection-Tools
 
-## 🔧 Externe Abhängigkeiten (Optional)
-
-### OIDC Provider
-- **Zweck:** Benutzerauthentifizierung
-- **Beispiel:** Nextcloud, Keycloak, Auth0
-- **Konfiguration:** `OIDC_ENDPOINT`, `OIDC_CLIENT_ID`, `OIDC_CLIENT_SECRET`
-
-### Nextcloud
-- **Zweck:** File-Upload für Knowledgebase-Beiträge
-- **Features:** Medien-Management, öffentliche Links
-- **Konfiguration:** `NEXTCLOUD_ENDPOINT`, `NEXTCLOUD_USERNAME`, `NEXTCLOUD_PASSWORD`
-
-### AI Service (Mistral/OpenAI-kompatibel)
-- **Zweck:** KI-gestützte Tool-Empfehlungen
-- **Konfiguration:** `AI_ANALYZER_ENDPOINT`, `AI_ANALYZER_API_KEY`, `AI_ANALYZER_MODEL`
-
-### Uptime Kuma
-- **Zweck:** Status-Monitoring für gehostete Services
-- **Integration:** Status-Badges in der Service-Übersicht
-
-### Git Provider (Gitea/GitHub/GitLab)
-- **Zweck:** Issue-Erstellung für Contributions
-- **Konfiguration:** `GIT_PROVIDER`, `GIT_API_ENDPOINT`, `GIT_API_TOKEN`
-
-## 🚀 Installation
-
-### Lokale Entwicklung
-
-```bash
-# Repository klonen
-git clone https://git.cc24.dev/mstoeck3/forensic-pathways.git
-cd forensic-pathways
-
-# Dependencies installieren
-npm install
-
-# Umgebungsvariablen konfigurieren
-cp .env.example .env
-# .env bearbeiten (siehe Konfiguration unten)
-
-npm run astro build
-
-# Development Server starten
-npm run dev
+scenarios:
+  - id: scenario:memory_dump
+    icon: 🧠
+    friendly_name: RAM-Analyse
 ```
 
-Die Seite ist dann unter `http://localhost:4321` verfügbar.
+## AI Concept
 
-### Produktions-Deployment
+### Micro-Task Architecture
+The AI system uses a sophisticated pipeline that breaks complex analysis into focused micro-tasks:
 
-#### 1. System vorbereiten
+1. **Scenario Analysis**: Understanding the forensic context
+2. **Investigation Approach**: Determining optimal methodology  
+3. **Critical Considerations**: Identifying potential challenges
+4. **Tool Selection**: Phase-specific or problem-specific recommendations
+5. **Background Knowledge**: Relevant concepts and prerequisites
+6. **Final Synthesis**: Integrated recommendations with confidence scoring
 
+### Confidence Scoring
+Each recommendation includes transparent confidence metrics:
+- **Semantic Relevance**: Vector similarity between query and tool descriptions
+- **Task Suitability**: AI-assessed fitness for the specific scenario
+- **Uncertainty Factors**: Potential limitations and considerations
+- **Strength Indicators**: Why the tool is well-suited
+
+## NIST SP 800-86 Phases
+
+The system organizes tools according to the four-phase NIST methodology:
+
+1. **Data Collection**: Imaging, acquisition, and evidence preservation
+2. **Examination**: Parsing, extraction, and initial data processing  
+3. **Analysis**: Deep investigation, correlation, and insight generation
+4. **Reporting**: Documentation, visualization, and presentation
+
+Each tool is mapped to appropriate phases, enabling workflow-based recommendations.
+
+## Deployment
+
+### Production Setup
+
+1. **Build and Deploy**:
 ```bash
-# System-Updates
-sudo apt update && sudo apt upgrade -y
-
-# Node.js installieren (Ubuntu/Debian)
-curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
-sudo apt-get install -y nodejs
-
-# Nginx installieren
-sudo apt install nginx -y
-
-# Systemd für Service-Management
-sudo systemctl enable nginx
+npm run build
+sudo ./deploy.sh  # Copies dist/ to /var/www/forensic-pathways
 ```
 
-#### 2. Anwendung installieren
-
+2. **Configuration**:
 ```bash
-# Klonen des Repositorys
-sudo git clone https://git.cc24.dev/mstoeck3/forensic-pathways /opt/forensic-pathways
-cd /opt/forensic-pathways
-
-# Abhängigkeiten installieren
-sudo npm install
-
-# Production-Build erstellen
-sudo npm run build
-npm run astro build
-
-# Berechtigungen setzen
-sudo chown -R www-data:www-data /opt/forensic-pathways
+cd /var/www/forensic-pathways
+sudo cp .env.example .env
+sudo nano .env  # Configure AI services, authentication, etc.
 ```
 
-#### 3. Umgebungsvariablen konfigurieren
+3. **Systemd Service** (`/etc/systemd/system/forensic-pathways.service`):
+```ini
+[Unit]
+Description=ForensicPathways
+After=network.target
 
-Erstelle `/opt/forensic-pathways/.env`:
+[Service]
+Type=simple
+User=www-data
+WorkingDirectory=/var/www/forensic-pathways
+ExecStart=/usr/bin/node server/entry.mjs
+Restart=always
+RestartSec=10
+Environment=NODE_ENV=production
 
-```bash
-# ===========================================
-# ForensicPathways Environment Configuration
-# ===========================================
-
-# Authentication & OIDC (Required)
-AUTH_SECRET=change-this-to-a-strong-secret-key-in-production
-OIDC_ENDPOINT=https://your-oidc-provider.com
-OIDC_CLIENT_ID=your-oidc-client-id
-OIDC_CLIENT_SECRET=your-oidc-client-secret
-
-# Auth Scopes - set to true in prod
-AUTHENTICATION_NECESSARY_CONTRIBUTIONS=true
-AUTHENTICATION_NECESSARY_AI=true
-
-# Application Configuration (Required)
-PUBLIC_BASE_URL=https://your-domain.com
-NODE_ENV=production
-
-# AI Service Configuration (Required for AI features)
-AI_ANALYZER_MODEL=mistral-large-latest
-AI_ANALYZER_ENDPOINT=https://api.mistral.ai
-AI_ANALYZER_API_KEY=your-mistral-api-key
-AI_RATE_LIMIT_DELAY_MS=1000
-
-# Git Integration (Required for contributions)
-GIT_REPO_URL=https://git.cc24.dev/mstoeck3/forensic-pathways
-GIT_PROVIDER=gitea
-GIT_API_ENDPOINT=https://git.cc24.dev/api/v1
-GIT_API_TOKEN=your-git-api-token
-
-# File Upload Configuration (Optional)
-LOCAL_UPLOAD_PATH=./public/uploads
-
-# Nextcloud Integration (Optional)
-NEXTCLOUD_ENDPOINT=https://your-nextcloud.com
-NEXTCLOUD_USERNAME=your-username
-NEXTCLOUD_PASSWORD=your-password
-NEXTCLOUD_UPLOAD_PATH=/kb-media
-NEXTCLOUD_PUBLIC_URL=https://your-nextcloud.com/s/
+[Install]
+WantedBy=multi-user.target
 ```
 
-```bash
-# Berechtigungen sichern
-sudo chmod 600 /opt/forensic-pathways/.env
-sudo chown www-data:www-data /opt/forensic-pathways/.env
-```
-
-#### 4. Nginx konfigurieren
-
-Erstelle `/etc/nginx/sites-available/forensic-pathways`:
-
+4. **Nginx Configuration**:
 ```nginx
 server {
     listen 80;
-    server_name ihre-domain.de;
+    server_name forensic-pathways.yourdomain.com;
     
-    # Redirect HTTP to HTTPS
-    return 301 https://$server_name$request_uri;
-}
-
-server {
-    listen 443 ssl http2;
-    server_name ihre-domain.de;
-    
-    # SSL Konfiguration (Let's Encrypt empfohlen)
-    ssl_certificate /etc/letsencrypt/live/ihre-domain.de/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/ihre-domain.de/privkey.pem;
-    
-    # Security Headers
-    add_header X-Frame-Options DENY;
-    add_header X-Content-Type-Options nosniff;
-    add_header X-XSS-Protection "1; mode=block";
-    add_header Referrer-Policy "strict-origin-when-cross-origin";
-    
-    # Static Files
     location / {
-        try_files $uri $uri/ @nodejs;
-        root /opt/forensic-pathways/dist;
-        index index.html;
-        
-        # Cache static assets
-        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf)$ {
-            expires 1y;
-            add_header Cache-Control "public, immutable";
-        }
-    }
-    
-    # API Routes to Node.js
-    location @nodejs {
         proxy_pass http://localhost:4321;
         proxy_http_version 1.1;
         proxy_set_header Upgrade $http_upgrade;
@@ -236,251 +153,162 @@ server {
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
         proxy_cache_bypass $http_upgrade;
-        proxy_read_timeout 300s;
-        proxy_connect_timeout 75s;
     }
-    
-    # Upload limit
-    client_max_body_size 50M;
 }
 ```
 
+5. **Enable and Start**:
 ```bash
-# Site aktivieren
-sudo ln -s /etc/nginx/sites-available/forensic-pathways /etc/nginx/sites-enabled/
-sudo nginx -t
+sudo systemctl enable forensic-pathways
+sudo systemctl start forensic-pathways
 sudo systemctl reload nginx
 ```
 
-#### 5. Systemd Service einrichten
+### Environment Configuration
 
-Erstelle `/etc/systemd/system/forensic-pathways.service`:
-
-```ini
-[Unit]
-Description=ForensicPathways DFIR Guide
-After=network.target nginx.service
-Wants=nginx.service
-
-[Service]
-Type=exec
-User=www-data
-Group=www-data
-WorkingDirectory=/opt/forensic-pathways
-Environment=NODE_ENV=production
-ExecStart=/usr/bin/node ./dist/server/entry.mjs
-Restart=always
-RestartSec=10
-StandardOutput=journal
-StandardError=journal
-
-# Security
-NoNewPrivileges=yes
-PrivateTmp=yes
-ProtectSystem=strict
-ProtectHome=yes
-ReadWritePaths=/opt/forensic-pathways
-CapabilityBoundingSet=
-
-# Resource Limits
-LimitNOFILE=65536
-MemoryMax=512M
-
-[Install]
-WantedBy=multi-user.target
-```
+Key configuration in `.env`:
 
 ```bash
-# Service aktivieren und starten
-sudo systemctl daemon-reload
-sudo systemctl enable forensic-pathways
-sudo systemctl start forensic-pathways
+# Core Application
+PUBLIC_BASE_URL=https://forensic-pathways.yourdomain.com
+AUTH_SECRET=your-secure-random-secret
 
-# Status prüfen
-sudo systemctl status forensic-pathways
+# AI Services (Required)
+AI_ANALYZER_ENDPOINT=https://api.mistral.ai/v1/chat/completions
+AI_ANALYZER_API_KEY=your-api-key
+AI_ANALYZER_MODEL=mistral/mistral-small-latest
+
+# Vector Embeddings (Recommended)
+AI_EMBEDDINGS_ENABLED=true
+AI_EMBEDDINGS_ENDPOINT=https://api.mistral.ai/v1/embeddings
+AI_EMBEDDINGS_MODEL=mistral-embed
+
+# Authentication (Optional)
+AUTHENTICATION_NECESSARY_AI=false
+OIDC_ENDPOINT=https://your-keycloak.com/auth/realms/your-realm
+OIDC_CLIENT_ID=forensic-pathways
 ```
 
-## 🔧 Konfiguration
+## Externe Abhängigkeiten (Optionale Features)
 
-### Minimalkonfiguration (ohne Auth)
+### File-Upload-System
+- **Nextcloud**: Primärer Speicher für Beitrags-Anhänge
+- **Lokaler Fallback**: Automatischer Fallback zu lokalem Speicher bei Nextcloud-Ausfall
+
+### Authentifizierungsanbieter
+- **Keycloak**: Empfohlener OIDC-Provider
+- **Andere OIDC**: Jeder OIDC-konforme Provider (Auth0, Azure AD, etc.)
+
+### Git-Integration
+- **Gitea**: Primärer Git-Provider für Beiträge
+- **GitHub/GitLab**: Alternative Git-Provider unterstützt
+
+### Monitoring
+- **Uptime Kuma**: Service-Monitoring und Gesundheitschecks (optional)
+
+### KI-Services
+- **Mistral AI**: Empfohlen für Produktion (API-Schlüssel erforderlich)
+- **Ollama**: Lokale Deployment-Option (kein API-Schlüssel benötigt)
+- **OpenAI**: Alternative kommerzielle Anbieter
+
+## Knowledgebase-System
+
+### Artikel hinzufügen
+
+Knowledgebase-Artikel werden in `src/content/knowledgebase/` als Markdown-Dateien mit Frontmatter gespeichert:
+
+```markdown
+---
+title: "Tool-Konfigurationsanleitung"
+description: "Schritt-für-Schritt-Setup-Anweisungen"
+last_updated: 2024-01-15
+author: "Ihr Name"
+difficulty: intermediate
+
+# Tool-Zuordnung (optional)
+tool_name: "Autopsy"
+related_tools: ["Volatility 3", "YARA"]
+
+# Kategorisierung
+categories: ["konfiguration", "setup"]
+tags: ["gui", "installation", "windows"]
+
+published: true
+---
+
+# Tool-Konfigurationsanleitung
+
+Ihr Artikel-Inhalt hier...
+
+## Voraussetzungen
+- Systemanforderungen
+- Abhängigkeiten
+
+## Installationsschritte
+1. Download von offizieller Quelle
+2. Installer ausführen
+3. Einstellungen konfigurieren
+
+## Häufige Probleme
+Lösungen für typische Probleme...
+```
+
+### Artikel-Struktur-Richtlinien
+
+**Erforderliche Felder**:
+- `title`: Klarer, beschreibender Titel
+- `description`: Einzeilige Zusammenfassung für Auflistungen
+- `last_updated`: Artikel-Änderungsdatum
+- `published`: Boolean-Flag für Sichtbarkeit
+
+**Optionale Felder**:
+- `tool_name`: Zuordnung zu spezifischem Tool aus Datenbank
+- `author`: Mitwirkender Name (Standard: "Anon")
+- `difficulty`: Komplexitätslevel passend zu Tool-Skill-Levels
+- `categories`: Breite Klassifizierungen
+- `tags`: Spezifische Stichwörter für Entdeckung
+- `related_tools`: Array verwandter Tool-Namen
+
+**Inhalt-Richtlinien**:
+- Standard-Markdown-Formatierung verwenden
+- Praktische Beispiele und Code-Snippets einschließen
+- Screenshots oder Diagramme bei Bedarf hinzufügen
+- Zu verwandten Tools mit `[Tool Name](/tools/tool-slug)` Format verlinken
+- Troubleshooting-Abschnitte für komplexe Tools einschließen
+
+### Automatische Verarbeitung
+
+1. Artikel werden automatisch beim Build indexiert
+2. Tool-Zuordnungen erstellen bidirektionale Links
+3. Suche umfasst Volltext-Inhalt und Metadaten
+4. Verwandte Artikel erscheinen in Tool-Detail-Ansichten
+
+## Entwicklung
 
 ```bash
-# Nur für Tests geeignet
-AUTHENTICATION_NECESSARY=false
-PUBLIC_BASE_URL=http://localhost:4321
+# Setup
+npm install
+cp .env.example .env
+
+# Entwicklung
+npm run dev
+
+# Build
+npm run build
+
+# Deploy
+sudo ./deploy.sh
 ```
 
-### Tools-Datenbank
+## Konfigurationsübersicht
 
-Die Tools werden in `src/data/tools.yaml` verwaltet. Vollständiges Beispiel:
+Die `.env.example`-Datei enthält umfassende Konfigurationsoptionen für alle Features. Die meisten Optionen haben sinnvolle Standardwerte, wobei nur die KI-Service-Konfiguration für volle Funktionalität erforderlich ist.
 
-```yaml
-tools:
-  - name: Autopsy
-    type: software  # software|method|concept
-    description: >-
-      Die führende Open-Source-Alternative zu kommerziellen Forensik-Suiten mit
-      intuitiver grafischer Oberfläche. Besonders stark in der Timeline-Analyse,
-      Keyword-Suche und dem Carving gelöschter Dateien. Die modulare
-      Plugin-Architektur erlaubt Erweiterungen für spezielle
-      Untersuchungsszenarien.
-    icon: 📦
-    skillLevel: intermediate  # novice|beginner|intermediate|advanced|expert
-    url: https://www.autopsy.com/
-    domains:
-      - incident-response
-      - static-investigations
-      - malware-analysis
-      - mobile-forensics
-      - cloud-forensics
-    phases:
-      - examination
-      - analysis
-    platforms:
-      - Windows
-      - Linux
-    related_concepts:
-      - SQL Query Fundamentals
-      - Hash Functions & Digital Signatures
-    accessType: download  # download|web|api|cli|service
-    license: Apache 2.0
-    knowledgebase: false  # true für erweiterte Dokumentation
-    tags:
-      - gui
-      - filesystem
-      - timeline-analysis
-      - carving
-      - artifact-extraction
-      - keyword-search
-    # Optional: Für gehostete Services
-    projectUrl: https://autopsy.ihre-domain.de
-    statusUrl: https://status.ihre-domain.de/api/badge/1/status
-    
-  # Beispiel Methode
-  - name: Live Response Methodology
-    type: method
-    description: >-
-      Strukturierte Vorgehensweise zur Sammlung volatiler Daten
-      von laufenden Systemen ohne Shutdown.
-    icon: 📋
-    skillLevel: advanced
-    url: https://www.sans.org/white-papers/live-response/
-    domains:
-      - incident-response
-    phases:
-      - data-collection
-    related_concepts:
-      - Memory Forensics Fundamentals
-    tags:
-      - volatile-data
-      - live-analysis
-      - methodology
-    knowledgebase: true
-    
-  # Beispiel Konzept
-  - name: Hash Functions & Digital Signatures
-    type: concept
-    description: >-
-      Kryptographische Grundlagen für Datenintegrität und
-      Authentifizierung in der digitalen Forensik.
-    icon: 🔐
-    skillLevel: intermediate
-    url: https://en.wikipedia.org/wiki/Cryptographic_hash_function
-    domains:
-      - incident-response
-      - static-investigations
-      - malware-analysis
-    phases:
-      - data-collection
-      - examination
-    tags:
-      - cryptography
-      - data-integrity
-      - evidence-preservation
-    knowledgebase: false
+## Architektur
 
-# Konfiguration der Domänen
-domains:
-  - id: incident-response
-    name: Incident Response & Breach-Untersuchung
-  - id: static-investigations
-    name: Datenträgerforensik & Ermittlungen
-  - id: malware-analysis
-    name: Malware-Analyse & Reverse Engineering
-  - id: mobile-forensics
-    name: Mobile Geräte & App-Forensik
-  - id: cloud-forensics
-    name: Cloud & Virtuelle Umgebungen
-
-# Konfiguration der Phasen (NIST Framework)
-phases:
-  - id: data-collection
-    name: Datensammlung
-    description: Imaging, Acquisition, Remote Collection Tools
-  - id: examination
-    name: Auswertung
-    description: Parsing, Extraction, Initial Analysis Tools
-  - id: analysis
-    name: Analyse
-    description: Deep Analysis, Correlation, Visualization Tools
-  - id: reporting
-    name: Bericht & Präsentation
-    description: Documentation, Visualization, Presentation Tools
-
-# Domänenübergreifende Kategorien
-domain-agnostic-software:
-  - id: collaboration-general
-    name: Übergreifend & Kollaboration
-    description: Cross-cutting tools and collaboration platforms
-  - id: specific-os
-    name: Betriebssysteme
-    description: Operating Systems which focus on forensics
-```
-
-## 📦 Updates
-
-```bash
-# Repository aktualisieren
-cd /opt/forensic-pathways
-sudo git pull
-
-# Dependencies aktualisieren
-sudo npm install
-
-# Rebuild
-sudo npm run build
-
-# Service neustarten
-sudo systemctl restart forensic-pathways
-```
-
-## 💾 Backup
-
-Wichtige Dateien für Backup:
-
-```bash
-/opt/forensic-pathways/src/data/tools.yaml
-/opt/forensic-pathways/.env
-/etc/nginx/sites-available/forensic-pathways
-/etc/systemd/system/forensic-pathways.service
-```
-
-## 🤝 Beiträge
-
-Contributions sind willkommen! Bitte:
-
-1. Issue im Repository erstellen
-2. Feature-Branch erstellen
-3. Pull Request öffnen
-4. Tests durchführen
-
-## 📞 Support
-
-Bei Problemen oder Fragen:
-
-- **Issues:** [Repository Issues](https://git.cc24.dev/mstoeck3/forensic-pathways/issues)
-- **Dokumentation:** Siehe `/knowledgebase` auf der Website
-
-## 📄 Lizenz
-
-Dieses Projekt steht unter der **BSD-3-Clause** Lizenz.
\ No newline at end of file
+- **Frontend**: Astro mit TypeScript, responsive CSS
+- **Backend**: Node.js API-Routen mit intelligenter Ratenbegrenzung
+- **KI-Pipeline**: Micro-Task-Architektur mit Audit-Protokollierung
+- **Daten**: YAML-basierte Tool-Datenbank mit Git-basierten Beiträgen
+- **Suche**: Dual-Mode Text- und semantische Vector-Suche
+- **Auth**: OIDC-Integration mit Session-Management
\ No newline at end of file
diff --git a/deploy.sh b/deploy.sh
new file mode 100644
index 0000000..e69de29
-- 
2.39.5