thaloco/aman
1
Fork 0
Code Pull requests Releases Packages Activity Actions
aman/docs/releases/1.0.0.md
Thales Maciel dd2813340b Align CI with the validated Ubuntu support floor 
Stop implying that one Ubuntu 3.11 unit lane validates the full Linux support surface Aman documents.\n\nSplit CI into an Ubuntu CPython 3.10/3.11/3.12 unit-package matrix, a portable install plus doctor smoke lane, and a packaging lane gated on both. Add a reproducible ci_portable_smoke.sh helper with fake systemctl coverage, and force the installer onto /usr/bin/python3 so the smoke path uses the distro-provided GI and X11 Python packages it is meant to validate.\n\nUpdate the README, release/distribution docs, and Debian metadata to distinguish the automated Ubuntu CI floor from broader manual GA signoff families, and add the missing AppIndicator introspection package to the Ubuntu/Debian dependency lists.\n\nValidate with python3 -m unittest discover -s tests -p 'test_*.py', python3 -m py_compile src/*.py tests/*.py, and bash -n scripts/ci_portable_smoke.sh. The full xvfb-backed smoke could not be run locally in this sandbox because xvfb-run is unavailable.
2026-03-14 15:45:21 -03:00

2.2 KiB
Raw Permalink Blame History

Aman 1.0.0

This is the first GA-targeted X11 release for Aman.

  • Canonical release page: https://git.thaloco.com/thaloco/aman/releases/tag/v1.0.0
  • Canonical release index: https://git.thaloco.com/thaloco/aman/releases
  • Support and issue reporting: thales@thalesmaciel.com

Supported environment

  • X11 desktop sessions only
  • systemd --user for supported daily use
  • System CPython 3.10, 3.11, or 3.12 for the portable installer
  • Runtime dependencies installed from the distro package manager
  • Automated validation floor: Ubuntu CI on CPython 3.10, 3.11, and 3.12 for unit/package coverage, plus portable install and aman doctor smoke with Ubuntu system python3
  • Manual GA signoff families: Debian/Ubuntu, Arch, Fedora, openSUSE

Artifacts

The release page should publish:

  • aman-x11-linux-1.0.0.tar.gz
  • aman-x11-linux-1.0.0.tar.gz.sha256
  • SHA256SUMS
  • wheel artifact from dist/*.whl
  • Debian package from dist/*.deb
  • Arch package inputs from dist/arch/PKGBUILD and dist/arch/*.tar.gz

Install, update, and uninstall

  • Install: download the portable bundle and checksum from the release page, verify the checksum, extract the bundle, then run ./install.sh
  • Update: extract the newer bundle and run its ./install.sh
  • Uninstall: run ~/.local/share/aman/current/uninstall.sh
  • Purge uninstall: run ~/.local/share/aman/current/uninstall.sh --purge

The full end-user lifecycle is documented in docs/portable-install.md.

Recovery path

If the supported path fails, use:

  1. aman doctor --config ~/.config/aman/config.json
  2. aman self-check --config ~/.config/aman/config.json
  3. journalctl --user -u aman
  4. aman run --config ~/.config/aman/config.json --verbose

Reference diagnostics and failure IDs live in docs/runtime-recovery.md.

Support

Email thales@thalesmaciel.com with:

  • distro and version
  • X11 confirmation
  • install channel and Aman version
  • aman doctor output
  • aman self-check output
  • relevant journalctl --user -u aman lines

Non-goals

  • Wayland support
  • Flatpak or snap as the canonical GA path
  • Native-package parity across every Linux distro