Nostr-Engagement-Features — Kontext & Lernprotokoll

Erstellt: 2026-07-21 Status: Draft (nicht production-ready) Ziel: Späteres Wiederaufgreifen ohne bei Null anzfangen

❌ Warum nicht production-ready

1. Follower-Zählung = 0: Keine Relay-Abfragen implementiert. Platzhalter-Werte.
2. Engagement = 0: Keine Posts haben event_id in state.json.
   • Posts sind im Status draft oder scheduled, nicht published.
   • sovgrid-nostr-daily.py schreibt erst bei publish_scheduled() event_ids.
   • engagement_fetcher.py sucht nur nach Posts mit event_ids.
3. Kein Event-ID-Workflow: Alte Posts (vor dem Status-Machine) haben keine event_ids.
   • Nur neu über sovgrid-nostr-daily.py --publish-scheduled veröffentlichte Posts bekommen event_ids.

📁 Dateien (alle im Draft-Verzeichnis)

state.json

• Ort: /data/scripts/blog/nostr-state/state.json
• Struktur: posts[], reposts[], replies[], liked_events[]
• Jeder Post hat: status, event_id, published_at, article_slug
• Problem: Alle aktuellen Posts haben status=draft/scheduled und event_id=(none)

generate_nostr_stats.py

• Ort: /data/scripts/blog/generate_nostr_stats.py
• Funktion: Liest state.json + nsm-stats.json, generiert nostr-stats.json
• Ausgabe: nostr-stats.json mit followers, engagement, stats
• Problem: Zählt nur replies/likes/reposts aus state.json, nicht von Relays

engagement_fetcher.py

• Ort: /data/scripts/blog/engagement_fetcher.py
• Funktion: Sucht Nostr-Posts nach Blog-URL auf öffentlichen Relays
• Zählt: kind-1 replies, kind-7 likes, kind-74 reposts
• Problem: Braucht Posts mit event_id in state.json
• Lösung: Muss erst nach publish_scheduled() laufen

insights.astro (modifiziert)

• Feature: Follower-Sektion mit follower-grid, follower-card
• Feature: Engagement-Spalten (Replies, Likes, Reposts, Comments)
• Feature: JS fetches /api/nostr-stats.json für live Daten
• Problem: Wurde nie committet, nicht im Repo verfügbar

Caddyfile (modifiziert)

• Feature: handle /api/nostr-stats.json mit rewrite * /nostr-stats.json
• Feature: root * /srv, file_server, JSON headers
• Problem: Wurde revertet, muss neu deployed werden

Crontab

0 3 * * * /usr/bin/python3 /data/scripts/blog/generate_nostr_stats.py /tmp/nostr-stats.json && scp /tmp/nostr-stats.json floki:/home/cipherfox/sovereign-blog/srv/nostr-stats.json && ssh floki 'docker restart sovereign-caddy'

🔧 Was zum Laufen gebracht wurde

1. ✅ generate_nostr_stats.py generiert korrekte nostr-stats.json
2. ✅ Caddyfile-Handler auf Floki serviert /api/nostr-stats.json
3. ✅ nostr-stats.json wird von Floki via Docker-Volume gemountet
4. ✅ Crontab auf sparki generiert + deployt (wurde bereinigt)
5. ✅ insights.astro zeigt Follower-Karten + Engagement-Zellen

🚧 Was noch fehlt

1. Relay-Follower-Zählung:

   • Muss nostr-tools oder @nostr/tools installieren
   • Relay-Query für kind-10001 (follow events) pro Account
   • Ergebnis in state.json schreiben
   • generate_nostr_stats.py liest follower counts aus state.json

2. Event-ID-Workflow:

   • Alte Posts müssen nachträglich mit event_ids versehen werden
   • Entweder: Manuell event_ids in state.json eintragen
   • Oder: engagement_fetcher.py sucht nach Blog-URLs auf Relays
   • Dann: publish_scheduled() für neue Posts nutzen

3. Integration:

   • insights.astro muss die Nostr-Features wieder einbauen
   • Caddyfile muss den nostr-stats-Handler wieder enthalten
   • Crontab muss aktiviert sein

📋 Nächste Schritte (wiederaufgreifen)

1. state.json mit event_ids füllen (alte Posts manuell oder neue via status machine)
2. Relay-Follower-Zählung implementieren (nostr-tools)
3. insights.astro mit Nostr-Features neu erstellen (aus draft kopieren)
4. Caddyfile nostr-stats-Handler wieder einfügen
5. Crontab aktivieren
6. Testen: curl https://sovgrid.org/api/nostr-stats.json
7. Deploy: npm run build && deploy.sh

📚 Referenzen

• sovgrid-nostr-daily.py: Status-Machine (draft → scheduled → published)
• engagement_fetcher.py: Relay-Query für replies/likes/reposts
• generate_nostr_stats.py: Generiert nostr-stats.json aus state.json
• Caddyfile: Served /api/nostr-stats.json von /srv/nostr-stats.json