ruvnet/ruflo · error · QEHiveError

QEHiveBridge not initialized. Call registerQueen() first.

Error message

QEHiveBridge not initialized. Call registerQueen() first.

What it means

Lifecycle guard on QEHiveBridge: an operation (spawn, coordinate, BFT, propose, broadcast, store) was invoked while the bridge's initialized flag is false. registerQueen() must complete first to establish the queen identity and hive connection; every public entry point calls ensureInitialized().

Source

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

    } else if (context.includes('test-execution')) {
      baseCapabilities.push(...QE_CAPABILITIES.testExecution);
    } else if (context.includes('coverage')) {
      baseCapabilities.push(...QE_CAPABILITIES.coverageAnalysis);
    } else if (context.includes('quality')) {
      baseCapabilities.push(...QE_CAPABILITIES.qualityAssessment);
    } else if (context.includes('security')) {
      baseCapabilities.push(...QE_CAPABILITIES.securityCompliance);
    }

    return baseCapabilities;
  }

  /**
   * Ensure bridge is initialized
   */
  private ensureInitialized(): void {
    if (!this.initialized) {
      throw new QEHiveError('QEHiveBridge not initialized. Call registerQueen() first.');
    }
  }

  /**
   * Sleep helper
   */
  private sleep(ms: number): Promise<void> {
    return new Promise((resolve) => setTimeout(resolve, ms));
  }
}

/**
 * QE Hive Error class
 */
export class QEHiveError extends Error {
  public readonly cause?: Error;

  constructor(message: string, cause?: Error) {

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Call registerQueen() before using the hive bridge.
2. Guard bridge operations behind an initialized check.

When it happens

Trigger: Thrown at v3/plugins/agentic-qe/src/bridges/QEHiveBridge.ts:588 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/afe931534a30327c. Report an issue: GitHub.