docs: correct the Mesa / Directed Messaging migration commands

[sigilante]

Tenth PR from the audit against urbit/urbit@08026c84b2.

Companion PRs: #266, #267, #268, #269, #270, #271, #272, #273, #274.

A correction to the audit first. It reported that the docs contain "zero occurrences" of mesa. That is false — hood.md already documented four migration pokes. The real problem is narrower and worse: one of those pokes no longer exists, another's payload is wrong, and none of the generators that drive them are documented.

%helm-send-ahoy is gone

Not present anywhere in pkg/arvo. Removed by 3ff38fb0d2 (2026-03-26, "hood: remove |ahoy generator"). The poke dispatch now handles %ahoy-comb and %ahoy-prob (lib/hood/ahoy.hoon:173-174) alongside %helm-mass-mate, %helm-send-rege and %helm-mass-rege (lib/hood/helm.hoon:665-667).

Rewrote the section around %ahoy-prob [=ship force=?], added one for %ahoy-comb, and fixed the two cross-references that pointed at the dead mark.

%ahoy-comb is currently a no-op

+comb (lib/hood/ahoy.hoon:184-186) opens with:

?:  &  this  :: XX disabled

It returns immediately and the entire rest of the arm is unreachable. The poke succeeds and does nothing — exactly the sort of behaviour a reader would otherwise spend an afternoon diagnosing as their own mistake. Documented in both hood.md and the generator entry, pointing at |ahoy/prob instead.

%helm-mass-mate's payload was wrong

Documented as [ship=(unit ship) dry=?]. +poke-mass-mate (lib/hood/helm.hoon:196-198) binds dry in its subject with =| and takes only ship=(unit ship) as its sample — so the payload is the unit alone. The |mate generator agrees, sending helm-mass-mate/who.

I checked the neighbours rather than assuming the same bug: %helm-mass-rege [ship=(unit ship) dry=?] and %helm-send-rege [her=ship test=?] are both already correct, and are untouched.

Five undocumented generators

|ahoy/prob, |ahoy/comb, |mate, |rege, |ress — all added to dojo-tools.md. All five default to a dry run. |mate and |ress are marked testing-only per their own source comments, since they skip negotiation entirely and always run dry.

%ahoy name collision

examples/ahoy.md documents ~midden-fabler's third-party %ahoy desk, which since February 2026 collides by name with the kernel's %ahoy migration subsystem. A reader who types |ahoy after finishing that tutorial lands somewhere entirely unrelated. Added a disambiguation note linking to the real generators.

Incidental

Added anchors to five hood.md headings that were already the target of same-file links (#migrate-to-directed-messaging, #set-ames-verbosity, #automatic-memory-reports, #cancel-automatic-memory-reports, #send-a-hi).

The remaining broken #vat and #claycancelautocommit links in dojo-tools.md are deliberately untouched — owned by #266 and #273. Verified in a combined test-merge of all ten branches that the merged dojo-tools.md has zero broken anchors.

🤖 Generated with Claude Code