semantic-complexity 0.0.1-44fdea25

package/dist/compare.js

@@ -0,0 +1,354 @@
+/**
+ * McCabe 순환복잡도 vs 차원 복잡도 비교 분석기
+ *
+ * 사용법:
+ *   npx tsx src/compare.ts <파일경로>
+ *   npx tsx src/compare.ts <파일경로> --json
+ *   npx tsx src/compare.ts <파일경로> --threshold=10
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import ts from 'typescript';
+import { parseSourceFile, extractFunctionInfo } from './ast/parser.js';
+import { analyzeFunctionExtended } from './metrics/index.js';
+// ─────────────────────────────────────────────────────────────────
+// 등급 판정
+// ─────────────────────────────────────────────────────────────────
+function getMcCabeGrade(complexity) {
+    if (complexity <= 5)
+        return 'low';
+    if (complexity <= 10)
+        return 'moderate';
+    if (complexity <= 20)
+        return 'high';
+    return 'very-high';
+}
+function getCognitiveGrade(complexity) {
+    if (complexity <= 5)
+        return 'low';
+    if (complexity <= 10)
+        return 'moderate';
+    if (complexity <= 15)
+        return 'high';
+    return 'very-high';
+}
+// ─────────────────────────────────────────────────────────────────
+// 스칼라 점수 계산 (dimensional.ts와 동일 로직)
+// ─────────────────────────────────────────────────────────────────
+function scoreState(result) {
+    const s = result.dimensional.state;
+    return (s.enumStates * 1 +
+        s.stateMutations * 2 +
+        s.stateReads * 0.5 +
+        s.stateBranches * 3 +
+        s.stateMachinePatterns.length * 5);
+}
+function scoreAsync(result) {
+    const a = result.dimensional.async;
+    return (a.asyncBoundaries * 1 +
+        a.promiseChains * 2 +
+        a.retryPatterns * 3 +
+        a.timeouts * 2 +
+        a.callbackDepth * 3 +
+        a.concurrencyPatterns.length * 4 +
+        a.asyncErrorBoundaries * 1);
+}
+function scoreCoupling(result) {
+    const c = result.dimensional.coupling;
+    return (c.globalAccess.length * 2 +
+        c.implicitIO.length * 2 +
+        c.sideEffects.length * 3 +
+        c.envDependency.length * 2 +
+        c.closureCaptures.length * 1);
+}
+// ─────────────────────────────────────────────────────────────────
+// 인사이트 생성
+// ─────────────────────────────────────────────────────────────────
+function generateInsights(result) {
+    const insights = [];
+    const d = result.dimensional;
+    // McCabe vs 차원 복잡도 비교
+    const mccabe = result.cyclomatic;
+    const weighted = d.weighted;
+    if (weighted > mccabe * 2) {
+        insights.push(`⚠️ 차원 복잡도(${weighted.toFixed(1)})가 McCabe(${mccabe})의 2배 이상 - 숨은 복잡도 존재`);
+    }
+    // 차원별 분석
+    const stateScore = scoreState(result);
+    const asyncScore = scoreAsync(result);
+    const couplingScore = scoreCoupling(result);
+    // 3D 상태
+    if (d.state.stateMutations > 3) {
+        insights.push(`🔄 상태 변경 ${d.state.stateMutations}회 - 상태 관리 복잡도 높음`);
+    }
+    if (d.state.stateMachinePatterns.length > 0) {
+        insights.push(`🎛️ 상태 머신 패턴 ${d.state.stateMachinePatterns.length}개 탐지`);
+    }
+    // 4D 비동기
+    if (d.async.callbackDepth > 2) {
+        insights.push(`📥 콜백 중첩 깊이 ${d.async.callbackDepth} - 콜백 지옥 위험`);
+    }
+    if (d.async.concurrencyPatterns.length > 1) {
+        insights.push(`⚡ 동시성 패턴 ${d.async.concurrencyPatterns.length}개 - 레이스 컨디션 주의`);
+    }
+    if (d.async.asyncErrorBoundaries === 0 && d.async.asyncBoundaries > 0) {
+        insights.push(`🚨 비동기 코드에 에러 처리 없음`);
+    }
+    // 5D 결합
+    if (d.coupling.globalAccess.length > 2) {
+        insights.push(`🌐 전역 접근 ${d.coupling.globalAccess.length}회 - 테스트 어려움`);
+    }
+    if (d.coupling.sideEffects.length > 2) {
+        insights.push(`💥 부작용 ${d.coupling.sideEffects.length}개 - 예측 불가능성 증가`);
+    }
+    if (d.coupling.closureCaptures.length > 3) {
+        insights.push(`🔒 클로저 캡처 ${d.coupling.closureCaptures.length}개 - 메모리 누수 주의`);
+    }
+    // 차원 불균형 분석
+    const scores = [
+        { name: '상태(3D)', score: stateScore },
+        { name: '비동기(4D)', score: asyncScore },
+        { name: '결합(5D)', score: couplingScore },
+    ].filter((s) => s.score > 0);
+    if (scores.length > 0) {
+        const maxScore = Math.max(...scores.map((s) => s.score));
+        const dominant = scores.find((s) => s.score === maxScore);
+        if (dominant && maxScore > 5) {
+            insights.push(`📊 주요 복잡도 원인: ${dominant.name} (점수: ${maxScore.toFixed(1)})`);
+        }
+    }
+    return insights;
+}
+// ─────────────────────────────────────────────────────────────────
+// 파일 분석
+// ─────────────────────────────────────────────────────────────────
+export function analyzeFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const sourceFile = parseSourceFile(filePath, content);
+    const results = [];
+    function visit(node) {
+        const funcInfo = extractFunctionInfo(node, sourceFile);
+        if (funcInfo) {
+            const result = analyzeFunctionExtended(node, sourceFile, funcInfo);
+            const loc = funcInfo.location;
+            const stateScore = scoreState(result);
+            const asyncScore = scoreAsync(result);
+            const couplingScore = scoreCoupling(result);
+            const comparison = {
+                function: funcInfo.name,
+                location: `${path.basename(filePath)}:${loc.startLine}`,
+                mccabe: result.cyclomatic,
+                mccabeGrade: getMcCabeGrade(result.cyclomatic),
+                cognitive: result.cognitive,
+                cognitiveGrade: getCognitiveGrade(result.cognitive),
+                dimensional: {
+                    weighted: result.dimensional.weighted,
+                    control: result.dimensional.control,
+                    nesting: result.dimensional.nesting,
+                    state: stateScore,
+                    async: asyncScore,
+                    coupling: couplingScore,
+                },
+                insights: generateInsights(result),
+                hotspots: result.dimensional.hotspots,
+                dimensionalRatio: result.cyclomatic > 0
+                    ? Math.round((result.dimensional.weighted / result.cyclomatic) * 100) / 100
+                    : 0,
+            };
+            results.push(comparison);
+        }
+        ts.forEachChild(node, visit);
+    }
+    ts.forEachChild(sourceFile, visit);
+    return results;
+}
+// ─────────────────────────────────────────────────────────────────
+// 콘솔 출력
+// ─────────────────────────────────────────────────────────────────
+function printComparison(results, threshold = 0) {
+    const filtered = results.filter((r) => r.mccabe >= threshold || r.dimensional.weighted >= threshold);
+    if (filtered.length === 0) {
+        console.log(`\n임계값 ${threshold} 이상인 함수가 없습니다.\n`);
+        return;
+    }
+    console.log('\n' + '═'.repeat(80));
+    console.log(' McCabe vs 차원 복잡도 비교 분석');
+    console.log('═'.repeat(80));
+    // 헤더
+    console.log('\n' +
+        '함수명'.padEnd(30) +
+        'McCabe'.padStart(8) +
+        'Cognitive'.padStart(10) +
+        'Dimensional'.padStart(12) +
+        'Ratio'.padStart(8));
+    console.log('-'.repeat(68));
+    for (const r of filtered.sort((a, b) => b.dimensional.weighted - a.dimensional.weighted)) {
+        console.log(r.function.slice(0, 28).padEnd(30) +
+            `${r.mccabe}`.padStart(8) +
+            `${r.cognitive}`.padStart(10) +
+            `${r.dimensional.weighted.toFixed(1)}`.padStart(12) +
+            `${r.dimensionalRatio}x`.padStart(8));
+        // 차원별 분포
+        const dims = r.dimensional;
+        const bar = (score, max = 20) => {
+            const filled = Math.min(Math.round((score / max) * 10), 10);
+            return '█'.repeat(filled) + '░'.repeat(10 - filled);
+        };
+        console.log(`  └─ 1D 제어:  ${bar(dims.control)} ${dims.control.toFixed(1)}`);
+        console.log(`     2D 중첩:  ${bar(dims.nesting)} ${dims.nesting.toFixed(1)}`);
+        console.log(`     3D 상태:  ${bar(dims.state)} ${dims.state.toFixed(1)}`);
+        console.log(`     4D 비동기: ${bar(dims.async)} ${dims.async.toFixed(1)}`);
+        console.log(`     5D 결합:  ${bar(dims.coupling)} ${dims.coupling.toFixed(1)}`);
+        // 인사이트
+        if (r.insights.length > 0) {
+            console.log('  인사이트:');
+            for (const insight of r.insights) {
+                console.log(`    ${insight}`);
+            }
+        }
+        console.log();
+    }
+    // 요약 통계
+    console.log('─'.repeat(80));
+    console.log('📊 요약 통계');
+    console.log('─'.repeat(80));
+    const avgMccabe = filtered.reduce((s, r) => s + r.mccabe, 0) / filtered.length;
+    const avgDimensional = filtered.reduce((s, r) => s + r.dimensional.weighted, 0) / filtered.length;
+    const avgRatio = filtered.reduce((s, r) => s + r.dimensionalRatio, 0) / filtered.length;
+    console.log(`  분석 함수: ${filtered.length}개`);
+    console.log(`  평균 McCabe: ${avgMccabe.toFixed(1)}`);
+    console.log(`  평균 차원 복잡도: ${avgDimensional.toFixed(1)}`);
+    console.log(`  평균 비율 (차원/McCabe): ${avgRatio.toFixed(2)}x`);
+    // 고위험 함수
+    const highRisk = filtered.filter((r) => r.dimensionalRatio > 2 || r.dimensional.weighted > 20);
+    if (highRisk.length > 0) {
+        console.log(`\n  ⚠️ 고위험 함수 (ratio > 2x 또는 weighted > 20):`);
+        for (const r of highRisk) {
+            console.log(`    - ${r.function} @ ${r.location}`);
+        }
+    }
+    console.log('\n' + '═'.repeat(80));
+}
+// ─────────────────────────────────────────────────────────────────
+// 해석 가이드 출력
+// ─────────────────────────────────────────────────────────────────
+function printGuide() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════════╗
+║                    McCabe vs 차원 복잡도 해석 가이드                       ║
+╠════════════════════════════════════════════════════════════════════════════╣
+║                                                                            ║
+║  📐 McCabe 순환복잡도 (1976)                                               ║
+║  ─────────────────────────────────────────────────────────────────────────  ║
+║  • 정의: 분기점 개수 + 1                                                   ║
+║  • 측정: if, switch case, for, while, catch, &&, ||, ?:                    ║
+║  • 한계: 중첩 무시, 상태/비동기/결합 미반영                                ║
+║                                                                            ║
+║  등급 기준:                                                                ║
+║    🟢 1-5:   Low (단순, 테스트 용이)                                       ║
+║    🟡 6-10:  Moderate (적정)                                               ║
+║    🟠 11-20: High (리팩토링 권장)                                          ║
+║    🔴 21+:   Very High (반드시 리팩토링)                                   ║
+║                                                                            ║
+╠════════════════════════════════════════════════════════════════════════════╣
+║                                                                            ║
+║  🧠 차원 복잡도 (Dimensional Complexity)                                   ║
+║  ─────────────────────────────────────────────────────────────────────────  ║
+║                                                                            ║
+║  1D 제어 (×1.0): 순환복잡도 기반                                           ║
+║  2D 중첩 (×1.5): 중첩으로 인한 인지 부하                                   ║
+║  3D 상태 (×2.0): 상태 변수, 상태 머신 패턴                                 ║
+║  4D 비동기 (×2.5): async/await, Promise, 콜백                              ║
+║  5D 결합 (×3.0): 전역 접근, I/O, 부작용, 환경 의존                         ║
+║                                                                            ║
+║  가중치 근거:                                                              ║
+║  • 상태: 버그 발생률 2배 (IBM 연구)                                        ║
+║  • 비동기: 디버깅 시간 2.5배 (Salesforce 연구)                             ║
+║  • 결합: 테스트 커버리지 달성 3배 어려움                                   ║
+║                                                                            ║
+╠════════════════════════════════════════════════════════════════════════════╣
+║                                                                            ║
+║  📊 비율 (Ratio) 해석                                                      ║
+║  ─────────────────────────────────────────────────────────────────────────  ║
+║                                                                            ║
+║  Ratio = 차원 복잡도 / McCabe                                              ║
+║                                                                            ║
+║  • < 1.5: 순수한 제어 흐름 중심 (McCabe로 충분)                            ║
+║  • 1.5-2.0: 중첩/상태가 추가됨 (주의 필요)                                 ║
+║  • 2.0-3.0: 비동기/결합 복잡도 높음 (리팩토링 권장)                        ║
+║  • > 3.0: 숨은 복잡도 심각 (McCabe가 과소평가)                             ║
+║                                                                            ║
+╠════════════════════════════════════════════════════════════════════════════╣
+║                                                                            ║
+║  🎯 실무 권장 임계값                                                       ║
+║  ─────────────────────────────────────────────────────────────────────────  ║
+║                                                                            ║
+║  PoC/MVP 단계:                                                             ║
+║    • McCabe ≤ 15                                                           ║
+║    • 차원 복잡도 ≤ 30                                                      ║
+║                                                                            ║
+║  Production 단계:                                                          ║
+║    • McCabe ≤ 10                                                           ║
+║    • 차원 복잡도 ≤ 20                                                      ║
+║    • Ratio ≤ 2.0                                                           ║
+║                                                                            ║
+║  Mission Critical:                                                         ║
+║    • McCabe ≤ 5                                                            ║
+║    • 차원 복잡도 ≤ 10                                                      ║
+║    • 5D 결합 = 0 (순수 함수)                                               ║
+║                                                                            ║
+╚════════════════════════════════════════════════════════════════════════════╝
+`);
+}
+// ─────────────────────────────────────────────────────────────────
+// CLI 엔트리포인트
+// ─────────────────────────────────────────────────────────────────
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        console.log(`
+사용법:
+  npx tsx src/compare.ts <파일경로> [옵션]
+
+옵션:
+  --json           JSON 형식으로 출력
+  --threshold=N    복잡도 N 이상인 함수만 표시 (기본: 0)
+  --guide          해석 가이드 표시
+  --help, -h       도움말
+
+예제:
+  npx tsx src/compare.ts ./src/components/Signup.tsx
+  npx tsx src/compare.ts ./src/api/handler.ts --threshold=5
+  npx tsx src/compare.ts ./src/utils.ts --json
+  npx tsx src/compare.ts --guide
+`);
+        return;
+    }
+    if (args.includes('--guide')) {
+        printGuide();
+        return;
+    }
+    const filePath = args.find((a) => !a.startsWith('--'));
+    if (!filePath) {
+        console.error('파일 경로를 지정해주세요.');
+        process.exit(1);
+    }
+    const resolvedPath = path.resolve(filePath);
+    if (!fs.existsSync(resolvedPath)) {
+        console.error(`파일을 찾을 수 없습니다: ${resolvedPath}`);
+        process.exit(1);
+    }
+    const isJson = args.includes('--json');
+    const thresholdArg = args.find((a) => a.startsWith('--threshold='));
+    const threshold = thresholdArg ? parseInt(thresholdArg.split('=')[1], 10) : 0;
+    const results = analyzeFile(resolvedPath);
+    if (isJson) {
+        console.log(JSON.stringify(results, null, 2));
+    }
+    else {
+        printGuide();
+        printComparison(results, threshold);
+    }
+}
+main();
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,41 @@
+import type { AnalysisContext, AnalysisOptions } from '../types.js';
+/**
+ * MCP용 분석 컨텍스트 수집기
+ *
+ * LLM이 인지복잡도를 정확히 판단할 수 있도록
+ * 코드와 관련된 모든 컨텍스트를 수집합니다.
+ */
+export declare class ContextCollector {
+    private options;
+    private projectRoot;
+    private dependencyGraph;
+    private projectInfo?;
+    constructor(projectRoot: string, options?: Partial<AnalysisOptions>);
+    /**
+     * 파일에 대한 전체 분석 컨텍스트 수집
+     */
+    collectContext(filePath: string): Promise<AnalysisContext>;
+    /**
+     * MCP 응답용 프롬프트 생성
+     *
+     * LLM이 인지복잡도를 판단할 수 있도록
+     * 구조화된 프롬프트를 생성합니다.
+     */
+    generatePrompt(context: AnalysisContext, functionName?: string): string;
+    /**
+     * 관련 파일 분석
+     */
+    private analyzeRelatedFiles;
+    /**
+     * 프로젝트 정보 감지
+     */
+    private detectProjectInfo;
+}
+/**
+ * 단일 파일 빠른 분석 (MCP 도구용)
+ */
+export declare function quickAnalyze(filePath: string, functionName?: string): Promise<{
+    context: AnalysisContext;
+    prompt: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAGhB,MAAM,aAAa,CAAC;AAMrB;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,WAAW,CAAC,CAAc;gBAEtB,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAOnE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA8BhE;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IA6FvE;;OAEG;YACW,mBAAmB;IAuBjC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAsD1B;AAgBD;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAOvD"}