@windagency/valora 2.0.1

package/dist/cli/command-palette.js

@@ -0,0 +1,246 @@
+/**
+ * Command Palette - Fuzzy searchable command launcher
+ *
+ * Provides interactive command discovery when running 'ai' with no arguments
+ */
+import { CommandLoader } from '../executor/command-loader.js';
+import { getColorAdapter } from '../output/color-adapter.interface.js';
+import { getHeaderFormatter } from '../output/header-formatter.js';
+import { getPromptAdapter } from '../ui/prompt-adapter.interface.js';
+const prompt = getPromptAdapter();
+export class CommandPalette {
+    commandLoader;
+    recentCommands = [];
+    constructor(commandLoader) {
+        this.commandLoader = commandLoader ?? new CommandLoader();
+        this.loadRecentCommands();
+    }
+    /**
+     * Load recent commands from history
+     */
+    loadRecentCommands() {
+        try {
+            // TODO: Load from ~/.valora/history.json or similar
+            // For now, using empty array
+            this.recentCommands = [];
+        }
+        catch {
+            // Silently fail - not critical
+        }
+    }
+    /**
+     * Save command to history
+     */
+    saveToHistory(command, args) {
+        try {
+            this.recentCommands.unshift({
+                args,
+                command,
+                timestamp: new Date()
+            });
+            // Keep only last 10
+            this.recentCommands = this.recentCommands.slice(0, 10);
+            // TODO: Persist to ~/.valora/history.json
+        }
+        catch {
+            // Silently fail - not critical
+        }
+    }
+    /**
+     * Get all available commands
+     */
+    async getAvailableCommands() {
+        const commandsMap = await this.commandLoader.loadAllCommands();
+        const commands = Array.from(commandsMap.values());
+        return commands.map((cmd) => ({
+            description: cmd.description ?? 'No description available',
+            name: cmd.name,
+            phase: this.inferPhase(cmd.name),
+            value: cmd.name
+        }));
+    }
+    /**
+     * Infer workflow phase from command name
+     */
+    inferPhase(commandName) {
+        const phaseMap = {
+            assert: 'test',
+            commit: 'finalize',
+            'create-backlog': 'initialize',
+            'create-pr': 'finalize',
+            'create-prd': 'initialize',
+            feedback: 'learn',
+            'fetch-task': 'prepare',
+            'gather-knowledge': 'workflow',
+            implement: 'implement',
+            plan: 'workflow',
+            'refine-specs': 'initialize',
+            'refine-task': 'prepare',
+            'review-code': 'review',
+            'review-functional': 'review',
+            'review-plan': 'workflow',
+            test: 'test'
+        };
+        return phaseMap[commandName] ?? 'other';
+    }
+    /**
+     * Show the command palette
+     */
+    async show() {
+        const color = getColorAdapter();
+        const headerFormatter = getHeaderFormatter();
+        const title = '🎯 What would you like to do?';
+        const subtitle = 'Type to search commands, workflows, or tasks...';
+        console.log(headerFormatter.formatMultiLineHeader([title, subtitle]));
+        const commands = await this.getAvailableCommands();
+        // Group commands by phase
+        const commandsByPhase = commands.reduce((acc, cmd) => {
+            acc[cmd.phase] ??= [];
+            // Type guard ensures acc[cmd.phase] is defined after the check above
+            const phaseArray = acc[cmd.phase];
+            if (phaseArray) {
+                phaseArray.push(cmd);
+            }
+            return acc;
+        }, {});
+        // Build choices array with separators
+        const choices = [];
+        // Add recent commands section if any
+        if (this.recentCommands.length > 0) {
+            choices.push(new prompt.Separator(color.bold('Recent commands:')));
+            this.recentCommands.slice(0, 3).forEach((recent) => {
+                const cmd = commands.find((c) => c.name === recent.command);
+                if (cmd) {
+                    choices.push({
+                        ...cmd,
+                        name: `${cmd.name} ${recent.args.join(' ')}`.trim()
+                    });
+                }
+            });
+            choices.push(new prompt.Separator());
+        }
+        // Add commands grouped by phase
+        const phaseOrder = ['workflow', 'implement', 'test', 'review', 'finalize', 'prepare', 'initialize', 'learn'];
+        phaseOrder.forEach((phase) => {
+            if (commandsByPhase[phase] && commandsByPhase[phase].length > 0) {
+                choices.push(new prompt.Separator(color.bold(`${phase.charAt(0).toUpperCase() + phase.slice(1)}:`)));
+                commandsByPhase[phase].forEach((cmd) => choices.push(cmd));
+            }
+        });
+        // Add quick actions
+        choices.push(new prompt.Separator());
+        choices.push(new prompt.Separator(color.bold('Quick actions:')));
+        choices.push({
+            description: 'Configure settings',
+            name: 'config',
+            phase: 'other',
+            value: 'config'
+        });
+        choices.push({
+            description: 'Check system health',
+            name: 'doctor',
+            phase: 'other',
+            value: 'doctor'
+        });
+        choices.push({
+            description: 'List all commands',
+            name: 'list',
+            phase: 'other',
+            value: 'list'
+        });
+        choices.push({
+            description: 'Exit',
+            name: 'exit',
+            phase: 'other',
+            value: 'exit'
+        });
+        try {
+            const answer = await prompt.prompt([
+                {
+                    choices,
+                    loop: false,
+                    message: 'Select a command:',
+                    name: 'command',
+                    pageSize: 15,
+                    type: 'list'
+                }
+            ]);
+            if (answer.command === 'exit') {
+                return null;
+            }
+            return answer.command;
+        }
+        catch {
+            // User cancelled (Ctrl+C)
+            return null;
+        }
+    }
+    /**
+     * Show command palette with autocomplete search
+     * Note: Requires inquirer-autocomplete-prompt plugin
+     */
+    async showWithSearch() {
+        // Fall back to regular list since autocomplete requires additional plugin
+        return this.show();
+    }
+    /**
+     * Show quick action menu
+     */
+    async showQuickActions() {
+        const color = getColorAdapter();
+        const headerFormatter = getHeaderFormatter();
+        console.log(headerFormatter.formatHeader('⚡ Quick Actions', { width: 58 }));
+        const choices = [
+            {
+                name: color.cyan('Continue last session'),
+                value: 'session:resume'
+            },
+            {
+                name: color.cyan('View available commands'),
+                value: 'list'
+            },
+            {
+                name: color.cyan('Configure settings'),
+                value: 'config'
+            },
+            {
+                name: color.cyan('Check system health'),
+                value: 'doctor'
+            },
+            {
+                name: color.cyan('View help'),
+                value: 'help'
+            },
+            new prompt.Separator(),
+            {
+                name: color.gray('Exit'),
+                value: 'exit'
+            }
+        ];
+        try {
+            const answer = await prompt.prompt([
+                {
+                    choices,
+                    message: 'What would you like to do?',
+                    name: 'action',
+                    type: 'list'
+                }
+            ]);
+            if (answer.action === 'exit') {
+                return null;
+            }
+            return answer.action;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Show command palette
+ */
+export async function showCommandPalette() {
+    const palette = new CommandPalette();
+    return palette.show();
+}
+//# sourceMappingURL=command-palette.js.map

package/dist/cli/command-palette.js.map

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

package/dist/cli/command-resolver.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Command Resolver - Handles command loading and provider resolution
+ */
+import type { CommandLoader } from '../executor/command-loader.js';
+import type { getProviderRegistry } from '../llm/registry.js';
+import type { CommandDefinition } from '../types/command.types.js';
+import type { MCPSamplingService } from '../types/mcp.types.js';
+import type { CommandExecutionOptions } from './command-executor.js';
+import type { CLIProviderResolver } from './provider-resolver.js';
+import { ProviderFallbackService, type ProviderResolutionPath } from './provider-fallback-service.js';
+export interface ResolvedCommand {
+    command: CommandDefinition;
+    mode?: string;
+    model?: string;
+    provider: ReturnType<ReturnType<typeof getProviderRegistry>['createProvider']>;
+    providerName: string;
+    resolutionPath?: ProviderResolutionPath;
+}
+export declare class CommandResolver {
+    private commandLoader;
+    private providerResolver;
+    private mcpSampling?;
+    private fallbackService;
+    constructor(commandLoader: CommandLoader, providerResolver: CLIProviderResolver, mcpSampling?: MCPSamplingService | undefined, fallbackService?: ProviderFallbackService);
+    /**
+     * Load and resolve command with provider using three-tier fallback
+     */
+    resolveCommand(commandName: string, options: CommandExecutionOptions): Promise<ResolvedCommand>;
+    /**
+     * Attempt provider resolution with error handling
+     */
+    private attemptProviderResolution;
+    /**
+     * Perform fallback resolution using ProviderFallbackService
+     */
+    private performFallbackResolution;
+    /**
+     * Validate model availability
+     */
+    private validateModelAvailability;
+}
+//# sourceMappingURL=command-resolver.d.ts.map

package/dist/cli/command-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/command-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAM1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAkB,MAAM,6BAA6B,CAAC;AAEnH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACxC;AAED,qBAAa,eAAe;IAI1B,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,WAAW,CAAC;IALrB,OAAO,CAAC,eAAe,CAA0B;gBAGxC,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,mBAAmB,EACrC,WAAW,CAAC,EAAE,kBAAkB,YAAA,EACxC,eAAe,CAAC,EAAE,uBAAuB;IAM1C;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;IA8BrG;;OAEG;YACW,yBAAyB;IA2CvC;;OAEG;YACW,yBAAyB;IAoEvC;;OAEG;YACW,yBAAyB;CAwBvC"}

package/dist/cli/command-resolver.js

@@ -0,0 +1,140 @@
+/**
+ * Command Resolver - Handles command loading and provider resolution
+ */
+import { ProviderName } from '../config/providers.config.js';
+import { getLogger } from '../output/logger.js';
+import { ExecutionError } from '../utils/error-handler.js';
+import { ProviderFallbackService, ResolutionPath } from './provider-fallback-service.js';
+export class CommandResolver {
+    commandLoader;
+    providerResolver;
+    mcpSampling;
+    fallbackService;
+    constructor(commandLoader, providerResolver, mcpSampling, fallbackService) {
+        this.commandLoader = commandLoader;
+        this.providerResolver = providerResolver;
+        this.mcpSampling = mcpSampling;
+        // Use injected fallbackService or create one (for backwards compatibility)
+        this.fallbackService = fallbackService ?? new ProviderFallbackService(providerResolver);
+    }
+    /**
+     * Load and resolve command with provider using three-tier fallback
+     */
+    async resolveCommand(commandName, options) {
+        const logger = getLogger();
+        // Load command definition
+        const command = await this.commandLoader.loadCommand(commandName);
+        // Resolve provider with fallback handling
+        const providerInfo = await this.attemptProviderResolution(command.model, options, logger);
+        // Perform fallback resolution
+        const resolution = await this.performFallbackResolution(providerInfo, logger);
+        // Validate model availability
+        await this.validateModelAvailability(resolution.model, resolution.providerName, resolution.provider, resolution.resolutionPath);
+        return {
+            command,
+            mode: resolution.mode,
+            model: resolution.model,
+            provider: resolution.provider,
+            providerName: resolution.providerName,
+            resolutionPath: resolution.resolutionPath
+        };
+    }
+    /**
+     * Attempt provider resolution with error handling
+     */
+    async attemptProviderResolution(commandModel, options, logger) {
+        try {
+            const resolved = await this.providerResolver.resolveProvider(commandModel, options);
+            return {
+                mode: resolved.mode,
+                model: resolved.model,
+                providerConfig: resolved.providerConfig,
+                providerName: resolved.providerName,
+                shouldAttemptFallback: false
+            };
+        }
+        catch (err) {
+            // If provider resolution failed due to missing configuration, attempt fallback
+            if (err instanceof ExecutionError) {
+                logger.debug(`Provider resolution failed, will attempt fallback: ${err.message}`);
+                // Check if we're in MCP context (running in Cursor)
+                if (process.env['AI_MCP_ENABLED'] === 'true') {
+                    // Set up for fallback attempt
+                    return {
+                        mode: undefined,
+                        model: commandModel,
+                        providerConfig: {},
+                        providerName: ProviderName.CURSOR,
+                        shouldAttemptFallback: true
+                    };
+                }
+            }
+            // For other errors or non-MCP context, rethrow
+            throw err;
+        }
+    }
+    /**
+     * Perform fallback resolution using ProviderFallbackService
+     */
+    async performFallbackResolution(providerInfo, logger) {
+        const inMCPContext = process.env['AI_MCP_ENABLED'] === 'true';
+        try {
+            const resolution = await this.fallbackService.resolveWithFallback({
+                inMCPContext,
+                mode: providerInfo.mode,
+                model: providerInfo.model,
+                providerConfig: providerInfo.providerConfig || {},
+                providerName: providerInfo.providerName
+            }, this.mcpSampling);
+            // Log resolution path
+            if (resolution.fallbackReason) {
+                logger.debug(`Provider fallback: ${resolution.fallbackReason}`, {
+                    providerName: resolution.providerName,
+                    resolutionPath: resolution.resolutionPath
+                });
+            }
+            return {
+                mode: providerInfo.mode,
+                model: providerInfo.model,
+                provider: resolution.provider,
+                providerName: resolution.providerName,
+                resolutionPath: resolution.resolutionPath
+            };
+        }
+        catch (err) {
+            const errorMessage = err.message;
+            logger.error(`Provider resolution failed completely: ${errorMessage}`, err);
+            // If we get here and we're in MCP context with no API keys, provide helpful guidance
+            if (inMCPContext && providerInfo.shouldAttemptFallback) {
+                throw new ExecutionError('Provider resolution failed. In Cursor, you have three options:\n' +
+                    '1. Use guided completion mode (current - no setup needed)\n' +
+                    '2. Configure API keys: valora config setup --quick\n' +
+                    '3. Wait for Cursor to add native MCP sampling support', {
+                    errorDetails: errorMessage,
+                    inMCPContext,
+                    suggestion: 'guided_completion_mode'
+                });
+            }
+            throw err;
+        }
+    }
+    /**
+     * Validate model availability
+     */
+    async validateModelAvailability(model, providerName, provider, resolutionPath) {
+        // Validate model availability if model is specified
+        // This provides early detection before attempting to use the model
+        if (model && resolutionPath !== ResolutionPath.GUIDED) {
+            // Skip validation for guided mode as it doesn't use models directly
+            const isAvailable = await provider.validateModel(model);
+            if (!isAvailable) {
+                const alternatives = provider.getAlternativeModels(model);
+                const alternativesText = alternatives.length > 0
+                    ? `\n\nSuggested alternatives:\n${alternatives.map((m) => `  • ${m}`).join('\n')}`
+                    : '';
+                throw new Error(`❌ Model '${model}' is not available or not supported by the '${providerName}' provider.${alternativesText}\n\nPlease specify a valid model name or check the provider documentation for available models.`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=command-resolver.js.map

package/dist/cli/command-resolver.js.map

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

package/dist/cli/command-suggestions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Intelligent Command Suggestions
+ *
+ * Suggests next logical commands based on workflow state and command execution results
+ */
+export interface CommandSuggestion {
+    command: string;
+    description: string;
+    priority: 'optional' | 'recommended';
+    reason?: string;
+}
+export interface WorkflowContext {
+    currentCommand: string;
+    filesModified?: number;
+    hasErrors?: boolean;
+    hasWarnings?: boolean;
+    previousCommands: string[];
+    sessionId?: string;
+    testsStatus?: 'failed' | 'passed' | 'pending';
+}
+export declare class CommandSuggestionEngine {
+    /**
+     * Get suggestions based on workflow context
+     */
+    getSuggestions(context: WorkflowContext): CommandSuggestion[];
+    /**
+     * Format suggestions for display
+     */
+    formatSuggestions(suggestions: CommandSuggestion[]): string;
+    /**
+     * Show interactive suggestion prompt
+     */
+    promptForNext(context: WorkflowContext): Promise<null | string>;
+    /**
+     * Get auto-next command (highest priority suggestion)
+     */
+    getAutoNext(context: WorkflowContext): null | string;
+}
+/**
+ * Show command suggestions after execution
+ */
+export declare function showSuggestions(currentCommand: string, options?: {
+    hasErrors?: boolean;
+    hasWarnings?: boolean;
+    previousCommands?: string[];
+    sessionId?: string;
+    testsStatus?: 'failed' | 'passed' | 'pending';
+}): Promise<null | string>;
+//# sourceMappingURL=command-suggestions.d.ts.map

package/dist/cli/command-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-suggestions.d.ts","sourceRoot":"","sources":["../../src/cli/command-suggestions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,aAAa,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9C;AAoFD,qBAAa,uBAAuB;IACnC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAuC7D;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,MAAM;IA0B3D;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IAqCrE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM;CAOpD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACR,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,GACJ,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAuBxB"}