ruvnet/ruflo · error

[ruvector] @ruvector/attention unavailable (${reason}), atte

Error message

[ruvector] @ruvector/attention unavailable (${reason}), attention features disabled

What it means

Log warning in ruvector-training setup: the optional @ruvector/attention package (flash attention, curriculum, hard-negative mining) could not be loaded; training continues with attention features disabled.

Source

Thrown at v3/@claude-flow/cli/src/services/ruvector-training.ts:417

    if (config.totalSteps) {
      curriculum = new attention.CurriculumScheduler(
        config.totalSteps,
        config.warmupSteps || Math.floor(config.totalSteps * 0.1)
      );
      features.push('Curriculum Learning');
    }

    try {
      hardMiner = new attention.HardNegativeMiner(5, 'semi_hard');
      features.push('Hard Negative Mining');
    } catch {
      // Mining not available, continue without it
    }
  } catch (attentionError) {
    // @ruvector/attention not available - attention features skipped
    const reason = attentionError instanceof Error ? attentionError.message : String(attentionError);
    console.warn(`[ruvector] @ruvector/attention unavailable (${reason}), attention features disabled`);
  }

  // --- SONA (optional, backward compatible) ---
  if (config.useSona !== false) {
    try {
      const sona = await importWithInterop('@ruvector/sona');
      const sonaRank = config.sonaRank || 4;
      sonaEngine = new sona.SonaEngine(dim, sonaRank, alpha, lr) as SonaEngineInstance;
      sonaAvailable = true;
      features.push(`SONA (${dim}-dim, rank-${sonaRank}, 624k learn/s)`);
    } catch (sonaError) {
      sonaAvailable = false;
      if (config.useSona === true) {
        console.warn('SONA requested but not available:', sonaError);
      }
    }
  }

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install @ruvector/attention to enable attention features; they are disabled while the package is unavailable.

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/services/ruvector-training.ts:417 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/fb10f5f36629fe6e. Report an issue: GitHub.