test-genie-mcp 2.0.0

package/README.md

@@ -0,0 +1,219 @@
+# Test Genie MCP
+
+AI-powered App Test Automation MCP Server
+
+앱 테스트 자동화를 위한 MCP 서버입니다. 시나리오 생성부터 테스트 실행, 문제 검출, 수정 제안 및 적용까지 전체 테스트 파이프라인을 자동화합니다.
+
+## Features
+
+### Phase 1: Analysis & Scenario Generation
+- **analyze_app_structure**: 앱 코드베이스 분석 (화면, 컴포넌트, API, 상태관리)
+- **generate_scenarios**: AI 기반 테스트 시나리오 자동 생성
+- **create_test_plan**: 테스트 계획 수립 및 스케줄링
+
+### Phase 2: Test Execution
+- **run_scenario_test**: 개별 시나리오 테스트 실행
+- **run_simulation**: 사용자 행동 시뮬레이션 (랜덤/패턴 기반)
+- **run_stress_test**: 스트레스/부하 테스트
+
+### Phase 3: Issue Detection
+- **detect_memory_leaks**: 메모리 릭 감지 (힙 분석, 순환 참조)
+- **detect_logic_errors**: 논리적 오류 검출 (레이스 컨디션, 상태 불일치)
+
+### Phase 4: Fix Suggestions & Application
+- **suggest_fixes**: AI 기반 수정 방안 제안
+- **confirm_fix**: 수정 사항 사용자 확인
+- **apply_fix**: 확인된 수정 사항 적용
+- **rollback_fix**: 적용된 수정 롤백
+
+### Phase 5: Full Automation
+- **run_full_automation**: 전체 파이프라인 자동 실행
+- **generate_report**: 상세 보고서 생성 (Markdown, HTML, JSON)
+
+### Enhanced Analysis (v2.0)
+- **analyze_performance**: 성능 심층 분석 (렌더링, 연산, 네트워크, 번들)
+- **analyze_code_deep**: AST 기반 코드 분석 (복잡도, 훅, 의존성)
+- **generate_cicd_config**: CI/CD 설정 자동 생성 (GitHub Actions, Jenkins, GitLab CI)
+
+## Supported Platforms
+
+| Platform | Language | Test Framework |
+|----------|----------|----------------|
+| iOS | Swift, Objective-C | XCTest, XCUITest |
+| Android | Kotlin, Java | Espresso, UI Automator |
+| Flutter | Dart | flutter_test |
+| React Native | TypeScript, JavaScript | Detox, Jest |
+| Web | TypeScript, JavaScript | Playwright, Puppeteer |
+
+## Installation
+
+```bash
+npm install -g test-genie-mcp
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/MUSE-CODE-SPACE/test-genie-mcp.git
+cd test-genie-mcp
+npm install
+npm run build
+```
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "test-genie": {
+      "command": "npx",
+      "args": ["test-genie-mcp"]
+    }
+  }
+}
+```
+
+## Example Usage
+
+### Full Automation
+```
+User: "자동화 테스트해줘"
+
+Claude will:
+1. Analyze your app structure
+2. Generate test scenarios
+3. Execute tests
+4. Detect issues (memory leaks, logic errors)
+5. Suggest fixes
+6. Wait for your confirmation
+7. Apply approved fixes
+8. Generate report
+```
+
+### Step-by-Step
+
+```
+# Analyze app
+analyze_app_structure(projectPath: "/path/to/app")
+
+# Generate scenarios
+generate_scenarios(projectPath: "/path/to/app", testTypes: ["e2e", "unit"])
+
+# Detect memory leaks
+detect_memory_leaks(projectPath: "/path/to/app")
+
+# Get fix suggestions
+suggest_fixes(projectPath: "/path/to/app")
+
+# Confirm and apply fix
+confirm_fix(fixId: "xxx", action: "approve")
+apply_fix(fixId: "xxx")
+```
+
+## Fix Confirmation Workflow
+
+When issues are detected, Test Genie will:
+
+1. **Suggest Fixes**: Generate AI-powered fix suggestions with confidence scores
+2. **Show Diff**: Display exactly what will change
+3. **Await Confirmation**: Wait for user approval
+4. **Apply Fix**: Only apply after explicit approval
+5. **Backup**: Automatically create backups before applying
+
+Example confirmation prompt:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔧 Fix Suggestion #abc123
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 File: src/screens/HomeScreen.tsx:45
+📝 Title: Fix: useEffect missing cleanup
+🎯 Confidence: 90%
+
+📄 Current Code:
+┌──────────────────────────────────────────
+│ useEffect(() => {
+│   const subscription = api.subscribe();
+│ }, []);
+└──────────────────────────────────────────
+
+✨ Suggested Fix:
+┌──────────────────────────────────────────
+│ useEffect(() => {
+│   const subscription = api.subscribe();
+│   return () => subscription.unsubscribe();
+│ }, []);
+└──────────────────────────────────────────
+
+Actions: [✅ Approve]  [❌ Reject]  [✏️ Modify]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Tools Reference
+
+| Tool | Description |
+|------|-------------|
+| `analyze_app_structure` | Analyze codebase structure |
+| `generate_scenarios` | Generate test scenarios |
+| `create_test_plan` | Create test plan |
+| `run_scenario_test` | Run single scenario |
+| `run_simulation` | Run user simulation |
+| `run_stress_test` | Run stress test |
+| `detect_memory_leaks` | Detect memory leaks |
+| `detect_logic_errors` | Detect logic errors |
+| `suggest_fixes` | Generate fix suggestions |
+| `confirm_fix` | Confirm/reject fix |
+| `apply_fix` | Apply confirmed fix |
+| `rollback_fix` | Rollback applied fix |
+| `run_full_automation` | Run full automation pipeline |
+| `generate_report` | Generate test report |
+| `get_pending_fixes` | Get pending confirmations |
+| `get_test_history` | Get test history |
+| `analyze_performance` | Deep performance analysis |
+| `analyze_code_deep` | AST-based code analysis |
+| `generate_cicd_config` | Generate CI/CD configuration |
+
+## Platform-Specific Features
+
+### iOS
+- XCTest, XCUITest integration
+- Instruments profiling (Time Profiler, Allocations, Leaks)
+- Simulator management
+- Screenshot & video recording
+
+### Android
+- Gradle test integration
+- Espresso, UI Automator support
+- Android Profiler (CPU, Memory, Network)
+- LeakCanary integration
+- ADB device management
+
+### Flutter
+- flutter_test, integration_test
+- Golden tests (snapshot testing)
+- Performance profiling
+- Memory analysis
+
+### React Native
+- Jest, React Native Testing Library
+- Detox E2E testing
+- Performance monitoring
+- Memory leak detection
+
+### Web
+- Playwright, Cypress support
+- Lighthouse performance audits
+- Accessibility testing (axe-core)
+- Visual regression testing
+- Load testing (K6 integration)
+
+## License
+
+MIT
+
+## Author
+
+Yoonkyoung Gong

package/dist/analyzers/astAnalyzer.d.ts

@@ -0,0 +1,108 @@
+import { Platform, ComponentInfo, ApiInfo } from '../types.js';
+export interface FunctionInfo {
+    name: string;
+    path: string;
+    line: number;
+    parameters: {
+        name: string;
+        type: string;
+        optional: boolean;
+    }[];
+    returnType: string;
+    async: boolean;
+    complexity: number;
+    linesOfCode: number;
+    dependencies: string[];
+    calls: string[];
+    isExported: boolean;
+}
+export interface ClassInfo {
+    name: string;
+    path: string;
+    line: number;
+    extends?: string;
+    implements: string[];
+    properties: {
+        name: string;
+        type: string;
+        visibility: string;
+        static: boolean;
+    }[];
+    methods: FunctionInfo[];
+    isExported: boolean;
+}
+export interface ImportInfo {
+    module: string;
+    imports: {
+        name: string;
+        alias?: string;
+    }[];
+    isDefault: boolean;
+    isNamespace: boolean;
+    line: number;
+}
+export interface CodeAnalysisResult {
+    functions: FunctionInfo[];
+    classes: ClassInfo[];
+    imports: ImportInfo[];
+    exports: string[];
+    hooks: HookInfo[];
+    components: ComponentInfo[];
+    apis: ApiInfo[];
+    complexity: {
+        average: number;
+        max: number;
+        total: number;
+    };
+    issues: CodeIssue[];
+    metrics: {
+        totalLines: number;
+        codeLines: number;
+        commentLines: number;
+        blankLines: number;
+        functionCount: number;
+        classCount: number;
+    };
+}
+export interface HookInfo {
+    type: 'useState' | 'useEffect' | 'useCallback' | 'useMemo' | 'useRef' | 'useContext' | 'custom';
+    name: string;
+    line: number;
+    dependencies?: string[];
+    hasCleanup?: boolean;
+    initialValue?: string;
+}
+export interface CodeIssue {
+    type: 'error' | 'warning' | 'info';
+    category: 'memory' | 'performance' | 'security' | 'style' | 'logic';
+    message: string;
+    line: number;
+    column?: number;
+    file: string;
+    suggestion?: string;
+}
+export declare function analyzeTypeScript(filePath: string, content: string): CodeAnalysisResult;
+export declare function analyzeProject(projectPath: string, platform: Platform): Promise<{
+    files: {
+        path: string;
+        analysis: CodeAnalysisResult;
+    }[];
+    summary: {
+        totalFiles: number;
+        totalFunctions: number;
+        totalClasses: number;
+        totalComponents: number;
+        avgComplexity: number;
+        issueCount: {
+            error: number;
+            warning: number;
+            info: number;
+        };
+    };
+}>;
+declare const _default: {
+    analyzeTypeScript: typeof analyzeTypeScript;
+    analyzeProject: typeof analyzeProject;
+};
+export default _default;
+//# sourceMappingURL=astAnalyzer.d.ts.map

package/dist/analyzers/astAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/astAnalyzer.ts"],"names":[],"mappings":"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"}