control-plane
PM hub — project board, task scoring, event stream, Telegram notification-only status
Source facts
- Repository
- arigatoexpress/Sapphire
- Last source activity
- July 29, 2026 at 16:28
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
46 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- control-plane
- description
- PM hub — project board, task scoring, event stream, Telegram notification-only status
- type
- service
- runtime
- python
- deploy_target
- rari1
- dependencies
- ["sapphire-core","sapphire-agents"]
- entry_point
- app/main.py
- test_command
- pytest tests/
- build_command
- docker build -t control-plane .
# Control Plane
## Purpose
Central project management and coordination service. Manages the project board,
scores tasks, and publishes local events. Telegram notification-only delivery
belongs to the separate secure-review rail; this service accepts no Telegram
authority.
## Event System
Publishes tagged events: `task.created`, `task.completed`, `deploy.started`, `alert.fired`
Tags: `project:`, `agent:`, `priority:`, `type:`
Agents subscribe to relevant tags for notifications.
## Key Files
- `app/main.py` — FastAPI entry point (health, events, tasks, Kimi bridge, constant-refusal Telegram tombstone)
- `app/control_plane.py` — State management and persistence (SQLite default)
- `app/project_board.py` — Project and task CRUD
- `app/scoring.py` — Task priority scoring
- `app/event_stream.py` — JSONL event log (no GCP — file-based)
- `app/kimi_bridge.py` — `/api/kimi/pm` dispatch endpoint
- `app/frontend/` — PM dashboard HTML pages
## On-prem Deploy (rari1)
```bash
bash infra/pi/rari1/deploy-control-plane.sh
# Service: http://100.x.x.x:8082
# Kimi bridge: POST /api/kimi/pm X-Control-Token: <CONTROL_PLANE_TOKEN>
```
View on GitHub