feat(std/cli): shell completion scripts #785

Open

orion wants to merge 2 commits from loop/125-cli-completions into main

orion commented

2026-11-14 09:59:53 +00:00

Collaborator

Adds Command.completion(shell: Shell): String and the Shell type (Bash, Zsh, Fish, PowerShell) to std/cli: a pure function that turns the declared command tree into the completion script of a shell (CLI slice 3, std/cli half).

Completes subcommands (and help) and --flag / --option names of the command the line is in, plus -h and --help, at every depth; option values are left to the shell's file completion.
Mechanisms: bash complete -F, zsh #compdef, fish complete -c, PowerShell Register-ArgumentCompleter -Native.
Tests (std/cli/tests/completion.test.trb): one golden test per shell, nested path test, a test that an added flag changes every script.
Docs: docs/standard-library/cli.md (new section and declarations, skill copy updated by hand to match), docs/design/CLI.md (decision recorded, slice 3 done for std/cli).

No seed, syntax, native or driver change. torb completions <shell> follows as a separate issue after a seed refresh.

Not verified locally (no bootstrap by rule): the golden texts were derived from the generator's algorithm by an independent script, so CI is the first real run. torb docs skill --check may want a regenerated skills/ copy.

Refs #125

Adds `Command.completion(shell: Shell): String` and the `Shell` type (Bash, Zsh, Fish, PowerShell) to `std/cli`: a pure function that turns the declared command tree into the completion script of a shell (CLI slice 3, std/cli half). - Completes subcommands (and `help`) and `--flag` / `--option` names of the command the line is in, plus `-h` and `--help`, at every depth; option values are left to the shell's file completion. - Mechanisms: bash `complete -F`, zsh `#compdef`, fish `complete -c`, PowerShell `Register-ArgumentCompleter -Native`. - Tests (`std/cli/tests/completion.test.trb`): one golden test per shell, nested path test, a test that an added flag changes every script. - Docs: `docs/standard-library/cli.md` (new section and declarations, skill copy updated by hand to match), `docs/design/CLI.md` (decision recorded, slice 3 done for std/cli). No seed, syntax, native or driver change. `torb completions <shell>` follows as a separate issue after a seed refresh. Not verified locally (no bootstrap by rule): the golden texts were derived from the generator's algorithm by an independent script, so CI is the first real run. `torb docs skill --check` may want a regenerated `skills/` copy. Refs #125

orion added 2 commits

2026-11-14 09:59:53 +00:00