docs: complete Clay's task coverage and add a Gifts section - #277
Open
sigilante wants to merge 1 commit into
Open
docs: complete Clay's task coverage and add a Gifts section#277sigilante wants to merge 1 commit into
sigilante wants to merge 1 commit into
Conversation
Against urbit/docs.urbit.org@08026c84b2. `+$ task:clay` (lull.hoon:2442-2481) has 30 cards; clay/tasks.md documented 16. Coverage is now 30/30, verified by script. Ten tasks added, placed in the existing topic sections: Write and Modify %into [%into des=desk all=? fis=mode] external edit, for Unix sync %park [%park des=desk yok=yoki ran=rang] synchronous commit %pork [%pork ~] resume interrupted commit %prep [%prep lat=(map lobe page)] prime the object store Apps and updates %esse [%esse des=desk ese=?] mark desk essential %zeal [%zeal lit=(list [=desk =zest])] batch form of %zest %stir [%stir arg=*] debug; not stable interface Merge Desks %fuse [%fuse des=desk bas=beak con=...] merge many sources %drop [%drop des=desk] cancel pending merge Foreign Ships %werp [%werp who=ship wer=ship rif=...] inbound remote request %fuse is the one most likely to be reached from userspace -- it backs the |fuse generator -- so its entry carries the real usage examples and the %track semantics from the generator's own help text (gen/hood/clay/fuse/help.txt), rather than a reconstruction. Called out the %warp / %werp distinction explicitly in the Foreign Ships intro: %warp is how we request a file from a named ship; %werp is the inbound form carrying the requesting ship, passed to Clay by Ames. The two differ by one letter and it would be easy to reach for the wrong one. Added a "Vane lifecycle tasks" section for the four $vane-task cards (%init, %trim, %vega, %plea). These are shared boilerplate rather than Clay-specific, but they ARE part of Clay's union, and leaving them out is why the file previously looked complete while missing a third of its cards. There is no shared vane-task page in the docs to link to instead; Gall's API page documents its own inline, and this follows that precedent. Added a Gifts section covering all 13 cards of `$gift:clay`. Previously the gifts appeared only incidentally under whichever task produced them, and %croz, %cruz and %wris were never named at all. The quoted union was checked line-by-line against lull.hoon:2427-2441 by script. All anchors 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.
Twelfth PR from the audit against
urbit/urbit@08026c84b2.+$ task:clay(lull.hoon:2442-2481) has 30 cards;clay/tasks.mddocumented 16. Coverage is now 30/30, verified by script.Companion PRs: #266, #267, #269, #270, #271, #272, #273, #274, #275, #276.
Ten tasks added, in the existing topic sections
%into[%into des=desk all=? fis=mode]— external edit, for Unix sync%park[%park des=desk yok=yoki ran=rang]— synchronous commit%pork[%pork ~]— resume interrupted commit%prep[%prep lat=(map lobe page)]— prime the object store%esse[%esse des=desk ese=?]— mark desk essential%zeal[%zeal lit=(list [=desk =zest])]— batch form of%zest%stir[%stir arg=*]— debug; not stable interface%fuse[%fuse des=desk bas=beak con=(list [beak germ])]%drop[%drop des=desk]— cancel pending merge%werp[%werp who=ship wer=ship rif=riff-any]%fuseis the one most likely to be reached from userspace — it backs the|fusegenerator — so its entry carries the real usage examples and the%tracksemantics from the generator's own help text (gen/hood/clay/fuse/help.txt) rather than a reconstruction.I also called out the
%warp/%werpdistinction explicitly in the Foreign Ships intro. They differ by one letter:%warpis how we request a file from a named ship;%werpis the inbound form carrying the requesting ship, passed to Clay by Ames. Easy to reach for the wrong one.Vane lifecycle tasks
Added a short section for the four
$vane-taskcards (%init,%trim,%vega,%plea). These are shared boilerplate rather than Clay-specific — but they are part of Clay's union, and omitting them is why the file previously looked complete while missing a third of its cards.There's no shared vane-task page to link to instead; Gall's API page documents its own inline, so this follows that precedent.
Gifts section
All 13 cards of
$gift:clay. Previously the gifts appeared only incidentally under whichever task produced them, and%croz,%cruzand%wriswere never named at all. The quoted union was checked line-by-line againstlull.hoon:2427-2441by script.Verification
lull.hoon— exact match.clay/data-types.md: the merged tree has zerofad=flowand three%fusereferences.🤖 Generated with Claude Code