arch-ops-server 3.1.0__tar.gz → 3.2.0__tar.gz

{arch_ops_server-3.1.0 → arch_ops_server-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: arch-ops-server
-Version: 3.1.0
+Version: 3.2.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 → arch_ops_server-3.2.0}/README.md

@@ -16,17 +16,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>
 
@@ -35,11 +36,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 |
@@ -47,6 +50,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 |
@@ -57,6 +61,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) |
@@ -67,6 +72,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 |
@@ -74,6 +80,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 |
@@ -84,6 +91,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 |
@@ -91,6 +99,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 |
@@ -99,6 +108,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 |
@@ -109,6 +119,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 |
@@ -118,6 +129,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 |
@@ -128,6 +140,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 |
@@ -136,6 +149,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 |
@@ -143,6 +157,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 |
@@ -151,6 +166,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 |
@@ -159,6 +175,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 |
@@ -178,6 +195,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
 
@@ -186,6 +204,7 @@ Direct access to Arch ecosystem data via custom URI schemes:
 ```bash
 uvx arch-ops-server
 ```
+
 ---
 
 ## Configuration
@@ -218,4 +237,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 → arch_ops_server-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arch-ops-server"
-version = "3.1.0"
+version = "3.2.0"
 description = "MCP server bridging AI assistants with Arch Linux ecosystem (Wiki, AUR, official repos)"
 readme = {file = "README.md", content-type = "text/markdown"}
 license = { text = "GPL-3.0-only OR MIT" }

{arch_ops_server-3.1.0 → arch_ops_server-3.2.0}/src/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.2.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-3.1.0 → arch_ops_server-3.2.0}/src/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,
@@ -302,6 +305,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"
+        ),
     ]
 
 
@@ -482,6 +492,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}")
 
@@ -579,7 +594,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["query"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         # AUR tools
@@ -606,7 +622,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["query"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -621,7 +638,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -630,7 +648,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -645,7 +664,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
         
         Tool(
@@ -660,7 +680,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["pkgbuild_content"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
         
         Tool(
@@ -675,7 +696,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_info"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Removal Tools
@@ -701,7 +723,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         Tool(
@@ -722,7 +745,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_names"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # Orphan Package Management
@@ -732,7 +756,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -753,7 +778,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # Package Ownership Tools
@@ -769,7 +795,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["file_path"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -788,7 +815,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -803,7 +831,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["filename_pattern"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Verification
@@ -824,7 +853,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Package Groups
@@ -834,7 +864,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -849,7 +880,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["group_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Install Reason Management
@@ -859,7 +891,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -874,7 +907,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         Tool(
@@ -889,7 +923,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(destructiveHint=True)
         ),
 
         # System Diagnostic Tools
@@ -899,7 +934,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -908,7 +944,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -917,7 +954,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -926,7 +964,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -942,7 +981,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # News Tools
@@ -963,7 +1003,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -979,7 +1020,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -988,7 +1030,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Transaction Log Tools
@@ -1011,7 +1054,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1026,7 +1070,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": ["package_name"]
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1035,7 +1080,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1051,7 +1097,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Mirror Management Tools
@@ -1061,7 +1108,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1076,7 +1124,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1096,7 +1145,8 @@ async def list_tools() -> list[Tool]:
                     }
                 },
                 "required": []
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1105,7 +1155,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         # Configuration Tools
@@ -1115,7 +1166,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1124,7 +1176,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1133,7 +1186,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1142,7 +1196,8 @@ async def list_tools() -> list[Tool]:
             inputSchema={
                 "type": "object",
                 "properties": {}
-            }
+            },
+            annotations=ToolAnnotations(readOnlyHint=True)
         ),
 
         Tool(
@@ -1151,7 +1206,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)
         ),
     ]
 
@@ -1466,6 +1532,13 @@ async def call_tool(name: str, arguments: dict[str, Any]) -> list[TextContent |
         
         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="Error: run_system_health_check only available on Arch Linux systems")]
+        
+        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:

arch_ops_server-3.2.0/src/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-3.1.0 → arch_ops_server-3.2.0}/src/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=[]
+    ),
 }