Adolfo Reyna
40 lines
904 B
Markdown
40 lines
904 B
Markdown
# 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
|
|
```
|
|
|