Purpose
MAGIC is the infrastructure service. Provider switching, governance validation, tier algebra. Every request validated. Every response governed.
MAGIC enforces 255-bit governance at runtime. It manages the LLM provider landscape (Anthropic, RunPod, Vast.ai, OpenAI), runs the BAKEOFF evaluation harness, and validates that every scope meets its tier contract. Providers are switchable — not hardcoded. Quality is measured — not assumed.
Tier Algebra
| Tier | Score | Artifacts |
|---|---|---|
| COMMUNITY | 051 | CANON.md + VOCAB.md + README.md |
| BUSINESS | 102 | + {SCOPE}.md |
| ENTERPRISE | 153 | + COVERAGE.md + ROADMAP.md |
| AGENT | 204 | + LEARNING.md |
| MAGIC | 255 | + INTEL.md |
255 is the composition: all artifacts present, INTEL bridge connected, full governance.
Provider Landscape
| Provider | Type | Status | Use Case |
|---|---|---|---|
| Anthropic (Claude) | API | ACTIVE | Primary LLM — TALK, AGENT, compilation |
| RunPod | Serverless | ACTIVE | Open-source model inference |
| Vast.ai | Persistent | ACTIVE | Long-running model instances |
| OpenAI | API | Monitoring | Benchmark comparison |
BAKEOFF Harness
The BAKEOFF evaluates providers across latency, throughput, cost/token, and quality. Decision criteria: cost-adjusted quality per governed task. Results drive provider switching — not opinion.
Structure
Root MAGIC domains:
RUNPOD/ (serverless Runpod.io LLM provider scope).
VASTAI/ (Vast.ai persistent-instance LLM provider scope).
BAKEOFF/ (governed provider evaluation harness).
Required closure artifacts per scope:
CANON.md, README.md, {SCOPE}.md, VOCAB.md, ROADMAP.md, COVERAGE.md, LEARNING.md.
Learning lane per governed scope:
LEARNING.md at the scope root is terminal and SHALL NOT nest further LEARNING/.
Routes
web_docs: https://hadleylab-canonic.github.io/
web_surface: https://hadleylab-canonic.github.io/SERVICES/MAGIC/
magic: magic://hadleylab-canonic.github.io/SERVICES/MAGIC/
Ecosystem Connectivity
- Upstream:
canonic-canonic/MAGICcanonical law — the source of tier algebra and MAGIC compliance. - Runtime:
~/.canonicdiscovery/generation/relink workflows — compile-canon-json validates all. - TALK plane: provider switching feeds
/chat— Anthropic primary, fallback chain governed. - LEDGER plane: tier validation results logged — fake 255 fails at the compiler.
- Frontend: Jekyll + remote_theme (canonic-canonic/DESIGN) — governed surface rendering.
Pages
| Page | Sections |
|---|---|
| Overview | Purpose, Structure |
| Ecosystem | Routes, Ecosystem Connectivity |
Default: Overview.
| *MAGIC | SPEC | SERVICES* |