Skip to content

Upgrade helm/k8s/cel-go deps; tighten docs wording - #1

Merged
dvrkn merged 3 commits into
mainfrom
claude/festive-bardeen-wm90v9
Sep 24, 2026
Merged

dvrkn merged 3 commits into
mainfrom
claude/festive-bardeen-wm90v9

Conversation

@dvrkn

@dvrkn dvrkn commented Sep 24, 2026

Copy link
Copy Markdown
Owner

Two changes, one commit each (plus a CI pin bump), so they can be reviewed separately.

Dependency upgrade

Module From To
helm.sh/helm/v4 v4.2.2 v4.3.0
k8s.io/{api,apimachinery,cli-runtime,client-go} v0.36.2 v0.37.1
cel-go github.com/google/cel-go v0.29.0 cel.dev/cel-go v0.32.0
santhosh-tekuri/jsonschema/v6 v6.0.2 v6.0.3
go.yaml.in/yaml/v3 v3.0.4 v3.0.5
golang.org/x/term v0.44.0 v0.46.0
go directive 1.26.4 1.26.8
golangci-lint (CI) v2.12.2 v2.13.2
  • cel-go changed its module path to cel.dev/cel-go in v0.32, so the imports in internal/spec/when.go change with it. khook is the only package in the binary that imports cel-go (k8s apiserver still requires the old path, but none of its CEL packages are linked), so the binary contains one copy.
  • Indirect deps are resolved by MVS from the direct upgrades, not bumped individually. Running go get -u ./... on everything pulls a kube-openapi pseudo-version that requires Go 1.27.
  • Go 1.27.1 is out, but I kept 1.26.x. Moving to 1.27 needs a golangci-lint release built with 1.27, and it's a bigger change than a dependency refresh. Better as a separate PR.
  • Release binary: 66.1 MB → 68.3 MB (+3%). The README badge and the AGENTS.md size note (which already said ~60 MB, out of date before this change) are updated.

Docs pass

The goal was shorter, plainer wording with the same content. I removed the pitch-style lines ("feared by everyone on call", "sleep-and-pray", "turf war", "That's the point", "Stop babysitting…") and most em-dash asides. Word count is down about 10–15% per page.

  • dsl.md / cli.md: every rule, table, and example is kept. Headings are unchanged so existing #anchor links still work (all in-repo anchors checked). The remote-content caveat that appeared twice under state: now appears once. Stale notes are gone: "v0-proven", "v0 examples survive in-tree" (they don't), and "(roadmap)" markers (none exist).
  • README, getting-started, examples, vs-terraform, ROADMAP: trimmed to match.
  • index.html, 404.html, _config.yml: copy changes only; markup and CSS are untouched.

Testing

  • go build ./..., go vet ./..., go test ./...: pass
  • golangci-lint run (v2.13.2): 0 issues
  • make build: links
  • k3d E2E could only partly run locally. The sandbox proxy blocks kubernetes.github.io and ghcr.io, and nested k3s can't start any pod (even its own coredns fails with failed to create containerd task). The spec validate / plan --offline / graph sections passed, and in the ops section every API call against the live cluster (apply, delete, Job create) worked; only the pod-readiness waits failed. The full E2E runs in this PR's CI.

Generated by Claude Code

- helm.sh/helm/v4 v4.2.2 -> v4.3.0
- k8s.io/{api,apimachinery,cli-runtime,client-go} v0.36.2 -> v0.37.1
- cel-go v0.29.0 -> v0.32.0; the module moved to cel.dev/cel-go, so
  the imports in internal/spec/when.go follow it. khook is the only
  importer of cel-go in the binary, so only one copy is linked.
- santhosh-tekuri/jsonschema v6.0.3, go.yaml.in/yaml/v3 v3.0.5,
  golang.org/x/term v0.46.0; indirect deps follow via MVS.
- go directive 1.26.4 -> 1.26.8 (latest 1.26 patch; CI reads it
  through go-version-file).

README badge and the AGENTS.md size note are updated to match; the
release binary is now ~68 MB.
Shorter, plainer prose with the same content. Drops the pitch-style
lines ("feared by everyone on call", "sleep-and-pray", "turf war",
"That's the point"), most em-dash asides, and stale asides such as the
"v0-proven" notes and the claim that v0 examples live in-tree.

- dsl.md / cli.md: same rules, tables, and examples; headings kept
  so existing #anchors still resolve. The duplicated remote-content
  caveat in state: now lives only under the tradeoffs.
- README, getting-started, examples, vs-terraform, ROADMAP: trimmed.
- index.html, 404.html, _config.yml: copy only, markup unchanged.
Runs clean (0 issues) against the upgraded module.
@dvrkn
dvrkn merged commit 5cbd751 into main Sep 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants