# 🔍 CodePulse CLI

### 🚀 Fortschrittliche Architektur-Intelligenz & Code-Health-Engine **Architektur-Intelligenz • Semantische Modellierung • Echtzeit-Monitoring • KI-Agenten-Bereit** CodePulse ist eine Architektur-Health-Engine der nächsten Generation, entwickelt für große JavaScript-, TypeScript-, Python- und gemischte Projekte. Sie bietet tiefe, systemische Einblicke in Codestrukturen, Abhängigkeitsrisiken und evolutionäre Trends, sodass Teams und KI-Agenten robuste und wartbare Codebasen mit chirurgischer Präzision aufrechterhalten können. **v5.2 Evolution:** Mit unserem neuen nichtlinearen Scoring-Modell, der 🛡️️ Confidence Metric und dem **Architectural Ghost Mode**. ![CodePulse Health](../badge.svg) [![NPM Version](https://img.shields.io/npm/v/@archpulse/codepulse?style=for-the-badge&color=0ea5e9)](https://www.npmjs.com/package/@archpulse/codepulse) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT) [![Node Version](https://img.shields.io/badge/Node-16%2B-brightgreen?style=for-the-badge)](https://nodejs.org/) --- ### 🌐 Mehrsprachige Unterstützung [English](../README.md) | [Українська](./README.ua.md) | [Русский](./README.ru.md) | [Čeština](./README.cs.md) | [한국어](./README.ko.md) | [Deutsch](./README.de.md) | [Français](./README.fr.md) ### 📖 Vollständige Dokumentation [English](../docs/CODEPULSE_FULL_DOCS.md) | [Українська](./CODEPULSE_FULL_DOCS.ua.md) | [Русский](./CODEPULSE_FULL_DOCS.ru.md) | [Čeština](./CODEPULSE_FULL_DOCS.cs.md) | [한국어](./CODEPULSE_FULL_DOCS.ko.md) | [Deutsch](./CODEPULSE_FULL_DOCS.de.md) | [Français](./CODEPULSE_FULL_DOCS.fr.md)

--- ## ⚡ Schnellstart ### Installation ```bash npm install -g @archpulse/codepulse ``` ### Erster Scan ```bash # Analysieren Sie Ihr Projekt und erstellen Sie einen HTML-Bericht codepulse scan . # Starten Sie das interaktive Echtzeit-TUI-Dashboard codepulse watch . ``` --- ## 🚀 Performance & Analyse-Engines CodePulse bietet zwei verschiedene Analysepfade, die für unterschiedliche Workflows optimiert sind. Wir erstellen ein umfassendes systemisches Modell Ihres gesamten Projekts, das weit über standardmäßiges dateibasiertes Linting hinausgeht. ### Fast Mode (Ultraschnelles Scannen) *Fokus: Sofortiges Feedback zur grundlegenden Architekturgesundheit.* | Tool | Engine | Laufzeit (s) | |------|--------|--------------| | **ESLint** | Baseline | ~4.8s | | **CodePulse** | **Oxlint Engine** | **~2.8s** | ### Extended Analysis Mode (Volle Ökosystem-Kompatibilität) *Fokus: Tiefe architektonische Einblicke, komplexe Abhängigkeitsanalysen und volle ESLint-Regelkompatibilität.* | Tool | Engine | Laufzeit (s) | |------|--------|--------------| | **ESLint** | Raw Baseline | ~3.3s | | **CodePulse** | **ESLint + Systemic Analysis** | **~5.5s** | > **Warum der Unterschied?** > Im **Extended Analysis Mode** führt CodePulse die gesamte ESLint-Suite Ihres Projekts aus **plus** seine eigene systemische Analyse (Abhängigkeitsgraph, Zyklen-Erkennung, Prüfung architektonischer Grenzen und historische Fluktuation). Das Ergebnis ist ein einheitlicher Bericht, der Ökosystem-Standard-Linting mit tiefer struktureller Intelligenz kombiniert. --- ## 🔍 Scan-Modi & Engines ### Engine-Auswahl ```bash # Automatische Erkennung (Standard) # Verwendet ESLint, falls eine Konfiguration gefunden wird, andernfalls Oxlint codepulse scan . # Ultraschnellen Modus erzwingen (Oxlint-basiert) codepulse scan . --engine oxlint # Erweiterten Analysemodus erzwingen (höhere Präzision & Kompatibilität) codepulse scan . --engine eslint # oder codepulse scan . --precision ``` ### Verbose / Debug-Modi ```bash # Nur Probleme auf Programmebene anzeigen codepulse scan . -d # Linter-Debug-Modus (zeigt Rohausgaben der zugrunde liegenden Tools) codepulse scan . -ld ``` --- ## 🏆 Kernfunktionen & Wettbewerbsvorteil CodePulse ist das einzige Tool, das AST-statische Analyse, Git-basierte Fluktuation & Kopplungsanalyse und native MCP-Integration für KI-Agenten-Workflows nahtlos vereint. Optimiert für moderne Entwicklungsumgebungen, beantwortet es die Fragen: „Wie es war, wie es ist und was als Nächstes zu tun ist“. | Feature | Beschreibung | |---------|-------------| | **🏛️️ Architektur-Radar** | Schichten definieren und Grenzverletzungen automatisch erkennen | | **💡 Semantische Duplikate** | AST-basiertes strukturelles Hashing findet identische Logik, nicht nur Zeilen | | **🔄 Circular Dependency Breaker** | Zirkuläre Importe und Abhängigkeitsschleifen erkennen und visualisieren | | **⚡ Echtzeit-Watch-Modus** | Interaktives TUI-Dashboard, das sich beim Codieren aktualisiert | | **🚀 Parallele Pipeline** | Kernanalyse, schnelle Linter und Sicherheitschecks laufen gleichzeitig | | **📦 Intelligentes Caching** | Ergebnisse von unveränderten Dateien effizient wiederverwenden | | **🛠️️ Auto-Linter-Setup** | Installiert automatisch erforderliche externe Linter für Ihr Projekt | | **🎨 Professionelle TUI/CLI** | Satte Farben, interaktive Visualisierungen und klares Feedback | | **🌐 7 Sprachen Unterstützung** | Vollständige Lokalisierung für globale Entwicklungsteams | | **📄 Lizenz-Management** | Open-Source-Lizenzen sofort generieren und verifizieren | --- ## 📋 Befehlsreferenz ### Primäre Befehle | Befehl | Beschreibung | |---------|-------------| | `codepulse scan [dir]` | Vollständige Analyse + HTML-Bericht + Status-Badge | | `codepulse watch [dir]` | Interaktives Echtzeit-TUI-Dashboard | | `codepulse verify [dir]` | **[GOD TIER]** Tiefe Verifizierung: Build, Typecheck und Tests | | `codepulse audit [dir]` | **[NEW]** Umfassendes Architektur-Audit und `AUDIT.md`-Erstellung | | `codepulse ghost ` | **[NEW]** Architektonischen „Blast Radius“ von Änderungen vorhersagen | | `codepulse mcp` | Startet den Model Context Protocol (MCP) Server für KI-Agenten | | `codepulse setup-mcp` | Erstellt MCP-Konfiguration und Agent-Regeldateien | | `codepulse stats [dir]` | Schnelle Projektstatistiken und Gesundheitsübersicht | | `codepulse explain [topic]` | Detaillierte Erklärungen und Abhilfe für spezifische Probleme | ### Erweiterte Analysen | Befehl | Beschreibung | |---------|-------------| | `codepulse pr-risk [dir]` | Architektonisches Risiko von Pull-Request-Änderungen bewerten | | `codepulse coupling [dir]` | „Temporal Coupling“ erkennen (Dateien, die sich gemeinsam ändern) | | `codepulse health-trend` | Entwicklung des Health-Scores über die Zeit visualisieren | | `codepulse heatmap [dir]` | Interaktive TUI-Heatmap der Risikozonen der Codebasis | | `codepulse diff ` | Architekturgesundheit zwischen Branches vergleichen | | `codepulse time-machine` | Historie und Evolution des Abhängigkeitsgraphen analysieren | | `codepulse profile` | Profiler-Daten mit Code-Komplexität korrelieren | | `codepulse synth [dir]` | Synthetischen Stresstest-Plan für Ihre Architektur erstellen | --- ## 🏛️️ Architektur-Governance Erzwingen Sie die Struktur und Grenzen Ihres Projekts mit der `.codepulse.json`: ```json { "architecture": { "layers": [ { "name": "UI", "pattern": "src/ui/.*", "allowDependenciesFrom": ["Services", "Utils"] }, { "name": "Services", "pattern": "src/services/.*", "allowDependenciesFrom": ["DB", "Utils"] }, { "name": "DB", "pattern": "src/db/.*", "allowDependenciesFrom": ["Utils"] } ], "strict": true } } ``` --- ## 🔌 Plugin-System Erweitern Sie CodePulse um benutzerdefinierte Analyseregeln, die auf Ihr Team zugeschnitten sind. ### Ein Plugin erstellen Erstellen Sie ein TypeScript/JavaScript-Plugin im `plugins/`-Verzeichnis Ihres Projekts: ```typescript import { Rule, AnalysisContext, Issue } from '@archpulse/codepulse'; export default class CustomQualityRule implements Rule { name = 'custom-quality-rule'; description = 'Stellt sicher, dass teamspezifische Standards erfüllt werden'; version = '1.0.0'; category = 'code-quality'; run(context: AnalysisContext): Issue[] { // Benutzerdefinierte Analyselogik return []; } } ``` 📘 **[Plugin-Entwicklung erkunden →](../docs/PLUGINS.md)** --- ## 🤖 KI-Agenten-Integration (MCP) CodePulse verfügt über einen nativen **Model Context Protocol (MCP)** Server, der es KI-Assistenten (Claude, Cursor etc.) ermöglicht, Architekturanalysen auf Expertenniveau durchzuführen. ### Setup für KI-Assistenten ```bash # MCP konfigurieren und IDE-spezifische Regeln erstellen codepulse setup-mcp ``` Dieser Befehl erstellt optimierte Regeln für verschiedene IDEs und Agenten (`.cursorrules`, `.clinerules`, `CLAUDE.md` etc.) und weist sie an, CodePulse-Tools für tieferen Kontext zu nutzen. ### Agent-spezifische Tools (17+ Tools) | Tool | Beschreibung | |------|-------------| | `codepulse_identity` | Health-Score abrufen und kritische „God Files“ identifizieren | | `get_file_context` | Tiefes Architektur-Dossier (Kopplung, Risiko, Komplexität) einer Datei | | `predict_change_impact` | Transitiven „Blast Radius“ einer Symboländerung vorhersagen | | `optimize_context` | **[NEW]** Minimale relevante Dateien für ein Ziel identifizieren | | `find_similar_functions` | AST-basierte strukturelle Duplikatsuche im gesamten Projekt | | `suggest_split_strategy` | Konkreter Dekompositionsplan für große Dateien | | `simulate_edit` | Vorgeschlagene Codeänderungen gegen Architekturregeln validieren | --- ## 🛠️️ CI/CD-Integration Automatisieren Sie Architektur-Reviews in Ihren GitHub-Workflows. ```yaml - name: CodePulse Review uses: archpulse/codepulse@v5 with: command: 'review' github_token: ${{ secrets.GITHUB_TOKEN }} ``` **CI-Funktionen:** - **Review:** PR-Zusammenfassungen und Impact-Analysen direkt auf GitHub posten. - **Verify:** Build-, Typecheck- und Test-Erfolgsraten erzwingen. - **Audit:** `AUDIT.md`-Artefakte für jeden Build generieren. --- ## 🚀 Visualisierungen

Interaktiver HTML-Bericht	Temporal Coupling Analytik	Architectural Ghost Mode
Entwicklung des Health-Scores	Interaktive Risiko-Heatmap	Fortgeschrittenes TUI-Dashboard

--- ## 🌐 Lokalisierung Vollständige Unterstützung für mehrere Sprachen: ```bash # Hilfe auf Französisch anzeigen codepulse --help --lang fr # Scan auf Ukrainisch codepulse scan . --lang ua # Watch auf Deutsch codepulse watch . --lang de ``` **Unterstützt:** English, Українська, Русский, Čeština, 한국어, Deutsch, Français --- ## 💻 Systemanforderungen - **Node.js**: 16.0.0+ - **BS**: Linux, macOS, Windows - **RAM**: 512MB (1GB+ empfohlen für große Projekte) --- ## 🤝 Mitwirken Beiträge sind willkommen! Bitte lesen Sie unseren [Leitfaden für Mitwirkende](../CONTRIBUTING.md). ```bash git clone https://github.com/archpulse/codepulse-cli.git npm install npm test npm run dev -- scan . ``` --- ## 📄 Lizenz MIT License © 2024 ArchPulse ---

### ⭐ Lieben Sie CodePulse? Geben Sie uns einen Stern auf GitHub! **archpulse**