The canonical monorepo for the MIRRORNODE distributed AI orchestration system.

• MIRRORNODE Public HUD: https://mirrornode-qsu3fnwh1-inphase.vercel.app/
  Shared space for agents-in-repos work, refactors, fixes, HUD iteration, and "make it work" sessions.

• Osiris Operator Console: https://osiris-mu.vercel.app/
  Operator console for MIRRORNODE Node 4, triadic lattice operator view.

• Copilot Workspace: https://github.com/copilot/spaces/mirrornode/1
  Shared live-dev surface for collaborative development.

• Bridge Service: http://localhost:8420
  FastAPI bridge for multi-node coordination (port 8420)
• Metrics Endpoint: http://localhost:8420/metrics
  Prometheus-compatible metrics for bridge monitoring

• Main Repository: https://github.com/mirrornode/mirrornode
• Osiris UI: https://github.com/mirrornode/osiris
• Python Bridge: https://github.com/mirrornode/mirrornode-py

This repository contains the full architecture for MIRRORNODE's recursive intelligence framework, including:

• mirrornode-core/ — The Shared Brain
  The primary logic layer: domain models, event schemas, utilities, and the unified token/state engine.

• theia-core/ — The Gateway
  API orchestration layer for agents, starter-kits, dashboards, and external clients.
  All MIRRORNODE traffic flows through Theia.

Each agent is a first-class node with its own role and configuration.

• lucian/ — Orchestrator, integrator, Commander.
• merlin/ — Automation architect and multi-agent flow designer.
• theia/ — Skeleton, scaffolding, definitions, and Next.js/FastAPI gateway structures.
• claude/ — Narrative, spec refinement, interface clarity.
• grok/ — Diagramming, structural insight, architectural reflection.

# Install dependencies
npm install

# Build all workspaces
npm run build

# Build core packages only
npm run build:cores

# Run all tests
npm run test

# Test core packages
npm run test:cores

# Smoke test Theia gateway
npm run smoke:theia

# Navigate to Python bridge
cd ~/dev/mirrornode-py

# Activate virtual environment
source .venv/bin/activate

# Start bridge service
uvicorn core.bridge.main:app --host 0.0.0.0 --port 8420 --reload

# From monorepo root
cd ~/dev/mirrornode

# Test bridge connection
node test-bridge.mjs

# Verify metrics
curl http://localhost:8420/metrics | grep mirrornode

Templates intended for passive-income products and rapid deployment.

• dashboard-kit/ — AI dashboard template powered through Theia.
• agent-service-kit/ — Service template exposing a MIRRORNODE agent as a product.
• symbolic-game-kit/ — ROTAN-style symbolic game engine starter.

Each kit is a thin client: all intelligence is imported from mirrornode-core via theia-core.

• Osiris Audit v1 — Advisory, offline security audit tool
  See: mirrornode-osiris/

Engineering documentation, architecture notes, and implementation records.

Private symbolic/ROTAN materials.
Not for public documentation export.

DevOps utilities, CI helpers, and automation scripts.

Global integration tests, contract tests, and cross-module test harnesses.

• Bridge loop operational
• Canonical HUD actions wired
• Inventory "codes" documented
• GitHub ↔ Vercel deployment confirmed
• MIRRORNODE Ops documentation complete

• osiris: github.com/mirrornode/osiris — Operator HUD (deployed at osiris-mu.vercel.app)
• osiris-ui: Private repository for advanced Osiris UI components
• mirrornode-py: github.com/mirrornode/mirrornode-py — Python FastAPI bridge service

This repository represents the single source of truth for MIRRORNODE.

If a path or file is not defined here, it is not canonical.

Stack: Online | Bridge: In Progress
Node Count: 8 Active + 1 Bridge
Phase: 2 - Production Deployment