Skip to content

docs: rig reconciliation — canonical apex is g.proxy; de-stale rig-guide; anchor swarm-market to the Rig - #108

Merged
ALLiDoizCode merged 1 commit into
mainfrom
docs/rig-reconciliation
Jul 1, 2026
Merged

ALLiDoizCode merged 1 commit into
mainfrom
docs/rig-reconciliation

Conversation

@ALLiDoizCode

Copy link
Copy Markdown
Contributor

Reconciles the "Rig = decentralized control plane for agent orchestration" concept after a pollution audit across toon-meta, toon, toon-client, and connector.

Canonical apex naming → g.proxy

The context docs had drifted to claiming g.connector was the canonical apex wire nodeId. The live devnet, docs/epic-44-payment-proxy.md, and the deploy handoffs all use g.proxy — confirmed as the canonical term. Flipped in context/{glossary,decisions,architecture,context,repos}.md and docs/architecture.md:

  • apex nodeId g.proxy, children g.proxy.<type>, env prefix PROXY_*
  • "connector" remains the repo / payment-engine product name — only the on-wire nodeId + env prefix are the g.proxy axis
  • vhost claims replaced with the actually-live ILP edges (connector.pay.toonprotocol.dev/ilp, proxy.store.devnet.toonprotocol.dev/ilp) — no invented canonical vhost scheme
  • the "pending cleanup" statements now point the right way (purge legacy g.connector refs)

rig-guide.md de-staled (verified against toon-client)

  • write path: TOON client paying the connector payment proxy — NIP-34 events to the relay, git objects via paid POST /store to the payment-oblivious store (no more "blob storage DVM")
  • stack section reflects reality: React 19 + shadcn browser-only SPA (the "no React / two dependencies" claims predated the rewrite); the true invariant — static build, no backend, no server — is kept front and center
  • Arweave gateways: shared @toon-protocol/arweave package + TOON_CLIENT_ARWEAVE_GATEWAYS override (the hardcoded triple was stale)
  • removed the dead scripts/deploy-forge-ui.mjs reference; deploy section generalized
  • new "Agent Orchestration — the Next Vocabulary" section anchoring the verifiable swarm-market epic ([tracking] Capability market — attested hermetic predicates as tradable propositions #84) as the incentive layer of this control plane: the resolver DVMs evaluate the same signed NIP-34 event log the Rig renders

Glossary disambiguation

"Control plane" canonically refers to the Rig's event-space; the toon-clientd loopback surface is the control API, not a control plane.

New docs (previously untracked)

  • docs/dx-findings.md — Path A DX friction log
  • docs/handoff-arweave-dvm-deploy.md — store-box deploy handoff (public addresses only)

Companion PR

toon-protocol/toon-client#220 purges the code-side pollution: the pre-reframe rig-as-server architecture (−7,621 LOC of stubs and red ATDD tests), pet-game leftovers, "TOON Forge" branding, and the daemon "control plane"→"control API" wording.

🤖 Generated with Claude Code

…ide; anchor swarm-market to the Rig

Reconciles the Rig (decentralized control plane) vocabulary and naming pollution:

- Flip every claim of g.connector-as-canonical to g.proxy (apex nodeId
  g.proxy, children g.proxy.<type>, env PROXY_*), matching the live devnet
  and epic-44. "connector" stays the repo/product name; remaining
  g.connector mentions are only the pending-cleanup statements, now
  pointing the right way.
- rig-guide.md: write path is a TOON client paying the connector proxy
  (NIP-34 events to the relay, git objects via paid POST /store) — no more
  "blob storage DVM"; stack section reflects the React 19 + shadcn
  browser-only SPA; gateways come from @toon-protocol/arweave with
  TOON_CLIENT_ARWEAVE_GATEWAYS override; dead deploy-forge-ui.mjs
  reference generalized; new "Agent Orchestration — the Next Vocabulary"
  section anchors the swarm-market epic (#84) as the incentive layer over
  the same NIP-34 event log the Rig renders.
- glossary: "control plane" canonically = the Rig's event-space; the
  toon-clientd loopback surface is the "control API".
- Add docs/dx-findings.md (Path A DX friction log) and
  docs/handoff-arweave-dvm-deploy.md (store-box deploy handoff), previously
  untracked.

Companion code cleanup: toon-client#220 (purges the pre-reframe rig server
architecture, pet-game leftovers, and "TOON Forge" branding).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant