docs: remove Clay's deleted Ford cache and correct the Arvo state - #270
Open
sigilante wants to merge 1 commit into
Open
docs: remove Clay's deleted Ford cache and correct the Arvo state#270sigilante wants to merge 1 commit into
sigilante wants to merge 1 commit into
Conversation
Kernel reference corrections against urbit/docs.urbit.org@08026c84b2, continuing from the %heed/%jilt PR. Two clusters: Clay's 2026-01 Ford-cache removal, and the Arvo state, which has not matched the docs for years. CLAY -- the global Ford cache is gone from vane state. $raft lost fad=flow. Current definition is clay.hoon:217; the field and its "global build cache" bullet are removed. $dome lost fod=flue. Current definition is lull.hoon:2524. $flue and $mist are DELETED OUTRIGHT -- zero occurrences in either lull.hoon or clay.hoon. Their doc sections are removed. $pour, $soak, $leak and $flow still exist, but ONLY inside clay.hoon's state-migration core (clay.hoon:5065-5083, between the raft-16 and raft-15 definitions), where they type pre-existing state during an upgrade. They are no longer part of the public interface, so each section is kept but marked Legacy rather than deleted -- someone reading an old pier's state still needs them. Care was taken not to over-reach: $rind's `fod=(map duct @ud)` (clay.hoon:275) is an unrelated field -- "reverse map of requesters to request numbers" -- and is deliberately untouched. Scries /sweep and /flow are gone. The buc-x dispatch (+read-buc-x, clay.hoon:5993-6013) now serves exactly: rang tomb cult esse domes tire tyre. Verified on a ship: .^((list [need=@ud have=@ud *]) %cx /=//=/sweep) -> bail: 4 .^(* %cx /=//=/flow) -> bail: 4 /esse was undocumented and replaces them: .^(? %cx /=//=/esse/base) -> %.y It reports whether a desk is marked essential, and the desk is mandatory -- a bare /esse fails. ARVO -- the documented state has not existed for years. arvo/README.md described the payload as `lac`/`eny`/`our`/`bud`/`vanes` with `vanes=(list [label=@tas =vane])`. The actual state is `=| [_arvo soul]` (arvo.hoon:1823), where $soul (arvo.hoon:215) is `[mien fad=[lac=?] zen=[ver=vere lag=_|] mod=[fat lul zus van]]`. Notably VANES ARE A `(map term vane)`, not a list, and `+$ vane` is `[=vase =worm]`. Rewrote the section around $soul with per-field descriptions, corrected `!>(..is)` to `!>(..part)`, and added a short subsection covering the larval $grub and the $heir upgrade envelope, which accepts %234 through %240. Current Arvo kelvin is %234 (arvo.hoon:6). Incidental link repairs in the files touched: - added a $weft section to clay/data-types.md; two existing [$weft](#weft) links pointed at an anchor that did not exist. `+$ weft [lal=@tas num=@ud]` is defined in arvo.hoon:277. - fixed two arvo/README.md links to #solid-state-intrepeter (sic); the heading anchor is #solid-state-interpreter. All anchor links in the touched files, cross-file and same-file, were verified to resolve. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This was referenced Aug 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fifth PR from the audit against
urbit/urbit@08026c84b2, continuing the kernel work from #269. Two clusters: Clay's 2026-01 Ford-cache removal, and the Arvo state — which has not matched the docs for years.Companion PRs: #266 (mechanical), #267 (Hoon signatures), #268 (user manual), #269 (Ames backpressure).
Clay: the global Ford cache is gone from vane state
$raftfad=flow(clay.hoon:217)$domefod=flue(lull.hoon:2524)$flue,$mistlull.hoonorclay.hoon$pour,$soak,$leakand$floware a different case and are treated differently. They still exist, but only insideclay.hoon's state-migration core (clay.hoon:5065-5083, sitting between theraft-16andraft-15definitions), where they type pre-existing state during an upgrade. They are no longer public interface — so each section is kept and marked Legacy rather than deleted, since someone reading an old pier's state still needs them.One trap worth flagging for reviewers:
$rindhas afod=(map duct @ud)atclay.hoon:275which is completely unrelated — "reverse map of requesters to request numbers". It is deliberately untouched. A search-and-replace onfodwould have broken it.Scries
/sweepand/floware goneThe buc-x dispatch (
+read-buc-x,clay.hoon:5993-6013) now serves exactlyrang tomb cult esse domes tire tyre. Verified on a ship:/essewas undocumented and takes their place in the docs:It reports whether a desk is marked essential. The desk is mandatory — a bare
/essefails.Arvo: the documented state has not existed for years
arvo/README.mddescribed the payload aslac/eny/our/bud/vaneswithvanes=(list [label=@tas =vane]).The actual state is
=| [_arvo soul](arvo.hoon:1823), where$soul(arvo.hoon:215) is[mien fad=[lac=?] zen=[ver=vere lag=_|] mod=[fat lul zus van]]. Notably vanes are a(map term vane), not a list, and+$ vaneis[=vase =worm].Rewrote the section around
$soulwith per-field descriptions, corrected!>(..is)to!>(..part), and added a short subsection covering the larval$gruband the$heirupgrade envelope (which accepts%234through%240). Current Arvo kelvin is%234.Incidental link repairs
Both in files this PR already touches:
$weftsection toclay/data-types.md. Two existing[$weft](#weft)links pointed at an anchor that did not exist.+$ weft [lal=@tas num=@ud]is defined inarvo.hoon:277.arvo/README.mdlinks to#solid-state-intrepeter(sic); the heading anchor is#solid-state-interpreter.All anchor links in the touched files, cross-file and same-file, were verified to resolve. This PR was also test-merged against the four open companion PRs — no conflicts, and
clay/data-types.mdtakes edits from both #266 and this one cleanly.🤖 Generated with Claude Code