mark_as_explicit
Prevent packages from being removed as orphans by marking them as explicitly installed on Arch Linux systems.
Instructions
Mark a package as explicitly installed. Prevents it from being removed as an orphan. Only works on Arch Linux.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| package_name | Yes | Name of the package to mark as explicit |
Implementation Reference
- src/arch_ops_server/pacman.py:1108-1159 (handler)Core handler function that executes the tool logic by running 'sudo pacman -D --asexplicit <package_name>' to mark the package as explicitly installed, with proper error handling and logging.async def mark_as_explicit(package_name: str) -> Dict[str, Any]: """ Mark a package as explicitly installed. Args: package_name: Name of package to mark Returns: Dict with operation status """ if not IS_ARCH: return create_error_response( "NotSupported", "Package marking is only available on Arch Linux" ) if not check_command_exists("pacman"): return create_error_response( "CommandNotFound", "pacman command not found" ) logger.info(f"Marking {package_name} as explicitly installed") try: exit_code, stdout, stderr = await run_command( ["sudo", "pacman", "-D", "--asexplicit", package_name], timeout=10, check=False, skip_sudo_check=True ) if exit_code != 0: return create_error_response( "CommandError", f"Failed to mark package as explicit: {stderr}" ) logger.info(f"Successfully marked {package_name} as explicit") return { "success": True, "package": package_name, "marked_as": "explicit" } except Exception as e: logger.error(f"Failed to mark package: {e}") return create_error_response( "CommandError", f"Failed to mark package as explicit: {str(e)}" )
- src/arch_ops_server/server.py:865-878 (registration)MCP tool registration in list_tools(), defining the tool name, description, and input schema (JSON schema for package_name parameter).Tool( name="mark_as_explicit", description="[MAINTENANCE] Mark a package as explicitly installed. Prevents it from being removed as an orphan. Only works on Arch Linux.", inputSchema={ "type": "object", "properties": { "package_name": { "type": "string", "description": "Name of the package to mark as explicit" } }, "required": ["package_name"] } ),
- src/arch_ops_server/server.py:1316-1322 (handler)MCP server call_tool dispatcher that extracts arguments, checks platform, invokes the pacman.mark_as_explicit handler, and formats the response as TextContent.elif name == "mark_as_explicit": if not IS_ARCH: return [TextContent(type="text", text="Error: mark_as_explicit only available on Arch Linux systems")] package_name = arguments["package_name"] result = await mark_as_explicit(package_name) return [TextContent(type="text", text=json.dumps(result, indent=2))]
- Tool metadata definition including category, platform requirements, permissions, workflow, and related tools for UI/organization purposes."mark_as_explicit": ToolMetadata( name="mark_as_explicit", category="maintenance", platform="arch", permission="write", workflow="organize", related_tools=["list_explicit_packages", "list_orphan_packages"], prerequisite_tools=[]
- src/arch_ops_server/server.py:51-52 (registration)Import of the mark_as_explicit handler function from pacman.py into the server module.mark_as_explicit, mark_as_dependency,