Ignacy Łątka 3f2680788d fix(cli): print help for init/update/uninstall instead of running them (#460) ...

## The bug

`argent <cmd> --help` for the installer subcommands `init` / `install` /
`update` / `uninstall` / `remove` did not print help — it ran the real,
side-effecting command. `argent uninstall --help` even opened the
destructive "Remove argent configuration from this workspace?" prompt
(with Yes pre-selected).

Root cause: `main()` in `packages/argent/src/cli.ts` dispatched these
subcommands and forwarded `rest` (including `--help`) to the installer
functions, which have no help handling. Only the top-level `--help` case
called `printHelp()`.

## The fix

Intercept `--help`/`-h` for exactly the installer command set before
dispatching, and print a short per-subcommand usage block without
loading or invoking any installer code (no network, no wizard, no
prompt).

- New side-effect-free module `packages/argent/src/installer-help.ts`
exports the pure decision function `installerHelpRequested(command,
rest)` plus `printInstallerHelp(command)`.
- `cli.ts` calls the guard at the top of `main()` and returns early when
help is requested.
- The other subcommands (`run`, `tools`, `server`, `link`, `flags`,
`enable`, `disable`, `telemetry`) already handle `--help` themselves, so
they are deliberately excluded — `argent run <tool> --help` still prints
that tool's flags.

## Verification

- `npm run build` (root tsc) + `npm run build -w @swmansion/argent` —
green.
- Ran the built CLI end-to-end (stdin from /dev/null): `init --help`,
`update --help`, `uninstall --help`, `install --help`, `remove --help`,
`uninstall -h` all print usage and exit 0 with no wizard/network/prompt.
- Regression: `argent --help` still prints top-level help; `argent run
--help` still prints the `run` usage (not intercepted).
- Added unit tests in `packages/argent/test/installer-help.test.ts` for
`installerHelpRequested` / `isInstallerCommand` (8 tests, all pass).
- `prettier` and `eslint` clean on the touched files; test typecheck
passes.

Fixes #451

2026-07-10 12:48:24 +02:00

..

bundled-paths.test.ts

feat(installer): committable repo-local (--local) install mode (#428)

2026-07-08 12:24:19 +02:00

cli-dispatch.test.ts

fix(cli): print help for init/update/uninstall instead of running them (#460)

2026-07-10 12:48:24 +02:00

dispatcher.test.ts

feat: support arm64 Linux simulator-server binary (#328)

2026-06-12 16:20:23 +02:00

esm-bundle-banner.test.ts

feat(telemetry): derive distinct_id from a stable host fingerprint (#444)

2026-07-07 16:28:29 +02:00

fatal-handlers.test.ts

fix: 100% CPU usage on broken stdio (#191)

2026-05-12 15:40:43 +02:00

installer-flags-sync.test.ts

fix(cli): print help for init/update/uninstall instead of running them (#460)

2026-07-10 12:48:24 +02:00

installer-help.test.ts

fix(cli): print help for init/update/uninstall instead of running them (#460)

2026-07-10 12:48:24 +02:00

package-manifest.test.ts

fix(release): ship ax-service in bin/darwin/ so describe works in published packages (#303)

2026-06-03 22:28:22 +02:00