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.

ExactCacheOwner

Exclusive right to fetch and publish one single-flight cache miss.

ExactCacheSingleFlightOptions

Bounded timing policy for exact-cache single-flight coordination.

ExactCacheSingleFlightWait

Target-neutral liveness state shared by filesystem and browser substrates.

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.

ExactCacheOpen

Result of opening an exact cache with single-flight coordination.

ExactCacheSingleFlightDecision

Target-neutral next action for an exact-cache single-flight waiter.

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.