build

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Purpose

This command is the local development loop. It compiles, tests, and runs the service locally so you can iterate quickly. No Docker images are built, no containers are pushed, no platform deployments happen. When the service works locally and you're ready to ship, hand off to /akka-specify:deploy.

Outline

1. Compile: Use the akka_maven_compile MCP tool to compile the project. If compilation fails, the tool returns extracted [ERROR] lines — read them, report to the user, and fix the code before proceeding.

2. Test: Use the akka_maven_test MCP tool to run all tests. If tests fail:

   • The tool returns test failure details and [ERROR] lines
   • Report which tests failed and why
   • Suggest fixes based on the failure messages
   • Stop and hand off to /akka-specify:implement for fixes

3. Start local environment: Use the akka_local_start MCP tool to start the local development environment in the background. Tell the user that the local runtime is starting — it provides gRPC proxying, service discovery, trace collection and the local console on localhost:9889 (this is not the service port). This is idempotent — if already running, tell the user it is already active and report its status.

4. Run the service: Use akka_local_run_service to start the service locally. This tool compiles first (catching errors immediately), then runs mvn exec:java in the background. Tell the user the service is launching against the local runtime.

   • Pass the environment parameter to set additional environment variables (e.g. {"LOG_LEVEL": "DEBUG", "DB_HOST": "localhost"}). These are merged with the current environment — useful for config overrides, debug flags, or connecting to external services during local development.

5. Verify: Use akka_local_status to confirm the service registered. Use akka_local_logs with source: "service" to check for runtime errors. The service serves its HTTP endpoints on its own port, typically localhost:9000 — confirm the actual port from akka_local_status or the service logs rather than assuming it. Test endpoints there, not on 9889. Tell the user the service endpoint URL and whether it started successfully.