Skip to content

refactor: extract modem parser format families - #792

Merged
itsDNNS merged 2 commits into
mainfrom
refactor/driver-parser-families
Aug 14, 2026
Merged

refactor: extract modem parser format families#792
itsDNNS merged 2 commits into
mainfrom
refactor/driver-parser-families

Conversation

@itsDNNS

@itsDNNS itsDNNS commented Aug 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • extract modem payload normalization into 22 explicit, pure format profiles
  • keep transport, authentication, retries, TLS, cryptography, endpoint selection, and firmware detection in concrete drivers
  • retain existing driver and shared Arris import contracts through narrow adapters
  • add immutable profile metadata, dependency guards, direct parser contracts, and architecture documentation

Equivalence proof

  • covers all 21 built-in registry keys and 20 concrete driver classes
  • preserves all 66 frozen normalized output digests and structural counts
  • preserves channel order, scalar types, null and zero semantics, units, modulation, lock state, DOCSIS lanes, and counters
  • handles success, empty, missing, null, malformed, locked/active, OFDM, and OFDMA inputs without network access
  • removes nontrivial parser implementations from concrete drivers and reduces their source by about 32%; parser branch count falls by about 11%

Validation

  • 116 passed architecture, characterization, golden, and direct-profile tests
  • 3728 passed, 2 skipped complete non-E2E suite
  • 531 passed complete E2E suite with TZ=UTC
  • deterministic final golden report SHA-256: 5b7a01be977b6842493c34ccaf7f09821146ccc3605702daa0ae1085cd4c2396
  • compileall, git diff --check, and patch secret scan passed

Tracker: https://github.com/itsDNNS/docsight-optimization-offensive/issues/2

@itsDNNS
itsDNNS merged commit c95aa7d into main Aug 14, 2026
16 checks passed
@itsDNNS
itsDNNS deleted the refactor/driver-parser-families branch August 14, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant