agentic-qe 3.8.1 → 3.8.3

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,

package/dist/domains/learning-optimization/coordinator.d.ts

@@ -65,6 +65,7 @@ export declare class LearningOptimizationCoordinator extends BaseDomainCoordinat
      * 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
      */
     private sona;
     /**
@@ -76,7 +77,7 @@ export declare class LearningOptimizationCoordinator extends BaseDomainCoordinat
     /**
      * Initialize the coordinator.
      * CQ-002: Domain-specific initialization
-     * Throws if QESONA fails to initialize.
+     * SONA init failure is non-fatal — coordinator degrades gracefully (#359).
      */
     protected onInitialize(): Promise<void>;
     /**
@@ -122,6 +123,10 @@ export declare class LearningOptimizationCoordinator extends BaseDomainCoordinat
      * Ensure the coordinator is initialized before use.
      */
     private ensureInitialized;
+    /**
+     * Ensure SONA engine is available (may be null if init failed gracefully).
+     */
+    private ensureSONAAvailable;
     /**
      * Adapt a pattern based on current context using QESONA.
      * Leverages @ruvector/sona's HNSW-indexed pattern matching for <0.05ms adaptation.

package/dist/domains/learning-optimization/coordinator.js

@@ -53,8 +53,9 @@ export class LearningOptimizationCoordinator 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
@@ -78,7 +79,7 @@ export class LearningOptimizationCoordinator 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() {
         // Initialize QESONA for neural pattern learning (persistent patterns)
@@ -93,8 +94,10 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
             console.log('[LearningOptimizationCoordinator] PersistentSONAEngine initialized for pattern learning');
         }
         catch (error) {
+            // SONA is an enhancement, not a hard requirement — degrade gracefully (#359)
             console.error('[LearningOptimizationCoordinator] Failed to initialize PersistentSONAEngine:', error);
-            throw error; // Learning optimization requires SONA
+            console.warn('[LearningOptimizationCoordinator] Continuing without SONA pattern persistence');
+            this.sona = null;
         }
         // Initialize DreamScheduler if enabled
         if (this.config.enableDreamScheduler) {
@@ -484,6 +487,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     learnPattern(state, action, outcome, patternType, domain, metadata) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.createPattern(state, action, outcome, patternType, domain, metadata);
     }
     /**
@@ -494,6 +498,14 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
             throw new Error('[LearningOptimizationCoordinator] Not initialized. Call initialize() first.');
         }
     }
+    /**
+     * 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.
@@ -506,6 +518,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     async adaptPattern(state, patternType, domain) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.adaptPattern(state, patternType, domain);
     }
     /**
@@ -516,6 +529,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     getSONAStats() {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.getStats();
     }
     /**
@@ -526,6 +540,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     getSONAPatterns() {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.getAllPatterns();
     }
     /**
@@ -537,6 +552,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     getSONAPatternsByType(type) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.getPatternsByType(type);
     }
     /**
@@ -548,6 +564,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     getSONAPatternsByDomain(domain) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.getPatternsByDomain(domain);
     }
     /**
@@ -562,6 +579,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     updateSONAPattern(patternId, success, quality) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.updatePattern(patternId, success, quality);
     }
     /**
@@ -573,6 +591,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     forceSONALearning() {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.forceLearn();
     }
     /**
@@ -581,7 +600,7 @@ export class LearningOptimizationCoordinator 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.
@@ -591,6 +610,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     exportSONAPatterns() {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.exportPatterns();
     }
     /**
@@ -602,6 +622,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     importSONAPatterns(patterns) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         this.sona.importPatterns(patterns);
     }
     /**
@@ -613,6 +634,7 @@ export class LearningOptimizationCoordinator extends BaseDomainCoordinator {
      */
     async verifySONAPerformance(iterations = 100) {
         this.ensureInitialized();
+        this.ensureSONAAvailable();
         return this.sona.verifyPerformance(iterations);
     }
     // ============================================================================

package/dist/domains/learning-optimization/plugin.d.ts

@@ -22,6 +22,8 @@ export interface LearningOptimizationPluginConfig {
  * Public API for the learning-optimization domain
  */
 export interface LearningOptimizationAPI {
+    /** Check if SONA pattern engine is available (may be false if init failed) */
+    isSONAAvailable(): boolean;
     runLearningCycle(domain: DomainName): Promise<Result<LearningCycleReport>>;
     optimizeAllStrategies(): Promise<Result<OptimizationReport>>;
     shareCrossDomainLearnings(): Promise<Result<CrossDomainSharingReport>>;

package/dist/domains/learning-optimization/plugin.js

@@ -42,6 +42,8 @@ export class LearningOptimizationPlugin extends BaseDomainPlugin {
      */
     getAPI() {
         const api = {
+            // Availability check
+            isSONAAvailable: () => this.coordinator?.isSONAAvailable() ?? false,
             // Coordinator methods
             runLearningCycle: this.runLearningCycle.bind(this),
             optimizeAllStrategies: this.optimizeAllStrategies.bind(this),

package/dist/governance/adversarial-defense-integration.js

@@ -3,6 +3,7 @@ import { randomUUID } from 'node:crypto';
  * Adversarial Defense Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance adversarial defense capabilities to AQE's agent system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides prompt injection detection, input sanitization, threat scoring,
  * automatic blocking, and trust integration.
  *

package/dist/governance/continue-gate-integration.d.ts

@@ -2,6 +2,7 @@
  * ContinueGate Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance ContinueGate to the AQE agent coordination loop.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides loop detection, throttling, and automatic escalation.
  *
  * @module governance/continue-gate-integration

package/dist/governance/continue-gate-integration.js

@@ -2,6 +2,7 @@
  * ContinueGate Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance ContinueGate to the AQE agent coordination loop.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides loop detection, throttling, and automatic escalation.
  *
  * @module governance/continue-gate-integration

package/dist/governance/deterministic-gateway-integration.d.ts

@@ -2,6 +2,7 @@
  * DeterministicToolGateway Integration for Agentic QE Fleet
  *
  * Wires tool idempotency enforcement to the AQE agent coordination.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides idempotency key generation, request deduplication, schema validation,
  * and response caching for idempotent operations.
  *

package/dist/governance/deterministic-gateway-integration.js

@@ -2,6 +2,7 @@
  * DeterministicToolGateway Integration for Agentic QE Fleet
  *
  * Wires tool idempotency enforcement to the AQE agent coordination.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides idempotency key generation, request deduplication, schema validation,
  * and response caching for idempotent operations.
  *

package/dist/governance/evolution-pipeline-integration.d.ts

@@ -2,6 +2,7 @@
  * Evolution Pipeline Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance Evolution Pipeline to AQE's ReasoningBank learning system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides rule effectiveness tracking, pattern promotion/demotion, A/B testing for
  * rule variants, and learning from agent task outcomes.
  *

package/dist/governance/evolution-pipeline-integration.js

@@ -2,6 +2,7 @@
  * Evolution Pipeline Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance Evolution Pipeline to AQE's ReasoningBank learning system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides rule effectiveness tracking, pattern promotion/demotion, A/B testing for
  * rule variants, and learning from agent task outcomes.
  *

package/dist/governance/memory-write-gate-integration.d.ts

@@ -2,6 +2,7 @@
  * MemoryWriteGate Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance MemoryWriteGate to ReasoningBank.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides contradiction detection, temporal decay, and domain namespacing.
  *
  * @module governance/memory-write-gate-integration

package/dist/governance/memory-write-gate-integration.js

@@ -2,6 +2,7 @@
  * MemoryWriteGate Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance MemoryWriteGate to ReasoningBank.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides contradiction detection, temporal decay, and domain namespacing.
  *
  * @module governance/memory-write-gate-integration

package/dist/governance/proof-envelope-integration.d.ts

@@ -1,5 +1,6 @@
 /**
  * Proof Envelope Integration for Agentic QE Fleet
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  *
  * Provides hash-chained audit trails with cryptographic proof generation,
  * tamper detection, and action attestation for governance compliance.

package/dist/governance/proof-envelope-integration.js

@@ -2,6 +2,7 @@ import { randomUUID } from 'node:crypto';
 import { safeJsonParse } from '../shared/safe-json.js';
 /**
  * Proof Envelope Integration for Agentic QE Fleet
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  *
  * Provides hash-chained audit trails with cryptographic proof generation,
  * tamper detection, and action attestation for governance compliance.

package/dist/governance/shard-retriever-integration.d.ts

@@ -2,6 +2,7 @@
  * ShardRetriever Integration for Agentic QE Fleet
  *
  * Provides semantic shard retrieval from the @claude-flow/guidance system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Loads, parses, and matches domain shards to tasks based on intent and context.
  *
  * Features:

package/dist/governance/shard-retriever-integration.js

@@ -2,6 +2,7 @@
  * ShardRetriever Integration for Agentic QE Fleet
  *
  * Provides semantic shard retrieval from the @claude-flow/guidance system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Loads, parses, and matches domain shards to tasks based on intent and context.
  *
  * Features:

package/dist/governance/trust-accumulator-integration.d.ts

@@ -2,6 +2,7 @@
  * TrustAccumulator Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance TrustAccumulator to AQE's agent routing system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides trust scoring, tier assignment, and intelligent agent selection.
  *
  * Trust tiers:

package/dist/governance/trust-accumulator-integration.js

@@ -2,6 +2,7 @@
  * TrustAccumulator Integration for Agentic QE Fleet
  *
  * Wires @claude-flow/guidance TrustAccumulator to AQE's agent routing system.
+ * TODO(ruflo-rebrand): Replace @claude-flow/guidance with @ruflo/guidance when published
  * Provides trust scoring, tier assignment, and intelligent agent selection.
  *
  * Trust tiers:

package/dist/init/agents-installer.js

@@ -12,6 +12,31 @@ import { toErrorMessage } from '../shared/error-utils.js';
 import { loadOverlays, applyOverlayToContent } from '../agents/overlay-loader.js';
 import { validateFleetMcpDeps } from '../validation/steps/agent-mcp-validator.js';
 // ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Bump the `updated:` field in YAML frontmatter to today's date.
+ * If no `updated:` field exists, one is added after `created:` (or at end of frontmatter).
+ */
+function bumpUpdatedDate(content) {
+    const today = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+    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\nupdated: ${today}`);
+    }
+    else {
+        newFm = fm + `\nupdated: ${today}`;
+    }
+    return content.replace(/^---\n[\s\S]*?\n---/, `---\n${newFm}\n---`);
+}
+// ============================================================================
 // Agent Categories
 // ============================================================================
 /**
@@ -283,7 +308,9 @@ export class AgentsInstaller {
             try {
                 const agentContent = readFileSync(agentFile, 'utf-8');
                 const { content: modifiedContent, applied } = applyOverlayToContent(agentContent, overlay);
-                writeFileSync(agentFile, modifiedContent, 'utf-8');
+                // Bump the `updated` date in frontmatter when content is modified (#365)
+                const finalContent = bumpUpdatedDate(modifiedContent);
+                writeFileSync(agentFile, finalContent, 'utf-8');
                 result.overlaysApplied.push(agentName);
                 const changes = [
                     ...applied.replacedFields.map(f => `replaced:${f}`),

package/dist/init/enhancements/claude-flow-adapter.js

@@ -14,15 +14,28 @@ import { safeJsonParse } from '../../shared/safe-json.js';
 /** Shared execFileSync options */
 const EXEC_OPTS = { encoding: 'utf-8' };
 /**
- * Build args array for npx @claude-flow/cli calls.
+ * Build args array for npx ruflo / @claude-flow/cli calls.
+ * Uses ruflo first with @claude-flow/cli fallback (matching detect.ts).
  * Using execFileSync with explicit args prevents shell injection.
  */
 function cfCliArgs(...subcommand) {
+    // Lazy-resolve: ruflo preferred, @claude-flow/cli as fallback
+    const pkg = cfCliArgs._resolvedPkg ??= (() => {
+        for (const candidate of ['ruflo', '@claude-flow/cli']) {
+            try {
+                require.resolve(`${candidate}/package.json`);
+                return candidate;
+            }
+            catch { /* next */ }
+        }
+        return 'ruflo';
+    })();
     return {
         bin: 'npx',
-        args: ['--no-install', '@claude-flow/cli', ...subcommand],
+        args: ['--no-install', pkg, ...subcommand],
     };
 }
+cfCliArgs._resolvedPkg = undefined;
 /**
  * Claude Flow Adapter Implementation
  * Falls back gracefully when Claude Flow is not available

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

@@ -174,7 +174,7 @@ export async function configureHooks(projectRoot, config) {
         ...generateAqeEnvVars(config),
     };
     // Apply v3 settings sections
-    const v3Sections = generateV3SettingsSections(config);
+    const v3Sections = generateV3SettingsSections(config, projectRoot);
     for (const [key, value] of Object.entries(v3Sections)) {
         settings[key] = value;
     }
@@ -509,7 +509,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({
@@ -522,7 +522,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

package/dist/init/kiro-installer.js

@@ -36,16 +36,22 @@ export class KiroInstaller {
     // ==========================================================================
     findOpenCodeDir() {
         const possiblePaths = [
+            // Development: src/init/ or dist/init/ -> project root
             join(__dirname, '../../.opencode'),
-            join(process.cwd(), '.opencode'),
-            join(process.cwd(), '.opencode'),
+            // NPM package location
+            join(__dirname, '../../assets/opencode'),
         ];
         for (const p of possiblePaths) {
-            if (existsSync(p)) {
+            if (existsSync(p) && (existsSync(join(p, 'agents')) || existsSync(join(p, 'skills')))) {
                 return p;
             }
         }
-        return join(process.cwd(), '.opencode');
+        // Fallback: CWD .opencode — but only if it has actual source content
+        const cwdPath = join(process.cwd(), '.opencode');
+        if (existsSync(cwdPath) && (existsSync(join(cwdPath, 'agents')) || existsSync(join(cwdPath, 'skills')))) {
+            return cwdPath;
+        }
+        return possiblePaths[0];
     }
     // ==========================================================================
     // Installation

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

@@ -32,9 +32,21 @@ export declare class OpenCodeInstaller {
     private sourceDir;
     constructor(options: OpenCodeInstallerOptions);
     /**
-     * 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).
      */
     private findSourceDir;
+    /**
+     * Try to find the package root via require.resolve on our own package.json,
+     * then return <root>/.opencode. Returns null if resolution fails.
+     */
+    private resolveViaPackageJson;
+    /**
+     * Check if a directory is a valid source for OpenCode assets
+     * (must exist and contain at least an agents/ or skills/ subdirectory)
+     */
+    private isValidSourceDir;
     /**
      * Install OpenCode agents, skills, tools, and permissions
      */

package/dist/init/opencode-installer.js

@@ -5,7 +5,7 @@
  * Installs OpenCode agents, skills, tools, and permissions to user projects
  * when --with-opencode flag is used. Follows the N8n installer pattern.
  */
-import { existsSync, mkdirSync, readdirSync, writeFileSync, copyFileSync, } from 'fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync, } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { toErrorMessage } from '../shared/error-utils.js';
@@ -34,24 +34,63 @@ export class OpenCodeInstaller {
     // 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 = join(this.projectRoot, '.opencode');
         const possiblePaths = [
-            // Development: src/init/ or dist/init/ -> project root
+            // From dist/init/ or src/init/ → package root .opencode/
             join(__dirname, '../../.opencode'),
-            // From project root (CWD)
-            join(process.cwd(), '.opencode'),
-            // NPM package location
-            join(__dirname, '../../assets/opencode'),
-        ];
+            // From dist/cli/ (bundle) → package root .opencode/
+            join(__dirname, '../.opencode'),
+            // require.resolve fallback: find the package root via its package.json
+            this.resolveViaPackageJson(),
+        ].filter((p) => p !== null);
         for (const path of possiblePaths) {
-            if (existsSync(path)) {
+            // Never use the target directory as the source
+            if (path === targetDir)
+                continue;
+            if (this.isValidSourceDir(path)) {
                 return path;
             }
         }
-        // Default to CWD location
-        return join(process.cwd(), '.opencode');
+        // Return the first package path even if not found — install() will report the error
+        return possiblePaths[0] ?? join(__dirname, '../../.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 {
+            // Walk up from __dirname to find the nearest package.json with our name
+            let dir = __dirname;
+            for (let i = 0; i < 5; i++) {
+                const pkgPath = join(dir, 'package.json');
+                if (existsSync(pkgPath)) {
+                    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+                    if (pkg.name === 'agentic-qe') {
+                        return join(dir, '.opencode');
+                    }
+                }
+                dir = dirname(dir);
+            }
+        }
+        catch {
+            // resolution failed
+        }
+        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 (!existsSync(dir))
+            return false;
+        return existsSync(join(dir, 'agents')) || existsSync(join(dir, 'skills'));
     }
     // ==========================================================================
     // Installation
@@ -240,9 +279,8 @@ export class OpenCodeInstaller {
             mcp: {
                 'agentic-qe': {
                     type: 'local',
-                    command: 'npx',
-                    args: ['agentic-qe', 'mcp'],
-                    env: {
+                    command: ['npx', 'agentic-qe', 'mcp'],
+                    environment: {
                         AQE_MEMORY_PATH: '.agentic-qe/memory.db',
                         AQE_V3_MODE: 'true',
                     },