Flux
Flux for swamp: HelmReleases, Kustomizations and sources as three model types, read with kubectl and driven with the flux CLI.
A fork of @ginger_pappa/flux 2026.06.09.1 (MIT, copyright ginger_pappa) merged with the reset method this package used to add to it, so one package owns the types and nothing is pulled from another collective. helmrelease lists releases with chart, requested and applied versions, readiness and source, and reconciles, suspends and resumes one; kustomization does the same for Kustomizations with path, prune and the applied and attempted revisions; source lists GitRepository, HelmRepository and OCIRepository objects with URL, reference and artifact revision, skipping a kind whose CRD is not installed.
reset is the recovery action the base type lacked: a reconcile with --reset that clears a HelmRelease's failure counters so helm-controller tries again after RetriesExceeded, then reads the object back and records readiness, the newest Helm history status and both counters, so the outcome is a record and not a log line. Two live pre-flight checks confirm flux and kubectl can be run before anything starts, so a missing binary is a named refusal instead of a spawn error part-way through.
Changes from upstream: kubectl output that is not JSON is a named error; a HelmRelease declared through chartRef reports that as its source; the spec is read defensively; every kubectl resource is named by its full group. flux and kubectl are run by name from PATH and the model's namespace, kubeconfig and context are honoured, as upstream did.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned