graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs
Kernels
A kernel graduates when (1) Lean builds, (2) the reference model exhausts the reachable cells, (3) the Zig implementation matches the export.
Process vs cube
A kernel is a cube (flag or table product; native_decide over the cells)
or a process (a finite Event / step state diagram). Process kernels
are not Turing machines: no tape, no halt state, no computability encoding.
The diagram is the transition function. The cube, if the kernel has one, is
the snapshot of that function.
Process kernels: GoalLoop (standing has no retire edge; harness-done
needs a done write), PromptCache (sub never spawns; join restores the
root partition), PromptPrefix (names + triggers, pinned once; skill
load/list/rescan do not rewrite the prefix), PromptStable (OpenGauss
must-nots: skills/schemas in history, no clock/toolset-rewrite/memory
reload in the prefix; compact re-pins — showcase with
python3 spec/conformance.py --showcase), PathConfine (component walk: Escaped and
Absolute absorb), Transport (a sub never takes WS; only one live root
Responses cell does), and Score (attempt never files; capture
after the join files one stage row). They are not Turing machines: no
tape, no halt state.
The shape of a subagent fleet is not a cube. Shape is the observation
ladder of one turn and stays a cube. How many children spawn, which
isolation they take, which paths they walk, and whether they get a
WebSocket are events — PromptCache, PathConfine, and Transport force
every child through a machine. Score is how that unbounded fleet is
filed: N items fold into one stage row; a 0 does not poison the cell.
Shape, Provider, and ToolCatalog stay cubes. Leftover this turn:
BashPolicy (command cube: isSimple / escapesCwd / readOnlyAllowed).
TUI layout/glyphs, prompts, and SSE stay never.
Every harness part
Every part is live, new, or never. Never is a classification, not a skip: TUI, prompts, and SSE bytes stay out of Lean on purpose.
Live (already a complete triangle)
| Kernel | Cells | What it is not |
|---|---|---|
ToolCatalog |
64 flag cubes | MCP names, descriptions, JSON wrappers |
Transport |
96 turns + Event/step; 1 WS cell |
frames, TLS, idle-kill timing of the server |
Provider |
25 baked rows | live /models overlay, Kimi protocol flip |
GoalLoop |
360 gate cells + Event/step |
model wording, whether the work is correct |
PromptCache |
48 cells + Event/step |
provider cache HIT, uuid5 cwd bytes, vision pin |
PromptPrefix |
6 cells + Event/step |
catalog wording, provider HIT, compaction |
PromptStable |
20 cells + Event/step |
Anthropic cache_control bytes, compact summary wording |
PathConfine |
16 lexical paths + 80 lease cells + Event/step |
OS errno, Windows drives, live symlink walk |
Shape |
1728 ladder cells | admit, learned override, ε-explore, observe |
Score |
1210 filing cells (240 filed) + Event/step; 11 titles; 16 class samples |
HMAC, providerClass price fallback |
New (this loop)
| Kernel | Cells | What it is not |
|---|---|---|
BashPolicy |
finite command cube: isSimple, escapesCwd, readOnlyAllowed, readOnlyExternal |
live argv quoting, Windows cmd.exe |
Never (accounted for; eval / tier 2)
| Part | Why never |
|---|---|
| TUI (layout, colors, glyphs, hover) | the emulator owns the font and the cell grid |
| Prompts / system text | wording is not a discrete decision (prefix kind is PromptPrefix) |
| SSE / stream bytes | wire framing, not a predicate |
| MCP protocol / tool descriptions | names and schemas, not a flag cube |
| HMAC score signing | crypto, not a discrete gate |
| Learned override / ε-explore | archive-backed, not the compiled prior |
observe file tokenizer / session decline counts |
encoder in front of the ladder |
Live /models overlay |
network, not the baked table |
noSymlinkEscape on a real FS |
OS; modelled lexically in PathConfine |
| Approvals session state (allow-list, yolo persistence) | mutable human session, not a pure function |
| Compaction / HTTP / process runner | I/O and timing |
| "eval GREEN before completion" | no such discrete Zig predicate exists |
The leftover discrete bash/policy family (isSimple / escapesCwd /
readOnlyAllowed, plus the #64 twin readOnlyExternal) is the new
triangle. isInterpreter, isDestructiveGit, and planReadMatch live
in the same module and are covered as tables/cases on that triangle, not
as a ninth kernel.
How a kernel evolves
- Write the axes and the illegal-cell predicates in Lean first.
- Prove the cheap general facts.
- Port the same functions to
spec/ref/<kernel>.py. - Export
spec/kernels/<kernel>.json. - Diff the live Zig function against the export.
- Stop. Do not add a vendor-specific theorem.