agentic-qe 3.8.1 → 3.8.2

package/dist/adapters/claude-flow/model-router-bridge.js

@@ -11,7 +11,8 @@
  * - Uses simple rule-based routing
  * - Falls back to sonnet as default
  */
-import { detectClaudeFlow } from './detect.js';
+import { detectClaudeFlow, resolveCliPackage } from './detect.js';
+const cliPkg = resolveCliPackage();
 /**
  * Task complexity indicators
  */
@@ -55,7 +56,7 @@ export class ModelRouterBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const result = execFileSync('npx', ['--no-install', '@claude-flow/cli', 'hooks', 'model-route', '--task', task], { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
+                const result = execFileSync('npx', ['--no-install', cliPkg, 'hooks', 'model-route', '--task', task], { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
                 // Parse result
                 const modelMatch = result.match(/model[:\s]+["']?(haiku|sonnet|opus)/i);
                 const confMatch = result.match(/confidence[:\s]+([0-9.]+)/i);
@@ -89,7 +90,7 @@ export class ModelRouterBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                execFileSync('npx', ['--no-install', '@claude-flow/cli', 'hooks', 'model-outcome', '--task', outcome.task, '--model', outcome.model, '--outcome', outcome.outcome], { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
+                execFileSync('npx', ['--no-install', cliPkg, 'hooks', 'model-outcome', '--task', outcome.task, '--model', outcome.model, '--outcome', outcome.outcome], { encoding: 'utf-8', timeout: 10000, cwd: this.options.projectRoot });
             }
             catch (error) {
                 // Non-critical: outcome recording is optional

package/dist/adapters/claude-flow/pretrain-bridge.js

@@ -11,7 +11,8 @@
  * - Uses AQE's built-in project analyzer
  * - Generates basic agent configurations
  */
-import { detectClaudeFlow } from './detect.js';
+import { detectClaudeFlow, resolveCliPackage } from './detect.js';
+const cliPkg = resolveCliPackage();
 import { safeJsonParse } from '../../shared/safe-json.js';
 import { toErrorMessage } from '../../shared/error-utils.js';
 /**
@@ -50,7 +51,7 @@ export class PretrainBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const result = execFileSync('npx', ['--no-install', '@claude-flow/cli', 'hooks', 'pretrain', '--path', targetPath, '--depth', depth], { encoding: 'utf-8', timeout: 120000, cwd: this.options.projectRoot });
+                const result = execFileSync('npx', ['--no-install', cliPkg, 'hooks', 'pretrain', '--path', targetPath, '--depth', depth], { encoding: 'utf-8', timeout: 120000, cwd: this.options.projectRoot });
                 // Try to parse JSON result
                 try {
                     const parsed = safeJsonParse(result);
@@ -88,7 +89,7 @@ export class PretrainBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const result = execFileSync('npx', ['--no-install', '@claude-flow/cli', 'hooks', 'build-agents', '--format', format], { encoding: 'utf-8', timeout: 60000, cwd: this.options.projectRoot });
+                const result = execFileSync('npx', ['--no-install', cliPkg, 'hooks', 'build-agents', '--format', format], { encoding: 'utf-8', timeout: 60000, cwd: this.options.projectRoot });
                 try {
                     return safeJsonParse(result);
                 }
@@ -112,7 +113,7 @@ export class PretrainBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const result = execFileSync('npx', ['--no-install', '@claude-flow/cli', 'hooks', 'transfer', '--source-path', sourcePath, '--min-confidence', String(minConfidence)], { encoding: 'utf-8', timeout: 60000, cwd: this.options.projectRoot });
+                const result = execFileSync('npx', ['--no-install', cliPkg, 'hooks', 'transfer', '--source-path', sourcePath, '--min-confidence', String(minConfidence)], { encoding: 'utf-8', timeout: 60000, cwd: this.options.projectRoot });
                 const transferredMatch = result.match(/transferred[:\s]+(\d+)/i);
                 const skippedMatch = result.match(/skipped[:\s]+(\d+)/i);
                 return {

package/dist/adapters/claude-flow/trajectory-bridge.js

@@ -1,5 +1,6 @@
 import { randomUUID } from 'node:crypto';
-import { detectClaudeFlow } from './detect.js';
+import { detectClaudeFlow, resolveCliPackage } from './detect.js';
+const cliPkg = resolveCliPackage();
 /**
  * Trajectory Bridge for SONA integration
  */
@@ -30,7 +31,7 @@ export class TrajectoryBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const args = ['--no-install', '@claude-flow/cli', 'hooks', 'intelligence', 'trajectory-start', '--task', task];
+                const args = ['--no-install', cliPkg, 'hooks', 'intelligence', 'trajectory-start', '--task', task];
                 if (agent) {
                     args.push('--agent', agent);
                 }
@@ -63,7 +64,7 @@ export class TrajectoryBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const args = ['--no-install', '@claude-flow/cli', 'hooks', 'intelligence', 'trajectory-step', '--trajectory-id', trajectoryId, '--action', action];
+                const args = ['--no-install', cliPkg, 'hooks', 'intelligence', 'trajectory-step', '--trajectory-id', trajectoryId, '--action', action];
                 if (result) {
                     args.push('--result', result);
                 }
@@ -97,7 +98,7 @@ export class TrajectoryBridge {
         if (this.claudeFlowAvailable) {
             try {
                 const { execFileSync } = await import('child_process');
-                const args = ['--no-install', '@claude-flow/cli', 'hooks', 'intelligence', 'trajectory-end', '--trajectory-id', trajectoryId, '--success', String(success)];
+                const args = ['--no-install', cliPkg, 'hooks', 'intelligence', 'trajectory-end', '--trajectory-id', trajectoryId, '--success', String(success)];
                 if (feedback) {
                     args.push('--feedback', feedback);
                 }

package/dist/cli/bundle.js

@@ -22719,6 +22719,7 @@ import {
   existsSync as existsSync30,
   mkdirSync as mkdirSync13,
   readdirSync as readdirSync13,
+  readFileSync as readFileSync22,
   writeFileSync as writeFileSync11,
   copyFileSync as copyFileSync7
 } from "fs";
@@ -22753,23 +22754,56 @@ var init_opencode_installer = __esm({
       // Source Directory Detection
       // ==========================================================================
       /**
-       * Find the source .opencode/ directory
+       * Find the source .opencode/ directory containing agents/skills/tools to install.
+       * Resolves relative to the package installation directory (not CWD) so that
+       * globally-installed and bundled CLI paths all work correctly (#361).
        */
       findSourceDir() {
+        const targetDir = join34(this.projectRoot, ".opencode");
         const possiblePaths = [
-          // Development: src/init/ or dist/init/ -> project root
+          // From dist/init/ or src/init/ → package root .opencode/
           join34(__dirname3, "../../.opencode"),
-          // From project root (CWD)
-          join34(process.cwd(), ".opencode"),
-          // NPM package location
-          join34(__dirname3, "../../assets/opencode")
-        ];
+          // From dist/cli/ (bundle) → package root .opencode/
+          join34(__dirname3, "../.opencode"),
+          // require.resolve fallback: find the package root via its package.json
+          this.resolveViaPackageJson()
+        ].filter((p74) => p74 !== null);
         for (const path38 of possiblePaths) {
-          if (existsSync30(path38)) {
+          if (path38 === targetDir) continue;
+          if (this.isValidSourceDir(path38)) {
             return path38;
           }
         }
-        return join34(process.cwd(), ".opencode");
+        return possiblePaths[0] ?? join34(__dirname3, "../../.opencode");
+      }
+      /**
+       * Try to find the package root via require.resolve on our own package.json,
+       * then return <root>/.opencode. Returns null if resolution fails.
+       */
+      resolveViaPackageJson() {
+        try {
+          let dir = __dirname3;
+          for (let i58 = 0; i58 < 5; i58++) {
+            const pkgPath = join34(dir, "package.json");
+            if (existsSync30(pkgPath)) {
+              const pkg = JSON.parse(readFileSync22(pkgPath, "utf-8"));
+              if (pkg.name === "agentic-qe") {
+                return join34(dir, ".opencode");
+              }
+            }
+            dir = dirname9(dir);
+          }
+        } catch {
+        }
+        return null;
+      }
+      /**
+       * Check if a directory is a valid source for OpenCode assets
+       * (must exist and contain at least an agents/ or skills/ subdirectory)
+       */
+      isValidSourceDir(dir) {
+        if (!existsSync30(dir)) return false;
+        return existsSync30(join34(dir, "agents")) || existsSync30(join34(dir, "skills"));
       }
       // ==========================================================================
       // Installation
@@ -23009,16 +23043,21 @@ var init_kiro_installer = __esm({
       // ==========================================================================
       findOpenCodeDir() {
         const possiblePaths = [
+          // Development: src/init/ or dist/init/ -> project root
           join35(__dirname4, "../../.opencode"),
-          join35(process.cwd(), ".opencode"),
-          join35(process.cwd(), ".opencode")
+          // NPM package location
+          join35(__dirname4, "../../assets/opencode")
         ];
         for (const p74 of possiblePaths) {
-          if (existsSync31(p74)) {
+          if (existsSync31(p74) && (existsSync31(join35(p74, "agents")) || existsSync31(join35(p74, "skills")))) {
             return p74;
           }
         }
-        return join35(process.cwd(), ".opencode");
+        const cwdPath = join35(process.cwd(), ".opencode");
+        if (existsSync31(cwdPath) && (existsSync31(join35(cwdPath, "agents")) || existsSync31(join35(cwdPath, "skills")))) {
+          return cwdPath;
+        }
+        return possiblePaths[0];
       }
       // ==========================================================================
       // Installation
@@ -122207,8 +122246,9 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    * QESONA (Self-Optimizing Neural Architecture) for pattern learning
    * Provides <0.05ms pattern adaptation via @ruvector/sona
    * Now uses PersistentSONAEngine to survive restarts
+   * Nullable: init may fail (e.g. during `aqe init`) — coordinator degrades gracefully
    */
-  sona;
+  sona = null;
   /**
    * DreamScheduler for offline pattern consolidation and insight generation
    * Wraps DreamEngine with automatic scheduling and trigger support
@@ -122220,7 +122260,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
   /**
    * Initialize the coordinator.
    * CQ-002: Domain-specific initialization
-   * Throws if QESONA fails to initialize.
+   * SONA init failure is non-fatal — coordinator degrades gracefully (#359).
    */
   async onInitialize() {
     try {
@@ -122234,7 +122274,8 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
       console.log("[LearningOptimizationCoordinator] PersistentSONAEngine initialized for pattern learning");
     } catch (error) {
       console.error("[LearningOptimizationCoordinator] Failed to initialize PersistentSONAEngine:", error);
-      throw error;
+      console.warn("[LearningOptimizationCoordinator] Continuing without SONA pattern persistence");
+      this.sona = null;
     }
     if (this.config.enableDreamScheduler) {
       try {
@@ -122604,6 +122645,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   learnPattern(state3, action, outcome, patternType, domain, metadata) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.createPattern(state3, action, outcome, patternType, domain, metadata);
   }
   /**
@@ -122616,6 +122658,16 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
       );
     }
   }
+  /**
+   * Ensure SONA engine is available (may be null if init failed gracefully).
+   */
+  ensureSONAAvailable() {
+    if (!this.sona) {
+      throw new Error(
+        "[LearningOptimizationCoordinator] SONA engine is not available. Pattern persistence failed during initialization."
+      );
+    }
+  }
   /**
    * Adapt a pattern based on current context using QESONA.
    * Leverages @ruvector/sona's HNSW-indexed pattern matching for <0.05ms adaptation.
@@ -122628,6 +122680,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   async adaptPattern(state3, patternType, domain) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.adaptPattern(state3, patternType, domain);
   }
   /**
@@ -122638,6 +122691,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   getSONAStats() {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.getStats();
   }
   /**
@@ -122648,6 +122702,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   getSONAPatterns() {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.getAllPatterns();
   }
   /**
@@ -122659,6 +122714,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   getSONAPatternsByType(type) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.getPatternsByType(type);
   }
   /**
@@ -122670,6 +122726,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   getSONAPatternsByDomain(domain) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.getPatternsByDomain(domain);
   }
   /**
@@ -122684,6 +122741,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   updateSONAPattern(patternId, success, quality) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.updatePattern(patternId, success, quality);
   }
   /**
@@ -122695,6 +122753,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   forceSONALearning() {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.forceLearn();
   }
   /**
@@ -122703,7 +122762,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    * @returns True if SONA is available
    */
   isSONAAvailable() {
-    return this.initialized;
+    return this.initialized && this.sona !== null;
   }
   /**
    * Export all QESONA patterns for persistence or transfer.
@@ -122713,6 +122772,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   exportSONAPatterns() {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.exportPatterns();
   }
   /**
@@ -122724,6 +122784,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   importSONAPatterns(patterns) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     this.sona.importPatterns(patterns);
   }
   /**
@@ -122735,6 +122796,7 @@ var LearningOptimizationCoordinator = class extends BaseDomainCoordinator {
    */
   async verifySONAPerformance(iterations = 100) {
     this.ensureInitialized();
+    this.ensureSONAAvailable();
     return this.sona.verifyPerformance(iterations);
   }
   // ============================================================================
@@ -123443,6 +123505,8 @@ var LearningOptimizationPlugin = class extends BaseDomainPlugin {
    */
   getAPI() {
     const api = {
+      // Availability check
+      isSONAAvailable: () => this.coordinator?.isSONAAvailable() ?? false,
       // Coordinator methods
       runLearningCycle: this.runLearningCycle.bind(this),
       optimizeAllStrategies: this.optimizeAllStrategies.bind(this),
@@ -139344,7 +139408,7 @@ var ALL_DOMAINS2 = [
   "enterprise-integration"
 ];
 function getAQEVersion() {
-  return true ? "3.8.1" : "3.0.0";
+  return true ? "3.8.2" : "3.0.0";
 }
 function createDefaultConfig(projectName, projectRoot) {
   return {
@@ -140303,8 +140367,9 @@ function generateAqeEnvVars(config) {
     AQE_V3_SUCCESS_RATE_THRESHOLD: String(config.learning?.qualityThreshold ?? 0.7)
   };
 }
-function generateV3SettingsSections(config) {
+function generateV3SettingsSections(config, projectRoot) {
   const domains = config.domains?.enabled || [];
+  const fallback = projectRoot ? `echo ${JSON.stringify(projectRoot)}` : "pwd";
   return {
     aqe: {
       version: config.version ?? "3.0.0",
@@ -140313,21 +140378,20 @@ function generateV3SettingsSections(config) {
     },
     statusLine: {
       type: "command",
-      command: 'node "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.claude/helpers/statusline-v3.cjs" 2>/dev/null || echo "\u258A Agentic QE v3"',
+      command: `node "$(git rev-parse --show-toplevel 2>/dev/null || ${fallback})/.claude/helpers/statusline-v3.cjs" 2>/dev/null || echo "\u258A Agentic QE v3"`,
       refreshMs: 5e3,
       enabled: true
     },
-    permissions: {
-      allow: [
-        "Bash(npx claude-flow:*)",
-        "Bash(npx @claude-flow/cli:*)",
-        "mcp__claude-flow__:*",
-        "mcp__agentic-qe__*"
-      ],
-      deny: [
-        "Bash(rm -rf /)"
-      ]
-    },
+    // permissions are union-merged in 07-hooks.ts — not set here to avoid overwriting user entries (#362)
+    _aqePermissions: [
+      "Bash(npx ruflo:*)",
+      "Bash(npx @ruflo/cli:*)",
+      "Bash(npx claude-flow:*)",
+      "Bash(npx @claude-flow/cli:*)",
+      "mcp__ruflo__:*",
+      "mcp__claude-flow__:*",
+      "mcp__agentic-qe__*"
+    ],
     includeCoAuthoredBy: true,
     v3Configuration: {
       domains: {
@@ -140499,7 +140563,7 @@ async function configureHooks(projectRoot, config) {
     ...existingEnv,
     ...generateAqeEnvVars(config)
   };
-  const v3Sections = generateV3SettingsSections(config);
+  const v3Sections = generateV3SettingsSections(config, projectRoot);
   for (const [key, value] of Object.entries(v3Sections)) {
     settings[key] = value;
   }
@@ -140803,7 +140867,7 @@ Task({ prompt: "Run security audit", subagent_type: "qe-security-scanner", run_i
 
 \`\`\`javascript
 // STEP 1: Initialize Claude Flow swarm for coordination
-Bash("npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 15")
+Bash("npx ruflo swarm init --topology hierarchical --max-agents 15")
 
 // STEP 2: Initialize AQE Fleet for QE-specific work
 mcp__agentic-qe__fleet_init({
@@ -140816,7 +140880,7 @@ Task({ prompt: "Analyze coverage gaps", subagent_type: "qe-coverage-specialist",
 
 // STEP 4: Store learnings in both systems
 mcp__agentic-qe__memory_store({ key: "pattern-1", value: "...", namespace: "qe-patterns", persist: true })
-Bash("npx @claude-flow/cli@latest memory store --key 'qe-pattern-1' --value '...' --namespace patterns")
+Bash("npx ruflo memory store --key 'qe-pattern-1' --value '...' --namespace patterns")
 \`\`\`
 
 ### Data Storage
@@ -141552,6 +141616,25 @@ ${capsSection}
 }
 
 // src/init/agents-installer.ts
+function bumpUpdatedDate(content) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!fmMatch) return content;
+  const fm = fmMatch[1];
+  let newFm;
+  if (/^updated:/m.test(fm)) {
+    newFm = fm.replace(/^updated:.*$/m, `updated: ${today}`);
+  } else if (/^created:/m.test(fm)) {
+    newFm = fm.replace(/^(created:.*$)/m, `$1
+updated: ${today}`);
+  } else {
+    newFm = fm + `
+updated: ${today}`;
+  }
+  return content.replace(/^---\n[\s\S]*?\n---/, `---
+${newFm}
+---`);
+}
 var V3_QE_AGENTS = [
   // Test Generation Domain
   "qe-test-architect",
@@ -141790,7 +141873,8 @@ var AgentsInstaller = class {
       try {
         const agentContent = readFileSync18(agentFile, "utf-8");
         const { content: modifiedContent, applied } = applyOverlayToContent(agentContent, overlay);
-        writeFileSync5(agentFile, modifiedContent, "utf-8");
+        const finalContent = bumpUpdatedDate(modifiedContent);
+        writeFileSync5(agentFile, finalContent, "utf-8");
         result.overlaysApplied.push(agentName);
         const changes = [
           ...applied.replacedFields.map((f74) => `replaced:${f74}`),
@@ -143829,7 +143913,7 @@ var HooksPhase = class extends BasePhase {
         settings = {};
       }
     }
-    const aqeHooks = this.generateHooksConfig(config);
+    const aqeHooks = this.generateHooksConfig(config, projectRoot);
     const hookTypes = Object.keys(aqeHooks);
     const existingHooks = settings.hooks || {};
     const existingAqeDetected = this.hasExistingAqeHooks(existingHooks);
@@ -143842,9 +143926,20 @@ var HooksPhase = class extends BasePhase {
       ...existingEnv,
       ...generateAqeEnvVars(config)
     };
-    const v3Sections = generateV3SettingsSections(config);
+    const v3Sections = generateV3SettingsSections(config, projectRoot);
     for (const [key, value] of Object.entries(v3Sections)) {
-      settings[key] = value;
+      if (key === "_aqePermissions") {
+        const existingPerms = settings.permissions || {};
+        const existingAllow = existingPerms.allow || [];
+        const aqeEntries = value;
+        const merged = [.../* @__PURE__ */ new Set([...existingAllow, ...aqeEntries])];
+        settings.permissions = {
+          ...existingPerms,
+          allow: merged
+        };
+      } else {
+        settings[key] = value;
+      }
     }
     let existingMcp = settings.enabledMcpjsonServers || [];
     existingMcp = existingMcp.filter((s70) => s70 !== "aqe");
@@ -144126,7 +144221,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
    * Uses `npx agentic-qe` for portability - works without global installation.
    * All hooks use --json output for structured data and fail silently with continueOnError.
    */
-  generateHooksConfig(_config) {
+  generateHooksConfig(_config, projectRoot) {
     return {
       PreToolUse: [
         // File guardian — MUST be first to block before learning hooks run
@@ -144240,7 +144335,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
           hooks: [
             {
               type: "command",
-              command: 'node "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.claude/helpers/brain-checkpoint.cjs" verify --json',
+              command: `node "$(git rev-parse --show-toplevel 2>/dev/null || echo ${JSON.stringify(projectRoot)})/.claude/helpers/brain-checkpoint.cjs" verify --json`,
               timeout: 5e3,
               continueOnError: true
             }
@@ -144262,7 +144357,7 @@ if (process.argv.includes('--json')) process.stdout.write(JSON.stringify(result)
           hooks: [
             {
               type: "command",
-              command: 'node "$(git rev-parse --show-toplevel 2>/dev/null || pwd)/.claude/helpers/brain-checkpoint.cjs" export --json',
+              command: `node "$(git rev-parse --show-toplevel 2>/dev/null || echo ${JSON.stringify(projectRoot)})/.claude/helpers/brain-checkpoint.cjs" export --json`,
               timeout: 6e4,
               continueOnError: true
             }
@@ -146864,7 +146959,7 @@ function checkMCPConfig(projectRoot) {
   if (existsSync45(mcpJsonPath)) {
     try {
       const config = safeJsonParse(readFileSync37(mcpJsonPath, "utf-8"));
-      if (config.mcpServers?.["claude-flow"]) {
+      if (config.mcpServers?.["ruflo"] || config.mcpServers?.["claude-flow"]) {
         return { available: true, method: "mcp-config" };
       }
     } catch {
@@ -146875,7 +146970,7 @@ function checkMCPConfig(projectRoot) {
     try {
       const settings = safeJsonParse(readFileSync37(settingsPath, "utf-8"));
       const servers = settings.mcpServers || settings.mcp?.servers || {};
-      if (servers["claude-flow"] || servers["@anthropic/claude-flow"]) {
+      if (servers["ruflo"] || servers["claude-flow"] || servers["@anthropic/claude-flow"]) {
         return { available: true, method: "mcp-config" };
       }
     } catch {
@@ -146889,7 +146984,7 @@ function checkPackageJson(projectRoot) {
   try {
     const pkg = safeJsonParse(readFileSync37(packageJsonPath, "utf-8"));
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-    if (deps["@claude-flow/cli"] || deps["claude-flow"]) {
+    if (deps["ruflo"] || deps["@claude-flow/cli"] || deps["claude-flow"]) {
       return { available: true, method: "npm-dependency" };
     }
   } catch {
@@ -146897,17 +146992,19 @@ function checkPackageJson(projectRoot) {
   return null;
 }
 function checkLocalBinary(projectRoot) {
-  try {
-    const result = execSync6("npx --no-install @claude-flow/cli --version", {
-      encoding: "utf-8",
-      timeout: 5e3,
-      cwd: projectRoot,
-      stdio: ["pipe", "pipe", "pipe"]
-      // suppress stderr noise
-    });
-    const version2 = result.trim().match(/\d+\.\d+\.\d+[\w.-]*/)?.[0];
-    return { available: true, method: "npx-cached", version: version2 };
-  } catch {
+  for (const pkg of ["ruflo", "@claude-flow/cli"]) {
+    try {
+      const result = execSync6(`npx --no-install ${pkg} --version`, {
+        encoding: "utf-8",
+        timeout: 5e3,
+        cwd: projectRoot,
+        stdio: ["pipe", "pipe", "pipe"]
+        // suppress stderr noise
+      });
+      const version2 = result.trim().match(/\d+\.\d+\.\d+[\w.-]*/)?.[0];
+      return { available: true, method: "npx-cached", version: version2 };
+    } catch {
+    }
   }
   return null;
 }
@@ -146921,8 +147018,8 @@ function getClaudeFlowNotFoundMessage() {
     "    - Codebase pretrain analysis",
     "",
     "  To install later:",
-    "    npm install -g @claude-flow/cli",
-    "    claude mcp add claude-flow -- npx -y @claude-flow/cli@latest",
+    "    npm install -g ruflo",
+    "    claude mcp add ruflo -- npx -y ruflo@3.5.18",
     "    aqe init --auto --with-claude-flow"
   ].join("\n");
 }
@@ -147010,10 +147107,10 @@ function updateMCPConfig(projectRoot) {
     settings.mcpServers = {};
   }
   const servers = settings.mcpServers;
-  if (!servers["claude-flow"]) {
-    servers["claude-flow"] = {
+  if (!servers["ruflo"] && !servers["claude-flow"]) {
+    servers["ruflo"] = {
       command: "npx",
-      args: ["@anthropic/claude-flow", "mcp"],
+      args: ["ruflo@3.5.18", "mcp"],
       env: {}
     };
   }
@@ -147022,7 +147119,7 @@ function updateMCPConfig(projectRoot) {
 async function runPretrainAnalysis(projectRoot, debug) {
   try {
     if (debug) console.log("[ClaudeFlow] Running pretrain analysis...");
-    execSync7("npx --no-install @claude-flow/cli hooks pretrain --depth medium", {
+    execSync7("npx --no-install ruflo hooks pretrain --depth medium", {
       encoding: "utf-8",
       timeout: 12e4,
       // 2 minutes
@@ -170052,7 +170149,7 @@ async function cleanupAndExit(code = 0) {
   process.exit(code);
 }
 var program = new Command22();
-var VERSION = true ? "3.8.1" : "0.0.0-dev";
+var VERSION = true ? "3.8.2" : "0.0.0-dev";
 program.name("aqe").description("Agentic QE - Domain-Driven Quality Engineering").version(VERSION);
 var registry2 = createCommandRegistry(context, cleanupAndExit, ensureInitialized, ensureInitializedStrict);
 registry2.registerAll(program);

package/dist/cli/commands/claude-flow-setup.js

@@ -137,10 +137,10 @@ function updateMCPConfig(projectRoot) {
     }
     // Add claude-flow server if not present
     const servers = settings.mcpServers;
-    if (!servers['claude-flow']) {
-        servers['claude-flow'] = {
+    if (!servers['ruflo'] && !servers['claude-flow']) {
+        servers['ruflo'] = {
             command: 'npx',
-            args: ['@anthropic/claude-flow', 'mcp'],
+            args: ['ruflo@3.5.18', 'mcp'],
             env: {},
         };
     }
@@ -155,7 +155,7 @@ async function runPretrainAnalysis(projectRoot, debug) {
     try {
         if (debug)
             console.log('[ClaudeFlow] Running pretrain analysis...');
-        execSync('npx --no-install @claude-flow/cli hooks pretrain --depth medium', {
+        execSync('npx --no-install ruflo hooks pretrain --depth medium', {
             encoding: 'utf-8',
             timeout: 120000, // 2 minutes
             cwd: projectRoot,