Could not create pgvector extension (may require superuser p

Error message

Could not create pgvector extension (may require superuser privileges)

What it means

Log warning in ensureExtension: the 'CREATE EXTENSION IF NOT EXISTS vector' statement failed — typically because the DB user lacks superuser privileges; the bridge proceeds and pgvector-dependent operations will fail later if the extension truly is absent.

Source

Thrown at v3/@claude-flow/plugins/src/integrations/ruvector/ruvector-bridge.ts:1843

  /**
   * Ensure the plugin is initialized.
   */
  private ensureInitialized(): void {
    if (!this.vectorOps || !this.connectionManager) {
      throw new Error('RuVector Bridge not initialized. Call initialize() first.');
    }
  }

  /**
   * Ensure pgvector extension is installed.
   */
  private async ensureExtension(): Promise<void> {
    try {
      await this.connectionManager!.query("CREATE EXTENSION IF NOT EXISTS vector");
      this.logger.debug('pgvector extension ensured');
    } catch (error) {
      this.logger.warn('Could not create pgvector extension (may require superuser privileges)', error);
    }
  }

  /**
   * Forward connection manager events to plugin event bus.
   */
  private forwardConnectionEvents(): void {
    const events: RuVectorEventType[] = [
      'connection:open',
      'connection:close',
      'connection:error',
      'connection:pool_acquired',
      'connection:pool_released',
      'query:start',
      'query:complete',
      'query:error',
      'query:slow',
    ];

View on GitHub (pinned to fa13ee4ad6)

Solutions

Run the migration with a database role that has superuser/privilege to create extensions, or pre-create the pgvector extension manually.

Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at v3/@claude-flow/plugins/src/integrations/ruvector/ruvector-bridge.ts:1843 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/0f89f67620306f06. Report an issue: GitHub.