DiffCatcher

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

# Scansiona tutti i repo in una directory (solo fetch, nessuna modifica)
diffcatcher ~/projects

# Esegui pull e genera report di sicurezza
diffcatcher ~/projects --pull -o ./report

# Crea diff tra due branch in un singolo repo (modalità revisione PR)
diffcatcher ./my-repo --diff main..feature/auth -o ./pr-report

# Genera output SARIF per GitHub Code Scanning
diffcatcher ~/projects --summary-format sarif,json -o ./report

# Esecuzione a secco per vedere cosa verrebbe scansionato
diffcatcher ~/projects --dry-run

# Scansione veloce con 8 lavoratori paralleli
diffcatcher ~/projects -j 8 --quiet

# Scansiona con impostazioni predefinite (solo fetch)
diffcatcher <ROOT_DIR>

# Directory di output personalizzata
diffcatcher ~/projects -o ./my-report

# Includi repo nidificati e segui i link simbolici
diffcatcher ~/projects --nested --follow-symlinks

# Salta directory nascoste
diffcatcher ~/projects --skip-hidden

# Solo fetch (predefinito - nessuna modifica al working tree)
diffcatcher ~/projects

# Esegui effettivamente il pull delle modifiche
diffcatcher ~/projects --pull

# Forza pull con stash/pop per repo sporchi
diffcatcher ~/projects --pull --force-pull

# Usa strategia rebase
diffcatcher ~/projects --pull --pull-strategy rebase

# Salta fetch/pull completamente (solo diff storici)
diffcatcher ~/projects --no-pull

# Salta estrazione elementi (solo diff grezzi)
diffcatcher ~/projects --no-summary-extraction

# Estrai elementi ma salta i frammenti di codice
diffcatcher ~/projects --no-snippets

# Regola contesto e limiti dei frammenti
diffcatcher ~/projects --snippet-context 10 --max-snippet-lines 300

# Limita elementi per diff
diffcatcher ~/projects --max-elements 1000

# Salta marcatura di sicurezza
diffcatcher ~/projects --no-security-tags

# Includi file di test nell'analisi di sicurezza
diffcatcher ~/projects --include-test-security

# Usa pattern di sicurezza personalizzati
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_]*)"
    }
  ]
}

# Crea diff tra due branch in un singolo repo
diffcatcher ./my-repo --diff main..feature/auth

# Crea diff tra commit specifici
diffcatcher ./my-repo --diff abc123..def456

# Crea diff con output SARIF per integrazione CI
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

# Genera SARIF insieme ad altri formati
diffcatcher ~/projects --summary-format sarif,json,md

# Solo SARIF per upload CI/CD
diffcatcher ~/projects --summary-format sarif -o ./report

# Modalità incrementale (salta repo invariati)
diffcatcher ~/projects --incremental -o ./report

# Filtra per pattern di branch
diffcatcher ~/projects --branch-filter "main"

# Regola profondità storica
diffcatcher ~/projects --history-depth 5

# Output JSON per CI/CD
diffcatcher ~/projects --quiet --json > result.json

# Output verboso con percorsi scoperti
diffcatcher ~/projects --verbose

<report_dir>/
├── summary.json                    # Riepilogo globale
├── summary.md                      # Riepilogo in Markdown
├── results.sarif                   # Output SARIF 2.1.0 (quando --summary-format sarif)
├── security_overview.json          # Aggregazione sicurezza cross-repo
├── security_overview.md
├── <repo-name>/
│   ├── status.json                 # Stato del repo
│   ├── pull_log.txt
│   └── diffs/
│       ├── diff_N_vs_N-1.patch     # Diff unificato grezzo
│       ├── changes_N_vs_N-1.txt    # Manifest dei file
│       ├── summary_N_vs_N-1.json   # Estrazione elementi
│       ├── 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": "Elaborazione dati PII",
      "severity": "High",
      "patterns": ["ssn", "social_security", "passport"]
    }
  ]
}

src/
├── cli.rs              # Analisi argomenti
├── scanner.rs          # Scoperta repository
├── git/                # Operazioni Git
│   ├── commands.rs     # Wrapper Git
│   ├── state.rs        # Cattura stato
│   ├── diff.rs         # Generazione diff
│   └── file_retrieval.rs
├── extraction/         # Estrazione elementi
│   ├── parser.rs       # Parser diff unificato
│   ├── elements.rs     # Rilevamento elementi
│   ├── snippets.rs     # Estrazione frammenti di codice
│   ├── boundary.rs     # Tracciamento parentesi/indentazione
│   └── languages/      # Pattern specifici per linguaggio
├── security/           # Marcatura di sicurezza
│   ├── tagger.rs       # Matching pattern
│   ├── patterns.rs     # Pattern integrati
│   └── overview.rs     # Aggregazione cross-repo
└── report/             # Generazione report
    ├── writer.rs       # Struttura directory
    ├── json.rs         # Serializzazione JSON
    ├── sarif.rs        # Output SARIF 2.1.0
    ├── markdown.rs     # Formattazione Markdown
    └── snippet_writer.rs

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

# Esegui tutti i test
cargo test

# Esegui una suite di test specifica
cargo test security_tagger

# Esegui con output
cargo test -- --nocapture

# Compila i binary di benchmark
cargo bench --no-run

# Esegui l'harness di benchmark
cargo bench --bench core_bench

cargo doc --open