# 🔍 CodePulse CLI

### 🚀 Pokročilý Nástroj pro Architektonickou Inteligenci a Zdraví Kódu **Architektonická Inteligence • Sémantické Modelování • Monitorování v Reálném Čase • Připraveno pro AI Agenty** CodePulse je nástroj nové generace pro sledování architektonického zdraví kódu, navržený pro rozsáhlé projekty v JavaScriptu, TypeScriptu, Pythonu a smíšených jazycích. Poskytuje hluboký systémový vhled do struktury kódu, rizik závislostí a evolučních trendů, což umožňuje týmům i AI agentům udržovat robustní a udržovatelné kódové báze s chirurgickou přesností. **Evoluce v5.2:** Představujeme náš nový nelineární model hodnocení, metriku spolehlivosti 🛡️️ Confidence Metric a **Architektonický Režim Ducha (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/) --- ### 🌐 Vícejazyčná Podpora [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) ### 📖 Kompletní Dokumentace [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)

--- ## ⚡ Rychlý Start ### Instalace ```bash npm install -g @archpulse/codepulse ``` ### První Skenování ```bash # Analyzujte svůj projekt a vygenerujte HTML report codepulse scan . # Spusťte interaktivní TUI dashboard v reálném čase codepulse watch . ``` --- ## 🚀 Výkon a Analytické Motory CodePulse nabízí dvě různé cesty analýzy optimalizované pro různé pracovní postupy. Budujeme komplexní systémový model celého vašeho projektu, který jde daleko za hranice standardního lintování souborů. ### Rychlý Režim (Ultra-fast scanning) *Zaměření: Okamžitá zpětná vazba na základní architektonické zdraví.* | Nástroj | Motor | Doba běhu (s) | |---------|-------|---------------| | **ESLint** | Základní | ~4.8s | | **CodePulse** | **Oxlint Engine** | **~2.8s** | ### Režim Rozšířené Analýzy (Plná kompatibilita s ekosystémem) *Zaměření: Hluboké architektonické vhledy, komplexní analýza závislostí a plná kompatibilita s pravidly ESLint.* | Nástroj | Motor | Doba běhu (s) | |---------|-------|---------------| | **ESLint** | Raw Baseline | ~3.3s | | **CodePulse** | **ESLint + Systemic Analysis** | **~5.5s** | > **Proč ten rozdíl?** > V **Režimu Rozšířené Analýzy** CodePulse provádí kompletní sadu pravidel ESLint vašeho projektu **plus** vlastní systémovou analýzu (graf závislostí, detekce cyklů, kontrola architektonických hranic a historická fluktuace). Výsledkem je sjednocený report, který kombinuje standardní lintování s hlubokou strukturní inteligencí. --- ## 🔍 Režimy Skenování a Motory ### Výběr Motoru ```bash # Automatická detekce (Výchozí) # Použije ESLint, pokud je nalezena konfigurace, jinak Oxlint codepulse scan . # Vynutit ultra-rychlý režim (poháněný Oxlintem) codepulse scan . --engine oxlint # Vynutit režim rozšířené analýzy (vyšší přesnost a kompatibilita) codepulse scan . --engine eslint # nebo codepulse scan . --precision ``` ### Detailní / Ladicí Režimy ```bash # Pouze systémové problémy programu codepulse scan . -d # Ladicí režim linteru (zobrazuje surový výstup nástrojů) codepulse scan . -ld ``` --- ## 🏆 Hlavní Výhody a Konkurenceschopnost CodePulse je jediný nástroj, který plynule spojuje statickou analýzu AST, analytiku fluktuace a provázanosti na základě Gitu a nativní integraci MCP pro pracovní postupy AI agentů. Optimalizováno pro moderní vývojová prostředí, odpovídá na otázky: „jak to bylo, jak to je a co dělat dál“. | Funkce | Popis | |---------|-------| | **🏛️️ Architektonický Radar** | Definujte vrstvy a automaticky zachycujte porušení hranic | | **💡 Sémantická Duplikace** | Strukturní hašování založené na AST najde identickou logiku, nejen řádky | | **🔄 Přerušovač Cyklických Závislostí** | Detekujte a vizualizujte cyklické importy a smyčky závislostí | | **⚡ Režim Watch v Reálném Čase** | Interaktivní TUI dashboard, který se aktualizuje při psaní kódu | | **🚀 Paralelní Pipeline** | Hlavní analýza, rychlé lintery a bezpečnostní kontroly běží současně | | **📦 Chytré Cachování** | Efektivně znovupoužívá výsledky pro nezměněné soubory | | **🛠️️ Automatické Nastavení Linterů** | Automaticky instaluje potřebné externí lintery pro váš projekt | | **🎨 Profesionální TUI/CLI** | Bohaté barvy, interaktivní vizualizace a jasná zpětná vazba | | **🌐 Podpora 7 Jazyků** | Plná lokalizace pro mezinárodní vývojové týmy | | **📄 Správa Licencí** | Okamžitě generujte a ověřujte open-source licence | --- ## 📋 Přehled Příkazů ### Základní Příkazy | Příkaz | Popis | |---------|-------| | `codepulse scan [dir]` | Kompletní analýza + HTML report + status badge | | `codepulse watch [dir]` | Interaktivní TUI dashboard v reálném čase | | `codepulse verify [dir]` | **[GOD TIER]** Hluboké ověření: Build, Typecheck a testy | | `codepulse audit [dir]` | **[NEW]** Komplexní architektonický audit a generování `AUDIT.md` | | `codepulse ghost ` | **[NEW]** Předpověď architektonického „rádiusu dopadu“ změn souboru | | `codepulse mcp` | Spuštění Model Context Protocol (MCP) serveru pro AI agenty | | `codepulse setup-mcp` | Generování MCP konfigurace a souborů s pravidly pro agenty | | `codepulse stats [dir]` | Rychlé statistiky projektu a přehled zdraví | | `codepulse explain [topic]` | Detailní vysvětlení a rady k opravě konkrétních problémů | ### Pokročilá Analytika | Příkaz | Popis | |---------|-------| | `codepulse pr-risk [dir]` | Hodnocení architektonického rizika změn v Pull Requestu | | `codepulse coupling [dir]` | Detekce „temporální provázanosti“ (soubory, které se mění společně) | | `codepulse health-trend` | Vizualizace evoluce skóre zdraví v čase | | `codepulse heatmap [dir]` | Interaktivní TUI heatmapa rizikových zón kódové báze | | `codepulse diff ` | Porovnání architektonického zdraví mezi větvemi | | `codepulse time-machine` | Analýza historie a evoluce grafu závislostí | | `codepulse profile` | Korelace dat z profileru se složitostí kódu | | `codepulse synth [dir]` | Generování plánu syntetického stres-testu pro vaši architekturu | --- ## 🏛️️ Správa Architektury Vynuťte strukturu a hranice svého projektu pomocí `.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ém Pluginů Rozšiřte CodePulse o vlastní pravidla analýzy přizpůsobená potřebám vašeho týmu. ### Vytvoření Pluginu Vytvořte TypeScript/JavaScript plugin v adresáři `plugins/` vašeho projektu: ```typescript import { Rule, AnalysisContext, Issue } from '@archpulse/codepulse'; export default class CustomQualityRule implements Rule { name = 'custom-quality-rule'; description = 'Zajišťuje dodržování standardů týmu'; version = '1.0.0'; category = 'code-quality'; run(context: AnalysisContext): Issue[] { // Vlastní analytická logika return []; } } ``` 📘 **[Prozkoumat vývoj pluginů →](../docs/PLUGINS.md)** --- ## 🤖 Integrace AI Agentů (MCP) CodePulse obsahuje nativní **Model Context Protocol (MCP)** server, který umožňuje AI asistentům (Claude, Cursor atd.) provádět architektonickou analýzu na expertní úrovni. ### Nastavení pro AI Asistenty ```bash # Nakonfigurujte MCP a vygenerujte pravidla pro IDE codepulse setup-mcp ``` Tento příkaz vygeneruje optimalizovaná pravidla pro různá IDE a agenty (`.cursorrules`, `.clinerules`, `CLAUDE.md` atd.), které je instruují používat nástroje CodePulse pro hlubší kontext. ### Nástroje pro Agenty (17+ nástrojů) | Nástroj | Popis | |---------|-------| | `codepulse_identity` | Získání skóre zdraví projektu a identifikace kritických „God Files“ | | `get_file_context` | Hluboké architektonické dossier (provázanost, riziko, složitost) souboru | | `predict_change_impact` | Předpověď tranzitivního rádiusu dopadu při změně symbolu | | `optimize_context` | **[NEW]** Filtrace a identifikace minimálně relevantních souborů pro cíl | | `find_similar_functions` | Hledání strukturních duplikátů na bázi AST v celém projektu | | `suggest_split_strategy` | Konkrétní plán dekompozice a refaktorování velkých souborů | | `simulate_edit` | Validace navrhovaných změn kódu proti architektonickým pravidlům | --- ## 🛠️️ Integrace CI/CD Automatizujte architektonické revize ve vašich GitHub workflows. ```yaml - name: CodePulse Review uses: archpulse/codepulse@v5 with: command: 'review' github_token: ${{ secrets.GITHUB_TOKEN }} ``` **Možnosti CI:** - **Review:** Publikujte shrnutí PR a analýzu dopadu přímo na GitHub. - **Verify:** Vynuťte úspěšnost buildu, typové kontroly a testů. - **Audit:** Generujte soubory `AUDIT.md` pro každý build. --- ## 🚀 Vizualizace

Interaktivní HTML Report	Analytika temporální provázanosti	Architektonický Režim Ducha
Evoluce skóre zdraví	Interaktivní heatmapa rizik	Pokročilý TUI Dashboard

--- ## 🌐 Lokalizace Plná podpora více jazyků: ```bash # Nápověda ve francouzštině codepulse --help --lang fr # Skenování v ukrajinštině codepulse scan . --lang ua # Watch v němčině codepulse watch . --lang de ``` **Podporováno:** English, Українська, Русский, Čeština, 한국어, Deutsch, Français --- ## 💻 Systémové Požadavky - **Node.js**: 16.0.0+ - **OS**: Linux, macOS, Windows - **RAM**: 512MB (1GB+ doporučeno pro velké projekty) --- ## 🤝 Přispívání Vítáme příspěvky! Pro začátek se prosím podívejte na naši [příručku pro přispěvatele](../CONTRIBUTING.md). ```bash git clone https://github.com/archpulse/codepulse-cli.git npm install npm test npm run dev -- scan . ``` --- ## 📄 Licence MIT License © 2024 ArchPulse ---

### ⭐ Líbí se vám CodePulse? Dejte nám hvězdičku na GitHubu! **archpulse**