clavix 4.3.2 → 4.5.0

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

@@ -1,18 +1,22 @@
-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 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;
     private hasTopicOrganization;

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

@@ -1,17 +1,213 @@
-import { BasePattern } from './base-pattern.js';
+import { BasePattern, } from './base-pattern.js';
 /**
- * v4.3.2 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': [
+            'ui',
+            'interface',
+            'design',
+            'layout',
+            'button',
+            'form',
+            'page',
+            'screen',
+            'component',
+            'modal',
+            'dialog',
+            'navigation',
+            'menu',
+            'sidebar',
+            'header',
+            'footer',
+        ],
+        'Backend/API': [
+            'api',
+            'backend',
+            'server',
+            'endpoint',
+            'route',
+            'controller',
+            'service',
+            'middleware',
+            'rest',
+            'graphql',
+            'websocket',
+        ],
+        Database: [
+            'database',
+            'db',
+            'schema',
+            'table',
+            'query',
+            'migration',
+            'model',
+            'orm',
+            'sql',
+            'nosql',
+            'index',
+            'relationship',
+        ],
+        Authentication: [
+            'auth',
+            'login',
+            'password',
+            'session',
+            'token',
+            'permission',
+            'role',
+            'oauth',
+            'jwt',
+            'sso',
+            'mfa',
+            '2fa',
+        ],
+        Performance: [
+            'performance',
+            'speed',
+            'cache',
+            'optimize',
+            'latency',
+            'load time',
+            'bundle',
+            'lazy',
+            'memory',
+            'cpu',
+        ],
+        Testing: [
+            'test',
+            'spec',
+            'coverage',
+            'qa',
+            'validation',
+            'unit test',
+            'integration',
+            'e2e',
+            'mock',
+            'fixture',
+        ],
+        Deployment: [
+            'deploy',
+            'ci/cd',
+            'pipeline',
+            'release',
+            'environment',
+            'production',
+            'staging',
+            'docker',
+            'kubernetes',
+        ],
+        'User Experience': [
+            'ux',
+            'usability',
+            'accessibility',
+            'user flow',
+            'journey',
+            'experience',
+            'onboarding',
+            'feedback',
+        ],
+        'Business Logic': [
+            'business',
+            'workflow',
+            'process',
+            'rule',
+            'logic',
+            'requirement',
+            'feature',
+            'use case',
+        ],
+        Integration: [
+            'integration',
+            'third-party',
+            'external',
+            'webhook',
+            'sync',
+            'connect',
+            'import',
+            'export',
+        ],
+        Security: [
+            'security',
+            'encryption',
+            'vulnerability',
+            'xss',
+            'csrf',
+            'injection',
+            'sanitize',
+            'audit',
+        ],
+        Analytics: [
+            'analytics',
+            'tracking',
+            'metrics',
+            'dashboard',
+            'report',
+            'insight',
+            'data',
+            'statistics',
+        ],
+        'Error Handling': [
+            'error',
+            'exception',
+            'fallback',
+            'retry',
+            'timeout',
+            'failure',
+            'recovery',
+            'logging',
+        ],
+        Documentation: [
+            'documentation',
+            'docs',
+            'readme',
+            'guide',
+            'tutorial',
+            'api docs',
+            'comment',
+            'jsdoc',
+        ],
+        'State Management': [
+            'state',
+            'store',
+            'redux',
+            'context',
+            'global state',
+            'local state',
+            'persist',
+            'hydrate',
+        ],
+    };
     apply(prompt, _context) {
         // Detect topics in the content
         const topics = this.detectTopics(prompt);
@@ -54,20 +250,7 @@ export class TopicCoherenceAnalyzer extends BasePattern {
     detectTopics(prompt) {
         const topics = [];
         const lowerPrompt = prompt.toLowerCase();
-        // Topic detection patterns
-        const topicIndicators = {
-            'User Interface': ['ui', 'interface', 'design', 'layout', 'button', 'form', 'page', 'screen'],
-            'Backend/API': ['api', 'backend', 'server', 'endpoint', 'route', 'controller'],
-            Database: ['database', 'db', 'schema', 'table', 'query', 'migration'],
-            Authentication: ['auth', 'login', 'password', 'session', 'token', 'permission'],
-            Performance: ['performance', 'speed', 'cache', 'optimize', 'latency'],
-            Testing: ['test', 'spec', 'coverage', 'qa', 'validation'],
-            Deployment: ['deploy', 'ci/cd', 'pipeline', 'release', 'environment'],
-            'User Experience': ['ux', 'usability', 'accessibility', 'user flow', 'journey'],
-            'Business Logic': ['business', 'workflow', 'process', 'rule', 'logic'],
-            Integration: ['integration', 'third-party', 'external', 'webhook', 'sync'],
-        };
-        for (const [topic, keywords] of Object.entries(topicIndicators)) {
+        for (const [topic, keywords] of Object.entries(this.topicIndicators)) {
             const hasKeyword = keywords.some((kw) => lowerPrompt.includes(kw));
             if (hasKeyword) {
                 topics.push(topic);
@@ -99,30 +282,7 @@ export class TopicCoherenceAnalyzer extends BasePattern {
         return organized;
     }
     extractTopicContent(prompt, topic) {
-        // Simple extraction based on topic keywords
-        const topicKeywords = {
-            'User Interface': [
-                'ui',
-                'interface',
-                'design',
-                'layout',
-                'button',
-                'form',
-                'page',
-                'screen',
-                'component',
-            ],
-            'Backend/API': ['api', 'backend', 'server', 'endpoint', 'route', 'controller', 'service'],
-            Database: ['database', 'db', 'schema', 'table', 'query', 'migration', 'model'],
-            Authentication: ['auth', 'login', 'password', 'session', 'token', 'permission', 'user'],
-            Performance: ['performance', 'speed', 'cache', 'optimize', 'latency', 'fast', 'slow'],
-            Testing: ['test', 'spec', 'coverage', 'qa', 'validation', 'verify'],
-            Deployment: ['deploy', 'ci/cd', 'pipeline', 'release', 'environment', 'production'],
-            'User Experience': ['ux', 'usability', 'accessibility', 'user flow', 'journey', 'experience'],
-            'Business Logic': ['business', 'workflow', 'process', 'rule', 'logic', 'requirement'],
-            Integration: ['integration', 'third-party', 'external', 'webhook', 'sync', 'connect'],
-        };
-        const keywords = topicKeywords[topic] || [];
+        const keywords = this.topicIndicators[topic] || [];
         const sentences = this.extractSentences(prompt);
         const relevantSentences = sentences.filter((sentence) => {
             const lower = sentence.toLowerCase();

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/_canonical/deep.md

@@ -179,7 +179,7 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### Quality Output Format
 {{INCLUDE:agent-protocols/quality-output.md}}

package/dist/templates/slash-commands/_canonical/execute.md

@@ -109,7 +109,7 @@ clavix prompts clear --executed
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### File Format Reference
 {{INCLUDE:agent-protocols/file-formats.md}}

package/dist/templates/slash-commands/_canonical/fast.md

@@ -158,7 +158,7 @@ Clavix provides **Clavix Intelligence™** that automatically detects intent and
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### Quality Output Format
 {{INCLUDE:agent-protocols/quality-output.md}}

package/dist/templates/slash-commands/_canonical/implement.md

@@ -315,7 +315,7 @@ To find the task ID programmatically, read tasks.md and look for the pattern `ph
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}

package/dist/templates/slash-commands/_canonical/plan.md

@@ -288,7 +288,7 @@ The generated `tasks.md` will look like:
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}

package/dist/templates/slash-commands/_canonical/prd.md

@@ -316,7 +316,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
 
 ### Quality Output Format
 {{INCLUDE:agent-protocols/quality-output.md}}

package/dist/templates/slash-commands/_canonical/start.md

@@ -190,7 +190,27 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
+
+### Enhanced Conversational Analysis (v4.4)
+
+Clavix Intelligence™ now includes enhanced conversational pattern recognition:
+
+**Topic Detection** (~15 topic areas):
+- Automatically detects: User Interface, Backend/API, Database, Authentication, Performance, Testing, Deployment, User Experience, Business Logic, Integration, Security, Analytics, Error Handling, Documentation, State Management
+- Groups related keywords for more accurate multi-topic detection
+- Triggers focus suggestions when 3+ distinct topics detected
+
+**Conversational Markers** (~30 patterns):
+- Intent expressions: "i want", "we need", "should be able to"
+- Thinking/exploring: "thinking about", "what if", "how about"
+- Informal markers: "basically", "kind of like", "something like"
+- Collaborative: "can we", "could we", "shall we"
+
+**Implicit Requirement Detection**:
+- Surfaces unstated requirements from context
+- Categories: Infrastructure, Security, Performance, UX, Integration
+- Examples: "mobile" → responsive design, "real-time" → WebSocket infrastructure
 
 ### Agent Decision Rules
 {{INCLUDE:agent-protocols/decision-rules.md}}

package/dist/templates/slash-commands/_canonical/summarize.md

@@ -104,7 +104,15 @@ Implementation: BLOCKED - I will extract requirements, not implement them
    - **Success Criteria** [confidence]: How will success be measured?
    - **Context** [confidence]: Any important background or constraints?
 
-   **CHECKPOINT:** Extracted [N] requirements, [M] constraints from conversation
+   **Calculate Extraction Confidence (v4.4):**
+   - Start with 50% base (conversational content detected)
+   - Add 20% if concrete requirements extracted
+   - Add 15% if clear goals identified
+   - Add 15% if constraints defined
+   - Display: "*Extraction confidence: X%*"
+   - If confidence < 80%, include verification prompt in output
+
+   **CHECKPOINT:** Extracted [N] requirements, [M] constraints from conversation (confidence: X%)
 
 3. **CREATE OUTPUT FILES (REQUIRED)** - You MUST create three files. This is not optional.
 
@@ -156,6 +164,12 @@ Implementation: BLOCKED - I will extract requirements, not implement them
    - [Edge case 1 and how it should be handled]
    - [Open question 1 - needs clarification]
 
+   ## Implicit Requirements (v4.4)
+   *Inferred from conversation context - please verify:*
+   - [Category] [Requirement inferred from discussion]
+   - [Category] [Another requirement]
+   > **Note:** These requirements were surfaced by analyzing conversation patterns.
+
    ## Success Criteria
    How we know this is complete and working:
    - ✓ [Specific success criterion 1]
@@ -344,7 +358,34 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
 ---
 
-## Agent Transparency (v4.1)
+## Agent Transparency (v4.4)
+
+### Enhanced Extraction Capabilities (v4.4)
+
+Clavix Intelligence™ now includes enhanced extraction with confidence scoring:
+
+**Extraction Confidence** (auto-calculated):
+- Base confidence: 50% (conversational content detected)
+- +20% if concrete requirements extracted
+- +15% if clear goals identified
+- +15% if constraints defined
+- Display: "Extraction confidence: X%"
+- If <80%, add verification prompt to output
+
+**Implicit Requirements** (auto-surfaced):
+- Inferred from conversation context, grouped by category:
+  - **Infrastructure**: Mobile-responsive, real-time, scalability, offline, multi-tenant
+  - **Security**: Audit compliance, data privacy, encryption
+  - **Performance**: Speed optimization, low-latency
+  - **UX**: Simplicity focus, accessibility (WCAG)
+  - **Integration**: Notifications, search, analytics, APIs, data import/export
+- Up to 10 implicit requirements per extraction
+- Always marked with verification note
+
+**Topic Organization**:
+- Detects 15 topic categories with expanded keyword matching
+- Groups multi-topic extractions by area
+- Suggests separate PRDs for 3+ distinct topics
 
 ### Quality Output Format
 {{INCLUDE:agent-protocols/quality-output.md}}

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