From 43eddc7fc1b9c96542d31af7af6097b695074da6 Mon Sep 17 00:00:00 2001 From: sandwich Date: Fri, 4 Sep 2026 14:56:00 +0200 Subject: [PATCH] Keep root-level docs deployments verifiable Treat a present but empty Bunny remote prefix as the storage-zone root while preserving the error for an omitted option value. This lets the live smoke test verify the same root deployment that the uploader and manifest already accept. Align the install matrix with the now-live installer and direct-download release artifacts so the deployment status is not documented as blocked. Constraint: An empty BUNNY_REMOTE_PREFIX intentionally denotes the storage root Rejected: Omit --remote-prefix in the workflow | would leave the CLI contract inconsistent across configured values Confidence: high Scope-risk: narrow Reversibility: clean Directive: Preserve the distinction between an empty value and a missing argument Tested: Live loopwire.app smoke, installer hash comparison, empty-prefix regression, omitted-value rejection, docs and script verification Not-tested: Non-root Bunny prefix in the live production zone Related: #30 --- apps/docs/docs/guide/install.md | 19 +++++++++---------- apps/docs/docs/guide/support-matrix.md | 8 ++++---- apps/docs/docs/release-notes/unreleased.md | 5 +++++ scripts/verify-docs-live.sh | 3 ++- scripts/verify-scripts.sh | 15 +++++++++++++++ 5 files changed, 35 insertions(+), 15 deletions(-) diff --git a/apps/docs/docs/guide/install.md b/apps/docs/docs/guide/install.md index 9d53906..9a2d32a 100644 --- a/apps/docs/docs/guide/install.md +++ b/apps/docs/docs/guide/install.md @@ -26,18 +26,16 @@ pnpm install pnpm check ``` -## Planned Release Installer +## Signed Release Installer -The release installer is scaffolded and locally smoke-tested in `scripts/install.sh`. Once signed release artifacts -exist, the public entry point will follow this shape: +The public installer is deployed from `scripts/install.sh` and installs the signed `v0.1.0` release artifacts: ```bash curl -fsSL https://loopwire.app/install.sh | bash ``` -The VitePress public asset is a byte-for-byte copy of `scripts/install.sh`, and the combined Astro + VitePress build -also copies that installer to the site root at `/install.sh`. It is not a release claim until signed GitHub Release -assets, `SHA256SUMS`, `SHA256SUMS.sig`, and the release public key exist. +The VitePress public asset and live `/install.sh` are byte-for-byte copies of `scripts/install.sh`. The installer +requires the published `SHA256SUMS`, `SHA256SUMS.sig`, and release public key before extracting an artifact. The installer must detect OS and architecture, download a release artifact, verify signed checksums, and avoid persistent system changes unless the user explicitly opts in. @@ -104,16 +102,17 @@ Run the metadata smoke: pnpm verify:packaging ``` -The native package recipes are verified but are not yet a public install channel. Their matching-guest proof command -boots official, checksum-pinned cloud images under KVM and stores local evidence without changing host audio: +The AppImages and native deb/RPM files are published as direct downloads on the `v0.1.0` GitHub Release. They are not +yet served through an APT, DNF/COPR, or OBS repository. Their matching-guest proof command boots official, +checksum-pinned cloud images under KVM and stores local evidence without changing host audio: ```bash pnpm vm:native-packages -- run-all --version 0.1.0 --release-dir .vm/native-packages/release ``` See `packaging/README.md` for release-tarball creation, host prerequisites, exact target names, and evidence paths. -The review-safe proof snapshot for commit `70eee4e` is under `vm/native-package-proof/`; package publication remains -blocked until the tagged release ceremony succeeds. +The review-safe proof snapshot for commit `70eee4e` is under `vm/native-package-proof/`; it backs the published +direct-download native packages without claiming that a distro package repository exists. After signed release artifacts exist, render the concrete Nix package expression from the published checksum manifest: diff --git a/apps/docs/docs/guide/support-matrix.md b/apps/docs/docs/guide/support-matrix.md index bddca66..5263743 100644 --- a/apps/docs/docs/guide/support-matrix.md +++ b/apps/docs/docs/guide/support-matrix.md @@ -68,10 +68,10 @@ the Tauri shell command bridge. | Channel | Current validation | Public status | |---------|--------------------|---------------| | Source checkout | `pnpm check` | Supported for contributors. | -| Signed curl installer | `pnpm verify:install`, `pnpm verify:release` | Blocked on tagged artifacts and public key. | -| AppImage | Local Tauri bundle smoke | Blocked on release publishing. | -| Ubuntu 24.04 / Debian 13 deb | Verified in matching KVM guests at commit `70eee4e`; review snapshot in `vm/native-package-proof/` | Blocked on release publishing. | -| Fedora 44 / openSUSE Tumbleweed RPM | Verified in matching KVM guests at commit `70eee4e`; review snapshot in `vm/native-package-proof/` | Blocked on release publishing. | +| Signed curl installer | Local verification plus live `/install.sh` byte comparison | Published for 0.1.0 at `loopwire.app`. | +| AppImage | Published-artifact and Tauri bundle smoke | Published for 0.1.0 on GitHub Releases. | +| Ubuntu 24.04 / Debian 13 deb | Verified in matching KVM guests at commit `70eee4e`; review snapshot in `vm/native-package-proof/` | Published as direct downloads; no APT repository. | +| Fedora 44 / openSUSE Tumbleweed RPM | Verified in matching KVM guests at commit `70eee4e`; review snapshot in `vm/native-package-proof/` | Published as direct downloads; no COPR/OBS repository. | | AUR `loopwire` | Tagged source build through `pnpm verify:aur:source` | Published for 0.1.0. | | AUR `loopwire-bin` | Signed release-artifact build through `pnpm verify:aur` | Published for 0.1.0. | | Nix flake package template | `pnpm verify:packaging` | Blocked on real release hashes and Nix build proof. | diff --git a/apps/docs/docs/release-notes/unreleased.md b/apps/docs/docs/release-notes/unreleased.md index 3dbbef8..f09ecce 100644 --- a/apps/docs/docs/release-notes/unreleased.md +++ b/apps/docs/docs/release-notes/unreleased.md @@ -2,6 +2,11 @@ These notes describe source-tree progress. They are not a public release announcement. +- Root-level Bunny deployments now pass the post-upload live-site check when `BUNNY_REMOTE_PREFIX` is intentionally + empty, while an omitted command argument remains an error. +- The signed installer is now live at `https://loopwire.app/install.sh`; AppImage, deb, and RPM artifacts are available + from the `v0.1.0` GitHub Release, with native files documented as direct downloads rather than distro repositories. + ## Packaging - The AUR now keeps two honest stable recipes: `loopwire` compiles the immutable tagged source archive, while diff --git a/scripts/verify-docs-live.sh b/scripts/verify-docs-live.sh index 06558be..83798d7 100644 --- a/scripts/verify-docs-live.sh +++ b/scripts/verify-docs-live.sh @@ -88,7 +88,8 @@ while [ "$#" -gt 0 ]; do shift 2 ;; --remote-prefix) - remote_prefix="${2:?missing value for --remote-prefix}" + [ "$#" -ge 2 ] || fail "missing value for --remote-prefix" + remote_prefix="$2" shift 2 ;; --expected-installer) diff --git a/scripts/verify-scripts.sh b/scripts/verify-scripts.sh index 09736ee..a62a77b 100755 --- a/scripts/verify-scripts.sh +++ b/scripts/verify-scripts.sh @@ -5449,6 +5449,21 @@ printf '%s\n' "$docs_live_output" | grep -F "Live docs smoke passed for https:// echo "verify-scripts: live docs smoke did not verify the expected pull-zone URL" >&2 exit 1 } +docs_live_root_output="$( + PATH="$docs_live_bin:$PATH" \ + LOOPWIRE_FAKE_INSTALLER="scripts/install.sh" \ + bash scripts/verify-docs-live.sh --hostname docs.example.test --remote-prefix "" +)" +printf '%s\n' "$docs_live_root_output" | grep -F "Live docs smoke passed for https://docs.example.test." >/dev/null || { + echo "verify-scripts: live docs smoke did not accept an explicit root prefix" >&2 + exit 1 +} +if PATH="$docs_live_bin:$PATH" \ + LOOPWIRE_FAKE_INSTALLER="scripts/install.sh" \ + bash scripts/verify-docs-live.sh --hostname docs.example.test --remote-prefix >/dev/null 2>&1; then + echo "verify-scripts: live docs smoke accepted an omitted remote-prefix value" >&2 + exit 1 +fi bad_live_installer="$tmp_dir/bad-live-install.sh" printf '%s\n' "#!/usr/bin/env bash" "echo stale" >"$bad_live_installer" if PATH="$docs_live_bin:$PATH" \