Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions apps/docs/docs/developer/release.md
Original file line number Diff line number Diff line change
Expand Up @@ -768,8 +768,8 @@ configured and readiness passes.

- The workflow now has a dedicated `ubuntu-22.04-arm` AArch64 lane, but public AArch64 proof still requires a tagged
workflow run and published `loopwire-linux-aarch64.tar.gz` asset.
- Package templates must not be published until a tagged release has real checksums and package-build smoke evidence
against those published artifacts.
- The default flake package is now bound to the signed `v0.1.0` tarball checksums. Fresh local non-skipped Nix build
proof only covers `x86_64-linux`; public `aarch64-linux` proof still requires its own Nix-enabled run.
- `packaging/release-signing-public.pem` contains the project release public key, and the live `sandwichfarm/loopwire`
repository has the matching `LOOPWIRE_RELEASE_PRIVATE_KEY` secret. Public installer claims still require Bunny
deployment secrets plus a tagged release workflow run.
Expand Down
9 changes: 5 additions & 4 deletions apps/docs/docs/guide/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,8 +90,8 @@ Package metadata templates now exist under `packaging/`:
- `packaging/aur/loopwire/PKGBUILD.in` for stable tagged source builds.
- `packaging/aur/loopwire-bin/PKGBUILD.in` for signed prebuilt release artifacts.
- `packaging/aur/loopwire-git/PKGBUILD.in` for the rolling default-branch source build.
- `flake.nix` exposes `packages.<system>.loopwire-bin` from `packaging/nix/loopwire-bin.nix`, currently with fake
hashes until the first public release provides real artifact hashes.
- `flake.nix` exposes `packages.<system>.loopwire-bin` from `packaging/nix/loopwire-bin.nix`, pinned to the signed
`v0.1.0` release hashes for `x86_64-linux` and `aarch64-linux`.
- Repository-owned deb recipes for Ubuntu 24.04 and Debian 13, plus RPM recipes for Fedora 44 and openSUSE
Tumbleweed. They package the full canonical release payload rather than Tauri's GUI-only bundle.
- AppImage through Tauri bundling.
Expand Down Expand Up @@ -148,5 +148,6 @@ pnpm verify:nix-release -- \
Non-Nix CI and local machines may use `--skip-build-if-missing-nix` only to check wiring. Release evidence and final
release proof must not use that skip as Nix package proof.

The AUR recipes are published as separate package bases. The Nix package remains a template; do not expose it as
release-ready until real hashes and non-skipped Nix build proof exist.
The AUR recipes are published as separate package bases. The default Nix package is now release-bound for `v0.1.0`,
but fresh local non-skipped build proof currently covers only `x86_64-linux`; do not describe `aarch64-linux` as
locally verified until it gets its own native proof run.
6 changes: 4 additions & 2 deletions apps/docs/docs/guide/support-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,11 @@ the Tauri shell command bridge.
| 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. |
| AUR `loopwire-git` | Rolling default-branch build through `pnpm verify:aur:git` | Published; development snapshots are not stable releases. |
| Nix flake package template | `pnpm verify:packaging` | Blocked on real release hashes and Nix build proof. |
| Nix flake package (`loopwire-bin`) | `pnpm verify:nix-release -- --repo sandwichfarm/loopwire --tag v0.1.0 --public-key packaging/release-signing-public.pem` | Release-bound for 0.1.0; locally proved on x86_64 only. |

The flake package output is `packages.<system>.loopwire-bin`; it uses fake hashes until published artifacts exist.
The flake package output is `packages.<system>.loopwire-bin`; `flake.nix` now pins the signed `v0.1.0` tarball hashes
for `x86_64-linux` and `aarch64-linux`. Fresh local non-skipped Nix build evidence in this repository currently covers
`x86_64-linux` only; `aarch64-linux` still needs native proof.

Native package verification is narrower than audio-backend support. The committed snapshot proves that each official,
checksum-pinned guest built and installed its target package, ran the packaged background/provider/backend commands,
Expand Down
4 changes: 2 additions & 2 deletions apps/docs/docs/release-notes/unreleased.md
Original file line number Diff line number Diff line change
Expand Up @@ -731,8 +731,8 @@ These notes describe source-tree progress. They are not a public release announc
- The VM target matrix now includes `opensuse-kde-pipewire` with zypper-based guest bootstrap validation.
- The VM target matrix now includes an AArch64 Ubuntu target and prints architecture-specific QEMU launch handoffs.
- `pnpm check` now includes `pnpm verify:tauri`, which runs Tauri Rust formatting, compile checks, and tests.
- The Nix flake now exposes `packages.<system>.loopwire-bin` as a binary package template with fake hashes, plus a
helper for injecting real release hashes after published artifacts exist.
- The Nix flake now binds `packages.<system>.loopwire-bin` to the signed `v0.1.0` release hashes for `x86_64-linux`
and `aarch64-linux`, while `lib.<system>.mkLoopwireBinPackage` remains available for future published releases.
- `pnpm nix:render-release` now renders a concrete Nix package expression from checksum-bound release tarballs and
rejects missing or duplicate checksum manifest entries before any Nix publication claim.
- `pnpm verify:nix-release` now wraps the Nix render step and runs `nix build` on Nix-enabled hosts, with an explicit
Expand Down
27 changes: 27 additions & 0 deletions flake.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions flake.nix
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@
forEachSystem = nixpkgs.lib.genAttrs systems;
releaseVersion = "0.1.0";
releaseHashes = {
x86_64-linux = nixpkgs.lib.fakeHash;
aarch64-linux = nixpkgs.lib.fakeHash;
x86_64-linux = "sha256-Gt5lTPyKa34+WoVXorxTdH3MktJVW7mKNlEKVTjktWI=";
aarch64-linux = "sha256-5ZjdwSUDQZYfw4gwhDf/4/1rhfg8m4ue0uvJkl7m0L8=";
};
in
{
Expand Down
21 changes: 11 additions & 10 deletions packaging/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,12 +80,13 @@ key in `packaging/aur/known_hosts`; verify any future key rotation against the o
## Nix

`flake.nix` exposes `packages.<system>.loopwire-bin` and `packages.<system>.default` from
`packaging/nix/loopwire-bin.nix` for `x86_64-linux` and `aarch64-linux`. The default flake package intentionally uses
`nixpkgs.lib.fakeHash` until the first public release provides real artifact hashes.
`packaging/nix/loopwire-bin.nix` for `x86_64-linux` and `aarch64-linux`. The default flake package is pinned to the
signed `v0.1.0` release tarball hashes for both systems.
`flake.lock` pins the nixpkgs revision used to evaluate and build those outputs.

After a release exists, use `lib.<system>.mkLoopwireBinPackage` with the published version and per-system hashes from
release metadata. Do not describe the flake package as release-ready until those hashes are real and `nix build` has
been run against published artifacts.
Use `lib.<system>.mkLoopwireBinPackage` when a newer release exists and you need to inject a different published
version/hash set. Fresh local proof in this repository only covers `x86_64-linux` via a non-skipped `nix build`
against published artifacts; `aarch64-linux` still needs native proof before that host is described as verified.

Render a reviewable Nix package expression from a signed release directory:

Expand Down Expand Up @@ -231,8 +232,8 @@ and validates source-package `.SRCINFO`. It skips cleanly on hosts without `make
builds the tagged source recipe and checks the complete runtime, desktop entry, and icon.

`verify:packaging` statically checks that package metadata points at the same release artifact names as the installer
and that the flake exposes the binary package template without replacing fake hashes with unverified values. It also
renders a temporary Nix release package expression from checksum-bound fake artifacts and proves duplicate manifest
entries are rejected. It invokes the Nix verifier with `--render-only` against fake local artifacts, so it does not
replace real release-time `nix build` evidence. It also runs the native package reproducibility and proof-verifier
regressions; this still does not substitute for the matching-guest KVM run.
and that the flake keeps the signed `v0.1.0` SRI hashes wired while render-only metadata smokes stay separate from real
release proof. It also renders a temporary Nix release package expression from checksum-bound fake artifacts and proves
duplicate manifest entries are rejected. It invokes the Nix verifier with `--render-only` against fake local artifacts,
so it does not replace real release-time `nix build` evidence. It also runs the native package reproducibility and
proof-verifier regressions; this still does not substitute for the matching-guest KVM run.
6 changes: 3 additions & 3 deletions scripts/verify-docs.sh
Original file line number Diff line number Diff line change
Expand Up @@ -103,8 +103,8 @@ assert_contains "apps/docs/docs/guide/support-matrix.md" "pnpm vm:render-ssh-pla
assert_contains "apps/docs/docs/guide/support-matrix.md" "Virtual sinks, routes, mute, monitor links"
assert_contains "apps/docs/docs/guide/support-matrix.md" "one output per source"
assert_contains "apps/docs/docs/guide/support-matrix.md" "Playback/capture hardware detection"
assert_contains "apps/docs/docs/guide/support-matrix.md" "Nix flake package template"
assert_contains "apps/docs/docs/guide/support-matrix.md" "fake hashes"
assert_contains "apps/docs/docs/guide/support-matrix.md" 'Nix flake package (`loopwire-bin`)'
assert_contains "apps/docs/docs/guide/support-matrix.md" "Release-bound for 0.1.0; locally proved on x86_64 only."
assert_contains "apps/docs/docs/guide/backends.md" "list PipeWire output ports as source candidates"
assert_contains "apps/docs/docs/guide/backends.md" "create Loopwire-owned virtual output and monitor sinks"
assert_contains "apps/docs/docs/guide/backends.md" "virtual monitor sink ports"
Expand Down Expand Up @@ -970,7 +970,7 @@ assert_contains "apps/docs/docs/release-notes/unreleased.md" "Debian and Ubuntu
assert_contains "apps/docs/docs/release-notes/unreleased.md" "Non-Nix VM cloud-init commands now install Rust"
assert_contains "apps/docs/docs/release-notes/unreleased.md" "NixOS VM cloud-init commands"
assert_contains "apps/docs/docs/release-notes/unreleased.md" 'packages.<system>.loopwire-bin'
assert_contains "apps/docs/docs/release-notes/unreleased.md" "fake hashes"
assert_contains "apps/docs/docs/release-notes/unreleased.md" 'signed `v0.1.0` release hashes'
assert_contains "apps/docs/docs/release-notes/unreleased.md" "VitePress public installer asset"
assert_contains "apps/docs/docs/release-notes/unreleased.md" "unsafe absolute or parent-traversing archive paths"
assert_contains "apps/docs/docs/release-notes/unreleased.md" "Release readiness now fails if the public docs installer drifts"
Expand Down
9 changes: 8 additions & 1 deletion scripts/verify-packaging.sh
Original file line number Diff line number Diff line change
Expand Up @@ -46,8 +46,10 @@ require_contains flake.nix "packages = forEachSystem"
require_contains flake.nix "loopwire-bin = loopwireBin"
require_contains flake.nix "default = loopwireBin"
require_contains flake.nix "pkgs.callPackage ./packaging/nix/loopwire-bin.nix"
require_contains flake.nix "nixpkgs.lib.fakeHash"
require_contains flake.nix 'x86_64-linux = "sha256-Gt5lTPyKa34+WoVXorxTdH3MktJVW7mKNlEKVTjktWI="'
require_contains flake.nix 'aarch64-linux = "sha256-5ZjdwSUDQZYfw4gwhDf/4/1rhfg8m4ue0uvJkl7m0L8="'
require_contains flake.nix "mkLoopwireBinPackage"
require_contains flake.lock '"type": "github"'
require_contains package.json '"nix:render-release": "bash scripts/render-nix-release-package.sh"'
require_contains package.json '"verify:nix-release": "bash scripts/verify-nix-release-package.sh"'
require_contains scripts/render-nix-release-package.sh "loopwire-linux-x86_64.tar.gz"
Expand Down Expand Up @@ -116,4 +118,9 @@ bash scripts/verify-nix-release-package.sh \
--release-dir "$release_dir" \
--render-only >/dev/null

if grep -Fq "fakeHash" flake.nix; then
echo "flake.nix must not use fakeHash for the default Loopwire release package" >&2
exit 1
fi

echo "Packaging metadata smoke passed."
1 change: 1 addition & 0 deletions scripts/verify-requirements.sh
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ assert_file "scripts/verify-aur-git-package.sh"
assert_file "scripts/verify-aur-source-package.sh"
assert_file "packaging/nix/loopwire-bin.nix"
assert_file "flake.nix"
assert_file "flake.lock"
assert_contains "flake.nix" "packages = forEachSystem"
assert_contains "flake.nix" "loopwire-bin = loopwireBin"
assert_contains "flake.nix" "mkLoopwireBinPackage"
Expand Down