Skip to content

Gui: Add IntentFrame Control Plane (port 9720) with operator UI and Docker test harness#7

Merged
maniotrix merged 7 commits into
mainfrom
gui
Jun 28, 2026
Merged

Gui: Add IntentFrame Control Plane (port 9720) with operator UI and Docker test harness#7
maniotrix merged 7 commits into
mainfrom
gui

Conversation

@maniotrix

Copy link
Copy Markdown
Member

Summary

  • Introduces a standalone IntentFrame Control Plane on port 9720 — separate from Hermes chat (9119) — with a React operator UI (Overview, Governance, Policy, Audit) and FastAPI backend under intentframe-control-plane/.
  • Adds CLI lifecycle commands: intentframe-integrations control-plane start|stop|status|serve, plus --json on status/governance/policy reads.
  • Updates the installer to build the frontend, seed ~/.intentframe/.env, and start the control plane by default (--no-control-plane for CI/Docker).
  • Extends the Docker harness (tests/docker/) to publish 9720 and 9119, seed Docker config, start the control plane, then bring up Hermes enforcement + dashboard.
  • Fixes control-plane health checks that could deadlock or falsely report unhealthy on single-worker uvicorn (loopback probe for 0.0.0.0, lightweight /api/health, in-process status skips self HTTP probe).

Test plan

  • uv run --package intentframe-control-plane python tests/intentframe_control_plane/test_lifecycle.py
  • uv run --package intentframe-control-plane python tests/intentframe_control_plane/test_read_models.py
  • uv run --package intentframe-control-plane python tests/intentframe_control_plane/test_server.py
  • Local: intentframe-integrations control-plane start → open http://127.0.0.1:9720 → Overview shows UI server: healthy
  • Docker: REF=gui docker compose -f tests/docker/docker-compose.test.yml uphttp://localhost:9720 healthy, http://localhost:9119/chat loads
  • Optional smoke: tests/docker/test_control_plane_smoke.sh
  • CLI: intentframe-integrations control-plane status reports running + healthy from an external shell

@maniotrix maniotrix merged commit 2aed945 into main Jun 28, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant