Chart Ledger: Helm Upgrade Reviews, with the Migration Guide Attached

Description and use

Chart Ledger automates Helm chart upgrade reviews by comparing manifests, ranking relevant migration‑guide passages, and generating a traceable report with unresolved questions.

Problem

Engineers need to review Helm chart upgrades, identify changed fields, locate relevant migration documentation, and track unresolved questions, but manual diffing and documentation lookup is tedious.

Outcome

Chart Ledger produces a traceable review report that lists changed Deployment fields, inventories other resource changes, highlights relevant migration‑guide passages with source links, records input hashes, and flags unresolved questions. The tool does not execute upgrades or declare deployments safe.

Workflow

• Validate input manifests and migration guide
• Compare selected Deployment fields (image, probe paths, ports, readOnlyRootFilesystem)
• Inventory other changed resources
• Construct reading questions from detected changes
• Rank migration‑guide passages using BGE reranker
• Generate source‑linked report (JSON/Markdown)
• Export report and record input hashes

Evidence

Chart Ledger takes before-and-after rendered Kubernetes manifests and a migration guide, compares selected Deployment settings, ranks relevant documentation passages and produces a source-linked review.

Source

The report contains: Changes to supported Deployment fields. An inventory of other changed resources. Relevant migration-guide passages and source locations. Input hashes and documentation coverage information. Unresolved questions requiring human review. JSON and Markdown exports.

Source

Chart Ledger uses BAAI/bge-reranker-base on CPU.

Source