[tomvanmele]

Summary

• modernize packaging, CI, documentation, and release verification for the COMPAS 3 candidate
• align public typing and installed-package checks with the framework-wide contracts
• harden native wheel, sdist, licensing, and platform-tag verification
• update examples and ShapeOp constraint documentation without implementing the still-proposed solver API ADRs

Validation

• Ruff and formatting
• strict Pyright and 100% verifytypes
• 20 tests
• strict MkDocs and rendered-content verification
• sdist and native wheel verification, Twine, installed-wheel smoke and typing checks

Draft only. This targets c3-upgrade; main remains untouched.