@local-labs-jpollock/local-addon-nexus-ai 0.1.14 → 0.2.1

package/README.md

@@ -237,11 +237,13 @@ Install the CLI, which automatically downloads and installs the addon for your p
 # Install CLI globally
 npm install -g @local-labs-jpollock/local-addon-nexus-ai
 
-# Run any command to trigger auto-install
-nexus sites list
+# Verify everything is working
+nexus doctor
 ```
 
-**What happens:**
+`nexus doctor` checks Local, the addon, MCP server, AI provider, and site configuration — and prints the exact next step for anything that needs attention.
+
+**What the first run does:**
 1. CLI detects the addon is missing
 2. Prompts: "Download and install addon for macOS (Apple Silicon)? (Y/n)"
 3. Downloads the correct platform-specific addon from GitHub Releases
@@ -249,6 +251,14 @@ nexus sites list
 5. Activates the addon automatically
 6. Prompts you to restart Local
 
+**After restarting Local, connect your AI agent:**
+
+```bash
+nexus mcp setup   # configure Claude Code, Cursor, Claude Desktop, etc.
+```
+
+This is the fastest path to value — no API key required.
+
 **Supported platforms:**
 - macOS (Apple Silicon) - `darwin-arm64`
 - macOS (Intel) - `darwin-x64`

package/lib/cli/bootstrap/graphql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../../src/cli/bootstrap/graphql.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAoB1D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,GAAE,MAAc,EACzB,cAAc,GAAE,MAAY,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoClB"}
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../../src/cli/bootstrap/graphql.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAwB1D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,GAAE,MAAc,EACzB,cAAc,GAAE,MAAY,GAC3B,OAAO,CAAC,OAAO,CAAC,CAiDlB"}

package/lib/cli/bootstrap/graphql.js

@@ -51,10 +51,13 @@ function readConnectionInfo() {
         }
         const content = fs.readFileSync(paths.graphqlConnectionInfoFile, 'utf-8');
         const info = JSON.parse(content);
+        // Local's connection file sometimes has stale ports - default to port 4000
+        const defaultUrl = 'http://127.0.0.1:4000/graphql';
+        const defaultPort = 4000;
         return {
-            url: info.url || `http://127.0.0.1:${info.port}/graphql`,
-            subscriptionUrl: info.subscriptionUrl || `ws://127.0.0.1:${info.port}/graphql`,
-            port: info.port,
+            url: info.url || defaultUrl,
+            subscriptionUrl: info.subscriptionUrl || `ws://127.0.0.1:${info.port || defaultPort}/graphql`,
+            port: info.port || defaultPort,
             authToken: info.authToken || '',
         };
     }
@@ -70,26 +73,38 @@ async function waitForGraphQL(timeoutMs = 30000, pollIntervalMs = 500) {
     while (Date.now() - start < timeoutMs) {
         const connectionInfo = readConnectionInfo();
         if (connectionInfo) {
-            try {
-                // Use AbortController for per-request timeout (2 seconds)
-                const controller = new AbortController();
-                const requestTimeout = setTimeout(() => controller.abort(), 2000);
-                const response = await fetch(connectionInfo.url, {
-                    method: 'POST',
-                    headers: {
-                        'Content-Type': 'application/json',
-                        Authorization: `Bearer ${connectionInfo.authToken}`,
-                    },
-                    body: JSON.stringify({ query: '{ __typename }' }),
-                    signal: controller.signal,
-                });
-                clearTimeout(requestTimeout);
-                if (response.ok) {
-                    return true;
+            // Try both the URL from the connection file AND port 4000 as fallback
+            // (Local's connection file sometimes has stale ports)
+            const urlsToTry = [
+                connectionInfo.url,
+                'http://127.0.0.1:4000/graphql',
+            ];
+            for (const url of urlsToTry) {
+                try {
+                    // Use AbortController for per-request timeout (2 seconds)
+                    const controller = new AbortController();
+                    const requestTimeout = setTimeout(() => controller.abort(), 2000);
+                    const response = await fetch(url, {
+                        method: 'POST',
+                        headers: {
+                            'Content-Type': 'application/json',
+                            Authorization: `Bearer ${connectionInfo.authToken}`,
+                        },
+                        body: JSON.stringify({ query: '{ __typename }' }),
+                        signal: controller.signal,
+                    });
+                    clearTimeout(requestTimeout);
+                    if (response.ok) {
+                        // Update connection info to use the working URL
+                        if (url !== connectionInfo.url) {
+                            connectionInfo.url = url;
+                        }
+                        return true;
+                    }
+                }
+                catch {
+                    // Server not ready yet - connection refused, timeout, etc.
                 }
-            }
-            catch {
-                // Server not ready yet - connection refused, timeout, etc.
             }
         }
         await delay(pollIntervalMs);

package/lib/cli/bootstrap/graphql.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../../src/cli/bootstrap/graphql.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,gDAoBC;AAKD,wCAuCC;AA7ED,uCAAyB;AACzB,mCAAwC;AASxC;;GAEG;AACH,SAAgB,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAA,qBAAa,GAAE,CAAC;IAE9B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEjC,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,oBAAoB,IAAI,CAAC,IAAI,UAAU;YACxD,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,kBAAkB,IAAI,CAAC,IAAI,UAAU;YAC9E,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;SAChC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAClC,YAAoB,KAAK,EACzB,iBAAyB,GAAG;IAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,kBAAkB,EAAE,CAAC;QAE5C,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,0DAA0D;gBAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;gBAElE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE;oBAC/C,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,cAAc,CAAC,SAAS,EAAE;qBACpD;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;oBACjD,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBAEH,YAAY,CAAC,cAAc,CAAC,CAAC;gBAE7B,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;QACH,CAAC;QAED,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../../src/cli/bootstrap/graphql.ts"],"names":[],"mappings":"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"}

package/lib/cli/commands/doctor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * nexus doctor
+ *
+ * System health check and first-run orientation.
+ * Runs independently of bootstrap — each check is isolated and never crashes
+ * the overall command. Shows actionable next steps for anything that is missing.
+ *
+ * Usage:
+ *   nexus doctor          # human-readable report
+ *   nexus doctor --json   # machine-readable output
+ */
+import { Command } from 'commander';
+export declare const doctorCommand: Command;
+//# sourceMappingURL=doctor.d.ts.map

package/lib/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkcpC,eAAO,MAAM,aAAa,SAqCtB,CAAC"}

package/lib/cli/commands/doctor.js

@@ -0,0 +1,496 @@
+"use strict";
+/**
+ * nexus doctor
+ *
+ * System health check and first-run orientation.
+ * Runs independently of bootstrap — each check is isolated and never crashes
+ * the overall command. Shows actionable next steps for anything that is missing.
+ *
+ * Usage:
+ *   nexus doctor          # human-readable report
+ *   nexus doctor --json   # machine-readable output
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorCommand = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const process_1 = require("../bootstrap/process");
+const addon_1 = require("../bootstrap/addon");
+const graphql_1 = require("../bootstrap/graphql");
+const paths_1 = require("../bootstrap/paths");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+// Known AI agent config files — used to detect which agents are configured.
+const AGENT_CONFIG_PATHS = {
+    'Claude Desktop': () => process.platform === 'win32'
+        ? path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json')
+        : process.platform === 'darwin'
+            ? path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+            : path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json'),
+    'Cursor': () => path.join(os.homedir(), '.cursor', 'mcp.json'),
+    'Windsurf': () => path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json'),
+};
+const PROVIDER_LABELS = {
+    anthropic: 'Anthropic (Claude)',
+    openai: 'OpenAI (GPT)',
+    google: 'Google (Gemini)',
+    ollama: 'Ollama (local)',
+    'local-gateway': 'Local Gateway',
+};
+// ---------------------------------------------------------------------------
+// Status icons
+// ---------------------------------------------------------------------------
+const ICON = {
+    ok: '✅',
+    warn: '⚠️ ',
+    error: '❌',
+    skip: '⚪',
+    disabled: '○ ',
+};
+// ---------------------------------------------------------------------------
+// MCP helpers (duplicated from mcp.ts to keep doctor self-contained)
+// ---------------------------------------------------------------------------
+function getMcpConnectionInfoPath() {
+    const dir = process.platform === 'win32'
+        ? path.join(process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming'), 'Local')
+        : process.platform === 'darwin'
+            ? path.join(os.homedir(), 'Library', 'Application Support', 'Local')
+            : path.join(os.homedir(), '.config', 'Local');
+    return path.join(dir, 'nexus-ai-mcp-connection-info.json');
+}
+function loadMcpInfo() {
+    try {
+        const data = fs.readFileSync(getMcpConnectionInfoPath(), 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+async function isMcpServerLive(url, token) {
+    try {
+        const https = await Promise.resolve().then(() => __importStar(require('https')));
+        const http = await Promise.resolve().then(() => __importStar(require('http')));
+        const lib = url.startsWith('https') ? https : http;
+        return await new Promise((resolve) => {
+            const req = lib.get(`${url}/health`, { headers: { Authorization: `Bearer ${token}` }, timeout: 3000 }, (res) => resolve(res.statusCode === 200));
+            req.on('error', () => resolve(false));
+            req.on('timeout', () => { req.destroy(); resolve(false); });
+        });
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Individual checks (each returns CheckResult, never throws)
+// ---------------------------------------------------------------------------
+async function checkLocalInstalled() {
+    try {
+        const installed = (0, process_1.isLocalInstalled)();
+        return installed
+            ? { label: 'Local app', status: 'ok', detail: 'Installed' }
+            : { label: 'Local app', status: 'error', detail: 'Not found', action: 'Download Local from https://localwp.com' };
+    }
+    catch {
+        return { label: 'Local app', status: 'error', detail: 'Check failed' };
+    }
+}
+async function checkLocalRunning() {
+    try {
+        const running = await (0, process_1.isLocalRunning)();
+        return running
+            ? { label: 'Local running', status: 'ok', detail: 'Running' }
+            : { label: 'Local running', status: 'warn', detail: 'Not running', action: 'Open the Local app' };
+    }
+    catch {
+        return { label: 'Local running', status: 'error', detail: 'Check failed' };
+    }
+}
+/**
+ * Try to read addon version from the npm global install path.
+ * The addon may be loaded by Local from the npm global dir (not Local's own addons/ folder)
+ * when installed via `npm install -g`.
+ */
+function getGlobalNpmAddonVersion() {
+    // Try npm global resolution first
+    try {
+        const pkgPath = require.resolve('@local-labs-jpollock/local-addon-nexus-ai/package.json');
+        return require(pkgPath).version ?? null;
+    }
+    catch { /* not on require path */ }
+    // Fallback: CLI and addon are the same package — read our own package.json.
+    // __dirname is lib/cli/commands, so ../../.. reaches the package root.
+    try {
+        const pkgPath = path.join(__dirname, '..', '..', '..', 'package.json');
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkAddon() {
+    try {
+        // isAddonActivated() is the authoritative signal — if the addon is in enabled-addons.json,
+        // Local has it available and it's active. isAddonInstalled() only checks one specific path
+        // and misses npm-global installs (the common case for `npm install -g` users).
+        const activated = (0, addon_1.isAddonActivated)();
+        const version = (0, addon_1.getInstalledAddonVersion)() ?? getGlobalNpmAddonVersion() ?? 'unknown';
+        const devMode = (0, addon_1.isDevAddon)();
+        if (activated) {
+            const detail = `Active (v${version})${devMode ? ' · dev' : ''}`;
+            return { label: 'Nexus AI addon', status: 'ok', detail };
+        }
+        // Activated flag not set — may be installed but not enabled
+        const installed = (0, addon_1.isAddonInstalled)();
+        if (installed) {
+            return { label: 'Nexus AI addon', status: 'warn', detail: `Installed (v${version}) but not activated`, action: 'Enable Nexus AI in Local → Preferences → Addons' };
+        }
+        return { label: 'Nexus AI addon', status: 'error', detail: 'Not installed', action: 'nexus update' };
+    }
+    catch {
+        return { label: 'Nexus AI addon', status: 'error', detail: 'Check failed' };
+    }
+}
+async function checkVersionMatch() {
+    try {
+        const addonVersion = (0, addon_1.getInstalledAddonVersion)();
+        if (!addonVersion)
+            return null;
+        // package.json version is baked in at build time via __VERSION__ or require
+        const cliPkg = require('../../../package.json');
+        const cliVersion = cliPkg.version;
+        if (addonVersion !== cliVersion) {
+            return {
+                label: 'Version match',
+                status: 'warn',
+                detail: `CLI v${cliVersion} ≠ addon v${addonVersion}`,
+                action: 'nexus update',
+            };
+        }
+        return { label: 'Version match', status: 'ok', detail: `v${cliVersion}` };
+    }
+    catch {
+        return null; // Non-critical — skip silently
+    }
+}
+async function checkGraphQL() {
+    try {
+        const info = (0, graphql_1.readConnectionInfo)();
+        if (!info) {
+            return { label: 'GraphQL server', status: 'warn', detail: 'No connection info — Local may not be running' };
+        }
+        return { label: 'GraphQL server', status: 'ok', detail: `Connected (port ${info.port})` };
+    }
+    catch {
+        return { label: 'GraphQL server', status: 'error', detail: 'Check failed' };
+    }
+}
+async function checkMcpServer() {
+    try {
+        const info = loadMcpInfo();
+        if (!info) {
+            return { label: 'MCP server', status: 'warn', detail: 'Not configured', action: 'Start Local with Nexus AI addon to activate MCP' };
+        }
+        const live = await isMcpServerLive(info.url, info.authToken);
+        if (!live) {
+            return { label: 'MCP server', status: 'warn', detail: `Configured (port ${info.port}) but not responding`, action: 'Restart Local' };
+        }
+        return { label: 'MCP server', status: 'ok', detail: `Running · ${info.tools.length} tools (v${info.version ?? '?'})` };
+    }
+    catch {
+        return { label: 'MCP server', status: 'error', detail: 'Check failed' };
+    }
+}
+/**
+ * Check if Claude Code has nexus-ai registered via `claude mcp list`.
+ * Claude Code is a CLI tool — registrations are managed by the `claude` binary,
+ * not a config file we can inspect directly.
+ */
+async function isClaudeCodeConfigured() {
+    try {
+        const { execFile } = await Promise.resolve().then(() => __importStar(require('child_process')));
+        const { promisify } = await Promise.resolve().then(() => __importStar(require('util')));
+        const exec = promisify(execFile);
+        const { stdout } = await exec('claude', ['mcp', 'list'], { timeout: 4000 });
+        return stdout.toLowerCase().includes('nexus-ai') || stdout.includes('mcp-stdio');
+    }
+    catch {
+        // claude not installed, not in PATH, or command failed
+        return false;
+    }
+}
+async function checkAgentConfig() {
+    try {
+        const info = loadMcpInfo();
+        if (!info) {
+            return { label: 'AI agent config', status: 'warn', detail: 'MCP server not running', action: 'nexus mcp setup' };
+        }
+        const configured = [];
+        // Claude Code — CLI-based, detect via `claude mcp list`
+        if (await isClaudeCodeConfigured()) {
+            configured.push('Claude Code');
+        }
+        // File-based agents — check their config files for nexus references
+        for (const [name, getPath] of Object.entries(AGENT_CONFIG_PATHS)) {
+            try {
+                const content = fs.readFileSync(getPath(), 'utf-8');
+                if (content.includes(info.url) || content.includes('nexus-ai') || content.includes('mcp-stdio')) {
+                    configured.push(name);
+                }
+            }
+            catch {
+                // File doesn't exist — agent not configured
+            }
+        }
+        if (configured.length === 0) {
+            return { label: 'AI agent config', status: 'warn', detail: 'No agents configured', action: 'nexus mcp setup' };
+        }
+        return { label: 'AI agent config', status: 'ok', detail: configured.join(', ') };
+    }
+    catch {
+        return { label: 'AI agent config', status: 'error', detail: 'Check failed' };
+    }
+}
+async function checkAiProvider(graphqlAvailable) {
+    if (!graphqlAvailable) {
+        return { label: 'AI provider', status: 'skip', detail: 'Local not running' };
+    }
+    try {
+        const { getClient } = await Promise.resolve().then(() => __importStar(require('../utils/graphql')));
+        const client = getClient({ timeout: 5000 });
+        const result = await client.mutate(`
+      mutation { nexusAiGetConfig { success config { provider model hasApiKey useLocalGateway } } }
+    `, {});
+        const { success, config } = result.nexusAiGetConfig;
+        if (!success || !config?.provider) {
+            return { label: 'AI provider', status: 'warn', detail: 'Not configured', action: 'nexus ai config' };
+        }
+        const label = PROVIDER_LABELS[config.provider] ?? config.provider;
+        if (!config.hasApiKey && config.provider !== 'ollama') {
+            return { label: 'AI provider', status: 'warn', detail: `${label} · no API key`, action: 'nexus ai config' };
+        }
+        return { label: 'AI provider', status: 'ok', detail: label };
+    }
+    catch {
+        return { label: 'AI provider', status: 'skip', detail: 'Could not reach addon' };
+    }
+}
+async function checkGateway(graphqlAvailable) {
+    if (!graphqlAvailable) {
+        return { label: 'Local Gateway', status: 'skip', detail: 'Local not running' };
+    }
+    try {
+        const { getClient } = await Promise.resolve().then(() => __importStar(require('../utils/graphql')));
+        const client = getClient({ timeout: 5000 });
+        const result = await client.mutate(`
+      mutation { nexusAiGetConfig { success config { useLocalGateway } } }
+    `, {});
+        const enabled = result.nexusAiGetConfig?.config?.useLocalGateway;
+        return enabled
+            ? { label: 'Local Gateway', status: 'ok', detail: 'Enabled' }
+            : { label: 'Local Gateway', status: 'disabled', detail: 'Disabled' };
+    }
+    catch {
+        return { label: 'Local Gateway', status: 'skip', detail: 'Could not reach addon' };
+    }
+}
+function readSiteAiConfigs() {
+    try {
+        const p = path.join((0, paths_1.getLocalPaths)().dataDir, 'nexus-ai_site_ai_config.json');
+        return JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+async function checkSitesWithAI(graphqlAvailable) {
+    if (!graphqlAvailable) {
+        return { label: 'Sites with AI', status: 'skip', detail: 'Local not running' };
+    }
+    try {
+        const { getClient } = await Promise.resolve().then(() => __importStar(require('../utils/graphql')));
+        const client = getClient({ timeout: 8000 });
+        const result = await client.mutate(`
+      mutation { nexusSitesList { local { name status } } }
+    `, {});
+        const sites = result.nexusSitesList?.local ?? [];
+        const total = sites.length;
+        if (total === 0) {
+            return { label: 'Sites with AI', status: 'skip', detail: 'No local sites found' };
+        }
+        // Read AI config from disk — no separate GraphQL mutation needed
+        const siteAiConfigs = readSiteAiConfigs();
+        const configuredCount = Object.keys(siteAiConfigs).length;
+        const running = sites.filter((s) => s.status === 'running');
+        const detail = `${configuredCount} / ${total} site${total !== 1 ? 's' : ''} configured · ${running.length} running`;
+        if (configuredCount === 0) {
+            const firstRunning = running[0];
+            return {
+                label: 'Sites with AI',
+                status: 'warn',
+                detail,
+                action: firstRunning ? `nexus ai setup ${firstRunning.name}` : 'nexus ai setup <sitename>',
+            };
+        }
+        return { label: 'Sites with AI', status: 'ok', detail };
+    }
+    catch {
+        return { label: 'Sites with AI', status: 'skip', detail: 'Could not reach addon' };
+    }
+}
+// ---------------------------------------------------------------------------
+// Report rendering
+// ---------------------------------------------------------------------------
+const COL_LABEL = 18; // label column width
+function formatRow(result) {
+    const icon = ICON[result.status];
+    const label = result.label.padEnd(COL_LABEL);
+    const detail = result.detail ? `  ${result.detail}` : '';
+    return `  ${icon}  ${label}${detail}`;
+}
+function isFirstRun(checks) {
+    // "First run" = MCP not configured AND no AI provider set
+    const mcp = checks.find((c) => c.label === 'MCP server');
+    const ai = checks.find((c) => c.label === 'AI provider');
+    return mcp?.status === 'warn' && ai?.status === 'warn';
+}
+function renderReport(checks, version) {
+    const line = '─'.repeat(50);
+    const localRunning = checks.find((c) => c.label === 'Local running')?.status === 'ok';
+    console.log('');
+    console.log(`Nexus AI v${version} — System Health`);
+    console.log(line);
+    for (const check of checks) {
+        console.log(formatRow(check));
+    }
+    console.log(line);
+    const nextSteps = checks
+        .filter((c) => c.action && (c.status === 'warn' || c.status === 'error'))
+        .map((c) => c.action);
+    if (nextSteps.length > 0) {
+        console.log('');
+        if (isFirstRun(checks) && !localRunning) {
+            console.log('  Getting started:');
+            console.log('');
+            console.log('  1. Open the Local app and make sure Nexus AI addon is enabled.');
+            console.log('  2. Connect your AI agent:   nexus mcp setup');
+            console.log('  3. Configure AI provider:   nexus ai config');
+            console.log('');
+        }
+        else if (isFirstRun(checks)) {
+            console.log('  Getting started:');
+            console.log('');
+            console.log('  1. Connect your AI agent:    nexus mcp setup');
+            console.log('  2. Configure AI provider:    nexus ai config');
+            console.log('  3. Set up a WordPress site:  nexus ai setup <sitename>');
+            console.log('');
+        }
+        else {
+            console.log('  Next steps:');
+            for (const step of [...new Set(nextSteps)]) {
+                console.log(`  → ${step}`);
+            }
+            console.log('');
+        }
+    }
+    else {
+        console.log('');
+        console.log('  Everything looks good. 🎉');
+        console.log('');
+    }
+}
+function renderJson(checks, version) {
+    const output = {
+        version,
+        healthy: checks.every((c) => c.status === 'ok' || c.status === 'disabled' || c.status === 'skip'),
+        checks: checks.map((c) => ({
+            label: c.label,
+            status: c.status,
+            detail: c.detail ?? null,
+            action: c.action ?? null,
+        })),
+    };
+    console.log(JSON.stringify(output, null, 2));
+}
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+exports.doctorCommand = new commander_1.Command('doctor')
+    .description('Check system health and show setup status')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const cliPkg = (() => {
+        try {
+            return require('../../../package.json');
+        }
+        catch {
+            return { version: '?' };
+        }
+    })();
+    const version = cliPkg.version;
+    const checks = [];
+    // ── Phase 1: checks that never need Local/GraphQL ────────────────────
+    checks.push(await checkLocalInstalled());
+    checks.push(await checkLocalRunning());
+    checks.push(await checkAddon());
+    const versionMatch = await checkVersionMatch();
+    if (versionMatch)
+        checks.push(versionMatch);
+    checks.push(await checkGraphQL());
+    checks.push(await checkMcpServer());
+    checks.push(await checkAgentConfig());
+    // ── Phase 2: checks that need GraphQL (only if GraphQL is reachable) ─
+    const graphqlAvailable = checks.find((c) => c.label === 'GraphQL server')?.status === 'ok';
+    checks.push(await checkAiProvider(graphqlAvailable));
+    checks.push(await checkGateway(graphqlAvailable));
+    checks.push(await checkSitesWithAI(graphqlAvailable));
+    // ── Output ────────────────────────────────────────────────────────────
+    if (options.json) {
+        renderJson(checks, version);
+    }
+    else {
+        renderReport(checks, version);
+    }
+    // Exit with non-zero if any check is 'error'
+    const hasError = checks.some((c) => c.status === 'error');
+    if (hasError)
+        process.exit(1);
+});
+//# sourceMappingURL=doctor.js.map