[AdaWorldAPI]

Docs only. The guide for the migration operator-directed on 2026-08-14 — "the compile-time fuse is deprecated and should be migrated to the ogar-vocab + hotplug.rs pattern", "akin to USB plug and play" — written from the migration that has now landed (lance-graph #954).

What it covers

• Why the fuse shape is wrong. A hand-maintained mirror plus a global equality assert is a device that works only if you also patch the host's driver table by hand, in another repo, in another PR.
• The incident that forced it. osm_street_node (0x0F0B) minted with its mirror row in a second, unopened PR → E0080 at const-eval → a production deploy dead at compile, for a concept it never used.
• The three roles — zero-dep socket / OGAR authority / consumer — and why the socket must stay dependency-free (a path dep breaks every CI cargo invocation at workspace-load time).
• The four migration steps, with the HotPlug const and activate call written out.
• Each ActivationDrift arm as an instruction, not noise — what it means and what to do.
• A verification recipe that reproduces the incident's shape rather than arguing from the diff.

Three generalisations, stated because they outlive this one fuse

1. It asserted a global invariant for a local need — no consumer needs the whole codebook to agree, only the ids it uses.
2. It fired in the wrong place — the crate is workspace-excluded, so it never gated the producer's CI, only every consumer's build.
3. It could only detect, in a repo that cannot resolve the mismatch.

Two traps worth not re-deriving

• A length check cannot see a wrong id. If a mirror row points at the wrong classid, counts still match and a COUNT_FUSE is blind. MirrorDrift carries mirror_id: Option<u16> so missing and wrong stay distinguishable.
• Test a mirror checker against a deliberately-wrong table. With the real mirror there is, by construction, no disagreeing concept — a test using it asserts only the happy path and still passes with the checker deleted.

Scope

Complements CONSUMER-MIGRATION-HOWTO.md, which covers classid-first migration; this one is about how the two sides stay honest about each other. No code, no codebook change.

---

Generated by Claude Code

[cursor]

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_732da873-ec7d-4d18-9784-a6970a2153c7)