Skip to main content

Module lockfile

Module lockfile 

Source
Expand description

soothfast.lock: committed fingerprints for every bound item. A bind is stale when the item’s current fingerprint differs from the locked one; docs accept re-locks after the prose has been re-verified by a human.

Structs§

Lock
Accepted binds, and the format version they were written under.

Constants§

LOCKFILE
Lockfile name, resolved relative to the workspace root.
VERSION
Current lockfile format. Bumped whenever the fingerprint input changes, so a lock written by an older release reports as needing one re-accept rather than as prose that drifted.

Functions§

comparable
The entries of lock a fresh accept may merge over.
merge
Merge freshly accepted binds over existing. A full-scope accept replaces the map outright, dropping binds that no longer exist anywhere; a partial (explicit-paths) accept must preserve out-of-scope entries.
read
Read root’s lockfile. A missing file is an empty map at the current version, not an error (a fresh repo has accepted nothing yet). A file without a version key predates the field and reads as v1.
write
Persist binds to root’s lockfile as stable, pretty-printed JSON.

Type Aliases§

Binds
item path → fingerprint (hex).