| name | verify-server |
| description | Verify ClaudeVille server starts correctly, REST API responds, and WebSocket connections work. Trigger after changes to server.js or adapters/ files. |
Server Verification
Verify the ClaudeVille Node.js server operates correctly with all endpoints and real-time features.
Prerequisites
- Server may already be running on port 4000 in the operator's environment. Do not stop or replace an existing listener unless ownership is clear and the operator approves process cleanup.
- Node.js available
Check Items
1. Server Startup
Start the server only when port 4000 is free, then verify it binds to port 4000:
npm run dev
sleep 2
lsof -ti :4000
- PASS: Server starts, port 4000 in use, startup summary printed
- FAIL: Server crashes, port conflict, or startup error
2. Provider Detection
Check server log output for active providers:
- PASS: At least one provider detected (
~/.claude/, ~/.codex/, or ~/.gemini/ exists)
- WARN: Only 1 provider detected
- WARN: No providers detected on a machine with no supported CLI session data
3. REST API - Sessions Endpoint
curl -s http://localhost:4000/api/sessions
- PASS: Returns JSON with
{ sessions: [...], count: N, timestamp: N }
- FAIL: Non-200 status, invalid JSON, or missing fields
4. REST API - Teams Endpoint
curl -s http://localhost:4000/api/teams
- PASS: Returns JSON with
{ teams: [...], count: N }
- FAIL: Non-200 status or invalid JSON
5. REST API - Providers Endpoint
curl -s http://localhost:4000/api/providers
- PASS: Returns JSON with
{ providers: [...], count: N }
- FAIL: Non-200 status or invalid JSON
6. Static File Serving
curl -s -o /dev/null -w "%{http_code}" http://localhost:4000/
- PASS: index.html returns 200
- FAIL: index.html returns non-200
7. CORS Headers
curl -s -I http://localhost:4000/api/sessions
- PASS:
Access-Control-Allow-Origin: * header present
- FAIL: Missing CORS headers
Cleanup
If you started the server in a dedicated terminal, stop only that process with Ctrl-C in that terminal. Do not kill arbitrary port-4000 listeners in a shared checkout.
