@windagency/valora 2.0.1

package/dist/cli/presenters/review-code-presenter.js

@@ -0,0 +1,197 @@
+/**
+ * Review Code Presenter - Displays code review summary
+ */
+import { BasePresenter } from './base-presenter.js';
+/**
+ * Presenter for review-code command output
+ */
+export class ReviewCodePresenter extends BasePresenter {
+    constructor(console, renderer) {
+        super(console, renderer);
+    }
+    display(outputs) {
+        this.displaySummaryBox('Code Review Summary');
+        this.displayDecision(outputs);
+        this.displayChangedFiles(outputs);
+        this.displayValidationResults(outputs);
+        this.displayIssues(outputs);
+        this.displayBlockingIssues(outputs);
+        this.displaySecurityConcerns(outputs);
+        this.displayRecommendations(outputs);
+        this.displayNextSteps(outputs);
+        this.displaySummaryFooter();
+    }
+    getCommandName() {
+        return 'review-code';
+    }
+    displayBlockingIssues(outputs) {
+        const blockingIssues = this.getArray(outputs, 'blocking_issues');
+        if (!blockingIssues || blockingIssues.length === 0)
+            return;
+        this.console.print(`\n🚨 Blocking Issues (${blockingIssues.length}):`);
+        for (const issue of blockingIssues.slice(0, 3)) {
+            const desc = issue.description ?? 'Blocking issue';
+            this.console.print(`   • ${desc}`);
+            if (issue.file) {
+                this.console.print(`     at ${issue.file}`);
+            }
+            if (issue.impact) {
+                this.console.print(`     Impact: ${issue.impact}`);
+            }
+        }
+        if (blockingIssues.length > 3) {
+            this.console.print(`   ... and ${blockingIssues.length - 3} more`);
+        }
+    }
+    displayChangedFiles(outputs) {
+        const changedFiles = this.getArray(outputs, 'changed_files');
+        if (!changedFiles || changedFiles.length === 0)
+            return;
+        this.console.print(`\n📁 Files Reviewed (${changedFiles.length}):`);
+        this.displayList(changedFiles, (file) => {
+            const filePath = file.path ?? file.file ?? 'Unknown file';
+            const criticality = file.criticality ? ` [${file.criticality}]` : '';
+            return `${filePath}${criticality}`;
+        });
+    }
+    displayDecision(outputs) {
+        const reviewDecision = this.getString(outputs, 'review_decision');
+        const qualityScore = this.getNumber(outputs, 'quality_score');
+        if (reviewDecision) {
+            const decisionIcon = this.getDecisionIcon(reviewDecision);
+            const decisionText = this.normalizeDecision(reviewDecision);
+            this.console.print(`\n${decisionIcon} Decision: ${decisionText}`);
+        }
+        if (qualityScore !== undefined) {
+            const scoreIcon = qualityScore >= 80 ? '✓' : qualityScore >= 60 ? '○' : '✗';
+            this.console.print(`   Quality Score: ${qualityScore}/100 ${scoreIcon}`);
+        }
+    }
+    displayDefaultNextSteps(reviewDecision) {
+        const upper = reviewDecision?.toUpperCase() ?? '';
+        if (['APPROVE', 'APPROVED'].includes(upper)) {
+            this.console.print('   → Ready for functional review');
+            this.console.print('   Run: valora review-functional');
+        }
+        else if (['BLOCK', 'BLOCKED'].includes(upper)) {
+            this.console.print('   → Address blocking issues before proceeding');
+            this.console.print('   Run: valora implement (to fix issues)');
+        }
+        else {
+            this.console.print('   → Address requested changes');
+            this.console.print('   Run: valora implement (to address feedback)');
+        }
+    }
+    displayIssues(outputs) {
+        const issuesFound = this.getArray(outputs, 'issues_found');
+        if (!issuesFound || issuesFound.length === 0)
+            return;
+        const bySeverity = this.groupBySeverity(issuesFound);
+        const severityOrder = ['critical', 'high', 'medium', 'low'];
+        this.console.print(`\n⚠️  Issues Found (${issuesFound.length}):`);
+        for (const severity of severityOrder) {
+            this.displaySeverityGroup(severity, bySeverity.get(severity));
+        }
+    }
+    /**
+     * Display a group of issues by severity
+     */
+    displaySeverityGroup(severity, issues) {
+        if (!issues || issues.length === 0)
+            return;
+        const icon = this.getSeverityIcon(severity);
+        const label = severity.charAt(0).toUpperCase() + severity.slice(1);
+        this.console.print(`   ${icon} ${label}: ${issues.length}`);
+        for (const issue of issues.slice(0, 2)) {
+            this.displayIssueItem(issue);
+        }
+        if (issues.length > 2) {
+            this.console.print(`      ... and ${issues.length - 2} more`);
+        }
+    }
+    /**
+     * Display a single issue item
+     */
+    displayIssueItem(issue) {
+        const desc = issue.description ?? 'Issue found';
+        this.console.print(`      • ${desc}`);
+        if (issue.file) {
+            const location = issue.line ? `${issue.file}:${issue.line}` : issue.file;
+            this.console.print(`        at ${location}`);
+        }
+    }
+    displayNextSteps(outputs) {
+        const nextSteps = this.getArray(outputs, 'next_steps');
+        const reviewDecision = this.getString(outputs, 'review_decision');
+        this.console.print('\n🚀 Next Steps:');
+        if (nextSteps && nextSteps.length > 0) {
+            for (const step of nextSteps.slice(0, 3)) {
+                this.console.print(`   → ${step}`);
+            }
+        }
+        else {
+            this.displayDefaultNextSteps(reviewDecision);
+        }
+    }
+    displayRecommendations(outputs) {
+        const recommendations = this.getArray(outputs, 'recommendations');
+        if (!recommendations || recommendations.length === 0)
+            return;
+        this.console.print(`\n💡 Recommendations (${recommendations.length}):`);
+        for (const rec of recommendations.slice(0, 5)) {
+            const priority = rec.priority ? `[${rec.priority}]` : '';
+            const text = rec.recommendation ?? rec.description ?? 'Recommendation';
+            this.console.print(`   • ${priority} ${text}`);
+        }
+        if (recommendations.length > 5) {
+            this.console.print(`   ... and ${recommendations.length - 5} more`);
+        }
+    }
+    displaySecurityConcerns(outputs) {
+        const securityConcerns = this.getArray(outputs, 'security_concerns');
+        if (!securityConcerns || securityConcerns.length === 0)
+            return;
+        this.console.print(`\n🔒 Security Concerns (${securityConcerns.length}):`);
+        for (const concern of securityConcerns.slice(0, 3)) {
+            const severity = concern.severity ? `[${concern.severity.toUpperCase()}]` : '';
+            const desc = concern.description ?? 'Security concern';
+            this.console.print(`   • ${severity} ${desc}`);
+        }
+        if (securityConcerns.length > 3) {
+            this.console.print(`   ... and ${securityConcerns.length - 3} more`);
+        }
+    }
+    displayValidationResults(outputs) {
+        const validationResults = this.getObject(outputs, 'validation_results');
+        if (!validationResults || Object.keys(validationResults).length === 0)
+            return;
+        this.console.print('\n📊 Validation Results:');
+        const entries = Object.entries(validationResults);
+        for (const [category, data] of entries) {
+            const statusIcon = data.status ? this.getStatusIcon(data.status) : '○';
+            const score = data.score !== undefined ? ` (${data.score}/100)` : '';
+            const issues = data.issues !== undefined && data.issues > 0 ? ` - ${data.issues} issue(s)` : '';
+            const formattedCategory = this.formatKey(category);
+            this.console.print(`   ${statusIcon} ${formattedCategory}${score}${issues}`);
+        }
+    }
+    groupBySeverity(issues) {
+        const grouped = new Map();
+        for (const issue of issues) {
+            const severity = issue.severity ?? 'medium';
+            const existing = grouped.get(severity) ?? [];
+            existing.push(issue);
+            grouped.set(severity, existing);
+        }
+        return grouped;
+    }
+    normalizeDecision(decision) {
+        const upper = decision.toUpperCase();
+        if (['APPROVE', 'APPROVED'].includes(upper))
+            return 'APPROVED';
+        if (['BLOCK', 'BLOCKED'].includes(upper))
+            return 'BLOCKED';
+        return 'CHANGES REQUESTED';
+    }
+}
+//# sourceMappingURL=review-code-presenter.js.map

package/dist/cli/presenters/review-code-presenter.js.map

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

package/dist/cli/presenters/review-plan-presenter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Review Plan Presenter - Displays plan review summary
+ */
+import type { ConsoleOutput } from '../../output/console-output.js';
+import type { MarkdownRenderer } from '../../output/markdown.js';
+import { BasePresenter } from './base-presenter.js';
+/**
+ * Presenter for review-plan command output
+ */
+export declare class ReviewPlanPresenter extends BasePresenter {
+    constructor(console: ConsoleOutput, renderer: MarkdownRenderer);
+    display(outputs: Record<string, unknown>): void;
+    getCommandName(): string;
+    private displayCriticalIssues;
+    private displayDecision;
+    private displayDimensionScores;
+    private displayPreImplementationSteps;
+    private displayRationale;
+    private displayRecommendations;
+    /**
+     * Display a category of recommendations
+     */
+    private displayRecommendationCategory;
+    private getDimensionStatusIcon;
+}
+//# sourceMappingURL=review-plan-presenter.d.ts.map

package/dist/cli/presenters/review-plan-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan-presenter.d.ts","sourceRoot":"","sources":["../../../src/cli/presenters/review-plan-presenter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA2CjD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACzC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB;IAI9D,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW/C,cAAc,IAAI,MAAM;IAIxB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,6BAA6B;IAarC,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAiBrC,OAAO,CAAC,sBAAsB;CAS9B"}

package/dist/cli/presenters/review-plan-presenter.js

@@ -0,0 +1,130 @@
+/**
+ * Review Plan Presenter - Displays plan review summary
+ */
+import { BasePresenter } from './base-presenter.js';
+/**
+ * Presenter for review-plan command output
+ */
+export class ReviewPlanPresenter extends BasePresenter {
+    constructor(console, renderer) {
+        super(console, renderer);
+    }
+    display(outputs) {
+        this.displaySummaryBox('Plan Review Summary');
+        this.displayDecision(outputs);
+        this.displayDimensionScores(outputs);
+        this.displayCriticalIssues(outputs);
+        this.displayRecommendations(outputs);
+        this.displayPreImplementationSteps(outputs);
+        this.displayRationale(outputs);
+        this.displaySummaryFooter();
+    }
+    getCommandName() {
+        return 'review-plan';
+    }
+    displayCriticalIssues(outputs) {
+        const criticalIssues = this.getArray(outputs, 'critical_issues');
+        if (!criticalIssues || criticalIssues.length === 0)
+            return;
+        this.console.print('\n🚨 Critical Issues:');
+        for (const issue of criticalIssues) {
+            const issueId = issue.id ? `[${issue.id}] ` : '';
+            this.console.print(`   • ${issueId}${issue.description ?? 'Unknown issue'}`);
+        }
+    }
+    displayDecision(outputs) {
+        const decision = this.getObject(outputs, 'go_no_go_decision');
+        if (!decision)
+            return;
+        const decisionIcon = this.getDecisionIcon(decision.decision ?? 'UNKNOWN');
+        this.console.print(`\n${decisionIcon} Decision: ${decision.decision ?? 'UNKNOWN'}`);
+        const overallConfidence = this.getNumber(outputs, 'overall_confidence');
+        if (overallConfidence !== undefined) {
+            const threshold = decision.threshold ?? 7.0;
+            const thresholdMet = decision.threshold_met ?? overallConfidence >= threshold;
+            const thresholdIcon = thresholdMet ? '✓' : '✗';
+            this.console.print(`   Confidence: ${overallConfidence.toFixed(1)}/10 (threshold: ${threshold}) ${thresholdIcon}`);
+        }
+        if (decision.critical_blockers !== undefined) {
+            this.console.print(`   Critical Blockers: ${decision.critical_blockers}`);
+        }
+        if (decision.next_command) {
+            this.console.print(`   Next Command: ${decision.next_command}`);
+        }
+    }
+    displayDimensionScores(outputs) {
+        const dimensionBreakdown = this.getObject(outputs, 'dimension_breakdown');
+        if (!dimensionBreakdown || Object.keys(dimensionBreakdown).length === 0)
+            return;
+        this.console.print('\n📊 Dimension Scores:');
+        for (const [dimension, data] of Object.entries(dimensionBreakdown)) {
+            if (data.score === undefined)
+                continue;
+            const statusIcon = this.getDimensionStatusIcon(data.status);
+            const formattedDimension = this.formatKey(dimension);
+            this.console.print(`   ${statusIcon} ${formattedDimension}: ${data.score.toFixed(1)}/10`);
+        }
+    }
+    displayPreImplementationSteps(outputs) {
+        const nextSteps = this.getObject(outputs, 'next_steps');
+        if (!nextSteps?.pre_implementation || nextSteps.pre_implementation.length === 0)
+            return;
+        this.console.print('\n🚀 Pre-Implementation Steps:');
+        for (const step of nextSteps.pre_implementation.slice(0, 3)) {
+            this.console.print(`   • ${step}`);
+        }
+        if (nextSteps.pre_implementation.length > 3) {
+            this.console.print(`   ... and ${nextSteps.pre_implementation.length - 3} more`);
+        }
+    }
+    displayRationale(outputs) {
+        const decision = this.getObject(outputs, 'go_no_go_decision');
+        if (!decision?.rationale)
+            return;
+        this.console.print('\n💡 Rationale:');
+        const rationale = this.truncate(decision.rationale, 300);
+        this.console.print(`   ${rationale}`);
+    }
+    displayRecommendations(outputs) {
+        const recommendations = this.getObject(outputs, 'improvement_recommendations');
+        if (!recommendations)
+            return;
+        const criticalCount = recommendations.critical?.length ?? 0;
+        const importantCount = recommendations.important?.length ?? 0;
+        const niceToHaveCount = recommendations.nice_to_have?.length ?? 0;
+        const totalCount = criticalCount + importantCount + niceToHaveCount;
+        if (totalCount === 0)
+            return;
+        this.console.print(`\n📋 Recommendations (${totalCount}):`);
+        this.displayRecommendationCategory('🔴 Critical', recommendations.critical, 3, false);
+        this.displayRecommendationCategory('🟡 Important', recommendations.important, 3, true);
+        if (niceToHaveCount > 0) {
+            this.console.print(`   🟢 Nice-to-have: ${niceToHaveCount}`);
+        }
+    }
+    /**
+     * Display a category of recommendations
+     */
+    displayRecommendationCategory(label, items, maxItems, showOverflow) {
+        if (!items || items.length === 0)
+            return;
+        this.console.print(`   ${label}: ${items.length}`);
+        for (const rec of items.slice(0, maxItems)) {
+            this.console.print(`      • ${rec.recommendation ?? 'No description'}`);
+        }
+        if (showOverflow && items.length > maxItems) {
+            this.console.print(`      ... and ${items.length - maxItems} more`);
+        }
+    }
+    getDimensionStatusIcon(status) {
+        if (!status)
+            return '○';
+        const icons = {
+            acceptable: '○',
+            excellent: '★',
+            good: '✓'
+        };
+        return icons[status.toLowerCase()] ?? '✗';
+    }
+}
+//# sourceMappingURL=review-plan-presenter.js.map

package/dist/cli/presenters/review-plan-presenter.js.map

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

package/dist/cli/provider-fallback-service.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Provider Fallback Service - Manages three-tier provider resolution
+ *
+ * Tier 1: MCP Sampling (when Cursor supports it)
+ * Tier 2: Guided Completion Mode (uses Cursor subscription, no API keys)
+ * Tier 3: API Key Fallback (Anthropic, OpenAI, Google)
+ */
+import type { LLMProvider } from '../types/llm.types.js';
+import type { MCPSamplingService } from '../types/mcp.types.js';
+import { GUIDED_MODE, type GuidedMode, type ProviderResolutionPath, ResolutionPath } from '../types/provider.types.js';
+import type { CLIProviderResolver } from './provider-resolver.js';
+/**
+ * Re-export for backward compatibility
+ */
+export { GUIDED_MODE, ResolutionPath };
+export type { GuidedMode, ProviderResolutionPath };
+export interface ProviderFallbackContext {
+    inMCPContext: boolean;
+    mode?: string;
+    model?: string;
+    providerConfig: Record<string, unknown>;
+    providerName: string;
+}
+export interface ProviderResolution {
+    fallbackReason?: string;
+    provider: LLMProvider;
+    providerName: string;
+    resolutionPath: ProviderResolutionPath;
+}
+export declare class ProviderFallbackService {
+    private providerResolver;
+    private providerRegistry;
+    constructor(providerResolver: CLIProviderResolver, providerRegistry?: import("../llm/registry.js").LLMProviderRegistry);
+    /**
+     * Resolve provider with automatic three-tier fallback
+     *
+     * @param context - Provider resolution context
+     * @param mcpSampling - Optional MCP sampling service
+     * @returns Provider resolution result with metadata
+     */
+    resolveWithFallback(context: ProviderFallbackContext, mcpSampling?: MCPSamplingService): Promise<ProviderResolution>;
+    /**
+     * Check if we should use guided completion mode
+     * Returns true if in MCP context but no API keys configured
+     */
+    shouldUseGuidedCompletion(): Promise<boolean>;
+    /**
+     * Get human-readable description of resolution path
+     */
+    getResolutionPathDescription(path: ProviderResolutionPath): string;
+}
+//# sourceMappingURL=provider-fallback-service.d.ts.map

package/dist/cli/provider-fallback-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-fallback-service.d.ts","sourceRoot":"","sources":["../../src/cli/provider-fallback-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGjH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,sBAAsB,CAAC;CACvC;AAED,qBAAa,uBAAuB;IAElC,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,gBAAgB;gBADhB,gBAAgB,EAAE,mBAAmB,EACrC,gBAAgB,6CAAwB;IAGjD;;;;;;OAMG;IACG,mBAAmB,CACxB,OAAO,EAAE,uBAAuB,EAChC,WAAW,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IA2F9B;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC;IAQnD;;OAEG;IACH,4BAA4B,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM;CASlE"}

package/dist/cli/provider-fallback-service.js

@@ -0,0 +1,134 @@
+/**
+ * Provider Fallback Service - Manages three-tier provider resolution
+ *
+ * Tier 1: MCP Sampling (when Cursor supports it)
+ * Tier 2: Guided Completion Mode (uses Cursor subscription, no API keys)
+ * Tier 3: API Key Fallback (Anthropic, OpenAI, Google)
+ */
+import { ProviderName } from '../config/providers.config.js';
+import { getProviderRegistry } from '../llm/registry.js';
+import { GUIDED_MODE, ResolutionPath } from '../types/provider.types.js';
+import { formatErrorMessage } from '../utils/error-utils.js';
+/**
+ * Special provider identifiers for fallback modes
+ * These are synthetic names used to distinguish between different resolution modes
+ */
+const CURSOR_GUIDED_MODE = 'cursor-guided';
+/**
+ * Re-export for backward compatibility
+ */
+export { GUIDED_MODE, ResolutionPath };
+export class ProviderFallbackService {
+    providerResolver;
+    providerRegistry;
+    constructor(providerResolver, providerRegistry = getProviderRegistry()) {
+        this.providerResolver = providerResolver;
+        this.providerRegistry = providerRegistry;
+    }
+    /**
+     * Resolve provider with automatic three-tier fallback
+     *
+     * @param context - Provider resolution context
+     * @param mcpSampling - Optional MCP sampling service
+     * @returns Provider resolution result with metadata
+     */
+    async resolveWithFallback(context, mcpSampling) {
+        const logger = await import('../output/logger.js').then((m) => m.getLogger());
+        // TIER 1: Try MCP Sampling (if provider is cursor and MCP is available)
+        if (context.providerName === ProviderName.CURSOR && mcpSampling) {
+            try {
+                logger.debug('Attempting Tier 1: MCP Sampling');
+                const provider = this.providerRegistry.createProvider(ProviderName.CURSOR, context.providerConfig, mcpSampling);
+                // Test if provider is properly configured
+                if (provider.isConfigured()) {
+                    logger.always('✅ Using MCP Sampling (Tier 1: Zero-config mode)', {
+                        provider: ProviderName.CURSOR,
+                        resolutionPath: ResolutionPath.MCP
+                    });
+                    return {
+                        provider,
+                        providerName: ProviderName.CURSOR,
+                        resolutionPath: ResolutionPath.MCP
+                    };
+                }
+            }
+            catch (error) {
+                logger.debug('MCP Sampling not available, checking fallback options', {
+                    error: formatErrorMessage(error)
+                });
+            }
+        }
+        // TIER 2 & 3: Check if we should use guided completion or API fallback
+        // Only apply fallback if we're trying to use CURSOR provider or if provider is not configured
+        if (context.inMCPContext && (context.providerName === ProviderName.CURSOR || !context.providerConfig['apiKey'])) {
+            // In MCP context (Cursor), check for API key fallback first
+            const apiFallback = await this.providerResolver.getFallbackProvider();
+            if (apiFallback) {
+                // TIER 3: API Key Fallback available
+                logger.always(`✅ Using API Key Fallback (Tier 3: ${apiFallback.name})`, {
+                    model: apiFallback.model,
+                    provider: apiFallback.name,
+                    reason: 'MCP sampling not available, API keys configured',
+                    resolutionPath: ResolutionPath.API_FALLBACK
+                });
+                const provider = this.providerRegistry.createProvider(apiFallback.name, apiFallback.config, mcpSampling);
+                return {
+                    fallbackReason: 'mcp_sampling_unavailable_using_api_keys',
+                    provider,
+                    providerName: apiFallback.name,
+                    resolutionPath: ResolutionPath.API_FALLBACK
+                };
+            }
+            else {
+                // TIER 2: Guided Completion Mode (no API keys configured)
+                logger.always('✅ Using Guided Completion Mode (Tier 2: Zero-config, Cursor subscription)', {
+                    provider: CURSOR_GUIDED_MODE,
+                    reason: 'No API keys configured, using Cursor subscription',
+                    resolutionPath: ResolutionPath.GUIDED
+                });
+                // Create cursor provider without MCP sampling = guided mode
+                const cursorProviderClass = await import('../llm/providers/cursor.provider.js').then((m) => m.CursorProvider);
+                const provider = new cursorProviderClass({}, undefined); // No MCP sampling = guided mode
+                return {
+                    fallbackReason: 'mcp_sampling_unavailable_using_guided_mode',
+                    provider,
+                    providerName: CURSOR_GUIDED_MODE,
+                    resolutionPath: ResolutionPath.GUIDED
+                };
+            }
+        }
+        // Not in MCP context - use traditional provider resolution
+        logger.debug('Not in MCP context, using traditional provider resolution', {
+            provider: context.providerName
+        });
+        const provider = this.providerRegistry.createProvider(context.providerName, context.providerConfig, mcpSampling);
+        return {
+            provider,
+            providerName: context.providerName,
+            resolutionPath: ResolutionPath.API_FALLBACK
+        };
+    }
+    /**
+     * Check if we should use guided completion mode
+     * Returns true if in MCP context but no API keys configured
+     */
+    async shouldUseGuidedCompletion() {
+        const inMCPContext = process.env['AI_MCP_ENABLED'] === 'true';
+        if (!inMCPContext)
+            return false;
+        const fallback = await this.providerResolver.getFallbackProvider();
+        return fallback === null; // No API keys = use guided mode
+    }
+    /**
+     * Get human-readable description of resolution path
+     */
+    getResolutionPathDescription(path) {
+        const pathDescriptions = {
+            [ResolutionPath.API_FALLBACK]: 'API Key Mode (external provider with API keys)',
+            [ResolutionPath.GUIDED]: 'Guided Completion Mode (Cursor subscription, no API keys)',
+            [ResolutionPath.MCP]: 'MCP Sampling (native Cursor support)'
+        };
+        return pathDescriptions[path];
+    }
+}
+//# sourceMappingURL=provider-fallback-service.js.map

package/dist/cli/provider-fallback-service.js.map

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

package/dist/cli/provider-mismatch-handler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Provider Mismatch Handler - Handles model/provider configuration mismatches interactively
+ *
+ * When a command requests a model that requires an unconfigured provider,
+ * this handler offers interactive options to resolve the issue.
+ */
+import type { Config, ProviderConfig } from '../types/config.types.js';
+export interface ProviderResolution {
+    model?: string;
+    providerConfig: ProviderConfig;
+    providerName: string;
+}
+export declare class ProviderMismatchHandler {
+    /**
+     * Handle provider/model mismatch interactively
+     */
+    handleMismatch(requestedProvider: string, requestedModel: string, configuredProviders: string[], config: Config): Promise<null | ProviderResolution>;
+    /**
+     * Prompt user for action
+     */
+    private promptUserAction;
+    /**
+     * Configure the requested provider
+     */
+    private configureProvider;
+    /**
+     * Use the default configured provider
+     */
+    private useDefaultProvider;
+    /**
+     * Get default model for a provider
+     */
+    private getDefaultModelForProvider;
+}
+//# sourceMappingURL=provider-mismatch-handler.d.ts.map

package/dist/cli/provider-mismatch-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-mismatch-handler.d.ts","sourceRoot":"","sources":["../../src/cli/provider-mismatch-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASjE,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,uBAAuB;IACnC;;OAEG;IACG,cAAc,CACnB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAgCrC;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAQlC"}