ruvnet/ruflo · error · QEMemoryError

QEMemoryBridge not initialized. Call initialize() first.

Error message

QEMemoryBridge not initialized. Call initialize() first.

What it means

Lifecycle guard on QEMemoryBridge: an operation (store, search, stats, etc.) ran before initialize() completed, so the memory handle is absent. Every public entry point calls ensureInitialized() and this sentinel fires when the bridge is used uninitialized.

Source

Thrown at v3/plugins/agentic-qe/src/bridges/QEMemoryBridge.ts:526

    if (filters.language) memoryFilters.language = filters.language;
    if (filters.framework) memoryFilters.framework = filters.framework;
    if (filters.minEffectiveness !== undefined) {
      memoryFilters.effectiveness = { $gte: filters.minEffectiveness };
    }
    // Tags require special handling (array contains)
    if (filters.tags && filters.tags.length > 0) {
      memoryFilters.tags = { $containsAll: filters.tags };
    }

    return Object.keys(memoryFilters).length > 0 ? memoryFilters : undefined;
  }

  /**
   * Ensure bridge is initialized before operations
   */
  private ensureInitialized(): void {
    if (!this.initialized) {
      throw new QEMemoryError('QEMemoryBridge not initialized. Call initialize() first.');
    }
  }
}

/**
 * QE Memory Error class
 */
export class QEMemoryError extends Error {
  public readonly cause?: Error;

  constructor(message: string, cause?: Error) {
    super(message);
    this.name = 'QEMemoryError';
    this.cause = cause;
  }
}

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Call initialize() on the memory bridge before use.
2. Guard bridge methods behind an initialized check.

When it happens

Trigger: Thrown at v3/plugins/agentic-qe/src/bridges/QEMemoryBridge.ts:526 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/7ed32c852a313051. Report an issue: GitHub.