ALPS — Advanced Linux Package System
=====================================
by adrianpriza-ai

Started as a simple pacman wrapper.
Ended up as something that tries to unify
apt, apt-get, dnf, and pacman under one roof —
with AUR, Snap, Flatpak, and a custom script repo
called alps-more.

The goal was never to replace yay or apt.
It was to stop remembering which command works on which distro.
One tool. One interface. Every distro.


What it does
------------
- Auto-detects your package manager
- AUR support with dep resolution, PKGBUILD review, build cache
- Snap fallback on Ubuntu/Debian when apt can't find a package
- Flatpak as a first-class subcommand
- alps-more: a cross-distro script repo hosted on Codeberg + GitHub Pages
- Handles root, sudo, and su — works even on systems without sudo
- Shell completion that knows your distro
- Warns you before doing something stupid (partial upgrades on Arch)
- Customizable: colors, symbols, header, aliases


What it doesn't do
------------------
- It doesn't reinvent the wheel
- It calls the real package manager, not replace it
- It won't install snap on a system where it's blocked


Project structure
-----------------
alps/
  main.go          entry point, backend dispatch
  config/          config loading
  ui/              output, header, help
  aur/             AUR helper (yay fallback + makepkg)
  more/            alps-more repo parser and installer
  snap/            snap support
  flatpak/         flatpak support
  priv/            privilege escalation (sudo / su / root)
  completion/      shell completion (fish, bash, zsh)


alps-more format
----------------
[package@distro]
desc = something
arch = x86_64, aarch64
os = arch
deps = curl
sudo = true
cmd_begin
curl -fsSL https://example.com/install.sh | sh
cmd_end
remove_begin
sudo rm -f /usr/bin/something
remove_end


Links
-----
GitHub   : https://github.com/adrianpriza-ai/alps
AUR      : https://aur.archlinux.org/packages/alps-pm
Website  : https://adrianpriza-ai.github.io/alps
alps-more: https://codeberg.org/moreland/alps-more


Notes to self
-------------
- apt-get needs its own cmdMap (no apt search, use apt-cache)
- pacman -Sy and -Su alone = partial upgrade = bad
- /tmp is RAM on Arch, use ~/.cache for AUR builds
- priv.Command() priority: root > sudo > su > error
- LANG=C only for pacman -Sp (check), never for output
- snap fallback checks for /etc/apt/preferences.d/nosnap.pref (Linux Mint)
- alps-more cache expires after 90 days, lives at /var/cache/alps/more/
- completion is distro-aware: aur only on Arch, snap only on Debian/Ubuntu