docs: update CLI and REST API docs for unified health status (smart-mcp-proxy#204)

Updated documentation to reflect the new unified health status feature:

- CLI management commands: Updated output format showing new columns
  (STATUS, ACTION) and health status emojis (✅ ⚠️ ❌ ⏸️ 🔒)
- REST API: Added `health` object to GET /api/v1/servers response
  with fields: level, admin_state, summary, detail, action

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: Dumbris

docs/api/rest-api.md

@@ -64,24 +64,58 @@ Get server status and statistics.
 
 #### GET /api/v1/servers
 
-List all upstream servers.
+List all upstream servers with unified health status.
 
 **Response:**
 ```json
 {
-  "servers": [
-    {
-      "name": "github-server",
-      "protocol": "http",
-      "enabled": true,
-      "connected": true,
-      "quarantined": false,
-      "tools_count": 15
-    }
-  ]
+  "success": true,
+  "data": {
+    "servers": [
+      {
+        "name": "github-server",
+        "protocol": "http",
+        "enabled": true,
+        "connected": true,
+        "quarantined": false,
+        "tool_count": 15,
+        "health": {
+          "level": "healthy",
+          "admin_state": "enabled",
+          "summary": "Connected (15 tools)",
+          "action": ""
+        }
+      },
+      {
+        "name": "oauth-server",
+        "protocol": "http",
+        "enabled": true,
+        "connected": false,
+        "quarantined": false,
+        "tool_count": 0,
+        "health": {
+          "level": "unhealthy",
+          "admin_state": "enabled",
+          "summary": "Token expired",
+          "detail": "OAuth access token has expired",
+          "action": "login"
+        }
+      }
+    ]
+  }
 }
 ```
 
+**Health Object Fields:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `level` | string | Health level: `healthy`, `degraded`, or `unhealthy` |
+| `admin_state` | string | Admin state: `enabled`, `disabled`, or `quarantined` |
+| `summary` | string | Human-readable status message |
+| `detail` | string | Optional additional context about the status |
+| `action` | string | Suggested remediation: `login`, `restart`, `enable`, `approve`, `view_logs`, or empty |
+
 #### POST /api/v1/servers/{name}/enable
 
 Enable a server.

docs/cli-management-commands.md

@@ -41,11 +41,26 @@ mcpproxy upstream list --log-level=debug
 
 **Output Fields:**
 - NAME - Server name
-- ENABLED - Whether server is enabled
-- PROTOCOL - Transport protocol (stdio, http, sse)
-- CONNECTED - Connection status
+- PROTOCOL - Transport protocol (stdio, http, sse, streamable-http)
 - TOOLS - Number of available tools
-- STATUS - Current status or error message
+- STATUS - Unified health status with emoji indicator and summary
+- ACTION - Suggested remediation command (if applicable)
+
+**Status Indicators:**
+- ✅ Healthy - Server connected and working
+- ⚠️ Degraded - Server has warnings (e.g., token expiring soon)
+- ❌ Unhealthy - Server has errors or not functioning
+- ⏸️ Disabled - Server manually disabled by user
+- 🔒 Quarantined - Server pending security approval
+
+**Example Output:**
+```
+NAME                      PROTOCOL   TOOLS      STATUS                         ACTION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅    github-server           http       15         Connected (15 tools)           -
+❌    oauth-server            http       0          Token expired                  auth login --server=oauth-server
+⏸️    disabled-server         stdio      0          Disabled by user               upstream enable disabled-server
+```
 
 ---
 

docs/cli/management-commands.md

@@ -43,12 +43,19 @@ mcpproxy upstream restart failing-srv
 mcpproxy upstream list
 ```
 
-Output shows:
-- Server name
-- Connection status
-- Protocol type
-- Enabled/disabled state
+Output shows unified health status:
+- Server name and protocol type
 - Tool count
+- Health status with emoji indicator (✅ healthy, ⚠️ degraded, ❌ unhealthy, ⏸️ disabled, 🔒 quarantined)
+- Suggested action command when applicable
+
+Example output:
+```
+NAME                      PROTOCOL   TOOLS      STATUS                         ACTION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅    github-server           http       15         Connected (15 tools)           -
+❌    oauth-server            http       0          Token expired                  auth login --server=oauth-server
+```
 
 ### View Logs