Skip to main content

Module snapshot

Module snapshot 

Source
Expand description

KnowledgeSnapshot — the single in-memory view of a project’s durable knowledge that every outbound rendering shares.

Before this existed, the Context Package builder read knowledge.json + relations.json inline and shaped its own KnowledgeLayer. Adding a second portable format (Open Knowledge Format, see super::okf) would have meant a second extractor reading the same stores with subtly different rules — the exact fragmentation the “one model, many renderings” positioning warns against. Instead both the ctxpkg KnowledgeLayer and the OKF Markdown bundle are rendered from this one snapshot, so they can never drift on what counts as the project’s knowledge.

The snapshot carries the full fact history (ctxpkg preserves superseded facts for fidelity); KnowledgeSnapshot::current_facts is the human-facing view portable exports use.

Structs§

KnowledgeRef
Receipt-safe reference to a selected portable knowledge object.
KnowledgeSnapshot
A consistent read of a project’s knowledge (facts + patterns + insights) and its relation graph, taken at one point in time. The single source of truth for outbound renderings (ctxpkg, OKF).