Merge branch 'unstable' into ai/debug-frontend-13808877327263676633

issues/upgrade-major-deps.md

@@ -0,0 +1,35 @@
+# Major Dependency Upgrades Needed
+
+The following dependencies have major version upgrades available. These require manual review and potentially migration guides.
+
+## Packages
+
+### tailwindcss
+- **Current:** `3.4.19`
+- **Latest:** `4.1.18`
+- **Notes:** Tailwind v4 is a significant rewrite. Breaking changes expected in configuration and build process.
+
+### stylelint
+- **Current:** `16.26.1`
+- **Latest:** `17.1.0`
+- **Notes:** Check for deprecated rules and config format changes.
+
+### pixelmatch
+- **Current:** `5.3.0`
+- **Latest:** `7.1.0`
+- **Notes:** Used in visual tests. Verify image comparison logic remains compatible.
+
+### esbuild
+- **Current:** `0.25.12`
+- **Latest:** `0.27.2`
+- **Notes:** Check build scripts (`scripts/build-beacon.mjs`) for compatibility.
+
+### prettier-plugin-tailwindcss
+- **Current:** `0.6.14`
+- **Latest:** `0.7.2`
+- **Notes:** Minor version bump but 0.x semantic.
+
+## Action Items
+- [ ] Create individual tasks for each major upgrade.
+- [ ] Review migration guides for each package.
+- [ ] Create branches for each upgrade to isolate regressions.

issues/upgrade-nostr-tools.md

@@ -1,21 +1,15 @@
 # Upgrade nostr-tools
 
-## Status
-- **Current (Package):** `^2.19.4`
-- **Current (Vendor):** `2.17.0` (found in `vendor/nostr-tools.bundle.min.js`)
-- **Latest:** `2.21.0`
+**Package:** `nostr-tools`
+**Current Version:** `2.20.0`
+**Wanted Version:** `2.22.1`
+**Latest Version:** `2.22.1`
 
 ## Details
-`nostr-tools` is a core protocol library.
-There is a discrepancy between `package.json` (2.19.4) and the vendored bundle (2.17.0).
-The latest version 2.21.0 is available.
+This package was identified as a critical dependency (cryptographic/protocol library). Automatic upgrade was skipped.
 
-## Plan
-1. Review changelogs for breaking changes between 2.17.0/2.19.4 and 2.21.0.
-2. Update `package.json` to `2.21.0`.
-3. Update `vendor/nostr-tools.bundle.min.js` to match the new version.
-4. Verify `js/nostr/client.js` and other consumers work correctly.
-5. Run full E2E and Unit tests.
-
-## Guardrails
-- Protocol library: Requires manual review.
+## Action Items
+- [ ] Review changelog for `nostr-tools` between 2.20.0 and 2.22.1.
+- [ ] Verify no breaking changes in NIP implementations.
+- [ ] Test cryptographic functions manually or via specific test suite.
+- [ ] Apply upgrade manually.