clavix 4.4.0 → 4.5.0

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

@@ -1,11 +1,44 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, } from './base-pattern.js';
+/**
+ * v4.5 Pattern: Technical Context Enricher
+ *
+ * Adds missing technical context (language, framework, versions).
+ * Detects technologies and suggests version specifications.
+ */
 export class TechnicalContextEnricher extends BasePattern {
+    // -------------------------------------------------------------------------
+    // Pattern Metadata (v4.5 unified types)
+    // -------------------------------------------------------------------------
     id = 'technical-context-enricher';
     name = 'Technical Context Enricher';
     description = 'Adds missing technical context (language, framework, versions)';
     applicableIntents = ['code-generation', 'refinement', 'debugging'];
     mode = 'both';
-    priority = 8;
+    priority = 5; // MEDIUM-LOW - supplementary context
+    phases = ['all'];
+    // v4.5: Dependencies
+    dependencies = {
+        runAfter: ['objective-clarifier'], // Clarify objective first, then add technical context
+        enhancedBy: ['domain-context-enricher'],
+    };
+    // -------------------------------------------------------------------------
+    // Configuration Schema (v4.5)
+    // -------------------------------------------------------------------------
+    static configSchema = {
+        detectFrameworks: {
+            type: 'boolean',
+            default: true,
+            description: 'Detect and add framework information',
+        },
+        suggestVersions: {
+            type: 'boolean',
+            default: true,
+            description: 'Suggest adding version information when missing',
+        },
+    };
+    // -------------------------------------------------------------------------
+    // Pattern Application
+    // -------------------------------------------------------------------------
     apply(prompt, context) {
         const lowerPrompt = prompt.toLowerCase();
         const enhancements = [];
@@ -16,9 +49,9 @@ export class TechnicalContextEnricher extends BasePattern {
                 improvement: {
                     dimension: 'completeness',
                     description: 'Technical context already specified',
-                    impact: 'low'
+                    impact: 'low',
                 },
-                applied: false
+                applied: false,
             };
         }
         // Detect language mentions without versions
@@ -40,22 +73,22 @@ export class TechnicalContextEnricher extends BasePattern {
                 improvement: {
                     dimension: 'completeness',
                     description: 'No additional technical context needed',
-                    impact: 'low'
+                    impact: 'low',
                 },
-                applied: false
+                applied: false,
             };
         }
         // Add technical context section
-        const contextSection = `\n\n# Technical Constraints\n${enhancements.map(e => `- ${e}`).join('\n')}`;
+        const contextSection = `\n\n# Technical Constraints\n${enhancements.map((e) => `- ${e}`).join('\n')}`;
         const enhanced = prompt + contextSection;
         return {
             enhancedPrompt: enhanced,
             improvement: {
                 dimension: 'completeness',
                 description: `Added ${enhancements.length} technical context specifications`,
-                impact: 'medium'
+                impact: 'medium',
             },
-            applied: true
+            applied: true,
         };
     }
     hasTechnicalContext(prompt) {
@@ -63,25 +96,25 @@ export class TechnicalContextEnricher extends BasePattern {
             /version|v\d+\.\d+/i,
             /technical (context|constraints|requirements)/i,
             /language:.*framework:/i,
-            /using (python|javascript|typescript|java|rust|go) \d/i
+            /using (python|javascript|typescript|java|rust|go) \d/i,
         ];
-        return contextMarkers.some(marker => marker.test(prompt));
+        return contextMarkers.some((marker) => marker.test(prompt));
     }
     detectLanguage(prompt) {
         const languages = {
-            'python': 'Python',
-            'javascript': 'JavaScript',
-            'typescript': 'TypeScript',
-            'java': 'Java',
-            'rust': 'Rust',
-            'go': 'Go',
-            'php': 'PHP',
-            'ruby': 'Ruby',
-            'swift': 'Swift',
-            'kotlin': 'Kotlin',
+            python: 'Python',
+            javascript: 'JavaScript',
+            typescript: 'TypeScript',
+            java: 'Java',
+            rust: 'Rust',
+            go: 'Go',
+            php: 'PHP',
+            ruby: 'Ruby',
+            swift: 'Swift',
+            kotlin: 'Kotlin',
             'c++': 'C++',
-            'csharp': 'C#',
-            'c#': 'C#'
+            csharp: 'C#',
+            'c#': 'C#',
         };
         for (const [key, name] of Object.entries(languages)) {
             if (prompt.includes(key)) {
@@ -102,21 +135,21 @@ export class TechnicalContextEnricher extends BasePattern {
     }
     detectFramework(prompt) {
         const frameworks = {
-            'react': 'React',
-            'vue': 'Vue.js',
-            'angular': 'Angular',
-            'svelte': 'Svelte',
-            'next': 'Next.js',
-            'nextjs': 'Next.js',
-            'nuxt': 'Nuxt.js',
-            'django': 'Django',
-            'flask': 'Flask',
-            'fastapi': 'FastAPI',
-            'express': 'Express.js',
-            'nestjs': 'NestJS',
-            'spring': 'Spring Boot',
-            'rails': 'Ruby on Rails',
-            'laravel': 'Laravel'
+            react: 'React',
+            vue: 'Vue.js',
+            angular: 'Angular',
+            svelte: 'Svelte',
+            next: 'Next.js',
+            nextjs: 'Next.js',
+            nuxt: 'Nuxt.js',
+            django: 'Django',
+            flask: 'Flask',
+            fastapi: 'FastAPI',
+            express: 'Express.js',
+            nestjs: 'NestJS',
+            spring: 'Spring Boot',
+            rails: 'Ruby on Rails',
+            laravel: 'Laravel',
         };
         for (const [key, name] of Object.entries(frameworks)) {
             if (prompt.includes(key)) {

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

@@ -1,19 +1,21 @@
-import { BasePattern } from './base-pattern.js';
-import { PromptIntent, OptimizationMode, PatternContext, PatternResult } from '../types.js';
+import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
- * v4.4 Conversational Pattern: TopicCoherenceAnalyzer
+ * v4.5 Pattern: Topic Coherence Analyzer
  *
  * Detects topic shifts and multi-topic conversations.
  * Helps organize scattered discussions into coherent themes.
  * Enhanced with expanded topic dictionary and better detection.
  */
 export declare class TopicCoherenceAnalyzer extends BasePattern {
-    id: string;
-    name: string;
-    description: string;
-    applicableIntents: PromptIntent[];
-    mode: OptimizationMode | 'both';
-    priority: number;
+    readonly id = "topic-coherence-analyzer";
+    readonly name = "Topic Coherence Analyzer";
+    readonly description = "Detects topic shifts and multi-topic conversations";
+    readonly applicableIntents: PromptIntent[];
+    readonly mode: PatternMode;
+    readonly priority: PatternPriority;
+    readonly phases: PatternPhase[];
+    static readonly configSchema: PatternConfigSchema;
     private readonly topicIndicators;
     apply(prompt: string, _context: PatternContext): PatternResult;
     private detectTopics;

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

@@ -1,18 +1,36 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, } from './base-pattern.js';
 /**
- * v4.4 Conversational Pattern: TopicCoherenceAnalyzer
+ * v4.5 Pattern: Topic Coherence Analyzer
  *
  * Detects topic shifts and multi-topic conversations.
  * Helps organize scattered discussions into coherent themes.
  * Enhanced with expanded topic dictionary and better detection.
  */
 export class TopicCoherenceAnalyzer extends BasePattern {
+    // -------------------------------------------------------------------------
+    // Pattern Metadata (v4.5 unified types)
+    // -------------------------------------------------------------------------
     id = 'topic-coherence-analyzer';
-    name = 'TopicCoherenceAnalyzer';
+    name = 'Topic Coherence Analyzer';
     description = 'Detects topic shifts and multi-topic conversations';
     applicableIntents = ['summarization', 'planning'];
     mode = 'deep';
-    priority = 6;
+    priority = 6; // MEDIUM - standard enhancement
+    phases = ['conversation-tracking', 'summarization'];
+    // -------------------------------------------------------------------------
+    // Configuration Schema (v4.5)
+    // -------------------------------------------------------------------------
+    static configSchema = {
+        minTopicsForOrganization: {
+            type: 'number',
+            default: 2,
+            description: 'Minimum number of topics before organizing',
+            validation: { min: 2, max: 5 },
+        },
+    };
+    // -------------------------------------------------------------------------
+    // Pattern Data
+    // -------------------------------------------------------------------------
     // Expanded topic indicators (~15 topics with more keywords)
     topicIndicators = {
         'User Interface': [

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

@@ -1,18 +1,20 @@
-import { BasePattern } from './base-pattern.js';
-import { PromptIntent, OptimizationMode, PatternContext, PatternResult } from '../types.js';
+import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema } from './base-pattern.js';
+import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
- * v4.3.2 PRD Pattern: UserPersonaEnricher
+ * v4.5 Pattern: User Persona Enricher
  *
  * Adds missing user context and personas to PRD content.
  * Ensures the "who" is clearly defined alongside the "what".
  */
 export declare class UserPersonaEnricher extends BasePattern {
-    id: string;
-    name: string;
-    description: string;
-    applicableIntents: PromptIntent[];
-    mode: OptimizationMode | 'both';
-    priority: number;
+    readonly id = "user-persona-enricher";
+    readonly name = "User Persona Enricher";
+    readonly description = "Adds missing user context and personas";
+    readonly applicableIntents: PromptIntent[];
+    readonly mode: PatternMode;
+    readonly priority: PatternPriority;
+    readonly phases: PatternPhase[];
+    static readonly configSchema: PatternConfigSchema;
     apply(prompt: string, _context: PatternContext): PatternResult;
     private hasUserContext;
     private needsUserContext;

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

@@ -1,17 +1,34 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, } from './base-pattern.js';
 /**
- * v4.3.2 PRD Pattern: UserPersonaEnricher
+ * v4.5 Pattern: User Persona Enricher
  *
  * Adds missing user context and personas to PRD content.
  * Ensures the "who" is clearly defined alongside the "what".
  */
 export class UserPersonaEnricher extends BasePattern {
+    // -------------------------------------------------------------------------
+    // Pattern Metadata (v4.5 unified types)
+    // -------------------------------------------------------------------------
     id = 'user-persona-enricher';
-    name = 'UserPersonaEnricher';
+    name = 'User Persona Enricher';
     description = 'Adds missing user context and personas';
     applicableIntents = ['prd-generation', 'planning'];
     mode = 'deep';
-    priority = 6;
+    priority = 6; // MEDIUM - standard enhancement
+    phases = ['question-validation', 'output-generation'];
+    // -------------------------------------------------------------------------
+    // Configuration Schema (v4.5)
+    // -------------------------------------------------------------------------
+    static configSchema = {
+        inferUserType: {
+            type: 'boolean',
+            default: true,
+            description: 'Attempt to infer user type from content',
+        },
+    };
+    // -------------------------------------------------------------------------
+    // Pattern Application
+    // -------------------------------------------------------------------------
     apply(prompt, _context) {
         // Check if user/persona context already exists
         if (this.hasUserContext(prompt)) {

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

@@ -1,18 +1,21 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, PatternMode, PatternPriority, PatternPhase, PatternConfigSchema, PatternDependency } from './base-pattern.js';
 import { PromptIntent, PatternContext, PatternResult } from '../types.js';
 /**
- * v4.0 Deep Mode Pattern: Validation Checklist Creator
+ * v4.5 Pattern: Validation Checklist Creator
  *
  * Creates implementation validation checklists to ensure
  * comprehensive verification of completed work.
  */
 export declare class ValidationChecklistCreator extends BasePattern {
-    id: string;
-    name: string;
-    description: string;
-    applicableIntents: PromptIntent[];
-    mode: "deep";
-    priority: number;
+    readonly id = "validation-checklist-creator";
+    readonly name = "Validation Checklist Creator";
+    readonly description = "Create implementation validation checklist for verification";
+    readonly applicableIntents: PromptIntent[];
+    readonly mode: PatternMode;
+    readonly priority: PatternPriority;
+    readonly phases: PatternPhase[];
+    readonly dependencies: PatternDependency;
+    static readonly configSchema: PatternConfigSchema;
     apply(prompt: string, context: PatternContext): PatternResult;
     private createChecklist;
     private getCodeGenerationChecklist;

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

@@ -1,11 +1,14 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, } from './base-pattern.js';
 /**
- * v4.0 Deep Mode Pattern: Validation Checklist Creator
+ * v4.5 Pattern: Validation Checklist Creator
  *
  * Creates implementation validation checklists to ensure
  * comprehensive verification of completed work.
  */
 export class ValidationChecklistCreator extends BasePattern {
+    // -------------------------------------------------------------------------
+    // Pattern Metadata (v4.5 unified types)
+    // -------------------------------------------------------------------------
     id = 'validation-checklist-creator';
     name = 'Validation Checklist Creator';
     description = 'Create implementation validation checklist for verification';
@@ -17,7 +20,32 @@ export class ValidationChecklistCreator extends BasePattern {
         'debugging',
     ];
     mode = 'deep';
-    priority = 3;
+    priority = 3; // VERY LOW - final touches
+    phases = ['all'];
+    // v4.5: Dependencies
+    dependencies = {
+        runAfter: ['success-criteria-enforcer'], // Checklist should include success criteria
+        enhancedBy: ['edge-case-identifier'],
+    };
+    // -------------------------------------------------------------------------
+    // Configuration Schema (v4.5)
+    // -------------------------------------------------------------------------
+    static configSchema = {
+        maxChecklistItems: {
+            type: 'number',
+            default: 12,
+            description: 'Maximum number of checklist items',
+            validation: { min: 5, max: 20 },
+        },
+        groupByCategory: {
+            type: 'boolean',
+            default: true,
+            description: 'Group checklist items by category',
+        },
+    };
+    // -------------------------------------------------------------------------
+    // Pattern Application
+    // -------------------------------------------------------------------------
     apply(prompt, context) {
         const checklist = this.createChecklist(prompt, context.intent.primaryIntent);
         if (checklist.length === 0) {

package/dist/templates/slash-commands/_components/references/intent-types.md

@@ -1,6 +1,6 @@
 ## Intent Types Reference
 
-Clavix Intelligence™ detects 10 primary intent types. This reference is synchronized with `src/core/intelligence/types.ts`.
+Clavix Intelligence™ detects 11 primary intent types. This reference is synchronized with `src/core/intelligence/types.ts`.
 
 ### Intent Categories
 
@@ -16,6 +16,7 @@ Clavix Intelligence™ detects 10 primary intent types. This reference is synchr
 | **migration** | Version upgrades, porting code | "migrate", "upgrade", "port", "convert", "transition" |
 | **security-review** | Security audits, vulnerability checks | "security", "audit", "vulnerability", "OWASP", "CVE" |
 | **learning** | Conceptual understanding, tutorials | "explain", "how does", "tutorial", "understand" |
+| **summarization** | Extracting requirements from conversations | "summarize", "extract", "requirements from" |
 
 ### Intent Detection Confidence Levels
 
@@ -35,3 +36,4 @@ Different intents enable different optimization patterns:
 - **debugging**: ErrorToleranceEnhancer, EdgeCaseIdentifier
 - **testing**: ValidationChecklistCreator, EdgeCaseIdentifier
 - **prd-generation**: PRDStructureEnforcer, CompletenessValidator
+- **summarization**: ConversationSummarizer, TopicCoherenceAnalyzer, ImplicitRequirementExtractor

package/dist/templates/slash-commands/_components/sections/pattern-visibility.md

@@ -46,19 +46,19 @@ Patterns: 7 applied (deep mode)
 **Core Patterns (fast + deep):**
 | Pattern | Priority | What It Does |
 |---------|----------|--------------|
-| ConcisenessFilter | 10 | Removes pleasantries, filler words, redundant phrases |
+| ConcisenessFilter | 4 | Removes pleasantries, filler words, redundant phrases |
 | ObjectiveClarifier | 9 | Adds clear objective/goal statement if missing |
 | StructureOrganizer | 8 | Reorders into logical flow: context→requirements→constraints→output |
-| ActionabilityEnhancer | 7 | Converts vague language to specific, actionable terms |
-| TechnicalContextEnricher | 8 | Adds missing technical context (frameworks, tools, versions) |
+| ActionabilityEnhancer | 4 | Converts vague language to specific, actionable terms |
+| TechnicalContextEnricher | 5 | Adds missing technical context (frameworks, tools, versions) |
 | CompletenessValidator | 6 | Identifies and flags missing required elements |
-| StepDecomposer | 7 | Breaks complex prompts into sequential steps |
-| ContextPrecisionBooster | 8 | Adds precise context when missing |
+| StepDecomposer | 5 | Breaks complex prompts into sequential steps |
+| ContextPrecisionBooster | 6 | Adds precise context when missing |
 
 **Deep Mode Exclusive Patterns:**
 | Pattern | Priority | What It Does |
 |---------|----------|--------------|
-| AlternativePhrasingGenerator | 5 | Generates 2-3 alternative prompt structures |
+| AlternativePhrasingGenerator | 3 | Generates 2-3 alternative prompt structures |
 | EdgeCaseIdentifier | 4 | Identifies domain-specific edge cases |
 | ValidationChecklistCreator | 3 | Creates implementation verification checklist |
 | AssumptionExplicitizer | 6 | Makes implicit assumptions explicit |
@@ -72,7 +72,7 @@ Patterns: 7 applied (deep mode)
 |---------|----------|--------------|
 | AmbiguityDetector | 9 | Identifies and flags ambiguous terms |
 | OutputFormatEnforcer | 7 | Adds explicit output format specifications |
-| SuccessCriteriaEnforcer | 6 | Adds measurable success criteria |
+| SuccessCriteriaEnforcer | 7 | Adds measurable success criteria |
 | DomainContextEnricher | 5 | Adds domain-specific best practices |
 
 **v4.3.2 PRD Mode Patterns (deep mode):**
@@ -88,7 +88,7 @@ Patterns: 7 applied (deep mode)
 |---------|----------|--------------|
 | ConversationSummarizer | 8 | Extracts structured requirements from messages |
 | TopicCoherenceAnalyzer | 6 | Detects topic shifts and multi-topic conversations |
-| ImplicitRequirementExtractor | 7 | Surfaces requirements mentioned indirectly |
+| ImplicitRequirementExtractor | 5 | Surfaces requirements mentioned indirectly |
 
 ### Pattern Selection Logic
 
@@ -137,7 +137,7 @@ v4.3.2 Conversational mode (deep):
 
 | Mode | Patterns Available | Typical Applied |
 |------|-------------------|-----------------|
-| Fast | 21 core patterns | 4-7 patterns |
+| Fast | 12 core patterns | 4-7 patterns |
 | Deep | 27 total patterns | 8-14 patterns |
 | PRD | 15 patterns | 10-15 patterns |
 | Conversational | 11 patterns | 6-11 patterns |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "Clavix Intelligence™ for AI coding. Automatically optimizes prompts with intent detection, quality assessment, and adaptive patterns—no framework to learn. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",