diagnose

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.