Code Intelligence Graph

AST-Parsing + Dependency-Graph + Complexity-Analyse + Refactoring-Vorschläge + HTML-Report für Python-Codebasen.

Überblick

scripts/code-intelligence.py scannt alle .py-Dateien in openamer_cli/, scripts/ und tests/, baut einen vollständigen AST-basierten Code-Intelligence-Graph und exportiert:

• Funktionen: Name, Argumente, Rückgabetyp, Zeilen, Docstring, McCabe-Complexity
• Klassen: Name, Basisklassen, Methoden, Attribute, Docstring
• Imports: Modul, Namen, Aliase, interne/extern
• Abhängigkeiten: Welche Datei importiert welche andere (intern + extern)
• Zirkuläre Imports: Erkennt gegenseitige Import-Ketten

CLI-Modi

Flag	Beschreibung
--build	Scanner alle .py-Dateien und baut den Graph neu
--query TERM	Findet alle Referenzen zu Funktion/Klasse/Datei
--deps FILE	Zeigt Abhängigkeiten einer Datei
--complexity	Top-N komplexeste Funktionen (McCabe)
--suggest-refactor	Analysiert Graph & findet Refactoring-Kandidaten
--report	Generiert HTML-Report mit D3.js-Graph-Visualisierung
--json	Machine-readable JSON-Output
--no-cache	Ignoriert Cache, baut immer neu
--top N	Top N für --complexity (default: 10)

Verwendung

# Graph bauen
python scripts/code-intelligence.py --build

# Nach Funktionen/Dateien suchen
python scripts/code-intelligence.py --query 'cmd_cron'
python scripts/code-intelligence.py --query 'KanbanBoard'

# Abhängigkeiten anzeigen
python scripts/code-intelligence.py --deps 'openamer_cli/cron.py'

# Komplexität
python scripts/code-intelligence.py --complexity --top 20

# Refactoring-Vorschläge
python scripts/code-intelligence.py --suggest-refactor

# HTML-Report (mit D3.js Graph)
python scripts/code-intelligence.py --report

# Bauen + Report in einem Schritt
python scripts/code-intelligence.py --build --report

Exit-Codes

Code	Bedeutung
0	Erfolg
1	Fehler (ungültige Argumente)
2	Graph nicht gefunden
3	Abhängigkeitsfehler

Graph-Daten

Der Graph wird gespeichert als JSON unter: $OPENAMER_HOME\.code-intelligence\graph.json

Struktur:

{
  "meta": { "built_at": "...", "total_files": 2852, ... },
  "nodes": [
    {
      "file": "openamer_cli/cron.py",
      "lines": 500,
      "functions": [{ "name": "cron_list", "complexity": 18, ... }],
      "classes": [],
      "imports": [{ "module": "json", ... }],
      "internal_deps": ["openamer_cli/colors.py"]
    }
  ],
  "edges": [
    { "from": "openamer_cli/cron.py", "to": "openamer_cli/colors.py", "type": "import" }
  ]
}

Analyse-Kategorien (--suggest-refactor)

1. Zu große Dateien (>400 / >800 Zeilen)
2. Hochkomplexe Funktionen (CX ≥ 10)
3. Zirkuläre Imports
4. Skript-artige Dateien (keine Funktionen/Klassen, >50 Zeilen)
5. Meistgenutzte Imports
6. Lange Funktionen/Methoden (≥80 Zeilen)

Cron-Job

Der Graph wird automatisch alle 24h via Cron-Job neu gebaut: 0 */24 * * * python scripts/code-intelligence.py --build

Fehlerbehebung

• "Verzeichnis nicht gefunden": Die Scan-Dirs sind relativ zum REPO_DIR. Setze REPO_DIR in der Datei oder führe aus dem Repo-Root aus.
• Große Graphen: Bei 2800+ Dateien kann der Build 10-60 Sekunden dauern. Der Cache wird automatisch beim nächsten --build aktualisiert.
• Kein D3.js im Report: Der HTML-Report lädt D3.js via CDN (d3js.org). Bei fehlender Internetverbindung wird kein Graph gerendert, die Tabelle bleibt lesbar.