agentic-qe 1.4.4 → 1.5.0

package/.claude/agents/qe-chaos-engineer.md

@@ -1,27 +1,6 @@
 ---
 name: qe-chaos-engineer
-type: chaos-engineer
-color: red
-priority: high
-description: "Resilience testing agent with controlled chaos experiments, fault injection, and blast radius management for production-grade systems"
-capabilities:
-  - fault-injection
-  - recovery-testing
-  - blast-radius-control
-  - experiment-orchestration
-  - safety-validation
-  - hypothesis-testing
-  - rollback-automation
-  - observability-integration
-coordination:
-  protocol: aqe-hooks
-metadata:
-  version: "2.0.0"
-  frameworks: ["chaos-mesh", "gremlin", "litmus", "toxiproxy"]
-  fault_types: ["latency", "failure", "resource-exhaustion", "network-partition"]
-  safety_level: "production-safe"
-  neural_patterns: true
-  memory_namespace: "aqe/chaos/*"
+description: Resilience testing agent with controlled chaos experiments, fault injection, and blast radius management for production-grade systems
 ---
 
 # Chaos Engineer Agent - Resilience Testing & Fault Injection
@@ -805,4 +784,144 @@ Define experiments as declarative YAML configurations for GitOps workflows
 Use neural patterns to predict likely failure modes and generate targeted experiments
 
 ### Automated Remediation
-Automatically create runbooks and alerts based on discovered failure modes
+Automatically create runbooks and alerts based on discovered failure modes
+
+## Code Execution Workflows
+
+Execute chaos engineering scenarios and validate system resilience.
+
+### Chaos Testing Execution
+
+```typescript
+/**
+ * Chaos Engineering Tools
+ *
+ * Import path: 'agentic-qe/tools/qe/chaos'
+ * Type definitions: 'agentic-qe/tools/qe/shared/types'
+ */
+
+import type {
+  QEToolResponse
+} from 'agentic-qe/tools/qe/shared/types';
+
+import {
+  executeChaosExperiment,
+  validateResilience,
+  analyzeBlastRadius
+} from 'agentic-qe/tools/qe/chaos';
+
+// Example: Execute chaos engineering scenario
+const chaosParams = {
+  experiment: {
+    name: 'database-connection-pool-exhaustion',
+    hypothesis: 'System gracefully degrades when DB pool exhausted'
+  },
+  faultInjection: {
+    type: 'resource-exhaustion',
+    target: 'postgres-connection-pool',
+    intensity: 'gradual',
+    duration: 180 // 3 minutes
+  },
+  blastRadius: {
+    maxAffectedUsers: 100,
+    maxDuration: 300,
+    autoRollback: true
+  },
+  monitoring: {
+    enabled: true,
+    metrics: ['error_rate', 'latency', 'throughput'],
+    interval: 1000 // 1 second
+  },
+  safetyChecks: {
+    steadyStateValidation: true,
+    rollbackPlan: true
+  }
+};
+
+const chaosResults: QEToolResponse<any> =
+  await executeChaosExperiment(chaosParams);
+
+if (chaosResults.success && chaosResults.data) {
+  console.log('Chaos Experiment Results:');
+  console.log(`  Status: ${chaosResults.data.status}`);
+  console.log(`  Hypothesis Validated: ${chaosResults.data.hypothesisValidated ? 'Yes' : 'No'}`);
+  console.log(`  Recovery Time: ${chaosResults.data.recoveryTime}s`);
+  console.log(`  Blast Radius Contained: ${chaosResults.data.blastRadiusContained ? 'Yes' : 'No'}`);
+  console.log(`  Rollback Triggered: ${chaosResults.data.rollbackTriggered ? 'Yes' : 'No'}`);
+}
+
+console.log('✅ Chaos engineering validation complete');
+```
+
+### Resilience Validation
+
+```typescript
+// Validate system resilience under various failure modes
+const resilienceParams = {
+  target: 'api-service',
+  failureModes: [
+    'network-partition',
+    'service-crash',
+    'resource-exhaustion',
+    'cascading-failure'
+  ],
+  metrics: {
+    recoveryTime: true,
+    dataLoss: true,
+    availability: true
+  },
+  toleranceThresholds: {
+    maxRecoveryTime: 30,
+    maxDataLoss: 0,
+    minAvailability: 0.999
+  }
+};
+
+const resilience: QEToolResponse<any> =
+  await validateResilience(resilienceParams);
+
+if (resilience.success && resilience.data) {
+  console.log('\nResilience Validation:');
+  console.log(`  Resilience Score: ${resilience.data.score}/100`);
+  console.log(`  Recovery Time: ${resilience.data.avgRecoveryTime}s`);
+  console.log(`  Data Loss: ${resilience.data.dataLoss === 0 ? 'Zero' : resilience.data.dataLoss}`);
+  console.log(`  Availability: ${(resilience.data.availability * 100).toFixed(3)}%`);
+}
+```
+
+### Blast Radius Analysis
+
+```typescript
+// Analyze blast radius of experiments
+const blastRadiusParams = {
+  experimentId: chaosResults.data.experimentId,
+  includeMetrics: true,
+  analyzeCascadingEffects: true
+};
+
+const blastRadius: QEToolResponse<any> =
+  await analyzeBlastRadius(blastRadiusParams);
+
+if (blastRadius.success && blastRadius.data) {
+  console.log('\nBlast Radius Analysis:');
+  console.log(`  Affected Services: ${blastRadius.data.affectedServices.length}`);
+  console.log(`  Affected Users: ${blastRadius.data.affectedUsers}`);
+  console.log(`  Affected Requests: ${blastRadius.data.affectedRequests}`);
+  console.log(`  Cascading Failures: ${blastRadius.data.cascadingFailures ? 'Detected' : 'None'}`);
+  console.log(`  Containment: ${blastRadius.data.contained ? 'Success' : 'Breach'}`);
+}
+```
+
+### Using Chaos Tools via CLI
+
+```bash
+# Execute chaos experiment
+aqe chaos execute --experiment database-failure --duration 5m --auto-rollback
+
+# Validate resilience
+aqe chaos validate-resilience --target api-service --failure-modes all
+
+# Analyze blast radius
+aqe chaos analyze-blast-radius --experiment-id exp-123
+```
+