From 43cdef3d4881085ebecaf067b3e6d7fa40d10cdc Mon Sep 17 00:00:00 2001 From: Dmitriy Date: Sat, 7 Nov 2026 15:30:37 +0300 Subject: [PATCH 1/3] release: prepare syauth 0.2.0 --- Cargo.lock | 14 +++++++------- Cargo.toml | 8 ++++---- Makefile | 6 +++--- README.md | 2 +- crates/syauth-cli/Cargo.toml | 2 +- crates/syauth-mobile/Cargo.toml | 2 +- crates/syauth-presenced/Cargo.toml | 4 ++-- crates/syauth-transport/Cargo.toml | 2 +- deploy/debian/changelog | 7 +++++++ deploy/debian/rules | 4 ++-- deploy/fedora/syauth.spec | 7 +++++-- deploy/release-notes.md | 17 +++++++++++++++++ deploy/version.env | 6 +++--- docs/contributing/releases.md | 20 ++++++++++---------- docs/how-to/install.md | 24 ++++++++++++------------ docs/index.md | 2 +- scripts/build-release-apk.sh | 2 +- scripts/smoke-install.sh | 2 +- syauth-android/app/build.gradle.kts | 2 +- 19 files changed, 80 insertions(+), 53 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index c7bd1bb..837cf5b 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -2175,7 +2175,7 @@ checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292" [[package]] name = "syauth" -version = "0.1.0" +version = "0.2.0" dependencies = [ "bluer", "syauth-core", @@ -2188,7 +2188,7 @@ dependencies = [ [[package]] name = "syauth-cli" -version = "0.1.0" +version = "0.2.0" dependencies = [ "anyhow", "assert_cmd", @@ -2218,7 +2218,7 @@ dependencies = [ [[package]] name = "syauth-core" -version = "0.1.0" +version = "0.2.0" dependencies = [ "blake3", "ed25519-dalek", @@ -2240,7 +2240,7 @@ dependencies = [ [[package]] name = "syauth-mobile" -version = "0.1.0" +version = "0.2.0" dependencies = [ "hex", "hkdf 0.13.0", @@ -2253,7 +2253,7 @@ dependencies = [ [[package]] name = "syauth-pam" -version = "0.1.0" +version = "0.2.0" dependencies = [ "ed25519-dalek", "getrandom 0.3.4", @@ -2270,7 +2270,7 @@ dependencies = [ [[package]] name = "syauth-presenced" -version = "0.1.0" +version = "0.2.0" dependencies = [ "anyhow", "ciborium", @@ -2296,7 +2296,7 @@ dependencies = [ [[package]] name = "syauth-transport" -version = "0.1.0" +version = "0.2.0" dependencies = [ "async-trait", "bluer", diff --git a/Cargo.toml b/Cargo.toml index 8093033..6285c00 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -22,7 +22,7 @@ exclude = ["crates/syauth-core/fuzz"] resolver = "2" [workspace.package] -version = "0.1.0" +version = "0.2.0" edition = "2024" rust-version = "1.85" license = "MIT" @@ -59,15 +59,15 @@ workspace = true bluer = { version = "0.17", default-features = false, features = ["bluetoothd"] } tokio = { version = "1", features = ["macros", "rt-multi-thread"] } # DEV-001 TC-11: pins LESC-derived material → MAC + BondStore round-trip. -syauth-core = { version = "0.1", path = "crates/syauth-core" } +syauth-core = { version = "0.2", path = "crates/syauth-core" } # DEV-001 TC-11: built-in `Bond` carries `time::OffsetDateTime`. time = { version = "0.3", features = ["macros"] } # DEV-003 cross-crate byte-identity: assert the mobile UniFFI # `session_uuid_for_bond` output matches the desktop transport's # `session_uuid_for` byte for byte so the phone's scan filter UUID # set always matches the desktop's advertised service UUID. -syauth-transport = { version = "0.1", path = "crates/syauth-transport" } -syauth-mobile = { version = "0.1", path = "crates/syauth-mobile" } +syauth-transport = { version = "0.2", path = "crates/syauth-transport" } +syauth-mobile = { version = "0.2", path = "crates/syauth-mobile" } uuid = { version = "1" } [profile.release] diff --git a/Makefile b/Makefile index 00f894e..fdf190d 100644 --- a/Makefile +++ b/Makefile @@ -93,7 +93,7 @@ lint: scope-discipline scope-discipline: @echo "Running scope-discipline grep..." @if git grep -nE \ - '(v0\.[0-9]+ ?(demo|will|follow.?up|reinstates|candidate))|(for the v0\.)|(production (version|will))|(demo only)|(temporary until)|(placeholder until)' \ + '(v0\.[0-9]+ ?(demo|will|follow.?up|reinstates|candidate))|(for[ ]the[ ]v0\.)|(production[ ](version|will))|(demo[ ]only)|(temporary[ ]until)|(placeholder[ ]until)' \ -- 'crates/' 'syauth-android/app/src/main/' 'deploy/' \ ':!:*tests/*' ':!:*test/*' ':!:*build/*' ':!:*target/*'; then \ echo ""; \ @@ -279,8 +279,8 @@ endif # deploy/version.env; the values are duplicated here only to keep the # Make invocation self-contained. -PACKAGE_VERSION ?= 0.1.0 -RPM_RELEASE ?= 3 +PACKAGE_VERSION ?= 0.2.0 +RPM_RELEASE ?= 5 DEB_REVISION ?= 1 DIST_PREFIX ?= syauth-$(PACKAGE_VERSION) DIST_TARBALL ?= target/$(DIST_PREFIX).tar.gz diff --git a/README.md b/README.md index 4e8c30e..e5ecd40 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ sh install-syauth.sh --dry-run sh install-syauth.sh ``` -Release downloads include DEB, RPM, Arch Linux packages, and manual Linux archives for x86_64 and ARM64, plus a signed [Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0/syauth-0.1.0-android.apk), source archive, signing certificate, build metadata, and `SHA256SUMS`. See [installation and verification](https://dmytrogajewski.github.io/syauth/how-to/install/) for direct package commands and version-pinned downloads. +Release downloads include DEB, RPM, Arch Linux packages, and manual Linux archives for x86_64 and ARM64, plus a signed [Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), source archive, signing certificate, build metadata, and `SHA256SUMS`. See [installation and verification](https://dmytrogajewski.github.io/syauth/how-to/install/) for direct package commands and version-pinned downloads. Use Debian 12+, Ubuntu 24.04+, a current Fedora/openSUSE/Arch installation, or a compatible derivative, with glibc 2.36+, PAM, systemd user services, BlueZ, and a BLE adapter capable of advertising. The phone needs Android 13+ with a supported Ed25519 Keystore implementation and an enrolled strong biometric. The APK can install on older Android versions, but that does not establish signing-key support. diff --git a/crates/syauth-cli/Cargo.toml b/crates/syauth-cli/Cargo.toml index 866dd46..ba6fd97 100644 --- a/crates/syauth-cli/Cargo.toml +++ b/crates/syauth-cli/Cargo.toml @@ -74,7 +74,7 @@ serde_json = "1" # wire shape the PAM module uses to probe the daemon's auth.sock. # `syauth-presenced` already lives in the workspace; this dependency is # library-only (no binary linkage). -syauth-presenced = { version = "0.1", path = "../syauth-presenced" } +syauth-presenced = { version = "0.2", path = "../syauth-presenced" } # S-016 doctor: `geteuid()` for the `/run/user/` fallback when # `XDG_RUNTIME_DIR` is unset. `nix` already lives in `Cargo.lock` # via `syauth-presenced`, so no new transitive surface. diff --git a/crates/syauth-mobile/Cargo.toml b/crates/syauth-mobile/Cargo.toml index 6b73486..5dda73b 100644 --- a/crates/syauth-mobile/Cargo.toml +++ b/crates/syauth-mobile/Cargo.toml @@ -51,7 +51,7 @@ thiserror = "2" # `syauth-core` re-exports `Frame`, `compute_tag`, `verify_tag`, # `sign_frame`, `verify_frame`, and the typed errors we wrap into # `MobileError`. Pinned by path so the workspace resolves to one version. -syauth-core = { version = "0.1", path = "../syauth-core" } +syauth-core = { version = "0.2", path = "../syauth-core" } # HKDF-SHA256 for `oob_code_for_bond`. The version pins match # `crates/syauth-cli/Cargo.toml` so the workspace resolves to a single diff --git a/crates/syauth-presenced/Cargo.toml b/crates/syauth-presenced/Cargo.toml index eda0ec8..d744de6 100644 --- a/crates/syauth-presenced/Cargo.toml +++ b/crates/syauth-presenced/Cargo.toml @@ -72,13 +72,13 @@ nix = { version = "0.29", features = ["fs", "signal", "user", "socket"] } libc = "0.2" # S-004: the orchestrator reads `Bond` metadata for the rotation # audit line and reuses `bond_key_from_pubkeys` / `BondStore` shapes. -syauth-core = { version = "0.1", path = "../syauth-core" } +syauth-core = { version = "0.2", path = "../syauth-core" } # S-004: the `Peripheral` trait + `session_uuid_for` derivation + # `BOND_KEY_BYTES` width all live in the transport crate. The # `test-fake` feature ships the radio-free `FakePeripheral` test # double for the rotation integration test; it is a default feature # of `syauth-transport` so no explicit `features` list is required. -syauth-transport = { version = "0.1", path = "../syauth-transport" } +syauth-transport = { version = "0.2", path = "../syauth-transport" } # S-004: 128-bit UUID type for the rotation audit short-hex render. uuid = { version = "1" } # S-005: belt-and-suspenders inotify watcher on `bonds.toml`. The diff --git a/crates/syauth-transport/Cargo.toml b/crates/syauth-transport/Cargo.toml index 6e61324..23ee573 100644 --- a/crates/syauth-transport/Cargo.toml +++ b/crates/syauth-transport/Cargo.toml @@ -39,7 +39,7 @@ test-fake = [] # Shared protocol core. `Frame` and `FrameError` are the only types that cross # the `BtPeer` trait boundary, so consumers can swap implementations (mock # today, `bluer` in S-010) without touching the upper layers. -syauth-core = { version = "0.1", path = "../syauth-core" } +syauth-core = { version = "0.2", path = "../syauth-core" } # Async trait surface. `BtPeer` and `Session` are `async fn` methods on trait # objects; `async-trait` is the canonical way to do that on stable Rust. diff --git a/deploy/debian/changelog b/deploy/debian/changelog index 303989e..2708510 100644 --- a/deploy/debian/changelog +++ b/deploy/debian/changelog @@ -1,3 +1,10 @@ +syauth (0.2.0-1) unstable; urgency=medium + + * Recover Bluetooth transport after controller loss. + * Report controller and advertising health independently of phone presence. + + -- syauth contributors Sat, 07 Nov 2026 00:00:00 +0000 + syauth (0.1.0-1) unstable; urgency=medium * Initial release (Closes: #1). diff --git a/deploy/debian/rules b/deploy/debian/rules index c38f5d4..ed6585f 100755 --- a/deploy/debian/rules +++ b/deploy/debian/rules @@ -1,6 +1,6 @@ #!/usr/bin/make -f # -# Debian rules for syauth v0.1.0 (roadmap item S-021). +# Debian rules for syauth v0.2.0 (roadmap item S-021). # # Driven by debhelper-compat 13. The build chain is hand-rolled (not # dh-cargo) because dh-cargo expects a single-crate package; syauth is @@ -43,7 +43,7 @@ override_dh_auto_build: # so the package surface is identical across distros. mkdir -p debian/man printf '%s\n' \ - '.TH SYAUTH 8 "2026-05-15" "syauth 0.1.0" "System Administration"' \ + '.TH SYAUTH 8 "2026-05-15" "syauth 0.2.0" "System Administration"' \ '.SH NAME' \ 'syauth \- phone-as-key PAM authenticator for Linux' \ '.SH SYNOPSIS' \ diff --git a/deploy/fedora/syauth.spec b/deploy/fedora/syauth.spec index 41e88f7..2e25695 100644 --- a/deploy/fedora/syauth.spec +++ b/deploy/fedora/syauth.spec @@ -1,4 +1,4 @@ -# Fedora RPM spec for syauth v0.1.0 (roadmap item S-021). +# Fedora RPM spec for syauth v0.2.0 (roadmap item S-021). # # This spec ships the Linux desktop side of syauth — the PAM cdylib # under %%{_libdir}/security/pam_syauth.so (mode 0644 per SPEC §6 + @@ -12,7 +12,7 @@ # phone. Built under `mock -r fedora-%%{fedora}-x86_64 deploy/fedora/syauth.spec` # or via `make rpm` (which gates on `which mock`). -%global package_version 0.1.0 +%global package_version 0.2.0 %global rpm_release 5 %global debug_package %{nil} %global min_fedora 39 @@ -164,6 +164,9 @@ fi %{_mandir}/man8/syauth.8.gz %changelog +* Sat Nov 07 2026 syauth contributors - 0.2.0-5 +- Recover Bluetooth transport after controller loss and report transport health. + * Sat Oct 31 2026 syauth contributors - 0.1.0-5 - Select the available BlueZ default adapter when starting the presence daemon. diff --git a/deploy/release-notes.md b/deploy/release-notes.md index 1faed6e..1b47f74 100644 --- a/deploy/release-notes.md +++ b/deploy/release-notes.md @@ -1,3 +1,20 @@ +# syauth 0.2.0 + +This release restores phone discovery after Bluetooth controller resets and +reports transport health separately from daemon liveness. + +- Automatically rebuild GATT and rotating advertising after controller loss, + including controllers renamed from hci0 to hci1. Keep the existing pairing. +- Retry while the controller is unavailable without exhausting the service + restart limit. Bluetooth setup failures request recovery instead of leaving + a socket-only daemon. +- Add `daemon.transport_ready` to `syauth status --json`. Phone absence and an + unanswered approval do not indicate a failed local Bluetooth transport. +- Include patched ctutils and Tokio dependencies. + +The companion panel update is in https://github.com/dmytrogajewski/sy/pull/9. +Each authentication still requires explicit phone approval and a strong biometric. + Approve Linux authentication on Android with a fresh strong biometric. - Native desktop DEB, RPM, and Arch packages and Linux archives for x86_64 and ARM64. diff --git a/deploy/version.env b/deploy/version.env index 6158d2c..7f0e734 100644 --- a/deploy/version.env +++ b/deploy/version.env @@ -11,13 +11,13 @@ # The wire-shipped package version. Mirrors the Rust workspace's # `[workspace.package].version` field in /Cargo.toml. Bump in lockstep. -PACKAGE_VERSION=0.1.0 +PACKAGE_VERSION=0.2.0 -# RPM release counter (the `-1` in `syauth-0.1.0-1.fc39.x86_64.rpm`). +# RPM release counter (the `-1` in `syauth-0.2.0-1.fc39.x86_64.rpm`). # Bump only if a respin is needed without changing the source version. RPM_RELEASE=5 -# Debian revision (the `-1` in `syauth_0.1.0-1_amd64.deb`). Same rule +# Debian revision (the `-1` in `syauth_0.2.0-1_amd64.deb`). Same rule # as RPM_RELEASE. DEB_REVISION=1 diff --git a/docs/contributing/releases.md b/docs/contributing/releases.md index ccd48a4..38e10cc 100644 --- a/docs/contributing/releases.md +++ b/docs/contributing/releases.md @@ -4,16 +4,16 @@ The [release workflow](https://github.com/dmytrogajewski/syauth/actions/workflow ## Artifact contract -For version `0.1.0`, [GitHub Releases](https://github.com/dmytrogajewski/syauth/releases/tag/v0.1.0) contains: +For version `0.2.0`, [GitHub Releases](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) contains: | Artifact | Consumer | | --- | --- | -| `syauth_0.1.0_amd64.deb`, `syauth_0.1.0_arm64.deb` | Debian / Ubuntu and compatible derivatives | -| `syauth-0.1.0-4.x86_64.rpm`, `syauth-0.1.0-4.aarch64.rpm` | Fedora / openSUSE and compatible RPM systems | -| `syauth-0.1.0-1-x86_64.pkg.tar.zst`, `syauth-0.1.0-1-aarch64.pkg.tar.zst` | Arch package-manager installations; ARM64 requires an appropriate Arch Linux ARM system | -| `syauth-0.1.0-linux-{x86_64,aarch64}.tar.gz` | Manual installation / inspection | -| `syauth-0.1.0-android.apk` | Android companion, signed with the persistent release key | -| `syauth-0.1.0-source.tar.gz` | Tagged project sources | +| `syauth_0.2.0_amd64.deb`, `syauth_0.2.0_arm64.deb` | Debian / Ubuntu and compatible derivatives | +| `syauth-0.2.0-4.x86_64.rpm`, `syauth-0.2.0-4.aarch64.rpm` | Fedora / openSUSE and compatible RPM systems | +| `syauth-0.2.0-1-x86_64.pkg.tar.zst`, `syauth-0.2.0-1-aarch64.pkg.tar.zst` | Arch package-manager installations; ARM64 requires an appropriate Arch Linux ARM system | +| `syauth-0.2.0-linux-{x86_64,aarch64}.tar.gz` | Manual installation / inspection | +| `syauth-0.2.0-android.apk` | Android companion, signed with the persistent release key | +| `syauth-0.2.0-source.tar.gz` | Tagged project sources | | `install.sh` | Version-selecting, checksum-verifying shell installer | | `android-signing-certificate.pem`, `android-signing-certificate.txt` | Public signing identity and APK verification output | | `release.json`, `SHA256SUMS` | Source revision, file sizes, SHA-256 digests | @@ -26,9 +26,9 @@ Build the three desktop outputs and package them on the target CPU: ```sh cargo build --locked --release -p syauth-cli -p syauth-pam -p syauth-presenced -scripts/build-linux-packages.sh --version 0.1.0 --arch x86_64 \ +scripts/build-linux-packages.sh --version 0.2.0 --arch x86_64 \ --binaries target/release --output target/release-artifacts -scripts/test-package-install.sh target/release-artifacts 0.1.0 x86_64 debian +scripts/test-package-install.sh target/release-artifacts 0.2.0 x86_64 debian ``` Use `--arch aarch64` for ARM64 binaries. The packager downloads checksum-pinned nFPM 2.47.0; it does not install build tools globally. Building on a newer distribution can raise the required glibc version, so use the workflow's Debian 12 build environment for published artifacts. @@ -41,7 +41,7 @@ The workflow installs JDK 21, Android platform 34, Build Tools 34.0.0, NDK 28.0. ```sh NDK_HOME="$ANDROID_HOME/ndk/28.0.13004108" scripts/build_aar.sh -VERSION=0.1.0 scripts/build-release-apk.sh +VERSION=0.2.0 scripts/build-release-apk.sh ``` The signing script requires `SYAUTH_RELEASE_KEYSTORE` and `SYAUTH_RELEASE_KEYSTORE_PASSWORD`; the key alias defaults to `syauth`. Keep private material outside the checkout. The protected GitHub environment `release` stores `SYAUTH_RELEASE_KEYSTORE_BASE64` and `SYAUTH_RELEASE_KEYSTORE_PASSWORD`. Its key persists across releases; replacing it prevents ordinary Android updates from trusting the old installation. diff --git a/docs/how-to/install.md b/docs/how-to/install.md index 3068ae7..823f6d8 100644 --- a/docs/how-to/install.md +++ b/docs/how-to/install.md @@ -25,29 +25,29 @@ To inspect the script, select a version, or preview package selection: ```sh curl -fsSLo install-syauth.sh https://dmytrogajewski.github.io/syauth/install.sh less install-syauth.sh -sh install-syauth.sh --version 0.1.0 --dry-run -sh install-syauth.sh --version 0.1.0 +sh install-syauth.sh --version 0.2.0 --dry-run +sh install-syauth.sh --version 0.2.0 ``` ### Direct downloads -The [v0.1.0 release](https://github.com/dmytrogajewski/syauth/releases/tag/v0.1.0) has the native packages, manual archives, source, signed APK, and checksums. For example, on Debian/Ubuntu x86_64: +The [v0.2.0 release](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) has the native packages, manual archives, source, signed APK, and checksums. For example, on Debian/Ubuntu x86_64: ```sh -release=https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0 -curl -fSLO "$release/syauth_0.1.0_amd64.deb" +release=https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0 +curl -fSLO "$release/syauth_0.2.0_amd64.deb" curl -fSLO "$release/SHA256SUMS" sha256sum --check --ignore-missing SHA256SUMS -sudo apt install ./syauth_0.1.0_amd64.deb +sudo apt install ./syauth_0.2.0_amd64.deb ``` Choose the corresponding artifact for other native managers, verify it against the same checksum file, then install it: | System | x86_64 artifact | Install command | | --- | --- | --- | -| Fedora | `syauth-0.1.0-4.x86_64.rpm` | `sudo dnf install ./syauth-0.1.0-4.x86_64.rpm` | -| openSUSE | `syauth-0.1.0-4.x86_64.rpm` | `sudo zypper install --allow-unsigned-rpm ./syauth-0.1.0-4.x86_64.rpm` | -| Arch | `syauth-0.1.0-1-x86_64.pkg.tar.zst` | `sudo pacman -U ./syauth-0.1.0-1-x86_64.pkg.tar.zst` | +| Fedora | `syauth-0.2.0-4.x86_64.rpm` | `sudo dnf install ./syauth-0.2.0-4.x86_64.rpm` | +| openSUSE | `syauth-0.2.0-4.x86_64.rpm` | `sudo zypper install --allow-unsigned-rpm ./syauth-0.2.0-4.x86_64.rpm` | +| Arch | `syauth-0.2.0-1-x86_64.pkg.tar.zst` | `sudo pacman -U ./syauth-0.2.0-1-x86_64.pkg.tar.zst` | For ARM64, use the DEB ending in `_arm64.deb`, or the RPM/Arch filename with `aarch64` replacing `x86_64`. The RPM is checksum-verified rather than RPM-signed; the openSUSE command permits that local unsigned RPM without disabling repository checks. These are downloadable native packages, not registered APT/DNF repositories or an AUR listing. Repeat the shell installer to fetch and install a newer release. @@ -112,14 +112,14 @@ The `--dry-run` command **writes the unit file** but skips the binary copy and ` ## Install the Android app -Download the [signed Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0/syauth-0.1.0-android.apk) and [SHA256SUMS](https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0/SHA256SUMS). Verify the downloaded file before opening it on your phone, or install it with ADB: +Download the [signed Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk) and [SHA256SUMS](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/SHA256SUMS). Verify the downloaded file before opening it on your phone, or install it with ADB: ```sh sha256sum --check --ignore-missing SHA256SUMS -adb install -r syauth-0.1.0-android.apk +adb install -r syauth-0.2.0-android.apk ``` -With Android SDK Build Tools installed, verify the signature using `apksigner verify --verbose --print-certs syauth-0.1.0-android.apk`. Compare its SHA-256 certificate digest with the [published release signing identity](../contributing/releases.md#android-builds-and-signing). The private signing key is retained across releases. A debug APK uses a different identity and must be uninstalled before installing this release; uninstalling removes its local app data and requires pairing again. +With Android SDK Build Tools installed, verify the signature using `apksigner verify --verbose --print-certs syauth-0.2.0-android.apk`. Compare its SHA-256 certificate digest with the [published release signing identity](../contributing/releases.md#android-builds-and-signing). The private signing key is retained across releases. A debug APK uses a different identity and must be uninstalled before installing this release; uninstalling removes its local app data and requires pairing again. To build from source, provide Android SDK platform 34, JDK 21, NDK 28.0.13004108, cargo-ndk 4.1.2, and the four Rust Android targets required by `scripts/build_aar.sh`. Its checked-in helper generates the matching UniFFI 0.29.5 bindings. diff --git a/docs/index.md b/docs/index.md index b337d8a..9980d25 100644 --- a/docs/index.md +++ b/docs/index.md @@ -21,7 +21,7 @@ Approve Linux authentication on your Android phone. syauth carries a fresh chall ## Install the release -Install the desktop with `curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh`, then follow [installation and setup](how-to/install.md). The [published v0.1.0 assets](https://github.com/dmytrogajewski/syauth/releases/tag/v0.1.0) include DEB/RPM/Arch packages for both CPU architectures, the [signed Android companion](https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0/syauth-0.1.0-android.apk), and [checksums](https://github.com/dmytrogajewski/syauth/releases/download/v0.1.0/SHA256SUMS). +Install the desktop with `curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh`, then follow [installation and setup](how-to/install.md). The [published v0.2.0 assets](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) include DEB/RPM/Arch packages for both CPU architectures, the [signed Android companion](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), and [checksums](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/SHA256SUMS). ## Follow one unlock diff --git a/scripts/build-release-apk.sh b/scripts/build-release-apk.sh index bb8339d..ff97784 100755 --- a/scripts/build-release-apk.sh +++ b/scripts/build-release-apk.sh @@ -6,7 +6,7 @@ set -euo pipefail : "${SYAUTH_RELEASE_KEYSTORE:?SYAUTH_RELEASE_KEYSTORE is required}" : "${SYAUTH_RELEASE_KEYSTORE_PASSWORD:?SYAUTH_RELEASE_KEYSTORE_PASSWORD is required}" -VERSION="${VERSION:-0.1.0}" +VERSION="${VERSION:-0.2.0}" if [[ ! "$VERSION" =~ ^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$ ]]; then echo "Error: VERSION must be a numeric major.minor.patch" >&2 exit 1 diff --git a/scripts/smoke-install.sh b/scripts/smoke-install.sh index 6ef5e40..2ee1d9f 100755 --- a/scripts/smoke-install.sh +++ b/scripts/smoke-install.sh @@ -17,7 +17,7 @@ set -euo pipefail # Pinned constants. Single-source-of-truth lives in deploy/version.env; # we re-declare here so the script is self-contained when invoked # without the make wrapper. -readonly PACKAGE_VERSION="0.1.0" +readonly PACKAGE_VERSION="0.2.0" readonly RPM_RELEASE="1" readonly DEB_REVISION="1" readonly EXPECTED_VERSION_PREFIX="syauth ${PACKAGE_VERSION}" diff --git a/syauth-android/app/build.gradle.kts b/syauth-android/app/build.gradle.kts index 0457248..cb7e762 100644 --- a/syauth-android/app/build.gradle.kts +++ b/syauth-android/app/build.gradle.kts @@ -45,7 +45,7 @@ plugins { id("org.jetbrains.kotlin.android") } -val releaseVersion = providers.environmentVariable("VERSION").orElse("0.1.0").get() +val releaseVersion = providers.environmentVariable("VERSION").orElse("0.2.0").get() require(Regex("(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)").matches(releaseVersion)) { "VERSION must be a numeric major.minor.patch" } From 7b192f85176171809006d027be8d2e571282cd8a Mon Sep 17 00:00:00 2001 From: Dmitriy Date: Sat, 7 Nov 2026 15:37:07 +0300 Subject: [PATCH 2/3] fix(release): use current repository and Pages addresses --- README.md | 26 ++++++++++---------- deploy/release-notes.md | 6 ++--- docs/contributing/documentation.md | 2 +- docs/contributing/releases.md | 6 ++--- docs/explanation/mechanics.md | 6 ++--- docs/explanation/security.md | 4 ++-- docs/how-to/install.md | 10 ++++---- docs/how-to/troubleshoot.md | 2 +- docs/index.md | 6 ++--- docs/reference/cli.md | 2 +- docs/reference/configuration.md | 2 +- docs/reference/protocol.md | 2 +- docs/release-process.md | 4 ++-- mkdocs.yml | 4 ++-- scripts/build-linux-packages.py | 2 +- scripts/install.sh | 8 +++---- specs/bugs/BUG-20261107-1537.md | 38 ++++++++++++++++++++++++++++++ tests/test_installer.py | 9 +++++++ 18 files changed, 93 insertions(+), 46 deletions(-) create mode 100644 specs/bugs/BUG-20261107-1537.md diff --git a/README.md b/README.md index e5ecd40..d28b516 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,14 @@ Approve Linux authentication on your Android phone with a fresh strong biometric. syauth connects a Linux PAM module, a desktop Bluetooth daemon, and an Android companion that signs each request through Android Keystore. -[Documentation](https://dmytrogajewski.github.io/syauth/) · [Downloads](https://github.com/dmytrogajewski/syauth/releases/latest) · [How it works](https://dmytrogajewski.github.io/syauth/explanation/mechanics/) · [Security boundaries](https://dmytrogajewski.github.io/syauth/explanation/security/) +[Documentation](https://mewplane.github.io/syauth/) · [Downloads](https://github.com/Mewplane/syauth/releases/latest) · [How it works](https://mewplane.github.io/syauth/explanation/mechanics/) · [Security boundaries](https://mewplane.github.io/syauth/explanation/security/) ## Install On a supported Linux desktop: ```sh -curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh +curl -fsSL https://mewplane.github.io/syauth/install.sh | sh ``` The installer resolves the latest release, chooses the native package for your distribution and CPU, checks its SHA-256 checksum, and installs it with `apt`, `dnf`, `zypper`, or `pacman`. It requests `sudo` when needed. It leaves PAM configuration and service activation to you. @@ -19,22 +19,22 @@ The installer resolves the latest release, chooses the native package for your d Prefer to review the script first? ```sh -curl -fsSLo install-syauth.sh https://dmytrogajewski.github.io/syauth/install.sh +curl -fsSLo install-syauth.sh https://mewplane.github.io/syauth/install.sh less install-syauth.sh sh install-syauth.sh --dry-run sh install-syauth.sh ``` -Release downloads include DEB, RPM, Arch Linux packages, and manual Linux archives for x86_64 and ARM64, plus a signed [Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), source archive, signing certificate, build metadata, and `SHA256SUMS`. See [installation and verification](https://dmytrogajewski.github.io/syauth/how-to/install/) for direct package commands and version-pinned downloads. +Release downloads include DEB, RPM, Arch Linux packages, and manual Linux archives for x86_64 and ARM64, plus a signed [Android APK](https://github.com/Mewplane/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), source archive, signing certificate, build metadata, and `SHA256SUMS`. See [installation and verification](https://mewplane.github.io/syauth/how-to/install/) for direct package commands and version-pinned downloads. Use Debian 12+, Ubuntu 24.04+, a current Fedora/openSUSE/Arch installation, or a compatible derivative, with glibc 2.36+, PAM, systemd user services, BlueZ, and a BLE adapter capable of advertising. The phone needs Android 13+ with a supported Ed25519 Keystore implementation and an enrolled strong biometric. The APK can install on older Android versions, but that does not establish signing-key support. ## Use 1. Install the desktop package and signed Android companion. -2. Follow [storage and user-service setup](https://dmytrogajewski.github.io/syauth/how-to/install/#prepare-storage-and-the-user-service). +2. Follow [storage and user-service setup](https://mewplane.github.io/syauth/how-to/install/#prepare-storage-and-the-user-service). 3. Run `syauth pair`, complete numeric comparison on both devices, and confirm the bond with `syauth list`. -4. Read the [PAM policy reference](https://dmytrogajewski.github.io/syauth/reference/configuration/#pam-policy), configure one service, and complete [your first unlock](https://dmytrogajewski.github.io/syauth/tutorials/first-unlock/). +4. Read the [PAM policy reference](https://mewplane.github.io/syauth/reference/configuration/#pam-policy), configure one service, and complete [your first unlock](https://mewplane.github.io/syauth/tutorials/first-unlock/). ```sh syauth pair @@ -42,15 +42,15 @@ syauth list syauth doctor ``` -Being nearby prepares the connection; each authentication still needs explicit approval and a strong biometric. Keep the existing recovery method available while configuring PAM. The [security guide](https://dmytrogajewski.github.io/syauth/explanation/security/) describes the current implementation's differences from the design specification, including bond derivation and desktop key storage. +Being nearby prepares the connection; each authentication still needs explicit approval and a strong biometric. Keep the existing recovery method available while configuring PAM. The [security guide](https://mewplane.github.io/syauth/explanation/security/) describes the current implementation's differences from the design specification, including bond derivation and desktop key storage. ## Documentation -- [First unlock tutorial](https://dmytrogajewski.github.io/syauth/tutorials/first-unlock/) -- [Install](https://dmytrogajewski.github.io/syauth/how-to/install/), [pair and revoke](https://dmytrogajewski.github.io/syauth/how-to/pair-and-revoke/), [troubleshoot](https://dmytrogajewski.github.io/syauth/how-to/troubleshoot/) -- [CLI](https://dmytrogajewski.github.io/syauth/reference/cli/), [configuration](https://dmytrogajewski.github.io/syauth/reference/configuration/), [protocol](https://dmytrogajewski.github.io/syauth/reference/protocol/) -- [Illustrated mechanics](https://dmytrogajewski.github.io/syauth/explanation/mechanics/) with animated pairing, discovery, and unlock -- [Release builds and signing](https://dmytrogajewski.github.io/syauth/contributing/releases/) +- [First unlock tutorial](https://mewplane.github.io/syauth/tutorials/first-unlock/) +- [Install](https://mewplane.github.io/syauth/how-to/install/), [pair and revoke](https://mewplane.github.io/syauth/how-to/pair-and-revoke/), [troubleshoot](https://mewplane.github.io/syauth/how-to/troubleshoot/) +- [CLI](https://mewplane.github.io/syauth/reference/cli/), [configuration](https://mewplane.github.io/syauth/reference/configuration/), [protocol](https://mewplane.github.io/syauth/reference/protocol/) +- [Illustrated mechanics](https://mewplane.github.io/syauth/explanation/mechanics/) with animated pairing, discovery, and unlock +- [Release builds and signing](https://mewplane.github.io/syauth/contributing/releases/) ## Development and contributing @@ -64,7 +64,7 @@ python3 -m unittest discover -s tests -p 'test_release_*.py' python3 -m unittest discover -s tests -p test_installer.py ``` -See [documentation development](docs/contributing/documentation.md), [release development](docs/contributing/releases.md), and [AGENTS.md](AGENTS.md) for contributor contracts. Open an [issue](https://github.com/dmytrogajewski/syauth/issues) with reproduction steps and sanitized diagnostics, or a pull request with the user-visible change and relevant test evidence. Avoid posting bond files, private keys, or unreviewed logs. +See [documentation development](docs/contributing/documentation.md), [release development](docs/contributing/releases.md), and [AGENTS.md](AGENTS.md) for contributor contracts. Open an [issue](https://github.com/Mewplane/syauth/issues) with reproduction steps and sanitized diagnostics, or a pull request with the user-visible change and relevant test evidence. Avoid posting bond files, private keys, or unreviewed logs. ## Maintainers diff --git a/deploy/release-notes.md b/deploy/release-notes.md index 1b47f74..00a56d2 100644 --- a/deploy/release-notes.md +++ b/deploy/release-notes.md @@ -19,8 +19,8 @@ Approve Linux authentication on Android with a fresh strong biometric. - Native desktop DEB, RPM, and Arch packages and Linux archives for x86_64 and ARM64. - Signed Android companion with four native ABIs and a published signing certificate. -- Illustrated documentation: https://dmytrogajewski.github.io/syauth/ -- Installer: `curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh` +- Illustrated documentation: https://mewplane.github.io/syauth/ +- Installer: `curl -fsSL https://mewplane.github.io/syauth/install.sh | sh` Packages install the CLI, PAM module, presence daemon, and user service. They do not enable PAM or start the service automatically. Follow the installation guide to prepare storage, pair the phone, select a PAM policy, and test your recovery method. @@ -28,4 +28,4 @@ Linux requires glibc 2.36+; supported package paths include Debian 12+, Ubuntu 2 Verify downloads against `SHA256SUMS`. `release.json` records the source commit and artifact digests. The Android release certificate SHA-256 fingerprint is `25:58:5E:64:1E:DB:3D:A8:7B:98:90:56:B3:D1:65:CA:C2:AF:AF:2A:AE:DD:35:87:56:66:B5:21:EC:C0:22:1C`. -Read the documented security boundaries before enabling PAM: https://dmytrogajewski.github.io/syauth/explanation/security/ +Read the documented security boundaries before enabling PAM: https://mewplane.github.io/syauth/explanation/security/ diff --git a/docs/contributing/documentation.md b/docs/contributing/documentation.md index 16b2396..9b287dd 100644 --- a/docs/contributing/documentation.md +++ b/docs/contributing/documentation.md @@ -22,7 +22,7 @@ target/docs-venv/bin/python -m playwright install chromium target/docs-venv/bin/python scripts/docs-check.py ``` -The generated site lives in `target/docs-site/`, outside the source tree. Linux environments may need Playwright's browser system dependencies; its installer reports missing libraries. CI builds and checks pull requests. On `master`, the workflow copies the shell installer to the site root and deploys the checked output to [GitHub Pages](https://dmytrogajewski.github.io/syauth/). Running the preview or checks locally does not publish a site. +The generated site lives in `target/docs-site/`, outside the source tree. Linux environments may need Playwright's browser system dependencies; its installer reports missing libraries. CI builds and checks pull requests. On `master`, the workflow copies the shell installer to the site root and deploys the checked output to [GitHub Pages](https://mewplane.github.io/syauth/). Running the preview or checks locally does not publish a site. ## Choose the right page diff --git a/docs/contributing/releases.md b/docs/contributing/releases.md index 38e10cc..8797d8d 100644 --- a/docs/contributing/releases.md +++ b/docs/contributing/releases.md @@ -1,10 +1,10 @@ # Build and publish a release -The [release workflow](https://github.com/dmytrogajewski/syauth/actions/workflows/release.yml) builds native Linux packages and a signed Android APK from the same source revision. Pushes to `release/**` branches and manual workflow runs validate and upload artifacts without creating a public release. A `vMAJOR.MINOR.PATCH` tag publishes after every build and package-install check passes. +The [release workflow](https://github.com/Mewplane/syauth/actions/workflows/release.yml) builds native Linux packages and a signed Android APK from the same source revision. Pushes to `release/**` branches and manual workflow runs validate and upload artifacts without creating a public release. A `vMAJOR.MINOR.PATCH` tag publishes after every build and package-install check passes. ## Artifact contract -For version `0.2.0`, [GitHub Releases](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) contains: +For version `0.2.0`, [GitHub Releases](https://github.com/Mewplane/syauth/releases/tag/v0.2.0) contains: | Artifact | Consumer | | --- | --- | @@ -62,4 +62,4 @@ The public release certificate's SHA-256 fingerprint is: 4. The workflow publishes only after both Linux architectures, signed Android output, and the package-install matrix pass. `release.json` records the source revision. The publishing job verifies all checksums again. 5. Download the published artifacts, verify `SHA256SUMS` and the APK certificate, and check the live Pages installation guide and installer. -The release workflow has write access only in its publishing job. Documentation checks run on pull requests; the Pages deployment job runs only from `master`, with Pages and OIDC permissions. Its deployment URL is [the documentation site](https://dmytrogajewski.github.io/syauth/), also shown in the repository's website field. +The release workflow has write access only in its publishing job. Documentation checks run on pull requests; the Pages deployment job runs only from `master`, with Pages and OIDC permissions. Its deployment URL is [the documentation site](https://mewplane.github.io/syauth/), also shown in the repository's website field. diff --git a/docs/explanation/mechanics.md b/docs/explanation/mechanics.md index 6237671..a375a17 100644 --- a/docs/explanation/mechanics.md +++ b/docs/explanation/mechanics.md @@ -34,7 +34,7 @@ The long-running daemon keeps radio state outside the synchronous PAM call. PAM The private signing key remains behind its Android Keystore alias. The public-key derivation in step 4 does not create a secret unknown to anyone who knows those public keys. The application confirmation is useful for checking the exchanged identities, but is not a substitute for a confidential key exchange. See [the security boundaries](security.md#implementation-and-design). -Implementation anchors: [bond derivation](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-core/src/bond.rs), [phone exchange wiring](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/pair/impl/RealPairBackendWiring.kt), [Keystore key generation](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/pair/impl/KeystoreKeyGenerator.kt). +Implementation anchors: [bond derivation](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-core/src/bond.rs), [phone exchange wiring](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/pair/impl/RealPairBackendWiring.kt), [Keystore key generation](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/pair/impl/KeystoreKeyGenerator.kt). ## Discovery: prepare the channel @@ -52,7 +52,7 @@ The UUID is a matching mechanism, not proof of distance or authorization. Someon When the radio disconnects, Android retries setup through service discovery and subscription. The desktop discards a closed notifier while keeping its GATT application registered for re-subscription. OS scheduling, Doze, adapter behavior, and manufacturer restrictions affect recovery; a successful radio toggle is not evidence for all range-loss cases. -Implementation anchors: [session UUID derivation](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-transport/src/bluez.rs), [phone scan slots](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/BleScanController.kt), [persistent phone connection](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/PersistentGattClient.kt), [notification lifecycle](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-transport/src/peripheral/notification.rs). +Implementation anchors: [session UUID derivation](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-transport/src/bluez.rs), [phone scan slots](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/BleScanController.kt), [persistent phone connection](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/PersistentGattClient.kt), [notification lifecycle](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-transport/src/peripheral/notification.rs). ## Unlock: a fresh signature for each request @@ -69,7 +69,7 @@ A captured signature covers one particular challenge body. Changing its nonce ch The active phone callbacks do not call the core MAC verifier before showing the prompt. The active PAM handler trusts the daemon's reason rather than verifying the response itself. These boundaries are material to the [security model](security.md), even though the common happy-path animation ends with verification success. -Implementation anchors: [PAM authentication](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-pam/src/auth.rs), [daemon state machine](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [phone callback](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/SyauthCompanionService.kt), [approval and signing](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/ChallengeApprovalActivity.kt). +Implementation anchors: [PAM authentication](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-pam/src/auth.rs), [daemon state machine](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [phone callback](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/SyauthCompanionService.kt), [approval and signing](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/ChallengeApprovalActivity.kt). ## When the happy path stops diff --git a/docs/explanation/security.md b/docs/explanation/security.md index 9e563c0..5e49bff 100644 --- a/docs/explanation/security.md +++ b/docs/explanation/security.md @@ -24,7 +24,7 @@ The phone requests a Keystore signing key with per-use strong biometric authenti | Socket peer check | Socket mode `0600` inside the user's runtime directory; unexpected peer credentials are warned about but accepted | Filesystem access control is the active barrier; do not claim strict UID rejection | | Expiry and cancellation | Desktop deadline without authenticated phone cancellation | A stale prompt may remain after the caller has stopped waiting | -These are existing mismatches and limitations; the documentation work does not approve a SPEC deviation or change any production behavior. The historical [known-gaps ledger](https://github.com/dmytrogajewski/syauth/blob/master/docs/known-gaps.md) and [design specification](https://github.com/dmytrogajewski/syauth/blob/master/specs/syauth/SPEC.md) provide design context, not proof that every property is present in the runtime path. +These are existing mismatches and limitations; the documentation work does not approve a SPEC deviation or change any production behavior. The historical [known-gaps ledger](https://github.com/Mewplane/syauth/blob/master/docs/known-gaps.md) and [design specification](https://github.com/Mewplane/syauth/blob/master/specs/syauth/SPEC.md) provide design context, not proof that every property is present in the runtime path. ## Relay and unwanted approval @@ -44,6 +44,6 @@ Keep desktop key files private and do not copy them into logs or issue reports. If you lose a phone, [revoke its application bond](../how-to/pair-and-revoke.md#revoke-a-phone) and remove the OS association when possible. Revoked records are retained for history and excluded from active daemon peers. -Source: [public-input bond derivation](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-core/src/bond.rs), [challenge verification](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [socket admission](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/server.rs), [PAM handler](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-pam/src/auth.rs), [Android challenge callback](https://github.com/dmytrogajewski/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/SyauthCompanionService.kt). +Source: [public-input bond derivation](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-core/src/bond.rs), [challenge verification](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [socket admission](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/server.rs), [PAM handler](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-pam/src/auth.rs), [Android challenge callback](https://github.com/Mewplane/syauth/blob/648375e/syauth-android/app/src/main/kotlin/com/sy/syauth/android/bg/SyauthCompanionService.kt). diff --git a/docs/how-to/install.md b/docs/how-to/install.md index 823f6d8..1772428 100644 --- a/docs/how-to/install.md +++ b/docs/how-to/install.md @@ -15,7 +15,7 @@ Before enabling PAM, read [security boundaries](../explanation/security.md). Kee Install the latest release with your native package manager: ```sh -curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh +curl -fsSL https://mewplane.github.io/syauth/install.sh | sh ``` The POSIX shell installer reads your distribution and architecture, resolves one GitHub release tag, downloads that tag's package and `SHA256SUMS`, checks the exact package digest, then invokes `apt`, `dnf`, `zypper`, or `pacman`. It requests `sudo` when necessary. An unsupported system or checksum mismatch stops installation. It does not change PAM stacks, enable services, or change existing bond ownership. @@ -23,7 +23,7 @@ The POSIX shell installer reads your distribution and architecture, resolves one To inspect the script, select a version, or preview package selection: ```sh -curl -fsSLo install-syauth.sh https://dmytrogajewski.github.io/syauth/install.sh +curl -fsSLo install-syauth.sh https://mewplane.github.io/syauth/install.sh less install-syauth.sh sh install-syauth.sh --version 0.2.0 --dry-run sh install-syauth.sh --version 0.2.0 @@ -31,10 +31,10 @@ sh install-syauth.sh --version 0.2.0 ### Direct downloads -The [v0.2.0 release](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) has the native packages, manual archives, source, signed APK, and checksums. For example, on Debian/Ubuntu x86_64: +The [v0.2.0 release](https://github.com/Mewplane/syauth/releases/tag/v0.2.0) has the native packages, manual archives, source, signed APK, and checksums. For example, on Debian/Ubuntu x86_64: ```sh -release=https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0 +release=https://github.com/Mewplane/syauth/releases/download/v0.2.0 curl -fSLO "$release/syauth_0.2.0_amd64.deb" curl -fSLO "$release/SHA256SUMS" sha256sum --check --ignore-missing SHA256SUMS @@ -112,7 +112,7 @@ The `--dry-run` command **writes the unit file** but skips the binary copy and ` ## Install the Android app -Download the [signed Android APK](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk) and [SHA256SUMS](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/SHA256SUMS). Verify the downloaded file before opening it on your phone, or install it with ADB: +Download the [signed Android APK](https://github.com/Mewplane/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk) and [SHA256SUMS](https://github.com/Mewplane/syauth/releases/download/v0.2.0/SHA256SUMS). Verify the downloaded file before opening it on your phone, or install it with ADB: ```sh sha256sum --check --ignore-missing SHA256SUMS diff --git a/docs/how-to/troubleshoot.md b/docs/how-to/troubleshoot.md index 9576bd0..3c2f8fa 100644 --- a/docs/how-to/troubleshoot.md +++ b/docs/how-to/troubleshoot.md @@ -66,7 +66,7 @@ Use the actual service name. This restores its `.bak` snapshot, including the sn Include the CLI and APK versions, distribution, BlueZ version, phone model and Android version, the action that triggered the problem, and sanitized logs from both sides. Distinguish a radio-off/on test from physical range loss or Doze: success in one does not establish recovery in the others. -The [repository Bluetooth guide](https://github.com/dmytrogajewski/syauth/blob/master/docs/bluetooth.md) includes the emulator harness and its qualifications. Arch Linux KDE users can also consult the optional [package update checker](https://github.com/dmytrogajewski/syauth/blob/master/docs/arch-update-check.md). +The [repository Bluetooth guide](https://github.com/Mewplane/syauth/blob/master/docs/bluetooth.md) includes the emulator harness and its qualifications. Arch Linux KDE users can also consult the optional [package update checker](https://github.com/Mewplane/syauth/blob/master/docs/arch-update-check.md). diff --git a/docs/index.md b/docs/index.md index 9980d25..3e5f57f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -14,14 +14,14 @@ Approve Linux authentication on your Android phone. syauth carries a fresh chall [Set up syauth](how-to/install.md){ .md-button .md-button--primary } [See the mechanics](explanation/mechanics.md){ .md-button } -[Download a release](https://github.com/dmytrogajewski/syauth/releases/latest){ .md-button } +[Download a release](https://github.com/Mewplane/syauth/releases/latest){ .md-button } ## Install the release -Install the desktop with `curl -fsSL https://dmytrogajewski.github.io/syauth/install.sh | sh`, then follow [installation and setup](how-to/install.md). The [published v0.2.0 assets](https://github.com/dmytrogajewski/syauth/releases/tag/v0.2.0) include DEB/RPM/Arch packages for both CPU architectures, the [signed Android companion](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), and [checksums](https://github.com/dmytrogajewski/syauth/releases/download/v0.2.0/SHA256SUMS). +Install the desktop with `curl -fsSL https://mewplane.github.io/syauth/install.sh | sh`, then follow [installation and setup](how-to/install.md). The [published v0.2.0 assets](https://github.com/Mewplane/syauth/releases/tag/v0.2.0) include DEB/RPM/Arch packages for both CPU architectures, the [signed Android companion](https://github.com/Mewplane/syauth/releases/download/v0.2.0/syauth-0.2.0-android.apk), and [checksums](https://github.com/Mewplane/syauth/releases/download/v0.2.0/SHA256SUMS). ## Follow one unlock @@ -65,4 +65,4 @@ Use Android 13 or later with a supported Ed25519 Android Keystore implementation These pages describe the implementation, including its limitations. In particular, the current bond derivation is not the hybrid key exchange described in the design specification, and the desktop stores application bond material in files. Read [the implementation boundaries](explanation/security.md#implementation-and-design) before enabling PAM. -[Source code](https://github.com/dmytrogajewski/syauth) · [Report a problem](https://github.com/dmytrogajewski/syauth/issues) · [Build these docs](contributing/documentation.md) +[Source code](https://github.com/Mewplane/syauth) · [Report a problem](https://github.com/Mewplane/syauth/issues) · [Build these docs](contributing/documentation.md) diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 33f42ef..0bf4a02 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -57,6 +57,6 @@ syauth doctor --json systemctl --user status syauth-presenced --no-pager ``` -Source: [CLI dispatch](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-cli/src/main.rs), [PAM installer](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-cli/src/install_pam.rs), [daemon options](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/main.rs). +Source: [CLI dispatch](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-cli/src/main.rs), [PAM installer](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-cli/src/install_pam.rs), [daemon options](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/main.rs). diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index 49a8d9b..f6a04e0 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -73,6 +73,6 @@ The syauth module returns success, authentication error, or authentication-infor The shipped unit restarts on failure and restricts filesystem writes to its configured paths. If you override data paths, review the unit's `ReadWritePaths` too. Its user-session lifetime also matters for authentication before login: a stopped user service cannot answer requests. -Source: [PAM configuration](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-pam/src/config.rs), [orchestrator limits](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [user unit](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/dist/syauth-presenced.service). +Source: [PAM configuration](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-pam/src/config.rs), [orchestrator limits](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [user unit](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/dist/syauth-presenced.service). diff --git a/docs/reference/protocol.md b/docs/reference/protocol.md index 2999091..f7070b8 100644 --- a/docs/reference/protocol.md +++ b/docs/reference/protocol.md @@ -86,6 +86,6 @@ Two details matter when integrating: `denied` exists in the RPC taxonomy; the current phone Cancel wire value follows the `bad-signature` path. Socket or decoding failure also maps to unavailable. The surrounding PAM stack controls fallback and final access. -Source: [UUIDs and session derivation](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-transport/src/bluez.rs), [frame layout](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-core/src/frame.rs), [challenge state machine](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [RPC types](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-presenced/src/rpc.rs), [PAM mapping](https://github.com/dmytrogajewski/syauth/blob/648375e/crates/syauth-pam/src/auth.rs). +Source: [UUIDs and session derivation](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-transport/src/bluez.rs), [frame layout](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-core/src/frame.rs), [challenge state machine](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/orchestrator.rs), [RPC types](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-presenced/src/rpc.rs), [PAM mapping](https://github.com/Mewplane/syauth/blob/648375e/crates/syauth-pam/src/auth.rs). diff --git a/docs/release-process.md b/docs/release-process.md index d9ea7c1..2895036 100644 --- a/docs/release-process.md +++ b/docs/release-process.md @@ -1,7 +1,7 @@ # Release process -The maintained release handbook is [Build and publish a release](contributing/releases.md), published on [GitHub Pages](https://dmytrogajewski.github.io/syauth/contributing/releases/). +The maintained release handbook is [Build and publish a release](contributing/releases.md), published on [GitHub Pages](https://mewplane.github.io/syauth/contributing/releases/). It describes the Debian 12 Linux build baseline, DEB/RPM/Arch packaging, the container installation matrix, persistent Android signing, checksum and source metadata, and tag-triggered publication. The canonical pipeline is `.github/workflows/release.yml`; older mock/pbuilder Makefile targets are not used for release publication. -For installing published artifacts, follow [the installation guide](how-to/install.md). Downloads are attached to [GitHub Releases](https://github.com/dmytrogajewski/syauth/releases/latest). +For installing published artifacts, follow [the installation guide](how-to/install.md). Downloads are attached to [GitHub Releases](https://github.com/Mewplane/syauth/releases/latest). diff --git a/mkdocs.yml b/mkdocs.yml index 3de62da..c74df6b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,5 +1,5 @@ site_name: syauth -site_url: https://dmytrogajewski.github.io/syauth/ +site_url: https://mewplane.github.io/syauth/ site_description: Understand and operate phone-approved Linux authentication. docs_dir: docs site_dir: target/docs-site @@ -46,7 +46,7 @@ extra: generator: false social: - icon: fontawesome/brands/github - link: https://github.com/dmytrogajewski/syauth + link: https://github.com/Mewplane/syauth name: syauth on GitHub nav: - Start here: index.md diff --git a/scripts/build-linux-packages.py b/scripts/build-linux-packages.py index 45d0877..0570da2 100755 --- a/scripts/build-linux-packages.py +++ b/scripts/build-linux-packages.py @@ -48,7 +48,7 @@ def package_config(version, arch, kind, binaries): "release": "4" if kind == "rpm" else "1", "section": "admin", "priority": "optional", "maintainer": "syauth contributors ", "description": "Phone-as-key PAM authenticator with a per-user presence daemon.", - "homepage": "https://github.com/dmytrogajewski/syauth", "license": "MIT", + "homepage": "https://github.com/Mewplane/syauth", "license": "MIT", "depends": dependencies[kind], "contents": contents, "scripts": {"postinstall": str(ROOT / "deploy/packages/postinstall.sh")}, } diff --git a/scripts/install.sh b/scripts/install.sh index 7d5dbce..1931b3d 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -37,7 +37,7 @@ case "$distro" in fedora) manager=dnf; format=rpm;; opensuse-tumbleweed|opensuse-leap|opensuse) manager=zypper; format=rpm;; arch|endeavouros|manjaro) manager=pacman; format=arch;; - *) fail "Unsupported distribution: $distro. See https://dmytrogajewski.github.io/syauth/how-to/install/";; + *) fail "Unsupported distribution: $distro. See https://mewplane.github.io/syauth/how-to/install/";; esac command -v "$manager" >/dev/null 2>&1 || fail "Native package manager missing: $manager" work=$(mktemp -d "${TMPDIR:-/tmp}/syauth-install.XXXXXXXX") @@ -45,8 +45,8 @@ trap 'rm -rf "$work"' EXIT trap 'exit 130' INT trap 'exit 143' TERM fetch() { curl --fail --silent --show-error --location --proto '=https' --proto-redir '=https' --connect-timeout 15 --max-time 180 --retry 3 --output "$2" "$1"; } -repo=https://github.com/dmytrogajewski/syauth -api=https://api.github.com/repos/dmytrogajewski/syauth/releases +repo=https://github.com/Mewplane/syauth +api=https://api.github.com/repos/Mewplane/syauth/releases if [ -n "$version" ]; then endpoint=$api/tags/v$version else @@ -86,4 +86,4 @@ case "$manager" in zypper) run_root zypper --non-interactive install --allow-unsigned-rpm "$work/$asset";; pacman) run_root pacman -U --noconfirm "$work/$asset";; esac -printf '%s\n' 'Installed. PAM configuration is unchanged. Follow https://dmytrogajewski.github.io/syauth/tutorials/first-unlock/ to pair your phone and enable the user service.' +printf '%s\n' 'Installed. PAM configuration is unchanged. Follow https://mewplane.github.io/syauth/tutorials/first-unlock/ to pair your phone and enable the user service.' diff --git a/specs/bugs/BUG-20261107-1537.md b/specs/bugs/BUG-20261107-1537.md new file mode 100644 index 0000000..030ac14 --- /dev/null +++ b/specs/bugs/BUG-20261107-1537.md @@ -0,0 +1,38 @@ +# Release installation links still point to the former repository owner + +## Summary + +The installer command and installation guide return HTTP 404 after the +repository moved to Mewplane. + +## Reproduction + +HEAD requests to `https://dmytrogajewski.github.io/syauth/install.sh` and +`https://dmytrogajewski.github.io/syauth/how-to/install/` return 404. +GitHub Pages reports `https://mewplane.github.io/syauth/` as the deployment URL, +and its installer returns 200. The new installer owner regression fails on +the former API repository path. + +## Expected + +Release instructions reach the published installer and current repository. + +## Actual + +The documented installer and guide are unavailable at their former addresses. + +## Root Cause + +Published URLs retained the former GitHub owner after the repository transfer. + +## Fix + +Use the current Pages address, release/API repository, package homepage, and +documentation source links. Keep the existing package verification and approval +requirements. + +## Traceability + +`tests/test_installer.py::InstallerTests::test_downloads_and_guidance_use_the_current_repository_owner` +checks the API lookup, download origin, and final setup guidance through the +real shell installer. It failed before updating those addresses. diff --git a/tests/test_installer.py b/tests/test_installer.py index d8d9561..5446c15 100644 --- a/tests/test_installer.py +++ b/tests/test_installer.py @@ -65,6 +65,15 @@ def run_installer(self, *args): return subprocess.run(["sh", str(REPO / "scripts/install.sh"), *args], env=self.env, text=True, capture_output=True) + def test_downloads_and_guidance_use_the_current_repository_owner(self): + result = self.run_installer("--dry-run") + self.assertEqual(result.returncode, 0, result.stderr) + urls = self.requests.read_text().splitlines() + self.assertEqual(urls[0], "https://api.github.com/repos/Mewplane/syauth/releases/latest") + self.assertTrue(all(url.startswith("https://github.com/Mewplane/syauth/") for url in urls[1:])) + result = self.run_installer() + self.assertIn("https://mewplane.github.io/syauth/tutorials/first-unlock/", result.stdout) + def test_latest_is_resolved_once_and_verified_before_apt(self): result = self.run_installer() self.assertEqual(result.returncode, 0, result.stderr) From abf301a7415533735ec66e4e319535a3a33aa587 Mon Sep 17 00:00:00 2001 From: Dmitriy Date: Sat, 7 Nov 2026 15:43:38 +0300 Subject: [PATCH 3/3] fix(release): identify the current source repository in package metadata --- Cargo.toml | 2 +- deploy/debian/control | 6 +++--- deploy/debian/copyright | 2 +- deploy/fedora/syauth.spec | 2 +- scripts/release-metadata.py | 2 +- tests/test_release_metadata.py | 1 + 6 files changed, 8 insertions(+), 7 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 6285c00..38f8d76 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -27,7 +27,7 @@ edition = "2024" rust-version = "1.85" license = "MIT" authors = ["syauth contributors"] -repository = "https://github.com/sy/syauth" +repository = "https://github.com/Mewplane/syauth" [workspace.lints.rust] unsafe_code = "deny" diff --git a/deploy/debian/control b/deploy/debian/control index 2c7cb7d..9f2184e 100644 --- a/deploy/debian/control +++ b/deploy/debian/control @@ -13,9 +13,9 @@ Build-Depends: debhelper-compat (= 13), dbus-daemon, gzip Standards-Version: 4.6.2 -Homepage: https://github.com/sy/syauth -Vcs-Browser: https://github.com/sy/syauth -Vcs-Git: https://github.com/sy/syauth.git +Homepage: https://github.com/Mewplane/syauth +Vcs-Browser: https://github.com/Mewplane/syauth +Vcs-Git: https://github.com/Mewplane/syauth.git Rules-Requires-Root: no Package: syauth diff --git a/deploy/debian/copyright b/deploy/debian/copyright index 89eabd9..4b4b0c4 100644 --- a/deploy/debian/copyright +++ b/deploy/debian/copyright @@ -1,7 +1,7 @@ Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: syauth Upstream-Contact: syauth contributors -Source: https://github.com/sy/syauth +Source: https://github.com/Mewplane/syauth Files: * Copyright: 2026 syauth contributors diff --git a/deploy/fedora/syauth.spec b/deploy/fedora/syauth.spec index 2e25695..14783d2 100644 --- a/deploy/fedora/syauth.spec +++ b/deploy/fedora/syauth.spec @@ -23,7 +23,7 @@ Release: %{rpm_release}%{?dist} Summary: Phone-as-key PAM authenticator for Linux License: MIT -URL: https://github.com/sy/syauth +URL: https://github.com/Mewplane/syauth Source0: %{name}-%{version}.tar.gz # Cross-reference: deploy/version.env, /Cargo.toml [workspace.package]. diff --git a/scripts/release-metadata.py b/scripts/release-metadata.py index a46dbed..ffc2543 100644 --- a/scripts/release-metadata.py +++ b/scripts/release-metadata.py @@ -35,7 +35,7 @@ def prepare(directory, version, revision): artifacts.append({"name": path.name, "sha256": hashlib.sha256(path.read_bytes()).hexdigest(), "size": path.stat().st_size}) manifest = {"version": version, "tag": "v" + version, "source_revision": revision, - "repository": "dmytrogajewski/syauth", "linux_glibc_minimum": "2.36", + "repository": "Mewplane/syauth", "linux_glibc_minimum": "2.36", "artifacts": artifacts} (directory / "release.json").write_text(json.dumps(manifest, indent=2) + "\n") artifacts.append({"name": "release.json", "sha256": hashlib.sha256((directory / "release.json").read_bytes()).hexdigest()}) diff --git a/tests/test_release_metadata.py b/tests/test_release_metadata.py index ae3ce80..20d1cf0 100644 --- a/tests/test_release_metadata.py +++ b/tests/test_release_metadata.py @@ -31,6 +31,7 @@ def test_complete_release_checksums_cover_exact_bytes_and_source(self): module.prepare(directory, "0.1.0", "a" * 40) manifest = json.loads((directory / "release.json").read_text()) self.assertEqual(manifest["source_revision"], "a" * 40) + self.assertEqual(manifest["repository"], "Mewplane/syauth") lines = (directory / "SHA256SUMS").read_text().splitlines() self.assertEqual(len(lines), len(module.required_artifacts("0.1.0")) + 1) for line in lines: