# 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
```