ruvnet/ruflo · error

WasmBridge not initialized. Call initialize() first or await

Error message

WasmBridge not initialized. Call initialize() first or await the initialization promise.

What it means

Guard in ensureInitialized(): a getter for one of the WASM engines (spectral, causal, quantum, category, hott, cohomology) was invoked after dispose() or before initialize() resolved, so this.initialized is still false. The bridge instance is in an unusable lifecycle state, not a WASM failure itself.

Source

Thrown at v3/plugins/prime-radiant/src/wasm-bridge.ts:464

    this.spectralEngine = null;
    this.causalEngine = null;
    this.quantumEngine = null;
    this.categoryEngine = null;
    this.hottEngine = null;
    this.initialized = false;
    this.initPromise = null;

    if (this.config.enableLogging) {
      console.log('[Prime Radiant] WASM bridge disposed');
    }
  }

  /**
   * Ensure bridge is initialized before use
   */
  private ensureInitialized(): void {
    if (!this.initialized) {
      throw new Error(
        'WasmBridge not initialized. Call initialize() first or await the initialization promise.'
      );
    }
  }
}

/**
 * Create a pre-configured WASM bridge instance
 */
export function createWasmBridge(config?: WasmBridgeConfig): WasmBridge {
  return new WasmBridge(config);
}

/**
 * Create and initialize a WASM bridge
 */
export async function initializeWasmBridge(config?: WasmBridgeConfig): Promise<WasmBridge> {
  const bridge = new WasmBridge(config);

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Ensure the module/bridge/plugin initialize() method has been called and awaited before invoking this operation.
2. Guard against calls made during startup: await the initialization promise or check the initialized flag and fail fast with a clear setup hint.

When it happens

Trigger: Thrown at v3/plugins/prime-radiant/src/wasm-bridge.ts:464 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/aaa1d696b8cd71cb. Report an issue: GitHub.