semantic-complexity 0.0.1-cedf2072

package/dist/metrics/index.js

@@ -0,0 +1,120 @@
+import ts from 'typescript';
+import { extractFunctionInfo, extractImports, extractExports } from '../ast/parser.js';
+import { calculateCyclomaticComplexity } from './cyclomatic.js';
+import { calculateCognitiveComplexity } from './cognitive.js';
+import { analyzeDimensionalComplexity, DEFAULT_WEIGHTS } from './dimensional.js';
+export { calculateCyclomaticComplexity, analyzeFunctionCyclomatic, analyzeFileCyclomatic, } from './cyclomatic.js';
+export { calculateCognitiveComplexity, analyzeFunctionCognitive, analyzeFileCognitive, } from './cognitive.js';
+export { analyzeStateComplexity, analyzeAsyncComplexity, analyzeCouplingComplexity, analyzeDimensionalComplexity, DEFAULT_WEIGHTS, } from './dimensional.js';
+/**
+ * 함수의 순환복잡도와 인지복잡도를 모두 계산
+ */
+export function analyzeFunction(functionNode, sourceFile, functionInfo) {
+    const cyclomatic = calculateCyclomaticComplexity(functionNode, sourceFile);
+    const cognitive = calculateCognitiveComplexity(functionNode, sourceFile, functionInfo.name !== '<anonymous>' ? functionInfo.name : undefined);
+    // 상세 정보 병합 (인지복잡도 기준, 더 상세함)
+    return {
+        function: functionInfo,
+        cyclomatic: cyclomatic.complexity,
+        cognitive: cognitive.complexity,
+        details: cognitive.details,
+    };
+}
+/**
+ * 함수의 확장된 복잡도 분석 (차원 복잡도 포함)
+ */
+export function analyzeFunctionExtended(functionNode, sourceFile, functionInfo, weights = DEFAULT_WEIGHTS) {
+    const cyclomatic = calculateCyclomaticComplexity(functionNode, sourceFile);
+    const cognitive = calculateCognitiveComplexity(functionNode, sourceFile, functionInfo.name !== '<anonymous>' ? functionInfo.name : undefined);
+    // nesting penalty 계산 (인지복잡도 - 순환복잡도 기반 추정)
+    const nestingPenalty = cognitive.details
+        .filter((d) => d.nestingLevel > 0)
+        .reduce((sum, d) => sum + d.nestingLevel, 0);
+    // 차원 복잡도 분석
+    const dimensional = analyzeDimensionalComplexity(functionNode, sourceFile, cyclomatic.complexity, nestingPenalty, weights);
+    return {
+        function: functionInfo,
+        cyclomatic: cyclomatic.complexity,
+        cognitive: cognitive.complexity,
+        details: cognitive.details,
+        dimensional,
+    };
+}
+/**
+ * 소스 파일의 모든 함수에 대한 복잡도 분석
+ */
+export function analyzeFile(sourceFile) {
+    const functions = [];
+    function visit(node, className) {
+        // 클래스 처리
+        if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) {
+            const name = node.name?.getText(sourceFile) ?? '<anonymous>';
+            node.members.forEach((member) => visit(member, name));
+            return;
+        }
+        // 함수 노드 확인
+        const functionInfo = extractFunctionInfo(node, sourceFile, className);
+        if (functionInfo) {
+            const result = analyzeFunction(node, sourceFile, functionInfo);
+            functions.push(result);
+        }
+        // 최상위 레벨만 순회 (중첩 함수는 상위 함수에서 처리)
+    }
+    ts.forEachChild(sourceFile, (node) => visit(node));
+    // 통계 계산
+    const totalCyclomatic = functions.reduce((sum, f) => sum + f.cyclomatic, 0);
+    const totalCognitive = functions.reduce((sum, f) => sum + f.cognitive, 0);
+    const count = functions.length || 1;
+    return {
+        filePath: sourceFile.fileName,
+        functions,
+        imports: extractImports(sourceFile),
+        exports: extractExports(sourceFile),
+        totalCyclomatic,
+        totalCognitive,
+        averageCyclomatic: totalCyclomatic / count,
+        averageCognitive: totalCognitive / count,
+    };
+}
+/**
+ * 복잡도 등급 판정
+ */
+export function getComplexityGrade(cyclomatic, cognitive) {
+    // 인지복잡도 기준 (SonarQube 기준)
+    if (cognitive <= 5 && cyclomatic <= 5)
+        return 'low';
+    if (cognitive <= 10 && cyclomatic <= 10)
+        return 'moderate';
+    if (cognitive <= 20 && cyclomatic <= 20)
+        return 'high';
+    return 'very-high';
+}
+/**
+ * 복잡도 요약 생성 (MCP용)
+ */
+export function generateComplexitySummary(result) {
+    const lines = [
+        `## 파일: ${result.filePath}`,
+        '',
+        `총 함수 수: ${result.functions.length}`,
+        `평균 순환복잡도: ${result.averageCyclomatic.toFixed(1)}`,
+        `평균 인지복잡도: ${result.averageCognitive.toFixed(1)}`,
+        '',
+    ];
+    // 복잡도가 높은 함수 목록
+    const highComplexity = result.functions
+        .filter((f) => f.cyclomatic > 10 || f.cognitive > 15)
+        .sort((a, b) => b.cognitive - a.cognitive);
+    if (highComplexity.length > 0) {
+        lines.push('### 리팩토링 권장 함수');
+        lines.push('');
+        for (const func of highComplexity) {
+            const grade = getComplexityGrade(func.cyclomatic, func.cognitive);
+            const loc = func.function.location;
+            lines.push(`- **${func.function.name}** (${loc.startLine}행): ` +
+                `순환=${func.cyclomatic}, 인지=${func.cognitive} [${grade}]`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,341 @@
+/**
+ * 소스 위치 정보
+ */
+export interface SourceLocation {
+    filePath: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+/**
+ * 함수/메서드 정보
+ */
+export interface FunctionInfo {
+    name: string;
+    kind: 'function' | 'method' | 'arrow' | 'getter' | 'setter' | 'constructor';
+    location: SourceLocation;
+    isAsync: boolean;
+    isGenerator: boolean;
+    isExported: boolean;
+    parameters: ParameterInfo[];
+    returnType?: string;
+    className?: string;
+}
+/**
+ * 파라미터 정보
+ */
+export interface ParameterInfo {
+    name: string;
+    type?: string;
+    isOptional: boolean;
+    isRest: boolean;
+    hasDefault: boolean;
+}
+/**
+ * 복잡도 결과
+ */
+export interface ComplexityResult {
+    function: FunctionInfo;
+    cyclomatic: number;
+    cognitive: number;
+    details: ComplexityDetail[];
+}
+/**
+ * 복잡도 상세 정보
+ */
+export interface ComplexityDetail {
+    type: ComplexityContributor;
+    location: SourceLocation;
+    increment: number;
+    nestingLevel: number;
+    description: string;
+}
+/**
+ * 복잡도 기여 요인
+ */
+export type ComplexityContributor = 'if' | 'else-if' | 'else' | 'switch' | 'case' | 'for' | 'for-in' | 'for-of' | 'while' | 'do-while' | 'catch' | 'conditional' | 'logical-and' | 'logical-or' | 'nullish-coalescing' | 'optional-chaining' | 'recursion' | 'callback' | 'nested-function';
+/**
+ * 파일 분석 결과
+ */
+export interface FileAnalysisResult {
+    filePath: string;
+    functions: ComplexityResult[];
+    imports: ImportInfo[];
+    exports: ExportInfo[];
+    totalCyclomatic: number;
+    totalCognitive: number;
+    averageCyclomatic: number;
+    averageCognitive: number;
+}
+/**
+ * Import 정보
+ */
+export interface ImportInfo {
+    source: string;
+    specifiers: ImportSpecifier[];
+    isTypeOnly: boolean;
+    location: SourceLocation;
+}
+/**
+ * Import 세부 정보
+ */
+export interface ImportSpecifier {
+    name: string;
+    alias?: string;
+    isDefault: boolean;
+    isNamespace: boolean;
+}
+/**
+ * Export 정보
+ */
+export interface ExportInfo {
+    name: string;
+    kind: 'function' | 'class' | 'variable' | 'type' | 'interface' | 're-export';
+    location: SourceLocation;
+    source?: string;
+}
+/**
+ * 의존성 그래프 노드
+ */
+export interface DependencyNode {
+    filePath: string;
+    imports: string[];
+    importedBy: string[];
+    depth: number;
+}
+/**
+ * 호출 그래프 노드
+ */
+export interface CallNode {
+    function: FunctionInfo;
+    calls: CallEdge[];
+    calledBy: CallEdge[];
+}
+/**
+ * 호출 그래프 엣지
+ */
+export interface CallEdge {
+    from: FunctionInfo;
+    to: FunctionInfo;
+    location: SourceLocation;
+    isConditional: boolean;
+    isAsync: boolean;
+}
+/**
+ * MCP용 컨텍스트 정보
+ */
+export interface AnalysisContext {
+    file: FileAnalysisResult;
+    dependencies: DependencyNode;
+    callGraph: CallNode[];
+    relatedFiles: FileAnalysisResult[];
+    projectInfo?: ProjectInfo;
+}
+/**
+ * 프로젝트 정보
+ */
+export interface ProjectInfo {
+    name: string;
+    root: string;
+    packageManager: 'npm' | 'pnpm' | 'yarn' | 'bun';
+    framework?: string;
+    language: 'typescript' | 'javascript' | 'mixed';
+}
+/**
+ * 분석 옵션
+ */
+export interface AnalysisOptions {
+    /** 순환복잡도 임계값 (기본: 10) */
+    cyclomaticThreshold: number;
+    /** 인지복잡도 임계값 (기본: 15) */
+    cognitiveThreshold: number;
+    /** 타입 정보 포함 여부 */
+    includeTypes: boolean;
+    /** 테스트 파일 제외 여부 */
+    excludeTests: boolean;
+    /** 분석 제외 패턴 */
+    excludePatterns: string[];
+    /** 관련 파일 포함 깊이 (의존성 그래프) */
+    contextDepth: number;
+}
+/**
+ * 기본 분석 옵션
+ */
+export declare const DEFAULT_OPTIONS: AnalysisOptions;
+/**
+ * 3D: 상태 복잡도 (State Complexity)
+ * 상태 공간과 분기의 결합으로 인한 복잡도
+ */
+export interface StateComplexity {
+    /** enum/union 타입 기반 상태 수 */
+    enumStates: number;
+    /** 상태 변경 지점 (setter, 재할당) */
+    stateMutations: number;
+    /** 상태 참조 지점 */
+    stateReads: number;
+    /** 상태 기반 분기 (상태값에 따른 조건문) */
+    stateBranches: number;
+    /** 상태 머신 패턴 탐지 */
+    stateMachinePatterns: StatePattern[];
+}
+/**
+ * 상태 패턴 정보
+ */
+export interface StatePattern {
+    kind: 'switch-enum' | 'reducer' | 'state-machine' | 'flag-based';
+    location: SourceLocation;
+    stateCount: number;
+    transitionCount: number;
+}
+/**
+ * 4D: 비동기/동시성 복잡도 (Async Complexity)
+ * 시간 축을 따라 발생하는 복잡도
+ */
+export interface AsyncComplexity {
+    /** async/await 경계 */
+    asyncBoundaries: number;
+    /** Promise 체인 깊이 */
+    promiseChains: number;
+    /** 재시도 패턴 (retry, exponential backoff 등) */
+    retryPatterns: number;
+    /** 타임아웃/인터벌 처리 */
+    timeouts: number;
+    /** 콜백 중첩 깊이 */
+    callbackDepth: number;
+    /** 동시성 패턴 (Promise.all, Promise.race 등) */
+    concurrencyPatterns: ConcurrencyPattern[];
+    /** 에러 경계 (try-catch in async) */
+    asyncErrorBoundaries: number;
+}
+/**
+ * 동시성 패턴 정보
+ */
+export interface ConcurrencyPattern {
+    kind: 'parallel' | 'race' | 'sequential' | 'batch' | 'throttle' | 'debounce';
+    location: SourceLocation;
+    promiseCount: number;
+}
+/**
+ * 5D: 숨은 결합 복잡도 (Hidden Coupling Complexity)
+ * 명시적으로 보이지 않는 의존성과 부작용
+ */
+export interface CouplingComplexity {
+    /** 전역 변수/싱글톤 접근 */
+    globalAccess: GlobalAccessInfo[];
+    /** 암묵적 I/O (console, DOM, fetch 등) */
+    implicitIO: ImplicitIOInfo[];
+    /** 부작용 (외부 상태 변경) */
+    sideEffects: SideEffectInfo[];
+    /** 환경 의존성 (process.env, window 등) */
+    envDependency: EnvDependencyInfo[];
+    /** 클로저 캡처 */
+    closureCaptures: ClosureCaptureInfo[];
+}
+/**
+ * 전역 접근 정보
+ */
+export interface GlobalAccessInfo {
+    name: string;
+    kind: 'global' | 'singleton' | 'static' | 'module-scope';
+    location: SourceLocation;
+    isWrite: boolean;
+}
+/**
+ * 암묵적 I/O 정보
+ */
+export interface ImplicitIOInfo {
+    kind: 'console' | 'dom' | 'fetch' | 'storage' | 'file' | 'network';
+    location: SourceLocation;
+    api: string;
+}
+/**
+ * 부작용 정보
+ */
+export interface SideEffectInfo {
+    kind: 'mutation' | 'event' | 'subscription' | 'timer';
+    location: SourceLocation;
+    target: string;
+    description: string;
+}
+/**
+ * 환경 의존성 정보
+ */
+export interface EnvDependencyInfo {
+    kind: 'process-env' | 'window' | 'document' | 'navigator' | 'location';
+    location: SourceLocation;
+    property: string;
+}
+/**
+ * 클로저 캡처 정보
+ */
+export interface ClosureCaptureInfo {
+    variableName: string;
+    location: SourceLocation;
+    capturedAt: SourceLocation;
+    isMutable: boolean;
+}
+/**
+ * 차원별 복잡도 가중치
+ */
+export interface DimensionalWeights {
+    /** 1D 제어 흐름 가중치 */
+    control: number;
+    /** 2D 중첩 가중치 */
+    nesting: number;
+    /** 3D 상태 가중치 */
+    state: number;
+    /** 4D 비동기 가중치 */
+    async: number;
+    /** 5D 결합 가중치 */
+    coupling: number;
+}
+/**
+ * 기본 차원 가중치 (연구 기반 초기값)
+ */
+export declare const DEFAULT_DIMENSIONAL_WEIGHTS: DimensionalWeights;
+/**
+ * 차원 기반 복잡도 결과
+ */
+export interface DimensionalComplexity {
+    /** 1D: 제어 흐름 복잡도 (순환복잡도 기반) */
+    control: number;
+    /** 2D: 중첩 복잡도 (인지복잡도의 nesting penalty) */
+    nesting: number;
+    /** 3D: 상태 복잡도 */
+    state: StateComplexity;
+    /** 4D: 비동기 복잡도 */
+    async: AsyncComplexity;
+    /** 5D: 숨은 결합 복잡도 */
+    coupling: CouplingComplexity;
+    /** 가중 합산 점수 */
+    weighted: number;
+    /** 사용된 가중치 */
+    weights: DimensionalWeights;
+    /** 각 차원별 기여도 (0-1) */
+    contributions: {
+        control: number;
+        nesting: number;
+        state: number;
+        async: number;
+        coupling: number;
+    };
+    /** 주요 복잡도 원인 (상위 3개) */
+    hotspots: DimensionalHotspot[];
+}
+/**
+ * 복잡도 핫스팟
+ */
+export interface DimensionalHotspot {
+    dimension: '1D-control' | '2D-nesting' | '3D-state' | '4D-async' | '5D-coupling';
+    score: number;
+    location: SourceLocation;
+    reason: string;
+}
+/**
+ * 확장된 복잡도 결과 (차원 포함)
+ */
+export interface ExtendedComplexityResult extends ComplexityResult {
+    dimensional: DimensionalComplexity;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,22 @@
+/**
+ * 기본 분석 옵션
+ */
+export const DEFAULT_OPTIONS = {
+    cyclomaticThreshold: 10,
+    cognitiveThreshold: 15,
+    includeTypes: true,
+    excludeTests: true,
+    excludePatterns: ['node_modules', 'dist', 'build', '.git'],
+    contextDepth: 2,
+};
+/**
+ * 기본 차원 가중치 (연구 기반 초기값)
+ */
+export const DEFAULT_DIMENSIONAL_WEIGHTS = {
+    control: 1.0, // 기준
+    nesting: 1.5, // 중첩은 1.5배
+    state: 2.0, // 상태 결합은 2배
+    async: 2.5, // 비동기는 2.5배 (Salesforce 연구 기반)
+    coupling: 3.0, // 숨은 결합은 3배 (디버깅 난이도 기반)
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoMA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,mBAAmB,EAAE,EAAE;IACvB,kBAAkB,EAAE,EAAE;IACtB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAC1D,YAAY,EAAE,CAAC;CAChB,CAAC;AAgJF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,OAAO,EAAE,GAAG,EAAI,KAAK;IACrB,OAAO,EAAE,GAAG,EAAI,WAAW;IAC3B,KAAK,EAAE,GAAG,EAAM,YAAY;IAC5B,KAAK,EAAE,GAAG,EAAM,+BAA+B;IAC/C,QAAQ,EAAE,GAAG,EAAG,yBAAyB;CAC1C,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "semantic-complexity",
+  "version": "0.0.1-cedf2072",
+  "description": "Multi-dimensional code complexity analyzer",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ast": {
+      "types": "./dist/ast/index.d.ts",
+      "import": "./dist/ast/index.js"
+    },
+    "./metrics": {
+      "types": "./dist/metrics/index.d.ts",
+      "import": "./dist/metrics/index.js"
+    },
+    "./graph": {
+      "types": "./dist/graph/index.d.ts",
+      "import": "./dist/graph/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "complexity",
+    "cognitive-complexity",
+    "cyclomatic-complexity",
+    "semantic",
+    "ast",
+    "static-analysis"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yscha88/semantic-complexity.git",
+    "directory": "packages/core"
+  },
+  "dependencies": {
+    "typescript": "^5.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "rimraf": "^6.0.1",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src",
+    "clean": "rimraf dist",
+    "compare": "tsx src/compare.ts",
+    "guide": "tsx src/compare.ts --guide"
+  }
+}