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
29 commits 2 branches 0 tags 93 MiB
Find a file
George Lambert ddf772454b
Some checks are pending
offline / test (push) Waiting to run
Details
Clean prepaid SoT, identity mailbox, public access planes, leaf policy, fleet spawn 
Persist account-balance books; edge caches prepaid from books. Add zappier-identity, verae-nats-accounts, verae-jobs-events, verae-access-staff, zapier-decisions. Edge binds loopback; lan-134 stays off; HTTP services prefer local spawn.
2026-09-11 17:15:16 -04:00
.github/workflows Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
docs Clean prepaid SoT, identity mailbox, public access planes, leaf policy, fleet spawn 2026-09-11 17:15:16 -04:00
harness Keep-going: tree shares, health flags, CI, compose, timestamp Zapier action 2026-09-09 03:02:08 -04:00
packages Clean prepaid SoT, identity mailbox, public access planes, leaf policy, fleet spawn 2026-09-11 17:15:16 -04:00
research Milestone 0: import zappier billing, Verae middleware, and Zapier research 2026-09-09 02:37:36 -04:00
scripts Clean prepaid SoT, identity mailbox, public access planes, leaf policy, fleet spawn 2026-09-11 17:15:16 -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 Document every repo in Sphinx, catalog PDFs, and verae-ops 2026-09-11 14:36:17 -04:00
README.MD Fix catalog PDF links; add bring-online guide; feature zappier billing 2026-09-11 14:59:13 -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/.

Bring online: https://zapier.georgelambert.org/packages/verae-ops/GETTING-STARTED.pdf
Live catalog (PDF default): https://zapier.georgelambert.org/ · Markdown indexes
Billing / users (zappier-edge): https://zapier.georgelambert.org/packages/zappier/docs/USER-MANUAL.pdf
Sphinx: https://zapier.georgelambert.org/sphinx/ · LaTeX PDF

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.