Scanner - Wraithbound Engineering

wraithbound-scanner.exe `
  --root "C:\Users\User\AppData\Roaming\wraithbound-launcher\storage\common\Vanilla1.17" `
  --manifest "C:\Users\User\AppData\Roaming\wraithbound-launcher\storage\metadata\1-revision.manifest.json" `
  --managed "mods" `
  --managed "mods/**" `
  --preserve "mods/local.jar" `
  --progress

Результат

{
  "schemaVersion": 1,
  "valid": ["libraries/example.jar"],
  "missing": ["mods/example.jar"],
  "modified": [],
  "extra": ["mods/unknown.jar"],
  "skippedOptional": [],
  "downloadBytes": 184523
}

--managed ограничивает поиск extra. Если он не передан, extra не собирается. --preserve исключает совпавшие пути из extra. Scanner ничего не скачивает и не удаляет. Missing optional файл попадает в skippedOptional, а не в обязательную загрузку.

Внутренняя архитектура

Бинарник является тонким entry point над библиотечной частью:

Модуль	Ответственность
`main.rs`	Парсинг CLI, единый fatal event и exit code
`lib.rs`	Последовательность `load manifest → scan → serialize result`
`manifest.rs`	Чтение schema v1, SHA-256 и проверка уникальности безопасных путей
`path_safety.rs`	Canonical root, запрет traversal/backslash и symlink parents
`hashing.rs`	Потоковый SHA-256 с буфером 1 MiB
`patterns.rs`	Скомпилированные `managed`/`preserve` glob-наборы
`progress.rs`	Потокобезопасный счётчик и JSON Lines в `stderr`
`scanner.rs`	Rayon-проверка manifest files, extra traversal и итоговый `ScanResult`

Такое разделение сохраняет процессный JSON-контракт, но позволяет независимо тестировать безопасность путей и правила области сканирования.

Проверка изменений

cargo fmt --check
cargo test
cargo clippy --all-targets -- -D warnings