그래프 명령어

codeknit은 그래프 명령어를 제공하여 구조를 시각화하고, 자동화된 분석을 실행하며, 현재 의존성 그래프를 Git 변경 이력과 결합합니다.

graph show

코드베이스의 대화형 HTML 그래프 시각화를 생성합니다.

codeknit graph show <input-path>

이 명령어는 코드베이스를 파싱하고 대화형 그래프 시각화가 포함된 독립 실행형 HTML 파일을 생성합니다. 심볼(함수, 클래스, 타입)은 노드로 나타나고, 이들의 관계(호출, 포함, 구현)는 엣지로 나타납니다. 시각화는 기본 브라우저에서 자동으로 열립니다.

플래그

플래그	기본값	설명
`-o`, `--output`	`./skeleton/codeknit-graph.html`	출력 HTML 파일 경로
`--collect-test`	`false`	분석에 테스트 파일 포함
`--workers`	`NumCPU`	최대 동시 파싱 고루틴
`--verbose`	`false`	처리 중 진행 정보 출력

예시

# 기본 시각화 생성
codeknit graph show ./myproject

# 사용자 정의 출력 파일
codeknit graph show ./myproject -o graph.html

# 테스트 파일 포함
codeknit graph show ./src --collect-test

graph analyze

코드베이스에 구조적 그래프 알고리즘을 실행하고 LLM이 읽을 수 있는 .skt 보고서를 생성하여 코드 품질 인사이트를 제공합니다.

codeknit graph analyze <input-path>

이 명령어는 순환 의존성, 허브 심볼, 데드 코드, 갓 클래스, 아키텍처 병목과 같은 일반적인 코드 품질 문제를 감지합니다.

알고리즘

분석에는 22개의 구조적 그래프 알고리즘이 포함됩니다:

순환 의존성 (Tarjan의 SCC)
허브 감지 (높은 팬인/팬아웃 결합)
고아 감지 (데드 코드 후보)
갓 클래스/함수 감지 (과도한 자식)
불안정성 지표 (Robert C. Martin의 Ce/(Ca+Ce))
깊은 상속 체인
매개 중심성 (병목 감지)
절단점 (단일 실패 지점)
PageRank (재귀적 중요도)
전이 팬인 (영향 범위)
변경 전파 시뮬레이션
순환 패키지 의존성
계층 위반 감지
진입점 도달 가능성
약한 연결 요소
의존성 가중치 (패키지 결합 강도)
메인 시퀀스로부터의 거리 (A+I 균형)
샷건 수술 감지
기능 탐욕 감지
안정적 의존성 위반
인터페이스 분리 위반
포함 깊이

플래그

플래그	기본값	설명
`-o`, `--output`	`./skeleton/graph_analysis.skt`	출력 `.skt` 파일 경로
`--collect-test`	`false`	분석에 테스트 파일 포함
`--workers`	`NumCPU`	최대 동시 파싱 고루틴
`--verbose`	`false`	처리 중 진행 정보 출력
`--fan-threshold`	`10`	허브 심볼로 표시할 최소 팬인 또는 팬아웃
`--god-threshold`	`15`	갓 클래스/함수로 표시할 최소 포함 엣지 수
`--max-inheritance-depth`	`5`	이보다 깊은 상속 체인 표시
`--top-n`	`30`	순위 출력 섹션 제한; 0 = 제한 없음
`--betweenness-threshold`	`0.001`	보고할 최소 매개 중심성 값
`--propagation-cutoff`	`0.05`	변경 전파를 계속할 최소 확률

예시

# 기본값으로 구조 분석 실행
codeknit graph analyze ./myproject

# 사용자 정의 출력 및 임계값
codeknit graph analyze ./myproject -o analysis.skt --fan-threshold 15

# 섹션별 더 많은 결과 표시
codeknit graph analyze ./myproject --top-n 50

# 테스트 파일 포함
codeknit graph analyze ./src --collect-test

graph hotspots

자주 변경되고 구조적으로 중요한 파일을 순위화합니다:

codeknit graph hotspots <input-path>

점수는 커밋 빈도, 라인 변경량, 최신성과 파일 수준의 PageRank, 전이 팬인, 매개 중심성을 결합합니다. 또한 동일한 커밋에서 반복적으로 변경되는 파일 간의 시간적 결합도 식별합니다.

기본적으로 병합 커밋은 제외됩니다. 50개 이상의 파일을 변경하는 커밋도 제외되어 생성된 파일, 벤더링된 파일 또는 기계적인 대량 변경이 결과에 왜곡을 주지 않습니다.

플래그

플래그	기본값	설명
`-o`, `--output`	`./skeleton/hotspots.skt`	출력 파일 경로
`--format`	`skt`	출력 형식: `skt` 또는 `json`
`--since`	`12mo`	이력 기간, 예: `180d`, `12mo`, 또는 `2y`
`--max-commits`	`2000`	검사할 최대 커밋 수
`--max-files-per-commit`	`50`	더 많은 파일을 변경하는 커밋 제외
`--min-cochanges`	`3`	시간적 결합을 위한 최소 공유 커밋 수
`--top-n`	`30`	보고서 섹션별 최대 결과 수
`--include-merges`	`false`	병합 커밋 포함
`--collect-test`	`false`	테스트 파일 포함
`--workers`	`NumCPU`	최대 동시 파싱 고루틴
`--verbose`	`false`	진행 정보 출력

예시

# 지난 12개월 분석
codeknit graph hotspots ./myproject

# 2년 분석 및 JSON 출력
codeknit graph hotspots ./myproject --since 2y --format json -o hotspots.json

# 더 큰 커밋 포함 및 더 강한 결합 요구
codeknit graph hotspots . --max-files-per-commit 100 --min-cochanges 5