feat(desktop): release v2.16.0 — PR activity notifications

Author: Laurent Guitton

CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.16.0] - 2026-05-29
+
+v2.16 adds native OS notifications for pull-request activity — review requests, new comments, CI pass/fail flips, and merge/close — surfaced while GitWand is in the background, with zero extra network requests beyond the existing Launchpad poll.
+
+### Added
+
+- **Background Launchpad poller** (`useLaunchpadPoller`) — a dedicated ~60 s poll loop, independent of `useRepoPoller` (which pauses when the window is hidden). It keeps refreshing PR state in the background so notifications fire without GitWand in the foreground. Gated on workspace presence, notification settings, and connectivity.
+- **Snapshot diff layer** (`useLaunchpadNotifications`) — a module-level singleton that compares successive PR snapshots and emits typed events: `new-pr`, `ci-flip`, `review-requested`, `review-decided`, `new-comment`, `closed` (merged/closed). Zero additional network requests — it consumes the data the poller already fetched. The first pass only seeds the snapshot, so reopening the app never fires a burst of stale notifications.
+- **Native OS notifications** via `tauri-plugin-notification` (macOS Notification Center, Linux libnotify, Windows toast). Emitted only when the window is in the background (`document.hidden`); in the foreground the Launchpad updates visually instead. Every event is also pushed to `useLogs` (traceable in the Logs tab).
+- **Notification settings** (Settings → Notifications) — granularity selector: All activity · Reviews & comments · CI failures only · None; plus a "by people" toggle that suppresses events authored by bots (GitHub Actions, Dependabot, Renovate).
+
+### Changed
+
+- **`workspace_prs_all` re-enriched** — the Launchpad PR list again carries `statusCheckRollup`, `reviewDecision`, `reviewRequests` and a new `comment_count`, which the notification diff needs. The light sidebar list (`gh_list_prs`) stays unenriched for boot performance; only the background Launchpad path pays the heavier `gh pr list --json` cost.
+
+### Technical
+
+- New `PullRequest.comment_count` field threaded across the three layers (`types.rs`/`gh.rs`/`gitlab.rs`/`bitbucket.rs`, `dev-server.mjs`, `backend.ts` + `backend-pr.ts`).
+- `tauri-plugin-notification` added to Cargo + initialised in `lib.rs`; `notification:*` permissions declared in `capabilities/default.json`. The TS wrapper (`useOsNotification`) calls the plugin's IPC commands directly so the type-check and `dev:web` builds don't depend on the native JS package.
+- Unit tests for the diff layer (every transition → correct event, terminal-only CI flips, bot detection, no boot burst).
+- i18n: `settings.notification*` and `notify.*` keys across all five locales.
+
 ## [2.15.1] - 2026-05-29
 
 v2.15.1 closes the "Git Tree polish & quick actions" lot — the daily-friction follow-ups to PR #23 (Force push, Quick Stash, Submodules in the Git Tree).

PLAN-v2.16-pr-notifications.md

@@ -0,0 +1,67 @@
+# PLAN v2.16.0 — PR Activity Notifications
+
+> Notifications OS natives pour les évènements de PR (review request, nouveau commentaire, flip CI, merge/close) sans quitter GitWand.
+
+**Rappels transverses** (identiques v2.15.1) : tout ajout backend = 3 couches (Rust `ops.rs`/`gh.rs` + `dev-server.mjs` + wrapper `backend.ts`) ; i18n × 5 locales ; versioning via `./scripts/bump-version.sh` ; `packages/core` zéro-Node ; tests de parité pour toute nouvelle commande.
+
+---
+
+## Ce que l'exploration a confirmé (et corrigé par rapport à la ROADMAP)
+
+La ROADMAP annonçait l'infra « presque prête (`useRepoPoller`, `useLaunchpadPrs`, `useConnectivity`) ; seul manque le diff-snapshot + l'émission OS ». En réalité **deux écarts** changent l'ampleur :
+
+1. **Pas de polling Launchpad de fond.** `useRepoPoller` ne suit que le repo actif et **se met en pause quand la fenêtre est cachée** (`document.hidden`). Or on veut notifier *quand l'app est en arrière-plan*. Le Launchpad (`LaunchpadView.vue`) ne rafraîchit qu'au montage et au clic. → Il faut un **poller dédié Launchpad** qui continue de tourner en arrière-plan.
+
+2. **Les données de PR « légères » ne portent ni CI ni reviews ni commentaires.** Le chemin liste (`workspace_prs_all` → `gh.rs`) renvoie `checks_rollup` et `review_decision` **vides** (allégés en v2.8.5 pour la perf de boot du sidebar), et `PullRequest` n'expose pas de `commentCount`. → Pour notifier sur flip CI / review request / nouveau commentaire, il faut **enrichir `workspace_prs_all`** (`gh pr list --json …,statusCheckRollup,reviewDecision,reviewRequests,comments`). Sinon on ne peut détecter que : nouvelle PR, changement d'état (merged/closed), bump `updatedAt`.
+
+Acquis utilisables tels quels : `useConnectivity` (`isOnline` pour ne pas notifier hors-ligne), `useLogs` (singleton `pushLog(level,msg,ctx)` → onglet Logs), `useSettings` (champ `notifications: boolean` existant), capabilities dans `src-tauri/capabilities/default.json`.
+
+---
+
+## Chantier 1 — Poller Launchpad de fond (front)
+
+- `useLaunchpadPoller.ts` : `setInterval` dédié (~60 s), indépendant de `useRepoPoller`. **Ne se met PAS en pause** quand la fenêtre est cachée (c'est justement là qu'on veut notifier), mais respecte `isOnline` (skip si hors-ligne) et l'activation des notifications.
+- À chaque tick : `useLaunchpadPrs.refresh(repos)` → met à jour le snapshot courant (et rafraîchit le Launchpad au passage si ouvert).
+- Discipline polling (mémoire `feedback_gitwand_polling_discipline`) : un seul interval, gaté sur `workspace non vide` + `notifications activées` ; cleanup en `onUnmounted`.
+
+## Chantier 2 — Couche diff-snapshot (front)
+
+- `useLaunchpadNotifications.ts` : singleton niveau module. Garde le snapshot précédent (Map `url → {state, updatedAt, checksRollup, reviewDecision, reviewRequested, commentCount}`).
+- À chaque refresh, compare ancien/nouveau et produit des évènements typés :
+  - `ci-flip` (SUCCESS↔FAILURE), `review-requested` (mon login ajouté à `reviewRequested`), `new-comment` (`commentCount` ↑), `review-decided` (APPROVED / CHANGES_REQUESTED), `merged` / `closed`, `new-pr`.
+  - Zéro requête réseau supplémentaire (réutilise les données du poller).
+- Filtre « by people » : ignore les évènements dont l'auteur est un bot (`github-actions`, `dependabot`, `renovate`, suffixe `[bot]`).
+- Première passe après boot = établissement du snapshot **sans** notifier (pas de rafale au démarrage).
+
+## Chantier 3 — Notifications OS natives (Rust + capabilities)
+
+- Ajouter `tauri-plugin-notification = "2"` (Cargo.toml) + init du plugin (`lib.rs`), permission `notification:default` dans `capabilities/default.json`.
+- Wrapper TS `notify(title, body, prUrl)` (3 couches : Tauri `plugin-notification` ; dev-server = no-op/log ; fallback Web Notification en `dev:web`).
+- Action au clic → ouvrir le Launchpad sur la PR concernée (réutilise la navigation Launchpad + deep-link par `url`).
+- **Gating** : émettre seulement quand `document.hidden` (app en arrière-plan) ; en avant-plan, le Launchpad se met à jour visuellement, pas de notif OS.
+- Chaque notif est aussi poussée dans `useLogs` (traçable, onglet Logs).
+
+## Chantier 4 — Réglages de granularité (front + i18n)
+
+- `useSettings` : ajouter `notificationLevel: "all" | "reviews" | "ci" | "none"` (le `notifications: boolean` existant reste le maître on/off, ou est migré). Ajouter `notificationsByPeople: boolean`.
+- ⚠️ Mémoire `feedback_gitwand_duplicate_settings_interfaces` : tout nouveau champ doit être ajouté **à la fois** dans `useSettings.ts` (AppSettings) **et** `SettingsPanel.vue` (Settings).
+- Section « Notifications » dans `SettingsPanel.vue` : radio All / Reviews & comments / CI failures only / None + toggle « by people ».
+- i18n × 5 : `settings.notifications.*`, libellés des évènements pour les titres/corps de notif.
+
+## Chantier 5 — Backend enrichi (conditionnel — voir question de cadrage)
+
+- Si on veut CI/review/comment : enrichir `workspace_prs_all` pour peupler `checks_rollup`, `review_decision`, `review_requested`, et un `comment_count` (nouveau champ `PullRequest` + 3 couches + GitLab/Bitbucket en best-effort).
+- Coût : `gh pr list --json` plus lourd, mais sur le poll Launchpad de fond (60 s), acceptable.
+- Tests de parité pour le champ enrichi.
+
+## Chantier 6 — Finition release
+
+- Tests : unitaires sur la couche diff (`useLaunchpadNotifications` : chaque transition → bon évènement ; bots filtrés ; pas de rafale au boot) ; parité si backend enrichi.
+- Docs : ROADMAP v2.16 → Shipped + CHANGELOG + website/changelog.
+- `./scripts/bump-version.sh 2.16.0`.
+
+---
+
+## Ordre conseillé
+
+Backend enrichi (5, si retenu) → Poller (1) → Diff (2) → Notif OS (3) → Settings (4) → Finition (6).

README.md

@@ -21,7 +21,7 @@
 <p align="center">
   <img alt="License" src="https://img.shields.io/badge/license-MIT-8B5CF6">
   <img alt="TypeScript" src="https://img.shields.io/badge/TypeScript-100%25-3178C6">
-  <img alt="Version" src="https://img.shields.io/badge/version-2.15.1-22c55e">
+  <img alt="Version" src="https://img.shields.io/badge/version-2.16.0-22c55e">
 </p>
 
 ---

ROADMAP.md

@@ -6,30 +6,6 @@
 
 ## What's Next
 
-### v2.16.0 — PR Activity Notifications
-
-Native OS notifications for PR events — review request, new comment, CI flip, mention — without leaving GitWand. The infrastructure is nearly ready (`useRepoPoller`, `useLaunchpadPrs`, `useConnectivity`); only the diff-snapshot layer and OS emission are missing.
-
-**Launchpad diff-snapshot**
-
-- Between two poller ticks, compare the previous snapshot with the new one: new comments, CI status changes (pass/fail flip), incoming review requests, PR merge/close
-- `useLaunchpadNotifications.ts`: module-level singleton, compares by `updatedAt` / `commentCount` / `ciStatus` — zero additional network requests
-
-**Native notifications via `tauri-plugin-notification`**
-
-- OS notification (macOS Notification Center, Linux libnotify, Windows toast) with title, body, and action (open the Launchpad on the relevant PR)
-- Configurable granularity in Settings > Notifications: All activity · Reviews & comments · CI failures only · None
-- "By people" mode: filter events identified as bots (GitHub Actions, Dependabot, Renovate)
-- Gating: notifications only when the GitWand window is in the background (`visibilitychange`)
-
-**Implementation**
-
-- `tauri-plugin-notification` already in the Tauri 2 ecosystem
-- macOS TCC permissions declared in `tauri.conf.json` (`allow-notification` capability)
-- Notifications are pushed to `useLogs` — traceable in the Logs tab
-
----
-
 ### v2.17.0 — Inline CI Check Annotations
 
 Overlay check-run annotations in the diff — the exact line that failed the linter or typecheck, right where you need it in the review.
@@ -166,6 +142,7 @@ Positioning: neither "yet another Git GUI" nor an IDE. A first-class Git navigat
 
 | Version | Highlights |
 |---------|-----------|
+| **v2.16.0** | PR Activity Notifications — background Launchpad poller, zero-network snapshot diff (`useLaunchpadNotifications`) for CI flips / review requests / new comments / merge-close, native OS notifications via `tauri-plugin-notification` (background-only), Settings granularity (All · Reviews & comments · CI failures only · None) + "by people" bot filter, enriched `workspace_prs_all` (CI/review/comment fields) |
 | **v2.15.1** | Git Tree polish & quick actions — Force push (branch context menu + protected-trunk/diverged-remote guard), Quick Stash `⌘⇧,` (instant, AI label) + pending badge in the commit area, Submodules in the Git Tree (branch-picker section, per-commit pointed-SHA badge, click-to-navigate) |
 | **v2.15.0** | Git Tree multi-branch — Git Tree as primary view, Log panel removed, unified context menus, stash/branch/tag management from the graph, DAG trunk-pinning, WIP node, search bar |
 | **v2.14.0** | Forge completeness — GitLab `updateComment`/`deleteComment`/CI checks, complete Bitbucket stubs, forge-agnostic `getConflictPreview`/`getHotspots`, multi-account provider |

apps/desktop/dev-server.mjs

@@ -3669,13 +3669,13 @@ async function handleRequest(req, res) {
         const { repos } = await readBody(req);
         const results = repos.map(repo => {
           try {
-            // v2.8.5 boot-perf: dropped heavy fields (statusCheckRollup,
-            // mergeStateStatus, reviewRequests, reviewDecision, additions,
-            // deletions) — each triggers a per-PR roundtrip in `gh` internals
-            // and HTTP 502s on busy repos like dendreo at high --limit.
-            // Mirror of the Rust change in `commands/workspace.rs`.
+            // v2.16: re-enriched with CI / review / comment fields so the
+            // Launchpad notification diff (useLaunchpadNotifications) can detect
+            // CI flips, review requests and new comments. Mirror of the Rust
+            // change in `commands/workspace.rs`. This runs on the background
+            // Launchpad poller (~60 s), so the extra cost is acceptable.
             const raw = execSync(
-              "gh pr list --state open --json number,title,state,author,headRefName,baseRefName,isDraft,createdAt,updatedAt,url,labels,assignees --limit 10",
+              "gh pr list --state open --json number,title,state,author,headRefName,baseRefName,isDraft,createdAt,updatedAt,url,labels,assignees,reviewRequests,reviewDecision,mergeStateStatus,statusCheckRollup,comments --limit 10",
               { cwd: repo.path, encoding: "utf-8" }
             );
             const ghPrs = JSON.parse(raw || "[]");
@@ -3702,6 +3702,7 @@ async function handleRequest(req, res) {
               checks_rollup: (pr.statusCheckRollup ?? [])
                 .map(c => c.conclusion)
                 .find(c => !!c) ?? "",
+              comment_count: (pr.comments ?? []).length,
             }));
             return { repo_path: repo.path, repo_name: repo.name, prs, error: null };
           } catch (e) {

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitwand/desktop",
-  "version": "2.15.1",
+  "version": "2.16.0",
   "private": true,
   "description": "GitWand Desktop — lightweight Git client with smart conflict resolution (Tauri + Vue 3)",
   "type": "module",
@@ -25,6 +25,7 @@
     "@gitwand/core": "workspace:*",
     "@tanstack/vue-virtual": "^3.13.24",
     "@tauri-apps/api": "^2.0.0",
+    "@tauri-apps/plugin-notification": "^2.0.0",
     "@tauri-apps/plugin-process": "^2.0.0",
     "@tauri-apps/plugin-updater": "^2.0.0",
     "dompurify": "^3.2.0",

apps/desktop/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "gitwand-desktop"
-version = "2.15.1"
+version = "2.16.0"
 description = "GitWand Desktop — standalone merge conflict resolution"
 authors = ["Laurent Guitton <lb.guitton@gmail.com>"]
 license = "MIT"
@@ -38,6 +38,7 @@ tauri-build = { version = "2", features = [] }
 # app is built in debug mode unless we explicitly enable it in release too.
 tauri = { version = "2", features = ["devtools"] }
 tauri-plugin-dialog = "2"
+tauri-plugin-notification = "2"
 tauri-plugin-shell = "2"
 tauri-plugin-global-shortcut = "2"
 tauri-plugin-updater = "2"

apps/desktop/src-tauri/capabilities/default.json

@@ -13,6 +13,10 @@
     "global-shortcut:allow-is-registered",
     "updater:default",
     "process:default",
-    "process:allow-restart"
+    "process:allow-restart",
+    "notification:default",
+    "notification:allow-notify",
+    "notification:allow-request-permission",
+    "notification:allow-is-permission-granted"
   ]
 }

apps/desktop/src-tauri/src/commands/bitbucket.rs

@@ -331,6 +331,7 @@ fn bb_pr_to_pr(pr: &serde_json::Value) -> PullRequest {
         review_decision: String::new(),
         merge_state_status: String::new(),
         checks_rollup: String::new(),
+        comment_count: ji(pr, "comment_count"),
     }
 }
 

apps/desktop/src-tauri/src/commands/gh.rs

@@ -285,6 +285,7 @@ pub(crate) fn gh_create_pr(
         review_decision: String::new(),
         merge_state_status: String::new(),
         checks_rollup: String::new(),
+        comment_count: 0,
     })
 }