Skip to content

Add lightweight Ruflo wrapper fast paths for help and version commands#2160

Open
JuicyBrandon wants to merge 1 commit into
ruvnet:mainfrom
JuicyBrandon:fix/ruflo-wrapper-fast-paths
Open

Add lightweight Ruflo wrapper fast paths for help and version commands#2160
JuicyBrandon wants to merge 1 commit into
ruvnet:mainfrom
JuicyBrandon:fix/ruflo-wrapper-fast-paths

Conversation

@JuicyBrandon

Copy link
Copy Markdown

Summary

Adds early exit handling in the Ruflo wrapper for lightweight smoke commands before importing the full @claude-flow/cli runtime.

Handled directly by the wrapper:

  • ruflo --version
  • ruflo -v
  • ruflo --help
  • ruflo -h
  • ruflo mcp --help
  • ruflo mcp -h

Why

The ruflo package is a thin wrapper around @claude-flow/cli. Currently, basic help and version checks can load the full Claude Flow runtime. In cold npx environments, this can make simple smoke checks slow, unreliable, or fail before the user receives basic CLI output.

This change keeps smoke commands lightweight and predictable while preserving full delegation for real command execution.

Validation

Tested in an isolated WSL lab clone.

Commands verified:

node ruflo/bin/ruflo.js --version
node ruflo/bin/ruflo.js -v
node ruflo/bin/ruflo.js --help
node ruflo/bin/ruflo.js -h
node ruflo/bin/ruflo.js mcp --help
node ruflo/bin/ruflo.js mcp -h
git diff --check

Results:

Version commands returned 3.10.3.
Help commands returned immediately.
MCP help returned immediately.
No MCP server was started.
No registration files were written.
git diff --check passed.

Scope

This does not change full Ruflo command execution. Runtime commands still delegate to @claude-flow/cli.

This only prevents basic smoke commands from loading the full runtime unnecessarily.

@JuicyBrandon JuicyBrandon requested a review from ruvnet as a code owner May 27, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant