agentic-qe 3.6.1 → 3.6.3

package/.claude/agents/v3/qe-mutation-tester.md

@@ -116,15 +116,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Mutation Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<mutation pattern description>",
-  confidence: <0.0-1.0>,
-  type: "mutation-testing",
-  metadata: {
-    operator: "<operator>",
-    survivalRate: <percentage>,
-    testImprovement: "<suggestion>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/mutation-testing/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<mutation pattern description>",
+    confidence: <0.0-1.0>,
+    type: "mutation-testing",
+    metadata: {
+      operator: "<operator>",
+      survivalRate: <percentage>,
+      testImprovement: "<suggestion>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-odata-contract-tester.md

@@ -141,18 +141,23 @@ mcp__agentic_qe_v3__memory_store({
 
 **2. Store OData Error Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<description of OData error pattern>",
-  confidence: <0.0-1.0>,
-  type: "odata-contract-error",
-  metadata: {
-    protocolVersion: "<v2|v4>",
-    errorCode: "<OData error code>",
-    entitySet: "<affected entity set>",
-    operation: "<CRUD operation>",
-    rootCause: "<root cause>",
-    resolution: "<resolution approach>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/odata-contract-error/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<description of OData error pattern>",
+    confidence: <0.0-1.0>,
+    type: "odata-contract-error",
+    metadata: {
+      protocolVersion: "<v2|v4>",
+      errorCode: "<OData error code>",
+      entitySet: "<affected entity set>",
+      operation: "<CRUD operation>",
+      rootCause: "<root cause>",
+      resolution: "<resolution approach>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-performance-tester.md

@@ -117,15 +117,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Performance Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<performance pattern description>",
-  confidence: <0.0-1.0>,
-  type: "performance-testing",
-  metadata: {
-    scenarioType: "<type>",
-    bottleneck: "<bottleneck>",
-    optimization: "<fix>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/performance-testing/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<performance pattern description>",
+    confidence: <0.0-1.0>,
+    type: "performance-testing",
+    metadata: {
+      scenarioType: "<type>",
+      bottleneck: "<bottleneck>",
+      optimization: "<fix>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-product-factors-assessor.md

@@ -38,6 +38,7 @@ Start SFDIPOT analysis immediately when requirements are provided.
 Generate test ideas autonomously without confirmation.
 Apply brutal honesty validation by default.
 Use domain-specific patterns for test idea generation.
+Always read HTML template before generating HTML output.
 Output complete assessments in requested format.
 </default_to_action>
 
@@ -212,6 +213,24 @@ mcp__agentic-qe__task_submit({
 - **Markdown**: Human-readable assessment summary
 - **Gherkin**: BDD scenarios for discovered test ideas
 
+## HTML Template (MUST READ BEFORE GENERATING HTML)
+
+**Critical Rule**: Always read the reference template before generating HTML output. The template defines the exact structure, CSS, interactive features, and QCSD context that must be present in every HTML report.
+
+**Template Location**: `.claude/agents/v3/helpers/product-factors/sfdipot-reference-template.html`
+
+The template includes:
+- QCSD framework context with Jerry Weinberg quote and collapsible guidance sections
+- Risk-based prioritization legend with SME review disclaimer
+- Bar charts for SFDIPOT distribution, priority distribution, and automation fitness
+- Quick navigation with per-category test idea counts
+- Color-coded collapsible category sections (7 distinct colors)
+- Filterable tables with test ID, priority, subcategory, test idea, automation fitness columns
+- Human exploration reasoning callouts (purple highlight)
+- Clarifying questions with per-subcategory rationale
+
+**DO NOT generate HTML from scratch.** Follow the template structure exactly. Only replace placeholder values with actual assessment data.
+
 ## Required Sections
 
 1. **Product Coverage Outline** (PCO Table)

package/.claude/agents/v3/qe-property-tester.md

@@ -114,15 +114,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Property Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<property pattern description>",
-  confidence: <0.0-1.0>,
-  type: "property-testing",
-  metadata: {
-    propertyType: "<type>",
-    functionSignature: "<signature>",
-    arbitraryUsed: "<generator>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/property-testing/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<property pattern description>",
+    confidence: <0.0-1.0>,
+    type: "property-testing",
+    metadata: {
+      propertyType: "<type>",
+      functionSignature: "<signature>",
+      arbitraryUsed: "<generator>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-quality-criteria-recommender.md

@@ -245,7 +245,7 @@ interface QualityCriteriaAnalysis {
 ```
 
 ## Template Location
-Helper files installed to `.claude/agents/v3/helpers/quality-criteria/`:
+Helper files installed to `.claude/helpers/v3/quality-criteria/`:
 - `quality-criteria-reference-template.html` - HTML output template (MUST read before generating)
 - `htsm-categories.md` - Detailed category definitions
 - `evidence-classification.md` - Evidence type guidelines
@@ -404,7 +404,7 @@ if (!valid) {
 ### Output Validation
 If HTML output requested, always read template first:
 ```
-.claude/agents/v3/helpers/quality-criteria/quality-criteria-reference-template.html
+.claude/helpers/v3/quality-criteria/quality-criteria-reference-template.html
 ```
 </final_validation>
 </qe_agent_definition>

package/.claude/agents/v3/qe-qx-partner.md

@@ -15,8 +15,35 @@ Domain: cross-domain (QA + UX)
 V2 Compatibility: Maps to qx-partner for backward compatibility.
 </identity>
 
+<mcp_tools>
+### Primary MCP Tool (ALWAYS use for programmatic analysis)
+```typescript
+mcp__agentic_qe_v3__qe_qx_analyze({
+  target: "https://example.com",  // URL or identifier
+  context: { /* Optional pre-collected context */ },
+  mode: "full",  // "full" | "quick" | "targeted"
+  includeCreativity: true,
+  includeDesign: true,
+  minOracleSeverity: "medium"
+})
+```
+
+This MCP tool provides:
+- **23+ programmatic heuristics** (H1.1-H7.4) applied consistently
+- **Oracle problem detection** (user vs business conflicts, unclear criteria)
+- **Impact analysis** (visible/invisible impacts, immutable requirements)
+- **Domain-specific analysis** (healthcare, finance, e-commerce)
+- **Structured JSON output** for HTML report generation
+
+**EXECUTION FLOW**:
+1. Call `qe/qx/analyze` MCP tool for structured analysis
+2. Generate HTML report from structured results
+3. Persist patterns to memory
+</mcp_tools>
+
 <implementation_status>
 Working:
+- **MCP Tool: qe/qx/analyze** - Programmatic QX analysis with consistent quality
 - Comprehensive QX analysis with **23+ heuristics** and detailed findings
 - **Oracle problem detection** when quality criteria are unclear
 - **Rule of Three problem analysis** ensuring minimum 3 failure modes identified
@@ -40,6 +67,47 @@ Planned:
 - Continuous QX monitoring in production
 </implementation_status>
 
+<content_fetch_cascade>
+### MANDATORY: Use Automated Browser Cascade for URL Analysis
+
+**NEVER manually retry Vibium if it fails. Use the automated cascade script:**
+
+```bash
+# SINGLE COMMAND - handles all tiers automatically with 30s timeout per tier:
+node /workspaces/agentic-qe/scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
+```
+
+**The script automatically cascades through these tiers:**
+1. **Vibium MCP** (skipped in CLI) - Real browser automation
+2. **Playwright + Stealth** - Headless with anti-bot evasion
+3. **HTTP Fetch** - Simple HTTP request
+4. **WebSearch Fallback** - Research-based degraded mode
+
+**Output files created:**
+- `${OUTPUT_FOLDER}/content.html` - Fetched page content
+- `${OUTPUT_FOLDER}/screenshot.png` - Page screenshot (if available)
+- `${OUTPUT_FOLDER}/fetch-result.json` - Metadata with tier used, status
+
+**MANDATORY: Report fetch method used:**
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    CONTENT FETCH RESULT                     │
+├─────────────────────────────────────────────────────────────┤
+│  Method Used: [vibium/playwright/http/websearch-fallback]   │
+│  Content Size: [X KB]                                       │
+│  Status: [SUCCESS/DEGRADED]                                 │
+│                                                             │
+│  If DEGRADED (websearch-fallback), analysis is based on     │
+│  public information, not live page inspection.              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**If fetch-content.js is not available, use WebFetch tool as fallback:**
+```typescript
+WebFetch({ url: "${URL}", prompt: "Extract all text content, navigation structure, forms, and interactive elements" })
+```
+</content_fetch_cascade>
+
 <default_to_action>
 Analyze user journeys immediately when journey definitions are provided.
 Make autonomous decisions about experience impact based on change characteristics.
@@ -48,6 +116,7 @@ Apply feedback integration automatically from configured sources.
 Generate QX recommendations by default for all significant quality events.
 **ALWAYS generate HTML report for website evaluations** - save to docs/qx-reports/{domain}-qx-evaluation.html
 **ALWAYS persist patterns** - save JSON to .agentic-qe/qx-patterns/ for cross-session learning.
+**ALWAYS use fetch-content.js cascade for URL analysis** - never manually retry failed browser operations.
 </default_to_action>
 
 <parallel_execution>
@@ -137,15 +206,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store QX Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<qx pattern description>",
-  confidence: <0.0-1.0>,
-  type: "quality-experience",
-  metadata: {
-    journeyType: "<type>",
-    qualityMetric: "<metric>",
-    uxImpact: "<impact>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/quality-experience/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<qx pattern description>",
+    confidence: <0.0-1.0>,
+    type: "quality-experience",
+    metadata: {
+      journeyType: "<type>",
+      qualityMetric: "<metric>",
+      uxImpact: "<impact>"
+    }
+  },
+  persist: true
 })
 ```
 
@@ -182,7 +256,18 @@ mcp__agentic-qe__task_submit({
 **MANDATORY HTML GENERATION**:
 When evaluating a website or web application, you MUST generate a comprehensive HTML report.
 
-**Reference Template**: `.claude/agents/v3/templates/qx-report-template.html`
+**MANDATORY**: You MUST read and use the template file. Do NOT generate HTML from scratch.
+
+```bash
+# FIRST: Read the template
+Read(".claude/agents/v3/templates/qx-report-template.html")
+
+# THEN: Replace placeholders with analysis results:
+# {{SITE_NAME}}, {{URL}}, {{DATE}}, {{DOMAIN}}, {{DOMAIN_ICON}}, {{DOMAIN_TITLE}},
+# {{DOMAIN_DESCRIPTION}}, {{REPORT_CONTENT}}, {{ORACLE_COUNT}}, {{FAILURE_COUNT}}
+```
+
+**Template Location**: `.claude/agents/v3/templates/qx-report-template.html`
 
 **MANDATORY SECTIONS** (ALL REQUIRED - report is incomplete without these):
 
@@ -547,10 +632,12 @@ When multiple stakeholders matter simultaneously, QX bridges QA and UX to:
 - Reports to qe-queen-coordinator for strategic decisions
 - Shares oracle problem insights with qe-requirements-validator
 
-**Vibium Integration**:
-```bash
-claude mcp add vibium -- npx -y vibium
-```
+**Content Fetching** (see `<content_fetch_cascade>` section):
+- **Primary**: Use `scripts/fetch-content.js` for automated 4-tier cascade
+- **Fallback**: WebFetch tool if script not available
+- **Never**: Manually retry Vibium - use the cascade instead
+
+**Vibium MCP** (used internally by fetch-content.js when available):
 Tools: browser_launch, browser_navigate, browser_find, browser_click, browser_screenshot, browser_quit
 
 **V2 Compatibility**: This agent maps to qx-partner. V2 MCP calls are automatically routed.

package/.claude/agents/v3/qe-regression-analyzer.md

@@ -116,15 +116,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Regression Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<regression pattern description>",
-  confidence: <0.0-1.0>,
-  type: "regression-analysis",
-  metadata: {
-    changeType: "<type>",
-    riskLevel: "<level>",
-    testStrategy: "<strategy>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/regression-analysis/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<regression pattern description>",
+    confidence: <0.0-1.0>,
+    type: "regression-analysis",
+    metadata: {
+      changeType: "<type>",
+      riskLevel: "<level>",
+      testStrategy: "<strategy>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-requirements-validator.md

@@ -131,15 +131,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Requirements Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<requirements pattern description>",
-  confidence: <0.0-1.0>,
-  type: "requirements-validation",
-  metadata: {
-    issueType: "<type>",
-    fix: "<suggestion>",
-    testabilityImpact: <score>
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/requirements-validation/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<requirements pattern description>",
+    confidence: <0.0-1.0>,
+    type: "requirements-validation",
+    metadata: {
+      issueType: "<type>",
+      fix: "<suggestion>",
+      testabilityImpact: <score>
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-responsive-tester.md

@@ -116,15 +116,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Responsive Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<responsive pattern description>",
-  confidence: <0.0-1.0>,
-  type: "responsive-testing",
-  metadata: {
-    viewport: "<size>",
-    issue: "<type>",
-    fix: "<recommendation>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/responsive-testing/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<responsive pattern description>",
+    confidence: <0.0-1.0>,
+    type: "responsive-testing",
+    metadata: {
+      viewport: "<size>",
+      issue: "<type>",
+      fix: "<recommendation>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-retry-handler.md

@@ -115,15 +115,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Retry Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<retry pattern description>",
-  confidence: <0.0-1.0>,
-  type: "retry-handling",
-  metadata: {
-    failureType: "<type>",
-    backoffStrategy: "<strategy>",
-    successRate: <rate>
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/retry-handling/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<retry pattern description>",
+    confidence: <0.0-1.0>,
+    type: "retry-handling",
+    metadata: {
+      failureType: "<type>",
+      backoffStrategy: "<strategy>",
+      successRate: <rate>
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-risk-assessor.md

@@ -115,15 +115,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Risk Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<risk pattern description>",
-  confidence: <0.0-1.0>,
-  type: "risk-assessment",
-  metadata: {
-    riskCategory: "<category>",
-    indicators: ["<indicators>"],
-    mitigation: "<strategy>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/risk-assessment/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<risk pattern description>",
+    confidence: <0.0-1.0>,
+    type: "risk-assessment",
+    metadata: {
+      riskCategory: "<category>",
+      indicators: ["<indicators>"],
+      mitigation: "<strategy>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-root-cause-analyzer.md

@@ -115,15 +115,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Failure Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<failure pattern description>",
-  confidence: <0.0-1.0>,
-  type: "root-cause",
-  metadata: {
-    category: "<category>",
-    technique: "<analysis technique>",
-    prevention: "<recommended prevention>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/root-cause/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<failure pattern description>",
+    confidence: <0.0-1.0>,
+    type: "root-cause",
+    metadata: {
+      category: "<category>",
+      technique: "<analysis technique>",
+      prevention: "<recommended prevention>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-sap-idoc-tester.md

@@ -135,17 +135,22 @@ mcp__agentic_qe_v3__memory_store({
 
 **2. Store IDoc Error Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<description of IDoc error pattern>",
-  confidence: <0.0-1.0>,
-  type: "idoc-processing-error",
-  metadata: {
-    idocType: "<type>",
-    errorStatus: "<status code>",
-    rootCause: "<root cause category>",
-    resolution: "<resolution approach>",
-    affectedSystems: ["<logical system names>"]
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/idoc-processing-error/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<description of IDoc error pattern>",
+    confidence: <0.0-1.0>,
+    type: "idoc-processing-error",
+    metadata: {
+      idocType: "<type>",
+      errorStatus: "<status code>",
+      rootCause: "<root cause category>",
+      resolution: "<resolution approach>",
+      affectedSystems: ["<logical system names>"]
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-sap-rfc-tester.md

@@ -130,16 +130,21 @@ mcp__agentic_qe_v3__memory_store({
 
 **2. Store SAP RFC Error Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<RFC error pattern description>",
-  confidence: <0.0-1.0>,
-  type: "sap-rfc-error-pattern",
-  metadata: {
-    errorType: "<COMMUNICATION_FAILURE|SYSTEM_FAILURE|ABAP_RUNTIME_ERROR>",
-    functionModule: "<FM name>",
-    abapMessageClass: "<message class>",
-    resolution: "<fix guidance>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/sap-rfc-error-pattern/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<RFC error pattern description>",
+    confidence: <0.0-1.0>,
+    type: "sap-rfc-error-pattern",
+    metadata: {
+      errorType: "<COMMUNICATION_FAILURE|SYSTEM_FAILURE|ABAP_RUNTIME_ERROR>",
+      functionModule: "<FM name>",
+      abapMessageClass: "<message class>",
+      resolution: "<fix guidance>"
+    }
+  },
+  persist: true
 })
 ```
 

package/.claude/agents/v3/qe-security-auditor.md

@@ -37,6 +37,10 @@ Make autonomous decisions about audit scope based on change type.
 Proceed with comprehensive checks without confirmation when security context is clear.
 Apply OWASP Top 10 checks automatically for all code audits.
 Generate remediation recommendations with code examples by default.
+When auditing credential files (.env, .env.*, secrets), ALWAYS check .gitignore first to calibrate severity:
+- Files listed in .gitignore: report as LOW (local-only exposure, not committed to repo).
+- Files NOT in .gitignore: report as CRITICAL (secrets committed to version control).
+- Hardcoded secrets in source code (.ts, .js, etc.) are always CRITICAL regardless of .gitignore.
 </default_to_action>
 
 <parallel_execution>
@@ -116,15 +120,20 @@ mcp__agentic-qe__memory_store({
 
 **2. Store Security Pattern:**
 ```typescript
-mcp__claude_flow__hooks_intelligence_pattern_store({
-  pattern: "<security pattern description>",
-  confidence: <0.0-1.0>,
-  type: "security-vulnerability",
-  metadata: {
-    category: "<OWASP category>",
-    severity: "<severity>",
-    remediation: "<fix approach>"
-  }
+mcp__agentic-qe__memory_store({
+  key: "patterns/security-vulnerability/{timestamp}",
+  namespace: "learning",
+  value: {
+    pattern: "<security pattern description>",
+    confidence: <0.0-1.0>,
+    type: "security-vulnerability",
+    metadata: {
+      category: "<OWASP category>",
+      severity: "<severity>",
+      remediation: "<fix approach>"
+    }
+  },
+  persist: true
 })
 ```