packagekit_dart

• Breaking: migrate the native build hook from hooks 1.x to 2.x (and
  code_assets to 1.2.x). hooks 2.x requires Dart >=3.10, so the SDK lower
  bound rises from 3.6.0 — consumers on Dart 3.6–3.9 should stay on 0.4.x. The
  hook's behaviour is unchanged (it still builds libpackagekit_nc.so via CMake
  and skips cleanly when cmake/ninja/sd-bus are absent); the migration is a
  dependency bump only, verified end to end against a consumer build.
• Drop the native_toolchain_c dependency: it was declared but never imported
  (the hook drives CMake directly rather than CBuilder).

• Breaking: migrate the native build hook from hooks 1.x to 2.x (and code_assets to 1.2.x). hooks 2.x requires Dart >=3.10, so the SDK lower bound rises from 3.6.0 — consumers on Dart 3.6–3.9 should stay on 0.4.x. The hook's behaviour is unchanged (it still builds libpackagekit_nc.so via CMake and skips cleanly when cmake/ninja/sd-bus are absent); the migration is a dependency bump only, verified end to end against a consumer build.
• Drop the native_toolchain_c dependency: it was declared but never imported (the hook drives CMake directly rather than CBuilder).

A build-hook fix so the package installs on hosts that lack the native-bridge
toolchain.

• Skip the native bridge cleanly when its build prerequisites are absent.
  The bridge needs a C++ toolchain (cmake + ninja) and libsystemd's sd-bus;
  on Alpine/OpenRC, a minimal image, or any non-systemd host, the build hook
  now probes for these up front and returns without building — the PackageKit
  backend is simply unavailable, which is fine where it is unused. Previously a
  missing tool threw ProcessException (only a present-but-failing tool was
  handled), failing the whole build hook and blocking dart pub get / install
  for every consumer on such a host. Probing first also avoids a needless
  sdbus-cpp clone.

A build-hook fix so the package installs on hosts that lack the native-bridge toolchain.

• Skip the native bridge cleanly when its build prerequisites are absent. The bridge needs a C++ toolchain (cmake + ninja) and libsystemd's sd-bus; on Alpine/OpenRC, a minimal image, or any non-systemd host, the build hook now probes for these up front and returns without building — the PackageKit backend is simply unavailable, which is fine where it is unused. Previously a missing tool threw ProcessException (only a present-but-failing tool was handled), failing the whole build hook and blocking dart pub get / install for every consumer on such a host. Probing first also avoids a needless sdbus-cpp clone.

Documentation only — no code change.

• Lead the WSL guidance with the polkit rule rather than running as root.
  Recommending root to library consumers pushes them to relay that to their
  own users, and most tools keep caches or configuration under $HOME, where
  running as root leaves artifacts the user can no longer modify. Keeping the
  client unprivileged is what PackageKit exists to make possible.
• Document that the suggested rule covers only install/remove/update.
  refreshCache maps to system-sources-refresh, which needs no
  authorization for a caller in a login session but does for one without —
  the CI and WSL case.

Documentation only — no code change.

• Lead the WSL guidance with the polkit rule rather than running as root. Recommending root to library consumers pushes them to relay that to their own users, and most tools keep caches or configuration under $HOME, where running as root leaves artifacts the user can no longer modify. Keeping the client unprivileged is what PackageKit exists to make possible.
• Document that the suggested rule covers only install/remove/update. refreshCache maps to system-sources-refresh, which needs no authorization for a caller in a login session but does for one without — the CI and WSL case.

Documentation only — no code change. Released so the README rendered on
pub.dev stops handing out a polkit rule that does nothing on Debian/Ubuntu.

• Fix the documented polkit rule, which granted only to wheel — the admin
  group on Fedora/RHEL/Arch but not on Debian/Ubuntu, where it is sudo. A
  wheel-only rule silently does nothing on Debian and is hard to diagnose,
  because the rule looks installed and the error is unchanged. Match both.
• Document that installing the rule is not sufficient: you must be in the
  group, passwordless sudo is not the same thing, and usermod does not
  affect a running session. All three produce the same unchanged denial.

Documentation only — no code change. Released so the README rendered on pub.dev stops handing out a polkit rule that does nothing on Debian/Ubuntu.

• Fix the documented polkit rule, which granted only to wheel — the admin group on Fedora/RHEL/Arch but not on Debian/Ubuntu, where it is sudo. A wheel-only rule silently does nothing on Debian and is hard to diagnose, because the rule looks installed and the error is unchanged. Match both.
• Document that installing the rule is not sufficient: you must be in the group, passwordless sudo is not the same thing, and usermod does not affect a running session. All three produce the same unchanged denial.

• Send the interactive hint on every transaction. The daemon treats an
  absent hint as false, which strips ALLOW_USER_INTERACTION from its polkit
  check — so any transaction needing authorization failed synchronously with
  PkError.notAuthorized and a 0 ms runtime, on any host where the polkit
  action is auth_admin and the caller is not root.
• Add PkClient.connect({bool interactive = true}) and the matching
  PkClient.interactive getter. Interactive is the default: transactions that
  need authorization now prompt instead of failing. Pass interactive: false
  for unattended callers that must fail fast rather than block on a prompt —
  it suppresses the prompt, it does not grant authorization.
• Document authorization on WSL, where polkit cannot reliably prompt because
  a logind session owned by the calling user is often absent. Recommends
  running as root, with a narrowly scoped polkit rule as an opt-in
  alternative, plus how to tell a session problem from a real denial.
• C ABI change: pk_transaction_set_hints takes a third parameter,
  bool interactive. Consumers linking libpackagekit_nc directly must
  update their declaration; consumers using the build hook are unaffected,
  as it compiles the library from source.

• Send the interactive hint on every transaction. The daemon treats an absent hint as false, which strips ALLOW_USER_INTERACTION from its polkit check — so any transaction needing authorization failed synchronously with PkError.notAuthorized and a 0 ms runtime, on any host where the polkit action is auth_admin and the caller is not root.
• Add PkClient.connect({bool interactive = true}) and the matching PkClient.interactive getter. Interactive is the default: transactions that need authorization now prompt instead of failing. Pass interactive: false for unattended callers that must fail fast rather than block on a prompt — it suppresses the prompt, it does not grant authorization.
• Document authorization on WSL, where polkit cannot reliably prompt because a logind session owned by the calling user is often absent. Recommends running as root, with a narrowly scoped polkit rule as an opt-in alternative, plus how to tell a session problem from a real denial.
• C ABI change: pk_transaction_set_hints takes a third parameter, bool interactive. Consumers linking libpackagekit_nc directly must update their declaration; consumers using the build hook are unaffected, as it compiles the library from source.

• Point repository and issue_tracker at the jwinarske fork, fixing
  pub.dev repository verification.

• Point repository and issue_tracker at the jwinarske fork, fixing pub.dev repository verification.

• Extract TransactionDispatcher and dispatchManagerEvent for testable
  message dispatch without a live daemon
• 102 unit tests covering all codec discriminators, model constructors,
  enum round-trips, dispatcher paths, and error handling
• ~98% coverage on testable Dart code (FFI glue excluded)
• Remove unused generated sdbus-cpp proxy headers and D-Bus XML interfaces
• Remove go_router; use index-based navigation for instant screen switching
• Fix CI: add libclang-rt-19-dev for ASAN, exclude test/ from clang-tidy,
  add dart pub get before format check, add flutter analyze step
• Lower Dart coverage threshold to 10% (FFI-heavy package)
• Add Flutter example screenshot to README
• Fix detail pane overlay on screen switch and package selection

• Extract TransactionDispatcher and dispatchManagerEvent for testable message dispatch without a live daemon
• 102 unit tests covering all codec discriminators, model constructors, enum round-trips, dispatcher paths, and error handling
• ~98% coverage on testable Dart code (FFI glue excluded)
• Remove unused generated sdbus-cpp proxy headers and D-Bus XML interfaces
• Remove go_router; use index-based navigation for instant screen switching
• Fix CI: add libclang-rt-19-dev for ASAN, exclude test/ from clang-tidy, add dart pub get before format check, add flutter analyze step
• Lower Dart coverage threshold to 10% (FFI-heavy package)
• Add Flutter example screenshot to README
• Fix detail pane overlay on screen switch and package selection

• Native build hook (hook/build.dart) using package:hooks and
  package:code_assets — automatically compiles libpackagekit_nc.so via
  CMake at build time and bundles it as a CodeAsset
• Auto-clone sdbus-cpp at pinned commit when submodule is unavailable
  (pub.dev installs)
• Flutter example app (example/packagekit_catalog/) — Material 3 desktop
  catalog with Riverpod state management, GoRouter navigation, search,
  installed packages, updates, and repository views
• Codecov integration with 60% threshold enforcement
• Dart and C++ coverage collection in CI

• Native build hook (hook/build.dart) using package:hooks and package:code_assets — automatically compiles libpackagekit_nc.so via CMake at build time and bundles it as a CodeAsset
• Auto-clone sdbus-cpp at pinned commit when submodule is unavailable (pub.dev installs)
• Flutter example app (example/packagekit_catalog/) — Material 3 desktop catalog with Riverpod state management, GoRouter navigation, search, installed packages, updates, and repository views
• Codecov integration with 60% threshold enforcement
• Dart and C++ coverage collection in CI