janpeter/scrum4me-workers

Fork 0

docs: Fase B — permanente intern-only HTTP-MCP (spec + plan) #42

Merged

janpeter merged 6 commits from claude/mcp-http-permanent into main

2026-06-10 19:07:45 +02:00

janpeter commented

2026-06-10 14:36:57 +02:00

Owner

Summary

Design-spec + implementatieplan voor Fase B: de scrum4me-mcp HTTP-server permanent en betrouwbaar beschikbaar maken voor de /mcp-tester admin-UI, als intern-only docker-compose-service.

docs/superpowers/specs/2026-06-08-mcp-http-permanent-design.md (v0.2, approved) — intern-only service scrum4me-mcp-http op een privé mcp-internal-netwerk (alleen workers + mcp-http + postgres), géén Caddy/Tailscale/host-poort. Lost de bewuste 2026-05-25 retirement-reden op ("global tailnet/HTTP endpoint unwanted"). http.ts graceful-shutdown hardening; mcp-http gebruikt exact dezelfde DATABASE_URL als workers; default-token audit-tradeoff gedocumenteerd.
docs/superpowers/plans/2026-06-08-mcp-http-permanent.md — 4 taken: http.ts graceful-shutdown+seam (TDD), compose-service (Ops-dashboard), workers .env.example prod-hint, deploy via s4m-queue → scrum4me-server:claude.

Beide doorliepen een cross-model review-loop (codex op mac): spec NO-GO → GO, plan NO-GO → GO.

Scope

Alleen documentatie (spec + plan). Geen code/infra-wijziging in deze PR.
Uitvoering is cross-repo (scrum4me-mcp + Ops-dashboard + workers) + server-deploy en volgt als aparte PRs/taken.

Test Plan

Spec + plan codex-GO (cross-model review).
Uitvoering (apart): http.ts-test groen; docker compose config valideert de service; end-to-end DB-consistentie (list_products == comboboxdata).

Vervolg op de eerdere /mcp-tester-PR (#35, gemerged); zie spec §7 Fase B daarvan.

🤖 Generated with Claude Code

## Summary Design-spec + implementatieplan voor **Fase B**: de scrum4me-mcp HTTP-server permanent en betrouwbaar beschikbaar maken voor de `/mcp-tester` admin-UI, als **intern-only** docker-compose-service. - **`docs/superpowers/specs/2026-06-08-mcp-http-permanent-design.md`** (v0.2, approved) — intern-only service `scrum4me-mcp-http` op een privé `mcp-internal`-netwerk (alleen workers + mcp-http + postgres), géén Caddy/Tailscale/host-poort. Lost de bewuste 2026-05-25 retirement-reden op ("global tailnet/HTTP endpoint unwanted"). `http.ts` graceful-shutdown hardening; mcp-http gebruikt exact dezelfde `DATABASE_URL` als workers; default-token audit-tradeoff gedocumenteerd. - **`docs/superpowers/plans/2026-06-08-mcp-http-permanent.md`** — 4 taken: `http.ts` graceful-shutdown+seam (TDD), compose-service (Ops-dashboard), workers `.env.example` prod-hint, deploy via s4m-queue → `scrum4me-server:claude`. Beide doorliepen een cross-model review-loop (codex op mac): **spec NO-GO → GO**, **plan NO-GO → GO**. ## Scope - **Alleen documentatie** (spec + plan). Geen code/infra-wijziging in deze PR. - Uitvoering is cross-repo (scrum4me-mcp + Ops-dashboard + workers) + server-deploy en volgt als aparte PRs/taken. ## Test Plan - [x] Spec + plan codex-GO (cross-model review). - [ ] Uitvoering (apart): `http.ts`-test groen; `docker compose config` valideert de service; end-to-end DB-consistentie (`list_products` == comboboxdata). Vervolg op de eerdere `/mcp-tester`-PR (#35, gemerged); zie spec §7 Fase B daarvan. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

janpeter added 6 commits

2026-06-10 14:36:57 +02:00

docs(specs): Fase B — permanente intern-only HTTP-MCP (design v0.1) 6684ae259c

Intern-only docker-compose-service scrum4me-mcp-http op scrum4me-server,
alleen bereikbaar door de workers-admin-UI (geen Caddy/Tailscale-expose),
lost de 2026-05-25 retirement-reden op. + http.ts graceful-shutdown hardening,
workers MCP_HTTP_URL/MCP_DEFAULT_TOKEN. Cross-repo (mcp/ops-dashboard/workers).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(specs): Fase B spec v0.2 — verwerk codex-review (NO-GO → fixes) 005d065c7e

- (Critical) DB-target hard vastgelegd: identieke DATABASE_URL als workers (K5/§6.3)
  + deploy-verificatie list_products == comboboxdata (§8)
- (Important) privé mcp-internal-netwerk (workers+mcp-http+postgres); topologie-claim
  gecorrigeerd (§5.1/§6.2/K2)
- (Minor) http.ts test-seam startHttpServer() + closeAllConnections vóór exit (§6.1/§8)
- (Minor) default-token audit-tradeoff expliciet (§6.3/§9)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(specs): Fase B spec — codex GO (ronde 2); status approved c0e665cd9d

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(plans): Fase B implementatieplan — permanente intern-only HTTP-MCP 43725fb337

4 taken: http.ts graceful-shutdown+seam (TDD), compose-service scrum4me-mcp-http op
privé mcp-internal-netwerk (Ops-dashboard), workers .env.example prod-hint, deploy via
s4m-queue. Op basis van spec v0.2 (codex GO).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(plans): Fase B plan v2 — verwerk codex plan-review (NO-GO → fixes) 3922a6363a

- (Important) Task 4: pas compose toe op canonieke host-locatie
  /srv/scrum4me/compose/docker-compose.yml + config-check vóór build
- (Minor) Task 2: structurele docker-compose-config check i.p.v. raw-grep

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs(plans): Fase B plan — codex GO (ronde 2); hardstop checkt ook mcp-internal bc42b3f3f6

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

janpeter merged commit 103cf75d44 into main

2026-06-10 19:07:45 +02:00

janpeter deleted branch claude/mcp-http-permanent

2026-06-10 19:07:45 +02:00

janpeter referenced this pull request from a commit

2026-06-10 19:07:46 +02:00

Merge pull request 'docs: Fase B — permanente intern-only HTTP-MCP (spec + plan)' (#42) from claude/mcp-http-permanent into main

No reviewers

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

janpeter/scrum4me-workers!42

No description provided.

Rows
Columns