Pacman-to-Flatpak Ecosystem Migration Tool

A high-velocity, automated systems utility written in Python to audit, map, and migrate local Arch Linux system packages (pacman / AUR) to sandboxed Flatpak equivalents.

Features interactive validation scoring, privilege tracking, yay/paru fallback handling, and instant transaction rollbacks.

Operational Capabilities

• Scoping Flexibility: Supports targeting AUR-only (--aur), native core dependencies (--main), or full system payloads (--all).
• Confidence Analytics: Uses string similarity ratios to filter accurate upstream Flatpak targets.
• Interactive Interception: Intercepts low-confidence matches using yay-style command parameters (1-3, A, N) for manual verification.
• Tactical Retreats: Automatically logs atomic changes to a local state ledger (migration_backup.json) to allow full ecosystem restorations (--rollback).

System Requirements & Prerequisites

• Host OS: Arch Linux (or derivatives running pacman)
• Core Dependencies: python3, flatpak (configured with the Flathub remote)
• Privilege Managers: sudo or doas
• AUR Support (Optional): yay or paru installed within the host $PATH

Post-Migration Protocols (The Flatpak Sandbox)

Configuration Migration: Your native configuration files are not automatically moved. You will need to port these manually if you wish to retain your application settings.

Permission Management: It is highly recommended to install Flatseal to graphically manage and restore file system permissions.

Command-Line Interface Reference

# Display help and usage matrices
python3 migrate.py --help

# Audit and migrate foreign AUR packages only
python3 migrate.py --aur

# Audit and migrate native sync repository packages only
python3 migrate.py --main

# Execute full systemic rollback from the saved state ledger
python3 migrate.py --rollback