v3.4.0

TLDR: This release primarly focuses on tool consolidation along with enhanced security, and improved system diagnostics.

🚀 New Features & Major Consolidations

• Unified News System: Consolidated multiple news tools into fetch_news, supporting latest, critical, and since-update queries.
• System Diagnostics: Merged failed services and boot log tools into a single diagnose_system tool.
• Storage Analysis: Unified disk usage and pacman cache statistics into analyze_storage.
• Security Auditing: Consolidated PKGBUILD analysis and metadata risk assessment into audit_package_security.
• Package Management:
  • Unified package removal and orphan management into remove_packages and manage_orphans.
  • Consolidated file ownership and install reason tools for better package organization.
• Mirror Management: Smart mirror management tool optimize_mirrors now handles status, speed tests, suggestions, and health checks in one place.
• System Health Check: Added a comprehensive run_system_health_check tool that integrates multiple diagnostics for a complete system overview.

🛠 Enhancements

• Tool Metadata & Categorization: Implemented a robust categorization system (Discovery, Lifecycle, Security, etc.) with 28 registered tools, improving discoverability for MCP clients.
• Improved Annotations: Added detailed examples and recovery hints to all tool descriptions and error messages.
• Configuration Focus: Added a focus parameter to analyze_pacman_conf, allowing targeted analysis of ignored packages or parallel download settings.
• Log Parsing: Improved pacman log parsing and error handling across the entire codebase.
• HTTP Support: Added http extras and scripts to support running the server over HTTP/SSE (Server-Sent Events) for platforms like Smithery.

🛡 Security & Safety

• AUR Safety Warnings: Enhanced safety notices for all AUR-related operations.
• Secure Installation: install_package_secure now performs even more rigorous checks before allowing AUR installations.

📝 Documentation & Infrastructure

• Opencode Integration: Added specific instructions and configurations for Opencode users.
• CI/CD Automation: Streamlined the publishing workflow for PyPI and GHCR (multi-arch support).

⚠️ Breaking Changes (v3.0.0 → v3.4.0)

• Tool Deprecation: Many individual tools (e.g., check_disk_space, get_boot_logs) have been removed in favor of their consolidated counterparts (analyze_storage, diagnose_system). AI assistants should be prompted to use the new unified tools.
• Resource URI Updates: Several resource URIs have been updated to match the new module structure.

Full Changelog: v3.0.0...v3.4.0

v3.0.0 - System Monitoring & Proactive Safety

🚀 Major Release: System Monitoring & Proactive Safety

This release adds comprehensive system monitoring, news integration, and proactive safety features for safer Arch Linux management.

✨ New Features

📰 News Integration

• RSS feed parser for archlinux.org announcements
• Critical news detection (manual intervention required)
• News filtering since last system update
• Breaking change and action item detection

📜 Transaction History

• Parse pacman log for complete transaction history
• Package installation timeline and upgrade tracking
• Failed operation detection and diagnostics
• Database synchronization event monitoring

🪞 Mirror Management

• Active mirror listing and health checks
• Mirror speed testing with latency measurements
• Fastest mirror suggestions by geographic location
• Comprehensive mirror configuration validation

⚙️ Configuration Analysis

• Parse and analyze pacman.conf settings
• Parse and analyze makepkg.conf build configuration
• Ignored package detection with critical warnings
• Parallel downloads configuration management

🔍 Database Monitoring

• Package database freshness checking
• Staleness warnings and sync recommendations
• Multi-repository database age tracking

🛡️ Safe System Update Workflow

• New safe_system_update prompt orchestrates:
  • Critical news checking
  • Disk space verification
  • Available updates listing
  • Failed services detection
  • Database freshness validation
  • Comprehensive safety recommendations

📊 Statistics

• New Modules: 4 (news, logs, mirrors, config)
• New Tools: 17
• New Resources: 11
• New Prompts: 1 (safe_system_update)
• Test Coverage: Comprehensive test suite for all new features

🔧 Tools Added

get_latest_news, check_critical_news, get_news_since_last_update
get_transaction_history, find_when_installed, find_failed_transactions, get_database_sync_history
list_active_mirrors, test_mirror_speed, suggest_fastest_mirrors, check_mirrorlist_health
analyze_pacman_conf, analyze_makepkg_conf, check_ignored_packages, get_parallel_downloads_setting
check_database_freshness

🔗 Resources Added

archnews://latest, archnews://critical, archnews://since-update
pacman://log/recent, pacman://log/failed, pacman://database/freshness
mirrors://active, mirrors://health
config://pacman, config://makepkg

📦 Installation

uvx arch-ops-server@3.0.0

Or via Docker:

docker pull ghcr.io/nihalxkumar/arch-mcp:3.0.0

🔄 Upgrade Notes

No breaking changes. All existing functionality remains compatible.

---

Full Changelog: v2.0.1...v3.0.0

v2.0.0 - Package Lifecycle & System Diagnostics

🎉 Major Release

This release adds complete package lifecycle management and system diagnostics capabilities to arch-ops-server, transforming it from a search/install tool into a comprehensive Arch Linux administration assistant.

✨ What's New

📦 Package Lifecycle Management (13 new tools)

Package Removal:

• remove_package - Remove single package with dependency options
• remove_packages_batch - Efficient batch removal operations

Orphan Management:

• list_orphan_packages - Find orphaned packages with disk usage
• remove_orphans - Clean orphaned packages with dry-run support

Package Ownership:

• find_package_owner - Find which package owns a file
• list_package_files - List all files owned by a package
• search_package_files - Search files across all packages

Package Verification:

• verify_package_integrity - Check package file integrity (detects modified/missing files)

Package Groups:

• list_package_groups - List all available package groups
• list_group_packages - Show packages in specific group

Install Reason Management:

• list_explicit_packages - List user-installed packages (for backup/restore)
• mark_as_explicit - Mark package as explicitly installed
• mark_as_dependency - Mark package as dependency

��️ System Diagnostics (5 new tools)

• get_system_info - Get comprehensive system information (kernel, memory, uptime)
• check_disk_space - Check disk usage with low-space warnings
• get_pacman_cache_stats - Analyze package cache size and age
• check_failed_services - Detect failed systemd services
• get_boot_logs - Retrieve recent boot logs

🔗 New Resources (9 new URI schemes)

Pacman Resources:

• pacman://orphans - List orphaned packages
• pacman://explicit - List explicitly installed packages
• pacman://groups - List all package groups
• pacman://group/{group_name} - List packages in specific group

System Resources:

• system://info - System information summary
• system://disk - Disk space usage statistics
• system://services/failed - Failed systemd services
• system://logs/boot - Recent boot logs

📊 Statistics

• 18 new tools across 7 categories
• 9 new resource URI schemes
• 1 new module (system.py)
• 92 tests passing with comprehensive coverage

🔧 Technical Details

• All new pacman tools require Arch Linux (IS_ARCH=True)
• System diagnostics tools work on any system with graceful degradation
• Complete async/await support throughout
• Consistent error handling and logging

Docs are also updated 🙏

Full Changelog: v0.1.3...v2.0.0

v1.3.0 - Dual-licensing & Dockerfile standardization

What's Changed

• Add dual-licensing (GPL-3.0 + MIT) for broader compatibility
• Standardize Dockerfile naming convention
• Add SPDX license headers to source files

Full Changelog: v0.1.2...v0.1.3