clavix 4.3.1 → 4.3.2

package/dist/core/intelligence/pattern-library.js

@@ -21,6 +21,15 @@ import { SuccessCriteriaEnforcer } from './patterns/success-criteria-enforcer.js
 import { ErrorToleranceEnhancer } from './patterns/error-tolerance-enhancer.js';
 import { PrerequisiteIdentifier } from './patterns/prerequisite-identifier.js';
 import { DomainContextEnricher } from './patterns/domain-context-enricher.js';
+// v4.3.2 PRD patterns
+import { RequirementPrioritizer } from './patterns/requirement-prioritizer.js';
+import { UserPersonaEnricher } from './patterns/user-persona-enricher.js';
+import { SuccessMetricsEnforcer } from './patterns/success-metrics-enforcer.js';
+import { DependencyIdentifier } from './patterns/dependency-identifier.js';
+// v4.3.2 Conversational patterns
+import { ConversationSummarizer } from './patterns/conversation-summarizer.js';
+import { TopicCoherenceAnalyzer } from './patterns/topic-coherence-analyzer.js';
+import { ImplicitRequirementExtractor } from './patterns/implicit-requirement-extractor.js';
 export class PatternLibrary {
     patterns = new Map();
     constructor() {
@@ -51,6 +60,15 @@ export class PatternLibrary {
         this.register(new ErrorToleranceEnhancer()); // P5 - Add error handling (deep only)
         this.register(new PrerequisiteIdentifier()); // P6 - Identify prerequisites (deep only)
         this.register(new DomainContextEnricher()); // P5 - Add domain best practices (both modes)
+        // v4.3.2 PRD patterns
+        this.register(new RequirementPrioritizer()); // P7 - Separate must-have from nice-to-have
+        this.register(new UserPersonaEnricher()); // P6 - Add user context and personas
+        this.register(new SuccessMetricsEnforcer()); // P7 - Ensure measurable success criteria
+        this.register(new DependencyIdentifier()); // P5 - Identify technical/external dependencies
+        // v4.3.2 Conversational patterns
+        this.register(new ConversationSummarizer()); // P8 - Extract structured requirements
+        this.register(new TopicCoherenceAnalyzer()); // P6 - Detect topic shifts
+        this.register(new ImplicitRequirementExtractor()); // P7 - Surface implicit requirements
     }
     /**
      * Register a new pattern
@@ -102,6 +120,119 @@ export class PatternLibrary {
         // Sort by priority (highest first)
         return applicablePatterns.sort((a, b) => b.priority - a.priority);
     }
+    /**
+     * v4.3.2: Select patterns for specific mode with phase-awareness
+     * Maps PRD and conversational modes to appropriate base modes and patterns
+     */
+    selectPatternsForMode(mode, intent, phase) {
+        // Map PRD/conversational modes to base modes for pattern selection
+        const baseMode = this.mapToBaseMode(mode, phase);
+        const applicablePatterns = [];
+        for (const pattern of this.patterns.values()) {
+            // Check mode compatibility (use mapped base mode)
+            if (pattern.mode !== 'both' && pattern.mode !== baseMode) {
+                continue;
+            }
+            // Check intent compatibility
+            if (!pattern.applicableIntents.includes(intent.primaryIntent)) {
+                continue;
+            }
+            // Phase-specific filtering for PRD mode
+            if (mode === 'prd' && phase) {
+                if (!this.isPatternApplicableForPRDPhase(pattern, phase)) {
+                    continue;
+                }
+            }
+            // Phase-specific filtering for conversational mode
+            if (mode === 'conversational' && phase) {
+                if (!this.isPatternApplicableForConversationalPhase(pattern, phase)) {
+                    continue;
+                }
+            }
+            applicablePatterns.push(pattern);
+        }
+        // Sort by priority (highest first)
+        return applicablePatterns.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Map extended modes to base modes for pattern compatibility
+     */
+    mapToBaseMode(mode, phase) {
+        switch (mode) {
+            case 'prd':
+                // PRD uses deep mode for output generation, fast for validation
+                return phase === 'question-validation' ? 'fast' : 'deep';
+            case 'conversational':
+                // Conversational uses fast mode for tracking, deep for summarization
+                return phase === 'summarization' ? 'deep' : 'fast';
+            case 'fast':
+            case 'deep':
+            default:
+                return mode;
+        }
+    }
+    /**
+     * Check if pattern is applicable for PRD phase
+     */
+    isPatternApplicableForPRDPhase(pattern, phase) {
+        // Patterns for question validation (lightweight, clarity-focused)
+        const questionValidationPatterns = [
+            'ambiguity-detector',
+            'completeness-validator',
+            'objective-clarifier',
+        ];
+        // Patterns for output generation (comprehensive)
+        const outputGenerationPatterns = [
+            'prd-structure-enforcer',
+            'structure-organizer',
+            'success-criteria-enforcer',
+            'scope-definer',
+            'edge-case-identifier',
+            'assumption-explicitizer',
+            'technical-context-enricher',
+            'domain-context-enricher',
+            // v4.3.2 PRD patterns will be added here
+            'requirement-prioritizer',
+            'user-persona-enricher',
+            'success-metrics-enforcer',
+            'dependency-identifier',
+        ];
+        if (phase === 'question-validation') {
+            return questionValidationPatterns.includes(pattern.id);
+        }
+        if (phase === 'output-generation') {
+            return outputGenerationPatterns.includes(pattern.id);
+        }
+        return true; // Default: allow pattern
+    }
+    /**
+     * Check if pattern is applicable for conversational phase
+     */
+    isPatternApplicableForConversationalPhase(pattern, phase) {
+        // Patterns for conversation tracking (minimal, non-intrusive)
+        const conversationTrackingPatterns = ['ambiguity-detector', 'completeness-validator'];
+        // Patterns for summarization (comprehensive extraction)
+        const summarizationPatterns = [
+            'structure-organizer',
+            'completeness-validator',
+            'success-criteria-enforcer',
+            'edge-case-identifier',
+            'actionability-enhancer',
+            'technical-context-enricher',
+            'domain-context-enricher',
+            // v4.3.2 Conversational patterns will be added here
+            'conversation-summarizer',
+            'topic-coherence-analyzer',
+            'implicit-requirement-extractor',
+        ];
+        if (phase === 'conversation-tracking') {
+            return conversationTrackingPatterns.includes(pattern.id);
+        }
+        if (phase === 'summarization') {
+            return summarizationPatterns.includes(pattern.id);
+        }
+        return true; // Default: allow pattern
+    }
     /**
      * Get all registered patterns
      */

package/dist/core/intelligence/patterns/conversation-summarizer.d.ts

@@ -0,0 +1,25 @@
+import { BasePattern } from './base-pattern.js';
+import { PromptIntent, OptimizationMode, PatternContext, PatternResult } from '../types.js';
+/**
+ * v4.3.2 Conversational Pattern: ConversationSummarizer
+ *
+ * Extracts structured requirements from conversational messages.
+ * Organizes free-form discussion into actionable requirements.
+ */
+export declare class ConversationSummarizer extends BasePattern {
+    id: string;
+    name: string;
+    description: string;
+    applicableIntents: PromptIntent[];
+    mode: OptimizationMode | 'both';
+    priority: number;
+    apply(prompt: string, _context: PatternContext): PatternResult;
+    private isAlreadyStructured;
+    private isConversationalContent;
+    private extractAndStructure;
+    private extractRequirements;
+    private extractConstraints;
+    private extractGoals;
+    private cleanRequirement;
+}
+//# sourceMappingURL=conversation-summarizer.d.ts.map

package/dist/core/intelligence/patterns/conversation-summarizer.js

@@ -0,0 +1,197 @@
+import { BasePattern } from './base-pattern.js';
+/**
+ * v4.3.2 Conversational Pattern: ConversationSummarizer
+ *
+ * Extracts structured requirements from conversational messages.
+ * Organizes free-form discussion into actionable requirements.
+ */
+export class ConversationSummarizer extends BasePattern {
+    id = 'conversation-summarizer';
+    name = 'ConversationSummarizer';
+    description = 'Extracts structured requirements from messages';
+    applicableIntents = ['summarization', 'planning', 'prd-generation'];
+    mode = 'deep';
+    priority = 8;
+    apply(prompt, _context) {
+        // Check if content is already well-structured
+        if (this.isAlreadyStructured(prompt)) {
+            return {
+                enhancedPrompt: prompt,
+                improvement: {
+                    dimension: 'structure',
+                    description: 'Content already well-structured',
+                    impact: 'low',
+                },
+                applied: false,
+            };
+        }
+        // Check if this looks like conversational content
+        if (!this.isConversationalContent(prompt)) {
+            return {
+                enhancedPrompt: prompt,
+                improvement: {
+                    dimension: 'structure',
+                    description: 'Not conversational content',
+                    impact: 'low',
+                },
+                applied: false,
+            };
+        }
+        // Extract and structure requirements
+        const enhanced = this.extractAndStructure(prompt);
+        return {
+            enhancedPrompt: enhanced,
+            improvement: {
+                dimension: 'structure',
+                description: 'Extracted structured requirements from conversation',
+                impact: 'high',
+            },
+            applied: true,
+        };
+    }
+    isAlreadyStructured(prompt) {
+        // Check for markdown structure
+        const structureIndicators = [
+            '##',
+            '###',
+            '**Requirements:**',
+            '**Features:**',
+            '- [ ]',
+            '1.',
+            '2.',
+            '3.',
+        ];
+        const matches = structureIndicators.filter((indicator) => prompt.includes(indicator));
+        return matches.length >= 3;
+    }
+    isConversationalContent(prompt) {
+        // Conversational markers
+        const conversationalMarkers = [
+            'i want',
+            'i need',
+            'we need',
+            'should be able to',
+            'would like',
+            'thinking about',
+            'maybe we could',
+            'what if',
+            'how about',
+            'let me',
+            "let's",
+            'also',
+            'and then',
+            'basically',
+            'so basically',
+        ];
+        const lowerPrompt = prompt.toLowerCase();
+        const matches = conversationalMarkers.filter((marker) => lowerPrompt.includes(marker));
+        // Also check for lack of structure (sentences without bullet points)
+        const sentences = this.extractSentences(prompt);
+        const hasBulletPoints = prompt.includes('- ') || prompt.includes('* ');
+        return matches.length >= 2 || (sentences.length > 3 && !hasBulletPoints);
+    }
+    extractAndStructure(prompt) {
+        const requirements = this.extractRequirements(prompt);
+        const constraints = this.extractConstraints(prompt);
+        const goals = this.extractGoals(prompt);
+        let structured = '### Extracted Requirements\n\n';
+        if (goals.length > 0) {
+            structured += '**Goals:**\n';
+            structured += goals.map((g) => `- ${g}`).join('\n');
+            structured += '\n\n';
+        }
+        if (requirements.length > 0) {
+            structured += '**Requirements:**\n';
+            structured += requirements.map((r) => `- ${r}`).join('\n');
+            structured += '\n\n';
+        }
+        if (constraints.length > 0) {
+            structured += '**Constraints:**\n';
+            structured += constraints.map((c) => `- ${c}`).join('\n');
+            structured += '\n\n';
+        }
+        structured += '---\n\n**Original Context:**\n' + prompt;
+        return structured;
+    }
+    extractRequirements(prompt) {
+        const requirements = [];
+        const sentences = this.extractSentences(prompt);
+        const requirementPatterns = [
+            /(?:need|want|should|must|require)\s+(?:to\s+)?(.+)/i,
+            /(?:should be able to|needs to)\s+(.+)/i,
+            /(?:feature|functionality):\s*(.+)/i,
+        ];
+        for (const sentence of sentences) {
+            for (const pattern of requirementPatterns) {
+                const match = sentence.match(pattern);
+                if (match && match[1]) {
+                    const req = this.cleanRequirement(match[1]);
+                    if (req && !requirements.includes(req)) {
+                        requirements.push(req);
+                    }
+                }
+            }
+        }
+        return requirements.slice(0, 10); // Max 10 requirements
+    }
+    extractConstraints(prompt) {
+        const constraints = [];
+        const lowerPrompt = prompt.toLowerCase();
+        const constraintPatterns = [
+            /(?:can't|cannot|shouldn't|must not)\s+(.+)/gi,
+            /(?:limited to|restricted to|only)\s+(.+)/gi,
+            /(?:within|budget|deadline|timeline):\s*(.+)/gi,
+            /(?:no more than|at most|maximum)\s+(.+)/gi,
+        ];
+        for (const pattern of constraintPatterns) {
+            const matches = prompt.matchAll(pattern);
+            for (const match of matches) {
+                if (match[1]) {
+                    const constraint = this.cleanRequirement(match[1]);
+                    if (constraint && !constraints.includes(constraint)) {
+                        constraints.push(constraint);
+                    }
+                }
+            }
+        }
+        // Common constraint keywords
+        if (lowerPrompt.includes('performance')) {
+            constraints.push('Performance requirements to be defined');
+        }
+        if (lowerPrompt.includes('security')) {
+            constraints.push('Security requirements to be defined');
+        }
+        if (lowerPrompt.includes('mobile') && lowerPrompt.includes('desktop')) {
+            constraints.push('Must work on both mobile and desktop');
+        }
+        return constraints.slice(0, 5); // Max 5 constraints
+    }
+    extractGoals(prompt) {
+        const goals = [];
+        const goalPatterns = [
+            /(?:goal is to|aim to|objective is to)\s+(.+)/gi,
+            /(?:trying to|looking to|hoping to)\s+(.+)/gi,
+            /(?:so that|in order to)\s+(.+)/gi,
+        ];
+        for (const pattern of goalPatterns) {
+            const matches = prompt.matchAll(pattern);
+            for (const match of matches) {
+                if (match[1]) {
+                    const goal = this.cleanRequirement(match[1]);
+                    if (goal && !goals.includes(goal)) {
+                        goals.push(goal);
+                    }
+                }
+            }
+        }
+        return goals.slice(0, 3); // Max 3 goals
+    }
+    cleanRequirement(text) {
+        return text
+            .trim()
+            .replace(/[.!?,;:]+$/, '')
+            .replace(/\s+/g, ' ')
+            .substring(0, 200);
+    }
+}
+//# sourceMappingURL=conversation-summarizer.js.map

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

@@ -0,0 +1,21 @@
+import { BasePattern } from './base-pattern.js';
+import { PromptIntent, OptimizationMode, PatternContext, PatternResult } from '../types.js';
+/**
+ * v4.3.2 PRD Pattern: DependencyIdentifier
+ *
+ * Identifies technical and external dependencies in PRD content.
+ * Helps surface hidden requirements and blockers.
+ */
+export declare class DependencyIdentifier extends BasePattern {
+    id: string;
+    name: string;
+    description: string;
+    applicableIntents: PromptIntent[];
+    mode: OptimizationMode | 'both';
+    priority: number;
+    apply(prompt: string, _context: PatternContext): PatternResult;
+    private hasDependencySection;
+    private identifyDependencies;
+    private addDependencySection;
+}
+//# sourceMappingURL=dependency-identifier.d.ts.map

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

@@ -0,0 +1,149 @@
+import { BasePattern } from './base-pattern.js';
+/**
+ * v4.3.2 PRD Pattern: DependencyIdentifier
+ *
+ * Identifies technical and external dependencies in PRD content.
+ * Helps surface hidden requirements and blockers.
+ */
+export class DependencyIdentifier extends BasePattern {
+    id = 'dependency-identifier';
+    name = 'DependencyIdentifier';
+    description = 'Identifies technical and external dependencies';
+    applicableIntents = ['prd-generation', 'planning', 'migration'];
+    mode = 'deep';
+    priority = 5;
+    apply(prompt, _context) {
+        // Check if dependencies are already documented
+        if (this.hasDependencySection(prompt)) {
+            return {
+                enhancedPrompt: prompt,
+                improvement: {
+                    dimension: 'completeness',
+                    description: 'Dependencies already documented',
+                    impact: 'low',
+                },
+                applied: false,
+            };
+        }
+        // Check if this content has identifiable dependencies
+        const dependencies = this.identifyDependencies(prompt);
+        if (dependencies.length === 0) {
+            return {
+                enhancedPrompt: prompt,
+                improvement: {
+                    dimension: 'completeness',
+                    description: 'No clear dependencies identified',
+                    impact: 'low',
+                },
+                applied: false,
+            };
+        }
+        // Add dependency section
+        const enhanced = this.addDependencySection(prompt, dependencies);
+        return {
+            enhancedPrompt: enhanced,
+            improvement: {
+                dimension: 'completeness',
+                description: `Identified ${dependencies.length} dependencies (technical/external)`,
+                impact: 'medium',
+            },
+            applied: true,
+        };
+    }
+    hasDependencySection(prompt) {
+        const dependencyKeywords = [
+            'dependencies',
+            'depends on',
+            'prerequisite',
+            'requires',
+            'blocked by',
+            'blocker',
+            'external service',
+            'third-party',
+            'integration with',
+        ];
+        return this.hasSection(prompt, dependencyKeywords);
+    }
+    identifyDependencies(prompt) {
+        const dependencies = [];
+        const lowerPrompt = prompt.toLowerCase();
+        // Technical dependencies
+        if (lowerPrompt.includes('api')) {
+            dependencies.push('API availability and documentation');
+        }
+        if (lowerPrompt.includes('database') || lowerPrompt.includes('db')) {
+            dependencies.push('Database schema and migrations');
+        }
+        if (lowerPrompt.includes('authentication') || lowerPrompt.includes('auth')) {
+            dependencies.push('Authentication system integration');
+        }
+        if (lowerPrompt.includes('payment') ||
+            lowerPrompt.includes('stripe') ||
+            lowerPrompt.includes('billing')) {
+            dependencies.push('Payment provider integration');
+        }
+        if (lowerPrompt.includes('email') || lowerPrompt.includes('notification')) {
+            dependencies.push('Email/notification service');
+        }
+        if (lowerPrompt.includes('storage') ||
+            lowerPrompt.includes('s3') ||
+            lowerPrompt.includes('file')) {
+            dependencies.push('File storage service');
+        }
+        if (lowerPrompt.includes('search') || lowerPrompt.includes('elasticsearch')) {
+            dependencies.push('Search infrastructure');
+        }
+        if (lowerPrompt.includes('analytics') || lowerPrompt.includes('tracking')) {
+            dependencies.push('Analytics platform');
+        }
+        if (lowerPrompt.includes('ci/cd') || lowerPrompt.includes('deploy')) {
+            dependencies.push('CI/CD pipeline');
+        }
+        if (lowerPrompt.includes('cache') || lowerPrompt.includes('redis')) {
+            dependencies.push('Caching infrastructure');
+        }
+        // External dependencies
+        if (lowerPrompt.includes('third-party') || lowerPrompt.includes('external')) {
+            dependencies.push('Third-party service availability');
+        }
+        if (lowerPrompt.includes('team') || lowerPrompt.includes('collaboration')) {
+            dependencies.push('Cross-team coordination');
+        }
+        if (lowerPrompt.includes('approval') || lowerPrompt.includes('sign-off')) {
+            dependencies.push('Stakeholder approvals');
+        }
+        if (lowerPrompt.includes('legal') || lowerPrompt.includes('compliance')) {
+            dependencies.push('Legal/compliance review');
+        }
+        if (lowerPrompt.includes('design') ||
+            lowerPrompt.includes('ui') ||
+            lowerPrompt.includes('ux')) {
+            dependencies.push('Design specifications');
+        }
+        return dependencies;
+    }
+    addDependencySection(prompt, dependencies) {
+        // Categorize dependencies
+        const technical = dependencies.filter((d) => d.includes('API') ||
+            d.includes('Database') ||
+            d.includes('Authentication') ||
+            d.includes('service') ||
+            d.includes('infrastructure') ||
+            d.includes('pipeline'));
+        const external = dependencies.filter((d) => !technical.includes(d));
+        let section = '\n\n### Dependencies\n';
+        if (technical.length > 0) {
+            section += '**Technical Dependencies:**\n';
+            section += technical.map((d) => `- ${d}`).join('\n');
+            section += '\n\n';
+        }
+        if (external.length > 0) {
+            section += '**External Dependencies:**\n';
+            section += external.map((d) => `- ${d}`).join('\n');
+            section += '\n';
+        }
+        section += '\n**Dependency Status:** [Track status of each dependency]';
+        return prompt + section;
+    }
+}
+//# sourceMappingURL=dependency-identifier.js.map

package/dist/core/intelligence/patterns/implicit-requirement-extractor.d.ts

@@ -0,0 +1,20 @@
+import { BasePattern } from './base-pattern.js';
+import { PromptIntent, OptimizationMode, PatternContext, PatternResult } from '../types.js';
+/**
+ * v4.3.2 Conversational Pattern: ImplicitRequirementExtractor
+ *
+ * Surfaces requirements mentioned indirectly in conversations.
+ * Identifies hidden assumptions and unstated needs.
+ */
+export declare class ImplicitRequirementExtractor extends BasePattern {
+    id: string;
+    name: string;
+    description: string;
+    applicableIntents: PromptIntent[];
+    mode: OptimizationMode | 'both';
+    priority: number;
+    apply(prompt: string, _context: PatternContext): PatternResult;
+    private extractImplicitRequirements;
+    private addImplicitRequirements;
+}
+//# sourceMappingURL=implicit-requirement-extractor.d.ts.map