ruvnet/ruflo · error

Warning: '${flag}' depends on '${dep}' which is disabled. '$

Error message

Warning: '${flag}' depends on '${dep}' which is disabled. '${flag}' may not work correctly.

What it means

Log warning from validateDependencies (during initialize): a feature depends on another feature that is currently disabled, so the dependent feature may not work correctly — a static consistency warning over the flag graph.

Source

Thrown at v3/@claude-flow/integration/src/feature-flags.ts:443

  private loadFromEnvironment(): void {
    for (const flag of Object.keys(FEATURE_FLAG_DEFINITIONS)) {
      const envVar = `CLAUDE_FLOW_${flag.replace(/([A-Z])/g, '_$1').toUpperCase()}`;
      const envValue = process.env[envVar];

      if (envValue !== undefined) {
        const boolValue = envValue.toLowerCase() === 'true' || envValue === '1';
        this.flags[flag as keyof FeatureFlags] = boolValue;
        this.sources.set(flag as keyof FeatureFlags, 'environment');
      }
    }
  }

  private validateDependencies(): void {
    for (const [flag, info] of Object.entries(FEATURE_FLAG_DEFINITIONS)) {
      if (this.isEnabled(flag as keyof FeatureFlags)) {
        for (const dep of info.dependencies) {
          if (!this.isEnabled(dep)) {
            console.warn(
              `Warning: '${flag}' depends on '${dep}' which is disabled. ` +
              `'${flag}' may not work correctly.`
            );
          }
        }
      }
    }
  }

  private getDependentFlags(flag: keyof FeatureFlags): (keyof FeatureFlags)[] {
    return Object.entries(FEATURE_FLAG_DEFINITIONS)
      .filter(([_, info]) => info.dependencies.includes(flag))
      .map(([name]) => name as keyof FeatureFlags);
  }
}

/**
 * Create and initialize a feature flag manager

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Enable the dependency named in the warning, or disable the dependent flag to avoid incorrect behavior.

When it happens

Trigger: Thrown at v3/@claude-flow/integration/src/feature-flags.ts:443 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/8ba355110dd7a945. Report an issue: GitHub.