fix: resolve technical debt - dynamic version and command options handling (v0.5.2)

Resolved 2 TODO items in generator.py:

1. Dynamic Version Retrieval (Line 191):
   - Added _get_metaspec_version() method
   - Uses importlib.metadata.version() to get actual package version
   - Includes fallback to '0.0.0' if metadata unavailable
   - Replaces hardcoded '0.1.0' with dynamic version

2. Command Options Handling (Line 514):
   - Properly generates CLI command parameters from options
   - Supports required and optional parameters
   - Handles parameter types correctly
   - Generates default values (None) for optional parameters
   - Adds display output for each option value

Code Quality:
- Fixed linter warnings (unused variable, blank line whitespace)
- Improved code maintainability
- Better generated CLI command structure

Impact:
- Generated speckits will show correct MetaSpec version
- CLI commands with options will work properly
- Better developer experience with generated code

Author: NeilJo-GY

CHANGELOG.md

@@ -9,6 +9,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.5.2] - 2025-11-11
+
+### 🐛 Bug Fixes
+
+**Technical Debt Cleanup**
+
+Resolved 2 TODO items in the generator module:
+
+1. **Dynamic Version Retrieval**: Now automatically gets MetaSpec version from package metadata using `importlib.metadata.version()`
+   - Previously hardcoded as "0.1.0"
+   - Now reflects the actual installed version (0.5.2)
+   - Includes fallback to "0.0.0" if metadata unavailable
+
+2. **Command Options Handling**: Properly generates CLI command parameters from options
+   - Supports both required and optional parameters
+   - Correctly handles parameter types
+   - Generates appropriate default values for optional parameters
+   - Adds display output for each option
+
+**Changes**:
+- `generator.py`: Added `_get_metaspec_version()` method
+- `generator.py`: Enhanced command generation to properly handle options with types and requirements
+- Fixed linter warnings (removed unused variables, cleaned blank lines)
+
+---
+
 ## [0.5.1] - 2025-11-11
 
 ### 🔄 Refactoring

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "meta-spec"
-version = "0.5.1"
+version = "0.5.2"
 description = "Meta-specification framework for generating Spec-Driven X (SD-X) toolkits for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

src/metaspec/generator.py

@@ -8,6 +8,7 @@
 import re
 import textwrap
 from datetime import datetime
+from importlib.metadata import version
 from pathlib import Path
 from typing import Any
 
@@ -109,6 +110,19 @@ def generate(
 
         return project
 
+    def _get_metaspec_version(self) -> str:
+        """
+        Get the MetaSpec package version from metadata.
+
+        Returns:
+            Version string (e.g., "0.5.1")
+        """
+        try:
+            return version("meta-spec")
+        except Exception:
+            # Fallback to a default version if package metadata is not available
+            return "0.0.0"
+
     def _create_template_context(self, meta_spec: MetaSpecDefinition) -> dict[str, Any]:
         """
         Create template rendering context from MetaSpecDefinition.
@@ -188,7 +202,7 @@ def _create_template_context(self, meta_spec: MetaSpecDefinition) -> dict[str, A
             "dependencies": meta_spec.dependencies or [],
             "year": datetime.now().year,
             "date": datetime.now().date().isoformat(),
-            "metaspec_version": "0.1.0",  # TODO: Get from package metadata
+            "metaspec_version": self._get_metaspec_version(),
         }
 
     def _select_templates(self, meta_spec: MetaSpecDefinition) -> dict[str, str]:
@@ -497,18 +511,34 @@ def {cmd_name}():
                 )
             else:
                 # Generate function with options if present
+                params_list = ["spec_file: str"]
+                option_prints = ['console.print(f"[green]{cmd_name.title()}:[/green] {{spec_file}}")']
+
                 if cmd.get("options"):
-                    # TODO: Handle options properly
-                    params = "spec_file: str"
-                else:
-                    params = "spec_file: str"
+                    for opt in cmd["options"]:
+                        opt_name = opt["name"]
+                        opt_type = opt["type"]
+                        opt_required = opt.get("required", False)
+
+                        # Build parameter declaration
+                        if opt_required:
+                            params_list.append(f"{opt_name}: {opt_type}")
+                        else:
+                            # Optional parameter with default None
+                            params_list.append(f"{opt_name}: {opt_type} = None")
+
+                        # Add print statement for the option
+                        option_prints.append(f'console.print(f"[blue]{opt_name.title()}:[/blue] {{{opt_name}}}")')
+
+                params = ", ".join(params_list)
+                option_code = "\n                        ".join(option_prints)
 
                 command_functions.append(
                     textwrap.dedent(f'''
                     @app.command()
                     def {cmd_name}({params}):
                         """{cmd_desc}"""
-                        console.print(f"[green]{cmd_name.title()}:[/green] {{spec_file}}")
+                        {option_code}
                         # TODO: Implement {cmd_name}
                 ''').strip()
                 )