arch-ops-server 3.1.0__py3-none-any.whl → 3.3.0__py3-none-any.whl

arch_ops_server/__init__.py

@@ -6,7 +6,7 @@ A Model Context Protocol server that bridges AI assistants with the Arch Linux
 ecosystem, providing access to the Arch Wiki, AUR, and official repositories.
 """
 
-__version__ = "3.1.0"
+__version__ = "3.3.0"
 
 from .wiki import search_wiki, get_wiki_page, get_wiki_page_as_text
 from .aur import (
@@ -43,6 +43,7 @@ from .system import (
     check_failed_services,
     get_boot_logs
 )
+from .system_health_check import run_system_health_check
 from .news import (
     get_latest_news,
     check_critical_news,
@@ -147,6 +148,7 @@ __all__ = [
     "get_pacman_cache_stats",
     "check_failed_services",
     "get_boot_logs",
+    "run_system_health_check",
     # News
     "get_latest_news",
     "check_critical_news",

arch_ops_server/server.py

@@ -15,6 +15,7 @@ from mcp.server import Server
 from mcp.types import (
     Resource,
     Tool,
+    ToolAnnotations,
     TextContent,
     ImageContent,
     EmbeddedResource,
@@ -76,6 +77,8 @@ from . import (
     analyze_makepkg_conf,
     check_ignored_packages,
     get_parallel_downloads_setting,
+    # System health check
+    run_system_health_check,
     # Utils
     IS_ARCH,
     run_command,
@@ -92,6 +95,57 @@ server = Server("arch-ops-server")
 # HELPER FUNCTIONS
 # ============================================================================
 
+def create_platform_error_message(tool_name: str, current_platform: str = None) -> str:
+    """
+    Create an informative error message with recovery hints for platform-specific tools.
+    
+    Args:
+        tool_name: Name of the tool that requires Arch Linux
+        current_platform: Current platform/OS (auto-detected if not provided)
+    
+    Returns:
+        Formatted error message with recovery suggestions
+    """
+    import platform
+    
+    if current_platform is None:
+        try:
+            if IS_ARCH:
+                current_platform = "Arch Linux"
+            else:
+                import distro
+                current_platform = f"{distro.name()} {distro.version()}" if distro.name() else platform.system()
+        except:
+            current_platform = platform.system()
+    
+    error_msg = f"""Error: '{tool_name}' requires Arch Linux
+
+Current system: {current_platform}
+
+This tool requires a running Arch Linux system to function. However, you can still:
+
+Alternative actions:
+1. Use platform-agnostic tools:
+   - search_archwiki: Search Arch Wiki documentation (works anywhere)
+   - search_aur: Search AUR packages (works anywhere)
+   - get_official_package_info: Get package info from archlinux.org (works anywhere)
+   - get_latest_news: Check Arch Linux news (works anywhere)
+   - check_critical_news: Check for critical Arch news (works anywhere)
+
+2. Browse documentation resources:
+   - archwiki://<page_title> - Read any Arch Wiki page
+   - aur://<package>/info - Get AUR package metadata
+   - archrepo://<package> - Get official package details
+
+3. If you're planning to use Arch Linux:
+   - Visit the Arch Wiki Installation Guide: archwiki://Installation_guide
+   - Check latest Arch news before installing: get_latest_news
+
+Note: Tools marked with [DISCOVERY], [SECURITY], and news-related tools work on any system."""
+    
+    return error_msg
+
+
 def create_standard_output_schema(data_schema: dict, description: str = "") -> dict:
     """
     Create a standard output schema with status, data, error fields.
@@ -302,6 +356,13 @@ async def list_resources() -> list[Resource]:
             mimeType="application/json",
             description="Check when package databases were last synchronized"
         ),
+        # System health resources
+        Resource(
+            uri="system://health",
+            name="System - Health Check",
+            mimeType="application/json",
+            description="Comprehensive system health check report"
+        ),
     ]
 
 
@@ -392,7 +453,7 @@ async def read_resource(uri: str) -> str:
     
     elif scheme == "pacman":
         if not IS_ARCH:
-            raise ValueError(f"pacman:// resources only available on Arch Linux systems")
+            raise ValueError(create_platform_error_message("pacman:// resources"))
 
         resource_path = parsed.netloc or parsed.path.lstrip('/')
 
@@ -482,6 +543,11 @@ async def read_resource(uri: str) -> str:
             else:
                 raise ValueError(result.get("error", "Failed to get boot logs"))
 
+        elif resource_path == "health":
+            # Get system health check
+            result = await run_system_health_check()
+            return json.dumps(result, indent=2)
+
         else:
             raise ValueError(f"Unsupported system resource: {resource_path}")
 
@@ -508,7 +574,7 @@ async def read_resource(uri: str) -> str:
 
     elif scheme == "mirrors":
         if not IS_ARCH:
-            raise ValueError(f"mirrors:// resources only available on Arch Linux systems")
+            raise ValueError(create_platform_error_message("mirrors:// resources"))
 
         resource_path = parsed.netloc or parsed.path.lstrip('/')
 
@@ -527,7 +593,7 @@ async def read_resource(uri: str) -> str:
 
     elif scheme == "config":
         if not IS_ARCH:
-            raise ValueError(f"config:// resources only available on Arch Linux systems")
+            raise ValueError(create_platform_error_message("config:// resources"))
 
         resource_path = parsed.netloc or parsed.path.lstrip('/')
 
@@ -579,7 +645,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["query"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         # AUR tools
@@ -606,7 +673,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["query"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -621,7 +689,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -630,7 +699,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -645,7 +715,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
         
         Tool(
@@ -660,7 +731,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["pkgbuild_content"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -675,7 +747,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_info"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Removal Tools
@@ -701,7 +774,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         Tool(
@@ -722,7 +796,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_names"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # Orphan Package Management
@@ -732,7 +807,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -753,7 +829,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # Package Ownership Tools
@@ -769,7 +846,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["file_path"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -788,7 +866,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -803,7 +882,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["filename_pattern"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Verification
@@ -824,7 +904,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Groups
@@ -834,7 +915,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -849,7 +931,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["group_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Install Reason Management
@@ -859,7 +942,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -874,7 +958,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         Tool(
@@ -889,7 +974,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # System Diagnostic Tools
@@ -899,7 +985,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -908,7 +995,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -917,7 +1005,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -926,7 +1015,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -942,7 +1032,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # News Tools
@@ -963,7 +1054,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -979,7 +1071,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -988,7 +1081,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Transaction Log Tools
@@ -1011,7 +1105,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1026,7 +1121,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1035,7 +1131,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1051,7 +1148,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Mirror Management Tools
@@ -1061,7 +1159,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1076,7 +1175,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1096,7 +1196,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1105,7 +1206,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Configuration Tools
@@ -1115,7 +1217,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1124,7 +1227,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1133,7 +1237,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1142,7 +1247,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1151,7 +1257,18 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
+        ),
+        
+        Tool(
+            name="run_system_health_check",
+            description="[MONITORING] Run a comprehensive system health check. Integrates multiple diagnostics to provide a complete overview of system status, including disk space, failed services, updates, orphan packages, and more. Only works on Arch Linux.",
+            inputSchema={
+                "type": "object",
+                "properties": {}
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
     ]
 
@@ -1193,14 +1310,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     
     elif name == "check_updates_dry_run":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: check_updates_dry_run only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("check_updates_dry_run"))]
         
         result = await check_updates_dry_run()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
     
     elif name == "install_package_secure":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: install_package_secure only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("install_package_secure"))]
         
         package_name = arguments["package_name"]
         result = await install_package_secure(package_name)
@@ -1219,7 +1336,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Package Removal Tools
     elif name == "remove_package":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: remove_package only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("remove_package"))]
 
         package_name = arguments["package_name"]
         remove_dependencies = arguments.get("remove_dependencies", False)
@@ -1229,7 +1346,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "remove_packages_batch":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: remove_packages_batch only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("remove_packages_batch"))]
 
         package_names = arguments["package_names"]
         remove_dependencies = arguments.get("remove_dependencies", False)
@@ -1239,14 +1356,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Orphan Package Management
     elif name == "list_orphan_packages":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_orphan_packages only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_orphan_packages"))]
 
         result = await list_orphan_packages()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "remove_orphans":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: remove_orphans only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("remove_orphans"))]
 
         dry_run = arguments.get("dry_run", True)
         exclude = arguments.get("exclude", None)
@@ -1256,7 +1373,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Package Ownership Tools
     elif name == "find_package_owner":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: find_package_owner only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("find_package_owner"))]
 
         file_path = arguments["file_path"]
         result = await find_package_owner(file_path)
@@ -1264,7 +1381,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "list_package_files":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_package_files only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_package_files"))]
 
         package_name = arguments["package_name"]
         filter_pattern = arguments.get("filter_pattern", None)
@@ -1273,7 +1390,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "search_package_files":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: search_package_files only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("search_package_files"))]
 
         filename_pattern = arguments["filename_pattern"]
         result = await search_package_files(filename_pattern)
@@ -1282,7 +1399,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Package Verification
     elif name == "verify_package_integrity":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: verify_package_integrity only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("verify_package_integrity"))]
 
         package_name = arguments["package_name"]
         thorough = arguments.get("thorough", False)
@@ -1292,14 +1409,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Package Groups
     elif name == "list_package_groups":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_package_groups only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_package_groups"))]
 
         result = await list_package_groups()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "list_group_packages":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_group_packages only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_group_packages"))]
 
         group_name = arguments["group_name"]
         result = await list_group_packages(group_name)
@@ -1308,14 +1425,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Install Reason Management
     elif name == "list_explicit_packages":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_explicit_packages only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_explicit_packages"))]
 
         result = await list_explicit_packages()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "mark_as_explicit":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: mark_as_explicit only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("mark_as_explicit"))]
 
         package_name = arguments["package_name"]
         result = await mark_as_explicit(package_name)
@@ -1323,7 +1440,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "mark_as_dependency":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: mark_as_dependency only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("mark_as_dependency"))]
 
         package_name = arguments["package_name"]
         result = await mark_as_dependency(package_name)
@@ -1340,7 +1457,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "get_pacman_cache_stats":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: get_pacman_cache_stats only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("get_pacman_cache_stats"))]
 
         result = await get_pacman_cache_stats()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
@@ -1368,7 +1485,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "get_news_since_last_update":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: get_news_since_last_update only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("get_news_since_last_update"))]
         
         result = await get_news_since_last_update()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
@@ -1376,7 +1493,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Transaction log tools
     elif name == "get_transaction_history":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: get_transaction_history only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("get_transaction_history"))]
         
         limit = arguments.get("limit", 50)
         transaction_type = arguments.get("transaction_type", "all")
@@ -1385,7 +1502,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "find_when_installed":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: find_when_installed only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("find_when_installed"))]
         
         package_name = arguments.get("package_name")
         if not package_name:
@@ -1396,14 +1513,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "find_failed_transactions":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: find_failed_transactions only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("find_failed_transactions"))]
         
         result = await find_failed_transactions()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "get_database_sync_history":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: get_database_sync_history only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("get_database_sync_history"))]
         
         limit = arguments.get("limit", 20)
         result = await get_database_sync_history(limit=limit)
@@ -1412,14 +1529,14 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Mirror management tools
     elif name == "list_active_mirrors":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: list_active_mirrors only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("list_active_mirrors"))]
         
         result = await list_active_mirrors()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "test_mirror_speed":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: test_mirror_speed only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("test_mirror_speed"))]
         
         mirror_url = arguments.get("mirror_url")
         result = await test_mirror_speed(mirror_url=mirror_url)
@@ -1433,7 +1550,7 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
 
     elif name == "check_mirrorlist_health":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: check_mirrorlist_health only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("check_mirrorlist_health"))]
         
         result = await check_mirrorlist_health()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
@@ -1441,35 +1558,42 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
     # Configuration tools
     elif name == "analyze_pacman_conf":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: analyze_pacman_conf only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("analyze_pacman_conf"))]
         
         result = await analyze_pacman_conf()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "analyze_makepkg_conf":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: analyze_makepkg_conf only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("analyze_makepkg_conf"))]
         
         result = await analyze_makepkg_conf()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "check_ignored_packages":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: check_ignored_packages only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("check_ignored_packages"))]
         
         result = await check_ignored_packages()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "get_parallel_downloads_setting":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: get_parallel_downloads_setting only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("get_parallel_downloads_setting"))]
         
         result = await get_parallel_downloads_setting()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
+    
+    elif name == "run_system_health_check":
+        if not IS_ARCH:
+            return [TextContent(type="text", text=create_platform_error_message("run_system_health_check"))]
+        
+        result = await run_system_health_check()
+        return [TextContent(type="text", text=json.dumps(result, indent=2))]
 
     elif name == "check_database_freshness":
         if not IS_ARCH:
-            return [TextContent(type="text", text="Error: check_database_freshness only available on Arch Linux systems")]
+            return [TextContent(type="text", text=create_platform_error_message("check_database_freshness"))]
         
         result = await check_database_freshness()
         return [TextContent(type="text", text=json.dumps(result, indent=2))]
@@ -1810,7 +1934,7 @@ paru -S {package_name}  # or yay -S {package_name}
                         role="assistant",
                         content=PromptMessage.TextContent(
                             type="text",
-                            text="Error: safe_system_update prompt only available on Arch Linux systems"
+                            text=create_platform_error_message("safe_system_update prompt")
                         )
                     )
                 ]
@@ -1965,7 +2089,7 @@ paru -S {package_name}  # or yay -S {package_name}
                         role="assistant",
                         content=PromptMessage.TextContent(
                             type="text",
-                            text="Error: cleanup_system prompt only available on Arch Linux systems"
+                            text=create_platform_error_message("cleanup_system prompt")
                         )
                     )
                 ]
@@ -2141,7 +2265,7 @@ Be detailed and provide specific mirror URLs and configuration commands."""
                         role="assistant",
                         content=PromptMessage.TextContent(
                             type="text",
-                            text="Error: system_health_check prompt only available on Arch Linux systems"
+                            text=create_platform_error_message("system_health_check prompt")
                         )
                     )
                 ]

arch_ops_server/system_health_check.py

@@ -0,0 +1,189 @@
+# SPDX-License-Identifier: GPL-3.0-only OR MIT
+"""
+System health check module.
+Provides a comprehensive system health check by integrating multiple system diagnostics.
+"""
+
+import logging
+from typing import Dict, Any
+
+from .utils import IS_ARCH
+from . import (
+    get_system_info,
+    check_disk_space,
+    check_failed_services,
+    get_pacman_cache_stats,
+    check_updates_dry_run,
+    check_critical_news,
+    list_orphan_packages,
+    check_database_freshness,
+    check_mirrorlist_health
+)
+
+logger = logging.getLogger(__name__)
+
+
+async def run_system_health_check() -> Dict[str, Any]:
+    """
+    Run a comprehensive system health check.
+    
+    This function integrates multiple system diagnostics to provide a complete
+    overview of the system's health status in a single call.
+    
+    Returns:
+        Dict with comprehensive health check results
+    """
+    logger.info("Starting comprehensive system health check")
+    
+    health_report = {
+        "status": "success",
+        "system_info": {},
+        "disk_space": {},
+        "services": {},
+        "pacman_cache": {},
+        "updates": {},
+        "news": {},
+        "orphans": {},
+        "database": {},
+        "mirrors": {},
+        "issues": [],
+        "suggestions": []
+    }
+    
+    try:
+        # System information
+        logger.info("Checking system information")
+        system_info = await get_system_info()
+        health_report["system_info"] = system_info
+        
+        # Disk space check
+        logger.info("Checking disk space")
+        disk_space = await check_disk_space()
+        health_report["disk_space"] = disk_space
+        
+        # Check for low disk space
+        if disk_space.get("status") == "success":
+            for partition in disk_space.get("data", []):
+                if partition.get("used_percent", 0) > 90:
+                    health_report["issues"].append({
+                        "type": "critical",
+                        "message": f"Low disk space on {partition['mount_point']}: {partition['used_percent']}% used",
+                        "suggestion": "Clean up unnecessary files or resize the partition"
+                    })
+                elif partition.get("used_percent", 0) > 80:
+                    health_report["issues"].append({
+                        "type": "warning",
+                        "message": f"Disk space getting low on {partition['mount_point']}: {partition['used_percent']}% used",
+                        "suggestion": "Consider cleaning up files to free up space"
+                    })
+        
+        # Failed services check
+        logger.info("Checking for failed services")
+        failed_services = await check_failed_services()
+        health_report["services"] = failed_services
+        
+        if failed_services.get("status") == "success" and failed_services.get("data"):
+            health_report["issues"].append({
+                "type": "warning",
+                "message": f"{len(failed_services['data'])} failed systemd services detected",
+                "suggestion": "Check systemd journal logs for details about failed services"
+            })
+        
+        # Pacman cache statistics
+        logger.info("Checking pacman cache")
+        cache_stats = await get_pacman_cache_stats()
+        health_report["pacman_cache"] = cache_stats
+        
+        if cache_stats.get("status") == "success":
+            cache_size = cache_stats.get("data", {}).get("total_size_mb", 0)
+            if cache_size > 5000:  # 5GB
+                health_report["suggestions"].append({
+                    "message": f"Pacman cache is large ({cache_size:.1f}MB)",
+                    "action": "Run 'paccache -r' to clean old packages"
+                })
+        
+        # Updates check
+        logger.info("Checking for available updates")
+        updates = await check_updates_dry_run()
+        health_report["updates"] = updates
+        
+        if updates.get("status") == "success":
+            if updates.get("updates_available"):
+                count = updates.get("count", 0)
+                health_report["suggestions"].append({
+                    "message": f"{count} updates available",
+                    "action": "Run 'sudo pacman -Syu' to update the system"
+                })
+        
+        # Critical news check
+        logger.info("Checking for critical news")
+        critical_news = await check_critical_news()
+        health_report["news"] = critical_news
+        
+        if critical_news.get("status") == "success" and critical_news.get("data"):
+            health_report["issues"].append({
+                "type": "critical",
+                "message": f"{len(critical_news['data'])} critical news items require attention",
+                "suggestion": "Review the news items before updating"
+            })
+        
+        # Orphan packages check
+        logger.info("Checking for orphan packages")
+        orphans = await list_orphan_packages()
+        health_report["orphans"] = orphans
+        
+        if orphans.get("status") == "success":
+            orphan_count = len(orphans.get("data", []))
+            if orphan_count > 0:
+                health_report["suggestions"].append({
+                    "message": f"{orphan_count} orphan packages detected",
+                    "action": "Run 'sudo pacman -Rns $(pacman -Qtdq)' to remove orphans"
+                })
+        
+        # Database freshness
+        logger.info("Checking database freshness")
+        db_freshness = await check_database_freshness()
+        health_report["database"] = db_freshness
+        
+        # Mirrorlist health
+        logger.info("Checking mirrorlist health")
+        mirror_health = await check_mirrorlist_health()
+        health_report["mirrors"] = mirror_health
+        
+        if mirror_health.get("status") == "success":
+            if not mirror_health.get("data", {}).get("healthy", True):
+                health_report["issues"].append({
+                    "type": "warning",
+                    "message": "Mirrorlist configuration has issues",
+                    "suggestion": "Run 'reflector' to update your mirrorlist"
+                })
+        
+        # Overall health assessment
+        issue_count = len(health_report["issues"])
+        suggestion_count = len(health_report["suggestions"])
+        
+        health_report["summary"] = {
+            "total_issues": issue_count,
+            "critical_issues": len([i for i in health_report["issues"] if i["type"] == "critical"]),
+            "warnings": len([i for i in health_report["issues"] if i["type"] == "warning"]),
+            "suggestions": suggestion_count
+        }
+        
+        logger.info(f"Health check completed: {issue_count} issues, {suggestion_count} suggestions")
+        
+        return health_report
+        
+    except Exception as e:
+        logger.error(f"Health check failed: {e}")
+        return {
+            "status": "error",
+            "error": str(e),
+            "issues": [],
+            "suggestions": [],
+            "summary": {
+                "total_issues": 1,
+                "critical_issues": 1,
+                "warnings": 0,
+                "suggestions": 0
+            }
+        }

arch_ops_server/tool_metadata.py

@@ -457,6 +457,25 @@ TOOL_METADATA = {
         related_tools=["analyze_pacman_conf"],
         prerequisite_tools=[]
     ),
+    "run_system_health_check": ToolMetadata(
+        name="run_system_health_check",
+        category="monitoring",
+        platform="arch",
+        permission="read",
+        workflow="diagnose",
+        related_tools=[
+            "get_system_info",
+            "check_disk_space",
+            "check_failed_services",
+            "get_pacman_cache_stats",
+            "check_updates_dry_run",
+            "check_critical_news",
+            "list_orphan_packages",
+            "check_database_freshness",
+            "check_mirrorlist_health"
+        ],
+        prerequisite_tools=[]
+    ),
 }
 
 

{arch_ops_server-3.1.0.dist-info → arch_ops_server-3.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: arch-ops-server
-Version: 3.1.0
+Version: 3.3.0
 Summary: MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)
 Keywords: arch-linux,mcp,model-context-protocol,aur,pacman,wiki,ai-assistant
 Author: Nihal
@@ -52,17 +52,18 @@ Leverage AI to get  output for digestible, structured results that are ready for
 
 ## Sneak Peak into what's available
 
-<details open>
-<summary>Claude Desktop (no terminal)</summary>
+<details>
+
+<summary>Using VS Code Sonnet 3.5 for Safe Installation from AUR</summary>
 
-![Claude Desktop Demo](assets/claudedesktop_signalcli.gif)
+![VS Code Demo](assets/vscode_notesnook.gif)
 
 </details>
 
 <details>
-<summary>VS Code (with terminal)</summary>
+<summary> Asking Claude Code Sonnet 4.5 for fedora equivalent command </summary>
 
-![VS Code Demo](assets/vscode_notesnook.gif)
+![Equivalent Command Demo](assets/equivalent-commands.gif)
 
 </details>
 
@@ -71,11 +72,13 @@ Leverage AI to get  output for digestible, structured results that are ready for
 Direct access to Arch ecosystem data via custom URI schemes:
 
 #### Documentation & Search
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `archwiki://` | `archwiki://Installation_guide` | Markdown-formatted Wiki page |
 
 #### Package Information
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `archrepo://` | `archrepo://vim` | Official repository package details |
@@ -83,6 +86,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `aur://*/pkgbuild` | `aur://yay/pkgbuild` | Raw PKGBUILD with safety analysis |
 
 #### System Packages (Arch only)
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `pacman://installed` | `pacman://installed` | System installed packages list |
@@ -93,6 +97,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `pacman://database/freshness` | `pacman://database/freshness` | Package database sync status |
 
 #### System Monitoring & Logs
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `system://info` | `system://info` | System information (kernel, memory, uptime) |
@@ -103,6 +108,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `pacman://log/failed` | `pacman://log/failed` | Failed package transactions |
 
 #### News & Updates
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `archnews://latest` | `archnews://latest` | Latest Arch Linux news |
@@ -110,6 +116,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `archnews://since-update` | `archnews://since-update` | News since last system update |
 
 #### Configuration
+
 | URI Scheme | Example | Returns |
 |------------|---------|---------|
 | `config://pacman` | `config://pacman` | Parsed pacman.conf configuration |
@@ -120,6 +127,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ### Tools (Executable Functions)
 
 #### Package Search & Information
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `search_archwiki` | Query Arch Wiki with ranked results | Any |
@@ -127,6 +135,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `get_official_package_info` | Get official package details (hybrid local/remote) | Any |
 
 #### Package Lifecycle Management
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `check_updates_dry_run` | Check for available updates | Arch only |
@@ -135,6 +144,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `remove_packages_batch` | Remove multiple packages efficiently | Arch only |
 
 #### Package Analysis & Maintenance
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `list_orphan_packages` | Find orphaned packages | Arch only |
@@ -145,6 +155,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `mark_as_dependency` | Allow package to be orphaned | Arch only |
 
 #### Package Organization
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `find_package_owner` | Find which package owns a file | Arch only |
@@ -154,6 +165,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `list_group_packages` | Show packages in specific group | Arch only |
 
 #### System Monitoring & Diagnostics
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `get_system_info` | System info (kernel, memory, uptime) | Any |
@@ -164,6 +176,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `check_database_freshness` | Check package database sync status | Arch only |
 
 #### Transaction History & Logs
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `get_transaction_history` | Recent package transactions (install/upgrade/remove) | Arch only |
@@ -172,6 +185,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `get_database_sync_history` | Database sync events | Arch only |
 
 #### News & Safety Checks
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `get_latest_news` | Fetch Arch Linux news from RSS | Any |
@@ -179,6 +193,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `get_news_since_last_update` | News posted since last system update | Arch only |
 
 #### Mirror Management
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `list_active_mirrors` | Show configured mirrors | Arch only |
@@ -187,6 +202,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `check_mirrorlist_health` | Verify mirror configuration | Arch only |
 
 #### Configuration Management
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `analyze_pacman_conf` | Parse pacman.conf settings | Arch only |
@@ -195,6 +211,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 | `get_parallel_downloads_setting` | Get parallel download config | Arch only |
 
 #### Security Analysis
+
 | Tool | Description | Platform |
 |------|-------------|----------|
 | `analyze_pkgbuild_safety` | Comprehensive PKGBUILD analysis (50+ red flags) | Any |
@@ -214,6 +231,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ## Installation
 
 ### Prerequisites
+
 - Python 3.11+
 - [uv](https://github.com/astral-sh/uv) (recommended) or pip
 
@@ -222,6 +240,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ```bash
 uvx arch-ops-server
 ```
+
 ---
 
 ## Configuration
@@ -254,4 +273,5 @@ This project is dual-licensed under your choice of:
 
 You may use this software under the terms of either license. When redistributing or modifying this software, you may choose which license to apply.
 
-By contributing to this project, you agree that your contributions will be licensed under both licenses.
+By contributing to this project, you agree that your contributions will be licensed under both licenses.
+

{arch_ops_server-3.1.0.dist-info → arch_ops_server-3.3.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-arch_ops_server/__init__.py,sha256=8UZTb4O3wQD4WGrspE06O9AscuAQi_pEh4VR9y5yM2U,4255
+arch_ops_server/__init__.py,sha256=UiV6PqYZHQzRx_tOZG8G7gMBTXtWG9pkPtPgWn-crzw,4343
 arch_ops_server/aur.py,sha256=poYbh2DW7I1tZfCeNp_7e10fh9ZZx8HTnYZnKKZtflQ,49808
 arch_ops_server/config.py,sha256=4mtpS28vXSMeEVGrTWTMwZEzgIyfl0oCAYEzF7SKxE8,11076
 arch_ops_server/http_server.py,sha256=wZ3hY6o6EftbN1OZiTUau7861LB9ihKWap6gevev_No,31810
@@ -7,12 +7,13 @@ arch_ops_server/mirrors.py,sha256=Evt-g20cMOTZQl9FbbkbklFd0gKWz-I7vVNrmyQO19U,13
 arch_ops_server/news.py,sha256=E97eASR24tq_EaVDYuamIoBl4a7QtBkpscOaUPuU0W4,9359
 arch_ops_server/pacman.py,sha256=S1Gc53CA6o4--YavA03EkxL0dGCZNhoFFZjawlW_p20,38354
 arch_ops_server/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-arch_ops_server/server.py,sha256=u3KIZ1j8PR8l1oF8nL6nIKHIrrxybTUnWHj9T4LL3JQ,84493
+arch_ops_server/server.py,sha256=aAYEzkxp1PY6Bqv1ZZNKuxZbTAE8N8A8a7X_zhUXs4k,89743
 arch_ops_server/system.py,sha256=JfBUB3KD0veulQ-IIK8IOC8Jn6lqtLMCtlnryiL1n7w,9221
-arch_ops_server/tool_metadata.py,sha256=C2EQuR6BlzrKNWwdMi3EPexnlKYw18yBNvq5X2JovLU,19875
+arch_ops_server/system_health_check.py,sha256=G_hgPaVz-6tQ_ZAoPEk7aX2rm4lIwbO0xdXcwdBDoaE,7196
+arch_ops_server/tool_metadata.py,sha256=Z0ZhtS1bxo9T_erJlGx9Xf0fKk4oZ0L6UQ8gJu7WEcA,20468
 arch_ops_server/utils.py,sha256=po7MVqCx-hsdx-lOgs7uGicjoUVMf6HvuNNYl2qyFH0,10112
 arch_ops_server/wiki.py,sha256=XB_emMGXYF3Vn5likRICkGOa72YDZvOhtZBgp_d1gg8,7350
-arch_ops_server-3.1.0.dist-info/WHEEL,sha256=w4ZtLaDgMAZW2MMZZwtH8zENekoQYBCeullI-zsXJQk,78
-arch_ops_server-3.1.0.dist-info/entry_points.txt,sha256=ZS2crFEqE9TteC4j2HmYS1wKvoBOCCXT2FJXJW5C4-E,117
-arch_ops_server-3.1.0.dist-info/METADATA,sha256=vbVTjHuSEe3wgMJvPSrjd3agtohpXK2H2_zmJouQxyE,11275
-arch_ops_server-3.1.0.dist-info/RECORD,,
+arch_ops_server-3.3.0.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+arch_ops_server-3.3.0.dist-info/entry_points.txt,sha256=ZS2crFEqE9TteC4j2HmYS1wKvoBOCCXT2FJXJW5C4-E,117
+arch_ops_server-3.3.0.dist-info/METADATA,sha256=TTHK9ymnrPpDClCfPJ7krmYCFbVflLKp595jBiKbjpk,11356
+arch_ops_server-3.3.0.dist-info/RECORD,,

{arch_ops_server-3.1.0.dist-info → arch_ops_server-3.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.9
+Generator: uv 0.9.28
 Root-Is-Purelib: true
-Tag: py3-none-any
+Tag: py3-none-any