thaloco/aman
1
Fork 0
Code Pull requests Releases Packages Activity Actions

Align CI with the validated Ubuntu support floor

Browse source 
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.
This commit is contained in:
Thales Maciel 2026-03-14 15:45:21 -03:00
parent 4d0081d1d0
commit dd2813340b
9 changed files with 270 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

3
docs/developer-workflows.md
View file

@ -14,10 +14,13 @@ make package-arch
make runtime-check
make release-check
make release-prep
bash ./scripts/ci_portable_smoke.sh
```
- `make package-portable` builds `dist/aman-x11-linux-<version>.tar.gz` plus
its `.sha256` file.
- `bash ./scripts/ci_portable_smoke.sh` reproduces the Ubuntu CI portable
install plus `aman doctor` smoke path locally.
- `make release-prep` runs `make release-check`, builds the packaged artifacts,
and writes `dist/SHA256SUMS` for the release page upload set.
- `make package-deb` installs Python dependencies while creating the package.

5
docs/persona-and-distribution.md
View file

@ -50,7 +50,10 @@ For X11 GA, Aman supports:
- Runtime dependencies installed from the distro package manager.
- `systemd --user` as the supported daily-use path.
- `aman run` as the foreground setup, support, and debugging path.
- Representative validation across Debian/Ubuntu, Arch, Fedora, and openSUSE.
- Automated validation floor on Ubuntu CI: 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.
- The recovery sequence `aman doctor` -> `aman self-check` ->
`journalctl --user -u aman` -> `aman run --verbose`.

7
docs/portable-install.md
View file

@ -15,6 +15,11 @@ Download published bundles, checksums, and release notes from
- System CPython `3.10`, `3.11`, or `3.12`
- Runtime dependencies installed from the distro package manager
Current automated validation covers Ubuntu CI on CPython `3.10`, `3.11`, and
`3.12` for unit/package coverage, plus a portable install and `aman doctor`
smoke path with Ubuntu system `python3`. The other distro-family instructions
below remain manual validation targets.
## Runtime dependencies
Install the runtime dependencies for your distro before running `install.sh`.
@ -22,7 +27,7 @@ Install the runtime dependencies for your distro before running `install.sh`.
### Ubuntu/Debian
```bash
sudo apt install -y libportaudio2 python3-gi python3-xlib gir1.2-gtk-3.0 libayatana-appindicator3-1
sudo apt install -y libportaudio2 python3-gi python3-xlib gir1.2-gtk-3.0 gir1.2-ayatanaappindicator3-0.1 libayatana-appindicator3-1
```
### Arch Linux

5
docs/releases/1.0.0.md
View file

@ -15,7 +15,10 @@ This is the first GA-targeted X11 release for Aman.
- `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
- Representative validation families: Debian/Ubuntu, Arch, Fedora, openSUSE
- 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

5
docs/x11-ga/ga-validation-report.md
View file

@ -34,6 +34,10 @@ state.
## Evidence sources
- Automated CI validation:
GitHub Actions Ubuntu lanes for CPython `3.10`, `3.11`, and `3.12` for
unit/package coverage, plus a portable install and `aman doctor` smoke lane
with Ubuntu system `python3`
- Portable lifecycle matrix:
[`portable-validation-matrix.md`](./portable-validation-matrix.md)
- Runtime reliability matrix:
@ -52,6 +56,7 @@ state.
| Milestone 2 portable lifecycle | Complete for now | Arch row in `portable-validation-matrix.md` plus [`user-readiness/1773357669.md`](../../user-readiness/1773357669.md) |
| Milestone 3 runtime reliability | Complete for now | Arch runtime rows in `runtime-validation-report.md` plus [`user-readiness/1773357669.md`](../../user-readiness/1773357669.md) |
| Milestone 4 first-run UX/docs | Complete | `first-run-review-notes.md` and `user-readiness/1773352170.md` |
| Automated validation floor | Repo-complete | GitHub Actions Ubuntu matrix on CPython `3.10`-`3.12` plus portable smoke with Ubuntu system `python3` |
| Release metadata and support surface | Repo-complete | `LICENSE`, `SUPPORT.md`, `pyproject.toml`, packaging templates |
| Release artifacts and checksums | Repo-complete | `make release-prep`, `dist/SHA256SUMS`, `docs/releases/1.0.0.md` |
| Full four-family GA validation | Pending | Complete the remaining Debian/Ubuntu, Fedora, and openSUSE rows in both validation matrices |