DiffCatcher

git clone https://github.com/Teycir/DiffCatcher.git
cd DiffCatcher
cargo build --release
./target/release/diffcatcher --help

# 디렉터리 내 모든 저장소 스캔 (fetch 전용, 수정 없음)
diffcatcher ~/projects

# 업데이트 pull 및 보안 보고서 생성
diffcatcher ~/projects --pull -o ./report

# 단일 저장소에서 두 브랜치 차이 (PR 리뷰 모드)
diffcatcher ./my-repo --diff main..feature/auth -o ./pr-report

# GitHub Code Scanning용 SARIF 출력 생성
diffcatcher ~/projects --summary-format sarif,json -o ./report

# 스캔할 항목을 확인하는 드라이런
diffcatcher ~/projects --dry-run

# 8개의 병렬 워커로 빠른 스캔
diffcatcher ~/projects -j 8 --quiet

# 기본 설정으로 스캔 (fetch 전용)
diffcatcher <ROOT_DIR>

# 사용자 지정 출력 디렉터리
diffcatcher ~/projects -o ./my-report

# 중첩 저장소 포함 및 심볼릭 링크 따라가기
diffcatcher ~/projects --nested --follow-symlinks

# 숨김 디렉터리 건너뛰기
diffcatcher ~/projects --skip-hidden

# Fetch만 (기본값 - 워킹 트리 변경 없음)
diffcatcher ~/projects

# 실제로 변경 사항 pull
diffcatcher ~/projects --pull

# 더티 저장소에 대해 stash/pop으로 강제 pull
diffcatcher ~/projects --pull --force-pull

# 리베이스 전략 사용
diffcatcher ~/projects --pull --pull-strategy rebase

# fetch/pull 완전히 건너뛰기 (과거 차이만)
diffcatcher ~/projects --no-pull

# 요소 추출 건너뛰기 (원시 차이만)
diffcatcher ~/projects --no-summary-extraction

# 요소는 추출하지만 코드 조각은 건너뛰기
diffcatcher ~/projects --no-snippets

# 조각 컨텍스트 및 제한 조정
diffcatcher ~/projects --snippet-context 10 --max-snippet-lines 300

# 차이당 요소 제한
diffcatcher ~/projects --max-elements 1000

# 보안 태깅 건너뛰기
diffcatcher ~/projects --no-security-tags

# 보안 분석에 테스트 파일 포함
diffcatcher ~/projects --include-test-security

# 사용자 지정 보안 패턴 사용
diffcatcher ~/projects --security-tags-file ./custom-patterns.json

output = "reports-local"
no_pull = true
history_depth = 2
summary_formats = ["json", "txt"]
no_security_tags = false

[plugins]
security_pattern_files = ["plugins/security-extra.json"]
extractor_files = ["plugins/extractors.json"]

{
  "version": 1,
  "extractors": [
    {
      "name": "policy-rule",
      "kind": "Config",
      "regex": "^policy\\s+([A-Za-z_][A-Za-z0-9_]*)"
    }
  ]
}

# 단일 저장소에서 두 브랜치 차이
diffcatcher ./my-repo --diff main..feature/auth

# 특정 커밋 차이
diffcatcher ./my-repo --diff abc123..def456

# CI 통합용 SARIF 출력으로 차이
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

# 다른 형식과 함께 SARIF 생성
diffcatcher ~/projects --summary-format sarif,json,md

# CI/CD 업로드용 SARIF 전용
diffcatcher ~/projects --summary-format sarif -o ./report

# 증분 모드 (변경되지 않은 저장소 건너뛰기)
diffcatcher ~/projects --incremental -o ./report

# 브랜치 패턴으로 필터링
diffcatcher ~/projects --branch-filter "main"

# 과거 깊이 조정
diffcatcher ~/projects --history-depth 5

# CI/CD용 JSON 출력
diffcatcher ~/projects --quiet --json > result.json

# 발견된 경로를 포함한 자세한 출력
diffcatcher ~/projects --verbose

<report_dir>/
├── summary.json                    # 전체 요약
├── summary.md                      # Markdown 요약
├── results.sarif                   # SARIF 2.1.0 출력 (--summary-format sarif일 때)
├── security_overview.json          # 저장소 간 보안 집계
├── security_overview.md
├── <repo-name>/
│   ├── status.json                 # 저장소 상태
│   ├── pull_log.txt
│   └── diffs/
│       ├── diff_N_vs_N-1.patch     # 원시 통합 차이
│       ├── changes_N_vs_N-1.txt    # 파일 매니페스트
│       ├── summary_N_vs_N-1.json   # 요소 추출
│       ├── summary_N_vs_N-1.md
│       └── snippets/
│           ├── 001_validate_token_ADDED.rs
│           ├── 002_check_permissions_BEFORE.rs
│           ├── 002_check_permissions_AFTER.rs
│           └── 002_check_permissions.diff
└── ...

{
  "version": 1,
  "mode": "extend",
  "tags": [
    {
      "tag": "pii-handling",
      "description": "PII 데이터 처리",
      "severity": "High",
      "patterns": ["ssn", "social_security", "passport"]
    }
  ]
}

src/
├── cli.rs              # 인자 파싱
├── scanner.rs          # 저장소 검색
├── git/                # Git 작업
│   ├── commands.rs     # Git 래퍼
│   ├── state.rs        # 상태 캡처
│   ├── diff.rs         # 차이 생성
│   └── file_retrieval.rs
├── extraction/         # 요소 추출
│   ├── parser.rs       # 통합 차이 파서
│   ├── elements.rs     # 요소 탐지
│   ├── snippets.rs     # 코드 조각 추출
│   ├── boundary.rs     # 괄호/들여쓰기 추적
│   └── languages/      # 언어별 패턴
├── security/           # 보안 태깅
│   ├── tagger.rs       # 패턴 매칭
│   ├── patterns.rs     # 내장 패턴
│   └── overview.rs     # 저장소 간 집계
└── report/             # 보고서 생성
    ├── writer.rs       # 디렉터리 구조
    ├── json.rs         # JSON 직렬화
    ├── sarif.rs        # SARIF 2.1.0 출력
    ├── markdown.rs     # Markdown 형식화
    └── snippet_writer.rs

ls | while read line; do git -C "$line" diff HEAD~1 HEAD || true; done

# 모든 테스트 실행
cargo test

# 특정 테스트 스위트 실행
cargo test security_tagger

# 출력과 함께 실행
cargo test -- --nocapture

# 벤치마크 바이너리 컴파일
cargo bench --no-run

# 벤치마크 실행
cargo bench --bench core_bench

cargo doc --open