agentic-qe 3.8.1 → 3.8.3

package/assets/skills/aqe-v2-v3-migration/skill.md

@@ -1,326 +0,0 @@
----
-name: aqe-v2-v3-migration
-version: 1.0.0
-description: Migrate Agentic QE projects from v2 to v3 with zero data loss
-author: Agentic QE Team
-tags:
-  - migration
-  - upgrade
-  - v2-to-v3
-  - agentic-qe
-trigger:
-  - migrate from v2 to v3
-  - upgrade agentic-qe
-  - aqe migration
-  - v2 to v3 migration
-trust_tier: 1
-validation:
-  schema_path: schemas/output.json
-
----
-
-# AQE v2 to v3 Migration Skill
-
-<default_to_action>
-When migrating from v2 to v3:
-1. ANALYZE current v2 installation
-2. BACKUP all data before any changes
-3. MIGRATE configuration, memory, and patterns
-4. VALIDATE migration success
-5. PROVIDE rollback instructions
-
-**Never delete v2 data without explicit user confirmation.**
-</default_to_action>
-
-## Quick Reference
-
-### Migration Command
-```bash
-# When v3 becomes main release, just update the package
-npm install agentic-qe@latest
-
-# Run migration
-aqe migrate
-
-# Or use this skill
-/aqe-v2-v3-migration
-```
-
-### What Gets Migrated
-
-| Component | v2 Location | v3 Location | Auto-Migrate |
-|-----------|-------------|-------------|--------------|
-| Memory DB | `.agentic-qe/memory.db` | `.aqe/agentdb/` | Yes |
-| Config | `.agentic-qe/config.json` | `.aqe/config.json` | Yes |
-| Patterns | `.agentic-qe/patterns/` | `.aqe/reasoning-bank/` | Yes |
-| Cache | `.agentic-qe/cache/` | `.aqe/cache/` | Optional |
-| Logs | `.agentic-qe/logs/` | `.aqe/logs/` | No (fresh start) |
-
----
-
-## Migration Checklist
-
-### Pre-Migration
-- [ ] Verify v2 installation exists (`.agentic-qe/` directory)
-- [ ] Check v2 version: `aqe --version` (should be 2.x.x)
-- [ ] Backup current data: `npm run backup` (in v2 project)
-- [ ] Note any custom configurations
-- [ ] Document current test counts and coverage
-
-### During Migration
-- [ ] Update to v3: `npm install agentic-qe@latest`
-- [ ] Run migration: `aqe migrate`
-- [ ] Review migration report
-- [ ] Verify data transferred correctly
-
-### Post-Migration
-- [ ] Run v3 tests: `aqe test`
-- [ ] Check coverage: `aqe coverage`
-- [ ] Verify patterns loaded: `aqe patterns list`
-- [ ] Test MCP integration with Claude Code
-
----
-
-## Architecture Changes (v2 → v3)
-
-### From Monolithic to DDD
-
-```
-v2 Structure:                    v3 Structure:
-├── src/mcp/tools/              ├── src/domains/
-│   ├── test-*.ts (40+ tools)   │   ├── test-generation/
-│   └── ...                     │   ├── test-execution/
-├── src/core/agents/            │   ├── coverage-analysis/
-│   ├── mixed agents            │   ├── quality-assessment/
-│   └── ...                     │   ├── defect-intelligence/
-└── src/core/memory/            │   ├── requirements-validation/
-    └── scattered impls         │   ├── code-intelligence/
-                                │   ├── security-compliance/
-                                │   ├── contract-testing/
-                                │   ├── visual-accessibility/
-                                │   ├── chaos-resilience/
-                                │   └── learning-optimization/
-                                ├── src/kernel/
-                                │   ├── event-bus.ts
-                                │   └── coordinator.ts
-                                └── src/mcp/
-                                    └── domain-handlers.ts
-```
-
-### Key API Changes
-
-| v2 API | v3 API | Notes |
-|--------|--------|-------|
-| `aqe init` | `aqe init` | Different binary |
-| `aqe.generateTests()` | `testGeneration.generate()` | Domain-based |
-| `aqe.analyzeGaps()` | `coverageAnalysis.findGaps()` | O(log n) now |
-| `memory.store()` | `agentDB.store()` | HNSW-indexed |
-| `patterns.learn()` | `reasoningBank.record()` | With verdicts |
-
----
-
-## Configuration Migration
-
-### v2 Config Format
-```json
-{
-  "version": "2.8.2",
-  "memory": {
-    "path": ".agentic-qe/memory.db",
-    "type": "sqlite"
-  },
-  "agents": {
-    "enabled": ["test-generator", "coverage-analyzer"]
-  }
-}
-```
-
-### v3 Config Format
-```json
-{
-  "version": "3.0.0",
-  "kernel": {
-    "eventBus": "in-memory",
-    "coordinator": "queen"
-  },
-  "domains": {
-    "test-generation": { "enabled": true },
-    "test-execution": { "enabled": true },
-    "coverage-analysis": {
-      "enabled": true,
-      "algorithm": "hnsw",
-      "dimensions": 128
-    }
-  },
-  "memory": {
-    "backend": "agentdb",
-    "path": ".aqe/agentdb/",
-    "hnsw": {
-      "M": 16,
-      "efConstruction": 200
-    }
-  },
-  "learning": {
-    "reasoningBank": true,
-    "sona": true
-  }
-}
-```
-
----
-
-## Memory Migration
-
-### SQLite to AgentDB
-
-```typescript
-// v2: Direct SQLite access
-import Database from 'better-sqlite3';
-const db = new Database('.agentic-qe/memory.db');
-const patterns = db.prepare('SELECT * FROM patterns').all();
-
-// v3: AgentDB with HNSW
-import { AgentDB } from 'agentic-qe';
-const db = new AgentDB('.aqe/agentdb/');
-await db.initialize({ dimensions: 128, M: 16 });
-
-// Migration script transfers and indexes
-for (const pattern of v2Patterns) {
-  await db.store({
-    key: pattern.id,
-    value: pattern.data,
-    embedding: await generateEmbedding(pattern.data),
-    metadata: { migratedFrom: 'v2', originalId: pattern.id }
-  });
-}
-```
-
----
-
-## Breaking Changes
-
-### Must Update
-
-1. **Import Paths**
-   ```typescript
-   // v2
-   import { AgenticQE } from 'agentic-qe';
-
-   // v3 (when v3 becomes main release, package name is still 'agentic-qe')
-   import { TestGenerationDomain } from 'agentic-qe/domains';
-   ```
-
-2. **CLI Commands**
-   ```bash
-   # v2
-   aqe test --parallel
-
-   # v3
-   aqe test --workers=4 --topology=mesh
-   ```
-
-3. **MCP Server**
-   ```bash
-   # v2
-   claude mcp add aqe -- npx aqe-mcp
-
-   # v3 (same CLI name, enhanced capabilities)
-   claude mcp add aqe -- npx aqe mcp
-   ```
-
-### Deprecated (Will Warn)
-
-- `aqe.runTests()` → Use domain-specific methods
-- Direct memory access → Use AgentDB API
-- Flat agent list → Use domain coordinators
-
----
-
-## Rollback Instructions
-
-If migration fails or you need to revert:
-
-```bash
-# 1. v3 does NOT modify v2 data
-# Your .agentic-qe/ folder is untouched
-
-# 2. Downgrade to v2
-npm install agentic-qe@2.x
-rm -rf .aqe/
-
-# 3. Continue using v2
-aqe --version  # Should show 2.x.x
-```
-
----
-
-## Agent Coordination Examples
-
-### Spawning Migration Agents
-
-```typescript
-// Use Task tool to spawn migration agents in parallel
-Task({
-  prompt: "Analyze v2 memory.db and extract all patterns",
-  subagent_type: "researcher",
-  description: "Analyze v2 patterns"
-});
-
-Task({
-  prompt: "Convert v2 config to v3 format",
-  subagent_type: "coder",
-  description: "Convert config"
-});
-
-Task({
-  prompt: "Validate migration results",
-  subagent_type: "tester",
-  description: "Validate migration"
-});
-```
-
----
-
-## Troubleshooting
-
-### Common Issues
-
-| Issue | Cause | Solution |
-|-------|-------|----------|
-| "Cannot find .agentic-qe/" | No v2 installation | Run `aqe init` first |
-| "Memory migration failed" | Corrupted SQLite | Use backup: `npm run backup:restore` |
-| "HNSW index error" | Dimension mismatch | Set `dimensions: 128` in config |
-| "Pattern not found" | Not migrated | Re-run: `aqe migrate --patterns` |
-
-### Debug Mode
-
-```bash
-# Run migration with debug output
-DEBUG=aqe:migrate aqe migrate
-
-# Check migration logs
-cat .aqe/logs/migration.log
-```
-
----
-
-## Support
-
-- **Migration Issues**: Open issue with `[v2-v3-migration]` tag
-- **Documentation**: [Migration Guide](../../docs/plans/V2-TO-V3-MIGRATION-PLAN.md)
-- **Discord**: #v3-migration channel
-
----
-
-## Version Compatibility Matrix
-
-| v2 Version | v3 Version | Migration Support |
-|------------|------------|-------------------|
-| 2.8.x | 3.0.x | Full |
-| 2.7.x | 3.0.x | Full |
-| 2.6.x | 3.0.x | Partial (config only) |
-| 2.5.x and below | 3.0.x | Manual migration |
-
----
-
-*Skill Version: 1.0.0 | Last Updated: 2026-01-11*

package/assets/skills/qe-contract-testing/SKILL.md

@@ -1,224 +0,0 @@
----
-name: "QE Contract Testing"
-description: "Consumer-driven contract testing for APIs including REST, GraphQL, and event-driven systems with schema validation."
-trust_tier: 3
-validation:
-  schema_path: schemas/output.json
-  validator_path: scripts/validate-config.json
-  eval_path: evals/qe-contract-testing.yaml
-
----
-
-# QE Contract Testing
-
-## Purpose
-
-Guide the use of v3's contract testing capabilities including consumer-driven contracts, schema validation, backward compatibility checking, and API versioning verification.
-
-## Activation
-
-- When testing API contracts
-- When validating schema changes
-- When checking backward compatibility
-- When testing GraphQL APIs
-- When verifying event schemas
-
-## Quick Start
-
-```bash
-# Generate contract from API
-aqe contract generate --api openapi.yaml --output contracts/
-
-# Verify provider against contracts
-aqe contract verify --provider http://localhost:3000 --contracts contracts/
-
-# Check breaking changes
-aqe contract breaking --old api-v1.yaml --new api-v2.yaml
-
-# Test GraphQL schema
-aqe contract graphql --schema schema.graphql --operations queries/
-```
-
-## Agent Workflow
-
-```typescript
-// Contract generation
-Task("Generate API contracts", `
-  Analyze the REST API and generate consumer contracts:
-  - Parse OpenAPI specification
-  - Identify critical endpoints
-  - Generate Pact contracts
-  - Include example requests/responses
-  Output to contracts/ directory.
-`, "qe-api-contract")
-
-// Breaking change detection
-Task("Check API compatibility", `
-  Compare API v2.0 against v1.0:
-  - Detect removed endpoints
-  - Check parameter changes
-  - Verify response schema changes
-  - Identify deprecations
-  Report breaking vs non-breaking changes.
-`, "qe-api-compatibility")
-```
-
-## Contract Testing Types
-
-### 1. Consumer-Driven Contracts (Pact)
-
-```typescript
-await contractTester.consumerDriven({
-  consumer: 'web-app',
-  provider: 'user-service',
-  contracts: 'contracts/web-app-user-service.json',
-  verification: {
-    providerBaseUrl: 'http://localhost:3000',
-    providerStates: providerStateHandlers,
-    publishResults: true
-  }
-});
-```
-
-### 2. Schema Validation
-
-```typescript
-await contractTester.validateSchema({
-  type: 'openapi',
-  schema: 'api/openapi.yaml',
-  requests: actualRequests,
-  validation: {
-    requestBody: true,
-    responseBody: true,
-    headers: true,
-    statusCodes: true
-  }
-});
-```
-
-### 3. GraphQL Contract Testing
-
-```typescript
-await graphqlTester.testContracts({
-  schema: 'schema.graphql',
-  operations: 'queries/**/*.graphql',
-  validation: {
-    queryValidity: true,
-    responseShapes: true,
-    nullability: true,
-    deprecations: true
-  }
-});
-```
-
-### 4. Event Contract Testing
-
-```typescript
-await contractTester.eventContracts({
-  schema: 'events/schemas/',
-  events: {
-    'user.created': {
-      schema: 'UserCreatedEvent.json',
-      examples: ['examples/user-created.json']
-    },
-    'order.completed': {
-      schema: 'OrderCompletedEvent.json',
-      examples: ['examples/order-completed.json']
-    }
-  },
-  compatibility: 'backward'
-});
-```
-
-## Breaking Change Detection
-
-```yaml
-breaking_changes:
-  always_breaking:
-    - endpoint_removed
-    - required_param_added
-    - response_field_removed
-    - type_changed
-
-  potentially_breaking:
-    - optional_param_removed
-    - response_field_added
-    - enum_value_removed
-
-  non_breaking:
-    - endpoint_added
-    - optional_param_added
-    - response_field_made_optional
-    - documentation_changed
-```
-
-## Contract Report
-
-```typescript
-interface ContractReport {
-  summary: {
-    contracts: number;
-    passed: number;
-    failed: number;
-    warnings: number;
-  };
-  consumers: {
-    name: string;
-    contracts: ContractResult[];
-    compatibility: 'compatible' | 'breaking' | 'unknown';
-  }[];
-  breakingChanges: {
-    type: string;
-    location: string;
-    description: string;
-    impact: 'high' | 'medium' | 'low';
-    migration: string;
-  }[];
-  deprecations: {
-    item: string;
-    deprecatedIn: string;
-    removeIn: string;
-    replacement: string;
-  }[];
-}
-```
-
-## CI/CD Integration
-
-```yaml
-contract_verification:
-  consumer_side:
-    - generate_contracts
-    - publish_to_broker
-    - can_i_deploy_check
-
-  provider_side:
-    - fetch_contracts_from_broker
-    - verify_against_provider
-    - publish_results
-
-  pre_release:
-    - check_breaking_changes
-    - verify_all_consumers
-    - update_compatibility_matrix
-```
-
-## Pact Broker Integration
-
-```typescript
-await contractTester.withBroker({
-  brokerUrl: 'https://pact-broker.example.com',
-  auth: { token: process.env.PACT_TOKEN },
-  operations: {
-    publish: true,
-    canIDeploy: true,
-    webhooks: true
-  }
-});
-```
-
-## Coordination
-
-**Primary Agents**: qe-api-contract, qe-api-compatibility, qe-graphql-tester
-**Coordinator**: qe-contract-coordinator
-**Related Skills**: qe-test-generation, qe-security-compliance