add `zsh_path_helper` to `caveats` DSL

Per discussion in #3597 and Homebrew/homebrew#25719
Merge pull request #3699 from rolandwalker/zsh_path_helper_caveat

add `zsh_path_helper` to `caveats` DSL