ruvnet/ruflo · error

SONA requested but not available:

Error message

SONA requested but not available:

What it means

Log warning in ruvector-training setup: SONA adaptation was requested (useSona) but @ruvector/sona could not be imported; the SONA engine is left unset and training proceeds without it (backward compatible).

Source

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

    }
  } 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);
      }
    }
  }

  initialized = true;
  return { success: true, features, backend: activeBackend };
}

/**
 * Operator types for scoped LoRA (0-16)
 */
export const OperatorType = {
  GENERAL: 0,
  ATTENTION: 1,
  MLP: 2,
  EMBEDDING: 3,
  NORMALIZATION: 4,
  PROJECTION: 5,

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install the SONA dependency or remove the SONA request from the training configuration.

When it happens

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