Release v3.7.0 - In-app update notifications + summary OS toasts (Phase 12.10)

SysAdminDoc · SysAdminDoc · commit c0416618ed3d · 2026-05-02T15:26:25.000-04:00
applyUpdate no longer fires a per-script OS notification. Previously a 10-
script auto-update cycle would trigger 10 back-to-back "Script Updated"
toasts; now autoUpdate aggregates cycle results and fires at most one
summary notification gated by notifyOnUpdate:

  "3 scripts updated: A v1.0 -&gt; v1.1, B v2.0 -&gt; v2.1, C v0.4 -&gt; v0.5"

New UpdateSystem._recentUpdates ring buffer (cap 20, newest first) plus
getRecentUpdates / clearRecentUpdates background message handlers.

Dashboard init() calls showRecentUpdatesBanner() which renders a
dismissible banner at the top of the Scripts tab listing what auto-updated
since the last dashboard visit. Dismiss button clears the ring on the
background side so the banner stays gone next visit.

Manual single-script flows (popup "Check for Update", dashboard
force-update) keep their inline feedback path - they don't push onto the
ring or fire a summary notification.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,13 @@
 
 All notable changes to ScriptVault will be documented in this file.
 
+## [v3.7.0] — In-app update notifications + summary OS notifications (Phase 12.10)
+
+- Changed: `applyUpdate` no longer fires a per-script OS notification. Previously a 10-script auto-update cycle would trigger 10 OS-level "Script Updated" toasts back-to-back; now `autoUpdate` aggregates the cycle's successful updates and fires at most one summary notification (`"3 scripts updated: A v1.0 → v1.1, B v2.0 → v2.1, C v0.4 → v0.5"`).
+- Added: in-app dashboard banner that lists scripts auto-updated since the last visit. Lands at the top of the Scripts tab on dashboard load. Dismiss button clears the ring on the background side so the banner stays gone next visit.
+- Added: `UpdateSystem._recentUpdates` ring buffer (cap 20, newest first) plus `getRecentUpdates` / `clearRecentUpdates` background message handlers.
+- Manual single-script flows (popup "Check for Update", dashboard force-update) keep their inline feedback path — they don't push onto the ring or fire a summary notification.
+
 ## [v3.6.3] — Beautify preserves cursor + scroll (Phase 7.5)
 
 - Fixed: `beautifyCode` (editor toolbar "Beautify" button) used to slam the cursor to line 0, char 0 after every reformat. On a long file you'd lose your place every time you hit it. The cursor + vertical scroll position now stay where they were.
diff --git a/README.md b/README.md
@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-3.6.3-22c55e?style=flat-square" alt="Version">
+  <img src="https://img.shields.io/badge/version-3.7.0-22c55e?style=flat-square" alt="Version">
   <img src="https://img.shields.io/badge/manifest-v3-60a5fa?style=flat-square" alt="Manifest V3">
   <img src="https://img.shields.io/badge/license-MIT-orange?style=flat-square" alt="License">
   <img src="https://img.shields.io/badge/chrome-120%2B-blue?style=flat-square" alt="Chrome 120+">
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -808,6 +808,8 @@ TM issue [#2748](https://github.com/Tampermonkey/tampermonkey/issues/2748) and [
 - Dashboard shows an "Updates available" banner that lists pending updates
 - Only use OS notifications for: install errors, sync failures, and security warnings (new `@connect` domain added)
 
+**Status (v3.7.0, 2026-05-02):** Mostly shipped. `applyUpdate` no longer fires a per-script OS notification — `autoUpdate` aggregates cycle results into a single summary notification ("3 scripts updated: A v1.0 → v1.1, B v2.0 → v2.1, ..."), still gated by `notifyOnUpdate`. New `UpdateSystem._recentUpdates` ring buffer + `getRecentUpdates`/`clearRecentUpdates` background handlers feed a dismissible dashboard banner that lists scripts auto-updated since the last visit. Yellow-badge indicator for "updates available" still pending — can land alongside Phase 6.2 (staged updates) when those land.
+
 ### 12.11 Per-Site Enable/Disable Toggle
 
 VM issue [#2410](https://github.com/violentmonkey/violentmonkey/issues/2410). Allow enabling or disabling a script for only the current domain without globally disabling it or editing `@match`. No other manager has this; it fills the gap between "script off everywhere" and "script on everywhere."
diff --git a/background.core.js b/background.core.js
@@ -419,19 +419,20 @@ const UpdateSystem = {
     // Persist to storage after registration attempt
     await ScriptStorage.set(scriptId, script);
 
-    const settings = await SettingsManager.get();
-    if (settings.notifyOnUpdate) {
-      chrome.notifications.create({
-        type: 'basic',
-        iconUrl: 'images/icon128.png',
-        title: 'Script Updated',
-        message: `${script.meta.name} updated to v${script.meta.version}`
-      });
-    }
-
+    // Phase 12.10 — applyUpdate no longer fires a per-script OS notification.
+    // Instead, the autoUpdate caller aggregates successful updates into a
+    // single summary notification (or none, when notifyOnUpdate is off), and
+    // pushes them onto the recent-updates ring so the dashboard can surface
+    // an in-app banner. Manual single-script updates (popup "Check for
+    // Update", dashboard force-update) get their feedback inline via the
+    // returned { success, script } payload.
     return { success: true, script };
   },
-  
+
+  // Phase 12.10 — recently-applied updates ring buffer surfaced to the
+  // dashboard via the `getRecentUpdates` background message. Capped at 20.
+  _recentUpdates: [],
+
   async autoUpdate() {
     const settings = await SettingsManager.get();
     if (!settings.autoUpdate) return;
@@ -444,7 +445,56 @@ const UpdateSystem = {
       console.error('[ScriptVault] Auto-update failures:', failed.map(r => r.reason?.message || r.reason));
     }
 
+    // Aggregate successful updates for in-app surfacing + a single summary
+    // OS notification (only fired when the user opted in via notifyOnUpdate).
+    const successful = [];
+    results.forEach((r, idx) => {
+      if (r.status === 'fulfilled' && r.value?.success && updates[idx]) {
+        successful.push({
+          id: updates[idx].id,
+          name: updates[idx].name,
+          previousVersion: updates[idx].currentVersion,
+          newVersion: updates[idx].newVersion,
+          appliedAt: Date.now()
+        });
+      }
+    });
+    if (successful.length > 0) {
+      // Push onto the ring (newest first), cap at 20.
+      this._recentUpdates = [...successful, ...this._recentUpdates].slice(0, 20);
+
+      if (settings.notifyOnUpdate) {
+        const title = successful.length === 1
+          ? 'Script Updated'
+          : `${successful.length} scripts updated`;
+        // Compact message body: list up to 3 names then "+N more".
+        const names = successful.slice(0, 3).map(s => `${s.name} v${s.newVersion}`);
+        const overflow = successful.length - names.length;
+        const message = overflow > 0
+          ? `${names.join(', ')} (+${overflow} more)`
+          : names.join(', ');
+        try {
+          chrome.notifications.create({
+            type: 'basic',
+            iconUrl: 'images/icon128.png',
+            title,
+            message
+          });
+        } catch (_e) { /* notifications may be disabled; non-fatal */ }
+      }
+    }
+
     await SettingsManager.set('lastUpdateCheck', Date.now());
+  },
+
+  /** Return the most recent successful auto-updates (newest first). */
+  getRecentUpdates() {
+    return this._recentUpdates.slice();
+  },
+
+  /** Clear the recent-updates ring (called when the dashboard banner is dismissed). */
+  clearRecentUpdates() {
+    this._recentUpdates = [];
   }
 };
 
@@ -1532,6 +1582,14 @@ async function handleMessage(message, sender) {
       case 'checkUpdates':
         return await UpdateSystem.checkForUpdates(data?.scriptId);
 
+      // Phase 12.10 — recently-applied updates for the in-app dashboard banner.
+      case 'getRecentUpdates':
+        return UpdateSystem.getRecentUpdates();
+
+      case 'clearRecentUpdates':
+        UpdateSystem.clearRecentUpdates();
+        return { success: true };
+
       case 'forceUpdate': {
         // Force re-download bypassing HTTP cache
         const scriptId = data.scriptId;
diff --git a/background.js b/background.js
@@ -1,4 +1,4 @@
-// ScriptVault v3.6.3 - Background Service Worker
+// ScriptVault v3.7.0 - Background Service Worker
 // Comprehensive userscript manager with cloud sync and auto-updates
 // NOTE: This file is built from source modules. Edit the individual files in
 // shared/, modules/, and lib/, then run `npm run build` to regenerate.
@@ -11074,19 +11074,20 @@ const UpdateSystem = {
     // Persist to storage after registration attempt
     await ScriptStorage.set(scriptId, script);
 
-    const settings = await SettingsManager.get();
-    if (settings.notifyOnUpdate) {
-      chrome.notifications.create({
-        type: 'basic',
-        iconUrl: 'images/icon128.png',
-        title: 'Script Updated',
-        message: `${script.meta.name} updated to v${script.meta.version}`
-      });
-    }
-
+    // Phase 12.10 — applyUpdate no longer fires a per-script OS notification.
+    // Instead, the autoUpdate caller aggregates successful updates into a
+    // single summary notification (or none, when notifyOnUpdate is off), and
+    // pushes them onto the recent-updates ring so the dashboard can surface
+    // an in-app banner. Manual single-script updates (popup "Check for
+    // Update", dashboard force-update) get their feedback inline via the
+    // returned { success, script } payload.
     return { success: true, script };
   },
-  
+
+  // Phase 12.10 — recently-applied updates ring buffer surfaced to the
+  // dashboard via the `getRecentUpdates` background message. Capped at 20.
+  _recentUpdates: [],
+
   async autoUpdate() {
     const settings = await SettingsManager.get();
     if (!settings.autoUpdate) return;
@@ -11099,7 +11100,56 @@ const UpdateSystem = {
       console.error('[ScriptVault] Auto-update failures:', failed.map(r => r.reason?.message || r.reason));
     }
 
+    // Aggregate successful updates for in-app surfacing + a single summary
+    // OS notification (only fired when the user opted in via notifyOnUpdate).
+    const successful = [];
+    results.forEach((r, idx) => {
+      if (r.status === 'fulfilled' && r.value?.success && updates[idx]) {
+        successful.push({
+          id: updates[idx].id,
+          name: updates[idx].name,
+          previousVersion: updates[idx].currentVersion,
+          newVersion: updates[idx].newVersion,
+          appliedAt: Date.now()
+        });
+      }
+    });
+    if (successful.length > 0) {
+      // Push onto the ring (newest first), cap at 20.
+      this._recentUpdates = [...successful, ...this._recentUpdates].slice(0, 20);
+
+      if (settings.notifyOnUpdate) {
+        const title = successful.length === 1
+          ? 'Script Updated'
+          : `${successful.length} scripts updated`;
+        // Compact message body: list up to 3 names then "+N more".
+        const names = successful.slice(0, 3).map(s => `${s.name} v${s.newVersion}`);
+        const overflow = successful.length - names.length;
+        const message = overflow > 0
+          ? `${names.join(', ')} (+${overflow} more)`
+          : names.join(', ');
+        try {
+          chrome.notifications.create({
+            type: 'basic',
+            iconUrl: 'images/icon128.png',
+            title,
+            message
+          });
+        } catch (_e) { /* notifications may be disabled; non-fatal */ }
+      }
+    }
+
     await SettingsManager.set('lastUpdateCheck', Date.now());
+  },
+
+  /** Return the most recent successful auto-updates (newest first). */
+  getRecentUpdates() {
+    return this._recentUpdates.slice();
+  },
+
+  /** Clear the recent-updates ring (called when the dashboard banner is dismissed). */
+  clearRecentUpdates() {
+    this._recentUpdates = [];
   }
 };
 
@@ -12187,6 +12237,14 @@ async function handleMessage(message, sender) {
       case 'checkUpdates':
         return await UpdateSystem.checkForUpdates(data?.scriptId);
 
+      // Phase 12.10 — recently-applied updates for the in-app dashboard banner.
+      case 'getRecentUpdates':
+        return UpdateSystem.getRecentUpdates();
+
+      case 'clearRecentUpdates':
+        UpdateSystem.clearRecentUpdates();
+        return { success: true };
+
       case 'forceUpdate': {
         // Force re-download bypassing HTTP cache
         const scriptId = data.scriptId;
diff --git a/manifest.json b/manifest.json
@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "__MSG_extName__",
-  "version": "3.6.3",
+  "version": "3.7.0",
   "description": "__MSG_extDescription__",
   "default_locale": "en",
   "minimum_chrome_version": "120",
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "scriptvault",
-  "version": "3.6.3",
+  "version": "3.7.0",
   "private": true,
   "type": "module",
   "scripts": {
diff --git a/pages/dashboard.js b/pages/dashboard.js
@@ -1712,6 +1712,11 @@
         // Lazy-init the scripts tab (default active tab) so CardView etc. are available
         lazyInitTab('scripts');
 
+        // Phase 12.10 — show an in-app banner if scripts auto-updated since
+        // the last dashboard visit. Replaces the per-script OS notification
+        // spam.
+        showRecentUpdatesBanner();
+
         const route = getDashboardRoute();
         if (route.type === 'new') {
             createNewScript();
@@ -1942,6 +1947,47 @@
         });
     }
     
+    // Phase 12.10 — In-app banner replacing the per-script update OS
+    // notification spam. Pulls the recent-updates ring from background;
+    // dismiss → clearRecentUpdates so the banner stays gone next visit.
+    async function showRecentUpdatesBanner() {
+        try {
+            const updates = await chrome.runtime.sendMessage({ action: 'getRecentUpdates' });
+            if (!Array.isArray(updates) || updates.length === 0) return;
+
+            const panel = document.getElementById('scriptsPanel');
+            if (!panel) return;
+
+            // Compose a compact summary — list up to 3 names with old → new
+            // versions, then "+N more" overflow.
+            const head = updates.slice(0, 3).map(u =>
+                `${escapeHtml(u.name || u.id || 'Unnamed')} <span style="opacity:0.7">v${escapeHtml(u.previousVersion || '?')} → v${escapeHtml(u.newVersion || '?')}</span>`
+            );
+            const overflow = updates.length - head.length;
+            const list = head.join(' · ') + (overflow > 0 ? ` <span style="opacity:0.7">(+${overflow} more)</span>` : '');
+
+            const banner = document.createElement('div');
+            banner.className = 'recent-updates-banner';
+            banner.innerHTML = `
+                <div style="display:flex;align-items:center;gap:12px;padding:10px 16px;background:linear-gradient(135deg,rgba(34,197,94,0.12),rgba(96,165,250,0.12));border:1px solid rgba(34,197,94,0.25);border-radius:8px;margin:8px 12px;font-size:13px">
+                    <div style="flex:1;min-width:0;color:var(--text-primary)">
+                        <strong>${updates.length === 1 ? 'Script updated' : `${updates.length} scripts updated`}:</strong>
+                        ${list}
+                    </div>
+                    <button id="btnRecentUpdatesDismiss" type="button" aria-label="Dismiss" style="background:none;border:none;color:var(--text-muted);cursor:pointer;font-size:18px;padding:4px;line-height:1">&times;</button>
+                </div>
+            `;
+            panel.insertBefore(banner, panel.firstChild);
+
+            document.getElementById('btnRecentUpdatesDismiss')?.addEventListener('click', async () => {
+                banner.remove();
+                try { await chrome.runtime.sendMessage({ action: 'clearRecentUpdates' }); } catch (_e) {}
+            });
+        } catch (_e) {
+            // Background message failure isn't fatal — banner just won't show.
+        }
+    }
+
     // Check if userScripts API is available and enabled
     async function checkUserScriptsAvailability() {
         const banner = document.getElementById('setupWarningBanner');

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"manifest_version": 3,`
`3`	`3`	`"name": "__MSG_extName__",`
`4`		`- "version": "3.6.3",`
	`4`	`+ "version": "3.7.0",`
`5`	`5`	`"description": "__MSG_extDescription__",`
`6`	`6`	`"default_locale": "en",`
`7`	`7`	`"minimum_chrome_version": "120",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "scriptvault",`
`3`		`- "version": "3.6.3",`
	`3`	`+ "version": "3.7.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`