ruvnet/ruflo · error · QEHiveError

Swarm coordination failed

Error message

Swarm coordination failed

What it means

The swarm coordination pipeline (dispatch, result collection, aggregation) aborted with an exception before a QESwarmResult could be produced — this is a hard failure, not a below-quorum partial result.

Source

Thrown at v3/plugins/agentic-qe/src/bridges/QEHiveBridge.ts:287

      const results = await this.collectResults(task);

      // 4. Aggregate results
      const success = results.filter((r) => r.success).length >= Math.ceil(task.agents.length / 2);

      const swarmResult: QESwarmResult = {
        taskId: task.id,
        agentResults: results,
        completedAgents: results.length,
        totalAgents: task.agents.length,
        success,
        aggregatedOutput: this.aggregateResults(results),
      };

      this.logger.info(`QE swarm task complete: ${task.id} (success: ${success})`);
      return swarmResult;
    } catch (error) {
      this.logger.error(`QE swarm task failed: ${task.id}`, error);
      throw new QEHiveError('Swarm coordination failed', error as Error);
    }
  }

  /**
   * Execute operation with Byzantine fault tolerance
   */
  async executeWithBFT<T>(
    operation: () => Promise<T>,
    replicaCount: number = 3
  ): Promise<T> {
    this.ensureInitialized();

    this.logger.debug(`Executing operation with BFT (replicas: ${replicaCount})`);

    const results: T[] = [];
    const errors: Error[] = [];

    // Execute operation on multiple replicas

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check hive connectivity and worker health before coordinating.
2. Inspect the underlying coordination error.

When it happens

Trigger: Thrown at v3/plugins/agentic-qe/src/bridges/QEHiveBridge.ts:287 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/e97d1bcc3689a995. Report an issue: GitHub.