[mauvilsa]

What does this PR do?

Brings the expected type guidance of shtab bash completions to zsh. When completing a value, zsh now shows a message like Expected type: bool | None above the choices, formatted with the user's descriptions style if one is configured. This covers options, positionals, subclass selection and subclass init_args, the last of these saying which subclasses accept them. For types that also accept values other than the choices, e.g. null for int | None, the choices are listed but not inserted until a prefix is typed, same as in bash.

It also fixes zsh completion script generation, which failed with TypeError: vars() argument must have __dict__ attribute for parsers that have subcommands added without help.

Before submitting

• Did you read the contributing guideline?
• If you used a coding agent, did you fully understand and validate all generated code and ensure it follows the contributing guidelines?
• Did you update the documentation? (readme and public docstrings)
• Did you write unit tests such that there is 100% coverage on related code? (required for bug fixes and new features)
• Did you verify that new and existing tests pass locally?
• If this is a bug fix, did you verify that the tests fail without the code fix?
• Did you make sure that all changes preserve backward compatibility?
• Did you update the CHANGELOG including a pull request link? (not for typos, docs, test updates, or minor internal changes/refactors)

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable issues were found.

Summary

Adds expected-type messages to zsh completions for typed arguments and subclass parameters.

• Zsh completions explain expected value types beside their choices.
• Zsh completion scripts generate for subcommands with no help text.

_{Reviews (1) · Last reviewed commit: "Add expected type guidance to shtab zsh ..." · Reviewed by Greptile}

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (7ef2bab) to head (9519cc7).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1024   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           27        27           
  Lines         9950      9962   +12     
=========================================
+ Hits          9950      9962   +12     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.