crackerjack 0.33.0__py3-none-any.whl → 0.33.2__py3-none-any.whl

crackerjack/cli/options.py

@@ -1,8 +1,9 @@
 import typing as t
+import warnings
 from enum import Enum
 
 import typer
-from pydantic import BaseModel, field_validator
+from pydantic import BaseModel, field_validator, model_validator
 
 
 class BumpOption(str, Enum):
@@ -12,7 +13,7 @@ class BumpOption(str, Enum):
     interactive = "interactive"
 
     def __str__(self) -> str:
-        return self.value
+        return str(self.value)
 
 
 class Options(BaseModel):
@@ -21,16 +22,13 @@ class Options(BaseModel):
     no_config_updates: bool = False
     update_precommit: bool = False
     publish: BumpOption | None = None
+    all: BumpOption | None = None
     bump: BumpOption | None = None
     verbose: bool = False
     debug: bool = False
-    clean: bool = False
-    test: bool = False
     benchmark: bool = False
     test_workers: int = 0
     test_timeout: int = 0
-    all: BumpOption | None = None
-    ai_agent: bool = False
     start_mcp_server: bool = False
     stop_mcp_server: bool = False
     restart_mcp_server: bool = False
@@ -61,8 +59,18 @@ class Options(BaseModel):
     stop_websocket_server: bool = False
     restart_websocket_server: bool = False
     websocket_port: int | None = None
+    start_zuban_lsp: bool = False
+    stop_zuban_lsp: bool = False
+    restart_zuban_lsp: bool = False
+    no_zuban_lsp: bool = False
+    zuban_lsp_port: int = 8677
+    zuban_lsp_mode: str = "tcp"
+    zuban_lsp_timeout: int = 30
+    enable_lsp_hooks: bool = False
     dev: bool = False
     dashboard: bool = False
+    unified_dashboard: bool = False
+    unified_dashboard_port: int | None = None
     max_iterations: int = 5
     enterprise_batch: str | None = None
     monitor_dashboard: str | None = None
@@ -76,18 +84,140 @@ class Options(BaseModel):
     global_lock_dir: str | None = None
     quick: bool = False
     thorough: bool = False
+    clear_cache: bool = False
+    cache_stats: bool = False
+
+    # Semantic field names (new primary interface)
+    strip_code: bool | None = None  # Replaces clean
+    run_tests: bool = False  # Replaces test
+    ai_fix: bool | None = None  # Replaces ai_agent
+    full_release: BumpOption | None = None  # Replaces all
+    show_progress: bool | None = None  # Replaces track_progress
+    advanced_monitor: bool | None = None  # Replaces enhanced_monitor
+    coverage_report: bool | None = None  # Replaces coverage_status
+    clean_releases: bool | None = None  # Replaces cleanup_pypi
+
+    # Documentation and changelog generation fields
+    generate_docs: bool = False
+    docs_format: str = "markdown"
+    validate_docs: bool = False
+    generate_changelog: bool = False
+    changelog_version: str | None = None
+    changelog_since: str | None = None
+    changelog_dry_run: bool = False
+    auto_version: bool = False
+    version_since: str | None = None
+    accept_version: bool = False
+
+    # Intelligent features
+    smart_commit: bool = False
+
+    # Analytics and visualization features
+    heatmap: bool = False
+    heatmap_type: str = "error_frequency"
+    heatmap_output: str | None = None
+    anomaly_detection: bool = False
+    anomaly_sensitivity: float = 2.0
+    anomaly_report: str | None = None
+    predictive_analytics: bool = False
+    prediction_periods: int = 10
+    analytics_dashboard: str | None = None
+
+    # Configuration management features
+    check_config_updates: bool = False
+    apply_config_updates: bool = False
+    diff_config: str | None = None
+    config_interactive: bool = False
+    refresh_cache: bool = False
+
+    # Enterprise features
+    enterprise_optimizer: bool = False
+    enterprise_profile: str | None = None
+    enterprise_report: str | None = None
+    mkdocs_integration: bool = False
+    mkdocs_serve: bool = False
+    mkdocs_theme: str = "material"
+    mkdocs_output: str | None = None
+    contextual_ai: bool = False
+    ai_recommendations: int = 5
+    ai_help_query: str | None = None
+
+    def _map_legacy_flag(
+        self, old_attr: str, new_attr: str, deprecation_msg: str | None = None
+    ) -> None:
+        """Helper to map legacy flag to new flag with optional deprecation warning."""
+        old_value = getattr(self, old_attr)
+        new_value = getattr(self, new_attr)
+
+        if old_value and new_value is None:
+            setattr(self, new_attr, old_value)
+            if deprecation_msg:
+                warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=4)
+        elif new_value is not None:
+            setattr(self, old_attr, new_value)
+
+    @model_validator(mode="after")
+    def handle_legacy_mappings(self) -> "Options":
+        """Handle backward compatibility for deprecated flags."""
+        # Map flags without deprecation warnings
+        self._map_legacy_flag("all", "full_release")
+        self._map_legacy_flag("track_progress", "show_progress")
+        self._map_legacy_flag("enhanced_monitor", "advanced_monitor")
+        self._map_legacy_flag("coverage_status", "coverage_report")
+        self._map_legacy_flag("cleanup_pypi", "clean_releases")
+
+        return self
+
+    @property
+    def test(self) -> bool:
+        """Compatibility property for run_tests field."""
+        return self.run_tests
+
+    @test.setter
+    def test(self, value: bool) -> None:
+        """Setter for test property."""
+        self.run_tests = value
+
+    @property
+    def ai_agent(self) -> bool:
+        """Compatibility property for ai_fix field."""
+        return bool(self.ai_fix)
+
+    @ai_agent.setter
+    def ai_agent(self, value: bool) -> None:
+        """Setter for ai_agent property."""
+        self.ai_fix = value if self.ai_fix is not None else value
+
+    @property
+    def clean(self) -> bool:
+        """Compatibility property for strip_code field."""
+        return bool(self.strip_code)
+
+    @clean.setter
+    def clean(self, value: bool) -> None:
+        """Setter for clean property."""
+        self.strip_code = value
+
+    @property
+    def update_docs_index(self) -> bool:
+        """Compatibility property for generate_docs field."""
+        return self.generate_docs
+
+    @update_docs_index.setter
+    def update_docs_index(self, value: bool) -> None:
+        """Setter for update_docs_index property."""
+        self.generate_docs = value
 
     @property
     def effective_max_iterations(self) -> int:
-        """Get the effective max iterations based on quick/thorough flags."""
         if self.quick:
-            return 3  # Quick mode: 3 iterations for CI/CD
+            return 2
         if self.thorough:
-            return 8  # Thorough mode: 8 iterations for complex refactoring
-        return self.max_iterations  # Default: 5 iterations
+            return 8
+        return self.max_iterations
 
     @classmethod
-    @field_validator("publish", "bump", mode="before")
+    @field_validator("publish", "bump", "full_release", mode="before")
     def validate_bump_options(cls, value: t.Any) -> BumpOption | None:
         if value is None:
             return None
@@ -102,6 +232,17 @@ class Options(BaseModel):
                 msg,
             )
 
+    @classmethod
+    @field_validator("zuban_lsp_mode", mode="before")
+    def validate_zuban_lsp_mode(cls, value: t.Any) -> str:
+        if value is None:
+            return "tcp"
+        valid_modes = ["tcp", "stdio"]
+        if value.lower() not in valid_modes:
+            msg = f"Invalid zuban LSP mode: {value}. Must be one of: {', '.join(valid_modes)}"
+            raise ValueError(msg)
+        return str(value).lower()
+
 
 CLI_OPTIONS = {
     "commit": typer.Option(
@@ -134,7 +275,17 @@ CLI_OPTIONS = {
         None,
         "-p",
         "--publish",
-        help="Bump version and publish to PyPI (patch, minor, major). Use 'interactive' to be prompted for version selection.",
+        help=(
+            "Bump version and publish to PyPI (patch, minor, major). "
+            "Use 'interactive' to be prompted for version selection."
+        ),
+        case_sensitive=False,
+    ),
+    "all": typer.Option(
+        None,
+        "-a",
+        "--all",
+        help="Full release workflow: bump version, run quality checks, and publish (patch, minor, major).",
         case_sensitive=False,
     ),
     "bump": typer.Option(
@@ -144,13 +295,6 @@ CLI_OPTIONS = {
         help="Bump version (patch, minor, major).",
         case_sensitive=False,
     ),
-    "clean": typer.Option(
-        False,
-        "-x",
-        "--clean",
-        help="Remove docstrings, line comments, and unnecessary whitespace from source code with automatic backup protection (doesn't affect test files).",
-    ),
-    "test": typer.Option(False, "-t", "--test", help="Run tests."),
     "benchmark": typer.Option(
         False,
         "--benchmark",
@@ -159,12 +303,18 @@ CLI_OPTIONS = {
     "test_workers": typer.Option(
         0,
         "--test-workers",
-        help="Number of parallel workers for running tests (0 = auto-detect, 1 = disable parallelization).",
+        help=(
+            "Number of parallel workers for running tests "
+            "(0 = auto-detect, 1 = disable parallelization)."
+        ),
     ),
     "test_timeout": typer.Option(
         0,
         "--test-timeout",
-        help="Timeout in seconds for individual tests (0 = use default based on project size).",
+        help=(
+            "Timeout in seconds for individual tests "
+            "(0 = use default based on project size)."
+        ),
     ),
     "skip_hooks": typer.Option(
         False,
@@ -180,14 +330,10 @@ CLI_OPTIONS = {
     "comp": typer.Option(
         False,
         "--comp",
-        help="Run only comprehensive hooks (type checking, security, complexity analysis).",
-    ),
-    "all": typer.Option(
-        None,
-        "-a",
-        "--all",
-        help="Run with `-x -t -p <patch|minor|major> -c` development options).",
-        case_sensitive=False,
+        help=(
+            "Run only comprehensive hooks (type checking, security, "
+            "complexity analysis)."
+        ),
     ),
     "create_pr": typer.Option(
         False,
@@ -196,11 +342,6 @@ CLI_OPTIONS = {
         "--new-pull-request",
         help="Create a new pull request to the upstream repository.",
     ),
-    "ai_agent": typer.Option(
-        False,
-        "--ai-agent",
-        help="Enable AI agent mode with autonomous auto-fixing.",
-    ),
     "start_mcp_server": typer.Option(
         False,
         "--start-mcp-server",
@@ -230,22 +371,33 @@ CLI_OPTIONS = {
     "enable_pyrefly": typer.Option(
         False,
         "--enable-pyrefly",
-        help="Enable pyrefly experimental type checking (requires experimental hooks mode).",
+        help=(
+            "Enable pyrefly experimental type checking "
+            "(requires experimental hooks mode)."
+        ),
     ),
     "enable_ty": typer.Option(
         False,
         "--enable-ty",
-        help="Enable ty experimental type verification (requires experimental hooks mode).",
+        help=(
+            "Enable ty experimental type verification "
+            "(requires experimental hooks mode)."
+        ),
     ),
     "no_git_tags": typer.Option(
         False,
         "--no-git-tags",
-        help="Skip creating git tags during version bumping (tags are created by default).",
+        help=(
+            "Skip creating git tags during version bumping "
+            "(tags are created by default)."
+        ),
     ),
     "skip_version_check": typer.Option(
         False,
         "--skip-version-check",
-        help="Skip version consistency verification between pyproject.toml and git tags.",
+        help=(
+            "Skip version consistency verification between pyproject.toml and git tags."
+        ),
     ),
     "start_websocket_server": typer.Option(
         False,
@@ -267,30 +419,98 @@ CLI_OPTIONS = {
         "--websocket-port",
         help="Port for WebSocket server when using --start-mcp-server (e.g., 8675).",
     ),
+    "start_zuban_lsp": typer.Option(
+        False,
+        "--start-zuban-lsp",
+        help="Start Zuban LSP server for real-time type checking.",
+    ),
+    "stop_zuban_lsp": typer.Option(
+        False,
+        "--stop-zuban-lsp",
+        help="Stop all running Zuban LSP servers.",
+    ),
+    "restart_zuban_lsp": typer.Option(
+        False,
+        "--restart-zuban-lsp",
+        help="Restart Zuban LSP server (stop and start again).",
+    ),
+    "no_zuban_lsp": typer.Option(
+        False,
+        "--no-zuban-lsp",
+        help="Disable automatic Zuban LSP server startup.",
+    ),
+    "zuban_lsp_port": typer.Option(
+        8677,
+        "--zuban-lsp-port",
+        help="Port for Zuban LSP server (default: 8677).",
+    ),
+    "zuban_lsp_mode": typer.Option(
+        "tcp",
+        "--zuban-lsp-mode",
+        help="Transport mode for Zuban LSP: tcp or stdio (default: tcp).",
+    ),
+    "zuban_lsp_timeout": typer.Option(
+        30,
+        "--zuban-lsp-timeout",
+        help="Timeout in seconds for LSP server operations (default: 30).",
+    ),
+    "enable_lsp_hooks": typer.Option(
+        False,
+        "--enable-lsp-hooks",
+        help="Enable LSP-optimized hook execution for faster type checking.",
+    ),
     "watchdog": typer.Option(
         False,
         "--watchdog",
-        help="Start service watchdog to monitor and auto-restart MCP and WebSocket servers.",
+        help=(
+            "Start service watchdog to monitor and auto-restart "
+            "MCP and WebSocket servers."
+        ),
     ),
     "monitor": typer.Option(
         False,
         "--monitor",
-        help="Start multi-project progress monitor with WebSocket polling, watchdog services, and autodiscovery.",
+        help=(
+            "Start multi-project progress monitor with WebSocket polling, "
+            "watchdog services, and autodiscovery."
+        ),
     ),
     "enhanced_monitor": typer.Option(
         False,
         "--enhanced-monitor",
-        help="Start enhanced progress monitor with advanced MetricCard widgets and modern web UI patterns.",
+        help=(
+            "Start enhanced progress monitor with advanced MetricCard widgets "
+            "and modern web UI patterns."
+        ),
     ),
     "dev": typer.Option(
         False,
         "--dev",
-        help="Enable development mode for progress monitors (enables textual --dev mode).",
+        help=(
+            "Enable development mode for progress monitors "
+            "(enables textual --dev mode)."
+        ),
     ),
     "dashboard": typer.Option(
         False,
         "--dashboard",
-        help="Start the comprehensive dashboard with system metrics, job tracking, and performance monitoring.",
+        help=(
+            "Start the comprehensive dashboard with system metrics, "
+            "job tracking, and performance monitoring."
+        ),
+    ),
+    "unified_dashboard": typer.Option(
+        False,
+        "--unified-dashboard",
+        help=(
+            "Start the unified monitoring dashboard with real-time WebSocket streaming, "
+            "web UI, and comprehensive system metrics aggregation."
+        ),
+    ),
+    "unified_dashboard_port": typer.Option(
+        None,
+        "--unified-dashboard-port",
+        help="Port for unified dashboard server (default: 8675).",
     ),
     "max_iterations": typer.Option(
         5,
@@ -300,7 +520,7 @@ CLI_OPTIONS = {
     "ai_debug": typer.Option(
         False,
         "--ai-debug",
-        help="Enable verbose debugging for AI agent mode (implies --ai-agent).",
+        help="Enable verbose debugging for AI auto-fixing mode (implies --ai-fix).",
     ),
     "job_id": typer.Option(
         None,
@@ -326,7 +546,10 @@ CLI_OPTIONS = {
     "orchestration_ai_mode": typer.Option(
         "single-agent",
         "--orchestration-ai-mode",
-        help="AI coordination mode: single-agent, multi-agent, coordinator (default: single-agent).",
+        help=(
+            "AI coordination mode: single-agent, multi-agent, coordinator "
+            "(default: single-agent)."
+        ),
     ),
     "coverage_status": typer.Option(
         False,
@@ -346,12 +569,17 @@ CLI_OPTIONS = {
     "boost_coverage": typer.Option(
         True,
         "--boost-coverage/--no-boost-coverage",
-        help="Automatically improve test coverage after successful workflow execution (default: True).",
+        help=(
+            "Automatically improve test coverage after successful "
+            "workflow execution (default: True)."
+        ),
     ),
     "disable_global_locks": typer.Option(
         False,
         "--disable-global-locks",
-        help="Disable global locking (allow concurrent hook execution across sessions).",
+        help=(
+            "Disable global locking (allow concurrent hook execution across sessions)."
+        ),
     ),
     "global_lock_timeout": typer.Option(
         600,
@@ -378,6 +606,259 @@ CLI_OPTIONS = {
         "--thorough",
         help="Thorough mode: Run with maximum 8 iterations (for complex refactoring).",
     ),
+    "clear_cache": typer.Option(
+        False,
+        "--clear-cache",
+        help="Clear all caches (hook results, file hashes, agent decisions) and exit.",
+    ),
+    "cache_stats": typer.Option(
+        False,
+        "--cache-stats",
+        help="Display cache statistics (hit rates, sizes, entries) and exit.",
+    ),
+    # New semantic CLI options with backward compatibility
+    "strip_code": typer.Option(
+        None,
+        "-x",
+        "--strip-code",
+        help="Remove docstrings, line comments, and unnecessary whitespace from source code with automatic backup protection (doesn't affect test files).",
+    ),
+    "run_tests": typer.Option(
+        False,
+        "-t",
+        "--run-tests",
+        help=(
+            "Execute the test suite with automatic worker detection "
+            "and timeout handling."
+        ),
+    ),
+    "ai_fix": typer.Option(
+        None,
+        "--ai-fix",
+        help=(
+            "Enable AI-powered automatic fixing of code quality issues "
+            "and test failures."
+        ),
+    ),
+    "full_release": typer.Option(
+        None,
+        "-a",
+        "--full-release",
+        help="Complete release workflow: strip code, run tests, bump version, and publish. Equivalent to `-x -t -p <version> -c`.",
+        case_sensitive=False,
+    ),
+    "show_progress": typer.Option(
+        None,
+        "--show-progress",
+        help=(
+            "Display detailed progress tracking during execution. "
+            "[Semantic alias for --track-progress]"
+        ),
+    ),
+    "advanced_monitor": typer.Option(
+        None,
+        "--advanced-monitor",
+        help=(
+            "Enable advanced monitoring dashboard with detailed metrics "
+            "and analytics. [Semantic alias for --enhanced-monitor]"
+        ),
+    ),
+    "coverage_report": typer.Option(
+        None,
+        "--coverage-report",
+        help=(
+            "Display comprehensive coverage analysis and report. "
+            "[Semantic alias for --coverage-status]"
+        ),
+    ),
+    "clean_releases": typer.Option(
+        None,
+        "--clean-releases",
+        help=(
+            "Clean up old releases from PyPI, keeping only the most recent "
+            "versions. [Semantic alias for --cleanup-pypi]"
+        ),
+    ),
+    "generate_docs": typer.Option(
+        False,
+        "--generate-docs",
+        help=(
+            "Generate comprehensive API documentation from source code "
+            "with AST analysis and cross-references."
+        ),
+    ),
+    "docs_format": typer.Option(
+        "markdown",
+        "--docs-format",
+        help="Documentation output format: 'markdown' (default), 'rst', or 'html'.",
+    ),
+    "validate_docs": typer.Option(
+        False,
+        "--validate-docs",
+        help="Validate existing documentation for completeness and consistency.",
+    ),
+    "generate_changelog": typer.Option(
+        False,
+        "--generate-changelog",
+        help="Generate changelog entries from git commits.",
+    ),
+    "changelog_version": typer.Option(
+        None,
+        "--changelog-version",
+        help="Version number for changelog generation (default: next version).",
+    ),
+    "changelog_since": typer.Option(
+        None,
+        "--changelog-since",
+        help="Generate changelog since this version/tag (default: last release).",
+    ),
+    "changelog_dry_run": typer.Option(
+        False,
+        "--changelog-dry-run",
+        help="Preview changelog generation without writing to file.",
+    ),
+    "auto_version": typer.Option(
+        False,
+        "--auto-version",
+        help="Automatically analyze changes and recommend version bump.",
+    ),
+    "version_since": typer.Option(
+        None,
+        "--version-since",
+        help="Analyze changes since this version/tag for version bump recommendation.",
+    ),
+    "accept_version": typer.Option(
+        False,
+        "--accept-version",
+        help="Automatically accept version bump recommendation without confirmation.",
+    ),
+    "smart_commit": typer.Option(
+        False,
+        "--smart-commit",
+        help="Generate intelligent commit messages based on code changes using AI analysis.",
+    ),
+    "heatmap": typer.Option(
+        False,
+        "--heatmap",
+        help="Generate visual heat map analysis of code quality patterns and error distributions.",
+    ),
+    "heatmap_type": typer.Option(
+        "error_frequency",
+        "--heatmap-type",
+        help="Type of heat map to generate: error_frequency, complexity, quality_metrics, test_failures.",
+    ),
+    "heatmap_output": typer.Option(
+        None,
+        "--heatmap-output",
+        help="Output file path for heat map data (JSON/CSV) or HTML visualization.",
+    ),
+    "anomaly_detection": typer.Option(
+        False,
+        "--anomaly-detection",
+        help="Enable ML-based anomaly detection for quality metrics monitoring.",
+    ),
+    "anomaly_sensitivity": typer.Option(
+        2.0,
+        "--anomaly-sensitivity",
+        help="Sensitivity level for anomaly detection (1.0=very sensitive, 3.0=less sensitive).",
+    ),
+    "anomaly_report": typer.Option(
+        None,
+        "--anomaly-report",
+        help="Output file path for anomaly detection report (JSON format).",
+    ),
+    "predictive_analytics": typer.Option(
+        False,
+        "--predictive-analytics",
+        help="Enable predictive analytics for quality metrics forecasting and trend analysis.",
+    ),
+    "prediction_periods": typer.Option(
+        10,
+        "--prediction-periods",
+        help="Number of future periods to predict (default: 10).",
+    ),
+    "analytics_dashboard": typer.Option(
+        None,
+        "--analytics-dashboard",
+        help="Output file path for analytics dashboard (HTML format).",
+    ),
+    # Enterprise features
+    "enterprise_optimizer": typer.Option(
+        False,
+        "--enterprise-optimizer",
+        help="Enable enterprise-scale optimization engine with resource monitoring and scaling analysis.",
+    ),
+    "enterprise_profile": typer.Option(
+        None,
+        "--enterprise-profile",
+        help="Enterprise optimization profile: balanced, performance, memory, throughput.",
+    ),
+    "enterprise_report": typer.Option(
+        None,
+        "--enterprise-report",
+        help="Output file path for enterprise optimization report (JSON format).",
+    ),
+    "mkdocs_integration": typer.Option(
+        False,
+        "--mkdocs-integration",
+        help="Generate complete MkDocs documentation site with Material theme and automation.",
+    ),
+    "mkdocs_serve": typer.Option(
+        False,
+        "--mkdocs-serve",
+        help="Start MkDocs development server after building documentation site.",
+    ),
+    "mkdocs_theme": typer.Option(
+        "material",
+        "--mkdocs-theme",
+        help="MkDocs theme to use for documentation generation (default: material).",
+    ),
+    "mkdocs_output": typer.Option(
+        None,
+        "--mkdocs-output",
+        help="Output directory for MkDocs site generation (default: ./docs_site).",
+    ),
+    "contextual_ai": typer.Option(
+        False,
+        "--contextual-ai",
+        help="Enable contextual AI assistant with project-specific recommendations and insights.",
+    ),
+    "ai_recommendations": typer.Option(
+        5,
+        "--ai-recommendations",
+        help="Maximum number of AI recommendations to display (default: 5).",
+    ),
+    "ai_help_query": typer.Option(
+        None,
+        "--ai-help-query",
+        help="Get contextual help for specific query using AI assistant.",
+    ),
+    # Configuration management features
+    "check_config_updates": typer.Option(
+        False,
+        "--check-config-updates",
+        help="Check for available configuration template updates.",
+    ),
+    "apply_config_updates": typer.Option(
+        False,
+        "--apply-config-updates",
+        help="Apply available configuration template updates.",
+    ),
+    "diff_config": typer.Option(
+        None,
+        "--diff-config",
+        help="Show diff preview for a specific configuration type.",
+    ),
+    "config_interactive": typer.Option(
+        False,
+        "--config-interactive",
+        help="Apply configuration updates interactively with confirmations.",
+    ),
+    "refresh_cache": typer.Option(
+        False,
+        "--refresh-cache",
+        help="Refresh pre-commit cache to ensure fresh environment.",
+    ),
 }
 
 
@@ -389,10 +870,7 @@ def create_options(
     verbose: bool,
     debug: bool,
     publish: BumpOption | None,
-    all: BumpOption | None,
     bump: BumpOption | None,
-    clean: bool,
-    test: bool,
     benchmark: bool,
     test_workers: int,
     test_timeout: int,
@@ -400,11 +878,18 @@ def create_options(
     fast: bool,
     comp: bool,
     create_pr: bool,
-    ai_agent: bool,
     async_mode: bool,
     experimental_hooks: bool,
     enable_pyrefly: bool,
     enable_ty: bool,
+    start_zuban_lsp: bool,
+    stop_zuban_lsp: bool,
+    restart_zuban_lsp: bool,
+    no_zuban_lsp: bool,
+    zuban_lsp_port: int,
+    zuban_lsp_mode: str,
+    zuban_lsp_timeout: int,
+    enable_lsp_hooks: bool,
     no_git_tags: bool,
     skip_version_check: bool,
     orchestrated: bool,
@@ -413,6 +898,8 @@ def create_options(
     orchestration_ai_mode: str,
     dev: bool,
     dashboard: bool,
+    unified_dashboard: bool,
+    unified_dashboard_port: int | None,
     max_iterations: int,
     coverage_status: bool,
     coverage_goal: float | None,
@@ -424,6 +911,53 @@ def create_options(
     global_lock_dir: str | None,
     quick: bool,
     thorough: bool,
+    clear_cache: bool,
+    cache_stats: bool,
+    generate_docs: bool,
+    docs_format: str,
+    validate_docs: bool,
+    generate_changelog: bool,
+    changelog_version: str | None,
+    changelog_since: str | None,
+    changelog_dry_run: bool,
+    auto_version: bool,
+    version_since: str | None,
+    accept_version: bool,
+    smart_commit: bool,
+    heatmap: bool,
+    heatmap_type: str,
+    heatmap_output: str | None,
+    anomaly_detection: bool,
+    anomaly_sensitivity: float,
+    anomaly_report: str | None,
+    predictive_analytics: bool,
+    prediction_periods: int,
+    analytics_dashboard: str | None,
+    # Enterprise features
+    enterprise_optimizer: bool,
+    enterprise_profile: str | None,
+    enterprise_report: str | None,
+    mkdocs_integration: bool,
+    mkdocs_serve: bool,
+    mkdocs_theme: str,
+    mkdocs_output: str | None,
+    contextual_ai: bool,
+    ai_recommendations: int,
+    ai_help_query: str | None,
+    check_config_updates: bool,
+    apply_config_updates: bool,
+    diff_config: str | None,
+    config_interactive: bool,
+    refresh_cache: bool,
+    # New semantic parameters
+    strip_code: bool | None = None,
+    run_tests: bool = False,
+    ai_fix: bool | None = None,
+    full_release: BumpOption | None = None,
+    show_progress: bool | None = None,
+    advanced_monitor: bool | None = None,
+    coverage_report: bool | None = None,
+    clean_releases: bool | None = None,
 ) -> Options:
     return Options(
         commit=commit,
@@ -434,21 +968,25 @@ def create_options(
         debug=debug,
         publish=publish,
         bump=bump,
-        clean=clean,
-        test=test,
         benchmark=benchmark,
         test_workers=test_workers,
         test_timeout=test_timeout,
         skip_hooks=skip_hooks,
         fast=fast,
         comp=comp,
-        all=all,
-        ai_agent=ai_agent,
         create_pr=create_pr,
         async_mode=async_mode,
         experimental_hooks=experimental_hooks,
         enable_pyrefly=enable_pyrefly,
         enable_ty=enable_ty,
+        start_zuban_lsp=start_zuban_lsp,
+        stop_zuban_lsp=stop_zuban_lsp,
+        restart_zuban_lsp=restart_zuban_lsp,
+        no_zuban_lsp=no_zuban_lsp,
+        zuban_lsp_port=zuban_lsp_port,
+        zuban_lsp_mode=zuban_lsp_mode,
+        zuban_lsp_timeout=zuban_lsp_timeout,
+        enable_lsp_hooks=enable_lsp_hooks,
         no_git_tags=no_git_tags,
         skip_version_check=skip_version_check,
         orchestrated=orchestrated,
@@ -457,6 +995,8 @@ def create_options(
         orchestration_ai_mode=orchestration_ai_mode,
         dev=dev,
         dashboard=dashboard,
+        unified_dashboard=unified_dashboard,
+        unified_dashboard_port=unified_dashboard_port,
         max_iterations=max_iterations,
         coverage_status=coverage_status,
         coverage_goal=coverage_goal,
@@ -468,4 +1008,51 @@ def create_options(
         global_lock_dir=global_lock_dir,
         quick=quick,
         thorough=thorough,
+        clear_cache=clear_cache,
+        cache_stats=cache_stats,
+        generate_docs=generate_docs,
+        docs_format=docs_format,
+        validate_docs=validate_docs,
+        generate_changelog=generate_changelog,
+        changelog_version=changelog_version,
+        changelog_since=changelog_since,
+        changelog_dry_run=changelog_dry_run,
+        auto_version=auto_version,
+        version_since=version_since,
+        accept_version=accept_version,
+        smart_commit=smart_commit,
+        heatmap=heatmap,
+        heatmap_type=heatmap_type,
+        heatmap_output=heatmap_output,
+        anomaly_detection=anomaly_detection,
+        anomaly_sensitivity=anomaly_sensitivity,
+        anomaly_report=anomaly_report,
+        predictive_analytics=predictive_analytics,
+        prediction_periods=prediction_periods,
+        analytics_dashboard=analytics_dashboard,
+        # Enterprise features
+        enterprise_optimizer=enterprise_optimizer,
+        enterprise_profile=enterprise_profile,
+        enterprise_report=enterprise_report,
+        mkdocs_integration=mkdocs_integration,
+        mkdocs_serve=mkdocs_serve,
+        mkdocs_theme=mkdocs_theme,
+        mkdocs_output=mkdocs_output,
+        contextual_ai=contextual_ai,
+        ai_recommendations=ai_recommendations,
+        ai_help_query=ai_help_query,
+        check_config_updates=check_config_updates,
+        apply_config_updates=apply_config_updates,
+        diff_config=diff_config,
+        config_interactive=config_interactive,
+        refresh_cache=refresh_cache,
+        # New semantic parameters
+        strip_code=strip_code,
+        run_tests=run_tests,
+        ai_fix=ai_fix,
+        full_release=full_release,
+        show_progress=show_progress,
+        advanced_monitor=advanced_monitor,
+        coverage_report=coverage_report,
+        clean_releases=clean_releases,
     )