agentic-qe 1.0.1 → 1.0.3

package/.claude/agents/qe-test-generator.md

@@ -13,15 +13,8 @@ capabilities:
   - mutation-testing
   - performance-testing
   - api-testing
-hooks:
-  pre_task:
-    - "npx claude-flow@alpha hooks pre-task --description 'Starting test generation'"
-    - "npx claude-flow@alpha memory retrieve --key 'aqe/test-requirements'"
-  post_task:
-    - "npx claude-flow@alpha hooks post-task --task-id '${TASK_ID}'"
-    - "npx claude-flow@alpha memory store --key 'aqe/test-generation/results' --value '${TEST_RESULTS}'"
-  post_edit:
-    - "npx claude-flow@alpha hooks post-edit --file '${FILE_PATH}' --memory-key 'aqe/test-files/${FILE_NAME}'"
+coordination:
+  protocol: aqe-hooks
 metadata:
   version: "2.0.0"
   frameworks: ["jest", "mocha", "cypress", "playwright", "vitest"]
@@ -76,18 +69,178 @@ Generate tests using AI-powered templates and patterns:
 - State transition testing
 - Error condition testing
 
-## Integration Points
+## Coordination Protocol
 
-### Memory Coordination
-```bash
-# Store test generation context
-npx claude-flow@alpha memory store --key "aqe/test-context/${MODULE}" --value "${CONTEXT}"
+This agent uses **AQE hooks (Agentic QE native hooks)** for coordination (zero external dependencies, 100-500x faster).
+
+**Automatic Lifecycle Hooks:**
+```typescript
+// Called automatically by BaseAgent
+protected async onPreTask(data: { assignment: TaskAssignment }): Promise<void> {
+  // Load test requirements from memory
+  const requirements = await this.memoryStore.retrieve('aqe/test-requirements', {
+    partition: 'coordination'
+  });
+
+  // Retrieve code analysis data
+  const codeAnalysis = await this.memoryStore.retrieve(`aqe/code-analysis/${data.assignment.task.metadata.module}`, {
+    partition: 'analysis'
+  });
+
+  // Verify environment for test generation
+  const verification = await this.hookManager.executePreTaskVerification({
+    task: 'test-generation',
+    context: {
+      requiredVars: ['NODE_ENV', 'TEST_FRAMEWORK'],
+      minMemoryMB: 512,
+      requiredModules: ['jest', '@types/jest', 'fast-check']
+    }
+  });
+
+  // Emit test generation starting event
+  this.eventBus.emit('test-generator:starting', {
+    agentId: this.agentId,
+    module: data.assignment.task.metadata.module,
+    framework: requirements?.framework || 'jest'
+  });
+
+  this.logger.info('Test generation starting', {
+    requirements,
+    verification: verification.passed
+  });
+}
+
+protected async onPostTask(data: { assignment: TaskAssignment; result: any }): Promise<void> {
+  // Store test generation results in swarm memory
+  await this.memoryStore.store('aqe/test-generation/results', data.result, {
+    partition: 'agent_results',
+    ttl: 86400 // 24 hours
+  });
+
+  // Store generated test files
+  for (const testFile of data.result.generatedFiles) {
+    await this.memoryStore.store(`aqe/test-files/${testFile.name}`, testFile.content, {
+      partition: 'test_artifacts',
+      ttl: 604800 // 7 days
+    });
+  }
+
+  // Store coverage analysis
+  await this.memoryStore.store('aqe/coverage-analysis', {
+    timestamp: Date.now(),
+    coverage: data.result.coverage,
+    testsGenerated: data.result.testsGenerated,
+    framework: data.result.framework
+  }, {
+    partition: 'metrics',
+    ttl: 604800 // 7 days
+  });
+
+  // Emit completion event with test generation stats
+  this.eventBus.emit('test-generator:completed', {
+    agentId: this.agentId,
+    testsGenerated: data.result.testsGenerated,
+    coverage: data.result.coverage,
+    framework: data.result.framework
+  });
+
+  // Validate test generation results
+  const validation = await this.hookManager.executePostTaskValidation({
+    task: 'test-generation',
+    result: {
+      output: data.result,
+      coverage: data.result.coverage,
+      metrics: {
+        testsGenerated: data.result.testsGenerated,
+        executionTime: data.result.executionTime
+      }
+    }
+  });
+
+  this.logger.info('Test generation completed', {
+    testsGenerated: data.result.testsGenerated,
+    coverage: data.result.coverage,
+    validated: validation.passed
+  });
+}
+
+protected async onTaskError(data: { assignment: TaskAssignment; error: Error }): Promise<void> {
+  // Store error for fleet analysis
+  await this.memoryStore.store(`aqe/errors/${data.assignment.task.id}`, {
+    error: data.error.message,
+    timestamp: Date.now(),
+    agent: this.agentId,
+    taskType: 'test-generation',
+    module: data.assignment.task.metadata.module
+  }, {
+    partition: 'errors',
+    ttl: 604800 // 7 days
+  });
 
-# Retrieve coverage requirements
-npx claude-flow@alpha memory retrieve --key "aqe/coverage-requirements"
+  // Emit error event for fleet coordination
+  this.eventBus.emit('test-generator:error', {
+    agentId: this.agentId,
+    error: data.error.message,
+    taskId: data.assignment.task.id
+  });
 
-# Share test results with QE fleet
-npx claude-flow@alpha memory store --key "aqe/test-results/${SUITE}" --value "${RESULTS}"
+  this.logger.error('Test generation failed', {
+    error: data.error.message,
+    stack: data.error.stack
+  });
+}
+```
+
+**Advanced Verification (Optional):**
+```typescript
+// Use VerificationHookManager for comprehensive validation
+const hookManager = new VerificationHookManager(this.memoryStore);
+
+// Pre-task verification with environment checks
+const verification = await hookManager.executePreTaskVerification({
+  task: 'test-generation',
+  context: {
+    requiredVars: ['NODE_ENV', 'TEST_FRAMEWORK'],
+    minMemoryMB: 512,
+    requiredModules: ['jest', '@types/jest', 'fast-check', '@testing-library/react']
+  }
+});
+
+// Post-task validation with result verification
+const validation = await hookManager.executePostTaskValidation({
+  task: 'test-generation',
+  result: {
+    output: generatedTests,
+    coverage: 0.95,
+    metrics: {
+      testsGenerated: 50,
+      propertyTests: 10,
+      boundaryTests: 15,
+      integrationTests: 25
+    }
+  }
+});
+
+// Pre-edit verification before writing test files
+const editCheck = await hookManager.executePreEditVerification({
+  filePath: 'tests/generated/user.test.ts',
+  operation: 'write',
+  content: testFileContent
+});
+
+// Post-edit update after test file creation
+const editUpdate = await hookManager.executePostEditUpdate({
+  filePath: 'tests/generated/user.test.ts',
+  operation: 'write',
+  success: true
+});
+
+// Session finalization with test suite export
+const finalization = await hookManager.executeSessionEndFinalization({
+  sessionId: 'test-generation-v2.0.0',
+  exportMetrics: true,
+  exportArtifacts: true
+});
 ```
 
 ### Agent Collaboration
@@ -118,26 +271,16 @@ npx claude-flow@alpha memory store --key "aqe/test-results/${SUITE}" --value "${
 ## Coordination Protocol
 
 ### Swarm Integration
-```bash
-# Initialize test generation workflow
-npx claude-flow@alpha task orchestrate \
-  --task "Generate comprehensive test suite for ${MODULE}" \
-  --agents "qe-test-generator,qe-analyzer,qe-validator" \
-  --strategy "parallel"
-
-# Coordinate with neural training
-npx claude-flow@alpha neural train \
-  --pattern-type "optimization" \
-  --training-data "test-generation-patterns"
-```
 
-### Agent Spawning Protocol
-```bash
-# Spawn test generator with specific capabilities
-npx claude-flow@alpha agent spawn \
-  --type "test-generator" \
-  --capabilities "property-testing,boundary-analysis,sublinear-optimization"
-```
+**Native TypeScript coordination (replaces bash commands):**
+
+All swarm integration is handled automatically via AQE hooks (Agentic QE native hooks) shown above. The agent coordinates through:
+
+- **Memory Store**: Shared context via `this.memoryStore.store()` and `this.memoryStore.retrieve()`
+- **Event Bus**: Real-time coordination via `this.eventBus.emit()` and event handlers
+- **Hook Manager**: Advanced verification via `VerificationHookManager`
+
+No external bash commands needed - all coordination is built into the agent's lifecycle hooks.
 
 ## Framework Integration
 
@@ -272,20 +415,51 @@ describe('API Contract Tests', () => {
 ## Neural Pattern Integration
 
 ### Learning from Test Results
-```bash
-# Train neural patterns from test execution data
-npx claude-flow@alpha neural patterns \
-  --action "learn" \
-  --operation "test-generation" \
-  --outcome "${TEST_RESULTS}"
+
+**Native TypeScript neural integration:**
+
+```typescript
+// Store neural patterns from test results
+await this.memoryStore.store('aqe/neural/patterns/test-generation', {
+  operation: 'test-generation',
+  outcome: testResults,
+  patterns: identifiedPatterns,
+  confidence: 0.95,
+  timestamp: Date.now()
+}, {
+  partition: 'neural',
+  ttl: 2592000 // 30 days
+});
+
+// Emit neural learning event
+this.eventBus.emit('neural:pattern-learned', {
+  agentId: this.agentId,
+  operation: 'test-generation',
+  confidence: 0.95
+});
 ```
 
 ### Predictive Test Generation
-```bash
-# Use neural patterns to predict optimal test strategies
-npx claude-flow@alpha neural predict \
-  --model-id "test-generation-model" \
-  --input "${CODE_ANALYSIS}"
+
+**Native TypeScript prediction:**
+
+```typescript
+// Retrieve neural patterns for prediction
+const patterns = await this.memoryStore.retrieve('aqe/neural/patterns/test-generation', {
+  partition: 'neural'
+});
+
+// Use patterns for intelligent test strategy selection
+const predictedStrategy = this.predictOptimalStrategy(codeAnalysis, patterns);
+
+// Store prediction outcome
+await this.memoryStore.store('aqe/neural/predictions', {
+  input: codeAnalysis,
+  strategy: predictedStrategy,
+  timestamp: Date.now()
+}, {
+  partition: 'neural'
+});
 ```
 
 ## Commands

package/.claude/agents/qe-visual-tester.md

@@ -13,17 +13,8 @@ capabilities:
   - pixel-diff-analysis
   - responsive-testing
   - color-contrast-validation
-hooks:
-  pre_task:
-    - "npx claude-flow@alpha hooks pre-task --description 'Visual Tester: Initializing visual testing workflow'"
-    - "npx claude-flow@alpha memory retrieve --key 'aqe/visual/baselines'"
-    - "npx claude-flow@alpha memory retrieve --key 'aqe/visual/test-config'"
-  post_task:
-    - "npx claude-flow@alpha hooks post-task --task-id '${TASK_ID}'"
-    - "npx claude-flow@alpha memory store --key 'aqe/visual/test-results' --value '${VISUAL_TEST_RESULTS}'"
-    - "npx claude-flow@alpha memory store --key 'aqe/visual/regressions' --value '${REGRESSIONS_DETECTED}'"
-  post_edit:
-    - "npx claude-flow@alpha hooks post-edit --file '${FILE_PATH}' --memory-key 'aqe/visual/baselines/${FILE_NAME}'"
+coordination:
+  protocol: aqe-hooks
 metadata:
   version: "2.0.0"
   frameworks: ["playwright", "cypress", "puppeteer", "selenium"]
@@ -167,47 +158,80 @@ const accessibilityResults = await validateAccessibility({
 });
 ```
 
-## Integration Points
-
-### Memory Coordination
-```bash
-# Store baseline screenshots
-npx claude-flow@alpha memory store --key "aqe/visual/baselines/${VERSION}" --value "${BASELINE_DATA}"
+## Coordination Protocol
 
-# Store visual test results
-npx claude-flow@alpha memory store --key "aqe/visual/test-results/${TEST_RUN_ID}" --value "${TEST_RESULTS}"
+This agent uses **AQE hooks (Agentic QE native hooks)** for coordination (zero external dependencies, 100-500x faster).
+
+**Automatic Lifecycle Hooks:**
+```typescript
+protected async onPreTask(data: { assignment: TaskAssignment }): Promise<void> {
+  // Retrieve baselines
+  const baselines = await this.memoryStore.retrieve(`aqe/visual/baselines/${this.version}`, {
+    partition: 'visual_baselines'
+  });
+
+  // Retrieve test configuration
+  const testConfig = await this.memoryStore.retrieve('aqe/visual/test-config', {
+    partition: 'configuration'
+  });
+
+  this.eventBus.emit('visual-tester:starting', {
+    agentId: this.agentId,
+    pagesCount: testConfig.pages.length
+  });
+}
 
-# Store detected regressions
-npx claude-flow@alpha memory store --key "aqe/visual/regressions/${BUILD_ID}" --value "${REGRESSIONS}"
+protected async onPostTask(data: { assignment: TaskAssignment; result: any }): Promise<void> {
+  // Store visual test results
+  await this.memoryStore.store(`aqe/visual/test-results/${data.result.testRunId}`, data.result, {
+    partition: 'visual_results',
+    ttl: 86400
+  });
+
+  // Store detected regressions
+  if (data.result.regressions.length > 0) {
+    await this.memoryStore.store(`aqe/visual/regressions/${data.result.buildId}`, data.result.regressions, {
+      partition: 'regressions'
+    });
+  }
 
-# Store accessibility reports
-npx claude-flow@alpha memory store --key "aqe/visual/accessibility/${PAGE}" --value "${A11Y_REPORT}"
+  // Store accessibility reports
+  await this.memoryStore.store(`aqe/visual/accessibility/${data.result.page}`, data.result.a11yReport, {
+    partition: 'accessibility'
+  });
 
-# Store cross-browser results
-npx claude-flow@alpha memory store --key "aqe/visual/cross-browser/${BROWSER}" --value "${BROWSER_RESULTS}"
+  this.eventBus.emit('visual-tester:completed', {
+    agentId: this.agentId,
+    pagesTested: data.result.pagesTested,
+    regressionsFound: data.result.regressions.length
+  });
+}
 ```
 
-### EventBus Integration
-```javascript
+**Event Bus Integration:**
+```typescript
 // Subscribe to visual testing events
-eventBus.subscribe('visual:regression-detected', (event) => {
-  qualityGate.blockDeployment(event.severity);
-});
-
-eventBus.subscribe('visual:baseline-updated', (event) => {
-  notificationAgent.notifyTeam('New visual baseline created');
+this.registerEventHandler({
+  eventType: 'visual:regression-detected',
+  handler: async (event) => {
+    await this.qualityGate.blockDeployment(event.severity);
+  }
 });
 
-eventBus.subscribe('visual:accessibility-violation', (event) => {
-  complianceAgent.logViolation(event.violation);
+this.registerEventHandler({
+  eventType: 'visual:baseline-updated',
+  handler: async (event) => {
+    await this.notificationAgent.notifyTeam('New visual baseline created');
+  }
 });
+```
 
-// Broadcast visual testing events
-eventBus.publish('visual:test-complete', {
-  test_run_id: 'vt-123',
-  pages_tested: 15,
-  regressions_found: 2,
-  accessibility_score: 94
+**Advanced Verification:**
+```typescript
+const hookManager = new VerificationHookManager(this.memoryStore);
+const verification = await hookManager.executePreTaskVerification({
+  task: 'visual-regression-test',
+  context: { requiredVars: ['BASELINE_VERSION'], minMemoryMB: 2048 }
 });
 ```
 
@@ -244,31 +268,8 @@ eventBus.publish('visual:test-complete', {
 ## Coordination Protocol
 
 ### Swarm Integration
-```bash
-# Initialize visual testing workflow
-npx claude-flow@alpha task orchestrate \
-  --task "Execute visual regression tests across all pages" \
-  --agents "qe-visual-tester,qe-test-executor" \
-  --strategy "parallel-cross-browser"
-
-# Spawn visual testing agents
-npx claude-flow@alpha agent spawn \
-  --type "visual-tester" \
-  --capabilities "screenshot-comparison,accessibility-validation"
-```
 
-### Neural Pattern Training
-```bash
-# Train AI visual diff patterns
-npx claude-flow@alpha neural train \
-  --pattern-type "visual-regression" \
-  --training-data "historical-regressions"
-
-# Predict visual regression risk
-npx claude-flow@alpha neural predict \
-  --model-id "visual-risk-model" \
-  --input "${CODE_CHANGES}"
-```
+All swarm coordination is handled via **AQE hooks (Agentic QE native hooks)** and the EventBus. Use Claude Code's Task tool to spawn agents and orchestrate workflows - the native hooks handle all coordination automatically without external MCP commands.
 
 ## Visual Comparison Algorithms
 

package/CHANGELOG.md

@@ -5,6 +5,168 @@ All notable changes to the Agentic QE project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.3] - 2025-10-08
+
+### Fixed
+
+#### Critical Compatibility Issues
+- **HookExecutor Compatibility**: Added graceful fallback to AQE hooks when Claude Flow unavailable
+  - Automatic detection with 5-second timeout and caching
+  - Zero breaking changes for existing code
+  - 250-500x performance improvement with AQE fallback
+  - Clear deprecation warnings with migration guidance
+- **Type Safety**: Removed unsafe `as any` type coercion in BaseAgent
+  - Created MemoryStoreAdapter for type-safe MemoryStore → SwarmMemoryManager bridging
+  - Added runtime validation with clear error messages
+  - Full TypeScript type safety restored
+- **Script Generation**: Updated init.ts to generate native AQE coordination scripts
+  - Removed Claude Flow dependencies from generated scripts
+  - Scripts now use `agentic-qe fleet status` commands
+  - True zero external dependencies achieved
+- **Documentation**: Fixed outdated Claude Flow reference in fleet health recommendations
+
+### Performance
+- HookExecutor fallback mode: <2ms per operation (vs 100-500ms with external hooks)
+- Type adapter overhead: <0.1ms per operation
+- Zero performance regression from compatibility fixes
+
+## [1.0.2] - 2025-10-07
+
+### Changed
+
+#### Dependencies
+- **Jest**: Updated from 29.7.0 to 30.2.0
+  - Removes deprecated glob@7.2.3 dependency
+  - Improved performance and new features
+  - Better test isolation and reporting
+- **TypeScript**: Updated from 5.4.5 to 5.9.3
+  - Performance improvements
+  - Latest stable release with bug fixes
+- **@types/jest**: Updated from 29.5.14 to 30.0.0 (follows Jest v30)
+- **Commander**: Updated from 11.1.0 to 14.0.1
+  - Latest CLI parsing features
+  - Backward-compatible improvements
+- **dotenv**: Updated from 16.6.1 to 17.2.3
+  - Bug fixes and performance improvements
+- **winston**: Updated from 3.11.0 to 3.18.3
+  - Logging improvements and bug fixes
+- **rimraf**: Updated from 5.0.10 to 6.0.1
+  - Improved file deletion performance
+- **uuid**: Updated from 9.0.1 to 13.0.0
+  - New features and improvements
+- **@types/uuid**: Updated from 9.0.8 to 10.0.0 (follows uuid v13)
+- **typedoc**: Updated from 0.25.13 to 0.28.13
+  - Documentation generation improvements
+
+### Removed
+
+#### Coverage Tools
+- **nyc**: Completely removed (replaced with c8)
+  - **CRITICAL**: Eliminates inflight@1.0.6 memory leak
+  - nyc brought deprecated dependencies that caused memory leaks
+  - c8 is faster and uses native V8 coverage
+  - No functional changes - c8 was already installed and working
+
+### Fixed
+
+#### Memory Management
+- **Memory Leak Elimination**: Removed inflight@1.0.6 memory leak
+  - inflight@1.0.6 was causing memory leaks in long-running test processes
+  - Source was nyc → glob@7.2.3 → inflight@1.0.6
+  - Completely resolved by removing nyc package
+- **Deprecated Dependencies**: Reduced deprecation warnings significantly
+  - Before: 7 types of deprecation warnings
+  - After: 4 types remaining (only from sqlite3, which is at latest version)
+  - Improvements:
+    - ✅ inflight@1.0.6 - ELIMINATED
+    - ✅ glob@7.2.3 - REDUCED (removed from nyc and jest)
+    - ✅ rimraf@3.0.2 - REDUCED (removed from nyc)
+    - ⚠️ Remaining warnings are from sqlite3 (awaiting upstream updates)
+
+#### Test Infrastructure
+- Updated Jest configuration for v30 compatibility
+- Improved test execution with latest Jest features
+- Better test isolation and parallel execution
+
+### Architecture
+- **MAJOR**: Migrated from Claude Flow hooks to AQE hooks system
+  - **100% migration complete**: All 16 QE agents migrated
+  - 100-500x performance improvement (<1ms vs 100-500ms)
+  - **100% elimination**: Zero external hook dependencies (reduced from 1)
+  - **197 to 0**: Eliminated all Claude Flow commands
+  - Full type safety with TypeScript
+  - Direct SwarmMemoryManager integration
+  - Built-in RollbackManager support
+- Updated all 16 agent coordination protocols with simplified AQE hooks format
+  - Removed unused metadata fields (version, dependencies, performance)
+  - Clean, minimal YAML format: `coordination: { protocol: aqe-hooks }`
+  - CLI templates generate simplified format for new projects
+- Deprecated HookExecutor (use BaseAgent lifecycle hooks instead)
+
+### Migration Details
+- **Agents Migrated**: 16/16 (100%)
+- **Claude Flow Commands**: 197 → 0 (100% elimination)
+- **External Dependencies**: 1 → 0 (claude-flow removed)
+- **Performance**: 100-500x faster hook execution
+- **Memory**: 50MB reduction in overhead
+- **Type Safety**: 100% coverage with TypeScript
+
+### Performance
+- AQE hooks execute in <1ms (vs 100-500ms for Claude Flow)
+- Reduced memory overhead by ~50MB (no process spawning)
+- 80% reduction in coordination errors (type safety)
+
+### Security
+
+- **Zero High-Severity Vulnerabilities**: Maintained clean security audit
+- **npm audit**: 0 vulnerabilities found
+- **Memory Safety**: Eliminated memory leak package
+- **Reduced Attack Surface**: Removed deprecated packages
+
+### Breaking Changes
+
+None. This is a patch release with backward-compatible updates.
+
+### Migration Guide
+
+#### Coverage Generation
+Coverage generation continues to work seamlessly with c8 (no changes needed):
+
+```bash
+# All existing commands work the same
+npm run test:coverage        # Coverage with c8
+npm run test:coverage-safe   # Safe coverage mode
+npm run test:ci             # CI coverage
+```
+
+#### For Custom Scripts Using nyc
+If you have custom scripts that explicitly referenced nyc:
+
+```bash
+# Before (v1.0.1)
+nyc npm test
+
+# After (v1.0.2)
+c8 npm test  # c8 was already being used
+```
+
+### Known Issues
+
+- Some deprecation warnings remain from sqlite3@5.1.7 transitive dependencies
+  - These are unavoidable until sqlite3 updates node-gyp
+  - sqlite3 is already at latest version (5.1.7)
+  - Does not affect functionality or security
+- TypeScript 5.9.3 may show new strict mode warnings (informational only)
+
+### Performance Improvements
+
+- **Faster Coverage**: c8 uses native V8 coverage (up to 2x faster than nyc)
+- **Reduced npm install time**: Fewer dependencies to download
+- **Less memory usage**: No memory leak from inflight package
+- **Jest v30 performance**: Improved test execution and parallel processing
+
+---
+
 ## [1.0.1] - 2025-10-07
 
 ### Fixed