feat(cli): implement hatch mcp sync command with advanced options

Add comprehensive sync command with full CLI integration:
- Mutually exclusive source options: --from-env and --from-host
- Required target specification: --to-host with multi-host support
- Server filtering options: --servers and --pattern (mutually exclusive)
- Standard operation flags: --dry-run, --auto-approve, --no-backup

Command structure:
  hatch mcp sync [SOURCE] [TARGET] [FILTERS] [OPTIONS]

Key features:
- Argument parsing with proper validation and error messages
- Integration with parse_host_list for host resolution
- TTY-safe user confirmation using request_confirmation()
- Detailed dry-run preview and progress reporting
- Proper error handling and user feedback

Fixes host list parsing issues by using correct string-returning function.
Implements Phase 3f CLI requirements with intuitive user experience.

Author: LittleCoinCoin

hatch/cli_hatch.py

@@ -767,6 +767,90 @@ def handle_mcp_remove_host(host_name: str, no_backup: bool = False,
         print(f"Error removing host configuration: {e}")
         return 1
 
+def handle_mcp_sync(from_env: Optional[str] = None,
+                   from_host: Optional[str] = None,
+                   to_hosts: Optional[str] = None,
+                   servers: Optional[str] = None,
+                   pattern: Optional[str] = None,
+                   dry_run: bool = False,
+                   auto_approve: bool = False,
+                   no_backup: bool = False) -> int:
+    """Handle 'hatch mcp sync' command."""
+    try:
+        # Parse target hosts
+        if not to_hosts:
+            print("Error: Must specify --to-host")
+            return 1
+
+        target_hosts = parse_host_list(to_hosts)
+
+        # Parse server filters
+        server_list = None
+        if servers:
+            server_list = [s.strip() for s in servers.split(',') if s.strip()]
+
+        if dry_run:
+            source_desc = f"environment '{from_env}'" if from_env else f"host '{from_host}'"
+            target_desc = f"hosts: {', '.join(target_hosts)}"
+            print(f"[DRY RUN] Would synchronize from {source_desc} to {target_desc}")
+
+            if server_list:
+                print(f"[DRY RUN] Server filter: {', '.join(server_list)}")
+            elif pattern:
+                print(f"[DRY RUN] Pattern filter: {pattern}")
+
+            print(f"[DRY RUN] Backup: {'Disabled' if no_backup else 'Enabled'}")
+            return 0
+
+        # Confirm operation unless auto-approved
+        source_desc = f"environment '{from_env}'" if from_env else f"host '{from_host}'"
+        target_desc = f"{len(target_hosts)} host(s)"
+        if not request_confirmation(
+            f"Synchronize MCP configurations from {source_desc} to {target_desc}?",
+            auto_approve
+        ):
+            print("Operation cancelled.")
+            return 0
+
+        # Perform synchronization
+        mcp_manager = MCPHostConfigurationManager()
+        result = mcp_manager.sync_configurations(
+            from_env=from_env,
+            from_host=from_host,
+            to_hosts=target_hosts,
+            servers=server_list,
+            pattern=pattern,
+            no_backup=no_backup
+        )
+
+        if result.success:
+            print(f"[SUCCESS] Synchronization completed")
+            print(f"  Servers synced: {result.servers_synced}")
+            print(f"  Hosts updated: {result.hosts_updated}")
+
+            # Show detailed results
+            for res in result.results:
+                if res.success:
+                    backup_info = f" (backup: {res.backup_path})" if res.backup_path else ""
+                    print(f"  ✓ {res.hostname}{backup_info}")
+                else:
+                    print(f"  ✗ {res.hostname}: {res.error_message}")
+
+            return 0
+        else:
+            print(f"[ERROR] Synchronization failed")
+            for res in result.results:
+                if not res.success:
+                    print(f"  ✗ {res.hostname}: {res.error_message}")
+            return 1
+
+    except ValueError as e:
+        print(f"Error: {e}")
+        return 1
+    except Exception as e:
+        print(f"Error during synchronization: {e}")
+        return 1
+
 def main():
     """Main entry point for Hatch CLI.
     
@@ -954,6 +1038,27 @@ def main():
     mcp_remove_host_parser.add_argument("--dry-run", action="store_true", help="Preview removal without execution")
     mcp_remove_host_parser.add_argument("--auto-approve", action="store_true", help="Skip confirmation prompts")
 
+    # MCP synchronization command
+    mcp_sync_parser = mcp_subparsers.add_parser("sync", help="Synchronize MCP configurations between environments and hosts")
+
+    # Source options (mutually exclusive)
+    sync_source_group = mcp_sync_parser.add_mutually_exclusive_group(required=True)
+    sync_source_group.add_argument("--from-env", help="Source environment name")
+    sync_source_group.add_argument("--from-host", help="Source host platform")
+
+    # Target options
+    mcp_sync_parser.add_argument("--to-host", required=True, help="Target hosts (comma-separated or 'all')")
+
+    # Filter options (mutually exclusive)
+    sync_filter_group = mcp_sync_parser.add_mutually_exclusive_group()
+    sync_filter_group.add_argument("--servers", help="Specific server names to sync (comma-separated)")
+    sync_filter_group.add_argument("--pattern", help="Regex pattern for server selection")
+
+    # Standard options
+    mcp_sync_parser.add_argument("--dry-run", action="store_true", help="Preview synchronization without execution")
+    mcp_sync_parser.add_argument("--auto-approve", action="store_true", help="Skip confirmation prompts")
+    mcp_sync_parser.add_argument("--no-backup", action="store_true", help="Skip backup creation before synchronization")
+
     # Package management commands
     pkg_subparsers = subparsers.add_parser("package", help="Package management commands").add_subparsers(
         dest="pkg_command", help="Package command to execute"
@@ -1468,6 +1573,18 @@ def main():
                 print("Unknown remove command")
                 return 1
 
+        elif args.mcp_command == "sync":
+            return handle_mcp_sync(
+                from_env=getattr(args, 'from_env', None),
+                from_host=getattr(args, 'from_host', None),
+                to_hosts=args.to_host,
+                servers=getattr(args, 'servers', None),
+                pattern=getattr(args, 'pattern', None),
+                dry_run=args.dry_run,
+                auto_approve=args.auto_approve,
+                no_backup=args.no_backup
+            )
+
         else:
             print("Unknown MCP command")
             return 1