agentic-qe 3.6.1 → 3.6.3

package/v3/dist/mcp/tools/qx-analysis/impact-analyzer.js

@@ -0,0 +1,175 @@
+/**
+ * Agentic QE v3 - Impact Analyzer
+ *
+ * Analyzes visible and invisible impacts of quality experience.
+ * Identifies immutable requirements and overall impact scores.
+ *
+ * QX Methodology by Lalitkumar Bhamare / Tales of Testing
+ */
+// ============================================================================
+// Impact Analyzer
+// ============================================================================
+export class ImpactAnalyzer {
+    /**
+     * Analyze impacts from context and problem analysis
+     */
+    analyze(context, problemAnalysis) {
+        const guiFlowEndUser = [];
+        const guiFlowInternal = [];
+        const userFeelings = [];
+        const performance = [];
+        const security = [];
+        const immutableRequirements = [];
+        // Analyze visible impacts
+        const interactiveElements = context.domMetrics?.interactiveElements || 0;
+        const forms = context.domMetrics?.forms || 0;
+        if (interactiveElements > 0) {
+            guiFlowEndUser.push(`${interactiveElements} interactive elements affect user journey`);
+        }
+        if (forms > 0) {
+            guiFlowEndUser.push(`${forms} forms impact user input flows`);
+        }
+        // Check for navigation impact
+        if (context.domMetrics?.semanticStructure?.hasNav) {
+            guiFlowEndUser.push('Navigation structure enables exploration flow');
+        }
+        // Check for content structure impact
+        if (context.domMetrics?.semanticStructure?.hasMain) {
+            guiFlowEndUser.push('Clear main content area guides user focus');
+        }
+        // Internal user impacts
+        if (forms > 0) {
+            guiFlowInternal.push('Form submissions create data processing workflows');
+        }
+        if (context.domMetrics?.semanticStructure?.hasAside) {
+            guiFlowInternal.push('Sidebar content may require separate management');
+        }
+        // User feelings based on quality metrics
+        const altCoverage = context.accessibility?.altTextsCoverage || 0;
+        if (altCoverage > 80) {
+            userFeelings.push('Positive - Good accessibility creates inclusive experience');
+        }
+        else if (altCoverage >= 50 && altCoverage <= 80) {
+            userFeelings.push('Neutral - Moderate accessibility; some users may struggle');
+        }
+        else if (altCoverage < 50) {
+            userFeelings.push('Frustrated - Poor accessibility excludes some users');
+        }
+        const loadTime = context.performance?.loadTime || 0;
+        if (loadTime > 4000) {
+            userFeelings.push('Impatient - Very slow load time causes significant frustration');
+        }
+        else if (loadTime > 3000) {
+            userFeelings.push('Impatient - Slow load time causes frustration');
+        }
+        else if (loadTime > 2000) {
+            userFeelings.push('Mildly Annoyed - Noticeable load time');
+        }
+        else if (loadTime < 1500) {
+            userFeelings.push('Delighted - Fast load time enhances experience');
+        }
+        else if (loadTime < 2000) {
+            userFeelings.push('Satisfied - Good load time meets expectations');
+        }
+        if (context.errorIndicators?.hasErrorMessages) {
+            userFeelings.push('Confused - Visible errors reduce confidence');
+        }
+        // Check for visual hierarchy impact on feelings
+        const semanticStructure = context.domMetrics?.semanticStructure;
+        if (semanticStructure) {
+            const structureCount = [
+                semanticStructure.hasHeader,
+                semanticStructure.hasNav,
+                semanticStructure.hasMain,
+                semanticStructure.hasFooter,
+            ].filter(Boolean).length;
+            if (structureCount >= 3) {
+                userFeelings.push('Oriented - Clear page structure helps navigation');
+            }
+            else if (structureCount < 2) {
+                userFeelings.push('Disoriented - Unclear page structure may confuse users');
+            }
+        }
+        // Analyze invisible impacts
+        if (loadTime > 2000) {
+            performance.push(`Load time ${loadTime}ms impacts user retention`);
+        }
+        if (!context.metadata?.viewport) {
+            performance.push('Missing viewport tag affects mobile performance');
+        }
+        // First Contentful Paint impact
+        if (context.performance?.firstContentfulPaint && context.performance.firstContentfulPaint > 2500) {
+            performance.push(`First Contentful Paint ${context.performance.firstContentfulPaint}ms delays perceived readiness`);
+        }
+        // Security considerations based on forms
+        if (forms > 0) {
+            security.push('Form data handling requires secure transmission');
+        }
+        // Accessibility-related security/privacy
+        if (context.accessibility && (context.accessibility.ariaLabelsCount || 0) > 0) {
+            security.push('ARIA labels may expose internal element names - review for sensitive info');
+        }
+        // Immutable requirements
+        if (context.domMetrics?.semanticStructure?.hasMain) {
+            immutableRequirements.push('Must maintain main content accessibility');
+        }
+        if (context.accessibility && (context.accessibility.focusableElementsCount || 0) > 0) {
+            immutableRequirements.push('Must support keyboard navigation');
+        }
+        if (problemAnalysis.complexity === 'complex') {
+            immutableRequirements.push('Must maintain system stability with complex interactions');
+        }
+        // Domain-specific immutable requirements
+        const titleLower = (context.title || '').toLowerCase();
+        if (titleLower.includes('health') ||
+            titleLower.includes('medical') ||
+            titleLower.includes('care')) {
+            immutableRequirements.push('Must comply with healthcare accessibility standards');
+            immutableRequirements.push('Must protect patient data privacy');
+        }
+        if (titleLower.includes('bank') || titleLower.includes('finance') || titleLower.includes('payment')) {
+            immutableRequirements.push('Must maintain PCI DSS compliance for payment data');
+            immutableRequirements.push('Must support secure authentication flows');
+        }
+        // Calculate impact scores
+        let visibleScore = 50;
+        if (guiFlowEndUser.length > 0)
+            visibleScore += 15;
+        if (userFeelings.some((f) => f.includes('Positive') || f.includes('Satisfied') || f.includes('Delighted')))
+            visibleScore += 20;
+        if (userFeelings.some((f) => f.includes('Oriented')))
+            visibleScore += 10;
+        if (userFeelings.some((f) => f.includes('Frustrated') || f.includes('Confused') || f.includes('Impatient')))
+            visibleScore -= 15;
+        if (userFeelings.some((f) => f.includes('Disoriented')))
+            visibleScore -= 10;
+        visibleScore = Math.max(0, Math.min(100, visibleScore));
+        let invisibleScore = 50;
+        if (performance.length === 0)
+            invisibleScore += 20;
+        if (security.length === 0)
+            invisibleScore += 10;
+        if (performance.length > 2)
+            invisibleScore -= 15;
+        invisibleScore = Math.max(0, Math.min(100, invisibleScore));
+        const overallImpactScore = Math.round((visibleScore + invisibleScore) / 2);
+        return {
+            visible: {
+                guiFlow: {
+                    forEndUser: guiFlowEndUser,
+                    forInternalUser: guiFlowInternal,
+                },
+                userFeelings,
+                score: visibleScore,
+            },
+            invisible: {
+                performance,
+                security,
+                score: invisibleScore,
+            },
+            immutableRequirements,
+            overallImpactScore,
+        };
+    }
+}
+//# sourceMappingURL=impact-analyzer.js.map

package/v3/dist/mcp/tools/qx-analysis/impact-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-analyzer.js","sourceRoot":"","sources":["../../../../src/mcp/tools/qx-analysis/impact-analyzer.ts"],"names":[],"mappings":"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"}

package/v3/dist/mcp/tools/qx-analysis/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Agentic QE v3 - QX Analysis Tools
+ *
+ * MCP tools for programmatic Quality Experience analysis.
+ * Ported from V2 QXPartnerAgent for consistent, high-quality output.
+ *
+ * QX Methodology by Lalitkumar Bhamare / Tales of Testing
+ * https://talesoftesting.com/quality-experienceqx-co-creating-quality-experience-for-everyone-associated-with-the-product/
+ *
+ * Tools:
+ * - qe/qx/analyze: Comprehensive QX analysis (combines all analysis)
+ *
+ * Components (used internally):
+ * - QXHeuristicsEngine: Applies 23+ programmatic heuristics
+ * - OracleDetector: Detects oracle problems
+ * - ImpactAnalyzer: Analyzes visible/invisible impacts
+ */
+export * from './types';
+export { QXHeuristicsEngine, getHeuristicsByCategory } from './heuristics-engine';
+export { OracleDetector } from './oracle-detector';
+export { ImpactAnalyzer } from './impact-analyzer';
+export { QXAnalyzeTool, qxAnalyzeTool } from './analyze';
+/**
+ * Get all QX analysis tools for registration
+ */
+export declare function getQXAnalysisTools(): import("./analyze").QXAnalyzeTool[];
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/mcp/tools/qx-analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/qx-analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAKzD;;GAEG;AACH,wBAAgB,kBAAkB,wCAEjC"}

package/v3/dist/mcp/tools/qx-analysis/index.js

@@ -0,0 +1,34 @@
+/**
+ * Agentic QE v3 - QX Analysis Tools
+ *
+ * MCP tools for programmatic Quality Experience analysis.
+ * Ported from V2 QXPartnerAgent for consistent, high-quality output.
+ *
+ * QX Methodology by Lalitkumar Bhamare / Tales of Testing
+ * https://talesoftesting.com/quality-experienceqx-co-creating-quality-experience-for-everyone-associated-with-the-product/
+ *
+ * Tools:
+ * - qe/qx/analyze: Comprehensive QX analysis (combines all analysis)
+ *
+ * Components (used internally):
+ * - QXHeuristicsEngine: Applies 23+ programmatic heuristics
+ * - OracleDetector: Detects oracle problems
+ * - ImpactAnalyzer: Analyzes visible/invisible impacts
+ */
+// Types
+export * from './types';
+// Components
+export { QXHeuristicsEngine, getHeuristicsByCategory } from './heuristics-engine';
+export { OracleDetector } from './oracle-detector';
+export { ImpactAnalyzer } from './impact-analyzer';
+// Tools
+export { QXAnalyzeTool, qxAnalyzeTool } from './analyze';
+// Tool Registration
+import { qxAnalyzeTool } from './analyze';
+/**
+ * Get all QX analysis tools for registration
+ */
+export function getQXAnalysisTools() {
+    return [qxAnalyzeTool];
+}
+//# sourceMappingURL=index.js.map

package/v3/dist/mcp/tools/qx-analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tools/qx-analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,QAAQ;AACR,cAAc,SAAS,CAAC;AAExB,aAAa;AACb,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/v3/dist/mcp/tools/qx-analysis/oracle-detector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agentic QE v3 - Oracle Problem Detector
+ *
+ * Detects situations where testers cannot determine quality criteria.
+ * Identifies user vs business conflicts, missing information, and stakeholder conflicts.
+ *
+ * QX Methodology by Lalitkumar Bhamare / Tales of Testing
+ */
+import { QXContext, UserNeedsAnalysis, BusinessNeedsAnalysis, OracleProblem } from './types';
+export declare class OracleDetector {
+    private minSeverity;
+    constructor(minSeverity?: 'low' | 'medium' | 'high' | 'critical');
+    /**
+     * Detect oracle problems from context and analysis
+     */
+    detect(context: QXContext, userNeeds: UserNeedsAnalysis, businessNeeds: BusinessNeedsAnalysis): OracleProblem[];
+    /**
+     * Check if severity meets minimum threshold
+     */
+    private meetsMinimumSeverity;
+}
+//# sourceMappingURL=oracle-detector.d.ts.map

package/v3/dist/mcp/tools/qx-analysis/oracle-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-detector.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/qx-analysis/oracle-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACd,MAAM,SAAS,CAAC;AAMjB,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAyC;gBAEhD,WAAW,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAqB;IAI1E;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,iBAAiB,EAC5B,aAAa,EAAE,qBAAqB,GACnC,aAAa,EAAE;IAoMlB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAM7B"}

package/v3/dist/mcp/tools/qx-analysis/oracle-detector.js

@@ -0,0 +1,194 @@
+/**
+ * Agentic QE v3 - Oracle Problem Detector
+ *
+ * Detects situations where testers cannot determine quality criteria.
+ * Identifies user vs business conflicts, missing information, and stakeholder conflicts.
+ *
+ * QX Methodology by Lalitkumar Bhamare / Tales of Testing
+ */
+// ============================================================================
+// Oracle Detector
+// ============================================================================
+export class OracleDetector {
+    minSeverity;
+    constructor(minSeverity = 'medium') {
+        this.minSeverity = minSeverity;
+    }
+    /**
+     * Detect oracle problems from context and analysis
+     */
+    detect(context, userNeeds, businessNeeds) {
+        const problems = [];
+        // Check for user vs business conflicts
+        if (Math.abs(userNeeds.alignmentScore - businessNeeds.alignmentScore) > 20) {
+            problems.push({
+                type: 'user-vs-business',
+                description: 'Significant gap between user needs and business objectives',
+                severity: 'high',
+                stakeholders: ['Users', 'Business'],
+                resolutionApproach: [
+                    'Gather supporting data from both perspectives',
+                    'Facilitate discussion between stakeholders',
+                    'Find compromise solutions that address both needs',
+                ],
+            });
+        }
+        // Check for missing information
+        if (userNeeds.challenges.length > 0 || businessNeeds.compromisesUX) {
+            problems.push({
+                type: 'unclear-criteria',
+                description: 'Quality criteria unclear due to conflicting information',
+                severity: 'medium',
+                missingInfo: userNeeds.challenges,
+                resolutionApproach: [
+                    'Collect missing information from stakeholders',
+                    'Define clear acceptance criteria',
+                ],
+            });
+        }
+        // DOMAIN-SPECIFIC Oracle Problems
+        const titleLower = (context.title || '').toLowerCase();
+        const descLower = (context.metadata?.description || '').toLowerCase();
+        // E-commerce/Travel/Booking: Conversion vs UX quality
+        if (titleLower.includes('hotel') ||
+            titleLower.includes('booking') ||
+            titleLower.includes('travel') ||
+            titleLower.includes('shop') ||
+            titleLower.includes('store') ||
+            descLower.includes('book')) {
+            if (businessNeeds.kpisAffected.some((k) => k.toLowerCase().includes('conversion') || k.toLowerCase().includes('engagement'))) {
+                problems.push({
+                    type: 'user-vs-business',
+                    description: 'Potential conflict between conversion optimization (business) and user experience quality (user trust)',
+                    severity: 'medium',
+                    stakeholders: ['Marketing', 'Product', 'Users'],
+                    resolutionApproach: [
+                        'A/B test aggressive vs. subtle conversion tactics',
+                        'Measure both conversion rate and user satisfaction metrics',
+                        'Balance urgency messaging with transparent communication',
+                    ],
+                });
+            }
+            // Price transparency oracle
+            problems.push({
+                type: 'unclear-criteria',
+                description: 'Unclear criteria for price display timing - when to show fees, taxes, and final price',
+                severity: 'medium',
+                stakeholders: ['Users', 'Legal', 'Business'],
+                resolutionApproach: [
+                    'Define regulatory compliance requirements for price display',
+                    'Balance business desire for competitive base pricing vs user need for full price transparency',
+                    'Establish clear standards for fee disclosure timing',
+                ],
+            });
+        }
+        // Content sites: Quality vs. Quantity
+        if (titleLower.includes('blog') ||
+            titleLower.includes('article') ||
+            titleLower.includes('news') ||
+            titleLower.includes('magazine') ||
+            titleLower.includes('testing')) {
+            problems.push({
+                type: 'user-vs-business',
+                description: 'Content depth (user need) vs. publication frequency (business engagement goals) trade-off',
+                severity: 'low',
+                stakeholders: ['Readers', 'Content Team', 'Editorial'],
+                resolutionApproach: [
+                    'Define content quality standards and acceptance criteria',
+                    'Balance editorial calendar with quality thresholds',
+                    'Consider mix of in-depth and quick-read content formats',
+                ],
+            });
+        }
+        // Healthcare: Compliance vs UX
+        if (titleLower.includes('health') ||
+            titleLower.includes('medical') ||
+            titleLower.includes('patient') ||
+            titleLower.includes('care') ||
+            titleLower.includes('nhs')) {
+            problems.push({
+                type: 'stakeholder-conflict',
+                description: 'Healthcare compliance requirements may conflict with streamlined user experience',
+                severity: 'medium',
+                stakeholders: ['Patients', 'Healthcare Providers', 'Compliance', 'Legal'],
+                resolutionApproach: [
+                    'Map regulatory requirements to UX touchpoints',
+                    'Identify where compliance can be achieved without friction',
+                    'Engage compliance team early in UX design reviews',
+                    'Document consent and data handling requirements clearly',
+                ],
+            });
+            // Accessibility in healthcare is critical
+            if (context.accessibility && (context.accessibility.altTextsCoverage || 0) < 80) {
+                problems.push({
+                    type: 'technical-constraint',
+                    description: 'Healthcare accessibility requirements not fully met - critical for patient inclusivity',
+                    severity: 'high',
+                    stakeholders: ['Patients', 'Accessibility Team', 'Legal'],
+                    resolutionApproach: [
+                        'Prioritize WCAG 2.1 AA compliance for healthcare content',
+                        'Ensure screen reader compatibility for medical information',
+                        'Test with assistive technology users',
+                    ],
+                });
+            }
+        }
+        // Finance: Security vs Convenience
+        if (titleLower.includes('bank') ||
+            titleLower.includes('finance') ||
+            titleLower.includes('payment') ||
+            titleLower.includes('money')) {
+            problems.push({
+                type: 'stakeholder-conflict',
+                description: 'Security requirements vs user convenience - authentication friction vs fraud prevention',
+                severity: 'high',
+                stakeholders: ['Users', 'Security Team', 'Product', 'Compliance'],
+                resolutionApproach: [
+                    'Implement risk-based authentication to reduce friction for trusted sessions',
+                    'Use biometrics where available for convenient yet secure access',
+                    'A/B test authentication flows for security effectiveness and user completion rates',
+                ],
+            });
+        }
+        // Complex sites: Technical constraints
+        if ((context.domMetrics?.totalElements || 0) > 500 ||
+            (context.domMetrics?.interactiveElements || 0) > 50) {
+            problems.push({
+                type: 'technical-constraint',
+                description: 'Platform technical limitations may restrict advanced UX features or accessibility enhancements',
+                severity: 'low',
+                stakeholders: ['Development', 'Product', 'Users'],
+                resolutionApproach: [
+                    'Evaluate platform capabilities and constraints',
+                    'Prioritize features based on user impact vs. implementation complexity',
+                    'Consider gradual enhancement approach',
+                ],
+            });
+        }
+        // Performance oracle
+        if (context.performance && (context.performance.loadTime || 0) > 3000) {
+            problems.push({
+                type: 'technical-constraint',
+                description: 'Performance optimization needed but may require trade-offs with visual richness',
+                severity: 'medium',
+                stakeholders: ['Users', 'Development', 'Design'],
+                resolutionApproach: [
+                    'Profile and identify performance bottlenecks',
+                    'Consider progressive loading for visual elements',
+                    'Balance image quality with load time',
+                ],
+            });
+        }
+        return problems.filter((p) => this.meetsMinimumSeverity(p.severity));
+    }
+    /**
+     * Check if severity meets minimum threshold
+     */
+    meetsMinimumSeverity(severity) {
+        const severityLevels = ['low', 'medium', 'high', 'critical'];
+        const minIndex = severityLevels.indexOf(this.minSeverity);
+        const currentIndex = severityLevels.indexOf(severity);
+        return currentIndex >= minIndex;
+    }
+}
+//# sourceMappingURL=oracle-detector.js.map

package/v3/dist/mcp/tools/qx-analysis/oracle-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle-detector.js","sourceRoot":"","sources":["../../../../src/mcp/tools/qx-analysis/oracle-detector.ts"],"names":[],"mappings":"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"}