feat: BlackRoad OS Phase 2.5 - Infrastructure Wiring Complete

Phase 2.5 wires up the infrastructure decisions and prepares BlackRoad OS
for production deployment. This phase codifies architectural choices and
creates deployment-ready configurations.

## Key Decisions Codified

- ✅ Monorepo as canonical OS home (for Phase 1-2)
- ✅ Prism Console served from backend at /prism
- ✅ Documentation via GitHub Pages (MkDocs)
- ✅ Vanilla JavaScript frontend maintained

## New Infrastructure

### Documentation & Planning
- PHASE2_5_SUMMARY_FOR_ALEXA.md - Complete Phase 2.5 summary
- BLACKROAD_OS_REPO_MAP.md - Repository structure map
- DEPLOYMENT_NOTES.md - Production deployment guide

### Backend Infrastructure
- backend/app/routers/prism_static.py - Prism Console static router
- backend/static/prism/ - Prism Console UI skeleton
  - index.html, css/prism.css, js/prism-core.js

### Documentation System
- .github/workflows/docs-deploy.yml - MkDocs deployment automation
- codex-docs/mkdocs.yml - MkDocs + Material theme config
- codex-docs/DEPLOY_DOCS.md - Docs deployment guide
- codex-docs/docs/ - Complete documentation structure

### Updated Files
- backend/app/main.py - Added Prism router, OpenAPI tags
- MASTER_ORCHESTRATION_PLAN.md - Added Phase 2.5 section

## URL Structure (Production)

- https://blackroad.systems → Main OS
- https://blackroad.systems/prism → Prism Console
- https://blackroad.systems/api/* → REST API
- https://docs.blackroad.systems → Documentation

## Post-Merge Checklist

1. Configure GitHub Pages (5 min)
2. Configure Railway deployment (10 min)
3. Configure Cloudflare DNS (15 min)
4. Verify all routes work (5 min)
5. Monitor first deployment (10 min)

See PHASE2_5_SUMMARY_FOR_ALEXA.md for complete post-merge instructions.

## Implementation Status

✅ Phase 2.5 Complete - Ready for production deployment

---

Where AI meets the open road. 🛣️

backend/app/main.py

@@ -15,12 +15,13 @@ from app.routers import (
     digitalocean, github, huggingface, vscode, games, browser, dashboard,
     railway, vercel, stripe, twilio, slack, discord, sentry, api_health, agents,
     capture, identity_center, notifications_center, creator, compliance_ops,
-    search, cloudflare
+    search, cloudflare, prism_static
 )
 from app.services.crypto import rotate_plaintext_wallet_keys
 
 
 openapi_tags = [
+    {"name": "prism", "description": "Prism Console - Administrative interface for job queue, events, and metrics"},
     {"name": "railway", "description": "Railway deployment management"},
     {"name": "vercel", "description": "Vercel project automation"},
     {"name": "stripe", "description": "Stripe billing integrations"},
@@ -155,6 +156,9 @@ app.include_router(api_health.router)
 # Agent Library
 app.include_router(agents.router)
 
+# Prism Console (must be before StaticFiles mount to take precedence)
+app.include_router(prism_static.router)
+
 
 # Static file serving for the BlackRoad OS front-end
 static_dir = os.path.join(os.path.dirname(os.path.dirname(__file__)), "static")