chore(main): release 18.2.0 - #2569

The .completion() API docs have advertised "bash/zsh/fish-completion" support for a long time, and even tell users to write the output to ~/.config/fish/completions/command.fish:

But the code only shipped bash and zsh templates until #2568 — the fish template didn't exist.
This has real consequences: downstream CLIs (e.g. opencode) followed the docs and created fish completion files like mycli completion fish | source. With no fish template in the code, yargs emitted bash syntax, which breaks fish on source with command substitutions not allowed here. Releasing 18.2.0 would fix this for everyone (including agents!) who trusted the docs.

In retrospect, I should have delayed landing the fish completions PR, or used a staging branch.

After some investigation, the documentation site is failing to work out the last release tag and using the master branch as fallback. That explains the leakage, and how it was working better in past.

Ah, that makes sense.

Any chance of a backport to 18.1.x (either fixing the docs or cherry picking the fix)? Not sure how much work that would be, but I appreciate the cadence of this project doesn't make cutting 18.2.0 realistic. Happy to prepare a PR myself if that's a blocker.

I don't know what will be involved in updating the documentation site so it only shows released changes, but releasing 18.2 should be fine. Heading towards that.