Skip to main content

Module blob_tree

Module blob_tree 

Source
Expand description

Tree manifests: {"schema":"khive-tree/v1","entries":[{path,ref,mode}]}.

A manifest is stored as one blob whose reference is the tree id. The serialization is canonical (entries sorted by path, compact JSON) so two runs that leave identical content produce identical tree references.

Structs§

PathCoverage
Exact-or-directory-prefix coverage, independent of manifest collision rules. Declarations are used as given; this does not validate or normalize them.
TreeEntry

Constants§

MAX_MANIFEST_BYTES
Largest manifest the shared load path will read back.
TREE_SCHEMA

Functions§

blob_store
entries_json
load
Load a manifest by reference. An unknown reference or a non-manifest object is an error naming the reference.
parse_entries
Validate wire entries in input order: paths, refs, modes, duplicates, and file/directory collisions. exec.tree_put uses this for candidate manifests.
store
Validate and store entries from any producer; returns a loadable tree ref.
store_from_value
Validate and store a manifest built from wire entries; returns the tree ref.
validate_relative_path
Validate a relative path: no empty components, no ./.., no leading /, no NUL, no backslash. Returns the normalized path.
verify_blobs
Every entry’s blob must exist before materialization starts.