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

# Сгенерировать вывод SARIF для GitHub Code Scanning
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

# Принудительный pull с stash/pop для "грязных" репозиториев
diffcatcher ~/projects --pull --force-pull

# Использовать стратегию rebase
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

# Сравнить с выводом SARIF для интеграции с CI
diffcatcher ./my-repo --diff origin/main..HEAD --summary-format sarif -o ./pr-report

# Генерация SARIF вместе с другими форматами
diffcatcher ~/projects --summary-format sarif,json,md

# Только SARIF для загрузки в CI/CD
diffcatcher ~/projects --summary-format sarif -o ./report

# Инкрементальный режим (пропустить неизменённые репозитории)
diffcatcher ~/projects --incremental -o ./report

# Фильтрация по шаблону ветки
diffcatcher ~/projects --branch-filter "main"

# Настройка глубины истории
diffcatcher ~/projects --history-depth 5

# Вывод JSON для CI/CD
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 data processing",
      "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