Skip to content

docs(go): note that GOFLAGS from the host has no effect - #106

Closed
raphaelvigee wants to merge 1 commit into
mainfrom
claude/eager-galileo-7x57k7
Closed

docs(go): note that GOFLAGS from the host has no effect#106
raphaelvigee wants to merge 1 commit into
mainfrom
claude/eager-galileo-7x57k7

Conversation

@raphaelvigee

Copy link
Copy Markdown
Member

Summary

  • Document that heph's go plugin does not read the host's GOFLAGS for go list/build — build tags belong on a variant's tags field instead.
  • Updated both the docs page (website/docs/plugins/go.md) and its Claude Code plugin reference twin (plugins/heph-go/skills/heph-go/references/go-plugin.md), per this repo's reference-drift rule.

Why

Triggered by hephbuild/heph@74d10bc (hephbuild/heph#448), which removed GOFLAGS from the go_golist driver's host environment passthrough. GOFLAGS (-mod=vendor, -tags=…, -buildvcs=…) changed what go list reported without being part of the cache key, so a listing cached under one GOFLAGS value could be silently served to a build with a different one. The PR itself calls this out as a behavior change: "a workspace relying on ambient GOFLAGS to influence Go builds stops getting that, silently." This PR adds a short doc note so users don't hit that silently and know where the supported equivalent lives.

Test plan

  • Read the triggering commit's diff and linked PR (#448) to confirm the removed variable and the stated behavior change.
  • Confirmed GOFLAGS/the host env passthrough list was previously undocumented anywhere in this site.
  • Docs-only change; no build attempted per instructions (no build environment available in this session).

Ref: hephbuild/heph@74d10bc


Generated by Claude Code

heph/heph#448 removed GOFLAGS from the go_golist driver's host
passthrough (it changed go list's output without keying the cache,
so a cached listing could be served to a build with a different
GOFLAGS). Document that build tags belong on a variant's `tags`
field, not in the environment.

Ref: hephbuild/heph@74d10bc
@github-actions

Copy link
Copy Markdown

⚡ Cloudflare Pages preview

Preview https://87385187.hephbuild.pages.dev
Commit 877b5d6

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