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.mdonto 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 readsSPEC.mdas text –§Gpairs them, and now the code does too. - debt
- A RATCHET: measure, compare to a recorded floor, refuse the wrong way.
- fed
- Federation: the
§Ftable, 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
applyjust committed. - slice
- Distil a big document into the part a reader needs to ACT.
- spec
SPEC.mdstructure. Sole call site formicrolith(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-statein the git common dir (src/state:V4). - tokens
- Token counting. Sole call site for
itok(V72) – no other module in this crate may nameitok::, 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.