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
8 changes: 7 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [0.2.0] - 2026-10-26

### Added

- Explicit screen-reader names for the device filter/list, device details action,
Expand Down Expand Up @@ -40,6 +42,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Changed

- Update the locked Tokio runtime to 1.54.1, proptest to 1.12.0, and pinned CI
actions after compatibility, coverage and reproducibility checks.
- Enforce >=98% production line coverage across the complete application, including
GTK and headless builds. Isolated desktop tests cover dialogs, notifications,
device/rule operations, single-instance lifecycle and real 20/180-second notices;
Expand Down Expand Up @@ -183,6 +187,8 @@ The first release.
- `docs/architecture.md`: `listRules` takes a label filter, not a query — `""` lists every rule,
`"match"` would have listed none. Found by introspection before any code depended on it.

[Unreleased]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.1...HEAD
[Unreleased]: https://github.com/onyks-os/USBGuardGUI/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.2...v0.2.0
[0.1.2]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.1...v0.1.2
[0.1.1]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/onyks-os/USBGuardGUI/releases/tag/v0.1.0
2 changes: 1 addition & 1 deletion Cargo.lock

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

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "usbguard-gui"
version = "0.1.2"
version = "0.2.0"
edition = "2024"
rust-version = "1.89"
description = "Unprivileged GTK4 desktop client for managing USB device authorization policy through the USBGuard daemon."
Expand Down
12 changes: 6 additions & 6 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -218,11 +218,11 @@ explicit at every step.
| **0.1.0** | Released | Device list/search/filter; runtime or permanent allow/block/reject; policy editor and safe removal; diagnostics; preferences; notifications, background/tray, autostart; English/Italian; native and Flatpak packages. |
| **0.1.1** | Released | Flatpak status-icon correction. |
| **0.1.2** | Current stable | Authentication-cancellation crash fix, reconnect backoff, inconclusive-write handling, log privacy, per-file core coverage, reproducible binaries and all package formats. |
| **0.2.0** | Implementation complete; release pending | zbus 6.1, direct SNI/menu implementation and Rust 1.89; four clean-system daemon/Polkit checks; application fixes and >=98% production line coverage, GTK included. Includes the already-merged French catalogues and license/source/CI maintenance. |
| **Following releases, versions unassigned** | Approved product milestones | Rule/device preview, device details and observed decisions, event history, desktop quality; ordered below. |
| **0.2.0** | Implementation and desktop acceptance complete; release candidate pending | Rule/device preview, device details, private local event history and desktop quality; zbus 6.1, direct SNI/menu and Rust 1.89; four clean-system daemon/Polkit checks; >=98% production line coverage, GTK included. Includes the already-merged French catalogues and license/source/CI maintenance. |

The old “v0.2.0 scope” above is historical: those policy actions shipped in
0.1.0. The new 0.2.0 target contains the post-0.1.2 dependency and validation work. No release date is promised; a tag
0.1.0. The new 0.2.0 target contains the post-0.1.2 dependency and validation work
and all four product milestones below. No release date is promised; a tag
requires the usual CI, coverage, reproducibility and installed-runtime gates.

Real-daemon/Polkit checks now pass on disposable Ubuntu, Debian, Fedora and Arch
Expand All @@ -232,16 +232,16 @@ records the exact virtual-device/agent scope and package versions.

### Approved product milestones (2026-10-25)

The following work is approved in priority order. Version numbers and release dates
will be assigned after each milestone passes its acceptance checks. Further languages
The following work was approved in priority order and is included in the 0.2.0
release preparation after passing its acceptance checks. Further languages
and AUR publication remain deferred; they are not prerequisites for these milestones.

| Priority | Milestone | Scope and acceptance criteria | Status |
| :--- | :--- | :--- | :--- |
| **1** | **Preview matching devices before adding a rule** | A read-only action in both rule-editor modes asks USBGuard which currently connected devices match the attributes. Show results, no matches, errors and cancellation; discard results after edits or closing. State explicitly that conditions and rule precedence are not simulated. No authorization or policy mutation is performed. Test target-independent queries, hostile text, stale replies and failure paths; maintain >=98% application line coverage. | Merged; unreleased |
| **2** | **Device details and observed decisions** | Add an accessible per-device details view for USB interfaces/functions, physical port topology, connection type and daemon-reported state/rule text. Label the source and distinguish that device description from the effective policy rule. Show a matched rule only when USBGuard reports an unambiguous, current identity; otherwise say that the API does not provide it. Test missing/malformed fields, hostile strings and invalidation on row replacement/reconnection. | Merged; unreleased |
| **3** | **Local event history** | Show insertions, removals, authorization outcomes and reconnections observed while the app runs. Mark observation gaps; bound retention and make persistence opt-in. Offer export with identifiers obscured and test redaction. | Merged; unreleased |
| **4** | **Desktop quality** | Measure and reduce memory usage; verify keyboard navigation, screen-reader labels, Wayland and GNOME/KDE behavior. Track repeatable measurements and desktop-specific regressions. | Validated; PR #61 pending merge. Memory baseline, installed Fedora AT-SPI/keyboard and native Weston checks passed. Corrected diagnostic executable passed 7/7 cases on GNOME and Plasma with 10/30 stress cycles and fatal criticals; application coverage 98.0917%. Versioned release-package verification remains a release gate. |
| **4** | **Desktop quality** | Measure and reduce memory usage; verify keyboard navigation, screen-reader labels, Wayland and GNOME/KDE behavior. Track repeatable measurements and desktop-specific regressions. | Validated for 0.2.0. Memory baseline, installed Fedora AT-SPI/keyboard and native Weston checks passed. Corrected diagnostic executable passed 7/7 cases on GNOME and Plasma with 10/30 stress cycles and fatal criticals; application coverage 98.0917%. Versioned release-package verification remains a release gate. |

All four retain the unprivileged D-Bus architecture. Each completed milestone must
pass the existing tests, coverage and packaging gates before release. The first
Expand Down
35 changes: 20 additions & 15 deletions SESSION_HANDOFF.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Development checkpoint — 2026-10-26

Continue completing PR #61 (`feat/desktop-quality`), then prepare and publish
0.2.0 through a verified release candidate. The user authorized signed-off commits,
PR #61 and maintenance PRs #52–57 are merged. Continue preparing and publishing
0.2.0 through a verified release candidate on branch `release/0.2.0`. The user authorized signed-off commits,
PR management and release/tag publication; DCO consent already exists.

**Privacy:** never inspect the real host's desktop, applications, services or
Expand All @@ -26,8 +26,9 @@ narrow namespace wrapper `target/run-private-tests.py`. No subagents requested.
GDB traced the separate stale-index critical to GTK 4.22.5's root handler.
This corrects our observer; it does not fix GTK for other accessibility clients.
- All 17 PR checks passed on ddd8977, including coverage, reproducibility of every
package format, stable/beta/MSRV, lint, audit, DCO and CodeQL. Final subsequent
driver/docs/receipt changes need their own CI before merge.
package format, stable/beta/MSRV, lint, audit, DCO and CodeQL. Final observer/docs commit `5f8874d` also passed all 17 checks before
merge. Main integration commit is `2b64f6e`. Maintenance updates include
Tokio 1.54.1, proptest 1.12.0 and pinned CI actions; each PR passed all 17 checks.
- Local checks already passed: driver 20 tests, reproducibility 30, dependency
policy 6, i18n 7; audit/deny, lint, pinned strict MkDocs. Markdownlint unavailable.

Expand All @@ -46,16 +47,20 @@ software Mesa. Do not use the older whole-root bind or the real desktop.

## Remaining release work

1. Commit final observer, verified receipts, updated roadmap/docs; push PR #61,
update its description, mark ready, wait for green exact-head CI and squash
merge with the already-authorized Git identity's Signed-off-by.
2. Prepare 0.2.0 version metadata/changelog/AppStream/Arch version in a new branch.
Include all four completed product milestones in 0.2.0 scope; no more languages
or AUR publication. Draft notes: `target/release-020-notes.md`.
3. Pass CI and merge version PR; require main checks before tagging. Follow
`docs/releasing.md`: publish v0.2.0-rc.1, verify checksums/Sigstore identity,
installed candidate package and pinned Flatpak validation; stable tag at the
same verified commit. Existing native receipts from prior candidates must not
be described as installed 0.2.0 validation.
1. Version metadata, changelog and AppStream now identify 0.2.0; all four product
milestones are assigned to this release. Local pre-integration Rust/lint and
policy/i18n/coverage-tool tests, AppStream and strict MkDocs passed. The complete
combination with the merged dependencies is being revalidated before release.
2. Push the release preparation PR; pass current-head CI and merge, then require
main checks before tagging. No additional languages or AUR publication.
3. Follow `docs/releasing.md`: publish v0.2.0-rc.1, verify checksums/Sigstore
identity, installed candidate package and pinned Flatpak validation; stable
tag at the same verified commit. Existing native receipts from prior candidates
must not be described as installed 0.2.0 validation.

Release-note draft: `target/release-020-notes.md`. Signature verifier is installed
only in `target/release-signature-venv/` (sigstore 4.5.1). The original CI coverage
report from final desktop commit is `target/ci-5f8874d-coverage/`; paths refer to
GitHub's checkout and were mapped in memory for local validation, not rewritten.

No v0.2.0 tag exists at this checkpoint. Stable remains 0.1.2.
11 changes: 11 additions & 0 deletions data/io.github.onyks_os.UsbguardGui.metainfo.xml
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,17 @@
</branding>
<content_rating type="oars-1.1"/>
<releases>
<release version="0.2.0" date="2026-10-26" type="stable">
<description>
<p>Understand device policy before making changes.</p>
<ul>
<li>Preview connected devices matching a new rule's attributes</li>
<li>Inspect USB interfaces, connection details and daemon-reported state</li>
<li>Review local event history with optional persistence and no device identifiers</li>
<li>Improve accessible controls and native-dialog reliability</li>
</ul>
</description>
</release>
<release version="0.1.2" date="2026-10-24" type="stable">
<description>
<p>Authentication cancellation and USBGuard reconnection are more reliable.</p>
Expand Down
11 changes: 11 additions & 0 deletions data/io.github.onyks_os.UsbguardGui.metainfo.xml.in
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,17 @@
<content_rating type="oars-1.1"/>

<releases>
<release version="0.2.0" date="2026-10-26" type="stable">
<description>
<p>Understand device policy before making changes.</p>
<ul>
<li>Preview connected devices matching a new rule's attributes</li>
<li>Inspect USB interfaces, connection details and daemon-reported state</li>
<li>Review local event history with optional persistence and no device identifiers</li>
<li>Improve accessible controls and native-dialog reliability</li>
</ul>
</description>
</release>
<release version="0.1.2" date="2026-10-24" type="stable">
<description>
<p>Authentication cancellation and USBGuard reconnection are more reliable.</p>
Expand Down
8 changes: 7 additions & 1 deletion docs/web/release-notes/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [0.2.0] - 2026-10-26

### Added

- Explicit screen-reader names for the device filter/list, device details action,
Expand Down Expand Up @@ -35,6 +37,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

### Changed

- Update the locked Tokio runtime to 1.54.1, proptest to 1.12.0, and pinned CI
actions after compatibility, coverage and reproducibility checks.
- Enforce >=98% production line coverage across the complete application, including
GTK and headless builds. Isolated desktop tests cover dialogs, notifications,
device/rule operations, single-instance lifecycle and real 20/180-second notices;
Expand Down Expand Up @@ -178,6 +182,8 @@ The first release.
- `docs/architecture.md`: `listRules` takes a label filter, not a query — `""` lists every rule,
`"match"` would have listed none. Found by introspection before any code depended on it.

[Unreleased]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.1...HEAD
[Unreleased]: https://github.com/onyks-os/USBGuardGUI/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.2...v0.2.0
[0.1.2]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.1...v0.1.2
[0.1.1]: https://github.com/onyks-os/USBGuardGUI/compare/v0.1.0...v0.1.1
[0.1.0]: https://github.com/onyks-os/USBGuardGUI/releases/tag/v0.1.0
2 changes: 1 addition & 1 deletion packaging/arch/PKGBUILD
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
# Build from a clone: makepkg -si (in this directory)

pkgname=usbguard-gui
pkgver=0.1.2
pkgver=0.2.0
pkgrel=1
pkgdesc='Desktop interface for USBGuard: see and control which USB devices may connect'
arch=('x86_64' 'aarch64')
Expand Down
Loading