Dicklesworthstone/ultimate_bug_scanner v5.0.6

v5.0.6 - Documentation Deep-Dive

on GitHub

What's New

Technical Documentation Improvements

Added 201 lines of new documentation covering sophisticated scanner internals:

AST Rule Architecture: Ancestor-Aware Pattern Matching

• Documents the critical stopBy: end directive for ast-grep rules
• Explains how 19+ JavaScript rules use ancestor traversal to reduce false positives
• Shows before/after comparisons for try-catch, promise chains, and return statements

Inline Suppression Comments

• Full documentation for ubs:ignore comment syntax
• Examples for JavaScript, Python, and Ruby
• Suppression rules and anti-patterns to avoid

Cross-Language Async Error Detection

• Comprehensive table mapping async patterns across all 8 languages
• Detailed JavaScript promise chain analysis examples
• Shows what gets detected vs correctly ignored

Helper Script Verification

• Documents SHA-256 checksum verification for 7 helper scripts
• Shows ubs doctor validation output

Unified Severity Normalization

• ASCII table mapping tool-specific severities to UBS levels
• Documents consistent exit code behavior across languages

Previous Fixes (included since v5.0.5)

• fix(js-scanner): fix then-without-catch rules and promiseall consistency
• fix(js-scanner): improve .catch() chain detection in ast-grep rules
• fix(js-scanner): add stopBy: end for proper ancestor traversal

Test Results

• ✅ 67 tests pass across all 8 languages
• ✅ Clean fixtures produce 0 critical/warning issues

Install / Update

curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/ultimate_bug_scanner/master/install.sh?$(date +%s)" | bash