DiffCatcher

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

# Alle Repos in einem Verzeichnis scannen (nur fetch, keine Änderungen)
diffcatcher ~/projects

# Updates pullen und Sicherheitsbericht erstellen
diffcatcher ~/projects --pull -o ./report

# Zwei Branches in einem einzelnen Repo difffen (PR-Review-Modus)
diffcatcher ./my-repo --diff main..feature/auth -o ./pr-report

# SARIF-Ausgabe für GitHub Code Scanning erzeugen
diffcatcher ~/projects --summary-format sarif,json -o ./report

# Trockenlauf, um zu sehen, was gescannt würde
diffcatcher ~/projects --dry-run

# Schnelles Scannen mit 8 parallelen Arbeitern
diffcatcher ~/projects -j 8 --quiet

# Standard-Scan (nur fetch)
diffcatcher <ROOT_DIR>

# Benutzerdefiniertes Ausgabeverzeichnis
diffcatcher ~/projects -o ./my-report

# Verschachtelte Repos einbeziehen und Symlinks folgen
diffcatcher ~/projects --nested --follow-symlinks

# Versteckte Verzeichnisse überspringen
diffcatcher ~/projects --skip-hidden

# Nur fetch (Standard – keine Arbeitsverzeichnis-Änderungen)
diffcatcher ~/projects

# Änderungen tatsächlich pullen
diffcatcher ~/projects --pull

# Force pull mit stash/pop für schmutzige Repos
diffcatcher ~/projects --pull --force-pull

# Rebase-Strategie verwenden
diffcatcher ~/projects --pull --pull-strategy rebase

# Fetch/Pull komplett überspringen (nur historische Diffs)
diffcatcher ~/projects --no-pull

# Element-Extraktion überspringen (nur rohe Diffs)
diffcatcher ~/projects --no-summary-extraction

# Elemente extrahieren, aber Code-Snippets überspringen
diffcatcher ~/projects --no-snippets

# Snippet-Kontext und -Grenzen anpassen
diffcatcher ~/projects --snippet-context 10 --max-snippet-lines 300

# Elemente pro Diff begrenzen
diffcatcher ~/projects --max-elements 1000

# Sicherheits-Tagging überspringen
diffcatcher ~/projects --no-security-tags

# Testdateien in die Sicherheitsanalyse einbeziehen
diffcatcher ~/projects --include-test-security

# Benutzerdefinierte Sicherheitsmuster verwenden
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_]*)"
    }
  ]
}

# Zwei Branches in einem einzelnen Repo difffen
diffcatcher ./my-repo --diff main..feature/auth

# Bestimmte Commits difffen
diffcatcher ./my-repo --diff abc123..def456

# Diff mit SARIF-Ausgabe für CI-Integration
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

# SARIF zusammen mit anderen Formaten erzeugen
diffcatcher ~/projects --summary-format sarif,json,md

# Nur SARIF für CI/CD-Upload
diffcatcher ~/projects --summary-format sarif -o ./report

# Inkrementeller Modus (unveränderte Repos überspringen)
diffcatcher ~/projects --incremental -o ./report

# Nach Branch-Muster filtern
diffcatcher ~/projects --branch-filter "main"

# Historientiefe anpassen
diffcatcher ~/projects --history-depth 5

# JSON-Ausgabe für CI/CD
diffcatcher ~/projects --quiet --json > result.json

# Ausführliche Ausgabe mit gefundenen Pfaden
diffcatcher ~/projects --verbose

<report_dir>/
├── summary.json                    # Globale Zusammenfassung
├── summary.md                      # Markdown-Zusammenfassung
├── results.sarif                   # SARIF 2.1.0-Ausgabe (wenn --summary-format sarif)
├── security_overview.json          # Repo-übergreifende Sicherheits-Aggregation
├── security_overview.md
├── <repo-name>/
│   ├── status.json                 # Repo-Zustand
│   ├── pull_log.txt
│   └── diffs/
│       ├── diff_N_vs_N-1.patch     # Roh-Unified-Diff
│       ├── changes_N_vs_N-1.txt    # Dateimanifest
│       ├── summary_N_vs_N-1.json   # Element-Extraktion
│       ├── 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": "Verarbeitung personenbezogener Daten",
      "severity": "High",
      "patterns": ["ssn", "social_security", "passport"]
    }
  ]
}

src/
├── cli.rs              # Argument-Parsing
├── scanner.rs          # Repository-Erkennung
├── git/                # Git-Operationen
│   ├── commands.rs     # Git-Wrapper
│   ├── state.rs        # Zustandserfassung
│   ├── diff.rs         # Diff-Generierung
│   └── file_retrieval.rs
├── extraction/         # Element-Extraktion
│   ├── parser.rs       # Unified-Diff-Parser
│   ├── elements.rs     # Element-Erkennung
│   ├── snippets.rs     # Code-Snippet-Extraktion
│   ├── boundary.rs     # Klammer/Einrückungs-Verfolgung
│   └── languages/      # Sprachspezifische Muster
├── security/           # Sicherheits-Tagging
│   ├── tagger.rs       # Mustervergleich
│   ├── patterns.rs     # Integrierte Muster
│   └── overview.rs     # Repo-übergreifende Aggregation
└── report/             # Berichtserstellung
    ├── writer.rs       # Verzeichnisstruktur
    ├── json.rs         # JSON-Serialisierung
    ├── sarif.rs        # SARIF 2.1.0-Ausgabe
    ├── markdown.rs     # Markdown-Formatierung
    └── snippet_writer.rs

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

# Alle Tests ausführen
cargo test

# Bestimmte Test-Suite ausführen
cargo test security_tagger

# Mit Ausgabe ausführen
cargo test -- --nocapture

# Benchmark-Binärdateien kompilieren
cargo bench --no-run

# Benchmark-Harness ausführen
cargo bench --bench core_bench

cargo doc --open