Description
API-09 from the 2026-04-28 production-readiness audit, recorded as DEFERRED with the deferral documented in docs/versioning.md. Deliberately not done for v1alpha1: adding +kubebuilder:subresource:scale changes the CRD surface, and the audit’s call was to hold every non-forced API surface change until the v1 graduation pass so they land as one reviewable change rather than a drip of alpha churn.
This task exists so the deferral is visible in the queue rather than only in a gitignored audit file. Do not action it in isolation - it is a v1 graduation gate and should be picked up with the rest of docs/versioning.md’s six gates.
Acceptance Criteria
- #1 docs/versioning.md’s v1 graduation gates re-read and this decision confirmed or reversed with a stated reason
- #2 If adopted: +kubebuilder:subresource:scale markers added and CRDs regenerated by the wiring pass
- #3 If reversed: docs/versioning.md updated so the deferral is not left claiming something untrue
Definition of Done
- #1 make lint
- #2 make test
- #3 make manifests generate && git diff –exit-code (only if CRD types or RBAC markers changed)
- #4 make docs-check && make chart-docs-check (only if docs/ or chart values changed)