packagekit_dart

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.

• 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.

• 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