Document every repo in Sphinx, catalog PDFs, and verae-ops

Add missing package READMEs, expand Sphinx to all runtime modules, publish a LaTeX/PDF README book, and add verae-ops for Docker, Proxmox, VMs, dedicated hardware, and service linking. Catalog defaults to public PDF links for each module README and samples.
2026-09-11 14:36:17 -04:00 · 2026-09-11 14:36:17 -04:00 · e401635fd6
commit e401635fd6
parent 5ad3222def
222 changed files with 4498 additions and 123 deletions
--- a/docs/modules/verae-zapier-simulator/monitors.md
+++ b/docs/modules/verae-zapier-simulator/monitors.md
@ -0,0 +1,40 @@
+# `verae-zapier-simulator/monitors`
+
+**Package:** `verae-zapier-simulator`  
+**Source:** `packages/verae-zapier-simulator/src/monitors.js`  
+**Lines:** 221
+
+## What this module is
+
+Implementation module in `verae-zapier-simulator`. The tables below are extracted from the source (signatures + JSDoc).
+
+## Exports
+
+`analyze`
+
+## Types / interfaces / classes
+
+_None extracted._
+
+## Functions
+
+| Name | Parameters | Param types (JSDoc) | Returns | Calls (same file / helpers) |
+|------|------------|---------------------|---------|-----------------------------|
+| `analyze` | `events, ctx = {}` | events: `object[]`, ctx: `object` | `unknown` | see Call graph |
+
+## What it imports / requires
+
+_No imports detected._
+
+## Call graph (identifiers invoked)
+
+`check`, `filter`, `startsWith`, `includes`, `keys`, `join`, `broadcast`, `hop`, `analyze`, `push`, `map`, `find`, `some`
+
+Each identifier is a call site in this file. Follow the import list to see the defining module; open that module’s MD for parameter and return types.
+
+## Return values (how to read this)
+
+- HTTP route handlers return Express `res.json(...)` bodies (see route docs).
+- Zapier `perform` functions return a **single object** (creates) or an **array** (triggers/searches).
+- Pricing functions return integer **cents** on `Quote.totalCents`.
+
--- a/docs/modules/verae-zapier-simulator/pipeline.md
+++ b/docs/modules/verae-zapier-simulator/pipeline.md
@ -0,0 +1,58 @@
+# `verae-zapier-simulator/pipeline`
+
+**Package:** `verae-zapier-simulator`  
+**Source:** `packages/verae-zapier-simulator/src/pipeline.js`  
+**Lines:** 883
+
+## What this module is
+
+Implementation module in `verae-zapier-simulator`. The tables below are extracted from the source (signatures + JSDoc).
+
+## Exports
+
+`ACTIONS`, `Simulator`
+
+## Types / interfaces / classes
+
+| Kind | Name |
+|------|------|
+| class | `Simulator` |
+
+## Functions
+
+| Name | Parameters | Param types (JSDoc) | Returns | Calls (same file / helpers) |
+|------|------------|---------------------|---------|-----------------------------|
+| `redact` | `obj` | — | `unknown` | see Call graph |
+| `sleep` | `ms` | — | `unknown` | see Call graph |
+
+## Methods (class / object)
+
+| Name | Parameters |
+|------|------------|
+| `constructor` | `(none)` |
+| `reset` | `(none)` |
+| `snapshot` | `(none)` |
+| `run` | `req` |
+
+## What it imports / requires
+
+- `node:crypto`
+- `../../verae-request-splitter/src/splitRequest.js`
+- `../../verae-archive-worm/src/archive.js`
+- `../../verae-archive-aggregator/src/aggregate.js`
+- `../../verae-tree-node/src/merkle.js`
+- `./trace.js`
+- `./monitors.js`
+
+## Call graph (identifiers invoked)
+
+`setTimeout`, `up`, `app`, `constructor`, `reset`, `snapshot`, `map`, `keys`, `values`, `run`, `emit`, `redact`, `perform`, `signup`, `finish`, `connect`, `edgeAuth`, `meter`, `timestamp`, `lookup`, `batch`, `verify`, `assign`, `analyze`, `randomUUID`, `replace`, `slice`, `push`, `authentication`, `at`, `find`, `splitRequest`, `archivePuts`, `get`, `net`, `maybeDelay`, `seal`, `toISOString`, `queryArchives`, `mergeReceipts`, `filter`, `sha256Hex`, `toLowerCase`, `test`, `verifyProof`, `isArray`, `split`, `trim`, `buildMerkle`, `shardIndex`, `merkleProof`, `put`, `endsWith`, `query`, `includes`, `aggregateAttached`, `set`, `now`, `sleep`
+
+Each identifier is a call site in this file. Follow the import list to see the defining module; open that module’s MD for parameter and return types.
+
+## Return values (how to read this)
+
+- HTTP route handlers return Express `res.json(...)` bodies (see route docs).
+- Zapier `perform` functions return a **single object** (creates) or an **array** (triggers/searches).
+- Pricing functions return integer **cents** on `Quote.totalCents`.
+
--- a/docs/modules/verae-zapier-simulator/server.md
+++ b/docs/modules/verae-zapier-simulator/server.md
@ -0,0 +1,45 @@
+# `verae-zapier-simulator/server`
+
+**Package:** `verae-zapier-simulator`  
+**Source:** `packages/verae-zapier-simulator/src/server.js`  
+**Lines:** 87
+
+## What this module is
+
+Implementation module in `verae-zapier-simulator`. The tables below are extracted from the source (signatures + JSDoc).
+
+## Exports
+
+_No named `export` / `module.exports` keys detected._
+
+## Types / interfaces / classes
+
+_None extracted._
+
+## Functions
+
+| Name | Parameters | Param types (JSDoc) | Returns | Calls (same file / helpers) |
+|------|------------|---------------------|---------|-----------------------------|
+| `send` | `res, code, body, type = 'application/json; charset=utf-8'` | — | `unknown` | see Call graph |
+| `readBody` | `req` | — | `unknown` | see Call graph |
+
+## What it imports / requires
+
+- `node:http`
+- `node:fs`
+- `node:path`
+- `node:url`
+- `./pipeline.js`
+
+## Call graph (identifiers invoked)
+
+`dirname`, `fileURLToPath`, `join`, `send`, `stringify`, `writeHead`, `end`, `readBody`, `on`, `push`, `concat`, `toString`, `resolve`, `parse`, `reject`, `createServer`, `async`, `snapshot`, `reset`, `run`, `normalize`, `startsWith`, `existsSync`, `statSync`, `isDirectory`, `extname`, `createReadStream`, `pipe`, `listen`, `write`
+
+Each identifier is a call site in this file. Follow the import list to see the defining module; open that module’s MD for parameter and return types.
+
+## Return values (how to read this)
+
+- HTTP route handlers return Express `res.json(...)` bodies (see route docs).
+- Zapier `perform` functions return a **single object** (creates) or an **array** (triggers/searches).
+- Pricing functions return integer **cents** on `Quote.totalCents`.
+
--- a/docs/modules/verae-zapier-simulator/trace.md
+++ b/docs/modules/verae-zapier-simulator/trace.md
@ -0,0 +1,48 @@
+# `verae-zapier-simulator/trace`
+
+**Package:** `verae-zapier-simulator`  
+**Source:** `packages/verae-zapier-simulator/src/trace.js`  
+**Lines:** 45
+
+## What this module is
+
+Implementation module in `verae-zapier-simulator`. The tables below are extracted from the source (signatures + JSDoc).
+
+## Exports
+
+`TraceBus`
+
+## Types / interfaces / classes
+
+| Kind | Name |
+|------|------|
+| class | `TraceBus` |
+
+## Functions
+
+_No top-level functions extracted._
+
+## Methods (class / object)
+
+| Name | Parameters |
+|------|------------|
+| `constructor` | `(none)` |
+| `now` | `(none)` |
+| `emit` | `e` |
+
+## What it imports / requires
+
+_No imports detected._
+
+## Call graph (identifiers invoked)
+
+`constructor`, `now`, `emit`, `push`
+
+Each identifier is a call site in this file. Follow the import list to see the defining module; open that module’s MD for parameter and return types.
+
+## Return values (how to read this)
+
+- HTTP route handlers return Express `res.json(...)` bodies (see route docs).
+- Zapier `perform` functions return a **single object** (creates) or an **array** (triggers/searches).
+- Pricing functions return integer **cents** on `Quote.totalCents`.
+