ruvnet/ruflo · error · GasTownError

CLI_EXECUTION_FAILED

CLI_EXECUTION_FAILED

Error message

Step execution failed: ${result.error}

What it means

A single step's execution via this.gtBridge.execGt returned success=false. The CLI_EXECUTION_FAILED wrapper embeds the step's error text and attaches stepId plus the error details; remaining steps in the wave do not silently continue past it.

Source

Thrown at v3/plugins/gastown-bridge/src/formula/executor.ts:1491

      'step',
      step.id,
      '--execution-id', context.executionId,
      '--json',
    ];

    if (options.targetAgent) {
      args.push('--agent', options.targetAgent);
    }

    if (options.stepTimeout) {
      args.push('--timeout', String(options.stepTimeout));
    }

    // Execute via bridge
    const result = await this.gtBridge.execGt(args);

    if (!result.success) {
      throw new GasTownError(
        `Step execution failed: ${result.error}`,
        GasTownErrorCode.CLI_EXECUTION_FAILED,
        { stepId: step.id, error: result.error }
      );
    }

    return result.data ? JSON.parse(result.data) : null;
  }

  /**
   * Merge multiple abort signals
   */
  private mergeSignals(...signals: AbortSignal[]): AbortSignal {
    const controller = new AbortController();

    for (const signal of signals) {
      if (signal.aborted) {
        controller.abort();

View on GitHub (pinned to fa13ee4ad6)

Solutions

  1. Inspect result.error for the failing step; correct the step's inputs or handler and re-run the formula.
Defensive patterns

Strategy: try-catch

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/formula/executor.ts:1491 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/0ca75de840775b1d. Report an issue: GitHub.