Enhance help sync test to verify subcommand documentation

[bjcoombs]

Summary

Follow-up to #1594. The current help sync test only checks if commands exist in help documentation, not if their subcommands/options are correctly documented.

Problem

PR #1593 fixed outdated help documentation where:

• tags showed old commands (add-tag, use-tag) instead of new subcommand structure (tags add, tags use)
• list was missing new options (--watch, --ready, --blocking)

The test in #1595 wouldn't catch these issues because it only verifies command existence.

Proposed Enhancement

Add verification that:

1. tags subcommands are documented (tags add, tags use, tags remove, tags rename, tags copy, tags list)
2. Key command options are documented (e.g., list shows --watch, --ready, --blocking)

Dependencies

• Requires docs: Update help command with current tags and list options #1593 to be merged first (or branch from it)

Related

• Help command shows outdated tag commands and missing list options #1588 - Original help outdated issue
• docs: Update help command with current tags and list options #1593 - Fix for outdated help
• Add lint/test to ensure help documentation stays in sync with commands #1594 - Original test issue
• test: Add test to ensure help documentation stays in sync with CLI commands #1595 - Basic help sync test PR