Module snapshot 

Operation-scoped Git snapshot identity and canonical object graph. Operation-scoped Git snapshot identity and canonical object-graph contracts.

Structs

GitSha1ObjectId

Exact lowercase 40-hex Git SHA-1 object identifier.

GitSnapshotImportInputs

Exact retained files and directories authorized for one snapshot object import.

GitSnapshotKeepaliveRef

Exact local keepalive ref for one snapshot operation.

GitSnapshotObjectGraphV1

Complete identity of the two blobs, three nested trees, and parentless commit.

GitSnapshotPrecomputeInputs

Retained exact staged payloads for zero-write Git object precomputation.

GitSnapshotSourceRef

Exact source custom ref for one snapshot operation.

GitSnapshotStageDirectory

Retained create-only directory for assembling one private operation stage.

GitSnapshotStageLocatorV1

Path-free durable authority for reopening one exact completed stage.

GitSnapshotStageV1

Compact create-only metadata that binds a private stage to its canonical graph.

Enums

GitSnapshotError

Stable, path-free snapshot contract failure.

GitSnapshotObjectKind

Exact Git object type accepted by snapshot hash/import callbacks.

Constants

GIT_SNAPSHOT_GRAPH_SCHEMA_VERSION

Schema version of the six-object Git graph identity.

GIT_SNAPSHOT_KEEPALIVE_REF_PREFIX

Private local namespace retaining snapshot objects across retry lineages.

GIT_SNAPSHOT_STAGE_ARCHIVE_FILE

Create-only staged archive filename.

GIT_SNAPSHOT_STAGE_DESCRIPTOR_FILE

Create-only staged descriptor filename.

GIT_SNAPSHOT_STAGE_DIRECTORY

Directory below the private Git isolation root containing operation stages.

GIT_SNAPSHOT_STAGE_LOCATOR_SCHEMA_VERSION

Schema version of the path-free durable stage locator.

GIT_SNAPSHOT_STAGE_METADATA_FILE

Create-only compact stage metadata filename.

GIT_SNAPSHOT_STAGE_SCHEMA_VERSION

Schema version of the compact private staging record.

MAX_GIT_SNAPSHOT_DISCOVERY_STAGES

Maximum complete operation stages inspected by one bounded recovery discovery.

MAX_GIT_SNAPSHOT_STAGE_BYTES

Maximum canonical compact stage metadata size.

Functions

canonical_goal3_tree_bytes

Construct the valid leaf-tree bytes containing the two fixed snapshot files.

canonical_parentless_snapshot_commit_bytes

Construct the exact parentless commit bytes for one snapshot graph.

canonical_root_tree_bytes

Construct the valid root tree containing only .rustferry.

canonical_rustferry_tree_bytes

Construct the valid .rustferry tree containing only goal3.

complete_git_snapshot_object_graph

Complete the exact six-object graph after the two potentially streamed blobs are hashed.

git_snapshot_stage_directory

Derive one operation’s strict stage directory below a private isolation root.

require_sha1_object_format

Require exact sha1 output from the private repository object-format probe.