[ReasoningBank] Real embeddings unavailable, using hash-base

Error message

[ReasoningBank] Real embeddings unavailable, using hash-based fallback

What it means

Error "[ReasoningBank] Real embeddings unavailable, using hash-based fallback" thrown in ruvnet/ruflo.

Source

Thrown at v3/@claude-flow/hooks/src/reasoningbank/index.ts:258

          dimensions: this.config.dimensions,
          hnswM: this.config.hnswM,
          hnswEfConstruction: this.config.hnswEfConstruction,
          maxEntries: this.config.maxShortTerm + this.config.maxLongTerm,
          persistenceEnabled: true,
          persistencePath: this.config.dbPath,
          embeddingGenerator: (text: string) => this.embeddingService.embed(text),
        });

        await this.agentDB.initialize();
        this.useRealBackend = true;

        // Try to use real embedding service
        if (EmbeddingServiceImpl && !this.config.useMockEmbeddings) {
          try {
            this.embeddingService = new RealEmbeddingService(this.config.dimensions);
            await (this.embeddingService as RealEmbeddingService).initialize();
          } catch (e) {
            console.warn('[ReasoningBank] Real embeddings unavailable, using hash-based fallback');
          }
        }

        await this.loadPatterns();
        console.log(`[ReasoningBank] Initialized with AgentDB + HNSW (M=${this.config.hnswM}, efConstruction=${this.config.hnswEfConstruction})`);
      } else {
        throw new Error('Dependencies not available');
      }

      this.initialized = true;
      this.emit('initialized', {
        shortTermCount: this.shortTermPatterns.size,
        longTermCount: this.longTermPatterns.size,
        useRealBackend: this.useRealBackend,
      });
    } catch (error) {
      // Fallback to in-memory only mode
      console.warn('[ReasoningBank] AgentDB not available, using in-memory mode');

View on GitHub (pinned to fa13ee4ad6)

Solutions

Install the embeddings provider dependency to enable real embeddings; hash-based fallback reduces recall quality.

When it happens

Trigger: Thrown at v3/@claude-flow/hooks/src/reasoningbank/index.ts:258 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/d20ac0aeae75643e. Report an issue: GitHub.