docs: heph.core.num_cpu/packages, heph.fs.parent, in_place vs copy guard#60
Open
raphaelvigee wants to merge 1 commit into
Open
docs: heph.core.num_cpu/packages, heph.fs.parent, in_place vs copy guard#60raphaelvigee wants to merge 1 commit into
raphaelvigee wants to merge 1 commit into
Conversation
Reflects hephbuild/heph#144 (commit 34dc78d930407611473721c736a3a1f8bb8576e0): - heph.core.num_cpu() and heph.core.packages(matcher) builtins - heph.fs.parent(filename) provider function - codegen=in_place no longer clobbers a file owned by a codegen=copy target Updates both the docs pages and their heph-expert skill reference twins per the reference-drift rule. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015xfeKHdizRWuQczcGrQgHA
⚡ Cloudflare Pages preview
|
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
2 participants
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.
What
Documents the user-facing additions from hephbuild/heph#144 (commit
34dc78d):heph.core.num_cpu()— CPUs available to the process. Added a row to theheph.coretable plus a usage example inwebsite/docs/plugins/buildfile.md.heph.core.packages(matcher)— sorted list of workspace package paths matching a query matcher string, evaluated per package (package-level matchers only; target-level matchers error). Documented alongsidenum_cpu()in the same page.heph.fs.parent(filename)— walks up from the current package to the workspace root and returns the workspace-root-relative path of the closestfilename, orNone. Added a row + example + note (bare filename only) towebsite/docs/plugins/fs.md.codegen = "in_place"guard — anin_placetarget no longer clobbers a tree file owned by acodegen = "copy"target;--frozenskips the same files symmetrically. Added a:::noteto thein_placesection ofwebsite/docs/concepts/codegen.md.Per the reference-drift rule in
CLAUDE.md, also updated theheph-expertskill reference twins:plugins/heph-expert/skills/heph/references/authoring.md(heph.core/heph.fstables)plugins/heph-expert/skills/heph/references/concepts.md(codegenin_placevscopyownership)No new pages, so no
sidebars.tschanges. Did not touchwebsite/docs/reference/cli.md(generated) or thegoplugin docs (unchanged per the PR — an earliergo_compile_srcaddition was reverted before merge).Test plan
lint— not run in this session (no build env available here); please verify in CI.build— not run in this session; please verify in CI.hephrepo source (crates/builtins/src/pluginfs/mod.rs,crates/plugin-buildfile/src/pluginbuildfile/run_file.rs,crates/engine/src/engine/result.rs) rather than the PR description alone.🤖 Generated with Claude Code
Generated by Claude Code