feat: add shell completions

[alexander-akait]

Summary

Builds on @AmirSa12's #4829 (their commit is kept as-is, first in this branch) and fixes the two things that stood between it and covering every command. Closes #1402.

• Aliases resolved. @bomb.sh/tab registers each command under command.name() and has no alias concept, so completing after one returned only the global options: webpack b <TAB> offered 4 candidates against build's 21, webpack s <TAB> 4 against serve's 94. The alias being completed is now registered against the command it stands for. Only the requested alias is registered, so webpack <TAB> still lists the eight commands instead of all thirteen names — flip that if you would rather aliases were discoverable.
• The parser is optional. @bomb.sh/tab moves from dependencies to an optional peer, alongside webpack-dev-server, webpack-bundle-analyzer, js-yaml, json5 and toml. It is imported only to serve a completion request. A shell runs complete -- <words> on every keypress, so a missing package is silent there (exit 0, nothing on either stream), while complete <shell> reports what to install in the usual format.

Also updates the dev-server 6 help snapshots, added after #4829 branched — without them its CI fails on every dev-server 6 job.

Not covered, and inherent rather than an oversight: third-party commands, which the CLI resolves by import(commandName) as a package, so there is no set to enumerate before one is typed.

What kind of change does this PR introduce?

feat

Did you add tests for your changes?

Yes — test/complete/complete.test.js gains three cases on top of #4829's six: an alias offers byte-identical candidates to its command, values complete through an alias (b --mode=), and aliases stay out of the command suggestions. Measured before and after across all commands:

typed	before	after
build / watch	21	21
b, bundle, w	4	21
serve	94	94
s, server	4	94

The missing-package paths were checked by hand (both streams empty for a resolution request; exit 2 with the install message for complete zsh) since simulating an absent package inside the suite is not worth the machinery.

Does this PR introduce a breaking change?

No — a new command, and the parser it needs is optional.

If relevant, what needs to be documented once your changes are merged or what have you already documented?

Installing completions per shell: webpack complete zsh (and bash/fish/powershell) prints the script to source, and @bomb.sh/tab has to be installed to use it.

Use of AI

Claude Code was used to review #4829 by running its CLI, which is how the alias gap was measured, to read @bomb.sh/tab's adapter and find that it keys commands by name, and to write the fix and its tests. All changes were reviewed before committing.

---

Generated by Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 67bd238

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
webpack-cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​bomb.sh/​tab@​0.0.22

View full report

[github-actions]

This PR is packaged and the instant preview is available (f145401).

Install it locally:

• npm

npm i -D webpack-cli@https://pkg.pr.new/webpack-cli@f145401

• yarn

yarn add -D webpack-cli@https://pkg.pr.new/webpack-cli@f145401

• pnpm

pnpm add -D webpack-cli@https://pkg.pr.new/webpack-cli@f145401

[codecov]

Codecov Report

❌ Patch coverage is 95.93909% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 94.81%. Comparing base (7d40e4e) to head (67bd238).

Files with missing lines	Patch %	Lines
packages/webpack-cli/src/webpack-cli.ts	95.93%	8 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4840      +/-   ##
==========================================
+ Coverage   94.78%   94.81%   +0.03%     
==========================================
  Files          14       14              
  Lines        5406     5598     +192     
  Branches      799      837      +38     
==========================================
+ Hits         5124     5308     +184     
- Misses        281      289       +8     
  Partials        1        1              

Files with missing lines	Coverage Δ
packages/webpack-cli/src/webpack-cli.ts	96.70% <95.93%> (-0.05%)	⬇️

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7d40e4e...67bd238. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.