From fa2b92bb00c290a22675c0532e1b66b19be036f7 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 17 Jan 2026 01:14:17 +0000
Subject: [PATCH] docs: update health/status + doctor docs

---
 CHANGELOG.md           | 2 ++
 docs/cli/health.md     | 4 ++++
 docs/cli/status.md     | 3 +++
 docs/gateway/doctor.md | 1 +
 4 files changed, 10 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 840ee1826..f38647659 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,6 +24,7 @@
 - Cron: isolated cron jobs now start a fresh session id on every run to prevent context buildup.
 - Docs: add `/help` hub, Node/npm PATH guide, and expand directory CLI docs.
 - Config: support env var substitution in config values. (#1044) — thanks @sebslight.
+- Health: add per-agent session summaries and account-level health details, and allow selective probes. (#1047) — thanks @gumadeiras.
 
 ### Fixes
 - Messages: `/stop` now hard-aborts queued followups and sub-agent runs; suppress zero-count stop notes.
@@ -38,6 +39,7 @@
 - Signal/iMessage: bound transport readiness waits to 30s with periodic logging. (#1014) — thanks @Szpadel.
 - OpenAI image-gen: remove deprecated `response_format` and use URL downloads.
 - CLI: auto-update global installs when installed via a package manager.
+- Routing: migrate legacy `accountID` bindings to `accountId` and remove legacy fallback lookups. (#1047) — thanks @gumadeiras.
 - Discord: truncate skill command descriptions to 100 chars for slash command limits. (#1018) — thanks @evalexpr.
 - Security: bump `tar` to 7.5.3.
 - Models: align ZAI thinking toggles.
diff --git a/docs/cli/health.md b/docs/cli/health.md
index f1508c03c..bdb85c347 100644
--- a/docs/cli/health.md
+++ b/docs/cli/health.md
@@ -11,5 +11,9 @@ Fetch health from the running Gateway.
 ```bash
 clawdbot health
 clawdbot health --json
+clawdbot health --verbose
 ```
 
+Notes:
+- `--verbose` runs live probes and prints per-account timings when multiple accounts are configured.
+- Output includes per-agent session stores when multiple agents are configured.
diff --git a/docs/cli/status.md b/docs/cli/status.md
index 71e111ed9..98d0288bd 100644
--- a/docs/cli/status.md
+++ b/docs/cli/status.md
@@ -16,3 +16,6 @@ clawdbot status --deep
 clawdbot status --usage
 ```
 
+Notes:
+- `--deep` runs live probes (WhatsApp Web + Telegram + Discord + Slack + Signal).
+- Output includes per-agent session stores when multiple agents are configured.
diff --git a/docs/gateway/doctor.md b/docs/gateway/doctor.md
index 78baa8f75..0574566b0 100644
--- a/docs/gateway/doctor.md
+++ b/docs/gateway/doctor.md
@@ -112,6 +112,7 @@ Current migrations:
 - `routing.agents`/`routing.defaultAgentId` → `agents.list` + `agents.list[].default`
 - `routing.agentToAgent` → `tools.agentToAgent`
 - `routing.transcribeAudio` → `tools.audio.transcription`
+- `bindings[].match.accountID` → `bindings[].match.accountId`
 - `identity` → `agents.list[].identity`
 - `agent.*` → `agents.defaults` + `tools.*` (tools/elevated/exec/sandbox/subagents)
 - `agent.model`/`allowedModels`/`modelAliases`/`modelFallbacks`/`imageModelFallbacks`