ruvnet/ruflo · error

V3 router failed, using fallback

Error message

V3 router failed, using fallback

What it means

Log warning in routeQETask: invoking the V3 router for enhanced routing failed; the adapter logs the failure and continues with its own complexity/tier-based fallback routing decision.

Source

Thrown at v3/plugins/agentic-qe/src/bridges/QEModelRoutingAdapter.ts:190

      // 1. Get QE-specific complexity
      const complexity = this.getCategoryComplexity(task.category);

      // 2. Determine tier based on complexity
      const tier = this.determineTier(complexity);

      // 3. Check for Agent Booster availability
      const agentBooster = this.canUseAgentBooster(task);

      // 4. Try V3 router if available for enhanced routing
      let v3Result: EnhancedRouteResult | null = null;
      if (this.v3Router) {
        try {
          v3Result = await this.v3Router.route(task.description, {
            filePath: task.targetPath,
          });
        } catch (error) {
          this.logger.warn('V3 router failed, using fallback', error);
        }
      }

      // 5. Build final route result
      const model = this.selectModel(tier, v3Result);
      const recommendedAgents = this.getRecommendedAgents(task.category, tier);
      const costEstimate = this.estimateCost(task, tier);

      const result: QERouteResult = {
        tier: agentBooster.available ? 1 : tier,
        model: agentBooster.available ? 'haiku' : model,
        qeCategory: task.category,
        qeComplexity: complexity,
        recommendedAgents,
        costEstimate: agentBooster.available ? 0 : costEstimate,
        agentBoosterAvailable: agentBooster.available,
        agentBoosterIntent: agentBooster.intent,
        explanation: this.buildExplanation(task, tier, agentBooster, v3Result),

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Check the V3 router error detail and router configuration; the fallback model route is used until the router is fixed.

When it happens

Trigger: Thrown at v3/plugins/agentic-qe/src/bridges/QEModelRoutingAdapter.ts:190 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/64e92df7f8857d15. Report an issue: GitHub.