fix: resolve Sonar quality gate findings

[Brad-Edwards]

Summary

• resolve the 34 new-code findings blocking the Sonar quality gate on chore: merge dev to main #932
• split complex and oversized functions without changing runtime behavior
• correct unused imports, repeated literals, and test-quality findings

Test Plan

• nox -s lint
• repository policy check
• Python compilation check