Fix duplicate AI chat error display

- Implement 5 read-only tools: get_feed, search_users, search_follow_packs, fetch_page, fetch_event
- Upgrade useShakespeare streaming to support tool calls, AbortSignal, and robust SSE parsing
- Create useAIChatSession hook with streaming, 10-round tool loop, localStorage persistence
- Rewrite AIChatPage with modular architecture, streaming UI, tool call badges, and empty-bubble handling
- Add Agent settings section with model dropdown selector and pre-populated system prompt editor
- Add Agent to left sidebar navigation and right widget sidebar defaults
- Add aiModel and aiSystemPrompt config fields with encrypted settings sync

.agents/skills/lockdown-mode/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: lockdown-mode
+description: Apple Lockdown Mode restrictions and their impact on web APIs inside WKWebView/Safari/WebView. Reference when debugging or building features for lockdown-enabled devices.
+---
+
+# Apple Lockdown Mode
+
+Apple's Lockdown Mode is an opt-in security hardening profile that disables or restricts many web platform APIs inside Safari and WKWebView. Since this app ships inside a Capacitor WKWebView shell, **every restriction that applies to Safari also applies to our app**.
+
+## Platform Availability
+
+Lockdown Mode is available on:
+
+- **iOS 16** or later (iPhone)
+- **iPadOS 16** or later (iPad)
+- **watchOS 10** or later (Apple Watch)
+- **macOS Ventura** or later (Mac)
+
+Additional protections are available starting in iOS 17, iPadOS 17, watchOS 10, and macOS Sonoma.
+
+For full details, see [About Lockdown Mode](https://support.apple.com/en-us/105120) on Apple Support.
+
+## Testing Baseline
+
+This document is based on testing against **iOS 18.7 / Safari 26.4** on an iPhone with Lockdown Mode enabled (April 2026). The web API restrictions documented below apply to Safari and WKWebView across all supported platforms (iOS, iPadOS, and macOS).
+
+## Blocked APIs
+
+These APIs are **completely unavailable** (return `undefined`, `null`, or throw) when Lockdown Mode is active.
+
+| API | Impact | Notes |
+|-----|--------|-------|
+| **IndexedDB** | Critical | `indexedDB` global is missing entirely. Any library that relies on IndexedDB for storage will fail (Dexie, idb, localForage with IndexedDB driver, etc.). |
+| **Service Workers** | High | `navigator.serviceWorker` is absent. No offline caching, no background sync, no push notifications via SW. |
+| **Cache API** | High | `caches` global is absent. Often used alongside Service Workers for offline strategies. |
+| **WebAssembly** | High | `WebAssembly` global is `undefined`. Libraries compiled to WASM (e.g. libsodium-wrappers, secp256k1-wasm, SQLite WASM) will not load. |
+| **Web Locks** | High | `navigator.locks` is absent. Cross-tab coordination patterns that depend on this will break silently. |
+| **WebRTC** | High | `RTCPeerConnection` is absent. No peer-to-peer audio/video/data channels. |
+| **WebGL / WebGL2** | Medium | All canvas `getContext('webgl'*)` calls return `null`. GPU-accelerated rendering, maps (Mapbox GL, deck.gl), and 3D are broken. |
+| **FileReader** | Medium | `FileReader` constructor is absent. Cannot read `Blob`/`File` objects client-side (e.g. image preview before upload). Use the `File` constructor + `URL.createObjectURL()` as a workaround for previews. |
+| **SharedArrayBuffer** | Medium | `SharedArrayBuffer` is `undefined`. May also require COOP/COEP headers on non-lockdown browsers, so this is often already unavailable. |
+| **Speech Synthesis** | Low | `window.speechSynthesis` is absent. Text-to-speech features won't work. |
+| **Notifications API** | Low | `Notification` is absent. Web push permission prompts won't appear. (Capacitor local notifications via the native plugin are unaffected.) |
+| **WebCodecs** | Low | `VideoDecoder` / `VideoEncoder` are absent (`AudioDecoder` remains). Low-level media processing is unavailable. |
+| **Gamepad API** | Low | `navigator.getGamepads` is absent. |
+| **OPFS** | Medium | `navigator.storage.getDirectory` method does not exist. The `navigator.storage` object is present but the Origin Private File System API is stripped. SQLite-over-OPFS and any other OPFS-based storage will fail. |
+| **Web Share API** | Low | `navigator.share` is absent. Use Capacitor's `@capacitor/share` plugin instead -- the native share sheet still works. |
+
+## Available APIs
+
+These APIs **still work** under Lockdown Mode and can be relied on.
+
+| API | Notes |
+|-----|-------|
+| **File constructor** | `new File(...)` works. You can create File/Blob objects. |
+| **FontFace API** | Dynamic font loading via `new FontFace()` succeeds. Remote font fetches may fail with a network error (data URIs rejected). |
+| **JIT compilation** | JavaScript JIT appears active (~110ms for 1M iterations). Performance is not interpreter-level degraded. |
+| **PDF viewer** | `navigator.pdfViewerEnabled` is `true`. Inline `<embed type="application/pdf">` works. |
+| **Cookies** | `navigator.cookieEnabled` is `true`. |
+| **Credential Management** | `navigator.credentials` is available. |
+| **localStorage / sessionStorage** | Standard Web Storage APIs remain functional. |
+
+## Implications for This App
+
+### Storage
+
+- **localStorage works** -- our primary client-side storage (app config, relay lists, etc.) is unaffected.
+- **IndexedDB is gone** -- if any dependency silently uses IndexedDB (e.g. some Nostr caching layers, TanStack Query persisters), it will fail. Ensure all storage paths fall back to localStorage or in-memory.
+- **OPFS is gone** -- `navigator.storage.getDirectory` is stripped (the method doesn't exist, though the `navigator.storage` object itself remains). SQLite-over-OPFS (e.g. wa-sqlite, sql.js with OPFS backend) and any other OPFS-based persistence will not work.
+
+### Cryptography
+
+- **WebAssembly is blocked** -- any WASM-based crypto libraries (secp256k1 compiled to WASM, libsodium WASM builds) will not load. Use pure-JS implementations (e.g. `@noble/secp256k1`, `@noble/hashes`) which are already what nostr-tools uses.
+- **WebCrypto (`crypto.subtle`)** -- not listed as blocked in testing. The SubtleCrypto API should still be available for NIP-44 encryption via the standard Web Crypto path.
+
+### Media & Rendering
+
+- **WebGL is gone** -- map libraries that require WebGL (Mapbox GL JS, Google Maps WebGL renderer) will show blank canvases. Use raster tile alternatives or static map images.
+- **FileReader is gone** -- image/file preview workflows that use `FileReader.readAsDataURL()` need a workaround. Use `URL.createObjectURL(file)` directly for `<img src>` previews instead.
+
+### Communication
+
+- **WebRTC is gone** -- any peer-to-peer features (voice/video calls, WebRTC data channels) are completely unavailable.
+- **Fetch / XMLHttpRequest** -- standard network requests appear unaffected. Relay WebSocket connections should work normally.
+
+### Native Plugin Workarounds
+
+Several blocked web APIs have Capacitor plugin equivalents that bypass WKWebView restrictions entirely:
+
+| Blocked Web API | Capacitor Alternative |
+|---|---|
+| Web Share | `@capacitor/share` (already installed) |
+| Notifications | `@capacitor/local-notifications` (already installed) |
+| File downloads | `@capacitor/filesystem` + share (already implemented in `downloadFile.ts`) |
+
+### Detection
+
+The report used a scoring heuristic (8/12 key APIs blocked = 70%) to detect Lockdown Mode. There is no official API to query Lockdown Mode status. Detection relies on probing for the absence of multiple APIs that are specifically disabled by Lockdown Mode but normally present in Safari.
+
+## Raw Diagnostic Report
+
+For exact error messages, navigator properties, weight scores, and per-API diagnostic output, see [ios-report.txt](ios-report.txt).
+
+## Guidance for Feature Decisions
+
+When building new features, consider:
+
+1. **Always provide pure-JS fallbacks** for any crypto or data-processing library that might ship a WASM build.
+2. **Never depend on IndexedDB or OPFS** as the sole storage mechanism. Both are completely stripped. Always fall back to localStorage or in-memory stores.
+3. **Avoid WebGL-dependent UI** for core functionality. Use it as a progressive enhancement with a CSS/Canvas 2D fallback.
+4. **Use Capacitor plugins** for sharing, notifications, and file operations rather than web APIs -- they work on all native platforms regardless of Lockdown Mode.
+5. **Test on a Lockdown Mode device** when shipping features that touch storage, crypto, or media APIs.

.agents/skills/lockdown-mode/ios-report.txt

@@ -0,0 +1,229 @@
+============================================================
+LOCKDOWN MODE DETECTOR REPORT
+2026-04-06T23:40:58.170Z
+============================================================
+
+VERDICT: Lockdown Mode Likely Active
+8 of 12 key APIs are blocked, consistent with iOS/macOS Lockdown Mode.
+Score: 70% (8/12 key APIs blocked)
+
+============================================================
+API TEST RESULTS (detailed)
+============================================================
+
+------------------------------------------------------------
+[BLOCKED] IndexedDB (weight: 3)
+  Client-side structured storage
+  Result: Can't find variable: indexedDB
+  Diagnostics:
+    uncaught: Can't find variable: indexedDB
+
+------------------------------------------------------------
+[BLOCKED] WebAssembly (weight: 2)
+  Binary instruction execution
+  Result: WebAssembly is undefined
+  Diagnostics:
+    typeof WebAssembly: undefined
+    WebAssembly global does not exist
+
+------------------------------------------------------------
+[BLOCKED] Web Locks API (weight: 3)
+  Cross-tab resource coordination
+  Result: navigator.locks is undefined
+  Diagnostics:
+    typeof navigator.locks: undefined
+    'locks' in navigator: false
+    navigator.locks is falsy
+
+------------------------------------------------------------
+[BLOCKED] Speech Synthesis (weight: 3)
+  Web Speech API (text-to-speech)
+  Result: window.speechSynthesis is undefined
+  Diagnostics:
+    typeof window.speechSynthesis: undefined
+    'speechSynthesis' in window: false
+    typeof SpeechSynthesisUtterance: undefined
+    speechSynthesis is falsy
+
+------------------------------------------------------------
+[BLOCKED] FileReader API (weight: 2)
+  Local file reading interface
+  Result: FileReader is undefined
+  Diagnostics:
+    typeof FileReader: undefined
+    FileReader constructor does not exist
+
+------------------------------------------------------------
+[AVAILABLE] File Constructor (weight: 2)
+  File object creation
+  Result: File created: name=test.txt size=4
+  Diagnostics:
+    typeof File: function
+    calling new File(['test'], 'test.txt', {type:'text/plain'})...
+    succeeded
+    f.name: test.txt
+    f.size: 4
+    f.type: text/plain
+    f instanceof Blob: true
+
+------------------------------------------------------------
+[BLOCKED] WebGL (weight: 2)
+  GPU-accelerated graphics
+  Result: all WebGL contexts returned null
+  Diagnostics:
+    getContext('webgl2'): null
+    getContext('webgl'): null
+    getContext('experimental-webgl'): null
+
+------------------------------------------------------------
+[BLOCKED] WebGL2 (weight: 1)
+  Advanced GPU graphics context
+  Result: getContext('webgl2') returned null
+  Diagnostics:
+    getContext('webgl2'): null
+
+------------------------------------------------------------
+[BLOCKED] Service Worker (weight: 1)
+  Background script registration
+  Result: navigator.serviceWorker not present
+  Diagnostics:
+    'serviceWorker' in navigator: false
+    typeof navigator.serviceWorker: undefined
+
+------------------------------------------------------------
+[BLOCKED] Web Share API (weight: 0)
+  Native sharing interface
+  Result: navigator.share is undefined
+  Diagnostics:
+    typeof navigator.share: undefined
+    typeof navigator.canShare: undefined
+
+------------------------------------------------------------
+[BLOCKED] Gamepad API (weight: 1)
+  Game controller input
+  Result: navigator.getGamepads not present
+  Diagnostics:
+    'getGamepads' in navigator: false
+
+------------------------------------------------------------
+[BLOCKED] WebRTC (weight: 2)
+  Real-time peer communication
+  Result: RTCPeerConnection is undefined
+  Diagnostics:
+    typeof RTCPeerConnection: undefined
+    typeof webkitRTCPeerConnection: undefined
+
+------------------------------------------------------------
+[AVAILABLE] FontFace API (weight: 1)
+  Dynamic font loading
+  Result: status: loaded
+  Diagnostics:
+    typeof FontFace: function
+    new FontFace() succeeded
+    ff.status: unloaded
+    ff.family: test
+    ff.status after load: loaded
+
+------------------------------------------------------------
+[AVAILABLE] Remote Fonts (weight: 2)
+  Loading fonts from network via data URI
+  Result: API works, load rejected:  A network error occurred.
+  Diagnostics:
+    FontFace created with data URI
+    ff.status before load: unloaded
+    caught: DOMException:  A network error occurred.
+
+------------------------------------------------------------
+[AVAILABLE] JIT Compilation (weight: 2)
+  JavaScript JIT optimization heuristic
+  Result: 99.0ms for 1M iterations (JIT likely)
+  Diagnostics:
+    running 1,000,000 iterations of Math.sqrt*Math.sin...
+    elapsed: 99.00ms
+    sum (to prevent dead-code elimination): -681.7597
+    threshold: <150ms suggests JIT active
+    verdict: likely JIT
+
+------------------------------------------------------------
+[BLOCKED] Notifications API (weight: 1)
+  Push notification permission
+  Result: Notification not in window
+  Diagnostics:
+    'Notification' in window: false
+    typeof Notification: undefined
+
+------------------------------------------------------------
+[BLOCKED] WebCodecs (weight: 1)
+  Low-level VideoDecoder API
+  Result: VideoDecoder is undefined
+  Diagnostics:
+    typeof VideoDecoder: undefined
+    typeof VideoEncoder: undefined
+    typeof AudioDecoder: function
+
+------------------------------------------------------------
+[AVAILABLE] PDF Embed (weight: 2)
+  Inline PDF rendering via embed/pdfViewerEnabled
+  Result: pdfViewerEnabled is true
+  Diagnostics:
+    navigator.pdfViewerEnabled: true
+    typeof navigator.pdfViewerEnabled: boolean
+    created and appended <embed type=application/pdf>
+    navigator.mimeTypes['application/pdf']: [object MimeType]
+
+------------------------------------------------------------
+[BLOCKED] SharedArrayBuffer (weight: 1)
+  Shared memory between workers
+  Result: SharedArrayBuffer is undefined
+  Diagnostics:
+    typeof SharedArrayBuffer: undefined
+    requires COOP/COEP headers to be present; may not indicate Lockdown Mode specifically
+
+------------------------------------------------------------
+[BLOCKED] Cache API (weight: 1)
+  Programmatic HTTP cache (CacheStorage)
+  Result: caches not in window
+  Diagnostics:
+    'caches' in window: false
+    typeof caches: undefined
+
+------------------------------------------------------------
+[BLOCKED] OPFS (weight: 2)
+  Origin Private File System (navigator.storage.getDirectory)
+  Result: navigator.storage.getDirectory is not a function
+  Diagnostics:
+    typeof navigator.storage: object
+    typeof navigator.storage.getDirectory: undefined
+    getDirectory method does not exist
+
+============================================================
+NAVIGATOR INFO
+============================================================
+
+  userAgent:             Mozilla/5.0 (iPhone; CPU iPhone OS 18_7 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.4 Mobile/15E148 Safari/604.1
+  platform:              iPhone
+  vendor:                Apple Computer, Inc.
+  language:              en-US
+  languages:             en-US
+  cookieEnabled:         true
+  doNotTrack:            null
+  maxTouchPoints:        5
+  hardwareConcurrency:   4
+  deviceMemory:          N/A
+  pdfViewerEnabled:      true
+  webdriver:             false
+  connection:            unavailable
+  mediaDevices:          unavailable
+  storage:               available
+  serviceWorker:         unavailable
+  credentials:           available
+  bluetooth:             unavailable
+  gpu (WebGPU):          unavailable
+  screenWidth:           393
+  screenHeight:          852
+  devicePixelRatio:      3
+  colorDepth:            24
+
+============================================================
+END OF REPORT
+============================================================

.env.example

@@ -2,4 +2,6 @@ VITE_SENTRY_DSN="https://********************************@*****************.exam
 VITE_PLAUSIBLE_DOMAIN="example.tld"
 VITE_PLAUSIBLE_ENDPOINT="https://plausible.example.tld/api/event"
 # Hex pubkey of the nostr-push server (found in nostr-push startup logs as "worker_pubkey")
-VITE_NOSTR_PUSH_PUBKEY=""
+VITE_NOSTR_PUSH_PUBKEY=""
+# Set to "*" to allow any host in the Vite dev server (eg. when proxying through a custom domain)
+# ALLOWED_HOSTS="*"

.gitlab-ci.yml

@@ -26,13 +26,17 @@ test:
   script:
     - npm run test
 
+# Disabled: nsite deploy not needed right now; re-enable by restoring the
+# rules below to run on default branch (and ensure NSITE_NBUNKSEC is set).
 deploy-nsite:
   stage: deploy
   timeout: 10 minutes
   rules:
-    - if: $CI_COMMIT_TAG
-      when: never
-    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+    - when: never
+  # rules:
+  #   - if: $CI_COMMIT_TAG
+  #     when: never
+  #   - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
   variables:
     NSYTE_VERSION: "v0.24.1"
   script:
@@ -50,14 +54,29 @@ deploy-nsite:
       nsyte deploy ./dist
       -i
       --sec "$NSITE_NBUNKSEC"
-      --name ditto
+      --name agora
       --relays "wss://relay.ditto.pub,wss://relay.nsite.lol,wss://relay.dreamith.to,wss://relay.primal.net"
       --servers "https://blossom.primal.net,https://blossom.ditto.pub,https://blossom.dreamith.to"
       --fallback "/index.html"
-      --publish-server-list
       --use-fallback-relays
       --use-fallback-servers
 
+build-web:
+  stage: build
+  timeout: 10 minutes
+  needs: []
+  rules:
+    - if: $CI_COMMIT_TAG
+      when: never
+    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
+  script:
+    - npm ci
+    - npm run build
+    - cp dist/index.html dist/404.html
+  artifacts:
+    paths:
+      - dist/
+
 build-apk:
   stage: build
   image: eclipse-temurin:21-jdk
@@ -130,32 +149,33 @@ build-apk:
     - npx vite build -l error
     - cp dist/index.html dist/404.html
 
-    # Sync web assets to Capacitor Android project
+    # Sync web assets to Capacitor Android project and register local plugins
     - npx cap sync android
+    - node scripts/patch-cap-config.mjs
 
     # Build signed release APK
     - cd android && chmod +x gradlew && ./gradlew assembleRelease bundleRelease && cd ..
 
     # Copy APK to a predictable artifact path
     - mkdir -p artifacts
-    - cp android/app/build/outputs/apk/release/app-release.apk "artifacts/Ditto.apk"
-    - cp android/app/build/outputs/bundle/release/app-release.aab "artifacts/Ditto.aab"
+    - cp android/app/build/outputs/apk/release/app-release.apk "artifacts/Agora.apk"
+    - cp android/app/build/outputs/bundle/release/app-release.aab "artifacts/Agora.aab"
     - ls -lh artifacts/
 
     # Upload to Generic Packages registry for a stable public download URL
     - |
       curl --fail --header "JOB-TOKEN: ${CI_JOB_TOKEN}" \
-        --upload-file "artifacts/Ditto.apk" \
-        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/ditto/${CI_COMMIT_TAG}/Ditto-${CI_COMMIT_TAG}.apk"
+        --upload-file "artifacts/Agora.apk" \
+        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/agora/${CI_COMMIT_TAG}/Agora-${CI_COMMIT_TAG}.apk"
     - |
       curl --fail --header "JOB-TOKEN: ${CI_JOB_TOKEN}" \
-        --upload-file "artifacts/Ditto.aab" \
-        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/ditto/${CI_COMMIT_TAG}/Ditto-${CI_COMMIT_TAG}.aab"
+        --upload-file "artifacts/Agora.aab" \
+        "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/agora/${CI_COMMIT_TAG}/Agora-${CI_COMMIT_TAG}.aab"
 
   artifacts:
     paths:
-      - artifacts/Ditto.apk
-      - artifacts/Ditto.aab
+      - artifacts/Agora.apk
+      - artifacts/Agora.aab
     expire_in: 90 days
   cache:
     key: android-gradle
@@ -178,7 +198,7 @@ release:
       VERSION="${CI_COMMIT_TAG#v}"
       RELEASE_NOTES=$(awk "/^## \\[${VERSION}\\]/{found=1; next} /^## \\[/{if(found) exit} found{print}" CHANGELOG.md)
       if [ -z "$RELEASE_NOTES" ]; then
-        RELEASE_NOTES="Ditto ${CI_COMMIT_TAG}"
+        RELEASE_NOTES="Agora ${CI_COMMIT_TAG}"
       fi
     - echo "$RELEASE_NOTES" > release-notes.md
   release:
@@ -187,11 +207,11 @@ release:
     description: './release-notes.md'
     assets:
       links:
-        - name: Ditto-${CI_COMMIT_TAG}.apk
-          url: ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/ditto/${CI_COMMIT_TAG}/Ditto-${CI_COMMIT_TAG}.apk
+        - name: Agora-${CI_COMMIT_TAG}.apk
+          url: ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/agora/${CI_COMMIT_TAG}/Agora-${CI_COMMIT_TAG}.apk
           link_type: package
-        - name: Ditto-${CI_COMMIT_TAG}.aab
-          url: ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/ditto/${CI_COMMIT_TAG}/Ditto-${CI_COMMIT_TAG}.aab
+        - name: Agora-${CI_COMMIT_TAG}.aab
+          url: ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/agora/${CI_COMMIT_TAG}/Agora-${CI_COMMIT_TAG}.aab
           link_type: package
 
 publish-zapstore:
@@ -203,6 +223,8 @@ publish-zapstore:
     - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
   variables:
     SIGN_WITH: $ZAPSTORE_BUNKER_URL
+    RELAY_URLS: "wss://relay.zapstore.dev,wss://relay.ditto.pub,wss://relay.dreamith.to,wss://relay.primal.net"
+    BLOSSOM_URL: "https://blossom.ditto.pub"
   script:
     - go install github.com/zapstore/zsp@latest
 
@@ -212,8 +234,37 @@ publish-zapstore:
     - mkdir -p ~/.config/zsp/bunker-keys
     - echo "$ZAPSTORE_CLIENT_KEY" > ~/.config/zsp/bunker-keys/${BUNKER_PUBKEY}.key
 
-    - APK_PATH="artifacts/Ditto.apk"
+    - APK_PATH="artifacts/Agora.apk"
     - VERSION="${CI_COMMIT_TAG#v}"
     - sed -i "2i release_source:\ ./${APK_PATH}" zapstore.yaml
     - sed -i "2i version:\ ${VERSION}" zapstore.yaml
     - zsp publish --quiet --skip-metadata --skip-preview zapstore.yaml
+
+publish-google-play:
+  stage: publish
+  image: ruby:3.3
+  needs:
+    - build-apk
+  rules:
+    - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+  script:
+    - gem install fastlane --no-document
+
+    # Decode base64-encoded service account JSON to a temp file
+    - echo "$GOOGLE_PLAY_SERVICE_ACCOUNT_JSON" | base64 -d > /tmp/play-service-account.json
+
+    # Upload the AAB to Google Play production track
+    - >-
+      fastlane supply
+      --aab artifacts/Agora.aab
+      --package_name pub.agora.app
+      --track production
+      --json_key /tmp/play-service-account.json
+      --skip_upload_metadata
+      --skip_upload_changelogs
+      --skip_upload_images
+      --skip_upload_screenshots
+      --skip_upload_apk
+
+    # Clean up
+    - rm -f /tmp/play-service-account.json

.gitlab/merge_request_templates/Default.md

@@ -0,0 +1,68 @@
+Thanks for contributing to Agora! Please read [CONTRIBUTING.md](CONTRIBUTING.md) in full before submitting -- it covers everything you need to get your MR accepted.
+
+## Related Issue
+
+<!-- Link the GitLab issue. MRs without a linked issue will not be reviewed. -->
+
+Closes #
+
+## What Changed
+
+<!-- 1-3 sentences: what you changed and why. -->
+
+## Live Preview
+
+<!-- REQUIRED for UI changes. Deploy your branch and paste the URL. -->
+<!-- Example: npx surge dist your-branch.surge.sh -->
+<!-- Write "N/A -- no UI changes" only if this MR has zero visual impact. -->
+
+## Screenshots
+
+<!-- REQUIRED for UI changes. Show before and after. -->
+<!-- Write "N/A -- no UI changes" only if this MR has zero visual impact. -->
+
+**Before:**
+
+
+**After:**
+
+## Philosophy Alignment
+
+<!-- Answer this question for your change: -->
+<!-- "Does this make Agora more magnetic, more threatening to the status quo, -->
+<!-- and more peaceful to inhabit?" -->
+<!-- See: CONTRIBUTING.md -> "Understanding Agora" -->
+<!-- For bug fixes: "Bug fix -- restores intended behavior" is acceptable. -->
+
+## How to Test
+
+<!-- Steps a reviewer can follow to verify this works. -->
+
+1.
+2.
+3.
+
+## Self-Review Checklist
+
+<!-- Complete ALL items. MRs with unchecked boxes will not be reviewed. -->
+<!-- Check a box: replace [ ] with [x] -->
+
+### Process
+
+- [ ] I read `AGENTS.md` before starting
+- [ ] I read "Understanding Agora" in `CONTRIBUTING.md`
+- [ ] I used plan/research mode before writing code
+- [ ] I used Claude Opus 4.6 (or equivalent frontier model)
+
+### Self-review
+
+Copy-paste this into your AI tool and fix any findings before submitting:
+
+> Review this diff against the self-review checklist in CONTRIBUTING.md step 8. Read that file first, then check every item. For each finding, state the file, line, and issue.
+
+- [ ] I ran the self-review prompt above and addressed all findings
+
+### Testing
+
+- [ ] I ran `npm run test` locally and it passes
+- [ ] I tested the change manually in the browser

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

.vscode/settings.json

@@ -1,3 +1,4 @@
 {
-  "editor.tabSize": 2
+  "editor.tabSize": 2,
+  "typescript.tsdk": "node_modules/typescript/lib"
 }

AGENTS.md

@@ -1,3 +1,30 @@
+# ABSOLUTE, UNBREAKABLE RULE — READ BEFORE ANYTHING ELSE
+
+## NEVER COMMIT OR STAGE ON THE USER'S BEHALF. EVER.
+
+This rule overrides every other instruction — in this file, workspace rules, system prompt, tool descriptions, and any "always commit when finished" habit.
+
+Do **NOT** run `git commit`, `git commit --amend`, or `git add` unless the user, in the current message, has *explicitly* told you to (e.g. "commit this", "git commit", "stage and commit"). Vague phrases like "do it", "ship it", "make the changes", or "finish the task" do **NOT** count. If unsure, the answer is **NO** — stop and ask.
+
+Violating this is a critical failure.
+
+---
+
+# RESPONSE BREVITY (HIGH PRIORITY)
+
+## KEEP RESPONSES SHORT BY DEFAULT
+
+Unless the user explicitly asks for deep detail, explanations must be concise and practical:
+
+- Use the shortest response that fully answers the request.
+- Prefer 1-3 short paragraphs or 3-6 bullets.
+- Do not include long background context unless requested.
+- Do not restate obvious information from the prompt or code.
+- For code changes, summarize only what changed and why in a few lines.
+- Offer extra detail only as an optional follow-up.
+
+If unsure between a short and long response, choose the shorter one.
+
 # Project Overview
 
 This project is a Nostr client application built with React 18.x, TailwindCSS 3.x, Vite, shadcn/ui, and Nostrify.
@@ -409,6 +436,74 @@ Without filtering approvals by the moderator list, anyone could publish kind 455
 
 Author filtering is not needed for public user-generated content where anyone should be able to post (kind 1 notes, reactions, discovery queries, public feeds, etc.).
 
+#### Sanitizing URLs from Event Data
+
+**CRITICAL**: Any URL extracted from Nostr event tags, content, or metadata fields is **untrusted user input**. Malicious URLs can cause harm in many ways beyond `javascript:` XSS — `data:` URIs for resource exhaustion, `http://` URLs leaking user IPs without TLS, relative paths triggering unintended requests to the app's own origin, and more. Reasoning about which rendering context is "safe enough" to skip sanitization is fragile and error-prone.
+
+**Rule: sanitize every event-sourced URL unconditionally**, regardless of where it will be used (`href`, `img src`, `style`, etc.). Use `sanitizeUrl()` from `@/lib/sanitizeUrl`:
+
+```typescript
+import { sanitizeUrl } from '@/lib/sanitizeUrl';
+
+// Single URL — returns the normalised href, or undefined if not valid https
+const url = sanitizeUrl(getTag(event.tags, 'url'));
+if (url) {
+  // safe to use in any context
+}
+
+// Array of URLs — filter out invalid entries
+const links = getAllTags(event.tags, 'r')
+  .map(([, v]) => sanitizeUrl(v))
+  .filter((v): v is string => !!v);
+```
+
+`sanitizeUrl` accepts `string | undefined | null` and returns the normalised `href` string only when the URL parses successfully **and** uses the `https:` protocol. All other inputs (malformed URLs, `javascript:`, `data:`, `http:`, relative paths, etc.) return `undefined`.
+
+**Best practice — sanitize at the parse layer.** When writing a parser function that extracts URLs from event tags (e.g. `parseThemeDefinition`, `parseBadgeDefinition`), apply `sanitizeUrl()` before returning the parsed data. This way every downstream consumer is automatically protected without needing to remember to sanitize at each usage site.
+
+**When sanitization is NOT required:**
+- URLs extracted by regex that already constrains the protocol (e.g. `NoteContent` tokeniser matches only `https?://`)
+- Hardcoded or application-generated URLs (relay configs, internal routes, etc.)
+- URLs displayed as plain text without being placed into any HTML attribute or CSS value
+
+#### Preventing CSS Injection from Event Data
+
+**CRITICAL**: Any value from a Nostr event that is interpolated into a CSS string (inside a `<style>` element or inline `style` attribute) is a CSS injection vector. A malicious value containing `"`, `)`, `}`, or `;` can break out of the CSS context and inject arbitrary rules — for example, overlaying phishing content or hiding UI elements.
+
+**Common CSS injection surfaces:**
+- `background-image: url("${url}")` — a URL with `"); body { display:none }` breaks out
+- `font-family: "${family}"` — a family name with `"; } body { visibility:hidden } .x {` breaks out
+- `@font-face { src: url("${url}") }` — same risk as background URLs
+
+**Mitigation strategy — sanitize at the parse layer:**
+
+1. **URLs in CSS `url()` values**: Pass through `sanitizeUrl()` at parse time. The `URL` constructor normalises the string, percent-encoding characters like `"`, `)`, and `\` that could escape the CSS context. Invalid or non-`https:` URLs are rejected entirely.
+
+2. **Strings in CSS declarations** (e.g. font family names): Use `sanitizeCssString()` from `src/lib/fontLoader.ts`, which uses an allowlist approach — only Unicode letters, numbers, spaces, hyphens, underscores, apostrophes, and periods are permitted. Everything else is stripped.
+
+```typescript
+// ❌ UNSAFE — raw event data interpolated into CSS
+const bgUrl = getTagValue(event.tags, 'bg');
+style.textContent = `body { background-image: url("${bgUrl}"); }`;
+
+const family = getTagValue(event.tags, 'f');
+style.textContent = `html { font-family: "${family}"; }`;
+
+// ✅ SAFE — URLs validated, strings sanitised
+import { sanitizeUrl } from '@/lib/sanitizeUrl';
+
+const bgUrl = sanitizeUrl(getTagValue(event.tags, 'bg'));
+if (bgUrl) {
+  style.textContent = `body { background-image: url("${bgUrl}"); }`;
+}
+
+// For non-URL strings, allowlist safe characters only
+const safeFamily = family.replace(/[^\p{L}\p{N} _\-'.]/gu, '');
+style.textContent = `html { font-family: "${safeFamily}"; }`;
+```
+
+**Rule of thumb**: Never interpolate untrusted strings into CSS without sanitisation. If it's a URL, use `sanitizeUrl()`. If it's any other string, strip characters that can break out of the CSS string context.
+
 ### The `useNostr` Hook
 
 The `useNostr` hook returns an object containing a `nostr` property, with `.query()` and `.event()` methods for querying and publishing Nostr events respectively.
@@ -699,23 +794,47 @@ The `useCurrentUser` hook should be used to ensure that the user is logged in be
 
 Replaceable (kind 10000-19999) and addressable (kind 30000-39999) events require a read-modify-write cycle: fetch the current event, modify its tags, then publish a new version. **Never read from TanStack Query cache before mutating** -- the cache can be stale from another device or a rapid prior operation, and republishing stale data silently drops the user's data.
 
-Use `fetchFreshEvent()` from `src/lib/fetchFreshEvent.ts` inside every mutation:
+Use `fetchFreshEvent()` from `src/lib/fetchFreshEvent.ts` inside every mutation, and **always pass the fetched event as `prev`** so `useNostrPublish` can preserve `published_at`:
 
 ```typescript
 import { fetchFreshEvent } from '@/lib/fetchFreshEvent';
 
 // Inside a mutation function:
-const freshEvent = await fetchFreshEvent(nostr, {
+const prev = await fetchFreshEvent(nostr, {
   kinds: [10003],
   authors: [user.pubkey],
 });
-const currentTags = freshEvent?.tags ?? [];
+const currentTags = prev?.tags ?? [];
 // ...modify tags...
-await publishEvent({ kind: 10003, content: freshEvent?.content ?? '', tags: newTags });
+await publishEvent({
+  kind: 10003,
+  content: prev?.content ?? '',
+  tags: newTags,
+  prev: prev ?? undefined,
+});
 ```
 
 This applies to all list-type hooks (bookmarks, pins, interests, follow sets, badges, etc.). See `useFollowActions` and `useMuteList` for complete examples.
 
+#### The `prev` Property on Event Templates
+
+`useNostrPublish` accepts an optional `prev` property on the event template. This is the **previous version** of the event being replaced. The hook uses it to automatically manage the `published_at` tag (NIP-24) for replaceable and addressable events:
+
+- **First publish (no `prev`)**: `published_at` is set equal to `created_at`
+- **Update (`prev` provided)**: `published_at` is preserved from the old event
+- **Old event lacks `published_at`**: nothing is fabricated
+- **Caller already set `published_at` in tags**: left alone
+
+**Convention**: Name the local variable `prev` at the call site (not `freshEvent` or `latestEvent`) so it reads naturally when passed to `publishEvent`:
+
+```typescript
+const prev = await fetchFreshEvent(nostr, { kinds: [3], authors: [user.pubkey] });
+// ...
+await publishEvent({ kind: 3, content: prev?.content ?? '', tags: newTags, prev: prev ?? undefined });
+```
+
+`prev` is stripped from the template before signing — it never appears in the published Nostr event.
+
 ### D-Tag Collision Prevention for Addressable Events
 
 Addressable events (kind 30000-39999) are identified by `pubkey + kind + d-tag`. Publishing an event with the same d-tag as an existing one **silently replaces** it. This is by design for intentional updates (edit flows), but dangerous when creating *new* content with user-derived d-tags (slugs from titles, user-entered identifiers, etc.).
@@ -1071,6 +1190,7 @@ The router includes automatic scroll-to-top functionality and a 404 NotFound pag
 - Default connection to one Nostr relay for best performance
 - Comprehensive provider setup with NostrLoginProvider, QueryClientProvider, and custom AppProvider
 - **Never use the `any` type**: Always use proper TypeScript types for type safety
+- **Fail-fast error visibility**: Never silently hide errors in the UI. If data fails validation, a resource fails to load, or a user action errors, surface an explicit visible error state/message so users can see what failed and why.
 
 ## Loading States
 
@@ -1301,23 +1421,24 @@ Run available tools in this priority order:
 2. **Building/Compilation** (Required): Verify the project builds successfully
 3. **Linting** (Recommended): Check code style and catch potential issues
 4. **Tests** (If Available): Run existing test suite
-5. **Git Commit** (Required): Create a commit with your changes when finished
 
 **Minimum Requirements:**
 - Code must type-check without errors
 - Code must build/compile successfully
 - Fix any critical linting errors that would break functionality
-- Create a git commit when your changes are complete
+- **Do NOT commit.** Leave changes uncommitted for the user to review. See the "ABSOLUTE, UNBREAKABLE RULE" at the top of this file.
 
 The validation ensures code quality and catches errors before deployment, regardless of the development environment.
 
+### Contributing Guide
+
+When preparing changes for a merge request, also follow the guidelines in `CONTRIBUTING.md`. It includes a self-review checklist (step 8) that should be run against your diff before committing.
+
 ### Using Git
 
 If git is available in your environment (through a `shell` tool, or other git-specific tools), you should utilize `git log` to understand project history. Use `git status` and `git diff` to check the status of your changes, and if you make a mistake use `git checkout` to restore files.
 
-When your changes are complete and validated, create a git commit with a descriptive message summarizing your changes.
-
-**ALWAYS commit when you are finished making changes. This is non-negotiable -- every completed task must end with a git commit. Never leave uncommitted changes.**
+When your changes are complete and validated, leave the working tree as-is for the user to review. **Do NOT create a git commit unless the user has explicitly told you to in the current message.** See the "ABSOLUTE, UNBREAKABLE RULE" at the top of this file — it overrides any habit or template guidance about always committing at the end of a task.
 
 ## Capacitor Compatibility
 
@@ -1388,7 +1509,7 @@ The project uses GitLab CI (`.gitlab-ci.yml`) with the following stages:
 2. **deploy** - Builds and deploys to nsite via nsyte (`deploy-nsite` job, default branch only)
 3. **build** - Builds a signed release APK (`build-apk` job, tags only)
 4. **release** - Creates a GitLab Release with the APK artifact (tags only)
-5. **publish** - Publishes the APK to Zapstore (`publish-zapstore` job, tags only)
+5. **publish** - Publishes the APK to Zapstore (`publish-zapstore` job, tags only) and AAB to Google Play (`publish-google-play` job, tags only)
 
 ### Creating a Release
 
@@ -1398,7 +1519,7 @@ Releases are triggered by pushing a version tag. Use the npm script:
 npm run release
 ```
 
-This creates a tag in the format `v2026.03.14+abc1234` (date + short commit hash) and pushes it to GitLab, which triggers the `build-apk`, `release`, and `publish-zapstore` stages.
+This creates a tag in the format `v2026.03.14+abc1234` (date + short commit hash) and pushes it to GitLab, which triggers the `build-apk`, `release`, `publish-zapstore`, and `publish-google-play` stages.
 
 ### Zapstore Publishing
 
@@ -1490,4 +1611,39 @@ The `--use-fallback-relays` and `--use-fallback-servers` flags also include nsyt
 To rotate the nsite credential:
 1. Revoke the old bunker connection in your signer app
 2. Run `nsyte ci` again to generate a new `nbunksec1...` string
-3. Update the `NSITE_NBUNKSEC` variable in GitLab CI/CD settings
+3. Update the `NSITE_NBUNKSEC` variable in GitLab CI/CD settings
+
+### Google Play Publishing
+
+The project automatically publishes Android AABs (App Bundles) to [Google Play](https://play.google.com/store/apps/details?id=pub.ditto.app) using [fastlane supply](https://docs.fastlane.tools/actions/supply/). The `publish-google-play` CI job runs after a successful AAB build and uploads directly to the production track.
+
+**GitLab CI/CD Variables** (Settings > CI/CD > Variables):
+
+| Variable | Description | Protected | Masked | Raw |
+|---|---|---|---|---|
+| `GOOGLE_PLAY_SERVICE_ACCOUNT_JSON` | **Base64-encoded** contents of the Google Play API service account key JSON file. The CI job decodes it with `base64 -d` before passing it to `fastlane supply`. | Yes | Yes | No |
+
+#### Initial Setup (one-time)
+
+1. Create or reuse a project in the [Google Cloud Console](https://console.cloud.google.com/projectcreate)
+2. Enable the [Google Play Developer API](https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/) for that project
+3. In Google Cloud Console, go to [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts), create a service account, and download a JSON key file for it
+4. In Google Play Console, go to [Users & Permissions](https://play.google.com/console/users-and-permissions), click **Invite new users**, enter the service account email, and grant it permission to manage releases for `pub.ditto.app`
+5. **Base64-encode** the key file:
+
+   ```bash
+   # Linux
+   base64 -w0 service-account.json
+
+   # macOS
+   base64 -i service-account.json | tr -d '\n'
+   ```
+
+6. Add the base64-encoded value as the `GOOGLE_PLAY_SERVICE_ACCOUNT_JSON` variable in GitLab CI/CD settings (Settings > CI/CD > Variables). Mark it as **Protected** and **Masked**. Do **not** paste the raw JSON — the CI script expects base64 and will fail to decode a raw value.
+
+#### Key Points
+
+- The job uploads the signed AAB (not APK) since Google Play requires App Bundles
+- Uploads go directly to the **production** track -- Google's review process still applies before the update reaches users
+- Metadata, screenshots, and changelogs are managed in the Play Console, not via CI (the job uses `--skip_upload_metadata` etc.)
+- The same signing keystore used for Zapstore is used here (`ANDROID_KEYSTORE_BASE64`, `KEYSTORE_PASSWORD`, `KEY_PASSWORD`)

CHANGELOG.md

@@ -1,251 +1,7 @@
 # Changelog
 
-## [2.4.0] - 2026-04-02
+## [1.0.0] - 2026-04-30
 
 ### Added
-- First-hatch tour: a guided experience for hatching your very first Blobbi egg, with progressive crack animations, an inline card flow, and a reveal moment
-- Customizable bottom bar: rearrange or hide any item in the navigation bar to make Ditto feel like yours
-- Mission surface card in the feed that surfaces your active quests at a glance
 
-### Changed
-- Missions redesigned as a quest board with collapsible cards and a lighter aesthetic
-- "Edit Profile" mission now completes when you update any profile field, not just wall-specific edits
-- Media tab on profiles now shows only photos, videos, and other media -- not plain text posts
-- Blobbi onboarding state now syncs to your profile so it follows you across devices
-
-### Fixed
-- Notification dot no longer reappears after you've already marked notifications as read
-- Dialogs no longer fly up when the mobile keyboard opens
-
-## [2.3.1] - 2026-04-02
-
-### Changed
-- Drafts now save instantly to your device and sync to relays in the background, with a cloud sync indicator so you always know the status
-
-### Fixed
-- Dialogs stay visible above the keyboard on mobile instead of getting hidden behind it
-- Editing an existing article no longer incorrectly warns about a duplicate slug
-- Switching between rich text and markdown source mode no longer clears your content
-- Fix crash when editing in markdown source mode
-
-## [2.3.0] - 2026-04-02
-
-### Added
-- In-app article editor with a rich text toolbar, image uploads, auto-saving drafts, and a "My Articles" tab to manage drafts and published articles
-
-### Fixed
-- Custom emoji no longer stretch to fill their container
-- Mobile drawer now closes when tapping footer links like Changelog or Privacy
-- Logged-out users now default to the global tab on content feeds instead of seeing an empty follows tab
-
-## [2.2.11] - 2026-04-02
-
-### Fixed
-- Fix crash caused by the "What's new" toast firing outside the router
-
-## [2.2.10] - 2026-04-02
-
-### Added
-- App cards for Nostr apps now display in feeds and detail pages with hero images, icons, and quick-launch buttons
-- "What's new" toast appears after an app update with a changelog preview and link to the full changelog
-
-### Changed
-- Changelog page redesigned with a hero section for the latest release, collapsible older entries, and category icons inline with each item
-
-### Fixed
-- Compose box now fully resets to its collapsed state after posting, including poll options and media trays
-
-## [2.2.9] - 2026-04-01
-
-### Added
-- Emoji pack creator and editor with drag-and-drop image upload, auto-generated identifiers, and description field
-- Blobbi companions now appear in feeds and post detail pages
-
-### Changed
-- Blobbi shop redesigned with a tile layout and instant buy -- no more categories or accessory tabs
-- Emoji packs without any valid emojis are now hidden from feeds
-- Custom emoji shortcode collisions across packs are automatically resolved with pack-prefixed names
-
-## [2.2.8] - 2026-04-01
-
-### Added
-- Full threaded reply trees on post detail pages with collapsible deep branches and "Show X more replies" for sibling threads
-- Broadcast button in the Event JSON dialog to re-publish any event to your relays
-
-### Changed
-- My Badges tab overhauled with drag-and-drop reordering, a scrollable list, and a showcase-style carousel for pending badges
-- Encrypted letter envelopes now show the mailing side first (sender and recipient), then flip to reveal the wax seal
-- Blobbi companions are more expressive -- richer status reactions, sleeping visuals, and body effects like dirt and hunger cues
-
-### Fixed
-- Notification dot not clearing after marking notifications as read
-- Followers/following modal staying open after navigating to a profile
-
-## [2.2.7] - 2026-03-31
-
-### Fixed
-- Nushu script in encrypted letters now renders correctly on Android and iOS
-
-## [2.2.6] - 2026-03-31
-
-### Added
-- Encrypted letters now appear as interactive 3D envelopes with Nushu script -- flip and open them to reveal the secret writing inside
-- Zap receipts and profile metadata events now render in feeds and detail pages
-- Remote signer callback page for login flows with Amber, Primal, and other signing apps
-
-### Changed
-- Post action buttons extracted into a reusable PostActionBar component
-- Badge detail page streamlined with unified tab bar
-
-### Fixed
-- Hashtags now support accented and Unicode characters
-- Letter compose opens correctly from notifications and the letters page
-- Letter font picker loads fonts so each option previews in the correct typeface
-- Zap comment positioned inside the right column instead of floating with offset
-- Safe-area padding on pinned SubHeaderBar only applies when scrolled to top
-
-## [2.2.5] - 2026-03-30
-
-### Fixed
-- Crash when dragging profile tabs to reorder them
-
-## [2.2.4] - 2026-03-30
-
-### Changed
-- Profiles now have an emoji reaction button instead of a zap button -- express yourself with any emoji or custom emoji right on someone's profile
-- Zap moved to the profile overflow menu so it's still one tap away
-
-### Fixed
-- Crash on the notifications page caused by malformed badge award tags
-- Deleting a badge now also deletes all awards you issued for it
-- Custom emoji reactions missing their image tag no longer render as broken shortcodes
-- Deletion requests for addressable events now include both `e` and `a` tags for broader relay compatibility
-- Profile reactions no longer collapse into a single grouped notification
-- Oversized reaction emoji in comment context headers
-
-## [2.2.3] - 2026-03-30
-
-### Added
-- Letters now have an overflow menu, reply button, and a grid layout for browsing
-- Independent feed toggles for comments and generic reposts in content settings
-- Sidebar items are now visible to logged-out users so newcomers can explore everything
-
-### Changed
-- Compose textarea expands smoothly as you type instead of snapping to a new height
-- Blobbi stickers auto-shrink near card edges and clip cleanly at rounded boundaries
-
-### Fixed
-- Feed gaps when replies are disabled no longer cause missing posts
-- Avatar shape no longer flashes on load
-- Top bar arc no longer flickers during navigation transitions
-- Letter drawing-only sends, sticker drag bounds, and theme event preservation
-- Notification rendering for badges and letters
-- Duplicate React keys in content settings
-- Layout rendering warning when switching views
-
-## [2.2.2] - 2026-03-29
-
-### Added
-- Dedicated photo upload flow for sharing photos
-- Pull-to-refresh on all feed pages
-- 3D tilt effect on badge images -- hover over badges to see them pop
-- Multi-select badge awarding with indicators for already-sent badges
-- Badge list recovery dialog for restoring profile badge lists
-- Compact badge row preview in embedded profile badges events
-- Custom emoji usage tracking so your most-used custom emojis appear in the quick-react bar
-- Release notes now included in Zapstore publishing
-- Changelog link in the app footer
-
-### Changed
-- "Vines" renamed to "Divines" everywhere in the app
-- Custom emojis appear first in the emoji picker, right after recent
-- Threaded comment view now shows the parent event as a NoteCard with kind action headers
-
-### Fixed
-- Delete post dialog no longer freezes the feed on desktop
-- Amber login on Android now properly retries when returning from the background
-- Key downloads on Android save to the correct location
-- Custom emoji SVGs render correctly in the emoji-mart picker
-- Double-tap reactions now properly show the emoji on the post
-- Emoji shortcode autocomplete text and highlight colors
-- Profile skeleton no longer flickers for brand-new users with no metadata
-- Event links now route correctly for all event types
-- Badge notifications are now clickable
-- Custom profile tab form no longer retains fields from a previously edited tab
-- Double line under profile tabs in edit mode
-- Inconsistent use of "geocache" vs "treasures" terminology
-- Search page "N new posts" pill no longer shows unfiltered count
-- Stale-cache overwrites in replaceable event mutations
-- Click-through on delete confirmation and note menu items
-
-## [2.2.1] - 2026-03-28
-
-### Fixed
-- New posts no longer cause scroll jumps -- they buffer while you're reading and appear with a tap
-- Mobile header no longer shows double-layered backgrounds on notched devices
-- Pinned tabs stay properly positioned when scrolling on mobile
-- Signer approval toasts no longer fire in rapid succession on unstable connections
-- Toasts are easier to swipe away on mobile
-- Content warnings now blur thumbnails in the media grid
-
-## [2.2.0] - 2026-03-28
-
-### Added
-- Blobbi virtual pets -- adopt an egg, hatch it, evolve it into one of 16 adult forms, and care for it with feeding, cleaning, medicine, music, and singing
-- Blobbi companion that follows you around the app, tracks your cursor, blinks, expresses emotions, and reacts to what you're doing
-- Blobbi shop and inventory system with items that affect your pet's stats
-- Daily missions with reroll, care streaks, and stage-based rewards
-- Immersive full-screen divines experience on both mobile and desktop with floating controls
-- Relay information panel on the network settings page
-- Link preview cards now display inside quoted posts instead of raw URLs
-- Nsec paste guard warns you before accidentally pasting private keys outside the login field
-- Remote signer UX improvements for Amber users on Android
-- Badge awards now trigger push notifications
-- Badges display in profile bio section with a "Give badge" option in the profile menu
-
-### Changed
-- Notification "Mentions" tab now shows only pure mentions, filtering out replies
-- Notification preferences ("only from people I follow") now properly apply to push notifications, native Android notifications, and the unread dot
-- Upgraded from React 18 to React 19
-- Reduced initial bundle size by ~50% with improved code splitting and lazy loading
-
-### Fixed
-- Zapping Primal users no longer produces an error
-- Hashtag feeds now match case-insensitively for parity with search results
-- Mobile top bar arc no longer lingers on pages without tabs
-- Give Badge dialog and profile menu action handlers
-
-## [2.1.1] - 2026-03-27
-
-### Added
-- Emoji picker and shortcode autocomplete in zap comment box
-- Zap button on badge detail view
-- Theme descriptions now display on "updated their theme" posts and detail pages
-- Badge thumbnail previews in award notifications
-- Letter notifications with envelope card preview
-- Kind-specific labels in notification text instead of generic "post"
-
-### Fixed
-- Compose modal no longer closes when dismissing emoji picker on mobile
-- Compose preview overflow is now scrollable in modal
-- Toast notifications swipe up to dismiss on mobile instead of sideways
-- File downloads and URL opening work correctly on iOS
-- Badges page no longer shows infinite skeleton when logged out
-
-## [2.1.0] - 2026-03-26
-
-### Added
-- Letters -- a Wii Mail-inspired inbox for sending decorated letters to friends, complete with custom stationery, hand-drawn stickers, emoji stickers, fonts, and a send animation with envelope and wax seal
-- Attach a color moment or theme to your letter as a gift -- recipients can tap to apply it instantly
-- Stationery picker pulls from your color moments, followed users' themes, and built-in presets
-- Freehand drawing canvas for creating one-of-a-kind sticker doodles
-- Letters page added to the sidebar with a custom mailbox icon
-
-## [2.0.1] - 2026-03-26
-
-### Added
-- Tap the version number in settings to see what's new
-
-## [2.0.0] - 2026-03-26
-
-Initial release of Ditto 2.0 -- a complete rewrite of Ditto.
+- Initial Agora 3 release.

CONTRIBUTING.md

@@ -0,0 +1,184 @@
+# Contributing to Agora
+
+We welcome contributions, but we have high standards. Agora is a carefully designed product with a specific vision, and every merge request must meet that bar. This guide exists to help you succeed.
+
+**Required reading before you start:**
+
+- [Understanding Agora](#understanding-agora) -- the product vision. Your change must align with it.
+- This `CONTRIBUTING.md` guide -- the contribution process for this repository.
+- `AGENTS.md` in this repo -- the codebase conventions. Your AI tool should load this file.
+
+## Understanding Agora
+
+Agora is a carnival, not a platform. Before contributing, you need to understand what that means.
+
+### The product decision filter
+
+Every change to Agora should pass this test:
+
+> *Does this make Agora more magnetic, more threatening to the status quo, and more peaceful to inhabit?*
+
+- **Magnetic** -- Agora attracts through experience, not ideology. People don't need to understand Nostr to love it. They need to feel something they haven't felt online since the early web. Features should be odd, intriguing, and captivating -- not generic social media clones.
+- **Threatening to the status quo** -- Agora threatens mainstream platforms when someone opens it and thinks: *"Why can't my platform do this?"* Theming, games, treasure hunts, interoperable micro-apps -- these are things walled gardens can't replicate.
+- **Peaceful to inhabit** -- Agora displaces argument with creation, conformity with expression, and consumption with participation. No ads, no engagement-optimized algorithms, no outrage incentives.
+
+If a change does all three, it belongs. If it only does one, think harder. If it does none, it doesn't belong here.
+
+### What Agora is NOT
+
+- A Twitter/X clone with decentralization bolted on
+- A place to replicate features that mainstream platforms already do well
+- A showcase for generic UI components or boilerplate social features
+
+### What Agora IS
+
+- A convergence point for interoperable Nostr experiences (games, treasure hunts, magic decks, themes, color moments, live streams, and things nobody has imagined yet)
+- A place where profiles feel like worlds, not business cards
+- The most fun you've had on the internet in years
+
+Read the full "Understanding Agora" section above for the complete vision.
+
+## What we accept
+
+### Bug fixes
+
+One bug, one merge request. Fix exactly one thing. Don't bundle unrelated changes, don't sneak in refactors, don't "clean up while you're in there." Small, focused MRs get reviewed fast. Large ones sit.
+
+### New features and significant changes
+
+Every feature MR must link to an existing open issue and clearly align with the "Understanding Agora" section in this file. The philosophy alignment section in the MR template is where you make the case for why your change belongs in Agora. If you can't articulate that clearly, the change probably doesn't belong.
+
+If you have an idea for a feature that doesn't have an issue yet:
+
+1. Build it as a standalone Nostr app first (then document traction/feedback in the linked issue).
+2. Prove it works and get user feedback.
+3. Open an issue to discuss integration.
+
+**Feature MRs that don't link to an issue or don't align with the Agora Philosophy will be closed.** Our open issues are our internal roadmap -- some require deep product context. If your implementation doesn't match the product vision, it will be closed regardless of code quality.
+
+## Required tools
+
+- **Claude Opus 4.6** (or the latest frontier model) -- not Sonnet, not GPT-4o, not local models. Quality depends on model quality.
+- **An AI coding agent with plan/research mode** -- [OpenCode](https://opencode.ai), [Shakespeare](https://shakespeare.diy), Cursor, or similar.
+- **Node.js 22+** and npm 10.9.4+.
+
+## The contribution workflow
+
+Follow these steps in order. Skipping steps is the most common reason MRs are rejected.
+
+### 1. Ask: does anyone need this?
+
+Before writing a single line of code, answer this honestly. For bug fixes this is straightforward -- someone hit the bug. For features, it requires more thought. Is there evidence of real user demand? Is the underlying technology mature enough? A beautifully written feature for a nonexistent user base is the wrong thing to build. If you can't point to a concrete user need, reconsider.
+
+### 2. Understand the issue
+
+Read the issue thoroughly. If anything is unclear, ask in the issue comments before writing code. Understand not just *what* to change, but *why* -- what problem does this solve for users?
+
+### 3. Read the codebase conventions
+
+Read `AGENTS.md` in the repo root. This is the single source of truth for how code should be written in this project. Your AI tool should load this file automatically. If it doesn't, paste it in or configure your tool to read it.
+
+### 4. Read the philosophy
+
+Read "Understanding Agora" in this file. Agora is a carnival, not a platform. Your change should feel like it belongs in Agora -- not like it was transplanted from a generic social media template. Apply the product decision filter above.
+
+### 5. Plan before you code
+
+Start your AI tool in **plan mode** (or research/think mode). Spend the first few prompts:
+
+- Exploring the existing codebase to understand how similar features are implemented
+- Reading the files you'll need to modify
+- Proposing an approach
+
+Do not write code until you have a plan. The most expensive mistake is implementing the wrong approach.
+
+### 6. Implement
+
+Switch to code mode and implement your plan. Use Opus 4.6 or equivalent.
+
+### 7. Run the test suite
+
+```sh
+npm run test
+```
+
+This runs type-checking, linting, unit tests, and a production build. All must pass. Do not submit an MR with a failing test suite.
+
+### 8. Self-review
+
+Run this prompt against your diff (copy the full `git diff` output and paste it to your AI tool along with this prompt):
+
+```
+Review this diff as if you are a senior maintainer of this codebase who has to
+maintain it long-term. For each finding, state the file, line, and issue.
+
+- [ ] Does the diff contain changes that weren't requested? Flag anything out of scope.
+- [ ] Is there dead code, commented-out blocks, or debug artifacts left in?
+- [ ] Are there placeholder comments like "// In a real app..." or "// TODO: implement"?
+- [ ] For every value displayed to a user, can you trace it from source to render without a gap?
+- [ ] Are error, loading, and empty states all handled -- and in the right order?
+- [ ] Does a mutation reflect in the UI without requiring a manual refresh?
+- [ ] Is there a new read/write path that assumes fresh data but could get a stale cache?
+- [ ] For replaceable/addressable Nostr events: is fetchFreshEvent used before mutation?
+- [ ] Does anything new block the critical render path or fire N+1 network requests?
+- [ ] Are Nostr queries efficient (combined kinds, relay-level filtering vs client-side)?
+- [ ] Are user inputs used in queries or rendered as content without sanitization?
+- [ ] Were existing patterns/conventions in AGENTS.md ignored in favor of something novel?
+- [ ] Are secrets, keys, or env-specific values hardcoded?
+- [ ] Does the code use the `any` type anywhere?
+- [ ] Is the code Capacitor-compatible (no `<a download>`, no `window.open()`)?
+- [ ] Are new Nostr event kinds documented in NIP.md with links to relevant specs?
+- [ ] Are there any new images >100KB or other large binary assets that should be hosted externally?
+- [ ] Is there any use of dangerouslySetInnerHTML, eval, innerHTML, or SVG string interpolation?
+- [ ] Is any data from a Nostr event (tags, content, pubkey, URLs) used in a security-sensitive context (href, src, query filter, trust decision) without validation?
+
+Skip anything a linter or type checker would catch. Focus on logic, data flow, and intent.
+
+Then answer: "If you were the people who have to maintain this codebase and deal
+with all long-term issues, what would be your biggest concerns about this
+implementation?"
+```
+
+Address every finding before submitting.
+
+### 9. Deploy a live preview
+
+Deploy your branch so reviewers can test it without pulling your code:
+
+```sh
+npm run build
+npx surge dist your-branch-name.surge.sh
+```
+
+Or use Netlify, Vercel, or any static hosting. Include the live preview URL in your MR description.
+
+### 10. Take screenshots
+
+Capture before and after screenshots of any UI changes. Include them directly in the MR description. If your change has no visual component, state that explicitly.
+
+### 11. Submit
+
+Fill out every field in the MR template. Incomplete MRs will not be reviewed.
+
+## What gets your MR closed without review
+
+- No linked issue
+- Feature MRs with no clear alignment with "Understanding Agora" in this file
+- Features that fail the product decision filter (not magnetic, not threatening to the status quo, not peaceful)
+- Incomplete MR template (missing checklist, screenshots, or preview URL)
+- Changes that go beyond what was asked for (scope creep)
+- Placeholder code, dead code, or debug artifacts
+- Evidence of low-quality AI generation ("In a real application..." comments, hallucinated APIs, generic template code)
+- Failing test suite
+- No evidence of planning (code-first, think-later approach produces recognizable patterns)
+- Undocumented Nostr event kinds (new kinds must be in NIP.md)
+- Large binary assets committed to git (images >100KB, fonts, videos)
+- Security issues (dangerouslySetInnerHTML, eval, innerHTML, unsanitized user input)
+
+## MR review process
+
+1. The CI pipeline validates your MR description automatically. If it fails, read the error message and fix your MR description.
+2. Maintainers will review your MR when all CI checks pass and the template is complete.
+3. If changes are requested, address them promptly. Stale MRs will be closed.
+
+We appreciate your interest in contributing. These standards exist because reviewing a low-quality MR takes 3x longer than doing the work ourselves. Help us help you by following the process.

Dockerfile

@@ -0,0 +1,15 @@
+FROM node:22-alpine AS builder
+WORKDIR /app
+RUN apk add --no-cache git
+COPY package*.json ./
+COPY .npmrc ./
+COPY scripts/ ./scripts/
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM nginx:alpine
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY --from=builder /app/dist /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

NIP.md

@@ -6,10 +6,23 @@
 
 | Kind  | Name                 | Description                                           |
 |-------|----------------------|-------------------------------------------------------|
-| 36767 | Theme Definition     | Shareable, named custom UI theme                      |
-| 16767 | Active Profile Theme | The user's currently active theme (one per user)      |
 | 16769 | Profile Tabs         | The user's custom profile page tabs (one per user)    |
 
+### Agora Kinds
+
+| Kind  | Name                       | Description                                                    |
+|-------|----------------------------|----------------------------------------------------------------|
+| 20000 | Ephemeral Geo Chat (public) | Geo-anchored ephemeral chat message (kind 20000, public)      |
+| 20001 | Ephemeral Geo Heartbeat    | Geo-anchored ephemeral presence heartbeat (kind 20001)         |
+| 30385 | Community Stats Snapshot   | Pre-computed per-country / global community leaderboards       |
+| 36639 | Activist Action            | Country-scoped activist challenge with a sats bounty           |
+
+### Agora Protocols
+
+| Protocol                 | Composed Kinds                          | Description                                                     |
+|--------------------------|-----------------------------------------|-----------------------------------------------------------------|
+| Hierarchical Communities | 34550, 30009, 8, 1111, 1984, 5         | Ranked community membership via badge award chains (NIP-72 ext) |
+
 ### Community Kinds
 
 These event kinds were created by community contributors and are supported by Ditto. Full specifications are maintained by their respective authors.
@@ -20,175 +33,47 @@ These event kinds were created by community contributors and are supported by Di
 | 4223  | Weather Reading        | Sensor readings from a weather station                           | [Draft NIP](https://github.com/nostr-protocol/nips/pull/2163)                            |
 | 7516  | Found Log              | Log entry recording a user finding a geocache                    | [NIP-GC](https://gitlab.com/chad.curtis/treasures/-/blob/main/NIP-GC.md)                 |
 | 8211  | Encrypted Letter       | Encrypted personal letter with visual stationery                 | [NIP](https://gitlab.com/chad.curtis/lief/-/blob/main/NIP.md)                            |
-| 11125 | Blobbonaut Profile     | Owner profile with coins, achievements, and inventory            | [NIP-BB](https://github.com/Danidfra/nostr-pet/blob/production/NIP.md)                   |
-| 14919 | Blobbi Interaction     | Individual pet interaction (feed, play, clean, etc.)             | [NIP-BB](https://github.com/Danidfra/nostr-pet/blob/production/NIP.md)                   |
-| 14920 | Blobbi Breeding        | Breeding event between two adult Blobbis                         | [NIP-BB](https://github.com/Danidfra/nostr-pet/blob/production/NIP.md)                   |
-| 14921 | Blobbi Record          | Immutable lifecycle record (birth, evolution, adoption)          | [NIP-BB](https://github.com/Danidfra/nostr-pet/blob/production/NIP.md)                   |
 | 16158 | Weather Station        | Weather station metadata (location, sensors, connectivity)       | [Draft NIP](https://github.com/nostr-protocol/nips/pull/2163)                            |
-| 31124 | Blobbi Pet State       | Current state of a virtual Blobbi pet (addressable)              | [NIP-BB](https://github.com/Danidfra/nostr-pet/blob/production/NIP.md)                   |
 | 37516 | Geocache               | Geocache listing for real-world treasure hunting                 | [NIP-GC](https://gitlab.com/chad.curtis/treasures/-/blob/main/NIP-GC.md)                 |
 
 ---
 
-## Kind 36767: Theme Definition
+## Standard NIPs: Direct Messaging
 
-### Summary
+This application implements encrypted direct messaging using two standard Nostr protocols:
 
-Addressable event kind for publishing shareable custom UI themes. A single user may publish multiple themes, each identified by a unique `d` tag.
+### NIP-04 (Legacy Encrypted DMs)
 
-A theme consists of colors, optional fonts, and an optional background. Colors are stored in `c` tags, fonts in `f` tags, and background in a `bg` tag.
+| Field | Value |
+|-------|-------|
+| Kind  | 4     |
+| Spec  | [NIP-04](https://github.com/nostr-protocol/nips/blob/master/04.md) |
 
-### Event Structure
+Legacy encrypted direct messages. Content is encrypted with AES-256-CBC using a shared secret derived from the sender's private key and recipient's public key. The recipient is identified by a `p` tag.
 
-```json
-{
-  "kind": 36767,
-  "content": "",
-  "tags": [
-    ["d", "mk-dark-theme"],
-    ["c", "#1a1a2e", "background"],
-    ["c", "#e0e0e0", "text"],
-    ["c", "#6c3ce0", "primary"],
-    ["f", "Inter", "https://example.com/inter.woff2", "body"],
-    ["f", "Playfair Display", "https://example.com/playfair.woff2", "title"],
-    ["bg", "url https://example.com/bg.jpg", "mode cover", "m image/jpeg", "dim 1920x1080"],
-    ["title", "MK Dark Theme"],
-    ["alt", "Custom theme: MK Dark Theme"]
-  ]
-}
-```
+Used for backward compatibility with older Nostr clients that do not support NIP-17.
 
-### Content
+### NIP-17 (Private Direct Messages)
 
-The `content` field is unused and MUST be an empty string (`""`).
+| Field | Value |
+|-------|-------|
+| Kinds | 1059 (Gift Wrap), 1060 (Seal) |
+| Spec  | [NIP-17](https://github.com/nostr-protocol/nips/blob/master/17.md) |
 
-### Tags
+Modern private direct messages using the Gift Wrap protocol. Messages are triple-layered:
 
-| Tag     | Required | Description                                                                           |
-|---------|----------|---------------------------------------------------------------------------------------|
-| `d`     | Yes      | Unique identifier (slug) for this theme, e.g. `"mk-dark-theme"`                      |
-| `c`     | Yes (×3) | Hex color with marker. See [Color Tags](#color-tags).                                 |
-| `f`     | No       | Font declaration. See [Font Tag](#font-tag).                                          |
-| `bg`    | No       | Background media. See [Background Tag](#background-tag).                              |
-| `title` | Yes      | Human-readable theme name                                                             |
-| `alt`   | Yes      | NIP-31 human-readable fallback                                                        |
+1. **Rumor** (kind 14) — unsigned plaintext message
+2. **Seal** (kind 13) — rumor encrypted to the recipient, signed by the sender
+3. **Gift Wrap** (kind 1059) — seal encrypted to the recipient, signed by a random ephemeral key
 
-### Multiple Themes Per User
+This provides metadata protection: relays and observers cannot determine the sender, recipient, or content. The application uses NIP-17 as the default send protocol, with optional NIP-04 compatibility for older clients.
 
-Since kind 36767 is addressable, a user can publish multiple themes by using different `d` tag values. Publishing a new event with the same `d` tag replaces the previous version (this is how editing works).
+### Protocol Configuration
 
----
+Users can configure their preferred send protocol via Settings > Messages:
 
-## Kind 16767: Active Profile Theme
-
-### Summary
-
-Replaceable event that represents the user's currently active profile theme. Only one per user. When other users visit a profile, they query this kind to determine what theme to display.
-
-### Event Structure
-
-```json
-{
-  "kind": 16767,
-  "content": "",
-  "tags": [
-    ["c", "#1a1a2e", "background"],
-    ["c", "#e0e0e0", "text"],
-    ["c", "#6c3ce0", "primary"],
-    ["f", "Inter", "https://example.com/inter.woff2", "body"],
-    ["f", "Playfair Display", "https://example.com/playfair.woff2", "title"],
-    ["bg", "url https://example.com/bg.jpg", "mode cover", "m image/jpeg"],
-    ["title", "MK Dark Theme"],
-    ["alt", "Active profile theme"]
-  ]
-}
-```
-
-### Content
-
-The `content` field is unused and MUST be an empty string (`""`).
-
-### Tags
-
-| Tag     | Required | Description                                                                           |
-|---------|----------|---------------------------------------------------------------------------------------|
-| `c`     | Yes (×3) | Hex color with marker. See [Color Tags](#color-tags).                                 |
-| `f`     | No       | Font declaration. See [Font Tag](#font-tag).                                          |
-| `bg`    | No       | Background media. See [Background Tag](#background-tag).                              |
-| `title` | No       | Human-readable name for the theme                                                     |
-| `alt`   | Yes      | NIP-31 human-readable fallback                                                        |
-
-### Client Behavior
-
-- When visiting a profile, clients query `{ kinds: [16767], authors: [pubkey], limit: 1 }` to get the active theme.
-- Clients read the `c` tags to extract colors, `f` tags for fonts, and `bg` tag for the background.
-- Setting a new active theme publishes a new kind 16767 event (replacing the old one).
-- To remove the active theme, publish a kind 5 deletion event targeting kind 16767.
-
----
-
-## Shared Tag Definitions
-
-The following tag definitions apply to both kind 36767 and kind 16767.
-
-### Color Tags
-
-Format: `["c", "#rrggbb", "<marker>"]`
-
-| Index | Required | Description                                                                                   |
-|-------|----------|-----------------------------------------------------------------------------------------------|
-| 0     | Yes      | Tag name: `"c"`                                                                               |
-| 1     | Yes      | Lowercase 6-digit hex color code including the `#` sign (e.g. `"#ff0000"`)                    |
-| 2     | Yes      | Color role marker: one of `"primary"`, `"text"`, or `"background"`                            |
-
-- All three markers (`"primary"`, `"text"`, `"background"`) MUST be present.
-- Only one `c` tag per marker is allowed.
-
-### Font Tag
-
-Format: `["f", "<family>", "<url>", "<role>"]`
-
-| Index | Required | Description                                                                                   |
-|-------|----------|-----------------------------------------------------------------------------------------------|
-| 0     | Yes      | Tag name: `"f"`                                                                               |
-| 1     | Yes      | CSS `font-family` name (e.g. `"Inter"`)                                                       |
-| 2     | Yes      | Direct URL to a font file (`.woff2`, `.ttf`, `.otf`)                                          |
-| 3     | Yes      | Font role: `"body"` or `"title"`                                                              |
-
-**Roles:**
-
-| Role      | Applies to                                      |
-|-----------|--------------------------------------------------|
-| `"body"`  | All text globally (body, headings, UI elements)  |
-| `"title"` | The user's profile display name                  |
-
-**Rules:**
-
-- The `f` tag is optional on the event.
-- At most one `f` tag per role is allowed (i.e. one body font and one title font).
-- The `"body"` font tag MUST be ordered before the `"title"` font tag. This ensures backward-compatible clients that only read the first `f` tag will pick up the body font.
-- If the URL fails to load, the client SHOULD fall back to a default font gracefully.
-- Clients that do not recognize a role SHOULD ignore that `f` tag.
-- Legacy events with an `f` tag that has no role marker (only 3 elements) SHOULD be treated as `"body"`.
-- Variable font files (covering multiple weights in a single file) are preferred.
-
-### Background Tag
-
-The `bg` tag uses an `imeta`-style variadic format where each entry (after the tag name) is a space-delimited key/value pair.
-
-Format: `["bg", "url <url>", "mode <mode>", "m <mime-type>", ...]`
-
-| Key         | Required | Description                                                                              |
-|-------------|----------|------------------------------------------------------------------------------------------|
-| `url`       | Yes      | URL to an image or video file                                                            |
-| `mode`      | Yes      | Display mode: `"cover"` or `"tile"`                                                      |
-| `m`         | Yes      | MIME type (e.g. `"image/jpeg"`, `"image/png"`, `"video/mp4"`)                            |
-| `dim`       | No       | Dimensions in pixels: `"<width>x<height>"` (e.g. `"1920x1080"`)                          |
-| `blurhash`  | No       | Blurhash placeholder string for progressive loading                                      |
-
-- At most one `bg` tag is allowed per event.
-- Clients MAY choose not to render video backgrounds for performance or bandwidth reasons.
-- Unknown keys SHOULD be ignored for forward compatibility.
+- **NIP-17 only** (default) — maximum privacy, only modern clients can read
+- **NIP-04 + NIP-17** — sends via both protocols for compatibility with legacy clients
 
 ---
 
@@ -288,6 +173,643 @@ After resolution (assuming `$follows` = `["pk1", "pk2"]`):
 
 ---
 
+## Kind 36639: Activist Action
+
+### Summary
+
+Addressable event kind for publishing **activist actions** (called "challenges" internally for backwards compatibility). An action is a country-scoped task — take a photo, make art, gather information, or take direct action — with an optional sats bounty paid out via NIP-57 zaps to the best **submissions**.
+
+Submissions are **NIP-22 comments** (kind 1111) authored under the action's coordinate, ranked by zap totals. There is no separate submission kind; an earlier draft (kind 36640) was deprecated in favor of NIP-22 reuse.
+
+### Trust model
+
+Anyone can publish a kind 36639 event, but clients SHOULD only display actions whose author is either:
+
+1. A platform-level admin (see `src/lib/admins.ts`), or
+2. An organizer for the action's country (see kind 30078 `agora-organizers`).
+
+This authorization model is identical to the per-country pin model — see Kind 30078 in this document for the storage shape.
+
+### Event Structure
+
+```json
+{
+  "kind": 36639,
+  "content": "<long-form description, freeform markdown-ish text>",
+  "tags": [
+    ["d", "plant-a-tree-1729000000000"],
+    ["title", "Plant a tree in your neighborhood"],
+    ["challenge-type", "photo"],
+    ["bounty", "10000"],
+    ["i", "iso3166:US"],
+    ["t", "agora-action"],
+    ["image", "https://example.com/cover.jpg"],
+    ["start", "1729000000"],
+    ["deadline", "1729604800"],
+    ["alt", "Agora activist action: Plant a tree in your neighborhood"]
+  ]
+}
+```
+
+### Tags
+
+| Tag              | Required | Description                                                                                              |
+|------------------|----------|----------------------------------------------------------------------------------------------------------|
+| `d`              | Yes      | Unique identifier (typically slug + timestamp). Forms the addressable coordinate `36639:<pubkey>:<d>`.   |
+| `title`          | Yes      | Short title shown on cards.                                                                              |
+| `challenge-type` | Yes      | One of `photo`, `art`, `info`, `action`. Drives the display icon and submission expectations.            |
+| `bounty`         | Yes      | Bounty in **sats**, as an unsigned integer string. Paid out via zaps to the chosen submission(s).        |
+| `i`              | Yes      | NIP-73 country identifier: `iso3166:XX` (preferred). Legacy `geo:XX` (length 6, country code only) is accepted as a read alias. Optionally combined with a `location` tag fallback. |
+| `t`              | Yes      | Discovery tag. Canonical write value is `agora-action`. Read aliases: `pathos-challenge`, `agora-challenge`. |
+| `image`          | No       | Cover image URL.                                                                                         |
+| `start`          | No       | Unix timestamp when the action becomes active. Defaults to `created_at`.                                 |
+| `deadline`       | No       | Unix timestamp when the action expires. Defaults to `start + 48h`.                                       |
+| `alt`            | Yes      | NIP-31 human-readable fallback. Convention: `"Agora activist action: <title>"`.                          |
+
+### Content
+
+Long-form description of the action. Plain text or light markdown. Clients render this as the action's body on the detail page.
+
+### Submissions
+
+Submissions are kind 1111 NIP-22 comments addressed to the action's coordinate (`["A", "36639:<pubkey>:<d>"]` and `["P", "<pubkey>"]`). Clients SHOULD:
+
+- Sort top-level submissions by **total zap amount** (sum of NIP-57 zap receipts on each submission), descending.
+- Show the bounty as the prize pool that organizers can distribute to top submissions via zaps.
+- Hide submissions with `created_at` after the action's `deadline` for "past" leaderboards (or surface them separately as "late submissions").
+
+### Discovery
+
+Clients querying actions globally:
+
+```json
+{ "kinds": [36639], "#t": ["agora-action", "pathos-challenge", "agora-challenge"], "limit": 50 }
+```
+
+Per country:
+
+```json
+{
+  "kinds": [36639],
+  "#t": ["agora-action", "pathos-challenge", "agora-challenge"],
+  "#i": ["iso3166:US", "geo:US"],
+  "limit": 50
+}
+```
+
+After fetching, clients MUST filter the results down to events whose author is either an admin or an organizer for the event's country.
+
+---
+
+## Kind 30385: Community Stats Snapshot
+
+### Summary
+
+Addressable event kind for **pre-computed community statistics** (per-country and global). A trusted off-app indexer (the "stats bot") publishes one event per scope:
+
+- **Per-country**: `d` tag is `iso3166:XX` (ISO 3166-1 alpha-2 country code).
+- **Global**: `d` tag is `iso3166:ZZ` — `ZZ` is the ISO 3166-1 user-assigned code Agora uses for the cross-country aggregate.
+
+Each event contains aggregate counts (comments, authors, zaps, submissions) and ranked leaderboards (top posters, trending hashtags, top zapped authors, top donors, top actions) across multiple time windows (`7d`, `30d`, `90d`, all-time). Storing pre-computed leaderboards in a single event lets clients render community pages without scanning thousands of underlying events.
+
+### Trust model
+
+Anyone can publish kind 30385, but clients MUST only consume events from trusted authors:
+
+- **Per-country events**: trusted authors are platform admins (`src/lib/admins.ts`) **plus** appointed organizers for that specific country (kind 30078 `agora-organizers`).
+- **Global event** (`iso3166:ZZ`): trusted authors are platform admins only.
+
+When multiple trusted events exist for the same scope, clients pick the most recent by `created_at`.
+
+### Event Structure
+
+```json
+{
+  "kind": 30385,
+  "content": "",
+  "tags": [
+    ["d", "iso3166:US"],
+
+    ["comment_cnt", "12345"],
+    ["comment_cnt_7d", "789"],
+    ["comment_cnt_30d", "3421"],
+    ["comment_cnt_90d", "9876"],
+    ["author_cnt", "543"],
+    ["zap_amount", "123456789"],
+    ["zap_cnt", "1234"],
+    ["submission_cnt", "456"],
+
+    ["top_poster", "<pubkey-hex>", "987"],
+    ["top_poster_7d", "<pubkey-hex>", "42"],
+
+    ["trending_hashtag", "climate", "321"],
+    ["trending_hashtag_7d", "protest", "67"],
+
+    ["top_zapped", "<pubkey-hex>", "<totalSats>", "<postCount>", "<avgSats>", "<zapCount>"],
+    ["top_donor", "<pubkey-hex>", "<totalSats>", "<zapCount>"],
+
+    ["top_action", "36639:<pubkey>:<d-tag>", "Plant a tree", "<submissions>", "<bounty>", "<zapAmountSats>"]
+  ]
+}
+```
+
+### Tag families
+
+All numeric values are unsigned integers serialised as base-10 strings.
+
+#### Aggregate counts (one tag per metric per timeframe)
+
+| Tag base name      | Meaning                                                |
+|--------------------|--------------------------------------------------------|
+| `comment_cnt`      | Number of NIP-22 comments in scope                     |
+| `author_cnt`       | Distinct author pubkeys in scope                       |
+| `zap_amount`       | Total zap amount in **sats**                           |
+| `zap_cnt`          | Number of NIP-57 zap receipts                          |
+| `submission_cnt`   | Submissions to activist actions (kind 36639)           |
+
+Each is published as four tags: bare (`<base>`, all-time), `<base>_7d`, `<base>_30d`, `<base>_90d`.
+
+#### Leaderboards (repeated; one tag per row, ordered by rank)
+
+All-time variants use the bare tag name; windowed variants use the `_7d`, `_30d`, `_90d` suffixes.
+
+| Tag base name        | Positional fields                                                                              |
+|----------------------|-----------------------------------------------------------------------------------------------|
+| `top_poster`         | `[name, pubkeyHex, count]`                                                                    |
+| `trending_hashtag`   | `[name, hashtag, count]`                                                                      |
+| `top_zapped`         | `[name, pubkeyHex, totalSats, postCount, avgSats, zapCount]` (`zapCount` optional, legacy)    |
+| `top_donor`          | `[name, pubkeyHex, totalSats, zapCount]`                                                      |
+| `top_action`         | `[name, "36639:<pubkey>:<d>", title, submissions, bounty, zapAmountSats]`                     |
+
+Clients SHOULD parse defensively — accept missing trailing fields as `0` or omitted to maintain backwards compatibility as the schema evolves.
+
+### Content
+
+Empty string. All data lives in tags so relays can index/filter and clients don't need to parse JSON.
+
+### Discovery
+
+Per-country snapshot:
+
+```json
+{
+  "kinds": [30385],
+  "authors": [<admin and organizer pubkeys>],
+  "#d": ["iso3166:US"],
+  "limit": 10
+}
+```
+
+Global snapshot:
+
+```json
+{
+  "kinds": [30385],
+  "authors": [<admin pubkeys>],
+  "#d": ["iso3166:ZZ"],
+  "limit": 10
+}
+```
+
+After fetching, take the event with the highest `created_at` and parse it. Cache for ~1–2 minutes; the producer typically refreshes on a similar cadence.
+
+---
+
+## Kinds 20000 / 20001: Ephemeral Geo Chat
+
+### Summary
+
+Ephemeral events used to power realtime location-anchored chat on the world map. Both kinds live in NIP-01's ephemeral range (`20000 ≤ kind < 30000`), so relays MUST NOT persist them — they are short-lived signals only.
+
+- **Kind 20000** — public chat message. The `content` field carries the message text.
+- **Kind 20001** — presence "heartbeat". Same tag schema, but `content` MAY be empty (the event simply broadcasts that someone is listening at the geohash).
+
+This kind range is shared with the wider Bitchat / geo-chat ecosystem; Agora interoperates with Pathos and other clients producing the same shape.
+
+### Tags
+
+| Tag | Required | Purpose                                                                 |
+|-----|----------|-------------------------------------------------------------------------|
+| `g` | Yes      | Geohash anchoring the message. Any precision is allowed; the dialog filters by exact-match `g` value, while the map clusters by full geohash. |
+| `n` | No       | Display nickname (≤ 16 chars after client-side truncation). Anonymous senders pick a random "ghost" handle; logged-in senders may use their account display name. |
+
+Events without a `g` tag MUST be ignored — they cannot be plotted.
+
+### Identity
+
+There are two valid signing paths:
+
+1. **Real identity** — a logged-in user signs with their existing Nostr key (typically via NIP-07 / NIP-46). Other clients can correlate the chat message with the author's public profile.
+2. **Ephemeral "ghost" identity** — the client generates a fresh in-memory keypair (never persisted) and signs locally. Only the chosen `n` nickname is persisted (in `localStorage`) so the user keeps a stable handle even though the pubkey rotates per session.
+
+Clients SHOULD let logged-in users toggle between modes per-session and SHOULD default to the ghost mode when no account is available.
+
+### Relay Routing
+
+Because ephemeral events are not stored, latency dominates the experience. Clients SHOULD:
+
+1. Always include a baseline of widely-reachable relays (`wss://nos.lol`, `wss://relay.damus.io`, `wss://relay.primal.net`).
+2. Augment with geo-located relays drawn from the [permissionlesstech/georelays](https://github.com/permissionlesstech/georelays) CSV catalogue (`relayUrl,latitude,longitude` per line).
+3. For a specific geohash conversation, prefer the relays nearest the decoded coordinates (Haversine distance, top-N).
+4. For the global map heatmap, take a rotating window (e.g. 8 relays, rotated every 5 minutes) so coverage spreads without saturating any single relay.
+
+### Time Window
+
+Clients SHOULD only surface events from the last hour (`since = now - 3600`). Older ephemeral events are uninteresting for "what's happening right now" and most relays will have dropped them anyway.
+
+### Example
+
+```json
+{
+  "kind": 20000,
+  "created_at": 1734567890,
+  "pubkey": "...",
+  "tags": [
+    ["g", "u4pruydqqvj"],
+    ["n", "stealthranger4242"]
+  ],
+  "content": "anyone in berlin tonight?",
+  "sig": "..."
+}
+```
+
+---
+
+## Hierarchical Communities
+
+Hierarchical communities on Nostr, composed from existing event kinds. Communities have ranked membership where authority flows downward through a chain of badge awards.
+
+This specification is intended to be a foundation for community-scoped features. A community is a kind `34550` root that other events can tag with uppercase `A`. Posts, events, polls, listings, and future content kinds can all participate in the same community model when they tag the community root and pass the membership and moderation rules below.
+
+The initial implementation focuses on three foundation capabilities:
+
+1. Viewing communities a user owns or belongs to.
+2. Posting community-scoped discussion content.
+3. Moderating community-scoped content and members within communities the viewer has authority over.
+
+**No new event kinds are introduced.** The system composes:
+
+- **Kind 34550** ([NIP-72](https://github.com/nostr-protocol/nips/blob/master/72.md)) -- Community Definition
+- **Kind 30009** ([NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md)) -- Badge Definition
+- **Kind 8** ([NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md)) -- Badge Award
+- **Kind 1111** ([NIP-22](https://github.com/nostr-protocol/nips/blob/master/22.md)) -- Community Posts
+- **Kind 1984** ([NIP-56](https://github.com/nostr-protocol/nips/blob/master/56.md)) -- Moderation
+- **Kind 5** ([NIP-09](https://github.com/nostr-protocol/nips/blob/master/09.md)) -- Badge Award Revocation / Moderation Rescinding
+
+### Overview
+
+A hierarchical community consists of:
+
+1. **Badge definitions** (kind `30009`), one per rank tier, published by the founder.
+2. A **community definition** (kind `34550`) referencing those badges with rank indices.
+3. **Badge awards** (kind `8`) forming a chain of trust -- each award grants a rank, validated by the awarder's rank.
+4. **Community-scoped content** (initially kind `1111`) tagged to the community root.
+5. **Reports and bans** (kind `1984`) scoped to the community for content warnings, content removal, and member bans.
+6. **Deletion requests** (kind `5`) for revoking badge awards or rescinding moderation events.
+
+### Membership Derivation
+
+Community membership is derived from three distinct sources, each resolved differently:
+
+- **Founder** -- the `pubkey` field on the kind `34550` event. One per community, immutable. Controls the community definition since only they can republish the addressable event.
+- **Moderators** -- the `p` tags on the kind `34550` event (matching [NIP-72](https://github.com/nostr-protocol/nips/blob/master/72.md)). Mutable (the founder can add/remove by republishing). Share rank 0 with the founder.
+- **Members** -- derived from kind `8` badge awards forming the authority chain. A member's rank is determined by the badge they were awarded (rank 1 and below).
+
+The founder and moderators have no badge. Their rank 0 status comes from the community definition itself. Rank 0 cannot be awarded via kind `8` -- there is no rank 0 badge definition. Clients determine founder/moderator display from the community event directly.
+
+Authority is **rank-based, not badge-specific**. A member at rank N can award any badge at rank M where M > N.
+
+### Community Definition
+
+A kind `34550` event defines the community, extending [NIP-72](https://github.com/nostr-protocol/nips/blob/master/72.md) with badge `a` tags that encode rank indices.
+
+#### Tags
+
+| Tag | Required | Description |
+|-----|----------|-------------|
+| `d` | Yes | Unique community identifier (UUID recommended). |
+| `name` | Yes | Human-readable name. |
+| `description` | No | Community description. |
+| `image` | No | Image URL. |
+| `a` | Yes (1+) | Badge definition reference with rank index (see format below). |
+| `p` | Yes (1+) | Moderator pubkeys. Implicitly rank 0. The 4th element SHOULD be `"moderator"`. |
+| `relay` | No | Recommended relay URL for community content (per [NIP-72](https://github.com/nostr-protocol/nips/blob/master/72.md)). |
+| `alt` | No | [NIP-31](https://github.com/nostr-protocol/nips/blob/master/31.md) description. |
+
+#### Badge `a` Tag Format
+
+```
+["a", "30009:<pubkey>:<badge-d-tag>", "<relay-hint>", "<rank-index>"]
+```
+
+Rank `0` is reserved for the founder and moderators (derived from the community definition, not from badges). Badge `a` tags define awardable ranks starting from `1`. Higher numbers = lower authority. Indices MUST be contiguous starting from 1.
+
+#### Example
+
+```jsonc
+{
+  "kind": 34550,
+  "pubkey": "<founder-pubkey>",
+  "content": "",
+  "tags": [
+    ["d", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
+    ["name", "The Arbiter's Guard"],
+    ["description", "Elite Halo 2 clan"],
+    ["image", "https://example.com/clan-banner.jpg"],
+    ["a", "30009:<founder-pubkey>:a1b2c3d4-...-staff", "", "1"],
+    ["a", "30009:<founder-pubkey>:a1b2c3d4-...-member", "", "2"],
+    ["a", "30009:<founder-pubkey>:a1b2c3d4-...-peon", "", "3"],
+    ["p", "<founder-pubkey>", "", "moderator"],
+    ["p", "<co-moderator-pubkey>", "", "moderator"],
+    ["relay", "wss://relay.example.com"],
+    ["alt", "Community: The Arbiter's Guard"]
+  ]
+}
+```
+
+### Badge Definitions
+
+Each rank tier is a standard [NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md) kind `30009` badge definition published by the founder. Badge definitions MUST be published **before** the community definition that references them.
+
+The `d` tag SHOULD use the format `<community-d-tag>-<rank-name>` for global uniqueness.
+
+```jsonc
+{
+  "kind": 30009,
+  "pubkey": "<founder-pubkey>",
+  "content": "",
+  "tags": [
+    ["d", "a1b2c3d4-...-staff"],
+    ["name", "Staff"],
+    ["description", "Trusted officers who manage clan operations."],
+    ["image", "https://example.com/staff-badge.png"],
+    ["alt", "Badge definition: Staff"]
+  ]
+}
+```
+
+### Badge Awards
+
+Membership is established through kind `8` badge awards ([NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md)). Each award forms a chain link.
+
+A badge award is **valid** if and only if:
+
+1. The `a` tag references a badge definition listed in the community definition.
+2. The awarder is a validated member at a rank **strictly less than** the badge's rank index.
+3. The awarder's chain can be walked upward to a founder or moderator.
+
+```jsonc
+// Moderator (rank 0) awarding Staff (rank 1)
+{
+  "kind": 8,
+  "pubkey": "<founder-pubkey>",
+  "content": "",
+  "tags": [
+    ["a", "30009:<founder-pubkey>:a1b2c3d4-...-staff"],
+    ["p", "<recipient-pubkey>"],
+    ["alt", "Badge award: Staff in The Arbiter's Guard"]
+  ]
+}
+```
+
+### Chain Validation
+
+Membership is **derived state**. Clients compute effective membership by resolving the authority graph from badge awards, then applying moderation overlays.
+
+#### Algorithm
+
+1. **Seed rank 0**: The event publisher (founder) and all `p` tags (moderators) in the community definition are rank 0 members.
+2. **Query awards**: `{ kinds: [8], #a: [<all badge coordinates>] }`
+3. **Iteratively validate**: For each award, check if the awarder is a validated member with rank strictly less than the awarded rank. If valid, add the recipient. Repeat until no new members are discovered.
+4. **Resolve moderation**: Query `{ kinds: [1984], #A: [<community-a-tag>] }`. Classify kind `1984` events into **bans** and **reports** (see [Moderation](#moderation)). Kind `1984` events from non-members and banned members are ignored. Ban attempts from insufficiently ranked members are ignored, such as a rank 2 member trying to ban a rank 0 founder or moderator.
+5. **Apply moderation**: Remove banned members from effective membership. Omit content from banned authors, omit verified content bans, and attach report data to reported content for content-warning display.
+
+Clients MUST NOT trust kind `8` events at face value. An attacker can publish awards for themselves, but these fail chain validation without a path to a founder or moderator.
+
+### Community-Scoped Content
+
+Community-scoped content is any event that tags the community definition with uppercase `A`. The foundation implementation starts with kind `1111` ([NIP-22](https://github.com/nostr-protocol/nips/blob/master/22.md)) posts, but the same moderation overlay applies to future community content kinds such as calendar events, polls, listings, or other domain-specific events.
+
+Clients SHOULD treat valid community members as the canonical authors for community views. Content from non-members MAY be shown in future review surfaces, but canonical community feeds SHOULD discard non-member content by default.
+
+#### Community Post
+
+Community discussion uses kind `1111` scoped to the community definition as the root event.
+
+#### Top-Level Post
+
+```jsonc
+{
+  "kind": 1111,
+  "content": "Hello clan!",
+  "tags": [
+    ["A", "34550:<founder-pubkey>:<community-d-tag>", "<relay-hint>"],
+    ["K", "34550"],
+    ["P", "<founder-pubkey>", "<relay-hint>"],
+    ["a", "34550:<founder-pubkey>:<community-d-tag>", "<relay-hint>"],
+    ["k", "34550"],
+    ["p", "<founder-pubkey>", "<relay-hint>"]
+  ]
+}
+```
+
+#### Reply
+
+Replies keep the community as root scope and point to the parent comment:
+
+```jsonc
+{
+  "kind": 1111,
+  "content": "Great point!",
+  "tags": [
+    ["A", "34550:<founder-pubkey>:<community-d-tag>", "<relay-hint>"],
+    ["K", "34550"],
+    ["P", "<founder-pubkey>", "<relay-hint>"],
+    ["e", "<parent-comment-id>", "<relay-hint>", "<parent-author-pubkey>"],
+    ["k", "1111"],
+    ["p", "<parent-author-pubkey>", "<relay-hint>"]
+  ]
+}
+```
+
+#### Querying
+
+Fetch community-scoped content and moderation data together when relay limits permit. The `kinds` list can expand as the application adds supported community content kinds.
+
+```jsonc
+{
+  "kinds": [1111, 1984],
+  "#A": ["34550:<founder-pubkey>:<community-d-tag>"]
+}
+```
+
+Clients then filter client-side: discard unsupported kinds, discard non-member content from canonical community views, and process kind `1984` events per the moderation rules below. The moderation overlay is content-kind agnostic: a valid content ban or warning applies to the targeted event regardless of whether that event is a post, calendar event, poll, listing, or future supported kind.
+
+### Moderation
+
+Moderation uses kind `1984` ([NIP-56](https://github.com/nostr-protocol/nips/blob/master/56.md)) scoped to the community via the uppercase `A` tag. Moderation is derived state: clients first resolve trusted moderation actions from kind `1984`, then apply those actions to concrete community-scoped events.
+
+There are two tiers of moderation events:
+
+1. **Bans** -- authoritative actions from higher-ranked members that remove content or ban users. Identified by the presence of [NIP-32](https://github.com/nostr-protocol/nips/blob/master/32.md) label tags `["L", "moderation"]` and `["l", "ban", "moderation"]`.
+2. **Reports** -- soft flags from any valid community member using standard [NIP-56](https://github.com/nostr-protocol/nips/blob/master/56.md) report types (`nudity`, `spam`, `profanity`, `illegal`, `malware`, `impersonation`, `other`). No `L`/`l` tags. Clients display a content warning that users must click through to reveal.
+
+Kind `1984` events from **non-members** are ignored entirely within community context. Kind `1984` events from members who are themselves banned are also ignored after ban resolution; banned members cannot retain moderation or reporting authority.
+
+#### Bans (Authoritative Moderation)
+
+A ban is **authoritative** if and only if:
+
+1. The event contains `["l", "ban", "moderation"]` and `["L", "moderation"]` tags.
+2. The publisher is a validated community member.
+3. The publisher is not themselves banned after ban resolution.
+4. The publisher's rank is **strictly less than** the target's rank (or the target is a non-member).
+
+Bans that fail any of these conditions MUST be ignored.
+
+##### Content Ban
+
+Ban a specific post by publishing kind `1984` with `e`, `p`, and `A` tags plus the `ban` label. The `e` and `p` tags use `"other"` as the NIP-56 report type since the action is administrative rather than categorical.
+
+```jsonc
+{
+  "kind": 1984,
+  "pubkey": "<moderator-pubkey>",
+  "content": "Reason for removal",
+  "tags": [
+    ["e", "<offending-event-id>", "other"],
+    ["p", "<offending-author-pubkey>", "other"],
+    ["A", "34550:<founder-pubkey>:<community-d-tag>"],
+    ["L", "moderation"],
+    ["l", "ban", "moderation"]
+  ]
+}
+```
+
+Clients MUST omit the banned event from canonical community feeds entirely. The event is not displayed, blurred, or indicated in any way -- it is treated as if it does not exist.
+
+The `e` and `p` tags are untrusted until matched against the actual target event. A content ban MUST only apply when the targeted event's `id` matches the ban's `e` tag and the targeted event's `pubkey` matches the ban's `p` tag. This prevents a malicious or mistaken report from hiding an event by pairing its event ID with a lower-ranked or non-member pubkey.
+
+##### Member Ban
+
+Ban a member by publishing kind `1984` with `p` and `A` tags only (no `e` tag) plus the `ban` label. This is **non-cascading** -- only the targeted member is banned. Their kind `8` awards remain on relays, so downstream members whose chain passes through the banned member are still valid. For cascading removal, use badge revocation (kind `5`) instead.
+
+```jsonc
+{
+  "kind": 1984,
+  "pubkey": "<moderator-pubkey>",
+  "content": "Reason for ban",
+  "tags": [
+    ["p", "<banned-member-pubkey>", "other"],
+    ["A", "34550:<founder-pubkey>:<community-d-tag>"],
+    ["L", "moderation"],
+    ["l", "ban", "moderation"]
+  ]
+}
+```
+
+Clients distinguish content bans (`e` + `p` + `A` + `ban` label) from member bans (`p` + `A` + `ban` label, no `e` tag).
+
+#### Reports (Content Warnings)
+
+Any **valid, non-banned community member** (regardless of rank) may report content by publishing kind `1984` with a standard NIP-56 report type on the `e` and `p` tags. Reports do NOT use `L`/`l` label tags.
+
+```jsonc
+{
+  "kind": 1984,
+  "pubkey": "<member-pubkey>",
+  "content": "Additional context",
+  "tags": [
+    ["e", "<event-id>", "nudity"],
+    ["p", "<author-pubkey>", "nudity"],
+    ["A", "34550:<founder-pubkey>:<community-d-tag>"]
+  ]
+}
+```
+
+Clients SHOULD display reported content behind a content warning overlay that requires user interaction to reveal. The report type (e.g. `nudity`, `spam`) MAY be shown in the warning. Multiple reports on the same event reinforce the warning but do not automatically escalate to a ban.
+
+Reports from non-members and banned members are ignored.
+
+As with content bans, report warnings MUST only attach to content when the target event's `id` matches the report's `e` tag and the target event's `pubkey` matches the report's `p` tag.
+
+#### Classification Summary
+
+| `l` tag present? | `e` tag present? | Authority check | Result |
+|---|---|---|---|
+| `["l", "ban", "moderation"]` | Yes | Non-banned member; rank < target; `e`/`p` match target event | Content ban (omit event) |
+| `["l", "ban", "moderation"]` | No | Non-banned member; rank < target | Member ban |
+| No | Yes | Non-banned member; `e`/`p` match target event | Content warning |
+| No | No | -- | Invalid (ignored) |
+| Any | Any | Non-member | Ignored |
+| Any | Any | Banned member | Ignored |
+| `["l", "ban", "moderation"]` | Any | Rank >= target | Ignored |
+
+#### Rescinding Moderation
+
+A kind `1984` ban or report can be rescinded by deleting the kind `1984` event via kind `5` ([NIP-09](https://github.com/nostr-protocol/nips/blob/master/09.md)). Per NIP-09, only the original author of the kind `1984` event can delete it.
+
+```jsonc
+{
+  "kind": 5,
+  "tags": [["e", "<kind-1984-event-id>"], ["k", "1984"]]
+}
+```
+
+Clients that implement moderation rescinding SHOULD discard any kind `1984` event whose matching kind `5` deletion exists before resolving bans and reports. This branch does not implement moderation rescinding yet; it is retained here as part of the protocol foundation for future moderation extensions.
+
+### Revocation
+
+A badge awarder can revoke their own award via kind `5`:
+
+```jsonc
+{
+  "kind": 5,
+  "tags": [["e", "<kind-8-event-id>"], ["k", "8"]]
+}
+```
+
+This is **cascading** -- the chain link is destroyed, so the revoked member and all downstream members whose chain depended on it lose validated status. Per NIP-09, only the original publisher of the kind `8` event can delete it.
+
+**Ban vs revocation**: Use kind `1984` to ban a single member without affecting their downstream recruits. Use kind `5` revocation to remove a member and cascade to their entire subtree.
+
+### Community Updates
+
+Both kind `34550` and kind `30009` are addressable events. To add or remove ranks, republish the community definition with updated `a` tags. To update moderators, republish with updated `p` tags. Removing a moderator cascades to members they recruited (unless those members have another valid chain path). Only the founder (event publisher) can republish the community definition.
+
+### Discovery
+
+**Communities founded by a user:**
+
+```jsonc
+{ "kinds": [34550], "authors": ["<user-pubkey>"] }
+```
+
+**Communities a user belongs to:**
+
+1. `{ "kinds": [8], "#p": ["<user-pubkey>"] }`
+2. Extract badge `a` tags from results.
+3. `{ "kinds": [34550], "#a": ["30009:...", "..."] }`
+
+### Security Considerations
+
+- **Author filtering**: Clients MUST filter community definitions by `authors` to prevent impersonation.
+- **Chain validation is required**: Never trust kind `8` events without walking the authority chain.
+- **Badge d-tag uniqueness**: Use `<community-d-tag>-<rank-name>` to prevent cross-community collisions.
+- **Badge acceptance is cosmetic**: NIP-58 kind `10008`/`30008` events have no effect on chain validation.
+
+### Dependencies
+
+- [NIP-09](https://github.com/nostr-protocol/nips/blob/master/09.md) -- Event Deletion Request
+- [NIP-22](https://github.com/nostr-protocol/nips/blob/master/22.md) -- Comment
+- [NIP-31](https://github.com/nostr-protocol/nips/blob/master/31.md) -- Unknown Event Kinds (`alt` tag)
+- [NIP-32](https://github.com/nostr-protocol/nips/blob/master/32.md) -- Labeling (moderation `ban` label)
+- [NIP-56](https://github.com/nostr-protocol/nips/blob/master/56.md) -- Reporting
+- [NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md) -- Badges
+- [NIP-72](https://github.com/nostr-protocol/nips/blob/master/72.md) -- Moderated Communities
+
+---
+
 ## Kind 0 Extension: Avatar Shape
 
 ### Summary
@@ -351,13 +873,3 @@ NIP-44 encrypted personal letters with visual stationery, hand-drawn stickers, d
 **Firmware:** https://github.com/samthomson/weather-station
 
 Kind 16158 (replaceable) describes a weather station's configuration: name, geohash location, elevation, power source, connectivity, and sensor inventory. Kind 4223 (regular) carries individual sensor readings as 3-parameter tags `[sensor_type, value, model]`, enabling historical queries and cross-station comparison. Each station has its own keypair.
-
-### Blobbi Virtual Pet (Kinds 31124, 14919, 14920, 14921, 11125)
-
-**Author:** Danifra
-**Spec:** https://github.com/Danidfra/nostr-pet/blob/production/NIP.md
-**App:** https://nostr-pet.vercel.app
-**See also:** [Blobbi tag schema](docs/blobbi/blobbi-tag-schema.md) (Ditto-specific integration details)
-
-NIP-BB defines a virtual pet lifecycle on Nostr. Kind 31124 (addressable) holds the current pet state across three stages (egg, baby, adult) with stats, appearance, and personality traits. Kind 14919 logs individual interactions, kind 14920 records breeding events, kind 14921 stores immutable lifecycle records, and kind 11125 (replaceable) holds the owner's profile with coins, achievements, and inventory.
-

README.md

@@ -1,24 +1,25 @@
-# Ditto
+# Agora
 
-Your content. Your vibe. Your rules. A fun, customizable [Nostr](https://nostr.com/) client that puts you in control.
+Power to the people.
 
-**[ditto.pub](https://ditto.pub)** | **[Docs](https://docs.ditto.pub)** | **[Source](https://gitlab.com/soapbox-pub/ditto)**
+Agora is a Nostr client focused on community ownership, expressive identity, and censorship resistance. This repository (`agora-3`) is the Agora-branded app built from the Ditto codebase.
 
-## About
+**[agora.spot](https://agora.spot)** | **[Source](https://gitlab.com/soapbox-pub/agora-3)**
 
-Ditto is an open-source, decentralized social media client built on the Nostr protocol. It's designed for people who want to have fun online without feeding the Big Tech machine. Express yourself with custom themes, Lightning payments, and an ever-growing set of content types -- all while owning your identity and data.
+## What This Repo Is
 
-Made by [Soapbox](https://soapbox.pub).
+- Agora product identity (name, theme, assets, native IDs)
+- Ditto-derived implementation with broad Nostr feature coverage
+- Configurable deployment defaults via `agora.json`
 
 ## Features
 
-- **Theming** -- 9 built-in theme presets, 19 CSS token properties for full customization, and the ability to publish and share themes as Nostr events
-- **Infinite Content Types** -- Text notes, articles, short-form videos (Divines), live streams, polls, follow packs, color moments, magic decks, geocaching, and Webxdc mini-apps
-- **Lightning Payments** -- Zap posts and profiles with sats via Nostr Wallet Connect (NWC) or WebLN
-- **Private Messaging** -- End-to-end encrypted DMs (NIP-04 and NIP-17)
-- **Comments** -- Comment on anything: posts, URLs, profiles, hashtags, books, and more (NIP-22)
-- **Self-Hosting** -- Builds to static HTML/JS/CSS. Deploy anywhere -- GitHub Pages, Netlify, Vercel, a VPS, or a Raspberry Pi
-- **Mobile** -- Android native app via Capacitor, responsive design for all screen sizes
+- **Community-first social client**: notes, articles, comments, reposts, reactions, and rich event rendering
+- **Theming system**: built-in presets + custom color/font/background themes that can be shared as events
+- **Lightning support**: zaps with Nostr Wallet Connect and WebLN
+- **Private messaging**: NIP-04 and NIP-17 direct messages
+- **Mobile app shell**: Capacitor-powered Android/iOS wrappers
+- **Self-hostable**: static web build + configurable relay and upload infrastructure
 
 ## Getting Started
 
@@ -30,13 +31,43 @@ Made by [Soapbox](https://soapbox.pub).
 ### Development
 
 ```sh
-git clone https://gitlab.com/soapbox-pub/ditto.git
-cd ditto
+git clone https://gitlab.com/soapbox-pub/agora-3.git
+cd agora-3
 npm install
 npm run dev
 ```
 
-The dev server starts at `http://localhost:8080`.
+Development server: `http://localhost:8080`
+
+### Docker Getting Started
+
+Use Docker Compose when you want the nginx reverse-proxy stack (necessary if you want decryptable media in messages - kind 15s of NIP 17):
+
+```sh
+git clone https://gitlab.com/soapbox-pub/agora-3.git
+cd agora-3
+cp .env.example .env
+docker compose up --build
+```
+
+Proxy URL: `http://localhost:8083`
+
+This starts:
+
+- `vite` service on the internal Docker network (`vite:8080`)
+- `web` service (`nginx`) on host port `8082`, proxying to Vite with websocket support
+
+Stop stack:
+
+```sh
+docker compose down
+```
+
+Production-style container build:
+
+```sh
+docker compose -f docker-compose.prod.yml up --build
+```
 
 ### Build
 
@@ -44,66 +75,58 @@ The dev server starts at `http://localhost:8080`.
 npm run build
 ```
 
-The built site is output to `dist/`.
+Build output: `dist/`
 
-### Test
-
-Runs type-checking, linting, unit tests, and a production build:
+### Validate
 
 ```sh
 npm test
 ```
 
+This runs type-checking, linting, unit tests, and production build checks.
+
 ## Configuration
 
-Ditto is configured through a `ditto.json` file at the project root, read at build time. This file is gitignored so each deployment can have its own configuration.
+Build-time config is read from `agora.json` (gitignored by default so each deployment can provide its own values).
 
 ```jsonc
 {
   "theme": "dark",
   "relayMetadata": {
     "relays": [
-      { "url": "wss://relay.ditto.pub", "read": true, "write": true }
+      { "url": "wss://relay.ditto.pub", "read": true, "write": true },
+      { "url": "wss://relay.primal.net", "read": true, "write": true },
+      { "url": "wss://relay.damus.io", "read": true, "write": true }
     ]
   },
-  "blossomServers": ["https://blossom.ditto.pub"],
-  "feedSettings": {
-    "showPosts": true,
-    "showReposts": true,
-    "showArticles": true
-    // ...and more content type toggles
-  }
+  "blossomServers": [
+    "https://blossom.ditto.pub",
+    "https://blossom.primal.net/"
+  ]
 }
 ```
 
-Configuration is resolved in three layers (highest priority first):
+Configuration priority (highest first):
 
-1. **User settings** stored in localStorage
-2. **Build config** from `ditto.json`
-3. **Hardcoded defaults**
+1. User settings (local storage)
+2. Build config (`agora.json`)
+3. Hardcoded app defaults
 
-Use an alternate config file path with: `CONFIG_FILE=./my-config.json npm run build`
+Use a custom config path:
 
-### Custom Branding
-
-For self-hosted instances:
-
-- Replace `public/logo.svg` and `public/logo.png` with your logo
-- Update the app name in `index.html` and `public/manifest.webmanifest`
-- Replace `public/og-image.jpg` for social sharing previews
-- Set default relays and upload servers in `ditto.json`
+```sh
+CONFIG_FILE=./my-config.json npm run build
+```
 
 ## Deployment
 
-Ditto builds to static files and can be deployed anywhere that serves HTML.
+Agora builds to static files and can be deployed to any static host.
 
-- **GitHub Pages / GitLab Pages** -- Push to `main` and CI auto-deploys
-- **Netlify / Vercel** -- Connect your fork and deploy. A `_redirects` file is included for SPA routing
-- **VPS / Any web server** -- Build and copy `dist/` to your server. Configure SPA routing (e.g., Nginx `try_files $uri $uri/ /index.html`)
+- GitLab/GitHub Pages
+- Netlify/Vercel
+- VPS or any web server with SPA routing fallback
 
-### Android
-
-Build a native Android app with [Capacitor](https://capacitorjs.com/):
+For Android:
 
 ```sh
 npm run build
@@ -114,29 +137,20 @@ npx cap open android
 ## Tech Stack
 
 | Layer | Technology |
-|---|---|
+| --- | --- |
 | Framework | React 18 |
 | Build | Vite |
 | Language | TypeScript |
 | Styling | TailwindCSS 3 + shadcn/ui |
-| Routing | React Router 6 |
+| Routing | React Router |
 | Data | TanStack Query |
 | Nostr | Nostrify + nostr-tools |
 | Mobile | Capacitor |
 | Testing | Vitest + React Testing Library |
 
-## Project Structure
+## Contributing
 
-```
-src/
-  components/     UI components (100+), including shadcn/ui primitives
-  hooks/          Custom React hooks (65+)
-  pages/          Page components for each route (30+)
-  contexts/       React context providers
-  lib/            Utilities and shared logic
-  test/           Test setup and helpers
-public/           Static assets, icons, manifest
-```
+Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a merge request.
 
 ## License
 

android/app/build.gradle

@@ -7,14 +7,14 @@ if (keystorePropertiesFile.exists()) {
 }
 
 android {
-    namespace = "pub.ditto.app"
+    namespace = "pub.agora.app"
     compileSdk = rootProject.ext.compileSdkVersion
     defaultConfig {
-        applicationId "pub.ditto.app"
+        applicationId "pub.agora.app"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode 1
-        versionName "2.4.0"
+        versionName "2.8.0"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.

android/app/capacitor.build.gradle

@@ -11,9 +11,12 @@ apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"
 dependencies {
     implementation project(':capacitor-app')
     implementation project(':capacitor-filesystem')
+    implementation project(':capacitor-haptics')
+    implementation project(':capacitor-keyboard')
     implementation project(':capacitor-local-notifications')
     implementation project(':capacitor-share')
-    implementation project(':capacitor-status-bar')
+    implementation project(':capgo-capacitor-autofill-save-password')
+    implementation project(':capacitor-secure-storage-plugin')
 
 }
 

android/app/src/main/AndroidManifest.xml

@@ -3,6 +3,8 @@
 
     <application
         android:allowBackup="true"
+        android:fullBackupContent="@xml/backup_rules"
+        android:dataExtractionRules="@xml/data_extraction_rules"
         android:icon="@mipmap/ic_launcher"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
@@ -22,12 +24,12 @@
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
 
-            <!-- Deep links: open ditto.pub URLs in the app -->
+            <!-- Deep links: open agora.spot URLs in the app -->
             <intent-filter android:autoVerify="true">
                 <action android:name="android.intent.action.VIEW" />
                 <category android:name="android.intent.category.DEFAULT" />
                 <category android:name="android.intent.category.BROWSABLE" />
-                <data android:scheme="https" android:host="ditto.pub" />
+                <data android:scheme="https" android:host="agora.spot" />
             </intent-filter>
 
         </activity>

android/app/src/main/java/pub/ditto/app/DittoNotificationPlugin.java

@@ -1,7 +1,10 @@
 package pub.ditto.app;
 
-import android.content.SharedPreferences;
+import android.app.ForegroundServiceStartNotAllowedException;
 import android.content.Context;
+import android.content.Intent;
+import android.content.SharedPreferences;
+import android.os.Build;
 import android.util.Log;
 
 import com.getcapacitor.Plugin;
@@ -14,6 +17,10 @@ import org.json.JSONArray;
 /**
  * Capacitor plugin that allows the JS layer to configure the native
  * notification polling service with the user's pubkey and relay URLs.
+ *
+ * Supports two notification styles:
+ * - "push" (default): no foreground service, relies on push notifications
+ * - "persistent": starts NotificationRelayService as a foreground service
  */
 @CapacitorPlugin(name = "DittoNotification")
 public class DittoNotificationPlugin extends Plugin {
@@ -24,6 +31,7 @@ public class DittoNotificationPlugin extends Plugin {
     @PluginMethod
     public void configure(PluginCall call) {
         String userPubkey = call.getString("userPubkey");
+        String notificationStyle = call.getString("notificationStyle", "push");
         String relayUrlsRaw = null;
         String enabledKindsRaw = null;
         String authorsRaw = null;
@@ -60,7 +68,8 @@ public class DittoNotificationPlugin extends Plugin {
         if (userPubkey != null && relayUrlsRaw != null) {
             SharedPreferences.Editor editor = prefs.edit()
                     .putString("userPubkey", userPubkey)
-                    .putString("relayUrls", relayUrlsRaw);
+                    .putString("relayUrls", relayUrlsRaw)
+                    .putString("notificationStyle", notificationStyle);
             if (enabledKindsRaw != null) {
                 editor.putString("enabledKinds", enabledKindsRaw);
             }
@@ -70,13 +79,46 @@ public class DittoNotificationPlugin extends Plugin {
                 editor.remove("authors");
             }
             editor.apply();
-            Log.d(TAG, "Configured: pubkey=" + userPubkey.substring(0, 8) + "..., relays=" + relayUrlsRaw + ", kinds=" + enabledKindsRaw + ", authors=" + (authorsRaw != null ? authorsRaw.length() + " chars" : "all"));
+            Log.d(TAG, "Configured: pubkey=" + userPubkey.substring(0, 8) + "..., style=" + notificationStyle + ", relays=" + relayUrlsRaw + ", kinds=" + enabledKindsRaw + ", authors=" + (authorsRaw != null ? authorsRaw.length() + " chars" : "all"));
         } else {
             // Clear config (user logged out)
             prefs.edit().clear().apply();
             Log.d(TAG, "Config cleared (user logged out)");
         }
 
+        // Start or stop the foreground service based on style
+        manageService(notificationStyle, userPubkey != null && relayUrlsRaw != null);
+
         call.resolve();
     }
+
+    /**
+     * Start the foreground service when style is "persistent" and config is valid.
+     * Stop it otherwise.
+     */
+    private void manageService(String style, boolean hasConfig) {
+        Context ctx = getContext();
+        Intent serviceIntent = new Intent(ctx, NotificationRelayService.class);
+
+        if ("persistent".equals(style) && hasConfig) {
+            try {
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                    ctx.startForegroundService(serviceIntent);
+                } else {
+                    ctx.startService(serviceIntent);
+                }
+                Log.d(TAG, "Started NotificationRelayService (persistent mode)");
+            } catch (Exception e) {
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
+                        && e instanceof ForegroundServiceStartNotAllowedException) {
+                    Log.w(TAG, "Could not start foreground service: " + e.getMessage());
+                } else {
+                    Log.w(TAG, "Failed to start service", e);
+                }
+            }
+        } else {
+            ctx.stopService(serviceIntent);
+            Log.d(TAG, "Stopped NotificationRelayService (push mode or no config)");
+        }
+    }
 }

android/app/src/main/java/pub/ditto/app/MainActivity.java

@@ -1,7 +1,9 @@
 package pub.ditto.app;
 
 import android.app.ForegroundServiceStartNotAllowedException;
+import android.content.Context;
 import android.content.Intent;
+import android.content.SharedPreferences;
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
@@ -11,32 +13,36 @@ import com.getcapacitor.BridgeActivity;
 
 public class MainActivity extends BridgeActivity {
 
+    private static final String PREFS_NAME = "ditto_notification_config";
+
     @Override
     protected void onCreate(Bundle savedInstanceState) {
-        // Register the native notification config plugin before super.onCreate
+        // Register native plugins before super.onCreate.
         registerPlugin(DittoNotificationPlugin.class);
+        registerPlugin(SandboxPlugin.class);
 
         super.onCreate(savedInstanceState);
 
-        // Start the persistent relay connection service.
-        // On Android 12+ (API 31+) the system may throw
-        // ForegroundServiceStartNotAllowedException if the foreground service
-        // time limit for this type has already been exhausted. We catch it so
-        // the app continues to run normally; the alarm inside the service will
-        // retry at the next scheduled interval.
-        try {
-            Intent serviceIntent = new Intent(this, NotificationRelayService.class);
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-                startForegroundService(serviceIntent);
-            } else {
-                startService(serviceIntent);
-            }
-        } catch (Exception e) {
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
-                    && e instanceof ForegroundServiceStartNotAllowedException) {
-                Log.w("MainActivity", "Could not start NotificationRelayService: " + e.getMessage());
-            } else {
-                throw e;
+        // Only start the foreground service if the user has opted into
+        // "persistent" notification style. Default is "push" (no service).
+        SharedPreferences prefs = getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+        String style = prefs.getString("notificationStyle", "push");
+
+        if ("persistent".equals(style)) {
+            try {
+                Intent serviceIntent = new Intent(this, NotificationRelayService.class);
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+                    startForegroundService(serviceIntent);
+                } else {
+                    startService(serviceIntent);
+                }
+            } catch (Exception e) {
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
+                        && e instanceof ForegroundServiceStartNotAllowedException) {
+                    Log.w("MainActivity", "Could not start NotificationRelayService: " + e.getMessage());
+                } else {
+                    throw e;
+                }
             }
         }
 

android/app/src/main/java/pub/ditto/app/SandboxPlugin.java

@@ -0,0 +1,552 @@
+package pub.ditto.app;
+
+import android.graphics.Color;
+import android.graphics.PorterDuff;
+import android.os.Handler;
+import android.os.Looper;
+import android.util.Base64;
+import android.util.Log;
+import android.view.Gravity;
+import android.view.View;
+import android.view.ViewGroup;
+import android.webkit.JavascriptInterface;
+import android.webkit.WebResourceRequest;
+import android.webkit.WebResourceResponse;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+import android.webkit.WebViewClient;
+import android.widget.FrameLayout;
+import android.widget.ProgressBar;
+import androidx.coordinatorlayout.widget.CoordinatorLayout;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.io.ByteArrayInputStream;
+import java.io.InputStream;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * Capacitor plugin that creates isolated Android WebViews for sandboxed content.
+ *
+ * Each sandbox uses shouldInterceptRequest to intercept all requests and forward
+ * them to the JS layer as fetch events — the same protocol iframe.diy uses.
+ * The React code can serve files identically regardless of platform.
+ */
+@CapacitorPlugin(name = "SandboxPlugin")
+public class SandboxPlugin extends Plugin {
+
+    private static final String TAG = "SandboxPlugin";
+    private final Map<String, SandboxInstance> sandboxes = new HashMap<>();
+    private final Handler mainHandler = new Handler(Looper.getMainLooper());
+
+    @PluginMethod
+    public void create(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+
+        JSObject frame = call.getObject("frame");
+        if (frame == null) {
+            call.reject("Missing required parameter: frame");
+            return;
+        }
+
+        int x = frame.optInt("x", 0);
+        int y = frame.optInt("y", 0);
+        int width = frame.optInt("width", 0);
+        int height = frame.optInt("height", 0);
+
+        if (sandboxes.containsKey(sandboxId)) {
+            call.reject("Sandbox already exists: " + sandboxId);
+            return;
+        }
+
+        float density = getActivity().getResources().getDisplayMetrics().density;
+        int pxX = Math.round(x * density);
+        int pxY = Math.round(y * density);
+        int pxWidth = Math.round(width * density);
+        int pxHeight = Math.round(height * density);
+
+        mainHandler.post(() -> {
+            SandboxInstance sandbox = new SandboxInstance(sandboxId, this);
+            sandboxes.put(sandboxId, sandbox);
+
+            // Add the container (WebView + spinner overlay) on top of the
+            // Capacitor WebView. The parent is a CoordinatorLayout — using
+            // the wrong LayoutParams type causes a ClassCastException when
+            // it intercepts touch events.
+            View capWebView = getBridge().getWebView();
+            ViewGroup parent = (ViewGroup) capWebView.getParent();
+            CoordinatorLayout.LayoutParams params = new CoordinatorLayout.LayoutParams(pxWidth, pxHeight);
+            params.leftMargin = pxX;
+            params.topMargin = pxY;
+            parent.addView(sandbox.container, params);
+
+            // The spinner is now visible. Navigation is deferred until the
+            // JS layer calls navigate() — this allows the caller to
+            // pre-fetch blobs while the spinner animates.
+
+            call.resolve();
+        });
+    }
+
+    @PluginMethod
+    public void navigate(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+
+        mainHandler.post(() -> {
+            SandboxInstance sandbox = sandboxes.get(sandboxId);
+            if (sandbox == null) {
+                call.reject("Sandbox not found: " + sandboxId);
+                return;
+            }
+
+            sandbox.webView.loadUrl("https://" + sandboxId + ".sandbox.native/index.html");
+            call.resolve();
+        });
+    }
+
+    @PluginMethod
+    public void updateFrame(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+
+        JSObject frame = call.getObject("frame");
+        if (frame == null) {
+            call.reject("Missing required parameter: frame");
+            return;
+        }
+
+        int x = frame.optInt("x", 0);
+        int y = frame.optInt("y", 0);
+        int width = frame.optInt("width", 0);
+        int height = frame.optInt("height", 0);
+
+        float density = getActivity().getResources().getDisplayMetrics().density;
+        int pxX = Math.round(x * density);
+        int pxY = Math.round(y * density);
+        int pxWidth = Math.round(width * density);
+        int pxHeight = Math.round(height * density);
+
+        mainHandler.post(() -> {
+            SandboxInstance sandbox = sandboxes.get(sandboxId);
+            if (sandbox == null) {
+                call.reject("Sandbox not found: " + sandboxId);
+                return;
+            }
+
+            CoordinatorLayout.LayoutParams params = new CoordinatorLayout.LayoutParams(pxWidth, pxHeight);
+            params.leftMargin = pxX;
+            params.topMargin = pxY;
+            sandbox.container.setLayoutParams(params);
+
+            call.resolve();
+        });
+    }
+
+    @PluginMethod
+    public void respondToFetch(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+        String requestId = call.getString("requestId");
+        if (requestId == null) {
+            call.reject("Missing required parameter: requestId");
+            return;
+        }
+        JSObject response = call.getObject("response");
+        if (response == null) {
+            call.reject("Missing required parameter: response");
+            return;
+        }
+
+        SandboxInstance sandbox = sandboxes.get(sandboxId);
+        if (sandbox == null) {
+            call.reject("Sandbox not found: " + sandboxId);
+            return;
+        }
+
+        int status = response.optInt("status", 200);
+        String statusText = response.optString("statusText", "OK");
+        String bodyBase64 = response.optString("body", null);
+
+        Map<String, String> headers = new HashMap<>();
+        JSONObject headersObj = response.optJSONObject("headers");
+        if (headersObj != null) {
+            for (java.util.Iterator<String> it = headersObj.keys(); it.hasNext(); ) {
+                String key = it.next();
+                headers.put(key, headersObj.optString(key));
+            }
+        }
+
+        sandbox.resolveRequest(requestId, status, statusText, headers, bodyBase64);
+
+        call.resolve();
+    }
+
+    @PluginMethod
+    public void postMessage(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+        JSObject message = call.getObject("message");
+        if (message == null) {
+            call.reject("Missing required parameter: message");
+            return;
+        }
+
+        SandboxInstance sandbox = sandboxes.get(sandboxId);
+        if (sandbox == null) {
+            call.reject("Sandbox not found: " + sandboxId);
+            return;
+        }
+
+        mainHandler.post(() -> sandbox.postMessageToWebView(message.toString()));
+
+        call.resolve();
+    }
+
+    @PluginMethod
+    public void destroy(PluginCall call) {
+        String sandboxId = call.getString("id");
+        if (sandboxId == null) {
+            call.reject("Missing required parameter: id");
+            return;
+        }
+
+        mainHandler.post(() -> {
+            SandboxInstance sandbox = sandboxes.remove(sandboxId);
+            if (sandbox != null) {
+                ViewGroup parent = (ViewGroup) sandbox.container.getParent();
+                if (parent != null) {
+                    parent.removeView(sandbox.container);
+                }
+                sandbox.webView.destroy();
+            }
+            call.resolve();
+        });
+    }
+
+    void emitFetchRequest(String sandboxId, String requestId, JSObject request) {
+        JSObject data = new JSObject();
+        data.put("id", sandboxId);
+        data.put("requestId", requestId);
+        data.put("request", request);
+        notifyListeners("fetch", data);
+    }
+
+    void emitScriptMessage(String sandboxId, JSObject message) {
+        JSObject data = new JSObject();
+        data.put("id", sandboxId);
+        data.put("message", message);
+        notifyListeners("scriptMessage", data);
+    }
+
+    /**
+     * A single sandboxed WebView instance.
+     */
+    private static class SandboxInstance {
+        final String id;
+        /** Wrapper layout that holds the WebView and the loading overlay. */
+        final FrameLayout container;
+        final WebView webView;
+        final SandboxPlugin plugin;
+        private final ConcurrentHashMap<String, PendingRequest> pendingRequests = new ConcurrentHashMap<>();
+        /** Native spinner overlay, shown while the sandbox content loads. */
+        private ProgressBar spinner;
+
+        SandboxInstance(String id, SandboxPlugin plugin) {
+            this.id = id;
+            this.plugin = plugin;
+
+            this.container = new FrameLayout(plugin.getActivity());
+            this.webView = new WebView(plugin.getActivity());
+
+            WebSettings settings = webView.getSettings();
+            settings.setJavaScriptEnabled(true);
+            settings.setDomStorageEnabled(true);
+            settings.setAllowFileAccess(false);
+            settings.setAllowContentAccess(false);
+            settings.setDatabaseEnabled(true);
+
+            webView.setBackgroundColor(Color.parseColor("#14161f"));
+
+            // Add JavaScript interface for script->native communication.
+            webView.addJavascriptInterface(new SandboxBridge(this), "__sandboxNative");
+
+            // Inject the bridge script and intercept requests.
+            webView.setWebViewClient(new SandboxWebViewClient(this));
+
+            // Build the container: WebView fills it, spinner overlays on top.
+            container.addView(webView, new FrameLayout.LayoutParams(
+                    ViewGroup.LayoutParams.MATCH_PARENT,
+                    ViewGroup.LayoutParams.MATCH_PARENT));
+
+            // Native spinner overlay — uses the Android indeterminate
+            // ProgressBar which animates on the render thread, so it keeps
+            // spinning even when the main/IO threads are busy.
+            spinner = new ProgressBar(plugin.getActivity());
+            spinner.setIndeterminate(true);
+            spinner.getIndeterminateDrawable().setColorFilter(
+                    Color.parseColor("#7c5cdc"), PorterDuff.Mode.SRC_IN);
+            FrameLayout.LayoutParams spinnerParams = new FrameLayout.LayoutParams(
+                    dpToPx(plugin, 32), dpToPx(plugin, 32), Gravity.CENTER);
+            container.addView(spinner, spinnerParams);
+
+            // Dark background behind the spinner.
+            View overlay = new View(plugin.getActivity());
+            overlay.setBackgroundColor(Color.parseColor("#14161f"));
+            // Insert the overlay between the WebView (index 0) and spinner (index 1)
+            // so it covers the WebView but sits behind the spinner.
+            container.addView(overlay, 1, new FrameLayout.LayoutParams(
+                    ViewGroup.LayoutParams.MATCH_PARENT,
+                    ViewGroup.LayoutParams.MATCH_PARENT));
+        }
+
+        /** Remove the native loading overlay. Safe to call multiple times. */
+        void hideSpinner() {
+            if (spinner != null) {
+                // Remove spinner and overlay (indices 2 and 1 after WebView at 0).
+                if (container.getChildCount() > 2) container.removeViewAt(2); // spinner
+                if (container.getChildCount() > 1) container.removeViewAt(1); // overlay
+                spinner = null;
+            }
+        }
+
+        private static int dpToPx(SandboxPlugin plugin, int dp) {
+            float density = plugin.getActivity().getResources().getDisplayMetrics().density;
+            return Math.round(dp * density);
+        }
+
+        void postMessageToWebView(String jsonString) {
+            String js = "(function() { " +
+                    "if (window.__sandboxBridge && window.__sandboxBridge.onMessage) { " +
+                    "window.__sandboxBridge.onMessage(" + jsonString + "); " +
+                    "} " +
+                    "})();";
+            webView.evaluateJavascript(js, null);
+        }
+
+        void resolveRequest(String requestId, int status, String statusText,
+                            Map<String, String> headers, String bodyBase64) {
+            PendingRequest pending = pendingRequests.remove(requestId);
+            if (pending == null) return;
+
+            byte[] bodyBytes = null;
+            if (bodyBase64 != null && !bodyBase64.equals("null")) {
+                try {
+                    bodyBytes = Base64.decode(bodyBase64, Base64.DEFAULT);
+                } catch (Exception e) {
+                    Log.w(TAG, "Base64 decode failed for request " + requestId, e);
+                }
+            }
+
+            String contentType = headers.getOrDefault("Content-Type", "application/octet-stream");
+            String encoding = contentType.contains("text/") ? "UTF-8" : null;
+
+            InputStream body = bodyBytes != null
+                    ? new ByteArrayInputStream(bodyBytes)
+                    : new ByteArrayInputStream(new byte[0]);
+
+            WebResourceResponse response = new WebResourceResponse(
+                    contentType, encoding, status, statusText, headers, body
+            );
+
+            pending.resolve(response);
+        }
+    }
+
+    /**
+     * WebViewClient that intercepts all requests and forwards them to JS.
+     */
+    private static class SandboxWebViewClient extends WebViewClient {
+        private final SandboxInstance sandbox;
+        private boolean bridgeInjected = false;
+
+        SandboxWebViewClient(SandboxInstance sandbox) {
+            this.sandbox = sandbox;
+        }
+
+        @Override
+        public WebResourceResponse shouldInterceptRequest(WebView view, WebResourceRequest request) {
+            String url = request.getUrl().toString();
+
+            // Only intercept requests to the sandbox domain.
+            if (!url.contains(".sandbox.native")) {
+                return null;
+            }
+
+            String requestId = UUID.randomUUID().toString();
+
+            // Create a pending request with a blocking latch.
+            PendingRequest pending = new PendingRequest();
+            sandbox.pendingRequests.put(requestId, pending);
+
+            // Rewrite URL to include the sandbox ID for the JS handler.
+            String path = request.getUrl().getPath();
+            if (path == null || path.isEmpty()) path = "/";
+            String rewrittenURL = "https://" + sandbox.id + ".sandbox.native" + path;
+
+            // Serialise the request.
+            JSObject serialisedRequest = new JSObject();
+            serialisedRequest.put("url", rewrittenURL);
+            serialisedRequest.put("method", request.getMethod());
+
+            JSObject headers = new JSObject();
+            for (Map.Entry<String, String> entry : request.getRequestHeaders().entrySet()) {
+                headers.put(entry.getKey(), entry.getValue());
+            }
+            serialisedRequest.put("headers", headers);
+            serialisedRequest.put("body", JSONObject.NULL);
+
+            // Emit to JS.
+            sandbox.plugin.emitFetchRequest(sandbox.id, requestId, serialisedRequest);
+
+            // Block until JS responds. Each asset is fetched from a Blossom
+            // server over the network, so we need a generous timeout.  The
+            // WebView IO thread pool has ~6 threads; if all are blocked,
+            // subsequent requests queue until a thread frees up.
+            WebResourceResponse response = pending.awaitResponse(60000);
+
+            if (response != null) {
+                return response;
+            }
+
+            // Timeout — return error response.
+            sandbox.pendingRequests.remove(requestId);
+            return new WebResourceResponse(
+                    "text/plain", "UTF-8", 504,
+                    "Gateway Timeout", new HashMap<>(),
+                    new ByteArrayInputStream("Request timed out".getBytes())
+            );
+        }
+
+        @Override
+        public void onPageFinished(WebView view, String url) {
+            super.onPageFinished(view, url);
+
+            if (!bridgeInjected) {
+                bridgeInjected = true;
+                view.evaluateJavascript(getBridgeScript(), null);
+            }
+
+            // Remove the native spinner once the first page has finished
+            // loading (all initial resources resolved). This runs on the
+            // main thread, so the removal is safe.
+            sandbox.hideSpinner();
+        }
+
+        private String getBridgeScript() {
+            return "(function() {" +
+                    "'use strict';" +
+                    "var messageListeners = [];" +
+                    "window.__sandboxBridge = {" +
+                    "  onMessage: function(data) {" +
+                    "    var event = {" +
+                    "      data: data," +
+                    "      origin: 'https://" + sandbox.id + ".sandbox.native'," +
+                    "      source: window.parent," +
+                    "      type: 'message'" +
+                    "    };" +
+                    "    for (var i = 0; i < messageListeners.length; i++) {" +
+                    "      try { messageListeners[i](event); } catch(e) {}" +
+                    "    }" +
+                    "  }" +
+                    "};" +
+                    "var origAdd = window.addEventListener;" +
+                    "window.addEventListener = function(type, fn, opts) {" +
+                    "  if (type === 'message' && typeof fn === 'function') messageListeners.push(fn);" +
+                    "  return origAdd.call(window, type, fn, opts);" +
+                    "};" +
+                    "var origRemove = window.removeEventListener;" +
+                    "window.removeEventListener = function(type, fn, opts) {" +
+                    "  if (type === 'message') {" +
+                    "    var idx = messageListeners.indexOf(fn);" +
+                    "    if (idx !== -1) messageListeners.splice(idx, 1);" +
+                    "  }" +
+                    "  return origRemove.call(window, type, fn, opts);" +
+                    "};" +
+                    "if (!window.parent || window.parent === window) window.parent = {};" +
+                    "window.parent.postMessage = function(data) {" +
+                    "  if (data && typeof data === 'object' && data.jsonrpc === '2.0') {" +
+                    "    try { window.__sandboxNative.postMessage(JSON.stringify(data)); } catch(e) {}" +
+                    "  }" +
+                    "};" +
+                    "})();";
+        }
+    }
+
+    /**
+     * JavaScript interface exposed to the sandbox WebView.
+     */
+    private static class SandboxBridge {
+        private final SandboxInstance sandbox;
+
+        SandboxBridge(SandboxInstance sandbox) {
+            this.sandbox = sandbox;
+        }
+
+        @JavascriptInterface
+        public void postMessage(String json) {
+            try {
+                JSONObject obj = new JSONObject(json);
+                JSObject jsObj = new JSObject();
+                for (java.util.Iterator<String> it = obj.keys(); it.hasNext(); ) {
+                    String key = it.next();
+                    jsObj.put(key, obj.get(key));
+                }
+                sandbox.plugin.emitScriptMessage(sandbox.id, jsObj);
+            } catch (JSONException e) {
+                Log.w(TAG, "Failed to parse script message", e);
+            }
+        }
+    }
+
+    /**
+     * A pending request that blocks the WebViewClient IO thread until JS
+     * responds with the complete resource.
+     */
+    private static class PendingRequest {
+        private volatile WebResourceResponse response;
+        private final CountDownLatch latch = new CountDownLatch(1);
+
+        void resolve(WebResourceResponse response) {
+            this.response = response;
+            latch.countDown();
+        }
+
+        WebResourceResponse awaitResponse(long timeoutMs) {
+            try {
+                latch.await(timeoutMs, TimeUnit.MILLISECONDS);
+            } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+            }
+            return response;
+        }
+    }
+}

android/app/src/main/res/values/strings.xml

@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='utf-8'?>
 <resources>
-    <string name="app_name">Ditto</string>
-    <string name="title_activity_main">Ditto</string>
-    <string name="package_name">pub.ditto.app</string>
-    <string name="custom_url_scheme">pub.ditto.app</string>
+    <string name="app_name">Agora</string>
+    <string name="title_activity_main">Agora</string>
+    <string name="package_name">pub.agora.app</string>
+    <string name="custom_url_scheme">pub.agora.app</string>
 </resources>

android/app/src/main/res/xml/backup_rules.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+    Android Auto Backup rules (Android 11 and below).
+
+    Ditto excludes WebView storage (Local Storage, IndexedDB, databases) and
+    any shared_prefs that hold sensitive credentials so they don't end up in
+    Google Drive backups. Keychain/KeyStore entries used by
+    capacitor-secure-storage-plugin are not backed up by default, so we don't
+    need to exclude those explicitly; but we also exclude the plugin's
+    SharedPreferences for defense in depth.
+
+    See: https://developer.android.com/guide/topics/data/autobackup
+-->
+<full-backup-content>
+    <!-- WebView: localStorage, IndexedDB, cookies, caches -->
+    <exclude domain="file" path="app_webview/" />
+    <exclude domain="database" path="webview.db" />
+    <exclude domain="database" path="webviewCache.db" />
+
+    <!-- capacitor-secure-storage-plugin fallback SharedPreferences -->
+    <exclude domain="sharedpref" path="CapacitorSecureStoragePluginSharedPreferences.xml" />
+
+    <!-- Capacitor preferences plugin — may contain app-level settings -->
+    <exclude domain="sharedpref" path="CapacitorStorage.xml" />
+</full-backup-content>

android/app/src/main/res/xml/data_extraction_rules.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+    Android 12+ data extraction rules.
+
+    Separate rules apply to cloud backups (Google Drive) and device-to-device
+    transfers. Both exclude WebView storage and sensitive SharedPreferences so
+    wallet credentials, login tokens, and cached private data don't leak.
+
+    See: https://developer.android.com/about/versions/12/backup-restore
+-->
+<data-extraction-rules>
+    <cloud-backup>
+        <exclude domain="file" path="app_webview/" />
+        <exclude domain="database" path="webview.db" />
+        <exclude domain="database" path="webviewCache.db" />
+        <exclude domain="sharedpref" path="CapacitorSecureStoragePluginSharedPreferences.xml" />
+        <exclude domain="sharedpref" path="CapacitorStorage.xml" />
+    </cloud-backup>
+    <device-transfer>
+        <exclude domain="file" path="app_webview/" />
+        <exclude domain="database" path="webview.db" />
+        <exclude domain="database" path="webviewCache.db" />
+        <exclude domain="sharedpref" path="CapacitorSecureStoragePluginSharedPreferences.xml" />
+        <exclude domain="sharedpref" path="CapacitorStorage.xml" />
+    </device-transfer>
+</data-extraction-rules>

android/capacitor.settings.gradle

@@ -8,11 +8,20 @@ project(':capacitor-app').projectDir = new File('../node_modules/@capacitor/app/
 include ':capacitor-filesystem'
 project(':capacitor-filesystem').projectDir = new File('../node_modules/@capacitor/filesystem/android')
 
+include ':capacitor-haptics'
+project(':capacitor-haptics').projectDir = new File('../node_modules/@capacitor/haptics/android')
+
+include ':capacitor-keyboard'
+project(':capacitor-keyboard').projectDir = new File('../node_modules/@capacitor/keyboard/android')
+
 include ':capacitor-local-notifications'
 project(':capacitor-local-notifications').projectDir = new File('../node_modules/@capacitor/local-notifications/android')
 
 include ':capacitor-share'
 project(':capacitor-share').projectDir = new File('../node_modules/@capacitor/share/android')
 
-include ':capacitor-status-bar'
-project(':capacitor-status-bar').projectDir = new File('../node_modules/@capacitor/status-bar/android')
+include ':capgo-capacitor-autofill-save-password'
+project(':capgo-capacitor-autofill-save-password').projectDir = new File('../node_modules/@capgo/capacitor-autofill-save-password/android')
+
+include ':capacitor-secure-storage-plugin'
+project(':capacitor-secure-storage-plugin').projectDir = new File('../node_modules/capacitor-secure-storage-plugin/android')

capacitor.config.ts

@@ -1,12 +1,10 @@
 import type { CapacitorConfig } from '@capacitor/cli';
 
 const config: CapacitorConfig = {
-  appId: 'pub.ditto.app',
-  appName: 'Ditto',
+  appId: 'pub.agora.app',
+  appName: 'Agora',
   webDir: 'dist',
   server: {
-    // Handle deep links from your domain
-    hostname: 'ditto.pub',
     androidScheme: 'https',
     iosScheme: 'https'
   },
@@ -17,9 +15,16 @@ const config: CapacitorConfig = {
   },
   ios: {
     backgroundColor: '#14161f',
-    contentInset: 'automatic',
-    scheme: 'Ditto'
-  }
+    contentInset: 'never',
+    scheme: 'Agora'
+  },
+  plugins: {
+    SystemBars: {
+      // Inject --safe-area-inset-* CSS variables on Android to work around
+      // a Chromium bug (<140) where env(safe-area-inset-*) reports 0.
+      insetsHandling: 'css',
+    },
+  },
 };
 
 export default config;

docker-compose.prod.yml

@@ -0,0 +1,6 @@
+services:
+  web:
+    build: .
+    restart: unless-stopped
+    expose:
+      - "80"

docker-compose.yml

@@ -0,0 +1,30 @@
+services:
+  web:
+    image: nginx:alpine
+    ports:
+      - "8083:80"
+    volumes:
+      - ./nginx.dev.conf:/etc/nginx/conf.d/default.conf:ro
+      - ./dist:/usr/share/nginx/html:ro
+    restart: unless-stopped
+    depends_on:
+      - vite
+    networks:
+      - agora-network
+
+  vite:
+    image: node:22-alpine
+    working_dir: /app
+    # Use host node_modules so new dependencies are picked up after install.
+    command: sh -c "npm install && npm run dev"
+    volumes:
+      - .:/app
+    environment:
+      - NODE_ENV=development
+    networks:
+      - agora-network
+    restart: unless-stopped
+
+networks:
+  agora-network:
+    driver: bridge

docs/THEME_SYSTEM.md

@@ -1,383 +0,0 @@
-# Theme System
-
-This document describes the two separate but overlapping theme features in Ditto: the **App Theme** (which controls the local UI) and the **Profile Theme** (which is published to Nostr for others to see). Understanding the distinction is key to working with this codebase.
-
-## Overview
-
-| Concept | Purpose | Scope | Persistence |
-|---|---|---|---|
-| **App Theme** | Controls colors, fonts, and background of the local UI | Local to the user's browser | localStorage + encrypted NIP-78 sync |
-| **Profile Theme** | A set of theme values published as a Nostr event | Public, visible to other users | Kind 16767 replaceable event |
-
-The App Theme and Profile Theme share the same underlying data structure (`ThemeConfig`), and there is an optional bridge between them (`autoShareTheme`), but they are fundamentally independent systems.
-
----
-
-## Part 1: App Theme
-
-The App Theme controls what the user sees in their own browser. It has no inherent connection to Nostr.
-
-### Core Concept: 3 Colors Define Everything
-
-The entire theme is derived from just 3 core colors, defined by the `CoreThemeColors` interface in `src/themes.ts:8`:
-
-```typescript
-interface CoreThemeColors {
-  background: string;  // HSL string, e.g. "228 20% 10%"
-  text: string;        // Text/foreground color
-  primary: string;     // Primary accent (buttons, links, focus rings)
-}
-```
-
-From these 3 values, the system auto-derives 19 CSS tokens (the full `ThemeTokens` set) via `deriveTokensFromCore()` in `src/lib/colorUtils.ts:141`. The derivation algorithm:
-
-- Detects dark/light mode from background luminance (threshold: 0.2)
-- Derives `card` and `popover` surfaces by slightly lightening the background (dark mode) or using it directly (light mode)
-- Derives `secondary` and `muted` surfaces by adjusting background lightness
-- Derives `border` using the primary hue with reduced saturation
-- Computes `mutedForeground` as a dimmer version of the text color
-- Sets `accent = primary` and `ring = primary`
-- Auto-computes `primaryForeground` using WCAG contrast detection (white or dark)
-- Uses fixed red values for `destructive` / `destructiveForeground`
-
-### Theme Modes
-
-The `Theme` type (`src/contexts/AppContext.ts:9`) has four values:
-
-| Mode | Behavior |
-|---|---|
-| `"light"` | Uses the builtin (or configured) light color set |
-| `"dark"` | Uses the builtin (or configured) dark color set |
-| `"system"` | Resolves to `"light"` or `"dark"` based on `prefers-color-scheme`, with a live media query listener |
-| `"custom"` | Uses user-defined colors stored in `config.customTheme` |
-
-**Builtin themes** are defined in `src/themes.ts:102`:
-
-```typescript
-const builtinThemes = {
-  light: { background: '270 50% 97%', text: '270 25% 12%', primary: '270 65% 55%' },
-  dark:  { background: '228 20% 10%', text: '210 40% 98%', primary: '258 70% 60%' },
-};
-```
-
-Self-hosters can override these at build time via `ditto.json` (injected through `import.meta.env.DITTO_CONFIG` in `vite.config.ts`), or at runtime via the `ThemesConfig` in `AppConfig.themes`.
-
-### ThemeConfig
-
-The `ThemeConfig` type (`src/themes.ts:50`) wraps the 3 core colors with optional extras:
-
-```typescript
-interface ThemeConfig {
-  title?: string;
-  colors: CoreThemeColors;
-  font?: ThemeFont;        // { family: string; url?: string }
-  background?: ThemeBackground;  // { url: string; mode?: 'cover' | 'tile'; ... }
-}
-```
-
-This is the canonical type used everywhere: in `AppConfig.customTheme`, in encrypted settings, and in Nostr theme events.
-
-### Theme Presets
-
-Named presets are defined in `src/themes.ts:136` (e.g. `pink`, `toxic`, `sunset`). Each preset includes core colors and optionally a font and background image. Applying a preset sets the app theme to `"custom"` and stores the preset's config as `customTheme`.
-
-### How Themes Apply to the DOM
-
-The theme pipeline has three stages designed to prevent any flash of wrong colors:
-
-#### Stage 1: Pre-React Blocking Script (`public/theme.js`)
-
-A synchronous `<script>` tag in `index.html:43` runs before React mounts. It:
-
-1. Reads `nostr:app-config` from localStorage
-2. Resolves `"system"` via `matchMedia`
-3. Handles legacy presets (`"black"`, `"pink"`)
-4. Sets `document.documentElement.className` to the theme name
-5. Sets `document.body.style.background` to the correct background color
-6. Updates preloader colors (logo and spinner) to match
-
-This prevents any visible flash between the hardcoded dark defaults in `index.html:32` and the user's actual theme.
-
-#### Stage 2: React Provider (`src/components/AppProvider.tsx`)
-
-Three private hooks run during the provider's lifecycle:
-
-**`useApplyTheme`** (line 91) - Uses `useLayoutEffect` (synchronous before paint) to:
-- Resolve the theme mode
-- Build a full CSS string from `CoreThemeColors` via `buildThemeCssFromCore()`
-- Inject/update a `<style id="theme-vars">` element with all 19 CSS custom properties
-- Set `document.documentElement.className` to the resolved theme
-- Remove the inline body style left by `theme.js`
-- When mode is `"system"`, attach a `matchMedia` change listener
-
-**`useApplyFonts`** (line 133) - Loads and applies custom fonts via `loadAndApplyFont()` from `src/lib/fontLoader.ts`.
-
-**`useApplyBackground`** (line 156) - Injects/removes a `<style id="theme-background">` for background images (cover or tile mode).
-
-#### Stage 3: Theme Switch (`src/hooks/useTheme.ts`)
-
-The `setTheme()` function (line 52) performs a flicker-free theme switch:
-
-1. Injects a temporary `<style>` that disables all CSS transitions (`transition: none !important`)
-2. Synchronously builds and applies CSS vars before React re-renders
-3. Updates `document.documentElement.className`
-4. Re-enables transitions after browser paint via `requestAnimationFrame`
-5. Updates localStorage config
-6. Debounce-syncs to encrypted NIP-78 storage (1 second delay)
-
-### How Components Consume Theme Values
-
-#### CSS Custom Properties to Tailwind
-
-`tailwind.config.ts` maps all 19 CSS custom properties to Tailwind color utilities:
-
-```typescript
-colors: {
-  background: 'hsl(var(--background))',
-  foreground: 'hsl(var(--foreground))',
-  primary: { DEFAULT: 'hsl(var(--primary))', foreground: 'hsl(var(--primary-foreground))' },
-  // ... (secondary, destructive, muted, accent, popover, card, border, input, ring)
-}
-```
-
-Components use standard Tailwind classes like `bg-primary`, `text-foreground`, `border-border`, etc. These resolve to `hsl(var(--primary))`, which picks up whichever values are currently set on `:root`.
-
-The `cn()` utility in `src/lib/utils.ts` combines `clsx` (conditional class joining) with `tailwind-merge` (intelligent Tailwind class deduplication).
-
-#### Static CSS
-
-`src/index.css` applies base styles using theme tokens:
-
-```css
-* { @apply border-border; }
-body { @apply bg-background text-foreground; }
-```
-
-The only static CSS custom property is `--radius: 0.75rem`. All color variables are injected dynamically.
-
-### ScopedTheme
-
-The `ScopedTheme` component (`src/components/ScopedTheme.tsx`) applies a different set of theme colors to a DOM subtree by setting CSS variables as inline `style`:
-
-```tsx
-<ScopedTheme colors={someColors} className="rounded-lg p-4">
-  {/* Children here see different --background, --primary, etc. */}
-</ScopedTheme>
-```
-
-It also sets `data-theme-mode="dark"` or `"light"` based on background luminance, for CSS targeting.
-
-### App Theme Persistence
-
-#### Layer 1: localStorage (immediate)
-
-The `useLocalStorage` hook (`src/hooks/useLocalStorage.ts`) stores the full `AppConfig` under key `"nostr:app-config"`. This includes `theme`, `customTheme`, `autoShareTheme`, and `themes`. Changes are reflected immediately and support cross-tab sync via `StorageEvent`.
-
-#### Layer 2: Encrypted NIP-78 Settings (cross-device sync)
-
-The `useEncryptedSettings` hook (`src/hooks/useEncryptedSettings.ts`) stores theme preferences in a kind 30078 addressable event, encrypted to self via NIP-44. The `EncryptedSettings` interface includes `theme`, `customTheme`, and `autoShareTheme` among other app settings.
-
-Key behaviors:
-- Query is delayed 5 seconds after login to avoid competing with feed load
-- Uses optimistic updates with a `pendingSettings` ref for rapid successive mutations
-- A `recentlyWritten()` guard returns true for 10 seconds after a local write to prevent `NostrSync` from overwriting the value that was just saved
-
-#### Sync via NostrSync
-
-The `NostrSync` component (`src/components/NostrSync.tsx`) runs globally and syncs encrypted settings from Nostr on login. For theme-related fields, it:
-
-1. Seeds a `lastSyncedTimestamp` ref on first load to prevent stale events from overwriting local config
-2. Skips application if `recentlyWritten()` is true
-3. Only applies changes if the remote timestamp is newer
-4. Handles legacy theme value migration (`"black"`, `"pink"` to `"custom"`)
-5. Diffs each field individually to avoid unnecessary re-renders
-
----
-
-## Part 2: Profile Theme
-
-The Profile Theme is a public Nostr event that represents a user's chosen theme. Other clients can read it to style that user's profile page, or users can browse and copy each other's themes.
-
-### Nostr Event Kinds
-
-#### Kind 36767: Theme Definition (addressable, multiple per user)
-
-A shareable, named theme that a user has created. Think of these as "published theme presets." Tags:
-
-| Tag | Purpose | Example |
-|---|---|---|
-| `d` | Identifier (slug) | `["d", "ocean-night"]` |
-| `c` | Color (hex + role) | `["c", "#1a1a2e", "background"]` |
-| `f` | Font (family + optional URL) | `["f", "Comfortaa", "https://cdn.jsdelivr.net/..."]` |
-| `bg` | Background (imeta-style variadic) | `["bg", "url https://...", "mode cover", "m image/jpeg"]` |
-| `title` | Display name | `["title", "Ocean Night"]` |
-| `alt` | NIP-31 description | `["alt", "Custom theme: Ocean Night"]` |
-| `t` | Topic tag | `["t", "theme"]` |
-| `description` | Optional description | `["description", "A deep blue theme"]` |
-
-Colors are stored as **hex** in `c` tags (converted to/from HSL internally). The `content` field is empty (legacy events may have JSON in content for backward compatibility).
-
-#### Kind 16767: Active Profile Theme (replaceable, one per user)
-
-The user's currently active profile theme. Same tag structure as kind 36767 but without `d` or `description` tags, and with an optional `a` tag referencing the source theme definition:
-
-| Tag | Purpose |
-|---|---|
-| `c` | Color tags (same as 36767) |
-| `f` | Font tag (same as 36767) |
-| `bg` | Background tag (same as 36767) |
-| `alt` | Always `"Active profile theme"` |
-| `title` | Optional theme name |
-| `a` | Optional reference to source kind 36767 event |
-
-### Hooks
-
-| Hook | File | Purpose |
-|---|---|---|
-| `usePublishTheme` | `src/hooks/usePublishTheme.ts` | Publish/update/delete theme definitions (36767), set/clear active profile theme (16767) |
-| `useUserThemes` | `src/hooks/useUserThemes.ts` | Query all kind 36767 themes by a user, deduplicated by d-tag, sorted newest first |
-| `useActiveProfileTheme` | `src/hooks/useActiveProfileTheme.ts` | Query a user's kind 16767 active profile theme |
-
-### Publishing and Parsing
-
-All event building and parsing is in `src/lib/themeEvent.ts`:
-
-- `buildThemeDefinitionTags()` / `parseThemeDefinition()` - Kind 36767
-- `buildActiveThemeTags()` / `parseActiveProfileTheme()` - Kind 16767
-- `buildColorTags()` / `parseColorTags()` - HSL-to-hex conversion for `c` tags
-- `buildFontTag()` / `parseFontTag()` - Font `f` tags
-- `buildBackgroundTag()` / `parseBackgroundTag()` - Background `bg` tags (imeta-style)
-- `titleToSlug()` - Generate d-tag identifiers from titles
-
-Backward compatibility: if `c` tags are missing, the parser falls back to reading legacy JSON from `content` (handling both the old 19-token format and the 4-color format).
-
----
-
-## Part 3: The Bridge Between App Theme and Profile Theme
-
-The two systems are connected by the **autoShareTheme** setting and the NostrSync component.
-
-### App Theme -> Profile Theme
-
-When `autoShareTheme` is enabled (default: `true`) and the user applies a custom theme via `applyCustomTheme()`, the `useTheme` hook automatically publishes the custom theme as a kind 16767 active profile theme, debounced by 2 seconds.
-
-```
-User picks a custom theme
-  -> applyCustomTheme() in useTheme.ts:88
-    -> Updates local config (localStorage)
-    -> Syncs to encrypted NIP-78 storage (1s debounce)
-    -> If autoShareTheme: publishes kind 16767 (2s debounce)
-```
-
-### Profile Theme -> App Theme
-
-On page load, if `autoShareTheme` is enabled, `NostrSync` (line 174) fetches the user's kind 16767 event and applies it as `customTheme` **without changing the theme mode**. This means:
-
-- If the user is on `theme: "dark"`, their profile theme is stored as `customTheme` but the UI stays in dark mode
-- If the user is on `theme: "custom"`, the profile theme's colors are applied to the UI
-- This allows the profile theme to stay in sync across devices without forcing the user into custom mode
-
-### Theme Definitions (Kind 36767)
-
-Theme definitions are independent of the app theme. Users can create, publish, edit, and delete named themes. Other users can view them in feeds (via `ThemeUpdateCard`) and copy them. These are purely social objects on the Nostr network.
-
----
-
-## Font System
-
-Fonts are managed by `src/lib/fontLoader.ts` and `src/lib/fonts.ts`.
-
-### Bundled Fonts
-
-10 fonts are bundled via `@fontsource` packages with lazy loading (dynamic imports):
-
-| Category | Fonts |
-|---|---|
-| Sans | Inter, DM Sans, Outfit, Montserrat |
-| Serif | Lora, Merriweather, Playfair Display |
-| Mono | JetBrains Mono |
-| Display | Comfortaa |
-| Handwriting | Comic Relief |
-
-Each has a `load()` function and a `cdnUrl` for Nostr event publishing.
-
-### Font Application
-
-Three `<style>` elements manage fonts:
-
-| ID | Purpose |
-|---|---|
-| `theme-font-faces` | `@font-face` rules for remote fonts |
-| `theme-font-overrides` | `html { font-family: "CustomFont", "Inter Variable", ... !important; }` |
-| `theme-vars` | Theme CSS custom properties (not font-specific, but part of the pipeline) |
-
-The `loadAndApplyFont()` function:
-1. Tries to load via bundled `@fontsource` package first
-2. Falls back to injecting a `@font-face` rule from a remote URL
-3. Applies a global font-family override via `<style id="theme-font-overrides">`
-4. Passing `undefined` clears the override (reverts to default Inter)
-
----
-
-## Color Utilities
-
-`src/lib/colorUtils.ts` provides the color math underpinning the theme system:
-
-| Function | Purpose |
-|---|---|
-| `parseHsl` / `formatHsl` | Parse/format HSL strings (`"228 20% 10%"`) |
-| `hslToRgb` / `rgbToHsl` | HSL-RGB conversion |
-| `hexToRgb` / `rgbToHex` | Hex-RGB conversion |
-| `hexToHslString` / `hslStringToHex` | Direct hex-to-HSL-string conversion (used for Nostr `c` tags) |
-| `getLuminance` | WCAG 2.1 relative luminance |
-| `getContrastRatio` / `getContrastRatioHsl` | WCAG contrast ratio between two colors |
-| `isDarkTheme` | Determines if a background is "dark" (luminance < 0.2) |
-| `deriveTokensFromCore` | The core algorithm: 3 colors -> 19 tokens |
-| `tokensToCoreColors` | Extract 3 core colors from a legacy 19-token object |
-
-All colors are stored internally as HSL strings without the `hsl()` wrapper (e.g. `"228 20% 10%"`). The `hsl()` wrapper is added by Tailwind's config (`hsl(var(--background))`).
-
----
-
-## Validation
-
-Theme data is validated with Zod schemas in `src/lib/schemas.ts`:
-
-- `ThemeSchema` - Validates `'dark' | 'light' | 'system' | 'custom'`
-- `CoreThemeColorsSchema` - Validates the 3 HSL string fields
-- `ThemeConfigSchema` - Full config with optional font/background
-- `ThemeConfigCompatSchema` - Accepts both `ThemeConfig` and bare `CoreThemeColors`
-- `ThemeColorsCompatSchema` - Union of current 3-color, old 4-color, and legacy 19-token formats
-- `AppConfigSchema` - Full app config including all theme fields
-- `EncryptedSettingsSchema` - Encrypted settings including theme fields
-
-The `AppProvider` deserializer (`src/components/AppProvider.tsx:32`) validates each top-level field individually with `safeParse`, so a single invalid field doesn't nuke the entire config.
-
----
-
-## File Index
-
-| File | Role |
-|---|---|
-| `src/themes.ts` | Core types (`CoreThemeColors`, `ThemeConfig`, `ThemeTokens`), builtin themes, presets, CSS builders |
-| `src/lib/colorUtils.ts` | Color conversion, contrast detection, token derivation |
-| `src/lib/themeEvent.ts` | Nostr event kinds (36767, 16767), tag building/parsing |
-| `src/lib/fontLoader.ts` | Font loading and CSS injection |
-| `src/lib/fonts.ts` | Bundled font definitions |
-| `src/lib/schemas.ts` | Zod validation schemas |
-| `src/contexts/AppContext.ts` | `Theme` type, `AppConfig` interface, React context |
-| `src/hooks/useTheme.ts` | Primary theme API: `setTheme()`, `applyCustomTheme()`, `setAutoShareTheme()` |
-| `src/hooks/useAppContext.ts` | Context consumer hook |
-| `src/hooks/useEncryptedSettings.ts` | NIP-78 encrypted settings (cross-device sync) |
-| `src/hooks/usePublishTheme.ts` | Publish theme definitions and active profile theme |
-| `src/hooks/useUserThemes.ts` | Query user's theme definitions |
-| `src/hooks/useActiveProfileTheme.ts` | Query user's active profile theme |
-| `src/components/AppProvider.tsx` | Theme application to DOM (`useApplyTheme`, `useApplyFonts`, `useApplyBackground`) |
-| `src/components/NostrSync.tsx` | Cross-device sync for encrypted settings and profile theme |
-| `src/components/ScopedTheme.tsx` | Scoped CSS variable overrides for subtrees |
-| `src/components/ThemeSelector.tsx` | Full settings UI for theme management |
-| `src/components/SidebarThemeDropdown.tsx` | Compact theme picker dropdown |
-| `public/theme.js` | Pre-React blocking script for flash prevention |
-| `index.html` | Hardcoded dark defaults, preloader, blocking script tag |
-| `tailwind.config.ts` | CSS custom property to Tailwind color mapping |
-| `src/index.css` | Base styles using theme tokens |

docs/blobbi/blobbi-tag-schema.md

@@ -1,254 +0,0 @@
-# Blobbi Tag Schema
-
-> **Product Specification** - This document is the canonical source of truth for Blobbi tag definitions.  
-> The runtime schema at `src/lib/blobbi-tag-schema.ts` MUST align with this spec.
-
-## Overview
-
-Blobbi events (Kind 31124) use tags to store all state data. This document defines:
-- All valid tags and their purposes
-- Which tags are required vs optional
-- Which tags persist across stage transitions
-- Which tags should be removed during transitions
-- Deprecated tags that should be filtered out
-
----
-
-## Tag Categories
-
-### 1. System / Metadata Tags
-
-Core protocol-level tags required for event identification and ecosystem membership.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `d` | **Yes** | egg, baby, adult | Yes | system | `blobbi-{pubkeyPrefix12}-{petId10}` | Unique identifier (addressable event d-tag) |
-| `b` | **Yes** | egg, baby, adult | Yes | system | `blobbi:ecosystem:v1` | Ecosystem namespace identifier |
-| `t` | **Yes** | egg, baby, adult | Yes | system | `blobbi` | Topic tag for discoverability |
-| `client` | No | egg, baby, adult | Yes | system | `blobbi` | Client identifier |
-
-### 2. Core Identity Tags
-
-Tags that define the Blobbi's unique identity. These MUST be preserved across all transitions.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `name` | **Yes** | egg, baby, adult | Yes | user | string | Display name (set during adoption) |
-| `seed` | **Yes** | egg, baby, adult | Yes | system | 64 hex chars | Deterministic seed for visual traits |
-| `generation` | No | egg, baby, adult | Yes | system | positive integer | Lineage generation (default: 1) |
-
-**Important**: The `seed` is derived once at creation using `sha256("blobbi:v1|{pubkey}:{d}:{createdAt}")` and MUST NEVER be recomputed.
-
-### 3. Visual Trait Tags
-
-Tags derived deterministically from the seed. These are stored explicitly for fast rendering and compatibility.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `base_color` | No | egg, baby, adult | Yes | generated | CSS hex (e.g., `#F59E0B`) | Primary color |
-| `secondary_color` | No | egg, baby, adult | Yes | generated | CSS hex | Secondary/accent color |
-| `eye_color` | No | egg, baby, adult | Yes | generated | CSS hex | Eye color |
-| `pattern` | No | egg, baby, adult | Yes | generated | `solid\|spotted\|striped\|gradient` | Visual pattern type |
-| `special_mark` | No | egg, baby, adult | Yes | generated | `none\|star\|heart\|sparkle\|blush` | Special decoration |
-| `size` | No | egg, baby, adult | Yes | generated | `small\|medium\|large` | Size category |
-
-**Regenerable**: These tags CAN be regenerated from the seed if missing. However, they should be preserved when present.
-
-### 4. Personality / Trait Tags
-
-Character traits that define the Blobbi's personality. These are generated at creation and MUST persist.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `personality` | No | egg, baby, adult | Yes | generated | string | Core personality type |
-| `trait` | No | egg, baby, adult | Yes | generated | string | Character trait modifier |
-| `favorite_food` | No | egg, baby, adult | Yes | generated | string | Preferred food type |
-| `voice_type` | No | egg, baby, adult | Yes | generated | string | Voice characteristic |
-| `mood` | No | egg, baby, adult | Yes | computed | string | Current emotional state |
-
-**Not Regenerable**: These tags are generated once and MUST be preserved. Do NOT invent values for existing Blobbis that lack these tags.
-
-### 5. Stat Tags
-
-Numeric values representing the Blobbi's current condition. These are actively computed and change frequently.
-
-| Tag | Required | Stages | Persistent | Source | Format | Default | Description |
-|-----|----------|--------|------------|--------|--------|---------|-------------|
-| `hunger` | No | egg, baby, adult | No | computed | 1-100 | 100 | Fullness level |
-| `happiness` | No | egg, baby, adult | No | computed | 1-100 | 100 | Happiness level |
-| `health` | No | egg, baby, adult | No | computed | 1-100 | 100 | Health level |
-| `hygiene` | No | egg, baby, adult | No | computed | 1-100 | 100 | Cleanliness level |
-| `energy` | No | egg, baby, adult | No | computed | 1-100 | 100 | Energy level |
-
-**Stage Transition Behavior**:
-- **Hatch (egg → baby)**: `health` inherited from egg, others reset to 100
-- **Evolve (baby → adult)**: All stats inherited from baby (after decay)
-
-### 6. State / Lifecycle Tags
-
-Tags that track the Blobbi's current lifecycle state.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `stage` | **Yes** | egg, baby, adult | No | system | `egg\|baby\|adult` | Current lifecycle stage |
-| `state` | **Yes** | egg, baby, adult | No | system | `active\|sleeping\|hibernating\|incubating\|evolving` | Activity state |
-| `last_interaction` | **Yes** | egg, baby, adult | No | system | Unix timestamp | Last user action |
-| `last_decay_at` | No | egg, baby, adult | No | system | Unix timestamp | Decay checkpoint |
-
-**State Constraints**:
-- `incubating` is only valid for `stage: egg`
-- `evolving` is only valid for `stage: baby`
-- After hatch/evolve completes, `state` MUST be set to `active`
-
-### 7. Task System Tags
-
-Temporary tags used during incubation and evolution processes. These are REMOVED after stage transitions.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `state_started_at` | No | egg, baby | No | system | Unix timestamp | When incubating/evolving started |
-| `task` | No | egg, baby | No | computed | `["task", "name:value"]` | Task progress (multiple allowed) |
-| `task_completed` | No | egg, baby | No | computed | `["task_completed", "name"]` | Completed tasks (multiple allowed) |
-
-**Transition Behavior**: ALL task system tags MUST be removed when hatch or evolve completes.
-
-### 8. Progression Tags
-
-Long-term progress tracking that persists across all stages.
-
-| Tag | Required | Stages | Persistent | Source | Format | Default | Description |
-|-----|----------|--------|------------|--------|--------|---------|-------------|
-| `experience` | No | egg, baby, adult | Yes | computed | non-negative int | 0 | Total XP |
-| `care_streak` | No | egg, baby, adult | Yes | computed | non-negative int | 0 | Consecutive care days |
-
-### 9. Social / Flag Tags
-
-User preferences and computed flags.
-
-| Tag | Required | Stages | Persistent | Source | Format | Default | Description |
-|-----|----------|--------|------------|--------|--------|---------|-------------|
-| `breeding_ready` | No | egg, baby, adult | Yes | computed | `true\|false` | false | Breeding eligibility |
-
-### 10. Evolution Tags
-
-Tags specific to adult Blobbis.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `adult_type` | No | adult | Yes | computed | string | Evolution form type |
-
-### 11. Extension Tags
-
-Optional tags for themes and crossover features.
-
-| Tag | Required | Stages | Persistent | Source | Format | Description |
-|-----|----------|--------|------------|--------|--------|-------------|
-| `theme` | No | egg, baby, adult | Yes | system | string (e.g., `divine`) | Theme variant |
-| `crossover_app` | No | egg, baby, adult | Yes | system | string (e.g., `divine`) | Crossover app identifier |
-
----
-
-## Deprecated Tags
-
-These tags are from legacy versions and MUST be removed when republishing events.
-
-| Tag | Reason | Replaced By |
-|-----|--------|-------------|
-| `shell_integrity` | Eggs use standard `health` stat | `health` |
-| `egg_temperature` | Warmth handled via UI props | N/A |
-| `incubation_progress` | Replaced by task system | `task`, `task_completed` |
-| `egg_status` | Replaced by standard state | `state` |
-| `fees` | Removed | N/A |
-| `incubation_time` | Uses state_started_at | `state_started_at` |
-| `start_incubation` | Uses state_started_at | `state_started_at` |
-| `interact_6_progress` | Legacy interaction tracking | `["task", "interactions:N"]` |
-
----
-
-## Stage Transition Rules
-
-### Hatch (egg → baby)
-
-**Tags to REMOVE**:
-- `task`
-- `task_completed`
-- `state_started_at`
-
-**Tags to UPDATE**:
-- `stage` → `baby`
-- `state` → `active`
-- `hunger` → `100`
-- `happiness` → `100`
-- `hygiene` → `100`
-- `energy` → `100`
-- `health` → (inherited from egg after decay)
-- `last_interaction` → current timestamp
-- `last_decay_at` → current timestamp
-
-**Tags to PRESERVE (all persistent tags)**:
-- All system tags (`d`, `b`, `t`, `client`)
-- All identity tags (`name`, `seed`, `generation`)
-- All visual tags (colors, pattern, size)
-- All personality tags (if present)
-- All progression tags (`experience`, `care_streak`)
-- All social tags (`breeding_ready`)
-- All extension tags (`theme`, `crossover_app`)
-
-### Evolve (baby → adult)
-
-**Tags to REMOVE**:
-- `task`
-- `task_completed`
-- `state_started_at`
-
-**Tags to UPDATE**:
-- `stage` → `adult`
-- `state` → `active`
-- All stats → (inherited from baby after decay)
-- `last_interaction` → current timestamp
-- `last_decay_at` → current timestamp
-
-**Tags to PRESERVE (all persistent tags)**:
-- Same as hatch, plus all stats are inherited (not reset)
-
-**Tags to ADD (optional)**:
-- `adult_type` → computed based on care history
-
----
-
-## Migration Rules
-
-When migrating legacy Blobbis to canonical format:
-
-1. **Always preserve existing values** - Do not regenerate tags that already exist
-2. **Generate missing required tags** - Derive `seed` if missing using the legacy event's `created_at`
-3. **Remove deprecated tags** - Filter out all tags in the deprecated list
-4. **Repair visual tags** - Regenerate from seed if missing (these are regenerable)
-5. **Do NOT invent personality tags** - If `personality`, `trait`, etc. don't exist, leave them empty
-
----
-
-## Validation Rules
-
-A valid Blobbi event MUST have:
-- `d` tag in canonical format
-- `b` tag = `blobbi:ecosystem:v1`
-- `t` tag = `blobbi`
-- `name` tag (non-empty)
-- `seed` tag (64 hex chars)
-- `stage` tag (valid value)
-- `state` tag (valid value)
-- `last_interaction` tag (valid timestamp)
-
----
-
-## Implementation Checklist
-
-When implementing any flow that modifies Blobbi tags:
-
-- [ ] Start from `canonical.allTags` as the base
-- [ ] Remove only task-specific tags (`task`, `task_completed`, `state_started_at`)
-- [ ] Preserve ALL persistent tags (identity, visual, personality, progression, social, extension)
-- [ ] Filter out deprecated tags
-- [ ] Update only the tags that need to change
-- [ ] Validate required tags are present

eslint.config.js

@@ -8,7 +8,7 @@ import htmlParser from "@html-eslint/parser";
 import customRules from "./eslint-rules/index.js";
 
 export default tseslint.config(
-  { ignores: ["dist", "android"] },
+  { ignores: ["dist", "android", "ios"] },
   {
     extends: [js.configs.recommended, ...tseslint.configs.recommended],
     files: ["**/*.{ts,tsx}"],

index.html

@@ -1,43 +1,45 @@
 <!DOCTYPE html>
 <html lang="en" class="dark">
   <head>
-    <title>Ditto — Your content. Your vibe. Your rules.</title>
+    <title>Agora — Power to the people.</title>
     <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
-    <meta name="description" content="Ditto — Your content. Your vibe. Your rules." />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover, interactive-widget=resizes-content" />
+    <meta name="description" content="Agora — a Nostr social client for communities, creativity, and ownership." />
 
     <!-- Open Graph -->
-    <meta property="og:title" content="Ditto" />
-    <meta property="og:description" content="Your content. Your vibe. Your rules." />
-    <meta property="og:image" content="https://ditto.pub/og-image.jpg" />
+    <meta property="og:title" content="Agora" />
+    <meta property="og:description" content="Power to the people." />
+    <meta property="og:image" content="https://agora.spot/og-image.png" />
     <meta property="og:image:width" content="1200" />
     <meta property="og:image:height" content="630" />
     <meta property="og:image:type" content="image/jpeg" />
     <meta property="og:type" content="website" />
-    <meta property="og:url" content="https://ditto.pub" />
-    <meta property="og:site_name" content="Ditto" />
+    <meta property="og:url" content="https://agora.spot" />
+    <meta property="og:site_name" content="Agora" />
 
     <!-- Twitter / X -->
     <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="Ditto" />
-    <meta name="twitter:description" content="Your content. Your vibe. Your rules." />
-    <meta name="twitter:image" content="https://ditto.pub/og-image.jpg" />
+    <meta name="twitter:title" content="Agora" />
+    <meta name="twitter:description" content="Power to the people." />
+    <meta name="twitter:image" content="https://agora.spot/og-image.png" />
 
     <meta http-equiv="content-security-policy" content="default-src 'none'; script-src 'self' 'wasm-unsafe-eval'; style-src 'self' 'unsafe-inline'; frame-src 'self' https:; font-src 'self' https:; base-uri 'self'; manifest-src 'self'; connect-src 'self' blob: https: wss:; img-src 'self' data: blob: https:; media-src 'self' blob: https:">
-    <link rel="icon" type="image/svg+xml" href="/logo.svg">
-    <link rel="apple-touch-icon" href="/apple-touch-icon.png">
-    <meta name="theme-color" content="#161b2e" media="(prefers-color-scheme: dark)">
-    <meta name="theme-color" content="#ffffff" media="(prefers-color-scheme: light)">
+    <link rel="icon" type="image/x-icon" href="/favicon.ico">
+    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png">
+    <link rel="apple-touch-icon" sizes="192x192" href="/icon-192.png">
+    <meta name="theme-color" content="#0a0c14" media="(prefers-color-scheme: dark)">
+    <meta name="theme-color" content="#e85d3c" media="(prefers-color-scheme: light)">
     <link rel="manifest" href="/manifest.webmanifest">
-    <style>@keyframes ditto-spin{to{transform:rotate(360deg)}}</style>
+    <style>@keyframes agora-spin{to{transform:rotate(360deg)}}</style>
   </head>
-  <body style="margin:0;background:hsl(228 20% 10%)">
+  <body style="margin:0;background:hsl(0 0% 10%)">
     <!-- Pre-React loading screen. Lives OUTSIDE #root so React doesn't
          touch it. Removed by main.tsx once the app has mounted. -->
-    <div id="preloader" style="position:fixed;inset:0;z-index:9999;display:flex;align-items:center;justify-content:center;background:hsl(228 20% 10%)">
+    <div id="preloader" style="position:fixed;inset:0;z-index:9999;display:flex;align-items:center;justify-content:center;background:hsl(0 0% 10%)">
       <div style="display:flex;flex-direction:column;align-items:center;gap:24px">
-        <div data-logo style="width:48px;height:48px;background:hsl(258 70% 60%);-webkit-mask:url(/logo.svg) center/contain no-repeat;mask:url(/logo.svg) center/contain no-repeat"></div>
-        <div data-spinner style="width:24px;height:24px;border:2.5px solid hsl(258 70% 60% / 0.25);border-top-color:hsl(258 70% 60%);border-radius:50%;animation:ditto-spin .7s linear infinite"></div>
+        <div data-logo style="width:48px;height:48px;background:hsl(14 79% 58%);-webkit-mask:url(/logo.svg) center/contain no-repeat;mask:url(/logo.svg) center/contain no-repeat"></div>
+        <div data-spinner style="width:24px;height:24px;border:2.5px solid hsl(14 79% 58% / 0.25);border-top-color:hsl(14 79% 58%);border-radius:50%;animation:agora-spin .7s linear infinite"></div>
       </div>
     </div>
     <!-- Blocking script: reads theme from localStorage and applies it

ios/App/App.xcodeproj/project.pbxproj

@@ -15,6 +15,11 @@
 		504EC30F1FED79650016851F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30E1FED79650016851F /* Assets.xcassets */; };
 		504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC3101FED79650016851F /* LaunchScreen.storyboard */; };
 		50B271D11FEDC1A000F3C39B /* public in Resources */ = {isa = PBXBuildFile; fileRef = 50B271D01FEDC1A000F3C39B /* public */; };
+		B1A2C3D40001000100000001 /* SandboxPlugin.swift in Sources */ = {isa = PBXBuildFile; fileRef = B1A2C3D40001000100000002 /* SandboxPlugin.swift */; };
+		B1A2C3D40002000100000001 /* DittoBridgeViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = B1A2C3D40002000100000002 /* DittoBridgeViewController.swift */; };
+		B1A2C3D40005000100000001 /* PrivacyInfo.xcprivacy in Resources */ = {isa = PBXBuildFile; fileRef = B1A2C3D40005000100000002 /* PrivacyInfo.xcprivacy */; };
+		B1A2C3D40006000100000001 /* DittoNotificationPlugin.swift in Sources */ = {isa = PBXBuildFile; fileRef = B1A2C3D40006000100000002 /* DittoNotificationPlugin.swift */; };
+		B1A2C3D40007000100000001 /* NostrPoller.swift in Sources */ = {isa = PBXBuildFile; fileRef = B1A2C3D40007000100000002 /* NostrPoller.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXFileReference section */
@@ -28,6 +33,12 @@
 		504EC3131FED79650016851F /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
 		50B271D01FEDC1A000F3C39B /* public */ = {isa = PBXFileReference; lastKnownFileType = folder; path = public; sourceTree = "<group>"; };
 		958DCC722DB07C7200EA8C5F /* debug.xcconfig */ = {isa = PBXFileReference; lastKnownFileType = text.xcconfig; name = debug.xcconfig; path = ../debug.xcconfig; sourceTree = SOURCE_ROOT; };
+		B1A2C3D40001000100000002 /* SandboxPlugin.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SandboxPlugin.swift; sourceTree = "<group>"; };
+		B1A2C3D40002000100000002 /* DittoBridgeViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DittoBridgeViewController.swift; sourceTree = "<group>"; };
+		B1A2C3D40004000100000002 /* App.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = App.entitlements; sourceTree = "<group>"; };
+		B1A2C3D40005000100000002 /* PrivacyInfo.xcprivacy */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = PrivacyInfo.xcprivacy; sourceTree = "<group>"; };
+		B1A2C3D40006000100000002 /* DittoNotificationPlugin.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DittoNotificationPlugin.swift; sourceTree = "<group>"; };
+		B1A2C3D40007000100000002 /* NostrPoller.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = NostrPoller.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -63,11 +74,17 @@
 			isa = PBXGroup;
 			children = (
 				50379B222058CBB4000EE86E /* capacitor.config.json */,
+				B1A2C3D40004000100000002 /* App.entitlements */,
 				504EC3071FED79650016851F /* AppDelegate.swift */,
+				B1A2C3D40001000100000002 /* SandboxPlugin.swift */,
+				B1A2C3D40002000100000002 /* DittoBridgeViewController.swift */,
+				B1A2C3D40006000100000002 /* DittoNotificationPlugin.swift */,
+				B1A2C3D40007000100000002 /* NostrPoller.swift */,
 				504EC30B1FED79650016851F /* Main.storyboard */,
 				504EC30E1FED79650016851F /* Assets.xcassets */,
 				504EC3101FED79650016851F /* LaunchScreen.storyboard */,
 				504EC3131FED79650016851F /* Info.plist */,
+				B1A2C3D40005000100000002 /* PrivacyInfo.xcprivacy */,
 				2FAD9762203C412B000D30F8 /* config.xml */,
 				50B271D01FEDC1A000F3C39B /* public */,
 			);
@@ -145,6 +162,7 @@
 				50379B232058CBB4000EE86E /* capacitor.config.json in Resources */,
 				504EC30D1FED79650016851F /* Main.storyboard in Resources */,
 				2FAD9763203C412B000D30F8 /* config.xml in Resources */,
+				B1A2C3D40005000100000001 /* PrivacyInfo.xcprivacy in Resources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -156,6 +174,10 @@
 			buildActionMask = 2147483647;
 			files = (
 				504EC3081FED79650016851F /* AppDelegate.swift in Sources */,
+				B1A2C3D40001000100000001 /* SandboxPlugin.swift in Sources */,
+				B1A2C3D40002000100000001 /* DittoBridgeViewController.swift in Sources */,
+				B1A2C3D40006000100000001 /* DittoNotificationPlugin.swift in Sources */,
+				B1A2C3D40007000100000001 /* NostrPoller.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -295,17 +317,19 @@
 			baseConfigurationReference = 958DCC722DB07C7200EA8C5F /* debug.xcconfig */;
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CODE_SIGN_ENTITLEMENTS = App/App.entitlements;
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = GZLTTH5DLM;
 				INFOPLIST_FILE = App/Info.plist;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 2.4.0;
+				MARKETING_VERSION = 2.8.0;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
-				PRODUCT_BUNDLE_IDENTIFIER = pub.ditto.app;
+				PRODUCT_BUNDLE_IDENTIFIER = pub.agora.app;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
 				SWIFT_VERSION = 5.0;
@@ -317,16 +341,18 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				CODE_SIGN_ENTITLEMENTS = App/App.entitlements;
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = GZLTTH5DLM;
 				INFOPLIST_FILE = App/Info.plist;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
 				LD_RUNPATH_SEARCH_PATHS = (
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 2.4.0;
-				PRODUCT_BUNDLE_IDENTIFIER = pub.ditto.app;
+				MARKETING_VERSION = 2.8.0;
+				PRODUCT_BUNDLE_IDENTIFIER = pub.agora.app;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";
 				SWIFT_VERSION = 5.0;

ios/App/App/App.entitlements

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>webcredentials:agora.spot</string>
+		<string>webcredentials:agora.spot?mode=developer</string>
+	</array>
+</dict>
+</plist>

ios/App/App/AppDelegate.swift

@@ -1,36 +1,45 @@
 import UIKit
 import Capacitor
+import BackgroundTasks
+import UserNotifications
 
 @UIApplicationMain
-class AppDelegate: UIResponder, UIApplicationDelegate {
+class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
 
     var window: UIWindow?
 
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
-        // Override point for customization after application launch.
+        // Register the background task handler for notification polling.
+        // Must happen before the app finishes launching.
+        DittoNotificationPlugin.registerBackgroundTask()
+
+        // Set ourselves as the notification center delegate so we can:
+        // 1. Show banners even when the app is in the foreground.
+        // 2. Handle notification taps to navigate the WebView.
+        UNUserNotificationCenter.current().delegate = self
+
+        // Register notification categories with summary formats for iOS grouping.
+        registerNotificationCategories()
+
         return true
     }
 
     func applicationWillResignActive(_ application: UIApplication) {
-        // Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
-        // Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
     }
 
     func applicationDidEnterBackground(_ application: UIApplication) {
-        // Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
-        // If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
     }
 
     func applicationWillEnterForeground(_ application: UIApplication) {
-        // Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
+        // Trigger an immediate poll when returning to foreground to catch up
+        // on any notifications missed while backgrounded.
+        DittoNotificationPlugin.pollNow()
     }
 
     func applicationDidBecomeActive(_ application: UIApplication) {
-        // Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
     }
 
     func applicationWillTerminate(_ application: UIApplication) {
-        // Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
     }
 
     func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
@@ -46,4 +55,66 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         return ApplicationDelegateProxy.shared.application(application, continue: userActivity, restorationHandler: restorationHandler)
     }
 
+    // MARK: - UNUserNotificationCenterDelegate
+
+    /// Show notification banners even when the app is in the foreground.
+    func userNotificationCenter(
+        _ center: UNUserNotificationCenter,
+        willPresent notification: UNNotification,
+        withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
+    ) {
+        completionHandler([.banner, .sound])
+    }
+
+    /// Handle notification tap: navigate the Capacitor WebView to /notifications.
+    func userNotificationCenter(
+        _ center: UNUserNotificationCenter,
+        didReceive response: UNNotificationResponse,
+        withCompletionHandler completionHandler: @escaping () -> Void
+    ) {
+        let userInfo = response.notification.request.content.userInfo
+        let path = userInfo["url"] as? String ?? "/notifications"
+
+        // Navigate the Capacitor WebView to the notifications page.
+        DispatchQueue.main.async { [weak self] in
+            guard let rootVC = self?.window?.rootViewController as? DittoBridgeViewController else {
+                completionHandler()
+                return
+            }
+            let js = "window.location.pathname !== '\(path)' && (window.location.pathname = '\(path)');"
+            rootVC.webView?.evaluateJavaScript(js) { _, _ in }
+        }
+
+        completionHandler()
+    }
+
+    // MARK: - Notification Categories
+
+    /// Register notification categories with summary formats for native iOS
+    /// notification grouping. When multiple notifications share a thread
+    /// identifier, iOS automatically collapses them and uses the summary
+    /// format to describe the group.
+    private func registerNotificationCategories() {
+        let categories: [UNNotificationCategory] = [
+            makeCategory(id: NostrPoller.categoryReactions, summary: "%u more reactions"),
+            makeCategory(id: NostrPoller.categoryReposts, summary: "%u more reposts"),
+            makeCategory(id: NostrPoller.categoryZaps, summary: "%u more zaps"),
+            makeCategory(id: NostrPoller.categoryMentions, summary: "%u more mentions"),
+            makeCategory(id: NostrPoller.categoryComments, summary: "%u more comments"),
+            makeCategory(id: NostrPoller.categoryBadges, summary: "%u more badge awards"),
+            makeCategory(id: NostrPoller.categoryLetters, summary: "%u more letters"),
+        ]
+        UNUserNotificationCenter.current().setNotificationCategories(Set(categories))
+    }
+
+    private func makeCategory(id: String, summary: String) -> UNNotificationCategory {
+        return UNNotificationCategory(
+            identifier: id,
+            actions: [],
+            intentIdentifiers: [],
+            hiddenPreviewsBodyPlaceholder: nil,
+            categorySummaryFormat: summary,
+            options: []
+        )
+    }
 }

ios/App/App/Base.lproj/Main.storyboard

@@ -11,7 +11,7 @@
         <!--Bridge View Controller-->
         <scene sceneID="tne-QT-ifu">
             <objects>
-                <viewController id="BYZ-38-t0r" customClass="CAPBridgeViewController" customModule="Capacitor" sceneMemberID="viewController"/>
+                <viewController id="BYZ-38-t0r" customClass="DittoBridgeViewController" customModule="App" sceneMemberID="viewController"/>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
             </objects>
         </scene>

ios/App/App/DittoBridgeViewController.swift

@@ -0,0 +1,9 @@
+import UIKit
+import Capacitor
+
+class DittoBridgeViewController: CAPBridgeViewController {
+    override func capacitorDidLoad() {
+        super.capacitorDidLoad()
+        webView?.allowsBackForwardNavigationGestures = true
+    }
+}

ios/App/App/DittoNotificationPlugin.swift

@@ -0,0 +1,209 @@
+import Foundation
+import Capacitor
+import BackgroundTasks
+import UserNotifications
+
+// MARK: - DittoNotificationPlugin
+
+/// Capacitor plugin that bridges the JS notification configuration to the
+/// native iOS background polling system.
+///
+/// Mirrors the Android `DittoNotificationPlugin.java` interface:
+/// - Receives `userPubkey`, `relayUrls`, `enabledKinds`, `authors`, and
+///   `notificationStyle` from the JS layer via `configure()`.
+/// - Stores configuration in UserDefaults.
+/// - Schedules / cancels a `BGAppRefreshTask` to periodically poll relays
+///   and display local notifications via `NostrPoller`.
+///
+/// On iOS the "push" vs "persistent" distinction maps to:
+/// - **"push"**: No background polling. Relies on Web Push (where supported)
+///   or in-app polling when the app is open.
+/// - **"persistent"**: Schedules `BGAppRefreshTask` for periodic relay polling.
+///   iOS manages the interval (~15 min minimum, adaptive based on app usage).
+@objc(DittoNotificationPlugin)
+public class DittoNotificationPlugin: CAPPlugin, CAPBridgedPlugin {
+
+    // MARK: - Capacitor Bridging
+
+    public let identifier = "DittoNotificationPlugin"
+    public let jsName = "DittoNotification"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "configure", returnType: CAPPluginReturnPromise),
+    ]
+
+    // MARK: - Constants
+
+    static let bgTaskIdentifier = "pub.ditto.app.notification-refresh"
+    private static let prefsKey = "ditto_notification_config"
+
+    // MARK: - Plugin Methods
+
+    /// Called from JS: `DittoNotification.configure({ ... })`.
+    @objc func configure(_ call: CAPPluginCall) {
+        let userPubkey = call.getString("userPubkey")
+        let notificationStyle = call.getString("notificationStyle") ?? "push"
+        let relayUrls = call.getArray("relayUrls")?.compactMap { $0 as? String }
+        let enabledKinds = call.getArray("enabledKinds")?.compactMap { $0 as? Int }
+        let authors = call.getArray("authors")?.compactMap { $0 as? String }
+
+        let defaults = UserDefaults.standard
+
+        if let userPubkey, let relayUrls, !relayUrls.isEmpty {
+            // Save configuration.
+            defaults.set(userPubkey, forKey: "\(Self.prefsKey).userPubkey")
+            defaults.set(relayUrls, forKey: "\(Self.prefsKey).relayUrls")
+            defaults.set(notificationStyle, forKey: "\(Self.prefsKey).notificationStyle")
+            if let enabledKinds {
+                defaults.set(enabledKinds, forKey: "\(Self.prefsKey).enabledKinds")
+            }
+            if let authors, !authors.isEmpty {
+                defaults.set(authors, forKey: "\(Self.prefsKey).authors")
+            } else {
+                defaults.removeObject(forKey: "\(Self.prefsKey).authors")
+            }
+
+            let kindsStr = enabledKinds?.map(String.init).joined(separator: ",") ?? "none"
+            NSLog("[DittoNotification] Configured: pubkey=%@..., style=%@, relays=%d, kinds=%@",
+                  String(userPubkey.prefix(8)), notificationStyle,
+                  relayUrls.count,
+                  kindsStr)
+        } else {
+            // Clear configuration (user logged out).
+            for suffix in ["userPubkey", "relayUrls", "notificationStyle", "enabledKinds", "authors"] {
+                defaults.removeObject(forKey: "\(Self.prefsKey).\(suffix)")
+            }
+            NSLog("[DittoNotification] Config cleared (user logged out)")
+        }
+
+        // Schedule or cancel background polling based on style + config.
+        let hasConfig = userPubkey != nil && relayUrls != nil && !(relayUrls?.isEmpty ?? true)
+        Self.manageBackgroundRefresh(style: notificationStyle, hasConfig: hasConfig)
+
+        call.resolve()
+    }
+
+    // MARK: - Background Task Management
+
+    /// Register the BGAppRefreshTask handler. Must be called from
+    /// `application(_:didFinishLaunchingWithOptions:)` before the app
+    /// finishes launching.
+    static func registerBackgroundTask() {
+        BGTaskScheduler.shared.register(
+            forTaskWithIdentifier: bgTaskIdentifier,
+            using: nil
+        ) { task in
+            guard let refreshTask = task as? BGAppRefreshTask else {
+                task.setTaskCompleted(success: false)
+                return
+            }
+            Self.handleBackgroundRefresh(task: refreshTask)
+        }
+        NSLog("[DittoNotification] Registered BGAppRefreshTask: %@", bgTaskIdentifier)
+    }
+
+    /// Schedule or cancel the BGAppRefreshTask.
+    /// On iOS both "push" and "persistent" modes use BGAppRefreshTask
+    /// (there is no Web Push in WKWebView and no foreground service concept),
+    /// so we schedule whenever there is a valid config.
+    static func manageBackgroundRefresh(style: String, hasConfig: Bool) {
+        if hasConfig {
+            scheduleBackgroundRefresh()
+        } else {
+            cancelBackgroundRefresh()
+        }
+    }
+
+    /// Schedule the next background refresh. iOS decides the actual timing
+    /// (minimum ~15 minutes, adaptive based on user app usage patterns).
+    static func scheduleBackgroundRefresh() {
+        let request = BGAppRefreshTaskRequest(identifier: bgTaskIdentifier)
+        // Suggest earliest begin date of 8 minutes from now (iOS may defer).
+        request.earliestBeginDate = Date(timeIntervalSinceNow: 8 * 60)
+
+        do {
+            try BGTaskScheduler.shared.submit(request)
+            NSLog("[DittoNotification] Scheduled background refresh")
+        } catch {
+            NSLog("[DittoNotification] Failed to schedule background refresh: %@", error.localizedDescription)
+        }
+    }
+
+    private static func cancelBackgroundRefresh() {
+        BGTaskScheduler.shared.cancel(taskRequestWithIdentifier: bgTaskIdentifier)
+        NSLog("[DittoNotification] Cancelled background refresh")
+    }
+
+    /// Handle a BGAppRefreshTask: read config, poll, reschedule.
+    private static func handleBackgroundRefresh(task: BGAppRefreshTask) {
+        NSLog("[DittoNotification] Background refresh triggered")
+
+        // Read configuration from UserDefaults.
+        let defaults = UserDefaults.standard
+        guard let userPubkey = defaults.string(forKey: "\(prefsKey).userPubkey"),
+              let relayUrls = defaults.stringArray(forKey: "\(prefsKey).relayUrls"),
+              !relayUrls.isEmpty else {
+            NSLog("[DittoNotification] No config, completing task")
+            task.setTaskCompleted(success: true)
+            return
+        }
+
+        let enabledKinds = defaults.array(forKey: "\(prefsKey).enabledKinds") as? [Int] ?? []
+        let authors = defaults.stringArray(forKey: "\(prefsKey).authors")
+
+        guard !enabledKinds.isEmpty else {
+            NSLog("[DittoNotification] No enabled kinds, completing task")
+            task.setTaskCompleted(success: true)
+            return
+        }
+
+        // Schedule the next refresh before starting work (in case we're
+        // terminated mid-task, the next refresh is already queued).
+        scheduleBackgroundRefresh()
+
+        // Run the poll in a detached Task.
+        let pollTask = Task {
+            let poller = NostrPoller()
+            let count = await poller.poll(
+                userPubkey: userPubkey,
+                relayUrls: relayUrls,
+                enabledKinds: enabledKinds,
+                authors: authors
+            )
+            NSLog("[DittoNotification] Background poll complete: %d notifications", count)
+            task.setTaskCompleted(success: true)
+        }
+
+        // Handle task expiration (iOS is about to kill us).
+        task.expirationHandler = {
+            NSLog("[DittoNotification] Background task expired")
+            pollTask.cancel()
+            task.setTaskCompleted(success: false)
+        }
+    }
+
+    // MARK: - Immediate Poll
+
+    /// Trigger an immediate poll (e.g., when the app enters the foreground
+    /// after being backgrounded, to catch up on missed notifications).
+    static func pollNow() {
+        let defaults = UserDefaults.standard
+        guard let userPubkey = defaults.string(forKey: "\(prefsKey).userPubkey"),
+              let relayUrls = defaults.stringArray(forKey: "\(prefsKey).relayUrls"),
+              !relayUrls.isEmpty else { return }
+
+        let enabledKinds = defaults.array(forKey: "\(prefsKey).enabledKinds") as? [Int] ?? []
+        let authors = defaults.stringArray(forKey: "\(prefsKey).authors")
+
+        guard !enabledKinds.isEmpty else { return }
+
+        Task {
+            let poller = NostrPoller()
+            await poller.poll(
+                userPubkey: userPubkey,
+                relayUrls: relayUrls,
+                enabledKinds: enabledKinds,
+                authors: authors
+            )
+        }
+    }
+}

ios/App/App/Info.plist

@@ -7,7 +7,7 @@
 	<key>CFBundleDevelopmentRegion</key>
 	<string>en</string>
 	<key>CFBundleDisplayName</key>
-        <string>Ditto</string>
+        <string>Agora</string>
 	<key>CFBundleExecutable</key>
 	<string>$(EXECUTABLE_NAME)</string>
 	<key>CFBundleIdentifier</key>
@@ -48,8 +48,20 @@
 	<key>UIViewControllerBasedStatusBarAppearance</key>
 	<true/>
 	<key>NSPhotoLibraryUsageDescription</key>
-	<string>Ditto needs access to your photo library to upload images to your posts and profile.</string>
+	<string>Agora needs access to your photo library to upload images to your posts and profile.</string>
+	<key>NSCameraUsageDescription</key>
+	<string>Agora needs camera access to take photos and videos for your posts.</string>
 	<key>NSMicrophoneUsageDescription</key>
-	<string>Ditto needs access to your microphone to record voice messages.</string>
+	<string>Agora needs access to your microphone to record voice messages.</string>
+	<key>ITSAppUsesNonExemptEncryption</key>
+	<false/>
+	<key>UIBackgroundModes</key>
+	<array>
+		<string>fetch</string>
+	</array>
+	<key>BGTaskSchedulerPermittedIdentifiers</key>
+	<array>
+		<string>pub.agora.app.notification-refresh</string>
+	</array>
 </dict>
 </plist>

ios/App/App/NostrPoller.swift

@@ -0,0 +1,633 @@
+import Foundation
+import UserNotifications
+
+// MARK: - NostrPoller
+
+/// Polls Nostr relays for notification events and displays native iOS
+/// notifications with author names, content previews, and iOS thread grouping.
+///
+/// Improvements over the Android implementation:
+/// - Fetches kind 0 metadata so notifications show "Alice reacted" not "Someone reacted"
+/// - Uses iOS thread identifiers for native notification grouping per category+post
+/// - Caches author metadata in UserDefaults (24h TTL) to minimise relay queries
+/// - Designed to complete within the ~30s BGAppRefreshTask budget
+final class NostrPoller {
+
+    // MARK: - Constants
+
+    private static let prefsKey = "ditto_notifications"
+    private static let lastSeenKey = "nostr:notification-last-seen"
+    private static let metadataCacheKey = "nostr:author-metadata-cache"
+    private static let metadataTTL: TimeInterval = 24 * 60 * 60 // 24 hours
+
+    private static let fetchLimit = 5
+    private static let wsTimeout: TimeInterval = 10
+    private static let metadataFetchTimeout: TimeInterval = 5
+
+    // MARK: - Notification Categories (registered by AppDelegate)
+
+    /// Category identifiers used for UNNotificationCategory registration.
+    static let categoryReactions  = "reactions"
+    static let categoryReposts    = "reposts"
+    static let categoryZaps       = "zaps"
+    static let categoryMentions   = "mentions"
+    static let categoryComments   = "comments"
+    static let categoryBadges     = "badges"
+    static let categoryLetters    = "letters"
+
+    // MARK: - Types
+
+    /// Minimal parsed Nostr event used during polling.
+    struct NostrEvent {
+        let id: String
+        let pubkey: String
+        let kind: Int
+        let createdAt: Int
+        let content: String
+        let tags: [[String]]
+
+        init?(json: [String: Any]) {
+            guard let id = json["id"] as? String,
+                  let pubkey = json["pubkey"] as? String,
+                  let kind = json["kind"] as? Int,
+                  let createdAt = json["created_at"] as? Int else { return nil }
+            self.id = id
+            self.pubkey = pubkey
+            self.kind = kind
+            self.createdAt = createdAt
+            self.content = json["content"] as? String ?? ""
+            self.tags = (json["tags"] as? [[String]]) ?? []
+        }
+    }
+
+    /// Cached author display name.
+    private struct AuthorCache: Codable {
+        let name: String
+        let timestamp: TimeInterval
+    }
+
+    // MARK: - Public API
+
+    /// Run a single poll cycle: fetch events from a relay, resolve metadata,
+    /// and display notifications. Returns the number of notifications shown.
+    @discardableResult
+    func poll(
+        userPubkey: String,
+        relayUrls: [String],
+        enabledKinds: [Int],
+        authors: [String]?
+    ) async -> Int {
+        guard !relayUrls.isEmpty, !enabledKinds.isEmpty else { return 0 }
+
+        let since = lastSeenTimestamp
+        let effectiveSince = since > 0 ? since : Int(Date().timeIntervalSince1970) - 300
+
+        if since == 0 {
+            setLastSeenTimestamp(effectiveSince)
+        }
+
+        // Try each relay in order until one succeeds.
+        for relayUrl in relayUrls {
+            guard let events = await fetchEvents(
+                relayUrl: relayUrl,
+                userPubkey: userPubkey,
+                enabledKinds: enabledKinds,
+                authors: authors,
+                since: effectiveSince
+            ) else {
+                continue // Try next relay on failure.
+            }
+
+            // Deduplicate + filter self-interactions.
+            var seenIds = Set<String>()
+            let filtered = events.filter { ev in
+                guard ev.pubkey != userPubkey, !seenIds.contains(ev.id) else { return false }
+                seenIds.insert(ev.id)
+                return true
+            }
+
+            guard !filtered.isEmpty else {
+                // Successful fetch but nothing new — update timestamp and return.
+                return 0
+            }
+
+            // Verify referenced events for reactions/reposts/zaps.
+            let notifiable = await verifyReferencedEvents(
+                events: filtered,
+                userPubkey: userPubkey,
+                relayUrl: relayUrl
+            )
+
+            // Update last-seen to newest event in the full filtered set (not
+            // just notifiable) so we don't re-fetch already-seen events.
+            let newestTs = filtered.map(\.createdAt).max() ?? effectiveSince
+            if newestTs > lastSeenTimestamp {
+                setLastSeenTimestamp(newestTs)
+            }
+
+            guard !notifiable.isEmpty else { return 0 }
+
+            // Fetch author metadata for unique pubkeys.
+            let pubkeys = Array(Set(notifiable.map(\.pubkey)))
+            let authorNames = await resolveAuthorNames(pubkeys: pubkeys, relayUrl: relayUrl)
+
+            // Display notifications.
+            await displayNotifications(events: notifiable, authorNames: authorNames)
+
+            return notifiable.count
+        }
+
+        return 0 // All relays failed.
+    }
+
+    // MARK: - Relay Communication
+
+    /// Fetch notification events from a single relay. Returns nil on failure.
+    private func fetchEvents(
+        relayUrl: String,
+        userPubkey: String,
+        enabledKinds: [Int],
+        authors: [String]?,
+        since: Int
+    ) async -> [NostrEvent]? {
+        guard let url = URL(string: relayUrl) else { return nil }
+
+        var filter: [String: Any] = [
+            "kinds": enabledKinds,
+            "#p": [userPubkey],
+            "since": since + 1,
+            "limit": Self.fetchLimit,
+        ]
+        if let authors, !authors.isEmpty {
+            filter["authors"] = authors
+        }
+
+        return await relayQuery(url: url, filters: [filter])
+    }
+
+    /// Fetch events by IDs from a relay for referenced-event verification.
+    private func fetchEventsByIds(ids: [String], relayUrl: String) async -> [String: NostrEvent] {
+        guard !ids.isEmpty, let url = URL(string: relayUrl) else { return [:] }
+
+        let filter: [String: Any] = [
+            "ids": ids,
+            "limit": ids.count,
+        ]
+
+        guard let events = await relayQuery(url: url, filters: [filter], timeout: Self.metadataFetchTimeout) else {
+            return [:]
+        }
+
+        var map = [String: NostrEvent]()
+        for ev in events {
+            map[ev.id] = ev
+        }
+        return map
+    }
+
+    /// Fetch kind 0 metadata events for a set of pubkeys.
+    private func fetchMetadata(pubkeys: [String], relayUrl: String) async -> [String: NostrEvent] {
+        guard !pubkeys.isEmpty, let url = URL(string: relayUrl) else { return [:] }
+
+        let filter: [String: Any] = [
+            "kinds": [0],
+            "authors": pubkeys,
+            "limit": pubkeys.count,
+        ]
+
+        guard let events = await relayQuery(url: url, filters: [filter], timeout: Self.metadataFetchTimeout) else {
+            return [:]
+        }
+
+        var map = [String: NostrEvent]()
+        for ev in events {
+            // Keep only the newest kind 0 per pubkey.
+            if let existing = map[ev.pubkey], existing.createdAt > ev.createdAt {
+                continue
+            }
+            map[ev.pubkey] = ev
+        }
+        return map
+    }
+
+    /// Low-level relay query: open WebSocket, send REQ, collect events until
+    /// EOSE, close. Returns nil on connection/timeout failure.
+    private func relayQuery(
+        url: URL,
+        filters: [[String: Any]],
+        timeout: TimeInterval = wsTimeout
+    ) async -> [NostrEvent]? {
+        await withCheckedContinuation { continuation in
+            var events = [NostrEvent]()
+            var resumed = false
+            let subId = "ditto-\(UInt64.random(in: 0...UInt64.max))"
+
+            let session = URLSession(configuration: .default)
+            let task = session.webSocketTask(with: url)
+            task.resume()
+
+            // Build REQ message: ["REQ", subId, filter1, filter2, ...]
+            var reqArray: [Any] = ["REQ", subId]
+            reqArray.append(contentsOf: filters)
+
+            guard let reqData = try? JSONSerialization.data(withJSONObject: reqArray),
+                  let reqStr = String(data: reqData, encoding: .utf8) else {
+                continuation.resume(returning: nil)
+                return
+            }
+
+            // Timeout guard.
+            let timeoutWork = DispatchWorkItem { [weak task] in
+                guard !resumed else { return }
+                resumed = true
+                task?.cancel(with: .goingAway, reason: nil)
+                session.invalidateAndCancel()
+                continuation.resume(returning: events.isEmpty ? nil : events)
+            }
+            DispatchQueue.global().asyncAfter(deadline: .now() + timeout, execute: timeoutWork)
+
+            func finish(result: [NostrEvent]?) {
+                timeoutWork.cancel()
+                guard !resumed else { return }
+                resumed = true
+                // Send CLOSE and disconnect.
+                if let closeData = try? JSONSerialization.data(withJSONObject: ["CLOSE", subId]),
+                   let closeStr = String(data: closeData, encoding: .utf8) {
+                    task.send(.string(closeStr)) { _ in }
+                }
+                task.cancel(with: .normalClosure, reason: nil)
+                session.invalidateAndCancel()
+                continuation.resume(returning: result)
+            }
+
+            func receiveNext() {
+                task.receive { result in
+                    switch result {
+                    case .success(.string(let text)):
+                        guard let data = text.data(using: .utf8),
+                              let arr = try? JSONSerialization.jsonObject(with: data) as? [Any],
+                              let type = arr.first as? String else {
+                            receiveNext()
+                            return
+                        }
+
+                        if type == "EVENT", arr.count >= 3,
+                           let evJson = arr[2] as? [String: Any],
+                           let ev = NostrEvent(json: evJson) {
+                            events.append(ev)
+                            receiveNext()
+                        } else if type == "EOSE" || type == "CLOSED" {
+                            finish(result: events)
+                        } else {
+                            receiveNext()
+                        }
+
+                    case .failure:
+                        finish(result: nil)
+
+                    default:
+                        receiveNext()
+                    }
+                }
+            }
+
+            task.send(.string(reqStr)) { error in
+                if error != nil {
+                    finish(result: nil)
+                } else {
+                    receiveNext()
+                }
+            }
+        }
+    }
+
+    // MARK: - Event Verification
+
+    /// For reactions (7), reposts (6, 16), and zaps (9735), verify that the
+    /// referenced event was authored by the current user. Events that pass
+    /// verification or don't need it are returned.
+    private func verifyReferencedEvents(
+        events: [NostrEvent],
+        userPubkey: String,
+        relayUrl: String
+    ) async -> [NostrEvent] {
+        let needsVerification: Set<Int> = [7, 6, 16, 9735]
+
+        // Collect referenced IDs that need verification.
+        var refIdsNeeded = Set<String>()
+        for ev in events where needsVerification.contains(ev.kind) {
+            if let refId = referencedEventId(from: ev) {
+                refIdsNeeded.insert(refId)
+            }
+        }
+
+        let refMap: [String: NostrEvent]
+        if !refIdsNeeded.isEmpty {
+            refMap = await fetchEventsByIds(ids: Array(refIdsNeeded), relayUrl: relayUrl)
+        } else {
+            refMap = [:]
+        }
+
+        return events.filter { ev in
+            guard needsVerification.contains(ev.kind) else { return true }
+
+            // Zaps with #p tag targeting the user are valid (profile zaps have no e tag).
+            if ev.kind == 9735 {
+                return true
+            }
+
+            guard let refId = referencedEventId(from: ev) else { return false }
+            guard let refEvent = refMap[refId] else {
+                // Couldn't fetch — keep the notification rather than silently dropping it.
+                return true
+            }
+            return refEvent.pubkey == userPubkey
+        }
+    }
+
+    /// Returns the last `e` tag value from an event's tags.
+    private func referencedEventId(from event: NostrEvent) -> String? {
+        event.tags.last(where: { $0.first == "e" && $0.count > 1 })?[1]
+    }
+
+    // MARK: - Author Metadata Resolution
+
+    /// Resolve display names for a set of pubkeys, using cache where possible.
+    private func resolveAuthorNames(pubkeys: [String], relayUrl: String) async -> [String: String] {
+        var result = [String: String]()
+        var uncached = [String]()
+
+        let cache = loadMetadataCache()
+        let now = Date().timeIntervalSince1970
+
+        for pk in pubkeys {
+            if let cached = cache[pk], now - cached.timestamp < Self.metadataTTL {
+                result[pk] = cached.name
+            } else {
+                uncached.append(pk)
+            }
+        }
+
+        // Fetch uncached metadata from the relay.
+        if !uncached.isEmpty {
+            let metadataEvents = await fetchMetadata(pubkeys: uncached, relayUrl: relayUrl)
+            var updatedCache = cache
+
+            for pk in uncached {
+                if let ev = metadataEvents[pk], let name = parseDisplayName(from: ev) {
+                    result[pk] = name
+                    updatedCache[pk] = AuthorCache(name: name, timestamp: now)
+                } else {
+                    // Fall back to truncated npub-style identifier.
+                    let fallback = formatPubkey(pk)
+                    result[pk] = fallback
+                    // Don't cache failures — retry next time.
+                }
+            }
+
+            saveMetadataCache(updatedCache)
+        }
+
+        return result
+    }
+
+    /// Parse display_name or name from a kind 0 event's content JSON.
+    private func parseDisplayName(from event: NostrEvent) -> String? {
+        guard let data = event.content.data(using: .utf8),
+              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+            return nil
+        }
+        // Prefer display_name, fall back to name.
+        if let displayName = json["display_name"] as? String, !displayName.isEmpty {
+            return displayName
+        }
+        if let name = json["name"] as? String, !name.isEmpty {
+            return name
+        }
+        return nil
+    }
+
+    /// Format a hex pubkey as a short identifier: first 8 + "..." + last 4.
+    private func formatPubkey(_ pubkey: String) -> String {
+        guard pubkey.count >= 12 else { return pubkey }
+        let start = pubkey.prefix(8)
+        let end = pubkey.suffix(4)
+        return "\(start)...\(end)"
+    }
+
+    // MARK: - Metadata Cache (UserDefaults)
+
+    private func loadMetadataCache() -> [String: AuthorCache] {
+        let defaults = UserDefaults.standard
+        guard let data = defaults.data(forKey: Self.metadataCacheKey),
+              let cache = try? JSONDecoder().decode([String: AuthorCache].self, from: data) else {
+            return [:]
+        }
+        return cache
+    }
+
+    private func saveMetadataCache(_ cache: [String: AuthorCache]) {
+        guard let data = try? JSONEncoder().encode(cache) else { return }
+        UserDefaults.standard.set(data, forKey: Self.metadataCacheKey)
+    }
+
+    // MARK: - Notification Display
+
+    /// Display native iOS notifications for a batch of verified events.
+    private func displayNotifications(events: [NostrEvent], authorNames: [String: String]) async {
+        let center = UNUserNotificationCenter.current()
+
+        for event in events {
+            let authorName = authorNames[event.pubkey] ?? formatPubkey(event.pubkey)
+            let (title, body, categoryId, threadId) = notificationContent(
+                event: event,
+                authorName: authorName
+            )
+
+            let content = UNMutableNotificationContent()
+            content.title = title
+            content.body = body
+            content.sound = .default
+            content.categoryIdentifier = categoryId
+            content.threadIdentifier = threadId
+            content.userInfo = ["url": "/notifications"]
+
+            let identifier = "ditto-\(event.id.prefix(16))"
+            let request = UNNotificationRequest(
+                identifier: identifier,
+                content: content,
+                trigger: nil // Deliver immediately.
+            )
+
+            try? await center.add(request)
+        }
+    }
+
+    /// Build notification title, body, category ID, and thread identifier for an event.
+    private func notificationContent(
+        event: NostrEvent,
+        authorName: String
+    ) -> (title: String, body: String, categoryId: String, threadId: String) {
+        let refId = referencedEventId(from: event) ?? ""
+
+        switch event.kind {
+        case 7:
+            // Reaction — show the reaction content (emoji) if available.
+            let reaction = event.content.isEmpty || event.content == "+" ? "❤️" : event.content
+            return (
+                "\(authorName) reacted \(reaction)",
+                "Reacted to your post",
+                Self.categoryReactions,
+                "reactions:\(refId)"
+            )
+
+        case 6, 16:
+            return (
+                "\(authorName) reposted your note",
+                "",
+                Self.categoryReposts,
+                "reposts:\(refId)"
+            )
+
+        case 9735:
+            let sats = zapAmount(from: event)
+            if sats > 0 {
+                return (
+                    "\(formatSats(sats)) sats from \(authorName)",
+                    "You received a zap",
+                    Self.categoryZaps,
+                    "zaps"
+                )
+            }
+            return (
+                "\(authorName) zapped you",
+                "",
+                Self.categoryZaps,
+                "zaps"
+            )
+
+        case 1:
+            let hasETag = event.tags.contains(where: { $0.first == "e" })
+            let preview = contentPreview(event.content, maxLength: 120)
+            if hasETag {
+                return (
+                    "\(authorName) replied to you",
+                    preview,
+                    Self.categoryMentions,
+                    "mentions"
+                )
+            }
+            return (
+                "\(authorName) mentioned you",
+                preview,
+                Self.categoryMentions,
+                "mentions"
+            )
+
+        case 1111, 1222, 1244:
+            let preview = contentPreview(event.content, maxLength: 120)
+            // Check if this is a reply to another comment (k tag == "1111").
+            let isReply = event.tags.contains(where: { $0.first == "k" && $0.count > 1 && $0[1] == "1111" })
+            let action = isReply ? "replied to your comment" : "commented on your post"
+            return (
+                "\(authorName) \(action)",
+                preview,
+                Self.categoryComments,
+                "comments:\(refId)"
+            )
+
+        case 8:
+            return (
+                "\(authorName) awarded you a badge",
+                "You received a new badge",
+                Self.categoryBadges,
+                "badges"
+            )
+
+        case 8211:
+            return (
+                "\(authorName) sent you a letter",
+                "You have a new letter waiting for you",
+                Self.categoryLetters,
+                "letters"
+            )
+
+        default:
+            return (
+                "\(authorName) interacted with you",
+                "",
+                Self.categoryMentions,
+                "mentions"
+            )
+        }
+    }
+
+    /// Truncate content for notification body preview.
+    private func contentPreview(_ content: String, maxLength: Int) -> String {
+        let trimmed = content.trimmingCharacters(in: .whitespacesAndNewlines)
+        // Replace newlines with spaces for a single-line preview.
+        let singleLine = trimmed.replacingOccurrences(
+            of: "\\s*\\n+\\s*",
+            with: " ",
+            options: .regularExpression
+        )
+        guard singleLine.count > maxLength else { return singleLine }
+        return String(singleLine.prefix(maxLength)) + "…"
+    }
+
+    // MARK: - Zap Amount Extraction
+
+    /// Extract zap amount in sats from a kind 9735 zap receipt event.
+    /// Checks the "amount" tag first (millisats), then falls back to
+    /// parsing the "description" tag's zap request JSON.
+    private func zapAmount(from event: NostrEvent) -> Int {
+        // Check for direct "amount" tag (value in millisats).
+        for tag in event.tags where tag.first == "amount" && tag.count > 1 {
+            if let msats = Int(tag[1]), msats > 0 {
+                return msats / 1000
+            }
+        }
+
+        // Fall back to "description" tag (zap request JSON) -> amount tag.
+        for tag in event.tags where tag.first == "description" && tag.count > 1 {
+            guard let data = tag[1].data(using: .utf8),
+                  let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
+                  let reqTags = json["tags"] as? [[String]] else { continue }
+            for reqTag in reqTags where reqTag.first == "amount" && reqTag.count > 1 {
+                if let msats = Int(reqTag[1]), msats > 0 {
+                    return msats / 1000
+                }
+            }
+        }
+
+        return 0
+    }
+
+    /// Format sats for compact display: 500 -> "500", 1500 -> "1.5K", 1000000 -> "1M".
+    private func formatSats(_ sats: Int) -> String {
+        if sats >= 1_000_000 {
+            let val = Double(sats) / 1_000_000.0
+            if val == val.rounded(.down) {
+                return "\(Int(val))M"
+            }
+            return String(format: "%.1fM", val).replacingOccurrences(of: ".0M", with: "M")
+        } else if sats >= 1_000 {
+            let val = Double(sats) / 1_000.0
+            if val == val.rounded(.down) {
+                return "\(Int(val))K"
+            }
+            return String(format: "%.1fK", val).replacingOccurrences(of: ".0K", with: "K")
+        }
+        return "\(sats)"
+    }
+
+    // MARK: - Last-Seen Timestamp
+
+    var lastSeenTimestamp: Int {
+        UserDefaults.standard.integer(forKey: Self.lastSeenKey)
+    }
+
+    func setLastSeenTimestamp(_ ts: Int) {
+        UserDefaults.standard.set(ts, forKey: Self.lastSeenKey)
+    }
+}

ios/App/App/SandboxPlugin.swift

@@ -0,0 +1,541 @@
+import Foundation
+import Capacitor
+import WebKit
+
+// MARK: - Plugin
+
+/// Capacitor plugin that creates isolated WKWebViews for sandboxed content.
+///
+/// Each sandbox gets a unique custom URL scheme (`sbx-<id>://`) so that
+/// every embedded app has its own origin (separate localStorage, cookies, etc.).
+/// All requests on the custom scheme are intercepted via `WKURLSchemeHandler`
+/// and forwarded to the JS layer as fetch events — the same protocol
+/// iframe.diy uses. This lets the existing React code serve files identically.
+@objc(SandboxPlugin)
+public class SandboxPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "SandboxPlugin"
+    public let jsName = "SandboxPlugin"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "create", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "navigate", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "updateFrame", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "respondToFetch", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "postMessage", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "destroy", returnType: CAPPluginReturnPromise),
+    ]
+
+    /// Active sandbox instances, keyed by sandbox ID.
+    private var sandboxes: [String: SandboxInstance] = [:]
+
+    // MARK: - Plugin Methods
+
+    @objc func create(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+        guard let frame = call.getObject("frame"),
+              let x = frame["x"] as? Double,
+              let y = frame["y"] as? Double,
+              let width = frame["width"] as? Double,
+              let height = frame["height"] as? Double else {
+            call.reject("Missing or invalid parameter: frame")
+            return
+        }
+
+        if sandboxes[sandboxId] != nil {
+            call.reject("Sandbox already exists: \(sandboxId)")
+            return
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+
+            let webViewFrame = CGRect(x: x, y: y, width: width, height: height)
+            let sandbox = SandboxInstance(
+                id: sandboxId,
+                frame: webViewFrame,
+                plugin: self
+            )
+            self.sandboxes[sandboxId] = sandbox
+
+            // Add the container (WebView + spinner overlay) on top of
+            // the Capacitor WebView.
+            if let bridge = self.bridge,
+               let webView = bridge.webView {
+                webView.superview?.addSubview(sandbox.containerView)
+            }
+
+            call.resolve()
+        }
+    }
+
+    @objc func navigate(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let sandbox = self?.sandboxes[sandboxId] else {
+                call.reject("Sandbox not found: \(sandboxId)")
+                return
+            }
+            sandbox.navigateToApp()
+            call.resolve()
+        }
+    }
+
+    @objc func updateFrame(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+        guard let frame = call.getObject("frame"),
+              let x = frame["x"] as? Double,
+              let y = frame["y"] as? Double,
+              let width = frame["width"] as? Double,
+              let height = frame["height"] as? Double else {
+            call.reject("Missing or invalid parameter: frame")
+            return
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let sandbox = self?.sandboxes[sandboxId] else {
+                call.reject("Sandbox not found: \(sandboxId)")
+                return
+            }
+            sandbox.containerView.frame = CGRect(x: x, y: y, width: width, height: height)
+            call.resolve()
+        }
+    }
+
+    @objc func respondToFetch(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+        guard let requestId = call.getString("requestId") else {
+            call.reject("Missing required parameter: requestId")
+            return
+        }
+        guard let response = call.getObject("response") else {
+            call.reject("Missing required parameter: response")
+            return
+        }
+
+        guard let sandbox = sandboxes[sandboxId] else {
+            call.reject("Sandbox not found: \(sandboxId)")
+            return
+        }
+
+        sandbox.schemeHandler.resolveRequest(
+            requestId: requestId,
+            status: response["status"] as? Int ?? 200,
+            statusText: response["statusText"] as? String ?? "OK",
+            headers: response["headers"] as? [String: String] ?? [:],
+            bodyBase64: response["body"] as? String
+        )
+
+        call.resolve()
+    }
+
+    @objc func postMessage(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+        guard let message = call.getObject("message") else {
+            call.reject("Missing required parameter: message")
+            return
+        }
+
+        guard let sandbox = sandboxes[sandboxId] else {
+            call.reject("Sandbox not found: \(sandboxId)")
+            return
+        }
+
+        DispatchQueue.main.async {
+            sandbox.postMessageToWebView(message)
+        }
+
+        call.resolve()
+    }
+
+    @objc func destroy(_ call: CAPPluginCall) {
+        guard let sandboxId = call.getString("id") else {
+            call.reject("Missing required parameter: id")
+            return
+        }
+
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+            if let sandbox = self.sandboxes.removeValue(forKey: sandboxId) {
+                sandbox.containerView.removeFromSuperview()
+                sandbox.schemeHandler.cancelAll()
+            }
+            call.resolve()
+        }
+    }
+
+    // MARK: - Event Forwarding
+
+    /// Forward a fetch request from the native WebView to JS.
+    func emitFetchRequest(sandboxId: String, requestId: String, request: [String: Any]) {
+        notifyListeners("fetch", data: [
+            "id": sandboxId,
+            "requestId": requestId,
+            "request": request,
+        ])
+    }
+
+    /// Forward a script message from the sandbox to JS.
+    func emitScriptMessage(sandboxId: String, message: [String: Any]) {
+        notifyListeners("scriptMessage", data: [
+            "id": sandboxId,
+            "message": message,
+        ])
+    }
+}
+
+// MARK: - SandboxInstance
+
+/// Manages a single sandboxed WKWebView instance.
+private class SandboxInstance: NSObject, WKScriptMessageHandler, WKNavigationDelegate {
+    let id: String
+    let webView: WKWebView
+    let schemeHandler: SandboxSchemeHandler
+    private weak var plugin: SandboxPlugin?
+    private let customScheme: String
+
+    /// Container view that holds the WebView and spinner overlay.
+    let containerView: UIView
+
+    /// Native spinner overlay, removed when the first page finishes loading.
+    private var spinnerOverlay: UIView?
+
+    init(id: String, frame: CGRect, plugin: SandboxPlugin) {
+        self.id = id
+        self.plugin = plugin
+
+        // Each sandbox gets a unique custom URL scheme so that WKWebView
+        // assigns a distinct origin, isolating localStorage/IndexedDB/cookies.
+        self.customScheme = "sbx-\(id)"
+
+        self.schemeHandler = SandboxSchemeHandler(
+            sandboxId: id,
+            scheme: self.customScheme,
+            plugin: plugin
+        )
+
+        let config = WKWebViewConfiguration()
+        config.setURLSchemeHandler(self.schemeHandler, forURLScheme: self.customScheme)
+
+        // Add a script message handler for communication from injected scripts.
+        let userContentController = WKUserContentController()
+
+        // Inject a bridge script that:
+        // 1. Provides window.parent.postMessage()-like functionality
+        // 2. Routes messages through the native bridge
+        let bridgeScript = WKUserScript(
+            source: SandboxInstance.bridgeScript(scheme: self.customScheme),
+            injectionTime: .atDocumentStart,
+            forMainFrameOnly: false
+        )
+        userContentController.addUserScript(bridgeScript)
+
+        config.userContentController = userContentController
+        config.preferences.javaScriptCanOpenWindowsAutomatically = false
+        config.defaultWebpagePreferences.allowsContentJavaScript = true
+
+        // Container view that holds the WebView + spinner overlay.
+        self.containerView = UIView(frame: frame)
+
+        self.webView = WKWebView(frame: containerView.bounds, configuration: config)
+        self.webView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        self.webView.isOpaque = false
+        self.webView.backgroundColor = UIColor(red: 0x14/255.0, green: 0x16/255.0, blue: 0x1f/255.0, alpha: 1)
+        self.webView.scrollView.backgroundColor = self.webView.backgroundColor
+        self.webView.scrollView.bounces = false
+        self.containerView.addSubview(self.webView)
+
+        // Dark overlay behind the spinner.
+        let overlay = UIView(frame: containerView.bounds)
+        overlay.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        overlay.backgroundColor = UIColor(red: 0x14/255.0, green: 0x16/255.0, blue: 0x1f/255.0, alpha: 1)
+        self.containerView.addSubview(overlay)
+
+        // Native spinner — uses UIActivityIndicatorView which animates on
+        // the render thread independently of JS/main-thread work.
+        let spinner = UIActivityIndicatorView(style: .medium)
+        spinner.color = UIColor(red: 124/255.0, green: 92/255.0, blue: 220/255.0, alpha: 1)
+        spinner.translatesAutoresizingMaskIntoConstraints = false
+        spinner.startAnimating()
+        overlay.addSubview(spinner)
+        NSLayoutConstraint.activate([
+            spinner.centerXAnchor.constraint(equalTo: overlay.centerXAnchor),
+            spinner.centerYAnchor.constraint(equalTo: overlay.centerYAnchor),
+        ])
+
+        self.spinnerOverlay = overlay
+
+        super.init()
+
+        // Register the message handler and navigation delegate after super.init().
+        userContentController.add(self, name: "sandboxBridge")
+        self.webView.navigationDelegate = self
+    }
+
+    /// Navigate the WebView to the sandbox's entry point.
+    func navigateToApp() {
+        let initialURL = URL(string: "\(customScheme)://app/index.html")!
+        webView.load(URLRequest(url: initialURL))
+    }
+
+    /// Remove the native loading overlay. Safe to call multiple times.
+    func hideSpinner() {
+        spinnerOverlay?.removeFromSuperview()
+        spinnerOverlay = nil
+    }
+
+    /// Post a JSON-RPC message to injected scripts inside the WebView.
+    func postMessageToWebView(_ message: [String: Any]) {
+        guard let jsonData = try? JSONSerialization.data(withJSONObject: message),
+              let jsonString = String(data: jsonData, encoding: .utf8) else {
+            return
+        }
+
+        let js = """
+        (function() {
+            if (window.__sandboxBridge && window.__sandboxBridge.onMessage) {
+                window.__sandboxBridge.onMessage(\(jsonString));
+            }
+        })();
+        """
+        webView.evaluateJavaScript(js, completionHandler: nil)
+    }
+
+    // MARK: - WKScriptMessageHandler
+
+    /// Receive messages from injected scripts via webkit.messageHandlers.sandboxBridge.
+    func userContentController(
+        _ userContentController: WKUserContentController,
+        didReceive message: WKScriptMessage
+    ) {
+        guard message.name == "sandboxBridge",
+              let body = message.body as? [String: Any] else {
+            return
+        }
+        plugin?.emitScriptMessage(sandboxId: id, message: body)
+    }
+
+    // MARK: - WKNavigationDelegate
+
+    /// Remove the spinner overlay once the first page finishes loading.
+    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
+        hideSpinner()
+    }
+
+    // MARK: - Bridge Script
+
+    /// JavaScript injected at document start that provides:
+    ///   - `window.parent.postMessage()` emulation via WKScriptMessageHandler
+    ///   - `window.__sandboxBridge.onMessage()` for receiving messages from parent
+    ///   - `window.addEventListener("message", ...)` support for injected scripts
+    private static func bridgeScript(scheme: String) -> String {
+        return """
+        (function() {
+            'use strict';
+
+            // Message listeners registered by injected scripts.
+            var messageListeners = [];
+
+            // Bridge object for native communication.
+            window.__sandboxBridge = {
+                onMessage: function(data) {
+                    // Dispatch to all registered message listeners.
+                    var event = {
+                        data: data,
+                        origin: '\(scheme)://app',
+                        source: window.parent,
+                        type: 'message'
+                    };
+                    for (var i = 0; i < messageListeners.length; i++) {
+                        try {
+                            messageListeners[i](event);
+                        } catch (e) {
+                            console.error('[SandboxBridge] Listener error:', e);
+                        }
+                    }
+                }
+            };
+
+            // Override addEventListener to capture "message" listeners.
+            var originalAddEventListener = window.addEventListener;
+            window.addEventListener = function(type, listener, options) {
+                if (type === 'message' && typeof listener === 'function') {
+                    messageListeners.push(listener);
+                }
+                return originalAddEventListener.call(window, type, listener, options);
+            };
+
+            var originalRemoveEventListener = window.removeEventListener;
+            window.removeEventListener = function(type, listener, options) {
+                if (type === 'message') {
+                    var idx = messageListeners.indexOf(listener);
+                    if (idx !== -1) messageListeners.splice(idx, 1);
+                }
+                return originalRemoveEventListener.call(window, type, listener, options);
+            };
+
+            // Emulate window.parent.postMessage for scripts that use it
+            // (e.g. the webxdc bridge script, preview injected script).
+            if (!window.parent || window.parent === window) {
+                window.parent = {};
+            }
+            window.parent.postMessage = function(data, targetOrigin, transfer) {
+                if (data && typeof data === 'object' && data.jsonrpc === '2.0') {
+                    try {
+                        window.webkit.messageHandlers.sandboxBridge.postMessage(data);
+                    } catch (e) {
+                        console.error('[SandboxBridge] postMessage failed:', e);
+                    }
+                }
+            };
+        })();
+        """;
+    }
+}
+
+// MARK: - SandboxSchemeHandler
+
+/// WKURLSchemeHandler that intercepts all requests on the sandbox's custom
+/// URL scheme and forwards them to the JS layer as fetch events.
+private class SandboxSchemeHandler: NSObject, WKURLSchemeHandler {
+    private let sandboxId: String
+    private let scheme: String
+    private weak var plugin: SandboxPlugin?
+
+    /// Pending scheme tasks waiting for a response from JS.
+    /// Key: requestId (UUID string), Value: the WKURLSchemeTask to respond to.
+    private var pendingTasks: [String: WKURLSchemeTask] = [:]
+    private let lock = NSLock()
+
+    init(sandboxId: String, scheme: String, plugin: SandboxPlugin) {
+        self.sandboxId = sandboxId
+        self.scheme = scheme
+        self.plugin = plugin
+    }
+
+    func webView(_ webView: WKWebView, start urlSchemeTask: WKURLSchemeTask) {
+        let request = urlSchemeTask.request
+        guard let url = request.url else {
+            urlSchemeTask.didFailWithError(NSError(
+                domain: "SandboxPlugin", code: -1,
+                userInfo: [NSLocalizedDescriptionKey: "No URL in request"]
+            ))
+            return
+        }
+
+        let requestId = UUID().uuidString
+
+        lock.lock()
+        pendingTasks[requestId] = urlSchemeTask
+        lock.unlock()
+
+        // Serialise the request for the fetch event.
+        // Rewrite the URL so it looks like a normal HTTP URL to the parent
+        // (e.g. "sbx-abc123://app/index.html" -> "https://<sandboxId>.sandbox.native/index.html")
+        // The JS side only cares about the pathname.
+        var headers: [String: String] = [:]
+        if let allHeaders = request.allHTTPHeaderFields {
+            headers = allHeaders
+        }
+
+        var bodyBase64: String? = nil
+        if let bodyData = request.httpBody {
+            bodyBase64 = bodyData.base64EncodedString()
+        }
+
+        let path = url.path.isEmpty ? "/" : url.path
+        let rewrittenURL = "https://\(sandboxId).sandbox.native\(path)"
+
+        let serialisedRequest: [String: Any] = [
+            "url": rewrittenURL,
+            "method": request.httpMethod ?? "GET",
+            "headers": headers,
+            "body": bodyBase64 as Any,
+        ]
+
+        plugin?.emitFetchRequest(
+            sandboxId: sandboxId,
+            requestId: requestId,
+            request: serialisedRequest
+        )
+    }
+
+    func webView(_ webView: WKWebView, stop urlSchemeTask: WKURLSchemeTask) {
+        // Remove the task from pending — JS response will be ignored if it arrives later.
+        lock.lock()
+        let removed = pendingTasks.first(where: { $0.value === urlSchemeTask })
+        if let key = removed?.key {
+            pendingTasks.removeValue(forKey: key)
+        }
+        lock.unlock()
+    }
+
+    /// Called by the plugin when JS responds to a fetch request.
+    func resolveRequest(
+        requestId: String,
+        status: Int,
+        statusText: String,
+        headers: [String: String],
+        bodyBase64: String?
+    ) {
+        lock.lock()
+        guard let task = pendingTasks.removeValue(forKey: requestId) else {
+            lock.unlock()
+            return
+        }
+        lock.unlock()
+
+        // Decode the base64 body.
+        var bodyData: Data? = nil
+        if let b64 = bodyBase64 {
+            bodyData = Data(base64Encoded: b64)
+        }
+
+        // Build the response.
+        // Use the task's original URL for the response.
+        let responseURL = task.request.url ?? URL(string: "\(scheme)://app/")!
+        let response = HTTPURLResponse(
+            url: responseURL,
+            statusCode: status,
+            httpVersion: "HTTP/1.1",
+            headerFields: headers
+        )!
+
+        DispatchQueue.main.async {
+            task.didReceive(response)
+            if let data = bodyData {
+                task.didReceive(data)
+            }
+            task.didFinish()
+        }
+    }
+
+    /// Cancel all pending tasks (called on destroy).
+    func cancelAll() {
+        lock.lock()
+        let tasks = pendingTasks
+        pendingTasks.removeAll()
+        lock.unlock()
+
+        for (_, task) in tasks {
+            task.didFailWithError(NSError(
+                domain: "SandboxPlugin", code: -999,
+                userInfo: [NSLocalizedDescriptionKey: "Sandbox destroyed"]
+            ))
+        }
+    }
+}

ios/App/CapApp-SPM/Package.swift

@@ -14,9 +14,12 @@ let package = Package(
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", exact: "8.2.0"),
         .package(name: "CapacitorApp", path: "../../../node_modules/@capacitor/app"),
         .package(name: "CapacitorFilesystem", path: "../../../node_modules/@capacitor/filesystem"),
+        .package(name: "CapacitorHaptics", path: "../../../node_modules/@capacitor/haptics"),
+        .package(name: "CapacitorKeyboard", path: "../../../node_modules/@capacitor/keyboard"),
         .package(name: "CapacitorLocalNotifications", path: "../../../node_modules/@capacitor/local-notifications"),
         .package(name: "CapacitorShare", path: "../../../node_modules/@capacitor/share"),
-        .package(name: "CapacitorStatusBar", path: "../../../node_modules/@capacitor/status-bar")
+        .package(name: "CapgoCapacitorAutofillSavePassword", path: "../../../node_modules/@capgo/capacitor-autofill-save-password"),
+        .package(name: "CapacitorSecureStoragePlugin", path: "../../../node_modules/capacitor-secure-storage-plugin")
     ],
     targets: [
         .target(
@@ -26,9 +29,12 @@ let package = Package(
                 .product(name: "Cordova", package: "capacitor-swift-pm"),
                 .product(name: "CapacitorApp", package: "CapacitorApp"),
                 .product(name: "CapacitorFilesystem", package: "CapacitorFilesystem"),
+                .product(name: "CapacitorHaptics", package: "CapacitorHaptics"),
+                .product(name: "CapacitorKeyboard", package: "CapacitorKeyboard"),
                 .product(name: "CapacitorLocalNotifications", package: "CapacitorLocalNotifications"),
                 .product(name: "CapacitorShare", package: "CapacitorShare"),
-                .product(name: "CapacitorStatusBar", package: "CapacitorStatusBar")
+                .product(name: "CapgoCapacitorAutofillSavePassword", package: "CapgoCapacitorAutofillSavePassword"),
+                .product(name: "CapacitorSecureStoragePlugin", package: "CapacitorSecureStoragePlugin")
             ]
         )
     ]

nginx.conf

@@ -0,0 +1,30 @@
+server {
+    listen 80;
+    server_name _;
+    root /usr/share/nginx/html;
+    index index.html;
+
+    gzip on;
+    gzip_vary on;
+    gzip_min_length 1024;
+    gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/javascript application/json;
+
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+
+    location /health {
+        access_log off;
+        return 200 "healthy\n";
+        add_header Content-Type text/plain;
+    }
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+}

nginx.dev.conf

@@ -0,0 +1,35 @@
+server {
+    listen 80;
+    server_name _;
+    root /usr/share/nginx/html;
+    index index.html;
+
+    gzip on;
+    gzip_vary on;
+    gzip_min_length 1024;
+    gzip_types text/plain text/css text/xml text/javascript application/x-javascript application/xml+rss application/javascript application/json;
+
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+
+    location /health {
+        access_log off;
+        return 200 "healthy\n";
+        add_header Content-Type text/plain;
+    }
+
+    location / {
+        resolver 127.0.0.11 valid=10s;
+        set $vite_backend http://vite:8080;
+        proxy_pass $vite_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_read_timeout 86400;
+    }
+}

package.json

@@ -1,12 +1,13 @@
 {
-  "name": "ditto",
+  "name": "agora",
   "private": true,
-  "version": "2.4.0",
+  "version": "2.8.0",
   "type": "module",
   "scripts": {
     "dev": "npm i --silent && vite",
     "build": "npm i --silent && vite build -l error && cp dist/index.html dist/404.html && echo 'Project built successfully!'",
     "test": "npm i --silent && tsc --noEmit && eslint && vitest run --reporter=dot --silent && vite build -l error && cp dist/index.html dist/404.html && echo 'All tests passed!'",
+    "cap:sync": "npx cap sync && node scripts/patch-cap-config.mjs",
     "keygen": "keytool -genkey -v -keystore android/app/my-upload-key.keystore -keyalg RSA -keysize 2048 -validity 10000 -alias upload",
     "icons": "bash scripts/generate-icons.sh"
   },
@@ -14,12 +15,16 @@
     "node": ">=22"
   },
   "dependencies": {
+    "@breeztech/breez-sdk-spark": "^0.13.2-dev1",
     "@capacitor/app": "^8.0.0",
+    "@capacitor/barcode-scanner": "^3.0.2",
     "@capacitor/core": "^8.1.0",
     "@capacitor/filesystem": "^8.1.2",
+    "@capacitor/haptics": "^8.0.2",
+    "@capacitor/keyboard": "^8.0.3",
     "@capacitor/local-notifications": "^8.0.1",
     "@capacitor/share": "^8.0.1",
-    "@capacitor/status-bar": "^8.0.0",
+    "@capgo/capacitor-autofill-save-password": "^8.0.22",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -64,8 +69,10 @@
     "@milkdown/prose": "^7.20.0",
     "@milkdown/react": "^7.20.0",
     "@milkdown/utils": "^7.20.0",
-    "@nostrify/nostrify": "^0.51.0",
-    "@nostrify/react": "^0.4.0",
+    "@noble/curves": "^2.2.0",
+    "@noble/hashes": "^1.8.0",
+    "@nostrify/nostrify": "^0.51.1",
+    "@nostrify/react": "^0.5.1",
     "@nostrify/types": "^0.36.9",
     "@plausible-analytics/tracker": "^0.4.4",
     "@radix-ui/react-accordion": "^1.2.0",
@@ -95,15 +102,19 @@
     "@radix-ui/react-toggle": "^1.1.0",
     "@radix-ui/react-toggle-group": "^1.1.0",
     "@radix-ui/react-tooltip": "^1.2.8",
+    "@samthomson/nostr-messaging": "^0.17.1",
+    "@scure/bip39": "^1.6.0",
     "@sentry/react": "^10.42.0",
     "@tanstack/react-query": "^5.56.2",
-    "@unhead/addons": "^2.0.10",
-    "@unhead/react": "^2.0.10",
+    "@unhead/addons": "^2.1.13",
+    "@unhead/react": "^2.1.13",
     "blurhash": "^2.0.5",
     "buffer": "^6.0.3",
+    "capacitor-secure-storage-plugin": "^0.13.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.0.0",
+    "d3-scale": "^4.0.2",
     "date-fns": "^3.6.0",
     "dompurify": "^3.3.3",
     "embla-carousel-react": "^8.3.0",
@@ -111,9 +122,14 @@
     "fflate": "^0.8.2",
     "hls.js": "^1.6.15",
     "html-to-image": "^1.11.13",
+    "i18next": "^26.0.5",
+    "i18next-browser-languagedetector": "^8.2.1",
     "idb": "^8.0.3",
     "input-otp": "^1.2.4",
-    "lucide-react": "^0.462.0",
+    "iso-3166": "^4.4.0",
+    "leaflet": "^1.9.4",
+    "lucide-react": "^1.8.0",
+    "ngeohash": "^0.6.3",
     "nostr-tools": "^2.13.0",
     "qrcode": "^1.5.4",
     "react": "^19.2.4",
@@ -122,7 +138,9 @@
     "react-dom": "^19.2.4",
     "react-easy-crop": "^5.5.6",
     "react-hook-form": "^7.71.1",
+    "react-i18next": "^17.0.4",
     "react-intersection-observer": "^9.16.0",
+    "react-leaflet": "^4.2.1",
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^2.1.3",
     "react-router-dom": "^6.26.2",
@@ -147,7 +165,9 @@
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.2",
+    "@types/d3-scale": "^4.0.9",
     "@types/dompurify": "^3.0.5",
+    "@types/leaflet": "^1.9.21",
     "@types/node": "^22.5.5",
     "@types/qrcode": "^1.5.5",
     "@types/react": "^19.2.14",

public/.well-known/apple-app-site-association

@@ -0,0 +1,7 @@
+{
+  "webcredentials": {
+    "apps": [
+      "GZLTTH5DLM.pub.agora.app"
+    ]
+  }
+}

public/.well-known/assetlinks.json

@@ -1,8 +1,15 @@
-[{
-  "relation": ["delegate_permission/common.handle_all_urls"],
-  "target": {
-    "namespace": "android_app",
-    "package_name": "pub.ditto.app",
-    "sha256_cert_fingerprints": ["7C:05:A8:5A:07:0F:84:AE:43:DE:85:67:A4:5F:7F:FB:42:0A:05:05:27:CE:B6:8C:DA:AF:A5:E0:12:E0:9E:71"]
+[
+  {
+    "relation": [
+      "delegate_permission/common.handle_all_urls"
+    ],
+    "target": {
+      "namespace": "android_app",
+      "package_name": "pub.agora.app",
+      "sha256_cert_fingerprints": [
+        "7C:05:A8:5A:07:0F:84:AE:43:DE:85:67:A4:5F:7F:FB:42:0A:05:05:27:CE:B6:8C:DA:AF:A5:E0:12:E0:9E:71",
+        "E5:B1:A9:13:C9:37:35:3C:A5:E7:27:89:C0:9D:3D:0D:A5:4F:F5:26:88:06:BD:24:46:21:AB:61:6B:CC:C5:E5"
+      ]
+    }
   }
-}]
+]

public/CHANGELOG.md

@@ -1,251 +1,7 @@
 # Changelog
 
-## [2.4.0] - 2026-04-02
+## [1.0.0] - 2026-04-30
 
 ### Added
-- First-hatch tour: a guided experience for hatching your very first Blobbi egg, with progressive crack animations, an inline card flow, and a reveal moment
-- Customizable bottom bar: rearrange or hide any item in the navigation bar to make Ditto feel like yours
-- Mission surface card in the feed that surfaces your active quests at a glance
 
-### Changed
-- Missions redesigned as a quest board with collapsible cards and a lighter aesthetic
-- "Edit Profile" mission now completes when you update any profile field, not just wall-specific edits
-- Media tab on profiles now shows only photos, videos, and other media -- not plain text posts
-- Blobbi onboarding state now syncs to your profile so it follows you across devices
-
-### Fixed
-- Notification dot no longer reappears after you've already marked notifications as read
-- Dialogs no longer fly up when the mobile keyboard opens
-
-## [2.3.1] - 2026-04-02
-
-### Changed
-- Drafts now save instantly to your device and sync to relays in the background, with a cloud sync indicator so you always know the status
-
-### Fixed
-- Dialogs stay visible above the keyboard on mobile instead of getting hidden behind it
-- Editing an existing article no longer incorrectly warns about a duplicate slug
-- Switching between rich text and markdown source mode no longer clears your content
-- Fix crash when editing in markdown source mode
-
-## [2.3.0] - 2026-04-02
-
-### Added
-- In-app article editor with a rich text toolbar, image uploads, auto-saving drafts, and a "My Articles" tab to manage drafts and published articles
-
-### Fixed
-- Custom emoji no longer stretch to fill their container
-- Mobile drawer now closes when tapping footer links like Changelog or Privacy
-- Logged-out users now default to the global tab on content feeds instead of seeing an empty follows tab
-
-## [2.2.11] - 2026-04-02
-
-### Fixed
-- Fix crash caused by the "What's new" toast firing outside the router
-
-## [2.2.10] - 2026-04-02
-
-### Added
-- App cards for Nostr apps now display in feeds and detail pages with hero images, icons, and quick-launch buttons
-- "What's new" toast appears after an app update with a changelog preview and link to the full changelog
-
-### Changed
-- Changelog page redesigned with a hero section for the latest release, collapsible older entries, and category icons inline with each item
-
-### Fixed
-- Compose box now fully resets to its collapsed state after posting, including poll options and media trays
-
-## [2.2.9] - 2026-04-01
-
-### Added
-- Emoji pack creator and editor with drag-and-drop image upload, auto-generated identifiers, and description field
-- Blobbi companions now appear in feeds and post detail pages
-
-### Changed
-- Blobbi shop redesigned with a tile layout and instant buy -- no more categories or accessory tabs
-- Emoji packs without any valid emojis are now hidden from feeds
-- Custom emoji shortcode collisions across packs are automatically resolved with pack-prefixed names
-
-## [2.2.8] - 2026-04-01
-
-### Added
-- Full threaded reply trees on post detail pages with collapsible deep branches and "Show X more replies" for sibling threads
-- Broadcast button in the Event JSON dialog to re-publish any event to your relays
-
-### Changed
-- My Badges tab overhauled with drag-and-drop reordering, a scrollable list, and a showcase-style carousel for pending badges
-- Encrypted letter envelopes now show the mailing side first (sender and recipient), then flip to reveal the wax seal
-- Blobbi companions are more expressive -- richer status reactions, sleeping visuals, and body effects like dirt and hunger cues
-
-### Fixed
-- Notification dot not clearing after marking notifications as read
-- Followers/following modal staying open after navigating to a profile
-
-## [2.2.7] - 2026-03-31
-
-### Fixed
-- Nushu script in encrypted letters now renders correctly on Android and iOS
-
-## [2.2.6] - 2026-03-31
-
-### Added
-- Encrypted letters now appear as interactive 3D envelopes with Nushu script -- flip and open them to reveal the secret writing inside
-- Zap receipts and profile metadata events now render in feeds and detail pages
-- Remote signer callback page for login flows with Amber, Primal, and other signing apps
-
-### Changed
-- Post action buttons extracted into a reusable PostActionBar component
-- Badge detail page streamlined with unified tab bar
-
-### Fixed
-- Hashtags now support accented and Unicode characters
-- Letter compose opens correctly from notifications and the letters page
-- Letter font picker loads fonts so each option previews in the correct typeface
-- Zap comment positioned inside the right column instead of floating with offset
-- Safe-area padding on pinned SubHeaderBar only applies when scrolled to top
-
-## [2.2.5] - 2026-03-30
-
-### Fixed
-- Crash when dragging profile tabs to reorder them
-
-## [2.2.4] - 2026-03-30
-
-### Changed
-- Profiles now have an emoji reaction button instead of a zap button -- express yourself with any emoji or custom emoji right on someone's profile
-- Zap moved to the profile overflow menu so it's still one tap away
-
-### Fixed
-- Crash on the notifications page caused by malformed badge award tags
-- Deleting a badge now also deletes all awards you issued for it
-- Custom emoji reactions missing their image tag no longer render as broken shortcodes
-- Deletion requests for addressable events now include both `e` and `a` tags for broader relay compatibility
-- Profile reactions no longer collapse into a single grouped notification
-- Oversized reaction emoji in comment context headers
-
-## [2.2.3] - 2026-03-30
-
-### Added
-- Letters now have an overflow menu, reply button, and a grid layout for browsing
-- Independent feed toggles for comments and generic reposts in content settings
-- Sidebar items are now visible to logged-out users so newcomers can explore everything
-
-### Changed
-- Compose textarea expands smoothly as you type instead of snapping to a new height
-- Blobbi stickers auto-shrink near card edges and clip cleanly at rounded boundaries
-
-### Fixed
-- Feed gaps when replies are disabled no longer cause missing posts
-- Avatar shape no longer flashes on load
-- Top bar arc no longer flickers during navigation transitions
-- Letter drawing-only sends, sticker drag bounds, and theme event preservation
-- Notification rendering for badges and letters
-- Duplicate React keys in content settings
-- Layout rendering warning when switching views
-
-## [2.2.2] - 2026-03-29
-
-### Added
-- Dedicated photo upload flow for sharing photos
-- Pull-to-refresh on all feed pages
-- 3D tilt effect on badge images -- hover over badges to see them pop
-- Multi-select badge awarding with indicators for already-sent badges
-- Badge list recovery dialog for restoring profile badge lists
-- Compact badge row preview in embedded profile badges events
-- Custom emoji usage tracking so your most-used custom emojis appear in the quick-react bar
-- Release notes now included in Zapstore publishing
-- Changelog link in the app footer
-
-### Changed
-- "Vines" renamed to "Divines" everywhere in the app
-- Custom emojis appear first in the emoji picker, right after recent
-- Threaded comment view now shows the parent event as a NoteCard with kind action headers
-
-### Fixed
-- Delete post dialog no longer freezes the feed on desktop
-- Amber login on Android now properly retries when returning from the background
-- Key downloads on Android save to the correct location
-- Custom emoji SVGs render correctly in the emoji-mart picker
-- Double-tap reactions now properly show the emoji on the post
-- Emoji shortcode autocomplete text and highlight colors
-- Profile skeleton no longer flickers for brand-new users with no metadata
-- Event links now route correctly for all event types
-- Badge notifications are now clickable
-- Custom profile tab form no longer retains fields from a previously edited tab
-- Double line under profile tabs in edit mode
-- Inconsistent use of "geocache" vs "treasures" terminology
-- Search page "N new posts" pill no longer shows unfiltered count
-- Stale-cache overwrites in replaceable event mutations
-- Click-through on delete confirmation and note menu items
-
-## [2.2.1] - 2026-03-28
-
-### Fixed
-- New posts no longer cause scroll jumps -- they buffer while you're reading and appear with a tap
-- Mobile header no longer shows double-layered backgrounds on notched devices
-- Pinned tabs stay properly positioned when scrolling on mobile
-- Signer approval toasts no longer fire in rapid succession on unstable connections
-- Toasts are easier to swipe away on mobile
-- Content warnings now blur thumbnails in the media grid
-
-## [2.2.0] - 2026-03-28
-
-### Added
-- Blobbi virtual pets -- adopt an egg, hatch it, evolve it into one of 16 adult forms, and care for it with feeding, cleaning, medicine, music, and singing
-- Blobbi companion that follows you around the app, tracks your cursor, blinks, expresses emotions, and reacts to what you're doing
-- Blobbi shop and inventory system with items that affect your pet's stats
-- Daily missions with reroll, care streaks, and stage-based rewards
-- Immersive full-screen divines experience on both mobile and desktop with floating controls
-- Relay information panel on the network settings page
-- Link preview cards now display inside quoted posts instead of raw URLs
-- Nsec paste guard warns you before accidentally pasting private keys outside the login field
-- Remote signer UX improvements for Amber users on Android
-- Badge awards now trigger push notifications
-- Badges display in profile bio section with a "Give badge" option in the profile menu
-
-### Changed
-- Notification "Mentions" tab now shows only pure mentions, filtering out replies
-- Notification preferences ("only from people I follow") now properly apply to push notifications, native Android notifications, and the unread dot
-- Upgraded from React 18 to React 19
-- Reduced initial bundle size by ~50% with improved code splitting and lazy loading
-
-### Fixed
-- Zapping Primal users no longer produces an error
-- Hashtag feeds now match case-insensitively for parity with search results
-- Mobile top bar arc no longer lingers on pages without tabs
-- Give Badge dialog and profile menu action handlers
-
-## [2.1.1] - 2026-03-27
-
-### Added
-- Emoji picker and shortcode autocomplete in zap comment box
-- Zap button on badge detail view
-- Theme descriptions now display on "updated their theme" posts and detail pages
-- Badge thumbnail previews in award notifications
-- Letter notifications with envelope card preview
-- Kind-specific labels in notification text instead of generic "post"
-
-### Fixed
-- Compose modal no longer closes when dismissing emoji picker on mobile
-- Compose preview overflow is now scrollable in modal
-- Toast notifications swipe up to dismiss on mobile instead of sideways
-- File downloads and URL opening work correctly on iOS
-- Badges page no longer shows infinite skeleton when logged out
-
-## [2.1.0] - 2026-03-26
-
-### Added
-- Letters -- a Wii Mail-inspired inbox for sending decorated letters to friends, complete with custom stationery, hand-drawn stickers, emoji stickers, fonts, and a send animation with envelope and wax seal
-- Attach a color moment or theme to your letter as a gift -- recipients can tap to apply it instantly
-- Stationery picker pulls from your color moments, followed users' themes, and built-in presets
-- Freehand drawing canvas for creating one-of-a-kind sticker doodles
-- Letters page added to the sidebar with a custom mailbox icon
-
-## [2.0.1] - 2026-03-26
-
-### Added
-- Tap the version number in settings to see what's new
-
-## [2.0.0] - 2026-03-26
-
-Initial release of Ditto 2.0 -- a complete rewrite of Ditto.
+- Initial Agora 3 release.

public/logo.svg

@@ -1,32 +1,17 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <svg
-   version="1.1"
-   viewBox="-5 -10 100 100"
-   id="svg6"
-   width="100"
-   height="100"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <defs
-     id="defs6" />
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+>
   <path
-     d="m 71.719615,49.36907 -0.62891,0.37109 c -0.12891,0.07031 -0.26172,0.14844 -0.39062,0.21875 -3.9883,10.309 -14.008,17.617 -25.699,17.617 -4.1211,0 -8.0312,-0.89844 -11.539,-2.5391 -0.12891,0.03906 -0.26172,0.07031 -0.39063,0.10156 l -0.35156,0.08984 h -0.02734 l -0.25,0.05859 -0.07813,0.01953 -0.10938,0.03125 c -0.55859,0.12891 -1.1289,0.26172 -1.6992,0.39062 -0.10156,0.03125 -0.19922,0.05078 -0.30078,0.07031 l -0.30078,0.10156 -0.18359,0.0078 c -0.26953,0.05859 -1.3086,0.26953 -1.3086,0.26953 -0.28906,0.05859 -0.55859,0.10937 -0.82813,0.17187 4.9805,3.3086 10.961,5.2305 17.371,5.2305 15.059,0 27.699,-10.602 30.828,-24.738 -0.75,0.48828 -1.5195,0.96875 -2.2891,1.4414 -0.59375,0.36328 -1.2031,0.72656 -1.8242,1.0859 z"
-     id="path1"
-     style="fill:#7c52e0;fill-opacity:1" />
-  <path
-     d="m 30.926615,29.47807 c 0.36328,-0.48828 0.75,-0.95312 1.1523,-1.3828 0.75781,-0.80469 0.71484,-2.0703 -0.08984,-2.8281 -0.80469,-0.75781 -2.0703,-0.71484 -2.8281,0.08984 -0.50781,0.53906 -0.99219,1.125 -1.4492,1.7383 -0.65625,0.88672 -0.47266,2.1406 0.41406,2.7969 0.35938,0.26562 0.77344,0.39453 1.1875,0.39453 0.61719,0 1.2227,-0.27734 1.6133,-0.80859 z"
-     id="path2"
-     style="fill:#7c52e0;fill-opacity:1" />
-  <path
-     d="m 26.742615,32.67807 c -1.0586,-0.3125 -2.1719,0.29687 -2.4805,1.3594 -0.55859,1.9062 -0.83984,3.9141 -0.83984,5.9609 0,2.3789 0.39062,4.7227 1.1602,6.9609 0.28516,0.82812 1.0625,1.3516 1.8906,1.3516 0.21484,0 0.43359,-0.03516 0.64844,-0.10938 1.043,-0.35938 1.6016,-1.4961 1.2422,-2.543 -0.625,-1.8203 -0.94141,-3.7227 -0.94141,-5.6602 0,-1.668 0.22656,-3.2969 0.67969,-4.8398 0.30859,-1.0586 -0.30078,-2.168 -1.3594,-2.4805 z"
-     id="path3"
-     style="fill:#7c52e0;fill-opacity:1" />
-  <path
-     d="m 14.691615,48.83807 c 0.10156,0.33984 0.19922,0.67969 0.32812,1.0195 0.42969,1.3516 0.94922,2.6484 1.5781,3.9102 0.10156,-0.01172 0.21094,-0.01172 0.32031,-0.01953 l 0.16016,-0.01172 0.80078,-0.07031 c 0.37109,-0.03906 0.67188,-0.07031 0.98047,-0.10156 0.51172,-0.05859 1.0195,-0.12109 1.5586,-0.19922 l 0.21875,-0.03125 c 0.07031,-0.01172 0.14062,-0.01953 0.21094,-0.03125 -1.2188,-2.2109 -2.1484,-4.6016 -2.7305,-7.1211 -0.16016,-0.71094 -0.30078,-1.4297 -0.39844,-2.1602 -0.19922,-1.3086 -0.30078,-2.6602 -0.30078,-4.0312 0,-0.89844 0.03906,-1.7812 0.12891,-2.6484 0.07031,-0.71094 0.16016,-1.4102 0.28906,-2.1016 2.25,-12.949 13.57,-22.828 27.16,-22.828 6.0508,0 11.648,1.9609 16.211,5.3008 0.57031,0.41016 1.1289,0.85938 1.6719,1.3203 1.6914,1.4219 3.2109,3.0703 4.5,4.8789 0.42969,0.60156 0.83984,1.2109 1.2188,1.8398 1.3203,2.1602 2.3398,4.5117 3.0195,7 0.23828,-0.17188 0.42969,-0.30859 0.62891,-0.46875 0.64844,-0.48047 1.2109,-0.92188 1.7383,-1.3398 0.28125,-0.23047 0.5,-0.41016 0.71094,-0.57812 0.10156,-0.07813 0.19141,-0.16016 0.28125,-0.23828 -0.42969,-1.3516 -0.96094,-2.6484 -1.5898,-3.8984 -0.14062,-0.32812 -0.30859,-0.64844 -0.48047,-0.96875 -0.32812,-0.64844 -0.69922,-1.2891 -1.0898,-1.9102 -1.6797,-2.7109 -3.7695,-5.1406 -6.1719,-7.2188 -0.57031,-0.48828 -1.1484,-0.96875 -1.7617,-1.4102 -0.55859,-0.42188 -1.1406,-0.82812 -1.7305,-1.2109 -4.9414,-3.2188 -10.852,-5.0898 -17.16,-5.0898 -14.961,0 -27.531,10.469 -30.75,24.469 -0.17188,0.67969 -0.30859,1.3711 -0.42188,2.0703 -0.12891,0.73828 -0.21875,1.5 -0.28906,2.2617 -0.07813,0.91016 -0.12109,1.8398 -0.12109,2.7812 0,2.3008 0.25,4.5508 0.71875,6.7109 0.17188,0.71484 0.35156,1.4258 0.5625,2.125 z"
-     id="path4"
-     style="fill:#7c52e0;fill-opacity:1" />
-  <path
-     d="m 90.441615,21.60007 c -2.1797,-5.3398 -9.4102,-7.3984 -21,-6.0391 1.8906,1.8906 3.5391,3.9688 4.9297,6.2109 0.28906,0.46094 0.55859,0.92187 0.80859,1.3789 5.5391,-0.12109 7.6094,1.0391 7.8398,1.4492 0.12891,0.46875 -0.55078,2.7305 -4.5898,6.4805 -0.01953,0.01953 -0.03125,0.03125 -0.03906,0.03906 -0.26172,0.23828 -0.51953,0.48047 -0.80078,0.71875 -0.19922,0.17969 -0.41016,0.35938 -0.62891,0.53906 -0.10938,0.10156 -0.21875,0.19141 -0.33984,0.28906 -0.23828,0.19922 -0.5,0.41016 -0.76172,0.62109 -0.12891,0.10156 -0.26172,0.21094 -0.39844,0.32031 -0.42969,0.33984 -0.89063,0.69141 -1.3711,1.0508 -0.26953,0.21094 -0.53906,0.41016 -0.82812,0.60938 -0.32031,0.23047 -0.64062,0.46875 -0.98047,0.69922 0,0.01172 -0.01172,0.01172 -0.01172,0.01172 -0.26953,0.19141 -0.55078,0.37891 -0.82812,0.57031 -0.28125,0.19141 -0.55859,0.37109 -0.85156,0.55859 -0.25,0.16016 -0.5,0.32812 -0.76172,0.48828 -6,3.8984 -13.48,7.7188 -21.379,10.922 -8.0117,3.2383 -15.871,5.6602 -22.93,7.0391 -0.30078,0.05859 -0.60156,0.12109 -0.89062,0.17188 -0.60938,0.12109 -1.2188,0.21875 -1.8203,0.32031 -0.07031,0.01172 -0.12891,0.01953 -0.19922,0.03125 h -0.01953 c -0.28906,0.05078 -0.57031,0.08984 -0.83984,0.12891 -0.30859,0.05078 -0.60938,0.08984 -0.91016,0.12891 -0.57031,0.07813 -1.1094,0.14844 -1.6406,0.21094 -0.35156,0.03906 -0.69141,0.07031 -1.0195,0.10156 -0.30078,0.03125 -0.58984,0.05078 -0.87891,0.07813 -0.48047,0.03125 -0.92969,0.05859 -1.3711,0.07813 -0.39844,0.01953 -0.78125,0.03125 -1.1484,0.03906 -5.5116996,0.10938 -7.5702996,-1.0391 -7.8007996,-1.4492 -0.12891,-0.48047 0.55078,-2.7383 4.6093996,-6.5 -0.12891,-0.48828 -0.26172,-1 -0.37891,-1.5391 -0.51953,-2.4219 -0.78906,-4.8906 -0.78906,-7.3594 0,-0.17969 0,-0.37109 0.01172,-0.55078 -9.2733996,7.082 -13.0229996,13.59 -10.8749996,18.949 1.7383,4.2695 6.7188,6.4492 14.5899996,6.4492 2.8594,0 6.1016,-0.28906 9.7109,-0.87109 0.17188,-0.03125 0.33984,-0.05859 0.51953,-0.08984 0.17188,-0.03125 0.35156,-0.05859 0.51953,-0.08984 l 1.2188,-0.21875 c 0.57031,-0.10156 1.1484,-0.21875 1.7305,-0.33984 0.53125,-0.10938 1.0508,-0.21094 1.5781,-0.32812 0.01172,0 0.03125,-0.01172 0.03906,-0.01172 0.05078,-0.01172 0.08984,-0.01953 0.14062,-0.03125 0.07031,-0.01172 0.12891,-0.03125 0.19922,-0.05078 0.57812,-0.12891 1.1602,-0.26172 1.7383,-0.39844 0.05078,-0.01172 0.10156,-0.03125 0.14844,-0.03906 0.21094,-0.05078 0.42188,-0.10156 0.64062,-0.14844 h 0.01172 c 6.0898,-1.5117 12.559,-3.6406 19.102,-6.2891 6.5508,-2.6602 12.68,-5.6289 18.109,-8.7812 0.21875,-0.12891 0.44141,-0.26172 0.66016,-0.39062 0.58984,-0.33984 1.1797,-0.69141 1.7617,-1.0508 1.5703,-0.96094 3.0586,-1.9297 4.4805,-2.9102 0.12891,-0.08984 0.26172,-0.17969 0.39062,-0.26953 11.242,-7.8477 15.941,-15.09 13.594,-20.938 z"
-     id="path5"
-     style="fill:#7c52e0;fill-opacity:1" />
+    d="M13 2L3 14h8l-1 8 10-12h-8l1-8z"
+    fill="black"
+    stroke="black"
+    stroke-width="1.5"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+  />
 </svg>

public/manifest.webmanifest

@@ -1,11 +1,11 @@
 {
-  "name": "Ditto",
-  "short_name": "Ditto",
-  "description": "A carnival, not a platform. Color, whimsy, games, and endless customization — the most fun you've had on the internet in years.",
+  "name": "Agora",
+  "short_name": "Agora",
+  "description": "Power to the people. Organize, create, and connect across the open Nostr network.",
   "start_url": "/",
   "display": "standalone",
-  "background_color": "#161b2e",
-  "theme_color": "#7c3aed",
+  "background_color": "#0a0c14",
+  "theme_color": "#e85d3c",
   "icons": [
     {
       "src": "/icon-192.png",

public/sw.js

@@ -1,5 +1,5 @@
 /**
- * Ditto Service Worker
+ * Agora Service Worker
  *
  * Handles incoming Web Push notifications from the nostr-push server and
  * opens/focuses the app when the user taps a notification.
@@ -14,17 +14,17 @@ self.addEventListener('push', (event) => {
   try {
     payload = event.data.json();
   } catch {
-    payload = { title: 'Ditto', body: event.data.text() };
+    payload = { title: 'Agora', body: event.data.text() };
   }
 
-  const title = payload.title ?? 'Ditto';
+  const title = payload.title ?? 'Agora';
   const options = {
     body: payload.body ?? '',
     icon: payload.icon ?? '/icon-192.png',
     badge: payload.badge ?? '/icon-192.png',
     data: payload.data ?? {},
     requireInteraction: false,
-    tag: payload.data?.subscription_id ?? 'ditto-notification',
+    tag: payload.data?.subscription_id ?? 'agora-notification',
     renotify: true,
   };
 
@@ -42,7 +42,7 @@ self.addEventListener('notificationclick', (event) => {
     self.clients
       .matchAll({ type: 'window', includeUncontrolled: true })
       .then((clientList) => {
-        // Focus an existing Ditto tab if one is open
+        // Focus an existing Agora tab if one is open
         for (const client of clientList) {
           if (new URL(client.url).origin === self.location.origin) {
             client.navigate('/notifications');

public/theme.js

@@ -4,8 +4,8 @@
 (function () {
   // Builtin themes — must match builtinThemes in src/themes.ts
   var builtins = {
-    dark:  { bg: 'hsl(228 20% 10%)', primary: 'hsl(258 70% 60%)' },
-    light: { bg: 'hsl(270 50% 97%)', primary: 'hsl(270 65% 55%)' }
+    dark:  { bg: 'hsl(0 0% 10%)', primary: 'hsl(15 90% 52%)' },
+    light: { bg: 'hsl(0 0% 100%)', primary: 'hsl(15 90% 48%)' }
   };
 
   var theme = 'dark';

scripts/nip46-auth.mjs

@@ -33,7 +33,7 @@ function parseArgs() {
   const args = process.argv.slice(2);
   const result = {
     relays: [],
-    name: 'Ditto',
+    name: 'Agora',
     timeout: 300, // seconds
   };
 
@@ -54,9 +54,9 @@ function parseArgs() {
 
 Options:
   --relay <url>    Relay URL for NIP-46 communication (repeatable)
-                   Default: wss://relay.ditto.pub
+                   Default: wss://relay.agora.spot
   --name <name>    Application name shown to the signer
-                   Default: Ditto
+                   Default: Agora
   --timeout <sec>  How long to wait for signer approval (seconds)
                    Default: 300 (5 minutes)
   --help, -h       Show this help message
@@ -66,7 +66,7 @@ Options:
   }
 
   if (result.relays.length === 0) {
-    result.relays.push('wss://relay.ditto.pub');
+    result.relays.push('wss://relay.agora.spot');
   }
 
   return result;

scripts/patch-cap-config.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+/**
+ * Patch capacitor.config.json to include local (non-SPM) plugin classes.
+ *
+ * `npx cap sync` regenerates the `packageClassList` array from SPM packages
+ * only, so local plugins compiled directly into the app binary (like
+ * SandboxPlugin) are not included. This script appends them after sync so
+ * the Capacitor bridge eagerly registers them at startup.
+ *
+ * Usage: node scripts/patch-cap-config.mjs
+ * Typically run after `npx cap sync`.
+ */
+
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+
+/** Local plugin class names to ensure are registered. */
+const LOCAL_PLUGINS = ['SandboxPlugin', 'DittoNotificationPlugin'];
+
+const platforms = ['ios/App/App', 'android/app/src/main/assets'];
+
+for (const platform of platforms) {
+  const configPath = resolve(platform, 'capacitor.config.json');
+
+  let config;
+  try {
+    config = JSON.parse(readFileSync(configPath, 'utf-8'));
+  } catch {
+    // Platform may not exist or config not yet generated — skip.
+    continue;
+  }
+
+  const classList = new Set(config.packageClassList ?? []);
+  let changed = false;
+
+  for (const plugin of LOCAL_PLUGINS) {
+    if (!classList.has(plugin)) {
+      classList.add(plugin);
+      changed = true;
+    }
+  }
+
+  if (changed) {
+    config.packageClassList = [...classList];
+    writeFileSync(configPath, JSON.stringify(config, null, '\t') + '\n');
+    console.log(`Patched ${configPath}: added ${LOCAL_PLUGINS.join(', ')}`);
+  }
+}

src/App.tsx

@@ -1,15 +1,14 @@
 // NOTE: This file should normally not be modified unless you are adding a new provider.
 // To add new routes, edit the AppRouter.tsx file.
 
-import { Capacitor } from "@capacitor/core";
-import { StatusBar, Style } from "@capacitor/status-bar";
+import { Capacitor, SystemBars, SystemBarsStyle } from "@capacitor/core";
 import { NostrLoginProvider } from "@nostrify/react/login";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { InferSeoMetaPlugin } from "@unhead/addons";
 import { createHead, UnheadProvider } from "@unhead/react/client";
 import { useEffect } from "react";
 import { AppProvider } from "@/components/AppProvider";
-import { DMProvider, type DMConfig } from "@/components/DMProvider";
+import { DMProviderWrapper } from "@/components/DMProviderWrapper";
 import { InitialSyncGate } from "@/components/InitialSyncGate";
 import { NativeNotifications } from "@/components/NativeNotifications";
 import NostrProvider from "@/components/NostrProvider";
@@ -22,16 +21,12 @@ import { TooltipProvider } from "@/components/ui/tooltip";
 import { useNsecPasteGuard } from "@/hooks/useNsecPasteGuard";
 import type { AppConfig } from "@/contexts/AppContext";
 import { NWCProvider } from "@/contexts/NWCContext";
-import { PROTOCOL_MODE } from "@/lib/dmConstants";
-import { DittoConfigSchema, type DittoConfig } from "@/lib/schemas";
-import { EmotionDevProvider } from "@/blobbi/dev/EmotionDevContext";
+import { SparkWalletProvider } from "@/contexts/SparkWalletContext";
+import { BuildConfigSchema, type BuildConfig } from "@/lib/schemas";
+import { secureStorage } from "@/lib/secureStorage";
+import { PROTOCOL_MODE } from "@samthomson/nostr-messaging/core";
 import AppRouter from "./AppRouter";
 
-const dmConfig: DMConfig = {
-  enabled: false,
-  protocolMode: PROTOCOL_MODE.NIP04_OR_NIP17,
-};
-
 const head = createHead({
   plugins: [InferSeoMetaPlugin()],
 });
@@ -48,12 +43,12 @@ const queryClient = new QueryClient({
 
 /** Hardcoded fallback values. Always provides every required field. */
 const hardcodedConfig: AppConfig = {
-  appName: "Ditto",
-  appId: "ditto",
+  appName: "Agora",
+  appId: "agora",
   homePage: "feed",
+  client: "naddr1qvzqqqru7cpzq7q6z5ns2hm5c8msyv83qwzxpxe52j8c4d4q5m92wsp9sflelkh9qqzkg6t5w3hswjl4yp",
   magicMouse: false,
   theme: "system",
-  autoShareTheme: true,
   useAppRelays: true,
   relayMetadata: {
     relays: [],
@@ -90,13 +85,6 @@ const hardcodedConfig: AppConfig = {
     showVideos: true,
     feedIncludeNormalVideos: true,
     feedIncludeShortVideos: true,
-    showProfileThemes: false,
-    feedIncludeProfileThemes: true,
-    showThemeDefinitions: true,
-    feedIncludeThemeDefinitions: true,
-    showProfileThemeUpdates: true,
-    feedIncludeProfileThemeUpdates: true,
-    showCustomProfileThemes: true,
     feedIncludeVoiceMessages: true,
     showEmojiPacks: true,
     feedIncludeEmojiPacks: true,
@@ -110,26 +98,29 @@ const hardcodedConfig: AppConfig = {
     feedIncludePodcastTrailers: true,
     showDevelopment: true,
     feedIncludeDevelopment: true,
+    showCommunities: true,
+    feedIncludeCommunities: true,
     showBadges: true,
     showBadgeDefinitions: true,
     showProfileBadges: true,
     feedIncludeBadgeDefinitions: true,
     feedIncludeProfileBadges: true,
     feedIncludeVanish: true,
-    feedIncludeBlobbi: true,
     followsFeedShowReplies: true,
   },
   sidebarOrder: [
+    "wallet",
+    "verified",
+    "actions",
+    "polls",
+    "world",
+    "badges",
     "feed",
     "notifications",
-    "search",
-    "themes",
-    "letters",
-    "badges",
-    "blobbi",
-    "theme",
+    "messages",
+    "communities",
+    "profile",
     "settings",
-    "help",
   ],
   nip85StatsPubkey:
     "5f68e85ee174102ca8978eef302129f081f03456c884185d5ec1c1224ab633ea",
@@ -148,45 +139,65 @@ const hardcodedConfig: AppConfig = {
   plausibleEndpoint: import.meta.env.VITE_PLAUSIBLE_ENDPOINT || "",
   savedFeeds: [],
   imageQuality: 'compressed',
+  curatorPubkey: '932614571afcbad4d17a191ee281e39eebbb41b93fac8fd87829622aeb112f4d',
+  sandboxDomain: 'iframe.diy',
+  sidebarWidgets: [
+    { id: 'trends' },
+    { id: 'hot-posts' },
+    { id: 'ai-chat' },
+  ],
+  messaging: {
+    enabled: true,
+    relayMode: 'hybrid',
+    protocolMode: PROTOCOL_MODE.NIP17_ONLY,
+    renderInlineMedia: true,
+    soundEnabled: false,
+    devMode: false,
+  },
+  aiBaseURL: 'https://ai.shakespeare.diy/v1',
+  aiApiKey: '',
+  aiModel: 'grok-4.1-fast',
+  aiSystemPrompt: '',
 };
 
 /**
- * Parse and validate build-time ditto.json overrides from the env string.
+ * Parse and validate build-time app config overrides from the env string.
  * Returns an empty object when no config file was provided or validation fails.
  */
-function parseDittoConfig(): DittoConfig {
+function parseBuildConfig(): BuildConfig {
   try {
-    const json = JSON.parse(import.meta.env.DITTO_CONFIG);
+    const encodedConfig = import.meta.env.APP_CONFIG ?? import.meta.env.DITTO_CONFIG;
+    const json = JSON.parse(encodedConfig);
     if (!json) return {};
-    return DittoConfigSchema.parse(json);
+    return BuildConfigSchema.parse(json);
   } catch {
     return {};
   }
 }
 
 /**
- * Merge hardcoded defaults with build-time ditto.json overrides.
+ * Merge hardcoded defaults with build-time config overrides.
  * Deep-merges feedSettings so a partial override doesn't erase defaults.
  * Precedence (handled by AppProvider): user localStorage > build-time > hardcoded.
  */
-const dittoConfig = parseDittoConfig();
+const buildConfig = parseBuildConfig();
 const defaultConfig: AppConfig = {
   ...hardcodedConfig,
-  ...dittoConfig,
-  feedSettings: { ...hardcodedConfig.feedSettings, ...dittoConfig.feedSettings },
+  ...buildConfig,
+  feedSettings: { ...hardcodedConfig.feedSettings, ...buildConfig.feedSettings },
 };
 
 export function App() {
   useNsecPasteGuard();
 
   useEffect(() => {
-    // Initialize StatusBar for mobile apps
+    // Initialize system bars for mobile apps.
+    // On Android 16+ (API 36), edge-to-edge is enforced by the OS so
+    // setOverlaysWebView / setBackgroundColor no longer work. The new
+    // SystemBars API (bundled with @capacitor/core 8+) is the replacement.
     if (Capacitor.isNativePlatform()) {
-      StatusBar.setStyle({ style: Style.Dark }).catch(() => {
-        // StatusBar may not be available on all platforms
-      });
-      StatusBar.setOverlaysWebView({ overlay: true }).catch(() => {
-        // Ignore errors on unsupported platforms
+      SystemBars.setStyle({ style: SystemBarsStyle.Dark }).catch(() => {
+        // SystemBars may not be available on all platforms
       });
     }
   }, []);
@@ -197,21 +208,21 @@ export function App() {
         <SentryProvider>
           <PlausibleProvider>
             <QueryClientProvider client={queryClient}>
-              <NostrLoginProvider storageKey="nostr:login">
+              <NostrLoginProvider storageKey="nostr:login" storage={secureStorage}>
                 <NostrProvider>
                   <NostrSync />
                   <NativeNotifications />
 
                     <NWCProvider>
-                    <DMProvider config={dmConfig}>
-                      <EmotionDevProvider>
-                        <TooltipProvider>
-                          <InitialSyncGate>
-                            <AppRouter />
-                          </InitialSyncGate>
-                        </TooltipProvider>
-                      </EmotionDevProvider>
-                    </DMProvider>
+                    <SparkWalletProvider>
+                    <DMProviderWrapper>
+                      <TooltipProvider>
+                        <InitialSyncGate>
+                          <AppRouter />
+                        </InitialSyncGate>
+                      </TooltipProvider>
+                    </DMProviderWrapper>
+                    </SparkWalletProvider>
                   </NWCProvider>
                 </NostrProvider>
               </NostrLoginProvider>

src/AppRouter.tsx

@@ -4,7 +4,6 @@ import { AudioNavigationGuard } from "@/components/AudioNavigationGuard";
 import { DeepLinkHandler } from "@/components/DeepLinkHandler";
 import { MinimizedAudioBar } from "@/components/MinimizedAudioBar";
 import { AudioPlayerProvider } from "@/contexts/AudioPlayerContext";
-import { BlobbiActionsProvider } from "@/blobbi/companion/interaction/BlobbiActionsProvider";
 import { sidebarItemIcon } from "@/lib/sidebarItems";
 import { Toaster } from "./components/ui/toaster";
 import { MainLayout } from "./components/MainLayout";
@@ -17,29 +16,22 @@ import { getExtraKindDef } from "./lib/extraKinds";
 // Critical-path pages: eagerly loaded (landing + fallback)
 import Index from "./pages/Index";
 import NotFound from "./pages/NotFound";
-
-// Lazy-loaded companion layer (~450K code-split)
-const BlobbiCompanionLayer = lazy(() => import("@/blobbi/companion").then(m => ({ default: m.BlobbiCompanionLayer })));
+import MessagesPage from "./pages/Messages";
 
 // Lazy-loaded compose modal (pulls in emoji-mart ~620K)
 const ReplyComposeModal = lazy(() => import("@/components/ReplyComposeModal").then(m => ({ default: m.ReplyComposeModal })));
 
-// Lazy-loaded emoji pack dialog
-const EmojiPackDialog = lazy(() => import("@/components/EmojiPackDialog").then(m => ({ default: m.EmojiPackDialog })));
-
 // HomePage eagerly imported all page components; now lazy-loaded
 const HomePage = lazy(() => import("./pages/HomePage").then(m => ({ default: m.HomePage })));
 
 // All other pages: code-split via React.lazy
+const ActionsPage = lazy(() => import("./pages/ActionsPage"));
 const AdvancedSettingsPage = lazy(() => import("./pages/AdvancedSettingsPage").then(m => ({ default: m.AdvancedSettingsPage })));
-const AIChatPage = lazy(() => import("./pages/AIChatPage").then(m => ({ default: m.AIChatPage })));
-const ArchivePage = lazy(() => import("./pages/ArchivePage").then(m => ({ default: m.ArchivePage })));
+const AppearanceSettingsPage = lazy(() => import("./pages/AppearanceSettingsPage").then(m => ({ default: m.AppearanceSettingsPage })));
 const ArticleEditorPage = lazy(() => import("./pages/ArticleEditorPage").then(m => ({ default: m.ArticleEditorPage })));
 const BadgesPage = lazy(() => import("./pages/BadgesPage").then(m => ({ default: m.BadgesPage })));
-const BlobbiPage = lazy(() => import("./pages/BlobbiPage").then(m => ({ default: m.BlobbiPage })));
-const BlueskyPage = lazy(() => import("./pages/BlueskyPage").then(m => ({ default: m.BlueskyPage })));
+const CommunitiesPage = lazy(() => import("./pages/CommunitiesPage").then(m => ({ default: m.CommunitiesPage })));
 const BookmarksPage = lazy(() => import("./pages/BookmarksPage").then(m => ({ default: m.BookmarksPage })));
-const BooksPage = lazy(() => import("./pages/BooksPage").then(m => ({ default: m.BooksPage })));
 const ChangelogPage = lazy(() => import("./pages/ChangelogPage").then(m => ({ default: m.ChangelogPage })));
 const ContentPage = lazy(() => import("./pages/ContentPage").then(m => ({ default: m.ContentPage })));
 const ContentSettingsPage = lazy(() => import("./pages/ContentSettingsPage").then(m => ({ default: m.ContentSettingsPage })));
@@ -55,37 +47,29 @@ const LetterComposePage = lazy(() => import("./pages/LetterComposePage").then(m
 const LetterPreferencesPage = lazy(() => import("./pages/LetterPreferencesPage").then(m => ({ default: m.LetterPreferencesPage })));
 const LettersPage = lazy(() => import("./pages/LettersPage").then(m => ({ default: m.LettersPage })));
 const MagicSettingsPage = lazy(() => import("./pages/MagicSettingsPage").then(m => ({ default: m.MagicSettingsPage })));
-const MusicFeedPage = lazy(() => import("./pages/MusicFeedPage").then(m => ({ default: m.MusicFeedPage })));
+const MessagingSettingsPage = lazy(() => import("./pages/MessagingSettingsPage").then(m => ({ default: m.MessagingSettingsPage })));
 const NetworkSettingsPage = lazy(() => import("./pages/NetworkSettingsPage").then(m => ({ default: m.NetworkSettingsPage })));
 const NIP19Page = lazy(() => import("./pages/NIP19Page").then(m => ({ default: m.NIP19Page })));
 const NotificationSettings = lazy(() => import("./pages/NotificationSettings").then(m => ({ default: m.NotificationSettings })));
 const NotificationsPage = lazy(() => import("./pages/NotificationsPage").then(m => ({ default: m.NotificationsPage })));
+const AIChatPage = lazy(() => import("./pages/AIChatPage").then(m => ({ default: m.AIChatPage })));
+const OrganizersPage = lazy(() => import("./pages/OrganizersPage").then(m => ({ default: m.OrganizersPage })));
 const PhotosFeedPage = lazy(() => import("./pages/PhotosFeedPage").then(m => ({ default: m.PhotosFeedPage })));
-const PodcastsFeedPage = lazy(() => import("./pages/PodcastsFeedPage").then(m => ({ default: m.PodcastsFeedPage })));
 const PrivacyPolicyPage = lazy(() => import("./pages/PrivacyPolicyPage").then(m => ({ default: m.PrivacyPolicyPage })));
 const ProfileSettings = lazy(() => import("./pages/ProfileSettings").then(m => ({ default: m.ProfileSettings })));
 const RelayPage = lazy(() => import("./pages/RelayPage").then(m => ({ default: m.RelayPage })));
 const SearchPage = lazy(() => import("./pages/SearchPage").then(m => ({ default: m.SearchPage })));
 const SettingsPage = lazy(() => import("./pages/SettingsPage").then(m => ({ default: m.SettingsPage })));
-const ThemesPage = lazy(() => import("./pages/ThemesPage").then(m => ({ default: m.ThemesPage })));
-const TreasuresPage = lazy(() => import("./pages/TreasuresPage").then(m => ({ default: m.TreasuresPage })));
-const TrendsPage = lazy(() => import("./pages/TrendsPage").then(m => ({ default: m.TrendsPage })));
 const UserListsPage = lazy(() => import("./pages/UserListsPage").then(m => ({ default: m.UserListsPage })));
-const VideosFeedPage = lazy(() => import("./pages/VideosFeedPage").then(m => ({ default: m.VideosFeedPage })));
-const VinesFeedPage = lazy(() => import("./pages/VinesFeedPage").then(m => ({ default: m.VinesFeedPage })));
 const WalletSettingsPage = lazy(() => import("./pages/WalletSettingsPage").then(m => ({ default: m.WalletSettingsPage })));
-const WebxdcFeedPage = lazy(() => import("./pages/WebxdcFeedPage").then(m => ({ default: m.WebxdcFeedPage })));
-const WikipediaPage = lazy(() => import("./pages/WikipediaPage").then(m => ({ default: m.WikipediaPage })));
+const WalletPage = lazy(() => import("./pages/WalletPage").then(m => ({ default: m.WalletPage })));
 const WorldPage = lazy(() => import("./pages/WorldPage").then(m => ({ default: m.WorldPage })));
+const VerifiedPage = lazy(() => import("./pages/VerifiedPage").then(m => ({ default: m.VerifiedPage })));
+const FollowPage = lazy(() => import("./pages/FollowPage").then(m => ({ default: m.FollowPage })));
 const RemoteLoginSuccessPage = lazy(() => import("./pages/RemoteLoginSuccessPage").then(m => ({ default: m.RemoteLoginSuccessPage })));
 
 const pollsDef = getExtraKindDef("polls")!;
-const colorsDef = getExtraKindDef("colors")!;
-const packsDef = getExtraKindDef("packs")!;
 const articlesDef = getExtraKindDef("articles")!;
-const decksDef = getExtraKindDef("decks")!;
-const emojisDef = getExtraKindDef("emojis")!;
-const developmentDef = getExtraKindDef("development")!;
 
 /** Polls feed page with a FAB that opens the compose modal (poll mode via + menu). */
 function PollsFeedPage() {
@@ -107,26 +91,6 @@ function PollsFeedPage() {
   );
 }
 
-/** Emoji feed page with a FAB that opens the emoji pack creation dialog. */
-function EmojiFeedPage() {
-  const [composeOpen, setComposeOpen] = useState(false);
-  return (
-    <>
-      <KindFeedPage
-        kind={emojisDef.kind}
-        title={emojisDef.label}
-        icon={sidebarItemIcon("emojis", "size-5")}
-        onFabClick={() => setComposeOpen(true)}
-      />
-      {composeOpen && (
-        <Suspense fallback={null}>
-          <EmojiPackDialog open={composeOpen} onOpenChange={setComposeOpen} />
-        </Suspense>
-      )}
-    </>
-  );
-}
-
 /** Redirects /profile to the user's canonical profile URL (nip05 or npub). */
 function ProfileRedirect() {
   const { user, metadata } = useCurrentUser();
@@ -145,24 +109,23 @@ export function AppRouter() {
         <AudioNavigationGuard />
         <DeepLinkHandler />
         <ScrollToTop />
-        <BlobbiActionsProvider>
-          <Suspense fallback={null}>
-            <BlobbiCompanionLayer />
-          </Suspense>
-        </BlobbiActionsProvider>
         <Routes>
+          {/* Auto-follow deep link: fullscreen immersive (no sidebars/nav) */}
+          <Route path="/follow/:npub" element={<FollowPage />} />
+
           {/* All routes share the persistent MainLayout (sidebar + nav) */}
           <Route element={<MainLayout />}>
             <Route path="/" element={<HomePage />} />
             <Route path="/feed" element={<Index />} />
             <Route path="/notifications" element={<NotificationsPage />} />
+            <Route path="/messages" element={<MessagesPage />} />
             <Route path="/search" element={<SearchPage />} />
-            <Route path="/trends" element={<TrendsPage />} />
             <Route path="/profile" element={<ProfileRedirect />} />
              <Route path="/t/:tag" element={<HashtagPage />} />
              <Route path="/g/:geohash" element={<GeotagPage />} />
             <Route path="/feed/:domain" element={<DomainFeedPage />} />
             <Route path="/settings" element={<SettingsPage />} />
+            <Route path="/settings/appearance" element={<AppearanceSettingsPage />} />
             <Route path="/settings/profile" element={<ProfileSettings />} />
             <Route path="/settings/feed" element={<ContentSettingsPage />} />
             <Route path="/settings/content" element={<ContentPage />} />
@@ -171,6 +134,7 @@ export function AppRouter() {
               path="/settings/notifications"
               element={<NotificationSettings />}
             />
+            <Route path="/settings/messaging" element={<MessagingSettingsPage />} />
             <Route
               path="/settings/advanced"
               element={<AdvancedSettingsPage />}
@@ -180,38 +144,7 @@ export function AppRouter() {
             <Route path="/lists" element={<UserListsPage />} />
             <Route path="/events" element={<EventsFeedPage />} />
             <Route path="/photos" element={<PhotosFeedPage />} />
-            <Route path="/videos" element={<VideosFeedPage />} />
-            {/* /streams redirects to /videos for backward compatibility */}
-            <Route
-              path="/streams"
-              element={<Navigate to="/videos" replace />}
-            />
-            <Route path="/vines" element={<VinesFeedPage />} />
-            <Route path="/music" element={<MusicFeedPage />} />
-            <Route path="/podcasts" element={<PodcastsFeedPage />} />
             <Route path="/polls" element={<PollsFeedPage />} />
-            <Route path="/treasures" element={<TreasuresPage />} />
-            <Route
-              path="/colors"
-              element={
-                <KindFeedPage
-                  kind={colorsDef.kind}
-                  title={colorsDef.label}
-                  icon={sidebarItemIcon("colors", "size-5")}
-                />
-              }
-            />
-            <Route
-              path="/packs"
-              element={
-                <KindFeedPage
-                  kind={packsDef.kind}
-                  title={packsDef.label}
-                  icon={sidebarItemIcon("packs", "size-5")}
-                />
-              }
-            />
-            <Route path="/webxdc" element={<WebxdcFeedPage />} />
             <Route path="/articles/new" element={<ArticleEditorPage />} />
             <Route path="/articles/edit/:naddr" element={<ArticleEditorPage />} />
             <Route
@@ -225,41 +158,12 @@ export function AppRouter() {
                 />
               }
             />
-            <Route
-              path="/decks"
-              element={
-                <KindFeedPage
-                  kind={decksDef.kind}
-                  title={decksDef.label}
-                  icon={sidebarItemIcon("decks", "size-5")}
-                />
-              }
-            />
-            <Route path="/emojis" element={<EmojiFeedPage />} />
-            <Route
-              path="/development"
-              element={
-                <KindFeedPage
-                  kind={[
-                    developmentDef.kind,
-                    ...(developmentDef.extraFeedKinds ?? []),
-                  ]}
-                  title={developmentDef.label}
-                  icon={sidebarItemIcon("development", "size-5")}
-                  showFAB={false}
-                />
-              }
-            />
-            <Route path="/themes" element={<ThemesPage />} />
             <Route path="/bookmarks" element={<BookmarksPage />} />
-            <Route path="/ai-chat" element={<AIChatPage />} />
-            <Route path="/blobbi" element={<BlobbiPage />} />
+            <Route path="/wallet" element={<WalletPage />} />
+            <Route path="/verified" element={<VerifiedPage />} />
             <Route path="/world" element={<WorldPage />} />
             <Route path="/badges" element={<BadgesPage />} />
-            <Route path="/books" element={<BooksPage />} />
-            <Route path="/archive" element={<ArchivePage />} />
-            <Route path="/bluesky" element={<BlueskyPage />} />
-            <Route path="/wikipedia" element={<WikipediaPage />} />
+            <Route path="/communities" element={<CommunitiesPage />} />
             <Route path="/letters" element={<LettersPage />} />
             <Route path="/letters/compose" element={<LetterComposePage />} />
             <Route path="/settings/letters" element={<LetterPreferencesPage />} />
@@ -273,6 +177,9 @@ export function AppRouter() {
               element={<Navigate to="/lists" replace />}
             />
             <Route path="/i/*" element={<ExternalContentPage />} />
+            <Route path="/actions" element={<ActionsPage />} />
+            <Route path="/agent" element={<AIChatPage />} />
+            <Route path="/organizers" element={<OrganizersPage />} />
 
             {/* Callback target for remote signers (e.g. Amber, Primal) after NIP-46 approval */}
             <Route path="/remoteloginsuccess" element={<RemoteLoginSuccessPage />} />

src/blobbi/actions/components/BlobbiActionInventoryModal.tsx

@@ -1,614 +0,0 @@
-// src/blobbi/actions/components/BlobbiActionInventoryModal.tsx
-
-import { useMemo, useState } from 'react';
-import { Loader2, ShoppingBag, Minus, Plus, X } from 'lucide-react';
-
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogFooter,
-  DialogClose,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { Badge } from '@/components/ui/badge';
-import { Input } from '@/components/ui/input';
-
-import type { BlobbiCompanion, BlobbonautProfile } from '@/blobbi/core/lib/blobbi';
-import { cn } from '@/lib/utils';
-
-import {
-  filterInventoryByAction,
-  previewStatChanges,
-  previewMedicineForEgg,
-  previewCleanForEgg,
-  canUseAction,
-  getStageRestrictionMessage,
-  ACTION_METADATA,
-  type InventoryAction,
-  type ResolvedInventoryItem,
-  type EggStatPreview,
-} from '../lib/blobbi-action-utils';
-
-interface BlobbiActionInventoryModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  action: InventoryAction;
-  companion: BlobbiCompanion;
-  profile: BlobbonautProfile | null;
-  /** Called when user confirms using item(s). Now accepts quantity. */
-  onUseItem: (itemId: string, quantity: number) => void;
-  onOpenShop: () => void;
-  isUsingItem: boolean;
-  usingItemId: string | null;
-}
-
-export function BlobbiActionInventoryModal({
-  open,
-  onOpenChange,
-  action,
-  companion,
-  profile,
-  onUseItem,
-  onOpenShop,
-  isUsingItem,
-  usingItemId,
-}: BlobbiActionInventoryModalProps) {
-  const actionMeta = ACTION_METADATA[action];
-  
-  // State for confirmation dialog
-  const [selectedItem, setSelectedItem] = useState<ResolvedInventoryItem | null>(null);
-  const [quantity, setQuantity] = useState(1);
-  const [showConfirmDialog, setShowConfirmDialog] = useState(false);
-
-  // Filter inventory by action type, respecting egg-compatible effects
-  const availableItems = useMemo(() => {
-    if (!profile) return [];
-    return filterInventoryByAction(profile.storage, action, { stage: companion.stage });
-  }, [profile, action, companion.stage]);
-
-  // Check stage restrictions for this specific action
-  const canUse = canUseAction(companion, action);
-  const stageMessage = getStageRestrictionMessage(companion, action);
-
-  const isEmpty = availableItems.length === 0;
-
-  const handleSelectItem = (item: ResolvedInventoryItem) => {
-    if (isUsingItem) return;
-    setSelectedItem(item);
-    setQuantity(1);
-    setShowConfirmDialog(true);
-  };
-
-  const handleConfirmUse = () => {
-    if (!selectedItem || isUsingItem) return;
-    onUseItem(selectedItem.itemId, quantity);
-    // Reset after starting use
-    setShowConfirmDialog(false);
-    setSelectedItem(null);
-    setQuantity(1);
-  };
-
-  const handleCloseConfirmDialog = (isOpen: boolean) => {
-    if (!isOpen) {
-      setShowConfirmDialog(false);
-      setSelectedItem(null);
-      setQuantity(1);
-    }
-  };
-
-  const handleOpenShop = () => {
-    onOpenChange(false);
-    onOpenShop();
-  };
-
-  // Quantity controls
-  const maxQuantity = selectedItem?.quantity ?? 1;
-  const handleIncrease = () => setQuantity(q => Math.min(q + 1, maxQuantity));
-  const handleDecrease = () => setQuantity(q => Math.max(q - 1, 1));
-  const handleQuantityInput = (e: React.ChangeEvent<HTMLInputElement>) => {
-    const value = parseInt(e.target.value, 10);
-    if (isNaN(value) || value < 1) {
-      setQuantity(1);
-    } else {
-      setQuantity(Math.min(value, maxQuantity));
-    }
-  };
-
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="max-w-md w-[calc(100%-2rem)] max-h-[85vh] flex flex-col p-0 gap-0 [&>button:last-child]:hidden">
-        {/* Header - Sticky */}
-        <DialogHeader className="sticky top-0 z-10 bg-background px-4 sm:px-6 pt-4 sm:pt-6 pb-3 sm:pb-4 border-b">
-          <div className="flex items-start justify-between gap-3">
-            <div className="flex items-center gap-3 min-w-0">
-              <div className="size-9 sm:size-10 rounded-xl bg-gradient-to-br from-primary/20 to-primary/5 flex items-center justify-center text-xl sm:text-2xl shrink-0">
-                {actionMeta.icon}
-              </div>
-              <div className="min-w-0">
-                <DialogTitle className="text-lg sm:text-xl">{actionMeta.label}</DialogTitle>
-                <p className="text-xs sm:text-sm text-muted-foreground truncate">
-                  {actionMeta.description}
-                </p>
-              </div>
-            </div>
-            <DialogClose className="rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 shrink-0">
-              <X className="size-5" />
-              <span className="sr-only">Close</span>
-            </DialogClose>
-          </div>
-        </DialogHeader>
-
-        {/* Content - Scrollable */}
-        <div className="flex-1 min-h-0 overflow-y-auto px-4 sm:px-6 py-3 sm:py-4">
-          {/* Stage Restriction Message */}
-          {!canUse && stageMessage && (
-            <div className="flex flex-col items-center justify-center py-12 text-center">
-              <div className="size-16 rounded-2xl bg-amber-500/10 flex items-center justify-center mb-4">
-                <span className="text-3xl">🥚</span>
-              </div>
-              <h3 className="text-lg font-semibold mb-2">Not Available</h3>
-              <p className="text-sm text-muted-foreground max-w-sm">
-                {stageMessage}
-              </p>
-            </div>
-          )}
-
-          {/* Empty State */}
-          {canUse && isEmpty && (
-            <div className="flex flex-col items-center justify-center py-12 text-center">
-              <div className="size-16 rounded-2xl bg-muted/50 flex items-center justify-center mb-4">
-                <span className="text-3xl">{actionMeta.icon}</span>
-              </div>
-              <h3 className="text-lg font-semibold mb-2">No Items</h3>
-              <p className="text-sm text-muted-foreground max-w-sm mb-4">
-                You don't have any items for this action. Visit the shop to get some!
-              </p>
-              <Button onClick={handleOpenShop} className="gap-2">
-                <ShoppingBag className="size-4" />
-                Open Shop
-              </Button>
-            </div>
-          )}
-
-          {/* Item List */}
-          {canUse && !isEmpty && (
-            <div className="grid gap-3">
-              {availableItems.map((item) => (
-                <BlobbiInventoryUseRow
-                  key={item.itemId}
-                  item={item}
-                  companion={companion}
-                  action={action}
-                  onUse={() => handleSelectItem(item)}
-                  isUsing={isUsingItem && usingItemId === item.itemId}
-                  disabled={isUsingItem}
-                />
-              ))}
-            </div>
-          )}
-        </div>
-      </DialogContent>
-
-      {/* Confirmation Dialog with Quantity Selector */}
-      {selectedItem && (
-        <BlobbiUseItemConfirmDialog
-          open={showConfirmDialog}
-          onOpenChange={handleCloseConfirmDialog}
-          item={selectedItem}
-          companion={companion}
-          action={action}
-          quantity={quantity}
-          maxQuantity={maxQuantity}
-          onIncrease={handleIncrease}
-          onDecrease={handleDecrease}
-          onQuantityChange={handleQuantityInput}
-          onConfirm={handleConfirmUse}
-          isUsing={isUsingItem}
-        />
-      )}
-    </Dialog>
-  );
-}
-
-// ─── Inventory Use Row ────────────────────────────────────────────────────────
-
-interface BlobbiInventoryUseRowProps {
-  item: ResolvedInventoryItem;
-  companion: BlobbiCompanion;
-  action: InventoryAction;
-  onUse: () => void;
-  isUsing: boolean;
-  disabled: boolean;
-}
-
-function BlobbiInventoryUseRow({
-  item,
-  companion,
-  action,
-  onUse,
-  isUsing,
-  disabled,
-}: BlobbiInventoryUseRowProps) {
-  const isEgg = companion.stage === 'egg';
-  const isMedicine = action === 'medicine';
-  const isClean = action === 'clean';
-
-  // Preview stat changes - handle egg-specific preview for medicine and clean
-  const { normalStatChanges, eggStatChanges } = useMemo(() => {
-    if (isEgg && isMedicine) {
-      // For eggs using medicine, show health preview
-      // Eggs use the 3-stat model: health, hygiene, happiness
-      return {
-        normalStatChanges: [],
-        eggStatChanges: previewMedicineForEgg(companion.stats.health, item.effect),
-      };
-    }
-    if (isEgg && isClean) {
-      // For eggs using hygiene items, show hygiene (and possibly happiness) preview
-      return {
-        normalStatChanges: [],
-        eggStatChanges: previewCleanForEgg(
-          { hygiene: companion.stats.hygiene, happiness: companion.stats.happiness },
-          item.effect
-        ),
-      };
-    }
-    // Normal stats preview
-    return {
-      normalStatChanges: previewStatChanges(companion.stats, item.effect),
-      eggStatChanges: [] as EggStatPreview[],
-    };
-  }, [companion.stats, item.effect, isEgg, isMedicine, isClean]);
-
-  const hasChanges = normalStatChanges.length > 0 || eggStatChanges.length > 0;
-
-  return (
-    <div className="flex flex-col sm:flex-row sm:items-center gap-3 sm:gap-4 p-3 sm:p-4 rounded-xl border bg-card/60 backdrop-blur-sm hover:border-primary/30 transition-colors">
-      {/* Top row on mobile: Icon + Info + Button */}
-      <div className="flex items-center gap-3 sm:contents">
-        {/* Item Icon */}
-        <div className="relative shrink-0">
-          <div className="absolute inset-0 bg-gradient-to-br from-primary/20 to-primary/5 rounded-full blur-xl" />
-          <div className="relative size-10 sm:size-14 rounded-full bg-gradient-to-br from-primary/10 to-primary/5 flex items-center justify-center text-2xl sm:text-3xl">
-            {item.icon}
-          </div>
-        </div>
-
-        {/* Item Info */}
-        <div className="flex-1 min-w-0">
-          <div className="flex items-center gap-2 mb-0.5 sm:mb-1">
-            <h3 className="font-semibold text-sm sm:text-base truncate">{item.name}</h3>
-            <Badge variant="secondary" className="text-xs shrink-0">
-              x{item.quantity}
-            </Badge>
-          </div>
-
-          {/* Effect Preview - shown inline on desktop */}
-          <div className="hidden sm:block">
-            {hasChanges && (
-              <div className="flex flex-wrap gap-x-3 gap-y-1">
-                {/* Normal stat changes */}
-                {normalStatChanges.map(({ stat, delta }) => (
-                  <span key={stat} className="text-xs">
-                    <span
-                      className={cn(
-                        'font-medium',
-                        delta > 0
-                          ? 'text-emerald-600 dark:text-emerald-400'
-                          : 'text-red-600 dark:text-red-400'
-                      )}
-                    >
-                      {delta > 0 ? '+' : ''}
-                      {delta}
-                    </span>{' '}
-                    <span className="text-muted-foreground capitalize">
-                      {stat.replace('_', ' ')}
-                    </span>
-                  </span>
-                ))}
-                {/* Egg stat changes (health for medicine) */}
-                {eggStatChanges.map(({ stat, delta }) => (
-                  <span key={stat} className="text-xs">
-                    <span
-                      className={cn(
-                        'font-medium',
-                        delta > 0
-                          ? 'text-emerald-600 dark:text-emerald-400'
-                          : 'text-red-600 dark:text-red-400'
-                      )}
-                    >
-                      {delta > 0 ? '+' : ''}
-                      {delta}
-                    </span>{' '}
-                    <span className="text-muted-foreground capitalize">
-                      {stat.replace('_', ' ')}
-                    </span>
-                  </span>
-                ))}
-              </div>
-            )}
-          </div>
-        </div>
-
-        {/* Use Button */}
-        <Button
-          size="sm"
-          onClick={onUse}
-          disabled={disabled}
-          className="shrink-0"
-        >
-          {isUsing ? (
-            <Loader2 className="size-4 animate-spin" />
-          ) : (
-            'Use'
-          )}
-        </Button>
-      </div>
-
-      {/* Effect Preview - shown below on mobile */}
-      {hasChanges && (
-        <div className="sm:hidden flex flex-wrap gap-x-3 gap-y-1 pl-13">
-          {/* Normal stat changes */}
-          {normalStatChanges.map(({ stat, delta }) => (
-            <span key={stat} className="text-xs">
-              <span
-                className={cn(
-                  'font-medium',
-                  delta > 0
-                    ? 'text-emerald-600 dark:text-emerald-400'
-                    : 'text-red-600 dark:text-red-400'
-                )}
-              >
-                {delta > 0 ? '+' : ''}
-                {delta}
-              </span>{' '}
-              <span className="text-muted-foreground capitalize">
-                {stat.replace('_', ' ')}
-              </span>
-            </span>
-          ))}
-          {/* Egg stat changes (health for medicine) */}
-          {eggStatChanges.map(({ stat, delta }) => (
-            <span key={stat} className="text-xs">
-              <span
-                className={cn(
-                  'font-medium',
-                  delta > 0
-                    ? 'text-emerald-600 dark:text-emerald-400'
-                    : 'text-red-600 dark:text-red-400'
-                )}
-              >
-                {delta > 0 ? '+' : ''}
-                {delta}
-              </span>{' '}
-              <span className="text-muted-foreground capitalize">
-                {stat.replace('_', ' ')}
-              </span>
-            </span>
-          ))}
-        </div>
-      )}
-    </div>
-  );
-}
-
-// ─── Use Item Confirmation Dialog ─────────────────────────────────────────────
-
-interface BlobbiUseItemConfirmDialogProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  item: ResolvedInventoryItem;
-  companion: BlobbiCompanion;
-  action: InventoryAction;
-  quantity: number;
-  maxQuantity: number;
-  onIncrease: () => void;
-  onDecrease: () => void;
-  onQuantityChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
-  onConfirm: () => void;
-  isUsing: boolean;
-}
-
-function BlobbiUseItemConfirmDialog({
-  open,
-  onOpenChange,
-  item,
-  companion,
-  action,
-  quantity,
-  maxQuantity,
-  onIncrease,
-  onDecrease,
-  onQuantityChange,
-  onConfirm,
-  isUsing,
-}: BlobbiUseItemConfirmDialogProps) {
-  const actionMeta = ACTION_METADATA[action];
-  const isEgg = companion.stage === 'egg';
-  const isMedicine = action === 'medicine';
-  const isClean = action === 'clean';
-
-  // Preview stat changes for the selected quantity
-  const statPreview = useMemo(() => {
-    if (!item.effect) return { normalChanges: [], eggChanges: [] };
-
-    if (isEgg && isMedicine) {
-      // Calculate health change for N items
-      const healthDelta = item.effect.health ?? 0;
-      let currentHealth = companion.stats.health ?? 0;
-      for (let i = 0; i < quantity; i++) {
-        currentHealth = Math.max(0, Math.min(100, currentHealth + healthDelta));
-      }
-      const totalDelta = currentHealth - (companion.stats.health ?? 0);
-      return {
-        normalChanges: [],
-        eggChanges: totalDelta !== 0 ? [{ stat: 'health' as const, delta: totalDelta }] : [],
-      };
-    }
-
-    if (isEgg && isClean) {
-      // Calculate hygiene and happiness changes for N items
-      const hygieneDelta = item.effect.hygiene ?? 0;
-      const happinessDelta = item.effect.happiness ?? 0;
-      let currentHygiene = companion.stats.hygiene ?? 0;
-      let currentHappiness = companion.stats.happiness ?? 0;
-      for (let i = 0; i < quantity; i++) {
-        currentHygiene = Math.max(0, Math.min(100, currentHygiene + hygieneDelta));
-        currentHappiness = Math.max(0, Math.min(100, currentHappiness + happinessDelta));
-      }
-      const changes: Array<{ stat: 'health' | 'hygiene' | 'happiness'; delta: number }> = [];
-      const totalHygieneDelta = currentHygiene - (companion.stats.hygiene ?? 0);
-      const totalHappinessDelta = currentHappiness - (companion.stats.happiness ?? 0);
-      if (totalHygieneDelta !== 0) changes.push({ stat: 'hygiene', delta: totalHygieneDelta });
-      if (totalHappinessDelta !== 0) changes.push({ stat: 'happiness', delta: totalHappinessDelta });
-      return { normalChanges: [], eggChanges: changes };
-    }
-
-    // Normal stats preview - simulate N applications
-    const statKeys = ['hunger', 'happiness', 'energy', 'hygiene', 'health'] as const;
-    const currentStats = { ...companion.stats };
-    for (let i = 0; i < quantity; i++) {
-      for (const stat of statKeys) {
-        const delta = item.effect[stat];
-        if (delta !== undefined) {
-          currentStats[stat] = Math.max(0, Math.min(100, (currentStats[stat] ?? 0) + delta));
-        }
-      }
-    }
-    const changes: Array<{ stat: string; delta: number }> = [];
-    for (const stat of statKeys) {
-      const delta = (currentStats[stat] ?? 0) - (companion.stats[stat] ?? 0);
-      if (delta !== 0) {
-        changes.push({ stat, delta });
-      }
-    }
-    return { normalChanges: changes, eggChanges: [] };
-  }, [item.effect, companion.stats, quantity, isEgg, isMedicine, isClean]);
-
-  const hasChanges = statPreview.normalChanges.length > 0 || statPreview.eggChanges.length > 0;
-
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="max-w-sm w-[calc(100%-2rem)]">
-        <DialogHeader>
-          <DialogTitle>{actionMeta.label}</DialogTitle>
-        </DialogHeader>
-
-        <div className="space-y-4 py-2">
-          {/* Item Preview */}
-          <div className="flex items-center gap-3 sm:gap-4 p-3 sm:p-4 rounded-lg bg-muted/50">
-            <div className="text-3xl sm:text-4xl shrink-0">{item.icon}</div>
-            <div className="flex-1 min-w-0">
-              <h3 className="font-semibold truncate">{item.name}</h3>
-              <p className="text-sm text-muted-foreground">
-                {item.quantity} in inventory
-              </p>
-            </div>
-          </div>
-
-          {/* Quantity Selector */}
-          <div className="space-y-2">
-            <div className="flex items-center justify-between">
-              <label className="text-sm font-medium">Quantity</label>
-              <span className="text-xs text-muted-foreground">
-                Max: {maxQuantity}
-              </span>
-            </div>
-            <div className="flex items-center gap-2">
-              <Button
-                variant="outline"
-                size="icon"
-                onClick={onDecrease}
-                disabled={quantity <= 1 || isUsing}
-              >
-                <Minus className="size-4" />
-              </Button>
-              <Input
-                type="number"
-                min="1"
-                max={maxQuantity}
-                value={quantity}
-                onChange={onQuantityChange}
-                disabled={isUsing}
-                className="text-center"
-              />
-              <Button
-                variant="outline"
-                size="icon"
-                onClick={onIncrease}
-                disabled={quantity >= maxQuantity || isUsing}
-              >
-                <Plus className="size-4" />
-              </Button>
-            </div>
-          </div>
-
-          {/* Effects Summary */}
-          {hasChanges && (
-            <div className="p-4 rounded-lg bg-gradient-to-r from-emerald-500/10 to-green-500/10 border border-emerald-500/20">
-              <h4 className="text-sm font-medium mb-2">
-                Total effect{quantity > 1 ? ` (x${quantity})` : ''}
-              </h4>
-              <div className="flex flex-wrap gap-2">
-                {statPreview.normalChanges.map(({ stat, delta }) => (
-                  <Badge
-                    key={stat}
-                    variant="secondary"
-                    className={cn(
-                      'text-xs',
-                      delta > 0
-                        ? 'bg-green-500/20 text-green-700 dark:text-green-300'
-                        : 'bg-red-500/20 text-red-700 dark:text-red-300'
-                    )}
-                  >
-                    {delta > 0 ? '+' : ''}{delta} {stat}
-                  </Badge>
-                ))}
-                {statPreview.eggChanges.map(({ stat, delta }) => (
-                  <Badge
-                    key={stat}
-                    variant="secondary"
-                    className={cn(
-                      'text-xs',
-                      delta > 0
-                        ? 'bg-green-500/20 text-green-700 dark:text-green-300'
-                        : 'bg-red-500/20 text-red-700 dark:text-red-300'
-                    )}
-                  >
-                    {delta > 0 ? '+' : ''}{delta} {stat}
-                  </Badge>
-                ))}
-              </div>
-            </div>
-          )}
-        </div>
-
-        <DialogFooter>
-          <Button
-            variant="outline"
-            onClick={() => onOpenChange(false)}
-            disabled={isUsing}
-          >
-            Cancel
-          </Button>
-          <Button
-            onClick={onConfirm}
-            disabled={isUsing}
-            className="min-w-24"
-          >
-            {isUsing ? (
-              <>
-                <Loader2 className="size-4 mr-2 animate-spin" />
-                Using...
-              </>
-            ) : (
-              `Use${quantity > 1 ? ` (x${quantity})` : ''}`
-            )}
-          </Button>
-        </DialogFooter>
-      </DialogContent>
-    </Dialog>
-  );
-}

src/blobbi/actions/components/BlobbiActionsModal.tsx

@@ -1,201 +0,0 @@
-// src/blobbi/actions/components/BlobbiActionsModal.tsx
-
-import { Loader2, Moon, Sun, Utensils, Gamepad2, Sparkles as SparklesIcon, Pill, Music, Mic, X } from 'lucide-react';
-
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-  DialogClose,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-import type { InventoryAction, DirectAction } from '../lib/blobbi-action-utils';
-
-interface BlobbiActionsModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  companion: BlobbiCompanion;
-  onRest: () => void;
-  onInventoryAction: (action: InventoryAction) => void;
-  onDirectAction: (action: DirectAction) => void;
-  actionInProgress: string | null;
-  isPublishing: boolean;
-}
-
-export function BlobbiActionsModal({
-  open,
-  onOpenChange,
-  companion,
-  onRest,
-  onInventoryAction,
-  onDirectAction,
-  actionInProgress,
-  isPublishing,
-}: BlobbiActionsModalProps) {
-  const isSleeping = companion.state === 'sleeping';
-  const isDisabled = isPublishing || actionInProgress !== null;
-  const isEgg = companion.stage === 'egg';
-
-  const handleAction = (action: () => void) => {
-    action();
-  };
-
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="max-w-sm w-[calc(100%-2rem)] max-h-[85vh] flex flex-col p-0 gap-0 [&>button:last-child]:hidden">
-        {/* Header - Sticky */}
-        <DialogHeader className="sticky top-0 z-10 bg-background px-4 sm:px-6 pt-4 sm:pt-6 pb-3 sm:pb-4 border-b">
-          <div className="flex items-start justify-between gap-4">
-            <div>
-              <DialogTitle>Blobbi Actions</DialogTitle>
-              <p className="text-sm text-muted-foreground">{companion.name}</p>
-            </div>
-            <DialogClose className="rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2">
-              <X className="size-5" />
-              <span className="sr-only">Close</span>
-            </DialogClose>
-          </div>
-        </DialogHeader>
-        {/* Content - Scrollable */}
-        <div className="flex-1 min-h-0 overflow-y-auto px-4 sm:px-6 py-3 sm:py-4">
-          <div className="grid gap-3">
-          {/* Feed Action - hidden for eggs */}
-          {!isEgg && (
-            <Button
-              variant="outline"
-              className="w-full justify-start gap-3 h-14"
-              onClick={() => handleAction(() => onInventoryAction('feed'))}
-              disabled={isDisabled}
-            >
-              <Utensils className="size-5 text-orange-500" />
-              <div className="text-left">
-                <p className="font-medium">Feed</p>
-                <p className="text-xs text-muted-foreground">
-                  Give your Blobbi something to eat
-                </p>
-              </div>
-            </Button>
-          )}
-
-          {/* Play Action - hidden for eggs */}
-          {!isEgg && (
-            <Button
-              variant="outline"
-              className="w-full justify-start gap-3 h-14"
-              onClick={() => handleAction(() => onInventoryAction('play'))}
-              disabled={isDisabled}
-            >
-              <Gamepad2 className="size-5 text-yellow-500" />
-              <div className="text-left">
-                <p className="font-medium">Play</p>
-                <p className="text-xs text-muted-foreground">
-                  Play with toys to make your Blobbi happy
-                </p>
-              </div>
-            </Button>
-          )}
-
-          {/* Clean Action - available for all stages */}
-          <Button
-            variant="outline"
-            className="w-full justify-start gap-3 h-14"
-            onClick={() => handleAction(() => onInventoryAction('clean'))}
-            disabled={isDisabled}
-          >
-            <SparklesIcon className="size-5 text-blue-500" />
-            <div className="text-left">
-              <p className="font-medium">Clean</p>
-              <p className="text-xs text-muted-foreground">
-                {isEgg 
-                  ? 'Keep your egg clean and fresh' 
-                  : 'Keep your Blobbi clean and fresh'}
-              </p>
-            </div>
-          </Button>
-
-          {/* Medicine Action - available for all stages */}
-          <Button
-            variant="outline"
-            className="w-full justify-start gap-3 h-14"
-            onClick={() => handleAction(() => onInventoryAction('medicine'))}
-            disabled={isDisabled}
-          >
-            <Pill className="size-5 text-green-500" />
-            <div className="text-left">
-              <p className="font-medium">Medicine</p>
-              <p className="text-xs text-muted-foreground">
-                {isEgg 
-                  ? 'Keep your egg healthy' 
-                  : 'Heal your Blobbi'}
-              </p>
-            </div>
-          </Button>
-
-          {/* Play Music Action - available for all stages */}
-          <Button
-            variant="outline"
-            className="w-full justify-start gap-3 h-14"
-            onClick={() => handleAction(() => onDirectAction('play_music'))}
-            disabled={isDisabled}
-          >
-            <Music className="size-5 text-pink-500" />
-            <div className="text-left">
-              <p className="font-medium">Play Music</p>
-              <p className="text-xs text-muted-foreground">
-                {isEgg 
-                  ? 'Play soothing music for your egg' 
-                  : 'Play music for your Blobbi'}
-              </p>
-            </div>
-          </Button>
-
-          {/* Sing Action - available for all stages */}
-          <Button
-            variant="outline"
-            className="w-full justify-start gap-3 h-14"
-            onClick={() => handleAction(() => onDirectAction('sing'))}
-            disabled={isDisabled}
-          >
-            <Mic className="size-5 text-purple-500" />
-            <div className="text-left">
-              <p className="font-medium">Sing</p>
-              <p className="text-xs text-muted-foreground">
-                {isEgg 
-                  ? 'Sing a lullaby to your egg' 
-                  : 'Sing to your Blobbi'}
-              </p>
-            </div>
-          </Button>
-
-          {/* Sleep/Wake Action - hidden for eggs */}
-          {!isEgg && (
-            <Button
-              variant="outline"
-              className="w-full justify-start gap-3 h-14"
-              onClick={() => handleAction(onRest)}
-              disabled={isDisabled}
-            >
-              {actionInProgress === 'rest' ? (
-                <Loader2 className="size-5 animate-spin" />
-              ) : isSleeping ? (
-                <Sun className="size-5 text-amber-500" />
-              ) : (
-                <Moon className="size-5 text-violet-500" />
-              )}
-              <div className="text-left">
-                <p className="font-medium">{isSleeping ? 'Wake Up' : 'Sleep'}</p>
-                <p className="text-xs text-muted-foreground">
-                  {isSleeping ? 'Wake your Blobbi up' : 'Put your Blobbi to sleep'}
-                </p>
-              </div>
-            </Button>
-          )}
-          </div>
-        </div>
-      </DialogContent>
-    </Dialog>
-  );
-}

src/blobbi/actions/components/BlobbiMissionsModal.tsx

@@ -1,560 +0,0 @@
-// src/blobbi/actions/components/BlobbiMissionsModal.tsx
-
-/**
- * Missions modal for Blobbi — card-grid quest board.
- *
- * Layout:
- * 1. Sticky header with title, subtitle, legend help button, close
- * 2. Current Focus section (hatch / evolve) — collapsible, default open
- * 3. Daily Bounties section — collapsible, default open
- * 4. Settings row — low emphasis toggle (not collapsible)
- *
- * Both main sections use lightweight Radix Collapsible wrappers.
- * Collapsed headers still show summary info (progress / coins).
- */
-
-import {
-  Loader2,
-  XCircle,
-  AlertTriangle,
-  Coins,
-  X,
-  Eye,
-  Scroll,
-  Compass,
-  HelpCircle,
-  ChevronDown,
-} from 'lucide-react';
-import { formatCompactNumber, cn } from '@/lib/utils';
-
-import { Button } from '@/components/ui/button';
-import { Switch } from '@/components/ui/switch';
-import { Label } from '@/components/ui/label';
-import { Badge } from '@/components/ui/badge';
-import { Dialog, DialogContent, DialogClose } from '@/components/ui/dialog';
-import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
-import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/components/ui/collapsible';
-import {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogTitle,
-} from '@/components/ui/alert-dialog';
-import { useState } from 'react';
-
-import type { BlobbiCompanion, BlobbonautProfile } from '@/blobbi/core/lib/blobbi';
-import type { NostrEvent } from '@nostrify/nostrify';
-import type { HatchTasksResult } from '../hooks/useHatchTasks';
-import type { EvolveTasksResult } from '../hooks/useEvolveTasks';
-import { TasksPanel } from './TasksPanel';
-import { DailyMissionsPanel } from './DailyMissionsPanel';
-import { useDailyMissions } from '../hooks/useDailyMissions';
-import { useClaimMissionReward } from '../hooks/useClaimMissionReward';
-import { useRerollMission } from '../hooks/useRerollMission';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface BlobbiMissionsModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  companion: BlobbiCompanion;
-  profile: BlobbonautProfile | null;
-  updateProfileEvent: (event: NostrEvent) => void;
-  hatchTasks: HatchTasksResult;
-  evolveTasks: EvolveTasksResult;
-  onOpenPostModal: () => void;
-  onHatch: () => void;
-  isHatching: boolean;
-  onEvolve: () => void;
-  isEvolving: boolean;
-  onStopIncubation: () => Promise<void>;
-  isStoppingIncubation: boolean;
-  onStopEvolution: () => Promise<void>;
-  isStoppingEvolution: boolean;
-  availableStages?: ('egg' | 'baby' | 'adult')[];
-  showMissionCard?: boolean;
-  onToggleMissionCard?: (visible: boolean) => void;
-}
-
-// ─── Section Chevron ─────────────────────────────────────────────────────────
-
-function SectionChevron({ open }: { open: boolean }) {
-  return (
-    <ChevronDown
-      className={cn(
-        'size-4 text-muted-foreground/60 transition-transform duration-200',
-        open && 'rotate-180',
-      )}
-    />
-  );
-}
-
-// ─── Mission Type Legend ──────────────────────────────────────────────────────
-
-function MissionTypeLegend() {
-  return (
-    <Popover>
-      <PopoverTrigger asChild>
-        <button
-          type="button"
-          className="rounded-full p-1.5 opacity-50 hover:opacity-100 hover:bg-muted transition-all"
-          aria-label="Mission types legend"
-        >
-          <HelpCircle className="size-4" />
-        </button>
-      </PopoverTrigger>
-      <PopoverContent side="bottom" align="end" className="w-56 p-3">
-        <p className="text-xs font-semibold mb-2">Mission Types</p>
-        <div className="space-y-2">
-          <div className="flex items-center gap-2">
-            <div className="size-5 rounded-full bg-amber-500/15 flex items-center justify-center shrink-0">
-              <Scroll className="size-3 text-amber-500" />
-            </div>
-            <div>
-              <p className="text-xs font-medium">Daily Bounty</p>
-              <p className="text-[10px] text-muted-foreground">Resets every day</p>
-            </div>
-          </div>
-          <div className="flex items-center gap-2">
-            <div className="size-5 rounded-full bg-sky-500/15 flex items-center justify-center shrink-0">
-              <span className="text-xs">🥚</span>
-            </div>
-            <div>
-              <p className="text-xs font-medium">Hatch Task</p>
-              <p className="text-[10px] text-muted-foreground">Egg progression</p>
-            </div>
-          </div>
-          <div className="flex items-center gap-2">
-            <div className="size-5 rounded-full bg-violet-500/15 flex items-center justify-center shrink-0">
-              <span className="text-xs">🐣</span>
-            </div>
-            <div>
-              <p className="text-xs font-medium">Evolve Task</p>
-              <p className="text-[10px] text-muted-foreground">Baby progression</p>
-            </div>
-          </div>
-        </div>
-      </PopoverContent>
-    </Popover>
-  );
-}
-
-// ─── Daily Missions Section ───────────────────────────────────────────────────
-
-interface DailyMissionsSectionProps {
-  profile: BlobbonautProfile | null;
-  updateProfileEvent: (event: NostrEvent) => void;
-  availableStages?: ('egg' | 'baby' | 'adult')[];
-  disabled?: boolean;
-  defaultOpen?: boolean;
-}
-
-function DailyMissionsSection({
-  profile,
-  updateProfileEvent,
-  availableStages,
-  disabled,
-  defaultOpen = true,
-}: DailyMissionsSectionProps) {
-  const [isOpen, setIsOpen] = useState(defaultOpen);
-
-  const {
-    missions,
-    todayClaimedReward,
-    totalPotentialReward,
-    bonusAvailable,
-    bonusClaimed,
-    bonusReward,
-    noMissionsAvailable,
-    rerollsRemaining,
-  } = useDailyMissions({ availableStages });
-
-  const { mutate: claimReward, isPending: isClaiming } = useClaimMissionReward(
-    profile,
-    updateProfileEvent,
-  );
-
-  const { mutate: rerollMission, isPending: isRerolling } = useRerollMission();
-
-  const claimableCount = missions.filter((m) => m.completed && !m.claimed).length;
-
-  return (
-    <Collapsible open={isOpen} onOpenChange={setIsOpen}>
-      {/* Section header — tappable */}
-      <CollapsibleTrigger className="w-full">
-        <div className="flex items-center justify-between py-1 group">
-          <div className="flex items-center gap-2">
-            <Scroll className="size-4 text-amber-500 dark:text-amber-400 shrink-0" />
-            <h3 className="font-semibold text-sm">Daily Bounties</h3>
-          </div>
-          <div className="flex items-center gap-2">
-            {/* Summary pill — always visible */}
-            <div className="flex items-center gap-1.5 text-xs text-muted-foreground">
-              <Coins className="size-3 shrink-0 text-amber-500 dark:text-amber-400" />
-              <span className="tabular-nums">
-                {formatCompactNumber(todayClaimedReward)} / {formatCompactNumber(totalPotentialReward)}
-              </span>
-              {claimableCount > 0 && (
-                <span className="size-4 rounded-full bg-emerald-500 text-white text-[10px] font-bold flex items-center justify-center shrink-0">
-                  {claimableCount}
-                </span>
-              )}
-            </div>
-            <SectionChevron open={isOpen} />
-          </div>
-        </div>
-      </CollapsibleTrigger>
-
-      <CollapsibleContent className="overflow-hidden data-[state=open]:animate-collapsible-down data-[state=closed]:animate-collapsible-up">
-        <div className="pt-3">
-          <DailyMissionsPanel
-            missions={missions}
-            onClaimReward={(id) => claimReward({ missionId: id })}
-            onRerollMission={(id) => rerollMission({ missionId: id, availableStages })}
-            todayCoins={todayClaimedReward}
-            disabled={disabled || isClaiming || isRerolling}
-            bonusAvailable={bonusAvailable}
-            bonusClaimed={bonusClaimed}
-            bonusReward={bonusReward}
-            noMissionsAvailable={noMissionsAvailable}
-            rerollsRemaining={rerollsRemaining}
-            isRerolling={isRerolling}
-          />
-        </div>
-      </CollapsibleContent>
-    </Collapsible>
-  );
-}
-
-// ─── Stop Process Confirmation Dialog ─────────────────────────────────────────
-
-interface StopConfirmationDialogProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  companionName: string;
-  processType: 'incubation' | 'evolution';
-  onConfirm: () => Promise<void>;
-  isPending: boolean;
-}
-
-function StopConfirmationDialog({
-  open,
-  onOpenChange,
-  companionName,
-  processType,
-  onConfirm,
-  isPending,
-}: StopConfirmationDialogProps) {
-  const handleConfirm = async () => {
-    await onConfirm();
-    onOpenChange(false);
-  };
-
-  const label = processType === 'incubation' ? 'Incubation' : 'Evolution';
-
-  return (
-    <AlertDialog open={open} onOpenChange={onOpenChange}>
-      <AlertDialogContent>
-        <AlertDialogHeader>
-          <AlertDialogTitle className="flex items-center gap-2">
-            <AlertTriangle className="size-5 text-amber-500" />
-            Stop {label}?
-          </AlertDialogTitle>
-          <AlertDialogDescription className="space-y-2">
-            <p>
-              Are you sure you want to stop {processType === 'incubation' ? 'incubating' : 'evolving'}{' '}
-              <strong>{companionName}</strong>?
-            </p>
-            <p>
-              This will interrupt the {processType} process and clear all task progress.
-              You can restart {processType} later, but you'll need to complete the tasks again.
-            </p>
-          </AlertDialogDescription>
-        </AlertDialogHeader>
-        <AlertDialogFooter>
-          <AlertDialogCancel disabled={isPending}>Cancel</AlertDialogCancel>
-          <AlertDialogAction
-            onClick={handleConfirm}
-            disabled={isPending}
-            className="bg-destructive hover:bg-destructive/90"
-          >
-            {isPending ? (
-              <>
-                <Loader2 className="size-4 mr-2 animate-spin" />
-                Stopping...
-              </>
-            ) : (
-              `Stop ${label}`
-            )}
-          </AlertDialogAction>
-        </AlertDialogFooter>
-      </AlertDialogContent>
-    </AlertDialog>
-  );
-}
-
-// ─── Current Focus Section (Hatch / Evolve) ──────────────────────────────────
-
-interface CurrentFocusSectionProps {
-  companion: BlobbiCompanion;
-  tasks: HatchTasksResult | EvolveTasksResult;
-  processType: 'incubation' | 'evolution';
-  onOpenPostModal: () => void;
-  onComplete: () => void;
-  isCompleting: boolean;
-  onStop: () => Promise<void>;
-  isStopping: boolean;
-  defaultOpen?: boolean;
-}
-
-function CurrentFocusSection({
-  companion,
-  tasks,
-  processType,
-  onOpenPostModal,
-  onComplete,
-  isCompleting,
-  onStop,
-  isStopping,
-  defaultOpen = true,
-}: CurrentFocusSectionProps) {
-  const [isOpen, setIsOpen] = useState(defaultOpen);
-  const [showStopConfirmation, setShowStopConfirmation] = useState(false);
-
-  const isIncubation = processType === 'incubation';
-  const title = isIncubation ? 'Hatch Tasks' : 'Evolve Tasks';
-  const completeLabel = isIncubation ? 'Hatch Your Blobbi!' : 'Evolve Your Blobbi!';
-  const completingLabel = isIncubation ? 'Hatching...' : 'Evolving...';
-  const completeEmoji = isIncubation ? '🐣' : '✨';
-  const stopLabel = isIncubation ? 'Stop Incubation' : 'Stop Evolution';
-  const badgeLabel = isIncubation ? 'Hatch' : 'Evolve';
-  const category = isIncubation ? ('hatch' as const) : ('evolve' as const);
-
-  const completedCount = tasks.tasks.filter((t) => t.completed).length;
-  const totalTasks = tasks.tasks.length;
-
-  return (
-    <Collapsible open={isOpen} onOpenChange={setIsOpen}>
-      {/* Section header — tappable */}
-      <CollapsibleTrigger className="w-full">
-        <div className="flex items-center justify-between py-1 group">
-          <div className="flex items-center gap-2">
-            <Badge
-              variant="secondary"
-              className={cn(
-                'text-xs font-semibold px-2 py-0.5',
-                isIncubation
-                  ? 'bg-sky-500/15 text-sky-600 dark:text-sky-400'
-                  : 'bg-violet-500/15 text-violet-600 dark:text-violet-400',
-              )}
-            >
-              {badgeLabel}
-            </Badge>
-            <span className="text-sm font-semibold">{title}</span>
-          </div>
-          <div className="flex items-center gap-2">
-            <span
-              className={cn(
-                'text-xs font-medium tabular-nums',
-                tasks.allCompleted
-                  ? 'text-emerald-600 dark:text-emerald-400'
-                  : 'text-muted-foreground',
-              )}
-            >
-              {completedCount} / {totalTasks}
-            </span>
-            <SectionChevron open={isOpen} />
-          </div>
-        </div>
-      </CollapsibleTrigger>
-
-      <CollapsibleContent className="overflow-hidden data-[state=open]:animate-collapsible-down data-[state=closed]:animate-collapsible-up">
-        <div className="pt-3">
-          {/* Task card grid */}
-          <TasksPanel
-            tasks={tasks.tasks}
-            allCompleted={tasks.allCompleted}
-            isLoading={tasks.isLoading}
-            onOpenPostModal={onOpenPostModal}
-            onComplete={onComplete}
-            isCompleting={isCompleting}
-            completeLabel={completeLabel}
-            completingLabel={completingLabel}
-            completeEmoji={completeEmoji}
-            category={category}
-          />
-
-          {/* Stop process — low emphasis */}
-          <div className="mt-3 flex justify-center">
-            <Button
-              variant="ghost"
-              size="sm"
-              onClick={() => setShowStopConfirmation(true)}
-              disabled={isStopping || isCompleting}
-              className="text-xs text-muted-foreground hover:text-destructive hover:bg-destructive/10 h-8 px-3"
-            >
-              {isStopping ? (
-                <>
-                  <Loader2 className="size-3.5 mr-1.5 animate-spin" />
-                  Stopping...
-                </>
-              ) : (
-                <>
-                  <XCircle className="size-3.5 mr-1.5" />
-                  {stopLabel}
-                </>
-              )}
-            </Button>
-          </div>
-        </div>
-      </CollapsibleContent>
-
-      <StopConfirmationDialog
-        open={showStopConfirmation}
-        onOpenChange={setShowStopConfirmation}
-        companionName={companion.name}
-        processType={processType}
-        onConfirm={onStop}
-        isPending={isStopping}
-      />
-    </Collapsible>
-  );
-}
-
-// ─── Empty Focus State ────────────────────────────────────────────────────────
-
-function EmptyFocusState() {
-  return (
-    <div className="py-6 text-center">
-      <Compass className="size-5 text-muted-foreground/50 mx-auto mb-2" />
-      <p className="text-sm text-muted-foreground">No active progression right now</p>
-    </div>
-  );
-}
-
-// ─── Main Modal ───────────────────────────────────────────────────────────────
-
-export function BlobbiMissionsModal({
-  open,
-  onOpenChange,
-  companion,
-  profile,
-  updateProfileEvent,
-  hatchTasks,
-  evolveTasks,
-  onOpenPostModal,
-  onHatch,
-  isHatching,
-  onEvolve,
-  isEvolving,
-  onStopIncubation,
-  isStoppingIncubation,
-  onStopEvolution,
-  isStoppingEvolution,
-  availableStages,
-  showMissionCard,
-  onToggleMissionCard,
-}: BlobbiMissionsModalProps) {
-  const isIncubating = companion.state === 'incubating';
-  const isEvolvingState = companion.state === 'evolving';
-  const isEgg = companion.stage === 'egg';
-  const isBaby = companion.stage === 'baby';
-
-  const hasActiveProcess = (isIncubating && isEgg) || (isEvolvingState && isBaby);
-  const isProcessBusy = isHatching || isEvolving || isStoppingIncubation || isStoppingEvolution;
-
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="max-w-lg w-[calc(100%-2rem)] max-h-[85vh] flex flex-col p-0 gap-0 overflow-hidden [&>button:last-child]:hidden">
-        {/* ── Sticky Header ── */}
-        <div className="sticky top-0 z-10 bg-background px-4 sm:px-5 pt-4 pb-3 border-b border-border/60">
-          <div className="flex items-center justify-between">
-            <div className="min-w-0">
-              <h2 className="text-base font-bold tracking-tight">Missions</h2>
-              <p className="text-xs text-muted-foreground mt-0.5">
-                Quests & bounties for {companion.name}
-              </p>
-            </div>
-            <div className="flex items-center gap-0.5 shrink-0">
-              <MissionTypeLegend />
-              <DialogClose className="rounded-full p-1.5 opacity-60 hover:opacity-100 hover:bg-muted transition-all">
-                <X className="size-4" />
-                <span className="sr-only">Close</span>
-              </DialogClose>
-            </div>
-          </div>
-        </div>
-
-        {/* ── Scrollable Content ── */}
-        <div className="flex-1 min-h-0 overflow-y-auto overflow-x-hidden px-4 sm:px-5 py-4 space-y-5">
-          {/* 1. Current Focus */}
-          {hasActiveProcess ? (
-            <>
-              {isIncubating && isEgg ? (
-                <CurrentFocusSection
-                  companion={companion}
-                  tasks={hatchTasks}
-                  processType="incubation"
-                  onOpenPostModal={onOpenPostModal}
-                  onComplete={onHatch}
-                  isCompleting={isHatching}
-                  onStop={onStopIncubation}
-                  isStopping={isStoppingIncubation}
-                />
-              ) : isEvolvingState && isBaby ? (
-                <CurrentFocusSection
-                  companion={companion}
-                  tasks={evolveTasks}
-                  processType="evolution"
-                  onOpenPostModal={onOpenPostModal}
-                  onComplete={onEvolve}
-                  isCompleting={isEvolving}
-                  onStop={onStopEvolution}
-                  isStopping={isStoppingEvolution}
-                />
-              ) : null}
-            </>
-          ) : (
-            <EmptyFocusState />
-          )}
-
-          {/* Divider */}
-          <div className="h-px bg-border/60" />
-
-          {/* 2. Daily Bounties */}
-          <DailyMissionsSection
-            profile={profile}
-            updateProfileEvent={updateProfileEvent}
-            availableStages={availableStages}
-            disabled={isProcessBusy}
-          />
-
-          {/* 3. Settings */}
-          {onToggleMissionCard !== undefined && showMissionCard !== undefined && (
-            <>
-              <div className="h-px bg-border/40" />
-              <div className="flex items-center justify-between py-1">
-                <Label
-                  htmlFor="mission-card-toggle"
-                  className="flex items-center gap-2 text-xs text-muted-foreground cursor-pointer"
-                >
-                  <Eye className="size-3.5" />
-                  Show mission card on main page
-                </Label>
-                <Switch
-                  id="mission-card-toggle"
-                  checked={showMissionCard}
-                  onCheckedChange={onToggleMissionCard}
-                />
-              </div>
-            </>
-          )}
-        </div>
-      </DialogContent>
-    </Dialog>
-  );
-}

src/blobbi/actions/components/BlobbiPostModal.tsx

@@ -1,294 +0,0 @@
-// src/blobbi/actions/components/BlobbiPostModal.tsx
-
-/**
- * Modal for creating a Blobbi post (hatch or evolve).
- * 
- * Requirements:
- * - Prefilled with stage-aware text:
- *   - Hatch: "Hello Nostr! Posting to hatch #<blobbiName> #blobbi #ditto #nostr"
- *   - Evolve: "Hello Nostr! Posting to evolve #<blobbiName> #blobbi #ditto #nostr"
- * - User can ADD text but CANNOT delete the prefix or required hashtags
- * - Blobbi name is sanitized into a valid hashtag format
- * - Enforced programmatically
- */
-
-import { useState, useCallback, useEffect, useMemo } from 'react';
-import { X, Loader2, AlertCircle } from 'lucide-react';
-
-import {
-  Dialog,
-  DialogContent,
-  DialogTitle,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { Textarea } from '@/components/ui/textarea';
-import { Alert, AlertDescription } from '@/components/ui/alert';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import {
-  BLOBBI_POST_REQUIRED_HASHTAGS,
-  buildHatchPhrase,
-} from '../hooks/useHatchTasks';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/** The process type for the post */
-export type BlobbiPostProcess = 'hatch' | 'evolve';
-
-interface BlobbiPostModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  /** The Blobbi's name (will be converted to hashtag) */
-  blobbiName: string;
-  /** The process type - 'hatch' for incubation, 'evolve' for evolution */
-  process?: BlobbiPostProcess;
-  onSuccess?: () => void;
-}
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-/**
- * Build the required prefix text based on process type.
- */
-function buildPrefix(process: BlobbiPostProcess): string {
-  return process === 'evolve'
-    ? 'Posting to evolve'
-    : 'Posting to hatch';
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function BlobbiPostModal({
-  open,
-  onOpenChange,
-  blobbiName,
-  process = 'hatch',
-  onSuccess,
-}: BlobbiPostModalProps) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: createEvent, isPending } = useNostrPublish();
-  
-  // Compute the required elements based on props
-  const prefix = useMemo(() => buildPrefix(process), [process]);
-  const capitalizedName = useMemo(() => blobbiName.charAt(0).toUpperCase() + blobbiName.slice(1), [blobbiName]);
-  
-  // The required phrase that must appear in the post
-  const requiredPhrase = useMemo(() => 
-    process === 'hatch'
-      ? buildHatchPhrase(blobbiName)
-      : `${prefix} ${capitalizedName} #blobbi`,
-    [process, blobbiName, prefix, capitalizedName]
-  );
-  
-  // Build default content (the phrase itself is enough)
-  const defaultContent = useMemo(() => requiredPhrase, [requiredPhrase]);
-  
-  const [content, setContent] = useState(defaultContent);
-  const [validationError, setValidationError] = useState<string | null>(null);
-  
-  // Reset content when modal opens or props change
-  useEffect(() => {
-    if (open) {
-      setContent(defaultContent);
-      setValidationError(null);
-    }
-  }, [open, defaultContent]);
-  
-  /**
-   * Validate that the content contains the required phrase.
-   */
-  const validateContent = useCallback((text: string): string | null => {
-    if (!text.includes(requiredPhrase)) {
-      return `The post must contain: "${requiredPhrase}"`;
-    }
-    return null;
-  }, [requiredPhrase]);
-  
-  /**
-   * Handle content change with validation.
-   * Prevents deletion of required content.
-   */
-  const handleContentChange = useCallback((e: React.ChangeEvent<HTMLTextAreaElement>) => {
-    const newContent = e.target.value;
-    
-    // Allow content changes only if it preserves the required elements
-    const error = validateContent(newContent);
-    
-    if (error) {
-      setValidationError(error);
-      // Still update content but show error
-      // This allows the user to see what they're trying to do
-      // but the post button will be disabled
-    } else {
-      setValidationError(null);
-    }
-    
-    setContent(newContent);
-  }, [validateContent]);
-  
-  /**
-   * Handle post creation.
-   */
-  const handlePost = useCallback(async () => {
-    if (!user?.pubkey) {
-      toast({
-        title: 'Not logged in',
-        description: 'Please log in to create a post',
-        variant: 'destructive',
-      });
-      return;
-    }
-    
-    // Final validation
-    const error = validateContent(content);
-    if (error) {
-      setValidationError(error);
-      return;
-    }
-    
-    try {
-      // Build tags for the post: extract all hashtags from content
-      const tags: string[][] = [];
-      const seen = new Set<string>();
-      
-      // Always include BLOBBI_POST_REQUIRED_HASHTAGS as t tags
-      for (const hashtag of BLOBBI_POST_REQUIRED_HASHTAGS) {
-        const lower = hashtag.toLowerCase();
-        if (!seen.has(lower)) {
-          tags.push(['t', lower]);
-          seen.add(lower);
-        }
-      }
-      
-      // Extract any additional hashtags from the content
-      const contentHashtags = content.match(/#(\w+)/g) || [];
-      for (const tag of contentHashtags) {
-        const tagValue = tag.slice(1).toLowerCase();
-        if (!seen.has(tagValue)) {
-          tags.push(['t', tagValue]);
-          seen.add(tagValue);
-        }
-      }
-      
-      await createEvent({
-        kind: 1,
-        content,
-        tags,
-      });
-      
-      toast({
-        title: 'Post created!',
-        description: process === 'evolve' 
-          ? 'Your Blobbi evolution post has been published.'
-          : 'Your Blobbi hatch post has been published.',
-      });
-      
-      onOpenChange(false);
-      onSuccess?.();
-    } catch (error) {
-      toast({
-        title: 'Failed to create post',
-        description: error instanceof Error ? error.message : 'Unknown error',
-        variant: 'destructive',
-      });
-    }
-  }, [user, content, validateContent, createEvent, onOpenChange, onSuccess, process]);
-  
-  const canPost = !validationError && content.trim().length > 0;
-  
-  const dialogTitle = process === 'evolve' ? 'Blobbi Evolution Post' : 'Blobbi Hatch Post';
-  const alertText = process === 'evolve'
-    ? "This special post announces your Blobbi's evolution! The highlighted text must remain in your post."
-    : "This special post announces your Blobbi's hatching journey! The highlighted text must remain in your post.";
-  
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="max-w-lg p-0 gap-0">
-        {/* Header */}
-        <div className="flex items-center justify-between px-4 h-14 border-b">
-          <DialogTitle className="text-base font-semibold">
-            {dialogTitle}
-          </DialogTitle>
-          <button
-            onClick={() => onOpenChange(false)}
-            className="p-1.5 -mr-1.5 rounded-full text-muted-foreground hover:text-foreground hover:bg-secondary/60 transition-colors"
-          >
-            <X className="size-5" />
-          </button>
-        </div>
-        
-        {/* Content */}
-        <div className="p-4 space-y-4">
-          {/* Info alert */}
-          <Alert className="border-primary/20 bg-primary/5">
-            <AlertDescription className="text-sm">
-              {alertText}
-            </AlertDescription>
-          </Alert>
-          
-          {/* Textarea */}
-          <div className="space-y-2">
-            <Textarea
-              value={content}
-              onChange={handleContentChange}
-              placeholder="Write your post..."
-              className="min-h-[150px] resize-none"
-              disabled={isPending}
-            />
-            
-            {/* Character count and validation */}
-            <div className="flex items-center justify-between text-sm">
-              <div>
-                {validationError && (
-                  <span className="text-destructive flex items-center gap-1">
-                    <AlertCircle className="size-3.5" />
-                    {validationError}
-                  </span>
-                )}
-              </div>
-              <span className="text-muted-foreground">
-                {content.length} characters
-              </span>
-            </div>
-          </div>
-          
-          {/* Preview of required content */}
-          <div className="p-3 rounded-lg bg-muted/50 border border-dashed">
-            <p className="text-xs text-muted-foreground mb-1">Required phrase:</p>
-            <p className="text-sm font-medium text-primary">
-              {requiredPhrase}
-            </p>
-          </div>
-        </div>
-        
-        {/* Footer */}
-        <div className="flex items-center justify-end gap-2 px-4 py-3 border-t bg-muted/30">
-          <Button
-            variant="outline"
-            onClick={() => onOpenChange(false)}
-            disabled={isPending}
-          >
-            Cancel
-          </Button>
-          <Button
-            onClick={handlePost}
-            disabled={!canPost || isPending}
-            className="min-w-24"
-          >
-            {isPending ? (
-              <>
-                <Loader2 className="size-4 mr-2 animate-spin" />
-                Posting...
-              </>
-            ) : (
-              'Post'
-            )}
-          </Button>
-        </div>
-      </DialogContent>
-    </Dialog>
-  );
-}

src/blobbi/actions/components/DailyMissionsPanel.tsx

@@ -1,319 +0,0 @@
-/**
- * DailyMissionsPanel — card-grid layout for daily bounties.
- *
- * Each mission is a compact card in a 2-col grid.
- * Tapping a card expands it to show progress, claim button, and reroll.
- * Only one card expanded at a time.
- */
-
-import { useState } from 'react';
-import {
-  Check,
-  Coins,
-  Gift,
-  Sparkles,
-  Egg,
-  Trophy,
-  RefreshCw,
-  Heart,
-  Utensils,
-  Droplets,
-  Moon,
-  Camera,
-  Mic,
-  Music,
-  Pill,
-  CircleDot,
-} from 'lucide-react';
-
-import { Button } from '@/components/ui/button';
-import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/components/ui/tooltip';
-import { cn, formatCompactNumber } from '@/lib/utils';
-import type { DailyMission, DailyMissionAction } from '../lib/daily-missions';
-import { BONUS_MISSION_ID } from '../hooks/useClaimMissionReward';
-import {
-  ExpandableMissionCard,
-  MissionDescription,
-  MissionProgress,
-} from './ExpandableMissionCard';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface DailyMissionsPanelProps {
-  missions: DailyMission[];
-  onClaimReward: (missionId: string) => void;
-  onRerollMission?: (missionId: string) => void;
-  todayCoins: number;
-  disabled?: boolean;
-  bonusAvailable?: boolean;
-  bonusClaimed?: boolean;
-  bonusReward?: number;
-  noMissionsAvailable?: boolean;
-  rerollsRemaining?: number;
-  isRerolling?: boolean;
-}
-
-// ─── Daily Mission Icon Mapping ───────────────────────────────────────────────
-
-function DailyMissionIcon({ action }: { action: DailyMissionAction }) {
-  const cls = 'size-5';
-  switch (action) {
-    case 'interact':
-      return <Heart className={cls} />;
-    case 'feed':
-      return <Utensils className={cls} />;
-    case 'clean':
-      return <Droplets className={cls} />;
-    case 'sleep':
-      return <Moon className={cls} />;
-    case 'take_photo':
-      return <Camera className={cls} />;
-    case 'sing':
-      return <Mic className={cls} />;
-    case 'play_music':
-      return <Music className={cls} />;
-    case 'medicine':
-      return <Pill className={cls} />;
-    default:
-      return <CircleDot className={cls} />;
-  }
-}
-
-// ─── Bonus Card ───────────────────────────────────────────────────────────────
-
-interface BonusCardProps {
-  isAvailable: boolean;
-  isClaimed: boolean;
-  reward: number;
-  onClaim: () => void;
-  disabled?: boolean;
-  isExpanded: boolean;
-  onToggle: (id: string) => void;
-}
-
-function BonusCard({ isAvailable, isClaimed, reward, onClaim, disabled, isExpanded, onToggle }: BonusCardProps) {
-  const progress = isClaimed ? 1 : isAvailable ? 1 : 0;
-
-  return (
-    <ExpandableMissionCard
-      id="bonus"
-      category="daily"
-      icon={<Trophy className="size-5" />}
-      title="Daily Champion"
-      completed={isClaimed}
-      progress={progress}
-      isExpanded={isExpanded}
-      onToggle={onToggle}
-    >
-      <MissionDescription>
-        {isAvailable || isClaimed
-          ? 'Bonus reward for completing all daily missions!'
-          : 'Complete all missions to unlock this bonus'}
-      </MissionDescription>
-
-      <div className="flex items-center gap-1 text-xs font-medium text-amber-600 dark:text-amber-400">
-        <Coins className="size-3" />
-        +{formatCompactNumber(reward)}
-      </div>
-
-      {isAvailable && !isClaimed && (
-        <Button
-          size="sm"
-          onClick={onClaim}
-          disabled={disabled}
-          className="w-full bg-gradient-to-r from-amber-500 to-orange-500 hover:from-amber-600 hover:to-orange-600 text-white h-8 text-xs"
-        >
-          <Trophy className="size-3.5 mr-1.5" />
-          Claim Bonus {formatCompactNumber(reward)} Coins
-        </Button>
-      )}
-    </ExpandableMissionCard>
-  );
-}
-
-// ─── Empty / Done States ──────────────────────────────────────────────────────
-
-function NoMissionsState() {
-  return (
-    <div className="flex flex-col items-center gap-2 py-6 text-center">
-      <Egg className="size-5 text-muted-foreground/50" />
-      <div>
-        <p className="text-sm font-medium">Hatch your Blobbi first</p>
-        <p className="text-xs text-muted-foreground mt-0.5">
-          Daily missions unlock after hatching
-        </p>
-      </div>
-    </div>
-  );
-}
-
-function AllClaimedState({ todayCoins }: { todayCoins: number }) {
-  return (
-    <div className="flex flex-col items-center gap-2 py-6 text-center">
-      <Sparkles className="size-5 text-primary/60" />
-      <div>
-        <p className="text-sm font-medium">All done for today</p>
-        <p className="text-xs text-muted-foreground mt-0.5">
-          Earned{' '}
-          <span className="font-medium text-amber-600 dark:text-amber-400">
-            {formatCompactNumber(todayCoins)} coins
-          </span>{' '}
-          — come back tomorrow!
-        </p>
-      </div>
-    </div>
-  );
-}
-
-// ─── Reroll Counter ───────────────────────────────────────────────────────────
-
-function RerollCounter({ remaining }: { remaining: number }) {
-  const text =
-    remaining === 0
-      ? 'No rerolls left'
-      : remaining === 1
-        ? '1 reroll left'
-        : `${remaining} rerolls left`;
-
-  return (
-    <div className="flex items-center justify-end gap-1 text-[11px] text-muted-foreground col-span-full">
-      <RefreshCw className="size-2.5" />
-      <span>{text}</span>
-    </div>
-  );
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function DailyMissionsPanel({
-  missions,
-  onClaimReward,
-  onRerollMission,
-  todayCoins,
-  disabled,
-  bonusAvailable = false,
-  bonusClaimed = false,
-  bonusReward = 50,
-  noMissionsAvailable = false,
-  rerollsRemaining = 0,
-  isRerolling = false,
-}: DailyMissionsPanelProps) {
-  const [expandedId, setExpandedId] = useState<string | null>(null);
-
-  if (noMissionsAvailable) return <NoMissionsState />;
-
-  const allRegularClaimed = missions.every((m) => m.claimed);
-  const allDone = allRegularClaimed && bonusClaimed;
-
-  if (allDone) return <AllClaimedState todayCoins={todayCoins} />;
-
-  const canReroll = rerollsRemaining > 0 && !!onRerollMission;
-
-  const handleToggle = (id: string) => {
-    setExpandedId((prev) => (prev === id ? null : id));
-  };
-
-  return (
-    <div className="grid grid-cols-2 sm:grid-cols-3 gap-2">
-      {/* Reroll counter */}
-      {onRerollMission && <RerollCounter remaining={rerollsRemaining} />}
-
-      {/* Regular mission cards */}
-      {missions.map((mission) => {
-        const progress = mission.requiredCount > 0 ? mission.currentCount / mission.requiredCount : 0;
-        const canClaim = mission.completed && !mission.claimed;
-        const showReroll = onRerollMission && !mission.completed && !mission.claimed && canReroll;
-
-        return (
-          <ExpandableMissionCard
-            key={mission.id}
-            id={mission.id}
-            category="daily"
-            icon={<DailyMissionIcon action={mission.action} />}
-            title={mission.title}
-            completed={mission.claimed}
-            progress={Math.min(progress, 1)}
-            isExpanded={expandedId === mission.id}
-            onToggle={handleToggle}
-          >
-            {/* Description */}
-            <MissionDescription>{mission.description}</MissionDescription>
-
-            {/* Progress */}
-            {!mission.claimed && (
-              <MissionProgress
-                current={mission.currentCount}
-                required={mission.requiredCount}
-                completed={mission.completed}
-              />
-            )}
-
-            {/* Reward + reroll row */}
-            <div className="flex items-center justify-between">
-              <span className="inline-flex items-center gap-0.5 text-xs font-medium text-amber-600 dark:text-amber-400">
-                <Coins className="size-3" />
-                {formatCompactNumber(mission.reward)}
-              </span>
-
-              {showReroll && (
-                <TooltipProvider>
-                  <Tooltip>
-                    <TooltipTrigger asChild>
-                      <button
-                        onClick={(e) => {
-                          e.stopPropagation();
-                          onRerollMission(mission.id);
-                        }}
-                        disabled={disabled || isRerolling}
-                        className="p-1 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted transition-colors disabled:opacity-40"
-                      >
-                        <RefreshCw className={cn('size-3', isRerolling && 'animate-spin')} />
-                      </button>
-                    </TooltipTrigger>
-                    <TooltipContent side="left">
-                      <p>Replace mission</p>
-                    </TooltipContent>
-                  </Tooltip>
-                </TooltipProvider>
-              )}
-
-              {mission.claimed && (
-                <span className="inline-flex items-center gap-0.5 text-[10px] font-medium text-primary">
-                  <Check className="size-2.5" />
-                  Done
-                </span>
-              )}
-            </div>
-
-            {/* Claim button */}
-            {canClaim && (
-              <Button
-                size="sm"
-                onClick={(e) => {
-                  e.stopPropagation();
-                  onClaimReward(mission.id);
-                }}
-                disabled={disabled}
-                className="w-full bg-emerald-600 hover:bg-emerald-700 text-white h-8 text-xs"
-              >
-                <Gift className="size-3.5 mr-1.5" />
-                Claim {formatCompactNumber(mission.reward)} Coins
-              </Button>
-            )}
-          </ExpandableMissionCard>
-        );
-      })}
-
-      {/* Bonus card */}
-      <BonusCard
-        isAvailable={bonusAvailable}
-        isClaimed={bonusClaimed}
-        reward={bonusReward}
-        onClaim={() => onClaimReward(BONUS_MISSION_ID)}
-        disabled={disabled}
-        isExpanded={expandedId === 'bonus'}
-        onToggle={handleToggle}
-      />
-    </div>
-  );
-}

src/blobbi/actions/components/ExpandableMissionCard.tsx

@@ -1,250 +0,0 @@
-// src/blobbi/actions/components/ExpandableMissionCard.tsx
-
-/**
- * Expandable mission card for the quest-board grid.
- *
- * Collapsed: compact square-ish card showing icon, title, and a tiny
- *            progress ring / checkmark.
- * Expanded:  full-width row that reveals description, progress bar,
- *            action link, claim button, dynamic hints, etc.
- *
- * Only one card is expanded at a time per section (controlled by parent).
- */
-
-import type { ReactNode } from 'react';
-import { Check, ChevronRight, ExternalLink, AlertCircle } from 'lucide-react';
-import { Progress } from '@/components/ui/progress';
-import { cn } from '@/lib/utils';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export type MissionCategory = 'daily' | 'hatch' | 'evolve';
-
-export interface ExpandableMissionCardProps {
-  /** Unique id used to track which card is expanded */
-  id: string;
-  /** Mission category for visual styling */
-  category: MissionCategory;
-  /** Icon rendered in the compact card (ReactNode — usually a lucide icon or emoji span) */
-  icon: ReactNode;
-  /** Short title */
-  title: string;
-  /** Whether the mission is complete */
-  completed: boolean;
-  /** Progress fraction 0-1 (used for the tiny ring in compact mode) */
-  progress: number;
-  /** Whether this card is currently expanded */
-  isExpanded: boolean;
-  /** Parent calls this to toggle expansion */
-  onToggle: (id: string) => void;
-  /** Content rendered only when expanded */
-  children: ReactNode;
-  /** Optional extra className on the outer wrapper */
-  className?: string;
-}
-
-// ─── Tiny Progress Ring ───────────────────────────────────────────────────────
-
-function ProgressRing({ progress, completed, category }: { progress: number; completed: boolean; category: MissionCategory }) {
-  const size = 28;
-  const stroke = 2.5;
-  const radius = (size - stroke) / 2;
-  const circumference = 2 * Math.PI * radius;
-  const offset = circumference - progress * circumference;
-
-  if (completed) {
-    return (
-      <div className="size-7 rounded-full bg-emerald-500/20 flex items-center justify-center">
-        <Check className="size-3.5 text-emerald-600 dark:text-emerald-400" />
-      </div>
-    );
-  }
-
-  const ringColor =
-    category === 'hatch'
-      ? 'text-sky-500'
-      : category === 'evolve'
-        ? 'text-violet-500'
-        : 'text-amber-500';
-
-  return (
-    <svg width={size} height={size} className={cn('shrink-0 -rotate-90', ringColor)}>
-      <circle
-        cx={size / 2}
-        cy={size / 2}
-        r={radius}
-        fill="none"
-        stroke="currentColor"
-        strokeWidth={stroke}
-        opacity={0.15}
-      />
-      <circle
-        cx={size / 2}
-        cy={size / 2}
-        r={radius}
-        fill="none"
-        stroke="currentColor"
-        strokeWidth={stroke}
-        strokeDasharray={circumference}
-        strokeDashoffset={offset}
-        strokeLinecap="round"
-        className="transition-all duration-300"
-      />
-    </svg>
-  );
-}
-
-// ─── Accent colors per category ───────────────────────────────────────────────
-
-const CATEGORY_STYLES: Record<MissionCategory, { bg: string; expandedBg: string; border: string }> = {
-  daily: {
-    bg: 'bg-amber-500/[0.06] hover:bg-amber-500/10',
-    expandedBg: 'bg-amber-500/[0.06]',
-    border: 'ring-amber-500/20',
-  },
-  hatch: {
-    bg: 'bg-sky-500/[0.06] hover:bg-sky-500/10',
-    expandedBg: 'bg-sky-500/[0.06]',
-    border: 'ring-sky-500/20',
-  },
-  evolve: {
-    bg: 'bg-violet-500/[0.06] hover:bg-violet-500/10',
-    expandedBg: 'bg-violet-500/[0.06]',
-    border: 'ring-violet-500/20',
-  },
-};
-
-// ─── Component ────────────────────────────────────────────────────────────────
-
-export function ExpandableMissionCard({
-  id,
-  category,
-  icon,
-  title,
-  completed,
-  progress,
-  isExpanded,
-  onToggle,
-  children,
-  className,
-}: ExpandableMissionCardProps) {
-  const styles = CATEGORY_STYLES[category];
-
-  // ── Collapsed card ──
-  if (!isExpanded) {
-    return (
-      <button
-        type="button"
-        onClick={() => onToggle(id)}
-        className={cn(
-          'flex flex-col items-center gap-1.5 rounded-xl p-3 transition-all text-center cursor-pointer select-none',
-          'ring-1 ring-transparent',
-          completed ? 'bg-emerald-500/[0.06] hover:bg-emerald-500/10' : styles.bg,
-          className,
-        )}
-      >
-        {/* Icon */}
-        <div className="text-lg leading-none">{icon}</div>
-
-        {/* Title — 2 lines max */}
-        <span className={cn(
-          'text-[11px] font-medium leading-tight line-clamp-2 min-h-[2lh]',
-          completed && 'text-emerald-600 dark:text-emerald-400',
-        )}>
-          {title}
-        </span>
-
-        {/* Progress ring / check */}
-        <ProgressRing progress={progress} completed={completed} category={category} />
-      </button>
-    );
-  }
-
-  // ── Expanded card (spans full row) ──
-  return (
-    <div
-      className={cn(
-        'col-span-full rounded-xl ring-1 transition-all overflow-hidden',
-        completed ? 'bg-emerald-500/[0.06] ring-emerald-500/20' : cn(styles.expandedBg, styles.border),
-        className,
-      )}
-    >
-      {/* Compact header — click to collapse */}
-      <button
-        type="button"
-        onClick={() => onToggle(id)}
-        className="w-full flex items-center gap-3 p-3 text-left cursor-pointer select-none"
-      >
-        <div className="text-lg leading-none shrink-0">{icon}</div>
-        <span className={cn(
-          'text-sm font-medium flex-1 min-w-0',
-          completed && 'text-emerald-600 dark:text-emerald-400',
-        )}>
-          {title}
-        </span>
-        <ProgressRing progress={progress} completed={completed} category={category} />
-      </button>
-
-      {/* Expanded details */}
-      <div className="px-3 pb-3 pt-0 space-y-2">
-        {children}
-      </div>
-    </div>
-  );
-}
-
-// ─── Shared detail sub-components ─────────────────────────────────────────────
-
-/** Description text */
-export function MissionDescription({ children }: { children: ReactNode }) {
-  return <p className="text-xs text-muted-foreground leading-snug">{children}</p>;
-}
-
-/** Progress bar with fraction label */
-export function MissionProgress({ current, required, completed }: { current: number; required: number; completed: boolean }) {
-  const pct = required > 0 ? Math.round((current / required) * 100) : 0;
-  return (
-    <div>
-      <div className="flex items-center justify-between text-[11px] text-muted-foreground mb-1">
-        <span className="tabular-nums">{current} / {required}</span>
-        <span className="tabular-nums">{pct}%</span>
-      </div>
-      <Progress value={pct} className={cn('h-1.5', completed && '[&>div]:bg-emerald-500')} />
-    </div>
-  );
-}
-
-/** Inline action link (navigate, external, modal) */
-export function MissionAction({
-  label,
-  type,
-  onClick,
-}: {
-  label: string;
-  type: 'navigate' | 'external_link' | 'open_modal';
-  onClick: () => void;
-}) {
-  return (
-    <button
-      onClick={onClick}
-      className="inline-flex items-center gap-1 text-xs font-medium text-primary hover:underline"
-    >
-      {label}
-      {type === 'external_link' ? (
-        <ExternalLink className="size-3" />
-      ) : (
-        <ChevronRight className="size-3" />
-      )}
-    </button>
-  );
-}
-
-/** Dynamic / live task hint */
-export function DynamicHint({ current, required }: { current: number; required: number }) {
-  return (
-    <div className="flex items-center gap-1.5 text-[11px] text-amber-600/80 dark:text-amber-400/80">
-      <AlertCircle className="size-3 shrink-0" />
-      <span>Lowest stat: {current}% (need {required}%+)</span>
-    </div>
-  );
-}

src/blobbi/actions/components/HatchTasksPanel.tsx

@@ -1,221 +0,0 @@
-// src/blobbi/actions/components/HatchTasksPanel.tsx
-
-/**
- * UI component for displaying hatch task progress.
- * Shows a list of tasks with progress indicators and action buttons.
- */
-
-import { ExternalLink, Check, Loader2, ChevronRight } from 'lucide-react';
-import { useNavigate } from 'react-router-dom';
-import { openUrl } from '@/lib/downloadFile';
-
-import { Button } from '@/components/ui/button';
-import { Progress } from '@/components/ui/progress';
-import { Card, CardContent, CardHeader, CardTitle, CardDescription } from '@/components/ui/card';
-import { Badge } from '@/components/ui/badge';
-import { cn } from '@/lib/utils';
-
-import type { HatchTask } from '../hooks/useHatchTasks';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface HatchTasksPanelProps {
-  tasks: HatchTask[];
-  allCompleted: boolean;
-  isLoading: boolean;
-  /** Called when user clicks "Create Post" action */
-  onOpenPostModal: () => void;
-  /** Called when all tasks are complete and user clicks "Hatch" */
-  onHatch: () => void;
-  /** Whether hatching is in progress */
-  isHatching?: boolean;
-}
-
-// ─── Task Row Component ───────────────────────────────────────────────────────
-
-interface TaskRowProps {
-  task: HatchTask;
-  onOpenPostModal: () => void;
-}
-
-function TaskRow({ task, onOpenPostModal }: TaskRowProps) {
-  const navigate = useNavigate();
-  
-  const handleAction = () => {
-    if (!task.action || !task.actionTarget) return;
-    
-    switch (task.action) {
-      case 'navigate':
-        navigate(task.actionTarget);
-        break;
-      case 'external_link':
-        openUrl(task.actionTarget);
-        break;
-      case 'open_modal':
-        if (task.actionTarget === 'blobbi_post') {
-          onOpenPostModal();
-        }
-        break;
-    }
-  };
-  
-  const progress = task.required > 1 
-    ? Math.round((task.current / task.required) * 100)
-    : task.completed ? 100 : 0;
-  
-  return (
-    <div
-      className={cn(
-        "flex items-center gap-4 p-4 rounded-xl border transition-all",
-        task.completed 
-          ? "bg-emerald-500/5 border-emerald-500/20" 
-          : "bg-card/60 border-border hover:border-primary/30"
-      )}
-    >
-      {/* Status indicator */}
-      <div className={cn(
-        "size-10 rounded-full flex items-center justify-center shrink-0",
-        task.completed 
-          ? "bg-emerald-500/20 text-emerald-600 dark:text-emerald-400"
-          : "bg-muted text-muted-foreground"
-      )}>
-        {task.completed ? (
-          <Check className="size-5" />
-        ) : task.required > 1 ? (
-          <span className="text-sm font-medium">{task.current}/{task.required}</span>
-        ) : (
-          <span className="text-lg">○</span>
-        )}
-      </div>
-      
-      {/* Task info */}
-      <div className="flex-1 min-w-0">
-        <div className="flex items-center gap-2 mb-1">
-          <h4 className={cn(
-            "font-medium",
-            task.completed && "text-emerald-600 dark:text-emerald-400"
-          )}>
-            {task.name}
-          </h4>
-          {task.completed && (
-            <Badge variant="secondary" className="bg-emerald-500/20 text-emerald-700 dark:text-emerald-300 text-xs">
-              Complete
-            </Badge>
-          )}
-        </div>
-        <p className="text-sm text-muted-foreground">
-          {task.description}
-        </p>
-        
-        {/* Progress bar for multi-step tasks */}
-        {task.required > 1 && !task.completed && (
-          <Progress value={progress} className="h-1.5 mt-2" />
-        )}
-      </div>
-      
-      {/* Action button */}
-      {task.action && task.actionLabel && !task.completed && (
-        <Button
-          variant="outline"
-          size="sm"
-          onClick={handleAction}
-          className="shrink-0 gap-2"
-        >
-          {task.actionLabel}
-          {task.action === 'external_link' ? (
-            <ExternalLink className="size-3.5" />
-          ) : (
-            <ChevronRight className="size-3.5" />
-          )}
-        </Button>
-      )}
-    </div>
-  );
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function HatchTasksPanel({
-  tasks,
-  allCompleted,
-  isLoading,
-  onOpenPostModal,
-  onHatch,
-  isHatching = false,
-}: HatchTasksPanelProps) {
-  const completedCount = tasks.filter(t => t.completed).length;
-  const totalTasks = tasks.length;
-  const overallProgress = Math.round((completedCount / totalTasks) * 100);
-  
-  return (
-    <Card className="border-primary/20 bg-gradient-to-br from-primary/5 to-transparent">
-      <CardHeader className="pb-4">
-        <div className="flex items-center justify-between">
-          <div>
-            <CardTitle className="flex items-center gap-2">
-              <span className="text-2xl">🥚</span>
-              Hatch Tasks
-            </CardTitle>
-            <CardDescription>
-              Complete these tasks to hatch your Blobbi
-            </CardDescription>
-          </div>
-          <Badge variant="outline" className="text-base px-3 py-1">
-            {completedCount}/{totalTasks}
-          </Badge>
-        </div>
-        
-        {/* Overall progress */}
-        <div className="mt-4">
-          <div className="flex items-center justify-between text-sm mb-2">
-            <span className="text-muted-foreground">Overall progress</span>
-            <span className="font-medium">{overallProgress}%</span>
-          </div>
-          <Progress value={overallProgress} className="h-2" />
-        </div>
-      </CardHeader>
-      
-      <CardContent className="space-y-3">
-        {isLoading ? (
-          <div className="flex items-center justify-center py-8">
-            <Loader2 className="size-6 animate-spin text-muted-foreground" />
-          </div>
-        ) : (
-          <>
-            {tasks.map(task => (
-              <TaskRow 
-                key={task.id} 
-                task={task} 
-                onOpenPostModal={onOpenPostModal}
-              />
-            ))}
-            
-            {/* Hatch button - only visible when all tasks complete */}
-            {allCompleted && (
-              <div className="pt-4 border-t border-border mt-4">
-                <Button
-                  onClick={onHatch}
-                  disabled={isHatching}
-                  size="lg"
-                  className="w-full gap-2 bg-gradient-to-r from-amber-500 to-orange-500 hover:from-amber-600 hover:to-orange-600 text-white"
-                >
-                  {isHatching ? (
-                    <>
-                      <Loader2 className="size-5 animate-spin" />
-                      Hatching...
-                    </>
-                  ) : (
-                    <>
-                      <span className="text-xl">🐣</span>
-                      Hatch Your Blobbi!
-                    </>
-                  )}
-                </Button>
-              </div>
-            )}
-          </>
-        )}
-      </CardContent>
-    </Card>
-  );
-}

src/blobbi/actions/components/InlineMusicPlayer.tsx

@@ -1,251 +0,0 @@
-// src/blobbi/actions/components/InlineMusicPlayer.tsx
-
-import { useCallback, useEffect } from 'react';
-import { Music, Play, Pause, RotateCcw, MoreHorizontal, Loader2, AlertCircle, X, Volume2, VolumeX } from 'lucide-react';
-
-import { Button } from '@/components/ui/button';
-import { Slider } from '@/components/ui/slider';
-import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
-import { cn } from '@/lib/utils';
-
-import { useAudioPlayback } from '../hooks/useAudioPlayback';
-import type { SelectedTrack } from './PlayMusicModal';
-
-// Re-export for external use
-export type { SelectedTrack } from './PlayMusicModal';
-
-interface InlineMusicPlayerProps {
-  /** The selected track */
-  selection: SelectedTrack;
-  /** Called when user wants to change the track */
-  onChangeTrack: () => void;
-  /** Called when user closes the player */
-  onClose: () => void;
-  /** Called when playback starts (for Blobbi reaction state) */
-  onPlaybackStart?: () => void;
-  /** Called when playback stops/pauses (for Blobbi reaction state) */
-  onPlaybackStop?: () => void;
-  /** Whether the action has been published (playback only starts after publish) */
-  isPublished: boolean;
-  /** Whether publishing is in progress */
-  isPublishing: boolean;
-}
-
-// ─── Component ────────────────────────────────────────────────────────────────
-
-export function InlineMusicPlayer({
-  selection,
-  onChangeTrack,
-  onClose,
-  onPlaybackStart,
-  onPlaybackStop,
-  isPublished,
-  isPublishing,
-}: InlineMusicPlayerProps) {
-  const {
-    state: playbackState,
-    error: playbackError,
-    load,
-    toggle,
-    restart,
-    stop,
-    isPlaying,
-    volume,
-    setVolume,
-    cleanup,
-  } = useAudioPlayback({
-    onEnded: () => {
-      onPlaybackStop?.();
-    },
-  });
-  
-  // Auto-start playback when first published (idle -> playing)
-  // Note: 'stopped' state is NOT included here - stop is a terminal state
-  // that requires explicit user action (play button) to restart
-  useEffect(() => {
-    if (isPublished && playbackState === 'idle') {
-      load(selection.url, true);
-      onPlaybackStart?.();
-    }
-  }, [isPublished, playbackState, selection.url, load, onPlaybackStart]);
-  
-  // Force reload when source URL changes while already playing/paused
-  useEffect(() => {
-    // Only trigger reload if we're in an active playback state with a different URL
-    if (isPublished && (playbackState === 'playing' || playbackState === 'paused')) {
-      // The load function will check if URL changed and reload if needed
-      load(selection.url, true);
-    }
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- Only react to selection.url changes
-  }, [selection.url]);
-  
-  // Notify on playback state changes
-  useEffect(() => {
-    if (isPlaying) {
-      onPlaybackStart?.();
-    } else if (playbackState === 'paused' || playbackState === 'stopped') {
-      onPlaybackStop?.();
-    }
-  }, [isPlaying, playbackState, onPlaybackStart, onPlaybackStop]);
-  
-  // Cleanup on close
-  const handleClose = useCallback(() => {
-    stop();
-    cleanup();
-    onPlaybackStop?.();
-    onClose();
-  }, [stop, cleanup, onPlaybackStop, onClose]);
-  
-  // Handle play/pause toggle
-  const handleToggle = useCallback(async () => {
-    if (playbackState === 'idle' || playbackState === 'stopped') {
-      load(selection.url, true);
-    } else {
-      await toggle();
-    }
-  }, [playbackState, selection.url, load, toggle]);
-  
-  // Track info
-  const trackTitle = selection.track.title;
-  const trackArtist = selection.track.artist;
-  
-  const isLoading = playbackState === 'loading' || isPublishing;
-  const hasError = playbackState === 'error';
-  
-  return (
-    <div className="mx-4 sm:mx-6 mb-4">
-      <div className={cn(
-        "rounded-xl border bg-card/80 backdrop-blur-sm overflow-hidden",
-        "shadow-sm transition-all",
-        isPlaying && "ring-2 ring-pink-500/30"
-      )}>
-        {/* Main content row */}
-        <div className="flex items-center gap-3 p-3">
-          {/* Music icon / Now Playing indicator */}
-          <div className={cn(
-            "size-10 rounded-lg flex items-center justify-center shrink-0",
-            isPlaying 
-              ? "bg-pink-500/20" 
-              : "bg-muted"
-          )}>
-            <Music className={cn(
-              "size-5",
-              isPlaying ? "text-pink-500 animate-pulse" : "text-muted-foreground"
-            )} />
-          </div>
-          
-          {/* Track info */}
-          <div className="flex-1 min-w-0">
-            <p className="font-medium text-sm truncate">{trackTitle}</p>
-            {trackArtist && (
-              <p className="text-xs text-muted-foreground truncate">{trackArtist}</p>
-            )}
-            {!trackArtist && (
-              <p className="text-xs text-muted-foreground">
-                {isPlaying ? 'Now playing...' : isPublishing ? 'Starting...' : 'Ready to play'}
-              </p>
-            )}
-          </div>
-          
-          {/* Controls */}
-          <div className="flex items-center gap-1 shrink-0">
-            {/* Play/Pause button */}
-            <Button
-              size="icon"
-              variant="ghost"
-              onClick={handleToggle}
-              disabled={isLoading || !isPublished}
-              className="size-9 rounded-full"
-            >
-              {isLoading ? (
-                <Loader2 className="size-4 animate-spin" />
-              ) : isPlaying ? (
-                <Pause className="size-4" />
-              ) : (
-                <Play className="size-4 ml-0.5" />
-              )}
-            </Button>
-            
-            {/* Restart button - only show when actively playing or paused */}
-            {isPublished && (playbackState === 'playing' || playbackState === 'paused') && (
-              <Button
-                size="icon"
-                variant="ghost"
-                onClick={() => {
-                  restart();
-                }}
-                className="size-9 rounded-full"
-                title="Restart from beginning"
-              >
-                <RotateCcw className="size-3.5" />
-              </Button>
-            )}
-            
-            {/* Volume control */}
-            <Popover>
-              <PopoverTrigger asChild>
-                <Button
-                  size="icon"
-                  variant="ghost"
-                  className="size-9 rounded-full"
-                  title={volume === 0 ? 'Unmute' : 'Volume'}
-                >
-                  {volume === 0 ? (
-                    <VolumeX className="size-4" />
-                  ) : (
-                    <Volume2 className="size-4" />
-                  )}
-                </Button>
-              </PopoverTrigger>
-              <PopoverContent 
-                side="top" 
-                align="center" 
-                className="w-32 p-3"
-              >
-                <Slider
-                  value={[volume * 100]}
-                  onValueChange={([val]) => setVolume(val / 100)}
-                  max={100}
-                  step={1}
-                  className="w-full"
-                />
-              </PopoverContent>
-            </Popover>
-            
-            {/* Change track button */}
-            <Button
-              size="icon"
-              variant="ghost"
-              onClick={onChangeTrack}
-              disabled={isPublishing}
-              className="size-9 rounded-full"
-            >
-              <MoreHorizontal className="size-4" />
-            </Button>
-            
-            {/* Close button */}
-            <Button
-              size="icon"
-              variant="ghost"
-              onClick={handleClose}
-              disabled={isPublishing}
-              className="size-9 rounded-full text-muted-foreground hover:text-foreground"
-            >
-              <X className="size-4" />
-            </Button>
-          </div>
-        </div>
-        
-        {/* Error message */}
-        {hasError && playbackError && (
-          <div className="px-3 pb-3">
-            <div className="flex items-start gap-2 p-2 rounded-lg bg-amber-500/10 text-amber-600 dark:text-amber-400">
-              <AlertCircle className="size-4 mt-0.5 shrink-0" />
-              <p className="text-xs">{playbackError.message}</p>
-            </div>
-          </div>
-        )}
-      </div>
-    </div>
-  );
-}

src/blobbi/actions/components/InlineSingCard.tsx

@@ -1,487 +0,0 @@
-// src/blobbi/actions/components/InlineSingCard.tsx
-
-import { useState, useRef, useCallback, useEffect } from 'react';
-import { 
-  Mic, 
-  Play, 
-  Pause, 
-  Square, 
-  FileText, 
-  Check, 
-  X, 
-  Loader2, 
-  AlertCircle,
-  RefreshCw,
-} from 'lucide-react';
-
-import { Button } from '@/components/ui/button';
-import { cn } from '@/lib/utils';
-
-import { useAudioPlayback } from '../hooks/useAudioPlayback';
-import { getRandomLyrics, type LyricsEntry } from '../lib/blobbi-random-lyrics';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-type RecordingState = 'idle' | 'requesting' | 'recording' | 'recorded' | 'error';
-
-interface InlineSingCardProps {
-  /** Called when user confirms the singing action (publish the action) */
-  onConfirm: () => Promise<void>;
-  /** Called when user closes the sing card */
-  onClose: () => void;
-  /** Called when recording starts (for Blobbi reaction) */
-  onRecordingStart?: () => void;
-  /** Called when recording stops (for Blobbi reaction) */
-  onRecordingStop?: () => void;
-  /** Whether publishing is in progress */
-  isPublishing: boolean;
-}
-
-// ─── MIME Type Selection ──────────────────────────────────────────────────────
-
-const AUDIO_MIME_CANDIDATES = [
-  'audio/webm;codecs=opus',
-  'audio/webm',
-  'audio/mp4',
-  'audio/ogg;codecs=opus',
-  'audio/ogg',
-] as const;
-
-function getSupportedAudioMimeType(): string | undefined {
-  if (typeof MediaRecorder === 'undefined') {
-    return undefined;
-  }
-  
-  for (const mimeType of AUDIO_MIME_CANDIDATES) {
-    if (MediaRecorder.isTypeSupported(mimeType)) {
-      return mimeType;
-    }
-  }
-  
-  return undefined;
-}
-
-// ─── Component ────────────────────────────────────────────────────────────────
-
-export function InlineSingCard({
-  onConfirm,
-  onClose,
-  onRecordingStart,
-  onRecordingStop,
-  isPublishing,
-}: InlineSingCardProps) {
-  // Recording state
-  const [recordingState, setRecordingState] = useState<RecordingState>('idle');
-  const [recordingError, setRecordingError] = useState<string | null>(null);
-  const [recordingDuration, setRecordingDuration] = useState(0);
-  const [audioUrl, setAudioUrl] = useState<string | null>(null);
-  
-  // Lyrics state
-  const [currentLyrics, setCurrentLyrics] = useState<LyricsEntry | null>(null);
-  const [showLyrics, setShowLyrics] = useState(false);
-  
-  // Refs
-  const mediaRecorderRef = useRef<MediaRecorder | null>(null);
-  const chunksRef = useRef<Blob[]>([]);
-  const streamRef = useRef<MediaStream | null>(null);
-  const timerRef = useRef<ReturnType<typeof setInterval> | null>(null);
-  const actualMimeTypeRef = useRef<string | undefined>(undefined);
-  
-  // Audio playback for preview
-  const {
-    state: playbackState,
-    error: playbackError,
-    load: loadAudio,
-    toggle: togglePlayback,
-    stop: stopPlayback,
-    isPlaying,
-    cleanup: cleanupPlayback,
-  } = useAudioPlayback();
-  
-  // Cleanup on unmount
-  useEffect(() => {
-    return () => {
-      cleanupAll();
-    };
-  }, []);
-  
-  // Cleanup all resources
-  const cleanupAll = useCallback(() => {
-    // Stop timer
-    if (timerRef.current) {
-      clearInterval(timerRef.current);
-      timerRef.current = null;
-    }
-    
-    // Stop media recorder
-    if (mediaRecorderRef.current && mediaRecorderRef.current.state !== 'inactive') {
-      try {
-        mediaRecorderRef.current.stop();
-      } catch {
-        // Ignore errors during cleanup
-      }
-    }
-    mediaRecorderRef.current = null;
-    
-    // Stop stream tracks
-    if (streamRef.current) {
-      streamRef.current.getTracks().forEach(track => track.stop());
-      streamRef.current = null;
-    }
-    
-    // Cleanup playback
-    cleanupPlayback();
-    
-    // Revoke URL
-    if (audioUrl) {
-      URL.revokeObjectURL(audioUrl);
-    }
-  }, [audioUrl, cleanupPlayback]);
-  
-  // Reset recording
-  const resetRecording = useCallback(() => {
-    cleanupAll();
-    setRecordingState('idle');
-    setRecordingError(null);
-    setRecordingDuration(0);
-    setAudioUrl(null);
-    chunksRef.current = [];
-    actualMimeTypeRef.current = undefined;
-    // Keep lyrics
-  }, [cleanupAll]);
-  
-  // Check browser support
-  const checkRecordingSupport = (): boolean => {
-    if (typeof navigator === 'undefined') return false;
-    if (!navigator.mediaDevices) return false;
-    if (!navigator.mediaDevices.getUserMedia) return false;
-    if (typeof MediaRecorder === 'undefined') return false;
-    return true;
-  };
-  
-  // Start recording
-  const startRecording = useCallback(async () => {
-    if (!checkRecordingSupport()) {
-      setRecordingError('Audio recording is not supported in this browser.');
-      setRecordingState('error');
-      return;
-    }
-    
-    setRecordingState('requesting');
-    setRecordingError(null);
-    
-    try {
-      const stream = await navigator.mediaDevices.getUserMedia({
-        audio: {
-          echoCancellation: true,
-          noiseSuppression: true,
-          autoGainControl: true,
-        }
-      });
-      
-      streamRef.current = stream;
-      chunksRef.current = [];
-      
-      // Get supported MIME type
-      const supportedMimeType = getSupportedAudioMimeType();
-      
-      // Create MediaRecorder
-      let mediaRecorder: MediaRecorder;
-      if (supportedMimeType) {
-        mediaRecorder = new MediaRecorder(stream, { mimeType: supportedMimeType });
-      } else {
-        mediaRecorder = new MediaRecorder(stream);
-      }
-      
-      actualMimeTypeRef.current = mediaRecorder.mimeType || supportedMimeType;
-      mediaRecorderRef.current = mediaRecorder;
-      
-      mediaRecorder.ondataavailable = (event) => {
-        if (event.data.size > 0) {
-          chunksRef.current.push(event.data);
-        }
-      };
-      
-      mediaRecorder.onstop = () => {
-        const blobMimeType = actualMimeTypeRef.current || 'audio/webm';
-        const blob = new Blob(chunksRef.current, { type: blobMimeType });
-        const url = URL.createObjectURL(blob);
-        setAudioUrl(url);
-        setRecordingState('recorded');
-        
-        if (streamRef.current) {
-          streamRef.current.getTracks().forEach(track => track.stop());
-          streamRef.current = null;
-        }
-      };
-      
-      mediaRecorder.onerror = () => {
-        setRecordingError('Recording failed. Please try again.');
-        setRecordingState('error');
-      };
-      
-      mediaRecorder.start(100);
-      setRecordingState('recording');
-      setRecordingDuration(0);
-      
-      // Notify parent that recording started (for Blobbi reaction)
-      onRecordingStart?.();
-      
-      timerRef.current = setInterval(() => {
-        setRecordingDuration(prev => prev + 1);
-      }, 1000);
-      
-    } catch (err) {
-      if (err instanceof Error) {
-        if (err.name === 'NotAllowedError' || err.name === 'PermissionDeniedError') {
-          setRecordingError('Microphone access was denied.');
-        } else if (err.name === 'NotFoundError') {
-          setRecordingError('No microphone found.');
-        } else {
-          setRecordingError(err.message);
-        }
-      } else {
-        setRecordingError('Failed to access microphone.');
-      }
-      setRecordingState('error');
-    }
-  }, [onRecordingStart]);
-  
-  // Stop recording
-  const stopRecording = useCallback(() => {
-    if (timerRef.current) {
-      clearInterval(timerRef.current);
-      timerRef.current = null;
-    }
-    
-    if (mediaRecorderRef.current && mediaRecorderRef.current.state !== 'inactive') {
-      mediaRecorderRef.current.stop();
-    }
-    
-    // Notify parent that recording stopped (for Blobbi reaction)
-    onRecordingStop?.();
-  }, [onRecordingStop]);
-  
-  // Handle preview playback
-  const handlePreview = useCallback(() => {
-    if (!audioUrl) return;
-    
-    if (playbackState === 'idle') {
-      loadAudio(audioUrl, true);
-    } else {
-      togglePlayback();
-    }
-  }, [audioUrl, playbackState, loadAudio, togglePlayback]);
-  
-  // Handle confirm
-  const handleConfirm = useCallback(async () => {
-    stopPlayback();
-    await onConfirm();
-    // After successful publish, close the card
-    onClose();
-  }, [stopPlayback, onConfirm, onClose]);
-  
-  // Handle close
-  const handleClose = useCallback(() => {
-    cleanupAll();
-    onClose();
-  }, [cleanupAll, onClose]);
-  
-  // Handle lyrics toggle
-  const handleLyricsToggle = useCallback(() => {
-    if (!currentLyrics && !showLyrics) {
-      // Generate lyrics on first open
-      setCurrentLyrics(getRandomLyrics());
-    }
-    setShowLyrics(!showLyrics);
-  }, [currentLyrics, showLyrics]);
-  
-  // Get new lyrics
-  const handleNewLyrics = useCallback(() => {
-    setCurrentLyrics(getRandomLyrics());
-  }, []);
-  
-  // Format duration
-  const formatDuration = (seconds: number) => {
-    const mins = Math.floor(seconds / 60);
-    const secs = seconds % 60;
-    return `${mins}:${secs.toString().padStart(2, '0')}`;
-  };
-  
-  const hasRecording = recordingState === 'recorded';
-  const isRecording = recordingState === 'recording';
-  const canConfirm = hasRecording && !isPublishing;
-  
-  return (
-    <div className="mx-4 sm:mx-6 mb-4">
-      <div className={cn(
-        "rounded-xl border bg-card/80 backdrop-blur-sm overflow-hidden",
-        "shadow-sm transition-all",
-        isRecording && "ring-2 ring-red-500/30"
-      )}>
-        {/* Lyrics panel (expands upward visually by being above controls) */}
-        {showLyrics && currentLyrics && (
-          <div className="px-3 pt-3 pb-2 border-b border-border/50">
-            <div className="flex items-center justify-between mb-2">
-              <span className="text-sm font-medium">{currentLyrics.title}</span>
-              <Button
-                size="icon"
-                variant="ghost"
-                onClick={handleNewLyrics}
-                className="size-7 rounded-full"
-              >
-                <RefreshCw className="size-3" />
-              </Button>
-            </div>
-            <div className="p-3 rounded-lg bg-muted/50 text-sm leading-relaxed whitespace-pre-line max-h-32 overflow-y-auto">
-              {currentLyrics.lines.join('\n')}
-            </div>
-          </div>
-        )}
-        
-        {/* Status row (recording/recorded info) */}
-        {(isRecording || hasRecording) && (
-          <div className="px-3 pt-3 pb-2 border-b border-border/50">
-            <div className="flex items-center justify-center gap-2">
-              {isRecording && (
-                <>
-                  <div className="size-2 rounded-full bg-red-500 animate-pulse" />
-                  <span className="text-sm font-mono font-medium text-red-500">
-                    {formatDuration(recordingDuration)}
-                  </span>
-                  <span className="text-xs text-muted-foreground">Recording...</span>
-                </>
-              )}
-              {hasRecording && !isRecording && (
-                <>
-                  <Check className="size-4 text-purple-500" />
-                  <span className="text-sm font-mono font-medium text-purple-500">
-                    {formatDuration(recordingDuration)}
-                  </span>
-                  <span className="text-xs text-muted-foreground">Recorded</span>
-                </>
-              )}
-            </div>
-          </div>
-        )}
-        
-        {/* Error message */}
-        {(recordingError || playbackError) && (
-          <div className="px-3 pt-2">
-            <div className="flex items-start gap-2 p-2 rounded-lg bg-amber-500/10 text-amber-600 dark:text-amber-400">
-              <AlertCircle className="size-4 mt-0.5 shrink-0" />
-              <p className="text-xs">{recordingError || playbackError?.message}</p>
-            </div>
-          </div>
-        )}
-        
-        {/* Main controls row */}
-        <div className="flex items-center justify-between gap-2 p-3">
-          {/* Left: Lyrics button */}
-          <Button
-            size="icon"
-            variant={showLyrics ? "secondary" : "ghost"}
-            onClick={handleLyricsToggle}
-            className="size-10 rounded-full shrink-0"
-          >
-            <FileText className="size-4" />
-          </Button>
-          
-          {/* Center: Record/Stop button */}
-          <div className="flex items-center gap-2">
-            {!isRecording && !hasRecording && (
-              <Button
-                onClick={startRecording}
-                disabled={isPublishing}
-                className="rounded-full px-6 bg-purple-500 hover:bg-purple-600"
-              >
-                <Mic className="size-4 mr-2" />
-                Sing
-              </Button>
-            )}
-            
-            {isRecording && (
-              <Button
-                onClick={stopRecording}
-                variant="destructive"
-                className="rounded-full px-6"
-              >
-                <Square className="size-4 mr-2" />
-                Stop
-              </Button>
-            )}
-            
-            {hasRecording && !isRecording && (
-              <>
-                <Button
-                  onClick={resetRecording}
-                  variant="outline"
-                  size="icon"
-                  className="size-10 rounded-full"
-                >
-                  <RefreshCw className="size-4" />
-                </Button>
-                
-                <Button
-                  onClick={handleConfirm}
-                  disabled={!canConfirm}
-                  className="rounded-full px-6 bg-purple-500 hover:bg-purple-600"
-                >
-                  {isPublishing ? (
-                    <Loader2 className="size-4 mr-2 animate-spin" />
-                  ) : (
-                    <Check className="size-4 mr-2" />
-                  )}
-                  {isPublishing ? 'Singing...' : 'Sing for Blobbi'}
-                </Button>
-              </>
-            )}
-          </div>
-          
-          {/* Right: Preview button (when recording exists) */}
-          {hasRecording ? (
-            <Button
-              size="icon"
-              variant="ghost"
-              onClick={handlePreview}
-              disabled={isPublishing}
-              className="size-10 rounded-full shrink-0"
-            >
-              {isPlaying ? (
-                <Pause className="size-4" />
-              ) : (
-                <Play className="size-4 ml-0.5" />
-              )}
-            </Button>
-          ) : (
-            /* Close button when no recording */
-            <Button
-              size="icon"
-              variant="ghost"
-              onClick={handleClose}
-              className="size-10 rounded-full shrink-0 text-muted-foreground hover:text-foreground"
-            >
-              <X className="size-4" />
-            </Button>
-          )}
-        </div>
-        
-        {/* Close button row when recording exists */}
-        {hasRecording && (
-          <div className="px-3 pb-3 pt-0 flex justify-end">
-            <Button
-              size="sm"
-              variant="ghost"
-              onClick={handleClose}
-              disabled={isPublishing}
-              className="text-muted-foreground hover:text-foreground"
-            >
-              <X className="size-3 mr-1" />
-              Cancel
-            </Button>
-          </div>
-        )}
-      </div>
-    </div>
-  );
-}

src/blobbi/actions/components/PlayMusicModal.tsx

@@ -1,301 +0,0 @@
-// src/blobbi/actions/components/PlayMusicModal.tsx
-
-import { useState, useRef, useCallback, useEffect } from 'react';
-import { Music, Play, Pause, Check, Loader2, Volume2, AlertCircle } from 'lucide-react';
-
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { cn } from '@/lib/utils';
-
-import {
-  getAllTracks,
-  formatTrackDuration,
-  type BlobbiTrack,
-} from '../lib/blobbi-track-catalog';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Selected track for the music player
- */
-export interface SelectedTrack {
-  track: BlobbiTrack;
-  url: string;
-}
-
-interface PlayMusicModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  /** Called with the selected track when user confirms */
-  onConfirm: (selection: SelectedTrack) => void;
-  isLoading: boolean;
-}
-
-// ─── Component ────────────────────────────────────────────────────────────────
-
-export function PlayMusicModal({
-  open,
-  onOpenChange,
-  onConfirm,
-  isLoading,
-}: PlayMusicModalProps) {
-  const [selectedTrack, setSelectedTrack] = useState<SelectedTrack | null>(null);
-  const [isPlaying, setIsPlaying] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const audioRef = useRef<HTMLAudioElement | null>(null);
-  
-  // Track the current audio source URL to detect changes
-  const currentAudioUrlRef = useRef<string | null>(null);
-  
-  const tracks = getAllTracks();
-  
-  // Cleanup audio on unmount
-  useEffect(() => {
-    return () => {
-      if (audioRef.current) {
-        audioRef.current.pause();
-        audioRef.current = null;
-      }
-    };
-  }, []);
-  
-  // Reset state when modal opens
-  useEffect(() => {
-    if (open) {
-      setSelectedTrack(null);
-      setIsPlaying(false);
-      setError(null);
-      currentAudioUrlRef.current = null;
-    }
-  }, [open]);
-  
-  // Handle selecting a track
-  const handleSelectTrack = useCallback((track: BlobbiTrack) => {
-    // Stop current playback
-    if (audioRef.current) {
-      audioRef.current.pause();
-      setIsPlaying(false);
-    }
-    
-    setSelectedTrack({ track, url: track.url });
-    setError(null);
-  }, []);
-  
-  // Handle play/pause preview
-  const handleTogglePlay = useCallback(() => {
-    if (!selectedTrack) return;
-    
-    const audioUrl = selectedTrack.url;
-    
-    // Check if we need to create a new Audio instance (source changed or first time)
-    const needsNewAudio = !audioRef.current || currentAudioUrlRef.current !== audioUrl;
-    
-    if (needsNewAudio) {
-      // Stop and cleanup old audio if exists
-      if (audioRef.current) {
-        audioRef.current.pause();
-        audioRef.current.onended = null;
-        audioRef.current.onerror = null;
-      }
-      
-      // Create new Audio instance with the correct source
-      audioRef.current = new Audio(audioUrl);
-      currentAudioUrlRef.current = audioUrl;
-      
-      audioRef.current.onended = () => setIsPlaying(false);
-      audioRef.current.onerror = () => {
-        setError('Failed to load this track. Please try another one.');
-        setIsPlaying(false);
-      };
-    }
-    
-    if (isPlaying && !needsNewAudio) {
-      // Pause current playback
-      audioRef.current?.pause();
-      setIsPlaying(false);
-    } else {
-      // Start playback (either new source or resuming)
-      audioRef.current?.play().catch(() => {
-        setError('Failed to play this track. Please try another one.');
-        setIsPlaying(false);
-      });
-      setIsPlaying(true);
-    }
-  }, [selectedTrack, isPlaying]);
-  
-  // Handle confirm
-  const handleConfirm = useCallback(() => {
-    if (!selectedTrack) return;
-    
-    // Stop playback
-    if (audioRef.current) {
-      audioRef.current.pause();
-      setIsPlaying(false);
-    }
-    onConfirm(selectedTrack);
-  }, [selectedTrack, onConfirm]);
-  
-  // Handle close
-  const handleClose = useCallback((isOpen: boolean) => {
-    if (!isOpen && audioRef.current) {
-      audioRef.current.pause();
-      setIsPlaying(false);
-    }
-    onOpenChange(isOpen);
-  }, [onOpenChange]);
-
-  return (
-    <Dialog open={open} onOpenChange={handleClose}>
-      <DialogContent className="max-w-md max-h-[85vh] flex flex-col p-0">
-        {/* Header */}
-        <DialogHeader className="px-6 pt-6 pb-4 border-b">
-          <div className="flex items-center gap-3">
-            <div className="size-10 rounded-xl bg-gradient-to-br from-pink-500/20 to-pink-500/5 flex items-center justify-center">
-              <Music className="size-5 text-pink-500" />
-            </div>
-            <div>
-              <DialogTitle className="text-xl">Play Music</DialogTitle>
-              <p className="text-sm text-muted-foreground">
-                Choose a track to play for your Blobbi
-              </p>
-            </div>
-          </div>
-        </DialogHeader>
-
-        {/* Content - Track List */}
-        <div className="flex-1 overflow-y-auto px-6 py-4">
-          <div className="grid gap-2">
-            {tracks.map((track) => (
-              <TrackRow
-                key={track.id}
-                track={track}
-                isSelected={selectedTrack?.track.id === track.id}
-                onSelect={() => handleSelectTrack(track)}
-              />
-            ))}
-          </div>
-          {error && (
-            <div className="mt-4 p-3 rounded-lg bg-amber-500/10 border border-amber-500/30">
-              <div className="flex items-start gap-2">
-                <AlertCircle className="size-4 text-amber-500 mt-0.5 shrink-0" />
-                <p className="text-sm text-amber-600 dark:text-amber-400">{error}</p>
-              </div>
-            </div>
-          )}
-        </div>
-
-        {/* Footer */}
-        <div className="px-6 py-4 border-t bg-muted/30">
-          {/* Preview Controls */}
-          {selectedTrack && (
-            <div className="mb-4 p-3 rounded-lg bg-card border">
-              <div className="flex items-center gap-3">
-                <Button
-                  size="icon"
-                  variant="outline"
-                  onClick={handleTogglePlay}
-                  className="size-10 rounded-full shrink-0"
-                >
-                  {isPlaying ? (
-                    <Pause className="size-4" />
-                  ) : (
-                    <Play className="size-4 ml-0.5" />
-                  )}
-                </Button>
-                <div className="flex-1 min-w-0">
-                  <p className="font-medium truncate text-sm">{selectedTrack.track.title}</p>
-                  <p className="text-xs text-muted-foreground">
-                    {isPlaying ? 'Now playing...' : 'Click to preview'}
-                  </p>
-                </div>
-                {isPlaying && (
-                  <Volume2 className="size-4 text-primary animate-pulse shrink-0" />
-                )}
-              </div>
-            </div>
-          )}
-          
-          {/* Action Buttons */}
-          <div className="flex gap-3">
-            <Button
-              variant="outline"
-              onClick={() => handleClose(false)}
-              className="flex-1"
-              disabled={isLoading}
-            >
-              Cancel
-            </Button>
-            <Button
-              onClick={handleConfirm}
-              disabled={!selectedTrack || isLoading}
-              className="flex-1"
-            >
-              {isLoading ? (
-                <>
-                  <Loader2 className="size-4 mr-2 animate-spin" />
-                  Playing...
-                </>
-              ) : (
-                <>
-                  <Music className="size-4 mr-2" />
-                  Play for Blobbi
-                </>
-              )}
-            </Button>
-          </div>
-        </div>
-      </DialogContent>
-    </Dialog>
-  );
-}
-
-// ─── Track Row Component ──────────────────────────────────────────────────────
-
-interface TrackRowProps {
-  track: BlobbiTrack;
-  isSelected: boolean;
-  onSelect: () => void;
-}
-
-function TrackRow({ track, isSelected, onSelect }: TrackRowProps) {
-  return (
-    <button
-      type="button"
-      onClick={onSelect}
-      className={cn(
-        "w-full p-3 rounded-xl text-left transition-all",
-        "border hover:border-primary/30",
-        isSelected 
-          ? "border-primary bg-primary/5 ring-2 ring-primary/20" 
-          : "border-border bg-card/60"
-      )}
-    >
-      <div className="flex items-center gap-3">
-        <div className={cn(
-          "size-10 rounded-lg flex items-center justify-center",
-          isSelected ? "bg-primary/20" : "bg-muted"
-        )}>
-          <Music className={cn(
-            "size-5",
-            isSelected ? "text-primary" : "text-muted-foreground"
-          )} />
-        </div>
-        <div className="flex-1 min-w-0">
-          <p className="font-medium truncate">{track.title}</p>
-          <p className="text-sm text-muted-foreground">{track.artist}</p>
-        </div>
-        <div className="flex items-center gap-2 shrink-0">
-          <span className="text-sm text-muted-foreground">
-            {formatTrackDuration(track.durationSeconds)}
-          </span>
-          {isSelected && <Check className="size-4 text-primary" />}
-        </div>
-      </div>
-    </button>
-  );
-}

src/blobbi/actions/components/SingModal.tsx

@@ -1,601 +0,0 @@
-// src/blobbi/actions/components/SingModal.tsx
-
-import { useState, useRef, useCallback, useEffect } from 'react';
-import { Mic, MicOff, Play, Pause, Square, Loader2, AlertCircle, RotateCcw, Sparkles, ChevronDown, ChevronUp } from 'lucide-react';
-
-import {
-  Dialog,
-  DialogContent,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog';
-import { Button } from '@/components/ui/button';
-import { cn } from '@/lib/utils';
-
-import { getRandomLyrics, type LyricsEntry } from '../lib/blobbi-random-lyrics';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface SingModalProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  onConfirm: () => void;
-  isLoading: boolean;
-}
-
-type RecordingState = 'idle' | 'requesting' | 'recording' | 'recorded' | 'playing' | 'error';
-
-// ─── MIME Type Selection Helper ───────────────────────────────────────────────
-
-/**
- * Ordered list of MIME types to try for audio recording.
- * The first supported type will be used.
- */
-const AUDIO_MIME_CANDIDATES = [
-  'audio/webm;codecs=opus',
-  'audio/webm',
-  'audio/mp4',
-  'audio/ogg;codecs=opus',
-  'audio/ogg',
-] as const;
-
-/**
- * Get the first supported MIME type for MediaRecorder.
- * Returns undefined if no explicit MIME type is supported (let browser decide).
- */
-function getSupportedAudioMimeType(): string | undefined {
-  if (typeof MediaRecorder === 'undefined') {
-    return undefined;
-  }
-  
-  for (const mimeType of AUDIO_MIME_CANDIDATES) {
-    if (MediaRecorder.isTypeSupported(mimeType)) {
-      return mimeType;
-    }
-  }
-  
-  // No explicit MIME type supported, let browser use default
-  return undefined;
-}
-
-// ─── Component ────────────────────────────────────────────────────────────────
-
-export function SingModal({
-  open,
-  onOpenChange,
-  onConfirm,
-  isLoading,
-}: SingModalProps) {
-  const [recordingState, setRecordingState] = useState<RecordingState>('idle');
-  const [error, setError] = useState<string | null>(null);
-  const [playbackError, setPlaybackError] = useState<string | null>(null);
-  const [recordingDuration, setRecordingDuration] = useState(0);
-  const [audioUrl, setAudioUrl] = useState<string | null>(null);
-  const [currentLyrics, setCurrentLyrics] = useState<LyricsEntry | null>(null);
-  const [showLyrics, setShowLyrics] = useState(false);
-  
-  const mediaRecorderRef = useRef<MediaRecorder | null>(null);
-  const chunksRef = useRef<Blob[]>([]);
-  const streamRef = useRef<MediaStream | null>(null);
-  const audioRef = useRef<HTMLAudioElement | null>(null);
-  const timerRef = useRef<ReturnType<typeof setInterval> | null>(null);
-  // Track the actual MIME type used by the recorder
-  const actualMimeTypeRef = useRef<string | undefined>(undefined);
-  
-  // Cleanup on unmount
-  useEffect(() => {
-    return () => {
-      cleanup();
-    };
-  }, []);
-  
-  // Reset state when modal opens
-  useEffect(() => {
-    if (open) {
-      resetRecording();
-    } else {
-      cleanup();
-    }
-  }, [open]);
-  
-  const cleanup = useCallback(() => {
-    // Stop timer
-    if (timerRef.current) {
-      clearInterval(timerRef.current);
-      timerRef.current = null;
-    }
-    
-    // Stop media recorder
-    if (mediaRecorderRef.current && mediaRecorderRef.current.state !== 'inactive') {
-      mediaRecorderRef.current.stop();
-    }
-    mediaRecorderRef.current = null;
-    
-    // Stop stream tracks
-    if (streamRef.current) {
-      streamRef.current.getTracks().forEach(track => track.stop());
-      streamRef.current = null;
-    }
-    
-    // Stop audio playback
-    if (audioRef.current) {
-      audioRef.current.pause();
-      audioRef.current = null;
-    }
-    
-    // Revoke URL
-    if (audioUrl) {
-      URL.revokeObjectURL(audioUrl);
-    }
-  }, [audioUrl]);
-  
-  const resetRecording = useCallback(() => {
-    cleanup();
-    setRecordingState('idle');
-    setError(null);
-    setPlaybackError(null);
-    setRecordingDuration(0);
-    setAudioUrl(null);
-    chunksRef.current = [];
-    currentPlaybackUrlRef.current = null;
-    actualMimeTypeRef.current = undefined;
-    // Keep lyrics when re-recording so user can sing the same song
-  }, [cleanup]);
-  
-  // Handle getting random lyrics
-  const handleRandomLyrics = useCallback(() => {
-    const lyrics = getRandomLyrics();
-    setCurrentLyrics(lyrics);
-    setShowLyrics(true);
-  }, []);
-  
-  // Check if browser supports media recording
-  const checkRecordingSupport = (): boolean => {
-    if (typeof navigator === 'undefined') return false;
-    if (!navigator.mediaDevices) return false;
-    if (!navigator.mediaDevices.getUserMedia) return false;
-    if (typeof MediaRecorder === 'undefined') return false;
-    return true;
-  };
-  
-  // Start recording
-  const startRecording = useCallback(async () => {
-    if (!checkRecordingSupport()) {
-      setError('Audio recording is not supported in this browser.');
-      setRecordingState('error');
-      return;
-    }
-    
-    setRecordingState('requesting');
-    setError(null);
-    setPlaybackError(null);
-    
-    try {
-      const stream = await navigator.mediaDevices.getUserMedia({ 
-        audio: {
-          echoCancellation: true,
-          noiseSuppression: true,
-          autoGainControl: true,
-        }
-      });
-      
-      streamRef.current = stream;
-      chunksRef.current = [];
-      
-      // Get the first supported MIME type using our helper
-      const supportedMimeType = getSupportedAudioMimeType();
-      
-      // Create MediaRecorder with or without explicit MIME type
-      let mediaRecorder: MediaRecorder;
-      if (supportedMimeType) {
-        mediaRecorder = new MediaRecorder(stream, { mimeType: supportedMimeType });
-      } else {
-        // Let browser choose default MIME type
-        mediaRecorder = new MediaRecorder(stream);
-      }
-      
-      // Store the actual MIME type being used (may differ from what we requested)
-      actualMimeTypeRef.current = mediaRecorder.mimeType || supportedMimeType;
-      mediaRecorderRef.current = mediaRecorder;
-      
-      mediaRecorder.ondataavailable = (event) => {
-        if (event.data.size > 0) {
-          chunksRef.current.push(event.data);
-        }
-      };
-      
-      mediaRecorder.onstop = () => {
-        // Create blob from chunks using the actual MIME type used by the recorder
-        const blobMimeType = actualMimeTypeRef.current || 'audio/webm';
-        const blob = new Blob(chunksRef.current, { type: blobMimeType });
-        const url = URL.createObjectURL(blob);
-        setAudioUrl(url);
-        setRecordingState('recorded');
-        
-        // Stop stream tracks
-        if (streamRef.current) {
-          streamRef.current.getTracks().forEach(track => track.stop());
-          streamRef.current = null;
-        }
-      };
-      
-      mediaRecorder.onerror = () => {
-        setError('Recording failed. Please try again.');
-        setRecordingState('error');
-      };
-      
-      // Start recording
-      mediaRecorder.start(100); // Collect data every 100ms
-      setRecordingState('recording');
-      setRecordingDuration(0);
-      
-      // Start timer
-      timerRef.current = setInterval(() => {
-        setRecordingDuration(prev => prev + 1);
-      }, 1000);
-      
-    } catch (err) {
-      if (err instanceof Error) {
-        if (err.name === 'NotAllowedError' || err.name === 'PermissionDeniedError') {
-          setError('Microphone access was denied. Please allow microphone access and try again.');
-        } else if (err.name === 'NotFoundError') {
-          setError('No microphone found. Please connect a microphone and try again.');
-        } else {
-          setError(`Failed to access microphone: ${err.message}`);
-        }
-      } else {
-        setError('Failed to access microphone. Please try again.');
-      }
-      setRecordingState('error');
-    }
-  }, []);
-  
-  // Stop recording
-  const stopRecording = useCallback(() => {
-    if (timerRef.current) {
-      clearInterval(timerRef.current);
-      timerRef.current = null;
-    }
-    
-    if (mediaRecorderRef.current && mediaRecorderRef.current.state !== 'inactive') {
-      mediaRecorderRef.current.stop();
-    }
-  }, []);
-  
-  // Track the current audio URL to detect changes
-  const currentPlaybackUrlRef = useRef<string | null>(null);
-  
-  // Play/pause preview
-  const togglePlayback = useCallback(() => {
-    if (!audioUrl) return;
-    
-    // Clear previous playback error when attempting to play
-    setPlaybackError(null);
-    
-    if (recordingState === 'playing') {
-      if (audioRef.current) {
-        audioRef.current.pause();
-      }
-      setRecordingState('recorded');
-    } else {
-      // Check if we need to create a new Audio instance (URL changed or first time)
-      const needsNewAudio = !audioRef.current || currentPlaybackUrlRef.current !== audioUrl;
-      
-      if (needsNewAudio) {
-        // Cleanup old audio if exists
-        if (audioRef.current) {
-          audioRef.current.pause();
-          audioRef.current.onended = null;
-          audioRef.current.onerror = null;
-        }
-        
-        // Create new Audio instance with the recorded audio URL
-        audioRef.current = new Audio(audioUrl);
-        currentPlaybackUrlRef.current = audioUrl;
-        audioRef.current.onended = () => setRecordingState('recorded');
-        
-        // Handle playback errors with user-visible message
-        audioRef.current.onerror = () => {
-          setPlaybackError('This browser could not play the recorded audio preview. Your recording was still created successfully.');
-          setRecordingState('recorded');
-        };
-      }
-      
-      audioRef.current?.play()
-        .then(() => {
-          setRecordingState('playing');
-        })
-        .catch((err) => {
-          console.error('Failed to play recording:', err);
-          // Provide user-friendly error message
-          if (err.name === 'NotSupportedError') {
-            setPlaybackError('Recording was created, but playback preview is not supported in this browser.');
-          } else if (err.name === 'NotAllowedError') {
-            setPlaybackError('Playback was blocked. Try interacting with the page first.');
-          } else {
-            setPlaybackError('Could not play the recording preview. Your recording was still created successfully.');
-          }
-          setRecordingState('recorded');
-        });
-    }
-  }, [audioUrl, recordingState]);
-  
-  // Handle confirm
-  const handleConfirm = useCallback(() => {
-    if (audioRef.current) {
-      audioRef.current.pause();
-    }
-    onConfirm();
-  }, [onConfirm]);
-  
-  // Handle close
-  const handleClose = useCallback((isOpen: boolean) => {
-    if (!isOpen) {
-      cleanup();
-    }
-    onOpenChange(isOpen);
-  }, [onOpenChange, cleanup]);
-  
-  // Format duration
-  const formatDuration = (seconds: number) => {
-    const mins = Math.floor(seconds / 60);
-    const secs = seconds % 60;
-    return `${mins}:${secs.toString().padStart(2, '0')}`;
-  };
-  
-  const hasRecording = recordingState === 'recorded' || recordingState === 'playing';
-
-  return (
-    <Dialog open={open} onOpenChange={handleClose}>
-      <DialogContent className="max-w-md max-h-[85vh] flex flex-col p-0">
-        {/* Header */}
-        <DialogHeader className="px-6 pt-6 pb-4 border-b">
-          <div className="flex items-center gap-3">
-            <div className="size-10 rounded-xl bg-gradient-to-br from-purple-500/20 to-purple-500/5 flex items-center justify-center">
-              <Mic className="size-5 text-purple-500" />
-            </div>
-            <div>
-              <DialogTitle className="text-xl">Sing</DialogTitle>
-              <p className="text-sm text-muted-foreground">
-                Record yourself singing for your Blobbi
-              </p>
-            </div>
-          </div>
-        </DialogHeader>
-
-        {/* Content */}
-        <div className="flex-1 px-6 py-8">
-          <div className="flex flex-col items-center justify-center gap-6">
-            {/* Recording Visualization */}
-            <div className={cn(
-              "relative size-40 rounded-full flex items-center justify-center transition-all",
-              recordingState === 'recording' && "animate-pulse",
-              recordingState === 'recording' 
-                ? "bg-red-500/10 ring-4 ring-red-500/30" 
-                : hasRecording
-                ? "bg-purple-500/10 ring-4 ring-purple-500/30"
-                : "bg-muted"
-            )}>
-              {/* Animated rings for recording */}
-              {recordingState === 'recording' && (
-                <>
-                  <div className="absolute inset-0 rounded-full bg-red-500/10 animate-ping" />
-                  <div className="absolute inset-4 rounded-full bg-red-500/10 animate-ping animation-delay-150" />
-                </>
-              )}
-              
-              {/* Icon */}
-              <div className={cn(
-                "relative size-20 rounded-full flex items-center justify-center",
-                recordingState === 'recording' 
-                  ? "bg-red-500 text-white" 
-                  : hasRecording
-                  ? "bg-purple-500 text-white"
-                  : "bg-muted-foreground/20"
-              )}>
-                {recordingState === 'requesting' ? (
-                  <Loader2 className="size-8 animate-spin" />
-                ) : recordingState === 'recording' ? (
-                  <Mic className="size-8" />
-                ) : hasRecording ? (
-                  recordingState === 'playing' ? (
-                    <Pause className="size-8" />
-                  ) : (
-                    <Play className="size-8 ml-1" />
-                  )
-                ) : (
-                  <MicOff className="size-8 text-muted-foreground" />
-                )}
-              </div>
-            </div>
-            
-            {/* Duration / Status */}
-            <div className="text-center">
-              {recordingState === 'idle' && (
-                <p className="text-muted-foreground">Tap the button below to start recording</p>
-              )}
-              {recordingState === 'requesting' && (
-                <p className="text-muted-foreground">Requesting microphone access...</p>
-              )}
-              {recordingState === 'recording' && (
-                <>
-                  <p className="text-3xl font-mono font-bold text-red-500">
-                    {formatDuration(recordingDuration)}
-                  </p>
-                  <p className="text-sm text-muted-foreground mt-1">Recording...</p>
-                </>
-              )}
-              {hasRecording && (
-                <>
-                  <p className="text-3xl font-mono font-bold text-purple-500">
-                    {formatDuration(recordingDuration)}
-                  </p>
-                  <p className="text-sm text-muted-foreground mt-1">
-                    {recordingState === 'playing' ? 'Playing...' : 'Tap to preview'}
-                  </p>
-                </>
-              )}
-              {recordingState === 'error' && (
-                <p className="text-destructive">Recording failed</p>
-              )}
-            </div>
-            
-            {/* Error Message */}
-            {error && (
-              <div className="w-full p-3 rounded-lg bg-destructive/10 border border-destructive/30">
-                <div className="flex items-start gap-2">
-                  <AlertCircle className="size-4 text-destructive mt-0.5 shrink-0" />
-                  <p className="text-sm text-destructive">{error}</p>
-                </div>
-              </div>
-            )}
-            
-            {/* Playback Error Message (non-fatal, recording still works) */}
-            {playbackError && (
-              <div className="w-full p-3 rounded-lg bg-amber-500/10 border border-amber-500/30">
-                <div className="flex items-start gap-2">
-                  <AlertCircle className="size-4 text-amber-500 mt-0.5 shrink-0" />
-                  <p className="text-sm text-amber-600 dark:text-amber-400">{playbackError}</p>
-                </div>
-              </div>
-            )}
-            
-            {/* Lyrics Helper */}
-            <div className="w-full">
-              {!currentLyrics ? (
-                <Button
-                  variant="outline"
-                  size="sm"
-                  onClick={handleRandomLyrics}
-                  className="w-full gap-2"
-                >
-                  <Sparkles className="size-4" />
-                  Need lyrics? Get random lyrics
-                </Button>
-              ) : (
-                <div className="rounded-lg border bg-card/60">
-                  <button
-                    type="button"
-                    onClick={() => setShowLyrics(!showLyrics)}
-                    className="w-full flex items-center justify-between p-3 text-left"
-                  >
-                    <div className="flex items-center gap-2">
-                      <Sparkles className="size-4 text-purple-500" />
-                      <span className="font-medium text-sm">{currentLyrics.title}</span>
-                    </div>
-                    {showLyrics ? (
-                      <ChevronUp className="size-4 text-muted-foreground" />
-                    ) : (
-                      <ChevronDown className="size-4 text-muted-foreground" />
-                    )}
-                  </button>
-                  {showLyrics && (
-                    <div className="px-3 pb-3 pt-0">
-                      <div className="p-3 rounded-md bg-muted/50 text-sm leading-relaxed whitespace-pre-line">
-                        {currentLyrics.lines.join('\n')}
-                      </div>
-                      <Button
-                        variant="ghost"
-                        size="sm"
-                        onClick={handleRandomLyrics}
-                        className="w-full mt-2 gap-2 text-muted-foreground"
-                      >
-                        <RotateCcw className="size-3" />
-                        Get different lyrics
-                      </Button>
-                    </div>
-                  )}
-                </div>
-              )}
-            </div>
-            
-            {/* Recording Controls */}
-            <div className="flex items-center gap-3">
-              {recordingState === 'idle' || recordingState === 'error' ? (
-                <Button
-                  size="lg"
-                  onClick={startRecording}
-                  className="rounded-full px-8 bg-purple-500 hover:bg-purple-600"
-                >
-                  <Mic className="size-5 mr-2" />
-                  Start Recording
-                </Button>
-              ) : recordingState === 'recording' ? (
-                <Button
-                  size="lg"
-                  variant="destructive"
-                  onClick={stopRecording}
-                  className="rounded-full px-8"
-                >
-                  <Square className="size-5 mr-2" />
-                  Stop
-                </Button>
-              ) : hasRecording ? (
-                <>
-                  <Button
-                    size="lg"
-                    variant="outline"
-                    onClick={togglePlayback}
-                    className="rounded-full"
-                  >
-                    {recordingState === 'playing' ? (
-                      <>
-                        <Pause className="size-5 mr-2" />
-                        Pause
-                      </>
-                    ) : (
-                      <>
-                        <Play className="size-5 mr-2" />
-                        Preview
-                      </>
-                    )}
-                  </Button>
-                  <Button
-                    size="lg"
-                    variant="ghost"
-                    onClick={resetRecording}
-                    className="rounded-full"
-                  >
-                    <RotateCcw className="size-5 mr-2" />
-                    Re-record
-                  </Button>
-                </>
-              ) : null}
-            </div>
-          </div>
-        </div>
-
-        {/* Footer */}
-        <div className="px-6 py-4 border-t bg-muted/30">
-          <div className="flex gap-3">
-            <Button
-              variant="outline"
-              onClick={() => handleClose(false)}
-              className="flex-1"
-              disabled={isLoading}
-            >
-              Cancel
-            </Button>
-            <Button
-              onClick={handleConfirm}
-              disabled={!hasRecording || isLoading}
-              className="flex-1"
-            >
-              {isLoading ? (
-                <>
-                  <Loader2 className="size-4 mr-2 animate-spin" />
-                  Singing...
-                </>
-              ) : (
-                <>
-                  <Mic className="size-4 mr-2" />
-                  Sing for Blobbi
-                </>
-              )}
-            </Button>
-          </div>
-        </div>
-      </DialogContent>
-    </Dialog>
-  );
-}

src/blobbi/actions/components/StartEvolutionDialog.tsx

@@ -1,125 +0,0 @@
-// src/blobbi/actions/components/StartEvolutionDialog.tsx
-
-/**
- * Dialog for confirming start of evolution.
- * 
- * Evolution is simpler than incubation:
- * - Only baby Blobbis can evolve
- * - Shows restart confirmation if already evolving
- * - Otherwise shows normal start confirmation
- */
-
-import { Loader2, AlertTriangle, Sparkles } from 'lucide-react';
-
-import {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogTitle,
-} from '@/components/ui/alert-dialog';
-
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface StartEvolutionDialogProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  /** The companion to start evolving */
-  companion: BlobbiCompanion | null;
-  /** Called when confirmed */
-  onConfirm: () => void;
-  isPending: boolean;
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function StartEvolutionDialog({
-  open,
-  onOpenChange,
-  companion,
-  onConfirm,
-  isPending,
-}: StartEvolutionDialogProps) {
-  // Check if the current Blobbi is already evolving
-  const isAlreadyEvolving = companion?.state === 'evolving';
-  
-  // Determine title and description based on state
-  const getDialogContent = () => {
-    if (isAlreadyEvolving) {
-      return {
-        title: 'Restart Evolution?',
-        icon: <AlertTriangle className="size-5 text-amber-500" />,
-        description: (
-          <>
-            <strong>{companion?.name}</strong> is already evolving. Starting over will{' '}
-            <strong>reset all task progress</strong> and begin from the beginning.
-            <br /><br />
-            Are you sure you want to restart?
-          </>
-        ),
-        buttonText: 'Restart Evolution',
-        buttonClass: 'bg-amber-500 hover:bg-amber-600 text-white',
-      };
-    }
-    
-    return {
-      title: 'Start Evolution',
-      icon: <Sparkles className="size-5 text-primary" />,
-      description: (
-        <>
-          Starting evolution begins <strong>{companion?.name}</strong>'s transformation journey.
-          Complete all the tasks to evolve your baby Blobbi into an adult!
-          <br /><br />
-          Ready to begin?
-        </>
-      ),
-      buttonText: 'Start Evolution',
-      buttonClass: 'bg-gradient-to-r from-violet-500 to-purple-500 hover:from-violet-600 hover:to-purple-600 text-white',
-    };
-  };
-  
-  const content = getDialogContent();
-  
-  return (
-    <AlertDialog open={open} onOpenChange={onOpenChange}>
-      <AlertDialogContent>
-        <AlertDialogHeader>
-          <AlertDialogTitle className="flex items-center gap-2">
-            {content.icon}
-            {content.title}
-          </AlertDialogTitle>
-          <AlertDialogDescription>
-            {content.description}
-          </AlertDialogDescription>
-        </AlertDialogHeader>
-        <AlertDialogFooter>
-          <AlertDialogCancel disabled={isPending}>
-            Cancel
-          </AlertDialogCancel>
-          <AlertDialogAction
-            onClick={(e) => {
-              e.preventDefault();
-              onConfirm();
-            }}
-            disabled={isPending}
-            className={content.buttonClass}
-          >
-            {isPending ? (
-              <>
-                <Loader2 className="size-4 mr-2 animate-spin" />
-                Starting...
-              </>
-            ) : (
-              content.buttonText
-            )}
-          </AlertDialogAction>
-        </AlertDialogFooter>
-      </AlertDialogContent>
-    </AlertDialog>
-  );
-}

src/blobbi/actions/components/StartIncubationDialog.tsx

@@ -1,180 +0,0 @@
-// src/blobbi/actions/components/StartIncubationDialog.tsx
-
-/**
- * Dialog for confirming start of incubation.
- * 
- * Determines the mode and passes it explicitly to the confirm callback:
- * - 'start': Normal start, no other Blobbi incubating
- * - 'restart': Restart same Blobbi (already incubating)
- * - 'switch': Stop another Blobbi first, then start this one
- * 
- * The mode is determined by UI state, NOT auto-detected by the hook.
- * This makes the flow explicit and predictable.
- */
-
-import { useMemo } from 'react';
-import { Loader2, AlertTriangle, ArrowRightLeft } from 'lucide-react';
-
-import {
-  AlertDialog,
-  AlertDialogAction,
-  AlertDialogCancel,
-  AlertDialogContent,
-  AlertDialogDescription,
-  AlertDialogFooter,
-  AlertDialogHeader,
-  AlertDialogTitle,
-} from '@/components/ui/alert-dialog';
-
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-import type { StartIncubationMode } from '../hooks/useBlobbiIncubation';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface StartIncubationDialogProps {
-  open: boolean;
-  onOpenChange: (open: boolean) => void;
-  /** The companion to start incubating */
-  companion: BlobbiCompanion | null;
-  /** All companions in the collection (to check for other incubating Blobbis) */
-  companions?: BlobbiCompanion[];
-  /** Called with explicit mode and optional stopOtherD when confirmed */
-  onConfirm: (mode: StartIncubationMode, stopOtherD?: string) => void;
-  isPending: boolean;
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function StartIncubationDialog({
-  open,
-  onOpenChange,
-  companion,
-  companions = [],
-  onConfirm,
-  isPending,
-}: StartIncubationDialogProps) {
-  // Check if the current Blobbi is already in a task state
-  const isAlreadyInTaskState = companion?.state === 'incubating' || companion?.state === 'evolving';
-  
-  // Check if another Blobbi (not this one) is currently incubating
-  const otherIncubatingBlobbi = useMemo(() => {
-    if (!companion) return null;
-    return companions.find(c => 
-      c.d !== companion.d && 
-      c.state === 'incubating' &&
-      c.stage === 'egg'
-    ) ?? null;
-  }, [companion, companions]);
-  
-  // Determine the mode based on current state
-  const mode: StartIncubationMode = useMemo(() => {
-    if (isAlreadyInTaskState) return 'restart';
-    if (otherIncubatingBlobbi) return 'switch';
-    return 'start';
-  }, [isAlreadyInTaskState, otherIncubatingBlobbi]);
-  
-  // Handle confirm with explicit mode
-  const handleConfirm = () => {
-    if (mode === 'switch' && otherIncubatingBlobbi) {
-      onConfirm(mode, otherIncubatingBlobbi.d);
-    } else {
-      onConfirm(mode);
-    }
-  };
-  
-  // Determine title and description based on mode
-  const getDialogContent = () => {
-    if (mode === 'restart') {
-      return {
-        title: 'Restart Incubation?',
-        icon: <AlertTriangle className="size-5 text-amber-500" />,
-        description: (
-          <>
-            Your Blobbi is already {companion?.state}. Starting over will{' '}
-            <strong>reset all task progress</strong> and begin from the beginning.
-            <br /><br />
-            Are you sure you want to restart?
-          </>
-        ),
-        buttonText: 'Restart Incubation',
-        buttonClass: 'bg-amber-500 hover:bg-amber-600 text-white',
-      };
-    }
-    
-    if (mode === 'switch') {
-      return {
-        title: 'Switch Incubation?',
-        icon: <ArrowRightLeft className="size-5 text-amber-500" />,
-        description: (
-          <>
-            <strong>{otherIncubatingBlobbi?.name}</strong> is currently incubating.
-            Only one Blobbi can incubate at a time.
-            <br /><br />
-            Starting incubation for <strong>{companion?.name}</strong> will{' '}
-            <strong>stop {otherIncubatingBlobbi?.name}'s incubation</strong> and{' '}
-            reset their task progress.
-            <br /><br />
-            Do you want to switch?
-          </>
-        ),
-        buttonText: 'Switch & Start',
-        buttonClass: 'bg-amber-500 hover:bg-amber-600 text-white',
-      };
-    }
-    
-    return {
-      title: 'Start Incubation',
-      icon: null,
-      description: (
-        <>
-          Starting incubation begins your Blobbi's hatching journey. 
-          Complete all the tasks to hatch your egg into a baby Blobbi!
-          <br /><br />
-          Ready to begin?
-        </>
-      ),
-      buttonText: 'Start Incubation',
-      buttonClass: undefined,
-    };
-  };
-  
-  const content = getDialogContent();
-  
-  return (
-    <AlertDialog open={open} onOpenChange={onOpenChange}>
-      <AlertDialogContent>
-        <AlertDialogHeader>
-          <AlertDialogTitle className="flex items-center gap-2">
-            {content.icon}
-            {content.title}
-          </AlertDialogTitle>
-          <AlertDialogDescription>
-            {content.description}
-          </AlertDialogDescription>
-        </AlertDialogHeader>
-        <AlertDialogFooter>
-          <AlertDialogCancel disabled={isPending}>
-            Cancel
-          </AlertDialogCancel>
-          <AlertDialogAction
-            onClick={(e) => {
-              e.preventDefault();
-              handleConfirm();
-            }}
-            disabled={isPending}
-            className={content.buttonClass}
-          >
-            {isPending ? (
-              <>
-                <Loader2 className="size-4 mr-2 animate-spin" />
-                Starting...
-              </>
-            ) : (
-              content.buttonText
-            )}
-          </AlertDialogAction>
-        </AlertDialogFooter>
-      </AlertDialogContent>
-    </AlertDialog>
-  );
-}

src/blobbi/actions/components/TasksPanel.tsx

@@ -1,195 +0,0 @@
-// src/blobbi/actions/components/TasksPanel.tsx
-
-/**
- * Card-grid presentation for hatch / evolve tasks.
- *
- * Each task is a compact card in a 2-column grid.
- * Tapping a card expands it inline (full row) to reveal details.
- * Only one card is expanded at a time.
- */
-
-import { useState } from 'react';
-import { useNavigate } from 'react-router-dom';
-import {
-  Palette,
-  Droplets,
-  MessageSquare,
-  Heart,
-  UserPen,
-  Activity,
-  Loader2,
-  HelpCircle,
-} from 'lucide-react';
-import { openUrl } from '@/lib/downloadFile';
-
-import { Button } from '@/components/ui/button';
-
-import type { HatchTask } from '../hooks/useHatchTasks';
-import type { MissionCategory } from './ExpandableMissionCard';
-import {
-  ExpandableMissionCard,
-  MissionDescription,
-  MissionProgress,
-  MissionAction,
-  DynamicHint,
-} from './ExpandableMissionCard';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-interface TasksPanelProps {
-  tasks: HatchTask[];
-  allCompleted: boolean;
-  isLoading: boolean;
-  onOpenPostModal: () => void;
-  onComplete: () => void;
-  isCompleting?: boolean;
-  completeLabel: string;
-  completingLabel: string;
-  completeEmoji: string;
-  /** Mission category for styling the cards */
-  category?: MissionCategory;
-}
-
-// ─── Task Icon Mapping ────────────────────────────────────────────────────────
-
-/** Map task ids to lucide icons. Falls back to a generic icon. */
-function TaskIcon({ taskId }: { taskId: string }) {
-  const iconClass = 'size-5';
-
-  switch (taskId) {
-    case 'create_themes':
-      return <Palette className={iconClass} />;
-    case 'color_moments':
-      return <Droplets className={iconClass} />;
-    case 'create_posts':
-      return <MessageSquare className={iconClass} />;
-    case 'interactions':
-      return <Heart className={iconClass} />;
-    case 'edit_profile':
-      return <UserPen className={iconClass} />;
-    case 'maintain_stats':
-      return <Activity className={iconClass} />;
-    default:
-      return <HelpCircle className={iconClass} />;
-  }
-}
-
-// ─── Main Component ───────────────────────────────────────────────────────────
-
-export function TasksPanel({
-  tasks,
-  allCompleted,
-  isLoading,
-  onOpenPostModal,
-  onComplete,
-  isCompleting = false,
-  completeLabel,
-  completingLabel,
-  completeEmoji,
-  category = 'hatch',
-}: TasksPanelProps) {
-  const [expandedId, setExpandedId] = useState<string | null>(null);
-  const navigate = useNavigate();
-
-  const handleToggle = (id: string) => {
-    setExpandedId((prev) => (prev === id ? null : id));
-  };
-
-  if (isLoading) {
-    return (
-      <div className="flex items-center justify-center py-8">
-        <Loader2 className="size-5 animate-spin text-muted-foreground" />
-      </div>
-    );
-  }
-
-  return (
-    <div className="space-y-3">
-      {/* Card grid */}
-      <div className="grid grid-cols-2 sm:grid-cols-3 gap-2">
-        {tasks.map((task) => {
-          const isDynamic = task.type === 'dynamic';
-          const progress =
-            task.required > 0 ? task.current / task.required : task.completed ? 1 : 0;
-
-          const handleAction = () => {
-            if (!task.action || !task.actionTarget) return;
-            switch (task.action) {
-              case 'navigate':
-                navigate(task.actionTarget);
-                break;
-              case 'external_link':
-                openUrl(task.actionTarget);
-                break;
-              case 'open_modal':
-                if (task.actionTarget === 'blobbi_post') onOpenPostModal();
-                break;
-            }
-          };
-
-          return (
-            <ExpandableMissionCard
-              key={task.id}
-              id={task.id}
-              category={category}
-              icon={<TaskIcon taskId={task.id} />}
-              title={task.name}
-              completed={task.completed}
-              progress={Math.min(progress, 1)}
-              isExpanded={expandedId === task.id}
-              onToggle={handleToggle}
-            >
-              {/* Expanded content */}
-              <MissionDescription>{task.description}</MissionDescription>
-
-              {/* Progress bar for multi-step tasks */}
-              {task.required > 1 && !isDynamic && (
-                <MissionProgress
-                  current={task.current}
-                  required={task.required}
-                  completed={task.completed}
-                />
-              )}
-
-              {/* Dynamic stat hint */}
-              {isDynamic && !task.completed && (
-                <DynamicHint current={task.current} required={task.required} />
-              )}
-
-              {/* Action link */}
-              {task.action && task.actionLabel && !task.completed && (
-                <MissionAction
-                  label={task.actionLabel}
-                  type={task.action}
-                  onClick={handleAction}
-                />
-              )}
-            </ExpandableMissionCard>
-          );
-        })}
-      </div>
-
-      {/* CTA button when all tasks are done */}
-      {allCompleted && (
-        <Button
-          onClick={onComplete}
-          disabled={isCompleting}
-          size="lg"
-          className="w-full gap-2 bg-gradient-to-r from-amber-500 to-orange-500 hover:from-amber-600 hover:to-orange-600 text-white shadow-sm"
-        >
-          {isCompleting ? (
-            <>
-              <Loader2 className="size-5 animate-spin" />
-              {completingLabel}
-            </>
-          ) : (
-            <>
-              <span className="text-lg">{completeEmoji}</span>
-              {completeLabel}
-            </>
-          )}
-        </Button>
-      )}
-    </div>
-  );
-}

src/blobbi/actions/hooks/useActiveTaskProcess.ts

@@ -1,232 +0,0 @@
-// src/blobbi/actions/hooks/useActiveTaskProcess.ts
-
-/**
- * Central abstraction for the active task process (hatch or evolve).
- * 
- * This hook consolidates all scattered if/else logic for determining:
- * - Which process is active (incubating vs evolving)
- * - Which tasks to use (hatch vs evolve)
- * - Thresholds and configuration
- * - Badge-related computed values
- * 
- * ARCHITECTURE RULES:
- * - Computed tasks remain the source of truth
- * - Tags are cache only for PERSISTENT tasks
- * - Dynamic tasks are NEVER persisted
- * - Badge counts ALL incomplete tasks (persistent + dynamic)
- */
-
-import { useMemo } from 'react';
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-import type { HatchTask, HatchTasksResult } from './useHatchTasks';
-import type { EvolveTasksResult } from './useEvolveTasks';
-import { HATCH_REQUIRED_INTERACTIONS } from './useHatchTasks';
-import { EVOLVE_REQUIRED_INTERACTIONS } from './useEvolveTasks';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/** The type of task process currently active */
-export type TaskProcessType = 'hatch' | 'evolve' | null;
-
-/**
- * Configuration for the active task process.
- * This provides a unified interface regardless of whether
- * the process is hatch or evolve.
- */
-export interface TaskProcessConfig {
-  /** The type of process ('hatch' | 'evolve' | null) */
-  type: TaskProcessType;
-  /** Whether there is an active task process */
-  isActive: boolean;
-  /** Required interactions threshold for the current process */
-  interactionThreshold: number;
-}
-
-/**
- * Result of the active task process hook.
- * Provides unified access to all task-related state.
- */
-export interface ActiveTaskProcessResult {
-  /** Configuration for the current process */
-  config: TaskProcessConfig;
-  
-  /** All tasks for the current process (empty if no active process) */
-  tasks: HatchTask[];
-  /** Whether tasks are still loading */
-  isLoading: boolean;
-  /** Whether all tasks (persistent + dynamic) are complete */
-  allCompleted: boolean;
-  /** Whether all persistent tasks are complete */
-  persistentTasksComplete: boolean;
-  /** Whether the dynamic task is complete */
-  dynamicTaskComplete: boolean;
-  
-  /** Refetch function for current tasks */
-  refetch: () => void;
-  
-  // ─── Badge-related computed values ───
-  
-  /** 
-   * Count of ALL remaining incomplete tasks (persistent + dynamic).
-   * This is used for the badge display.
-   * Dynamic tasks ARE counted here but are NEVER synced to tags.
-   */
-  remainingTasksCount: number;
-  
-  /**
-   * Only persistent tasks that are incomplete.
-   * Used for sync logic - dynamic tasks must NEVER be synced.
-   */
-  incompletePersistentTasks: HatchTask[];
-  
-  /**
-   * Only persistent tasks that are complete.
-   * Used for sync logic.
-   */
-  completedPersistentTasks: HatchTask[];
-  
-  /**
-   * Stable string key of completed persistent task IDs.
-   * Used for sync anti-loop protection.
-   */
-  completedPersistentTaskIds: string;
-  
-  /**
-   * Tasks to sync (persistent only, with completion status).
-   * Dynamic tasks are excluded.
-   */
-  tasksToSync: Array<{ taskId: string; completed: boolean }>;
-}
-
-// ─── Helper Functions ─────────────────────────────────────────────────────────
-
-/**
- * Filter tasks to only persistent tasks.
- * Dynamic tasks must NEVER be synced to tags.
- */
-export function filterPersistentTasks(tasks: HatchTask[]): HatchTask[] {
-  return tasks.filter(t => t.type === 'persistent');
-}
-
-/**
- * Filter tasks to only dynamic tasks.
- */
-export function filterDynamicTasks(tasks: HatchTask[]): HatchTask[] {
-  return tasks.filter(t => t.type === 'dynamic');
-}
-
-// ─── Main Hook ────────────────────────────────────────────────────────────────
-
-/**
- * Hook that provides a unified interface for the active task process.
- * 
- * Usage:
- * ```ts
- * const taskProcess = useActiveTaskProcess(companion, hatchTasks, evolveTasks);
- * 
- * // Access unified data
- * taskProcess.config.type // 'hatch' | 'evolve' | null
- * taskProcess.tasks // current tasks
- * taskProcess.remainingTasksCount // for badge (includes dynamic)
- * taskProcess.tasksToSync // for sync (excludes dynamic)
- * ```
- */
-export function useActiveTaskProcess(
-  companion: BlobbiCompanion | null,
-  hatchTasks: HatchTasksResult,
-  evolveTasks: EvolveTasksResult
-): ActiveTaskProcessResult {
-  // Determine which process is active
-  const processType = useMemo((): TaskProcessType => {
-    if (!companion) return null;
-    if (companion.state === 'incubating') return 'hatch';
-    if (companion.state === 'evolving') return 'evolve';
-    return null;
-  }, [companion]);
-  
-  // Build configuration
-  const config = useMemo((): TaskProcessConfig => {
-    const isActive = processType !== null;
-    const interactionThreshold = processType === 'hatch' 
-      ? HATCH_REQUIRED_INTERACTIONS 
-      : processType === 'evolve' 
-        ? EVOLVE_REQUIRED_INTERACTIONS 
-        : 0;
-    
-    return {
-      type: processType,
-      isActive,
-      interactionThreshold,
-    };
-  }, [processType]);
-  
-  // Get the active tasks result based on process type
-  const activeResult = useMemo(() => {
-    if (processType === 'hatch') return hatchTasks;
-    if (processType === 'evolve') return evolveTasks;
-    return null;
-  }, [processType, hatchTasks, evolveTasks]);
-  
-  // Extract tasks and state from active result
-  const tasks = activeResult?.tasks ?? [];
-  const isLoading = activeResult?.isLoading ?? false;
-  const allCompleted = activeResult?.allCompleted ?? false;
-  const persistentTasksComplete = activeResult?.persistentTasksComplete ?? false;
-  const dynamicTaskComplete = activeResult?.dynamicTaskComplete ?? false;
-  const refetch = activeResult?.refetch ?? (() => {});
-  
-  // Compute persistent task list (dynamic tasks computed for badge count directly from tasks array)
-  const persistentTasks = useMemo(() => filterPersistentTasks(tasks), [tasks]);
-  
-  // Compute incomplete tasks (for badge - includes BOTH persistent and dynamic)
-  const remainingTasksCount = useMemo(() => {
-    // Count ALL incomplete tasks - persistent AND dynamic
-    // Dynamic tasks are included in badge count but NEVER synced to tags
-    return tasks.filter(t => !t.completed).length;
-  }, [tasks]);
-  
-  // Compute persistent task lists for sync
-  const incompletePersistentTasks = useMemo(() => 
-    persistentTasks.filter(t => !t.completed), 
-    [persistentTasks]
-  );
-  
-  const completedPersistentTasks = useMemo(() => 
-    persistentTasks.filter(t => t.completed), 
-    [persistentTasks]
-  );
-  
-  // Compute stable string key for completed persistent tasks (anti-loop)
-  const completedPersistentTaskIds = useMemo(() => {
-    if (!completedPersistentTasks.length) return '';
-    return completedPersistentTasks
-      .map(t => t.id)
-      .sort()
-      .join(',');
-  }, [completedPersistentTasks]);
-  
-  // Compute tasks to sync (persistent only)
-  // CRITICAL: Dynamic tasks must NEVER be included here
-  const tasksToSync = useMemo(() => {
-    if (!persistentTasks.length) return [];
-    return persistentTasks.map(t => ({
-      taskId: t.id,
-      completed: t.completed,
-    }));
-  }, [persistentTasks]);
-  
-  return {
-    config,
-    tasks,
-    isLoading,
-    allCompleted,
-    persistentTasksComplete,
-    dynamicTaskComplete,
-    refetch,
-    remainingTasksCount,
-    incompletePersistentTasks,
-    completedPersistentTasks,
-    completedPersistentTaskIds,
-    tasksToSync,
-  };
-}

src/blobbi/actions/hooks/useAudioPlayback.ts

@@ -1,287 +0,0 @@
-// src/blobbi/actions/hooks/useAudioPlayback.ts
-
-import { useState, useRef, useCallback, useEffect } from 'react';
-
-/**
- * Audio playback state
- * - idle: No audio loaded
- * - loading: Audio is being loaded
- * - playing: Audio is playing
- * - paused: Audio is paused (can resume)
- * - stopped: Audio was stopped (must reload to play again)
- * - error: An error occurred
- */
-export type PlaybackState = 'idle' | 'loading' | 'playing' | 'paused' | 'stopped' | 'error';
-
-/**
- * Audio playback error info
- */
-export interface PlaybackError {
-  message: string;
-  code?: string;
-}
-
-/** Default volume level (0-1) */
-const DEFAULT_VOLUME = 0.8;
-
-/**
- * Options for the useAudioPlayback hook
- */
-export interface UseAudioPlaybackOptions {
-  /** Called when playback ends naturally */
-  onEnded?: () => void;
-  /** Called when an error occurs */
-  onError?: (error: PlaybackError) => void;
-  /** Initial volume level (0-1), defaults to 0.8 */
-  initialVolume?: number;
-}
-
-/**
- * Return type for useAudioPlayback hook
- */
-export interface UseAudioPlaybackReturn {
-  /** Current playback state */
-  state: PlaybackState;
-  /** Current error (if any) */
-  error: PlaybackError | null;
-  /** Current audio URL being played */
-  currentUrl: string | null;
-  /** Load and optionally start playing an audio URL */
-  load: (url: string, autoplay?: boolean) => void;
-  /** Play the current audio */
-  play: () => Promise<void>;
-  /** Pause the current audio */
-  pause: () => void;
-  /** Stop playback and reset */
-  stop: () => void;
-  /** Restart playback from the beginning */
-  restart: () => Promise<void>;
-  /** Toggle play/pause */
-  toggle: () => Promise<void>;
-  /** Whether audio is currently playing */
-  isPlaying: boolean;
-  /** Current volume level (0-1) */
-  volume: number;
-  /** Set volume level (0-1) */
-  setVolume: (volume: number) => void;
-  /** Cleanup function to release resources */
-  cleanup: () => void;
-}
-
-/**
- * Reusable hook for audio playback.
- * Handles Audio element lifecycle, error handling, and state management.
- */
-export function useAudioPlayback(options: UseAudioPlaybackOptions = {}): UseAudioPlaybackReturn {
-  const { onEnded, onError, initialVolume = DEFAULT_VOLUME } = options;
-  
-  const [state, setState] = useState<PlaybackState>('idle');
-  const [error, setError] = useState<PlaybackError | null>(null);
-  const [currentUrl, setCurrentUrl] = useState<string | null>(null);
-  const [volume, setVolumeState] = useState<number>(initialVolume);
-  
-  const audioRef = useRef<HTMLAudioElement | null>(null);
-  const currentUrlRef = useRef<string | null>(null);
-  const volumeRef = useRef<number>(initialVolume);
-  
-  // Cleanup audio element
-  const cleanup = useCallback(() => {
-    if (audioRef.current) {
-      audioRef.current.pause();
-      audioRef.current.onended = null;
-      audioRef.current.onerror = null;
-      audioRef.current.oncanplay = null;
-      audioRef.current.onplaying = null;
-      audioRef.current = null;
-    }
-    currentUrlRef.current = null;
-    setState('idle');
-    setCurrentUrl(null);
-    setError(null);
-  }, []);
-  
-  // Cleanup on unmount
-  useEffect(() => {
-    return () => {
-      cleanup();
-    };
-  }, [cleanup]);
-  
-  // Load audio from URL
-  const load = useCallback((url: string, autoplay = false) => {
-    // If same URL, don't reload
-    if (currentUrlRef.current === url && audioRef.current) {
-      if (autoplay) {
-        audioRef.current.play().catch(() => {});
-      }
-      return;
-    }
-    
-    // Cleanup previous audio
-    if (audioRef.current) {
-      audioRef.current.pause();
-      audioRef.current.onended = null;
-      audioRef.current.onerror = null;
-      audioRef.current.oncanplay = null;
-      audioRef.current.onplaying = null;
-    }
-    
-    setState('loading');
-    setError(null);
-    setCurrentUrl(url);
-    currentUrlRef.current = url;
-    
-    const audio = new Audio(url);
-    audio.volume = volumeRef.current; // Apply current volume to new audio
-    audioRef.current = audio;
-    
-    audio.oncanplay = () => {
-      if (autoplay) {
-        audio.play().catch((err) => {
-          const playbackError: PlaybackError = {
-            message: getPlaybackErrorMessage(err),
-            code: err.name,
-          };
-          setError(playbackError);
-          setState('error');
-          onError?.(playbackError);
-        });
-      } else {
-        setState('paused');
-      }
-    };
-    
-    audio.onplaying = () => {
-      setState('playing');
-    };
-    
-    audio.onpause = () => {
-      if (state === 'playing') {
-        setState('paused');
-      }
-    };
-    
-    audio.onended = () => {
-      setState('paused');
-      onEnded?.();
-    };
-    
-    audio.onerror = () => {
-      const playbackError: PlaybackError = {
-        message: 'Failed to load audio. The format may not be supported.',
-        code: 'MEDIA_ERR',
-      };
-      setError(playbackError);
-      setState('error');
-      onError?.(playbackError);
-    };
-    
-    // Start loading
-    audio.load();
-  }, [onEnded, onError, state]);
-  
-  // Play current audio
-  const play = useCallback(async () => {
-    if (!audioRef.current) return;
-    
-    try {
-      setError(null);
-      await audioRef.current.play();
-      setState('playing');
-    } catch (err) {
-      const playbackError: PlaybackError = {
-        message: getPlaybackErrorMessage(err),
-        code: err instanceof Error ? err.name : 'UNKNOWN',
-      };
-      setError(playbackError);
-      setState('error');
-      onError?.(playbackError);
-    }
-  }, [onError]);
-  
-  // Pause current audio
-  const pause = useCallback(() => {
-    if (!audioRef.current) return;
-    audioRef.current.pause();
-    setState('paused');
-  }, []);
-  
-  // Stop playback completely (requires reload to play again)
-  const stop = useCallback(() => {
-    if (!audioRef.current) return;
-    audioRef.current.pause();
-    audioRef.current.currentTime = 0;
-    // Clear URL ref so next load() will actually reload
-    currentUrlRef.current = null;
-    setState('stopped');
-  }, []);
-  
-  // Restart playback from the beginning
-  const restart = useCallback(async () => {
-    if (!audioRef.current) return;
-    audioRef.current.currentTime = 0;
-    try {
-      await audioRef.current.play();
-      setState('playing');
-    } catch (err) {
-      const playbackError: PlaybackError = {
-        message: getPlaybackErrorMessage(err),
-        code: err instanceof Error ? err.name : 'UNKNOWN',
-      };
-      setError(playbackError);
-      setState('error');
-      onError?.(playbackError);
-    }
-  }, [onError]);
-  
-  // Toggle play/pause
-  const toggle = useCallback(async () => {
-    if (state === 'playing') {
-      pause();
-    } else {
-      await play();
-    }
-  }, [state, play, pause]);
-  
-  // Set volume (0-1)
-  const setVolume = useCallback((newVolume: number) => {
-    const clampedVolume = Math.max(0, Math.min(1, newVolume));
-    volumeRef.current = clampedVolume;
-    setVolumeState(clampedVolume);
-    if (audioRef.current) {
-      audioRef.current.volume = clampedVolume;
-    }
-  }, []);
-  
-  return {
-    state,
-    error,
-    currentUrl,
-    load,
-    play,
-    pause,
-    stop,
-    restart,
-    toggle,
-    isPlaying: state === 'playing',
-    volume,
-    setVolume,
-    cleanup,
-  };
-}
-
-/**
- * Get a user-friendly error message for playback errors
- */
-function getPlaybackErrorMessage(err: unknown): string {
-  if (err instanceof Error) {
-    if (err.name === 'NotSupportedError') {
-      return 'This audio format is not supported by your browser.';
-    }
-    if (err.name === 'NotAllowedError') {
-      return 'Playback was blocked. Try interacting with the page first.';
-    }
-    return err.message;
-  }
-  return 'An unknown error occurred during playback.';
-}

src/blobbi/actions/hooks/useBlobbiCareActivity.ts

@@ -1,189 +0,0 @@
-/**
- * useBlobbiCareActivity - Hook for registering care activity and updating streaks
- * 
- * This hook provides a centralized way to register care activity for a Blobbi companion.
- * It handles:
- * - Calculating streak updates based on the last activity day
- * - Publishing updated Blobbi state to Nostr
- * - Updating local cache
- * 
- * Use this hook whenever care activity should count toward the streak:
- * - Opening the Blobbi page (page check-in)
- * - Performing care actions (feed, clean, play, etc.)
- * - Any other care interaction
- * 
- * The streak only increments once per calendar day, regardless of how many
- * activities are performed.
- */
-
-import { useCallback, useRef } from 'react';
-import { useMutation } from '@tanstack/react-query';
-import type { NostrEvent } from '@nostrify/nostrify';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-import { KIND_BLOBBI_STATE, updateBlobbiTags } from '@/blobbi/core/lib/blobbi';
-
-import { getStreakTagUpdates, calculateStreakUpdate, type StreakUpdateResult } from '../lib/blobbi-streak';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface UseBlobbiCareActivityParams {
-  companion: BlobbiCompanion | null;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-}
-
-export interface CareActivityResult {
-  /** Whether the streak was updated */
-  wasUpdated: boolean;
-  /** The new streak value */
-  newStreak: number;
-  /** Description of what happened */
-  action: StreakUpdateResult['action'];
-}
-
-// ─── Hook ─────────────────────────────────────────────────────────────────────
-
-/**
- * Hook to register care activity and update streaks.
- * 
- * Returns a function to register activity and a mutation for the actual update.
- * The register function is idempotent - calling it multiple times on the same day
- * will only update once.
- */
-export function useBlobbiCareActivity({
-  companion,
-  updateCompanionEvent,
-  invalidateCompanion,
-}: UseBlobbiCareActivityParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-  
-  // Track if we've already registered activity this session to avoid duplicate calls
-  // This is a performance optimization - the actual idempotency is handled by day comparison
-  const lastRegisteredDay = useRef<string | null>(null);
-
-  const mutation = useMutation({
-    mutationFn: async (): Promise<CareActivityResult> => {
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to register care activity');
-      }
-
-      if (!companion) {
-        throw new Error('No companion available');
-      }
-
-      const now = new Date();
-      
-      // Calculate what the streak update should be
-      const result = calculateStreakUpdate(
-        companion.careStreak,
-        companion.careStreakLastDay,
-        now
-      );
-      
-      // If no update needed (same day), return early without publishing
-      if (!result.wasUpdated) {
-        return {
-          wasUpdated: false,
-          newStreak: result.newStreak,
-          action: result.action,
-        };
-      }
-      
-      // Get the tag updates
-      const streakUpdates = getStreakTagUpdates(companion, now);
-      
-      if (!streakUpdates) {
-        // Shouldn't happen if wasUpdated is true, but handle gracefully
-        return {
-          wasUpdated: false,
-          newStreak: companion.careStreak ?? 0,
-          action: 'same_day',
-        };
-      }
-      
-      // Build updated tags
-      const updatedTags = updateBlobbiTags(companion.allTags, streakUpdates);
-      
-      // Publish the updated event
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: companion.event.content,
-        tags: updatedTags,
-      });
-      
-      // Update local cache
-      updateCompanionEvent(event);
-      
-      // Update session tracker
-      lastRegisteredDay.current = result.newLastDay;
-      
-      // Log for debugging (dev only)
-      if (import.meta.env.DEV) {
-        console.log('[CareActivity] Streak updated:', {
-          action: result.action,
-          previousStreak: companion.careStreak,
-          newStreak: result.newStreak,
-          lastDay: companion.careStreakLastDay,
-          newDay: result.newLastDay,
-        });
-      }
-      
-      return {
-        wasUpdated: true,
-        newStreak: result.newStreak,
-        action: result.action,
-      };
-    },
-    onSuccess: (result) => {
-      if (result.wasUpdated) {
-        invalidateCompanion();
-      }
-    },
-    onError: (error: Error) => {
-      console.error('[CareActivity] Failed to update streak:', error);
-    },
-  });
-
-  /**
-   * Register care activity. Call this when care-related activity happens.
-   * Safe to call multiple times - only updates streak once per day.
-   * 
-   * @returns Promise with the result of the activity registration
-   */
-  const registerCareActivity = useCallback(async (): Promise<CareActivityResult | null> => {
-    if (!companion) {
-      return null;
-    }
-    
-    // Quick check if we've already registered for this companion's last day (session cache)
-    // This is an optimization to avoid unnecessary mutation calls
-    if (lastRegisteredDay.current === companion.careStreakLastDay) {
-      // Already processed this day in this session, skip
-      return {
-        wasUpdated: false,
-        newStreak: companion.careStreak ?? 0,
-        action: 'same_day',
-      };
-    }
-    
-    return mutation.mutateAsync();
-  }, [companion, mutation]);
-
-  return {
-    /** Register care activity - call when page opens or care action happens */
-    registerCareActivity,
-    /** Whether an update is currently in progress */
-    isUpdating: mutation.isPending,
-    /** The last update result */
-    lastResult: mutation.data,
-    /** Any error from the last update attempt */
-    error: mutation.error,
-  };
-}

src/blobbi/actions/hooks/useBlobbiDirectAction.ts

@@ -1,228 +0,0 @@
-// src/blobbi/actions/hooks/useBlobbiDirectAction.ts
-
-import { useMutation } from '@tanstack/react-query';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-import {
-  KIND_BLOBBI_STATE,
-  updateBlobbiTags,
-} from '@/blobbi/core/lib/blobbi';
-import { applyBlobbiDecay } from '@/blobbi/core/lib/blobbi-decay';
-import {
-  clampStat,
-  applyStat,
-  DIRECT_ACTION_METADATA,
-  incrementInteractionTaskTags,
-  type DirectAction,
-} from '../lib/blobbi-action-utils';
-import { trackMultipleDailyMissionActions } from '../lib/daily-mission-tracker';
-import type { DailyMissionAction } from '../lib/daily-missions';
-import { getStreakTagUpdates } from '../lib/blobbi-streak';
-import { calculateActionXP, applyXPGain, formatXPGain } from '../lib/blobbi-xp';
-import { HATCH_REQUIRED_INTERACTIONS } from './useHatchTasks';
-import { EVOLVE_REQUIRED_INTERACTIONS } from './useEvolveTasks';
-
-// Import NostrEvent type
-import type { NostrEvent } from '@nostrify/nostrify';
-
-/**
- * Configuration for direct action happiness effects.
- * These are the happiness deltas for each direct action.
- */
-export const DIRECT_ACTION_HAPPINESS_EFFECTS: Record<DirectAction, number> = {
-  play_music: 15,
-  sing: 20,
-};
-
-/**
- * Request payload for executing a direct action
- */
-export interface DirectActionRequest {
-  action: DirectAction;
-}
-
-/**
- * Result of executing a direct action
- */
-export interface DirectActionResult {
-  action: DirectAction;
-  happinessChange: number;
-  xpGained: number;
-  newXP: number;
-}
-
-/**
- * Parameters for the useBlobbiDirectAction hook
- */
-export interface UseBlobbiDirectActionParams {
-  companion: BlobbiCompanion | null;
-  /** Called after ensuring companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration happened) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Hook to execute a direct action on a Blobbi companion.
- * Direct actions (play_music, sing) don't consume inventory items.
- * They directly affect happiness stat.
- * 
- * This hook:
- * 1. Validates the companion exists
- * 2. Ensures canonical format before action
- * 3. Applies accumulated decay
- * 4. Applies happiness boost
- * 5. Updates Blobbi state (kind 31124)
- * 6. Invalidates relevant queries
- */
-export function useBlobbiDirectAction({
-  companion,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseBlobbiDirectActionParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async ({ action }: DirectActionRequest): Promise<DirectActionResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to perform actions');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for action');
-      }
-
-      // ─── Apply Accumulated Decay First ───
-      // CRITICAL: Use canonical.companion for decay calculations, not the stale outer companion
-      const now = Math.floor(Date.now() / 1000);
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      const statsAfterDecay = decayResult.stats;
-      
-      // ─── Apply Happiness Effect ───
-      const happinessDelta = DIRECT_ACTION_HAPPINESS_EFFECTS[action];
-      const newHappiness = applyStat(statsAfterDecay.happiness, happinessDelta);
-      
-      // Track if happiness actually changed
-      const happinessChanged = newHappiness !== statsAfterDecay.happiness;
-      
-      // Build stats update
-      const isEgg = canonical.companion.stage === 'egg';
-      const statsUpdate: Record<string, string> = {
-        happiness: newHappiness.toString(),
-        health: statsAfterDecay.health.toString(),
-        hygiene: statsAfterDecay.hygiene.toString(),
-      };
-      
-      if (isEgg) {
-        // Eggs have fixed hunger and energy
-        statsUpdate.hunger = '100';
-        statsUpdate.energy = '100';
-      } else {
-        statsUpdate.hunger = clampStat(statsAfterDecay.hunger).toString();
-        statsUpdate.energy = clampStat(statsAfterDecay.energy).toString();
-      }
-
-      // ─── Update Blobbi State Event (kind 31124) ───
-      const nowStr = now.toString();
-      
-      // If incubating or evolving, increment the interaction counter for tasks
-      const companionState = canonical.companion.state;
-      let updatedTags = canonical.allTags;
-      if (companionState === 'incubating') {
-        updatedTags = incrementInteractionTaskTags(canonical.allTags, HATCH_REQUIRED_INTERACTIONS).updatedTags;
-      } else if (companionState === 'evolving') {
-        updatedTags = incrementInteractionTaskTags(canonical.allTags, EVOLVE_REQUIRED_INTERACTIONS).updatedTags;
-      }
-      
-      // Get streak updates (will only update if needed based on day)
-      const streakUpdates = getStreakTagUpdates(canonical.companion) ?? {};
-      
-      // ─── Apply XP Gain (ONLY if happiness actually changed) ───
-      // Direct actions modify happiness. Only grant XP if happiness actually increased.
-      const xpGained = happinessChanged ? calculateActionXP(action) : 0;
-      const currentXP = canonical.companion.experience ?? 0;
-      const newXP = applyXPGain(currentXP, xpGained);
-      
-      const blobbiTags = updateBlobbiTags(updatedTags, {
-        ...statsUpdate,
-        ...streakUpdates,
-        experience: newXP.toString(),
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      const blobbiEvent = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: blobbiTags,
-      });
-
-      updateCompanionEvent(blobbiEvent);
-
-      // ─── Invalidate Queries ───
-      invalidateCompanion();
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        action,
-        happinessChange: happinessDelta,
-        xpGained,
-        newXP,
-      };
-    },
-    onSuccess: ({ action, happinessChange, xpGained }) => {
-      const actionMeta = DIRECT_ACTION_METADATA[action];
-      const xpText = formatXPGain(xpGained);
-      toast({
-        title: `${actionMeta.label} complete!`,
-        description: `Your Blobbi's happiness increased by ${happinessChange}! ${xpText}`,
-      });
-
-      // Track daily mission progress
-      // 'interact' is always tracked, plus the specific action
-      const dailyActions: DailyMissionAction[] = ['interact'];
-      if (action === 'sing') dailyActions.push('sing');
-      if (action === 'play_music') dailyActions.push('play_music');
-      trackMultipleDailyMissionActions(dailyActions, user?.pubkey);
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Action failed',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}

src/blobbi/actions/hooks/useBlobbiIncubation.ts

@@ -1,939 +0,0 @@
-// src/blobbi/actions/hooks/useBlobbiIncubation.ts
-
-/**
- * Hooks for Blobbi incubation task system.
- * 
- * When a user starts incubation:
- * 1. Apply accumulated decay from last_decay_at to now
- * 2. Set state to 'incubating'
- * 3. Add state_started_at timestamp
- * 4. Update last_decay_at to the same timestamp
- * 5. Clear any previous task progress
- * 
- * Tasks are computed from Nostr events with created_at >= state_started_at
- */
-
-import { useMutation } from '@tanstack/react-query';
-import { useNostr } from '@nostrify/react';
-import type { NostrEvent } from '@nostrify/nostrify';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import type { BlobbiCompanion, BlobbonautProfile } from '@/blobbi/core/lib/blobbi';
-import {
-  KIND_BLOBBI_STATE,
-  updateBlobbiTags,
-} from '@/blobbi/core/lib/blobbi';
-import { applyBlobbiDecay } from '@/blobbi/core/lib/blobbi-decay';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Mode for starting incubation.
- * This makes the intent explicit rather than auto-detecting behavior.
- */
-export type StartIncubationMode = 
-  | 'start'              // Normal start (no other Blobbi incubating)
-  | 'restart'            // Restart same Blobbi (already incubating)
-  | 'switch';            // Switch from another incubating Blobbi
-
-/**
- * Request to start incubation with explicit mode.
- */
-export interface StartIncubationRequest {
-  /** Explicit mode for this operation */
-  mode: StartIncubationMode;
-  /** The d-tag of the other Blobbi to stop (required when mode === 'switch') */
-  stopOtherD?: string;
-}
-
-/**
- * Parameters for start incubation hook.
- */
-export interface UseStartIncubationParams {
-  companion: BlobbiCompanion | null;
-  profile: BlobbonautProfile | null;
-  /** Called to ensure companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    profileAllTags: string[][];
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration occurred) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Result of starting incubation.
- */
-export interface StartIncubationResult {
-  /** The Blobbi's name */
-  name: string;
-  /** Timestamp when incubation started */
-  stateStartedAt: number;
-  /** Mode that was used */
-  mode: StartIncubationMode;
-  /** Name of other Blobbi that was stopped (if mode === 'switch') */
-  stoppedOtherName?: string;
-}
-
-// ─── Start Incubation Hook ────────────────────────────────────────────────────
-
-/**
- * Hook to start the incubation process for an egg.
- * 
- * This sets the Blobbi state to 'incubating' and records the start timestamp.
- * Tasks will be computed based on events created after this timestamp.
- * 
- * IMPORTANT: The mode must be explicitly specified by the caller (UI).
- * This hook does NOT auto-detect whether to switch or restart.
- * The UI dialog determines the mode and passes it explicitly.
- * 
- * Modes:
- * - 'start': Normal start, no other Blobbi incubating
- * - 'restart': Restart same Blobbi (already incubating), resets task progress
- * - 'switch': Stop another Blobbi first, then start this one
- * 
- * Requirements:
- * - Blobbi must be in egg stage
- * - User must be logged in
- */
-export function useStartIncubation({
-  companion,
-  profile,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseStartIncubationParams) {
-  const { user } = useCurrentUser();
-  const { nostr } = useNostr();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (request: StartIncubationRequest): Promise<StartIncubationResult> => {
-      const { mode, stopOtherD } = request;
-      
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to start incubation');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (!profile) {
-        throw new Error('Profile not found');
-      }
-
-      if (companion.stage !== 'egg') {
-        throw new Error('Only eggs can be incubated');
-      }
-
-      // Validate switch mode requires stopOtherD
-      if (mode === 'switch' && !stopOtherD) {
-        throw new Error('Switch mode requires stopOtherD parameter');
-      }
-
-      let stoppedOtherName: string | undefined;
-
-      // ─── Stop Other Incubating Blobbi (switch mode only) ───
-      if (mode === 'switch' && stopOtherD) {
-        // Fetch the current event for the other Blobbi
-        const [otherEvent] = await nostr.query([{
-          kinds: [KIND_BLOBBI_STATE],
-          authors: [user.pubkey],
-          '#d': [stopOtherD],
-          limit: 1,
-        }]);
-        
-        if (otherEvent) {
-          // Get name from the event for the result
-          const nameTag = otherEvent.tags.find(t => t[0] === 'name');
-          stoppedOtherName = nameTag?.[1] ?? stopOtherD;
-          
-          // Stop the other Blobbi's incubation
-          const now = Math.floor(Date.now() / 1000);
-          const nowStr = now.toString();
-          
-          // Parse stats from the event
-          const getTagValue = (tags: string[][], name: string): number => 
-            parseInt(tags.find(t => t[0] === name)?.[1] ?? '50', 10);
-          
-          const otherStats = {
-            hunger: getTagValue(otherEvent.tags, 'hunger'),
-            happiness: getTagValue(otherEvent.tags, 'happiness'),
-            health: getTagValue(otherEvent.tags, 'health'),
-            hygiene: getTagValue(otherEvent.tags, 'hygiene'),
-            energy: getTagValue(otherEvent.tags, 'energy'),
-          };
-          const otherLastDecayAt = getTagValue(otherEvent.tags, 'last_decay_at') || now;
-          
-          // Apply decay to the other Blobbi
-          const otherDecayResult = applyBlobbiDecay({
-            stage: 'egg',
-            state: 'incubating',
-            stats: otherStats,
-            lastDecayAt: otherLastDecayAt,
-            now,
-          });
-          
-          // Remove task tags and state_started_at from the other Blobbi
-          const otherCleanedTags = otherEvent.tags.filter(tag => 
-            tag[0] !== 'task' && 
-            tag[0] !== 'task_completed' && 
-            tag[0] !== 'state_started_at'
-          );
-          
-          const otherNewTags = updateBlobbiTags(otherCleanedTags, {
-            health: otherDecayResult.stats.health.toString(),
-            hygiene: otherDecayResult.stats.hygiene.toString(),
-            happiness: otherDecayResult.stats.happiness.toString(),
-            hunger: '100',
-            energy: '100',
-            state: 'active',
-            last_interaction: nowStr,
-            last_decay_at: nowStr,
-          });
-          
-          // Publish the stop event for the other Blobbi
-          const stopEvent = await publishEvent({
-            kind: KIND_BLOBBI_STATE,
-            content: otherEvent.content,
-            tags: otherNewTags,
-          });
-          
-          // Update the cache for the stopped Blobbi
-          updateCompanionEvent(stopEvent);
-        }
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for incubation');
-      }
-
-      // ─── Apply Accumulated Decay ───
-      // CRITICAL: Apply decay from last_decay_at to now before changing state
-      const now = Math.floor(Date.now() / 1000);
-      const nowStr = now.toString();
-      
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      // ─── Build Updated Tags ───
-      // Remove any existing task tags when starting fresh (for all modes)
-      const cleanedTags = canonical.allTags.filter(tag => 
-        tag[0] !== 'task' && tag[0] !== 'task_completed'
-      );
-      
-      // Build stats update with decayed values
-      // Eggs have fixed hunger and energy at 100
-      const statsUpdate: Record<string, string> = {
-        health: decayResult.stats.health.toString(),
-        hygiene: decayResult.stats.hygiene.toString(),
-        happiness: decayResult.stats.happiness.toString(),
-        hunger: '100',
-        energy: '100',
-      };
-      
-      const newTags = updateBlobbiTags(cleanedTags, {
-        ...statsUpdate,
-        state: 'incubating',
-        state_started_at: nowStr,
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        name: canonical.companion.name,
-        stateStartedAt: now,
-        mode,
-        stoppedOtherName,
-      };
-    },
-    onSuccess: ({ name, mode, stoppedOtherName }) => {
-      if (mode === 'switch' && stoppedOtherName) {
-        toast({
-          title: 'Switched incubation!',
-          description: `Stopped ${stoppedOtherName}, now incubating ${name}.`,
-        });
-      } else if (mode === 'restart') {
-        toast({
-          title: 'Incubation restarted!',
-          description: `${name}'s task progress has been reset.`,
-        });
-      } else {
-        toast({
-          title: 'Incubation started!',
-          description: `${name} is now incubating. Complete the tasks to hatch!`,
-        });
-      }
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to start incubation',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}
-
-// ─── Stop Incubation Hook ─────────────────────────────────────────────────────
-
-/**
- * Parameters for stop incubation hook.
- */
-export interface UseStopIncubationParams {
-  companion: BlobbiCompanion | null;
-  /** Called to ensure companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    profileAllTags: string[][];
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration occurred) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Result of stopping incubation.
- */
-export interface StopIncubationResult {
-  /** The Blobbi's name */
-  name: string;
-}
-
-/**
- * Hook to stop/cancel the incubation process for a Blobbi.
- * 
- * This resets the Blobbi state to 'active' and clears all task progress tags.
- * The user can restart incubation later, but will need to complete tasks again.
- * 
- * When stopping incubation:
- * - Apply accumulated decay first
- * - Set state back to 'active'
- * - Remove state_started_at tag
- * - Remove all task and task_completed tags
- * 
- * Requirements:
- * - Blobbi must be in incubating state
- * - User must be logged in
- */
-export function useStopIncubation({
-  companion,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseStopIncubationParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (): Promise<StopIncubationResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to stop incubation');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (companion.state !== 'incubating') {
-        throw new Error('This Blobbi is not incubating');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion');
-      }
-
-      // ─── Apply Accumulated Decay ───
-      const now = Math.floor(Date.now() / 1000);
-      const nowStr = now.toString();
-      
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      // ─── Build Updated Tags ───
-      // Remove task tags and state_started_at
-      const cleanedTags = canonical.allTags.filter(tag => 
-        tag[0] !== 'task' && 
-        tag[0] !== 'task_completed' && 
-        tag[0] !== 'state_started_at'
-      );
-      
-      // Build stats update with decayed values
-      // Eggs have fixed hunger and energy at 100
-      const statsUpdate: Record<string, string> = {
-        health: decayResult.stats.health.toString(),
-        hygiene: decayResult.stats.hygiene.toString(),
-        happiness: decayResult.stats.happiness.toString(),
-        hunger: '100',
-        energy: '100',
-      };
-      
-      const newTags = updateBlobbiTags(cleanedTags, {
-        ...statsUpdate,
-        state: 'active',
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        name: canonical.companion.name,
-      };
-    },
-    onSuccess: ({ name }) => {
-      toast({
-        title: 'Incubation stopped',
-        description: `${name} is no longer incubating. Task progress has been reset.`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to stop incubation',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}
-
-// ─── Start Evolution Hook ─────────────────────────────────────────────────────
-
-/**
- * Parameters for start evolution hook.
- */
-export interface UseStartEvolutionParams {
-  companion: BlobbiCompanion | null;
-  /** Called to ensure companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    profileAllTags: string[][];
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration occurred) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Result of starting evolution.
- */
-export interface StartEvolutionResult {
-  /** The Blobbi's name */
-  name: string;
-  /** Timestamp when evolution started */
-  stateStartedAt: number;
-}
-
-/**
- * Hook to start the evolution process for a baby Blobbi.
- * 
- * This sets the Blobbi state to 'evolving' and records the start timestamp.
- * Tasks will be computed based on events created after this timestamp.
- * 
- * Requirements:
- * - Blobbi must be in baby stage
- * - Blobbi must not already be evolving
- * - User must be logged in
- */
-export function useStartEvolution({
-  companion,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseStartEvolutionParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (): Promise<StartEvolutionResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to start evolution');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (companion.stage !== 'baby') {
-        throw new Error('Only baby Blobbis can evolve');
-      }
-
-      if (companion.state === 'evolving') {
-        throw new Error('This Blobbi is already evolving');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for evolution');
-      }
-
-      // ─── Apply Accumulated Decay ───
-      const now = Math.floor(Date.now() / 1000);
-      const nowStr = now.toString();
-      
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      // ─── Build Updated Tags ───
-      // Remove any existing task tags when starting fresh
-      const cleanedTags = canonical.allTags.filter(tag => 
-        tag[0] !== 'task' && tag[0] !== 'task_completed'
-      );
-      
-      // Build stats update with decayed values
-      const statsUpdate: Record<string, string> = {
-        health: decayResult.stats.health.toString(),
-        hygiene: decayResult.stats.hygiene.toString(),
-        happiness: decayResult.stats.happiness.toString(),
-        hunger: decayResult.stats.hunger.toString(),
-        energy: decayResult.stats.energy.toString(),
-      };
-      
-      const newTags = updateBlobbiTags(cleanedTags, {
-        ...statsUpdate,
-        state: 'evolving',
-        state_started_at: nowStr,
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        name: canonical.companion.name,
-        stateStartedAt: now,
-      };
-    },
-    onSuccess: ({ name }) => {
-      toast({
-        title: 'Evolution started!',
-        description: `${name} is now working towards evolution. Complete the tasks to evolve!`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to start evolution',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}
-
-// ─── Stop Evolution Hook ──────────────────────────────────────────────────────
-
-/**
- * Parameters for stop evolution hook.
- */
-export interface UseStopEvolutionParams {
-  companion: BlobbiCompanion | null;
-  /** Called to ensure companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    profileAllTags: string[][];
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration occurred) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Result of stopping evolution.
- */
-export interface StopEvolutionResult {
-  /** The Blobbi's name */
-  name: string;
-}
-
-/**
- * Hook to stop/cancel the evolution process for a Blobbi.
- * 
- * This resets the Blobbi state to 'active' and clears all task progress tags.
- * The user can restart evolution later, but will need to complete tasks again.
- * 
- * When stopping evolution:
- * - Apply accumulated decay first
- * - Set state back to 'active'
- * - Remove state_started_at tag
- * - Remove all task and task_completed tags
- * 
- * Requirements:
- * - Blobbi must be in evolving state
- * - User must be logged in
- */
-export function useStopEvolution({
-  companion,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseStopEvolutionParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (): Promise<StopEvolutionResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to stop evolution');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (companion.state !== 'evolving') {
-        throw new Error('This Blobbi is not evolving');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion');
-      }
-
-      // ─── Apply Accumulated Decay ───
-      const now = Math.floor(Date.now() / 1000);
-      const nowStr = now.toString();
-      
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      // ─── Build Updated Tags ───
-      // Remove task tags and state_started_at
-      const cleanedTags = canonical.allTags.filter(tag => 
-        tag[0] !== 'task' && 
-        tag[0] !== 'task_completed' && 
-        tag[0] !== 'state_started_at'
-      );
-      
-      // Build stats update with decayed values
-      const statsUpdate: Record<string, string> = {
-        health: decayResult.stats.health.toString(),
-        hygiene: decayResult.stats.hygiene.toString(),
-        happiness: decayResult.stats.happiness.toString(),
-        hunger: decayResult.stats.hunger.toString(),
-        energy: decayResult.stats.energy.toString(),
-      };
-      
-      const newTags = updateBlobbiTags(cleanedTags, {
-        ...statsUpdate,
-        state: 'active',
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        name: canonical.companion.name,
-      };
-    },
-    onSuccess: ({ name }) => {
-      toast({
-        title: 'Evolution stopped',
-        description: `${name} is no longer evolving. Task progress has been reset.`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to stop evolution',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}
-
-// ─── Sync Task Completions Hook ───────────────────────────────────────────────
-
-/** Enable debug logging in development only */
-const DEBUG_TASK_SYNC = import.meta.env.DEV;
-
-/**
- * Parameters for syncing task completions (works for both hatch and evolve).
- */
-export interface UseSyncTaskCompletionsParams {
-  companion: BlobbiCompanion | null;
-  /** Called to ensure companion is canonical */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    profileAllTags: string[][];
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries */
-  invalidateProfile: () => void;
-}
-
-/**
- * Task completions to sync (from useHatchTasks or useEvolveTasks).
- */
-export interface TaskCompletionToSync {
-  taskId: string;
-  completed: boolean;
-}
-
-/**
- * Result of sync operation.
- */
-export interface SyncTaskCompletionsResult {
-  /** Task IDs that were synced (empty if nothing needed) */
-  synced: string[];
-  /** Whether sync was skipped (no diff) */
-  skipped: boolean;
-  /** Reason for skip (for debugging) */
-  skipReason?: string;
-}
-
-/**
- * Hook to sync persistent task completions to kind 31124 tags.
- * Works for both hatch (incubating) and evolve (evolving) processes.
- * 
- * CRITICAL: This is a cache-only sync. It must be:
- * 1. Fully idempotent - calling multiple times with same data = no-op
- * 2. Diff-based - only publish when tags would actually change
- * 3. Safe - no last_interaction update (this is cache sync, not user action)
- * 4. Only sync PERSISTENT tasks - dynamic tasks must NEVER be synced
- * 
- * Source of truth = computed task state from Nostr events.
- * Tags = cache layer for faster access.
- */
-export function useSyncTaskCompletions({
-  companion,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseSyncTaskCompletionsParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (tasksToSync: TaskCompletionToSync[]): Promise<SyncTaskCompletionsResult> => {
-      // ─── Early Guards ───
-      if (!user?.pubkey) {
-        return { synced: [], skipped: true, skipReason: 'no_user' };
-      }
-
-      if (!companion) {
-        return { synced: [], skipped: true, skipReason: 'no_companion' };
-      }
-
-      // Must be in an active task process (incubating or evolving)
-      if (companion.state !== 'incubating' && companion.state !== 'evolving') {
-        return { synced: [], skipped: true, skipReason: 'not_in_task_process' };
-      }
-
-      // ─── Compute Diff ───
-      // Get cached completions from companion.tasksCompleted (parsed from tags)
-      const cachedCompletions = new Set(companion.tasksCompleted);
-      
-      // Get computed completions from tasks (works for both hatch and evolve)
-      const computedCompletions = tasksToSync
-        .filter(t => t.completed)
-        .map(t => t.taskId);
-      
-      // Find tasks that are computed as complete but NOT in cache
-      const missingFromCache = computedCompletions.filter(id => !cachedCompletions.has(id));
-
-      if (DEBUG_TASK_SYNC) {
-        console.log('[TaskSync] Diff check:', {
-          cachedCompletions: Array.from(cachedCompletions),
-          computedCompletions,
-          missingFromCache,
-        });
-      }
-
-      // If no diff, skip entirely
-      if (missingFromCache.length === 0) {
-        if (DEBUG_TASK_SYNC) {
-          console.log('[TaskSync] Skipped: no diff between computed and cached');
-        }
-        return { synced: [], skipped: true, skipReason: 'no_diff' };
-      }
-
-      // ─── Ensure Canonical ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        return { synced: [], skipped: true, skipReason: 'canonical_failed' };
-      }
-
-      // ─── Build Updated Tags ───
-      // Re-check against canonical.allTags (may have updated since companion was parsed)
-      const existingCompletionTags = new Set(
-        canonical.allTags
-          .filter(tag => tag[0] === 'task_completed')
-          .map(tag => tag[1])
-      );
-
-      // Filter to only truly missing tags
-      const tagsToAdd = missingFromCache.filter(id => !existingCompletionTags.has(id));
-
-      if (tagsToAdd.length === 0) {
-        if (DEBUG_TASK_SYNC) {
-          console.log('[TaskSync] Skipped: all tags already exist in canonical');
-        }
-        return { synced: [], skipped: true, skipReason: 'tags_already_exist' };
-      }
-
-      // Add only the missing task_completed tags
-      // CRITICAL: Do NOT update last_interaction - this is cache sync, not user action
-      const updatedTags = [
-        ...canonical.allTags,
-        ...tagsToAdd.map(id => ['task_completed', id]),
-      ];
-
-      if (DEBUG_TASK_SYNC) {
-        console.log('[TaskSync] Publishing:', {
-          tagsToAdd,
-          totalTags: updatedTags.length,
-        });
-      }
-
-      // ─── Publish ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: updatedTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      if (DEBUG_TASK_SYNC) {
-        console.log('[TaskSync] Published successfully:', tagsToAdd);
-      }
-
-      return { synced: tagsToAdd, skipped: false };
-    },
-  });
-}

src/blobbi/actions/hooks/useBlobbiStageTransition.ts

@@ -1,407 +0,0 @@
-// src/blobbi/actions/hooks/useBlobbiStageTransition.ts
-
-/**
- * Hooks for Blobbi stage transitions (hatch, evolve).
- * 
- * Both transitions follow the same decay pattern:
- * 1. Apply accumulated decay from `last_decay_at` to `now`
- * 2. Use decayed stats as the source of truth for the transition
- * 3. Publish new event with decayed stats + new stage
- * 4. Reset `last_decay_at` to current timestamp
- * 
- * @see docs/blobbi/decay-system.md
- */
-
-import { useMutation } from '@tanstack/react-query';
-import type { NostrEvent } from '@nostrify/nostrify';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import type { BlobbiCompanion, BlobbonautProfile, BlobbiStage } from '@/blobbi/core/lib/blobbi';
-import {
-  KIND_BLOBBI_STATE,
-  STAT_MAX,
-  updateBlobbiTags,
-} from '@/blobbi/core/lib/blobbi';
-import { applyBlobbiDecay } from '@/blobbi/core/lib/blobbi-decay';
-import { validateAndRepairBlobbiTags } from '@/blobbi/core/lib/blobbi-tag-schema';
-import { getStreakTagUpdates } from '../lib/blobbi-streak';
-
-// ─── Content Helpers ──────────────────────────────────────────────────────────
-
-/**
- * Generate the content string for a Blobbi at a given stage.
- * Format: "{name} is a {stage} Blobbi."
- * 
- * Uses correct grammar: "an egg" vs "a baby/adult"
- */
-function generateBlobbiContent(name: string, stage: BlobbiStage): string {
-  const article = stage === 'egg' ? 'an' : 'a';
-  return `${name} is ${article} ${stage} Blobbi.`;
-}
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Result of ensuring canonical companion before action.
- * This is the same interface used by useBlobbiUseInventoryItem.
- */
-export interface CanonicalActionResult {
-  companion: BlobbiCompanion;
-  content: string;
-  allTags: string[][];
-  wasMigrated: boolean;
-  /** Latest profile tags after migration */
-  profileAllTags: string[][];
-  /** Latest profile storage after migration */
-  profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-}
-
-/**
- * Parameters for stage transition hooks.
- */
-export interface UseBlobbiStageTransitionParams {
-  companion: BlobbiCompanion | null;
-  profile: BlobbonautProfile | null;
-  /** Called to ensure companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<CanonicalActionResult | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries (needed if migration occurred) */
-  invalidateProfile: () => void;
-}
-
-/**
- * Result of a stage transition.
- */
-export interface StageTransitionResult {
-  /** Previous stage before transition */
-  previousStage: BlobbiStage;
-  /** New stage after transition */
-  newStage: BlobbiStage;
-  /** The Blobbi's name */
-  name: string;
-  /** Stats after decay was applied (before any transition bonuses) */
-  decayedStats: {
-    hunger: number;
-    happiness: number;
-    health: number;
-    hygiene: number;
-    energy: number;
-  };
-}
-
-// ─── Hatch Hook ───────────────────────────────────────────────────────────────
-
-/**
- * Hook to hatch an egg into a baby Blobbi.
- * 
- * Transition: egg -> baby
- * 
- * Requirements:
- * - Blobbi must be in egg stage
- * - Applies accumulated decay before transition
- * - Resets stats to healthy baby defaults (inherits health from egg)
- * - Sets last_decay_at to current timestamp
- */
-export function useBlobbiHatch({
-  companion,
-  profile,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseBlobbiStageTransitionParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (): Promise<StageTransitionResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to hatch');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (!profile) {
-        throw new Error('Profile not found');
-      }
-
-      if (companion.stage !== 'egg') {
-        throw new Error('Only eggs can be hatched');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for hatching');
-      }
-
-      // ─── Apply Accumulated Decay First ───
-      // Per decay-system.md: Always apply accumulated decay from persisted state
-      // before any stage transition.
-      const now = Math.floor(Date.now() / 1000);
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-
-      // ─── Calculate Baby Stats ───
-      // All stats reset to 100 when hatching — the baby starts fresh
-      const babyStats = {
-        hunger: STAT_MAX,
-        happiness: STAT_MAX,
-        health: STAT_MAX,
-        hygiene: STAT_MAX,
-        energy: STAT_MAX,
-      };
-
-      // ─── Build Updated Tags ───
-      // CRITICAL: Start from canonical.allTags and only remove task/state-specific tags
-      // This preserves ALL identity attributes (personality, trait, favorite_food, etc.)
-      const nowStr = now.toString();
-      
-      // Build the updated tags using the central merge function
-      // Get streak updates (hatching counts as care activity!)
-      const streakUpdates = getStreakTagUpdates(canonical.companion) ?? {};
-      
-      const mergedTags = updateBlobbiTags(canonical.allTags, {
-        stage: 'baby',
-        state: 'active', // Newly hatched babies are awake
-        hunger: babyStats.hunger.toString(),
-        happiness: babyStats.happiness.toString(),
-        health: babyStats.health.toString(),
-        hygiene: babyStats.hygiene.toString(),
-        energy: babyStats.energy.toString(),
-        ...streakUpdates,
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-      
-      // ─── Validate and Repair Tags ───
-      // Use the tag integrity guard to ensure all persistent tags are preserved
-      // and task-related tags are properly cleaned up for stage transitions
-      const repairResult = validateAndRepairBlobbiTags(
-        mergedTags,
-        canonical.allTags,
-        { cleanupTaskTags: true }
-      );
-      
-      if (repairResult.errors.length > 0) {
-        console.error('[Hatch] Tag validation errors:', repairResult.errors);
-        throw new Error(`Tag validation failed: ${repairResult.errors.join(', ')}`);
-      }
-      
-      if (repairResult.repaired && import.meta.env.DEV) {
-        console.log('[Hatch] Tag repairs applied:', repairResult.repairs);
-      }
-      
-      const newTags = repairResult.tags;
-
-      // ─── Generate New Content for Baby Stage ───
-      // CRITICAL: Content must reflect the new stage
-      const newContent = generateBlobbiContent(canonical.companion.name, 'baby');
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: newContent,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        previousStage: 'egg',
-        newStage: 'baby',
-        name: canonical.companion.name,
-        decayedStats: decayResult.stats,
-      };
-    },
-    onSuccess: ({ name }) => {
-      toast({
-        title: 'Your egg hatched!',
-        description: `${name} is now a baby Blobbi! Take good care of them.`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to hatch',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}
-
-// ─── Evolve Hook ──────────────────────────────────────────────────────────────
-
-/**
- * Hook to evolve a baby Blobbi into an adult.
- * 
- * Transition: baby -> adult
- * 
- * Requirements:
- * - Blobbi must be in baby stage
- * - Applies accumulated decay before transition
- * - Preserves all stats (decay already applied)
- * - Sets last_decay_at to current timestamp
- */
-export function useBlobbiEvolve({
-  companion,
-  profile,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseBlobbiStageTransitionParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async (): Promise<StageTransitionResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to evolve');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (!profile) {
-        throw new Error('Profile not found');
-      }
-
-      if (companion.stage !== 'baby') {
-        if (companion.stage === 'egg') {
-          throw new Error('Eggs must hatch before they can evolve');
-        }
-        if (companion.stage === 'adult') {
-          throw new Error('This Blobbi is already fully evolved');
-        }
-        throw new Error('Only baby Blobbis can evolve');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for evolution');
-      }
-
-      // ─── Apply Accumulated Decay First ───
-      // Per decay-system.md: Always apply accumulated decay from persisted state
-      // before any stage transition.
-      const now = Math.floor(Date.now() / 1000);
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-
-      // ─── Adult Stats ───
-      // Adult inherits all decayed stats from baby
-      // No stat reset - evolution preserves current condition
-      const adultStats = decayResult.stats;
-
-      // ─── Build Updated Tags ───
-      // CRITICAL: Start from canonical.allTags and only remove task/state-specific tags
-      // This preserves ALL identity attributes (personality, trait, favorite_food, etc.)
-      const nowStr = now.toString();
-      
-      // Get streak updates (evolving counts as care activity!)
-      const streakUpdates = getStreakTagUpdates(canonical.companion) ?? {};
-      
-      // Build the updated tags using the central merge function
-      const mergedTags = updateBlobbiTags(canonical.allTags, {
-        stage: 'adult',
-        state: 'active', // Evolution completes with active state
-        hunger: adultStats.hunger.toString(),
-        happiness: adultStats.happiness.toString(),
-        health: adultStats.health.toString(),
-        hygiene: adultStats.hygiene.toString(),
-        energy: adultStats.energy.toString(),
-        ...streakUpdates,
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-      
-      // ─── Validate and Repair Tags ───
-      // Use the tag integrity guard to ensure all persistent tags are preserved
-      // and task-related tags are properly cleaned up for stage transitions
-      const repairResult = validateAndRepairBlobbiTags(
-        mergedTags,
-        canonical.allTags,
-        { cleanupTaskTags: true }
-      );
-      
-      if (repairResult.errors.length > 0) {
-        console.error('[Evolve] Tag validation errors:', repairResult.errors);
-        throw new Error(`Tag validation failed: ${repairResult.errors.join(', ')}`);
-      }
-      
-      if (repairResult.repaired && import.meta.env.DEV) {
-        console.log('[Evolve] Tag repairs applied:', repairResult.repairs);
-      }
-      
-      const newTags = repairResult.tags;
-
-      // ─── Generate New Content for Adult Stage ───
-      // CRITICAL: Content must reflect the new stage
-      const newContent = generateBlobbiContent(canonical.companion.name, 'adult');
-
-      // ─── Publish Event ───
-      const event = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: newContent,
-        tags: newTags,
-      });
-
-      updateCompanionEvent(event);
-      invalidateCompanion();
-      
-      // Invalidate profile if migration occurred
-      if (canonical.wasMigrated) {
-        invalidateProfile();
-      }
-
-      return {
-        previousStage: 'baby',
-        newStage: 'adult',
-        name: canonical.companion.name,
-        decayedStats: decayResult.stats,
-      };
-    },
-    onSuccess: ({ name }) => {
-      toast({
-        title: 'Evolution complete!',
-        description: `${name} has evolved into an adult Blobbi!`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to evolve',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}

src/blobbi/actions/hooks/useBlobbiUseInventoryItem.ts

@@ -1,466 +0,0 @@
-// src/blobbi/actions/hooks/useBlobbiUseInventoryItem.ts
-
-import { useMutation } from '@tanstack/react-query';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import type { BlobbiCompanion, BlobbonautProfile, BlobbiStats } from '@/blobbi/core/lib/blobbi';
-import {
-  KIND_BLOBBI_STATE,
-  KIND_BLOBBONAUT_PROFILE,
-  updateBlobbiTags,
-  updateBlobbonautTags,
-  createStorageTags,
-} from '@/blobbi/core/lib/blobbi';
-import { applyBlobbiDecay } from '@/blobbi/core/lib/blobbi-decay';
-import { getShopItemById } from '@/blobbi/shop/lib/blobbi-shop-items';
-import {
-  applyItemEffects,
-  decrementStorageItem,
-  canUseAction,
-  getStageRestrictionMessage,
-  clampStat,
-  applyStat,
-  hasMedicineEffectForEgg,
-  hasHygieneEffectForEgg,
-  incrementInteractionTaskTags,
-  type InventoryAction,
-  ACTION_METADATA,
-} from '../lib/blobbi-action-utils';
-import { trackMultipleDailyMissionActions } from '../lib/daily-mission-tracker';
-import type { DailyMissionAction } from '../lib/daily-missions';
-import { getStreakTagUpdates } from '../lib/blobbi-streak';
-import { calculateInventoryActionXP, applyXPGain, formatXPGain } from '../lib/blobbi-xp';
-import { HATCH_REQUIRED_INTERACTIONS } from './useHatchTasks';
-import { EVOLVE_REQUIRED_INTERACTIONS } from './useEvolveTasks';
-
-/**
- * Request payload for using an inventory item
- */
-export interface UseItemRequest {
-  itemId: string;
-  action: InventoryAction;
-  /** Number of items to use (defaults to 1) */
-  quantity?: number;
-}
-
-/**
- * Result of using an inventory item
- */
-export interface UseItemResult {
-  itemName: string;
-  action: InventoryAction;
-  quantity: number;
-  effectiveItemCount: number; // How many items actually changed stats (may be less than quantity due to caps)
-  statsChanged: Record<string, number>;
-  xpGained: number;
-  newXP: number;
-}
-
-/**
- * Parameters for the useBlobbiUseInventoryItem hook
- */
-export interface UseBlobbiUseInventoryItemParams {
-  companion: BlobbiCompanion | null;
-  profile: BlobbonautProfile | null;
-  /** Called after ensuring companion is canonical (from migration helper) */
-  ensureCanonicalBeforeAction: () => Promise<{
-    companion: BlobbiCompanion;
-    content: string;
-    allTags: string[][];
-    wasMigrated: boolean;
-    /** Latest profile tags after migration (use instead of profile.allTags) */
-    profileAllTags: string[][];
-    /** Latest profile storage after migration (use instead of profile.storage) */
-    profileStorage: import('@/blobbi/core/lib/blobbi').StorageItem[];
-  } | null>;
-  /** Update companion event in local cache */
-  updateCompanionEvent: (event: NostrEvent) => void;
-  /** Update profile event in local cache */
-  updateProfileEvent: (event: NostrEvent) => void;
-  /** Invalidate companion queries */
-  invalidateCompanion: () => void;
-  /** Invalidate profile queries */
-  invalidateProfile: () => void;
-}
-
-// Import NostrEvent type
-import type { NostrEvent } from '@nostrify/nostrify';
-
-/**
- * Hook to use an inventory item on a Blobbi companion.
- * 
- * This hook:
- * 1. Validates the companion stage (eggs can't use items)
- * 2. Validates the item exists in storage
- * 3. Ensures canonical format before action
- * 4. Applies item effects to Blobbi stats
- * 5. Updates Blobbi state (kind 31124)
- * 6. Decrements item from profile storage (kind 11125)
- * 7. Invalidates relevant queries
- */
-export function useBlobbiUseInventoryItem({
-  companion,
-  profile,
-  ensureCanonicalBeforeAction,
-  updateCompanionEvent,
-  updateProfileEvent,
-  invalidateCompanion,
-  invalidateProfile,
-}: UseBlobbiUseInventoryItemParams) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-
-  return useMutation({
-    mutationFn: async ({ itemId, action, quantity = 1 }: UseItemRequest): Promise<UseItemResult> => {
-      // ─── Validation ───
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to use items');
-      }
-
-      if (!companion) {
-        throw new Error('No companion selected');
-      }
-
-      if (!profile) {
-        throw new Error('Profile not found');
-      }
-
-      // Validate quantity
-      if (quantity < 1) {
-        throw new Error('Quantity must be at least 1');
-      }
-
-      // Check stage restrictions for this specific action
-      if (!canUseAction(companion, action)) {
-        const message = getStageRestrictionMessage(companion, action);
-        throw new Error(message ?? 'This companion cannot use this item');
-      }
-
-      // Validate item exists in shop catalog
-      const shopItem = getShopItemById(itemId);
-      if (!shopItem) {
-        throw new Error('Item not found in catalog');
-      }
-
-      // Validate item exists in storage with sufficient quantity
-      const storageItem = profile.storage.find(s => s.itemId === itemId);
-      if (!storageItem || storageItem.quantity <= 0) {
-        throw new Error('Item not found in your inventory');
-      }
-      if (storageItem.quantity < quantity) {
-        throw new Error(`Not enough items in inventory (have ${storageItem.quantity}, need ${quantity})`);
-      }
-
-      // Validate item has effects
-      if (!shopItem.effect) {
-        throw new Error('This item has no effect');
-      }
-
-      // For eggs, validate that items have applicable effects
-      const isEgg = companion.stage === 'egg';
-      if (isEgg && action === 'medicine' && !hasMedicineEffectForEgg(shopItem.effect)) {
-        throw new Error('This medicine has no effect on eggs');
-      }
-      if (isEgg && action === 'clean' && !hasHygieneEffectForEgg(shopItem.effect)) {
-        throw new Error('This item has no cleaning effect on eggs');
-      }
-
-      // ─── Ensure Canonical Before Action ───
-      const canonical = await ensureCanonicalBeforeAction();
-      if (!canonical) {
-        throw new Error('Failed to prepare companion for action');
-      }
-
-      // ─── Apply Accumulated Decay First ───
-      // Per decay-system.md: Always apply accumulated decay from persisted state
-      // before any user interaction updates stats.
-      // CRITICAL: Use canonical.companion for decay calculations, not the stale outer companion
-      const now = Math.floor(Date.now() / 1000);
-      const decayResult = applyBlobbiDecay({
-        stage: canonical.companion.stage,
-        state: canonical.companion.state,
-        stats: canonical.companion.stats,
-        lastDecayAt: canonical.companion.lastDecayAt,
-        now,
-      });
-      
-      // Start with decayed stats as the base
-      const statsAfterDecay = decayResult.stats;
-      
-      // ─── Validate Play Energy Requirements ───
-      // For play actions, validate the Blobbi has enough energy AFTER decay
-      if (action === 'play') {
-        const energyCost = Math.abs(shopItem.effect.energy ?? 0);
-        const currentEnergy = statsAfterDecay.energy;
-        
-        if (energyCost > 0 && currentEnergy < energyCost) {
-          throw new Error(
-            `Your Blobbi needs at least ${energyCost} energy to play with this toy (current: ${currentEnergy})`
-          );
-        }
-        
-        // Also check if playing would have any effect at all
-        // If happiness is maxed AND we can't spend energy, playing is pointless
-        const happinessGain = shopItem.effect.happiness ?? 0;
-        const currentHappiness = statsAfterDecay.happiness;
-        const wouldGainHappiness = happinessGain > 0 && currentHappiness < 100;
-        const wouldSpendEnergy = energyCost > 0 && currentEnergy >= energyCost;
-        
-        if (!wouldGainHappiness && !wouldSpendEnergy) {
-          throw new Error(
-            'Playing would have no effect - your Blobbi is already at maximum happiness and has no energy to spend'
-          );
-        }
-      }
-      
-      // ─── Apply Item Effects ───
-      // Apply effects multiple times (once per quantity) to simulate using items in sequence.
-      // This ensures proper clamping at each step, e.g., using 5 health items when at 90 health
-      // won't give more than 100 health total.
-      // 
-      // CRITICAL: Track the number of items that actually produced INTENDED stat changes for XP.
-      // XP counting is action-aware - only count positive intended effects, NOT negative side effects:
-      // - feed: count when hunger/energy/health/happiness INCREASE (NOT when hygiene decreases)
-      // - clean: count when hygiene or happiness INCREASES
-      // - medicine: count when health/energy/happiness INCREASE (NOT negative side effects)
-      // - play: EXCEPTION - count when happiness increases OR energy decreases (both are intended effects)
-      //
-      // Use canonical companion stage for egg checks
-      const isEggCompanion = canonical.companion.stage === 'egg';
-      const statsUpdate: Record<string, string> = {};
-      const statsChanged: Record<string, number> = {};
-      let effectiveItemCount = 0; // Number of items that produced intended effects
-
-      if (isEggCompanion && action === 'medicine') {
-        // Egg medicine handling:
-        // Eggs use the 3-stat model: health, hygiene, happiness
-        // Medicine with health effect directly affects the egg's health stat
-        // hunger and energy remain fixed at 100 for eggs
-        
-        const healthDelta = shopItem.effect.health ?? 0;
-        // Apply health effect N times in sequence with clamping at each step
-        // Only count items that actually INCREASED health (positive effect only)
-        let currentHealth = statsAfterDecay.health ?? 0;
-        for (let i = 0; i < quantity; i++) {
-          const prevHealth = currentHealth;
-          currentHealth = applyStat(currentHealth, healthDelta);
-          // Only count as effective if health increased (not just changed)
-          if (healthDelta > 0 && currentHealth > prevHealth) {
-            effectiveItemCount++;
-          }
-        }
-        
-        statsUpdate.health = currentHealth.toString();
-        // Track total actual change (may be less than healthDelta * quantity due to clamping)
-        statsChanged.health = currentHealth - (statsAfterDecay.health ?? 0);
-        
-        // Apply decayed values for other egg stats
-        statsUpdate.hygiene = (statsAfterDecay.hygiene ?? 0).toString();
-        statsUpdate.happiness = (statsAfterDecay.happiness ?? 0).toString();
-        // hunger and energy stay at 100 for eggs
-        statsUpdate.hunger = '100';
-        statsUpdate.energy = '100';
-      } else if (isEggCompanion && action === 'clean') {
-        // Egg clean/hygiene handling:
-        // Hygiene items affect the egg's hygiene stat
-        // Some hygiene items also give happiness (e.g., bubble bath)
-        // hunger and energy remain fixed at 100 for eggs
-        
-        const hygieneDelta = shopItem.effect.hygiene ?? 0;
-        const happinessDelta = shopItem.effect.happiness ?? 0;
-        
-        // Apply effects N times in sequence
-        // Only count items that INCREASED hygiene or happiness (positive effects only)
-        let currentHygiene = statsAfterDecay.hygiene ?? 0;
-        let currentHappiness = statsAfterDecay.happiness ?? 0;
-        for (let i = 0; i < quantity; i++) {
-          const prevHygiene = currentHygiene;
-          const prevHappiness = currentHappiness;
-          currentHygiene = applyStat(currentHygiene, hygieneDelta);
-          currentHappiness = applyStat(currentHappiness, happinessDelta);
-          // Count as effective if hygiene OR happiness increased (positive effects only)
-          const hygieneIncreased = hygieneDelta > 0 && currentHygiene > prevHygiene;
-          const happinessIncreased = happinessDelta > 0 && currentHappiness > prevHappiness;
-          if (hygieneIncreased || happinessIncreased) {
-            effectiveItemCount++;
-          }
-        }
-        
-        statsUpdate.hygiene = currentHygiene.toString();
-        statsChanged.hygiene = currentHygiene - (statsAfterDecay.hygiene ?? 0);
-        
-        statsUpdate.happiness = currentHappiness.toString();
-        const totalHappinessChange = currentHappiness - (statsAfterDecay.happiness ?? 0);
-        if (totalHappinessChange !== 0) {
-          statsChanged.happiness = totalHappinessChange;
-        }
-        
-        // Apply decayed health
-        statsUpdate.health = (statsAfterDecay.health ?? 0).toString();
-        // hunger and energy stay at 100 for eggs
-        statsUpdate.hunger = '100';
-        statsUpdate.energy = '100';
-      } else {
-        // Normal stats application for baby/adult
-        // Apply item effects N times in sequence ON TOP of decayed stats
-        // Use action-aware effectiveness checking for XP calculation
-        let currentStats: Partial<BlobbiStats> = { ...statsAfterDecay };
-        const effect = shopItem.effect;
-        
-        for (let i = 0; i < quantity; i++) {
-          const prevStats = { ...currentStats };
-          currentStats = applyItemEffects(currentStats, effect);
-          
-          // Action-aware effectiveness check:
-          // Only count INTENDED positive effects, not negative side effects
-          let isEffective = false;
-          
-          if (action === 'feed') {
-            // Feed: count when hunger/energy/health/happiness INCREASE
-            // Do NOT count hygiene decrease (that's a side effect)
-            const hungerIncreased = (effect.hunger ?? 0) > 0 && (currentStats.hunger ?? 0) > (prevStats.hunger ?? 0);
-            const energyIncreased = (effect.energy ?? 0) > 0 && (currentStats.energy ?? 0) > (prevStats.energy ?? 0);
-            const healthIncreased = (effect.health ?? 0) > 0 && (currentStats.health ?? 0) > (prevStats.health ?? 0);
-            const happinessIncreased = (effect.happiness ?? 0) > 0 && (currentStats.happiness ?? 0) > (prevStats.happiness ?? 0);
-            isEffective = hungerIncreased || energyIncreased || healthIncreased || happinessIncreased;
-          } else if (action === 'clean') {
-            // Clean: count when hygiene or happiness INCREASES
-            const hygieneIncreased = (effect.hygiene ?? 0) > 0 && (currentStats.hygiene ?? 0) > (prevStats.hygiene ?? 0);
-            const happinessIncreased = (effect.happiness ?? 0) > 0 && (currentStats.happiness ?? 0) > (prevStats.happiness ?? 0);
-            isEffective = hygieneIncreased || happinessIncreased;
-          } else if (action === 'medicine') {
-            // Medicine: count when health/energy/happiness INCREASE
-            // Do NOT count negative side effects (like happiness decrease on Super Medicine)
-            const healthIncreased = (effect.health ?? 0) > 0 && (currentStats.health ?? 0) > (prevStats.health ?? 0);
-            const energyIncreased = (effect.energy ?? 0) > 0 && (currentStats.energy ?? 0) > (prevStats.energy ?? 0);
-            const happinessIncreased = (effect.happiness ?? 0) > 0 && (currentStats.happiness ?? 0) > (prevStats.happiness ?? 0);
-            isEffective = healthIncreased || energyIncreased || happinessIncreased;
-          } else if (action === 'play') {
-            // Play: EXCEPTION - both happiness increase AND energy decrease are intended effects
-            // Playing naturally consumes energy, so energy decrease counts as valid
-            const happinessIncreased = (effect.happiness ?? 0) > 0 && (currentStats.happiness ?? 0) > (prevStats.happiness ?? 0);
-            const energyDecreased = (effect.energy ?? 0) < 0 && (currentStats.energy ?? 0) < (prevStats.energy ?? 0);
-            isEffective = happinessIncreased || energyDecreased;
-          }
-          
-          if (isEffective) {
-            effectiveItemCount++;
-          }
-        }
-
-        statsUpdate.hunger = clampStat(currentStats.hunger).toString();
-        statsChanged.hunger = (currentStats.hunger ?? 0) - (statsAfterDecay.hunger ?? 0);
-        
-        statsUpdate.happiness = clampStat(currentStats.happiness).toString();
-        statsChanged.happiness = (currentStats.happiness ?? 0) - (statsAfterDecay.happiness ?? 0);
-        
-        statsUpdate.energy = clampStat(currentStats.energy).toString();
-        statsChanged.energy = (currentStats.energy ?? 0) - (statsAfterDecay.energy ?? 0);
-        
-        statsUpdate.hygiene = clampStat(currentStats.hygiene).toString();
-        statsChanged.hygiene = (currentStats.hygiene ?? 0) - (statsAfterDecay.hygiene ?? 0);
-        
-        statsUpdate.health = clampStat(currentStats.health).toString();
-        statsChanged.health = (currentStats.health ?? 0) - (statsAfterDecay.health ?? 0);
-      }
-
-      // ─── Update Blobbi State Event (kind 31124) ───
-      const nowStr = now.toString();
-      
-      // If incubating or evolving, increment the interaction counter for tasks
-      const companionState = canonical.companion.state;
-      let updatedTags = canonical.allTags;
-      if (companionState === 'incubating') {
-        updatedTags = incrementInteractionTaskTags(canonical.allTags, HATCH_REQUIRED_INTERACTIONS).updatedTags;
-      } else if (companionState === 'evolving') {
-        updatedTags = incrementInteractionTaskTags(canonical.allTags, EVOLVE_REQUIRED_INTERACTIONS).updatedTags;
-      }
-      
-      // Get streak updates (will only update if needed based on day)
-      const streakUpdates = getStreakTagUpdates(canonical.companion) ?? {};
-      
-      // ─── Apply XP Gain (Based on effective item count) ───
-      // Only grant XP for items that actually changed stats.
-      // If user used 100 food items but hunger capped at item #4, only 4 items were effective.
-      // This prevents XP farming by mass-using items after stats are already maxed.
-      const xpGained = effectiveItemCount > 0 ? calculateInventoryActionXP(action, effectiveItemCount) : 0;
-      const currentXP = canonical.companion.experience ?? 0;
-      const newXP = applyXPGain(currentXP, xpGained);
-      
-      const blobbiTags = updateBlobbiTags(updatedTags, {
-        ...statsUpdate,
-        ...streakUpdates,
-        experience: newXP.toString(),
-        last_interaction: nowStr,
-        last_decay_at: nowStr,
-      });
-
-      const blobbiEvent = await publishEvent({
-        kind: KIND_BLOBBI_STATE,
-        content: canonical.content,
-        tags: blobbiTags,
-      });
-
-      updateCompanionEvent(blobbiEvent);
-
-      // ─── Update Profile Storage (kind 11125) ───
-      // CRITICAL: Use canonical.profileStorage and canonical.profileAllTags
-      // instead of profile.storage/profile.allTags to avoid restoring
-      // stale/legacy values after migration
-      const newStorage = decrementStorageItem(canonical.profileStorage, itemId, quantity);
-      const storageValues = createStorageTags(newStorage).map(tag => tag[1]);
-
-      const profileTags = updateBlobbonautTags(canonical.profileAllTags, {
-        storage: storageValues,
-      });
-
-      const profileEvent = await publishEvent({
-        kind: KIND_BLOBBONAUT_PROFILE,
-        content: '',
-        tags: profileTags,
-      });
-
-      updateProfileEvent(profileEvent);
-
-      // ─── Invalidate Queries ───
-      invalidateCompanion();
-      invalidateProfile();
-
-      return {
-        itemName: shopItem.name,
-        action,
-        quantity,
-        effectiveItemCount, // How many items actually changed stats
-        statsChanged,
-        xpGained,
-        newXP,
-      };
-    },
-    onSuccess: ({ itemName, action, quantity, xpGained }) => {
-      const actionMeta = ACTION_METADATA[action];
-      const quantityText = quantity > 1 ? ` (x${quantity})` : '';
-      const xpText = formatXPGain(xpGained);
-      toast({
-        title: `${actionMeta.label} successful!`,
-        description: `Used ${itemName}${quantityText} on your Blobbi. ${xpText}`,
-      });
-
-      // Track daily mission progress
-      // 'interact' is always tracked, plus the specific action if it maps to a daily mission
-      const dailyActions: DailyMissionAction[] = ['interact'];
-      if (action === 'feed') dailyActions.push('feed');
-      if (action === 'clean') dailyActions.push('clean');
-      trackMultipleDailyMissionActions(dailyActions, user?.pubkey);
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to use item',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}

src/blobbi/actions/hooks/useClaimMissionReward.ts

@@ -1,242 +0,0 @@
-/**
- * useClaimMissionReward - Hook for claiming daily mission rewards
- * 
- * Handles:
- * - Persisting coin rewards to kind 11125 Blobbonaut profile
- * - Updating localStorage mission state
- * - Idempotent claiming (prevents double-credit)
- * - Optimistic cache updates
- */
-
-import { useMutation, useQueryClient } from '@tanstack/react-query';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { useNostrPublish } from '@/hooks/useNostrPublish';
-import { toast } from '@/hooks/useToast';
-
-import type { BlobbonautProfile } from '@/blobbi/core/lib/blobbi';
-import {
-  KIND_BLOBBONAUT_PROFILE,
-  updateBlobbonautTags,
-} from '@/blobbi/core/lib/blobbi';
-import {
-  type DailyMissionsState,
-  getTodayDateString,
-  needsDailyReset,
-  createDailyMissionsState,
-  isBonusMissionAvailable,
-  isBonusMissionClaimed,
-  BONUS_MISSION_DEFINITION,
-} from '../lib/daily-missions';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface ClaimMissionRequest {
-  missionId: string;
-}
-
-/** Special ID for claiming the bonus mission */
-export const BONUS_MISSION_ID = 'bonus_daily_complete';
-
-export interface ClaimMissionResult {
-  missionId: string;
-  coinsEarned: number;
-  newTotalCoins: number;
-}
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-const STORAGE_KEY = 'blobbi:daily-missions';
-
-// ─── Storage Utilities ────────────────────────────────────────────────────────
-
-function readMissionsState(): DailyMissionsState | null {
-  try {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    return stored ? JSON.parse(stored) : null;
-  } catch {
-    return null;
-  }
-}
-
-function writeMissionsState(state: DailyMissionsState): void {
-  try {
-    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
-  } catch (error) {
-    console.warn('[useClaimMissionReward] Failed to write state:', error);
-  }
-}
-
-// ─── Hook ─────────────────────────────────────────────────────────────────────
-
-/**
- * Hook to claim daily mission rewards.
- * 
- * This hook persists coin rewards to the kind 11125 Blobbonaut profile event,
- * ensuring rewards are stored on-chain rather than just in localStorage.
- * 
- * @param currentProfile - The current Blobbonaut profile (required for coin updates)
- * @param updateProfileEvent - Callback to update the profile in the query cache
- */
-export function useClaimMissionReward(
-  currentProfile: BlobbonautProfile | null,
-  updateProfileEvent: (event: import('@nostrify/nostrify').NostrEvent) => void
-) {
-  const { user } = useCurrentUser();
-  const { mutateAsync: publishEvent } = useNostrPublish();
-  const queryClient = useQueryClient();
-
-  return useMutation({
-    mutationFn: async ({ missionId }: ClaimMissionRequest): Promise<ClaimMissionResult> => {
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to claim rewards');
-      }
-
-      if (!currentProfile) {
-        throw new Error('Profile not found');
-      }
-
-      // Read current missions state from localStorage
-      let missionsState = readMissionsState();
-      
-      // Ensure we have valid state for today
-      if (needsDailyReset(missionsState)) {
-        const previousCoins = missionsState?.totalCoinsEarned ?? 0;
-        missionsState = createDailyMissionsState(getTodayDateString(), user.pubkey, previousCoins);
-      }
-
-      // Handle bonus mission claim
-      if (missionId === BONUS_MISSION_ID) {
-        // Check if bonus is available
-        if (!isBonusMissionAvailable(missionsState!)) {
-          throw new Error('Bonus mission not available yet');
-        }
-
-        // Check if already claimed
-        if (isBonusMissionClaimed(missionsState!)) {
-          throw new Error('Bonus reward already claimed');
-        }
-
-        const coinsToAdd = BONUS_MISSION_DEFINITION.reward;
-        const newTotalCoins = currentProfile.coins + coinsToAdd;
-
-        // Build updated tags with new coin balance
-        const updatedTags = updateBlobbonautTags(currentProfile.allTags, {
-          coins: newTotalCoins.toString(),
-        });
-
-        // Publish updated profile event
-        const event = await publishEvent({
-          kind: KIND_BLOBBONAUT_PROFILE,
-          content: '',
-          tags: updatedTags,
-        });
-
-        // Update the query cache
-        updateProfileEvent(event);
-
-        // Update localStorage to mark bonus as claimed
-        const updatedState: DailyMissionsState = {
-          ...missionsState!,
-          bonusClaimed: true,
-          totalCoinsEarned: missionsState!.totalCoinsEarned + coinsToAdd,
-        };
-
-        writeMissionsState(updatedState);
-
-        // Dispatch event for React components to re-render
-        window.dispatchEvent(new CustomEvent('daily-missions-updated', { 
-          detail: { missionId, claimed: true, isBonus: true } 
-        }));
-
-        return {
-          missionId,
-          coinsEarned: coinsToAdd,
-          newTotalCoins,
-        };
-      }
-
-      // Handle regular mission claim
-      const mission = missionsState!.missions.find(m => m.id === missionId);
-      if (!mission) {
-        throw new Error('Mission not found');
-      }
-
-      // Check if already claimed (idempotency check)
-      if (mission.claimed) {
-        throw new Error('Reward already claimed');
-      }
-
-      // Check if mission is completed
-      if (!mission.completed) {
-        throw new Error('Mission not completed yet');
-      }
-
-      const coinsToAdd = mission.reward;
-      const newTotalCoins = currentProfile.coins + coinsToAdd;
-
-      // Build updated tags with new coin balance
-      const updatedTags = updateBlobbonautTags(currentProfile.allTags, {
-        coins: newTotalCoins.toString(),
-      });
-
-      // Publish updated profile event to kind 11125
-      const event = await publishEvent({
-        kind: KIND_BLOBBONAUT_PROFILE,
-        content: '',
-        tags: updatedTags,
-      });
-
-      // Update the query cache optimistically
-      updateProfileEvent(event);
-
-      // Now update localStorage to mark mission as claimed
-      const updatedMissions = missionsState!.missions.map(m =>
-        m.id === missionId ? { ...m, claimed: true } : m
-      );
-
-      const updatedState: DailyMissionsState = {
-        ...missionsState!,
-        missions: updatedMissions,
-        totalCoinsEarned: missionsState!.totalCoinsEarned + coinsToAdd,
-      };
-
-      writeMissionsState(updatedState);
-
-      // Dispatch event for React components to re-render
-      window.dispatchEvent(new CustomEvent('daily-missions-updated', { 
-        detail: { missionId, claimed: true } 
-      }));
-
-      return {
-        missionId,
-        coinsEarned: coinsToAdd,
-        newTotalCoins,
-      };
-    },
-    onSuccess: ({ coinsEarned }) => {
-      // Invalidate profile query to ensure fresh data
-      if (user?.pubkey) {
-        queryClient.invalidateQueries({ queryKey: ['blobbonaut-profile', user.pubkey] });
-      }
-
-      // Show success toast
-      toast({
-        title: 'Reward Claimed!',
-        description: `You earned ${coinsEarned} coins.`,
-      });
-    },
-    onError: (error: Error) => {
-      // Don't show error for already claimed (user might have double-clicked)
-      if (error.message === 'Reward already claimed' || error.message === 'Bonus reward already claimed') {
-        return;
-      }
-
-      toast({
-        title: 'Failed to Claim Reward',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}

src/blobbi/actions/hooks/useDailyMissions.ts

@@ -1,201 +0,0 @@
-/**
- * useDailyMissions - Hook for managing Blobbi daily missions
- * 
- * Provides:
- * - Daily mission state management with localStorage persistence
- * - Automatic daily reset
- * - Progress tracking functions
- * - Read-only access to mission state (claiming is handled by useClaimMissionReward)
- * - Stage-based filtering (only shows missions user can complete)
- * - Bonus mission tracking
- * 
- * Note: Reward claiming should be done via useClaimMissionReward hook,
- * which persists coins to the kind 11125 Blobbonaut profile.
- */
-
-import { useMemo, useEffect, useState, useCallback } from 'react';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import {
-  type DailyMissionsState,
-  type DailyMission,
-  type BlobbiStage,
-  getTodayDateString,
-  needsDailyReset,
-  createDailyMissionsState,
-  areAllMissionsCompleted,
-  areAllMissionsClaimed,
-  getTotalPotentialReward,
-  getTodayClaimedReward,
-  isBonusMissionAvailable,
-  isBonusMissionClaimed,
-  BONUS_MISSION_DEFINITION,
-  getRerollsRemaining,
-  MAX_DAILY_REROLLS,
-} from '../lib/daily-missions';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface UseDailyMissionsOptions {
-  /** Available Blobbi stages the user has (filters eligible missions) */
-  availableStages?: BlobbiStage[];
-}
-
-export interface UseDailyMissionsResult {
-  /** Current daily missions state */
-  missions: DailyMission[];
-  /** Whether all missions are completed */
-  allCompleted: boolean;
-  /** Whether all missions are claimed */
-  allClaimed: boolean;
-  /** Total potential reward for today (including bonus if available) */
-  totalPotentialReward: number;
-  /** Total claimed reward for today */
-  todayClaimedReward: number;
-  /** Lifetime total coins earned from daily missions */
-  lifetimeCoinsEarned: number;
-  /** Whether the bonus mission is available (all regular missions completed) */
-  bonusAvailable: boolean;
-  /** Whether the bonus mission has been claimed */
-  bonusClaimed: boolean;
-  /** Bonus mission reward amount */
-  bonusReward: number;
-  /** Whether user has no eligible missions (e.g., only eggs) */
-  noMissionsAvailable: boolean;
-  /** Number of rerolls remaining for today */
-  rerollsRemaining: number;
-  /** Maximum rerolls allowed per day */
-  maxRerolls: number;
-  /** Force refresh missions (for testing or manual reset) */
-  forceReset: () => void;
-}
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-const STORAGE_KEY = 'blobbi:daily-missions';
-
-// ─── Storage Utilities ────────────────────────────────────────────────────────
-
-function readMissionsState(): DailyMissionsState | null {
-  try {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    return stored ? JSON.parse(stored) : null;
-  } catch {
-    return null;
-  }
-}
-
-function writeMissionsState(state: DailyMissionsState): void {
-  try {
-    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
-  } catch (error) {
-    console.warn('[useDailyMissions] Failed to write state:', error);
-  }
-}
-
-// ─── Hook ─────────────────────────────────────────────────────────────────────
-
-export function useDailyMissions(options: UseDailyMissionsOptions = {}): UseDailyMissionsResult {
-  const { availableStages } = options;
-  const { user } = useCurrentUser();
-  const pubkey = user?.pubkey;
-
-  // Read state directly from localStorage, with a version counter to trigger re-reads
-  const [version, setVersion] = useState(0);
-  
-  // Read from localStorage on every render when version changes
-  // eslint-disable-next-line react-hooks/exhaustive-deps -- version is intentionally used to force re-read
-  const state = useMemo(() => readMissionsState(), [version]);
-  
-  // Wrapper to write state and update version
-  const setState = useCallback((newState: DailyMissionsState) => {
-    writeMissionsState(newState);
-    setVersion((v) => v + 1);
-  }, []);
-
-  // Listen for external updates from mutations (reroll, claim, progress tracking)
-  // This re-reads localStorage when other hooks modify it directly
-  useEffect(() => {
-    const handleExternalUpdate = () => {
-      // Bump version to trigger a re-read from localStorage
-      setVersion((v) => v + 1);
-    };
-
-    window.addEventListener('daily-missions-updated', handleExternalUpdate);
-    return () => window.removeEventListener('daily-missions-updated', handleExternalUpdate);
-  }, []);
-
-  // Stable key for availableStages to use in dependencies
-  const stagesKey = availableStages?.sort().join(',') ?? '';
-
-  // Ensure we have valid state for today
-  const currentState = useMemo(() => {
-    // Check if we need to reset for a new day
-    if (needsDailyReset(state)) {
-      const previousCoins = state?.totalCoinsEarned ?? 0;
-      const newState = createDailyMissionsState(getTodayDateString(), pubkey, previousCoins, availableStages);
-      // Persist the reset state (this will trigger version bump via setState)
-      writeMissionsState(newState);
-      return newState;
-    }
-    
-    // Migration: ensure rerollsRemaining is set for old state
-    if (state && state.rerollsRemaining === undefined) {
-      const migratedState = {
-        ...state,
-        rerollsRemaining: MAX_DAILY_REROLLS,
-      };
-      writeMissionsState(migratedState);
-      return migratedState;
-    }
-    
-    return state!;
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [state, pubkey, stagesKey]);
-
-  // Force reset missions (for testing)
-  const forceReset = () => {
-    const previousCoins = state?.totalCoinsEarned ?? 0;
-    const newState = createDailyMissionsState(getTodayDateString(), pubkey, previousCoins, availableStages);
-    setState(newState);
-  };
-
-  // Computed values
-  const missions = currentState.missions;
-  const allCompleted = areAllMissionsCompleted(currentState);
-  const allClaimed = areAllMissionsClaimed(currentState);
-  const bonusAvailable = isBonusMissionAvailable(currentState);
-  const bonusClaimed = isBonusMissionClaimed(currentState);
-  const bonusReward = BONUS_MISSION_DEFINITION.reward;
-  const noMissionsAvailable = missions.length === 0;
-  const rerollsRemaining = getRerollsRemaining(currentState);
-  const maxRerolls = MAX_DAILY_REROLLS;
-  
-  // Total potential includes bonus if regular missions exist
-  const basePotentialReward = getTotalPotentialReward(currentState);
-  const totalPotentialReward = missions.length > 0 
-    ? basePotentialReward + bonusReward 
-    : 0;
-  
-  // Today's claimed includes bonus if claimed
-  const baseTodayClaimedReward = getTodayClaimedReward(currentState);
-  const todayClaimedReward = baseTodayClaimedReward + (bonusClaimed ? bonusReward : 0);
-  
-  const lifetimeCoinsEarned = currentState.totalCoinsEarned;
-
-  return {
-    missions,
-    allCompleted,
-    allClaimed,
-    totalPotentialReward,
-    todayClaimedReward,
-    lifetimeCoinsEarned,
-    bonusAvailable,
-    bonusClaimed,
-    bonusReward,
-    noMissionsAvailable,
-    rerollsRemaining,
-    maxRerolls,
-    forceReset,
-  };
-}

src/blobbi/actions/hooks/useEvolveTasks.ts

@@ -1,363 +0,0 @@
-// src/blobbi/actions/hooks/useEvolveTasks.ts
-
-/**
- * Hook to compute evolve task progress from Nostr events and current stats.
- * 
- * CRITICAL ARCHITECTURE:
- * - PERSISTENT TASKS: Based on Nostr events, can be cached in tags
- * - DYNAMIC TASKS: Based on current stats, NEVER stored in tags
- * 
- * Tags are only cache for persistent tasks. Source of truth = Nostr events.
- */
-
-import { useQuery } from '@tanstack/react-query';
-import { useNostr } from '@nostrify/react';
-import type { NostrEvent, NostrFilter } from '@nostrify/nostrify';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-
-import {
-  KIND_THEME_DEFINITION,
-  KIND_COLOR_MOMENT,
-  KIND_PROFILE_METADATA,
-  KIND_SHORT_TEXT_NOTE,
-  BLOBBI_POST_REQUIRED_HASHTAGS,
-  sanitizeToHashtag,
-  type HatchTask,
-  type TaskType,
-} from './useHatchTasks';
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-/** Kind for custom profile tabs event */
-export const KIND_PROFILE_TABS = 16769;
-
-/** Required themes for evolve task */
-export const EVOLVE_REQUIRED_THEMES = 3;
-
-/** Required color moments for evolve task */
-export const EVOLVE_REQUIRED_COLOR_MOMENTS = 3;
-
-/** Required posts for evolve task (lighter than hatch - just 1 evolve-specific post) */
-export const EVOLVE_REQUIRED_POSTS = 1;
-
-/** Required interactions for evolve task */
-export const EVOLVE_REQUIRED_INTERACTIONS = 21;
-
-/** Prefix text for Blobbi evolve post */
-export const BLOBBI_EVOLVE_POST_PREFIX = 'Hello Nostr! Posting to evolve';
-
-/** Stat threshold for evolve dynamic task (all stats >= 80) */
-export const EVOLVE_STAT_THRESHOLD = 80;
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-// Re-export task types for convenience
-export type { HatchTask as EvolveTask, TaskType };
-
-/**
- * Result of computing evolve tasks.
- */
-export interface EvolveTasksResult {
-  tasks: HatchTask[];
-  /** All persistent tasks are complete */
-  persistentTasksComplete: boolean;
-  /** Dynamic stat task is complete */
-  dynamicTaskComplete: boolean;
-  /** All tasks (persistent + dynamic) are complete - required to evolve */
-  allCompleted: boolean;
-  isLoading: boolean;
-  error: Error | null;
-  /** Refetch task progress */
-  refetch: () => void;
-}
-
-// ─── Helper Functions ─────────────────────────────────────────────────────────
-
-/**
- * Check if a post is a valid Blobbi evolve post.
- * Must contain the evolve prefix and all required hashtags including the Blobbi name.
- * 
- * @param event - The Nostr event to validate
- * @param blobbiName - The Blobbi's name (will be sanitized and checked as hashtag)
- */
-export function isValidEvolvePost(event: NostrEvent, blobbiName: string): boolean {
-  // Check content starts with evolve prefix
-  if (!event.content.startsWith(BLOBBI_EVOLVE_POST_PREFIX)) {
-    return false;
-  }
-  
-  // Check for required hashtags in tags
-  const hashtags = event.tags
-    .filter(tag => tag[0] === 't')
-    .map(tag => tag[1]?.toLowerCase());
-  
-  // All required hashtags must be present
-  const hasRequiredHashtags = BLOBBI_POST_REQUIRED_HASHTAGS.every(required => 
-    hashtags.includes(required.toLowerCase())
-  );
-  
-  if (!hasRequiredHashtags) {
-    return false;
-  }
-  
-  // Blobbi name hashtag must also be present
-  const blobbiHashtag = sanitizeToHashtag(blobbiName);
-  return hashtags.includes(blobbiHashtag);
-}
-
-// ─── Main Hook ────────────────────────────────────────────────────────────────
-
-/**
- * Hook to compute evolve task progress from Nostr events and current stats.
- * 
- * PERSISTENT TASKS (event-based, can be cached):
- * 1. Create 3 Themes (kind 36767)
- * 2. Create 3 Color Moments (kind 3367)
- * 3. Create 1 Evolve Post (kind 1) - lighter than hatch, evolve-specific
- * 4. Interact 21 times (tracked via companion.tasks cache)
- * 5. Edit Profile once (kind 0 profile metadata OR kind 16769 custom tabs)
- * 
- * DYNAMIC TASK (stat-based, NEVER cached):
- * 6. Maintain All Stats >= 80
- * 
- * @param companion - The Blobbi companion (must be in evolving state)
- * @param interactionCount - Current interaction count from companion tasks cache
- */
-export function useEvolveTasks(
-  companion: BlobbiCompanion | null,
-  interactionCount?: number
-): EvolveTasksResult {
-  const { user } = useCurrentUser();
-  const { nostr } = useNostr();
-  
-  const pubkey = user?.pubkey;
-  const stateStartedAt = companion?.stateStartedAt;
-  const isEvolving = companion?.state === 'evolving';
-  
-  // Query for all relevant events
-  const { data, isLoading, error, refetch } = useQuery({
-    queryKey: ['evolve-tasks', pubkey, stateStartedAt],
-    queryFn: async () => {
-      if (!pubkey || !stateStartedAt) {
-        return null;
-      }
-      
-      // Build filters for events we need
-      const filters: NostrFilter[] = [
-        // Theme definitions after start
-        {
-          kinds: [KIND_THEME_DEFINITION],
-          authors: [pubkey],
-          since: stateStartedAt,
-        },
-        // Color moments after start
-        {
-          kinds: [KIND_COLOR_MOMENT],
-          authors: [pubkey],
-          since: stateStartedAt,
-        },
-        // Posts after start (will filter for valid evolve posts)
-        {
-          kinds: [KIND_SHORT_TEXT_NOTE],
-          authors: [pubkey],
-          since: stateStartedAt,
-          limit: 50, // Only need 1 valid evolve post
-        },
-        // Custom profile tabs after start
-        {
-          kinds: [KIND_PROFILE_TABS],
-          authors: [pubkey],
-          since: stateStartedAt,
-          limit: 1, // Only need 1
-        },
-        // Profile metadata after start (for Blobbi shape check + profile edit mission)
-        {
-          kinds: [KIND_PROFILE_METADATA],
-          authors: [pubkey],
-          since: stateStartedAt,
-          limit: 1,
-        },
-      ];
-      
-      // Execute all queries
-      const events = await nostr.query(filters);
-      
-      // Categorize events
-      const themeEvents = events.filter(e => 
-        e.kind === KIND_THEME_DEFINITION && e.created_at >= stateStartedAt
-      );
-      
-      const colorMomentEvents = events.filter(e => 
-        e.kind === KIND_COLOR_MOMENT && e.created_at >= stateStartedAt
-      );
-      
-      const postEvents = events.filter(e => 
-        e.kind === KIND_SHORT_TEXT_NOTE && e.created_at >= stateStartedAt
-      );
-      
-      const profileTabsEvents = events.filter(e => 
-        e.kind === KIND_PROFILE_TABS && e.created_at >= stateStartedAt
-      );
-      
-      // Get latest profile after start
-      const profileEvents = events.filter(e => e.kind === KIND_PROFILE_METADATA);
-      const profileAfter = profileEvents
-        .filter(e => e.created_at >= stateStartedAt)
-        .sort((a, b) => b.created_at - a.created_at)[0];
-      
-      return {
-        themeEvents,
-        colorMomentEvents,
-        postEvents,
-        profileTabsEvents,
-        profileAfter,
-      };
-    },
-    enabled: !!pubkey && !!stateStartedAt && isEvolving,
-    staleTime: 30_000, // 30 seconds
-    refetchInterval: 60_000, // Refetch every minute
-  });
-  
-  // ─── Compute PERSISTENT Tasks ───
-  const tasks: HatchTask[] = [];
-  
-  // 1. Create 3 Themes (PERSISTENT)
-  const themeCount = data?.themeEvents?.length ?? 0;
-  const themesCompleted = themeCount >= EVOLVE_REQUIRED_THEMES;
-  tasks.push({
-    id: 'create_themes',
-    name: 'Create Themes',
-    description: `Create ${EVOLVE_REQUIRED_THEMES} custom themes`,
-    current: Math.min(themeCount, EVOLVE_REQUIRED_THEMES),
-    required: EVOLVE_REQUIRED_THEMES,
-    completed: themesCompleted,
-    type: 'persistent',
-    action: 'navigate',
-    actionTarget: '/themes',
-    actionLabel: 'Create Theme',
-  });
-  
-  // 2. Create 3 Color Moments (PERSISTENT)
-  const colorMomentCount = data?.colorMomentEvents?.length ?? 0;
-  const colorMomentsCompleted = colorMomentCount >= EVOLVE_REQUIRED_COLOR_MOMENTS;
-  tasks.push({
-    id: 'color_moments',
-    name: 'Color Moments',
-    description: `Share ${EVOLVE_REQUIRED_COLOR_MOMENTS} color moments on espy`,
-    current: Math.min(colorMomentCount, EVOLVE_REQUIRED_COLOR_MOMENTS),
-    required: EVOLVE_REQUIRED_COLOR_MOMENTS,
-    completed: colorMomentsCompleted,
-    type: 'persistent',
-    action: 'external_link',
-    actionTarget: 'https://espy.you/',
-    actionLabel: 'Open espy',
-  });
-  
-  // 3. Create 1 Evolve Post (PERSISTENT) - lighter than hatch
-  const blobbiName = companion?.name ?? '';
-  const validPosts = data?.postEvents?.filter(e => isValidEvolvePost(e, blobbiName)) ?? [];
-  const postCount = validPosts.length;
-  const postsCompleted = postCount >= EVOLVE_REQUIRED_POSTS;
-  tasks.push({
-    id: 'create_posts',
-    name: 'Share Evolution',
-    description: 'Post about your Blobbi evolving',
-    current: Math.min(postCount, EVOLVE_REQUIRED_POSTS),
-    required: EVOLVE_REQUIRED_POSTS,
-    completed: postsCompleted,
-    type: 'persistent',
-    action: 'open_modal',
-    actionTarget: 'blobbi_post',
-    actionLabel: 'Create Post',
-  });
-  
-  // 4. Interact 21 times (PERSISTENT)
-  const interactions = interactionCount ?? 0;
-  const interactionsCompleted = interactions >= EVOLVE_REQUIRED_INTERACTIONS;
-  tasks.push({
-    id: 'interactions',
-    name: 'Interact with Blobbi',
-    description: `Care for your Blobbi ${EVOLVE_REQUIRED_INTERACTIONS} times`,
-    current: Math.min(interactions, EVOLVE_REQUIRED_INTERACTIONS),
-    required: EVOLVE_REQUIRED_INTERACTIONS,
-    completed: interactionsCompleted,
-    type: 'persistent',
-    // No action - just interact with Blobbi
-  });
-  
-  // 5. Edit Profile once (PERSISTENT) — kind 0 profile metadata OR kind 16769 custom tabs
-  const hasTabsEdit = (data?.profileTabsEvents?.length ?? 0) >= 1;
-  const hasMetadataEdit = !!data?.profileAfter;
-  const hasProfileEdit = hasTabsEdit || hasMetadataEdit;
-  tasks.push({
-    id: 'edit_profile',
-    name: 'Edit Your Profile',
-    description: 'Update your profile info or customize your profile tabs',
-    current: hasProfileEdit ? 1 : 0,
-    required: 1,
-    completed: hasProfileEdit,
-    type: 'persistent',
-    action: 'navigate',
-    actionTarget: '/settings/profile',
-    actionLabel: 'Edit Profile',
-  });
-  
-  // ─── Compute DYNAMIC Task (stat-based, NEVER cached) ───
-  // 7. Maintain All Stats >= 80
-  const stats = companion?.stats ?? {};
-  const hunger = stats.hunger ?? 0;
-  const happiness = stats.happiness ?? 0;
-  const health = stats.health ?? 0;
-  const hygiene = stats.hygiene ?? 0;
-  const energy = stats.energy ?? 0;
-  
-  const statsOk = 
-    hunger >= EVOLVE_STAT_THRESHOLD &&
-    happiness >= EVOLVE_STAT_THRESHOLD &&
-    health >= EVOLVE_STAT_THRESHOLD &&
-    hygiene >= EVOLVE_STAT_THRESHOLD &&
-    energy >= EVOLVE_STAT_THRESHOLD;
-  
-  // Calculate minimum stat for progress display
-  const minStat = Math.min(hunger, happiness, health, hygiene, energy);
-  
-  tasks.push({
-    id: 'maintain_stats',
-    name: 'Peak Condition',
-    description: `Keep all stats above ${EVOLVE_STAT_THRESHOLD}`,
-    current: statsOk ? EVOLVE_STAT_THRESHOLD : minStat,
-    required: EVOLVE_STAT_THRESHOLD,
-    completed: statsOk,
-    type: 'dynamic', // CRITICAL: Never persist this task
-    // No action - just care for your Blobbi
-  });
-  
-  // ─── Compute Completion States ───
-  const persistentTasks = tasks.filter(t => t.type === 'persistent');
-  const dynamicTasks = tasks.filter(t => t.type === 'dynamic');
-  
-  const persistentTasksComplete = persistentTasks.every(t => t.completed);
-  const dynamicTaskComplete = dynamicTasks.every(t => t.completed);
-  const allCompleted = persistentTasksComplete && dynamicTaskComplete;
-  
-  return {
-    tasks,
-    persistentTasksComplete,
-    dynamicTaskComplete,
-    allCompleted,
-    isLoading,
-    error: error as Error | null,
-    refetch,
-  };
-}
-
-/**
- * Get the current interaction count for evolve from companion task cache.
- */
-export function getEvolveInteractionCount(companion: BlobbiCompanion | null): number {
-  if (!companion) return 0;
-  const interactionTask = companion.tasks.find(t => t.name === 'interactions');
-  return interactionTask?.value ?? 0;
-}

src/blobbi/actions/hooks/useHatchTasks.ts

@@ -1,364 +0,0 @@
-// src/blobbi/actions/hooks/useHatchTasks.ts
-
-/**
- * Hook to compute hatch task progress from Nostr events.
- * 
- * CRITICAL ARCHITECTURE:
- * - PERSISTENT TASKS: Based on Nostr events, can be cached in tags
- * 
- * Tags are only cache for persistent tasks. Source of truth = Nostr events.
- * All persistent tasks are computed dynamically from events with created_at >= state_started_at.
- * 
- * Note: Egg stats no longer decay, so there are no dynamic tasks for hatching.
- */
-
-import { useQuery } from '@tanstack/react-query';
-import { useNostr } from '@nostrify/react';
-import type { NostrEvent, NostrFilter } from '@nostrify/nostrify';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import type { BlobbiCompanion } from '@/blobbi/core/lib/blobbi';
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-/** Kind for theme definition events */
-export const KIND_THEME_DEFINITION = 36767;
-/** Kind for color moment events (espy.you) */
-export const KIND_COLOR_MOMENT = 3367;
-/** Kind for profile metadata */
-export const KIND_PROFILE_METADATA = 0;
-/** Kind for short text notes */
-export const KIND_SHORT_TEXT_NOTE = 1;
-
-/** Required interactions to complete the hatch interactions task */
-export const HATCH_REQUIRED_INTERACTIONS = 7;
-
-/** Required hashtags for the Blobbi post (excludes Blobbi name, which is dynamic) */
-export const BLOBBI_POST_REQUIRED_HASHTAGS = ['blobbi'];
-
-/** Prefix text for Blobbi hatch post (the Blobbi name is appended after this) */
-export const BLOBBI_POST_PREFIX = 'Posting to hatch';
-
-// Legacy export for backwards compatibility
-export const REQUIRED_INTERACTIONS = HATCH_REQUIRED_INTERACTIONS;
-
-/**
- * Sanitize a name into a valid hashtag format.
- * Must match the implementation in BlobbiPostModal.tsx.
- */
-export function sanitizeToHashtag(name: string): string {
-  return name
-    .toLowerCase()
-    // Remove emojis and special characters, keep letters, numbers, underscores
-    .replace(/[^\p{L}\p{N}_]/gu, '')
-    // Ensure it starts with a letter (prepend 'blobbi' if it starts with number)
-    .replace(/^(\d)/, 'blobbi$1')
-    // Limit length
-    .slice(0, 30)
-    // Fallback if empty
-    || 'myblobbi';
-}
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Task type classification.
- * - persistent: Based on Nostr events, can be cached in tags
- * - dynamic: Based on current stats, NEVER stored in tags
- */
-export type TaskType = 'persistent' | 'dynamic';
-
-/**
- * Individual task definition.
- */
-export interface HatchTask {
-  id: string;
-  name: string;
-  description: string;
-  /** Current progress value */
-  current: number;
-  /** Required value for completion */
-  required: number;
-  /** Whether the task is complete */
-  completed: boolean;
-  /** Task type - persistent (event-based) or dynamic (stat-based) */
-  type: TaskType;
-  /** Action to perform (if applicable) */
-  action?: 'navigate' | 'open_modal' | 'external_link';
-  /** Target for the action */
-  actionTarget?: string;
-  /** Button label */
-  actionLabel?: string;
-}
-
-/**
- * Result of computing hatch tasks.
- */
-export interface HatchTasksResult {
-  tasks: HatchTask[];
-  /** All persistent tasks are complete */
-  persistentTasksComplete: boolean;
-  /** Dynamic stat task is complete */
-  dynamicTaskComplete: boolean;
-  /** All tasks (persistent + dynamic) are complete - required to hatch */
-  allCompleted: boolean;
-  isLoading: boolean;
-  error: Error | null;
-  /** Refetch task progress */
-  refetch: () => void;
-}
-
-// ─── Helper Functions ─────────────────────────────────────────────────────────
-
-/**
- * Build the required phrase for a hatch post.
- * Format: "Posting to hatch {CapitalizedName} #blobbi"
- */
-export function buildHatchPhrase(blobbiName: string): string {
-  const capitalized = blobbiName.charAt(0).toUpperCase() + blobbiName.slice(1);
-  return `${BLOBBI_POST_PREFIX} ${capitalized} #blobbi`;
-}
-
-/**
- * Check if a post is a valid Blobbi hatch post.
- * The post must contain the required phrase: "Posting to hatch {Name} #blobbi"
- * The user may add extra text before or after it.
- * 
- * @param event - The Nostr event to validate
- * @param blobbiName - The Blobbi's name
- */
-export function isValidHatchPost(event: NostrEvent, blobbiName: string): boolean {
-  const phrase = buildHatchPhrase(blobbiName);
-
-  // The phrase must appear somewhere in the content
-  if (!event.content.includes(phrase)) {
-    return false;
-  }
-  
-  // Check for required hashtags in tags
-  const hashtags = event.tags
-    .filter(tag => tag[0] === 't')
-    .map(tag => tag[1]?.toLowerCase());
-  
-  // All required hashtags must be present as t tags
-  const hasRequiredHashtags = BLOBBI_POST_REQUIRED_HASHTAGS.every(required => 
-    hashtags.includes(required.toLowerCase())
-  );
-  
-  return hasRequiredHashtags;
-}
-
-// Legacy function name for backwards compatibility
-export const isValidBlobbiPost = isValidHatchPost;
-
-// ─── Main Hook ────────────────────────────────────────────────────────────────
-
-/**
- * Hook to compute hatch task progress from Nostr events and current stats.
- * 
- * PERSISTENT TASKS (event-based, can be cached):
- * 1. Create Theme (kind 36767) - ≥1 event after start
- * 2. Color Moment (kind 3367) - ≥1 event after start
- * 3. Create Post (kind 1) - ≥1 valid Blobbi hatch post after start
- * 4. Interactions - 7 total (tracked via companion.tasks cache)
- * 
- * Note: Egg stats no longer decay, so the "maintain stats" dynamic task
- * has been removed. The baby/adult evolve equivalent is still in useEvolveTasks.
- * 
- * @param companion - The Blobbi companion (must be incubating)
- * @param interactionCount - Current interaction count from companion tasks cache
- */
-export function useHatchTasks(
-  companion: BlobbiCompanion | null,
-  interactionCount?: number
-): HatchTasksResult {
-  const { user } = useCurrentUser();
-  const { nostr } = useNostr();
-  
-  const pubkey = user?.pubkey;
-  const stateStartedAt = companion?.stateStartedAt;
-  const isIncubating = companion?.state === 'incubating';
-  
-  // Query for all relevant events
-  const { data, isLoading, error, refetch } = useQuery({
-    queryKey: ['hatch-tasks', pubkey, stateStartedAt],
-    queryFn: async () => {
-      if (!pubkey || !stateStartedAt) {
-        return null;
-      }
-      
-      // Build filters for events we need
-      const filters: NostrFilter[] = [
-        // Theme definitions after start
-        {
-          kinds: [KIND_THEME_DEFINITION],
-          authors: [pubkey],
-          since: stateStartedAt,
-        },
-        // Color moments after start
-        {
-          kinds: [KIND_COLOR_MOMENT],
-          authors: [pubkey],
-          since: stateStartedAt,
-        },
-        // Posts after start (will filter for valid Blobbi posts)
-        {
-          kinds: [KIND_SHORT_TEXT_NOTE],
-          authors: [pubkey],
-          since: stateStartedAt,
-          limit: 50, // Reasonable limit
-        },
-        // Profile metadata - need both before and after start
-        // Get latest before start
-        {
-          kinds: [KIND_PROFILE_METADATA],
-          authors: [pubkey],
-          until: stateStartedAt,
-          limit: 1,
-        },
-        // Get latest after start
-        {
-          kinds: [KIND_PROFILE_METADATA],
-          authors: [pubkey],
-          since: stateStartedAt,
-          limit: 1,
-        },
-      ];
-      
-      // Execute all queries
-      const events = await nostr.query(filters);
-      
-      // Categorize events
-      const themeEvents = events.filter(e => 
-        e.kind === KIND_THEME_DEFINITION && e.created_at >= stateStartedAt
-      );
-      
-      const colorMomentEvents = events.filter(e => 
-        e.kind === KIND_COLOR_MOMENT && e.created_at >= stateStartedAt
-      );
-      
-      const postEvents = events.filter(e => 
-        e.kind === KIND_SHORT_TEXT_NOTE && e.created_at >= stateStartedAt
-      );
-      
-      // Separate profile events into before and after
-      const profileEvents = events.filter(e => e.kind === KIND_PROFILE_METADATA);
-      const profileBefore = profileEvents
-        .filter(e => e.created_at < stateStartedAt)
-        .sort((a, b) => b.created_at - a.created_at)[0];
-      const profileAfter = profileEvents
-        .filter(e => e.created_at >= stateStartedAt)
-        .sort((a, b) => b.created_at - a.created_at)[0];
-      
-      return {
-        themeEvents,
-        colorMomentEvents,
-        postEvents,
-        profileBefore,
-        profileAfter,
-      };
-    },
-    enabled: !!pubkey && !!stateStartedAt && isIncubating,
-    staleTime: 30_000, // 30 seconds
-    refetchInterval: 60_000, // Refetch every minute
-  });
-  
-  // ─── Compute PERSISTENT Tasks ───
-  const tasks: HatchTask[] = [];
-  
-  // 1. Create Theme (PERSISTENT)
-  const hasTheme = (data?.themeEvents?.length ?? 0) >= 1;
-  tasks.push({
-    id: 'create_theme',
-    name: 'Create Theme',
-    description: 'Create a custom theme for your profile',
-    current: hasTheme ? 1 : 0,
-    required: 1,
-    completed: hasTheme,
-    type: 'persistent',
-    action: 'navigate',
-    actionTarget: '/themes',
-    actionLabel: 'Create Theme',
-  });
-  
-  // 2. Color Moment (PERSISTENT)
-  const hasColorMoment = (data?.colorMomentEvents?.length ?? 0) >= 1;
-  tasks.push({
-    id: 'color_moment',
-    name: 'Color Moment',
-    description: 'Share a color moment on espy',
-    current: hasColorMoment ? 1 : 0,
-    required: 1,
-    completed: hasColorMoment,
-    type: 'persistent',
-    action: 'external_link',
-    actionTarget: 'https://espy.you/',
-    actionLabel: 'Open espy',
-  });
-  
-  // 3. Create Post (PERSISTENT)
-  const blobbiName = companion?.name ?? '';
-  const validPosts = data?.postEvents?.filter(e => isValidHatchPost(e, blobbiName)) ?? [];
-  const hasValidPost = validPosts.length >= 1;
-  tasks.push({
-    id: 'create_post',
-    name: 'Create Post',
-    description: 'Share a post about hatching your Blobbi',
-    current: hasValidPost ? 1 : 0,
-    required: 1,
-    completed: hasValidPost,
-    type: 'persistent',
-    action: 'open_modal',
-    actionTarget: 'blobbi_post',
-    actionLabel: 'Create Post',
-  });
-  
-  // 5. Interactions (PERSISTENT)
-  const interactions = interactionCount ?? 0;
-  const interactionsCompleted = interactions >= HATCH_REQUIRED_INTERACTIONS;
-  tasks.push({
-    id: 'interactions',
-    name: 'Interact with Blobbi',
-    description: `Care for your Blobbi ${HATCH_REQUIRED_INTERACTIONS} times`,
-    current: Math.min(interactions, HATCH_REQUIRED_INTERACTIONS),
-    required: HATCH_REQUIRED_INTERACTIONS,
-    completed: interactionsCompleted,
-    type: 'persistent',
-    // No action - just interact with Blobbi
-  });
-  
-  // ─── Compute Completion States ───
-  const persistentTasks = tasks.filter(t => t.type === 'persistent');
-  const dynamicTasks = tasks.filter(t => t.type === 'dynamic');
-  
-  const persistentTasksComplete = persistentTasks.every(t => t.completed);
-  const dynamicTaskComplete = dynamicTasks.every(t => t.completed);
-  const allCompleted = persistentTasksComplete && dynamicTaskComplete;
-  
-  return {
-    tasks,
-    persistentTasksComplete,
-    dynamicTaskComplete,
-    allCompleted,
-    isLoading,
-    error: error as Error | null,
-    refetch,
-  };
-}
-
-/**
- * Get the current interaction count from companion task cache.
- */
-export function getInteractionCount(companion: BlobbiCompanion | null): number {
-  if (!companion) return 0;
-  const interactionTask = companion.tasks.find(t => t.name === 'interactions');
-  return interactionTask?.value ?? 0;
-}
-
-/**
- * Filter tasks to only persistent tasks (for tag sync).
- * CRITICAL: Dynamic tasks must NEVER be synced to tags.
- */
-export function filterPersistentTasks(tasks: HatchTask[]): HatchTask[] {
-  return tasks.filter(t => t.type === 'persistent');
-}

src/blobbi/actions/hooks/useRerollMission.ts

@@ -1,159 +0,0 @@
-/**
- * useRerollMission - Hook for rerolling daily missions
- * 
- * Handles:
- * - Replacing a mission with a new one from the pool
- * - Tracking reroll usage (max 3 per day)
- * - Respecting stage-based mission filtering
- * - Persisting state to localStorage
- */
-
-import { useMutation } from '@tanstack/react-query';
-
-import { useCurrentUser } from '@/hooks/useCurrentUser';
-import { toast } from '@/hooks/useToast';
-
-import {
-  type DailyMissionsState,
-  type DailyMission,
-  type BlobbiStage,
-  getTodayDateString,
-  needsDailyReset,
-  createDailyMissionsState,
-  rerollMission,
-  canRerollMission,
-  getRerollsRemaining,
-} from '../lib/daily-missions';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-export interface RerollMissionRequest {
-  missionId: string;
-  availableStages?: BlobbiStage[];
-}
-
-export interface RerollMissionResult {
-  oldMissionId: string;
-  newMission: DailyMission;
-  rerollsRemaining: number;
-}
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-const STORAGE_KEY = 'blobbi:daily-missions';
-
-// ─── Storage Utilities ────────────────────────────────────────────────────────
-
-function readMissionsState(): DailyMissionsState | null {
-  try {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    if (!stored) return null;
-    
-    const state = JSON.parse(stored) as DailyMissionsState;
-    
-    // Migration: ensure rerollsRemaining is set for old state
-    if (state.rerollsRemaining === undefined) {
-      state.rerollsRemaining = 3; // MAX_DAILY_REROLLS
-    }
-    
-    return state;
-  } catch {
-    return null;
-  }
-}
-
-function writeMissionsState(state: DailyMissionsState): void {
-  try {
-    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
-  } catch (error) {
-    console.warn('[useRerollMission] Failed to write state:', error);
-  }
-}
-
-// ─── Hook ─────────────────────────────────────────────────────────────────────
-
-/**
- * Hook to reroll a daily mission.
- * 
- * Replaces the specified mission with a new one from the pool,
- * respecting stage-based filtering and avoiding duplicates.
- */
-export function useRerollMission() {
-  const { user } = useCurrentUser();
-
-  return useMutation({
-    mutationFn: async ({ missionId, availableStages }: RerollMissionRequest): Promise<RerollMissionResult> => {
-      if (!user?.pubkey) {
-        throw new Error('You must be logged in to reroll missions');
-      }
-
-      // Read current missions state from localStorage
-      let missionsState = readMissionsState();
-      
-      // Ensure we have valid state for today
-      if (needsDailyReset(missionsState)) {
-        const previousCoins = missionsState?.totalCoinsEarned ?? 0;
-        missionsState = createDailyMissionsState(getTodayDateString(), user.pubkey, previousCoins, availableStages);
-      }
-
-      // Check if reroll is allowed
-      if (!canRerollMission(missionsState!, missionId)) {
-        const rerollsLeft = getRerollsRemaining(missionsState!);
-        if (rerollsLeft <= 0) {
-          throw new Error('No rerolls remaining today');
-        }
-        
-        const mission = missionsState!.missions.find(m => m.id === missionId);
-        if (mission?.completed || mission?.claimed) {
-          throw new Error('Cannot reroll completed or claimed missions');
-        }
-        
-        throw new Error('Cannot reroll this mission');
-      }
-
-      // Perform the reroll
-      const result = rerollMission(missionsState!, missionId, availableStages);
-      
-      if (!result) {
-        throw new Error('No replacement missions available. All alternative missions may already be in your daily list.');
-      }
-
-      // Persist the updated state
-      writeMissionsState(result.state);
-
-      // Dispatch event for React components to re-render
-      window.dispatchEvent(new CustomEvent('daily-missions-updated', { 
-        detail: { 
-          missionId, 
-          rerolled: true,
-          newMissionId: result.newMission.id,
-        } 
-      }));
-
-      return {
-        oldMissionId: missionId,
-        newMission: result.newMission,
-        rerollsRemaining: getRerollsRemaining(result.state),
-      };
-    },
-    onSuccess: ({ newMission, rerollsRemaining }) => {
-      const rerollText = rerollsRemaining === 1 
-        ? '1 reroll left' 
-        : rerollsRemaining === 0 
-          ? 'No rerolls left'
-          : `${rerollsRemaining} rerolls left`;
-      
-      toast({
-        title: 'Mission Replaced',
-        description: `New mission: ${newMission.title}. ${rerollText}.`,
-      });
-    },
-    onError: (error: Error) => {
-      toast({
-        title: 'Failed to Reroll',
-        description: error.message,
-        variant: 'destructive',
-      });
-    },
-  });
-}

src/blobbi/actions/index.ts

@@ -1,191 +0,0 @@
-// src/blobbi/actions/index.ts
-
-// Components
-export { BlobbiActionsModal } from './components/BlobbiActionsModal';
-export { BlobbiActionInventoryModal } from './components/BlobbiActionInventoryModal';
-export { PlayMusicModal } from './components/PlayMusicModal';
-export { SingModal } from './components/SingModal';
-export { InlineMusicPlayer } from './components/InlineMusicPlayer';
-export { InlineSingCard } from './components/InlineSingCard';
-export { HatchTasksPanel } from './components/HatchTasksPanel';
-export { TasksPanel } from './components/TasksPanel';
-export { BlobbiPostModal } from './components/BlobbiPostModal';
-export { StartIncubationDialog } from './components/StartIncubationDialog';
-export { StartEvolutionDialog } from './components/StartEvolutionDialog';
-export { BlobbiMissionsModal } from './components/BlobbiMissionsModal';
-
-// Hooks
-export { useBlobbiUseInventoryItem } from './hooks/useBlobbiUseInventoryItem';
-export type { UseItemRequest, UseItemResult, UseBlobbiUseInventoryItemParams } from './hooks/useBlobbiUseInventoryItem';
-
-export { useBlobbiHatch, useBlobbiEvolve } from './hooks/useBlobbiStageTransition';
-export type { 
-  UseBlobbiStageTransitionParams, 
-  StageTransitionResult,
-  CanonicalActionResult,
-} from './hooks/useBlobbiStageTransition';
-
-export { 
-  useStartIncubation, 
-  useStopIncubation, 
-  useStartEvolution,
-  useStopEvolution,
-  useSyncTaskCompletions,
-} from './hooks/useBlobbiIncubation';
-export type {
-  StartIncubationMode,
-  StartIncubationRequest,
-  UseStartIncubationParams,
-  StartIncubationResult,
-  UseStopIncubationParams,
-  StopIncubationResult,
-  UseStartEvolutionParams,
-  StartEvolutionResult,
-  UseStopEvolutionParams,
-  StopEvolutionResult,
-  UseSyncTaskCompletionsParams,
-  TaskCompletionToSync,
-} from './hooks/useBlobbiIncubation';
-
-export { useActiveTaskProcess, filterPersistentTasks as filterPersistentTasksFromProcess, filterDynamicTasks } from './hooks/useActiveTaskProcess';
-export type { TaskProcessType, TaskProcessConfig, ActiveTaskProcessResult } from './hooks/useActiveTaskProcess';
-
-export { 
-  useHatchTasks, 
-  getInteractionCount,
-  filterPersistentTasks,
-  sanitizeToHashtag,
-  isValidHatchPost,
-  isValidBlobbiPost, // Legacy export
-  buildHatchPhrase,
-  KIND_THEME_DEFINITION,
-  KIND_COLOR_MOMENT,
-  HATCH_REQUIRED_INTERACTIONS,
-  REQUIRED_INTERACTIONS, // Legacy export
-  BLOBBI_POST_PREFIX,
-  BLOBBI_POST_REQUIRED_HASHTAGS,
-} from './hooks/useHatchTasks';
-export type { HatchTask, HatchTasksResult, TaskType } from './hooks/useHatchTasks';
-
-export {
-  useEvolveTasks,
-  getEvolveInteractionCount,
-  isValidEvolvePost,
-  KIND_PROFILE_TABS,
-  EVOLVE_REQUIRED_THEMES,
-  EVOLVE_REQUIRED_COLOR_MOMENTS,
-  EVOLVE_REQUIRED_POSTS,
-  EVOLVE_REQUIRED_INTERACTIONS,
-  EVOLVE_STAT_THRESHOLD,
-  BLOBBI_EVOLVE_POST_PREFIX,
-} from './hooks/useEvolveTasks';
-export type { EvolveTasksResult } from './hooks/useEvolveTasks';
-
-export { useBlobbiDirectAction, DIRECT_ACTION_HAPPINESS_EFFECTS } from './hooks/useBlobbiDirectAction';
-export type { DirectActionRequest, DirectActionResult, UseBlobbiDirectActionParams } from './hooks/useBlobbiDirectAction';
-
-export { useAudioPlayback } from './hooks/useAudioPlayback';
-export type { PlaybackState, PlaybackError, UseAudioPlaybackOptions, UseAudioPlaybackReturn } from './hooks/useAudioPlayback';
-
-// Track catalog
-export { 
-  BLOBBI_TRACK_CATALOG,
-  getAllTracks,
-  getTrackById,
-  formatTrackDuration,
-  type BlobbiTrack,
-} from './lib/blobbi-track-catalog';
-
-// Activity state
-export {
-  createMusicActivity,
-  createSingActivity,
-  createNoActivity,
-  type InlineActivityType,
-  type InlineActivityState,
-  type MusicActivityState,
-  type SingActivityState,
-  type NoActivityState,
-  type BlobbiReactionState,
-  type SelectedTrack,
-} from './lib/blobbi-activity-state';
-
-// Re-export stat bounds from canonical source
-export { STAT_MIN, STAT_MAX } from '@/blobbi/core/lib/blobbi';
-
-// Utilities
-export {
-  // Types
-  type InventoryAction,
-  type DirectAction,
-  type BlobbiAction,
-  type ResolvedInventoryItem,
-  type EggStatPreview,
-  type ItemUsabilityResult,
-  type IncrementInteractionResult,
-  // Constants
-  ACTION_TO_ITEM_TYPE,
-  ACTION_METADATA,
-  DIRECT_ACTION_METADATA,
-  ALL_ACTION_METADATA,
-  GENERAL_ITEM_USABLE_STAGES,
-  EGG_ALLOWED_ACTIONS,
-  EGG_ALLOWED_INVENTORY_ACTIONS,
-  EGG_ALLOWED_DIRECT_ACTIONS,
-  EGG_VISIBLE_INVENTORY_ACTIONS,
-  EGG_VISIBLE_ACTIONS,
-  SHELL_REPAIR_KIT_ID,
-  // Functions
-  clampStat,
-  applyStat,
-  applyItemEffects,
-  filterInventoryByAction,
-  decrementStorageItem,
-  canUseAction,
-  canUseDirectAction,
-  isActionVisibleForStage,
-  canUseInventoryItems,
-  getStageRestrictionMessage,
-  previewStatChanges,
-  previewMedicineForEgg,
-  previewCleanForEgg,
-  hasMedicineEffectForEgg,
-  hasHygieneEffectForEgg,
-  canUseItemForStage,
-  getActionForItem,
-  incrementInteractionTaskTags,
-} from './lib/blobbi-action-utils';
-
-// Daily Missions
-export { useDailyMissions } from './hooks/useDailyMissions';
-export type { UseDailyMissionsResult } from './hooks/useDailyMissions';
-export { useClaimMissionReward } from './hooks/useClaimMissionReward';
-export type { ClaimMissionRequest, ClaimMissionResult } from './hooks/useClaimMissionReward';
-export {
-  trackDailyMissionProgress,
-  trackMultipleDailyMissionActions,
-} from './lib/daily-mission-tracker';
-export type {
-  DailyMission,
-  DailyMissionAction,
-  DailyMissionDefinition,
-  DailyMissionsState,
-} from './lib/daily-missions';
-
-// Streak tracking
-export {
-  calculateStreakUpdate,
-  getStreakTagUpdates,
-  needsStreakUpdate,
-  getStreakStatus,
-} from './lib/blobbi-streak';
-export type {
-  StreakUpdateResult,
-  StreakTagUpdates,
-} from './lib/blobbi-streak';
-
-export { useBlobbiCareActivity } from './hooks/useBlobbiCareActivity';
-export type {
-  UseBlobbiCareActivityParams,
-  CareActivityResult,
-} from './hooks/useBlobbiCareActivity';

src/blobbi/actions/lib/blobbi-action-utils.ts

@@ -1,634 +0,0 @@
-// src/blobbi/actions/lib/blobbi-action-utils.ts
-
-import { STAT_MIN, STAT_MAX, type BlobbiCompanion, type BlobbiStats, type StorageItem } from '@/blobbi/core/lib/blobbi';
-import type { ItemEffect, ShopItemCategory } from '@/blobbi/shop/types/shop.types';
-import { getShopItemById } from '@/blobbi/shop/lib/blobbi-shop-items';
-
-// ─── Action Types ─────────────────────────────────────────────────────────────
-
-/**
- * Actions that consume inventory items
- */
-export type InventoryAction = 'feed' | 'play' | 'clean' | 'medicine';
-
-/**
- * Non-inventory actions that don't consume items
- * These actions affect stats directly without using shop items.
- */
-export type DirectAction = 'play_music' | 'sing';
-
-/**
- * All Blobbi actions (inventory + direct)
- */
-export type BlobbiAction = InventoryAction | DirectAction;
-
-/**
- * Mapping from action type to allowed item categories
- */
-export const ACTION_TO_ITEM_TYPE: Record<InventoryAction, ShopItemCategory> = {
-  feed: 'food',
-  play: 'toy',
-  clean: 'hygiene',
-  medicine: 'medicine',
-};
-
-/**
- * Action metadata for UI display (inventory actions)
- */
-export const ACTION_METADATA: Record<InventoryAction, { label: string; description: string; icon: string }> = {
-  feed: {
-    label: 'Feed',
-    description: 'Feed your Blobbi',
-    icon: '🍎',
-  },
-  play: {
-    label: 'Play',
-    description: 'Play with your Blobbi',
-    icon: '⚽',
-  },
-  clean: {
-    label: 'Clean',
-    description: 'Clean your Blobbi',
-    icon: '🧼',
-  },
-  medicine: {
-    label: 'Medicine',
-    description: 'Heal your Blobbi',
-    icon: '💊',
-  },
-};
-
-/**
- * Action metadata for direct actions (non-inventory)
- */
-export const DIRECT_ACTION_METADATA: Record<DirectAction, { label: string; description: string; icon: string }> = {
-  play_music: {
-    label: 'Play Music',
-    description: 'Play music for your Blobbi',
-    icon: '🎵',
-  },
-  sing: {
-    label: 'Sing',
-    description: 'Sing to your Blobbi',
-    icon: '🎤',
-  },
-};
-
-/**
- * Combined action metadata for all action types
- */
-export const ALL_ACTION_METADATA: Record<BlobbiAction, { label: string; description: string; icon: string }> = {
-  ...ACTION_METADATA,
-  ...DIRECT_ACTION_METADATA,
-};
-
-// ─── Stat Helpers ─────────────────────────────────────────────────────────────
-// STAT_MIN and STAT_MAX are imported from @/lib/blobbi (single source of truth)
-
-/**
- * Clamp a stat value between STAT_MIN (1) and STAT_MAX (100).
- * Safe for undefined values (returns STAT_MIN).
- * 
- * The minimum of 1 (instead of 0) ensures:
- * - Blobbi is never in an unrecoverable state
- * - Visual feedback shows critical state without being "dead"
- * - Recovery is always possible with any healing item
- */
-export function clampStat(value: number | undefined): number {
-  if (value === undefined) return STAT_MIN;
-  return Math.max(STAT_MIN, Math.min(STAT_MAX, Math.round(value)));
-}
-
-/**
- * Apply a delta to a stat, clamping the result to STAT_MIN-STAT_MAX.
- */
-export function applyStat(current: number | undefined, delta: number): number {
-  const currentValue = current ?? STAT_MIN;
-  return clampStat(currentValue + delta);
-}
-
-/**
- * Apply item effects to current stats.
- * Returns a new partial stats object with all affected stats clamped.
- * Only modifies stats that have corresponding effects.
- */
-export function applyItemEffects(
-  currentStats: Partial<BlobbiStats>,
-  effects: ItemEffect
-): Partial<BlobbiStats> {
-  const newStats: Partial<BlobbiStats> = { ...currentStats };
-
-  if (effects.hunger !== undefined) {
-    newStats.hunger = applyStat(currentStats.hunger, effects.hunger);
-  }
-  if (effects.happiness !== undefined) {
-    newStats.happiness = applyStat(currentStats.happiness, effects.happiness);
-  }
-  if (effects.energy !== undefined) {
-    newStats.energy = applyStat(currentStats.energy, effects.energy);
-  }
-  if (effects.hygiene !== undefined) {
-    newStats.hygiene = applyStat(currentStats.hygiene, effects.hygiene);
-  }
-  if (effects.health !== undefined) {
-    newStats.health = applyStat(currentStats.health, effects.health);
-  }
-
-  return newStats;
-}
-
-// ─── Egg-Specific Item Helpers ────────────────────────────────────────────────
-
-/**
- * The Shell Repair Kit is a special medicine item only usable by eggs.
- */
-export const SHELL_REPAIR_KIT_ID = 'med_shell_repair';
-
-/**
- * Result of checking if an item can be used by a specific Blobbi stage.
- */
-export interface ItemUsabilityResult {
-  canUse: boolean;
-  reason?: string;
-}
-
-/**
- * Check if a specific item can be used by a companion at the given stage.
- * 
- * This is the centralized item usability logic:
- * - Shell Repair Kit: Only usable by eggs
- * - Food items: Only usable by baby/adult (not eggs)
- * - Toy items: Only usable by baby/adult (not eggs)
- * - Medicine items (except Shell Repair Kit): Usable by all stages with health effect
- * - Hygiene items: Usable by all stages
- * 
- * @param itemId - The shop item ID
- * @param stage - The companion's life stage
- * @returns Object with canUse boolean and optional reason string
- */
-export function canUseItemForStage(
-  itemId: string,
-  stage: 'egg' | 'baby' | 'adult'
-): ItemUsabilityResult {
-  const shopItem = getShopItemById(itemId);
-  if (!shopItem) {
-    return { canUse: false, reason: 'Item not found' };
-  }
-
-  const isEgg = stage === 'egg';
-
-  // Shell Repair Kit special case: only for eggs
-  if (itemId === SHELL_REPAIR_KIT_ID) {
-    if (!isEgg) {
-      return { canUse: false, reason: 'Only usable for eggs' };
-    }
-    return { canUse: true };
-  }
-
-  // Food items: not usable by eggs
-  if (shopItem.type === 'food') {
-    if (isEgg) {
-      return { canUse: false, reason: 'Eggs cannot eat food' };
-    }
-    return { canUse: true };
-  }
-
-  // Toy items: not usable by eggs
-  if (shopItem.type === 'toy') {
-    if (isEgg) {
-      return { canUse: false, reason: 'Eggs cannot use toys' };
-    }
-    return { canUse: true };
-  }
-
-  // Medicine items (except Shell Repair Kit): check for health effect
-  if (shopItem.type === 'medicine') {
-    if (!hasMedicineEffectForEgg(shopItem.effect)) {
-      return { canUse: false, reason: 'This medicine has no effect' };
-    }
-    return { canUse: true };
-  }
-
-  // Hygiene items: all stages can use
-  if (shopItem.type === 'hygiene') {
-    if (!hasHygieneEffectForEgg(shopItem.effect) && !hasHappinessEffectForEgg(shopItem.effect)) {
-      return { canUse: false, reason: 'This item has no cleaning effect' };
-    }
-    return { canUse: true };
-  }
-
-  return { canUse: true };
-}
-
-/**
- * Get the action type for a given item.
- */
-export function getActionForItem(itemId: string): InventoryAction | null {
-  const shopItem = getShopItemById(itemId);
-  if (!shopItem) return null;
-
-  const typeToAction: Record<string, InventoryAction> = {
-    food: 'feed',
-    toy: 'play',
-    hygiene: 'clean',
-    medicine: 'medicine',
-  };
-
-  return typeToAction[shopItem.type] ?? null;
-}
-
-/**
- * Check if a medicine item has any effect on an egg.
- * 
- * Eggs use the standard 3-stat model:
- * - health
- * - hygiene  
- * - happiness
- * 
- * Medicine with a health effect will directly affect the egg's health stat.
- */
-export function hasMedicineEffectForEgg(effects: ItemEffect | undefined): boolean {
-  if (!effects) return false;
-  return effects.health !== undefined && effects.health !== 0;
-}
-
-/**
- * Check if a hygiene item has any effect on an egg.
- * Hygiene items with a hygiene effect will directly affect the egg's hygiene stat.
- */
-export function hasHygieneEffectForEgg(effects: ItemEffect | undefined): boolean {
-  if (!effects) return false;
-  return effects.hygiene !== undefined && effects.hygiene !== 0;
-}
-
-/**
- * Check if an item has a happiness effect for an egg.
- * Some items (like bubble bath) give happiness bonus in addition to primary effects.
- */
-export function hasHappinessEffectForEgg(effects: ItemEffect | undefined): boolean {
-  if (!effects) return false;
-  return effects.happiness !== undefined && effects.happiness !== 0;
-}
-
-// ─── Inventory Helpers ────────────────────────────────────────────────────────
-
-/**
- * Resolved inventory item with shop metadata
- */
-export interface ResolvedInventoryItem {
-  itemId: string;
-  quantity: number;
-  name: string;
-  icon: string;
-  type: ShopItemCategory;
-  effect?: ItemEffect;
-}
-
-/**
- * Options for filtering inventory by action
- */
-export interface FilterInventoryOptions {
-  /** Companion stage - used to filter items by egg-compatible effects */
-  stage?: 'egg' | 'baby' | 'adult';
-}
-
-/**
- * Filter inventory items by action type.
- * Returns resolved items with shop metadata.
- * 
- * Filtering rules:
- * - Only items matching the action's item type are included
- * - Shell Repair Kit only appears in medicine modal for eggs
- * - For eggs: only items with egg-compatible effects are returned
- *   - medicine action: only items with health effect
- *   - clean action: only items with hygiene or happiness effect
- */
-export function filterInventoryByAction(
-  storage: StorageItem[],
-  action: InventoryAction,
-  options: FilterInventoryOptions = {}
-): ResolvedInventoryItem[] {
-  const allowedType = ACTION_TO_ITEM_TYPE[action];
-  const result: ResolvedInventoryItem[] = [];
-  const isEgg = options.stage === 'egg';
-
-  for (const storageItem of storage) {
-    const shopItem = getShopItemById(storageItem.itemId);
-    if (!shopItem) continue;
-    if (shopItem.type !== allowedType) continue;
-    if (storageItem.quantity <= 0) continue;
-
-    // Shell Repair Kit: only show for eggs in medicine modal
-    if (storageItem.itemId === SHELL_REPAIR_KIT_ID && !isEgg) {
-      continue;
-    }
-
-    // For eggs, filter items by egg-compatible effects
-    if (isEgg) {
-      if (action === 'medicine' && !hasMedicineEffectForEgg(shopItem.effect)) {
-        continue; // Skip medicine without health effect
-      }
-      if (action === 'clean' && !hasHygieneEffectForEgg(shopItem.effect) && !hasHappinessEffectForEgg(shopItem.effect)) {
-        continue; // Skip hygiene items without hygiene or happiness effect
-      }
-    }
-
-    result.push({
-      itemId: storageItem.itemId,
-      quantity: storageItem.quantity,
-      name: shopItem.name,
-      icon: shopItem.icon,
-      type: shopItem.type,
-      effect: shopItem.effect,
-    });
-  }
-
-  return result;
-}
-
-/**
- * Decrement item quantity in storage array.
- * If quantity becomes 0, removes the item entirely.
- * Returns a new storage array (immutable).
- */
-export function decrementStorageItem(
-  storage: StorageItem[],
-  itemId: string,
-  amount = 1
-): StorageItem[] {
-  const result: StorageItem[] = [];
-
-  for (const item of storage) {
-    if (item.itemId !== itemId) {
-      result.push(item);
-      continue;
-    }
-    const newQuantity = item.quantity - amount;
-    if (newQuantity > 0) {
-      result.push({ ...item, quantity: newQuantity });
-    }
-    // If newQuantity <= 0, we don't add it (remove item)
-  }
-
-  return result;
-}
-
-// ─── Stage Restriction Helpers ────────────────────────────────────────────────
-
-/**
- * Stages that can use general inventory items (food, toys, hygiene)
- */
-export const GENERAL_ITEM_USABLE_STAGES = ['baby', 'adult'] as const;
-
-/**
- * Inventory actions that are allowed for eggs.
- * Eggs can use: medicine (health), clean (hygiene)
- */
-export const EGG_ALLOWED_INVENTORY_ACTIONS: InventoryAction[] = ['medicine', 'clean'];
-
-/**
- * Direct actions that are allowed for eggs.
- * All direct actions work on eggs.
- */
-export const EGG_ALLOWED_DIRECT_ACTIONS: DirectAction[] = ['play_music', 'sing'];
-
-/**
- * Inventory actions visible in the egg UI.
- * Note: feed, play, sleep are hidden in the UI for eggs but not hard-blocked.
- */
-export const EGG_VISIBLE_INVENTORY_ACTIONS: InventoryAction[] = ['clean', 'medicine'];
-
-/**
- * All actions visible in the egg UI.
- */
-export const EGG_VISIBLE_ACTIONS: BlobbiAction[] = ['clean', 'medicine', 'play_music', 'sing'];
-
-/**
- * @deprecated Use EGG_ALLOWED_INVENTORY_ACTIONS instead
- */
-export const EGG_ALLOWED_ACTIONS = EGG_ALLOWED_INVENTORY_ACTIONS;
-
-/**
- * Check if a companion can use a specific inventory action.
- * 
- * Note: This function no longer hard-blocks egg actions at the domain layer.
- * UI visibility is handled separately by `isActionVisibleForStage()`.
- * The domain layer allows all actions - UI chooses what to show.
- */
-export function canUseAction(_companion: BlobbiCompanion, _action: InventoryAction): boolean {
-  // All stages can technically use all inventory actions at the domain layer.
-  // UI filtering determines what actions are shown to users.
-  return true;
-}
-
-/**
- * Check if a companion can use a specific direct action.
- * Direct actions (play_music, sing) are available for all stages.
- */
-export function canUseDirectAction(_companion: BlobbiCompanion, _action: DirectAction): boolean {
-  // All stages can use direct actions
-  return true;
-}
-
-/**
- * Check if an action should be visible in the UI for a given stage.
- * This is for UI filtering only - some actions are hidden but not blocked.
- */
-export function isActionVisibleForStage(stage: 'egg' | 'baby' | 'adult', action: BlobbiAction): boolean {
-  if (stage === 'egg') {
-    return EGG_VISIBLE_ACTIONS.includes(action);
-  }
-  return true; // baby and adult see all actions
-}
-
-/**
- * Check if a companion can use general inventory items (feed, play, clean).
- * Eggs cannot use food, toys, or hygiene items.
- * @deprecated Use canUseAction(companion, action) for action-specific checks
- */
-export function canUseInventoryItems(companion: BlobbiCompanion): boolean {
-  return GENERAL_ITEM_USABLE_STAGES.includes(companion.stage as typeof GENERAL_ITEM_USABLE_STAGES[number]);
-}
-
-/**
- * Get a user-friendly message explaining why an action can't be used.
- */
-export function getStageRestrictionMessage(companion: BlobbiCompanion, action?: InventoryAction): string | null {
-  if (companion.stage === 'egg') {
-    if (action && EGG_ALLOWED_INVENTORY_ACTIONS.includes(action)) {
-      return null; // Medicine and clean are allowed for eggs
-    }
-    return 'Eggs cannot use this item. Wait for your Blobbi to hatch!';
-  }
-  return null;
-}
-
-// ─── Stats Preview ────────────────────────────────────────────────────────────
-
-/**
- * Preview stats after applying an item's effects.
- * Useful for showing the user what will happen before confirming.
- */
-export function previewStatChanges(
-  currentStats: Partial<BlobbiStats>,
-  effects: ItemEffect | undefined
-): Array<{ stat: keyof BlobbiStats; current: number; after: number; delta: number }> {
-  if (!effects) return [];
-
-  const changes: Array<{ stat: keyof BlobbiStats; current: number; after: number; delta: number }> = [];
-  const statKeys: (keyof BlobbiStats)[] = ['hunger', 'happiness', 'energy', 'hygiene', 'health'];
-
-  for (const stat of statKeys) {
-    const delta = effects[stat];
-    if (delta !== undefined && delta !== 0) {
-      const current = currentStats[stat] ?? 0;
-      const after = clampStat(current + delta);
-      changes.push({ stat, current, after, delta });
-    }
-  }
-
-  return changes;
-}
-
-/**
- * Preview stat change for an egg.
- * Eggs use the 3-stat model: health, hygiene, happiness.
- */
-export type EggStatPreview = { stat: 'health' | 'hygiene' | 'happiness'; current: number; after: number; delta: number };
-
-/**
- * Preview medicine effects for an egg.
- * Medicine directly affects the egg's health stat.
- */
-export function previewMedicineForEgg(
-  currentHealth: number | undefined,
-  effects: ItemEffect | undefined
-): EggStatPreview[] {
-  if (!effects || effects.health === undefined || effects.health === 0) {
-    return [];
-  }
-
-  const current = currentHealth ?? 100;
-  const delta = effects.health;
-  const after = clampStat(current + delta);
-
-  return [{ stat: 'health', current, after, delta }];
-}
-
-/**
- * Preview clean (hygiene) effects for an egg.
- * Hygiene items directly affect the egg's hygiene stat.
- * May also include happiness bonus if the item has one.
- */
-export function previewCleanForEgg(
-  currentStats: { hygiene?: number; happiness?: number },
-  effects: ItemEffect | undefined
-): EggStatPreview[] {
-  if (!effects) return [];
-  
-  const results: EggStatPreview[] = [];
-  
-  // Hygiene effect
-  if (effects.hygiene !== undefined && effects.hygiene !== 0) {
-    const current = currentStats.hygiene ?? 100;
-    const delta = effects.hygiene;
-    const after = clampStat(current + delta);
-    results.push({ stat: 'hygiene', current, after, delta });
-  }
-  
-  // Happiness bonus (some hygiene items like bubble bath give happiness)
-  if (effects.happiness !== undefined && effects.happiness !== 0) {
-    const current = currentStats.happiness ?? 100;
-    const delta = effects.happiness;
-    const after = clampStat(current + delta);
-    results.push({ stat: 'happiness', current, after, delta });
-  }
-  
-  return results;
-}
-
-// ─── Interaction Task Helpers ─────────────────────────────────────────────────
-
-/** Enable debug logging in development only */
-const DEBUG_INTERACTION_TASK = import.meta.env.DEV;
-
-/**
- * Result of incrementing interaction task tags
- */
-export interface IncrementInteractionResult {
-  /** Updated tags array */
-  updatedTags: string[][];
-  /** New interaction count after increment */
-  newCount: number;
-  /** Whether the task is now complete */
-  isCompleted: boolean;
-  /** Previous count before increment */
-  previousCount: number;
-}
-
-/**
- * Increment the interaction task counter in the tags array.
- * 
- * This is used by both useBlobbiDirectAction and useBlobbiUseInventoryItem
- * to track progress on interaction tasks for both hatch and evolve.
- * 
- * CRITICAL: This function is called during actual user actions (not retroactive sync).
- * It always increments by 1 because each call represents a real interaction.
- * 
- * Tag format:
- * - Progress: ["task", "interactions:N"]
- * - Completion: ["task_completed", "interactions"]
- * 
- * Idempotency notes:
- * - This is NOT idempotent by design - each call = one interaction
- * - Duplicate task_completed tags are prevented by filtering before add
- * - Multiple task:interactions tags are prevented by filtering before add
- * 
- * @param currentTags - Current tags array from the Blobbi state
- * @param requiredInteractions - Threshold for completion (7 for hatch, 21 for evolve)
- * @returns Updated tags array with incremented interaction count
- */
-export function incrementInteractionTaskTags(
-  currentTags: string[][],
-  requiredInteractions: number
-): IncrementInteractionResult {
-  // Get current interaction count from task tags
-  const interactionTag = currentTags.find(tag => 
-    tag[0] === 'task' && tag[1]?.startsWith('interactions:')
-  );
-  const previousCount = interactionTag 
-    ? parseInt(interactionTag[1].split(':')[1] || '0', 10)
-    : 0;
-  const newCount = previousCount + 1;
-  
-  // Check if already completed (task_completed tag exists)
-  const alreadyCompleted = currentTags.some(tag => 
-    tag[0] === 'task_completed' && tag[1] === 'interactions'
-  );
-  
-  // Remove old interaction task tag (prevent duplicates) and add new one
-  let updatedTags = currentTags.filter(tag => 
-    !(tag[0] === 'task' && tag[1]?.startsWith('interactions:'))
-  );
-  updatedTags = [...updatedTags, ['task', `interactions:${newCount}`]];
-  
-  // Mark as completed if reached required count AND not already marked
-  const isCompleted = newCount >= requiredInteractions;
-  if (isCompleted && !alreadyCompleted) {
-    // Only add if not already present (handled by filter, but double-check)
-    updatedTags = [...updatedTags, ['task_completed', 'interactions']];
-  }
-  
-  if (DEBUG_INTERACTION_TASK) {
-    console.log('[InteractionTask] Increment:', {
-      previousCount,
-      newCount,
-      requiredInteractions,
-      isCompleted,
-      alreadyCompleted,
-      addedCompletionTag: isCompleted && !alreadyCompleted,
-    });
-  }
-  
-  return { updatedTags, newCount, isCompleted, previousCount };
-}

src/blobbi/actions/lib/blobbi-activity-state.ts

@@ -1,81 +0,0 @@
-// src/blobbi/actions/lib/blobbi-activity-state.ts
-
-import type { SelectedTrack } from '../components/PlayMusicModal';
-
-/**
- * Types of inline activities that can be displayed in BlobbiPage
- */
-export type InlineActivityType = 'none' | 'music' | 'sing';
-
-// Re-export for convenience
-export type { SelectedTrack } from '../components/PlayMusicModal';
-
-/**
- * State for the music inline activity
- */
-export interface MusicActivityState {
-  type: 'music';
-  selection: SelectedTrack;
-  isPublished: boolean;
-}
-
-/**
- * State for the sing inline activity
- */
-export interface SingActivityState {
-  type: 'sing';
-}
-
-/**
- * No active inline activity
- */
-export interface NoActivityState {
-  type: 'none';
-}
-
-/**
- * Union type for all inline activity states
- */
-export type InlineActivityState = 
-  | NoActivityState 
-  | MusicActivityState 
-  | SingActivityState;
-
-/**
- * Blobbi reaction state - indicates how Blobbi should visually react
- */
-export type BlobbiReactionState = 
-  | 'idle'           // No special reaction
-  | 'listening'      // Music is playing, Blobbi is listening
-  | 'swaying'        // Blobbi is swaying to music
-  | 'singing'        // User is singing, Blobbi is engaged
-  | 'happy';         // General happy reaction
-
-/**
- * Helper to create a music activity state
- */
-export function createMusicActivity(selection: SelectedTrack): MusicActivityState {
-  return {
-    type: 'music',
-    selection,
-    isPublished: false,
-  };
-}
-
-/**
- * Helper to create a sing activity state
- */
-export function createSingActivity(): SingActivityState {
-  return {
-    type: 'sing',
-  };
-}
-
-/**
- * Helper to create no activity state
- */
-export function createNoActivity(): NoActivityState {
-  return {
-    type: 'none',
-  };
-}

src/blobbi/actions/lib/blobbi-random-lyrics.ts

@@ -1,121 +0,0 @@
-// src/blobbi/actions/lib/blobbi-random-lyrics.ts
-
-/**
- * Random lyrics for the Sing action.
- * These are fun, simple lyrics that users can sing to their Blobbi.
- */
-
-export interface LyricsEntry {
-  id: string;
-  title: string;
-  lines: string[];
-}
-
-/**
- * Collection of placeholder lyrics for singing to a Blobbi.
- * Simple, fun, and appropriate for all ages.
- */
-export const BLOBBI_LYRICS: LyricsEntry[] = [
-  {
-    id: 'lullaby-1',
-    title: 'Blobbi Lullaby',
-    lines: [
-      'Little Blobbi, close your eyes,',
-      'Dream of stars up in the skies.',
-      'Safe and warm, you drift away,',
-      "We'll play again another day.",
-    ],
-  },
-  {
-    id: 'happy-song-1',
-    title: 'Happy Blobbi Song',
-    lines: [
-      'Blobbi, Blobbi, jump around!',
-      "You're the happiest friend I've found!",
-      'Dancing, playing, full of cheer,',
-      "I'm so glad that you are here!",
-    ],
-  },
-  {
-    id: 'adventure-1',
-    title: 'Adventure Time',
-    lines: [
-      "Let's go on an adventure today,",
-      'Through the clouds and far away!',
-      'Mountains high and valleys deep,',
-      'Memories to always keep.',
-    ],
-  },
-  {
-    id: 'breakfast-song',
-    title: 'Breakfast Song',
-    lines: [
-      'Wake up, wake up, sleepy head,',
-      "Time to get out of your bed!",
-      "Breakfast's waiting, fresh and yummy,",
-      'Food to fill your happy tummy!',
-    ],
-  },
-  {
-    id: 'rainy-day',
-    title: 'Rainy Day',
-    lines: [
-      'Pitter patter on the roof,',
-      'Rainy days can be so nice.',
-      "We'll stay cozy, me and you,",
-      'Watching raindrops, one by two.',
-    ],
-  },
-  {
-    id: 'sunshine-song',
-    title: 'Sunshine Song',
-    lines: [
-      'Good morning, sunshine, bright and warm,',
-      'A brand new day is being born!',
-      'Blue sky smiling down on me,',
-      'Happy as can be, so free!',
-    ],
-  },
-  {
-    id: 'bedtime-1',
-    title: 'Bedtime Blues',
-    lines: [
-      'The moon is up, the stars are bright,',
-      'Time to say a soft goodnight.',
-      'Snuggle up and close your eyes,',
-      'Sweet dreams under starry skies.',
-    ],
-  },
-  {
-    id: 'play-time',
-    title: 'Play Time',
-    lines: [
-      "Bounce and jump and run around,",
-      "Spin and twirl without a sound!",
-      "Playing games is so much fun,",
-      "Laughing underneath the sun!",
-    ],
-  },
-];
-
-/**
- * Get a random lyrics entry.
- */
-export function getRandomLyrics(): LyricsEntry {
-  const index = Math.floor(Math.random() * BLOBBI_LYRICS.length);
-  return BLOBBI_LYRICS[index];
-}
-
-/**
- * Get all available lyrics entries.
- */
-export function getAllLyrics(): LyricsEntry[] {
-  return BLOBBI_LYRICS;
-}
-
-/**
- * Format lyrics for display (joined with newlines).
- */
-export function formatLyrics(lyrics: LyricsEntry): string {
-  return lyrics.lines.join('\n');
-}

src/blobbi/actions/lib/blobbi-streak.ts

@@ -1,202 +0,0 @@
-/**
- * Blobbi Care Streak Management
- * 
- * This module provides centralized logic for tracking care streaks on Blobbi companions.
- * A streak represents consecutive days of care activity (opening Blobbi page, performing
- * care actions, etc.).
- * 
- * Streak Rules:
- * - Starts at 1 on first activity
- * - Increments when activity happens on the NEXT local calendar day
- * - Same-day activity does not increment (at most once per day)
- * - Missing 2+ days resets streak to 1
- * 
- * Tags managed:
- * - care_streak: The current streak count (positive integer)
- * - care_streak_last_at: Unix timestamp (seconds) of last streak update
- * - care_streak_last_day: Local calendar day string (YYYY-MM-DD) of last update
- */
-
-import {
-  getLocalDayString,
-  getDaysDifference,
-  type BlobbiCompanion,
-} from '@/blobbi/core/lib/blobbi';
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Result of calculating a streak update.
- */
-export interface StreakUpdateResult {
-  /** Whether the streak was updated (incremented or reset) */
-  wasUpdated: boolean;
-  /** The new streak value */
-  newStreak: number;
-  /** The new timestamp for care_streak_last_at */
-  newLastAt: number;
-  /** The new day string for care_streak_last_day */
-  newLastDay: string;
-  /** Description of what happened (for debugging/logging) */
-  action: 'initialized' | 'incremented' | 'reset' | 'same_day';
-}
-
-/**
- * Tag updates to apply to the Blobbi event.
- * Only present if wasUpdated is true.
- * Uses index signature for compatibility with updateBlobbiTags.
- */
-export interface StreakTagUpdates {
-  care_streak: string;
-  care_streak_last_at: string;
-  care_streak_last_day: string;
-  [key: string]: string;
-}
-
-// ─── Core Logic ───────────────────────────────────────────────────────────────
-
-/**
- * Calculate what the streak should be updated to based on current state and activity.
- * 
- * This is a pure function that calculates the new streak state without side effects.
- * Use this to determine if/how the streak should be updated.
- * 
- * @param currentStreak - Current streak value (0 or undefined means no streak yet)
- * @param lastDay - The last day string (YYYY-MM-DD) when streak was updated, or undefined
- * @param now - Current timestamp (defaults to now)
- * @returns StreakUpdateResult describing the update
- */
-export function calculateStreakUpdate(
-  currentStreak: number | undefined,
-  lastDay: string | undefined,
-  now: Date = new Date()
-): StreakUpdateResult {
-  const nowTimestamp = Math.floor(now.getTime() / 1000);
-  const todayString = getLocalDayString(now);
-  
-  // Case 1: No existing streak - initialize to 1
-  if (currentStreak === undefined || currentStreak === 0 || !lastDay) {
-    return {
-      wasUpdated: true,
-      newStreak: 1,
-      newLastAt: nowTimestamp,
-      newLastDay: todayString,
-      action: 'initialized',
-    };
-  }
-  
-  // Case 2: Activity on the same day - no update needed
-  if (lastDay === todayString) {
-    return {
-      wasUpdated: false,
-      newStreak: currentStreak,
-      newLastAt: nowTimestamp,
-      newLastDay: todayString,
-      action: 'same_day',
-    };
-  }
-  
-  // Calculate days since last activity
-  const daysMissed = getDaysDifference(lastDay, todayString);
-  
-  // Case 3: Next day (1 day difference) - increment streak
-  if (daysMissed === 1) {
-    return {
-      wasUpdated: true,
-      newStreak: currentStreak + 1,
-      newLastAt: nowTimestamp,
-      newLastDay: todayString,
-      action: 'incremented',
-    };
-  }
-  
-  // Case 4: Missed 2+ days - reset to 1
-  return {
-    wasUpdated: true,
-    newStreak: 1,
-    newLastAt: nowTimestamp,
-    newLastDay: todayString,
-    action: 'reset',
-  };
-}
-
-/**
- * Get the tag updates to apply to a Blobbi event for a streak update.
- * Returns undefined if no update is needed (same day activity).
- * 
- * @param companion - The current Blobbi companion state
- * @param now - Current timestamp (defaults to now)
- * @returns Tag updates to apply, or undefined if no update needed
- */
-export function getStreakTagUpdates(
-  companion: BlobbiCompanion,
-  now: Date = new Date()
-): StreakTagUpdates | undefined {
-  const result = calculateStreakUpdate(
-    companion.careStreak,
-    companion.careStreakLastDay,
-    now
-  );
-  
-  if (!result.wasUpdated) {
-    return undefined;
-  }
-  
-  return {
-    care_streak: result.newStreak.toString(),
-    care_streak_last_at: result.newLastAt.toString(),
-    care_streak_last_day: result.newLastDay,
-  };
-}
-
-/**
- * Check if a streak update is needed for the companion.
- * 
- * @param companion - The current Blobbi companion state
- * @param now - Current timestamp (defaults to now)
- * @returns true if the streak should be updated
- */
-export function needsStreakUpdate(
-  companion: BlobbiCompanion,
-  now: Date = new Date()
-): boolean {
-  const result = calculateStreakUpdate(
-    companion.careStreak,
-    companion.careStreakLastDay,
-    now
-  );
-  return result.wasUpdated;
-}
-
-/**
- * Get the current streak status for display purposes.
- * 
- * @param companion - The current Blobbi companion state
- * @returns Object with streak info for UI display
- */
-export function getStreakStatus(companion: BlobbiCompanion): {
-  streak: number;
-  lastDay: string | undefined;
-  isActive: boolean;
-  daysSinceLastActivity: number | undefined;
-} {
-  const streak = companion.careStreak ?? 0;
-  const lastDay = companion.careStreakLastDay;
-  const today = getLocalDayString();
-  
-  let daysSinceLastActivity: number | undefined;
-  let isActive = false;
-  
-  if (lastDay) {
-    daysSinceLastActivity = getDaysDifference(lastDay, today);
-    // Streak is "active" if we've had activity today or yesterday
-    isActive = daysSinceLastActivity <= 1;
-  }
-  
-  return {
-    streak,
-    lastDay,
-    isActive,
-    daysSinceLastActivity,
-  };
-}

src/blobbi/actions/lib/blobbi-track-catalog.ts

@@ -1,118 +0,0 @@
-// src/blobbi/actions/lib/blobbi-track-catalog.ts
-
-/**
- * Blobbi Track Catalog
- * 
- * Music tracks for the Blobbi "Play Music" action.
- * All tracks are hosted on remote Blossom servers and streamed on-demand.
- * 
- * ## Adding New Tracks
- * 
- * 1. Convert the audio file to M4A (AAC-LC):
- *    `ffmpeg -i input.m4a -c:a aac -b:a 64k -ar 48000 output.m4a`
- * 2. Upload the M4A file to a Blossom server
- * 3. Add a new entry to `BLOBBI_TRACK_CATALOG` below
- * 4. Set `url` to the full Blossom URL
- * 5. Get the duration: `ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 <file>`
- * 
- * ## Supported Formats
- * 
- * M4A (AAC-LC) is required for iOS/Safari compatibility and small file size.
- */
-
-export interface BlobbiTrack {
-  /** Unique identifier for the track (used in state/events) */
-  id: string;
-  /** Display title shown in the UI */
-  title: string;
-  /** Artist or source attribution */
-  artist: string;
-  /** Full URL to the remote audio file (Blossom server) */
-  url: string;
-  /** Duration in seconds (for display, get via ffprobe) */
-  durationSeconds: number;
-  /** Optional cover art URL */
-  coverArt?: string;
-  /** Optional tags for categorization/filtering */
-  tags?: string[];
-}
-
-/**
- * Blobbi track catalog.
- * 
- * All tracks are royalty-free/Creative Commons licensed.
- * Audio files hosted on remote Blossom servers.
- */
-export const BLOBBI_TRACK_CATALOG: BlobbiTrack[] = [
-  {
-    id: 'nap_in_the_meadow',
-    title: 'Nap in the Meadow',
-    artist: 'Chilltape FM',
-    url: 'https://blossom.ditto.pub/6be1c95e879187f83af2a661ccac2bd96196f7bc334af44529ede6270b2811fc.m4a',
-    durationSeconds: 240, // 4:00
-    tags: ['relaxing', 'nature'],
-  },
-  {
-    id: 'happy_kids',
-    title: 'Happy Kids',
-    artist: 'Dmitrii Kolesnikov',
-    url: 'https://blossom.ditto.pub/94d49abd178aa8afb14737a55e0a7143f6b337f618d74858d011232bb2db845d.m4a',
-    durationSeconds: 129, // 2:09
-    tags: ['upbeat', 'fun'],
-  },
-  {
-    id: 'soft_piano',
-    title: 'Soft Piano',
-    artist: 'Dmitrii Kolesnikov',
-    url: 'https://blossom.ditto.pub/5367242d3dc555c77f5c637fd153df1166708a24c5a4c222bb4dcaeabf740743.m4a',
-    durationSeconds: 124, // 2:04
-    tags: ['calming', 'sleep'],
-  },
-  {
-    id: 'epic_sacred_light',
-    title: 'Epic Sacred Light',
-    artist: 'Ura Megis',
-    url: 'https://blossom.dreamith.to/c22953791d686605958165fd44a84cd7d9fd3d4423ebf786e47891ed3a82c6db.m4a',
-    durationSeconds: 223, // 3:43
-    tags: ['energetic', 'adventure'],
-  },
-  {
-    id: 'split_memories',
-    title: 'Split Memories',
-    artist: 'ido berg',
-    url: 'https://blossom.ditto.pub/57ba2e2122a732449880ae531d4bfac9a580bc19693c7dda735afbfa336b35fe.m4a',
-    durationSeconds: 153, // 2:33
-    tags: ['ambient', 'relaxing'],
-  },
-  {
-    id: 'minhas_mensagens',
-    title: 'Minhas Mensagens',
-    artist: 'PReis',
-    url: 'https://blossom.ditto.pub/0945064dc8f946f3392be23629b166e72090cafca7cca865a20b5395dd83ff46.m4a',
-    durationSeconds: 248, // 4:08
-    tags: ['ambient', 'relaxing'],
-  },
-];
-
-/**
- * Get a track by ID from the catalog
- */
-export function getTrackById(id: string): BlobbiTrack | undefined {
-  return BLOBBI_TRACK_CATALOG.find(track => track.id === id);
-}
-
-/**
- * Get all tracks from the catalog
- */
-export function getAllTracks(): BlobbiTrack[] {
-  return BLOBBI_TRACK_CATALOG;
-}
-
-/**
- * Format duration in seconds to MM:SS string
- */
-export function formatTrackDuration(seconds: number): string {
-  const mins = Math.floor(seconds / 60);
-  const secs = Math.floor(seconds % 60);
-  return `${mins}:${secs.toString().padStart(2, '0')}`;
-}

src/blobbi/actions/lib/blobbi-xp.test.ts

@@ -1,135 +0,0 @@
-import { describe, it, expect } from 'vitest';
-
-import {
-  calculateActionXP,
-  calculateInventoryActionXP,
-  applyXPGain,
-  getXPGainSummary,
-  formatXPGain,
-  getXPGainMessage,
-  ACTION_XP,
-  INVENTORY_ACTION_XP,
-  DIRECT_ACTION_XP,
-} from './blobbi-xp';
-
-describe('calculateActionXP', () => {
-  it('returns the correct XP for each inventory action', () => {
-    expect(calculateActionXP('feed')).toBe(5);
-    expect(calculateActionXP('play')).toBe(8);
-    expect(calculateActionXP('clean')).toBe(6);
-    expect(calculateActionXP('medicine')).toBe(10);
-  });
-
-  it('returns the correct XP for each direct action', () => {
-    expect(calculateActionXP('play_music')).toBe(7);
-    expect(calculateActionXP('sing')).toBe(9);
-  });
-
-  it('returns 0 for an unknown action', () => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    expect(calculateActionXP('unknown' as any)).toBe(0);
-  });
-});
-
-describe('calculateInventoryActionXP', () => {
-  it('returns base XP for quantity 1', () => {
-    expect(calculateInventoryActionXP('feed', 1)).toBe(5);
-    expect(calculateInventoryActionXP('medicine', 1)).toBe(10);
-  });
-
-  it('multiplies XP by quantity', () => {
-    expect(calculateInventoryActionXP('feed', 3)).toBe(15);
-    expect(calculateInventoryActionXP('play', 5)).toBe(40);
-  });
-
-  it('defaults to quantity 1 when not specified', () => {
-    expect(calculateInventoryActionXP('clean')).toBe(6);
-  });
-
-  it('returns 0 for quantity less than 1', () => {
-    expect(calculateInventoryActionXP('feed', 0)).toBe(0);
-    expect(calculateInventoryActionXP('feed', -1)).toBe(0);
-  });
-});
-
-describe('applyXPGain', () => {
-  it('adds XP to a current value', () => {
-    expect(applyXPGain(100, 25)).toBe(125);
-  });
-
-  it('treats undefined current XP as 0', () => {
-    expect(applyXPGain(undefined, 10)).toBe(10);
-  });
-
-  it('never returns a negative value', () => {
-    expect(applyXPGain(5, -20)).toBe(0);
-    expect(applyXPGain(0, -1)).toBe(0);
-  });
-
-  it('handles zero XP gain', () => {
-    expect(applyXPGain(50, 0)).toBe(50);
-  });
-});
-
-describe('getXPGainSummary', () => {
-  it('returns the correct xpGained and quantity', () => {
-    const result = getXPGainSummary('feed', 3);
-    expect(result).toEqual({ xpGained: 15, quantity: 3 });
-  });
-
-  it('defaults quantity to 1', () => {
-    const result = getXPGainSummary('sing');
-    expect(result).toEqual({ xpGained: 9, quantity: 1 });
-  });
-});
-
-describe('formatXPGain', () => {
-  it('formats positive XP as "+N XP"', () => {
-    expect(formatXPGain(15)).toBe('+15 XP');
-    expect(formatXPGain(1)).toBe('+1 XP');
-  });
-
-  it('returns empty string for zero or negative XP', () => {
-    expect(formatXPGain(0)).toBe('');
-    expect(formatXPGain(-5)).toBe('');
-  });
-});
-
-describe('getXPGainMessage', () => {
-  it('formats a message with action and XP earned', () => {
-    expect(getXPGainMessage('feed', 5)).toBe('+5 XP earned!');
-  });
-
-  it('includes total when provided', () => {
-    expect(getXPGainMessage('feed', 5, 105)).toBe('+5 XP earned! Total: 105 XP');
-  });
-
-  it('returns empty string for zero or negative XP', () => {
-    expect(getXPGainMessage('feed', 0)).toBe('');
-    expect(getXPGainMessage('feed', -1)).toBe('');
-  });
-});
-
-describe('XP constants', () => {
-  it('ACTION_XP contains all inventory and direct actions', () => {
-    for (const action of Object.keys(INVENTORY_ACTION_XP)) {
-      expect(ACTION_XP).toHaveProperty(action);
-      expect(ACTION_XP[action as keyof typeof ACTION_XP]).toBe(
-        INVENTORY_ACTION_XP[action as keyof typeof INVENTORY_ACTION_XP],
-      );
-    }
-    for (const action of Object.keys(DIRECT_ACTION_XP)) {
-      expect(ACTION_XP).toHaveProperty(action);
-      expect(ACTION_XP[action as keyof typeof ACTION_XP]).toBe(
-        DIRECT_ACTION_XP[action as keyof typeof DIRECT_ACTION_XP],
-      );
-    }
-  });
-
-  it('all XP values are positive integers', () => {
-    for (const xp of Object.values(ACTION_XP)) {
-      expect(xp).toBeGreaterThan(0);
-      expect(Number.isInteger(xp)).toBe(true);
-    }
-  });
-});

src/blobbi/actions/lib/blobbi-xp.ts

@@ -1,138 +0,0 @@
-/**
- * Blobbi XP (Experience Points) System
- * 
- * This module defines XP values for all Blobbi care actions and provides
- * utilities for calculating and applying XP gains.
- * 
- * Design Philosophy:
- * - Different actions award different XP to reflect their complexity/value
- * - XP values are balanced to encourage variety in care activities
- * - Direct actions (sing, play_music) give moderate XP as they're free
- * - Inventory actions (feed, play, clean, medicine) give varied XP based on resource cost
- * - XP accumulates across all life stages and never resets
- */
-
-import type { BlobbiAction, InventoryAction, DirectAction } from './blobbi-action-utils';
-
-// ─── XP Values by Action ──────────────────────────────────────────────────────
-
-/**
- * Base XP values for inventory actions (feed, play, clean, medicine).
- * These actions consume items from the player's storage.
- */
-export const INVENTORY_ACTION_XP: Record<InventoryAction, number> = {
-  feed: 5,      // Feeding is common and essential - moderate XP
-  play: 8,      // Playing toys provides good interaction - higher XP
-  clean: 6,     // Hygiene maintenance is important - moderate-high XP
-  medicine: 10, // Medicine is costly and critical - highest inventory XP
-};
-
-/**
- * Base XP values for direct actions (play_music, sing).
- * These actions don't consume items - they're free activities.
- */
-export const DIRECT_ACTION_XP: Record<DirectAction, number> = {
-  play_music: 7,  // Playing music is engaging - good XP
-  sing: 9,        // Singing requires more user effort - higher XP
-};
-
-/**
- * Combined XP lookup for all action types.
- * Use this for a unified XP calculation interface.
- */
-export const ACTION_XP: Record<BlobbiAction, number> = {
-  ...INVENTORY_ACTION_XP,
-  ...DIRECT_ACTION_XP,
-};
-
-// ─── XP Calculation Utilities ─────────────────────────────────────────────────
-
-/**
- * Calculate XP gain for a single action.
- * 
- * @param action - The action performed
- * @returns XP points earned
- */
-export function calculateActionXP(action: BlobbiAction): number {
-  return ACTION_XP[action] ?? 0;
-}
-
-/**
- * Calculate total XP gain for using multiple items.
- * Each item use counts as a separate action for XP purposes.
- * 
- * @param action - The action performed
- * @param quantity - Number of items used (defaults to 1)
- * @returns Total XP points earned
- */
-export function calculateInventoryActionXP(action: InventoryAction, quantity: number = 1): number {
-  if (quantity < 1) return 0;
-  const baseXP = INVENTORY_ACTION_XP[action] ?? 0;
-  return baseXP * quantity;
-}
-
-/**
- * Apply XP gain to current experience value.
- * 
- * @param currentXP - Current experience points (undefined = 0)
- * @param xpGain - XP points to add
- * @returns New total XP (never negative)
- */
-export function applyXPGain(currentXP: number | undefined, xpGain: number): number {
-  const current = currentXP ?? 0;
-  const newXP = current + xpGain;
-  return Math.max(0, newXP);
-}
-
-/**
- * Get XP gain summary for displaying to the user.
- * 
- * @param action - The action performed
- * @param quantity - Number of times the action was performed (for inventory actions)
- * @returns Object with xpGained and total quantity
- */
-export function getXPGainSummary(
-  action: BlobbiAction,
-  quantity: number = 1
-): { xpGained: number; quantity: number } {
-  const baseXP = ACTION_XP[action] ?? 0;
-  const xpGained = baseXP * quantity;
-  return { xpGained, quantity };
-}
-
-// ─── XP Display Utilities ─────────────────────────────────────────────────────
-
-/**
- * Format XP gain for display in toasts/notifications.
- * 
- * @param xpGained - Amount of XP gained
- * @returns Formatted string like "+15 XP"
- */
-export function formatXPGain(xpGained: number): string {
-  if (xpGained <= 0) return '';
-  return `+${xpGained} XP`;
-}
-
-/**
- * Get a descriptive message about XP gain.
- * 
- * @param action - The action that earned XP
- * @param xpGained - Amount of XP gained
- * @param newTotal - New total XP (optional, for "You now have X XP" message)
- * @returns Formatted message for user feedback
- */
-export function getXPGainMessage(
-  action: BlobbiAction,
-  xpGained: number,
-  newTotal?: number
-): string {
-  if (xpGained <= 0) return '';
-  
-  const xpText = formatXPGain(xpGained);
-  
-  if (newTotal !== undefined) {
-    return `${xpText} earned! Total: ${newTotal} XP`;
-  }
-  
-  return `${xpText} earned!`;
-}

src/blobbi/actions/lib/daily-mission-tracker.ts

@@ -1,109 +0,0 @@
-/**
- * Daily Mission Tracker - Standalone progress tracking utility
- * 
- * This module provides a simple way to track daily mission progress
- * without requiring React hooks or context. It directly manipulates
- * localStorage for immediate persistence.
- * 
- * This approach allows action hooks (which may be called outside of
- * the daily missions hook context) to record progress.
- */
-
-import {
-  type DailyMissionsState,
-  type DailyMissionAction,
-  getTodayDateString,
-  needsDailyReset,
-  createDailyMissionsState,
-  updateMissionProgress,
-} from './daily-missions';
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-const STORAGE_KEY = 'blobbi:daily-missions';
-
-// ─── Storage Utilities ────────────────────────────────────────────────────────
-
-/**
- * Read the current daily missions state from localStorage
- */
-function readState(): DailyMissionsState | null {
-  try {
-    const stored = localStorage.getItem(STORAGE_KEY);
-    return stored ? JSON.parse(stored) : null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Write the daily missions state to localStorage
- */
-function writeState(state: DailyMissionsState): void {
-  try {
-    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
-  } catch (error) {
-    console.warn('[DailyMissionTracker] Failed to write state:', error);
-  }
-}
-
-/**
- * Ensure we have a valid state for today, creating one if necessary
- */
-function ensureCurrentState(pubkey?: string): DailyMissionsState {
-  const current = readState();
-  
-  if (needsDailyReset(current)) {
-    const previousCoins = current?.totalCoinsEarned ?? 0;
-    const newState = createDailyMissionsState(getTodayDateString(), pubkey, previousCoins);
-    writeState(newState);
-    return newState;
-  }
-  
-  return current!;
-}
-
-// ─── Public API ───────────────────────────────────────────────────────────────
-
-/**
- * Record progress for a daily mission action.
- * This function can be called from anywhere (hooks, event handlers, etc.)
- * and will immediately persist to localStorage.
- * 
- * @param action - The action type that was performed
- * @param count - Number of times the action was performed (default: 1)
- * @param pubkey - Optional user pubkey for personalized mission selection
- */
-export function trackDailyMissionProgress(
-  action: DailyMissionAction,
-  count: number = 1,
-  pubkey?: string
-): void {
-  const current = ensureCurrentState(pubkey);
-  const updated = updateMissionProgress(current, action, count);
-  writeState(updated);
-  
-  // Dispatch a custom event so React components can re-render if needed
-  window.dispatchEvent(new CustomEvent('daily-missions-updated', { detail: { action, count } }));
-}
-
-/**
- * Convenience function to track multiple actions at once.
- * Useful when an action should count toward multiple missions.
- * 
- * @param actions - Array of actions to track
- * @param pubkey - Optional user pubkey
- */
-export function trackMultipleDailyMissionActions(
-  actions: DailyMissionAction[],
-  pubkey?: string
-): void {
-  let current = ensureCurrentState(pubkey);
-  
-  for (const action of actions) {
-    current = updateMissionProgress(current, action, 1);
-  }
-  
-  writeState(current);
-  window.dispatchEvent(new CustomEvent('daily-missions-updated', { detail: { actions } }));
-}

src/blobbi/actions/lib/daily-missions.ts

@@ -1,708 +0,0 @@
-/**
- * Daily Missions System for Blobbi
- * 
- * This module defines the daily mission pool, selection logic, and types.
- * Daily missions are separate from hatch/evolve missions and provide
- * daily engagement loops with coin rewards.
- */
-
-// ─── Types ────────────────────────────────────────────────────────────────────
-
-/**
- * Mission action types that can trigger progress
- */
-export type DailyMissionAction = 
-  | 'interact'      // Any interaction (feed, clean, play, etc.)
-  | 'feed'          // Feeding action specifically
-  | 'clean'         // Cleaning action specifically
-  | 'sing'          // Sing direct action
-  | 'play_music'    // Play music direct action
-  | 'sleep'         // Put Blobbi to sleep
-  | 'take_photo'    // Take a photo of Blobbi
-  | 'medicine';     // Give medicine to Blobbi
-
-/**
- * Blobbi stage type for filtering missions
- */
-export type BlobbiStage = 'egg' | 'baby' | 'adult';
-
-/**
- * Definition of a daily mission in the pool
- */
-export interface DailyMissionDefinition {
-  /** Unique identifier for this mission type */
-  id: string;
-  /** Display title */
-  title: string;
-  /** Description of what to do */
-  description: string;
-  /** Action that triggers progress */
-  action: DailyMissionAction;
-  /** Number of times the action must be performed */
-  requiredCount: number;
-  /** Coin reward for completing this mission */
-  reward: number;
-  /** Selection weight (higher = more likely to be selected) */
-  weight: number;
-  /** Required stages to show this mission (if empty/undefined, requires baby or adult) */
-  requiredStages?: BlobbiStage[];
-}
-
-/**
- * A daily mission instance with progress tracking
- */
-export interface DailyMission extends DailyMissionDefinition {
-  /** Current progress (how many times the action has been performed today) */
-  currentCount: number;
-  /** Whether the mission has been completed */
-  completed: boolean;
-  /** Whether the reward has been claimed */
-  claimed: boolean;
-}
-
-/**
- * Stored state for daily missions (persisted in localStorage)
- */
-export interface DailyMissionsState {
-  /** The date string (YYYY-MM-DD) when these missions were generated */
-  date: string;
-  /** The selected missions for this day */
-  missions: DailyMission[];
-  /** Total coins earned from daily missions (lifetime) */
-  totalCoinsEarned: number;
-  /** Whether the bonus mission has been claimed today */
-  bonusClaimed?: boolean;
-  /** Number of rerolls remaining for today (resets daily, max 3) */
-  rerollsRemaining?: number;
-}
-
-// ─── Constants ────────────────────────────────────────────────────────────────
-
-/** Maximum number of mission rerolls allowed per day */
-export const MAX_DAILY_REROLLS = 3;
-
-// ─── Mission Pool ─────────────────────────────────────────────────────────────
-
-/**
- * The pool of available daily missions.
- * Weights determine selection frequency:
- * - High weight (10): Common missions (interact, feed, clean)
- * - Medium weight (6): Regular missions (sing, play music, sleep)
- * - Low weight (2): Uncommon missions (change shape)
- * - Rare weight (1): Rare missions (take photo)
- */
-export const DAILY_MISSION_POOL: DailyMissionDefinition[] = [
-  // ═══════════════════════════════════════════════════════════════════════════
-  // BABY/ADULT ONLY MISSIONS
-  // These actions are NOT available for eggs
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ─── Interact Missions (Baby/Adult only) ───────────────────────────────────
-  {
-    id: 'interact_3',
-    title: 'Quick Care',
-    description: 'Interact with your Blobbi 3 times',
-    action: 'interact',
-    requiredCount: 3,
-    reward: 30,
-    weight: 10,
-    requiredStages: ['baby', 'adult'],
-  },
-  {
-    id: 'interact_6',
-    title: 'Attentive Caretaker',
-    description: 'Interact with your Blobbi 6 times',
-    action: 'interact',
-    requiredCount: 6,
-    reward: 50,
-    weight: 8,
-    requiredStages: ['baby', 'adult'],
-  },
-
-  // ─── Feed Missions (Baby/Adult only) ───────────────────────────────────────
-  {
-    id: 'feed_1',
-    title: 'Snack Time',
-    description: 'Feed your Blobbi once',
-    action: 'feed',
-    requiredCount: 1,
-    reward: 25,
-    weight: 10,
-    requiredStages: ['baby', 'adult'],
-  },
-  {
-    id: 'feed_2',
-    title: 'Hungry Blobbi',
-    description: 'Feed your Blobbi 2 times',
-    action: 'feed',
-    requiredCount: 2,
-    reward: 45,
-    weight: 8,
-    requiredStages: ['baby', 'adult'],
-  },
-  {
-    id: 'feed_3',
-    title: 'Feast Day',
-    description: 'Feed your Blobbi 3 times',
-    action: 'feed',
-    requiredCount: 3,
-    reward: 60,
-    weight: 5,
-    requiredStages: ['baby', 'adult'],
-  },
-
-  // ─── Sleep Missions (Baby/Adult only) ──────────────────────────────────────
-  {
-    id: 'sleep_1',
-    title: 'Nap Time',
-    description: 'Put your Blobbi to sleep',
-    action: 'sleep',
-    requiredCount: 1,
-    reward: 30,
-    weight: 6,
-    requiredStages: ['baby', 'adult'],
-  },
-
-  // ─── Photo Missions (Baby/Adult only) ──────────────────────────────────────
-  {
-    id: 'take_photo_1',
-    title: 'Snapshot',
-    description: 'Take a polaroid photo of your Blobbi',
-    action: 'take_photo',
-    requiredCount: 1,
-    reward: 55,
-    weight: 4,
-    requiredStages: ['baby', 'adult'],
-  },
-  {
-    id: 'take_photo_2',
-    title: 'Photo Album',
-    description: 'Take 2 photos of your Blobbi',
-    action: 'take_photo',
-    requiredCount: 2,
-    reward: 70,
-    weight: 2,
-    requiredStages: ['baby', 'adult'],
-  },
-
-  // ═══════════════════════════════════════════════════════════════════════════
-  // EGG + BABY + ADULT MISSIONS
-  // These actions are available for ALL stages including eggs
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ─── Clean Missions (All stages) ───────────────────────────────────────────
-  {
-    id: 'clean_1',
-    title: 'Quick Cleanup',
-    description: 'Clean your Blobbi once',
-    action: 'clean',
-    requiredCount: 1,
-    reward: 25,
-    weight: 10,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-  {
-    id: 'clean_2',
-    title: 'Squeaky Clean',
-    description: 'Clean your Blobbi 2 times',
-    action: 'clean',
-    requiredCount: 2,
-    reward: 45,
-    weight: 6,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-
-  // ─── Sing Missions (All stages) ────────────────────────────────────────────
-  {
-    id: 'sing_1',
-    title: 'Sing Along',
-    description: 'Sing a song to your Blobbi',
-    action: 'sing',
-    requiredCount: 1,
-    reward: 30,
-    weight: 6,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-  {
-    id: 'sing_2',
-    title: 'Karaoke Session',
-    description: 'Sing 2 songs to your Blobbi',
-    action: 'sing',
-    requiredCount: 2,
-    reward: 50,
-    weight: 3,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-
-  // ─── Play Music Missions (All stages) ──────────────────────────────────────
-  {
-    id: 'play_music_1',
-    title: 'DJ Time',
-    description: 'Play a song for your Blobbi',
-    action: 'play_music',
-    requiredCount: 1,
-    reward: 30,
-    weight: 6,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-  {
-    id: 'play_music_2',
-    title: 'Music Marathon',
-    description: 'Play 2 songs for your Blobbi',
-    action: 'play_music',
-    requiredCount: 2,
-    reward: 50,
-    weight: 3,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-
-  // ─── Medicine Missions (All stages) ────────────────────────────────────────
-  // Medicine rewards are higher since medicine costs coins to use
-  {
-    id: 'medicine_1',
-    title: 'Health Check',
-    description: 'Give medicine to your Blobbi',
-    action: 'medicine',
-    requiredCount: 1,
-    reward: 60,
-    weight: 5,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-  {
-    id: 'medicine_2',
-    title: 'Doctor Visit',
-    description: 'Give medicine to your Blobbi 2 times',
-    action: 'medicine',
-    requiredCount: 2,
-    reward: 70,
-    weight: 3,
-    requiredStages: ['egg', 'baby', 'adult'],
-  },
-];
-
-// ─── Utility Functions ────────────────────────────────────────────────────────
-
-/**
- * Get the current date string in YYYY-MM-DD format (local timezone)
- */
-export function getTodayDateString(): string {
-  const now = new Date();
-  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
-}
-
-/**
- * Generate a seed number from a date string and optional user pubkey.
- * Used for deterministic daily mission selection.
- */
-function generateDailySeed(dateString: string, pubkey?: string): number {
-  const input = pubkey ? `${dateString}:${pubkey}` : dateString;
-  let hash = 0;
-  for (let i = 0; i < input.length; i++) {
-    const char = input.charCodeAt(i);
-    hash = ((hash << 5) - hash) + char;
-    hash = hash & hash; // Convert to 32-bit integer
-  }
-  return Math.abs(hash);
-}
-
-/**
- * Seeded random number generator (Mulberry32)
- */
-function seededRandom(seed: number): () => number {
-  return function() {
-    let t = seed += 0x6D2B79F5;
-    t = Math.imul(t ^ t >>> 15, t | 1);
-    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
-    return ((t ^ t >>> 14) >>> 0) / 4294967296;
-  };
-}
-
-/**
- * Check if a mission is available for the given stages.
- * Missions with no requiredStages default to requiring baby or adult.
- */
-function isMissionAvailableForStages(
-  mission: DailyMissionDefinition,
-  availableStages: BlobbiStage[]
-): boolean {
-  const requiredStages = mission.requiredStages ?? ['baby', 'adult'];
-  return requiredStages.some((stage) => availableStages.includes(stage));
-}
-
-/**
- * Select N missions from the pool using weighted random selection.
- * Uses a seeded random generator for deterministic daily selection.
- * 
- * @param count - Number of missions to select
- * @param dateString - Date string for seeding (YYYY-MM-DD)
- * @param pubkey - Optional user pubkey for seeding
- * @param availableStages - Stages the user has available (filters eligible missions)
- */
-export function selectDailyMissions(
-  count: number,
-  dateString: string,
-  pubkey?: string,
-  availableStages?: BlobbiStage[]
-): DailyMissionDefinition[] {
-  const seed = generateDailySeed(dateString, pubkey);
-  const random = seededRandom(seed);
-  
-  // Filter pool by available stages (default to baby/adult if not specified)
-  const stagesToCheck = availableStages ?? ['baby', 'adult'];
-  const eligibleMissions = DAILY_MISSION_POOL.filter((m) =>
-    isMissionAvailableForStages(m, stagesToCheck)
-  );
-  
-  // If no missions are available for the user's stages, return empty
-  if (eligibleMissions.length === 0) {
-    return [];
-  }
-  
-  // Create a copy of the eligible pool
-  const available = [...eligibleMissions];
-  const selected: DailyMissionDefinition[] = [];
-  
-  while (selected.length < count && available.length > 0) {
-    // Calculate total weight of remaining missions
-    const totalWeight = available.reduce((sum, m) => sum + m.weight, 0);
-    
-    // Pick a random value in [0, totalWeight)
-    let pick = random() * totalWeight;
-    
-    // Find the mission that corresponds to this pick
-    let selectedIndex = 0;
-    for (let i = 0; i < available.length; i++) {
-      pick -= available[i].weight;
-      if (pick <= 0) {
-        selectedIndex = i;
-        break;
-      }
-    }
-    
-    // Add to selected and remove from available
-    selected.push(available[selectedIndex]);
-    available.splice(selectedIndex, 1);
-  }
-  
-  return selected;
-}
-
-/**
- * Create a fresh DailyMission from a definition
- */
-export function createMissionFromDefinition(def: DailyMissionDefinition): DailyMission {
-  return {
-    ...def,
-    currentCount: 0,
-    completed: false,
-    claimed: false,
-  };
-}
-
-/**
- * Create the initial daily missions state for a new day
- */
-export function createDailyMissionsState(
-  dateString: string,
-  pubkey?: string,
-  previousTotalCoins: number = 0,
-  availableStages?: BlobbiStage[]
-): DailyMissionsState {
-  const definitions = selectDailyMissions(3, dateString, pubkey, availableStages);
-  return {
-    date: dateString,
-    missions: definitions.map(createMissionFromDefinition),
-    totalCoinsEarned: previousTotalCoins,
-    rerollsRemaining: MAX_DAILY_REROLLS,
-  };
-}
-
-/**
- * Check if the daily missions need to be reset (new day)
- */
-export function needsDailyReset(state: DailyMissionsState | null): boolean {
-  if (!state) return true;
-  return state.date !== getTodayDateString();
-}
-
-/**
- * Update mission progress for a given action
- */
-export function updateMissionProgress(
-  state: DailyMissionsState,
-  action: DailyMissionAction,
-  incrementBy: number = 1
-): DailyMissionsState {
-  const updatedMissions = state.missions.map((mission) => {
-    // Skip if not the matching action or already completed
-    if (mission.action !== action || mission.completed) {
-      return mission;
-    }
-    
-    const newCount = Math.min(mission.currentCount + incrementBy, mission.requiredCount);
-    const nowCompleted = newCount >= mission.requiredCount;
-    
-    return {
-      ...mission,
-      currentCount: newCount,
-      completed: nowCompleted,
-    };
-  });
-  
-  return {
-    ...state,
-    missions: updatedMissions,
-  };
-}
-
-/**
- * Claim reward for a completed mission
- */
-export function claimMissionReward(
-  state: DailyMissionsState,
-  missionId: string
-): { state: DailyMissionsState; coinsEarned: number } {
-  let coinsEarned = 0;
-  
-  const updatedMissions = state.missions.map((mission) => {
-    if (mission.id !== missionId) return mission;
-    
-    // Can only claim if completed and not yet claimed
-    if (!mission.completed || mission.claimed) return mission;
-    
-    coinsEarned = mission.reward;
-    return {
-      ...mission,
-      claimed: true,
-    };
-  });
-  
-  return {
-    state: {
-      ...state,
-      missions: updatedMissions,
-      totalCoinsEarned: state.totalCoinsEarned + coinsEarned,
-    },
-    coinsEarned,
-  };
-}
-
-/**
- * Get the total potential reward for all daily missions
- */
-export function getTotalPotentialReward(state: DailyMissionsState): number {
-  return state.missions.reduce((sum, m) => sum + m.reward, 0);
-}
-
-/**
- * Get the total claimed reward for today
- */
-export function getTodayClaimedReward(state: DailyMissionsState): number {
-  return state.missions
-    .filter((m) => m.claimed)
-    .reduce((sum, m) => sum + m.reward, 0);
-}
-
-/**
- * Check if all daily missions are completed
- */
-export function areAllMissionsCompleted(state: DailyMissionsState): boolean {
-  return state.missions.every((m) => m.completed);
-}
-
-/**
- * Check if all daily missions are claimed
- */
-export function areAllMissionsClaimed(state: DailyMissionsState): boolean {
-  return state.missions.every((m) => m.claimed);
-}
-
-// ─── Bonus Mission ────────────────────────────────────────────────────────────
-
-/**
- * The bonus mission that becomes available after completing all regular missions.
- * This is a special mission that rewards extra coins for daily completion.
- */
-export const BONUS_MISSION_DEFINITION: DailyMissionDefinition = {
-  id: 'bonus_daily_complete',
-  title: 'Daily Champion',
-  description: 'Complete all daily missions to claim this bonus reward',
-  action: 'interact', // Not actually used - bonus is auto-completed
-  requiredCount: 1,
-  reward: 80,
-  weight: 0, // Not part of random selection
-};
-
-/**
- * Check if the bonus mission is available (all regular missions completed)
- */
-export function isBonusMissionAvailable(state: DailyMissionsState): boolean {
-  // Bonus is available if there are regular missions and all are completed
-  return state.missions.length > 0 && areAllMissionsCompleted(state);
-}
-
-/**
- * Check if the bonus mission has been claimed today
- */
-export function isBonusMissionClaimed(state: DailyMissionsState): boolean {
-  return state.bonusClaimed ?? false;
-}
-
-/**
- * Claim the bonus mission reward
- */
-export function claimBonusMissionReward(
-  state: DailyMissionsState
-): { state: DailyMissionsState; coinsEarned: number } {
-  // Can only claim if bonus is available and not yet claimed
-  if (!isBonusMissionAvailable(state) || isBonusMissionClaimed(state)) {
-    return { state, coinsEarned: 0 };
-  }
-  
-  return {
-    state: {
-      ...state,
-      bonusClaimed: true,
-      totalCoinsEarned: state.totalCoinsEarned + BONUS_MISSION_DEFINITION.reward,
-    },
-    coinsEarned: BONUS_MISSION_DEFINITION.reward,
-  };
-}
-
-// ─── Mission Reroll ───────────────────────────────────────────────────────────
-
-/**
- * Get the number of rerolls remaining for today.
- * Returns MAX_DAILY_REROLLS if not set (for backward compatibility with old state).
- */
-export function getRerollsRemaining(state: DailyMissionsState): number {
-  // If rerollsRemaining is not set (old state), default to max
-  if (state.rerollsRemaining === undefined || state.rerollsRemaining === null) {
-    return MAX_DAILY_REROLLS;
-  }
-  return state.rerollsRemaining;
-}
-
-/**
- * Check if the user can reroll a mission
- */
-export function canRerollMission(state: DailyMissionsState, missionId: string): boolean {
-  const rerollsRemaining = getRerollsRemaining(state);
-  if (rerollsRemaining <= 0) return false;
-  
-  // Find the mission
-  const mission = state.missions.find((m) => m.id === missionId);
-  if (!mission) return false;
-  
-  // Cannot reroll completed or claimed missions
-  if (mission.completed || mission.claimed) return false;
-  
-  return true;
-}
-
-/**
- * Select a replacement mission that:
- * - Is not already in the current mission list
- * - Is not the mission being replaced (avoid immediately giving back the same)
- * - Respects the user's available stages
- * 
- * Uses weighted random selection from eligible missions.
- */
-export function selectReplacementMission(
-  currentMissions: DailyMission[],
-  missionToReplace: DailyMission,
-  availableStages?: BlobbiStage[]
-): DailyMissionDefinition | null {
-  // Default to baby/adult if no stages provided (most common case)
-  const stagesToCheck = availableStages && availableStages.length > 0 
-    ? availableStages 
-    : ['baby', 'adult'] as BlobbiStage[];
-  
-  // Get IDs of missions that cannot be selected (current active missions)
-  const excludedIds = new Set<string>();
-  
-  // Exclude all current missions EXCEPT the one being replaced
-  for (const m of currentMissions) {
-    if (m.id !== missionToReplace.id) {
-      excludedIds.add(m.id);
-    }
-  }
-  
-  // Filter pool to eligible missions
-  const eligibleMissions = DAILY_MISSION_POOL.filter((m) => {
-    // Must not be an already-active mission (except the one being replaced)
-    if (excludedIds.has(m.id)) return false;
-    // Must not be the same mission being replaced
-    if (m.id === missionToReplace.id) return false;
-    // Must be available for user's stages
-    if (!isMissionAvailableForStages(m, stagesToCheck)) return false;
-    return true;
-  });
-  
-  // If no eligible missions, return null
-  if (eligibleMissions.length === 0) {
-    return null;
-  }
-  
-  // Use Math.random() for non-deterministic selection (rerolls should feel random)
-  const totalWeight = eligibleMissions.reduce((sum, m) => sum + m.weight, 0);
-  let pick = Math.random() * totalWeight;
-  
-  for (const mission of eligibleMissions) {
-    pick -= mission.weight;
-    if (pick <= 0) {
-      return mission;
-    }
-  }
-  
-  // Fallback to first eligible (shouldn't happen)
-  return eligibleMissions[0];
-}
-
-/**
- * Reroll a mission, replacing it with a new one from the pool.
- * Returns the updated state and the new mission, or null if reroll failed.
- */
-export function rerollMission(
-  state: DailyMissionsState,
-  missionId: string,
-  availableStages?: BlobbiStage[]
-): { state: DailyMissionsState; newMission: DailyMission } | null {
-  // Check if reroll is allowed
-  if (!canRerollMission(state, missionId)) {
-    return null;
-  }
-  
-  // Find the mission index
-  const missionIndex = state.missions.findIndex((m) => m.id === missionId);
-  if (missionIndex === -1) {
-    return null;
-  }
-  
-  const oldMission = state.missions[missionIndex];
-  
-  // Select a replacement
-  const replacement = selectReplacementMission(state.missions, oldMission, availableStages);
-  if (!replacement) {
-    return null;
-  }
-  
-  // Create the new mission instance
-  const newMission = createMissionFromDefinition(replacement);
-  
-  // Update the missions array
-  const updatedMissions = [...state.missions];
-  updatedMissions[missionIndex] = newMission;
-  
-  // Decrement rerolls remaining
-  const newRerollsRemaining = getRerollsRemaining(state) - 1;
-  
-  return {
-    state: {
-      ...state,
-      missions: updatedMissions,
-      rerollsRemaining: newRerollsRemaining,
-    },
-    newMission,
-  };
-}

src/blobbi/adult-blobbi/assets/bloomi/bloomi-base.svg

@@ -1,100 +0,0 @@
-<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
-  <!-- Grupo das pétalas com rotação -->
-  <g transform="rotate(0 100 110)">
-    <animateTransform 
-      attributeName="transform" 
-      type="rotate" 
-      from="0 100 110" 
-      to="360 100 110" 
-      dur="10s" 
-      repeatCount="indefinite" />
-    <circle cx="100" cy="70" r="25" fill="url(#bloomiPetal1)" />
-    <circle cx="130" cy="90" r="25" fill="url(#bloomiPetal2)" />
-    <circle cx="130" cy="130" r="25" fill="url(#bloomiPetal3)" />
-    <circle cx="100" cy="150" r="25" fill="url(#bloomiPetal4)" />
-    <circle cx="70" cy="130" r="25" fill="url(#bloomiPetal5)" />
-    <circle cx="70" cy="90" r="25" fill="url(#bloomiPetal6)" />
-  </g>
-
-  <!-- Grupo das partículas giratórias -->
-  <g transform="rotate(0 100 110)">
-    <animateTransform 
-      attributeName="transform" 
-      type="rotate" 
-      from="0 100 110" 
-      to="-360 100 110" 
-      dur="20s" 
-      repeatCount="indefinite" />
-    <circle cx="60" cy="80" r="2" fill="url(#bloomiPollen)" opacity="0.8" />
-    <circle cx="140" cy="85" r="1.5" fill="url(#bloomiPollen)" opacity="0.6" />
-    <circle cx="55" cy="140" r="1" fill="url(#bloomiPollen)" opacity="0.7" />
-    <circle cx="145" cy="135" r="2" fill="url(#bloomiPollen)" opacity="0.5" />
-    <circle cx="75" cy="60" r="1.5" fill="url(#bloomiPollen)" opacity="0.9" />
-  </g>
-
-  <!-- Centro da flor -->
-  <circle cx="100" cy="110" r="35" fill="url(#bloomiCenter)" />
-  <circle cx="100" cy="110" r="28" fill="url(#bloomiCenterHighlight)" opacity="0.6" />
-
-  <!-- Eyes (white/base eye shapes) -->
-  <circle cx="88" cy="105" r="8" fill="white" />
-  <circle cx="112" cy="105" r="8" fill="white" />
-  
-  <!-- Pupils (pupil + highlights) -->
-  <circle cx="88" cy="105" r="5" fill="#1f2937" />
-  <circle cx="112" cy="105" r="5" fill="#1f2937" />
-  <circle cx="90" cy="103" r="2" fill="white" />
-  <circle cx="114" cy="103" r="2" fill="white" />
-
-  <!-- Mouth -->
-  <path d="M 90 120 Q 100 128 110 120" stroke="#1f2937" stroke-width="3" fill="none" stroke-linecap="round" />
-
-  <!-- Bochechas -->
-  <circle cx="70" cy="115" r="8" fill="url(#bloomiBlush)" opacity="0.6" />
-  <circle cx="130" cy="115" r="8" fill="url(#bloomiBlush)" opacity="0.6" />
-
-  <!-- Gradientes -->
-  <defs>
-    <radialGradient id="bloomiPetal1" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#fef3c7" />
-      <stop offset="100%" stop-color="#fbbf24" />
-    </radialGradient>
-    <radialGradient id="bloomiPetal2" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#fed7d7" />
-      <stop offset="100%" stop-color="#f87171" />
-    </radialGradient>
-    <radialGradient id="bloomiPetal3" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#fce7f3" />
-      <stop offset="100%" stop-color="#f472b6" />
-    </radialGradient>
-    <radialGradient id="bloomiPetal4" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#e0e7ff" />
-      <stop offset="100%" stop-color="#8b5cf6" />
-    </radialGradient>
-    <radialGradient id="bloomiPetal5" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#dcfce7" />
-      <stop offset="100%" stop-color="#22c55e" />
-    </radialGradient>
-    <radialGradient id="bloomiPetal6" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#dbeafe" />
-      <stop offset="100%" stop-color="#3b82f6" />
-    </radialGradient>
-    <radialGradient id="bloomiCenter" cx="0.3" cy="0.2">
-      <stop offset="0%" stop-color="#fef3c7" />
-      <stop offset="50%" stop-color="#fbbf24" />
-      <stop offset="100%" stop-color="#f59e0b" />
-    </radialGradient>
-    <radialGradient id="bloomiCenterHighlight" cx="0.4" cy="0.3">
-      <stop offset="0%" stop-color="#ffffff" />
-      <stop offset="100%" stop-color="rgba(255,255,255,0.3)" />
-    </radialGradient>
-    <radialGradient id="bloomiBlush" cx="0.3" cy="0.3">
-      <stop offset="0%" stop-color="#fce7f3" />
-      <stop offset="100%" stop-color="#f472b6" />
-    </radialGradient>
-    <radialGradient id="bloomiPollen" cx="0.5" cy="0.5">
-      <stop offset="0%" stop-color="#fef3c7" />
-      <stop offset="100%" stop-color="#fbbf24" />
-    </radialGradient>
-  </defs>
-</svg>