agentic-qe 3.7.16 → 3.7.18

package/dist/init/agents-installer.d.ts

@@ -17,6 +17,10 @@ export interface AgentsInstallResult {
     errors: string[];
     totalCount: number;
     agentsDir: string;
+    /** Agents that had customization overlays applied */
+    overlaysApplied?: string[];
+    /** Warnings from overlay loading */
+    overlayWarnings?: string[];
 }
 export interface AgentsInstallerOptions {
     /** Project root directory */
@@ -43,6 +47,11 @@ export declare class AgentsInstaller {
      * PRIORITY: assets directory (has helpers) > root .claude (no helpers)
      */
     private findSourceAgentsDir;
+    /**
+     * Ensure the agent-overrides directory exists and is preserved during install.
+     * This directory holds user customization overlays that survive `aqe init`.
+     */
+    private preserveOverridesDir;
     /**
      * Install agents to the project
      */

package/dist/init/agents-installer.js

@@ -9,6 +9,7 @@ import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSy
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
+import { loadOverlays, applyOverlayToContent } from '../agents/overlay-loader.js';
 // ============================================================================
 // Agent Categories
 // ============================================================================
@@ -169,6 +170,37 @@ export class AgentsInstaller {
         // If no agents found, return the first path (will fail gracefully)
         return possiblePaths[0];
     }
+    /**
+     * Ensure the agent-overrides directory exists and is preserved during install.
+     * This directory holds user customization overlays that survive `aqe init`.
+     */
+    preserveOverridesDir() {
+        const overridesDir = join(this.projectRoot, '.claude', 'agent-overrides');
+        if (!existsSync(overridesDir)) {
+            mkdirSync(overridesDir, { recursive: true });
+        }
+        // Copy the example overlay template if not already present
+        const exampleDest = join(overridesDir, '_example.yaml');
+        if (!existsSync(exampleDest)) {
+            try {
+                const moduleDir = dirname(fileURLToPath(import.meta.url));
+                const templateSources = [
+                    join(moduleDir, '..', '..', 'assets', 'templates', 'agent-override-example.yaml'),
+                    join(moduleDir, '..', 'assets', 'templates', 'agent-override-example.yaml'),
+                    join(this.projectRoot, 'node_modules', 'agentic-qe', 'assets', 'templates', 'agent-override-example.yaml'),
+                ];
+                for (const src of templateSources) {
+                    if (existsSync(src)) {
+                        copyFileSync(src, exampleDest);
+                        break;
+                    }
+                }
+            }
+            catch {
+                // Template copy is non-critical — skip silently
+            }
+        }
+    }
     /**
      * Install agents to the project
      */
@@ -179,7 +211,11 @@ export class AgentsInstaller {
             errors: [],
             totalCount: 0,
             agentsDir: join(this.projectRoot, '.claude', 'agents', 'v3'),
+            overlaysApplied: [],
+            overlayWarnings: [],
         };
+        // Preserve the agent-overrides directory (survives reinstall)
+        this.preserveOverridesDir();
         // Check if source agents exist
         if (!existsSync(this.sourceAgentsDir)) {
             result.errors.push(`Source agents directory not found: ${this.sourceAgentsDir}`);
@@ -219,6 +255,49 @@ export class AgentsInstaller {
                 result.errors.push(`Failed to install ${agentName}: ${toErrorMessage(error)}`);
             }
         }
+        // Load and apply agent customization overlays (BMAD-002)
+        const overlayResult = loadOverlays(this.projectRoot);
+        if (overlayResult.warnings.length > 0) {
+            result.overlayWarnings = overlayResult.warnings;
+            for (const warning of overlayResult.warnings) {
+                console.error(`[AgentsInstaller] Overlay warning: ${warning}`);
+            }
+        }
+        if (overlayResult.errors.length > 0) {
+            for (const error of overlayResult.errors) {
+                result.errors.push(`Overlay error: ${error}`);
+            }
+        }
+        // Apply overlays to installed agent files
+        for (const overlay of overlayResult.overlays) {
+            const agentName = overlay.agent;
+            const isSubagent = V3_SUBAGENTS.includes(agentName);
+            const agentFile = isSubagent
+                ? join(targetSubagentsDir, `${agentName}.md`)
+                : join(targetAgentsDir, `${agentName}.md`);
+            if (!existsSync(agentFile)) {
+                result.overlayWarnings.push(`Overlay for "${agentName}" found but agent file does not exist. Skipping.`);
+                continue;
+            }
+            try {
+                const agentContent = readFileSync(agentFile, 'utf-8');
+                const { content: modifiedContent, applied } = applyOverlayToContent(agentContent, overlay);
+                writeFileSync(agentFile, modifiedContent, 'utf-8');
+                result.overlaysApplied.push(agentName);
+                const changes = [
+                    ...applied.replacedFields.map(f => `replaced:${f}`),
+                    ...applied.appendedFields.map(f => `appended:${f}`),
+                    ...applied.configOverrides.map(f => `config:${f}`),
+                ];
+                console.error(`[AgentsInstaller] Applied overlay for ${agentName}: ${changes.join(', ')}`);
+            }
+            catch (error) {
+                result.overlayWarnings.push(`Failed to apply overlay for "${agentName}": ${toErrorMessage(error)}`);
+            }
+        }
+        if (result.overlaysApplied.length > 0) {
+            console.error(`[AgentsInstaller] Applied ${result.overlaysApplied.length} agent overlay(s): ${result.overlaysApplied.join(', ')}`);
+        }
         // Create agents index file
         await this.createAgentsIndex(targetAgentsDir, result.installed);
         return result;

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

@@ -46,6 +46,17 @@ export declare class HooksPhase extends BasePhase<HooksResult> {
      * verifies the checkpoint exists on session start.
      */
     private installBrainCheckpoint;
+    /**
+     * Install the statusline-v3.cjs helper into .claude/helpers/.
+     * This script generates a dynamic status line for Claude Code showing
+     * fleet status, learning metrics, domain progress, and architecture info.
+     */
+    private installStatusline;
+    /**
+     * Generate a minimal statusline-v3.cjs script as a fallback.
+     * Used when the full asset isn't available for copying.
+     */
+    private generateMinimalStatuslineScript;
     /**
      * Generate the brain-checkpoint.cjs script inline.
      * Used when the source file isn't available for copying.

package/dist/init/phases/07-hooks.js

@@ -153,6 +153,8 @@ export class HooksPhase extends BasePhase {
         const { projectRoot } = context;
         // Install brain-checkpoint helper into .claude/helpers/
         this.installBrainCheckpoint(projectRoot, context);
+        // Install statusline-v3 helper into .claude/helpers/
+        this.installStatusline(projectRoot, context);
         // Install cross-phase memory config
         const crossPhasePath = join(hooksDir, 'cross-phase-memory.yaml');
         if (!existsSync(crossPhasePath)) {
@@ -241,6 +243,71 @@ export class HooksPhase extends BasePhase {
             context.services.log('  Installed brain-checkpoint.cjs (generated)');
         }
     }
+    /**
+     * Install the statusline-v3.cjs helper into .claude/helpers/.
+     * This script generates a dynamic status line for Claude Code showing
+     * fleet status, learning metrics, domain progress, and architecture info.
+     */
+    installStatusline(projectRoot, context) {
+        const helpersDir = join(projectRoot, '.claude', 'helpers');
+        if (!existsSync(helpersDir)) {
+            mkdirSync(helpersDir, { recursive: true });
+        }
+        const destPath = join(helpersDir, 'statusline-v3.cjs');
+        // Try to copy from distributed assets or our own installation
+        const sourcePaths = [
+            join(projectRoot, 'node_modules', 'agentic-qe', 'assets', 'helpers', 'statusline-v3.cjs'),
+            join(projectRoot, 'assets', 'helpers', 'statusline-v3.cjs'),
+        ];
+        for (const src of sourcePaths) {
+            if (existsSync(src) && src !== destPath) {
+                const { copyFileSync } = require('fs');
+                copyFileSync(src, destPath);
+                context.services.log('  Installed statusline-v3.cjs (copied)');
+                return;
+            }
+        }
+        // If not available from source, generate a minimal fallback
+        if (!existsSync(destPath)) {
+            writeFileSync(destPath, this.generateMinimalStatuslineScript(), 'utf-8');
+            context.services.log('  Installed statusline-v3.cjs (generated)');
+        }
+    }
+    /**
+     * Generate a minimal statusline-v3.cjs script as a fallback.
+     * Used when the full asset isn't available for copying.
+     */
+    generateMinimalStatuslineScript() {
+        return `#!/usr/bin/env node
+/**
+ * Agentic QE v3 Statusline (minimal fallback, generated by aqe init)
+ * For the full statusline, reinstall: npx agentic-qe init --auto
+ */
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+function q(cmd, d) { try { return execSync(cmd, { encoding: 'utf-8', timeout: 3000 }).trim(); } catch { return d || ''; } }
+
+const dir = process.cwd();
+const dbPath = path.join(dir, '.agentic-qe', 'memory.db');
+let patterns = 0;
+try {
+  if (fs.existsSync(dbPath)) {
+    const Database = require('better-sqlite3');
+    const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+    patterns = db.prepare('SELECT COUNT(*) AS c FROM qe_patterns').get()?.c || 0;
+    db.close();
+  }
+} catch { /* ignore */ }
+
+const branch = q('git branch --show-current 2>/dev/null');
+const branchStr = branch ? \`  \\x1b[34m⎇ \${branch}\\x1b[0m\` : '';
+const patStr = patterns > 0 ? \`  \\x1b[35m🎓 \${patterns} patterns\\x1b[0m\` : '';
+
+console.log(\`\\x1b[1m\\x1b[35m▊ Agentic QE v3\\x1b[0m\${branchStr}\${patStr}\`);
+`;
+    }
     /**
      * Generate the brain-checkpoint.cjs script inline.
      * Used when the source file isn't available for copying.

package/dist/init/phases/09-assets.js

@@ -8,6 +8,7 @@ import { BasePhase, } from './phase-interface.js';
 import { createSkillsInstaller } from '../skills-installer.js';
 import { createAgentsInstaller } from '../agents-installer.js';
 import { createN8nInstaller } from '../n8n-installer.js';
+import { initializeOverlays } from '../../routing/qe-agent-registry.js';
 /**
  * Assets phase - installs skills and agents
  */
@@ -55,17 +56,24 @@ export class AssetsPhase extends BasePhase {
             }
         }
         // Install agents
-        const agentsInstaller = createAgentsInstaller({
-            projectRoot,
-            installQEAgents: true,
-            installSubagents: true,
-            overwrite: shouldOverwrite,
-        });
-        const agentsResult = await agentsInstaller.install();
-        agentsInstalled = agentsResult.installed.length;
-        if (agentsResult.errors.length > 0) {
-            context.services.warn(`Agents warnings: ${agentsResult.errors.join(', ')}`);
+        try {
+            const agentsInstaller = createAgentsInstaller({
+                projectRoot,
+                installQEAgents: true,
+                installSubagents: true,
+                overwrite: shouldOverwrite,
+            });
+            const agentsResult = await agentsInstaller.install();
+            agentsInstalled = agentsResult.installed.length;
+            if (agentsResult.errors.length > 0) {
+                context.services.warn(`Agents warnings: ${agentsResult.errors.join(', ')}`);
+            }
+        }
+        catch (error) {
+            context.services.warn(`Agents install error: ${error instanceof Error ? error.message : error}`);
         }
+        // Initialize overlay configs in agent registry for runtime use
+        initializeOverlays(projectRoot);
         // Install n8n platform (optional)
         if (options.withN8n) {
             const n8nInstaller = createN8nInstaller({

package/dist/init/settings-merge.js

@@ -95,7 +95,7 @@ export function generateV3SettingsSections(config) {
         },
         statusLine: {
             type: 'command',
-            command: 'node .claude/helpers/statusline-v3.cjs 2>/dev/null || .claude/statusline-v3.sh 2>/dev/null || echo "▊ Agentic QE v3"',
+            command: 'node .claude/helpers/statusline-v3.cjs 2>/dev/null || echo "▊ Agentic QE v3"',
             refreshMs: 5000,
             enabled: true,
         },