mathias/hyperguild
1
0
Fork 0
Code Issues 30 Pull Requests 3 Actions Packages Projects Releases Wiki Activity

plan-7: write + execute supervisor MCP retirement (skill surface lives in routing now) #26

New Issue
Closed
opened 2026-05-21 21:25:58 +00:00 by mathias · 1 comment
mathias commented 2026-05-21 21:25:58 +00:00
Owner
Copy Link
Copy Source

Background

Mode 2 (client-local) of hyperguild's three-mode routing is live and serving 5 MCP tools from gitea.d-ma.be/mathias/routing at routing-mcp.d-ma.be — see infra commit a0f2d39 and docs/superpowers/handoffs/2026-05-21-routing-mcp-consumers.md for the audit.

The supervisor pod still ships the old skill surface (full set including tdd_red/green/refactor, spec, tier) on :30320 plus the ingestion service on :30330. Supervisor was always scheduled for retirement once Mode 2 stabilized — that's the forward-reference Plan 7 in 2026-05-04-mode-2-routing-pod-design.md.

This issue tracks writing that Plan 7 and executing it.

Scope

Retire the supervisor MCP (the skill-worker half), keep the ingestion service (the brain-write half).

In scope:

  • Delete the supervisor binary's MCP-server code path
  • Delete the supervisor manifests that expose :30320
  • Delete internal/skills/{tdd,spec}/ — these were supervisor-only, never adopted by the routing pod. The note in the Mode 2 spec is explicit that only these two skill packages are removed; internal/skills/{review,debug,retrospective,trainer}/ are reused by routing and must stay.
  • Free NodePort :30320
  • Update any per-project .mcp.json files that still point at koala:30320 to point at routing (koala:30310 / https://routing-mcp.d-ma.be).

Out of scope:

  • ingestion service itself (the brain pod at :30330 / brain-mcp.d-ma.be). Stays.
  • Mode 1 (cloud) and Mode 3 (sovereign) plumbing.
  • Any changes to the routing pod itself (Plan 6 already shipped).

Acceptance criteria

  • Plan 7 document written in ~/dev/AGENTS/hyperguild/docs/superpowers/plans/2026-05-supervisor-retirement.md covering the scope above plus rollback steps
  • Supervisor MCP code path removed from the supervisor binary
  • internal/skills/{tdd,spec}/ packages deleted
  • internal/skills/{review,debug,retrospective,trainer}/ packages explicitly preserved (per Mode 2 spec's constraint)
  • Infra manifests under k3s/apps/supervisor/ no longer expose :30320
  • Search for any .mcp.json consumers of :30320 / supervisor MCP, migrate them to routing
  • After deploy: flux get kustomizations Ready=True, curl :30320/healthz returns connection-refused, routing :30310 tools/list still returns the 5 tools
  • Brain ingestion at :30330 still healthy (separate concern; should be unaffected)

Cross-references

  • 2026-05-04-mode-2-routing-pod-design.md — Plan 6 spec, the constraint "internal/skills/{review,debug,retrospective,trainer}/ survives Plan 6", and the forward reference to Plan 7
  • docs/superpowers/handoffs/2026-05-21-routing-mcp-consumers.md — audit of current routing-mcp surface
  • docs/superpowers/specs/2026-05-homelab-architecture-review.md — routing's KEEP decision references Plan 7 completion

Note

This is a hyperguild-repo concern with a small infra-repo trailing edge (delete supervisor's MCP manifests once the binary stops serving). File a corresponding infra issue when Plan 7 is ready to start; the manifest delete is a separate small commit on mathias/infra.

## Background Mode 2 (`client-local`) of hyperguild's three-mode routing is live and serving 5 MCP tools from `gitea.d-ma.be/mathias/routing` at `routing-mcp.d-ma.be` — see infra commit `a0f2d39` and `docs/superpowers/handoffs/2026-05-21-routing-mcp-consumers.md` for the audit. The `supervisor` pod still ships the old skill surface (full set including `tdd_red/green/refactor`, `spec`, `tier`) on `:30320` plus the ingestion service on `:30330`. Supervisor was always scheduled for retirement once Mode 2 stabilized — that's the forward-reference Plan 7 in `2026-05-04-mode-2-routing-pod-design.md`. This issue tracks writing that Plan 7 and executing it. ## Scope Retire the supervisor MCP (the skill-worker half), keep the ingestion service (the brain-write half). In scope: - Delete the supervisor binary's MCP-server code path - Delete the supervisor manifests that expose `:30320` - Delete `internal/skills/{tdd,spec}/` — these were supervisor-only, never adopted by the routing pod. The note in the Mode 2 spec is explicit that **only** these two skill packages are removed; `internal/skills/{review,debug,retrospective,trainer}/` are reused by routing and must stay. - Free NodePort `:30320` - Update any per-project `.mcp.json` files that still point at `koala:30320` to point at routing (`koala:30310` / `https://routing-mcp.d-ma.be`). Out of scope: - ingestion service itself (the brain pod at `:30330` / `brain-mcp.d-ma.be`). Stays. - Mode 1 (cloud) and Mode 3 (sovereign) plumbing. - Any changes to the routing pod itself (Plan 6 already shipped). ## Acceptance criteria - [ ] Plan 7 document written in `~/dev/AGENTS/hyperguild/docs/superpowers/plans/2026-05-supervisor-retirement.md` covering the scope above plus rollback steps - [ ] Supervisor MCP code path removed from the supervisor binary - [ ] `internal/skills/{tdd,spec}/` packages deleted - [ ] `internal/skills/{review,debug,retrospective,trainer}/` packages explicitly preserved (per Mode 2 spec's constraint) - [ ] Infra manifests under `k3s/apps/supervisor/` no longer expose `:30320` - [ ] Search for any `.mcp.json` consumers of `:30320` / `supervisor` MCP, migrate them to routing - [ ] After deploy: `flux get kustomizations` Ready=True, `curl :30320/healthz` returns connection-refused, `routing :30310 tools/list` still returns the 5 tools - [ ] Brain ingestion at `:30330` still healthy (separate concern; should be unaffected) ## Cross-references - `2026-05-04-mode-2-routing-pod-design.md` — Plan 6 spec, the constraint "internal/skills/{review,debug,retrospective,trainer}/ survives Plan 6", and the forward reference to Plan 7 - `docs/superpowers/handoffs/2026-05-21-routing-mcp-consumers.md` — audit of current routing-mcp surface - `docs/superpowers/specs/2026-05-homelab-architecture-review.md` — routing's KEEP decision references Plan 7 completion ## Note This is a hyperguild-repo concern with a small infra-repo trailing edge (delete supervisor's MCP manifests once the binary stops serving). File a corresponding infra issue when Plan 7 is ready to start; the manifest delete is a separate small commit on `mathias/infra`.
mathias commented 2026-05-22 05:10:30 +00:00
Author
Owner
Copy Link
Copy Source

Discovered 2026-05-22 during S1 spike that Plan 7 already shipped on 2026-05-12 — see ~/dev/AGENTS/hyperguild/CLAUDE.md (the file itself documents the retirement).

Current state verifies:

  • cmd/supervisor/ no longer exists in the hyperguild repo (only cmd/hyperguild and cmd/routing).
  • internal/skills/{tdd,spec}/ no longer exists (per the Plan 7 spec; tdd + spec moved to SKILL.md files).
  • internal/skills/ retains brain, debug, org, project, retrospective, review, sessionlog, trainer — all reused by routing or the brain MCP.
  • supervisor k8s namespace hosts only the ingestion service now. No :30320 listener; supervisor-MCP deployment manifests are gone.
  • Only lingering :30320 references are in historical context files (.aider.conventions.md, AGENTS.md, .context/PROJECT.md, .cursorrules, system-prompt.txt). None are active manifests.

Closing as already-done. The five context-file mentions of :30320 are stale text and worth a small cleanup pass in a follow-up commit, but not load-bearing — the actual binary, manifests, and skills are gone.

Discovered 2026-05-22 during S1 spike that Plan 7 already shipped on 2026-05-12 — see `~/dev/AGENTS/hyperguild/CLAUDE.md` (the file itself documents the retirement). Current state verifies: - `cmd/supervisor/` no longer exists in the hyperguild repo (only `cmd/hyperguild` and `cmd/routing`). - `internal/skills/{tdd,spec}/` no longer exists (per the Plan 7 spec; `tdd` + `spec` moved to SKILL.md files). - `internal/skills/` retains brain, debug, org, project, retrospective, review, sessionlog, trainer — all reused by routing or the brain MCP. - supervisor k8s namespace hosts only the ingestion service now. No `:30320` listener; supervisor-MCP deployment manifests are gone. - Only lingering `:30320` references are in historical context files (`.aider.conventions.md`, `AGENTS.md`, `.context/PROJECT.md`, `.cursorrules`, `system-prompt.txt`). None are active manifests. Closing as already-done. The five context-file mentions of `:30320` are stale text and worth a small cleanup pass in a follow-up commit, but not load-bearing — the actual binary, manifests, and skills are gone.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
agent/ready
Meets the agent-ready contract; authorizes unattended execution
 blocked/client
Waiting on the client
 blocked/supplier
Waiting on a supplier
 blocked/upstream
Waiting on an upstream project or vendor
 risk/high
Irreversible, security-relevant, or control plane
 risk/low
Reversible, local, test-covered
 risk/medium
Touches shared state, deploys or data
 size/l
Too big - split it
 size/m
Under two days
 size/s
Under half a day
 size/xs
Under an hour
 status:dispatch
status:dispatched
status:review
status:reviewing
type/chore
Maintenance, no behaviour change
 type/decision
Human decision required; never agent/ready
 type/docs
Documentation only
 type/feat
New capability
 type/fix
Corrects broken behaviour
 type/ops
Infrastructure, deploy, runtime
 type/research
Investigate; output is a finding, not code
 type/test
Test coverage only
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
renovate-bot mathias
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mathias/hyperguild#26