centicodehelp 0.2.0__py3-none-any.whl

centicodehelp/cli/commands/fix.py

@@ -0,0 +1,170 @@
+import os
+from pathlib import Path
+from typing import Optional, List, Tuple
+import click
+from rich.table import Table
+from rich.panel import Panel
+from rich.syntax import Syntax
+
+from centicodehelp.core.config import load_config
+from centicodehelp.analysis.detector import detect_language
+from centicodehelp.analysis.static_analyzer import StaticAnalyzer
+from centicodehelp.ai.llm_client import LLMClient
+from centicodehelp.ai.reviewer import AIReviewer, AIReviewResult
+from centicodehelp.ai.prompts import FIX_PROMPT_TEMPLATE
+from centicodehelp.fixer.patcher import PatchGenerator
+from centicodehelp.fixer.applier import PatchApplier
+from centicodehelp.cli.commands.scan import collect_files
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_SUCCESS,
+    COLOR_ERROR,
+    COLOR_CRITICAL,
+    COLOR_HIGH,
+    COLOR_MEDIUM,
+    COLOR_LOW,
+    COLOR_INFO,
+    COLOR_TEXT,
+)
+
+@click.command(name="fix", help="Vollautomatisch: Scan + KI-Audit + Auto-Fix mit Backup.")
+@click.argument("path", default=".", type=click.Path(exists=False), required=False)
+@click.option("--provider", default=None, help="KI-Anbieter (Standard: ollama).")
+@click.option("--model", default=None, help="Modellname (Standard: llama3.2).")
+@click.option("-y", "--yes", is_flag=True, default=False, help="Änderungen ohne Rückfrage anwenden.")
+def fix_cmd(path: str, provider: Optional[str], model: Optional[str], yes: bool):
+    """
+    ct fix [pfad] - Quellcode automatisch reparieren.
+
+    Ablauf:
+    1. Schneller statischer Scan
+    2. KI-Tiefenanalyse (Standard: Ollama / llama3.2)
+    3. Automatische Patch-Erstellung mit .bak-Backup
+    """
+    target = Path(path)
+    if not target.exists():
+        console.print(f"\n[bold {COLOR_ERROR}]❌ Pfad nicht gefunden:[/bold {COLOR_ERROR}] [white]{target}[/white]\n")
+        return
+
+    files = collect_files(target)
+    if not files:
+        console.print(f"\n[bold {COLOR_MEDIUM}]⚠️ Keine Dateien in {target} gefunden.[/bold {COLOR_MEDIUM}]\n")
+        return
+
+    config = load_config()
+    sel_provider = provider or config.default_provider
+    sel_model = model or config.default_model
+
+    console.print(
+        Panel(
+            f"[bold]Ziel:[/bold] [yellow]{target}[/yellow] ({len(files)} Datei(en))\n"
+            f"[bold]KI-Reparatur:[/bold] [bold {COLOR_PURPLE}]{sel_provider}/{sel_model}[/bold {COLOR_PURPLE}]\n"
+            f"[bold]Backups:[/bold] [green]Aktiviert (.bak Dateien)[/green]",
+            title=f"[bold {COLOR_PURPLE}]âš¡ centicodehelp AUTO-FIX[/bold {COLOR_PURPLE}]",
+            border_style=COLOR_INDIGO,
+            expand=False,
+        )
+    )
+    console.print()
+
+    try:
+        client = LLMClient(provider=sel_provider, model=sel_model)
+        reviewer = AIReviewer(client)
+    except Exception as e:
+        console.print(f"[bold {COLOR_ERROR}]❌ {e}[/bold {COLOR_ERROR}]\n")
+        return
+
+    static_analyzer = StaticAnalyzer()
+    applier = PatchApplier(backup=True)
+
+    total_inspected = 0
+    total_found_issues = 0
+    total_fixed_files = 0
+
+    files_with_fixes: List[Tuple[Path, str, str, str]] = []  # (file, lang, old_code, clean_code)
+
+    for f_path in files:
+        lang = detect_language(f_path)
+        if not lang or lang == "binary":
+            continue
+
+        total_inspected += 1
+        static_findings = static_analyzer.analyze_file(f_path, lang)
+        if not static_findings:
+            continue
+
+        total_found_issues += len(static_findings)
+
+        with console.status(f"[bold {COLOR_PURPLE}]Generiere KI-Lösung für {f_path.name}...[/bold {COLOR_PURPLE}]", spinner="dots12"):
+            try:
+                source_code = f_path.read_text(encoding="utf-8", errors="replace")
+                findings_text = "\n".join([f"- Zeile {f.line or '?'}: {f.description}" for f in static_findings])
+                fix_prompt = FIX_PROMPT_TEMPLATE.format(
+                    file_path=str(f_path),
+                    language=lang,
+                    findings_text=findings_text,
+                    source_code=source_code,
+                )
+                raw_fixed = client.complete(
+                    fix_prompt,
+                    system="Du bist ein Sicherheitsexperte. Ersetze eval() IMMER durch ast.literal_eval(). Entferne alle print() Debug-Meldungen. Gib NUR den korrigierten Code zurück."
+                )
+                clean_code = PatchGenerator.extract_code_from_markdown(raw_fixed)
+                diff = PatchGenerator.generate_diff(source_code, clean_code, file_path=f_path.name)
+
+                if diff:
+                    files_with_fixes.append((f_path, lang, source_code, clean_code))
+            except Exception as e:
+                console.print(f"[bold {COLOR_ERROR}]❌ Fehler bei {f_path.name}:[/bold {COLOR_ERROR}] {e}")
+
+    if not files_with_fixes:
+        console.print(f"[bold {COLOR_SUCCESS}]✅ Keine reparaturbedürftigen Fehler gefunden![/bold {COLOR_SUCCESS}]\n")
+        console.print(f"[dim]Geprüft: {total_inspected} Datei(en), 0 Korrekturen nötig.[/dim]\n")
+        return
+
+    # Zeige Vorschau
+    console.print(f"[bold #38BDF8]Korrekturen für {len(files_with_fixes)} Datei(en) vorbereitet:[/bold #38BDF8]")
+    for f_path, lang, old_c, new_c in files_with_fixes:
+        diff_text = PatchGenerator.generate_diff(old_c, new_c, file_path=f_path.name)
+        syntax_diff = Syntax(diff_text, "diff", theme="monokai", line_numbers=True)
+        console.print(
+            Panel(
+                syntax_diff,
+                title=f"[bold {COLOR_PURPLE}]Vorschau-Patch für {f_path.name}[/bold {COLOR_PURPLE}]",
+                border_style=COLOR_INDIGO,
+                expand=False,
+            )
+        )
+
+    # Sicherheitsabfrage
+    confirmed = yes
+    if not yes:
+        confirmed = click.confirm(
+            f"\n{len(files_with_fixes)} Datei(en) jetzt ändern? (Backups als .bak werden angelegt)",
+            default=True,
+        )
+
+    if confirmed:
+        for f_path, lang, old_c, new_c in files_with_fixes:
+            if applier.apply_fix(f_path, new_c):
+                total_fixed_files += 1
+                console.print(f"[bold {COLOR_SUCCESS}]✔ {f_path.name} erfolgreich gepatcht![/bold {COLOR_SUCCESS}] [dim]({f_path.name}.bak gesichert)[/dim]")
+            else:
+                console.print(f"[bold {COLOR_ERROR}]✘ Fehler beim Schreiben von {f_path.name}[/bold {COLOR_ERROR}]")
+    else:
+        console.print("[dim]Abgebrochen. Keine Dateien geändert.[/dim]")
+
+    # Abschluss-Zusammenfassung
+    console.print()
+    summary_panel = Panel(
+        f"[bold {COLOR_SUCCESS}]✅ {total_inspected} Dateien geprüft, {total_found_issues} Probleme gefunden, {total_fixed_files} Datei(en) behoben.[/bold {COLOR_SUCCESS}]",
+        title=f"[bold {COLOR_PURPLE}]âš¡ ZUSAMMENFASSUNG[/bold {COLOR_PURPLE}]",
+        border_style=COLOR_SUCCESS if total_fixed_files > 0 else COLOR_INDIGO,
+        expand=False,
+    )
+    console.print(summary_panel)
+    console.print()
+

centicodehelp/cli/commands/providers.py

@@ -0,0 +1,81 @@
+import click
+import time
+from rich.table import Table
+from rich.panel import Panel
+from rich.align import Align
+
+from centicodehelp.ai.providers import list_providers, get_provider
+from centicodehelp.core.config import load_config, save_config
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_TEXT,
+    COLOR_SUCCESS,
+    COLOR_ERROR,
+    COLOR_HIGH,
+)
+
+@click.command(name="providers", help="Unterstützte KI-Anbieter & Modelle anzeigen oder Standard wählen.")
+@click.option("--set-default", "set_default", type=str, help="Standard-KI-Anbieter festlegen (z. B. openai, anthropic, ollama)")
+@click.option("--details", is_flag=True, help="Detaillierte Liste aller Modelle und Umgebungsvariablen anzeigen.")
+def providers_cmd(set_default: str, details: bool):
+    """Befehl zur Inspektion und Konfiguration aller KI-Anbieter."""
+    config = load_config()
+
+    if set_default:
+        provider_info = get_provider(set_default)
+        if not provider_info:
+            console.print(f"\n[bold {COLOR_ERROR}]❌ Unbekannter Anbieter:[/bold {COLOR_ERROR}] '{set_default}'")
+            console.print(f"[dim]Nutze [bold {COLOR_BLUE}]ct providers[/bold {COLOR_BLUE}] für alle verfügbaren Optionen.[/dim]\n")
+            return
+
+        config.default_provider = provider_info.id
+        config.default_model = provider_info.default_model
+        save_config(config)
+        console.print(f"\n[bold {COLOR_SUCCESS}]✅ Standard-Anbieter erfolgreich gesetzt:[/bold {COLOR_SUCCESS}] [bold {COLOR_PURPLE}]{provider_info.name}[/bold {COLOR_PURPLE}] (Standard-Modell: [cyan]{provider_info.default_model}[/cyan])\n")
+        return
+
+    table = Table(
+        title=f"\n[bold {COLOR_PURPLE}]âš¡ centicodehelp KI-ANBIETER REGISTRY[/bold {COLOR_PURPLE}] [dim](via LiteLLM)[/dim]",
+        show_header=True,
+        header_style=f"bold {COLOR_BLUE}",
+        border_style=COLOR_INDIGO,
+        expand=True,
+    )
+    table.add_column("Provider ID", style=f"bold {COLOR_PURPLE}", width=14)
+    table.add_column("Anbieter", style="white", width=20)
+    table.add_column("Standard-Modell", style=f"bold {COLOR_BLUE}", width=24)
+    table.add_column("Auth / Env Variable", style="dim white", width=28)
+    table.add_column("Status", justify="center", width=14)
+
+    all_providers = list_providers()
+    for p in all_providers:
+        is_default = (p.id == config.default_provider)
+        status_badge = f"[bold on {COLOR_PURPLE}] AKTIV [/bold on {COLOR_PURPLE}]" if is_default else "[dim]Verfügbar[/dim]"
+        env_text = ", ".join(p.env_keys) if p.env_keys else f"[{COLOR_SUCCESS}]Lokal / Kein Key nötig[/{COLOR_SUCCESS}]"
+        table.add_row(p.id, p.name, p.default_model, env_text, status_badge)
+
+    console.print(table)
+    console.print(f"[dim]Tipp: [bold {COLOR_BLUE}]ct providers --set-default <id>[/bold {COLOR_BLUE}] ändert den Standard-Anbieter.[/dim]\n")
+
+    if details:
+        console.print(f"[bold {COLOR_PURPLE}]Detaillierte Modellübersicht:[/bold {COLOR_PURPLE}]")
+        for p in all_providers:
+            model_items = []
+            for m in p.models:
+                marker = "⭐ " if m.is_default else "• "
+                model_items.append(f"  {marker}[bold {COLOR_BLUE}]{m.name}[/bold {COLOR_BLUE}] [dim]({m.description})[/dim]")
+            
+            panel_text = f"[bold]Beschreibung:[/bold] {p.description}\n[bold]Modelle:[/bold]\n" + "\n".join(model_items)
+            console.print(
+                Panel(
+                    panel_text,
+                    title=f"[bold {COLOR_PURPLE}]{p.name}[/bold {COLOR_PURPLE}] [dim]({p.id})[/dim]",
+                    border_style=COLOR_INDIGO,
+                    expand=False,
+                )
+            )
+        console.print()
+

centicodehelp/cli/commands/scan.py

@@ -0,0 +1,129 @@
+import os
+from pathlib import Path
+from typing import Optional, List
+import click
+from rich.table import Table
+from rich.panel import Panel
+
+from centicodehelp.analysis.detector import detect_language
+from centicodehelp.analysis.static_analyzer import StaticAnalyzer
+from centicodehelp.analysis.binary_analyzer import BinaryAnalyzer
+from centicodehelp.core.models import Finding, Severity
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_SUCCESS,
+    COLOR_ERROR,
+    COLOR_CRITICAL,
+    COLOR_HIGH,
+    COLOR_MEDIUM,
+    COLOR_LOW,
+    COLOR_INFO,
+    COLOR_TEXT,
+)
+
+SEVERITY_STYLES = {
+    Severity.CRITICAL: (COLOR_CRITICAL, "🔴 CRITICAL"),
+    Severity.HIGH: (f"bold {COLOR_HIGH}", "🟠 HIGH"),
+    Severity.MEDIUM: (f"bold {COLOR_MEDIUM}", "🟡 MEDIUM"),
+    Severity.LOW: (f"{COLOR_LOW}", "🔵 LOW"),
+    Severity.INFO: (f"{COLOR_INFO}", "⚪ INFO"),
+}
+
+def collect_files(target_path: Path) -> List[Path]:
+    """Sammelt rekursiv alle analysierbaren Quellcode-Dateien."""
+    if target_path.is_file():
+        return [target_path]
+    files_to_analyze: List[Path] = []
+    for root, dirs, files in os.walk(target_path):
+        dirs[:] = [
+            d for d in dirs
+            if not d.startswith(".")
+            and d not in ("node_modules", "target", "build", "dist", "__pycache__", "venv", ".venv", "env")
+        ]
+        for f in files:
+            files_to_analyze.append(Path(root) / f)
+    return files_to_analyze
+
+
+@click.command(name="scan", help="Schnelle statische Analyse (ohne KI) für einen Ordner oder eine Datei.")
+@click.argument("path", default=".", type=click.Path(exists=False), required=False)
+def scan_cmd(path: str):
+    """
+    ct scan [pfad] - Schnelle statische Code- und Sicherheitsanalyse.
+
+    Prüft Code ohne KI auf Fehler, Sicherheitslücken und Bad Practices.
+    Standard: Aktueller Ordner (.)
+    """
+    target = Path(path)
+    if not target.exists():
+        console.print(f"\n[bold {COLOR_ERROR}]❌ Pfad nicht gefunden:[/bold {COLOR_ERROR}] [white]{target}[/white]\n")
+        return
+
+    files = collect_files(target)
+    if not files:
+        console.print(f"\n[bold {COLOR_MEDIUM}]⚠️ Keine analysierbaren Dateien in {target} gefunden.[/bold {COLOR_MEDIUM}]\n")
+        return
+
+    static_analyzer = StaticAnalyzer()
+    binary_analyzer = BinaryAnalyzer()
+    all_findings: List[Finding] = []
+
+    with console.status(f"[bold {COLOR_PURPLE}]Scanne {len(files)} Datei(en) in {target}...[/bold {COLOR_PURPLE}]", spinner="dots"):
+        for f in files:
+            lang = detect_language(f)
+            if not lang:
+                continue
+            if lang == "binary":
+                all_findings.extend(binary_analyzer.analyze_binary(f))
+            else:
+                all_findings.extend(static_analyzer.analyze_file(f, lang))
+
+    # Kurzausgabe nach Schweregrad
+    sev_counts = {
+        Severity.CRITICAL: 0,
+        Severity.HIGH: 0,
+        Severity.MEDIUM: 0,
+        Severity.LOW: 0,
+        Severity.INFO: 0,
+    }
+    for item in all_findings:
+        sev_counts[item.severity] = sev_counts.get(item.severity, 0) + 1
+
+    console.print()
+    if not all_findings:
+        console.print(
+            Panel(
+                f"[bold {COLOR_SUCCESS}]✅ Alles sauber![/bold {COLOR_SUCCESS}] Keine Probleme in [cyan]{len(files)}[/cyan] Datei(en) gefunden.",
+                title=f"[bold {COLOR_PURPLE}]âš¡ centicodehelp SCAN[/bold {COLOR_PURPLE}]",
+                border_style=COLOR_SUCCESS,
+                expand=False,
+            )
+        )
+        console.print()
+        return
+
+    table = Table(
+        title=f"[bold {COLOR_PURPLE}]âš¡ SCAN-ERGEBNIS:[/bold {COLOR_PURPLE}] [yellow]{target}[/yellow] ({len(files)} Datei(en))",
+        show_header=True,
+        header_style=f"bold {COLOR_BLUE}",
+        border_style=COLOR_INDIGO,
+    )
+    table.add_column("Schweregrad", width=16)
+    table.add_column("Anzahl", justify="right", width=10)
+    table.add_column("Status", width=20)
+
+    for sev in (Severity.CRITICAL, Severity.HIGH, Severity.MEDIUM, Severity.LOW, Severity.INFO):
+        count = sev_counts[sev]
+        color, badge = SEVERITY_STYLES[sev]
+        status_text = f"[{color}]{count} gefunden[/{color}]" if count > 0 else "[dim]0 gefunden[/dim]"
+        table.add_row(f"[{color}]{badge}[/{color}]", str(count), status_text)
+
+    console.print(table)
+    console.print(
+        f"[dim]Tipp: Nutze [bold {COLOR_BLUE}]ct fix[/bold {COLOR_BLUE}] zur automatischen Reparatur oder "
+        f"[bold {COLOR_BLUE}]ct check <datei>[/bold {COLOR_BLUE}] für Datei-Details.[/dim]\n"
+    )
+

centicodehelp/cli/commands/setup.py

@@ -0,0 +1,93 @@
+import click
+from rich.panel import Panel
+from rich.table import Table
+
+from centicodehelp.core.config import load_config, save_config, get_config_path
+from centicodehelp.ai.providers import list_providers, get_provider
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_SUCCESS,
+    COLOR_TEXT,
+)
+
+@click.command(name="setup", help="Interaktiver Einrichtungsassistent für KI-Anbieter & Modelle.")
+def setup_cmd():
+    """
+    ct setup - Interaktiver Wizard: Anbieter, API-Keys und Modelle kinderleicht konfigurieren.
+    """
+    config = load_config()
+
+    console.print()
+    console.print(
+        Panel(
+            "[bold #38BDF8]Willkommen beim CentiCodeHelp Setup-Assistenten![/bold #38BDF8]\n"
+            "Hier kannst du deinen gewünschten KI-Anbieter und API-Schlüssel einrichten.",
+            title=f"[bold {COLOR_PURPLE}]âš¡ CENTICODEHELP SETUP[/bold {COLOR_PURPLE}]",
+            border_style=COLOR_INDIGO,
+            expand=False,
+        )
+    )
+    console.print()
+
+    # 1. Anbieter-Auswahl
+    console.print("[bold white]1. Wähle deinen bevorzugten KI-Anbieter:[/bold white]")
+    console.print("  [bold cyan]1[/bold cyan] - [bold green]Ollama[/bold green] [dim](Lokal, kostenlos, kein API-Key nötig)[/dim] ⭐ [italic]Standard[/italic]")
+    console.print("  [bold cyan]2[/bold cyan] - [bold blue]OpenAI[/bold blue] (GPT-4o, GPT-4o-mini)")
+    console.print("  [bold cyan]3[/bold cyan] - [bold yellow]Anthropic[/bold yellow] (Claude 3.5 Sonnet)")
+    console.print("  [bold cyan]4[/bold cyan] - [bold magenta]DeepSeek[/bold magenta] (DeepSeek Coder / V3)")
+    console.print("  [bold cyan]5[/bold cyan] - [bold red]Google Gemini[/bold red] (Gemini 1.5 Pro / Flash)")
+    console.print("  [bold cyan]6[/bold cyan] - [bold white]Anderer Anbieter[/bold white] (Groq, Mistral, OpenRouter etc.)")
+    console.print()
+
+    choice = click.prompt("Deine Wahl [1-6]", default="1", type=str)
+    provider_map = {
+        "1": ("ollama", "qwen2.5-coder:7b"),
+        "2": ("openai", "gpt-4o"),
+        "3": ("anthropic", "claude-3-5-sonnet"),
+        "4": ("deepseek", "deepseek-coder"),
+        "5": ("gemini", "gemini-1.5-pro"),
+    }
+
+    if choice in provider_map:
+        sel_provider, sel_default_model = provider_map[choice]
+    else:
+        sel_provider = click.prompt("Gib die Provider-ID ein (z. B. groq, mistral, openrouter)", default="groq").strip().lower()
+        p_info = get_provider(sel_provider)
+        sel_default_model = p_info.default_model if p_info else "default"
+
+    # 2. Modell-Auswahl
+    model_choice = click.prompt(f"Modellname festlegen", default=sel_default_model)
+
+    # 3. API-Key falls Cloud-Anbieter
+    if sel_provider != "ollama":
+        current_key = config.api_keys.get(sel_provider, "")
+        prompt_text = f"API-Key für {sel_provider} eingeben"
+        if current_key:
+            prompt_text += f" [aktuell: ••••{current_key[-4:] if len(current_key) > 4 else '••••'}]"
+        new_key = click.prompt(prompt_text, default=current_key or "", hide_input=True)
+        if new_key:
+            config.api_keys[sel_provider] = new_key
+
+    # 4. Speichern
+    config.default_provider = sel_provider
+    config.default_model = model_choice
+    save_config(config)
+
+    console.print()
+    console.print(
+        Panel(
+            f"[bold {COLOR_SUCCESS}]✅ Setup fertig gespeichert![/bold {COLOR_SUCCESS}]\n\n"
+            f"[bold white]Standard-Anbieter:[/bold white] [bold {COLOR_PURPLE}]{sel_provider}[/bold {COLOR_PURPLE}]\n"
+            f"[bold white]Standard-Modell:[/bold white] [bold cyan]{model_choice}[/bold cyan]\n"
+            f"[bold white]Konfigurationsdatei:[/bold white] [dim]{get_config_path()}[/dim]\n\n"
+            f"Nutze [bold #38BDF8]ct fix[/bold #38BDF8] oder [bold #38BDF8]ct scan[/bold #38BDF8] zum Starten.",
+            title=f"[bold {COLOR_PURPLE}]âš¡ SETUP ABGESCHLOSSEN[/bold {COLOR_PURPLE}]",
+            border_style=COLOR_SUCCESS,
+            expand=False,
+        )
+    )
+    console.print()
+

centicodehelp/cli/commands/update.py

@@ -0,0 +1,51 @@
+import time
+import click
+from rich.progress import Progress, SpinnerColumn, BarColumn, TextColumn
+from rich.panel import Panel
+
+from centicodehelp import __version__
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_SUCCESS,
+    COLOR_TEXT,
+)
+
+@click.command(name="update", help="centicodehelp auf die neueste Version aktualisieren.")
+@click.option("--check-only", is_flag=True, help="Nur prüfen, ob Aktualisierungen vorhanden sind.")
+def update_cmd(check_only: bool):
+    """Aktualisierungsroutine mit moderner Animation."""
+    console.print(f"\n[bold {COLOR_PURPLE}]âš¡ centicodehelp Updater[/bold {COLOR_PURPLE}] [dim](Installiert: v{__version__})[/dim]\n")
+
+    with Progress(
+        SpinnerColumn(spinner_name="dots12", style=COLOR_PURPLE),
+        TextColumn("[progress.description]{task.description}"),
+        BarColumn(complete_style=COLOR_BLUE, finished_style=COLOR_SUCCESS),
+        console=console,
+    ) as progress:
+        task1 = progress.add_task("[bold #818CF8]Verbindung zum Upstream-Repository herstellen...", total=100)
+        for _ in range(50):
+            time.sleep(0.015)
+            progress.update(task1, advance=2)
+
+        task2 = progress.add_task("[bold #38BDF8]Prüfe Release-Metadaten & Checksummen...", total=100)
+        for _ in range(50):
+            time.sleep(0.012)
+            progress.update(task2, advance=2)
+
+    if check_only:
+        console.print(f"\n[bold {COLOR_SUCCESS}]✅ centicodehelp ist auf dem neuesten Stand![/bold {COLOR_SUCCESS}] [dim](v{__version__})[/dim]\n")
+        return
+
+    console.print(
+        Panel(
+            f"[bold {COLOR_SUCCESS}]✅ centicodehelp ist bereits die aktuellste Version (v{__version__})![/bold {COLOR_SUCCESS}]\n"
+            f"[dim]Keine Aktualisierung erforderlich. Alle Module (CLI, AST-Engine, AI-Clients) sind einsatzbereit.[/dim]",
+            border_style=COLOR_PURPLE,
+            expand=False,
+        )
+    )
+    console.print()
+

centicodehelp/cli/main.py

@@ -0,0 +1,141 @@
+import click
+import sys
+from rich.table import Table
+
+from centicodehelp import __version__
+from centicodehelp.cli.theme import (
+    console,
+    COLOR_PURPLE,
+    COLOR_BLUE,
+    COLOR_INDIGO,
+    COLOR_TEXT,
+    COLOR_SUCCESS,
+)
+from centicodehelp.cli.banner import print_banner
+from centicodehelp.cli.commands.scan import scan_cmd
+from centicodehelp.cli.commands.fix import fix_cmd
+from centicodehelp.cli.commands.ai import ai_cmd
+from centicodehelp.cli.commands.check import check_cmd
+from centicodehelp.cli.commands.setup import setup_cmd
+from centicodehelp.cli.commands.analyze import analyze_cmd
+from centicodehelp.cli.commands.providers import providers_cmd
+from centicodehelp.cli.commands.config import config_cmd
+from centicodehelp.cli.commands.update import update_cmd
+
+
+class CentiCodeHelpCLI(click.Group):
+    """Custom click Group with stylish banner and formatted command help."""
+
+    def get_command(self, ctx, cmd_name):
+        rv = click.Group.get_command(self, ctx, cmd_name)
+        if rv is not None:
+            return rv
+        matches = [x for x in self.list_commands(ctx) if x.startswith(cmd_name)]
+        if not matches:
+            return None
+        elif len(matches) == 1:
+            return click.Group.get_command(self, ctx, matches[0])
+        ctx.fail(f"Zu viele Treffer für '{cmd_name}': {', '.join(sorted(matches))}")
+
+    def format_help(self, ctx, formatter):
+        """Render stylish help with Centi09 gradient logo and modern tables."""
+        print_banner(include_slogan=True)
+
+        commands_table = Table(
+            show_header=True,
+            header_style=f"bold {COLOR_PURPLE}",
+            border_style=COLOR_INDIGO,
+            box=None,
+            padding=(0, 2),
+        )
+        commands_table.add_column("Befehl", style=f"bold {COLOR_BLUE}", width=14)
+        commands_table.add_column("Beschreibung", style=COLOR_TEXT)
+
+        command_descriptions = {
+            "scan": "⚡ Statische Analyse (ohne KI) - schnell & übersichtlich.",
+            "fix": "🛠️ Vollautomatisch: Scan + KI-Audit + Auto-Fix (mit .bak-Backup).",
+            "ai": "🤖 Reine KI-Tiefenanalyse (Standard: Ollama / qwen2.5-coder:7b).",
+            "check": "🔍 Schnellcheck einer einzelnen Datei mit klaren Hinweisen.",
+            "setup": "⚙️ Interaktiver Setup-Assistent für KI-Anbieter & API-Keys.",
+            "analyze": "[dim]Erweiterte Analyse mit detaillierten Flags (--ai, --fix, --json).[/dim]",
+            "providers": "[dim]Unterstützte KI-Anbieter & Modelle auflisten.[/dim]",
+            "config": "[dim]Konfiguration und API-Schlüssel manuell verwalten.[/dim]",
+            "update": "[dim]CentiCodeHelp auf die neueste Version aktualisieren.[/dim]",
+        }
+
+        priority_order = ["scan", "fix", "ai", "check", "setup", "analyze", "providers", "config", "update"]
+        for cmd_name in priority_order:
+            if cmd_name in self.list_commands(ctx):
+                desc = command_descriptions.get(cmd_name, "")
+                commands_table.add_row(cmd_name, desc)
+
+        console.print("[bold #818CF8]BEFEHLE (centicodehelp / cch / ct):[/bold #818CF8]")
+        console.print(commands_table)
+        console.print()
+
+        options_table = Table(
+            show_header=True,
+            header_style=f"bold {COLOR_PURPLE}",
+            border_style=COLOR_INDIGO,
+            box=None,
+            padding=(0, 2),
+        )
+        options_table.add_column("Option", style=f"bold {COLOR_BLUE}", width=14)
+        options_table.add_column("Beschreibung", style=COLOR_TEXT)
+        options_table.add_row("--version", "Zeigt Version und Logo an.")
+        options_table.add_row("--help", "Zeigt diese Hilfe an.")
+
+        console.print("[bold #818CF8]ALLGEMEINE OPTIONEN:[/bold #818CF8]")
+        console.print(options_table)
+        console.print()
+        console.print(f"[dim]Tipp: Starte mit [bold {COLOR_BLUE}]cch scan[/bold {COLOR_BLUE}] oder repariere mit [bold {COLOR_BLUE}]cch fix[/bold {COLOR_BLUE}]. (Auch als [bold {COLOR_BLUE}]ct[/bold {COLOR_BLUE}] und [bold {COLOR_BLUE}]centicodehelp[/bold {COLOR_BLUE}] verfügbar)[/dim]\n")
+
+
+def version_callback(ctx, param, value):
+    if not value or ctx.resilient_parsing:
+        return
+    print_banner(include_slogan=True)
+    ctx.exit()
+
+
+@click.group(cls=CentiCodeHelpCLI, invoke_without_command=True)
+@click.option(
+    "--version",
+    is_flag=True,
+    callback=version_callback,
+    expose_value=False,
+    is_eager=True,
+    help="Version und Logo anzeigen.",
+)
+@click.pass_context
+def cli(ctx):
+    """CentiCodeHelp (centicodehelp / cch / ct) - Dein Code. Besser. Sauber."""
+    if ctx.invoked_subcommand is None:
+        print_banner(include_slogan=True)
+        console.print(f"[dim]Tipp: Nutze [bold {COLOR_BLUE}]cch scan[/bold {COLOR_BLUE}], [bold {COLOR_BLUE}]cch fix[/bold {COLOR_BLUE}] oder [bold {COLOR_BLUE}]cch --help[/bold {COLOR_BLUE}] zum Starten.[/dim]\n")
+
+
+# Register simplified commands
+cli.add_command(scan_cmd)
+cli.add_command(fix_cmd)
+cli.add_command(ai_cmd)
+cli.add_command(check_cmd)
+cli.add_command(setup_cmd)
+
+# Register power-user commands
+cli.add_command(analyze_cmd)
+cli.add_command(providers_cmd)
+cli.add_command(config_cmd)
+cli.add_command(update_cmd)
+
+
+def main():
+    try:
+        cli()
+    except Exception as e:
+        console.print(f"\n[bold #f87171]❌ Fehler:[/bold #f87171] [white]{e}[/white]\n")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()