ruvnet/ruflo · error · PluginError

INITIALIZATION_FAILED

INITIALIZATION_FAILED

Error message

Failed to initialize plugin '${plugin.name}': ${error}

What it means

PluginLoader.initializePlugin caught a failure (or timeout) from the plugin's own initialize(context) hook and rethrew as PluginError after marking the plugin's state 'error'. The root cause is the plugin's initialization code, not the loader; the message names the plugin and the underlying error.

Source

Thrown at v3/@claude-flow/shared/src/plugin-loader.ts:339

  /**
   * Initialize a single plugin
   */
  private async initializePlugin(plugin: ClaudeFlowPlugin, context: PluginContext): Promise<void> {
    this.registry.updatePluginState(plugin.name, 'initializing');

    try {
      // Run initialization with timeout
      await this.withTimeout(
        plugin.initialize(context),
        this.config.initializationTimeout,
        `Plugin '${plugin.name}' initialization timed out`
      );

      this.registry.updatePluginState(plugin.name, 'initialized');
      this.registry.collectPluginMetrics(plugin.name);
    } catch (error) {
      this.registry.updatePluginState(plugin.name, 'error', error instanceof Error ? error : new Error(String(error)));
      throw new PluginError(
        `Failed to initialize plugin '${plugin.name}': ${error}`,
        plugin.name,
        'INITIALIZATION_FAILED',
        error instanceof Error ? error : undefined
      );
    }
  }

  /**
   * Shutdown a single plugin
   */
  private async shutdownPlugin(plugin: ClaudeFlowPlugin): Promise<void> {
    this.registry.updatePluginState(plugin.name, 'shutting-down');

    try {
      await this.withTimeout(
        plugin.shutdown(),
        this.config.shutdownTimeout,

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Read the wrapped error to fix the plugin's initialize() failure.
2. Verify the plugin's dependencies and configuration are present before loading.

When it happens

Trigger: Thrown at v3/@claude-flow/shared/src/plugin-loader.ts:339 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/e9ecabd986ffb58c. Report an issue: GitHub.