ruvnet/ruflo · error

Cognitive module not initialized

Error message

Cognitive module not initialized

What it means

CognitiveBridge.store() was called while the underlying cognitive WASM module is not loaded (this._module is null — initialize() not run, failed, or destroy() was called). The same not-initialized sentinel guards every module-backed operation on this bridge.

Source

Thrown at v3/plugins/cognitive-kernel/src/bridges/cognitive-bridge.ts:142

  async destroy(): Promise<void> {
    this._module = null;
    this._status = 'unloaded';
  }

  isReady(): boolean {
    return this._status === 'ready';
  }

  getModule(): CognitiveModule | null {
    return this._module;
  }

  /**
   * Store item in working memory
   */
  store(item: CognitiveItem): boolean {
    if (!this._module) throw new Error('Cognitive module not initialized');
    return this._module.store(item);
  }

  /**
   * Retrieve item from working memory
   */
  retrieve(id: string): CognitiveItem | null {
    if (!this._module) throw new Error('Cognitive module not initialized');
    return this._module.retrieve(id);
  }

  /**
   * Search working memory
   */
  search(query: Float32Array, k: number): CognitiveItem[] {
    if (!this._module) throw new Error('Cognitive module not initialized');
    return this._module.search(query, k);
  }

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Ensure the module/bridge/plugin initialize() method has been called and awaited before invoking this operation.
2. Guard against calls made during startup: await the initialization promise or check the initialized flag and fail fast with a clear setup hint.

When it happens

Trigger: Thrown at v3/plugins/cognitive-kernel/src/bridges/cognitive-bridge.ts:142 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/88a0c59f9c18d505. Report an issue: GitHub.