Browse documentation
Code identity and test reuse
Exact dependency selection and per-case caching make changes inspectable.
Content addressing identifies specific source and artifacts. A dependency pin selects that identity. Changing the content produces a different pin; an existing pin does not silently acquire new bytes.
Identity has a scope
Original-library pins cover canonical source and dependency pins. Archive identities cover captured inputs and settings. Bundle identities cover emitted artifacts. Read the object named by a hash before treating it as a version.
Aliases can name the same exact owner. Different versions can coexist when selected explicitly, but equal-shaped types from distinct owners may still require conversions.
Updates remain compatibility decisions
A new pin makes a change explicit. Review its exported contracts, effects, authority requirements and saved-state implications. Exact identity does not establish API compatibility or benign behaviour.
Test caching is granular
With an explicit --cache, supported test commands reuse case outcomes whose relevant inputs are unchanged. Code, types, interfaces, settings, test inputs and dependencies participate in the decision. Changes to relevant components make the case run again.
The tooling reports reuse separately from fresh execution. Verification and executable generation still run fresh in this workflow; this is not general incremental compilation.
Installed package changes and local body edits can affect cache keys differently. Treat --explain-reuse as the explanation of the actual decision, not a guess based only on the edited filename.
Evidence records what ran
A graph-test receipt records consumed inputs, outcome and execution origin. An applicability query compares that test result with current inputs without running tests.
A reused result does not claim a new execution. Missing original bundle or environment provenance remains unknown. A content digest detects changes; it does not authenticate a publisher or prove trustworthiness.
Try code and evidence or update a library.