aman/docs/x11-ga/ga-validation-report.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

63 lines
3 KiB
Markdown

# GA Validation Report
This document is the final rollup for the X11 GA release. It does not replace
the underlying evidence sources. It links them and records the final signoff
state.
## Where to put validation evidence
- Put raw manual validation notes in `user-readiness/<linux-timestamp>.md`.
- Use one timestamped file per validation session, distro pass, or reviewer
handoff.
- In the raw evidence file, record:
- distro and version
- reviewer
- date
- release artifact version
- commands run
- pass/fail results
- failure details and recovery outcome
- Reference those timestamped files from the `Notes` columns in:
- [`portable-validation-matrix.md`](./portable-validation-matrix.md)
- [`runtime-validation-report.md`](./runtime-validation-report.md)
- For milestone 2 and 3 closeout, one fully validated representative distro
family is enough for now. Full Debian/Ubuntu, Arch, Fedora, and openSUSE
coverage remains a milestone 5 GA signoff requirement.
## Release metadata
- Release version: `1.0.0`
- Release page:
`https://git.thaloco.com/thaloco/aman/releases/tag/v1.0.0`
- Support channel: `thales@thalesmaciel.com`
- License: MIT
## 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:
[`runtime-validation-report.md`](./runtime-validation-report.md)
- First-run review:
[`first-run-review-notes.md`](./first-run-review-notes.md)
- Raw evidence archive:
[`user-readiness/README.md`](../../user-readiness/README.md)
- Release notes:
[`docs/releases/1.0.0.md`](../releases/1.0.0.md)
## Final signoff status
| Area | Status | Evidence |
| --- | --- | --- |
| 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 |
| Published release page | Pending | Publish `v1.0.0` on the forge release page and attach the prepared artifacts |