feat(commands): add descriptions to command parsers for better clarity

Author: httpdss

struct_module/commands/generate.py

@@ -12,6 +12,7 @@
 class GenerateCommand(Command):
   def __init__(self, parser):
     super().__init__(parser)
+    parser.description = "Generate the project structure from a YAML configuration file"
     structure_arg = parser.add_argument('structure_definition', type=str, help='Path to the YAML configuration file')
     structure_arg.completer = structures_completer
     parser.add_argument('base_path', type=str, help='Base path where the structure will be created')

struct_module/commands/generate_schema.py

@@ -6,6 +6,7 @@
 class GenerateSchemaCommand(Command):
     def __init__(self, parser):
         super().__init__(parser)
+        parser.description = "Generate JSON schema for available structures"
         parser.add_argument('-s', '--structures-path', type=str, help='Path to structure definitions')
         parser.add_argument('-o', '--output', type=str, help='Output file path for the schema (default: stdout)')
         parser.set_defaults(func=self.execute)

struct_module/commands/info.py

@@ -8,6 +8,7 @@
 class InfoCommand(Command):
     def __init__(self, parser):
       super().__init__(parser)
+      parser.description = "Show information about the package or structure definition"
       parser.add_argument('structure_definition', type=str, help='Name of the structure definition')
       parser.add_argument('-s', '--structures-path', type=str, help='Path to structure definitions')
       parser.add_argument('--mcp', action='store_true', help='Enable MCP (Model Context Protocol) integration')

struct_module/commands/list.py

@@ -9,6 +9,7 @@
 class ListCommand(Command):
   def __init__(self, parser):
     super().__init__(parser)
+    parser.description = "List available structures"
     parser.add_argument('-s', '--structures-path', type=str, help='Path to structure definitions')
     parser.add_argument('--names-only', action='store_true', help='Print only structure names, one per line (for shell completion)')
     parser.add_argument('--mcp', action='store_true', help='Enable MCP (Model Context Protocol) integration')

struct_module/commands/mcp.py

@@ -8,6 +8,7 @@
 class MCPCommand(Command):
     def __init__(self, parser):
         super().__init__(parser)
+        parser.description = "MCP (Model Context Protocol) support for struct tool"
         parser.add_argument('--server', action='store_true',
                           help='Start the MCP server for stdio communication')
         parser.set_defaults(func=self.execute)

struct_module/commands/validate.py

@@ -9,6 +9,7 @@
 class ValidateCommand(Command):
     def __init__(self, parser):
       super().__init__(parser)
+      parser.description = "Validate a YAML configuration file for structure definitions"
       parser.add_argument('yaml_file', type=str, help='Path to the YAML configuration file')
       parser.set_defaults(func=self.execute)