docs(clients): document make google-live and the opt-in live checks

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-25 07:27:24 +01:00
co-authored by Claude Sonnet 5.5
parent 248bdc221a
commit 865ce89784
2 changed files with 98 additions and 46 deletions
+3 -1
View File
@@ -60,7 +60,9 @@ client, credentials, errors, or caps.
Tokens expire after about an hour; refresh is the caller's job (gap).
- Test runs set `MOLO_ENV_FILES=off`: config files are ignored so a developer's
`.env.json.local` cannot change test outcomes. `MOLO_LIVE_NET=1` re-enables
them for the opt-in live checks.
them for the opt-in live checks. `make google-live` is the entry point: it
mints a service-account token (`build/google/sa-token`), exports it as
`GOOGLE_ACCESS_TOKEN`, and runs the full suite with `MOLO_LIVE_NET=1`.
- No key: `configured()` is false and every call throws `NotConfiguredError`
(HTTP 503, status `NOT_CONFIGURED`) before any network traffic. Loud, not
silent.