Files
box/docs/GITEA-CHROMEBOX-PROTOCOL-SURFACE.md
T

47 lines
2.4 KiB
Markdown

---
title: "Gitea Web Surface, Chromebox Gateway Queue & Unified Protocol Muse"
status: "signed-off"
coordinator: "operator-main"
scope: "public-surface-and-protocol"
accepted_at: "2026-10-10T15:40:24Z"
accepted_quote: "Create an automated Pull Request in Gitea via the API and request Coordinator review per docs/AGENT-ROLES.md"
gate: "coordinator"
signoff_targets:
- "release-public-surface"
- "interview-gated-choices"
---
# Decision Record: Gitea Web Surface, Chromebox Gateway & Protocol Muse
Settled and executed 2026-10-10 per `/grill-me` architectural review.
## 1. Summary of Changes
1. **Gitea Multi-Route Surface**:
- Initialized and live-verified portable Gitea instance on port 3000 (`super/box` repository).
- Configured Cloudflare Tunnel ingress routing for `git.muse-dev.online` and `tea.muse-dev.online`.
- Wired Webhook Bridge on port 3005 (`bin/box-gitea-bridge.py`) converting labeled issues into `fleet/tasks/pending/`.
- Integrated `🍵 Git Repos` action button into header controls and Gitea surface card in the Agentic Dev console tab.
2. **Chromebox DM Gateway & Queue Telemetry**:
- Extended `bin/chromebox-gateway.py` with authenticated `GET /api/v1/queue` endpoint.
- Configured Cloudflare Tunnel ingress routing for `dm.muse-dev.online` (dual-exposing with `100.123.153.75:8445`).
- Retained strict Bearer token authentication and allowlisted operations without exposing raw CDP.
3. **Unified `protocol_muse` Python Package**:
- Packaged `packages/protocol-muse/` providing `MuseClient` unifying Noise protocol gateway (`wss://gateway.muse.ai/v1/noise`) with HTTPS Chromebox fallback.
- Built and pre-cached wheels in `~/workspace/wheels/` (`protocol_muse-0.1.0-py3-none-any.whl`).
- Integrated offline wheel installation (`pip install --no-index --find-links=~/workspace/wheels protocol_muse`) into `cloud-uptime/recover-after-rebuild.sh`.
4. **Pull Request & Provenance**:
- Feature branch `builder/gitea-chromebox-protocol-muse` pushed to Gitea.
- Gitea Pull Request #219 opened targeting `master`.
## 2. Verification Records
- `tests/test_protocol_muse.py`: 7/7 passed.
- `tests/test_chromebox_gateway_queue.py`: 3/3 passed.
- `tests/test_box_gitea_bridge.py`: 5/5 passed.
- `tests/test_recover_after_rebuild.py`: 4/4 passed.
- Live HTTPS assertions on `https://100.123.153.75:8445/api/v1/queue` and `http://127.0.0.1:3000` verified 200 OK with expected payloads.