feat: add schema version to diagnostics exports for replay compatibility

Author: SysAdminDoc

CHANGELOG.md

@@ -21,6 +21,7 @@ All notable changes to ScriptHunt will be documented in this file.
 - Versioned preference storage (schema v2) with automatic migration on load. "Reset Preferences" button in diagnostics clears preferences, source health, caches, and saved searches without deleting favorites or installed scripts. Preference schema version appears in diagnostics export.
 - Accessibility regression tests for diagnostics popover (Escape close), saved searches popover visibility, and mobile viewport (375px) verifying no clipped primary controls.
 - GitHub rate-limit status now shows searches remaining, budget fraction, reset time, result cap (1,000), and whether code search is enabled (token vs. no-token).
+- Diagnostics exports now include `schema: "scripthunt-diagnostics"` and `schemaVersion: 1` for future replay/migration, plus preference schema diagnostics.
 
 ## [v0.4.1]
 

ROADMAP.md

@@ -9,12 +9,6 @@
   Acceptance: imports recognize ScriptHunt JSON plus at least two manager-style backup shapes via fixtures, show a preview with valid/invalid/skipped counts before committing, preserve include/exclude/update metadata where present, and never import executable code into storage.
   Complexity: L
 
-- [ ] P2 - Add diagnostics snapshot replay fixtures
-  Why: Source/proxy failures are currently copyable but not replayable, making reported failures harder to turn into deterministic regressions without secrets.
-  Evidence: `index.html:3498`, `tests/adapter.spec.js:136`, Violentmonkey#2263, ScriptCat#1476.
-  Touches: `index.html` diagnostics schema/sanitizer, `tests/smoke.spec.js`, `tests/fixtures/source-adapters.js`, README diagnostics notes.
-  Acceptance: diagnostics exports include a schema version and sanitized replay section; a local fixture/test can load a diagnostics snapshot to recreate source status/rate-limit/proxy/cache states; tokens and custom proxy URLs remain redacted.
-  Complexity: M
 
 ## P3
 

index.html

@@ -3643,6 +3643,8 @@ <h3>Search userscripts everywhere</h3>
 
     function buildDiagnosticsPayload() {
         return {
+            schema: 'scripthunt-diagnostics',
+            schemaVersion: 1,
             app: 'ScriptHunt',
             version: document.querySelector('.version').textContent,
             generatedAt: new Date().toISOString(),

tests/smoke.spec.js

@@ -965,9 +965,13 @@ test('diagnostics export includes health and excludes secrets', async ({ page })
   const payloadText = await page.locator('#diagnosticsOutput').inputValue();
   const payload = JSON.parse(payloadText);
 
+  expect(payload.schema).toBe('scripthunt-diagnostics');
+  expect(payload.schemaVersion).toBe(1);
   expect(payload.app).toBe('ScriptHunt');
   expect(payload.sources.length).toBeGreaterThan(0);
   expect(payload.proxyHealth).toBeTruthy();
+  expect(payload.preferences).toBeTruthy();
+  expect(payload.preferences.schemaVersion).toBeGreaterThan(0);
   expect(payloadText).not.toContain('ghp_secret_should_not_export');
   expect(payloadText).not.toContain('secret-proxy.example');
   expect(payload.customProxyConfigured).toBe(false);