ruvnet/ruflo · error

Plugin not initialized

Error message

Plugin not initialized

What it means

CodeIntelligencePlugin.getToolContext() found the GNN or MinCut bridge absent — initialize() has not run (or shutdown() cleared them). Tools cannot execute without their bridges, so this sentinel rejects tool-context creation on an uninitialized plugin.

Source

Thrown at v3/plugins/code-intelligence/src/index.ts:143

  async shutdown(): Promise<void> {
    this.state = 'shutdown';
    this.gnnBridge = null;
    this.mincutBridge = null;
  }

  /**
   * Get MCP tools provided by this plugin
   */
  getMCPTools() {
    return codeIntelligenceTools;
  }

  /**
   * Get tool context for execution
   */
  getToolContext() {
    if (!this.gnnBridge || !this.mincutBridge) {
      throw new Error('Plugin not initialized');
    }

    const store = new Map<string, unknown>();

    const blockedPatterns = this.config.security.blockedPatterns.map(
      p => new RegExp(p)
    );

    return {
      get: <T>(key: string) => store.get(key) as T | undefined,
      set: <T>(key: string, value: T) => { store.set(key, value); },
      bridges: {
        gnn: this.gnnBridge,
        mincut: this.mincutBridge,
      },
      config: {
        allowedRoots: this.config.security.allowedRoots,
        blockedPatterns,

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/code-intelligence/src/index.ts:143 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/bb71b04f83fbb7a9. Report an issue: GitHub.