ruvnet/ruflo · error · Error

Exotic module not initialized

Error message

Exotic module not initialized

What it means

qaoa() (and by delegation vqe()/quantumAnnealing()) was invoked while this._module is null. The exotic optimization module was never initialized or was destroyed; the guard fires before any problem data is touched, so it is purely a lifecycle error.

Source

Thrown at v3/plugins/ruvector-upstream/src/bridges/exotic.ts:123

  async destroy(): Promise<void> {
    this._module = null;
    this._status = 'unloaded';
  }

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

  getModule(): ExoticModule | null {
    return this._module;
  }

  /**
   * Solve optimization problem with QAOA
   */
  qaoa(problem: OptimizationProblem, config?: Partial<ExoticConfig>): OptimizationResult {
    if (!this._module) throw new Error('Exotic module not initialized');
    const mergedConfig = { ...this.config, ...config };
    return this._module.qaoa(problem, mergedConfig);
  }

  /**
   * Solve optimization problem with VQE
   */
  vqe(problem: OptimizationProblem, config?: Partial<ExoticConfig>): OptimizationResult {
    if (!this._module) throw new Error('Exotic module not initialized');
    const mergedConfig = { ...this.config, ...config };
    return this._module.vqe(problem, mergedConfig);
  }

  /**
   * Solve optimization problem with quantum annealing
   */
  quantumAnnealing(problem: OptimizationProblem, config?: Partial<ExoticConfig>): OptimizationResult {
    if (!this._module) throw new Error('Exotic module not initialized');

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/ruvector-upstream/src/bridges/exotic.ts:123 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/16e64fa75f612b60. Report an issue: GitHub.