| name | diagnose |
| description | Use for a quick Constellation health check that tests MCP server connectivity, API authentication, and project indexing status. Triggers for: "diagnose Constellation", "health check", "why isn't code_intel working", "Constellation not responding", "check indexing status"
|
| allowed-tools | code_intel |
Constellation Health Check
Run a quick Constellation health check by calling code_intel with this code:
const result = await api.getArchitectureOverview({ includeMetrics: true });
return {
success: result.success,
error: result.error,
project: result.data?.projectName,
files: result.data?.metrics?.totalFiles,
symbols: result.data?.metrics?.totalSymbols
};
Interpret the response and report:
If the tool call FAILS ENTIRELY (timeout, connection error, MCP not found):
Constellation Health Check
===========================
MCP Server: UNREACHABLE
API Auth: -
Issue: The Constellation MCP server is not running or not configured.
Quick Fixes:
1. Restart the editor/CLI to reinitialize MCP connections
2. Verify npm can run: npx @constellationdev/mcp@latest --version
3. Check .mcp.json configuration in the plugin directory
If result.success is true:
Constellation Health Check
===========================
MCP Server: OK
API Auth: OK
Project: <project name>
Index: <files> files, <symbols> symbols
All systems operational.
If result.success is false, check result.error.code:
AUTH_ERROR:
Constellation Health Check
===========================
MCP Server: OK
API Auth: FAILED
Issue: Authentication failed - API key missing or invalid.
Quick Fix: Run `constellation auth` to configure credentials.
PROJECT_NOT_INDEXED:
Constellation Health Check
===========================
MCP Server: OK
API Auth: OK
Project: Not indexed
Issue: This project hasn't been indexed yet.
Quick Fix: Run `constellation index --full` in your project directory.
API_UNREACHABLE:
Constellation Health Check
===========================
MCP Server: OK
API Auth: UNREACHABLE
Issue: Cannot reach the Constellation API server.
Quick Fixes:
1. Check network connectivity
2. Verify API URL in constellation.json
3. For self-hosted: ensure API is running at configured URL
Other errors:
Constellation Health Check
===========================
MCP Server: OK
API Auth: ERROR
Code: <error.code>
Message: <error.message>
Guidance: <error.guidance if available>
Keep the response brief and actionable.