Description
The baseline CI required by Renovate automerge has been red since cede7dd (2026-08-10). The Helm job exposes two related defects introduced when the chart homepage moved to the documentation site:
charts/graph2otel/README.mdstill contains the old GitHub homepage.make helm-docspasses the chart directory itself as--chart-search-root; helm-docs searches children of that root, discovers no charts, exits successfully, and therefore cannot regenerate the stale README. This silent no-op is why the generated output was missed and why the documented repair command did not repair it.
The fix must point helm-docs at the parent charts directory and regenerate the README from README.md.gotmpl plus Chart.yaml. Do not edit the generated README alone.
Acceptance Criteria
- #1 make helm-docs produces no diff on a clean tree
- #2 The ‘helm lint + template’ job passes on main
- #3 The fix is the regenerated output, not a hand-edit of charts/graph2otel/README.md
- #4 The make helm-docs target discovers the graph2otel chart instead of exiting successfully without generating anything
Definition of Done
- #1 make check is green — vet, go test -race ./…, lint, govulncheck, tidy-check, tools-check, forks-check, grafana-check, build. Evidence, not assertion: paste or cite the run.
- #2 make regen run and its output committed if the change touches a registry-driven or generated surface (collectors, env vars, beta drift spec).
- #3 Committed green to main and pushed, with the resulting SHA recorded in this task.
Implementation Plan
- Regenerate the Helm chart README from its template. 2. Verify the generated file is stable and run the full repository gate.
Implementation Notes
Reproduced 2026-08-16: the existing make target exited 0 without a Found Chart message and left the stale homepage unchanged. Directly using –chart-search-root charts found graph2otel and produced the expected one-line README update. This corrects the earlier task claim that make helm-docs already generated the diff. Evidence class: locally measured (2026-08-16, GTO-0003).
Validation 2026-08-16: make helm-docs logged Found Chart directories [graph2otel] and a second run preserved the README SHA-256 exactly. The CI-only acceptance criterion remains unchecked until the branch runs on GitHub.
2026-11-06 locally measured: the current pinned helm-docs v1.14.2 finds the chart and regenerates the existing version-footer template correctly. The checked-in README was missing exactly the final two footer lines. The required full gate reached this drift only after the independent compression audit fix; all preceding module/race/audit and 411 dashboard tests passed. This correction retains the generated footer rather than editing the template or weakening the drift check. The final combined candidate must still pass a fresh full gate; main CI remains unverified.