In #13555, it's noted that the built completion script that ships with zsh seems to be significantly better than the completion script we provide. We may want to consider removing our own script or at least redirecting users to use that. The built-in script does seem to be outdated, having been last updated over 4 years ago and missing some newer flags, but it's still likely a better experience overall.