Refresh docs-master with Forgejo URLs and NATS.md for every module
Some checks are pending
offline / test (push) Waiting to run

HTTPS-only packages (zappier, activate, zapier-app) now state they do
not subscribe to NATS. Catalog build copies docs-master onto the site.
This commit is contained in:
George Lambert 2026-09-11 12:38:55 -04:00
parent 8f9707a3b7
commit 392fe7bb15
8 changed files with 90 additions and 5 deletions

View file

@ -1,21 +1,44 @@
# zapier-docs-master
Summaries and NATS interaction map for every Verae Time × Zapier module.
Summaries, NATS contracts, and message flows for every Verae Time × Zapier module.
**Live HTML:** https://zapier.georgelambert.org/
**Live catalog:** https://zapier.georgelambert.org/
**Monorepo:** https://git.georgelambert.org/marchon/master-zapier-plan-draft (`main` and `master`)
**Monorepo:** https://git.georgelambert.org/marchon/master-zapier-plan-draft
## Git repos (Forgejo on NS1)
| Repo | URL |
|------|-----|
| master-zapier-plan-draft | https://git.georgelambert.org/marchon/master-zapier-plan-draft |
| zappier-edge | https://git.georgelambert.org/marchon/zappier-edge |
| verae-middleware | https://git.georgelambert.org/marchon/verae-middleware |
| verae-zapier-app | https://git.georgelambert.org/marchon/verae-zapier-app |
| verae-activate | https://git.georgelambert.org/marchon/verae-activate |
| verae-request-splitter | https://git.georgelambert.org/marchon/verae-request-splitter |
| verae-archive-worm | https://git.georgelambert.org/marchon/verae-archive-worm |
| verae-archive-aggregator | https://git.georgelambert.org/marchon/verae-archive-aggregator |
| **zapier-docs-master** (this repo) | https://git.georgelambert.org/marchon/zapier-docs-master |
Clone (SSH port 2223):
`git clone ssh://git@git.georgelambert.org:2223/marchon/<name>.git`
## Modules
| Module | Summary | NATS in | NATS out |
|--------|---------|---------|----------|
| zappier-edge | Metered HTTPS for Zapier | — | — (HTTPS to middleware) |
| verae-middleware | Job id + wait HTTP | jobs.events | jobs.watch, archive.query via aggregator |
| verae-middleware | Job id + wait HTTP | jobs.events | jobs.watch |
| verae-activate | Pushable Zapier app | — | — |
| verae-zapier-app | Full Zapier nouns | — | — |
| request-splitter | Hash vs files | — | archive.put |
| archive-worm | Bloom WORM node | archive.query, archive.put | archive.reply.* (hit only) |
| archive-aggregator | Merge archive replies | archive.reply.* | archive.query |
Full contracts: `../docs/02-architecture/modules-and-nats.md` and `archive-nats.md` in the monorepo / on the website.
## Documents in this repo
- [MESSAGE-FLOWS.md](MESSAGE-FLOWS.md) — numbered request paths
- [modules-and-nats.md](modules-and-nats.md) — address table
- [archive-nats.md](archive-nats.md) — bloom / multi-receipt design
- [composition.md](composition.md) — HTTPS hops
- `modules/<name>/SUMMARY.md` and `NATS.md`

View file

@ -0,0 +1,10 @@
# NATS — verae-activate
This Zapier Platform app **does not use NATS**.
| Direction | Address | Peer | Body |
|-----------|---------|------|------|
| IN | Zapier UI / runtime | user Zap | `number1`, `number2`, `text`, `data` / `sha256` |
| OUT HTTPS (optional) | zappier-edge `/v1/add` or `/v1/timestamp` | only if `api_base` + `api_key` set | JSON |
Blank connection fields → local compute only.

View file

@ -0,0 +1,10 @@
# NATS — verae-zapier-app
This Zapier Platform app **does not use NATS**.
| Direction | Address | Peer | Body |
|-----------|---------|------|------|
| IN | Zapier runtime | user Zap | create/search/trigger fields |
| OUT HTTPS | middleware `/zapier/v1/timestamp`, `/wait`, `/verify`, `/status/{id}`, `/hashes/{sha256}`, REST Hook subscribe | verae-middleware | Bearer `zmw_` |
Job completion is a REST Hook HTTP POST from webhook-deliver, not a NATS client in Zapier.

View file

@ -0,0 +1,10 @@
# NATS — zappier-edge
This process **does not subscribe or publish** on NATS.
| Direction | Address | Peer | Body |
|-----------|---------|------|------|
| IN HTTPS | `/v1/*` | Zapier Platform app | JSON + `x-api-key` |
| OUT HTTPS | middleware `/zapier/v1/*` | verae-middleware | same tenant request |
NATS is private to middleware workers and archives.