The API Connection

§1 · Why This Document Exists

CircularOS now has 4,305+ routes, 400+ master documents, 29+ named agents, dozens of trackers, sentinels, copilots, watchers, witnesses, dashboards, ledgers, vaults, and "temperature" pages. Operator instruction (May 2026): "Make the document show every last one in the system even if I don't consider it as an AI · I might think it's a page · I need it involved · might have to rename it one day. Diagrams same as the ones I'm sending you, just make the colour different."

This document is not a technical spec. It is a map — a terrain — for navigating the system. It uses the same three-level structure as the brief (Underbelly → Mycelium → Trees) but a distinct palette per the diagram colour policy: teal underbelly · coral mycelium · sunset trees (replacing the brief's purple/green/gold).

§2 · The Three Levels

The brief specifies dark-grey/purple → green/blue → gold/bright. This document deliberately uses teal → coral → sunset to satisfy the diagram colour policy in replit.md (no two diagrams in a batch share a palette).

§3 · The Temperature Pages · The Inputs the AI Reads From

Operator language: "it always runs off one of the ones or a few of them so it knows the temperature." These are the always-on read-surfaces every agent in the underbelly samples to know how hot the system is right now.

§4 · The Five Critical Paths

1. Path A · Public User → Carrot Supplier: / → form → Carrot Form Watcher → carrot@MPT email → 18 checkpoints → dPRN minted → 7% Covenant → 40 meals → £200 same-day → Deed issued.
2. Path B · Job → Operator: /gallery → claim → Job agent → /dashboard → operator does job → Verification → Payment → Notification.
3. Path C · Verification → Truth Ledger → dPRN: material at Unit 18 → 18 checkpoints → SHA-256 → Truth Ledger → dPRN minted → Covenant 7% → meals + 40 → Deed → £200 paid.
4. Path D · H.BLUE → Entity #35 → Wakey: H.BLUE pattern → webhook → /the-eye → Red Team escalation (if needed) → Wakey composes → 07:30 briefing → operator reviews.
5. Path E · Sovereign Action → op_ledger → Live Trackers: sovereign action → NOT EXISTS dedup insert → op_ledger row sealed → Velocity Tracker auto-mirrors → Mycelium Tracker absorbs → H.BLUE pattern feed updates → SIS picks it up.

Each path uses a distinct palette in the rendered map per the diagram colour policy.

§5 · The Sovereign Inventories · Every Last One

Per operator: "every last one in the system even if I don't consider it as a AI." Three living inventories cover the whole surface area:

• MD-461 · Complete AI Inventory at /ai-inventory — the named-agents register · Build #79.
• MD-472 · Agent Roster (chronological · rated) at /agent-roster — Build #96.
• /sitemap — every public route in the entire app (4,305+ routes).
• The Mirror at /last-250 — page-health verification + last-250 directory.

A page that is not in MD-461 today but reads from a temperature page or fires a webhook should be added to MD-461 and MD-472 the day it gets reclassified. See §6.

§6 · The Rename Doctrine

Operator: "might have to rename it one day." A page can be reclassified from "tracker / dashboard" to "agent" without code change — the route stays, the name changes in the inventories.

Renamable candidates (already shortlisted)

• /velocity-tracker → Velocity Sentinel
• /mycelium-tracker → Mycelium Sensor Agent
• /sovereign-progress-tracker → Progress Co-pilot
• /carrot-tracker → Carrot Form Watcher Agent
• /qr-tracker → QR Provenance Agent
• /grants-tracker → Grant Sentinel
• /acquisitions-tracker → Acquisitions Concierge Agent
• /admin/score-tracker → Score Co-pilot
• /admin/red-team/asset-tracker → Asset Sentinel
• /job-tracker/<id> → Job Concierge Agent
• /build-tracker → Build Heartbeat Agent
• /admin/sentinels-network → formalise as the Agent Council

Procedure

1. Operator decides reclassification.
2. Update entry in MD-461 (Complete AI Inventory).
3. Update entry in MD-472 (Agent Roster).
4. Move pill into the underbelly section of MD-479 hub.
5. Seal the rename to op_ledger as `agent.rename.<old>.to.<new>`.

§7 · The Six Axioms

1. Three layers · one system. Trees · Mycelium · Underbelly. Indivisible.
2. Every page is involved. Even ones not currently considered AI. None are excluded from the map.
3. Every agent reads a temperature page. No agent runs blind.
4. Diagrams diversify. Same structure as the brief, distinct palette per the colour policy.
5. Renames are doctrine, not refactors. A page becomes an agent the day the inventory says so.
6. Every connection is traceable through op_ledger. Trees rendered, mycelium fired, underbelly recorded.

§8 · How to Navigate When Lost