DocsKernkonzepteBug-Tracking & Journal

Bug-Tracking & Journal

Wie HelixMind automatisch Bugs erkennt, sie ĂĽber Sitzungen hinweg trackt und ein persistentes Bug-Journal fĂĽhrt.

Bug-Tracking & Journal

HelixMind erkennt automatisch Bugs im Code und fĂĽhrt ein persistentes Bug-Journal, das Probleme ĂĽber Sitzungen hinweg mit Beweisen und Statusupdates trackt.

Automatische Bug-Erkennung

Der Bug-Detektor scannt AI-generierten Code auf häufige Probleme:

Bug-TypWas erkannt wird
SicherheitSQL-Injection, XSS, Path Traversal, hartkodierte Secrets
PerformanceN+1 Queries, Memory Leaks, ineffiziente Schleifen
KorrektheitNull-Dereferenzierungen, Typenkonflikte, Race Conditions
WartbarkeitCode-Duplikation, zirkuläre Abhängigkeiten, Dead Code
StilInkonsistente Formatierung, Namensverletzungen

Die Erkennung läuft nach der Validierung und bevor Änderungen angewandt werden.

Bug-Journal

Jeder erkannte Bug wird im persistenten Journal gespeichert:

FeldBeschreibung
idEindeutiger Identifier
descriptionMenschenlesbare Bug-Beschreibung
fileDateipfad (falls zutreffend)
lineZeilennummer (falls zutreffend)
typeBug-Kategorie (Sicherheit, Performance, etc.)
statusopen → investigating → fixed → verified
evidenceScreenshots, Fehlermeldungen, Stack Traces
created_atWann der Bug erstmals erkannt wurde
updated_atLetzte Statusänderung

CLI-Befehle

BefehlBeschreibung
/bug listZeige alle Bugs mit Status
/bug show <id>Zeige Details fĂĽr einen spezifischen Bug
/bug fix <id>Markiere Bug als gefixt (mit Fix-Beschreibung)
/bug verify <id>Markiere Bug als verifiziert
/bug add-evidence <id>FĂĽge Beweis hinzu (Screenshot, Fehler)

Web-Dashboard-Integration

Das Web-Dashboard enthält eine Bug-Management-Oberfläche:

  • Bug-Listenansicht mit Filtern (Status, Typ, Datei)
  • Bug-Detailseite mit Beweis-Galerie
  • Timeline der Statusänderungen
  • Bugs zuweisen an Teammitglieder
  • Bugs exportieren als CSV/JSON

Beispiel-Workflow

1. AI schlägt Code mit möglicher SQL-Injection vor
2. Bug-Detektor markiert es als Sicherheitsproblem
3. Bug-Journal-Eintrag erstellt (Status: open)
4. Entwickler ĂĽberprĂĽft Bug im Web-Dashboard
5. Bug nach Code-Review als gefixt markiert
6. Beweis hinzugefĂĽgt (Screenshot des gefixten Codes)
7. Status auf verified aktualisiert

Konfiguration

Bug-Erkennung aktivieren/deaktivieren in .helixmind/config.json:

{
  "bugDetection": {
    "enabled": true,
    "security": true,
    "performance": true,
    "correctness": true,
    "maintainability": true,
    "style": false
  }
}
HelixMind — AI Coding CLI mit Spiral Memory