@tulex-cli/tulex-code 0.1.1

package/dist/src/utils/doctorChecks.js

@@ -0,0 +1,351 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import process from 'node:process';
+import os from 'node:os';
+import { getNpmVersion, getGitVersion } from './systemInfo.js';
+import { validateAuthMethod } from '../config/auth.js';
+import { findProviderByCredentials, canUseRipgrep, getMCPServerStatus, MCPServerStatus, } from '@tulex-cli/tulex-cli-core';
+import { t } from '../i18n/index.js';
+const MIN_NODE_MAJOR = 22;
+function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.replace(/^v/, '').split('.')[0], 10);
+    if (isNaN(major) || major < MIN_NODE_MAJOR) {
+        return {
+            category: t('System'),
+            name: t('Node.js version'),
+            status: 'fail',
+            message: version,
+            detail: t('Node.js v{{min}}+ is required. Current: {{version}}', {
+                min: String(MIN_NODE_MAJOR),
+                version,
+            }),
+        };
+    }
+    return {
+        category: t('System'),
+        name: t('Node.js version'),
+        status: 'pass',
+        message: version,
+    };
+}
+async function checkNpmVersion() {
+    const version = await getNpmVersion();
+    if (version === 'unknown') {
+        return {
+            category: t('System'),
+            name: t('npm version'),
+            status: 'warn',
+            message: t('not found'),
+            detail: t('npm is not available. Some features may not work.'),
+        };
+    }
+    return {
+        category: t('System'),
+        name: t('npm version'),
+        status: 'pass',
+        message: version,
+    };
+}
+function checkPlatform() {
+    return {
+        category: t('System'),
+        name: t('Platform'),
+        status: 'pass',
+        message: `${process.platform}/${process.arch} (${os.release()})`,
+    };
+}
+function checkAuth(context) {
+    const config = context.services.config;
+    const authType = config?.getAuthType();
+    if (!authType) {
+        return {
+            category: t('Authentication'),
+            name: t('API key'),
+            status: 'fail',
+            message: t('not configured'),
+            detail: t('Run /auth to configure authentication.'),
+        };
+    }
+    const error = validateAuthMethod(authType, config ?? undefined);
+    if (error) {
+        return {
+            category: t('Authentication'),
+            name: t('API key'),
+            status: 'fail',
+            message: t('invalid ({{authType}})', { authType }),
+            detail: error,
+        };
+    }
+    // Build enriched diagnostic information
+    const cgConfig = typeof config?.getContentGeneratorConfig === 'function'
+        ? config.getContentGeneratorConfig()
+        : undefined;
+    const model = cgConfig?.model ?? config?.getModel();
+    const baseUrl = cgConfig?.baseUrl;
+    const envKey = cgConfig?.apiKeyEnvKey;
+    const provider = findProviderByCredentials(baseUrl, envKey);
+    const detailParts = [];
+    if (provider) {
+        detailParts.push(t('Provider: {{provider}}', { provider: t(provider.label) }));
+    }
+    if (baseUrl) {
+        detailParts.push(t('Base URL: {{baseUrl}}', { baseUrl }));
+    }
+    if (model) {
+        detailParts.push(t('Model: {{model}}', { model }));
+    }
+    if (envKey) {
+        const hasKey = !!process.env[envKey];
+        detailParts.push(hasKey
+            ? t('API key: configured ({{envKey}})', { envKey })
+            : t('API key: {{envKey}} not set', { envKey }));
+    }
+    return {
+        category: t('Authentication'),
+        name: t('API key'),
+        status: 'pass',
+        message: t('configured ({{authType}})', { authType }),
+        detail: detailParts.length > 0 ? detailParts.join('\n') : undefined,
+    };
+}
+async function checkApiClient(context) {
+    const config = context.services.config;
+    if (!config) {
+        return {
+            category: t('Authentication'),
+            name: t('API client'),
+            status: 'fail',
+            message: t('config not loaded'),
+        };
+    }
+    try {
+        const client = config.getGeminiClient();
+        if (client.isInitialized()) {
+            return {
+                category: t('Authentication'),
+                name: t('API client'),
+                status: 'pass',
+                message: t('client initialized'),
+            };
+        }
+        return {
+            category: t('Authentication'),
+            name: t('API client'),
+            status: 'warn',
+            message: t('client not initialized'),
+            detail: t('The API client has not been initialized yet.'),
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return {
+            category: t('Authentication'),
+            name: t('API client'),
+            status: 'warn',
+            message: t('error'),
+            detail: errorMsg,
+        };
+    }
+}
+function checkSettings(context) {
+    const settings = context.services.settings;
+    if (!settings) {
+        return {
+            category: t('Configuration'),
+            name: t('Settings'),
+            status: 'fail',
+            message: t('not loaded'),
+            detail: t('Settings could not be loaded. Check your settings files for syntax errors.'),
+        };
+    }
+    return {
+        category: t('Configuration'),
+        name: t('Settings'),
+        status: 'pass',
+        message: t('loaded'),
+    };
+}
+function checkModel(context) {
+    const model = context.services.config?.getModel();
+    if (!model) {
+        return {
+            category: t('Configuration'),
+            name: t('Model'),
+            status: 'fail',
+            message: t('not configured'),
+            detail: t('Run /model to select a model.'),
+        };
+    }
+    return {
+        category: t('Configuration'),
+        name: t('Model'),
+        status: 'pass',
+        message: model,
+    };
+}
+function checkMcpServers(context) {
+    const config = context.services.config;
+    const servers = config?.getMcpServers();
+    if (!servers || Object.keys(servers).length === 0) {
+        return [
+            {
+                category: t('MCP Servers'),
+                name: t('MCP servers'),
+                status: 'pass',
+                message: t('none configured'),
+            },
+        ];
+    }
+    // In non-interactive mode MCP connections are never established, so querying
+    // getMCPServerStatus would always return DISCONNECTED and produce false failures.
+    // Report configured servers as unchecked instead.
+    if (context.executionMode !== 'interactive') {
+        return Object.keys(servers).map((name) => ({
+            category: t('MCP Servers'),
+            name,
+            status: 'pass',
+            message: config?.isMcpServerDisabled(name)
+                ? t('disabled')
+                : t('configured (not checked in non-interactive mode)'),
+        }));
+    }
+    return Object.keys(servers).map((name) => {
+        // Skip disabled servers — report as informational pass
+        if (config?.isMcpServerDisabled(name)) {
+            return {
+                category: t('MCP Servers'),
+                name,
+                status: 'pass',
+                message: t('disabled'),
+            };
+        }
+        const status = getMCPServerStatus(name);
+        switch (status) {
+            case MCPServerStatus.CONNECTED:
+                return {
+                    category: t('MCP Servers'),
+                    name,
+                    status: 'pass',
+                    message: t('connected'),
+                };
+            case MCPServerStatus.CONNECTING:
+                return {
+                    category: t('MCP Servers'),
+                    name,
+                    status: 'warn',
+                    message: t('connecting'),
+                    detail: t('Server is still starting up.'),
+                };
+            case MCPServerStatus.DISCONNECTED:
+            default:
+                return {
+                    category: t('MCP Servers'),
+                    name,
+                    status: 'fail',
+                    message: t('disconnected'),
+                    detail: t('Check that the server process is running and configuration is correct.'),
+                };
+        }
+    });
+}
+function checkToolRegistry(context) {
+    const registry = context.services.config?.getToolRegistry();
+    if (!registry) {
+        return {
+            category: t('Tools'),
+            name: t('Tool registry'),
+            status: 'fail',
+            message: t('not loaded'),
+        };
+    }
+    const count = registry.getAllTools().length;
+    return {
+        category: t('Tools'),
+        name: t('Tool registry'),
+        status: 'pass',
+        message: t('{{count}} tools registered', { count: String(count) }),
+    };
+}
+async function checkRipgrep(context) {
+    try {
+        const useBuiltin = context.services.config?.getUseBuiltinRipgrep() ?? false;
+        const result = await canUseRipgrep(useBuiltin);
+        if (result) {
+            return {
+                category: t('Tools'),
+                name: t('Ripgrep'),
+                status: 'pass',
+                message: t('available'),
+            };
+        }
+        return {
+            category: t('Tools'),
+            name: t('Ripgrep'),
+            status: 'warn',
+            message: t('not available'),
+            detail: t('Install ripgrep for faster file search: https://github.com/BurntSushi/ripgrep'),
+        };
+    }
+    catch {
+        return {
+            category: t('Tools'),
+            name: t('Ripgrep'),
+            status: 'warn',
+            message: t('check failed'),
+        };
+    }
+}
+async function checkGit(_context) {
+    const version = await getGitVersion();
+    if (version === 'unknown') {
+        return {
+            category: t('Git'),
+            name: t('Git'),
+            status: 'warn',
+            message: t('not available'),
+            detail: t('Git features will be limited.'),
+        };
+    }
+    return {
+        category: t('Git'),
+        name: t('Git'),
+        status: 'pass',
+        message: version,
+    };
+}
+/**
+ * Run all doctor diagnostic checks.
+ */
+export async function runDoctorChecks(context) {
+    // Run async checks in parallel
+    const [npmResult, ripgrepResult, apiClientResult, gitResult] = await Promise.all([
+        checkNpmVersion(),
+        checkRipgrep(context),
+        checkApiClient(context),
+        checkGit(context),
+    ]);
+    return [
+        // System
+        checkNodeVersion(),
+        npmResult,
+        checkPlatform(),
+        // Authentication
+        checkAuth(context),
+        apiClientResult,
+        // Configuration
+        checkSettings(context),
+        checkModel(context),
+        // MCP Servers
+        ...checkMcpServers(context),
+        // Tools
+        checkToolRegistry(context),
+        ripgrepResult,
+        // Git
+        gitResult,
+    ];
+}
+//# sourceMappingURL=doctorChecks.js.map

package/dist/src/utils/doctorChecks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctorChecks.js","sourceRoot":"","sources":["../../../src/utils/doctorChecks.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/doctorChecks.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/doctorChecks.test.js

@@ -0,0 +1,280 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
+import { runDoctorChecks } from './doctorChecks.js';
+import {} from '../ui/commands/types.js';
+import { createMockCommandContext } from '../test-utils/mockCommandContext.js';
+import * as systemInfoUtils from './systemInfo.js';
+import * as authModule from '../config/auth.js';
+import * as allProviders from '@tulex-cli/tulex-cli-core';
+vi.mock('./systemInfo.js');
+vi.mock('../config/auth.js');
+vi.mock('@tulex-cli/tulex-cli-core', async (importOriginal) => {
+    const actual = (await importOriginal());
+    return {
+        ...actual,
+        findProviderByCredentials: vi.fn(actual.findProviderByCredentials),
+        canUseRipgrep: vi.fn().mockResolvedValue(true),
+        getMCPServerStatus: vi.fn().mockReturnValue('connected'),
+        MCPServerStatus: {
+            CONNECTED: 'connected',
+            CONNECTING: 'connecting',
+            DISCONNECTED: 'disconnected',
+        },
+    };
+});
+describe('runDoctorChecks', () => {
+    let mockContext;
+    beforeEach(() => {
+        mockContext = createMockCommandContext({
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue('openai'),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(true),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getContentGeneratorConfig: vi.fn().mockReturnValue({
+                        model: 'openrouter/auto',
+                        baseUrl: 'https://openrouter.ai/api/v1',
+                        apiKeyEnvKey: 'OPENROUTER_API_KEY',
+                    }),
+                    getMcpServers: vi.fn().mockReturnValue({}),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([{ name: 'tool1' }]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: {
+                    merged: {},
+                },
+                git: {},
+            },
+        });
+        vi.mocked(systemInfoUtils.getNpmVersion).mockResolvedValue('10.0.0');
+        vi.mocked(systemInfoUtils.getGitVersion).mockResolvedValue('git version 2.39.0');
+        vi.mocked(authModule.validateAuthMethod).mockReturnValue(null);
+    });
+    afterEach(() => {
+        delete process.env['OPENROUTER_API_KEY'];
+        vi.clearAllMocks();
+    });
+    it('should return results for all categories', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const categories = [...new Set(results.map((r) => r.category))];
+        expect(categories).toContain('System');
+        expect(categories).toContain('Authentication');
+        expect(categories).toContain('Configuration');
+        expect(categories).toContain('Tools');
+        expect(categories).toContain('Git');
+    });
+    it('should pass Node.js version check for v22+', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const nodeCheck = results.find((r) => r.name === 'Node.js version');
+        expect(nodeCheck).toBeDefined();
+        expect(nodeCheck.status).toBe('pass');
+    });
+    it('should pass npm check when npm is available', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const npmCheck = results.find((r) => r.name === 'npm version');
+        expect(npmCheck).toBeDefined();
+        expect(npmCheck.status).toBe('pass');
+        expect(npmCheck.message).toBe('10.0.0');
+    });
+    it('should warn when npm is not available', async () => {
+        vi.mocked(systemInfoUtils.getNpmVersion).mockResolvedValue('unknown');
+        const results = await runDoctorChecks(mockContext);
+        const npmCheck = results.find((r) => r.name === 'npm version');
+        expect(npmCheck.status).toBe('warn');
+    });
+    it('should fail auth check when auth is not configured', async () => {
+        mockContext = createMockCommandContext({
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue(undefined),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(false),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getMcpServers: vi.fn().mockReturnValue({}),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: { merged: {} },
+                git: {},
+            },
+        });
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.status).toBe('fail');
+    });
+    it('should pass auth check when credentials are valid', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.status).toBe('pass');
+    });
+    it('should show provider detail when credentials match a known provider', async () => {
+        process.env['OPENROUTER_API_KEY'] = 'test-key';
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).toContain('Provider: OpenRouter');
+        expect(authCheck.detail).toContain('Base URL: https://openrouter.ai/api/v1');
+        expect(authCheck.detail).toContain('Model: openrouter/auto');
+        expect(authCheck.detail).toContain('API key: configured (OPENROUTER_API_KEY)');
+    });
+    it('should show a missing API key in provider detail', async () => {
+        delete process.env['OPENROUTER_API_KEY'];
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).toContain('API key: OPENROUTER_API_KEY not set');
+    });
+    it('should treat an empty API key environment variable as not set', async () => {
+        process.env['OPENROUTER_API_KEY'] = '';
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).toContain('API key: OPENROUTER_API_KEY not set');
+    });
+    it('should omit provider detail when credentials do not match a known provider', async () => {
+        vi.mocked(allProviders.findProviderByCredentials).mockReturnValueOnce(undefined);
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).not.toContain('Provider:');
+        expect(authCheck.detail).toContain('Base URL: https://openrouter.ai/api/v1');
+    });
+    it('should fall back to config model when content generator config is missing', async () => {
+        const config = mockContext.services.config;
+        vi.mocked(config.getContentGeneratorConfig).mockImplementationOnce(() => undefined);
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).toBe('Model: gpt-4');
+    });
+    it('should omit detail when no enriched auth fields are available', async () => {
+        const config = mockContext.services.config;
+        vi.mocked(config.getModel).mockReturnValueOnce(undefined);
+        vi.mocked(config.getContentGeneratorConfig).mockReturnValueOnce({});
+        const results = await runDoctorChecks(mockContext);
+        const authCheck = results.find((r) => r.name === 'API key');
+        expect(authCheck.detail).toBeUndefined();
+    });
+    it('should pass tool registry check when registry is loaded', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const toolCheck = results.find((r) => r.name === 'Tool registry');
+        expect(toolCheck.status).toBe('pass');
+        expect(toolCheck.message).toContain('1');
+    });
+    it('should pass git check when git service exists', async () => {
+        const results = await runDoctorChecks(mockContext);
+        const gitCheck = results.find((r) => r.name === 'Git');
+        expect(gitCheck.status).toBe('pass');
+    });
+    it('should warn git check when git service is missing and git binary is unavailable', async () => {
+        mockContext = createMockCommandContext({
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue('openai'),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(true),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getMcpServers: vi.fn().mockReturnValue({}),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: { merged: {} },
+            },
+        });
+        vi.mocked(systemInfoUtils.getGitVersion).mockResolvedValue('unknown');
+        const results = await runDoctorChecks(mockContext);
+        const gitCheck = results.find((r) => r.name === 'Git');
+        expect(gitCheck.status).toBe('warn');
+    });
+    it('should pass git check when git service is missing but git binary is available', async () => {
+        mockContext = createMockCommandContext({
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue('openai'),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(true),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getMcpServers: vi.fn().mockReturnValue({}),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: { merged: {} },
+            },
+        });
+        vi.mocked(systemInfoUtils.getGitVersion).mockResolvedValue('git version 2.39.0');
+        const results = await runDoctorChecks(mockContext);
+        const gitCheck = results.find((r) => r.name === 'Git');
+        expect(gitCheck.status).toBe('pass');
+        expect(gitCheck.message).toBe('git version 2.39.0');
+    });
+    it('should report disabled MCP servers as pass instead of fail', async () => {
+        mockContext = createMockCommandContext({
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue('openai'),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(true),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getMcpServers: vi
+                        .fn()
+                        .mockReturnValue({ 'my-server': { command: 'node' } }),
+                    isMcpServerDisabled: vi.fn().mockReturnValue(true),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: { merged: {} },
+                git: {},
+            },
+        });
+        const results = await runDoctorChecks(mockContext);
+        const mcpCheck = results.find((r) => r.name === 'my-server');
+        expect(mcpCheck).toBeDefined();
+        expect(mcpCheck.status).toBe('pass');
+        expect(mcpCheck.message).toBe('disabled');
+    });
+    it('should not report MCP connection status in non-interactive mode', async () => {
+        mockContext = createMockCommandContext({
+            executionMode: 'non_interactive',
+            services: {
+                config: {
+                    getAuthType: vi.fn().mockReturnValue('openai'),
+                    getGeminiClient: vi.fn().mockReturnValue({
+                        isInitialized: vi.fn().mockReturnValue(true),
+                    }),
+                    getModel: vi.fn().mockReturnValue('gpt-4'),
+                    getMcpServers: vi
+                        .fn()
+                        .mockReturnValue({ 'my-server': { command: 'node' } }),
+                    isMcpServerDisabled: vi.fn().mockReturnValue(false),
+                    getToolRegistry: vi.fn().mockReturnValue({
+                        getAllTools: vi.fn().mockReturnValue([]),
+                    }),
+                    getUseBuiltinRipgrep: vi.fn().mockReturnValue(false),
+                },
+                settings: { merged: {} },
+                git: {},
+            },
+        });
+        const results = await runDoctorChecks(mockContext);
+        const mcpCheck = results.find((r) => r.name === 'my-server');
+        expect(mcpCheck).toBeDefined();
+        // In non-interactive mode, servers are never connected — must not report as fail
+        expect(mcpCheck.status).toBe('pass');
+    });
+});
+//# sourceMappingURL=doctorChecks.test.js.map