ruvnet/ruflo · error · GasTownError

NOT_INITIALIZED

NOT_INITIALIZED

Error message

GtBridge not initialized

What it means

The GasTownBridge plugin's formula executor path found its GtBridge dependency uninitialized — initializeFormulaExecutor()/bridge initialization has not completed. Any formula operation needing the gt CLI is refused with this sentinel.

Source

Thrown at v3/plugins/gastown-bridge/src/index.ts:1083

      cwd: this.config.bdBridge?.cwd,
    });
    await this.bdBridge.initialize();

    // Initialize SyncBridge - requires an AgentDB service
    // We create a stub AgentDB service that will be replaced when
    // the plugin context provides a real one
    const stubAgentDB = this.createStubAgentDB();
    this.syncBridge = createSyncBridge(stubAgentDB, {
      beadsBridge: this.config.bdBridge,
      agentdbNamespace: this.config.syncBridge?.namespace ?? 'gastown:beads',
    });

    this.logger.debug('Bridges initialized');
  }

  private async initializeFormulaExecutor(): Promise<void> {
    if (!this.gtBridge) {
      throw new GasTownError('GtBridge not initialized', GasTownErrorCode.NOT_INITIALIZED);
    }

    const wasmLoader = this.config.formulaExecutor?.useWasm && this.wasmLoader
      ? this.wasmLoader
      : undefined;

    this.formulaExecutor = createFormulaExecutor(
      this.gtBridge,
      wasmLoader,
      this.logger
    );

    this.logger.debug('Formula executor initialized', {
      wasmEnabled: !!wasmLoader,
    });
  }

  private async initializeConvoyComponents(): Promise<void> {

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/gastown-bridge/src/index.ts:1083 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/95d04927674c81ab. Report an issue: GitHub.