feat(complete): support shell alias registration

[jdx]

Replaces #1146, which GitHub automatically marked merged when dependent branch refs temporarily matched during a restack. This is the same layer on the corrected stack.\n\n_This pull request was generated by Codex._

---

Note

Low Risk
Additive completion-script generation only. Parsing and ordinary CLI behavior are unchanged; risk is limited to generated shell registration names.

Overview
Adds explicit shell-alias completion: generated scripts can register a short name like m while the callback still runs the real binary (mise). This is a registration API, not alias discovery, so it does not depend on interactive alias expansion.

script() now delegates to script_for(bin, name, shell). Bash, zsh, fish, Nu, and PowerShell register name and invoke bin. The same split is exposed as completion_script_for_alias on derived CLIs and the embedded App API. Both the registered name and the invoked binary are asserted to be a single safe shell word.

^{Reviewed by Cursor Bugbot for commit e454902. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: f906ff56-6e55-4dab-8ac2-5760b146680a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 750419b. Configure here.}

[github-actions]

Instruction counts

benchmark	trend	instructions	Δ	wall (min)	Δ
markdown	▁██	226,113,376 → 226,081,848	-0.01%	21.96 → 20.86ms	-4.99%
startup	▁█▆	1,226,955 → 1,226,233	-0.06%	1.32 → 1.44ms	+9.14%

No instruction-count regression above 1%.

_{Only instruction counts gate. Wall clock is shown for context — on identical hardware it moves 4-20% run to run.}

_{Measured by tak — instruction-counted CLI benchmarks, stored in this repository's git notes.}

Shadow comparison

Parsing mise use -g node@20 against a shadow of mise's committed spec.
Reported, not gated: the shadow grows as the derive learns to express more, so
what to watch is the ratio rather than either column.

framework	instructions, cold parse	vs usage
usage	8316	—
argh	6307	0.8x
clap	6316072	759x
bpaf	21909147	2634x

                                              min       p01       p10    median
usage-rs: argv -> struct                      403       411       414       418  ns
argh: argv -> struct                          286       288       291       303  ns
clap: build tree + parse -> struct         512656    514350    516137    519563  ns
bpaf: build parser + parse -> struct      1562667   1562667   1580046   1601224  ns

usage: argv -> struct                             415 ns      0.41 µs
clap: build tree + parse -> struct             523748 ns    523.75 µs
clap: parse -> struct, tree reused              23093 ns     23.09 µs
clap: build tree only                          321629 ns    321.63 µs

_{e4549028527f vs df4693ff99fc · measured on the runner, not pushed to the history.}