Prepare the 1.0.0 GA release surface

Add the repo-side pieces for milestone 5: MIT licensing, real maintainer and forge metadata, a public support doc, 1.0.0 release notes, release-prep tooling, and CI uploads for the full candidate artifact set.

Keep source-tree version surfaces honest by reading the local project version in the CLI and About dialog, and cover the new release-prep plus version-fallback behavior with focused tests.

Document where raw validation evidence belongs, add the GA validation rollup, and archive the latest readiness review. Milestone 5 remains open until the forge release page is published and the milestone 2 and 3 matrices are filled with linked manual evidence.

Validation: PYTHONPATH=src python3 -m unittest discover -s tests -p 'test_*.py'; PYTHONPATH=src python3 -m unittest tests.test_release_prep tests.test_portable_bundle tests.test_aman_cli tests.test_config_ui; python3 -m py_compile src/*.py tests/*.py; PYTHONPATH=src python3 -m aman version
This commit is contained in:
Thales Maciel 2026-03-12 19:36:52 -03:00
parent acfc376845
commit 31a1e069b3
No known key found for this signature in database
GPG key ID: 33112E6833C34679
28 changed files with 591 additions and 33 deletions

View file

@ -5,6 +5,11 @@ Aman is a local X11 dictation daemon for Linux desktops. The supported path is:
install the portable bundle, save the first-run settings window once, then use
a hotkey to dictate into the focused app.
Published bundles, checksums, and release notes live on the
[`git.thaloco.com` releases page](https://git.thaloco.com/thaloco/aman/releases).
Support requests and bug reports go to
[`SUPPORT.md`](SUPPORT.md) or `thales@thalesmaciel.com`.
## Supported Path
| Surface | Contract |
@ -62,7 +67,7 @@ sudo zypper install -y portaudio gtk3 libayatana-appindicator3-1 python3-gobject
Then install Aman and run the first dictation:
1. Verify and extract the portable bundle.
1. Download, verify, and extract the portable bundle from the releases page.
2. Run `./install.sh`.
3. When `Aman Settings (Required)` opens, choose your microphone and keep
`Clipboard paste (recommended)` unless you have a reason to change it.
@ -138,6 +143,8 @@ The canonical end-user guide lives in
- Fresh install, upgrade, uninstall, and purge behavior are documented there.
- The same guide covers distro-package conflicts and portable-installer
recovery steps.
- Release-specific notes for `1.0.0` live in
[`docs/releases/1.0.0.md`](docs/releases/1.0.0.md).
## Daily Use and Support
@ -162,6 +169,8 @@ The canonical end-user guide lives in
- Install, upgrade, uninstall: [docs/portable-install.md](docs/portable-install.md)
- Runtime recovery and diagnostics: [docs/runtime-recovery.md](docs/runtime-recovery.md)
- Release notes: [docs/releases/1.0.0.md](docs/releases/1.0.0.md)
- Support and issue reporting: [SUPPORT.md](SUPPORT.md)
- Config reference and advanced behavior: [docs/config-reference.md](docs/config-reference.md)
- Developer, packaging, and benchmark workflows: [docs/developer-workflows.md](docs/developer-workflows.md)
- Persona and distribution policy: [docs/persona-and-distribution.md](docs/persona-and-distribution.md)