# 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:
```bash
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.*