[rushd][WS4] CLI client & command surface
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 25/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- nodejs, typescript
- Domain
- build-system, cli, devtools, tooling
Research direction
Start by reading the dependent issues #5896, #5897, and #5898, then examine the rush-client-core and rush-cli-client package entry points plus the existing rush and rushx commands. Verify the rush.json daemon block, routing precedence, daemon subcommands, graph protocol, and standalone rushx behavior against the listed acceptance criteria. Done means opt-in client behavior, validated configuration, correct streaming and exit handling, gated graph commands, and green CI tests.
Written by the indexing model from the issue text.
Description
Build the separate CLI client package/bin (@rushstack/rush-cli-client on @rushstack/rush-client-core) and its command surface — fallback/opt-in routing, rush daemon subcommands, the rush.json daemon config block + env overrides, an experimental rush daemon graph reference client, and a standalone rushx-equivalent bin — all opt-in until cutover.
Depends on: #5896; #5897; #5898
Scope
rush-client-core+rush-cli-clientbin. Connect/forward/pump, the request envelope (argv,cwd,env,columns,colorLevel), stream pumping, exit-code relay, and cancel-on-signal — with noSIGWINCHforwarding (the client owns width/resize).- Fallback/opt-in routing. Decide daemon vs in-process per invocation from
RUSH_DAEMON,--no-daemon,rush.jsonconfig, CI detection, and the never-daemonize list (routing to today's in-process path otherwise). rush.jsondaemon config. A validateddaemonblock (enabled,idleTimeoutSeconds,autoStart,watch,queueTimeoutSeconds, plus the WS3 warm-set knobs) withRUSH_DAEMON*env overrides.rush daemonsubcommands.start|stop|restart|status|logs(themselves never-daemonized);statussurfaces warm-set + lifecycle info (uptime, PID, reload tier, warm projects, memory) andlogsstreams the daemon log.- Experimental
rush daemon graph. BehindRUSH_DAEMON_EXPERIMENTAL=1,show/status/scope-in/scope-out/invalidate/watch/pause/resumeover the warm graph, serving as a reference "third client" that consumes only structured events. - Standalone
rushx-equivalent. Run the cwd project's package script with the same auto-start/forward behavior; it becomesrushxat cutover (WS5).
Acceptance criteria
- The client connects, sends the request envelope, pumps stdout/stderr/stdin, and relays the daemon's exit code; Ctrl+C cancels the request;
SIGWINCHis handled client-side and not forwarded; a samplerush buildvia the client is behaviorally equivalent to in-process (full matrix in WS5). - Each routing input (
RUSH_DAEMON,--no-daemon, config, CI, never-daemonize) selects the correct path with a documented precedence order; CI defaults to in-process (no auto-start) unless explicitly opted in. - The
rush.jsondaemonschema is published and validates the block (rejecting unknown/invalid values) with precedence env > config > default. - Each
rush daemonsubcommand acts against a running (or absent) daemon with correct exit codes;statusreports warm-set + lifecycle info andlogsstreams the daemon log (see WS5). - The experimental
rush daemon graphverbs operate over the warm graph via the protocol only (no rush-lib-internal calls), consume only the presentation-free event contract, and stay gated off unlessRUSH_DAEMON_EXPERIMENTAL=1. - The standalone
rushx-equivalent resolves the project by cwd, forwards with auto-start, and matches today'srushxoutput/exit code for a sample script. -
rush-client-corehas norush-libdependency and commits its API Extractor report; everything ships opt-in until cutover; tests green in CI.
Part of #5894.
- Dominant language
- TypeScript
- Stars
- 6.5k
- Forks
- 708
- Avg merge
- 5d 7h
- Merged PRs (30d)
- 44
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from microsoft/rushstack
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Difficulty 4/5 3-5 days Newbie friendliness 48/100
All issues in microsoft/rushstack
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
ontola/atomic-server#1625 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
melgarafael/DeskcommCRM#1451 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 82/100
-
bug via-triage
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bot:ai-assisted component:compact-js status:untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
midnightntwrk/midnight-sdk#403 ·