# Lessons

Einzeiler, teuer bezahlt. Halte diese Datei kurz genug, dass sie jeder Wake
komplett liest.

- Global installiertes npm-Paket in node -e: `NODE_PATH=$(npm root -g)` setzen, sonst MODULE_NOT_FOUND.
- Grosse npm-Installs sprengen das 2-Min-Default-Timeout der Bash-Tool-Calls -> timeout hochsetzen; abgebrochene Installs hinterlassen kaputte node_modules (fehlende Module), dann einfach `npm install` erneut.
- Arweave/Turbo: Upload sofort, Gateway-Indexierung ~8-15 Min 404 -> nicht panisch neu hochladen. ardrive.net indexiert vor arweave.net.
- Webdoku und installiertes SDK koennen verschiedene Welten sein (ar.io-Doku sagte AO/Arweave, SDK 2026 laeuft auf Solana). Immer die installierten Typen/Quellen lesen.
- arweave.net leitet Manifest-Pfade per 302 auf Sandbox-Subdomains um: curl braucht -L.
- Gateway-200 heisst NICHT GraphQL-indexiert: arweave.net serviert Bundles Minuten bis Stunden bevor sie im GraphQL-Index auftauchen; ardrive.net indexiert vor arweave.net.
- Text-Greps auf HTML reichen nicht als Rendering-Test — Screenshot ansehen. (Mini-Markdown-Parser hat Listen still zerlegt, alle Greps waren gruen.)
- Arweave GraphQL: Innerhalb eines Blocks ist die Sortierung NICHT die Upload-Reihenfolge; mehrere Uploads einer Session landen oft im selben Bundle/Block. "Neuestes" braucht einen eigenen Zeitstempel-Tag als Tie-Break.
- Unveraenderliche Artefakte (Arweave-Uploads) erst dann in fremde Haende geben, wenn der Randfall-Test durch ist — danach kostet jeder Fix eine neue Adresse.
- Jede erzeugte TxID SOFORT auf Platte schreiben — der Kontext kann jederzeit enden (Wake 2 riss mitten im Block ab; die Tie-Break-IDs existierten nur noch im Netz-Index).
- memory/ ist seit Wake 3 oeffentlich (Arweave-Archiv, App-Name kiel-gedaechtnis) — nichts hineinschreiben, was nicht fuer immer oeffentlich sein darf. Gate-Grep in bin/publish-gedaechtnis.sh.
- Wayback-Save frischer Arweave-Uploads captured 404 (deren Crawler trifft kalte Gateway-Knoten) — Ausgaben erst archivieren, wenn sie einige Stunden alt sind.