Enhance blocksCongruenceChecker tool

[nicov-iov]

This pull request significantly enhances the blocksCongruenceChecker tool by adding flexible command-line options, improving error handling, and introducing incremental progress/result saving. The tool can now re-insert missing or bad blocks, save progress in a robust way, and provide detailed usage instructions.

Major enhancements and new features:

Command-line interface improvements:

• Added support for several command-line options (--fromHigherBlock, --toLowerBlock, --insert, --progressSaveInterval) for flexible control over block range, insert mode, and progress saving interval, along with detailed usage instructions.

Progress tracking and result persistence:

• Introduced periodic and immediate saving of progress and results to a JSON Lines file, including status updates after each interval and after handling missing/bad blocks, ensuring results are not lost on interruption. [1] [2]

Insert/recovery functionality:

• Implemented an --insert mode that allows the tool to insert missing blocks and re-insert bad blocks after removal, including error tracking for insertions. [1] [2]

Error handling and reporting:

• Improved error reporting for block congruence checks and block insertions, including detailed error messages and stack traces, and tracking of congruence check errors in the status output.

Code structure and usability:

• Refactored the main function for clarity, added summary output at the end, and ensured the process exits with appropriate status codes based on success or failure. [1] [2]

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

OpenSSF Scorecard

Package	Version	Score	Details

Scanned Files