Skip to content

docs(go): document the buildmode variant field - #95

Merged
raphaelvigee merged 1 commit into
mainfrom
claude/eager-galileo-sc15cd
Aug 13, 2026
Merged

docs(go): document the buildmode variant field#95
raphaelvigee merged 1 commit into
mainfrom
claude/eager-galileo-sc15cd

Conversation

@raphaelvigee

Copy link
Copy Markdown
Member

Summary

  • Documents the new buildmode build-variant field added by hephbuild/heph#393 (commit c4c525de1c3b521f93429ee97a30c4427fd641f6).
  • That change is user-facing and behavior-changing: the Go plugin used to hardcode -buildmode=pie for every linked binary, which on Linux always emits PT_INTERP (needs /lib/ld-linux-<arch>.so.1) even with cgo disabled — breaking FROM scratch/distroless images. It now defaults to buildmode = "exe" (static, matching plain go build), with buildmode = "pie" as an opt-in variant field to keep the old behavior.
  • Updated both doc copies per the repo's reference-drift rule:
    • website/docs/plugins/go.md — added buildmode to the build-variant field table plus a new "Buildmode: static vs PIE" subsection.
    • plugins/heph-go/skills/heph-go/references/go-plugin.md — mirrored the same addition in the heph-go skill's distilled reference.

Test plan

  • Docs-only change; no build required per instructions.
  • Reviewer sanity-check: buildmode semantics match crates/plugin-go/src/plugingo/factors.rs (BuildMode::Exe default, BuildMode::Pie, darwin/arm64 always-PIE note) as of hephbuild/heph@c4c525d.

🤖 Generated with Claude Code

https://claude.ai/code/session_011yDz3LnKDgG4wK9etquPek


Generated by Claude Code

heph's Go plugin now defaults binary links to buildmode=exe (static, no
interpreter) instead of hardcoded pie, and exposes a `buildmode` variant
field ("exe"/"pie") to opt back into PIE. Document the field and its
Linux/darwin behavior in both the plugin docs page and the heph-go skill's
reference twin.

Ref: hephbuild/heph#393 (c4c525de1c3b521f93429ee97a30c4427fd641f6)
@github-actions

Copy link
Copy Markdown

⚡ Cloudflare Pages preview

Preview https://14a3be2d.hephbuild.pages.dev
Commit 2fc465d

@raphaelvigee
raphaelvigee merged commit f8cff1c into main Aug 13, 2026
3 checks passed
@raphaelvigee
raphaelvigee deleted the claude/eager-galileo-sc15cd branch August 13, 2026 16:15
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