marchon/master-zapier-plan-draft
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
Verae Time x Zapier monorepo plan draft
17 commits 2 branches 0 tags 64 MiB
Find a file
George Lambert b325f6f697
Some checks are pending
offline / test (push) Waiting to run
Details
Spread fleet replicas across extra machines and show message RTT percentiles 
machines.json plus Add-machine UI place copies on the least-loaded host.
Monitor samples processing RTT and displays min, avg, p50, and p90 for
capacity planning. Remote hosts run src/agent.js.
2026-09-11 13:25:05 -04:00
.github/workflows Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
docs Spread fleet replicas across extra machines and show message RTT percentiles 2026-09-11 13:25:05 -04:00
harness Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
packages Spread fleet replicas across extra machines and show message RTT percentiles 2026-09-11 13:25:05 -04:00
research Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
scripts Add fleet control: service configs, replica floors, monitor, pause/restart 2026-09-11 13:09:55 -04:00
vendor Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
.gitignore Publish docs site for zapier.georgelambert.org and archive-NATS design 2026-09-11 12:23:23 -04:00
package.json Publish docs site for zapier.georgelambert.org and archive-NATS design 2026-09-11 12:23:23 -04:00
README.MD Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00
restart.sh Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
TODO.md Milestone 3: NATS wait (gate 9), hash lookup, zappier timestamp, NS1 tunnel 2026-09-09 02:54:02 -04:00

README.MD

Verae Time × Zapier

Workspace that composes two existing systems and the official Zapier Platform SDK:

  1. packages/zappier — custom pricing, API keys, customer portal, admin, Stripe, invoices.
  2. packages/verae-zapier-middleware — timestamp adapter to api.veraetime.net (or MOCK_VERAE) plus NATS workers.
  3. packages/verae-zapier — Zapier Platform CLI app.
  4. vendor/zapier-platform — upstream CLI/core/schema/examples (reference).
  5. research/zapier — vendor research, scrapes, cloned Zapier repos, playbooks (research/README.md).

They are imported, not yet wired. Public Zapier traffic should eventually hit zappier (x-api-key), which meters the call and proxies to the Verae middleware. See docs/02-architecture/composition.md.

Original brief (features a–m): docs/00-sources/workspace-brief.md.
Where each tree came from: docs/00-sources/provenance.md.

Tomorrow morning: docs/04-activate/SETUP-ZAPIER-DEVELOPER.md — create a Zapier developer account and push Add Numbers.

Quick start

# Billing platform (portal :3000, admin, /docs)
cd packages/zappier && npm install && npm test && npm run dev

# Verae middleware (HTTP :3100, optional NATS)
cd packages/verae-zapier-middleware && npm install
cd ../.. && npm run gate:0

Gates (npm run gate:N) continue the middleware plan in TODO.md. Phases 0–8, 10, 11 already passed in the source tree; 9 and 12+ are still open. Path prefixes now use packages/.

Documentation map

Doc Contents
docs/01-product/features-a-m.md Requested Zapier surface vs owners
docs/01-product/api-gap-analysis.md Live Verae OpenAPI vs a–m
docs/01-product/billing-and-keys.md Keys, rate card, invoices
docs/02-architecture/overview.md Adapter internals (imported)
docs/03-zapier/operations.md Platform nouns
research/README.md Imported Zapier vendor research
docs/04-activate/SETUP-ZAPIER-DEVELOPER.md Morning: Zapier developer account + push Add Numbers
docs/modules/README.md Per-module API sheets (params, callees, returns)
docs/models/README.md Data models
docs/sphinx/_build/html/index.html Sphinx HTML (rebuild: npm run docs:sphinx)

Environment (middleware)

Variable Default Purpose
PORT 3100 Middleware HTTP
VERAE_API_BASE_URL http://localhost:8080 Upstream Verae
MOCK_VERAE false Local mock of Verae HTTP
NATS_ENABLED false JetStream workers vs in-process poller

Zappier uses PORT (3000), ZAPPIER_DB, ADMIN_KEY, STRIPE_SECRET_KEY — see packages/zappier/README.md.