@tonycasey/lisa 2.2.0 → 2.5.5

package/dist/lib/commands/doctor.js

@@ -0,0 +1,716 @@
+"use strict";
+/**
+ * Doctor Command Module
+ *
+ * Comprehensive diagnostic tool for Lisa configuration and connectivity.
+ * Supports basic, verbose, and JSON output modes.
+ */
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+exports.formatBasicOutput = formatBasicOutput;
+exports.formatVerboseOutput = formatVerboseOutput;
+exports.formatJsonOutput = formatJsonOutput;
+exports.getExitCode = getExitCode;
+exports.doctorCommand = doctorCommand;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_ENDPOINT = 'http://localhost:8010/mcp/';
+const ZEP_CLOUD_ENDPOINT = 'https://api.getzep.com/mcp/';
+/**
+ * Load Lisa configuration from .lisa/.env file.
+ */
+async function loadConfig(cwd) {
+    const lisaEnv = path_1.default.join(cwd, '.lisa', '.env');
+    const map = {};
+    if (await fs_extra_1.default.pathExists(lisaEnv)) {
+        const raw = await fs_extra_1.default.readFile(lisaEnv, 'utf8');
+        raw.split(/\r?\n/).forEach((line) => {
+            if (!line || line.startsWith('#'))
+                return;
+            const idx = line.indexOf('=');
+            if (idx === -1)
+                return;
+            const key = line.slice(0, idx).trim();
+            map[key] = line.slice(idx + 1).trim();
+        });
+    }
+    if (Object.keys(map).length === 0) {
+        return null;
+    }
+    return {
+        endpoint: map.GRAPHITI_ENDPOINT,
+        group: map.GRAPHITI_GROUP_ID,
+        mode: map.STORAGE_MODE,
+        zepApiKey: map.ZEP_API_KEY,
+        zepProjectId: map.ZEP_PROJECT_ID,
+    };
+}
+/**
+ * Get project name from package.json or directory name.
+ */
+function getProjectName(cwd) {
+    try {
+        const pkgPath = path_1.default.join(cwd, 'package.json');
+        if (fs_extra_1.default.existsSync(pkgPath)) {
+            const pkg = fs_extra_1.default.readJsonSync(pkgPath);
+            if (pkg.name) {
+                return pkg.name.replace(/^@[^/]+\//, '');
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return path_1.default.basename(cwd);
+}
+/**
+ * Get Lisa package version.
+ */
+function getLisaVersion() {
+    try {
+        // Try multiple locations for package.json
+        const possiblePaths = [
+            path_1.default.join(__dirname, '..', '..', '..', 'package.json'),
+            path_1.default.join(__dirname, '..', '..', 'package.json'),
+        ];
+        for (const pkgPath of possiblePaths) {
+            if (fs_extra_1.default.existsSync(pkgPath)) {
+                const pkg = fs_extra_1.default.readJsonSync(pkgPath);
+                return pkg.version || '0.0.0';
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return '0.0.0';
+}
+// ============================================================================
+// Health Checks
+// ============================================================================
+/**
+ * Check Docker availability.
+ */
+async function checkDocker(services) {
+    const start = Date.now();
+    try {
+        const version = await services.docker.version();
+        return {
+            name: 'Docker',
+            status: 'ok',
+            message: `Docker ${version.trim()}`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Docker',
+            status: 'error',
+            message: 'Docker not available',
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Check Docker Compose availability.
+ */
+async function checkDockerCompose(services) {
+    const start = Date.now();
+    try {
+        const version = await services.docker.composeVersion();
+        return {
+            name: 'Docker Compose',
+            status: 'ok',
+            message: `Compose ${version.trim()}`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Docker Compose',
+            status: 'error',
+            message: 'Docker Compose not available',
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Check compose file existence.
+ */
+async function checkComposeFile(composeFile) {
+    const start = Date.now();
+    const exists = await fs_extra_1.default.pathExists(composeFile);
+    return {
+        name: 'Compose File',
+        status: exists ? 'ok' : 'warning',
+        message: exists ? `Found: ${path_1.default.basename(composeFile)}` : 'Not found',
+        details: composeFile,
+        durationMs: Date.now() - start,
+    };
+}
+/**
+ * Check MCP/Graphiti connectivity.
+ */
+async function checkMcp(services, endpoint, apiKey) {
+    const start = Date.now();
+    try {
+        await services.mcp.ping(endpoint, { apiKey });
+        return {
+            name: 'MCP Server',
+            status: 'ok',
+            message: `Reachable at ${endpoint}`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'MCP Server',
+            status: 'error',
+            message: `Not reachable at ${endpoint}`,
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Check Neo4j connectivity (local mode only).
+ */
+async function checkNeo4j() {
+    const start = Date.now();
+    const uri = process.env.NEO4J_URI || 'bolt://localhost:7687';
+    try {
+        // Dynamic import to avoid requiring neo4j-driver if not needed
+        const neo4j = await Promise.resolve().then(() => __importStar(require('neo4j-driver')));
+        const driver = neo4j.default.driver(uri, neo4j.default.auth.basic(process.env.NEO4J_USER || 'neo4j', process.env.NEO4J_PASSWORD || 'demodemo'), { connectionTimeout: 5000 });
+        await driver.verifyConnectivity();
+        await driver.close();
+        return {
+            name: 'Neo4j',
+            status: 'ok',
+            message: `Connected to ${uri}`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Neo4j',
+            status: 'error',
+            message: `Cannot connect to ${uri}`,
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Check Zep Cloud connectivity.
+ */
+async function checkZepCloud(apiKey) {
+    const start = Date.now();
+    const endpoint = 'https://api.getzep.com/api/v2/users';
+    try {
+        const resp = await fetch(endpoint, {
+            method: 'GET',
+            headers: {
+                Authorization: `Api-Key ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            signal: AbortSignal.timeout(10000),
+        });
+        // 200 or 404 means API is reachable
+        if (resp.ok || resp.status === 404) {
+            return {
+                name: 'Zep Cloud',
+                status: 'ok',
+                message: 'API reachable',
+                durationMs: Date.now() - start,
+            };
+        }
+        return {
+            name: 'Zep Cloud',
+            status: 'error',
+            message: `API returned ${resp.status}`,
+            details: await resp.text().catch(() => ''),
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Zep Cloud',
+            status: 'error',
+            message: 'Cannot reach Zep Cloud API',
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Check .lisa directory structure.
+ */
+async function checkLisaStructure(cwd) {
+    const start = Date.now();
+    const lisaDir = path_1.default.join(cwd, '.lisa');
+    if (!(await fs_extra_1.default.pathExists(lisaDir))) {
+        return {
+            name: 'Lisa Structure',
+            status: 'error',
+            message: '.lisa directory not found',
+            details: 'Run "lisa init" to set up Lisa',
+            durationMs: Date.now() - start,
+        };
+    }
+    const expectedDirs = ['skills', 'rules'];
+    const missing = [];
+    for (const dir of expectedDirs) {
+        if (!(await fs_extra_1.default.pathExists(path_1.default.join(lisaDir, dir)))) {
+            missing.push(dir);
+        }
+    }
+    if (missing.length > 0) {
+        return {
+            name: 'Lisa Structure',
+            status: 'warning',
+            message: `Missing directories: ${missing.join(', ')}`,
+            details: `Expected in ${lisaDir}`,
+            durationMs: Date.now() - start,
+        };
+    }
+    return {
+        name: 'Lisa Structure',
+        status: 'ok',
+        message: '.lisa directory configured',
+        durationMs: Date.now() - start,
+    };
+}
+/**
+ * Check Claude Code hooks setup.
+ */
+async function checkClaudeHooks(cwd) {
+    const start = Date.now();
+    const claudeDir = path_1.default.join(cwd, '.claude');
+    const settingsPath = path_1.default.join(claudeDir, 'settings.json');
+    if (!(await fs_extra_1.default.pathExists(claudeDir))) {
+        return {
+            name: 'Claude Code Hooks',
+            status: 'warning',
+            message: '.claude directory not found',
+            details: 'Claude Code integration not configured',
+            durationMs: Date.now() - start,
+        };
+    }
+    if (!(await fs_extra_1.default.pathExists(settingsPath))) {
+        return {
+            name: 'Claude Code Hooks',
+            status: 'warning',
+            message: 'settings.json not found',
+            details: 'Hooks may not be registered',
+            durationMs: Date.now() - start,
+        };
+    }
+    try {
+        const settings = await fs_extra_1.default.readJson(settingsPath);
+        const hooks = settings.hooks || {};
+        const configuredHooks = Object.keys(hooks).length;
+        if (configuredHooks === 0) {
+            return {
+                name: 'Claude Code Hooks',
+                status: 'warning',
+                message: 'No hooks configured',
+                details: 'Memory loading may not work',
+                durationMs: Date.now() - start,
+            };
+        }
+        return {
+            name: 'Claude Code Hooks',
+            status: 'ok',
+            message: `${configuredHooks} hook(s) configured`,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            name: 'Claude Code Hooks',
+            status: 'warning',
+            message: 'Cannot parse settings.json',
+            details: message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+// ============================================================================
+// Transcript Discovery
+// ============================================================================
+/**
+ * Find all transcript files from standard Claude Code locations.
+ */
+function findTranscripts() {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    const searchPaths = [
+        path_1.default.join(homeDir, '.claude', 'projects'),
+        path_1.default.join(homeDir, '.claude'),
+    ];
+    const candidates = [];
+    for (const dir of searchPaths) {
+        if (!fs_extra_1.default.existsSync(dir))
+            continue;
+        // Check direct transcript
+        const directPath = path_1.default.join(dir, 'transcript.jsonl');
+        if (fs_extra_1.default.existsSync(directPath)) {
+            try {
+                const stats = fs_extra_1.default.statSync(directPath);
+                candidates.push({
+                    path: directPath,
+                    mtime: stats.mtime,
+                    sizeBytes: stats.size,
+                });
+            }
+            catch {
+                // Skip
+            }
+        }
+        // Check subdirectories
+        try {
+            const entries = fs_extra_1.default.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const subPath = path_1.default.join(dir, entry.name, 'transcript.jsonl');
+                    if (fs_extra_1.default.existsSync(subPath)) {
+                        try {
+                            const stats = fs_extra_1.default.statSync(subPath);
+                            candidates.push({
+                                path: subPath,
+                                mtime: stats.mtime,
+                                sizeBytes: stats.size,
+                            });
+                        }
+                        catch {
+                            // Skip
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore permission errors
+        }
+    }
+    // Sort by modification time (newest first)
+    candidates.sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+    return {
+        searchPaths,
+        candidates,
+        selected: candidates.length > 0 ? candidates[0].path : undefined,
+    };
+}
+// ============================================================================
+// Main Doctor Function
+// ============================================================================
+/**
+ * Run comprehensive health checks and return diagnostic results.
+ */
+async function runDoctor(opts, services) {
+    const startTime = Date.now();
+    const cwd = opts.cwd;
+    const projectName = getProjectName(cwd);
+    // Load configuration
+    const config = await loadConfig(cwd);
+    const mode = config?.mode || 'local';
+    const endpoint = opts.endpoint ||
+        config?.endpoint ||
+        (mode === 'zep-cloud' ? ZEP_CLOUD_ENDPOINT : DEFAULT_ENDPOINT);
+    const group = config?.group || projectName;
+    const zepApiKey = config?.zepApiKey || process.env.ZEP_API_KEY;
+    // Build config info
+    const envFilePath = path_1.default.join(cwd, '.lisa', '.env');
+    const configInfo = {
+        mode,
+        group,
+        endpoint,
+        envFilePath,
+        envFileExists: await fs_extra_1.default.pathExists(envFilePath),
+        zepApiKeyConfigured: !!zepApiKey,
+        zepProjectId: config?.zepProjectId,
+    };
+    // Run health checks based on mode
+    const checks = [];
+    // Always check Lisa structure and Claude hooks
+    checks.push(await checkLisaStructure(cwd));
+    checks.push(await checkClaudeHooks(cwd));
+    if (mode === 'local') {
+        // Local mode checks
+        checks.push(await checkDocker(services));
+        checks.push(await checkDockerCompose(services));
+        const composeFile = opts.compose || path_1.default.join(cwd, 'docker-compose.graphiti.yml');
+        checks.push(await checkComposeFile(composeFile));
+        checks.push(await checkNeo4j());
+        checks.push(await checkMcp(services, endpoint));
+    }
+    else if (mode === 'zep-cloud') {
+        // Zep Cloud mode checks
+        if (zepApiKey) {
+            checks.push(await checkZepCloud(zepApiKey));
+            checks.push(await checkMcp(services, endpoint, zepApiKey));
+        }
+        else {
+            checks.push({
+                name: 'Zep Cloud',
+                status: 'error',
+                message: 'ZEP_API_KEY not configured',
+                details: 'Set ZEP_API_KEY in .lisa/.env or environment',
+            });
+        }
+    }
+    else if (mode === 'skip') {
+        checks.push({
+            name: 'Storage Backend',
+            status: 'warning',
+            message: 'Storage not configured (skip mode)',
+            details: 'Run "lisa init" to configure storage',
+        });
+    }
+    // Find transcripts
+    const transcripts = findTranscripts();
+    // Determine overall status
+    const hasError = checks.some((c) => c.status === 'error');
+    const hasWarning = checks.some((c) => c.status === 'warning');
+    const overallStatus = hasError
+        ? 'error'
+        : hasWarning
+            ? 'warning'
+            : 'ok';
+    return {
+        timestamp: new Date().toISOString(),
+        projectRoot: cwd,
+        version: getLisaVersion(),
+        overallStatus,
+        config: configInfo,
+        checks,
+        transcripts,
+        totalDurationMs: Date.now() - startTime,
+    };
+}
+// ============================================================================
+// Output Formatting
+// ============================================================================
+/**
+ * Get status icon for check result.
+ */
+function getStatusIcon(status) {
+    switch (status) {
+        case 'ok':
+            return chalk_1.default.green('✓');
+        case 'warning':
+            return chalk_1.default.yellow('⚠');
+        case 'error':
+            return chalk_1.default.red('✗');
+    }
+}
+/**
+ * Get colored status text.
+ */
+function getStatusText(status) {
+    switch (status) {
+        case 'ok':
+            return chalk_1.default.green('OK');
+        case 'warning':
+            return chalk_1.default.yellow('WARNING');
+        case 'error':
+            return chalk_1.default.red('ERROR');
+    }
+}
+/**
+ * Format file size in human-readable format.
+ */
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Format duration in human-readable format.
+ */
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+/**
+ * Format basic output (checkmarks only).
+ */
+function formatBasicOutput(result) {
+    const lines = [];
+    // Header
+    lines.push(chalk_1.default.cyan(`Mode: ${result.config.mode}`));
+    lines.push(chalk_1.default.cyan(`Group: ${result.config.group}`));
+    lines.push('');
+    // Health checks
+    for (const check of result.checks) {
+        lines.push(`${getStatusIcon(check.status)} ${check.name}: ${check.message}`);
+    }
+    // Overall status
+    lines.push('');
+    lines.push(`Overall: ${getStatusText(result.overallStatus)} (${formatDuration(result.totalDurationMs)})`);
+    return lines.join('\n');
+}
+/**
+ * Format verbose output (detailed diagnostics).
+ */
+function formatVerboseOutput(result) {
+    const lines = [];
+    // Header
+    lines.push(chalk_1.default.bold.cyan('=== Lisa Doctor ==='));
+    lines.push('');
+    // System info
+    lines.push(chalk_1.default.bold('System Information'));
+    lines.push(`  Lisa Version: ${result.version}`);
+    lines.push(`  Project Root: ${result.projectRoot}`);
+    lines.push(`  Timestamp: ${result.timestamp}`);
+    lines.push('');
+    // Configuration
+    lines.push(chalk_1.default.bold('Configuration'));
+    lines.push(`  Mode: ${result.config.mode}`);
+    lines.push(`  Group: ${result.config.group}`);
+    lines.push(`  Endpoint: ${result.config.endpoint}`);
+    lines.push(`  Env File: ${result.config.envFilePath}`);
+    lines.push(`  Env File Exists: ${result.config.envFileExists ? 'Yes' : 'No'}`);
+    lines.push(`  Zep API Key: ${result.config.zepApiKeyConfigured ? 'Configured' : 'Not configured'}`);
+    if (result.config.zepProjectId) {
+        lines.push(`  Zep Project ID: ${result.config.zepProjectId}`);
+    }
+    lines.push('');
+    // Health checks with timing
+    lines.push(chalk_1.default.bold('Health Checks'));
+    for (const check of result.checks) {
+        const timing = check.durationMs ? ` (${formatDuration(check.durationMs)})` : '';
+        lines.push(`  ${getStatusIcon(check.status)} ${check.name}: ${check.message}${timing}`);
+        if (check.details) {
+            lines.push(`      ${chalk_1.default.dim(check.details)}`);
+        }
+    }
+    lines.push('');
+    // Transcript discovery
+    lines.push(chalk_1.default.bold('Transcript Discovery'));
+    lines.push(`  Search Paths:`);
+    for (const searchPath of result.transcripts.searchPaths) {
+        const exists = fs_extra_1.default.existsSync(searchPath);
+        lines.push(`    ${exists ? chalk_1.default.green('✓') : chalk_1.default.dim('-')} ${searchPath}`);
+    }
+    lines.push('');
+    if (result.transcripts.candidates.length > 0) {
+        lines.push(`  Found ${result.transcripts.candidates.length} transcript(s):`);
+        for (const candidate of result.transcripts.candidates) {
+            const isSelected = candidate.path === result.transcripts.selected;
+            const prefix = isSelected ? chalk_1.default.green('→') : ' ';
+            const date = candidate.mtime.toISOString().replace('T', ' ').slice(0, 19);
+            lines.push(`    ${prefix} ${candidate.path}`);
+            lines.push(`      ${chalk_1.default.dim(`Modified: ${date}, Size: ${formatSize(candidate.sizeBytes)}`)}`);
+        }
+    }
+    else {
+        lines.push(`  ${chalk_1.default.yellow('No transcripts found')}`);
+    }
+    lines.push('');
+    // Summary
+    lines.push(chalk_1.default.bold('Summary'));
+    const checkCounts = {
+        ok: result.checks.filter((c) => c.status === 'ok').length,
+        warning: result.checks.filter((c) => c.status === 'warning').length,
+        error: result.checks.filter((c) => c.status === 'error').length,
+    };
+    lines.push(`  Checks: ${chalk_1.default.green(checkCounts.ok + ' passed')}, ${chalk_1.default.yellow(checkCounts.warning + ' warnings')}, ${chalk_1.default.red(checkCounts.error + ' errors')}`);
+    lines.push(`  Total Duration: ${formatDuration(result.totalDurationMs)}`);
+    lines.push('');
+    lines.push(`Overall Status: ${getStatusText(result.overallStatus)}`);
+    return lines.join('\n');
+}
+/**
+ * Format JSON output.
+ */
+function formatJsonOutput(result) {
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Get exit code based on overall status.
+ * 0 = ok, 1 = warning, 2 = error
+ */
+function getExitCode(status) {
+    switch (status) {
+        case 'ok':
+            return 0;
+        case 'warning':
+            return 1;
+        case 'error':
+            return 2;
+    }
+}
+// ============================================================================
+// Exported Command Handler
+// ============================================================================
+/**
+ * Execute the doctor command with specified options.
+ */
+async function doctorCommand(opts, services) {
+    const result = await runDoctor(opts, services);
+    // Format and output
+    if (opts.json) {
+        console.log(formatJsonOutput(result));
+    }
+    else if (opts.verbose) {
+        console.log(formatVerboseOutput(result));
+    }
+    else {
+        console.log(formatBasicOutput(result));
+    }
+    // Set exit code
+    process.exitCode = getExitCode(result.overallStatus);
+}
+//# sourceMappingURL=doctor.js.map