monitoring: global #NNN, progress bar, secrets.env, yellow WARN

scripts/taler-monitoring/README.md

@@ -24,25 +24,45 @@ End of each phase: totals + list of **BLOCKERS** and **ERRORS** (ids included).
 
 ## Secrets (local GOA e2e)
 
-`check_e2e.sh` loads bank/merchant passwords from **koopa-admin-secrets**
-(not this repo). Search order:
+**Do not commit passwords.** Canonical trees: `~/src/koopa/koopa-admin-log` +
+sibling `~/src/koopa/koopa-admin-secrets`.
 
-1. `SECRETS_ROOT` → `…/taler-bank/bank-admin-password.txt`
-2. `KOOPA_ADMIN_SECRETS` → `$KOOPA_ADMIN_SECRETS/koopa/host-root/…`
-3. Sibling of this checkout: `../koopa-admin-secrets/koopa/host-root`
-4. `$HOME/taler/src/koopa-admin-secrets/koopa/host-root` (common laptop layout)
-5. `$HOME/.config/taler-landing/bank-admin-password.txt`
-6. SSH koopa: `/root/bank-admin-password.txt` or podman bank container
-
-If you keep admin-log at `~/koopa-admin-log` but secrets under `~/taler/src/…`:
+### Local file (recommended on laptop)
 
 ```bash
-export SECRETS_ROOT="$HOME/taler/src/koopa-admin-secrets/koopa/host-root"
-# or: export KOOPA_ADMIN_SECRETS="$HOME/taler/src/koopa-admin-secrets"
+cd ~/src/koopa/koopa-admin-log/scripts/taler-monitoring
+cp secrets.env.example secrets.env   # gitignored
+$EDITOR secrets.env
 ./taler-monitoring.sh e2e
 ```
 
-Or one-shot: `E2E_BANK_ADMIN_PASS=… E2E_MERCHANT_TOKEN=… ./taler-monitoring.sh e2e`
+See **[secrets.env.example](./secrets.env.example)** for every variable that
+may appear (admin pass, merchant token, SECRETS_ROOT, progress knobs).
+
+### Search order
+
+1. Already-exported env (`E2E_BANK_ADMIN_PASS`, …)
+2. `secrets.env` next to this suite (`MONITORING_SECRETS_ENV=` override)
+3. `SECRETS_ROOT` / `KOOPA_ADMIN_SECRETS` file tree
+4. Sibling `../koopa-admin-secrets/koopa/host-root`
+5. `$HOME/src/koopa/koopa-admin-secrets/koopa/host-root`
+6. `$HOME/.config/taler-landing/bank-admin-password.txt`
+7. SSH koopa `/root/…` or bank container
+
+### Line IDs + progress
+
+Each check prints **global** and **grouped** ids:
+
+```text
+┌ OK    ┐ #014  www.exchange-03  exchange /config · HTTP 200
+┌ WARN  ┐ #015  www.stats-02     stats age soft  · yellow badge (not red)
+┌ PROG  ┐ ████████░░░░  42%  14/55
+```
+
+- `#014` — run-wide counter (whole `./taler-monitoring.sh` invocation)  
+- `www.exchange-03` — area.group-NN  
+- **WARN** badge = **yellow**; **ERROR** = **red** only  
+- Progress: auto estimate per phase, or `PROGRESS_TOTAL=N` / `PROGRESS_OFF=1`
 
 ## Commands