joerglohrer
/
joerglohrerde
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
joerglohrerde/docs/HANDOFF.md

9.2 KiB
Raw Blame History

Handoff — Nächste Session

Du (Claude, nächste Session) oder ich (Jörg, später) kommen hier zurück. Dieses Dokument sagt: was ist der Zustand, was wartet, wo liegen die Fäden.

Zustand (Details in STATUS.md)

Cutover am 2026-04-18 abgeschlossen. joerg-lohrer.de läuft als SvelteKit-SPA, rendert 18 Nostr-Langform-Posts live aus 5 Relays, Bilder auf 2 Blossom-Servern. Hugo-Altbestand liegt als hugo-archive-Branch eingefroren.

Der Rest sind Feinschliff-Aufgaben.

Was als Nächstes ansteht (priorisiert)

Option A — Repo/Nostr-Konflikt-Management (priorisiert)

Warum jetzt: Es gibt 9 Langform-Events auf Nostr, die keine Markdown-Entsprechung im Repo haben — alle via Client (Habla / Yakihonne) direkt auf Nostr erstellt, zum Teil mit problematischen d-tags (Emojis, Doppelpunkte, Umlaute, Trailing-Dashes, oder leer).

Liste der verwaisten Nostr-Events (d-tag → event-id-Prefix):

d-tag event-id Probleme
richter-oder-rcher-banksy-als-moderner-prophet-vor-dem-high-court bb2c2cea… Umlaut-Abdecker (Rächer → rcher)
die-kraft-der-gemeinschaft-wahre-strke-liegt-nicht-in-strukturen-sondern-in-prozessen 27d7fbee… Umlaut-Abdecker (Stärke → strke)
nostr-und-open-educational-practices-oep- 0baa3615… Trailing-Dash, unschön
religionsbezogene-bildung-mit-rollenkarten:-ki-bilder-als-impulsgeber 3ac719ca… : ungültig für URL-Slug
📢-empowering-learners-for-the-age-of-ai-–-der-neue-review-draft-des-ai-literacy-frameworks-für-schule-ist-da! 3c005996… Emoji + ! + Umlaute + extrem lang
🟠-prompts-für-die-religionsbezogene-bildung-posten-und-diskutieren-auf-nostr f726fcd5… Emoji + Umlaute
ki-mitmachen a1368d2e… sauber, aber fehlt im Repo
bibel-selfies 00cbe5f3… Langform-Version; Duplikat mit Unix-Timestamp wurde bereits gelöscht
"" (leer!) d75857dc… leerer d-tag — SPA-kritisch, Event hat keinen Slug

Zielbild: Repo ist die Quelle der Wahrheit. Jeder Post existiert als Markdown mit sauberem Slug. d-tags sind URL-freundlich (ASCII, keine Sonderzeichen außer -).

Empfohlener Flow (Reihenfolge nicht tauschen!):

  1. Content exportieren. Pro Event: nak req -i <event-id> <relay> → JSON mit Content + Tags. Manuell in neue Markdown-Datei umwandeln (content/posts/<YYYY-MM-DD>-<saubererslug>/index.md). Titel, published_at, ggf. summary und bestehende image-Tags übernehmen. Bilder nach images/ kopieren (falls noch erreichbar), sonst Blossom-URLs im Markdown belassen und beim Publish neu hashen.
  2. Slugs bereinigen. Neue, saubere, ASCII-only d-tags wählen. Doku in docs/redaktion-bild-metadaten.md oder einem neuen docs/nostr-reimport-mapping.md festhalten (alter d-tag → neuer slug).
  3. Neu publizieren. deno task publish --post <slug> pro Datei. Pipeline hasht Bilder zu Blossom, signiert mit stabiler Identität.
  4. Alte Events löschen via NIP-09 (kind:5). Heute noch manuell per nak event -k 5 -t e=<old-event-id>, siehe Option D. Oder: erst Option D bauen, dann diesen Schritt per Pipeline-Subcommand.
  5. Verifikation. Post-Count pro Relay checken, SPA-Post-Liste visuell prüfen.

Edge Cases:

  • Das leere-d-tag-Event (d75857dc…): wenn es noch sinnvoller Content ist, als neuer Post re-importieren. Sonst einfach löschen.
  • Bilder in alten Events zeigen auf externe Server (nicht Blossom). Beim Re-Publish lädt die Pipeline sie herunter und hasht sie neu. Wenn die Quelle tot ist, muss das Bild manuell beschafft oder der Post mit Platzhalter markiert werden.
  • relay.damus.io liefert mehr Events als andere Relays — bei Nicht-Auffindbarkeit auf anderen Relays trotzdem löschen, damus.io respektiert den NIP-09.

Option B — SPA respektiert NIP-09-Deletion-Events

Status: aktuell filtert die SPA nicht nach NIP-09. Wenn ein Event per kind:5-Referenz gelöscht wurde, zeigen Relays es meist nicht mehr aus — aber die SPA würde es trotzdem rendern, falls ein Relay es doch liefert.

Zu tun: im kind:30023-Loader (app/src/lib/nostr/…) einen Cross-Check auf kind:5-Events einbauen. Events, deren Addressable-Pointer (30023:pubkey:d-tag) in einem kind:5 referenziert ist, werden gefiltert. Defensive Maßnahme für zukünftige Duplikate / Soft-Deletes.

Option C — Postfach webmaster@joerg-lohrer.de

User-Task: im All-Inkl KAS als Weiterleitung anlegen. Der Link im Footer und in den Social-Icons zeigt bereits darauf.

Option D — NIP-09-Delete als Pipeline-Subcommand

Status: heute einmalig per nak event -k 5 … mit neu erzeugter Bunker- URL erledigt (Duplikat 1744905463975). Das war ein Workaround um das „already connected"-Problem unserer Pipeline-Signer-Wiederverwendung.

Zu tun: in publish/src/subcommands/ einen delete-Subcommand bauen, der NIP-09 sauber erledigt und unsere stabile Signer-Identität nutzt.

deno task publish-delete --slug <slug>
# oder
deno task publish-delete --event-id <hex>

Sinnvollerweise mit Option A kombinieren — in der Re-Import-Kampagne werden 9 NIP-09 hintereinander gebraucht.

Option E — Pipeline weg von GitHub (self-hosted CI)

Wann: Wenn der Optiplex-Server steht und ein zentraler Ort für Dienste existiert.

Varianten:

  • Cron / systemd-Timer auf dem Optiplex, der alle X Minuten git pull && deno task publish macht. Einfach, minimaler Setup.
  • Woodpecker-CI als Docker-Container neben Forgejo. Volle Push-getriggerte Pipeline ohne GitHub.

Der Pipeline-Code selbst (publish/src/**) ist CI-agnostisch — nur die Trigger-Konfiguration ändert sich.

Option F — Design-Refinements

Wann: irgendwann, wenn Lust drauf ist.

  • Parallax-Effekte, Animations
  • Dark-Mode-Feinschliff (aktuell prefers-color-scheme, könnte Toggle bekommen)
  • Typografie-Experimente (Variable Fonts?)
  • Bildergalerie-Komponente für Posts mit vielen Bildern

Alles nicht-blockierend, die SPA funktioniert solide.

Schnell-Orientierung für die nächste Claude-Session

Lies in dieser Reihenfolge:

  1. docs/STATUS.md (5 min)
  2. docs/HANDOFF.md (= dieses Dokument)
  3. Für CI-Themen: docs/github-ci-setup.md
  4. Für Pipeline-Fragen: docs/superpowers/specs/2026-04-15-publish-pipeline-design.md

Dev-Kommandos

# SPA-Tests
cd app && npm run test:unit
cd app && npm run test:e2e
cd app && npm run check
cd app && npm run dev

# SPA-Build + Deploy
DEPLOY_TARGET=staging ./scripts/deploy-svelte.sh
DEPLOY_TARGET=prod ./scripts/deploy-svelte.sh

# Publish-Pipeline
cd publish && deno task check                          # pre-flight
cd publish && deno task publish --dry-run              # diff-modus simulation
cd publish && deno task publish                        # diff-modus echt
cd publish && deno task publish --force-all            # alle posts
cd publish && deno task publish --post <slug>          # einen post
cd publish && deno task test                           # tests

Bekannte Stolperfallen

  • Amber-Bunker: bei neuer Bunker-URL müssen die zwei Permissions (get_public_key, sign_event) in Amber auf „Allow + Always" gesetzt werden, bevor Publish-Requests verarbeitet werden. Siehe docs/github-ci-setup.md für Details.
  • CLIENT_SECRET_HEX in .env.local identisch mit GitHub-Secret — sorgt dafür, dass sich beide Umgebungen bei Amber mit derselben App anmelden. Rotieren nur bei bewusstem Neu-Pairing in Amber.
  • relay.damus.io bestätigt Events manchmal nicht mit OK. Bekanntes Damus-Verhalten, wird toleriert (MIN_RELAY_ACKS=2, andere 4 Relays sind zuverlässig).
  • Svelte 5 Runes: $props()-Werte via $derived() in lokale Variablen.
  • Hugo-quotierte Dates: date: "2023-02-26" ist ein YAML-String, nicht ein Date-Objekt. validatePost coerced das automatisch; in neuen Posts am besten ohne Quotes schreiben.
  • Deploy-Targets: svelte → Entwicklung, staging → Pre-Prod, prod → joerglohrer26/ (Produktion seit Cutover). Script parst .env.local per awk (wegen Sonderzeichen in FTP-Passwörtern).

Offene UNKNOWN-Einträge zur späteren Recherche

Im VR-Post (content/posts/2021-08-15-virtual-reality/index.md) sind 4 Bilder als license: UNKNOWN / authors: UNKNOWN markiert:

  • 01-immersion-wikipedia.jpg (Wikipedia-Screenshot)
  • 02-mittelalterliche-kirche.jpg (Sketchfab — Lizenz ist CC BY-NC, Fotograf fehlt)
  • 03-avatare-erstellen.jpg (Ready Player Me)
  • 05-pupillendistanz.jpg (EyeMeasure iOS App)

Pipeline loggt Warnungen, publisht aber trotzdem. Recherche-Notizen in docs/redaktion-bild-metadaten.md.

Session-Kontext

Hilfreich beim Wiedereinstieg mit Claude:

  • Branch-Check: git log --oneline -10 main
  • Live-Check: curl -sI https://joerg-lohrer.de/
  • Event-Count Repo vs. Relays: 
    ls content/posts/ | wc -l
nak req -k 30023 -a 4fa5d1c413e2b45e10d40bf3562ab701a5331206e359c90baae0e99bfd6c6e41 wss://relay.edufeed.org 2>/dev/null | jq -s 'length'
  • Pipeline-Tests: cd publish && deno task test

Community-Wiki-Entwürfe

Liegen im Repo, noch nicht extern veröffentlicht:

  • docs/wiki-entwurf-nostr-bild-metadaten.md — DE
  • docs/wiki-draft-nostr-image-metadata.md — EN

Können als NIP-Proposal oder auf nostrbook.dev eingebracht werden, jetzt wo die Konvention in der Praxis validiert ist.