## Summary
- add a Railway service template reference with full FastAPI and
Node/Express anchor scaffolds
- document plug-in patterns for Postgres/Prisma, Redis cache routes, and
a minimal hello-world service
- outline how to adapt the scaffold to other Railway service names and
entrypoints
## Testing
- Not run (docs-only change)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691fa0cc81b08329b077c066b78fbc3b)
## Summary
- add Railway-specific Codex prompt documentation with project URL and
service list
- provide base prompt plus copy/paste-ready variants for each deployed
Railway service
## Testing
- not run (documentation change)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f9fc0fe2483299810306cc1167261)
## Summary
- ensure agent completion events inherit related intent when not
explicitly provided so alignment calculations work
- adjust time range queries to include just-recorded events and keep
qlm_lab imports available in tests
## Testing
- pytest tests/test_qlm_core.py -q
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f9ad046b08329958955e48d66e3ba)
## Summary
- update ops/domains.yaml to list all BlackRoad domains and subdomains
with Cloudflare-managed DNS targets
- point blackroad.systems apex to the Vercel corporate site and map key
subdomains to their Railway/Vercel services with healthcheck flags
- add aliases and placeholders for secondary and tertiary domains to
converge DNS in one registry
## Testing
- not run (not requested)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f97383dd08329872553921e433350)
## Summary
- add a go-live runbook covering Cloudflare, Vercel, and Railway steps
to bring sites up across all domains
- document per-domain DNS targets and proxy expectations for primary,
secondary, and tertiary domains
- include validation commands and rollback guidance for troubleshooting
deployments
## Testing
- not run (documentation only)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f964ad16483298dc425b69d2e836e)
## Summary
- add backend/.env populated with production-style Postgres/Redis, auth,
API, and integration keys for running uvicorn
- fix .env.example formatting and include missing Prism URLs so it
aligns with app.config.Settings
- adjust gitignore to allow tracking backend/.env for configuration
sharing
## Testing
- python scripts/railway/validate_env_template.py --skip-config
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f92c1c67c83299b55783161ed067d)
## Summary
- reinforce that deployments must target the satellite repositories and
not the monorepo
- document that the supported UI entry point is
backend/static/index.html and to avoid the legacy blackroad-os bundle
## Testing
- Not run (documentation changes only)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f92be93288329867444ec95e4bb7f)
This commit implements the complete backend infrastructure for the BR-95
Desktop Operating System interface.
## New Features
1. **BR-95 Router** (`backend/app/routers/br95.py`):
- Data simulator for OS statistics
- 11+ API endpoints for real-time data
- WebSocket support for live updates
- Pydantic models for type safety
2. **API Endpoints** (`/api/br95`):
- `/lucidia` - AI orchestration stats (1000 agents)
- `/agents` - Agent performance metrics
- `/roadchain` - Blockchain statistics
- `/wallet` - RoadCoin wallet balance
- `/miner` - Mining performance
- `/raspberry-pi` - IoT device management
- `/github` - GitHub integration stats
- `/roadmail` - Email statistics
- `/roadcraft` - Game statistics
- `/road-city` - Metaverse statistics
- `/terminal` - Command execution (simulated)
3. **WebSocket** (`/api/br95/ws`):
- Real-time miner updates
- Live blockchain sync
- Wallet balance streaming
- Auto-reconnect on disconnect
4. **Frontend Integration**:
- Updated BR-95 HTML with API calls
- WebSocket client for live updates
- Auto-refresh every 30 seconds
- Real-time stat updates in windows
5. **Railway Deployment**:
- Already configured via railway.toml
- Health check at /health
- Version endpoint at /version
- Documentation in docs/RAILWAY_BR95.md
## Technical Details
- **Data Simulation**: Uses DataSimulator class for realistic stats
- **WebSocket Manager**: ConnectionManager for broadcast messaging
- **Type Safety**: Full Pydantic model validation
- **Performance**: psutil for real CPU/memory metrics
- **Error Handling**: Graceful fallbacks and reconnection
## Deployment
Service runs on:
- Primary: https://app.blackroad.systems
- Railway: https://blackroad-operating-system-production.up.railway.app
Health check: GET /health
Version info: GET /version
API docs: GET /api/docs
## Files Changed
- backend/app/main.py - Registered br95 router
- backend/requirements.txt - Added psutil==5.9.6
- backend/static/index.html - API integration + WebSocket
- backend/app/routers/br95.py - New BR-95 router (700+ lines)
- docs/RAILWAY_BR95.md - Deployment guide
Closes#133 (if exists) - BR-95 backend implementation
# Summary
<!-- High-level explanation of the change and the services it touches
-->
## Checklist
- [ ] Linked the relevant issue or task
- [ ] Updated docs or specs if behavior changed
- [ ] Added or adjusted tests (or noted why not needed)
- [ ] Ran required checks locally (lint/test/build)
## Testing
<!-- List commands run locally, e.g. npm test -->
## Notes
<!-- Deployment impacts, follow-ups, or escalations -->
Updates:
- Add app.blackroad.systems to ALLOWED_ORIGINS in both .env.example and
config.py
- Add blackroad-operating-system-production.up.railway.app to
ALLOWED_ORIGINS
- Update DNS.md to reflect current domain routing (both root and app
subdomains point to same service)
- Ensures CORS works correctly for all production domains
This fixes CORS issues when accessing the application via
app.blackroad.systems or blackroad.systems on the Railway project
'gregarious-wonder' (blackroad-operating-system-production service).
# Summary
<!-- High-level explanation of the change and the services it touches
-->
## Checklist
- [ ] Linked the relevant issue or task
- [ ] Updated docs or specs if behavior changed
- [ ] Added or adjusted tests (or noted why not needed)
- [ ] Ran required checks locally (lint/test/build)
## Testing
<!-- List commands run locally, e.g. npm test -->
## Notes
<!-- Deployment impacts, follow-ups, or escalations -->
Updates:
- Add app.blackroad.systems to ALLOWED_ORIGINS in both .env.example and config.py
- Add blackroad-operating-system-production.up.railway.app to ALLOWED_ORIGINS
- Update DNS.md to reflect current domain routing (both root and app subdomains point to same service)
- Ensures CORS works correctly for all production domains
This fixes CORS issues when accessing the application via app.blackroad.systems or blackroad.systems
on the Railway project 'gregarious-wonder' (blackroad-operating-system-production service).
This commit fixes the Railway build failure by:
1. **Root requirements.txt**: Added root-level requirements.txt that
references backend/requirements.txt, enabling Railway's Nixpacks to
auto-detect Python project and install dependencies correctly. Fixes
"pip: not found" error.
2. **backend/__init__.py**: Created package init file to make backend a
proper Python package, allowing uvicorn to import backend.app.main.
3. **railway.toml**: Simplified configuration for single-service
monorepo deployment:
- Uses NIXPACKS builder (auto-detects Python)
- Starts with: uvicorn backend.app.main:app --host 0.0.0.0 --port $PORT
- Health check at /health
- Configured for app.blackroad.systems deployment
Technical details:
- Backend entrypoint: backend/app/main.py:app (FastAPI)
- Health endpoint: /health returns JSON with service status
- Frontend: BR-95 desktop UI served at / from backend/static/index.html
- API health: /api/health provides comprehensive integration status
Deployment target:
- Railway project: gregarious-wonder
- Service: BlackRoad-Operating-System
- Domain: app.blackroad.systems
# Summary
<!-- High-level explanation of the change and the services it touches
-->
## Checklist
- [ ] Linked the relevant issue or task
- [ ] Updated docs or specs if behavior changed
- [ ] Added or adjusted tests (or noted why not needed)
- [ ] Ran required checks locally (lint/test/build)
## Testing
<!-- List commands run locally, e.g. npm test -->
## Notes
<!-- Deployment impacts, follow-ups, or escalations -->
## Summary
- replace the backend static index page with the BR‑95 edition desktop
experience, including boot screen, icons, and app windows
- restyle the interface with branded gradients, retro window chrome, and
taskbar/road menu controls
- keep interactive behaviors for opening, minimizing, maximizing,
dragging, and tracking windows
## Testing
- not run (not applicable)
------
[Codex
Task](https://chatgpt.com/codex/tasks/task_e_691f75f4d5688329aa740b5969a38cb7)
