@compass-ai/nova 1.0.73 → 1.0.74

package/dist/commands/slash/help.js

@@ -0,0 +1,282 @@
+/**
+ * Slash /help command implementation displaying available commands organized by category
+ * with descriptions, usage examples, and aliases.
+ *
+ * This command provides users with comprehensive help information about all available
+ * slash commands within the interactive Compass CLI session. It supports filtering
+ * by topic/command name and displays categorized command listings.
+ */
+import chalk from 'chalk';
+import { registerSlashCommand, getSlashCommandHelp, } from '../../core/slash-command-handler.js';
+import { SLASH_COMMANDS, formatFullHelp, formatCommandHelp, formatHelpCategory, } from '../../templates/help.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Parses command arguments into help options
+ */
+function parseHelpArgs(args) {
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg.toLowerCase()) {
+            case '--all':
+            case '-a':
+                options.all = true;
+                break;
+            case '--json':
+            case '-j':
+                options.json = true;
+                break;
+            case '--compact':
+            case '-c':
+                options.compact = true;
+                break;
+            case '--category':
+            case '-cat':
+                i++;
+                if (i < args.length) {
+                    options.category = args[i];
+                }
+                break;
+            default:
+                // Treat non-flag arguments as topic
+                if (!arg.startsWith('-') && !options.topic) {
+                    options.topic = arg;
+                }
+                break;
+        }
+    }
+    return options;
+}
+/**
+ * Formats help output as JSON
+ */
+function formatHelpAsJson(categories, topic) {
+    if (topic) {
+        // Find specific command
+        for (const category of categories) {
+            const command = category.commands.find((cmd) => cmd.name === `/${topic}` ||
+                cmd.name === topic ||
+                cmd.aliases?.includes(topic) ||
+                cmd.aliases?.includes(`/${topic}`));
+            if (command) {
+                return JSON.stringify({
+                    command: command.name,
+                    description: command.description,
+                    usage: command.usage,
+                    aliases: command.aliases,
+                    examples: command.examples,
+                    category: category.name,
+                }, null, 2);
+            }
+        }
+        return JSON.stringify({ error: `Command not found: ${topic}` }, null, 2);
+    }
+    // Return all commands (excluding hidden ones)
+    const output = categories
+        .map((category) => ({
+        name: category.name,
+        description: category.description,
+        commands: category.commands
+            .filter((cmd) => !cmd.hidden)
+            .map((cmd) => ({
+            name: cmd.name,
+            description: cmd.description,
+            usage: cmd.usage,
+            aliases: cmd.aliases,
+            examples: cmd.examples,
+        })),
+    }))
+        .filter((category) => category.commands.length > 0);
+    return JSON.stringify(output, null, 2);
+}
+/**
+ * Formats compact help output
+ */
+function formatCompactHelp(categories) {
+    const lines = [
+        '',
+        chalk.bold.cyan('Compass CLI Commands'),
+        '',
+    ];
+    for (const category of categories) {
+        const visibleCommands = category.commands.filter((cmd) => !cmd.hidden);
+        if (visibleCommands.length === 0)
+            continue;
+        const commandNames = visibleCommands
+            .map((cmd) => chalk.yellow(cmd.name))
+            .join(', ');
+        lines.push(`${chalk.gray(category.name + ':')} ${commandNames}`);
+    }
+    lines.push('');
+    lines.push(chalk.gray('Use /help <command> for detailed information'));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Displays help for a specific command or topic
+ */
+function displayTopicHelp(topic) {
+    // Normalize the topic (remove leading slash if present)
+    const normalizedTopic = topic.startsWith('/') ? topic.slice(1) : topic;
+    // First, try to get help from the template
+    const templateHelp = formatCommandHelp(normalizedTopic);
+    if (templateHelp) {
+        logger.output(templateHelp);
+        return;
+    }
+    // Try to get help from the registry
+    const registryHelp = getSlashCommandHelp(normalizedTopic);
+    if (registryHelp) {
+        logger.output('');
+        logger.output(registryHelp);
+        logger.output('');
+        return;
+    }
+    // Check if it's a category name
+    const matchingCategory = SLASH_COMMANDS.find((cat) => cat.name.toLowerCase().includes(normalizedTopic.toLowerCase()));
+    if (matchingCategory) {
+        logger.output(formatHelpCategory(matchingCategory));
+        return;
+    }
+    // Search for partial matches
+    const allCommands = SLASH_COMMANDS.flatMap((cat) => cat.commands);
+    const partialMatches = allCommands.filter((cmd) => cmd.name.toLowerCase().includes(normalizedTopic.toLowerCase()) ||
+        cmd.description.toLowerCase().includes(normalizedTopic.toLowerCase()));
+    if (partialMatches.length > 0) {
+        logger.output('');
+        logger.output(chalk.yellow(`No exact match for "${topic}". Did you mean:`));
+        logger.output('');
+        for (const match of partialMatches.slice(0, 5)) {
+            logger.output(`  ${chalk.cyan(match.name)} - ${match.description}`);
+        }
+        logger.output('');
+        return;
+    }
+    // No matches found
+    logger.output('');
+    logger.output(chalk.yellow(`No help found for: ${topic}`));
+    logger.output(chalk.gray('Use /help to see all available commands'));
+    logger.output('');
+}
+/**
+ * Displays help for a specific category
+ */
+function displayCategoryHelp(categoryName) {
+    const matchingCategories = SLASH_COMMANDS.filter((cat) => cat.name.toLowerCase().includes(categoryName.toLowerCase()));
+    if (matchingCategories.length === 0) {
+        logger.output('');
+        logger.output(chalk.yellow(`No category found matching: ${categoryName}`));
+        logger.output('');
+        logger.output(chalk.gray('Available categories:'));
+        for (const cat of SLASH_COMMANDS) {
+            logger.output(`  ${chalk.cyan(cat.name)}`);
+        }
+        logger.output('');
+        return;
+    }
+    for (const category of matchingCategories) {
+        logger.output(formatHelpCategory(category));
+    }
+}
+/**
+ * Displays the full help menu
+ */
+function displayFullHelp() {
+    logger.output(formatFullHelp());
+}
+/**
+ * Handler for the /help slash command.
+ *
+ * Displays available commands organized by category with descriptions,
+ * usage examples, and aliases. Supports filtering by topic or category.
+ *
+ * @param args - Command arguments
+ *   - No args: Show full help menu
+ *   - [topic]: Show help for specific command or topic
+ *   - --category <name>: Show commands in a specific category
+ *   - --all: Show all commands including aliases
+ *   - --compact: Show compact command listing
+ *   - --json: Output as JSON
+ *
+ * @example
+ * ```
+ * /help              # Show full help menu
+ * /help model        # Show help for /model command
+ * /help session      # Show session-related commands
+ * /help --compact    # Show compact listing
+ * /help --json       # Output as JSON
+ * ```
+ */
+export const helpHandler = async (args) => {
+    const options = parseHelpArgs(args);
+    try {
+        // JSON output
+        if (options.json) {
+            const jsonOutput = formatHelpAsJson(SLASH_COMMANDS, options.topic);
+            logger.output(jsonOutput);
+            return;
+        }
+        // Compact output
+        if (options.compact) {
+            logger.output(formatCompactHelp(SLASH_COMMANDS));
+            return;
+        }
+        // Category-specific help
+        if (options.category) {
+            displayCategoryHelp(options.category);
+            return;
+        }
+        // Topic-specific help
+        if (options.topic) {
+            displayTopicHelp(options.topic);
+            return;
+        }
+        // Full help menu
+        displayFullHelp();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Failed to display help';
+        logger.error('Help command failed', error);
+        logger.output(chalk.red(`❌ ${errorMessage}`));
+    }
+};
+/**
+ * Registers the /help slash command with the command handler
+ */
+export function registerHelpCommand() {
+    registerSlashCommand({
+        name: 'help',
+        aliases: ['h', '?'],
+        description: 'Show help menu with available commands',
+        usage: '/help [topic] [--category <name>] [--compact] [--json]',
+        examples: [
+            '/help',
+            '/help model',
+            '/help save',
+            '/help --category session',
+            '/help --compact',
+            '/help --json',
+        ],
+        handler: helpHandler,
+    });
+}
+/**
+ * Command definition for external registration
+ */
+export const helpCommand = {
+    name: 'help',
+    aliases: ['h', '?'],
+    description: 'Show help menu with available commands',
+    usage: '/help [topic] [--category <name>] [--compact] [--json]',
+    examples: [
+        '/help',
+        '/help model',
+        '/help save',
+        '/help --category session',
+        '/help --compact',
+        '/help --json',
+    ],
+    handler: helpHandler,
+};
+export default helpHandler;
+//# sourceMappingURL=help.js.map

package/dist/commands/slash/help.js.map

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

package/dist/commands/slash/index-cmd.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Slash /index command implementation for triggering project file reindexing
+ * with progress display. This command rebuilds the codebase index to ensure
+ * accurate file discovery, semantic search, and dependency analysis.
+ */
+/**
+ * Handles the /index slash command.
+ * Triggers project file reindexing with progress display.
+ *
+ * @param args - Command arguments
+ *   - --force, -f: Force full reindex, ignoring cache
+ *   - --verbose, -v: Show verbose output during indexing
+ *   - --pattern, -p <pattern>: Only index files matching pattern
+ *   - --json, -j: Output results as JSON
+ *   - --dry-run, -n: Show what would be indexed without actually indexing
+ *   - --max-depth, -d <num>: Maximum directory depth to traverse
+ *
+ * @example
+ * ```
+ * /index                    # Reindex all project files
+ * /index --force            # Force full reindex
+ * /index --verbose          # Show detailed progress
+ * /index --pattern "*.ts"   # Only index TypeScript files
+ * /index --dry-run          # Preview what would be indexed
+ * /index --json             # Output results as JSON
+ * ```
+ */
+export declare function handleIndexCommand(args: string[]): Promise<void>;
+/**
+ * Slash command definition for registration
+ */
+export declare const indexCommand: {
+    name: string;
+    aliases: string[];
+    description: string;
+    usage: string;
+    examples: string[];
+    handler: typeof handleIndexCommand;
+};
+export default handleIndexCommand;
+//# sourceMappingURL=index-cmd.d.ts.map

package/dist/commands/slash/index-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../../src/commands/slash/index-cmd.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuUH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEtE;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;CAcxB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/commands/slash/index-cmd.js

@@ -0,0 +1,349 @@
+/**
+ * Slash /index command implementation for triggering project file reindexing
+ * with progress display. This command rebuilds the codebase index to ensure
+ * accurate file discovery, semantic search, and dependency analysis.
+ */
+import chalk from 'chalk';
+import { logger } from '../../utils/logger.js';
+import { getCodebaseIndexer } from '../../services/codebase-indexer.js';
+import { getConfigManager } from '../../services/config-manager.js';
+import { formatDuration, formatFileSize } from '../../utils/format.js';
+import { getEventEmitter } from '../../core/event-emitter.js';
+import { getProjectRoot } from '../../services/agent-manager.js';
+/**
+ * Emits output for the index command via the event system
+ * This allows the UI to capture and display the output in real-time
+ */
+function emitOutput(message, isError = false) {
+    const eventEmitter = getEventEmitter();
+    eventEmitter.emit('slash-command-output', {
+        command: 'index',
+        message,
+        isError,
+    });
+}
+/**
+ * Parses command arguments into options
+ */
+function parseArguments(args) {
+    const options = {};
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        switch (arg) {
+            case '--force':
+            case '-f':
+                options.force = true;
+                break;
+            case '--verbose':
+            case '-v':
+                options.verbose = true;
+                break;
+            case '--json':
+            case '-j':
+                options.json = true;
+                break;
+            case '--dry-run':
+            case '-n':
+                options.dryRun = true;
+                break;
+            case '--pattern':
+            case '-p':
+                i++;
+                if (i < args.length) {
+                    options.pattern = args[i];
+                }
+                break;
+            case '--max-depth':
+            case '-d':
+                i++;
+                if (i < args.length) {
+                    const depth = parseInt(args[i], 10);
+                    if (!isNaN(depth) && depth > 0) {
+                        options.maxDepth = depth;
+                    }
+                }
+                break;
+            default:
+                // Treat non-flag arguments as patterns
+                if (!arg.startsWith('-')) {
+                    options.pattern = arg;
+                }
+                break;
+        }
+        i++;
+    }
+    return options;
+}
+/**
+ * Formats the indexing result for display
+ */
+function formatResult(result, _options) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold.green('✅ Indexing Complete'));
+    lines.push(chalk.dim('─'.repeat(50)));
+    lines.push('');
+    // Summary statistics
+    lines.push(chalk.bold('📊 Summary'));
+    lines.push(`  ${chalk.cyan('Total files indexed:')} ${result.totalFiles.toLocaleString()}`);
+    lines.push(`  ${chalk.green('New files:')} ${result.newFiles.toLocaleString()}`);
+    lines.push(`  ${chalk.yellow('Updated files:')} ${result.updatedFiles.toLocaleString()}`);
+    lines.push(`  ${chalk.red('Removed files:')} ${result.removedFiles.toLocaleString()}`);
+    lines.push(`  ${chalk.gray('Skipped files:')} ${result.skippedFiles.toLocaleString()}`);
+    lines.push('');
+    // Size and timing
+    lines.push(chalk.bold('⏱️  Performance'));
+    lines.push(`  ${chalk.cyan('Total size:')} ${formatFileSize(result.totalSize)}`);
+    lines.push(`  ${chalk.cyan('Duration:')} ${formatDuration(result.duration)}`);
+    lines.push(`  ${chalk.cyan('Speed:')} ${Math.round(result.totalFiles / (result.duration / 1000))} files/sec`);
+    lines.push('');
+    // Errors if any
+    if (result.errors.length > 0) {
+        lines.push(chalk.bold.yellow('⚠️  Warnings'));
+        for (const error of result.errors.slice(0, 5)) {
+            lines.push(`  ${chalk.yellow('•')} ${error}`);
+        }
+        if (result.errors.length > 5) {
+            lines.push(chalk.dim(`  ... and ${result.errors.length - 5} more`));
+        }
+        lines.push('');
+    }
+    // Tips
+    lines.push(chalk.dim('💡 Tip: Use /files to browse indexed files'));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Formats the result as JSON
+ */
+function formatResultAsJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+/**
+ * Creates a simple progress display for the terminal
+ */
+function createProgressDisplay(verbose) {
+    let lastUpdate = 0;
+    const updateInterval = 100; // Update every 100ms at most
+    return (current, total, currentFile) => {
+        const now = Date.now();
+        if (now - lastUpdate < updateInterval && current < total) {
+            return;
+        }
+        lastUpdate = now;
+        const percent = total > 0 ? Math.round((current / total) * 100) : 0;
+        const barWidth = 30;
+        const filled = Math.round((percent / 100) * barWidth);
+        const empty = barWidth - filled;
+        const bar = '█'.repeat(filled) + '░'.repeat(empty);
+        if (verbose) {
+            // Clear line and show detailed progress
+            process.stdout.write(`\r${chalk.cyan('Indexing:')} [${bar}] ${percent}% (${current}/${total})`);
+            if (currentFile) {
+                const truncatedFile = currentFile.length > 40 ? '...' + currentFile.slice(-37) : currentFile;
+                process.stdout.write(chalk.dim(` ${truncatedFile}`));
+            }
+            // Clear to end of line
+            process.stdout.write('\x1b[K');
+        }
+        else if (current === total) {
+            // Only show completion in non-verbose mode
+            process.stdout.write(`\r${chalk.cyan('Indexing:')} [${bar}] ${percent}%\x1b[K\n`);
+        }
+    };
+}
+/**
+ * Performs the actual indexing operation
+ */
+async function performIndexing(projectRoot, options, onProgress) {
+    const startTime = Date.now();
+    const errors = [];
+    let totalFiles = 0;
+    let newFiles = 0;
+    let updatedFiles = 0;
+    let removedFiles = 0;
+    let skippedFiles = 0;
+    let totalSize = 0;
+    try {
+        const indexer = await getCodebaseIndexer();
+        const configManager = getConfigManager();
+        const config = configManager.getConfig();
+        // Configure indexer options
+        const indexerOptions = {
+            force: options.force,
+            pattern: options.pattern,
+            maxDepth: options.maxDepth,
+            ignorePatterns: config.project?.ignorePatterns || [],
+            includePatterns: config.project?.includePatterns || ['**/*'],
+            maxFileSize: config.project?.maxFileSize || 1024 * 1024, // 1MB default
+        };
+        if (options.dryRun) {
+            // Dry run - just count files without actually indexing
+            const files = await indexer.discoverFiles(projectRoot, indexerOptions);
+            totalFiles = files.length;
+            for (const file of files) {
+                if (file.size) {
+                    totalSize += file.size;
+                }
+                if (onProgress) {
+                    onProgress(totalFiles, files.length, file.path);
+                }
+            }
+        }
+        else {
+            // Actual indexing
+            const result = await indexer.indexProject(projectRoot, {
+                ...indexerOptions,
+                onProgress: (current, total, file) => {
+                    totalFiles = current;
+                    if (onProgress) {
+                        onProgress(current, total, file);
+                    }
+                },
+                onFileIndexed: (file, status) => {
+                    switch (status) {
+                        case 'new':
+                            newFiles++;
+                            break;
+                        case 'updated':
+                            updatedFiles++;
+                            break;
+                        case 'skipped':
+                            skippedFiles++;
+                            break;
+                    }
+                    if (file.size) {
+                        totalSize += file.size;
+                    }
+                },
+                onError: (file, error) => {
+                    errors.push(`${file}: ${error}`);
+                },
+            });
+            totalFiles = result.totalFiles;
+            removedFiles = result.removedFiles || 0;
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error during indexing';
+        errors.push(errorMessage);
+        logger.error('Indexing failed', error);
+    }
+    const duration = Date.now() - startTime;
+    return {
+        totalFiles,
+        newFiles,
+        updatedFiles,
+        removedFiles,
+        skippedFiles,
+        totalSize,
+        duration,
+        errors,
+        completedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Handles the /index slash command.
+ * Triggers project file reindexing with progress display.
+ *
+ * @param args - Command arguments
+ *   - --force, -f: Force full reindex, ignoring cache
+ *   - --verbose, -v: Show verbose output during indexing
+ *   - --pattern, -p <pattern>: Only index files matching pattern
+ *   - --json, -j: Output results as JSON
+ *   - --dry-run, -n: Show what would be indexed without actually indexing
+ *   - --max-depth, -d <num>: Maximum directory depth to traverse
+ *
+ * @example
+ * ```
+ * /index                    # Reindex all project files
+ * /index --force            # Force full reindex
+ * /index --verbose          # Show detailed progress
+ * /index --pattern "*.ts"   # Only index TypeScript files
+ * /index --dry-run          # Preview what would be indexed
+ * /index --json             # Output results as JSON
+ * ```
+ */
+export async function handleIndexCommand(args) {
+    const options = parseArguments(args);
+    const projectRoot = getProjectRoot();
+    try {
+        // Show initial message
+        if (!options.json) {
+            if (options.dryRun) {
+                emitOutput(chalk.cyan('\n🔍 Dry run: Discovering files to index...\n'));
+            }
+            else if (options.force) {
+                emitOutput(chalk.cyan('\n🔄 Force reindexing project files...\n'));
+            }
+            else {
+                emitOutput(chalk.cyan('\n📇 Indexing project files...\n'));
+            }
+            if (options.pattern) {
+                emitOutput(chalk.dim(`  Pattern: ${options.pattern}\n`));
+            }
+        }
+        // Create progress callback
+        const progressCallback = options.json ? undefined : createProgressDisplay(options.verbose || false);
+        // Perform indexing
+        const result = await performIndexing(projectRoot, options, progressCallback);
+        // Clear progress line if verbose
+        if (options.verbose && !options.json) {
+            process.stdout.write('\n');
+        }
+        // Emit event for other components
+        const eventEmitter = getEventEmitter();
+        eventEmitter.emit('file-modified', {
+            path: projectRoot,
+            operation: 'modify',
+        });
+        // Output results
+        if (options.json) {
+            emitOutput(formatResultAsJson(result));
+        }
+        else {
+            emitOutput(formatResult(result, options));
+        }
+        // Log completion
+        logger.debug('Indexing completed', {
+            totalFiles: result.totalFiles,
+            duration: result.duration,
+            errors: result.errors.length,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Failed to index project';
+        logger.error('Index command failed', error);
+        if (options.json) {
+            emitOutput(JSON.stringify({
+                success: false,
+                error: errorMessage,
+            }, null, 2), true);
+        }
+        else {
+            emitOutput(chalk.red(`\n❌ Error: ${errorMessage}\n`), true);
+            emitOutput(chalk.dim('Try running with --verbose for more details.\n'));
+        }
+    }
+}
+/**
+ * Slash command definition for registration
+ */
+export const indexCommand = {
+    name: 'index',
+    aliases: ['reindex', 'scan'],
+    description: 'Reindex project files for improved search and context',
+    usage: '/index [options]',
+    examples: [
+        '/index',
+        '/index --force',
+        '/index --verbose',
+        '/index --pattern "*.ts"',
+        '/index --dry-run',
+        '/index --json',
+    ],
+    handler: handleIndexCommand,
+};
+export default handleIndexCommand;
+//# sourceMappingURL=index-cmd.js.map