feat: add version-history handoff links for Greasy Fork and GitHub sources

Author: SysAdminDoc

CHANGELOG.md

@@ -24,6 +24,7 @@ All notable changes to ScriptHunt will be documented in this file.
 - Diagnostics exports now include `schema: "scripthunt-diagnostics"` and `schemaVersion: 1` for future replay/migration, plus preference schema diagnostics.
 - Installed-script import now recognizes Violentmonkey/ScriptCat manager backup formats (`meta.name`/`custom.includes` shape and `list` arrays) alongside ScriptHunt JSON and generic arrays. Manager backups show "(detected manager backup)" in the import toast.
 - Live source canary tests (`npm run test:canary`) verify Greasy Fork, ScriptCat, GitHub, and allorigins proxy are reachable with expected response shapes. Excluded from the default deterministic test suite.
+- Result cards show "Version History" links for Greasy Fork (versions page) and GitHub (commits page) sources. Scrape-only sources omit the link.
 
 ## [v0.4.1]
 

ROADMAP.md

@@ -17,9 +17,3 @@
   Complexity: M
 
 
-- [ ] P3 — Add source version-history and diff handoff links
-  Why: Users deciding whether to install or update need a quick path to source history, but ScriptHunt should link to catalog/GitHub history instead of hosting script versions itself.
-  Evidence: OpenUserJS#1023, Tampermonkey#2015, GitHub Search API docs; index.html:1438, index.html:1473, index.html:1573.
-  Touches: index.html source normalizers/result cards/comparison modal, adapter fixtures, README source notes.
-  Acceptance: result cards show source-history or diff links when a source provides a stable history/repository URL, omit them otherwise, and tests cover Greasy Fork, GitHub repository/code, and scrape-only fallback behavior.
-  Complexity: M

index.html

@@ -1716,14 +1716,16 @@ <h3>Search userscripts everywhere</h3>
     }
 
     function normGF(item, srcId) {
+        var pageUrl = item.url || ('https://greasyfork.org/en/scripts/' + item.id);
         return { id: srcId + '-' + item.id, source: srcId, name: item.name || 'Untitled', description: item.description || '',
             author: (item.users && item.users[0] && item.users[0].name) || 'Unknown',
-            url: item.url || ('https://greasyfork.org/en/scripts/' + item.id),
+            url: pageUrl,
             installUrl: item.code_url || '', version: item.version || '',
             dailyInstalls: item.daily_installs || 0, totalInstalls: item.total_installs || 0,
             rating: item.good_ratings || 0, badRating: item.bad_ratings || 0,
             createdAt: item.created_at || '', updatedAt: item.code_updated_at || '',
-            license: normalizeLicense(item.license), _gfId: item.id };
+            license: normalizeLicense(item.license), _gfId: item.id,
+            historyUrl: pageUrl ? pageUrl.replace(/\/?$/, '/versions') : '' };
     }
 
     /* ===== Source: GitHub Repos ===== */
@@ -1753,7 +1755,8 @@ <h3>Search userscripts everywhere</h3>
             author: (item.owner && item.owner.login) || 'Unknown', url: item.html_url, installUrl: '',
             version: '', dailyInstalls: 0, totalInstalls: 0, rating: item.stargazers_count || 0, badRating: 0,
             createdAt: item.created_at || '', updatedAt: item.updated_at || '',
-            license: normalizeLicense(item.license && item.license.spdx_id), stars: item.stargazers_count || 0, forks: item.forks_count || 0, language: item.language || '' };
+            license: normalizeLicense(item.license && item.license.spdx_id), stars: item.stargazers_count || 0, forks: item.forks_count || 0, language: item.language || '',
+            historyUrl: item.html_url ? item.html_url + '/commits' : '' };
     }
 
     /* ===== Source: GitHub Code Search (authenticated) ===== */
@@ -2515,6 +2518,7 @@ <h3>Search userscripts everywhere</h3>
             h += '<div class="card-meta">' + meta.join('') + '</div>';
             h += '<div class="trust-details" id="' + trustId + '">' + renderTrustDetails(item) + '</div>';
             var urlLinks = renderScriptUrlLinks(item);
+            if (item.historyUrl) urlLinks += '<a class="script-url-link" href="' + safeHref(item.historyUrl) + '" target="_blank" rel="noopener">Version History</a>';
             if (urlLinks) h += '<div class="script-url-list">' + urlLinks + '</div>';
             h += renderAppliesToEvidence(item._appliesTo);
             h += renderProvenance(item, installed);