ruvnet / ruvnet/ruflo

[verification] HIGH: @claude-flow/cli@alpha --version times out (>60s, SIGTERM) in cold-cache npx

Open
#3,154 6 comments 0 reactions 0 assignees View on GitHub
severity:high verification
Dominant language
TypeScript
Stars
72.7k
Forks
8.6k
Avg merge
2d 23h
Merged PRs (30d)
83

Description

## Summary

`npx -y @claude-flow/cli@alpha --version` timed out and was killed (SIGTERM, exit 143) after 60 seconds in a cold-cache npx environment. No version was printed. The CLI package installed successfully but the `--version` invocation never completed.

## Impact

New or CI users running `npx @claude-flow/cli@alpha ` in a cold-cache environment (fresh Docker container, CI runner, first install) will experience an indefinite hang or timeout before any output appears. This affects the primary user-facing install path.

## Expected

```
@claude-flow/cli@alpha --version prints a version string >= 3.7.0-alpha.20 within a few seconds
```

## Actual

```
Terminated
CLI exit code: 143
```

## Command Output

```bash
# Install succeeded:
added 2 packages in 1s

# Exports check passed:
plugin-agent-federation@alpha exports OK, version: 1.0.0-alpha.17

# CLI version check:
timeout 60 npx -y @claude-flow/cli@alpha --version 2>&1 | tail -5
Terminated
CLI exit code: 143
```

## Relevant Report Section

Check 2: Published Package Smoke Test
- Status: PARTIALLY FAILED (exports OK, CLI timeout)
- Severity: HIGH
- Exit code: 143 (SIGTERM at 60s)

## Environment

- Commit: `29f048fc3b556f857cf2b126d2a84c19d2daa0d0`
- Timestamp UTC: 2026-09-01T19:03:58Z
- Node: v22.22.2
- npm: 10.9.7
- OS: Linux vm 6.18.44-fc-v22 x86_64
- npx cache: cold

## Related

- #3145 — `ruflo@alpha --version` times out (same symptom, MEDIUM severity, ruflo wrapper)

## Recommended Fix

Investigate the CLI startup path for blocking operations before `--version` can return — heavy `require()` chain, native addon initialization, network calls to check for updates, or daemon startup logic that stalls in a cold environment.

Contributor guide

Open the contributing guide

Research direction

Reproduce the failure with `timeout 60 npx -y @claude-flow/cli@alpha --version` in a cold-cache environment, then trace the CLI startup path before `--version` returns. Check the heavy require chain, native addon initialization, update checks, and daemon startup mentioned in the issue. Done means the command prints a version at least 3.7.0-alpha.20 within a few seconds and exits successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, typescript
Domain
cli
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.