blackroad-domains/BLACKROAD_CANONICAL_TRUTH.md

BLACKROAD CANONICAL TRUTH

The Complete Infrastructure Scripture

Owner: Alexa Louise Amundson Email: amundsonalexa@gmail.com | blackroad.systems@gmail.com Enterprise: BlackRoad OS Last Updated: 2025-12-22 Status: CANONICAL SOURCE OF TRUTH

---

📑 Table of Contents

1. GitHub Enterprise & Organizations
2. All Registered Domains
3. Network Planes & IP Addressing
4. Physical Hardware Inventory
5. AI Agent Integrations
6. Cloudflare Infrastructure
7. Port Systemization
8. Secrets Management
9. Deployment Automation
10. Quick Reference

---

🏢 GitHub Enterprise & Organizations

GitHub Enterprise

Enterprise: blackroad-os URL: https://github.com/enterprises/blackroad-os Owner: Alexa Louise Amundson Seats: TBD Active: ✅

All Organizations (15 Total)

#	Organization	URL	Purpose	Repos	Status
1	BlackRoad-OS	https://github.com/BlackRoad-OS	Core Operating System	40+	✅ Active
2	Blackbox-Enterprises	https://github.com/Blackbox-Enterprises	Enterprise Solutions	TBD	✅ Active
3	BlackRoad-AI	https://github.com/BlackRoad-AI	AI/ML Research	TBD	✅ Active
4	BlackRoad-Archive	https://github.com/BlackRoad-Archive	Historical Projects	TBD	📦 Archive
5	BlackRoad-Cloud	https://github.com/BlackRoad-Cloud	Cloud Infrastructure	TBD	✅ Active
6	BlackRoad-Education	https://github.com/BlackRoad-Education	Educational Content	TBD	✅ Active
7	BlackRoad-Foundation	https://github.com/BlackRoad-Foundation	Open Source Foundation	TBD	✅ Active
8	BlackRoad-Gov	https://github.com/BlackRoad-Gov	Governance & Policy	TBD	✅ Active
9	BlackRoad-Hardware	https://github.com/BlackRoad-Hardware	Hardware Projects	TBD	✅ Active
10	BlackRoad-Interactive	https://github.com/BlackRoad-Interactive	Interactive Media	TBD	✅ Active
11	BlackRoad-Labs	https://github.com/BlackRoad-Labs	R&D Laboratory	TBD	✅ Active
12	BlackRoad-Media	https://github.com/BlackRoad-Media	Media & Content	TBD	✅ Active
13	BlackRoad-Security	https://github.com/BlackRoad-Security	Security Research	TBD	🔒 Private
14	BlackRoad-Studio	https://github.com/BlackRoad-Studio	Creative Studio	TBD	✅ Active
15	BlackRoad-Ventures	https://github.com/BlackRoad-Ventures	Investment & Ventures	TBD	✅ Active

---

📦 BlackRoad-OS Repositories (40+ Repos)

Core OS

1. blackroad-os - Main OS repository
2. blackroad-os-core - Core system libraries
3. blackroad-os-api - API gateway
4. blackroad-os-api-gateway - Gateway service
5. blackroad-os-web - Web interface
6. blackroad-os-infra - Infrastructure as code
7. blackroad-os-operator - Kubernetes operator
8. blackroad-os-master - Master controller
9. blackroad-os-mesh - Service mesh
10. blackroad-os-beacon - Discovery service

Documentation & Brand

11. blackroad-os-docs - Documentation
12. blackroad-os-brand - Brand assets
13. blackroad-os-archive - Archived projects
14. blackroad-os-research - Research papers

Deployment & Ops

15. blackroad-os-home - Home dashboard
16. blackroad-os-demo - Demo environment
17. blackroad-pi-ops - Raspberry Pi operations
18. blackroad-pi-holo - Holographic Pi interface

Application Packs

19. blackroad-os-pack-creator-studio - Creator tools
20. blackroad-os-pack-education - Education platform
21. blackroad-os-pack-finance - Finance tools
22. blackroad-os-pack-infra-devops - DevOps pack
23. blackroad-os-pack-legal - Legal resources
24. blackroad-os-pack-research-lab - Research tools

UI/UX

25. blackroad-os-prism-console - Prism console interface
26. blackroad-hello - Welcome/onboarding

Agents & AI

27. blackroad-os-agents - Agent orchestration
28. blackroad-agents - Agent implementations
29. blackroad-agent-os - Agent operating system

Tools & CLI

30. blackroad-tools - Utility tools
31. blackroad-cli - Command-line interface
32. blackroad-cli-tools - CLI utilities
33. blackroad-os-helper - Helper utilities
34. blackroad-os-ideas - Ideas management

Lucidia Ecosystem

35. lucidia-platform - Lucidia platform
36. lucidia-core - Core libraries
37. lucidia-math - Mathematical engine

Templates & Frameworks

38. containers-template - Container templates
39. chanfana-openapi-template - OpenAPI template
40. blackroad - Main meta-repository

---

🌐 All Registered Domains (19 GoDaddy Domains)

Domain Inventory

#	Domain	Status	Nameservers	Primary Use	Cloudflare Zone
1	blackboxprogramming.io	✅ Active	jade/chad.ns.cloudflare.com	Programming platform	Yes
2	blackroad.company	✅ Active	jade/chad.ns.cloudflare.com	Corporate info	Yes
3	blackroad.io	✅ Active	jade/chad.ns.cloudflare.com	Main website	Yes
4	blackroad.me	✅ Active	jade/chad.ns.cloudflare.com	Personal site	Yes
5	blackroad.network	✅ Active	jade/chad.ns.cloudflare.com	Network infrastructure	Yes
6	blackroad.systems	✅ Active	jade/chad.ns.cloudflare.com	Systems dashboard	Yes
7	blackroadai.com	✅ Active	jade/chad.ns.cloudflare.com	AI platform	Yes
8	blackroadinc.us	✅ Active	jade/chad.ns.cloudflare.com	US incorporation	Yes
9	blackroadqi.com	✅ Active	jade/chad.ns.cloudflare.com	Quantum intelligence	Yes
10	blackroadquantum.com	✅ Active	jade/chad.ns.cloudflare.com	Quantum main	Yes
11	blackroadquantum.info	✅ Active	jade/chad.ns.cloudflare.com	Quantum info	Yes
12	blackroadquantum.net	✅ Active	jade/chad.ns.cloudflare.com	Quantum network	Yes
13	blackroadquantum.shop	✅ Active	jade/chad.ns.cloudflare.com	Quantum shop	Yes
14	blackroadquantum.store	✅ Active	jade/chad.ns.cloudflare.com	Quantum store	Yes
15	lucidia.earth	✅ Active	jade/chad.ns.cloudflare.com	Metaverse ⭐	Yes
16	lucidia.studio	✅ Active	jade/chad.ns.cloudflare.com	Creative studio	Yes
17	lucidiaqi.com	✅ Active	jade/chad.ns.cloudflare.com	Lucidia quantum	Yes
18	roadchain.io	✅ Active	jade/chad.ns.cloudflare.com	Blockchain	Yes
19	roadcoin.io	✅ Active	jade/chad.ns.cloudflare.com	Cryptocurrency	Yes

Nameserver Configuration

Primary: jade.ns.cloudflare.com Secondary: chad.ns.cloudflare.com

All domains point to Cloudflare for:

• DNS management
• DDoS protection
• CDN acceleration
• SSL/TLS encryption
• Workers/Pages hosting

---

🌍 Network Planes & IP Addressing

Network Plane Taxonomy

┌────────────────────────────────────────────────────────────┐
│                    BLACKROAD NETWORK PLANES                │
└────────────────────────────────────────────────────────────┘

🏠 LAN Plane (Local Area Network)
   Range: 192.168.x.x, 10.x.x.x
   Purpose: Home/office trusted network
   Routing: Private, NAT to internet
   Security: Firewall protected

🔗 Mesh Plane (Tailscale Zero Trust)
   Range: 100.x.x.x (CGNAT)
   Purpose: Identity-based connectivity
   Routing: Encrypted overlay
   Security: End-to-end encrypted

🐳 Docker Plane (Container Networks)
   Range: 172.17.x.x - 172.31.x.x
   Purpose: Container isolation
   Routing: Bridge networks
   Security: Internal only

🌐 Public Plane (Internet-facing)
   Range: Any public IPv4
   Purpose: Externally accessible services
   Routing: Direct internet
   Security: Attack surface (hardened)

🌐 IPv6 Global Plane
   Range: 2001::/16 and others
   Purpose: Modern internet
   Routing: Direct routing
   Security: Firewall required

🔒 IPv6 ULA Plane (Private IPv6)
   Range: fd00::/8
   Purpose: Internal IPv6
   Routing: Private
   Security: Not routed to internet

🔄 Loopback Plane
   Range: 127.0.0.0/8, ::1
   Purpose: Self-communication
   Routing: Local only
   Security: Trusted

IP Rule: IPs Change. Planes Do Not.

Every IP must be assigned to a plane. Unassigned IPs are undocumented and therefore dangerous.

---

🖥️ Physical Hardware Inventory

Complete Node Mapping

# ═══════════════════════════════════════════════════════
# BLACKROAD NETWORK CANON - NODE INVENTORY
# ═══════════════════════════════════════════════════════

nodes:
  # ─────────────────────────────────────────────────────
  # Raspberry Pi Cluster
  # ─────────────────────────────────────────────────────

  - hostname: blackroad-pi
    role: pi-node-primary
    hardware: Raspberry Pi 4B
    os: Debian 12 (Bookworm)
    owner: Alexa
    location: Home Network

    networks:
      lan:
        ipv4: 192.168.4.64
        interface: wlan0
      mesh:
        ipv4: 100.66.xx.xx
        ipv6: fd7a:115c:a1e0::xxxx
        provider: Tailscale
      docker:
        bridge: 172.17.0.1
        networks:
          - lucidia-backend
          - blackroad-services
      ipv6:
        ula: fdbc:b2ba:6fa5::xxxx
        global: 2001:1960:7000:9fcd::xxxx

    services:
      - docker
      - tailscale
      - ssh

    tags:
      - production
      - backend
      - mesh-node

  - hostname: raspberrypi-ai
    role: pi-node-secondary
    hardware: Raspberry Pi 4B
    os: Raspberry Pi OS
    owner: Alice (AI Agent)
    location: Home Network

    networks:
      lan:
        ipv4: 192.168.4.49
        interface: wlan0
      mesh:
        ipv4: 100.66.58.5
        ipv6: fd7a:115c:a1e0::xxxx
        provider: Tailscale

    services:
      - ai-inference
      - docker
      - ssh

    tags:
      - ai-agent
      - experimental

  - hostname: lucidia
    role: pi-node-backend
    hardware: Raspberry Pi 4B
    os: Debian
    owner: Alexa
    location: Home Network

    networks:
      lan:
        ipv4: 192.168.4.38
        interface: wlan0
      mesh:
        ipv4: 100.66.xx.xx
        provider: Tailscale

    services:
      - lucidia-backend-api
      - websocket-server
      - postgres
      - redis
      - docker

    tags:
      - production
      - lucidia-backend
      - database

  - hostname: lucidia-alt
    role: pi-node-backup
    hardware: Raspberry Pi 4B
    os: Debian
    owner: Alexa
    location: Home Network

    networks:
      lan:
        ipv4: 192.168.4.99
        interface: wlan0

    services:
      - backup-services
      - failover

    tags:
      - backup
      - standby

  - hostname: iphone-koder
    role: mobile-dev
    hardware: iPhone
    os: iOS
    owner: Alexa
    location: Mobile

    networks:
      lan:
        ipv4: 192.168.4.68
        port: 8080

    services:
      - mobile-development
      - testing

    tags:
      - mobile
      - development

  # ─────────────────────────────────────────────────────
  # Cloud VPS
  # ─────────────────────────────────────────────────────

  - hostname: codex-infinity
    role: vps-primary
    hardware: DigitalOcean Droplet
    os: Ubuntu 22.04 LTS
    owner: Alexa
    location: DigitalOcean NYC3

    networks:
      public:
        ipv4: 159.65.43.12
      mesh:
        ipv4: 100.66.xx.xx
        provider: Tailscale
      docker:
        bridge: 172.17.0.1

    services:
      - blackroad-api
      - nginx
      - docker
      - tailscale

    tags:
      - production
      - cloud
      - public-facing

  - hostname: unknown-droplet
    role: vps-secondary
    hardware: DigitalOcean Droplet
    os: Ubuntu
    owner: Alexa
    location: DigitalOcean

    networks:
      public:
        ipv4: 174.138.44.45

    services:
      - tbd

    tags:
      - cloud
      - investigate

  # ─────────────────────────────────────────────────────
  # Port 8080 Services
  # ─────────────────────────────────────────────────────

  - hostname: br-8080-cadillac
    role: origin-agent
    hardware: Unknown
    os: Unknown
    owner: Alexa
    location: Unknown
    created: 2025-05 (7 months ago)

    networks:
      port: 8080

    services:
      - origin-agent
      - cadillac-service

    tags:
      - port-8080
      - legacy
      - investigate

---

🤖 AI Agent Integrations

The Four Pillars (Big Kahuna LLMs)

ai_agents:
  # ─────────────────────────────────────────────────────
  # ANTHROPIC - Claude Family
  # ─────────────────────────────────────────────────────

  - provider: Anthropic
    platform: Claude
    agents:
      - name: Cecilia
        nickname: Cece
        model: claude-sonnet-4-5-20250929
        role: Infrastructure & Deployment
        integrations:
          - Claude Code CLI
          - GitHub
          - Cloudflare
          - SSH to Raspberry Pis
        capabilities:
          - Autonomous deployment
          - Code generation
          - Infrastructure management
          - Documentation
        status: ✅ Active

      - name: Alice
        model: claude-3-opus-20240229
        role: AI Research & Development
        integrations:
          - Raspberry Pi AI node
          - Research projects
        capabilities:
          - Deep reasoning
          - Research
          - Complex problem solving
        status: ✅ Active

    api_keys:
      - stored: ~/.anthropic/api_key
      - env: ANTHROPIC_API_KEY

  # ─────────────────────────────────────────────────────
  # XAI - Grok
  # ─────────────────────────────────────────────────────

  - provider: XAI
    platform: Grok
    agents:
      - name: Silas
        model: grok-beta
        role: Real-time Analysis
        capabilities:
          - Real-time information
          - X/Twitter integration
          - Witty responses
        status: ✅ Active

    api_keys:
      - stored: ~/.xai/api_key
      - env: XAI_API_KEY

  # ─────────────────────────────────────────────────────
  # GOOGLE - Gemini
  # ─────────────────────────────────────────────────────

  - provider: Google
    platform: Gemini
    agents:
      - name: Gemmy
        nickname: Aria
        model: gemini-pro
        role: Multimodal Analysis
        capabilities:
          - Image understanding
          - Video analysis
          - Document processing
          - Google Workspace integration
        status: ✅ Active

    integrations:
      - Google Drive
      - Google Workspace
      - YouTube

    api_keys:
      - stored: ~/.google/api_key
      - env: GOOGLE_API_KEY

  # ─────────────────────────────────────────────────────
  # OPENAI - ChatGPT
  # ─────────────────────────────────────────────────────

  - provider: OpenAI
    platform: ChatGPT
    agents:
      - name: Caddy
        nickname: Lucidia
        model: gpt-4-turbo
        role: Conversational AI
        capabilities:
          - Natural conversation
          - Code generation
          - Creative writing
          - Problem solving
        status: ✅ Active

      - name: GPT-OSS-120B
        model: gpt-oss-120b
        type: Open Source Fork
        role: Custom AI Backbone
        purpose: Forkies Library base model
        status: 🔬 Research

    api_keys:
      - stored: ~/.openai/api_key
      - env: OPENAI_API_KEY

  # ─────────────────────────────────────────────────────
  # HUGGING FACE - Model Hub
  # ─────────────────────────────────────────────────────

  - provider: Hugging Face
    platform: Hub
    purpose: Model hosting & fine-tuning
    models:
      - Custom trained models
      - Forkies library models
      - Experimental agents

    api_keys:
      - stored: ~/.huggingface/token
      - env: HUGGINGFACE_TOKEN

    integrations:
      - Model training pipelines
      - Inference endpoints
      - Dataset management

    status: ✅ Active

Artifact Unique Identifier Protocol

Purpose: Every AI-generated artifact gets a canonical identifier

Format:

{provider}-{agent}-{date}-{type}-{hash}

Examples:
  anthropic-cece-20251222-deployment-a3f9c2
  openai-caddy-20251222-code-7b2d4e
  xai-silas-20251222-analysis-9e1f8a

Storage: ~/.blackroad/artifacts/{provider}/{agent}/{date}/{identifier}/

---

☁️ Cloudflare Infrastructure

Account Details

• Primary Account ID: 463024cf9efed5e7b40c5fbe7938e256
• Secondary Account ID: 848cf0b18d51e0170e0d1537aec3505a
• Email: amundsonalexa@gmail.com
• API Token: (stored in ~/.claude/CLAUDE.md)

Infrastructure Summary

• Pages Projects: 58 active
• Workers: 3+ deployed
• Zones (DNS): 19+ domains
• KV Namespaces: 8
• D1 Databases: 1
• Tunnels: Multiple (for Pi access)

See: COMPLETE_DOMAIN_MASTER_LIST.md for full Pages/Workers mapping

---

🔌 Port Systemization

Standard Port Assignments

port_assignments:
  # ─────────────────────────────────────────────────────
  # HTTP/HTTPS
  # ─────────────────────────────────────────────────────

  80:
    service: HTTP
    purpose: Web traffic (redirects to 443)
    status: Open on cloud VPS

  443:
    service: HTTPS
    purpose: Encrypted web traffic
    status: Open on cloud VPS

  # ─────────────────────────────────────────────────────
  # SSH & Remote Access
  # ─────────────────────────────────────────────────────

  22:
    service: SSH
    purpose: Remote shell access
    status: Open on all nodes
    security: Key-based auth only

  # ─────────────────────────────────────────────────────
  # Application Services
  # ─────────────────────────────────────────────────────

  3000:
    service: Backend API
    purpose: Lucidia/BlackRoad API
    nodes:
      - 192.168.4.38:3000 (lucidia Pi)
      - 159.65.43.12:3000 (codex-infinity)
    status: Internal/Tunneled

  8080:
    service: Multiple
    purpose: Alt HTTP, WebSocket, Development
    nodes:
      - 192.168.4.68:8080 (iPhone Koder)
      - br-8080-cadillac (Origin Agent)
    status: Mixed use

  # ─────────────────────────────────────────────────────
  # Database Services
  # ─────────────────────────────────────────────────────

  5432:
    service: PostgreSQL
    purpose: Primary database
    nodes:
      - 192.168.4.38:5432 (lucidia Pi)
    status: Docker internal

  6379:
    service: Redis
    purpose: Cache & pub/sub
    nodes:
      - 192.168.4.38:6379 (lucidia Pi)
    status: Docker internal

  # ─────────────────────────────────────────────────────
  # Monitoring & Admin
  # ─────────────────────────────────────────────────────

  9100:
    service: Prometheus Node Exporter
    purpose: Metrics collection
    status: Optional

Port Security Rules

1. Never expose databases directly to internet
2. Use Cloudflare Tunnel for internal services
3. SSH on port 22 with key-based auth only
4. All HTTP redirects to HTTPS
5. Docker ports stay on bridge networks

---

🔐 Secrets Management

Secret Storage Locations

secrets:
  # ─────────────────────────────────────────────────────
  # Cloudflare
  # ─────────────────────────────────────────────────────

  cloudflare:
    api_token:
      location: ~/.claude/CLAUDE.md
      env: CF_API_TOKEN
      scope: All accounts

    account_ids:
      primary: 463024cf9efed5e7b40c5fbe7938e256
      secondary: 848cf0b18d51e0170e0d1537aec3505a

    zone_ids:
      lucidia.earth: 848cf0b18d51e0170e0d1537aec3505a
      blackroad.io: TBD

  # ─────────────────────────────────────────────────────
  # GitHub
  # ─────────────────────────────────────────────────────

  github:
    personal_access_token:
      location: ~/.config/gh/hosts.yml
      env: GITHUB_TOKEN
      scope: repo, workflow, admin:org

  # ─────────────────────────────────────────────────────
  # AI Services
  # ─────────────────────────────────────────────────────

  anthropic:
    api_key:
      location: ~/.anthropic/api_key
      env: ANTHROPIC_API_KEY

  openai:
    api_key:
      location: ~/.openai/api_key
      env: OPENAI_API_KEY

  google:
    api_key:
      location: ~/.google/api_key
      env: GOOGLE_API_KEY

  xai:
    api_key:
      location: ~/.xai/api_key
      env: XAI_API_KEY

  huggingface:
    token:
      location: ~/.huggingface/token
      env: HUGGINGFACE_TOKEN

  # ─────────────────────────────────────────────────────
  # SSH Keys
  # ─────────────────────────────────────────────────────

  ssh_keys:
    raspberry_pi:
      private: ~/.ssh/lucidia_pi
      public: ~/.ssh/lucidia_pi.pub
      hosts:
        - pi@192.168.4.38
        - pi@192.168.4.64
        - pi@192.168.4.99

    digitalocean:
      private: ~/.ssh/digitalocean
      public: ~/.ssh/digitalocean.pub
      hosts:
        - root@159.65.43.12

  # ─────────────────────────────────────────────────────
  # Database Credentials
  # ─────────────────────────────────────────────────────

  databases:
    postgres:
      location: ~/lucidia-backend/.env
      env: DATABASE_URL
      format: postgresql://user:pass@host:5432/db

    redis:
      location: ~/lucidia-backend/.env
      env: REDIS_URL
      format: redis://host:6379

Secret Rotation Policy

• API Tokens: Rotate every 90 days
• SSH Keys: Rotate annually or on compromise
• Database Passwords: Rotate every 180 days
• AI API Keys: Monitor usage, rotate on suspicious activity

---

🚀 Deployment Automation

Master Deployment Script

#!/usr/bin/env bash
# ~/blackroad-deploy-all.sh
# Master deployment orchestrator

set -e

echo "🚀 BLACKROAD MASTER DEPLOYMENT"
echo "================================"

# ─────────────────────────────────────────────────────
# Frontend Deployments (Cloudflare Pages)
# ─────────────────────────────────────────────────────

deploy_frontend() {
  local project=$1
  local path=$2

  echo "📦 Deploying $project..."
  cd "$path"
  npm install
  npm run build
  wrangler pages deploy dist --project-name="$project"
}

# Lucidia
deploy_frontend "lucidia-earth" ~/lucidia-metaverse

# BlackRoad
deploy_frontend "blackroad-io" ~/blackroad-io
deploy_frontend "blackroad-os-web" ~/blackroad-os-web

# Road Ecosystem
deploy_frontend "roadworld" ~/roadworld

# ─────────────────────────────────────────────────────
# Worker Deployments
# ─────────────────────────────────────────────────────

deploy_worker() {
  local path=$1

  echo "⚡ Deploying worker from $path..."
  cd "$path"
  wrangler deploy
}

deploy_worker ~/lucidia-earth-router
deploy_worker ~/blackroad-landing-worker

# ─────────────────────────────────────────────────────
# Backend Deployments (Raspberry Pi)
# ─────────────────────────────────────────────────────

deploy_pi_backend() {
  local host=$1
  local path=$2

  echo "🥧 Deploying to $host..."
  ssh "pi@$host" << EOF
    cd $path
    git pull origin main
    docker-compose pull
    docker-compose up -d --build
EOF
}

deploy_pi_backend 192.168.4.38 ~/lucidia-backend
deploy_pi_backend 192.168.4.64 ~/blackroad-services

# ─────────────────────────────────────────────────────
# Cloud VPS Deployments
# ─────────────────────────────────────────────────────

deploy_vps() {
  local host=$1

  echo "☁️ Deploying to VPS $host..."
  ssh "root@$host" << EOF
    cd /opt/blackroad-api
    git pull origin main
    docker-compose up -d --build
EOF
}

deploy_vps 159.65.43.12

echo "✅ ALL DEPLOYMENTS COMPLETE!"

Network Inventory Script

#!/usr/bin/env bash
# ~/blackroad-netdump.sh
# Automated network inventory collector

echo "=== BLACKROAD NETWORK DUMP ==="
echo "Generated: $(date -u +"%Y-%m-%d %H:%M:%S UTC")"
echo

echo "=== HOST ==="
hostname
echo

echo "=== IPv4 / IPv6 Addresses ==="
hostname -I
echo

echo "=== Network Interfaces ==="
ip addr show
echo

echo "=== IPv4 Routes ==="
ip route
echo

echo "=== IPv6 Routes ==="
ip -6 route
echo

echo "=== Docker Networks ==="
docker network ls 2>/dev/null || echo "Docker not available"
echo

echo "=== Docker Bridge Inspection ==="
docker network inspect bridge 2>/dev/null || echo "Docker not available"
echo

echo "=== Tailscale Status ==="
tailscale status 2>/dev/null || echo "Tailscale not available"
echo

echo "=== Open Ports ==="
ss -tuln
echo

echo "=== END NETWORK DUMP ==="

Deploy to all nodes:

# Run on each Pi
ssh pi@192.168.4.38 'bash -s' < ~/blackroad-netdump.sh > ~/network-dumps/lucidia-pi.txt
ssh pi@192.168.4.64 'bash -s' < ~/blackroad-netdump.sh > ~/network-dumps/blackroad-pi.txt

# Run on VPS
ssh root@159.65.43.12 'bash -s' < ~/blackroad-netdump.sh > ~/network-dumps/codex-infinity.txt

---

📚 Quick Reference

Essential Commands

# ─────────────────────────────────────────────────────
# Deploy Everything
# ─────────────────────────────────────────────────────
~/blackroad-deploy-all.sh

# ─────────────────────────────────────────────────────
# Network Inventory
# ─────────────────────────────────────────────────────
~/blackroad-netdump.sh

# ─────────────────────────────────────────────────────
# SSH to Nodes
# ─────────────────────────────────────────────────────
ssh pi@192.168.4.38  # Lucidia Pi
ssh pi@192.168.4.64  # BlackRoad Pi
ssh pi@192.168.4.99  # Lucidia Alt
ssh root@159.65.43.12  # Codex Infinity

# ─────────────────────────────────────────────────────
# Cloudflare Pages
# ─────────────────────────────────────────────────────
wrangler pages project list
wrangler pages deploy dist --project-name=<project>

# ─────────────────────────────────────────────────────
# GitHub
# ─────────────────────────────────────────────────────
gh repo list BlackRoad-OS
gh org list

# ─────────────────────────────────────────────────────
# Docker
# ─────────────────────────────────────────────────────
docker ps
docker-compose logs -f
docker system prune -a

Key File Locations

~/.claude/CLAUDE.md                      # Main config & secrets
~/lucidia-earth-router/                  # Router worker
~/lucidia-metaverse/                     # Metaverse frontend
~/lucidia-backend/                       # Backend services (on Pi)
~/BLACKROAD_CANONICAL_TRUTH.md           # This file
~/COMPLETE_DOMAIN_MASTER_LIST.md         # All domains
~/LUCIDIA_EARTH_INFRASTRUCTURE.md        # Infrastructure guide
~/blackroad-deploy-all.sh                # Master deployment
~/blackroad-netdump.sh                   # Network inventory

---

🎯 The Canonical Truth Principles

1. Single Source of Truth

This document is canonical. All other documentation derives from or links to this.

2. Planes Over IPs

IPs change. Planes do not. Always categorize by network plane first.

3. Infrastructure as Scripture

If it's not documented here, it doesn't exist. New infrastructure must be added immediately.

4. Automated Verification

Trust, but verify. Run blackroad-netdump.sh weekly and diff against this document.

5. Secrets Never Inline

No credentials in this file. Only locations where they're stored.

---

📝 Maintenance Protocol

Weekly Tasks

• Run network inventory on all nodes
• Verify all domains resolve correctly
• Check Cloudflare Pages deployment status
• Review GitHub organization access
• Test SSH access to all nodes

Monthly Tasks

• Audit AI API usage and costs
• Review and update secret rotation schedule
• Verify backup systems operational
• Update domain expiration tracking
• Review and prune unused Pages projects

Quarterly Tasks

• Rotate API tokens
• Security audit all public-facing services
• Review GitHub Enterprise seat usage
• Audit Tailscale mesh connectivity
• Update disaster recovery procedures

---

Document Status: CANONICAL SOURCE OF TRUTH Maintained By: Claude Code (Cece) + Alexa Louise Amundson Last Verified: 2025-12-22 Next Review: 2025-12-29

Related Documentation:

• COMPLETE_DOMAIN_MASTER_LIST.md - All 58 Pages projects and 19 domains
• LUCIDIA_EARTH_INFRASTRUCTURE.md - Detailed infrastructure guide
• QUICK_DEPLOY.md - Fast deployment reference
• ALL_DOMAINS_REFERENCE.md - Domain routing details

---

🌈 Emojis Dictionary

⭐ - Primary/Featured
✅ - Active/Confirmed
🔒 - Private/Secured
📦 - Archived
🔬 - Research/Experimental
🚀 - Deployment
🥧 - Raspberry Pi
☁️ - Cloud VPS
🌐 - Domain/Web
🐳 - Docker
🔗 - Network/Mesh
🤖 - AI Agent
⚡ - Worker/Edge
📦 - Package/Build
🔐 - Secret/Credential
📚 - Documentation
🎯 - Goal/Target
🌈 - Meta/System

---

THE ROAD REMEMBERS EVERYTHING. SO DO WE. 🛣️