Skip to content

docs(bazel): stop pinning a Go patch version in the gazelle_python note - #213

Merged
Syndic merged 1 commit into
mainfrom
docs/unpin-go-sdk-version-in-prose
Jul 29, 2026
Merged

docs(bazel): stop pinning a Go patch version in the gazelle_python note#213
Syndic merged 1 commit into
mainfrom
docs/unpin-go-sdk-version-in-prose

Conversation

@Syndic

@Syndic Syndic commented Jul 29, 2026

Copy link
Copy Markdown
Owner

What

MODULE.bazel's TEND(tooling) note about rules_python_gazelle_plugin said the plugin's cgo
tree-sitter dependency "does not compile under our Go 1.26.4 SDK". Renovate's 1.26.4 → 1.26.5 bump
(#210) moved the three go_sdk.download(version = …) pins but not the prose, so the comment named a
version the repo no longer uses. It now refers to "our pinned Go SDK".

Why no version at all

Checked upstream before genericizing, since a version-specific incompatibility would be worth
keeping: bazel-contrib/rules_python#3416
frames the smacker/go-tree-sitter problem as cgo making the gazelle binary hard to build/cross-compile
(Windows undefined: Node, Darwin targets), not as a regression at a particular Go release. The
pure-Go replacement, #3786, is still open,
so the rest of the note stands.

Other drift candidates

Swept the repo (1\.26\.[0-9] across *.md, *.bazel, *.yml, *.py, plus a broader go 1.x
pass). Nothing else needs a fix:

  • docs/future-considerations.md:163 — "the three real pins sat at 1.26.4 against a go.work
    already on 1.26.5" is a past-tense account of the custom-manager incident. Genericizing it would
    destroy the point; historical records don't drift.
  • meta/scripts/test_check_go_work.py, test_check_modules.py, test__workspace.pygo 1.26.1
    in synthetic go.work/go.mod fixtures written to temp dirs. No assertion compares them to the
    repo's SDK, so they can't become false.
  • MODULE.bazel:45,50,55, .devcontainer/devcontainer.json:14, go.work:1,
    tools/network_infrastructure_maintenance/go.mod:3 — real pins/directives, not prose.

Validation

  • bazel mod graph --depth=1 in the devcontainer — MODULE.bazel still resolves.
  • pre-commit run --files MODULE.bazel — all hooks correctly skip (none targets MODULE.bazel;
    their files: filters are go.(mod|work|sum), *.py, *.go, etc.).
  • Confirmed the Renovate go_sdk.download custom manager pattern never matched this comment, so
    removing the version doesn't touch pin coverage.

🤖 Generated with Claude Code

The TEND(tooling) comment named "our Go 1.26.4 SDK", which Renovate's
1.26.4 -> 1.26.5 bump (#210) left stale — it moved the go_sdk.download
pins but not the prose.

The patch version was never load-bearing: upstream
bazel-contrib/rules_python#3416 frames the smacker/go-tree-sitter
breakage as a cgo cross-compilation problem (Windows/Darwin), not a
regression at some Go release, so the comment now refers to the pinned
SDK without naming it.
@Syndic
Syndic enabled auto-merge (squash) July 29, 2026 10:04
@Syndic
Syndic merged commit 83b2770 into main Jul 29, 2026
26 checks passed
@Syndic
Syndic deleted the docs/unpin-go-sdk-version-in-prose branch July 29, 2026 10:09
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.

1 participant