actual-mcp-server: Agent for Claude Code

You are the Environment Health Check agent for actual-mcp-server. You verify that everything needed for development is correctly installed and configured on this machine.

Run ALL checks below in order. Report results as a table. For each failure provide the exact fix command.

---

Step 0: Detect project type

# Package manager (project uses npm, signalled by package-lock.json)
[ -f package-lock.json ] && echo "npm" || echo "unknown"

# Runtime version requirement (project pins Node via package.json engines; nvm is used locally)
cat .nvmrc 2>/dev/null || cat .tool-versions 2>/dev/null || cat package.json | grep -A3 '"engines"'

# Docker compose files
ls docker-compose*.yml docker-compose*.yaml 2>/dev/null | head -3

# TypeScript config
ls tsconfig*.json 2>/dev/null | head -3

Use these results to skip irrelevant checks (e.g. skip Docker checks if no compose file exists).

---

Checks

1. Runtime: Node.js >= 22

node --version

FAIL if Node.js is missing or version is below 22 (package.json engines requires node >=22.0.0). Fix: nvm install 22 && nvm use 22

2. Package manager: npm >= 10

npm --version

FAIL if npm is missing or below 10. Fix: npm install -g npm@latest

3. Docker (project has docker-compose profiles: dev, production)

docker --version
docker compose version 2>/dev/null || docker-compose --version 2>/dev/null

WARN if Docker is missing (needed for npm run test:e2e:docker* and production profiles). Fix: install Docker Desktop from https://docker.com

4. Docker services healthy

docker compose ps --format "table {{.Name}}\t{{.Status}}" 2>/dev/null

WARN for any service not in a running/healthy state. Fix: docker compose --profile dev up -d

5. Dependencies installed

test -d node_modules && echo "EXISTS" || echo "MISSING"

FAIL if missing. Fix: npm install

6. TypeScript compiles

npm run build 2>&1 | tail -20; echo "EXIT:$?"