Closes #

• Bug fix
• New feature
• Enhancement to existing feature
• Documentation update
• Refactoring

• DCO sign-off -- Every commit carries Signed-off-by: (use git commit -s); see CONTRIBUTING.md
• Tests -- Unit tests covering happy path, edge cases, and error conditions
• Framework Docs -- New or updated MDX page under web/sites/guides/src/content/docs/v4-0-0-snapshot/ with matching sidebar entry
• AI Reference Docs -- New or updated file in .ai/wheels/ directory
• CLAUDE.md -- Updated if the feature changes model/controller/view conventions
• Changelog fragment -- New changelog.d/<slug>.<type>.md file (do NOT edit CHANGELOG.md directly; see changelog.d/README.md)
• Test runner passes -- All existing tests still pass (/wheels/tests/core?format=json)