Skip to main content

Crate sherd

Crate sherd 

Source
Expand description

sherd – two-axis federation of SPEC.md and source over a dir DAG.

Module layout is the federation: every dir here is a node with its own SPEC.md (§C: node = dir = Rust module). mod.rs composes, it does not implement (V51).

Modules§

adopt
Brownfield on-ramp: a foreign single-file SPEC.md onto a federation.
cli
Arg dispatch and exit codes. The binary is a shim over run (src/cli:V14).
code
Reading Rust source AS TEXT. The mirror of src/spec, which reads SPEC.md as text – §G pairs them, and now the code does too.
debt
A RATCHET: measure, compare to a recorded floor, refuse the wrong way.
fed
Federation: the §F table, the parent/child edges, the chain to a node.
git
One shape for every git invocation, so nine call sites cannot each be wrong in the same way (.:B25). One shape for every git invocation, aimed at one repository.
land
Landing generated work on main – when it has earned it.
lens
The lens pack: what one node costs to work at.
plan
plan – what to attempt next, and why it might not survive contact.
review
Mechanical pre-review of what apply just committed.
slice
Distil a big document into the part a reader needs to ACT.
spec
SPEC.md structure. Sole call site for microlith (V72).
split
split – propose a federation: which rows and modules would come off a node’s chain, and where an unmanaged row belongs.
state
One cached, idempotent state file for every command that needs to remember something: sherd-state in the git common dir (src/state:V4).
tokens
Token counting. Sole call site for itok (V72) – no other module in this crate may name itok::, and a planted violation must fail to compile.
wave
The SCHEDULE a parallel build follows: the code DAG, the ready set per round, and the two numbers that make the case – depth and width.