fleet-dashboard/CONTRIBUTING.md

Contributing to BlackRoad OS

Pave Tomorrow.

Getting Started

1. Fork the repo on RoadCode
2. Clone your fork locally
3. Create a feature branch: git checkout -b feature/your-feature
4. Make your changes
5. Push and open a Pull Request

CI/CD

All repos have automated CI via Gitea Actions:

• Lint & Format — auto-detects language (JS/Python/Shell/Go/Rust)
• Security Scan — checks for leaked secrets
• Welcome Bot — greets first-time contributors

Issue Templates

Use the issue template that fits:

• Bug Report — something is broken
• Feature Request — you want something new
• Infrastructure — node/network/deployment changes
• Security Report — vulnerability found
• Agent Task — assign work to a BlackRoad agent

Code Style

• JavaScript/TypeScript: ESLint + Prettier
• Python: flake8 + black
• Shell: ShellCheck
• Go: gofmt + go vet
• Rust: cargo fmt + clippy

Agents

8 AI agents monitor all repos and respond to issues automatically. They will review your PR and offer perspective from their specialization.

Labels

Issues are auto-labeled based on content. You can also manually apply:

• priority:critical/high/medium/low
• status:in-progress/blocked/needs-review/ready
• component:gateway/api/inference/memory/orchestration/networking/security/web

---

BlackRoad OS — Pave Tomorrow.