Summary

• make generated zsh completion valid for compinit / ~/.zfunc/_hermes installs
• replace invalid grouped _arguments specs like { -h,--help } with separate zsh option specs
• remove direct _hermes "$@" self-invocation from the generated completion file
• update zsh completion comments to document the autoload/fpath install path
• add regression coverage for the invalid zsh output

Validation

• git diff --check
• python3 -m compileall hermes_cli/completion.py tests/hermes_cli/test_completion.py
• scoped assertions: generated code no longer contains _hermes "$@" or {{-h,--help}} / {{-V,--version}} / {{-p,--profile}}
• manual local validation on macOS zsh 5.9 using ~/.zfunc/_hermes + compinit: hermes <TAB> no longer raises _arguments:comparguments:327

Notes

I intentionally kept the fix narrow: only zsh completion generation and regression tests changed. No provider config, dependency lockfile, shell rc file, or runtime code path was modified.

Closes #21829
Related to #17266