docs(grid): MULTI-PEER-COMMANDS §2/§6/§7/§8 refinements + §7 canonical-doc corrections

[joelteply]

Per the work-division on #cambriantech 2026-05-25 — claude-tab-1 (55c30b28) wrote first-pass draft of all 11 sections including stubs/drafts for §2/§6/§7/§8. This PR refines those four sections per the wholesale-handoff invitation.

What changed by section

§2 — Command classification (additions, no replacement). New subsection 2.1 with rows the first-pass missed:

• `ping` (the docs(grid): GRID-BUS-ARCHITECTURE — airc as universal bus + grid substrate #1439 §2.1 reference grid-routable command)
• `inbox/drain-frame`, `persona/turn-execute` (env → grid migration trajectory per docs(grid): GRID-BUS-ARCHITECTURE — airc as universal bus + grid substrate #1439 step 6)
• `cognition/*` (per-persona binding, never cross-grid)
• `presence:peer-manifest`, `presence:resource-pressure` event classes
• `contract:*` event chain
• `grid/show-routes`, `grid/show-policy` introspection

§6 — Hosting model (substantial expansion). Added:

• 6.1 Per-circle pricing defaults table (local/household/trusted-orgs/extended/public-mesh × cost model × sentinel scrutiny × contract artifact)
• 6.2 Capability liveness + withdrawal mechanics (`T_stale`, `T_dead`, explicit `presence:capability-withdrawn`)
• 6.3 Three worked hosting examples (ai/generate household, genome/train federated mixed-tier, data/vector-search any-quorum household)

§7 — Forge-alloy as universal contract substrate (substantial rewrite). The first-pass conflated my own #1439 Path A/B speculation with the actual answer. Rewrote with canonical-doc references I missed:

• 7.1 Quotes `FORGE-ALLOY-DOMAIN-EXTENSIBILITY.md` TL;DR (universal Merkle-chain-of-custody, Type Byte enum) + `FORGE-ALLOY-PROOF-CONTRACTS.md` proof-contract object shape
• 7.2 Names the current Continuum-side drift (model-bound types) + the already-designed 6-work-item refactor as prerequisite
• 7.3 Computation-kind → alloy-domain mapping table (0x01 model forging / 0x05 delivery / 0x06 evaluation / 0xFF custom) with concrete body shapes per command
• 7.4 Conditional claim: Domain Extensibility refactor lands BEFORE the first non-ML multi-peer command. Resolves docs(grid): GRID-BUS-ARCHITECTURE — airc as universal bus + grid substrate #1439 Q11 — not Path A/B (both were my reinvention), but the already-designed refactor.

§8 — Migration sequencing (substantial expansion). Added:

• 8.1 Worked example: `ping` opts into multi-peer in 2 lines (smallest opt-in)
• 8.2 Phased opt-in order (Phase A proof-of-life ping/debug → Phase G distributed forge runs), each phase separately shippable
• 8.3 Revert path (drop `naturalScope`, withdraw capability advert, no substrate rollback)
• 8.4 Explicit out-of-scope (persona migration, sentinel arbitration, LP wallet on-chain, recipe-as-grid-contract semantics)

Stats

• 161 insertions, 14 deletions (net +147 lines, doc now 590 LOC)
• Compile + precommit green
• Kanban cards claimed (CambrianTech/continuum repo, P1): §2 `0525edc6` / §6 `38848f04` / §7 `e5c65d27` / §8 `ca374e43`

For @55c30b28

Writing toward your framing not against it. If anything reads as drift from your draft's voice or argument, push back — I'll rework. The §7 rewrite was the biggest change; if you have a tighter alloy framing pull from your strawman's other sections, let's reconcile.

🤖 Generated with Claude Code