clavix 4.10.0 → 4.11.2

package/dist/core/intelligence/patterns/prd-structure-enforcer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: PRD Structure Enforcer
@@ -11,7 +11,7 @@ export declare class PRDStructureEnforcer extends BasePattern {
     readonly name = "PRD Structure Enforcer";
     readonly description = "Ensure PRD prompts include all necessary sections";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/prd-structure-enforcer.js

@@ -13,7 +13,7 @@ export class PRDStructureEnforcer extends BasePattern {
     name = 'PRD Structure Enforcer';
     description = 'Ensure PRD prompts include all necessary sections';
     applicableIntents = ['prd-generation'];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 9; // VERY HIGH - structural integrity
     phases = ['question-validation', 'output-generation'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/prerequisite-identifier.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PatternContext, PatternResult, PromptIntent } from '../types.js';
 /**
  * v4.5 Pattern: Prerequisite Identifier
@@ -11,7 +11,7 @@ export declare class PrerequisiteIdentifier extends BasePattern {
     readonly name = "Prerequisite Identifier";
     readonly description = "Identifies and documents prerequisites and dependencies for task execution";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/prerequisite-identifier.js

@@ -19,7 +19,7 @@ export class PrerequisiteIdentifier extends BasePattern {
         'testing',
         'debugging',
     ];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 6; // MEDIUM - standard enhancement
     phases = ['all'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/requirement-prioritizer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Requirement Prioritizer
@@ -11,7 +11,7 @@ export declare class RequirementPrioritizer extends BasePattern {
     readonly name = "Requirement Prioritizer";
     readonly description = "Separates must-have from nice-to-have requirements";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/requirement-prioritizer.js

@@ -13,7 +13,7 @@ export class RequirementPrioritizer extends BasePattern {
     name = 'Requirement Prioritizer';
     description = 'Separates must-have from nice-to-have requirements';
     applicableIntents = ['prd-generation', 'planning'];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 7; // MEDIUM-HIGH - important enrichment
     phases = ['question-validation', 'output-generation'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/scope-definer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Scope Definer
@@ -11,7 +11,7 @@ export declare class ScopeDefiner extends BasePattern {
     readonly name = "Scope Definer";
     readonly description = "Add explicit scope boundaries to prevent scope creep";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/scope-definer.js

@@ -19,7 +19,7 @@ export class ScopeDefiner extends BasePattern {
         'migration',
         'documentation',
     ];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 5; // MEDIUM-LOW - supplementary
     phases = ['all'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/step-decomposer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Step-by-Step Decomposer
@@ -11,7 +11,7 @@ export declare class StepDecomposer extends BasePattern {
     readonly name = "Step-by-Step Decomposer";
     readonly description = "Break complex prompts into clear sequential steps";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/step-decomposer.js

@@ -20,7 +20,7 @@ export class StepDecomposer extends BasePattern {
         'debugging',
         'documentation',
     ];
-    mode = 'both';
+    scope = 'both';
     priority = 5; // MEDIUM-LOW - supplementary
     phases = ['all'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/structure-organizer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PatternContext, PatternResult, PromptIntent } from '../types.js';
 /**
  * v4.5 Pattern: Structure Organizer
@@ -11,7 +11,7 @@ export declare class StructureOrganizer extends BasePattern {
     readonly name = "Structure Organizer";
     readonly description = "Reorders information into logical sections";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/structure-organizer.js

@@ -19,7 +19,7 @@ export class StructureOrganizer extends BasePattern {
         'debugging',
         'documentation',
     ];
-    mode = 'both';
+    scope = 'both';
     priority = 8; // HIGH - core enhancement
     phases = ['all'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/success-criteria-enforcer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PatternContext, PatternResult, PromptIntent } from '../types.js';
 /**
  * v4.5 Pattern: Success Criteria Enforcer
@@ -11,7 +11,7 @@ export declare class SuccessCriteriaEnforcer extends BasePattern {
     readonly name = "Success Criteria Enforcer";
     readonly description = "Adds measurable success criteria for task completion validation";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/success-criteria-enforcer.js

@@ -21,7 +21,7 @@ export class SuccessCriteriaEnforcer extends BasePattern {
         'migration',
         'prd-generation',
     ];
-    mode = 'both';
+    scope = 'both';
     priority = 7; // MEDIUM-HIGH - important enrichment
     phases = ['all'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/success-metrics-enforcer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Success Metrics Enforcer
@@ -11,7 +11,7 @@ export declare class SuccessMetricsEnforcer extends BasePattern {
     readonly name = "Success Metrics Enforcer";
     readonly description = "Ensures measurable success criteria exist";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/success-metrics-enforcer.js

@@ -13,7 +13,7 @@ export class SuccessMetricsEnforcer extends BasePattern {
     name = 'Success Metrics Enforcer';
     description = 'Ensures measurable success criteria exist';
     applicableIntents = ['prd-generation', 'planning'];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 7; // MEDIUM-HIGH - important enrichment
     phases = ['question-validation', 'output-generation'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/technical-context-enricher.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema, PatternDependency } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema, PatternDependency } from './base-pattern.js';
 import { PatternContext, PatternResult, PromptIntent } from '../types.js';
 /**
  * v4.5 Pattern: Technical Context Enricher
@@ -11,7 +11,7 @@ export declare class TechnicalContextEnricher extends BasePattern {
     readonly name = "Technical Context Enricher";
     readonly description = "Adds missing technical context (language, framework, versions)";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     readonly dependencies: PatternDependency;

package/dist/core/intelligence/patterns/technical-context-enricher.js

@@ -13,7 +13,7 @@ export class TechnicalContextEnricher extends BasePattern {
     name = 'Technical Context Enricher';
     description = 'Adds missing technical context (language, framework, versions)';
     applicableIntents = ['code-generation', 'refinement', 'debugging'];
-    mode = 'both';
+    scope = 'both';
     priority = 5; // MEDIUM-LOW - supplementary context
     phases = ['all'];
     // v4.5: Dependencies

package/dist/core/intelligence/patterns/topic-coherence-analyzer.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Topic Coherence Analyzer
@@ -12,7 +12,7 @@ export declare class TopicCoherenceAnalyzer extends BasePattern {
     readonly name = "Topic Coherence Analyzer";
     readonly description = "Detects topic shifts and multi-topic conversations";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/topic-coherence-analyzer.js

@@ -14,7 +14,7 @@ export class TopicCoherenceAnalyzer extends BasePattern {
     name = 'Topic Coherence Analyzer';
     description = 'Detects topic shifts and multi-topic conversations';
     applicableIntents = ['summarization', 'planning'];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 6; // MEDIUM - standard enhancement
     phases = ['conversation-tracking', 'summarization'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/user-persona-enricher.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: User Persona Enricher
@@ -11,7 +11,7 @@ export declare class UserPersonaEnricher extends BasePattern {
     readonly name = "User Persona Enricher";
     readonly description = "Adds missing user context and personas";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     static readonly configSchema: PatternConfigSchema;

package/dist/core/intelligence/patterns/user-persona-enricher.js

@@ -13,7 +13,7 @@ export class UserPersonaEnricher extends BasePattern {
     name = 'User Persona Enricher';
     description = 'Adds missing user context and personas';
     applicableIntents = ['prd-generation', 'planning'];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 6; // MEDIUM - standard enhancement
     phases = ['question-validation', 'output-generation'];
     // -------------------------------------------------------------------------

package/dist/core/intelligence/patterns/validation-checklist-creator.d.ts

@@ -1,4 +1,4 @@
-import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema, PatternDependency } from './base-pattern.js';
+import { BasePattern, PatternScope, PatternPriority, PatternPhase, PatternConfigSchema, PatternDependency } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
  * v4.5 Pattern: Validation Checklist Creator
@@ -11,7 +11,7 @@ export declare class ValidationChecklistCreator extends BasePattern {
     readonly name = "Validation Checklist Creator";
     readonly description = "Create implementation validation checklist for verification";
     readonly applicableIntents: PromptIntent[];
-    readonly mode: PatternMode;
+    readonly scope: PatternScope;
     readonly priority: PatternPriority;
     readonly phases: PatternPhase[];
     readonly dependencies: PatternDependency;

package/dist/core/intelligence/patterns/validation-checklist-creator.js

@@ -19,7 +19,7 @@ export class ValidationChecklistCreator extends BasePattern {
         'security-review',
         'debugging',
     ];
-    mode = 'deep';
+    scope = 'comprehensive';
     priority = 3; // VERY LOW - final touches
     phases = ['all'];
     // v4.5: Dependencies

package/dist/core/intelligence/types.d.ts

@@ -1,7 +1,8 @@
 export type PromptIntent = 'code-generation' | 'planning' | 'refinement' | 'debugging' | 'documentation' | 'prd-generation' | 'testing' | 'migration' | 'security-review' | 'learning' | 'summarization';
 export type QualityDimension = 'clarity' | 'efficiency' | 'structure' | 'completeness' | 'actionability' | 'specificity';
 export type ImpactLevel = 'low' | 'medium' | 'high';
-export type OptimizationMode = 'fast' | 'deep' | 'prd' | 'conversational';
+export type OptimizationMode = 'improve' | 'prd' | 'conversational';
+export type DepthLevel = 'standard' | 'comprehensive';
 export type OptimizationPhase = 'question-validation' | 'output-generation' | 'conversation-tracking' | 'summarization';
 export type DocumentType = 'full-prd' | 'quick-prd' | 'mini-prd' | 'prompt';
 export interface IntentAnalysis {
@@ -34,7 +35,7 @@ export interface EscalationAnalysis {
     escalationScore: number;
     escalationConfidence: 'high' | 'medium' | 'low';
     reasons: EscalationReason[];
-    deepModeValue: string;
+    comprehensiveValue: string;
 }
 export interface QualityMetrics {
     clarity: number;
@@ -60,6 +61,7 @@ export interface PatternContext {
     phase?: OptimizationPhase;
     documentType?: DocumentType;
     questionId?: string;
+    depthLevel?: DepthLevel;
 }
 export interface PatternResult {
     enhancedPrompt: string;
@@ -79,6 +81,7 @@ export interface OptimizationResult {
     improvements: Improvement[];
     appliedPatterns: PatternSummary[];
     mode: OptimizationMode;
+    depthUsed?: DepthLevel;
     processingTimeMs: number;
 }
 export interface AlternativeApproach {
@@ -99,7 +102,7 @@ export interface EdgeCase {
     scenario: string;
     consideration: string;
 }
-export interface DeepModeExtras {
+export interface ComprehensiveModeExtras {
     alternatives: AlternativeApproach[];
     structures: AlternativeStructure[];
     validation: ValidationItem[];

package/dist/core/intelligence/universal-optimizer.d.ts

@@ -1,15 +1,16 @@
 import { IntentDetector } from './intent-detector.js';
 import { PatternLibrary } from './pattern-library.js';
 import { QualityAssessor } from './quality-assessor.js';
-import { OptimizationResult, OptimizationMode, OptimizationPhase, DocumentType, EscalationAnalysis } from './types.js';
+import { OptimizationResult, OptimizationMode, OptimizationPhase, DocumentType, EscalationAnalysis, DepthLevel } from './types.js';
 /**
- * v4.3.2: Extended context options for PRD and Conversational modes
+ * v4.11: Extended context options for optimization modes
  */
 export interface OptimizationContextOverride {
     phase?: OptimizationPhase;
     documentType?: DocumentType;
     questionId?: string;
     intent?: string;
+    depthLevel?: DepthLevel;
 }
 export declare class UniversalOptimizer {
     private intentDetector;
@@ -17,10 +18,10 @@ export declare class UniversalOptimizer {
     private qualityAssessor;
     constructor(intentDetector?: IntentDetector, patternLibrary?: PatternLibrary, qualityAssessor?: QualityAssessor);
     /**
-     * Optimize a prompt using Clavix Intelligence
+     * v4.11: Optimize a prompt using Clavix Intelligence
      * @param prompt The prompt to optimize
-     * @param mode The optimization mode
-     * @param contextOverride Optional context override for PRD/Conversational modes
+     * @param mode The optimization mode ('improve' | 'prd' | 'conversational')
+     * @param contextOverride Optional context override including depthLevel
      */
     optimize(prompt: string, mode: OptimizationMode, contextOverride?: OptimizationContextOverride): Promise<OptimizationResult>;
     /**
@@ -37,12 +38,16 @@ export declare class UniversalOptimizer {
      */
     private generateFriendlySuggestion;
     /**
-     * Determine if deep mode should be recommended (for fast mode results)
+     * v4.11: Determine if comprehensive depth should be recommended
      * @deprecated Use analyzeEscalation() for more detailed analysis
      */
+    shouldRecommendComprehensive(result: OptimizationResult): boolean;
+    /**
+     * @deprecated Use shouldRecommendComprehensive() instead
+     */
     shouldRecommendDeepMode(result: OptimizationResult): boolean;
     /**
-     * v4.0: Analyze whether to escalate from fast mode to deep mode
+     * v4.11: Analyze whether to escalate from standard to comprehensive depth
      * Uses multi-factor scoring for intelligent triage decisions
      *
      * IMPORTANT: Quality checks use the ORIGINAL prompt, not the enhanced one,
@@ -50,16 +55,16 @@ export declare class UniversalOptimizer {
      */
     analyzeEscalation(result: OptimizationResult): EscalationAnalysis;
     /**
-     * Generate a user-friendly explanation of what deep mode would provide
+     * v4.11: Generate a user-friendly explanation of what comprehensive depth would provide
      */
-    private generateDeepModeValue;
+    private generateComprehensiveValue;
     /**
-     * Get recommendation message for user
-     * v4.0: Enhanced with escalation analysis details
+     * v4.11: Get recommendation message for user
+     * Enhanced with escalation analysis for improve mode
      */
     getRecommendation(result: OptimizationResult): string | null;
     /**
-     * v4.0: Get detailed escalation recommendation with all reasons
+     * v4.11: Get detailed escalation recommendation with all reasons
      * Useful for verbose output or debugging
      */
     getDetailedRecommendation(result: OptimizationResult): {
@@ -68,12 +73,12 @@ export declare class UniversalOptimizer {
         qualityLevel: 'excellent' | 'good' | 'decent' | 'needs-work';
     };
     /**
-     * Get statistics about the optimizer
+     * v4.11: Get statistics about the optimizer
      */
     getStatistics(): {
         totalPatterns: number;
-        fastModePatterns: number;
-        deepModePatterns: number;
+        standardPatterns: number;
+        comprehensivePatterns: number;
     };
 }
 //# sourceMappingURL=universal-optimizer.d.ts.map

package/dist/core/intelligence/universal-optimizer.js

@@ -11,10 +11,10 @@ export class UniversalOptimizer {
         this.qualityAssessor = qualityAssessor || new QualityAssessor();
     }
     /**
-     * Optimize a prompt using Clavix Intelligence
+     * v4.11: Optimize a prompt using Clavix Intelligence
      * @param prompt The prompt to optimize
-     * @param mode The optimization mode
-     * @param contextOverride Optional context override for PRD/Conversational modes
+     * @param mode The optimization mode ('improve' | 'prd' | 'conversational')
+     * @param contextOverride Optional context override including depthLevel
      */
     async optimize(prompt, mode, contextOverride) {
         const startTime = Date.now();
@@ -26,10 +26,12 @@ export class UniversalOptimizer {
                 primaryIntent: contextOverride.intent,
             };
         }
+        // v4.11: Get depth level (explicit or auto-detected)
+        const depthLevel = contextOverride?.depthLevel;
         // Step 2: Select applicable patterns using mode-aware selection
         const patterns = mode === 'prd' || mode === 'conversational'
-            ? this.patternLibrary.selectPatternsForMode(mode, intent, contextOverride?.phase)
-            : this.patternLibrary.selectPatterns(intent, mode);
+            ? this.patternLibrary.selectPatternsForMode(mode, intent, contextOverride?.phase, depthLevel)
+            : this.patternLibrary.selectPatterns(intent, mode, depthLevel);
         // Step 3: Apply patterns sequentially
         let enhanced = prompt;
         const improvements = [];
@@ -42,6 +44,8 @@ export class UniversalOptimizer {
             phase: contextOverride?.phase,
             documentType: contextOverride?.documentType,
             questionId: contextOverride?.questionId,
+            // v4.11: Depth level for pattern selection
+            depthLevel,
         };
         for (const pattern of patterns) {
             try {
@@ -73,6 +77,7 @@ export class UniversalOptimizer {
             improvements,
             appliedPatterns,
             mode,
+            depthUsed: depthLevel, // v4.11: Track which depth was used
             processingTimeMs,
         };
     }
@@ -122,15 +127,21 @@ export class UniversalOptimizer {
         return `adding ${detail} would help`;
     }
     /**
-     * Determine if deep mode should be recommended (for fast mode results)
+     * v4.11: Determine if comprehensive depth should be recommended
      * @deprecated Use analyzeEscalation() for more detailed analysis
      */
-    shouldRecommendDeepMode(result) {
+    shouldRecommendComprehensive(result) {
         const escalation = this.analyzeEscalation(result);
         return escalation.shouldEscalate;
     }
     /**
-     * v4.0: Analyze whether to escalate from fast mode to deep mode
+     * @deprecated Use shouldRecommendComprehensive() instead
+     */
+    shouldRecommendDeepMode(result) {
+        return this.shouldRecommendComprehensive(result);
+    }
+    /**
+     * v4.11: Analyze whether to escalate from standard to comprehensive depth
      * Uses multi-factor scoring for intelligent triage decisions
      *
      * IMPORTANT: Quality checks use the ORIGINAL prompt, not the enhanced one,
@@ -236,23 +247,23 @@ export class UniversalOptimizer {
         else {
             escalationConfidence = 'low';
         }
-        // Generate deep mode value proposition
-        const deepModeValue = this.generateDeepModeValue(result, reasons);
+        // v4.11: Generate comprehensive mode value proposition
+        const comprehensiveValue = this.generateComprehensiveValue(result, reasons);
         return {
             // Threshold of 45 ensures planning prompts with missing completeness trigger escalation
             shouldEscalate: totalScore >= 45,
             escalationScore: Math.min(totalScore, 100),
             escalationConfidence,
             reasons,
-            deepModeValue,
+            comprehensiveValue,
         };
     }
     /**
-     * Generate a user-friendly explanation of what deep mode would provide
+     * v4.11: Generate a user-friendly explanation of what comprehensive depth would provide
      */
-    generateDeepModeValue(result, reasons) {
+    generateComprehensiveValue(result, reasons) {
         const benefits = [];
-        // Based on primary issues, suggest specific deep mode benefits
+        // Based on primary issues, suggest specific comprehensive depth benefits
         const hasLowQuality = reasons.some((r) => r.factor === 'low-quality');
         const hasLowCompleteness = reasons.some((r) => r.factor === 'missing-completeness');
         const hasHighAmbiguity = reasons.some((r) => r.factor === 'high-ambiguity');
@@ -277,22 +288,23 @@ export class UniversalOptimizer {
         if (result.intent.primaryIntent === 'security-review') {
             benefits.push('security checklist and threat analysis');
         }
-        // Always include validation checklist for deep mode
+        // Always include validation checklist for comprehensive depth
         benefits.push('validation checklist');
         if (benefits.length === 0) {
-            return 'Deep mode provides comprehensive analysis with alternative approaches.';
+            return 'Comprehensive analysis provides thorough examination with alternative approaches.';
         }
-        return `Deep mode would provide: ${benefits.join(', ')}.`;
+        return `Comprehensive analysis would provide: ${benefits.join(', ')}.`;
     }
     /**
-     * Get recommendation message for user
-     * v4.0: Enhanced with escalation analysis details
+     * v4.11: Get recommendation message for user
+     * Enhanced with escalation analysis for improve mode
      */
     getRecommendation(result) {
-        if (result.mode === 'fast') {
+        // v4.11: Check for escalation only in improve mode with standard depth
+        if (result.mode === 'improve' && result.depthUsed !== 'comprehensive') {
             const escalation = this.analyzeEscalation(result);
             if (escalation.shouldEscalate) {
-                return `${escalation.deepModeValue} Run: /clavix:deep`;
+                return `${escalation.comprehensiveValue} Run: /clavix:improve --comprehensive`;
             }
         }
         if (result.quality.overall >= 90) {
@@ -307,11 +319,14 @@ export class UniversalOptimizer {
         return null;
     }
     /**
-     * v4.0: Get detailed escalation recommendation with all reasons
+     * v4.11: Get detailed escalation recommendation with all reasons
      * Useful for verbose output or debugging
      */
     getDetailedRecommendation(result) {
-        const escalation = result.mode === 'fast' ? this.analyzeEscalation(result) : undefined;
+        // v4.11: Check escalation for improve mode with non-comprehensive depth
+        const escalation = result.mode === 'improve' && result.depthUsed !== 'comprehensive'
+            ? this.analyzeEscalation(result)
+            : undefined;
         let qualityLevel;
         let message;
         if (result.quality.overall >= 90) {
@@ -331,7 +346,7 @@ export class UniversalOptimizer {
             message = 'This prompt needs improvement for best results.';
         }
         if (escalation?.shouldEscalate) {
-            message = `${escalation.deepModeValue} Run: /clavix:deep`;
+            message = `${escalation.comprehensiveValue} Run: /clavix:improve --comprehensive`;
         }
         return {
             message,
@@ -340,16 +355,16 @@ export class UniversalOptimizer {
         };
     }
     /**
-     * Get statistics about the optimizer
+     * v4.11: Get statistics about the optimizer
      */
     getStatistics() {
         const totalPatterns = this.patternLibrary.getPatternCount();
-        const fastModePatterns = this.patternLibrary.getPatternsByMode('fast').length;
-        const deepModePatterns = this.patternLibrary.getPatternsByMode('deep').length;
+        const standardPatterns = this.patternLibrary.getPatternsByScope('standard').length;
+        const comprehensivePatterns = this.patternLibrary.getPatternsByScope('comprehensive').length;
         return {
             totalPatterns,
-            fastModePatterns,
-            deepModePatterns,
+            standardPatterns,
+            comprehensivePatterns,
         };
     }
 }