Skip to content

docs(buildfile): note load() is confined to the workspace root - #83

Open
raphaelvigee wants to merge 1 commit into
mainfrom
claude/eager-galileo-xbtt3q
Open

docs(buildfile): note load() is confined to the workspace root#83
raphaelvigee wants to merge 1 commit into
mainfrom
claude/eager-galileo-xbtt3q

Conversation

@raphaelvigee

Copy link
Copy Markdown
Member

Summary

  • hephbuild/heph#277 (commit 66dea21) closed a security bug where load() path resolution had no workspace-root boundary check, so a ..-laden or //-absolute path (e.g. load("../../../../etc/hosts")) could escape the workspace and be parsed as Starlark. load() now enforces the same boundary check as file()/glob()/query(), rejecting such paths with an error.
  • website/docs/plugins/buildfile.md already documented this workspace-root boundary for file()/glob()/query() paths, but was silent on load(). Added one sentence to the "Sharing symbols with load()" section mirroring the existing statement, now that load() behaves the same way.

Not documented (out of scope, no user-facing docs claim to correct): the companion fix for package-address escapes (Provider::get/list/probe now returning empty/not-found for a ..-escaping package address) and the list_packages symlinked-BUILD-file fix — both are internal consistency fixes with no prior doc claims to update.

Test plan

  • Read-only prose change to an existing docs page; no build/lint run per routine instructions (no build env available in this session).
  • Reviewer: confirm the added sentence renders correctly and matches site voice.

Generated by Claude Code

load() now enforces the same workspace-root boundary as file()/glob()/query() —
a `..`-laden path that would resolve outside the workspace is rejected instead
of being followed.

Ref: hephbuild/heph@66dea21 (#277)
@github-actions

Copy link
Copy Markdown

⚡ Cloudflare Pages preview

Preview https://6b8a8de4.hephbuild.pages.dev
Commit b43248a

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