agentic-qe 3.3.3 → 3.3.5

package/v3/dist/domains/requirements-validation/qcsd-ideation-plugin.js

@@ -0,0 +1,1143 @@
+/**
+ * Agentic QE v3 - QCSD Ideation Swarm Plugin
+ *
+ * Implements the QCSD (Quality Conscious Software Delivery) Ideation phase
+ * using James Bach's HTSM v6.3 framework for shift-left quality engineering.
+ *
+ * This plugin registers workflow actions that enable the qcsd-ideation-swarm
+ * workflow to orchestrate multi-agent quality assessment during PI/Sprint Planning.
+ *
+ * HTSM Quality Categories:
+ * 1. Capability - Core functionality
+ * 2. Reliability - Consistency under stress
+ * 3. Usability - User experience
+ * 4. Charisma - Aesthetics and appeal
+ * 5. Security - Protection mechanisms
+ * 6. Scalability - Growth handling
+ * 7. Compatibility - Integration factors
+ * 8. Performance - Speed and efficiency
+ * 9. Installability - Deployment ease
+ * 10. Supportability - Maintenance factors
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { ok, err } from '../../shared/types/index.js';
+// ============================================================================
+// QCSD Ideation Plugin
+// ============================================================================
+export class QCSDIdeationPlugin {
+    initialized = false;
+    memory;
+    constructor(memory) {
+        this.memory = memory;
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+    }
+    async dispose() {
+        this.initialized = false;
+    }
+    /**
+     * Register workflow actions with the orchestrator
+     */
+    registerWorkflowActions(orchestrator) {
+        if (!this.initialized) {
+            throw new Error('QCSDIdeationPlugin must be initialized before registering workflow actions');
+        }
+        // Register analyzeQualityCriteria action
+        orchestrator.registerAction('requirements-validation', 'analyzeQualityCriteria', this.analyzeQualityCriteria.bind(this));
+        // Register assessTestability action
+        orchestrator.registerAction('requirements-validation', 'assessTestability', this.assessTestability.bind(this));
+        // Register assessRisks action
+        orchestrator.registerAction('requirements-validation', 'assessRisks', this.assessRisks.bind(this));
+        // Register validateRequirements action
+        orchestrator.registerAction('requirements-validation', 'validateRequirements', this.validateRequirements.bind(this));
+        // Register modelSecurityThreats action
+        orchestrator.registerAction('security-compliance', 'modelSecurityThreats', this.modelSecurityThreats.bind(this));
+        // Register generateIdeationReport action
+        orchestrator.registerAction('requirements-validation', 'generateIdeationReport', this.generateIdeationReport.bind(this));
+        // Register storeIdeationLearnings action
+        orchestrator.registerAction('learning-optimization', 'storeIdeationLearnings', this.storeIdeationLearnings.bind(this));
+        // Register extractWebsiteContent action for live URL analysis
+        orchestrator.registerAction('requirements-validation', 'extractWebsiteContent', this.extractWebsiteContent.bind(this));
+        // Register auditAccessibility action for HAS_UI conditional
+        orchestrator.registerAction('visual-accessibility', 'auditAccessibility', this.auditAccessibility.bind(this));
+        // Register analyzeQualityExperience action for HAS_UX conditional
+        orchestrator.registerAction('coordination', 'analyzeQualityExperience', this.analyzeQualityExperience.bind(this));
+    }
+    // ============================================================================
+    // Workflow Actions
+    // ============================================================================
+    /**
+     * Extract content from a live website URL for QCSD analysis
+     * Converts website features into epic-like content for quality assessment
+     */
+    async extractWebsiteContent(input, context) {
+        try {
+            const url = input.url || context.input.url;
+            if (!url) {
+                // No URL provided - pass through existing content
+                return ok({
+                    url: '',
+                    isWebsite: false,
+                    extractedDescription: context.input.description || '',
+                    extractedFeatures: [],
+                    extractedAcceptanceCriteria: context.input.acceptanceCriteria || [],
+                    detectedFlags: {
+                        hasUI: false,
+                        hasSecurity: false,
+                        hasUX: false,
+                    },
+                });
+            }
+            // Validate URL
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(url);
+            }
+            catch {
+                return err(new Error(`Invalid URL: ${url}`));
+            }
+            // Fetch website content
+            const fetchResult = await this.fetchWebsiteContent(parsedUrl.toString());
+            if (!fetchResult.success) {
+                return err(fetchResult.error);
+            }
+            const htmlContent = fetchResult.value;
+            // Extract features and structure from HTML
+            const extraction = this.parseWebsiteContent(htmlContent, parsedUrl);
+            // Build epic-like description from extracted content
+            const description = this.buildEpicDescription(extraction, parsedUrl);
+            // Generate acceptance criteria from detected features
+            const acceptanceCriteria = this.generateAcceptanceCriteria(extraction);
+            // Detect content flags for conditional agents
+            const detectedFlags = this.detectContentFlags(htmlContent, extraction);
+            return ok({
+                url: parsedUrl.toString(),
+                isWebsite: true,
+                extractedDescription: description,
+                extractedFeatures: extraction.features,
+                extractedAcceptanceCriteria: acceptanceCriteria,
+                detectedFlags,
+                metadata: {
+                    title: extraction.title,
+                    pageCount: 1,
+                    extractedAt: new Date().toISOString(),
+                },
+            });
+        }
+        catch (error) {
+            return err(new Error(`Website extraction failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    /**
+     * Fetch website content via HTTP
+     */
+    async fetchWebsiteContent(url) {
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'AQE-QCSD-Ideation-Swarm/1.0 (Quality Assessment Bot)',
+                    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                    'Accept-Language': 'en-US,en;q=0.5',
+                },
+                signal: AbortSignal.timeout(30000), // 30 second timeout
+            });
+            if (!response.ok) {
+                return err(new Error(`HTTP ${response.status}: ${response.statusText}`));
+            }
+            const html = await response.text();
+            return ok(html);
+        }
+        catch (error) {
+            return err(new Error(`Fetch failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    /**
+     * Parse HTML content to extract website features
+     */
+    parseWebsiteContent(html, url) {
+        const features = [];
+        const uiComponents = [];
+        const securityFeatures = [];
+        // Extract title
+        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+        const title = titleMatch ? titleMatch[1].trim() : url.hostname;
+        // Detect common e-commerce/web app features
+        const featurePatterns = [
+            { pattern: /type\s*=\s*["']search["']/i, feature: 'Search functionality', ui: 'Search input' },
+            { pattern: /shopping[-_]?cart|cart[-_]?icon|add[-_]?to[-_]?cart/i, feature: 'Shopping cart', ui: 'Cart component' },
+            { pattern: /login|sign[-_]?in|log[-_]?in/i, feature: 'User authentication', ui: 'Login form' },
+            { pattern: /register|sign[-_]?up|create[-_]?account/i, feature: 'User registration', ui: 'Registration form' },
+            { pattern: /checkout|payment|pay[-_]?now/i, feature: 'Checkout process', ui: 'Checkout flow' },
+            { pattern: /product[-_]?list|product[-_]?grid|catalog/i, feature: 'Product catalog', ui: 'Product grid' },
+            { pattern: /filter|sort[-_]?by|refine/i, feature: 'Filtering and sorting', ui: 'Filter controls' },
+            { pattern: /wishlist|favorites|save[-_]?for[-_]?later/i, feature: 'Wishlist functionality', ui: 'Wishlist button' },
+            { pattern: /review|rating|stars/i, feature: 'Reviews and ratings', ui: 'Rating component' },
+            { pattern: /newsletter|subscribe|email[-_]?signup/i, feature: 'Newsletter subscription', ui: 'Subscription form' },
+            { pattern: /navigation|nav[-_]?menu|main[-_]?menu/i, feature: 'Site navigation', ui: 'Navigation menu' },
+            { pattern: /footer|site[-_]?map/i, feature: 'Footer navigation', ui: 'Footer component' },
+            { pattern: /modal|popup|dialog/i, feature: 'Modal dialogs', ui: 'Modal component' },
+            { pattern: /carousel|slider|slideshow/i, feature: 'Image carousel', ui: 'Carousel component' },
+            { pattern: /accordion|collapsible|expandable/i, feature: 'Accordion sections', ui: 'Accordion component' },
+            { pattern: /tab|tabbed[-_]?content/i, feature: 'Tabbed content', ui: 'Tab component' },
+            { pattern: /form|input|textarea|select/i, feature: 'Form interactions', ui: 'Form elements' },
+            { pattern: /video|player|embed/i, feature: 'Video content', ui: 'Video player' },
+            { pattern: /chat|support|help[-_]?desk/i, feature: 'Customer support', ui: 'Chat widget' },
+            { pattern: /cookie|consent|gdpr|privacy/i, feature: 'Privacy compliance', ui: 'Consent banner' },
+        ];
+        for (const { pattern, feature, ui } of featurePatterns) {
+            if (pattern.test(html)) {
+                features.push(feature);
+                if (ui)
+                    uiComponents.push(ui);
+            }
+        }
+        // Detect security-related features
+        const securityPatterns = [
+            { pattern: /password|passwd/i, feature: 'Password handling' },
+            { pattern: /https|ssl|secure/i, feature: 'Secure connection' },
+            { pattern: /oauth|sso|single[-_]?sign[-_]?on/i, feature: 'OAuth/SSO authentication' },
+            { pattern: /2fa|two[-_]?factor|mfa/i, feature: 'Multi-factor authentication' },
+            { pattern: /captcha|recaptcha/i, feature: 'Bot protection' },
+            { pattern: /csrf|token/i, feature: 'CSRF protection' },
+            { pattern: /encrypt|crypto/i, feature: 'Data encryption' },
+        ];
+        for (const { pattern, feature } of securityPatterns) {
+            if (pattern.test(html)) {
+                securityFeatures.push(feature);
+            }
+        }
+        // Count interactive elements
+        const formCount = (html.match(/<form/gi) || []).length;
+        const buttonCount = (html.match(/<button/gi) || []).length;
+        const inputCount = (html.match(/<input/gi) || []).length;
+        const linkCount = (html.match(/<a\s+[^>]*href/gi) || []).length;
+        const imageCount = (html.match(/<img/gi) || []).length;
+        return {
+            title,
+            features: [...new Set(features)], // Dedupe
+            uiComponents: [...new Set(uiComponents)],
+            securityFeatures: [...new Set(securityFeatures)],
+            metrics: {
+                formCount,
+                buttonCount,
+                inputCount,
+                linkCount,
+                imageCount,
+            },
+        };
+    }
+    /**
+     * Build epic-like description from extracted content
+     */
+    buildEpicDescription(extraction, url) {
+        const lines = [
+            `## Website Analysis: ${extraction.title}`,
+            `**URL**: ${url.toString()}`,
+            `**Domain**: ${url.hostname}`,
+            '',
+            '### Detected Features',
+        ];
+        if (extraction.features.length > 0) {
+            for (const feature of extraction.features) {
+                lines.push(`- ${feature}`);
+            }
+        }
+        else {
+            lines.push('- Basic web content');
+        }
+        lines.push('', '### UI Components');
+        if (extraction.uiComponents.length > 0) {
+            for (const component of extraction.uiComponents) {
+                lines.push(`- ${component}`);
+            }
+        }
+        else {
+            lines.push('- Standard HTML elements');
+        }
+        if (extraction.securityFeatures.length > 0) {
+            lines.push('', '### Security Features');
+            for (const feature of extraction.securityFeatures) {
+                lines.push(`- ${feature}`);
+            }
+        }
+        lines.push('', '### Page Metrics');
+        lines.push(`- Forms: ${extraction.metrics.formCount}`);
+        lines.push(`- Buttons: ${extraction.metrics.buttonCount}`);
+        lines.push(`- Input fields: ${extraction.metrics.inputCount}`);
+        lines.push(`- Links: ${extraction.metrics.linkCount}`);
+        lines.push(`- Images: ${extraction.metrics.imageCount}`);
+        return lines.join('\n');
+    }
+    /**
+     * Generate acceptance criteria from detected features
+     */
+    generateAcceptanceCriteria(extraction) {
+        const criteria = [];
+        // Map features to acceptance criteria
+        const featureToCriteria = {
+            'Search functionality': 'User can search for content and receive relevant results',
+            'Shopping cart': 'User can add items to cart and view cart contents',
+            'User authentication': 'User can log in with valid credentials',
+            'User registration': 'New user can create an account',
+            'Checkout process': 'User can complete purchase with valid payment',
+            'Product catalog': 'User can browse and view product listings',
+            'Filtering and sorting': 'User can filter and sort content by various criteria',
+            'Wishlist functionality': 'User can save items for later',
+            'Reviews and ratings': 'User can view and submit reviews',
+            'Newsletter subscription': 'User can subscribe to email updates',
+            'Site navigation': 'User can navigate between all main sections',
+            'Modal dialogs': 'Modal dialogs are accessible and dismissible',
+            'Form interactions': 'All forms validate input and show clear error messages',
+            'Video content': 'Video content is playable and accessible',
+            'Customer support': 'User can access help and support resources',
+            'Privacy compliance': 'Cookie consent is properly implemented',
+        };
+        for (const feature of extraction.features) {
+            if (featureToCriteria[feature]) {
+                criteria.push(featureToCriteria[feature]);
+            }
+        }
+        // Add default criteria if none detected
+        if (criteria.length === 0) {
+            criteria.push('Page loads within acceptable time', 'Content is readable and well-structured', 'Navigation is intuitive');
+        }
+        return criteria;
+    }
+    /**
+     * Detect content flags for conditional agent spawning
+     */
+    detectContentFlags(html, extraction) {
+        // HAS_UI: Any UI components or visual elements
+        const hasUI = extraction.uiComponents.length > 0 ||
+            extraction.metrics.formCount > 0 ||
+            extraction.metrics.buttonCount > 0 ||
+            /<(button|input|select|form|img|video|canvas)/i.test(html);
+        // HAS_SECURITY: Security-related features detected
+        const hasSecurity = extraction.securityFeatures.length > 0 ||
+            /login|password|auth|token|session|credential/i.test(html);
+        // HAS_UX: Interactive elements suggesting user experience concerns
+        const hasUX = extraction.features.length >= 3 ||
+            extraction.metrics.formCount >= 2 ||
+            /user[-_]?experience|ux|journey|onboarding|tutorial/i.test(html);
+        return { hasUI, hasSecurity, hasUX };
+    }
+    /**
+     * Analyze quality criteria using HTSM v6.3 framework
+     */
+    async analyzeQualityCriteria(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const targetType = input.targetType || context.input.targetType;
+            const description = input.description || context.input.description || '';
+            const acceptanceCriteria = input.acceptanceCriteria || context.input.acceptanceCriteria || [];
+            // Analyze each HTSM category
+            const criteria = this.analyzeHTSMCategories(targetId, targetType, description, acceptanceCriteria);
+            // Calculate overall quality score
+            const qualityScore = this.calculateQualityScore(criteria);
+            // Store intermediate result
+            await this.memory.set(`qcsd-ideation:quality-criteria:${targetId}`, { criteria, qualityScore, timestamp: new Date().toISOString() }, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok({ qualityCriteria: criteria, qualityScore });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Assess testability using 10 principles
+     */
+    async assessTestability(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const description = input.description || context.input.description || '';
+            const acceptanceCriteria = input.acceptanceCriteria || context.input.acceptanceCriteria || [];
+            // Assess each testability principle
+            const principles = this.assessTestabilityPrinciples(description, acceptanceCriteria);
+            // Calculate overall score
+            const overallScore = Math.round(Object.values(principles).reduce((sum, score) => sum + score, 0) / 10);
+            // Identify blockers and recommendations
+            const { blockers, recommendations } = this.identifyTestabilityIssues(principles);
+            const assessment = {
+                id: uuidv4(),
+                targetId,
+                overallScore,
+                principles,
+                blockers,
+                recommendations,
+            };
+            // Store intermediate result
+            await this.memory.set(`qcsd-ideation:testability:${targetId}`, assessment, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok(assessment);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Assess risks
+     */
+    async assessRisks(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const targetType = input.targetType || context.input.targetType;
+            const description = input.description || context.input.description || '';
+            // Analyze risk factors
+            const factors = this.analyzeRiskFactors(targetType, description);
+            // Calculate overall risk score
+            const riskScore = Math.round(factors.reduce((sum, f) => sum + f.score, 0) / factors.length * 4);
+            // Determine risk level
+            const overallRisk = this.determineRiskLevel(riskScore);
+            // Generate mitigations
+            const mitigations = this.generateMitigations(factors);
+            const assessment = {
+                id: uuidv4(),
+                targetId,
+                overallRisk,
+                riskScore,
+                factors,
+                mitigations,
+            };
+            // Store intermediate result
+            await this.memory.set(`qcsd-ideation:risk:${targetId}`, assessment, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok(assessment);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Validate requirements for completeness
+     */
+    async validateRequirements(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const description = input.description || context.input.description || '';
+            const acceptanceCriteria = input.acceptanceCriteria || context.input.acceptanceCriteria || [];
+            const issues = [];
+            const suggestions = [];
+            // Check description quality
+            if (description.length < 50) {
+                issues.push('Description is too short (< 50 characters)');
+                suggestions.push('Add more context about the business value and user need');
+            }
+            // Check for ambiguous language
+            const ambiguousTerms = ['should', 'could', 'might', 'maybe', 'possibly', 'etc', 'and so on'];
+            for (const term of ambiguousTerms) {
+                if (description.toLowerCase().includes(term)) {
+                    issues.push(`Ambiguous term detected: "${term}"`);
+                    suggestions.push(`Replace "${term}" with specific, measurable criteria`);
+                }
+            }
+            // Check acceptance criteria
+            if (acceptanceCriteria.length === 0) {
+                issues.push('No acceptance criteria defined');
+                suggestions.push('Add Given/When/Then acceptance criteria');
+            }
+            else if (acceptanceCriteria.length < 3) {
+                issues.push('Too few acceptance criteria (< 3)');
+                suggestions.push('Consider adding criteria for happy path, error cases, and edge cases');
+            }
+            // Check for testable criteria
+            const hasTestable = acceptanceCriteria.some(ac => ac.toLowerCase().includes('given') ||
+                ac.toLowerCase().includes('when') ||
+                ac.toLowerCase().includes('then'));
+            if (!hasTestable && acceptanceCriteria.length > 0) {
+                suggestions.push('Consider using Given/When/Then format for clearer test scenarios');
+            }
+            const valid = issues.length === 0;
+            return ok({ valid, issues, suggestions });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Model security threats using STRIDE
+     */
+    async modelSecurityThreats(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const description = input.description || context.input.description || '';
+            const securityCritical = input.securityCritical || context.input.securityCritical || false;
+            // Analyze STRIDE threats
+            const threats = this.analyzeSTRIDEThreats(description, securityCritical);
+            // Calculate overall risk
+            const maxScore = Math.max(...threats.map(t => t.likelihood * t.impact), 0);
+            const overallRisk = this.determineRiskLevel(maxScore * 4);
+            // Generate recommendations
+            const recommendations = this.generateSecurityRecommendations(threats);
+            const model = {
+                id: uuidv4(),
+                targetId,
+                threats,
+                overallRisk,
+                recommendations,
+            };
+            // Store intermediate result
+            await this.memory.set(`qcsd-ideation:threat-model:${targetId}`, model, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok(model);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Generate aggregated ideation report
+     */
+    async generateIdeationReport(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const targetType = (input.targetType || context.input.targetType || 'requirement');
+            // Retrieve all intermediate results
+            const qualityData = await this.memory.get(`qcsd-ideation:quality-criteria:${targetId}`);
+            const testability = await this.memory.get(`qcsd-ideation:testability:${targetId}`);
+            const risk = await this.memory.get(`qcsd-ideation:risk:${targetId}`);
+            const threatModel = await this.memory.get(`qcsd-ideation:threat-model:${targetId}`);
+            // Use context results if memory doesn't have them
+            // Cast results to Record<string, unknown> to access dynamic step outputs
+            const results = context.results;
+            const qualityCriteria = qualityData?.criteria || results['quality-criteria-analysis']?.qualityCriteria || [];
+            const qualityScore = qualityData?.qualityScore || results['quality-criteria-analysis']?.qualityScore || 0;
+            const testabilityResult = testability || results['testability-assessment'];
+            const riskResult = risk || results['risk-assessment'];
+            const threatModelResult = threatModel || results['security-threat-modeling'];
+            // Generate SWOT insights
+            const insights = this.generateSWOTInsights(qualityCriteria, testabilityResult, riskResult);
+            // Generate prioritized recommendations
+            const recommendations = this.generateRecommendations(qualityCriteria, testabilityResult, riskResult, threatModelResult);
+            // Generate test strategy
+            const testStrategy = this.generateTestStrategy(qualityCriteria, testabilityResult, riskResult);
+            // Determine development readiness
+            const blockers = this.identifyBlockers(testabilityResult, riskResult, threatModelResult);
+            const readyForDevelopment = blockers.length === 0;
+            const report = {
+                id: uuidv4(),
+                timestamp: new Date().toISOString(),
+                targetId,
+                targetType,
+                qualityCriteria,
+                qualityScore,
+                testability: testabilityResult,
+                risk: riskResult,
+                threatModel: threatModelResult,
+                insights,
+                recommendations,
+                testStrategy,
+                readyForDevelopment,
+                blockers,
+            };
+            // Store final report
+            await this.memory.set(`qcsd-ideation:report:${targetId}`, report, { namespace: 'qcsd-ideation', persist: true });
+            return ok(report);
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Store learnings for future pattern matching
+     */
+    async storeIdeationLearnings(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const report = input.report || context.results['aggregate-ideation-report'];
+            if (!report) {
+                return err(new Error('No ideation report found to store'));
+            }
+            const patternId = `ideation-pattern-${Date.now()}`;
+            // Create learning pattern
+            const pattern = {
+                id: patternId,
+                timestamp: new Date().toISOString(),
+                targetType: report.targetType,
+                qualityScore: report.qualityScore,
+                testabilityScore: report.testability.overallScore,
+                riskLevel: report.risk.overallRisk,
+                blockerCount: report.blockers.length,
+                readyForDevelopment: report.readyForDevelopment,
+                // Key characteristics for pattern matching
+                features: {
+                    hasSecurityThreats: !!report.threatModel && report.threatModel.threats.length > 0,
+                    avgPrincipleScore: report.testability.overallScore,
+                    riskFactorCount: report.risk.factors.length,
+                    qualityCriteriaCount: report.qualityCriteria.length,
+                },
+            };
+            // Store pattern for learning
+            await this.memory.set(`qcsd-patterns:${patternId}`, pattern, { namespace: 'learning', persist: true });
+            // Store in pattern index for search
+            const patternIndex = await this.memory.get('qcsd-patterns:index') || [];
+            patternIndex.push(patternId);
+            await this.memory.set('qcsd-patterns:index', patternIndex, { namespace: 'learning', persist: true });
+            return ok({ stored: true, patternId });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    analyzeHTSMCategories(targetId, targetType, description, acceptanceCriteria) {
+        const categories = [
+            'capability',
+            'reliability',
+            'usability',
+            'charisma',
+            'security',
+            'scalability',
+            'compatibility',
+            'performance',
+            'installability',
+            'supportability',
+        ];
+        const descLower = description.toLowerCase();
+        const acJoined = acceptanceCriteria.join(' ').toLowerCase();
+        return categories.map(category => {
+            const { weight, testabilityScore, risks, testIdeas } = this.analyzeCategory(category, descLower, acJoined);
+            return {
+                id: `${targetId}-${category}`,
+                category,
+                name: category.charAt(0).toUpperCase() + category.slice(1),
+                description: this.getCategoryDescription(category),
+                weight,
+                testabilityScore,
+                risks,
+                testIdeas,
+            };
+        });
+    }
+    analyzeCategory(category, description, acceptanceCriteria) {
+        const keywords = {
+            capability: ['function', 'feature', 'ability', 'can', 'must', 'shall'],
+            reliability: ['reliable', 'consistent', 'stable', 'fault', 'error', 'recover'],
+            usability: ['user', 'easy', 'intuitive', 'accessible', 'ux', 'interface'],
+            charisma: ['design', 'look', 'feel', 'brand', 'aesthetic', 'appeal'],
+            security: ['secure', 'auth', 'encrypt', 'protect', 'permission', 'role'],
+            scalability: ['scale', 'load', 'concurrent', 'throughput', 'capacity'],
+            compatibility: ['integrate', 'api', 'browser', 'device', 'version', 'legacy'],
+            performance: ['fast', 'response', 'latency', 'speed', 'efficient', 'optimize'],
+            installability: ['install', 'deploy', 'setup', 'configure', 'provision'],
+            supportability: ['log', 'monitor', 'debug', 'maintain', 'document', 'support'],
+        };
+        const categoryKeywords = keywords[category];
+        const mentionCount = categoryKeywords.filter(kw => description.includes(kw) || acceptanceCriteria.includes(kw)).length;
+        // Weight based on relevance
+        const weight = Math.min(10, 3 + mentionCount * 2);
+        // Testability based on specificity
+        const hasSpecificCriteria = categoryKeywords.some(kw => acceptanceCriteria.includes(kw));
+        const testabilityScore = hasSpecificCriteria ? 70 + Math.random() * 20 : 40 + Math.random() * 30;
+        // Generate risks
+        const risks = this.generateCategoryRisks(category, mentionCount === 0);
+        // Generate test ideas
+        const testIdeas = this.generateCategoryTestIdeas(category);
+        return { weight, testabilityScore: Math.round(testabilityScore), risks, testIdeas };
+    }
+    getCategoryDescription(category) {
+        const descriptions = {
+            capability: 'Core functionality and features the system must provide',
+            reliability: 'Consistency and stability under various conditions',
+            usability: 'Ease of use and user experience quality',
+            charisma: 'Visual appeal and brand alignment',
+            security: 'Protection against threats and unauthorized access',
+            scalability: 'Ability to handle growth and increased load',
+            compatibility: 'Integration with other systems and environments',
+            performance: 'Speed, responsiveness, and resource efficiency',
+            installability: 'Ease of deployment and configuration',
+            supportability: 'Maintainability and operational support',
+        };
+        return descriptions[category];
+    }
+    generateCategoryRisks(category, notMentioned) {
+        const risks = [];
+        if (notMentioned) {
+            risks.push(`${category.charAt(0).toUpperCase() + category.slice(1)} requirements not explicitly defined`);
+        }
+        const categoryRisks = {
+            capability: ['Feature gaps may emerge late', 'Edge cases not covered'],
+            reliability: ['System may fail under load', 'Error handling unclear'],
+            usability: ['User confusion possible', 'Accessibility gaps'],
+            charisma: ['Brand inconsistency risk', 'Visual regression possible'],
+            security: ['Vulnerability exposure', 'Data breach risk'],
+            scalability: ['Performance degradation at scale', 'Resource exhaustion'],
+            compatibility: ['Integration failures', 'Version conflicts'],
+            performance: ['Slow response times', 'Resource bottlenecks'],
+            installability: ['Deployment complexity', 'Configuration errors'],
+            supportability: ['Debugging difficulty', 'Maintenance burden'],
+        };
+        risks.push(...categoryRisks[category].slice(0, notMentioned ? 2 : 1));
+        return risks;
+    }
+    generateCategoryTestIdeas(category) {
+        const testIdeas = {
+            capability: ['Happy path scenarios', 'Boundary value analysis', 'State transition tests'],
+            reliability: ['Stress testing', 'Recovery testing', 'Long-running tests'],
+            usability: ['User journey tests', 'Accessibility audits', 'Heuristic evaluation'],
+            charisma: ['Visual regression tests', 'Brand guideline validation', 'A/B testing'],
+            security: ['Penetration testing', 'Auth flow tests', 'Input validation'],
+            scalability: ['Load testing', 'Capacity testing', 'Horizontal scaling tests'],
+            compatibility: ['Cross-browser tests', 'API contract tests', 'Migration tests'],
+            performance: ['Response time tests', 'Throughput tests', 'Resource monitoring'],
+            installability: ['Deployment verification', 'Configuration tests', 'Rollback tests'],
+            supportability: ['Log validation', 'Monitoring checks', 'Runbook validation'],
+        };
+        return testIdeas[category];
+    }
+    calculateQualityScore(criteria) {
+        if (criteria.length === 0)
+            return 0;
+        const totalWeight = criteria.reduce((sum, c) => sum + c.weight, 0);
+        const weightedScore = criteria.reduce((sum, c) => sum + (c.testabilityScore * c.weight) / totalWeight, 0);
+        return Math.round(weightedScore);
+    }
+    assessTestabilityPrinciples(description, acceptanceCriteria) {
+        const acCount = acceptanceCriteria.length;
+        const descLength = description.length;
+        const hasGivenWhenThen = acceptanceCriteria.some(ac => ac.toLowerCase().includes('given') || ac.toLowerCase().includes('when'));
+        return {
+            controllability: Math.min(100, 40 + acCount * 10),
+            observability: hasGivenWhenThen ? 80 : 50,
+            isolability: Math.min(100, 50 + Math.random() * 30),
+            separationOfConcerns: Math.min(100, 40 + Math.random() * 40),
+            simplicity: Math.max(30, 100 - descLength / 20),
+            stability: Math.min(100, 60 + Math.random() * 20),
+            informationCapture: hasGivenWhenThen ? 85 : 45,
+            automationSupport: hasGivenWhenThen ? 90 : 40,
+            selfDocumenting: Math.min(100, 30 + descLength / 10),
+            independence: Math.min(100, 50 + Math.random() * 30),
+        };
+    }
+    identifyTestabilityIssues(principles) {
+        const blockers = [];
+        const recommendations = [];
+        if (principles.controllability < 50) {
+            blockers.push('Low controllability - test setup may be difficult');
+        }
+        if (principles.observability < 50) {
+            blockers.push('Low observability - verifying outcomes may be challenging');
+        }
+        if (principles.automationSupport < 50) {
+            recommendations.push('Add explicit acceptance criteria in Given/When/Then format');
+        }
+        if (principles.isolability < 60) {
+            recommendations.push('Consider breaking into smaller, isolated components');
+        }
+        if (principles.simplicity < 40) {
+            recommendations.push('Simplify requirements - current description is complex');
+        }
+        return { blockers, recommendations };
+    }
+    analyzeRiskFactors(targetType, description) {
+        const factors = [];
+        const descLower = description.toLowerCase();
+        // Complexity risk
+        if (description.length > 500) {
+            factors.push({
+                category: 'Complexity',
+                description: 'High description complexity increases misunderstanding risk',
+                likelihood: 4,
+                impact: 3,
+                score: 12,
+            });
+        }
+        // Integration risk
+        if (descLower.includes('api') || descLower.includes('integrate')) {
+            factors.push({
+                category: 'Integration',
+                description: 'External dependencies may cause integration issues',
+                likelihood: 3,
+                impact: 4,
+                score: 12,
+            });
+        }
+        // Security risk
+        if (descLower.includes('user') || descLower.includes('data') || descLower.includes('auth')) {
+            factors.push({
+                category: 'Security',
+                description: 'User data handling requires security considerations',
+                likelihood: 3,
+                impact: 5,
+                score: 15,
+            });
+        }
+        // Performance risk
+        if (descLower.includes('real-time') || descLower.includes('fast') || descLower.includes('scale')) {
+            factors.push({
+                category: 'Performance',
+                description: 'Performance requirements may be challenging to meet',
+                likelihood: 3,
+                impact: 3,
+                score: 9,
+            });
+        }
+        // Default risk if none identified
+        if (factors.length === 0) {
+            factors.push({
+                category: 'General',
+                description: 'Standard development risks apply',
+                likelihood: 2,
+                impact: 2,
+                score: 4,
+            });
+        }
+        return factors;
+    }
+    determineRiskLevel(score) {
+        if (score >= 80)
+            return 'critical';
+        if (score >= 60)
+            return 'high';
+        if (score >= 40)
+            return 'medium';
+        return 'low';
+    }
+    generateMitigations(factors) {
+        const mitigations = [];
+        for (const factor of factors) {
+            switch (factor.category) {
+                case 'Complexity':
+                    mitigations.push('Break down into smaller, more manageable stories');
+                    break;
+                case 'Integration':
+                    mitigations.push('Define API contracts early with contract testing');
+                    break;
+                case 'Security':
+                    mitigations.push('Conduct threat modeling and security review');
+                    break;
+                case 'Performance':
+                    mitigations.push('Establish performance baselines and monitoring');
+                    break;
+                default:
+                    mitigations.push('Apply standard QE practices');
+            }
+        }
+        return mitigations;
+    }
+    analyzeSTRIDEThreats(description, securityCritical) {
+        const threats = [];
+        const descLower = description.toLowerCase();
+        // Spoofing
+        if (descLower.includes('auth') || descLower.includes('login') || descLower.includes('user')) {
+            threats.push({
+                category: 'spoofing',
+                name: 'Identity Spoofing',
+                description: 'Attacker may impersonate legitimate users',
+                likelihood: securityCritical ? 4 : 2,
+                impact: 4,
+                mitigations: ['Implement MFA', 'Use strong session management'],
+            });
+        }
+        // Tampering
+        if (descLower.includes('data') || descLower.includes('update') || descLower.includes('edit')) {
+            threats.push({
+                category: 'tampering',
+                name: 'Data Tampering',
+                description: 'Data may be modified maliciously',
+                likelihood: securityCritical ? 3 : 2,
+                impact: 4,
+                mitigations: ['Implement input validation', 'Use integrity checks'],
+            });
+        }
+        // Information Disclosure
+        if (descLower.includes('personal') || descLower.includes('sensitive') || descLower.includes('private')) {
+            threats.push({
+                category: 'informationDisclosure',
+                name: 'Information Disclosure',
+                description: 'Sensitive information may be exposed',
+                likelihood: securityCritical ? 4 : 3,
+                impact: 5,
+                mitigations: ['Encrypt data at rest and in transit', 'Implement access controls'],
+            });
+        }
+        // Default low-risk threat
+        if (threats.length === 0 && !securityCritical) {
+            threats.push({
+                category: 'denial',
+                name: 'Service Denial',
+                description: 'Service availability may be impacted',
+                likelihood: 2,
+                impact: 3,
+                mitigations: ['Implement rate limiting', 'Add monitoring and alerts'],
+            });
+        }
+        return threats;
+    }
+    generateSecurityRecommendations(threats) {
+        const recommendations = new Set();
+        for (const threat of threats) {
+            for (const mitigation of threat.mitigations) {
+                recommendations.add(mitigation);
+            }
+        }
+        return Array.from(recommendations);
+    }
+    generateSWOTInsights(qualityCriteria, testability, risk) {
+        const strengths = [];
+        const weaknesses = [];
+        const opportunities = [];
+        const threats = [];
+        // Analyze strengths
+        const highTestability = qualityCriteria.filter(c => c.testabilityScore >= 70);
+        if (highTestability.length > 5) {
+            strengths.push(`${highTestability.length}/10 quality categories have high testability`);
+        }
+        if (testability.overallScore >= 70) {
+            strengths.push('Overall testability score is good');
+        }
+        if (risk.overallRisk === 'low') {
+            strengths.push('Risk profile is manageable');
+        }
+        // Analyze weaknesses
+        const lowTestability = qualityCriteria.filter(c => c.testabilityScore < 50);
+        if (lowTestability.length > 0) {
+            weaknesses.push(`${lowTestability.length} quality categories need more definition`);
+        }
+        if (testability.blockers.length > 0) {
+            weaknesses.push(...testability.blockers.slice(0, 2));
+        }
+        // Analyze opportunities
+        if (testability.principles.automationSupport >= 70) {
+            opportunities.push('High automation potential for test coverage');
+        }
+        opportunities.push('Early quality assessment enables shift-left testing');
+        // Analyze threats
+        if (risk.factors.some(f => f.score >= 15)) {
+            threats.push('High-severity risks require immediate attention');
+        }
+        threats.push(...risk.factors.filter(f => f.score >= 10).map(f => f.description).slice(0, 2));
+        return { strengths, weaknesses, opportunities, threats };
+    }
+    generateRecommendations(qualityCriteria, testability, risk, threatModel) {
+        const recommendations = [];
+        // Testability recommendations
+        if (testability.overallScore < 60) {
+            recommendations.push({
+                priority: 'high',
+                category: 'Testability',
+                description: 'Improve acceptance criteria with specific, measurable outcomes',
+                effort: 'low',
+            });
+        }
+        // Risk recommendations
+        for (const factor of risk.factors.filter(f => f.score >= 12)) {
+            recommendations.push({
+                priority: factor.score >= 15 ? 'critical' : 'high',
+                category: 'Risk Mitigation',
+                description: risk.mitigations[0] || `Address ${factor.category} risk`,
+                effort: 'medium',
+            });
+        }
+        // Security recommendations
+        if (threatModel && threatModel.threats.length > 0) {
+            recommendations.push({
+                priority: threatModel.overallRisk === 'critical' ? 'critical' : 'high',
+                category: 'Security',
+                description: threatModel.recommendations[0] || 'Implement security controls',
+                effort: 'high',
+            });
+        }
+        // Quality recommendations
+        const lowCategories = qualityCriteria.filter(c => c.testabilityScore < 50);
+        if (lowCategories.length > 0) {
+            recommendations.push({
+                priority: 'medium',
+                category: 'Quality Definition',
+                description: `Define clearer criteria for: ${lowCategories.map(c => c.category).join(', ')}`,
+                effort: 'low',
+            });
+        }
+        return recommendations.sort((a, b) => {
+            const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
+            return priorityOrder[a.priority] - priorityOrder[b.priority];
+        });
+    }
+    generateTestStrategy(qualityCriteria, testability, risk) {
+        // Determine approach based on risk and testability
+        let approach = 'Standard test pyramid with unit, integration, and E2E tests';
+        if (risk.overallRisk === 'high' || risk.overallRisk === 'critical') {
+            approach = 'Risk-based testing with enhanced coverage for high-risk areas';
+        }
+        if (testability.overallScore >= 80) {
+            approach += ' with high automation potential';
+        }
+        // Coverage areas from quality criteria
+        const coverage = qualityCriteria
+            .filter(c => c.weight >= 5)
+            .flatMap(c => c.testIdeas.slice(0, 2));
+        // Risk areas
+        const riskAreas = risk.factors
+            .filter(f => f.score >= 9)
+            .map(f => `${f.category}: ${f.description}`);
+        // Estimate effort based on complexity
+        const totalWeight = qualityCriteria.reduce((sum, c) => sum + c.weight, 0);
+        let estimatedEffort = 'Medium (3-5 days)';
+        if (totalWeight > 60) {
+            estimatedEffort = 'High (1-2 weeks)';
+        }
+        else if (totalWeight < 40) {
+            estimatedEffort = 'Low (1-2 days)';
+        }
+        return {
+            approach,
+            coverage: [...new Set(coverage)].slice(0, 8),
+            riskAreas: riskAreas.slice(0, 4),
+            estimatedEffort,
+        };
+    }
+    // ============================================================================
+    // Conditional Agent Actions (HAS_UI, HAS_UX)
+    // ============================================================================
+    /**
+     * Audit accessibility for websites with UI components (HAS_UI flag)
+     * Triggered when website extraction detects UI elements
+     */
+    async auditAccessibility(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const url = input.url || context.input.url;
+            const description = input.description || context.input.description || '';
+            const features = input.features || context.input.features || [];
+            // Analyze accessibility concerns based on detected features
+            const violations = [];
+            const recommendations = [];
+            // Check for common accessibility issues based on features
+            const featureAnalysis = {
+                'Image carousel': {
+                    issue: 'Carousels may lack pause controls and keyboard navigation',
+                    rec: 'Ensure carousel has pause button, keyboard controls, and ARIA labels',
+                },
+                'Form interactions': {
+                    issue: 'Forms may lack proper labels and error announcements',
+                    rec: 'Add aria-describedby for errors, ensure all inputs have associated labels',
+                },
+                'Modal dialogs': {
+                    issue: 'Modals may trap focus or lack escape key handling',
+                    rec: 'Implement focus trap, escape key closure, and return focus on close',
+                },
+                'Video content': {
+                    issue: 'Videos may lack captions and audio descriptions',
+                    rec: 'Add WebVTT captions and audio description track for video content',
+                },
+                'Site navigation': {
+                    issue: 'Navigation may lack skip links and landmark roles',
+                    rec: 'Add skip-to-main link, use proper landmark roles (nav, main, aside)',
+                },
+                'Newsletter subscription': {
+                    issue: 'Signup forms may lack clear success/error feedback',
+                    rec: 'Use aria-live regions for form submission feedback',
+                },
+            };
+            for (const feature of features) {
+                const analysis = featureAnalysis[feature];
+                if (analysis) {
+                    violations.push(analysis.issue);
+                    recommendations.push(analysis.rec);
+                }
+            }
+            // Add general WCAG recommendations
+            recommendations.push('Verify color contrast meets WCAG 2.2 AA (4.5:1 for text)', 'Test with screen reader (NVDA/VoiceOver)', 'Verify keyboard navigation for all interactive elements', 'Check focus indicators are visible');
+            // Determine WCAG level based on violations
+            const wcagLevel = violations.length > 5 ? 'Likely fails AA' :
+                violations.length > 2 ? 'Partial AA compliance' : 'Potential AA compliance';
+            // Store result
+            await this.memory.set(`qcsd-ideation:accessibility:${targetId}`, { wcagLevel, violations, recommendations, url, timestamp: new Date().toISOString() }, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok({ wcagLevel, violations, recommendations });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Analyze quality experience for websites with UX concerns (HAS_UX flag)
+     * Triggered when website extraction detects user experience patterns
+     */
+    async analyzeQualityExperience(input, context) {
+        try {
+            const targetId = input.targetId || context.input.targetId;
+            const url = input.url || context.input.url;
+            const description = input.description || context.input.description || '';
+            const features = input.features || context.input.features || [];
+            const journeys = [];
+            const frictionPoints = [];
+            const recommendations = [];
+            // Identify user journeys based on detected features
+            const journeyMapping = {
+                'Newsletter subscription': {
+                    journey: 'Content subscription flow: Landing -> Email signup -> Confirmation',
+                    friction: 'Multi-step signup may cause abandonment',
+                    rec: 'Implement single-field inline signup with immediate feedback',
+                },
+                'Search functionality': {
+                    journey: 'Content discovery flow: Search -> Filter -> Select -> Read',
+                    friction: 'Poor search results relevance frustrates users',
+                    rec: 'Add search suggestions, filters, and "no results" helpful messaging',
+                },
+                'User authentication': {
+                    journey: 'Account access flow: Login page -> Auth -> Dashboard',
+                    friction: 'Password requirements and recovery flow complexity',
+                    rec: 'Add social login options, clear password requirements, easy recovery',
+                },
+                'Shopping cart': {
+                    journey: 'Purchase flow: Browse -> Add to cart -> Checkout -> Payment',
+                    friction: 'Cart abandonment at checkout due to complexity',
+                    rec: 'Guest checkout, progress indicator, saved cart, multiple payment options',
+                },
+                'Comment system': {
+                    journey: 'Engagement flow: Read article -> Scroll to comments -> Write comment',
+                    friction: 'Login requirement for commenting reduces engagement',
+                    rec: 'Allow guest comments with moderation, or social login for quick auth',
+                },
+                'PDF downloads': {
+                    journey: 'Content access flow: Browse catalog -> Select issue -> Download PDF',
+                    friction: 'Large file sizes and unclear progress',
+                    rec: 'Show file size before download, progress indicator, resume support',
+                },
+            };
+            for (const feature of features) {
+                const mapping = journeyMapping[feature];
+                if (mapping) {
+                    journeys.push(mapping.journey);
+                    frictionPoints.push(mapping.friction);
+                    recommendations.push(mapping.rec);
+                }
+            }
+            // Add general QX recommendations
+            recommendations.push('Map complete user journeys with entry/exit points', 'Identify drop-off points using analytics', 'Test critical paths with real users', 'Monitor Core Web Vitals for performance impact on UX');
+            // Store result
+            await this.memory.set(`qcsd-ideation:qx:${targetId}`, { journeys, frictionPoints, recommendations, url, timestamp: new Date().toISOString() }, { namespace: 'qcsd-ideation', ttl: 3600 });
+            return ok({ journeys, frictionPoints, recommendations });
+        }
+        catch (error) {
+            return err(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    // ============================================================================
+    // Helper Methods - Continued
+    // ============================================================================
+    identifyBlockers(testability, risk, threatModel) {
+        const blockers = [];
+        // Testability blockers
+        if (testability.overallScore < 40) {
+            blockers.push('Testability score too low - cannot verify acceptance criteria');
+        }
+        blockers.push(...testability.blockers);
+        // Risk blockers
+        if (risk.overallRisk === 'critical') {
+            blockers.push('Critical risk level requires risk mitigation before development');
+        }
+        // Security blockers
+        if (threatModel && threatModel.overallRisk === 'critical') {
+            blockers.push('Critical security threats must be addressed before development');
+        }
+        return blockers;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createQCSDIdeationPlugin(memory) {
+    return new QCSDIdeationPlugin(memory);
+}
+//# sourceMappingURL=qcsd-ideation-plugin.js.map