agentic-qe 1.3.5 → 1.3.6

package/.claude/agents/qe-code-complexity.md

@@ -0,0 +1,291 @@
+---
+name: qe-code-complexity
+version: 1.0.0
+description: Educational code complexity analyzer demonstrating the Agentic QE Fleet architecture
+tags: [quality-engineering, complexity-analysis, refactoring, learning-example]
+capabilities: [complexity-analysis, refactoring-recommendations, pattern-detection]
+type: quality-analyzer
+---
+
+# QE Code Complexity Analyzer
+
+## Overview
+
+The Code Complexity Analyzer is an **educational agent** that demonstrates the complete Agentic QE Fleet architecture. It analyzes code complexity metrics and provides AI-powered refactoring recommendations.
+
+**Purpose**: Learning tool to understand how agents work in the AQE fleet.
+
+## Capabilities
+
+### 1. Complexity Analysis
+- **Cyclomatic Complexity**: Measures decision point density
+- **Cognitive Complexity**: Accounts for nesting and control flow
+- **File Size Analysis**: Identifies overly large files
+- **Function Metrics**: Tracks function count and average complexity
+
+### 2. Refactoring Recommendations
+- AI-powered suggestions based on detected patterns
+- Severity-based prioritization (low, medium, high, critical)
+- Specific actionable advice (e.g., "Extract Method", "Reduce Nesting")
+
+### 3. Quality Scoring
+- Holistic quality score (0-100)
+- Issue-based deductions
+- Helps prioritize refactoring efforts
+
+## Key Learning Concepts
+
+### BaseAgent Pattern
+```typescript
+// All agents extend BaseAgent
+export class CodeComplexityAnalyzerAgent extends BaseAgent {
+  // Define capabilities in constructor
+  constructor(config: CodeComplexityConfig) {
+    super({
+      ...config,
+      type: QEAgentType.QUALITY_ANALYZER,
+      capabilities: [/* ... */]
+    });
+  }
+}
+```
+
+### Lifecycle Hooks
+```typescript
+// Pre-task: Load context before work
+protected async onPreTask(data: { assignment: any }): Promise<void> {
+  const history = await this.memoryStore.retrieve('aqe/complexity/.../history');
+  // Use historical data to improve analysis
+}
+
+// Post-task: Store results and coordinate
+protected async onPostTask(data: PostTaskData): Promise<void> {
+  await this.memoryStore.store('aqe/complexity/.../results', data.result);
+  this.eventBus.emit('complexity:analysis:completed', { ... });
+}
+
+// Error handling: Learn from failures
+protected async onTaskError(data: { assignment: any; error: Error }): Promise<void> {
+  await this.memoryStore.store('aqe/complexity/.../errors/...', { ... });
+}
+```
+
+### Memory System
+```typescript
+// Store results for other agents
+await this.memoryStore.store(
+  'aqe/complexity/${agentId}/latest-result',
+  result,
+  86400 // 24 hour TTL
+);
+
+// Retrieve for coordination
+const previous = await this.memoryStore.retrieve(
+  'aqe/complexity/${agentId}/history'
+);
+```
+
+### Event-Driven Architecture
+```typescript
+// Emit events for coordination
+this.eventBus.emit('complexity:analysis:completed', {
+  agentId: this.agentId,
+  result: analysisResult,
+  timestamp: new Date()
+});
+
+// Other agents can subscribe
+eventBus.on('complexity:analysis:completed', (event) => {
+  // Test generator could prioritize complex code
+  // Coverage analyzer could focus on complex functions
+});
+```
+
+## Usage Examples
+
+### From Claude Code CLI
+
+```bash
+# Analyze a single file
+claude "Use qe-code-complexity to analyze src/services/order-processor.ts"
+
+# Analyze multiple files
+claude "Run complexity analysis on all files in src/services/"
+
+# Get refactoring recommendations
+claude "Analyze src/utils/validator.ts and suggest refactorings"
+```
+
+### Via TypeScript
+
+```typescript
+import { CodeComplexityAnalyzerAgent } from './agents/CodeComplexityAnalyzerAgent';
+
+// Initialize agent
+const agent = new CodeComplexityAnalyzerAgent({
+  type: QEAgentType.QUALITY_ANALYZER,
+  capabilities: [],
+  context: { /* ... */ },
+  memoryStore,
+  eventBus,
+  thresholds: {
+    cyclomaticComplexity: 10,
+    cognitiveComplexity: 15,
+    linesOfCode: 300
+  },
+  enableRecommendations: true
+});
+
+await agent.initialize();
+
+// Analyze code
+const result = await agent.analyzeComplexity({
+  files: [{
+    path: 'complex.ts',
+    content: sourceCode,
+    language: 'typescript'
+  }]
+});
+
+console.log('Quality Score:', result.score);
+console.log('Issues:', result.issues);
+console.log('Recommendations:', result.recommendations);
+```
+
+## Configuration
+
+### Thresholds
+
+Customize complexity thresholds:
+
+```typescript
+{
+  thresholds: {
+    cyclomaticComplexity: 10,  // Default: 10
+    cognitiveComplexity: 15,   // Default: 15
+    linesOfCode: 300           // Default: 300
+  }
+}
+```
+
+### Features
+
+```typescript
+{
+  enableRecommendations: true,  // Default: true
+  enableLearning: true          // Default: false (demo uses false)
+}
+```
+
+## Integration with Other Agents
+
+### Test Generator
+The test-generator agent can use complexity analysis to:
+- Prioritize complex functions for testing
+- Generate more comprehensive tests for high-complexity code
+- Focus on edge cases in nested logic
+
+```typescript
+eventBus.on('complexity:analysis:completed', async (event) => {
+  if (event.result.issues.some(i => i.severity === 'critical')) {
+    // Test generator: Create extra tests for critical complexity
+    await testGeneratorAgent.generateTests({
+      focusAreas: event.result.issues
+        .filter(i => i.severity === 'critical')
+        .map(i => i.file)
+    });
+  }
+});
+```
+
+### Coverage Analyzer
+The coverage-analyzer can use complexity data to:
+- Ensure high-complexity code has high coverage
+- Identify risk areas (high complexity + low coverage)
+
+### Quality Gate
+The quality-gate can use complexity metrics as criteria:
+- Fail builds with critical complexity issues
+- Track complexity trends over time
+- Prevent complexity regressions
+
+## Example Output
+
+```
+Quality Score: 65/100
+
+⚠️  Issues Detected:
+  1. [HIGH] cyclomatic
+     Current: 23, Threshold: 10
+     Consider breaking down complex logic into smaller functions
+
+  2. [MEDIUM] cognitive
+     Current: 18, Threshold: 15
+     Reduce nesting levels and simplify control flow
+
+💡 Recommendations:
+  1. Apply Extract Method refactoring to reduce cyclomatic complexity
+  2. Use early returns to reduce nesting levels
+  3. Extract nested loops into separate methods
+```
+
+## Learning Objectives
+
+By studying this agent, you'll learn:
+
+1. ✅ **BaseAgent Pattern**: How to extend and customize agents
+2. ✅ **Lifecycle Hooks**: Pre-task, post-task, and error handling
+3. ✅ **Memory System**: Storing and retrieving agent data
+4. ✅ **Event System**: Coordinating multiple agents
+5. ✅ **Testing Patterns**: Comprehensive test coverage
+6. ✅ **Agent Coordination**: How agents work together
+
+## Running the Example
+
+```bash
+# Run the demo
+npx ts-node examples/complexity-analysis/demo.ts
+
+# Run tests
+npm test tests/agents/CodeComplexityAnalyzerAgent.test.ts
+```
+
+## Architecture Insights
+
+### Memory Namespace
+- `aqe/complexity/${agentId}/current-request` - Active analysis request
+- `aqe/complexity/${agentId}/latest-result` - Most recent result
+- `aqe/complexity/${agentId}/history` - Historical analyses (last 100)
+- `aqe/complexity/${agentId}/errors/*` - Error tracking
+
+### Events Emitted
+- `complexity:analysis:completed` - When analysis finishes successfully
+- `complexity:analysis:stored` - When results are persisted
+
+### Capabilities Provided
+- `complexity-analysis` - Core analysis functionality
+- `refactoring-recommendations` - AI-powered suggestions
+- `pattern-detection` - Complex code pattern recognition
+
+## Next Steps
+
+After understanding this agent, explore:
+- **TestGeneratorAgent**: See how it generates tests
+- **CoverageAnalyzerAgent**: Learn about O(log n) gap detection
+- **FleetManager**: Understand multi-agent coordination
+- **LearningEngine**: Discover how agents improve over time
+
+## Resources
+
+- **Source Code**: `src/agents/CodeComplexityAnalyzerAgent.ts`
+- **Tests**: `tests/agents/CodeComplexityAnalyzerAgent.test.ts`
+- **Demo**: `examples/complexity-analysis/demo.ts`
+- **BaseAgent**: `src/agents/BaseAgent.ts`
+
+---
+
+**Educational Agent**: This agent is designed for learning. For production complexity analysis, consider:
+- ESLint with complexity rules
+- SonarQube
+- CodeClimate
+- Commercial static analysis tools

package/.claude/settings.json

@@ -145,9 +145,9 @@
     ]
   },
   "includeCoAuthoredBy": true,
-  "enabledMcpjsonServers": ["claude-flow", "ruv-swarm"],
+  "enabledMcpjsonServers": ["claude-flow", "ruv-swarm", "agentic-qe"],
   "statusLine": {
     "type": "command",
-    "command": ".claude/statusline-agentdb.sh"
+    "command": ".claude/statusline-command.sh"
   }
 }

package/CHANGELOG.md

@@ -5,6 +5,43 @@ 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.3.6] - 2025-10-30
+
+### 🔒 Security & UX Improvements
+
+#### Security Fixes
+- **eval() Removal**: Replaced unsafe `eval()` in TestDataArchitectAgent with safe expression evaluator
+  - Supports comparison operators (===, !==, ==, !=, >=, <=, >, <)
+  - Supports logical operators (&&, ||)
+  - Eliminates arbitrary code execution vulnerability
+  - File: `src/agents/TestDataArchitectAgent.ts`
+
+#### UX Enhancements
+- **CLAUDE.md Append Strategy**: User-friendly placement of AQE instructions
+  - Interactive mode: Prompts user to choose prepend or append
+  - `--yes` mode: Defaults to append (less disruptive)
+  - Clear visual separator (---) between sections
+  - Backup existing CLAUDE.md automatically
+  - File: `src/cli/commands/init.ts`
+
+- **CLI Skills Count Fix**: Accurate display of installed skills
+  - Dynamic counting instead of hardcoded values
+  - Now shows correct "34/34" instead of "8/17"
+  - Future-proof (auto-updates when skills added)
+  - File: `src/cli/commands/skills/index.ts`
+
+#### Additional Improvements
+- **CodeComplexityAnalyzerAgent**: Cherry-picked from PR #22 with full integration
+- **TypeScript Compilation**: All errors resolved (0 compilation errors)
+- **Documentation**: Comprehensive fix reports and verification
+
+### Testing
+- ✅ TypeScript compilation: 0 errors
+- ✅ All three fixes verified and working
+- ✅ Backward compatible changes only
+
+---
+
 ## [1.3.5] - 2025-10-27
 
 ### ✨ Features Complete - Production Ready Release

package/README.md

@@ -7,7 +7,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg)](https://nodejs.org/)
 
-**Version 1.3.5** | [Changelog](CHANGELOG.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
+**Version 1.3.6** | [Changelog](CHANGELOG.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
 
 > Enterprise-grade test automation with AI learning, comprehensive skills library (34 QE skills), and 85.7% cost savings through intelligent model routing.
 
@@ -30,7 +30,7 @@ cd your-project
 aqe init
 
 # Add MCP server to Claude Code (optional)
-claude mcp add agentic-qe npx -y agentic-qe mcp:start
+claude mcp add agentic-qe npx aqe-mcp
 
 # Verify connection
 claude mcp list
@@ -501,6 +501,31 @@ Model Usage:
 
 ## 📝 Recent Changes
 
+### v1.3.6 (2025-10-30)
+**Stability & Educational Release**
+
+- ✅ **Fixed 16 critical TypeScript compilation errors** blocking production builds
+- ✅ **Integrated CodeComplexityAnalyzerAgent** (educational example from PR #22 by @mondweep)
+- ✅ **Zero functional regressions** - all core functionality tested and stable
+- ✅ **Build stability improvements** - TypeScript compilation passing with 0 errors
+- ✅ **BaseAgent property encapsulation** - proper lifecycle manager integration
+- ✅ **Clean cherry-pick** from PR #22 with zero conflicts
+
+**Technical Improvements**:
+- BaseAgent property access patterns now use lifecycle manager accessors
+- AccessControlDAO interface mapping corrected (`resourceId`, `owner` properties)
+- Permission enum usage standardized (READ, WRITE, DELETE, SHARE)
+- AgentLifecycleManager and AgentCoordinator properly integrated
+
+**New Capabilities**:
+- 📊 Code complexity analysis agent (cyclomatic & cognitive complexity)
+- 🎯 Quality scoring system (0-100 scale)
+- 🤖 AI-powered refactoring recommendations
+- 📚 Complete BaseAgent pattern demonstration
+- 📖 463-line architecture guide for learning
+
+**Contributors**: @mondweep (CodeComplexityAnalyzerAgent), AQE Development Team
+
 ### v1.3.5 (2025-10-27) - Learning System Complete & Critical Policies
 
 **Phase 2 Features Complete:**

package/dist/agents/BaseAgent.d.ts

@@ -10,6 +10,9 @@ import { PerformanceTracker } from '../learning/PerformanceTracker';
 import { LearningEngine } from '../learning/LearningEngine';
 import { LearningConfig, StrategyRecommendation } from '../learning/types';
 import { AgentDBManager, AgentDBConfig } from '../core/memory/AgentDBManager';
+import { AgentLifecycleManager } from './lifecycle/AgentLifecycleManager';
+import { AgentCoordinator } from './coordination/AgentCoordinator';
+import { AgentMemoryService } from './memory/AgentMemoryService';
 export interface BaseAgentConfig {
     id?: string;
     type: AgentType;
@@ -28,12 +31,10 @@ export interface BaseAgentConfig {
 }
 export declare abstract class BaseAgent extends EventEmitter {
     protected readonly agentId: AgentId;
-    protected status: AgentStatus;
     protected readonly capabilities: Map<string, AgentCapability>;
     protected readonly context: AgentContext;
     protected readonly memoryStore: MemoryStore;
     protected readonly eventBus: EventEmitter;
-    protected readonly eventHandlers: Map<string, EventHandler[]>;
     protected currentTask?: TaskAssignment;
     protected hookManager: VerificationHookManager;
     protected performanceTracker?: PerformanceTracker;
@@ -49,6 +50,9 @@ export declare abstract class BaseAgent extends EventEmitter {
         lastActivity: Date;
     };
     private taskStartTime?;
+    protected readonly lifecycleManager: AgentLifecycleManager;
+    protected readonly coordinator: AgentCoordinator;
+    protected readonly memoryService: AgentMemoryService;
     constructor(config: BaseAgentConfig);
     /**
      * Initialize the agent - must be called after construction

package/dist/agents/BaseAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EACL,OAAO,EACP,WAAW,IAAI,SAAS,EACxB,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,cAAc,EAGd,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAwB,MAAM,+BAA+B,CAAC;AAEpG,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAGvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CAC7D;AAED,8BAAsB,SAAU,SAAQ,YAAY;IAClD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IACpC,SAAS,CAAC,MAAM,EAAE,WAAW,CAA4B;IACzD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAa;IAC1E,SAAS,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC/C,SAAS,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAClD,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAC3C,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IACnC,SAAS,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,SAAS,CAAC,kBAAkB,EAAE;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,IAAI,CAAC;KACpB,CAKC;IACF,OAAO,CAAC,aAAa,CAAC,CAAS;gBAEnB,MAAM,EAAE,eAAe;IAiDnC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDxC;;OAEG;IACU,WAAW,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAsDlE;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CvC;;OAEG;IACI,SAAS,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,WAAW,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,kBAAkB,EAAE;YAClB,cAAc,EAAE,MAAM,CAAC;YACvB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,EAAE,IAAI,CAAC;SACpB,CAAC;KACH;IAUD;;OAEG;IACI,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACI,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzE;;OAEG;IACI,eAAe,IAAI,eAAe,EAAE;IAI3C;;OAEG;IACU,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAUtF;;OAEG;IACI,kBAAkB;IAIzB;;OAEG;IACI,iBAAiB;;;;;;IAUxB;;;;OAIG;IACU,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7E;;OAEG;IACU,gBAAgB;;;;;;;;;IAiB7B;;OAEG;IACI,UAAU,IAAI,OAAO;IAI5B;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACU,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAExD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3C;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAQvE;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAqB,GAAG,IAAI;IAc/G;;;OAGG;cACa,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3E;;OAEG;cACa,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjF;;OAEG;cACa,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASzD;;OAEG;cACa,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvF;;OAEG;cACa,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAarF;;;;;OAKG;cACa,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAgG3D;;;;;OAKG;cACa,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuJ7D;;;;;OAKG;cACa,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YAyGjD,WAAW;IAezB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,wBAAwB;YAelB,eAAe;YAQf,YAAY;YAYZ,SAAS;YAWT,YAAY;IAa1B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;IAIzB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAsB5B;AAMD,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,iBAAiB,IAAI,SAAS,EAAE,CAAC;IACjC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAAC;CACrD;AAED,8BAAsB,gBAAiB,YAAW,YAAY;IAC5D,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAClF,QAAQ,CAAC,iBAAiB,IAAI,SAAS,EAAE;IACzC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE;CAC7D"}
+{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/BaseAgent.js

@@ -15,11 +15,12 @@ const PerformanceTracker_1 = require("../learning/PerformanceTracker");
 const SwarmMemoryManager_1 = require("../core/memory/SwarmMemoryManager");
 const LearningEngine_1 = require("../learning/LearningEngine");
 const AgentDBManager_1 = require("../core/memory/AgentDBManager");
+const AgentLifecycleManager_1 = require("./lifecycle/AgentLifecycleManager");
+const AgentCoordinator_1 = require("./coordination/AgentCoordinator");
+const AgentMemoryService_1 = require("./memory/AgentMemoryService");
 class BaseAgent extends events_1.EventEmitter {
     constructor(config) {
         super();
-        this.status = types_1.AgentStatus.INITIALIZING;
-        this.eventHandlers = new Map();
         this.performanceMetrics = {
             tasksCompleted: 0,
             averageExecutionTime: 0,
@@ -58,6 +59,17 @@ class BaseAgent extends events_1.EventEmitter {
         // Provides runtime validation and clear error messages for incompatible implementations
         const memoryAdapter = new MemoryStoreAdapter_1.MemoryStoreAdapter(this.memoryStore);
         this.hookManager = new hooks_1.VerificationHookManager(memoryAdapter);
+        // Initialize integrated service classes
+        this.lifecycleManager = new AgentLifecycleManager_1.AgentLifecycleManager(this.agentId);
+        this.coordinator = new AgentCoordinator_1.AgentCoordinator({
+            agentId: this.agentId,
+            eventBus: this.eventBus,
+            memoryStore: this.memoryStore
+        });
+        this.memoryService = new AgentMemoryService_1.AgentMemoryService({
+            agentId: this.agentId,
+            memoryStore: this.memoryStore
+        });
         this.setupEventHandlers();
         this.setupLifecycleHooks();
     }
@@ -69,36 +81,43 @@ class BaseAgent extends events_1.EventEmitter {
      */
     async initialize() {
         try {
-            this.status = types_1.AgentStatus.INITIALIZING;
-            // Execute pre-initialization hooks
-            await this.executeHook('pre-initialization');
-            // Load agent knowledge and state
-            await this.loadKnowledge();
-            await this.restoreState();
-            // Initialize PerformanceTracker if learning is enabled
-            if (this.enableLearning && this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
-                this.performanceTracker = new PerformanceTracker_1.PerformanceTracker(this.agentId.id, this.memoryStore);
-                await this.performanceTracker.initialize();
-                // Initialize learning engine for Q-learning
-                this.learningEngine = new LearningEngine_1.LearningEngine(this.agentId.id, this.memoryStore, this.learningConfig);
-                await this.learningEngine.initialize();
-            }
-            // Initialize AgentDB if configured
-            if (this.agentDBConfig) {
-                await this.initializeAgentDB(this.agentDBConfig);
-            }
-            // Initialize agent-specific components
-            await this.initializeComponents();
-            // Execute post-initialization hooks
-            await this.executeHook('post-initialization');
-            this.status = types_1.AgentStatus.ACTIVE;
-            this.emitEvent('agent.initialized', { agentId: this.agentId });
-            // Report initialization to coordination system
-            await this.reportStatus('initialized');
+            // Delegate lifecycle initialization to lifecycleManager
+            await this.lifecycleManager.initialize({
+                onPreInitialization: async () => {
+                    await this.executeHook('pre-initialization');
+                },
+                onPostInitialization: async () => {
+                    // Load agent knowledge and state
+                    await this.loadKnowledge();
+                    const savedState = await this.memoryService.restoreState();
+                    if (savedState && savedState.performanceMetrics) {
+                        this.performanceMetrics = { ...this.performanceMetrics, ...savedState.performanceMetrics };
+                    }
+                    // Initialize PerformanceTracker if learning is enabled
+                    if (this.enableLearning && this.memoryStore instanceof SwarmMemoryManager_1.SwarmMemoryManager) {
+                        this.performanceTracker = new PerformanceTracker_1.PerformanceTracker(this.agentId.id, this.memoryStore);
+                        await this.performanceTracker.initialize();
+                        // Initialize learning engine for Q-learning
+                        this.learningEngine = new LearningEngine_1.LearningEngine(this.agentId.id, this.memoryStore, this.learningConfig);
+                        await this.learningEngine.initialize();
+                    }
+                    // Initialize AgentDB if configured
+                    if (this.agentDBConfig) {
+                        await this.initializeAgentDB(this.agentDBConfig);
+                    }
+                    // Initialize agent-specific components
+                    await this.initializeComponents();
+                    // Execute post-initialization hooks
+                    await this.executeHook('post-initialization');
+                    this.coordinator.emitEvent('agent.initialized', { agentId: this.agentId });
+                    // Report initialization to coordination system
+                    await this.coordinator.reportStatus('initialized', this.performanceMetrics);
+                }
+            });
         }
         catch (error) {
-            this.status = types_1.AgentStatus.ERROR;
-            this.emitEvent('agent.error', { agentId: this.agentId, error });
+            this.lifecycleManager.markError(`Initialization failed: ${error}`);
+            this.coordinator.emitEvent('agent.error', { agentId: this.agentId, error });
             throw error;
         }
     }
@@ -111,13 +130,13 @@ class BaseAgent extends events_1.EventEmitter {
             // Validate task assignment
             this.validateTaskAssignment(assignment);
             this.currentTask = assignment;
-            this.status = types_1.AgentStatus.ACTIVE;
+            this.lifecycleManager.markActive();
             // Execute pre-task hooks with verification
             const preTaskData = { assignment };
             await this.onPreTask(preTaskData);
             await this.executeHook('pre-task', preTaskData);
             // Broadcast task start
-            await this.broadcastMessage('task-start', assignment);
+            await this.coordinator.broadcastMessage('task-start', assignment);
             // Execute the actual task
             const result = await this.performTask(assignment.task);
             // Execute post-task hooks with validation
@@ -127,15 +146,15 @@ class BaseAgent extends events_1.EventEmitter {
             // Update performance metrics
             this.updatePerformanceMetrics(startTime, true);
             // Store task completion in memory
-            await this.storeTaskResult(assignment.id, result);
+            await this.memoryService.storeTaskResult(assignment.id, result);
             this.currentTask = undefined;
-            this.status = types_1.AgentStatus.IDLE;
+            this.lifecycleManager.markIdle();
             return result;
         }
         catch (error) {
             this.updatePerformanceMetrics(startTime, false);
             this.currentTask = undefined;
-            this.status = types_1.AgentStatus.ERROR;
+            this.lifecycleManager.markError(`Task execution failed: ${error}`);
             // Execute error hooks
             const errorData = {
                 assignment,
@@ -151,7 +170,7 @@ class BaseAgent extends events_1.EventEmitter {
      */
     async terminate() {
         try {
-            this.status = types_1.AgentStatus.TERMINATING;
+            this.lifecycleManager.setStatus(types_1.AgentStatus.TERMINATING);
             // Execute pre-termination hooks
             await this.executeHook('pre-termination');
             // Close AgentDB if enabled
@@ -163,22 +182,17 @@ class BaseAgent extends events_1.EventEmitter {
             await this.saveState();
             // Clean up agent-specific resources
             await this.cleanup();
-            // Remove all event handlers from EventBus
-            for (const [eventType, handlers] of this.eventHandlers.entries()) {
-                for (const handler of handlers) {
-                    this.eventBus.off(eventType, handler.handler);
-                }
-            }
-            this.eventHandlers.clear();
+            // Remove all event handlers from EventBus using coordinator
+            this.coordinator.clearAllHandlers();
             // Execute post-termination hooks
             await this.executeHook('post-termination');
-            this.status = types_1.AgentStatus.TERMINATED;
+            this.lifecycleManager.setStatus(types_1.AgentStatus.TERMINATED);
             this.emitEvent('agent.terminated', { agentId: this.agentId });
             // Remove all listeners from this agent (EventEmitter)
             this.removeAllListeners();
         }
         catch (error) {
-            this.status = types_1.AgentStatus.ERROR;
+            this.lifecycleManager.setStatus(types_1.AgentStatus.ERROR);
             throw error;
         }
     }
@@ -188,7 +202,7 @@ class BaseAgent extends events_1.EventEmitter {
     getStatus() {
         return {
             agentId: this.agentId,
-            status: this.status,
+            status: this.lifecycleManager.getStatus(),
             currentTask: this.currentTask?.id,
             capabilities: Array.from(this.capabilities.keys()),
             performanceMetrics: { ...this.performanceMetrics }
@@ -325,10 +339,7 @@ class BaseAgent extends events_1.EventEmitter {
      * Register an event handler
      */
     registerEventHandler(handler) {
-        const handlers = this.eventHandlers.get(handler.eventType) || [];
-        handlers.push(handler);
-        this.eventHandlers.set(handler.eventType, handlers);
-        this.eventBus.on(handler.eventType, handler.handler);
+        this.coordinator.registerEventHandler(handler);
     }
     /**
      * Emit an event
@@ -763,7 +774,7 @@ class BaseAgent extends events_1.EventEmitter {
     setupLifecycleHooks() {
         // Setup default lifecycle behavior
         this.on('error', (error) => {
-            this.status = types_1.AgentStatus.ERROR;
+            this.lifecycleManager.setStatus(types_1.AgentStatus.ERROR);
             this.emitEvent('agent.error', { agentId: this.agentId, error });
         });
     }