From fef1b5cca2c4072fb9c27f98bdddd5d7dcec36a8 Mon Sep 17 00:00:00 2001 From: Claudiu Schuster Date: Sat, 29 Aug 2026 14:40:04 +0200 Subject: [PATCH] Document Arch release candidate status --- README.md | 25 +++++++++++++++++++------ docs/DESKTOP_GATES.md | 10 ++++++++++ docs/PORTABILITY.md | 34 +++++++++++++++++++--------------- docs/QUICK_START.md | 16 ++++++++++++++-- 4 files changed, 62 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 18eecc6..ae1668e 100644 --- a/README.md +++ b/README.md @@ -82,12 +82,12 @@ when needed; writes remain protected in the local VFS cache until uploaded. ## Install The supported target is Linux Mint 22.x with Cinnamon, Nemo and a normal -graphical login. Arch Linux and Ubuntu are the first portability targets, but -are not called supported until their native packages and clean-desktop release -gates pass. An Arch package candidate now builds from the shared staged install -tree; it is not a published release yet. See the -[distribution portability plan](docs/PORTABILITY.md) and the -privacy-safe [real desktop release gates](docs/DESKTOP_GATES.md). +graphical login. Arch Linux and Ubuntu are the first portability targets. The +Arch Linux `0.8.0-1` package candidate has passed its clean Cinnamon/X11 +desktop gate and is attached to the `v0.8.0` GitHub Release for configured +real-world review; it is not yet a generally supported Arch target. See the +[distribution portability plan](docs/PORTABILITY.md) and the privacy-safe +[real desktop release gates](docs/DESKTOP_GATES.md). ```bash git clone https://github.com/oss-singularity/proton-drive-linux.git @@ -96,6 +96,19 @@ cd proton-drive-linux pdrive-ui ``` +Arch reviewers can download the `proton-drive-linux-0.8.0-1-any.pkg.tar.zst` +asset from the [`v0.8.0` release](https://github.com/oss-singularity/proton-drive-linux/releases/tag/v0.8.0), +verify the SHA-256 published in its release notes and install it with: + +```bash +sudo pacman -U ./proton-drive-linux-0.8.0-1-any.pkg.tar.zst +pdrive-ui +``` + +The native package installs immutable application files below `/usr` while +credentials, configuration, state, rclone and every VFS cache namespace remain +inside the user profile. + The installer may request `sudo` once to create the owner-only `/pdrive` directory. On first launch, the setup wizard checks prerequisites, can install missing supported distribution packages through Polkit, prepares PDrive's diff --git a/docs/DESKTOP_GATES.md b/docs/DESKTOP_GATES.md index 7d691ef..e69d152 100644 --- a/docs/DESKTOP_GATES.md +++ b/docs/DESKTOP_GATES.md @@ -122,3 +122,13 @@ Promotion requires green repository checks, the rolling Arch container job and one complete clean Arch desktop record. A report from an already customized machine is useful additional evidence but does not replace the clean install. Ubuntu follows the same process with its own package and clean Ubuntu desktop. + +The first clean Arch record was completed for pull request +[`#66`](https://github.com/oss-singularity/proton-drive-linux/pull/66): the +commit-bound `0.8.0-1` package was installed on a fresh Arch Cinnamon/X11 +desktop, passed all 15 automated preflight gates, tray and Nemo interaction, +English and German UI checks, logout/login lifecycle and package integrity. +The gate exposed and closed a 1280x800 work-area overflow before release. The +exact reviewed package SHA-256 is recorded in the pull request and matching +release notes. Configured Proton-account and transfer review remains required +before Arch is described as generally supported. diff --git a/docs/PORTABILITY.md b/docs/PORTABILITY.md index 332adad..749ea9e 100644 --- a/docs/PORTABILITY.md +++ b/docs/PORTABILITY.md @@ -6,9 +6,11 @@ or mechanically backport commits between them. Distribution differences belong in small reviewed adapters, package recipes and tests beside the shared source. Linux Mint 22.x Cinnamon remains the reference and currently supported desktop. -Arch Linux and Ubuntu are the first portability targets. Their presence in an -adapter or container test is not yet a support claim; each target is promoted -only after its complete release gate has passed. +Arch Linux and Ubuntu are the first portability targets. Arch Linux has passed +its clean Cinnamon/X11 installation gate and now has a release-candidate +package for configured real-world review. Adapter or container coverage alone +is never a support claim; each target is promoted only after its complete +release gate has passed. ## Portability envelope @@ -30,16 +32,16 @@ credential and UI behavior has been designed and tested. ## Target status -| Distribution | Current status | Promotion work still required | -| --------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------ | -| Linux Mint 22.x Cinnamon | Reference, supported | Keep the full local and online suite green and retain live Cinnamon/Nemo release testing. | -| Ubuntu 24.04 LTS | Initial target | Complete package layout, clean-system installation, GNOME/keyring/tray testing and release packaging. | -| Arch Linux | Package candidate | Keep smoke and native-package gates green; complete clean-system installation and Fabi's live desktop validation. | -| Debian | Prepared next | Reuse the Debian-family adapter, then validate supported desktop and package versions explicitly. | -| MX Linux | Planned | Decide and test the supported systemd mode; the default non-systemd experience is outside today's lifecycle contract. | -| Fedora | Planned | Add an RPM-family package adapter, spec file and SELinux-aware desktop tests. | -| CentOS Stream / RHEL family | Planned | Establish available GTK, AppIndicator and Python versions before defining a supported release. | -| Univention UCS | Future request | Treat as a separate Debian-derived, server-oriented target; first define the intended desktop and user-session use case. | +| Distribution | Current status | Promotion work still required | +| ---------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------ | +| Linux Mint 22.x Cinnamon | Reference, supported | Keep the full local and online suite green and retain live Cinnamon/Nemo release testing. | +| Ubuntu 24.04 LTS | Initial target | Complete package layout, clean-system installation, GNOME/keyring/tray testing and release packaging. | +| Arch Linux with Cinnamon/X11 | Release candidate | Keep smoke and native-package gates green; complete configured account, transfer and login-lifecycle review. | +| Debian | Prepared next | Reuse the Debian-family adapter, then validate supported desktop and package versions explicitly. | +| MX Linux | Planned | Decide and test the supported systemd mode; the default non-systemd experience is outside today's lifecycle contract. | +| Fedora | Planned | Add an RPM-family package adapter, spec file and SELinux-aware desktop tests. | +| CentOS Stream / RHEL family | Planned | Establish available GTK, AppIndicator and Python versions before defining a supported release. | +| Univention UCS | Future request | Treat as a separate Debian-derived, server-oriented target; first define the intended desktop and user-session use case. | ## One source tree, small adapters @@ -98,8 +100,10 @@ command publishes an image, stable package, tag or release. On pull requests and explicit workflow dispatches, the same Arch compatibility job reuses its already pulled image, runs the native package gate and uploads the compressed package for seven days as `proton-drive-linux-arch-`. This ephemeral, -commit-bound test candidate exists only for the clean-desktop gate; it is not a -stable distribution package. +commit-bound artifact exists for the clean-desktop gate. A package that passes +that gate may be attached to its matching PDrive GitHub Release for configured +review, but does not become a generally supported distribution package until +the remaining promotion record is complete. The runner refuses to download an image implicitly. To opt into a current image download, run: diff --git a/docs/QUICK_START.md b/docs/QUICK_START.md index 45708a3..dc0def6 100644 --- a/docs/QUICK_START.md +++ b/docs/QUICK_START.md @@ -11,8 +11,10 @@ upload. Detailed maintenance belongs in [Operations](OPERATIONS.md), not here. ## 1. Install The supported target is Linux Mint 22.x with Cinnamon, Nemo and a graphical -login. Arch Linux and Ubuntu are active portability targets, not yet supported -release targets; see [Distribution portability](PORTABILITY.md). +login. Arch Linux and Ubuntu are active portability targets. The Arch Linux +`0.8.0-1` candidate has passed its clean Cinnamon/X11 desktop gate and is ready +for configured real-world review, but is not yet a generally supported release +target; see [Distribution portability](PORTABILITY.md). ```bash git clone https://github.com/oss-singularity/proton-drive-linux.git @@ -21,6 +23,16 @@ cd proton-drive-linux pdrive-ui ``` +For the reviewed Arch candidate, download +`proton-drive-linux-0.8.0-1-any.pkg.tar.zst` from the +[`v0.8.0` release](https://github.com/oss-singularity/proton-drive-linux/releases/tag/v0.8.0), +verify its published SHA-256 and replace the source-install commands above with: + +```bash +sudo pacman -U ./proton-drive-linux-0.8.0-1-any.pkg.tar.zst +pdrive-ui +``` + The installer may request administrator approval once to create the owner-only `/pdrive` mountpoint. Personal rclone configuration, credentials, cache and state are preserved when the installer is run again.