clavix 4.9.0 → 4.11.1

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,
         };
     }
 }

package/dist/core/prompt-manager.d.ts

@@ -1,8 +1,12 @@
-export type PromptSource = 'fast' | 'deep';
+import { DepthLevel } from './intelligence/types.js';
+/**
+ * v4.11: Unified prompt metadata
+ * Replaces separate fast/deep storage with single directory and depthUsed field
+ */
 export interface PromptMetadata {
     id: string;
     filename: string;
-    source: PromptSource;
+    depthUsed: DepthLevel;
     timestamp: string;
     createdAt: Date;
     path: string;
@@ -24,15 +28,15 @@ export interface PromptData {
     content: string;
 }
 export interface PromptFilters {
-    source?: PromptSource;
+    depthUsed?: DepthLevel;
     executed?: boolean;
     stale?: boolean;
     old?: boolean;
 }
 export interface StorageStats {
     totalPrompts: number;
-    fastPrompts: number;
-    deepPrompts: number;
+    standardPrompts: number;
+    comprehensivePrompts: number;
     executedPrompts: number;
     pendingPrompts: number;
     stalePrompts: number;
@@ -43,39 +47,39 @@ export declare class PromptManager {
     private readonly promptsDir;
     constructor(baseDir?: string);
     /**
-     * Get index file path for a specific source
+     * v4.11: Get unified index file path
      */
     private getIndexPath;
     /**
-     * Ensure prompts directory structure exists
+     * v4.11: Ensure prompts directory exists (single directory)
      */
     ensurePromptsDir(): Promise<void>;
     /**
-     * Generate unique prompt ID with timestamp and hash
+     * v4.11: Generate unique prompt ID with depth and timestamp
      */
-    generatePromptId(source: PromptSource, _originalPrompt: string): string;
+    generatePromptId(depthLevel: DepthLevel, _originalPrompt: string): string;
     /**
-     * Save optimized prompt to file system
+     * v4.11: Save optimized prompt to file system
      */
-    savePrompt(content: string, source: PromptSource, originalPrompt: string, linkedProject?: string): Promise<PromptMetadata>;
+    savePrompt(content: string, depthUsed: DepthLevel, originalPrompt: string, linkedProject?: string): Promise<PromptMetadata>;
     /**
-     * Load prompt by ID
+     * v4.11: Load prompt by ID
      */
     loadPrompt(id: string): Promise<PromptData | null>;
     /**
-     * List prompts with optional filtering
+     * v4.11: List prompts with optional filtering
      */
     listPrompts(filters?: PromptFilters): Promise<PromptMetadata[]>;
     /**
-     * Mark prompt as executed
+     * v4.11: Mark prompt as executed
      */
     markExecuted(id: string): Promise<void>;
     /**
-     * Mark prompt as verified (v4.8)
+     * v4.11: Mark prompt as verified (v4.8)
      */
     markVerified(id: string): Promise<void>;
     /**
-     * Delete prompts by filter
+     * v4.11: Delete prompts by filter
      */
     deletePrompts(filters: PromptFilters): Promise<number>;
     /**
@@ -87,21 +91,19 @@ export declare class PromptManager {
      */
     getStalePrompts(_daysOld?: number): Promise<PromptMetadata[]>;
     /**
-     * Get storage statistics
+     * v4.11: Get storage statistics
      */
     getStorageStats(): Promise<StorageStats>;
     /**
-     * Load index from file
-     * If source is specified, loads that source's index only
-     * If source is undefined, loads and merges all source indexes
+     * v4.11: Load unified index from file
      */
     private loadIndex;
     /**
-     * Save index to file for a specific source
+     * v4.11: Save unified index to file
      */
     private saveIndex;
     /**
-     * Add prompt to index
+     * v4.11: Add prompt to unified index
      */
     private addToIndex;
 }