DiffCatcher

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

# Varre todos os repositórios em um diretório (apenas fetch, sem modificações)
diffcatcher ~/projects

# Atualiza com pull e gera relatório de segurança
diffcatcher ~/projects --pull -o ./report

# Diferença entre duas branches em um único repositório (modo revisão de PR)
diffcatcher ./my-repo --diff main..feature/auth -o ./pr-report

# Gera saída SARIF para GitHub Code Scanning
diffcatcher ~/projects --summary-format sarif,json -o ./report

# Simulação para ver o que seria varrido
diffcatcher ~/projects --dry-run

# Varredura rápida com 8 trabalhadores paralelos
diffcatcher ~/projects -j 8 --quiet

# Varre com configurações padrão (apenas fetch)
diffcatcher <ROOT_DIR>

# Diretório de saída personalizado
diffcatcher ~/projects -o ./my-report

# Inclui repositórios aninhados e segue links simbólicos
diffcatcher ~/projects --nested --follow-symlinks

# Pula diretórios ocultos
diffcatcher ~/projects --skip-hidden

# Apenas fetch (padrão - sem alterações na árvore de trabalho)
diffcatcher ~/projects

# Realmente puxa alterações
diffcatcher ~/projects --pull

# Força pull com stash/pop para repositórios sujos
diffcatcher ~/projects --pull --force-pull

# Usa estratégia rebase
diffcatcher ~/projects --pull --pull-strategy rebase

# Pula fetch/pull completamente (apenas diffs históricos)
diffcatcher ~/projects --no-pull

# Pula extração de elementos (apenas diffs brutos)
diffcatcher ~/projects --no-summary-extraction

# Extrai elementos mas pula trechos de código
diffcatcher ~/projects --no-snippets

# Ajusta contexto e limites dos trechos
diffcatcher ~/projects --snippet-context 10 --max-snippet-lines 300

# Limita elementos por diff
diffcatcher ~/projects --max-elements 1000

# Pula marcação de segurança
diffcatcher ~/projects --no-security-tags

# Inclui arquivos de teste na análise de segurança
diffcatcher ~/projects --include-test-security

# Usa padrões de segurança personalizados
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_]*)"
    }
  ]
}

# Diferença entre duas branches em um único repositório
diffcatcher ./my-repo --diff main..feature/auth

# Diferença entre commits específicos
diffcatcher ./my-repo --diff abc123..def456

# Diferença com saída SARIF para integração CI
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

# Gera SARIF junto com outros formatos
diffcatcher ~/projects --summary-format sarif,json,md

# Apenas SARIF para upload em CI/CD
diffcatcher ~/projects --summary-format sarif -o ./report

# Modo incremental (pula repositórios inalterados)
diffcatcher ~/projects --incremental -o ./report

# Filtra por padrão de branch
diffcatcher ~/projects --branch-filter "main"

# Ajusta profundidade do histórico
diffcatcher ~/projects --history-depth 5

# Saída JSON para CI/CD
diffcatcher ~/projects --quiet --json > result.json

# Saída verbosa com caminhos descobertos
diffcatcher ~/projects --verbose

<report_dir>/
├── summary.json                    # Resumo global
├── summary.md                      # Resumo em Markdown
├── results.sarif                   # Saída SARIF 2.1.0 (quando --summary-format sarif)
├── security_overview.json          # Agregação de segurança entre repositórios
├── security_overview.md
├── <repo-name>/
│   ├── status.json                 # Estado do repositório
│   ├── pull_log.txt
│   └── diffs/
│       ├── diff_N_vs_N-1.patch     # Diff unificado bruto
│       ├── changes_N_vs_N-1.txt    # Manifesto de arquivos
│       ├── summary_N_vs_N-1.json   # Extração de elementos
│       ├── 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": "Processamento de dados PII",
      "severity": "High",
      "patterns": ["ssn", "social_security", "passport"]
    }
  ]
}

src/
├── cli.rs              # Análise de argumentos
├── scanner.rs          # Descoberta de repositórios
├── git/                # Operações Git
│   ├── commands.rs     # Wrappers Git
│   ├── state.rs        # Captura de estado
│   ├── diff.rs         # Geração de diffs
│   └── file_retrieval.rs
├── extraction/         # Extração de elementos
│   ├── parser.rs       # Analisador de diff unificado
│   ├── elements.rs     # Detecção de elementos
│   ├── snippets.rs     # Extração de trechos de código
│   ├── boundary.rs     # Rastreamento de colchetes/indentação
│   └── languages/      # Padrões específicos de linguagem
├── security/           # Marcação de segurança
│   ├── tagger.rs       # Correspondência de padrões
│   ├── patterns.rs     # Padrões incorporados
│   └── overview.rs     # Agregação entre repositórios
└── report/             # Geração de relatórios
    ├── writer.rs       # Estrutura de diretórios
    ├── json.rs         # Serialização JSON
    ├── sarif.rs        # Saída SARIF 2.1.0
    ├── markdown.rs     # Formatação Markdown
    └── snippet_writer.rs

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

# Executa todos os testes
cargo test

# Executa suíte de testes específica
cargo test security_tagger

# Executa com saída
cargo test -- --nocapture

# Compila binários de benchmark
cargo bench --no-run

# Executa harness de benchmark
cargo bench --bench core_bench

cargo doc --open