ruvnet/ruflo · error · TeammateError

VERSION_INCOMPATIBLE

VERSION_INCOMPATIBLE

Error message

TeammateBridge not initialized. Call initialize() first.

What it means

ensureAvailable() found this.initialized false — a bridge operation was invoked before initialize() completed or after teardown. Sentinel lifecycle guard (reported under VERSION_INCOMPATIBLE): the underlying team store/handlers are not wired up yet, so any operation is refused.

Source

Thrown at v3/plugins/teammate-plugin/src/teammate-bridge.ts:2103

    }

    statuses.push({
      backend: 'in_process',
      available: true,
      activeTeammates: inProcessCount,
      capacity: 50,
    });

    return statuses;
  }

  // ==========================================================================
  // Private Methods
  // ==========================================================================

  private ensureAvailable(): void {
    if (!this.initialized) {
      throw new TeammateError(
        'TeammateBridge not initialized. Call initialize() first.',
        TeammateErrorCode.VERSION_INCOMPATIBLE
      );
    }

    if (!this.teammateToolAvailable && !this.config.fallbackToMCP) {
      throw new TeammateError(
        `TeammateTool not available. Requires Claude Code >= ${MINIMUM_CLAUDE_CODE_VERSION}, ` +
        `found: ${this.claudeCodeVersion ?? 'not installed'}`,
        TeammateErrorCode.VERSION_INCOMPATIBLE
      );
    }
  }

  private getTeamOrThrow(teamName: string): TeamState {
    const team = this.activeTeams.get(teamName);
    if (!team) {
      throw new TeammateError(

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/teammate-plugin/src/teammate-bridge.ts:2103 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/aec146aa6b0c57d3. Report an issue: GitHub.