Define the X11 support contract for milestone 1

Clarify the current release channels versus the X11 GA target so the project has an explicit support promise before milestone 2 delivery work begins.

Update the README, persona and distribution docs, and release checklist with a support matrix, the systemd --user daily-use path, the manual aman run support path, and the canonical recovery sequence. Mark milestone 1 complete in the roadmap once that contract is documented.

Align run, doctor, and self-check help text with the same service and diagnostics language without changing command behavior.

Validated with PYTHONPATH=src python3 -m aman --help, PYTHONPATH=src python3 -m aman doctor --help, and PYTHONPATH=src python3 -m aman self-check --help. Excludes generated src/aman.egg-info and prior user-readiness notes.

docs/persona-and-distribution.md

@@ -4,16 +4,21 @@
 
 This is the canonical Aman user.
 
-- Uses Linux desktop daily (X11 today), mostly Ubuntu/Debian.
+- Uses Linux desktop daily on X11, across mainstream distros.
 - Wants fast dictation and rewriting without learning Python tooling.
 - Prefers GUI setup and tray usage over CLI.
-- Expects normal install/uninstall/update behavior from system packages.
+- Expects a simple end-user install plus a normal background service lifecycle.
 
 Design implications:
 
 - End-user install path must not require `uv`.
 - Runtime defaults should work with minimal input.
-- Documentation should prioritize package install first.
+- Supported daily use should be a `systemd --user` service.
+- Foreground `aman run` should remain available for setup, support, and
+  debugging.
+- Diagnostics should be part of the user workflow, not only developer tooling.
+- Documentation should distinguish current release channels from the long-term
+  GA contract.
 
 ## Secondary Persona: Power User
 
@@ -27,24 +32,52 @@ Design implications:
 - Keep explicit expert-mode knobs in settings and config.
 - Keep docs for development separate from standard install docs.
 
-## Supported Distribution Path (Current)
+## Current Release Channels
 
-Tiered distribution model:
+The current release channels are:
 
-1. Canonical: Debian package (`.deb`) for Ubuntu/Debian users.
+1. Current end-user channel: Debian package (`.deb`) for Ubuntu/Debian users.
 2. Secondary: Arch package inputs (`PKGBUILD` + source tarball).
-3. Developer: wheel/sdist from `python -m build`.
+3. Developer: wheel and sdist from `python -m build`.
 
-## Out of Scope for Initial Packaging
+The portable X11 installer is the GA target channel, not the current shipped
+channel.
+
+## GA Target Support Contract
+
+For X11 GA, Aman supports:
+
+- X11 desktop sessions only.
+- 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.
+- The recovery sequence `aman doctor` -> `aman self-check` ->
+  `journalctl --user -u aman` -> `aman run --verbose`.
+
+"Any distro" means mainstream distros that satisfy these assumptions. It does
+not mean native-package parity or exhaustive certification for every Linux
+variant.
+
+## Out of Scope for X11 GA
 
 - Wayland production support.
 - Flatpak/snap-first distribution.
 - Cross-platform desktop installers outside Linux.
+- Native-package parity across every distro.
 
 ## Release and Support Policy
 
 - App versioning follows SemVer (`0.y.z` until API/UX stabilizes).
 - Config schema versioning is independent (`config_version` in config).
-- Packaging docs must always separate:
-  - End-user install path (package-first)
-  - Developer setup path (uv/pip/build workflows)
+- Docs must always separate:
+  - Current release channels
+  - GA target support contract
+  - Developer setup paths
+- The public support contract must always identify:
+  - Supported environment assumptions
+  - Daily-use service mode versus manual foreground mode
+  - Canonical recovery sequence
+  - Representative validation families
+- GA means the support contract, validation evidence, and release surface are
+  consistent. It does not require a native package for every distro.