3.0 KiB
3.0 KiB
RoadCode CI
BlackRoad OS — Pave Tomorrow.
Central CI/CD templates, workflows, and configuration for the entire BlackRoad fleet.
Workflow Templates (15 total)
CI Pipelines
| Workflow | Trigger | Purpose |
|---|---|---|
node-ci.yml |
push, PR | Node.js build, test, lint |
python-ci.yml |
push, PR | Python pytest + flake8 |
shell-ci.yml |
push, PR | ShellCheck + syntax validation |
lint-format.yml |
push, PR | Universal linter (auto-detects JS/Python/Shell/Go) |
security-scan.yml |
push, PR | Secret detection + dependency audit |
Deployment
| Workflow | Trigger | Purpose |
|---|---|---|
cloudflare-deploy.yml |
push to main | Deploy Cloudflare Pages |
deploy-worker.yml |
push to main | Deploy Cloudflare Worker |
docker-build.yml |
push, tags | Build + push Docker to Gitea registry |
release.yml |
tag v* | Auto-create release with changelog |
Automation
| Workflow | Trigger | Purpose |
|---|---|---|
auto-merge.yml |
PR approved | Auto-merge from trusted authors |
welcome-bot.yml |
issue/PR opened | Welcome first-time contributors |
stale-issues.yml |
daily | Close stale issues (30d inactivity) |
dependency-update.yml |
weekly | Check for outdated packages |
nightly-health.yml |
daily 6am | Health check all workers |
backup-db.yml |
daily 4am | Export D1 databases |
Issue Templates (5 types)
- Bug Report — severity, affected node, logs
- Feature Request — use case, components, solution
- Infrastructure — current/desired state, node, priority
- Security Report — vulnerability, severity, reproduction
- Agent Task — assign work to specific agents
Agent Integration
8 AI agents automatically respond to issues and comments:
| Agent | Role | Keywords |
|---|---|---|
| 🌐 Alice | Gateway & Infrastructure | DNS, routing, tunnels, nginx |
| 🧠 Lucidia | Memory & Cognition | AI, learning, context, knowledge |
| ⚡ Cecilia | Edge AI & Inference | Hailo, Ollama, models, GPU |
| 🔌 Cece | API Gateway | REST, webhooks, endpoints, auth |
| 🎵 Aria | Orchestration | Docker, Swarm, Portainer, deploy |
| 👁️ Eve | Intelligence & Analysis | Patterns, anomalies, metrics (always responds) |
| 🌊 Meridian | Networking & Mesh | WireGuard, RoadNet, tunnels |
| 🛡️ Sentinel | Security & Audit | SSH, firewall, threats (always responds) |
Usage
Copy any workflow to your repo:
mkdir -p .gitea/workflows
# Copy from this repo or write your own based on the templates
Milestones
- v1.0 — Foundation (April 2026): Core infrastructure, CI/CD, agents
- v1.1 — Intelligence (May 2026): AI-powered routing, Ollama integration
- v1.2 — Mesh (June 2026): Browser mesh network, WebRTC
- v2.0 — Sovereign (Sept 2026): Zero external dependencies
Labels
50 labels across 8 categories: type, priority, status, component, agent, node, service, meta.
🛣️ BlackRoad OS — Pave Tomorrow.