docs: BUILD-file LSP guide and exec pass_env wildcard#25
Merged
Conversation
Covers hephbuild/heph#81 (feat(buildfile): BUILD-file LSP). - Add guides/editor-setup.md: how to connect an editor to heph tool build-lsp - Update plugins/exec.md: document pass_env/runtime_pass_env "*" wildcard - Update sidebars.ts: register the new editor-setup guide
⚡ Cloudflare Pages preview
|
raphaelvigee
commented
Jun 13, 2026
raphaelvigee
commented
Jun 13, 2026
Member
Author
There was a problem hiding this comment.
remove all this
call this page Editor setup
description should not mention BUILD file specifically, keep it generic
add a VSCode section and mention the extension: https://marketplace.visualstudio.com/items?itemName=hephbuild.heph-nightly
raphaelvigee
commented
Jun 13, 2026
| heph tool build-lsp | ||
| ``` | ||
|
|
||
| ### VS Code |
Member
Author
There was a problem hiding this comment.
move vscode up, and the "Connecting an editor", nest "Neovim" and "Other Editors" under section and they should get a warning that the CLI may change without notice
…add CLI stability warning
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Covers user-facing changes from hephbuild/heph#81 (feat(buildfile): BUILD-file LSP).
guides/editor-setup.md— explains the BUILD-file language server: what it provides (completion, hover, go-to-definition, driver-field completion), how to launch it (heph tool build-lsp), setup examples for Neovim and generic LSP clients, and the synthetic//@heph/build:lsptarget.plugins/exec.md— documents the newpass_env = [\"*\"]andruntime_pass_env = [\"*\"]wildcard that passes all host env vars through, with examples and a note thatpass_env = [\"*\"]should only be used on uncached targets since it folds the entire environment into the cache key.sidebars.ts— registersguides/editor-setupin the Guides section.Test plan
buildpasses (Docusaurus produces no errors for the new page)lintcleanGenerated by Claude Code