Skip to content

INDEX.md

Latest commit

 

History

History
275 lines (211 loc) · 8.14 KB

INDEX.md

File metadata and controls

275 lines (211 loc) · 8.14 KB

BlackRoad Index

The map of everything. Browse the universe from here.

Quick Nav

Jump To Description
🌉 Bridge Files Core coordination files
🏢 Organizations All 15 org blueprints
🔧 Prototypes Working code
📊 Metrics Real-time KPIs

Bridge Files

The core of The Bridge - start here.

File Purpose Quick Look
.STATUS Real-time beacon cat .STATUS
MEMORY.md Cece's persistent brain Context survives disconnects
SIGNALS.md Morse code protocol ✔️ ❌ 📡 🎯
STREAMS.md Data flow patterns Upstream/Instream/Downstream
REPO_MAP.md Ecosystem overview All orgs, all nodes
BLACKROAD_ARCHITECTURE.md The vision Why we exist
TODO.md Task board What needs doing

Organizations

All 15 orgs, fully blueprinted. Click to explore.

Tier 1: Core Infrastructure

Org Code Blueprint Description
BlackRoad-OS OS 📁 Browse The Bridge, operator, mesh
BlackRoad-AI AI 📁 Browse Intelligence routing
BlackRoad-Cloud CLD 📁 Browse Edge compute, Cloudflare

Tier 2: Support Systems

Org Code Blueprint Description
BlackRoad-Hardware HW 📁 Browse Pi cluster, IoT, Hailo
BlackRoad-Security SEC 📁 Browse Auth, secrets, audit
BlackRoad-Labs LAB 📁 Browse Experiments, R&D

Tier 3: Business Layer

Org Code Blueprint Description
BlackRoad-Foundation FND 📁 Browse Salesforce, CRM, billing
BlackRoad-Ventures VEN 📁 Browse Marketplace, commerce
Blackbox-Enterprises BBX 📁 Browse Enterprise solutions

Tier 4: Content & Creative

Org Code Blueprint Description
BlackRoad-Media MED 📁 Browse Blog, docs, brand
BlackRoad-Studio STU 📁 Browse Design system, UI
BlackRoad-Interactive INT 📁 Browse Metaverse, 3D, games

Tier 5: Community & Storage

Org Code Blueprint Description
BlackRoad-Education EDU 📁 Browse Learning, tutorials
BlackRoad-Gov GOV 📁 Browse Governance, voting
BlackRoad-Archive ARC 📁 Browse Storage, backups

Org Deep Links

Quick access to specific files in each org:

BlackRoad-OS (The Bridge)

  • README - Mission & architecture
  • REPOS - 7 repos: operator, mesh, control-plane...
  • SIGNALS - OS as signal hub

BlackRoad-AI

  • README - "Route to intelligence, don't build it"
  • REPOS - router, prompts, agents, hailo
  • SIGNALS - AI routing signals

BlackRoad-Cloud

  • README - Edge compute architecture
  • REPOS - workers, functions, tunnels
  • SIGNALS - Deployment signals

BlackRoad-Hardware

  • README - Pi cluster + IoT
  • REPOS - nodes, hailo, esp32, lora
  • SIGNALS - Node health signals

BlackRoad-Foundation

BlackRoad-Interactive

Prototypes

Working code living in The Bridge.

Prototype Purpose Try It
🧠 Operator Routes requests to right org python -m operator.cli "query"
📊 Metrics Real-time KPI dashboard python -m metrics.dashboard

Operator Quick Start

cd prototypes/operator
python -m operator.cli "What is the weather?"
# → BlackRoad-AI (95%)

python -m operator.cli --interactive
# Live routing mode

Metrics Quick Start

cd prototypes/metrics
python -m metrics.dashboard --watch
# Live KPI dashboard

Live Metrics

Current state of The Bridge:

Run: python -m metrics.dashboard --compact

🟢 Files:71 Lines:9,903 Commits:11 Orgs:15/15 Health:5/5
Metric Value
Total Files 71
Total Lines ~10,000
Orgs Blueprinted 15/15 ✔️
Repos Defined 86
Prototypes 2

Directory Structure

BlackRoad-OS/.github/
│
├── 📄 Core Files
│   ├── .STATUS              ← Real-time beacon
│   ├── INDEX.md             ← YOU ARE HERE
│   ├── MEMORY.md            ← Persistent context
│   ├── SIGNALS.md           ← Signal protocol
│   ├── STREAMS.md           ← Data flows
│   ├── REPO_MAP.md          ← Ecosystem map
│   └── BLACKROAD_ARCHITECTURE.md
│
├── 🏢 orgs/                  ← All 15 org blueprints
│   ├── BlackRoad-OS/
│   ├── BlackRoad-AI/
│   ├── BlackRoad-Cloud/
│   ├── BlackRoad-Hardware/
│   ├── BlackRoad-Labs/
│   ├── BlackRoad-Security/
│   ├── BlackRoad-Foundation/
│   ├── BlackRoad-Media/
│   ├── BlackRoad-Interactive/
│   ├── BlackRoad-Education/
│   ├── BlackRoad-Gov/
│   ├── BlackRoad-Archive/
│   ├── BlackRoad-Studio/
│   ├── BlackRoad-Ventures/
│   └── Blackbox-Enterprises/
│
├── 🔧 prototypes/            ← Working code
│   ├── operator/            ← The routing brain
│   └── metrics/             ← KPI dashboard
│
└── 👤 profile/               ← Org landing page
    └── README.md

Quick Commands

# See everything
cat INDEX.md

# Check health
python -m metrics.dashboard

# Route a query
python -m operator.cli "your question"

# Browse org
cat orgs/BlackRoad-AI/README.md

# Check status
cat .STATUS

# Read memory
cat MEMORY.md

The Pattern

          YOU
           │
           ▼
      ┌─────────┐
      │ INDEX.md│  ← Start here
      └────┬────┘
           │
     ┌─────┴─────┐
     ▼           ▼
  [Core]      [Orgs]
  Files      Blueprints
     │           │
     └─────┬─────┘
           ▼
      [Prototypes]
       Live Code

The Bridge connects everything. The Index shows you where.

Infrastructure Status (2026-02-23)

Self-Hosted Runners ($0 compute)

Agent Status Location
aria-pi4 ✅ online 192.168.4.82
octavia-pi5 ✅ online 192.168.4.38
gematria-do ✅ online 159.65.43.12
cecilia ✅ online local
lucidia-pi5 ✅ online 192.168.4.81

Platform Auth (octavia)

  • ✅ Railway CLI authenticated
  • ✅ Wrangler/Cloudflare authenticated
  • ✅ GitHub CLI authenticated
  • ✅ All tokens in ~/.blackroad/vault/

Domain Self-Hosting (alice)

  • 14 domains routed via nginx → Pi cluster
  • cloudflared tunnel: 52915859-da18-4aa6-add5-7bd9fcac2e0b
  • Google Drive sync: cron every 6h