wiki: bootstrap gateway wiki — v2.11.0 SSE subscriptions + lifecycle frames
Adds six developer-facing pages covering the gateway's role,
SSE channel, the new subscription endpoint and Python Firestore
sidecar (v2.11.0), env configuration, and deployment.
Pages:
- Home.md: what the gateway owns vs does not own, page index.
- _Sidebar.md: navigation.
- architecture.md: module map (auth, graphql, sse, callbacks,
playbook_state, firestore_subscriptions, request_store,
proxy, session_cache); request-flow examples for
authenticated execution, Firestore subscription, and
lifecycle push.
- sse-events.md: GET /events channel, full frame catalog
(message init, ping, playbook/result, playbook/progress,
playbook/state in v2.11.0, subscription/event in v2.11.0),
payload schemas, reconnection notes.
- subscriptions.md: POST/DELETE /api/subscriptions/firestore,
the Python sidecar architecture (one process per pod,
JSON-line IPC), credential provisioning recipe, what the
endpoint is not (no writes, no replacement for security
rules).
- configuration.md: env var reference grouped by concern;
classification of what is platform-runtime vs business-logic
per the secrets-and-credentials rule.
- deployment.md: build (cargo, container, crate), k8s
manifests, Firestore credential provisioning,
Cloudflare Tunnel, health checks, roll forward / back.
Cross-links to the ephemeral_blueprints architecture doc,
the ops wiki for the GKE install, and the travel wiki for the
consumer side.