ruvnet/ruflo · error

FPGA bridge not initialized

Error message

FPGA bridge not initialized

What it means

FpgaBridge.optimizeConfig() found the bridge not in 'ready' status (initialize/dispose lifecycle left it unloaded). Configuration optimization is refused until initialize() completes; every public method on the bridge checks isReady().

Source

Thrown at v3/plugins/perf-optimizer/src/bridges/fpga-bridge.ts:109

    this.baselinePerformance.clear();
    this.status = 'unloaded';
  }

  isReady(): boolean {
    return this.status === 'ready';
  }

  /**
   * Optimize configuration for workload
   *
   * Uses SONA-based learning to find optimal configuration parameters.
   */
  async optimizeConfig(
    workload: WorkloadProfile,
    configSpace: Record<string, unknown>
  ): Promise<ConfigOptimization> {
    if (!this.isReady()) {
      throw new Error('FPGA bridge not initialized');
    }

    const parameters: ConfigParameter[] = [];
    const warnings: string[] = [];

    // Analyze each config parameter
    for (const [name, spec] of Object.entries(configSpace)) {
      const paramSpec = spec as { type: string; range?: unknown[]; current: unknown };

      const optimizedParam = this.optimizeParameter(name, paramSpec, workload);
      parameters.push(optimizedParam);

      // Check for potential issues
      if (optimizedParam.impact < 0.1) {
        warnings.push(`Parameter '${name}' has minimal impact on performance`);
      }
    }

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/perf-optimizer/src/bridges/fpga-bridge.ts:109 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/23346aa74be501c5. Report an issue: GitHub.