# 🔍 CodePulse CLI

### 🚀 Moteur d'Intelligence Architecturale & de Santé du Code **Intelligence Architecturale • Modélisation Sémantique • Surveillance en Temps Réel • Prêt pour les Agents IA** CodePulse est un moteur de santé architecturale de nouvelle génération conçu pour les projets JavaScript, TypeScript, Python et multilingues de grande envergure. Il fournit des informations systémiques approfondies sur la structure du code, les risques de dépendance et les tendances évolutives, permettant aux équipes et aux agents IA de maintenir des bases de code robustes avec une précision chirurgicale. **Évolution v5.2 :** Découvrez notre nouveau modèle de notation non linéaire, la métrique de confiance 🛡️️ Confidence Metric et le **Mode Fantôme 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/) --- ### 🌐 Support Multilingue [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) ### 📖 Documentation Complète [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)

--- ## ⚡ Démarrage Rapide ### Installation ```bash npm install -g @archpulse/codepulse ``` ### Premier Scan ```bash # Analysez votre projet et générez un rapport HTML codepulse scan . # Lancez le tableau de bord TUI interactif en temps réel codepulse watch . ``` --- ## 🚀 Performance & Moteurs d'Analyse CodePulse propose deux voies d'analyse distinctes optimisées pour différents flux de travail. Nous construisons un modèle systémique complet de l'ensemble de votre projet, allant bien au-delà du linting standard par fichier. ### Mode Rapide (Ultra-fast scanning) *Focus : Retour immédiat sur la santé architecturale de base.* | Outil | Moteur | Temps d'exécution (s) | |-------|--------|-----------------------| | **ESLint** | Référence | ~4.8s | | **CodePulse** | **Oxlint Engine** | **~2.8s** | ### Mode Analyse Étendue (Compatibilité totale avec l'écosystème) *Focus : Informations architecturales approfondies, analyse de dépendances complexes et compatibilité totale avec les règles ESLint.* | Outil | Moteur | Temps d'exécution (s) | |-------|--------|-----------------------| | **ESLint** | Raw Baseline | ~3.3s | | **CodePulse** | **ESLint + Systemic Analysis** | **~5.5s** | > **Pourquoi cette différence ?** > En **Mode Analyse Étendue**, CodePulse exécute l'intégralité de la suite ESLint de votre projet **plus** sa propre analyse systémique (graphe de dépendances, détection de cyclicité, vérification des frontières architecturales et turn-over historique). Le résultat est un rapport unifié combinant le linting standard de l'écosystème avec une intelligence structurelle profonde. --- ## 🔍 Modes de Scan & Moteurs ### Sélection du Moteur ```bash # Détection automatique (Par défaut) # Utilise ESLint si une config est trouvée, sinon Oxlint codepulse scan . # Forcer le mode ultra-rapide (propulsé par Oxlint) codepulse scan . --engine oxlint # Forcer le mode analyse étendue (plus de précision & compatibilité) codepulse scan . --engine eslint # ou codepulse scan . --precision ``` ### Modes Verbeux / Debug ```bash # Afficher uniquement les problèmes au niveau du programme codepulse scan . -d # Mode debug du linter (affiche la sortie brute des outils sous-jacents) codepulse scan . -ld ``` --- ## 🏆 Avantages Clés & Compétitivité CodePulse est le seul outil qui unit de manière transparente l'analyse statique AST, l'analytique de turn-over et de couplage basée sur Git, et l'intégration native MCP pour les flux de travail des agents IA. Optimisé pour les environnements de développement modernes, il répond à : "comment c'était, comment c'est, et que faire ensuite". | Fonctionnalité | Description | |----------------|-------------| | **🏛️️ Radar Architectural** | Définissez des couches et détectez automatiquement les violations de frontières | | **💡 Duplication Sémantique** | Le hachage structurel basé sur l'AST trouve la logique identique, pas seulement les lignes | | **🔄 Briseur de Dépendances Cycliques** | Détectez et visualisez les imports circulaires et les boucles de dépendance | | **⚡ Mode Watch en Temps Réel** | Tableau de bord TUI interactif qui se met à jour pendant que vous codez | | **🚀 Pipeline Parallèle** | L'analyse de base, les linters rapides et les tests de sécurité s'exécutent simultanément | | **📦 Mise en cache Intelligente** | Réutilise efficacement les résultats des fichiers non modifiés | | **🛠️️ Auto-configuration Linter** | Installe automatiquement les linters externes requis pour votre projet | | **🎨 TUI/CLI Professionnel** | Couleurs riches, visualisations interactives et retours clairs | | **🌐 Support 7 Langues** | Localisation complète pour les équipes de développement mondiales | | **📄 Gestion des Licences** | Générez et vérifiez instantanément des licences open-source | --- ## 📋 Référence des Commandes ### Commandes Principales | Commande | Description | |----------|-------------| | `codepulse scan [dir]` | Analyse complète + rapport HTML + badge de statut | | `codepulse watch [dir]` | Tableau de bord TUI interactif en temps réel | | `codepulse verify [dir]` | **[GOD TIER]** Vérification approfondie : Build, Typecheck et Tests | | `codepulse audit [dir]` | **[NEW]** Audit architectural complet et génération de `AUDIT.md` | | `codepulse ghost ` | **[NEW]** Prédire le "rayon d'impact" architectural des changements d'un fichier | | `codepulse mcp` | Démarrer le serveur Model Context Protocol (MCP) pour les agents IA | | `codepulse setup-mcp` | Générer la configuration MCP et les fichiers de règles pour agents | | `codepulse stats [dir]` | Statistiques rapides du projet et aperçu de la santé | | `codepulse explain [topic]` | Explication détaillée et conseils de remédiation pour des problèmes spécifiques | ### Analytique Avancée | Commande | Description | |----------|-------------| | `codepulse pr-risk [dir]` | Évaluer le risque architectural des changements d'une Pull Request | | `codepulse coupling [dir]` | Détecter le "Couplage Temporel" (fichiers qui changent ensemble) | | `codepulse health-trend` | Visualiser l'évolution du score de santé au fil du temps | | `codepulse heatmap [dir]` | Carte thermique TUI interactive des zones de risque de la base de code | | `codepulse diff ` | Comparer la santé architecturale entre les branches | | `codepulse time-machine` | Analyser l'historique et l'évolution du graphe de dépendances | | `codepulse profile` | Corréler les données du profileur d'exécution avec la complexité du code | | `codepulse synth [dir]` | Générer un plan de test de stress synthétique pour votre architecture | --- ## 🏛️️ Gouvernance Architecturale Appliquez la structure et les frontières de votre projet via `.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 } } ``` --- ## 🔌 Système de Plugins Étendez CodePulse avec des règles d'analyse personnalisées adaptées aux besoins de votre équipe. ### Créer un Plugin Créez un plugin TypeScript/JavaScript dans le répertoire `plugins/` de votre projet : ```typescript import { Rule, AnalysisContext, Issue } from '@archpulse/codepulse'; export default class CustomQualityRule implements Rule { name = 'custom-quality-rule'; description = 'Garantit que les standards spécifiques de l'équipe sont respectés'; version = '1.0.0'; category = 'code-quality'; run(context: AnalysisContext): Issue[] { // Logique d'analyse personnalisée return []; } } ``` 📘 **[Explorer le Développement de Plugins →](../docs/PLUGINS.md)** --- ## 🤖 Intégration Agents IA (MCP) CodePulse dispose d'un serveur **Model Context Protocol (MCP)** natif, permettant aux assistants IA (Claude, Cursor, etc.) d'effectuer des analyses architecturales de niveau expert. ### Configuration pour les Assistants IA ```bash # Configurer MCP et générer des règles spécifiques à l'IDE codepulse setup-mcp ``` Cette commande génère des règles optimisées pour divers IDE et agents (`.cursorrules`, `.clinerules`, `CLAUDE.md`, etc.), les instruisant d'utiliser les outils CodePulse pour un contexte plus profond. ### Outils Spécifiques aux Agents (17+ outils) | Outil | Description | |-------|-------------| | `codepulse_identity` | Obtenir le score de santé et identifier les "God Files" critiques | | `get_file_context` | Dossier architectural profond (couplage, risque, complexité) d'un fichier | | `predict_change_impact` | Prédire le rayon d'impact transitif du changement d'un symbole | | `optimize_context` | **[NEW]** Identifier les fichiers minimaux pertinents pour un objectif | | `find_similar_functions` | Recherche de duplication structurelle basée sur l'AST dans tout le projet | | `suggest_split_strategy` | Plan concret de décomposition et de refactorisation pour les gros fichiers | | `simulate_edit` | Valider les changements de code proposés par rapport aux règles architecturales | --- ## 🛠️️ Intégration CI/CD Automatisez les revues architecturales dans vos flux de travail GitHub. ```yaml - name: CodePulse Review uses: archpulse/codepulse@v5 with: command: 'review' github_token: ${{ secrets.GITHUB_TOKEN }} ``` **Capacités CI :** - **Review :** Publiez des résumés de PR et des analyses d'impact directement sur GitHub. - **Verify :** Imposez des taux de réussite pour le build, le typecheck et les tests. - **Audit :** Générez des artefacts `AUDIT.md` pour chaque build. --- ## 🚀 Visualisations

Rapport HTML Interactif	Analytique de Couplage Temporel	Mode Fantôme Architectural
Évolution du Score de Santé	Carte Thermique de Risque Interactive	Tableau de Bord TUI Avancé

--- ## 🌐 Localisation Support complet pour plusieurs langues : ```bash # Voir l'aide en français codepulse --help --lang fr # Scanner en ukrainien codepulse scan . --lang ua # Watch en allemand codepulse watch . --lang de ``` **Supporté :** English, Українська, Русский, Čeština, 한국어, Deutsch, Français --- ## 💻 Configuration Requise - **Node.js**: 16.0.0+ - **OS**: Linux, macOS, Windows - **RAM**: 512Mo (1Go+ recommandé pour les gros projets) --- ## 🤝 Contribuer Les contributions sont les bienvenues ! Veuillez consulter notre [Guide de Contribution](../CONTRIBUTING.md) pour commencer. ```bash git clone https://github.com/archpulse/codepulse-cli.git npm install npm test npm run dev -- scan . ``` --- ## 📄 Licence MIT License © 2024 ArchPulse ---

### ⭐ Vous aimez CodePulse ? Donnez-nous une étoile sur GitHub ! **archpulse**