Module context_checkpoint 

Canonical typed live-state checkpoint domain (ContextCheckpointV1).

A ContextCheckpointV1 is the portable semantic state needed to continue work: the active task, its progress, the decisions taken, the files in scope, the pinned policies and packages, and the lineage refs that bind the checkpoint to its project, workspace, plan, and receipts. It is explicitly not a Session Bundle (bounded session transfer), a Handoff Bundle (point-to-point handoff), a .ctxpkg (installable asset), or a Context Snapshot (signed point-in-time evidence).

The domain carries no machine-local or process-local state: absolute paths, credentials, API keys, provider cache handles, PIDs, locks, temp directories, and live-zone payloads are rejected at construction time, not merely discouraged. Every bounded string and every collection has an explicit cap, every identity is validated, and every public constructor is fallible so that invalid state can never reach a digest or a signature through an infallible API.

Projections, merge, migration, signing, and trust evaluation are downstream slices. They are represented here only by stable typed seams (ContextCheckpointProjectionV1, ContextCheckpointMergePolicyV1, ContextCheckpointMigrationV1, ContextCheckpointSignerV1) plus the sealed ContextCheckpointSigningPayloadV1 and ContextCheckpointDigestInputsV1 carriers those slices consume.

Structs

ContextCheckpointArtifactLineageV1

Authoritative content references for the task, plan, and signed receipts represented by a V2 checkpoint.

ContextCheckpointBranchIdV1

Bounded slug naming the checkpoint branch a device writes to.

ContextCheckpointCarrierBindingV1

Binding to an existing P6 .ctxpkg checkpoint carrier envelope.

ContextCheckpointDecisionV1

One decision taken while working the task.

ContextCheckpointDeviceIdV1

Bounded slug naming the device that produced a checkpoint.

ContextCheckpointDigestInputsV1

Domain-separated digests derived from one validated checkpoint.

ContextCheckpointEncryptionMetadataV1

Reference-only encryption metadata bound into the checkpoint digest.

ContextCheckpointFileV1

One file in scope for the checkpointed work, identified without any path.

ContextCheckpointIdV1

Canonical lowercase hyphenated UUID identifying one checkpoint.

ContextCheckpointIdentityV1

Parent, branch, and device identity of one checkpoint.

ContextCheckpointLearningStateV1

Portable reference to a separately stored learning-state projection.

ContextCheckpointLineageV1

Lineage references binding a checkpoint to the rest of the work graph.

ContextCheckpointLineageV2

V2 checkpoint lineage that adds authoritative artifact references without changing the deployed ContextCheckpointLineageV1 wire shape.

ContextCheckpointLiveStateV1

The portable live state needed to continue the task.

ContextCheckpointPackagePinV1

A package pinned by the checkpoint.

ContextCheckpointPolicyPinV1

A policy pinned by the checkpoint.

ContextCheckpointProgressV1

Bounded progress report for the active task.

ContextCheckpointSessionStateV1

Portable, bounded session state needed to continue work.

ContextCheckpointSigningPayloadV1

Sealed signature payload for one validated checkpoint.

ContextCheckpointTaskV1

The task a checkpoint continues.

ContextCheckpointTextV1

Bounded single-line free text carried by the live state.

ContextCheckpointV1

Canonical typed live-state checkpoint.

ContextCheckpointV2

Canonical checkpoint contract carrying authoritative artifact lineage.

Enums

ContextCheckpointDecisionStatusV1

Status of a decision recorded in the live state.

ContextCheckpointEncryptionAlgorithmV1

Encryption metadata for a separately encrypted checkpoint projection.

ContextCheckpointFileRoleV1

Role a file plays in the checkpointed work.

ContextCheckpointTaskStatusV1

Lifecycle status of the task a checkpoint continues.

Constants

CONTEXT_CHECKPOINT_CARRIER_ENVELOPE_DIGEST_DOMAIN

Digest domain string used by the P6 carrier for envelope_digest.

CONTEXT_CHECKPOINT_CARRIER_LOGICAL_STATE_KEYS

Exact key set of the P6 carrier logical_state object, in canonical order.

CONTEXT_CHECKPOINT_CARRIER_LOGICAL_STATE_SCHEMA_ID

Schema identity of the P6 carrier logical_state object.

CONTEXT_CHECKPOINT_CARRIER_SCHEMA_ID

Schema identity of the P6 .ctxpkg checkpoint carrier envelope.

CONTEXT_CHECKPOINT_CARRIER_STATE_DIGEST_DOMAIN

Digest domain string used by the P6 carrier for state_digest.

CONTEXT_CHECKPOINT_DIGEST_DOMAIN

Domain prefix for the whole-checkpoint content digest.

CONTEXT_CHECKPOINT_IDENTITY_DIGEST_DOMAIN

Domain prefix for the checkpoint identity digest.

CONTEXT_CHECKPOINT_LINEAGE_DIGEST_DOMAIN

Domain prefix for the checkpoint lineage digest.

CONTEXT_CHECKPOINT_LIVE_STATE_DIGEST_DOMAIN

Domain prefix for the checkpoint live-state digest.

CONTEXT_CHECKPOINT_SCHEMA_ID

Schema identity of the canonical live-state checkpoint contract.

CONTEXT_CHECKPOINT_SIGNATURE_DOMAIN

Domain prefix covered by a downstream checkpoint signature.

CONTEXT_CHECKPOINT_V2_DIGEST_DOMAIN

Domain prefix for the V2 checkpoint content digest.

CONTEXT_CHECKPOINT_V2_LINEAGE_DIGEST_DOMAIN

Domain prefix for the V2 checkpoint lineage digest.

CONTEXT_CHECKPOINT_V2_SCHEMA_ID

Schema identity of the additive artifact-lineage checkpoint contract.

CONTEXT_CHECKPOINT_V2_SIGNATURE_DOMAIN

Domain prefix covered by a V2 checkpoint signature.

MAX_CONTEXT_CHECKPOINT_DECISIONS

Maximum decisions carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_DECISION_REFS

Maximum evidence refs carried by one decision.

MAX_CONTEXT_CHECKPOINT_ENCODED_BYTES

Maximum encoded checkpoint size accepted before JSON parsing/allocation.

MAX_CONTEXT_CHECKPOINT_FILES

Maximum file entries carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_FINDINGS

Maximum findings carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_ID_BYTES

Maximum byte length of an existing protocol identity admitted by a checkpoint.

MAX_CONTEXT_CHECKPOINT_LINEAGE_REFS

Maximum entries in any one checkpoint lineage reference list.

MAX_CONTEXT_CHECKPOINT_NEXT_STEPS

Maximum next steps carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_PACKAGE_PINS

Maximum package pins carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_POLICY_PINS

Maximum policy pins carried by one checkpoint.

MAX_CONTEXT_CHECKPOINT_REFERENCE_BYTES

Maximum byte length of a scheme-prefixed checkpoint reference.

MAX_CONTEXT_CHECKPOINT_SLUG_BYTES

Maximum byte length of a bounded checkpoint identity slug.

MAX_CONTEXT_CHECKPOINT_STEPS

Maximum step count a checkpoint may report as progress.

MAX_CONTEXT_CHECKPOINT_TEXT_BYTES

Maximum byte length of a bounded checkpoint free-text value.

Traits

ContextCheckpointMergePolicyV1

Seam for the downstream branch-merge slice.

ContextCheckpointMigrationV1

Seam for the downstream migration slice.

ContextCheckpointProjectionV1

Seam for the downstream projection slice.

ContextCheckpointSignerV1

Seam for the downstream signing and trust slice.