{"record":{"id":"23346aa74be501c5","repo":"ruvnet/ruflo","slug":"fpga-bridge-not-initialized","errorCode":null,"errorMessage":"FPGA bridge not initialized","messagePattern":"FPGA bridge not initialized","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"v3/plugins/perf-optimizer/src/bridges/fpga-bridge.ts","lineNumber":109,"sourceCode":"    this.baselinePerformance.clear();\n    this.status = 'unloaded';\n  }\n\n  isReady(): boolean {\n    return this.status === 'ready';\n  }\n\n  /**\n   * Optimize configuration for workload\n   *\n   * Uses SONA-based learning to find optimal configuration parameters.\n   */\n  async optimizeConfig(\n    workload: WorkloadProfile,\n    configSpace: Record<string, unknown>\n  ): Promise<ConfigOptimization> {\n    if (!this.isReady()) {\n      throw new Error('FPGA bridge not initialized');\n    }\n\n    const parameters: ConfigParameter[] = [];\n    const warnings: string[] = [];\n\n    // Analyze each config parameter\n    for (const [name, spec] of Object.entries(configSpace)) {\n      const paramSpec = spec as { type: string; range?: unknown[]; current: unknown };\n\n      const optimizedParam = this.optimizeParameter(name, paramSpec, workload);\n      parameters.push(optimizedParam);\n\n      // Check for potential issues\n      if (optimizedParam.impact < 0.1) {\n        warnings.push(`Parameter '${name}' has minimal impact on performance`);\n      }\n    }\n","sourceCodeStart":91,"sourceCodeEnd":127,"githubUrl":"https://github.com/ruvnet/ruflo/blob/fa13ee4ad60ac2090b1480656eb233521790d640/v3/plugins/perf-optimizer/src/bridges/fpga-bridge.ts#L91-L127","documentation":"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().","triggerScenarios":"Thrown at v3/plugins/perf-optimizer/src/bridges/fpga-bridge.ts:109 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Ensure the module/bridge/plugin initialize() method has been called and awaited before invoking this operation.","Guard against calls made during startup: await the initialization promise or check the initialized flag and fail fast with a clear setup hint."],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fa13ee4ad60ac2090b1480656eb233521790d640","analyzedAt":"2026-08-18T21:34:22.708Z","contentChangedAt":"2026-08-18T21:34:22.708Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}