Module exact_cache 

Exact-product cache identity binding and atomic publication.

The pure functions in this module define one commit record for every Sidereon interface, including WebAssembly hosts. On native targets, ExactProductCache adds bounded cross-process locking, immutable entry staging, durable writes, and an atomic reader-visible commit.

Network transport and product parsing remain outside this module. Callers must validate product semantics before publication and repeat that semantic validation on bytes returned from a cache hit.

Structs

CommittedExactCacheEntry

Paths and exact bytes from one verified immutable cache entry.

ExactCacheDigests

Digests and lengths bound by one exact-cache commit.

ExactCacheGuard

Held cross-process lock for one ExactProductCache.

ExactProductCache

One exact identity/source cache rooted at the caller’s stable product path.

VerifiedExactCacheCommit

Parsed, verified commit record.

Enums

ExactCacheError

Error produced by the shared exact-product cache protocol.

Constants

EXACT_CACHE_CONTROL_DIRECTORY

Directory below one exact identity/source cache directory.

EXACT_CACHE_MARKER_FILENAME

Name of the single reader-visible commit record.

EXACT_CACHE_SCHEMA_VERSION

Commit-record version shared by all Sidereon interfaces.

Functions

build_commit_record

Build a canonical commit record for an immutable cache transaction.

identity_sha256

Return the SHA-256 binding for every field of an exact product identity.

verify_commit_record

Verify that one marker and immutable byte triple belong to the requested full identity and explicit distribution source.