pub struct CheckpointHeader {
pub format_version: u32,
pub graph_version: String,
pub graph_hash: String,
pub policy_version: PolicyVersion,
pub logical_clock: u64,
pub manifest: Option<RunManifest>,
}Expand description
The provenance header stamped into every checkpoint.
Answers, for any stored checkpoint: which checkpoint format wrote it
(format_version), which graph produced it (graph_version +
graph_hash), under which policy (policy_version), and where it sits
on the run’s logical clock. Without this, a checkpoint is data; with it,
a checkpoint is interpretable evidence — replay can refuse (or migrate)
checkpoints whose format or graph no longer matches.
Added to Checkpoint with serde defaults: checkpoints written before
R0.5 (no header) deserialize into CheckpointHeader::default. R0.7
extends the header additively with the RunManifest pin set — same
rule: unset fields stay absent from the wire and old headers keep
deserializing.
Fields§
§format_version: u32Checkpoint envelope format version; CURRENT_FORMAT_VERSION for
anything written now.
graph_version: StringApplication-declared graph version (via RunConfig::with_graph_version),
or "unversioned" when the application does not version its graph.
graph_hash: StringSHA-256 content hash of the compiled graph topology (node names and
edge shape — see Graph::topology_hash). Detects graph drift between
a checkpoint and the code about to resume it; semantic node-body
changes are the application’s responsibility via graph_version.
policy_version: PolicyVersionThe executor policy active when the checkpoint was written.
logical_clock: u64The run’s logical clock value (milliseconds) at creation. Under the default system clock this is epoch milliseconds; under a logical clock it is the deterministic tick — either way it is the ordering and replay handle, not wall time.
manifest: Option<RunManifest>The versioned run manifest (R0.7): prompts, tool schemas, model and
parameters, memory schema, and capsule versions pinned for the run —
see RunManifest for the upgrade-safety contract. Stamped from
RunConfig::with_manifest at checkpoint time.
Additive: None (the default) is absent from the wire, so headers
written before R0.7 — and headers of runs that pin nothing — keep
their exact R0.5 shape.