Repository navigation
Description
Delivery bundle: C: Convergence, APIs, and gated scalability. See #395 and #368 for the four-PR stack.
Parent: #393
Roadmap: #368
Plan item: PR-09
Priority: P2
Dependencies: PR-07
Kubernetes support: Rolling upstream-maintained minors; use the oldest/newest boundaries pinned in config/kubernetes-versions.env. See #368 for the current policy. Unrun jobs are not passed validation.
Problem Statement
Evidence: main.go:156 uses namespace-scoped cache defaults without transforms or a missing-informer policy. Cached reads can create previously undeclared informers; Owns does not filter cache content to owned objects.
Proposed Solution
Files: main.go, controller setup/cache tests, pkg/k8sutil/cache.go, resource/PKI readers, and Helm configuration only if necessary.
Interface contract: Declare required informers deliberately; use ReaderFailOnMissingInformer in tests first. Permit direct reads for infrequently accessed external objects. Evaluate TransformStripManagedFields without altering object semantics.
- Add tests for an unexpected cached type, user-provided unlabeled TLS Secrets, cluster-scoped Nodes/CSRs, and optional cert-manager/Contour CRDs absent.
- Inventory reads versus watches by kind and namespace; classify each as declared cache or intentional direct read.
- Benchmark managed-fields stripping and safe per-kind selectors. Do not enable a filter that hides referenced resources, strips fields used for decisions, or changes ownership.
- Enable production fail-fast behavior only after all supported integrations pass the inventory tests.
- Validate focused manager/controller/PKI tests and compare RSS, allocations, informer count, startup list bytes, and convergence against PR-07.
Done when: Cache behavior is explicit and any merged memory optimization has measured benefit without missing-resource regressions.
Delivery: Four consolidated PRs, approved November 16, 2026: A -> B -> C; D branches from A. Foundation is #395. The 22 PR-XX identifiers are work-item IDs, not separate PRs. Preserve every work-item acceptance criterion and native dependency. No gated experiment is automatically enabled, and no issue is complete merely because one PR references it. D must satisfy its native #375 gate, including lifecycle-domain signals assigned to B; branching from A does not waive that merge prerequisite. Write focused regression tests first; record exact commands/results and run make check plus this issue's real-cluster/measurement gates.
Alternatives Considered
Twenty-two individual PRs add unnecessary integration overhead, while one omnibus PR obscures correctness and rollout boundaries. Deliver this scope in its approved dependency-aligned bundle. Do not expand into deferred consistency, storage, or concurrency changes without their own decision gates.
Additional Context
Baseline: 95138e0d; detailed roadmap scope: #368, section PR-09. The roadmap #368 and its native sub-issues are the planning source of truth. No planning document is committed in the final PR diffs. Re-read affected source and overlapping work before implementation. Historical baseline test passes are not validation of this change.
Activity
amuraru commentedon Nov 17, 2026
Removed from active scope under #368: no measured cache problem currently justifies an informer-policy/cache-filter project. Revisit only if #393 measurements identify a worthwhile specific change. No cache optimization claimed.