brain backup 2026-09-14

2026-09-14 22:38:47 -04:00
parent ca346cc6e7
commit f0ead4f6fa
147 changed files with 73451 additions and 8 deletions
@@ -0,0 +1,39 @@
+# Colanode Hermes Bridge
+
+Standalone Node 22 TypeScript service that listens to Colanode synchronizer events and replies through Hermes only when a new Colanode `message` node explicitly mentions the bot user.
+
+## Safety
+
+- Reads secrets from `$HOME/.hermes/secrets/colanode-family-bot.env`.
+- Requires that secret file to be mode `0600`.
+- Uses Colanode client HTTP/WebSocket APIs only.
+- Does not write to Postgres, Hermes config, Caddy, Colanode deployment files, or Colanode data outside the documented mutation API.
+- Tests never send Colanode replies.
+
+## Secret File
+
+Expected variables:
+
+```sh
+COLANODE_TOKEN=...
+# Optional fallback only if a stored token is unavailable:
+COLANODE_EMAIL=bot@example.com
+COLANODE_PASSWORD=...
+```
+
+Optional overrides are shown in `.env.example`.
+
+## Commands
+
+```sh
+npm install
+npm run build
+npm test
+```
+
+Run foreground service after build:
+
+```sh
+npm start
+```
+