Skip to content

feat: prepare SpectraScan 2.2.4b beta stabilization - #4

Merged
ItsWanheda merged 6 commits into
mainfrom
fix/2.2.4b-stabilization
Nov 5, 2026
Merged

ItsWanheda merged 6 commits into
mainfrom
fix/2.2.4b-stabilization

Conversation

@ItsWanheda

@ItsWanheda ItsWanheda commented Nov 5, 2026 •

Copy link
Copy Markdown
Owner

Summary

This PR proposes the 2.2.4b Beta stabilization work from fix/2.2.4b-stabilization into main.

The focus is protocol wire-format correctness, more conservative/evidence-based detection, reliable CLI routing, and cross-platform regression coverage. It also updates the project documentation to clearly distinguish the stable 2.2.0 line from this unreleased beta candidate.

Protocol correctness

  • SNMP: repair BER integer/OID encoding and response decoding; retain cross-platform snmpwalk discovery.
  • MongoDB: correct OP_MSG framing and BSON lengths, arrays, nested documents, and boolean handling.
  • Redis: improve RESP parsing and only report unauthenticated INFO exposure when the command succeeds.
  • MySQL / PostgreSQL: correct handshake, SSLRequest, startup-message, and packet framing.
  • NFS: correct ONC RPC record framing and XDR parsing for portmapper/export results.

Detection accuracy and safe findings

  • RDP: parse negotiation results and avoid inferring BlueKeep from an open port alone.
  • RTSP: parse response headers and SDP media sections before reporting stream exposure.
  • SMTP: consume multiline EHLO responses and avoid unsupported plaintext-credential claims when STARTTLS is unavailable.
  • Remove or narrow findings that were previously inferred without sufficient protocol evidence.

CLI and architecture

  • Accept HTTP(S) URLs and bare host:port targets correctly.
  • Route interactive protocol-menu actions through their actual scanner modules.
  • Handle async scan exceptions safely.
  • Preserve distinct service results for multiple ports (for example, SMB 139/445 and LDAP 389/636).
  • Make optional executable discovery portable through shutil.which.

Tests and CI

  • Add protocol parser, framing, dispatch, and URL-resolution regression coverage.
  • Extend static security analysis to the modified protocol modules and network-service aggregator.
  • CI passed on the final documentation commit 50af96d4:
    • Ubuntu and Windows
    • Python 3.10, 3.11, and 3.12
    • All six matrix jobs successful
    • 48 automated tests passed
    • Bandit -ll passed on Linux; 0 medium/high findings, with 7 low-severity findings remaining
    • pip-audit passed on Ubuntu / Python 3.12

View the successful CI run.

Beta and release documentation

  • README now labels the branch as 2.2.4b Beta, with beta installation instructions, scope, validation status, and a pre-release warning.
  • CHANGELOG records the beta fixes and validation.
  • SECURITY policy distinguishes beta preview builds from supported stable releases.

Release status: 2.2.4b is an unreleased beta candidate. No GitHub Release, version tag, or PyPI package has been published for it. The stable main line currently documents 2.2.0.

Review notes

  • This PR contains 6 commits and changes 15 files.
  • The feature branch is 6 commits ahead of main and 0 commits behind it at the time of opening.
  • No live interoperability test against every real-world implementation is claimed; protocol results should continue to be validated in authorized lab environments.
  • Please review the protocol behavior changes and beta/release wording before merging.

Checklist

  • Regression tests added
  • Linux / Windows CI matrix passed
  • Static security checks passed at the configured threshold
  • Dependency audit passed
  • Maintainer review
  • Beta status documented in README, CHANGELOG, and SECURITY
  • Merge decision

@ItsWanheda
ItsWanheda merged commit a2555f2 into main Nov 5, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant