agentic-qe 3.10.1 → 3.10.3

package/dist/init/init-wizard-hooks.js

@@ -52,7 +52,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks guard --file "$TOOL_INPUT_file_path" --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" guard --file "$TOOL_INPUT_file_path" --json',
                         timeout: 3000,
                         continueOnError: true,
                     },
@@ -63,7 +63,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks pre-edit --file "$TOOL_INPUT_file_path" --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-edit --file "$TOOL_INPUT_file_path" --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -74,7 +74,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks pre-command --command "$TOOL_INPUT_command" --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-command --command "$TOOL_INPUT_command" --json',
                         timeout: 3000,
                         continueOnError: true,
                     },
@@ -85,7 +85,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks pre-task --description "$TOOL_INPUT_prompt" --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" pre-task --description "$TOOL_INPUT_prompt" --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -98,7 +98,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks post-edit --file "$TOOL_INPUT_file_path" --success --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-edit --file "$TOOL_INPUT_file_path" --success --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -109,7 +109,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks post-command --command "$TOOL_INPUT_command" --success --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-command --command "$TOOL_INPUT_command" --success true --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -120,7 +120,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks post-task --task-id "$TOOL_RESULT_agent_id" --success --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-task --task-id "$TOOL_RESULT_agent_id" --agent "$TOOL_INPUT_subagent_type" --success true --description "$TOOL_INPUT_prompt" --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -135,7 +135,7 @@ export async function configureHooks(projectRoot, config) {
                         // (e.g. {"prompt":"..."}). $PROMPT is NOT exposed as an env
                         // var, so we let the CLI read stdin directly.
                         type: 'command',
-                        command: 'npx agentic-qe hooks route --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" route --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -147,7 +147,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks session-start --session-id "$SESSION_ID" --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-start --session-id "$SESSION_ID" --json',
                         timeout: 10000,
                         continueOnError: true,
                     },
@@ -159,7 +159,7 @@ export async function configureHooks(projectRoot, config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx agentic-qe hooks session-end --save-state --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" session-end --save-state --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -172,7 +172,7 @@ export async function configureHooks(projectRoot, config) {
                         // 1:1 with UserPromptSubmit/route — without this, route
                         // sentinels accumulate at quality_score=-1 indefinitely.
                         type: 'command',
-                        command: 'npx agentic-qe hooks post-route --success true --json',
+                        command: 'node "${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/aqe-hook.cjs" post-route --success true --json',
                         timeout: 5000,
                         continueOnError: true,
                     },
@@ -251,30 +251,30 @@ async function installCrossPhaseMemoryHooks(projectRoot) {
         }
     }
     // If no asset found, create minimal config
-    const minimalConfig = `# Cross-Phase Memory Hooks Configuration
-# Generated by aqe init
-# See: https://github.com/anthropics/agentic-qe/docs/cross-phase-memory.md
-
-version: "1.0"
-enabled: true
-
-hooks:
-  # Add custom QCSD feedback loop hooks here
-  # See .claude/hooks/cross-phase-memory.yaml in the agentic-qe repo for examples
-
-routing:
-  authorized_receivers:
-    strategic:
-      - "qe-risk-assessor"
-      - "qe-quality-criteria-recommender"
-    tactical:
-      - "qe-product-factors-assessor"
-    operational:
-      - "qe-test-architect"
-      - "qe-tdd-specialist"
-    quality-criteria:
-      - "qe-requirements-validator"
-      - "qe-bdd-generator"
+    const minimalConfig = `# Cross-Phase Memory Hooks Configuration
+# Generated by aqe init
+# See: https://github.com/anthropics/agentic-qe/docs/cross-phase-memory.md
+
+version: "1.0"
+enabled: true
+
+hooks:
+  # Add custom QCSD feedback loop hooks here
+  # See .claude/hooks/cross-phase-memory.yaml in the agentic-qe repo for examples
+
+routing:
+  authorized_receivers:
+    strategic:
+      - "qe-risk-assessor"
+      - "qe-quality-criteria-recommender"
+    tactical:
+      - "qe-product-factors-assessor"
+    operational:
+      - "qe-test-architect"
+      - "qe-tdd-specialist"
+    quality-criteria:
+      - "qe-requirements-validator"
+      - "qe-bdd-generator"
 `;
     writeFileSync(targetPath, minimalConfig, 'utf-8');
     console.log('  ✓ Cross-phase memory hooks created (minimal config)');
@@ -351,242 +351,242 @@ export async function generateCLAUDEmd(projectRoot, config) {
 function generateCLAUDEmdContent(config) {
     const enabledDomains = config.domains.enabled.slice(0, 6).join(', ');
     const moreDomainsCount = Math.max(0, config.domains.enabled.length - 6);
-    return `## Agentic QE v3
-
-This project uses **Agentic QE v3** - a Domain-Driven Quality Engineering platform with 12 bounded contexts, ReasoningBank learning, and HNSW vector search.
-
----
-
-## 🐝 AQE FLEET ORCHESTRATION
-
-### Fleet Initialization
-
-**For QE-specific tasks, initialize the AQE fleet:**
-
-\`\`\`javascript
-// Initialize AQE Fleet with MCP tool
-mcp__agentic-qe__fleet_init({
-  config: {
-    topology: "hierarchical",  // Queen-led for QE coordination
-    maxAgents: 15,
-    testingFocus: ["unit", "integration", "e2e", "performance"],
-    frameworks: ["vitest", "jest", "playwright"],
-    environments: ["node", "browser"]
-  },
-  projectContext: {
-    language: "typescript",
-    buildSystem: "npm"
-  }
-})
-\`\`\`
-
-### 12 DDD Domains → Agent Mapping
-
-| Domain | Primary Agents | Focus Area |
-|--------|---------------|------------|
-| \`test-generation\` | qe-test-architect, qe-tdd-specialist | AI-powered test creation |
-| \`test-execution\` | qe-parallel-executor, qe-flaky-hunter, qe-retry-handler | Parallel execution, flaky detection |
-| \`coverage-analysis\` | qe-coverage-specialist, qe-gap-detector | O(log n) sublinear coverage |
-| \`quality-assessment\` | qe-quality-gate, qe-deployment-advisor | Quality gates, risk scoring |
-| \`defect-intelligence\` | qe-defect-predictor, qe-root-cause-analyzer | ML-powered defect prediction |
-| \`learning-optimization\` | qe-learning-coordinator, qe-pattern-learner | Cross-domain pattern learning |
-| \`requirements-validation\` | qe-tdd-specialist, qe-property-tester | BDD scenarios, property tests |
-| \`code-intelligence\` | qe-knowledge-manager, code-analyzer | Knowledge graphs, 80% token reduction |
-| \`security-compliance\` | qe-security-scanner, qe-security-auditor | OWASP, CVE detection |
-| \`contract-testing\` | qe-contract-validator, qe-api-tester | Pact, schema validation |
-| \`visual-accessibility\` | qe-visual-tester, qe-a11y-validator | Visual regression, WCAG |
-| \`chaos-resilience\` | qe-chaos-engineer, qe-performance-tester | Fault injection, load testing |
-
-### Fleet MCP Tools
-
-\`\`\`javascript
-// Spawn specialized QE agent
-mcp__agentic-qe__agent_spawn({
-  spec: {
-    type: "test-generator",
-    capabilities: ["unit-tests", "integration-tests"],
-    name: "test-gen-1"
-  },
-  fleetId: "fleet-123"
-})
-
-// AI-enhanced test generation
-mcp__agentic-qe__test_generate_enhanced({
-  sourceCode: "...",
-  language: "typescript",
-  testType: "unit",
-  coverageGoal: 90,
-  aiEnhancement: true,
-  detectAntiPatterns: true
-})
-
-// Parallel test execution with retry
-mcp__agentic-qe__test_execute_parallel({
-  testFiles: ["tests/**/*.test.ts"],
-  parallelism: 4,
-  retryFailures: true,
-  maxRetries: 3,
-  collectCoverage: true
-})
-
-// Orchestrate QE task across fleet
-mcp__agentic-qe__task_orchestrate({
-  task: {
-    type: "comprehensive-testing",
-    priority: "high",
-    strategy: "adaptive",
-    maxAgents: 5
-  },
-  context: {
-    project: "my-project",
-    environment: "test"
-  },
-  fleetId: "fleet-123"
-})
-\`\`\`
-
-### QE Memory Operations
-
-\`\`\`javascript
-// Store QE pattern with namespace
-mcp__agentic-qe__memory_store({
-  key: "coverage-pattern-auth",
-  value: { pattern: "...", successRate: 0.95 },
-  namespace: "qe-patterns",
-  ttl: 86400,
-  persist: true
-})
-
-// Query memory with pattern matching
-mcp__agentic-qe__memory_query({
-  pattern: "coverage-*",
-  namespace: "qe-patterns",
-  limit: 10
-})
-\`\`\`
-
-### QE Task Routing by Domain
-
-| Task Type | MCP Tool | Agents Spawned |
-|-----------|----------|----------------|
-| Generate tests | \`test_generate_enhanced\` | qe-test-architect, qe-tdd-specialist |
-| Run tests | \`test_execute_parallel\` | qe-parallel-executor, qe-retry-handler |
-| Analyze coverage | \`task_orchestrate\` (coverage) | qe-coverage-specialist, qe-gap-detector |
-| Quality gate | \`task_orchestrate\` (quality-gate) | qe-quality-gate, qe-deployment-advisor |
-| Security scan | \`agent_spawn\` (security-scanner) | qe-security-scanner, qe-security-auditor |
-| Chaos test | \`agent_spawn\` (chaos-engineer) | qe-chaos-engineer, qe-load-tester |
-
----
-
-## Quick Reference
-
-\`\`\`bash
-# Run tests
-npm test -- --run
-
-# Check quality
-aqe quality assess
-
-# Generate tests
-aqe test generate <file>
-
-# Coverage analysis
-aqe coverage <path>
-\`\`\`
-
-### MCP Server
-
-The AQE v3 MCP server is configured in \`.claude/mcp.json\`. Available tools:
-
-| Tool | Description |
-|------|-------------|
-| \`fleet_init\` | Initialize QE fleet with topology |
-| \`agent_spawn\` | Spawn specialized QE agent |
-| \`test_generate_enhanced\` | AI-powered test generation |
-| \`test_execute_parallel\` | Parallel test execution with retry |
-| \`task_orchestrate\` | Orchestrate multi-agent QE tasks |
-| \`coverage_analyze_sublinear\` | O(log n) coverage analysis |
-| \`quality_assess\` | Quality gate evaluation |
-| \`memory_store\` / \`memory_query\` | Pattern storage with namespacing |
-| \`security_scan_comprehensive\` | SAST/DAST scanning |
-| \`fleet_status\` | Get fleet and agent status |
-
-### Configuration
-
-- **Enabled Domains**: ${enabledDomains}${moreDomainsCount > 0 ? ` (+${moreDomainsCount} more)` : ''}
-- **Learning**: ${config.learning.enabled ? 'Enabled' : 'Disabled'} (${config.learning.embeddingModel} embeddings)
-- **Max Concurrent Agents**: ${config.agents.maxConcurrent}
-- **Background Workers**: ${config.workers.enabled.length > 0 ? config.workers.enabled.join(', ') : 'None'}
-
-### V3 QE Agents
-
-QE agents are installed in \`.claude/agents/v3/\`. Use with Claude Code's Task tool:
-
-\`\`\`javascript
-// Example: Generate tests
-Task({ prompt: "Generate unit tests for auth module", subagent_type: "qe-test-architect", run_in_background: true })
-
-// Example: Analyze coverage
-Task({ prompt: "Find coverage gaps in src/", subagent_type: "qe-coverage-specialist", run_in_background: true })
-
-// Example: Security scan
-Task({ prompt: "Run security audit", subagent_type: "qe-security-scanner", run_in_background: true })
-\`\`\`
-
-### Integration with Claude Flow
-
-**AQE Fleet + Claude Flow work together:**
-
-\`\`\`javascript
-// STEP 1: Initialize Claude Flow swarm for coordination
-Bash("npx ruflo swarm init --topology hierarchical --max-agents 15")
-
-// STEP 2: Initialize AQE Fleet for QE-specific work
-mcp__agentic-qe__fleet_init({
-  config: { topology: "hierarchical", maxAgents: 10, testingFocus: ["unit", "integration"] }
-})
-
-// STEP 3: Spawn agents via Claude Code Task tool (do the actual work)
-Task({ prompt: "Generate tests for auth module", subagent_type: "qe-test-architect", run_in_background: true })
-Task({ prompt: "Analyze coverage gaps", subagent_type: "qe-coverage-specialist", run_in_background: true })
-
-// STEP 4: Store learnings in both systems
-mcp__agentic-qe__memory_store({ key: "pattern-1", value: "...", namespace: "qe-patterns", persist: true })
-Bash("npx ruflo memory store --key 'qe-pattern-1' --value '...' --namespace patterns")
-\`\`\`
-
-### Data Storage
-
-- **Memory Backend**: \`.agentic-qe/memory.db\` (SQLite)
-- **Pattern Storage**: \`.agentic-qe/data/memory.db\` (ReasoningBank)
-- **HNSW Index**: \`.agentic-qe/data/hnsw/index.bin\`
-- **Configuration**: \`.agentic-qe/config.yaml\`
-
-### Best Practices
-
-1. **Test Execution**: Always use \`npm test -- --run\` (not \`npm test\` which runs in watch mode)
-2. **Coverage Targets**: Aim for 80%+ coverage on critical paths
-3. **Quality Gates**: Run \`quality_assess\` before merging PRs
-4. **Pattern Learning**: AQE learns from successful test patterns - consistent naming helps
-5. **Fleet Coordination**: Use \`fleet_init\` before spawning multiple QE agents
-6. **Memory Persistence**: Use \`persist: true\` for patterns you want to keep across sessions
-
-### Troubleshooting
-
-If MCP tools aren't working:
-\`\`\`bash
-# Verify MCP server is configured
-cat .claude/mcp.json
-
-# Check fleet status
-mcp__agentic-qe__fleet_status({ includeAgentDetails: true })
-
-# Reinitialize if needed
-aqe init --auto
-\`\`\`
-
----
-*Generated by AQE v3 init - ${new Date().toISOString()}*
+    return `## Agentic QE v3
+
+This project uses **Agentic QE v3** - a Domain-Driven Quality Engineering platform with 12 bounded contexts, ReasoningBank learning, and HNSW vector search.
+
+---
+
+## 🐝 AQE FLEET ORCHESTRATION
+
+### Fleet Initialization
+
+**For QE-specific tasks, initialize the AQE fleet:**
+
+\`\`\`javascript
+// Initialize AQE Fleet with MCP tool
+mcp__agentic-qe__fleet_init({
+  config: {
+    topology: "hierarchical",  // Queen-led for QE coordination
+    maxAgents: 15,
+    testingFocus: ["unit", "integration", "e2e", "performance"],
+    frameworks: ["vitest", "jest", "playwright"],
+    environments: ["node", "browser"]
+  },
+  projectContext: {
+    language: "typescript",
+    buildSystem: "npm"
+  }
+})
+\`\`\`
+
+### 12 DDD Domains → Agent Mapping
+
+| Domain | Primary Agents | Focus Area |
+|--------|---------------|------------|
+| \`test-generation\` | qe-test-architect, qe-tdd-specialist | AI-powered test creation |
+| \`test-execution\` | qe-parallel-executor, qe-flaky-hunter, qe-retry-handler | Parallel execution, flaky detection |
+| \`coverage-analysis\` | qe-coverage-specialist, qe-gap-detector | O(log n) sublinear coverage |
+| \`quality-assessment\` | qe-quality-gate, qe-deployment-advisor | Quality gates, risk scoring |
+| \`defect-intelligence\` | qe-defect-predictor, qe-root-cause-analyzer | ML-powered defect prediction |
+| \`learning-optimization\` | qe-learning-coordinator, qe-pattern-learner | Cross-domain pattern learning |
+| \`requirements-validation\` | qe-tdd-specialist, qe-property-tester | BDD scenarios, property tests |
+| \`code-intelligence\` | qe-knowledge-manager, code-analyzer | Knowledge graphs, 80% token reduction |
+| \`security-compliance\` | qe-security-scanner, qe-security-auditor | OWASP, CVE detection |
+| \`contract-testing\` | qe-contract-validator, qe-api-tester | Pact, schema validation |
+| \`visual-accessibility\` | qe-visual-tester, qe-a11y-validator | Visual regression, WCAG |
+| \`chaos-resilience\` | qe-chaos-engineer, qe-performance-tester | Fault injection, load testing |
+
+### Fleet MCP Tools
+
+\`\`\`javascript
+// Spawn specialized QE agent
+mcp__agentic-qe__agent_spawn({
+  spec: {
+    type: "test-generator",
+    capabilities: ["unit-tests", "integration-tests"],
+    name: "test-gen-1"
+  },
+  fleetId: "fleet-123"
+})
+
+// AI-enhanced test generation
+mcp__agentic-qe__test_generate_enhanced({
+  sourceCode: "...",
+  language: "typescript",
+  testType: "unit",
+  coverageGoal: 90,
+  aiEnhancement: true,
+  detectAntiPatterns: true
+})
+
+// Parallel test execution with retry
+mcp__agentic-qe__test_execute_parallel({
+  testFiles: ["tests/**/*.test.ts"],
+  parallelism: 4,
+  retryFailures: true,
+  maxRetries: 3,
+  collectCoverage: true
+})
+
+// Orchestrate QE task across fleet
+mcp__agentic-qe__task_orchestrate({
+  task: {
+    type: "comprehensive-testing",
+    priority: "high",
+    strategy: "adaptive",
+    maxAgents: 5
+  },
+  context: {
+    project: "my-project",
+    environment: "test"
+  },
+  fleetId: "fleet-123"
+})
+\`\`\`
+
+### QE Memory Operations
+
+\`\`\`javascript
+// Store QE pattern with namespace
+mcp__agentic-qe__memory_store({
+  key: "coverage-pattern-auth",
+  value: { pattern: "...", successRate: 0.95 },
+  namespace: "qe-patterns",
+  ttl: 86400,
+  persist: true
+})
+
+// Query memory with pattern matching
+mcp__agentic-qe__memory_query({
+  pattern: "coverage-*",
+  namespace: "qe-patterns",
+  limit: 10
+})
+\`\`\`
+
+### QE Task Routing by Domain
+
+| Task Type | MCP Tool | Agents Spawned |
+|-----------|----------|----------------|
+| Generate tests | \`test_generate_enhanced\` | qe-test-architect, qe-tdd-specialist |
+| Run tests | \`test_execute_parallel\` | qe-parallel-executor, qe-retry-handler |
+| Analyze coverage | \`task_orchestrate\` (coverage) | qe-coverage-specialist, qe-gap-detector |
+| Quality gate | \`task_orchestrate\` (quality-gate) | qe-quality-gate, qe-deployment-advisor |
+| Security scan | \`agent_spawn\` (security-scanner) | qe-security-scanner, qe-security-auditor |
+| Chaos test | \`agent_spawn\` (chaos-engineer) | qe-chaos-engineer, qe-load-tester |
+
+---
+
+## Quick Reference
+
+\`\`\`bash
+# Run tests
+npm test -- --run
+
+# Check quality
+aqe quality assess
+
+# Generate tests
+aqe test generate <file>
+
+# Coverage analysis
+aqe coverage <path>
+\`\`\`
+
+### MCP Server
+
+The AQE v3 MCP server is configured in \`.claude/mcp.json\`. Available tools:
+
+| Tool | Description |
+|------|-------------|
+| \`fleet_init\` | Initialize QE fleet with topology |
+| \`agent_spawn\` | Spawn specialized QE agent |
+| \`test_generate_enhanced\` | AI-powered test generation |
+| \`test_execute_parallel\` | Parallel test execution with retry |
+| \`task_orchestrate\` | Orchestrate multi-agent QE tasks |
+| \`coverage_analyze_sublinear\` | O(log n) coverage analysis |
+| \`quality_assess\` | Quality gate evaluation |
+| \`memory_store\` / \`memory_query\` | Pattern storage with namespacing |
+| \`security_scan_comprehensive\` | SAST/DAST scanning |
+| \`fleet_status\` | Get fleet and agent status |
+
+### Configuration
+
+- **Enabled Domains**: ${enabledDomains}${moreDomainsCount > 0 ? ` (+${moreDomainsCount} more)` : ''}
+- **Learning**: ${config.learning.enabled ? 'Enabled' : 'Disabled'} (${config.learning.embeddingModel} embeddings)
+- **Max Concurrent Agents**: ${config.agents.maxConcurrent}
+- **Background Workers**: ${config.workers.enabled.length > 0 ? config.workers.enabled.join(', ') : 'None'}
+
+### V3 QE Agents
+
+QE agents are installed in \`.claude/agents/v3/\`. Use with Claude Code's Task tool:
+
+\`\`\`javascript
+// Example: Generate tests
+Task({ prompt: "Generate unit tests for auth module", subagent_type: "qe-test-architect", run_in_background: true })
+
+// Example: Analyze coverage
+Task({ prompt: "Find coverage gaps in src/", subagent_type: "qe-coverage-specialist", run_in_background: true })
+
+// Example: Security scan
+Task({ prompt: "Run security audit", subagent_type: "qe-security-scanner", run_in_background: true })
+\`\`\`
+
+### Integration with Claude Flow
+
+**AQE Fleet + Claude Flow work together:**
+
+\`\`\`javascript
+// STEP 1: Initialize Claude Flow swarm for coordination
+Bash("npx ruflo swarm init --topology hierarchical --max-agents 15")
+
+// STEP 2: Initialize AQE Fleet for QE-specific work
+mcp__agentic-qe__fleet_init({
+  config: { topology: "hierarchical", maxAgents: 10, testingFocus: ["unit", "integration"] }
+})
+
+// STEP 3: Spawn agents via Claude Code Task tool (do the actual work)
+Task({ prompt: "Generate tests for auth module", subagent_type: "qe-test-architect", run_in_background: true })
+Task({ prompt: "Analyze coverage gaps", subagent_type: "qe-coverage-specialist", run_in_background: true })
+
+// STEP 4: Store learnings in both systems
+mcp__agentic-qe__memory_store({ key: "pattern-1", value: "...", namespace: "qe-patterns", persist: true })
+Bash("npx ruflo memory store --key 'qe-pattern-1' --value '...' --namespace patterns")
+\`\`\`
+
+### Data Storage
+
+- **Memory Backend**: \`.agentic-qe/memory.db\` (SQLite)
+- **Pattern Storage**: \`.agentic-qe/data/memory.db\` (ReasoningBank)
+- **HNSW Index**: \`.agentic-qe/data/hnsw/index.bin\`
+- **Configuration**: \`.agentic-qe/config.yaml\`
+
+### Best Practices
+
+1. **Test Execution**: Always use \`npm test -- --run\` (not \`npm test\` which runs in watch mode)
+2. **Coverage Targets**: Aim for 80%+ coverage on critical paths
+3. **Quality Gates**: Run \`quality_assess\` before merging PRs
+4. **Pattern Learning**: AQE learns from successful test patterns - consistent naming helps
+5. **Fleet Coordination**: Use \`fleet_init\` before spawning multiple QE agents
+6. **Memory Persistence**: Use \`persist: true\` for patterns you want to keep across sessions
+
+### Troubleshooting
+
+If MCP tools aren't working:
+\`\`\`bash
+# Verify MCP server is configured
+cat .claude/mcp.json
+
+# Check fleet status
+mcp__agentic-qe__fleet_status({ includeAgentDetails: true })
+
+# Reinitialize if needed
+aqe init --auto
+\`\`\`
+
+---
+*Generated by AQE v3 init - ${new Date().toISOString()}*
 `;
 }
 //# sourceMappingURL=init-wizard-hooks.js.map

package/dist/init/phases/07-hooks.d.ts

@@ -52,6 +52,13 @@ export declare class HooksPhase extends BasePhase<HooksResult> {
      * fleet status, learning metrics, domain progress, and architecture info.
      */
     private installStatusline;
+    /**
+     * Install the resilient hook shim (aqe-hook.cjs) into .claude/hooks/.
+     * The generated settings.json hooks run `node .../aqe-hook.cjs <cmd>` — the
+     * shim resolves a project-local AQE bundle (or falls back to npx), strips
+     * init noise from stdout, swallows stderr, and always exits 0.
+     */
+    private installHookShim;
     /**
      * Generate a minimal statusline-v3.cjs script as a fallback.
      * Used when the full asset isn't available for copying.