Skip to content

feat(sandbox): mvnw-fallback in Maven MCP-agent + README split#26

Merged
mreuvekamp merged 2 commits into
mainfrom
sandbox/mvnw-fallback-and-docs
May 13, 2026
Merged

feat(sandbox): mvnw-fallback in Maven MCP-agent + README split#26
mreuvekamp merged 2 commits into
mainfrom
sandbox/mvnw-fallback-and-docs

Conversation

@ericwout-overheid
Copy link
Copy Markdown
Collaborator

Summary

  • mvnw-fallback in de Maven MCP-host-agent: gebruikt ./mvnw als die executable bestaat in PROJECT_DIR, anders mvn op PATH. Geen Maven-host-installatie meer nodig voor projecten met een wrapper.
  • Reconnect-hint bij stale MCP-sessie: logging-filter in de agent vult de SDK-warning Received request before initialization was complete aan met een actionable tip (én een waarschuwing om in /mcp géén Authenticate te kiezen — deze server heeft geen auth-laag, wat eindigt in een verwarrende 404 / JSON parse error).
  • README opgesplitst naar claude-sandbox/docs/:
    • maven-mcp-agent.md — incl. troubleshooting voor host-firewall (UFW/firewalld blokkeert poort 7777 van Docker-bridge), de OAuth-404 bij Authenticate, en JAVA_HOME-noot bij host-agent start.
    • opstarten-en-afsluiten.md — Opstarten, Na installatie en Afsluiten secties.
  • README ingekort van 366 → 149 regels; Quick start verwijst via een bullet-lijst naar de docs en de Firewall-sectie.

Test plan

  • Host-agent draait tegen een project met mvnw en gebruikt die (zichtbaar in proces-tree / Maven-output).
  • Host-agent zonder mvnw valt terug op mvn op PATH.
  • Na een agent-herstart verschijnt de reconnect-tip in het agent-log bij de eerstvolgende stale request.
  • README-links naar docs/... werken in GitHub-rendering.
  • Anchor-link [Optionele componenten](docs/opstarten-en-afsluiten.md#optionele-componenten) werkt vanuit de README.
  • Linux Docker met compose.override.yml (host-gateway) + UFW-regel op compose-bridge-subnet → host.docker.internal:7777 bereikbaar.

🤖 Generated with Claude Code

- maven_agent.py: gebruik ./mvnw als die executable bestaat in
  PROJECT_DIR; anders fallback naar `mvn` op PATH. Maven hoeft dan niet
  meer op de host geïnstalleerd te zijn voor projecten met een wrapper.
- maven_agent.py: logging-filter dat de SDK-warning "Received request
  before initialization was complete" aanvult met een reconnect-hint
  (en de waarschuwing om in /mcp NIET 'Authenticate' te kiezen — deze
  server heeft geen auth-laag, dat eindigt in een 404).
- docs/maven-mcp-agent.md (nieuw): Maven MCP-sectie verplaatst uit
  README; troubleshooting (UFW/firewalld op host, OAuth-404) en
  JAVA_HOME-noot toegevoegd.
- docs/opstarten-en-afsluiten.md (nieuw): Opstarten / Na installatie /
  Afsluiten verplaatst uit README.
- README: ingekort van 366 naar 149 regels; Quick start verwijst via
  een bullet-lijst naar de docs en de Firewall-sectie.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mreuvekamp mreuvekamp merged commit 5c1815f into main May 13, 2026
9 checks passed
@mreuvekamp mreuvekamp deleted the sandbox/mvnw-fallback-and-docs branch May 13, 2026 09:13
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.

2 participants