Skip to content

refactor(opencode): route MCP integrations through gateway aggregate - #97

Merged
xnoto merged 3 commits into
mainfrom
refactor/opencode-mcp-service-names
Sep 12, 2026
Merged

refactor(opencode): route MCP integrations through gateway aggregate#97
xnoto merged 3 commits into
mainfrom
refactor/opencode-mcp-service-names

Conversation

@xnoto

@xnoto xnoto commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Routes OpenCode MCP integrations through one internal makeitwork gateway aggregate entry, retaining only direct agent-pipe, GitHub, hero-SSH, and codebase-memory connections. Documents aggregate tool naming, updates affected packaged skills, and bumps immutable opencode-server from 0.1.74 to 0.1.75.

Fixes #
N/A — owner-approved MCP aggregate consolidation.

Type of change

  • Feature / enhancement
  • Bug fix
  • Documentation
  • Infrastructure (OpenTofu root or module)
  • GitOps desired state (manifests, kustomize, charts, SOPS/KSOPS secrets)
  • Container image
  • CI / reusable workflow
  • Refactor / cleanup
  • Breaking change

Validation

  • Required pull-request checks pass — pending: repository hygiene, Helm validation, changed-chart detection, and opencode-server packaging.
  • Generated or centrally distributed files were regenerated by their owning automation, not hand-edited — ConfigMap contents are chart-packaged through Helm .Files.Glob; no generated source was edited.
  • Chart content versioned from 0.1.74 to 0.1.75.
  • Exact changed files were manually inspected for sensitive material; no secret values, decrypted SOPS content, tokens, kubeconfigs, or state were added.

Impact and rollout

Producer: immutable OCI package ghcr.io/makeitworkcloud/charts/opencode-server:0.1.75; consumer: the opencode GitOps Application selected by post-publish automation.

Prerequisite: merge/reconcile kustomize-cluster gateway refactor first. It establishes clean aggregate member names and adds Cloudflare, Playwright, and Twilio documentation before this chart switches to vmcp-gateway.

Owner-accepted cutover: the live 0.1.74 chart targets generated direct Services that the gateway refactor removes, so affected MCP integrations are temporarily unavailable between the GitOps reconciliation and this chart rollout. After a separately confirmed merge, the main workflow publishes 0.1.75 and opens/updates the GitOps pin PR; that PR, Argo reconciliation, pod health, aggregate tool discovery, and representative agent calls remain separate gates.

Rollback is paired with the gateway refactor: reselect/publish a chart compatible with restored direct Service names and revert the gateway change together; do not roll back either side in isolation.

Safety and secrets

  • Contains no plaintext secrets, decrypted SOPS values, state files, kubeconfigs, tokens, or private endpoints
  • No local OpenTofu init/plan/apply/destroy/import/state operations were run or claimed — plans come from pull-request checks
  • Breaking or irreversible effects are described above with rollback notes

AI-assisted change; reviewer scrutiny requested for aggregate tool naming and staged GitOps delivery.

…nal gateway aggregate

Replace the per-integration direct service entries (apify, argocd, aws,
aws-docs, cloudflare, context7, grafana, kubernetes, parallel-search,
playwright, slidespeak, terraform-docs) and the direct twilio-docs URL in
files/opencode.json with one makeitwork entry pointing at the in-cluster
vmcp-gateway aggregate endpoint (http://vmcp-gateway.mcp.svc:4483/mcp);
aggregate tools surface as makeitwork_<integration>_<tool>. Keep
agent-pipe, github, hero-ssh, and codebase-memory as direct per-backend
entries (chart-local or intentionally non-aggregated). Update exact tool
and member references in the s3-presigned-file-delivery,
career-external-documents, and twilio-docs-troubleshooting skills, revise
the README MCP routing/Cloudflare/Twilio/SlideSpeak/prerequisite guidance,
and bump the chart version to 0.1.75 for the changed packaged content.
…ated Cloudflare/Twilio/SlideSpeak delivery

Add an MCP routing section documenting the single internal makeitwork
aggregate entry (makeitwork_<integration>_<tool> tool naming) and the four
remaining direct per-backend entries; rewrite the Cloudflare and Twilio
documentation MCP sections for aggregate delivery (read-only token
boundary; public-docs-only proxy with no credentials); and update the
prerequisites and SlideSpeak paragraphs to name the vmcp-gateway aggregate
Service.
…ate MCP in AGENTS.md; record outage/rollback acceptance

Correct the aggregate AWS tool example to makeitwork_aws_aws___get_presigned_url
(the aws member's upstream tools already carry their own aws___ prefix) in the
README MCP routing section and the s3-presigned-file-delivery skill. Update the
charts root AGENTS.md session boundary to route aggregate tools through the
single makeitwork gateway entry (makeitwork_<integration>_<tool>) while
distinguishing the four direct integrations (agent-pipe, github, hero-ssh,
codebase-memory). Record the 2026-09-11 owner acceptance of the temporary
OpenCode integration outage and the paired rollback requirement for the 0.1.75
aggregate cutover in the README delivery lifecycle. Skill content is packaged
chart content already covered by the unpublished 0.1.75 version bump; no
additional bump required.
@github-actions

Copy link
Copy Markdown

Chart CI passed

Repository hygiene and Helm validation passed. View the workflow run.

@xnoto
xnoto merged commit d02cfba into main Sep 12, 2026
4 checks passed
@xnoto
xnoto deleted the refactor/opencode-mcp-service-names branch September 12, 2026 17:17
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