# Example installation detection
$ devex status
Platform: linux/ubuntu/22.04 (GNOME)
Package Manager: apt
Available Installers: apt, flatpak, snap, mise, curlpipe

# Add Flatpak support on Debian
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Fedora detection and configuration
$ devex status
Platform: linux/fedora/40 (GNOME)
Package Manager: dnf
Available Installers: dnf, rpm, flatpak, mise, curlpipe

# Enable EPEL on RHEL-based systems
sudo dnf install epel-release
# Or for CentOS 7
sudo yum install epel-release

# Arch Linux with AUR support
$ devex status
Platform: linux/arch/rolling (KDE)
Package Manager: pacman
AUR Helper: yay
Available Installers: pacman, yay, flatpak, mise, curlpipe

# openSUSE detection
$ devex status
Platform: linux/opensuse-tumbleweed/rolling (KDE)
Package Manager: zypper
Available Installers: zypper, flatpak, mise, curlpipe

# DevEx automatically handles APT operations
devex install docker        # Adds repositories if needed
devex install code          # Installs Microsoft repository

# Manual APT operations
sudo apt update              # Update package lists
sudo apt install package    # Install package
sudo apt remove package     # Remove package

# Example: Docker installation with APT source
applications:
  infrastructure:
    - name: docker
      apt_sources:
        - key_source: 'https://download.docker.com/linux/ubuntu/gpg'
          key_name: 'docker'
          source_repo: 'https://download.docker.com/linux/ubuntu'
          source_name: 'docker'

# DevEx DNF operations
devex install nodejs        # Uses DNF for system packages
devex install code          # Adds Microsoft repository

# Manual DNF operations  
sudo dnf update              # Update all packages
sudo dnf install package    # Install package
sudo dnf remove package     # Remove package
sudo dnf search term        # Search packages

# DevEx Pacman operations
devex install git           # Uses pacman for core packages
devex install yay           # Installs AUR helper if needed

# Manual Pacman operations
sudo pacman -Syu            # Update system
sudo pacman -S package      # Install package  
sudo pacman -R package      # Remove package
sudo pacman -Ss term        # Search packages

# AUR package installation via yay
devex install visual-studio-code-bin  # Uses yay if available

# DevEx Flatpak operations
devex install org.gimp.GIMP           # Flatpak application ID
devex install com.spotify.Client      # Cross-distro compatibility

# Manual Flatpak operations
flatpak install flathub app-id        # Install from Flathub
flatpak list                          # List installed apps
flatpak update                        # Update all apps

# DevEx Snap operations  
devex install code --classic           # Classic snap
devex install discord                  # Regular snap

# Manual Snap operations
snap install package                   # Install snap
snap list                             # List installed snaps
snap refresh                          # Update snaps

# Example GNOME configuration
desktop:
  gnome:
    settings:
      - key: 'org.gnome.desktop.interface.gtk-theme'
        value: 'Adwaita-dark'
      - key: 'org.gnome.shell.enabled-extensions'
        value: ['user-theme@gnome-shell-extensions.gcampax.github.com']

# Ubuntu comes with snap pre-installed
devex install code           # Prefers snap version on Ubuntu
devex install --method=apt code  # Force APT version

# DevEx automatically manages PPAs
devex install obs-studio     # Adds OBS PPA automatically

# DevEx can use Copr repositories
devex install rpmfusion-free    # Enables RPM Fusion

# Immutable systems prefer Flatpak
devex install --method=flatpak gimp

# Seamless AUR support
devex install spotify          # Uses AUR if not in official repos
devex install --aur-helper=paru spotify  # Use specific AUR helper

# APT lock issues
sudo rm /var/lib/apt/lists/lock
sudo rm /var/cache/apt/archives/lock
sudo rm /var/lib/dpkg/lock*

# DNF lock issues  
sudo rm /var/run/dnf.pid
sudo dnf clean all

# Pacman lock issues
sudo rm /var/lib/pacman/db.lck

# Refresh repository metadata
devex status --refresh-repos

# Manual repository refresh
sudo apt update              # Debian/Ubuntu
sudo dnf makecache          # Fedora/RHEL  
sudo pacman -Sy             # Arch

# Fix common permission issues
sudo chown -R $USER:$USER ~/.devex/
sudo chmod -R 755 ~/.devex/

# Fix broken packages
sudo apt --fix-broken install
sudo dpkg --configure -a

# Clear package cache
sudo apt clean
sudo apt autoremove

# Clear DNF cache
sudo dnf clean all
sudo dnf makecache

# Fix metadata issues
sudo dnf distro-sync

# Update keyring
sudo pacman -S archlinux-keyring
sudo pacman-key --refresh-keys

# Clear package cache  
sudo pacman -Sc

# Parallel downloads (APT 2.0+)
echo 'Acquire::Queue-Mode "host";' | sudo tee /etc/apt/apt.conf.d/99parallel
echo 'Acquire::http::Pipeline-Depth "5";' | sudo tee -a /etc/apt/apt.conf.d/99parallel

# Enable parallel downloads
echo 'max_parallel_downloads=10' | sudo tee -a /etc/dnf/dnf.conf
echo 'fastestmirror=True' | sudo tee -a /etc/dnf/dnf.conf

# Enable parallel downloads
sudo sed -i 's/#ParallelDownloads = 5/ParallelDownloads = 10/' /etc/pacman.conf

# Use local configuration cache
devex config cache --enable

# Prefer local package managers over universal ones
devex config set prefer-native-packages true

# Enable concurrent installations
devex config set max-concurrent-installs 3