ruvnet/ruflo · error

SONAAdapter not initialized. Call initialize() first.

Error message

SONAAdapter not initialized. Call initialize() first.

What it means

SONAAdapter uses the standard bridge pattern: methods that depend on runtime state call ensureInitialized(), which throws until initialize() has fully completed. Before that there is no pattern store, no configuration handshake, and no active trajectories.

Source

Thrown at v3/@claude-flow/integration/src/sona-adapter.ts:810

    this.stats.averageConfidence = total / this.patterns.size;
  }

  private estimateMemoryUsage(): number {
    // Rough estimate: 500 bytes per pattern, 1KB per trajectory step
    const patternBytes = this.patterns.size * 500;
    const trajectoryBytes = Array.from(this.activeTrajectories.values())
      .reduce((sum, t) => sum + t.steps.length * 1024, 0);

    return patternBytes + trajectoryBytes;
  }

  private generateId(prefix: string): string {
    return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
  }

  private ensureInitialized(): void {
    if (!this.initialized) {
      throw new Error('SONAAdapter not initialized. Call initialize() first.');
    }
  }
}

/**
 * Create and initialize a SONA adapter
 */
export async function createSONAAdapter(
  config?: Partial<SONAConfiguration>
): Promise<SONAAdapter> {
  const adapter = new SONAAdapter(config);
  await adapter.initialize();
  return adapter;
}

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Use the createSONAAdapter(config) factory — it constructs and awaits initialization in one step
2. If initializing manually, await it before any other call and fail loudly if it rejects
3. Share one initialized adapter instance across the app instead of constructing per module

Example fix

// before
const adapter = new SONAAdapter(config);
await adapter.startTrajectory({ /* ... */ }); // throws: not initialized

// after
const adapter = await createSONAAdapter(config);
await adapter.startTrajectory({ /* ... */ });

// Shared initialized singleton — every call site awaits the same promise
let adapterPromise: Promise<SONAAdapter> | null = null;
function getSONA(): Promise<SONAAdapter> {
  adapterPromise ??= createSONAAdapter(config);
  return adapterPromise;
}

try {
  await sona.startTrajectory(params);
} catch (e) {
  if (e instanceof Error && e.message.includes('SONAAdapter not initialized')) {
    const sonaReady = await createSONAAdapter(config); // then retry once with the ready instance
    return sonaReady.startTrajectory(params);
  }
  throw e;
}

When it happens

Trigger: Calling any adapter method (startTrajectory, recordTrajectoryStep, optimization APIs) on an instance where initialize() was never awaited, or where it failed earlier.

Common situations: Constructing with new SONAAdapter(config) and immediately calling methods; a swallowed init failure; multiple modules each constructing their own instance while only one gets initialized.

Related errors

• Store not initialized. Call initialize() first.
• SDKBridge not initialized. Call initialize() first.
• SwarmAdapter not initialized. Call initialize() first.
• Worker ${this.id} not initialized. Call initialize() first.
• SSRF guard: invalid URL — ${rawUrl}

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/29218878966d30cf. Report an issue: GitHub.