feat: add PowerShell completion support

[jdx]

Summary

• Add PowerShell as a supported shell for completion generation and script execution
• New usage powershell <script> command (uses pwsh interpreter)
• Add powershell to usage generate completion shell choices
• Add powershell to usage complete-word --shell options
• Integration test requires pwsh to be installed (no skip for CI)

Fixes #314

Changes

New files:

• lib/src/complete/powershell.rs - PowerShell completion script generator
• docs/cli/reference/powershell.md - Documentation

Modified files:

• lib/src/complete/mod.rs - Wire in powershell module
• cli/src/cli/mod.rs - Add Powershell command variant
• cli/src/cli/complete_word.rs - Add powershell shell option
• cli/src/cli/generate/completion.rs - Add powershell to shell choices
• cli/tests/shell_completions_integration.rs - Add PowerShell integration test

Test plan

• Unit tests pass (cargo test -p usage-lib test_complete_powershell)
• Integration test passes (cargo test -p usage-cli test_powershell_completion_integration)
• All existing tests pass
• Manual test: cargo run -- generate completion powershell mycli --usage-cmd "echo test"

🤖 Generated with Claude Code

---

Note

Adds first-class PowerShell support across completion and execution.

• New lib/src/complete/powershell.rs generator wired into complete(); outputs PS Register-ArgumentCompleter script
• CLI updates: usage generate completion and complete-word --shell accept powershell; new usage powershell subcommand (executes via pwsh)
• Integration: PowerShell completion test added; snapshot tests for generator output
• Assets/docs/manpage updated (Fig spec, usage.1, KDL spec, reference pages) to include PowerShell options and command

^{Written by Cursor Bugbot for commit 2587c6d. This will update automatically on new commits. Configure here.}

[Copilot]

Pull request overview

This PR adds PowerShell completion support to the usage CLI, enabling completion generation and script execution for PowerShell environments.

Changes:

• Add PowerShell as a supported shell for completion generation alongside bash, fish, and zsh
• Implement usage powershell <script> command using pwsh interpreter
• Add PowerShell integration test requiring pwsh installation

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
lib/src/complete/powershell.rs	PowerShell completion script generator implementation
lib/src/complete/mod.rs	Wire PowerShell module into completion system
cli/src/cli/mod.rs	Add Powershell command variant
cli/src/cli/complete_word.rs	Add powershell to shell option choices
cli/src/cli/generate/completion.rs	Add powershell to shell choices for completion generation
cli/tests/shell_completions_integration.rs	PowerShell integration test
docs/cli/reference/powershell.md	PowerShell command documentation
docs/cli/reference/index.md	Update command index with PowerShell entry
docs/cli/reference/generate/completion.md	Update completion docs to include PowerShell
docs/cli/reference/complete-word.md	Update complete-word docs with PowerShell option
docs/cli/reference/commands.json	Update command metadata with PowerShell entries
cli/usage.usage.kdl	Update usage spec with PowerShell command
cli/assets/usage.1	Update manpage with PowerShell documentation
cli/assets/fig.ts	Update Fig completion spec with PowerShell
lib/src/complete/snapshots/*	Snapshot test files for PowerShell completion

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 93.26923% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 47.42%. Comparing base (2cd5def) to head (2587c6d).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
lib/src/complete/powershell.rs	95.04%	5 Missing ⚠️
cli/src/cli/complete_word.rs	0.00%	0 Missing and 1 partial ⚠️
cli/src/cli/mod.rs	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #431      +/-   ##
==========================================
+ Coverage   46.63%   47.42%   +0.78%     
==========================================
  Files          46       47       +1     
  Lines        6546     6651     +105     
  Branches     6546     6651     +105     
==========================================
+ Hits         3053     3154     +101     
- Misses       1732     1737       +5     
+ Partials     1761     1760       -1     

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}