ruvnet/ruflo · error · Error

HyperbolicBridge not initialized

Error message

HyperbolicBridge not initialized

What it means

HyperbolicBridge.embedHierarchy() found this._module null — initialize() has not succeeded (or dispose() cleared it). The embedding computation is refused up front, before hierarchy validation or embedding math begins.

Source

Thrown at v3/plugins/hyperbolic-reasoning/src/bridges/hyperbolic-bridge.ts:146

  /**
   * Dispose of resources
   */
  async dispose(): Promise<void> {
    this._indices.clear();
    this._module = null;
    this._status = 'unloaded';
  }

  /**
   * Embed a hierarchy into hyperbolic space
   */
  async embedHierarchy(
    hierarchy: Hierarchy,
    config: Partial<EmbedHierarchyInput['parameters']> = {}
  ): Promise<EmbeddedHierarchy> {
    if (!this._module) {
      throw new Error('HyperbolicBridge not initialized');
    }

    const mergedConfig = { ...DEFAULT_EMBED_CONFIG, ...config };
    this.validateHierarchy(hierarchy);

    // Initialize embeddings
    const embeddings = new Map<string, HyperbolicPoint>();
    const nodeIndex = new Map<string, number>();
    const parentMap = new Map<string, string | null>();

    hierarchy.nodes.forEach((node, idx) => {
      nodeIndex.set(node.id, idx);
      parentMap.set(node.id, node.parent);
    });

    // Find root(s) and compute depths
    const depths = new Map<string, number>();
    const computeDepth = (nodeId: string): number => {

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/hyperbolic-reasoning/src/bridges/hyperbolic-bridge.ts:146 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/d5507cda2d085fa8. Report an issue: GitHub.