Build graph

Hypermake graph ownership

Hypermake keeps recipes, target state, dependency manifests, and graph-owned projections explicit. The goal is not to hide build complexity behind dynamic endpoints, but to make useful artifacts cheap, static after build, and explainable from the graph.

Graph neighborhood, generated from the graphpublic://_hypermake/site/graph-diagram.json
src://components/component-bound.html source template data://campaign.json + 1 more recorded reads src/_components/*.html 33 components (recipe glob) tape://…/component-bound.html virtual tape prereq rendered://public/components/ component-bound.html (target) cache://hypermake/lzr/tape-ledgers/… component-bound.tape-ledger.json (990.0 KB) cache://hypermake/lzr/spans/… component-bound.rendered-spans.json (34.9 KB) cache://hypermake/lzr/data-reads/… component-bound.data-reads.json (7.5 KB)
SourceDataVirtual prereqRenderedCacheOwns / producesDepends on

This diagram is not an illustration: tools/site-graph-diagram.mjs asks hypermake explain and hypermake state-summary about the page above, checks the proof sidecars on disk, and emits the nodes and edges this SVG renders. If the graph changes, the diagram changes.

Target state (real, from this project)rendered://public/components/component-bound.html
Recipesrc/rendered/public/components/component-bound.html.make#1
Recipe digesta0b01cda0c03…
Tape prereqtape://rendered/public/components/component-bound.html
Root packetxxh128:dbaf037e21f2…
Freshness built (proof-backed)
hypermake state-summary rendered/public/components/component-bound.html --json
Common commands
hypermake explain rendered/public/components/component-bound.html hypermake graph public hypermake affected-by src/components/component-bound.html hypermake doctor
Why this matters

Every edge is explicit.No hidden steps; every output can be traced to its inputs.

Changes are incremental.Only affected nodes rebuild and re-render.

Agents and humans ask the same questions.Inspector and CLI read the same graph.

Graph-owned doctrine

Preferred shape for generated support data

NeedPreferred artifactAvoid
Testing digestpublic://_hypermake/testing/latest.jsonRequest-time route with hidden inputs.
Inspector class candidatesStatic JSON plus .d prerequisites.Ad hoc polling or UI recomputation.
Style applicabilityPrecompiled map keyed by template/source node.Browser-only cascade guessing.
Protocol docs indexesGenerated docs page or JSON target.Manual list that drifts from graph state.

Commands agents should reach for

Graph debugging loop shell
hypermake match rendered/public/docs/hypermake-graph.html
hypermake explain rendered/public/docs/hypermake-graph.html
hypermake affected-by src/docs/hypermake-graph.html
hypermake graph public --json --pretty=false
hypermake public --summary