# 🔍 CodePulse CLI CodePulse Logo ### 🚀 Просунутий Двигун Архітектурного Аналізу та Здоров'я Коду **Архітектурний Інтелект • Семантичне Моделювання • Моніторинг у Реальному Часі • Готовність до ШІ-агентів** CodePulse — це двигун архітектурного здоров'я наступного покоління, розроблений для масштабних проектів на JavaScript, TypeScript, Python та змішаних мовах. Він надає глибоке системне розуміння структури коду, ризиків залежностей та еволюційних трендів, дозволяючи командам та ШІ-агентам підтримувати надійні та підтримувані кодові бази з хірургічною точністю. **Еволюція v5.2:** Представляємо нашу нову нелінійну модель оцінювання, метрику впевненості 🛡️️ Confidence Metric та **Архітектурний Режим Привида (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/) --- ### 🌐 Багатомовна Підтримка [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) ### 📖 Повна Документація [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)
--- ## ⚡ Швидкий Старт ### Встановлення ```bash npm install -g @archpulse/codepulse ``` ### Перше Сканування ```bash # Проаналізуйте свій проект та створіть HTML-звіт codepulse scan . # Запустіть інтерактивну TUI-панель у реальному часі codepulse watch . ``` --- ## 🚀 Продуктивність та Двигуни Аналізу CodePulse пропонує два різні шляхи аналізу, оптимізовані для різних робочих процесів. Ми будуємо всебічну системну модель усього вашого проекту, що виходить далеко за межі стандартного лінтингу файлів. ### Швидкий Режим (Ultra-fast scanning) *Фокус: Миттєвий зворотний зв'язок щодо основного архітектурного здоров'я.* | Інструмент | Двигун | Час виконання (с) | |------------|--------|-------------------| | **ESLint** | Базовий | ~4.8s | | **CodePulse** | **Oxlint Engine** | **~2.8s** | ### Режим Розширеного Аналізу (Повна сумісність з екосистемою) *Фокус: Глибокі архітектурні інсайти, складний аналіз залежностей та повна сумісність з правилами ESLint.* | Інструмент | Двигун | Час виконання (с) | |------------|--------|-------------------| | **ESLint** | Raw Baseline | ~3.3s | | **CodePulse** | **ESLint + Systemic Analysis** | **~5.5s** | > **Чому така різниця?** > У **Режимі Розширеного Аналізу** CodePulse виконує повний набір правил ESLint вашого проекту **плюс** власний системний аналіз (граф залежностей, виявлення циклічності, перевірка архітектурних меж та історична плинність). Результатом є уніфікований звіт, який поєднує стандартний лінтинг з глибоким структурним інтелектом. --- ## 🔍 Режими Сканування та Двигуни ### Вибір Двигуна ```bash # Автовизначення (Типово) # Використовує ESLint, якщо знайдено конфігурацію, інакше Oxlint codepulse scan . # Примусовий ультрашвидкий режим (на базі Oxlint) codepulse scan . --engine oxlint # Примусовий режим розширеного аналізу (вища точність та сумісність) codepulse scan . --engine eslint # або codepulse scan . --precision ``` ### Докладні / Налагоджувальні Режими ```bash # Тільки системні проблеми програми codepulse scan . -d # Налагодження лінтера (показує сирий вивід інструментів) codepulse scan . -ld ``` --- ## 🏆 Основні Переваги та Конкурентність CodePulse — це єдиний інструмент, який плавно об'єднує статичний аналіз AST, аналітику плинності та зв'язності на основі Git, а також нативну інтеграцію MCP для робочих процесів ШІ-агентів. Оптимізований для сучасних середовищ розробки, він дає відповідь на питання: "як було, як є і що робити далі". | Функція | Опис | |---------|------| | **🏛️️ Архітектурний Радар** | Визначайте шари та автоматично виявляйте порушення меж | | **💡 Семантичне Дублювання** | Структурне хешування на основі AST знаходить ідентичну логіку, а не лише рядки | | **🔄 Руйнівник Циклічних Залежностей** | Виявляйте та візуалізуйте циклічні імпорти та петлі залежностей | | **⚡ Режим Watch у Реальному Часі** | Інтерактивна TUI-панель, яка оновлюється під час написання коду | | **🚀 Паралельний Конвеєр** | Основний аналіз, швидкі лінтери та перевірки безпеки працюють одночасно | | **📦 Розумне Кешування** | Ефективно перевикористовує результати для незмінених файлів | | **🛠️️ Авто-налаштування Лінтерів** | Автоматично встановлює необхідні зовнішні лінтери для вашого проекту | | **🎨 Професійний TUI/CLI** | Насичені кольори, інтерактивна візуалізація та чіткий зворотний зв'язок | | **🌐 Підтримка 7 Мов** | Повна локалізація для міжнародних команд розробки | | **📄 Керування Ліцензіями** | Миттєво генеруйте та перевіряйте ліцензії Open Source | --- ## 📋 Довідник Команд ### Основні Команди | Команда | Опис | |---------|------| | `codepulse scan [dir]` | Повний аналіз + HTML-звіт + бейдж статусу | | `codepulse watch [dir]` | Інтерактивна TUI-панель у реальному часі | | `codepulse verify [dir]` | **[GOD TIER]** Глибока верифікація: збірка, типізація та тести | | `codepulse audit [dir]` | **[NEW]** Всебічний архітектурний аудит та генерація `AUDIT.md` | | `codepulse ghost ` | **[NEW]** Прогноз "радіусу ураження" архітектури при зміні файлу | | `codepulse mcp` | Запуск сервера Model Context Protocol (MCP) для ШІ-агентів | | `codepulse setup-mcp` | Генерація конфігурації MCP та файлів правил для агентів | | `codepulse stats [dir]` | Швидка статистика проекту та огляд здоров'я | | `codepulse explain [topic]` | Детальне пояснення та поради щодо виправлення конкретних проблем | ### Просунута Аналітика | Команда | Опис | |---------|------| | `codepulse pr-risk [dir]` | Оцінка архітектурного ризику змін у Pull Request | | `codepulse coupling [dir]` | Виявлення "часової зв'язності" (файли, що змінюються разом) | | `codepulse health-trend` | Візуалізація еволюції оцінки здоров'я з часом | | `codepulse heatmap [dir]` | Інтерактивна теплокарта зон ризику кодової бази | | `codepulse diff ` | Порівняння архітектурного здоров'я між гілками | | `codepulse time-machine` | Аналіз історії та еволюції графа залежностей | | `codepulse profile` | Кореляція даних профайлера з складністю коду | | `codepulse synth [dir]` | Генерація плану синтетичного стрес-тесту для вашої архітектури | --- ## 🏛️️ Архітектурне Управління Контролюйте структуру та межі вашого проекту за допомогою `.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 } } ``` --- ## 🔌 Система Плагінів Розширюйте CodePulse власними правилами аналізу, адаптованими під потреби вашої команди. ### Створення Плагіна Створіть TypeScript/JavaScript плагін у директорії `plugins/` вашого проекту: ```typescript import { Rule, AnalysisContext, Issue } from '@archpulse/codepulse'; export default class CustomQualityRule implements Rule { name = 'custom-quality-rule'; description = 'Гарантує дотримання стандартів команди'; version = '1.0.0'; category = 'code-quality'; run(context: AnalysisContext): Issue[] { // Власна логіка аналізу return []; } } ``` 📘 **[Дізнатися більше про розробку плагінів →](../docs/PLUGINS.md)** --- ## 🤖 Інтеграція з ШІ-агентами (MCP) CodePulse містить нативний сервер **Model Context Protocol (MCP)**, що дозволяє ШІ-асистентам (Claude, Cursor тощо) виконувати архітектурний аналіз експертного рівня. ### Налаштування для ШІ-асистентів ```bash # Налаштуйте MCP та згенеруйте правила для IDE codepulse setup-mcp ``` Ця команда генерує оптимізовані правила для різних IDE та агентів (`.cursorrules`, `.clinerules`, `CLAUDE.md` тощо), інструктуючи їх використовувати інструменти CodePulse для глибшого розуміння контексту. ### Інструменти для Агентів (17+ інструментів) | Інструмент | Опис | |------------|------| | `codepulse_identity` | Отримання оцінки здоров'я та виявлення критичних "God Files" | | `get_file_context` | Глибоке архітектурне досьє (зв'язність, ризик, складність) файлу | | `predict_change_impact` | Прогноз транзитивного радіусу ураження при зміні символу | | `optimize_context` | **[NEW]** Фільтрація та ідентифікація мінімально необхідних файлів | | `find_similar_functions` | Пошук структурних дублікатів на основі AST по всьому проекту | | `suggest_split_strategy` | Конкретний план декомпозиції та рефакторингу великих файлів | | `simulate_edit` | Валідація запропонованих змін на відповідність архітектурним правилам | --- ## 🛠️️ Інтеграція CI/CD Автоматизуйте архітектурні огляди у ваших робочих процесах GitHub. ```yaml - name: CodePulse Review uses: archpulse/codepulse@v5 with: command: 'review' github_token: ${{ secrets.GITHUB_TOKEN }} ``` **Можливості CI:** - **Review:** Публікація резюме PR та аналізу впливу безпосередньо в GitHub. - **Verify:** Контроль проходження збірки, типізації та тестів. - **Audit:** Генерація артефактів `AUDIT.md` для кожної збірки. --- ## 🚀 Візуалізації
HTML Report
Інтерактивний HTML-звіт 		Temporal Coupling
Аналітика часової зв'язності 		Ghost Mode
Архітектурний Режим Привида
Health Trend
Еволюція здоров'я проекту 		Risk Heatmap
Інтерактивна теплокарта ризиків 		Real-time TUI
Просунута TUI-панель
--- ## 🌐 Локалізація Повна підтримка декількох мов: ```bash # Допомога французькою codepulse --help --lang fr # Сканування українською codepulse scan . --lang ua # Watch німецькою codepulse watch . --lang de ``` **Підтримуються:** English, Українська, Русский, Čeština, 한국어, Deutsch, Français --- ## 💻 Системні Вимоги - **Node.js**: 16.0.0+ - **ОС**: Linux, macOS, Windows - **RAM**: 512MB (1GB+ рекомендовано для великих проектів) --- ## 🤝 Внесок у Проект Ми раді вашому внеску! Будь ласка, ознайомтеся з нашим [Посібником для контриб'юторів](../CONTRIBUTING.md). ```bash git clone https://github.com/archpulse/codepulse-cli.git npm install npm test npm run dev -- scan . ``` --- ## 📄 Ліцензія MIT License © 2024 ArchPulse ---
### ⭐ Подобається CodePulse? Поставте нам зірочку на GitHub! **archpulse**