# dev-overview

[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)

Developer map of the Verae Time × Zapier **NATS message fabric**: what was designed, what is actually running on...

**Forgejo:** https://git.georgelambert.org/marchon/dev-overview  
**SSH:** `ssh://git@git.georgelambert.org:2223/marchon/dev-overview.git`  
**Catalog:** https://zapier.georgelambert.org/packages/dev-overview/  
**Date:** 2026-09-14  

Zapier cloud **never** connects to NATS. It talks HTTPS to `https://zap.zapier.georgelambert.org` (access-zapier) then middleware. `api.veraetime.net` is **HTTPS only** — middleware is the NATS client.

## Contents

| Doc | What |
|-----|------|
| [00-sources.md](00-sources.md) | Every other doc that names a NATS address or TCP route |
| [01-nats-routes.md](01-nats-routes.md) | Transport ports + every `verae.*` address: designed vs running |
| [02-endpoint-io.md](02-endpoint-io.md) | Per-address: purpose, inbound from, outbound to, how to connect Verae API |
| [03-zapier-verae-path.md](03-zapier-verae-path.md) | Zapier → middleware → Verae timestamp server → poll → events → Zapier |
| [04-gaps-and-finish.md](04-gaps-and-finish.md) | Modules not connected; billing/event/aux; ordered finish list |
| [05-developer-credentials.md](05-developer-credentials.md) | URLs, tokens, lab API keys, staff/IAM, git, env cheat sheet |

## Cluster (running)

```text
nats://10.10.10.21:4222,nats://10.10.10.22:4222,nats://10.10.10.23:4222
```

JetStream streams (replicas=3, file): `ZAPIER_JOBS`, `ZAPIER_EVENTS`, `ZAPIER_WEBHOOKS`, `ZAPIER_USAGE`, `VERAE_ARCHIVE`.

Public token-gated **client** edge (not cluster routes): `nats://<token>@70.88.205.138:4222`, `wss://nats.zapier.georgelambert.org`. Do not put this in Zapier.

## Install

```sh
git clone ssh://git@git.georgelambert.org:2223/marchon/dev-overview.git
cd dev-overview
```

## Usage

```sh
# No single entrypoint is declared in this tree.
ls
```

## Contributing

Questions: open an issue at https://git.georgelambert.org/marchon/dev-overview/issues. Pull requests are accepted.

## License

UNLICENSED © George Lambert