# 🔍 CodePulse CLI

### 🚀 고급 아키텍처 인텔리전스 및 코드 상태 엔진 **아키텍처 인텔리전스 • 시맨틱 모델링 • 실시간 모니터링 • AI 에이전트 준비 완료** CodePulse는 대규모 JavaScript, TypeScript, Python 및 혼합 언어 프로젝트를 위해 설계된 차세대 아키텍처 상태 엔진입니다. 코드 구조, 종속성 위험 및 진화 추세에 대한 깊은 시스템 통찰력을 제공하여 팀과 AI 에이전트가 외과적 정밀도로 견고하고 유지 관리 가능한 코드베이스를 유지할 수 있도록 합니다. **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) *중점: 핵심 아키텍처 상태 및 기본 문제에 대한 즉각적인 피드백.* | 도구 | 엔진 | 실행 시간 (s) | |------|------|-------------| | **ESLint** | 기준선 | ~4.8s | | **CodePulse** | **Oxlint Engine** | **~2.8s** | ### 확장 분석 모드 (전체 에코시스템 호환성) *중점: 깊은 아키텍처 통찰력, 복잡한 종속성 분석 및 전체 ESLint 규칙 호환성.* | 도구 | 엔진 | 실행 시간 (s) | |------|------|-------------| | **ESLint** | 원시 기준선 | ~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 기반 이직률 및 결합 분석, AI 에이전트 워크플로우를 위한 네이티브 MCP 통합을 완벽하게 통합하는 유일한 도구입니다. 현대적인 개발 환경에 최적화되어 '과거의 상태, 현재의 상태, 그리고 다음에 할 일'에 대한 답을 제공합니다. | 기능 | 설명 | |---------|-------------| | **🏛️️ 아키텍처 레이더** | 레이어를 정의하고 경계 위반을 자동으로 감지 | | **💡 시맨틱 중복 감지** | AST 기반 구조적 해싱으로 단순한 줄이 아닌 동일한 로직을 탐색 | | **🔄 순환 종속성 제거** | 순환 임포트 및 종속성 루프 감지 및 시각화 | | **⚡ 실시간 Watch 모드** | 코딩 중에 업데이트되는 대화형 TUI 대시보드 | | **🚀 병렬 파이프라인** | 핵심 분석, 빠른 린터 및 보안 검사가 동시에 실행됨 | | **📦 스마트 캐싱** | 변경되지 않은 파일의 결과를 효율적으로 재사용 | | **🛠️️ 자동 린터 설정** | 프로젝트에 필요한 외부 린터를 자동으로 설치 | | **🎨 전문적인 TUI/CLI** | 풍부한 색상, 대화형 시각화 및 명확한 피드백 | | **🌐 7개 국어 지원** | 글로벌 개발 팀을 위한 전체 현지화 | | **📄 라이선스 관리** | 오픈 소스 라이선스를 즉시 생성 및 검증 | --- ## 📋 명령 참조 ### 기본 명령 | 명령 | 설명 | |---------|-------------| | `codepulse scan [dir]` | 전체 분석 + HTML 보고서 + 상태 배지 | | `codepulse watch [dir]` | 대화형 실시간 TUI 대시보드 | | `codepulse verify [dir]` | **[GOD TIER]** 심층 검증: 빌드, 타입 체크 및 테스트 | | `codepulse audit [dir]` | **[NEW]** 포괄적인 아키텍처 감사 및 `AUDIT.md` 생성 | | `codepulse ghost ` | **[NEW]** 파일 변경 시 아키텍처 "영향 범위" 예측 | | `codepulse mcp` | AI 에이전트를 위한 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]` | 코드베이스 위험 영역의 대화형 TUI 트리맵 | | `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를 확장하십시오. ### 플러그인 생성 프로젝트의 `plugins/` 디렉토리에 TypeScript/JavaScript 플러그인을 생성합니다: ```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)** --- ## 🤖 AI 에이전트 통합 (MCP) CodePulse는 네이티브 **Model Context Protocol (MCP)** 서버를 갖추고 있어 AI 어시스턴트(Claude, Cursor 등)가 전문가 수준의 아키텍처 분석을 수행할 수 있도록 합니다. ### AI 어시스턴트 설정 ```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 보고서	시간적 결합 분석	아키텍처 고스트 모드
상태 점수 진화	대화형 위험 히트맵	고급 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+ - **OS**: 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**