Merge branch 'master' into feat/execute-code-tool

Author: kingpanther13

.claude/skills/wt/SKILL.md

@@ -13,17 +13,20 @@ Create a new worktree in `worktree/<branch-name>` with branch `<branch-name>`.
 
 ```bash
 # Return to repo root
-cd /home/julien/github/ha-mcp
+cd "$(git rev-parse --show-toplevel)"
 
 # Pull latest master
 git checkout master
 git pull origin master
 
 # Create worktree
-git worktree add worktree/$ARGUMENTS -b $ARGUMENTS
+git worktree add worktree/"$ARGUMENTS" -b "$ARGUMENTS"
+
+# Initialize submodules (skills-vendor)
+git -C worktree/"$ARGUMENTS" submodule update --init --recursive
 
 # Navigate to worktree
-cd worktree/$ARGUMENTS
+cd worktree/"$ARGUMENTS"
 
 # Confirm location and branch
 echo ""
@@ -37,5 +40,5 @@ echo "You can now work in this isolated environment."
 ## Notes
 
 - Worktree inherits `.claude/agents/` workflows
-- To remove when done: `cd ../.. && git worktree remove worktree/$ARGUMENTS`
+- To remove when done: `cd ../.. && git worktree remove worktree/"$ARGUMENTS"`
 - List all worktrees: `git worktree list`

README.md

@@ -148,7 +148,7 @@ Spend less time configuring, more time enjoying your smart home.
 | **Groups** | `ha_config_list_groups`, `ha_config_remove_group`, `ha_config_set_group` |
 | **HACS** | `ha_hacs_add_repository`, `ha_hacs_download`, `ha_hacs_info`, `ha_hacs_list_installed`, `ha_hacs_repository_info`, `ha_hacs_search` |
 | **Helper Entities** | `ha_config_list_helpers`, `ha_config_remove_helper`, `ha_config_set_helper`, `ha_get_helper_schema`, `ha_set_config_entry_helper` |
-| **History & Statistics** | `ha_get_automation_traces`, `ha_get_history`, `ha_get_logbook`, `ha_get_statistics` |
+| **History & Statistics** | `ha_get_automation_traces`, `ha_get_history`, `ha_get_logs`, `ha_get_statistics` |
 | **Integrations** | `ha_delete_config_entry`, `ha_get_integration`, `ha_set_integration_enabled` |
 | **Labels & Categories** | `ha_config_get_category`, `ha_config_get_label`, `ha_config_remove_category`, `ha_config_remove_label`, `ha_config_set_category`, `ha_config_set_label` |
 | **Scripts** | `ha_config_get_script`, `ha_config_remove_script`, `ha_config_set_script` |
@@ -253,6 +253,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - **[@smenzer](https://github.com/smenzer)** — Documentation fix.
 - **[@The-Greg-O](https://github.com/The-Greg-O)** — REST API for config entry deletion.
 - **[@restriction](https://github.com/restriction)** — Responsible disclosure: python_transform sandbox missing call target validation.
+- **[@lcrostarosa](https://github.com/lcrostarosa)** — Diagnostic and health monitoring tools concept (#675), inspiring system/error logs, repairs, and ZHA radio metrics integration.
 
 ---
 

homeassistant-addon/DOCS.md

@@ -388,7 +388,7 @@ The add-on provides 80+ MCP tools for controlling Home Assistant:
 - `ha_backup_restore` - Restore from backup
 
 ### Utility
-- `ha_get_logbook` - Historical events
+- `ha_get_logs` - Logs (logbook, system, error, supervisor)
 - `ha_eval_template` - Evaluate Jinja2 templates
 - Domain documentation available via the `ha_get_skill_home_assistant_best_practices` skill
 - `ha_get_integration` - List or get integration info

site/package-lock.json

@@ -731,8 +731,8 @@
   },
   {
     "name": "ha_get_device",
-    "title": "Get Device",
-    "description": "Get device information - list all devices or get details for a specific one.\n\nWithout device_id/entity_id: Lists all devices with optional filters.\nWith device_id or entity_id: Returns detailed info for that specific device.\n\n**List all devices:**\n- All devices: ha_get_device()\n- By area: ha_get_device(area_id=\"living_room\")\n- By manufacturer: ha_get_device(manufacturer=\"Philips\")\n- By integration: ha_get_device(integration=\"zigbee2mqtt\")\n- Combined filters: ha_get_device(integration=\"zha\", area_id=\"kitchen\")\n\n**Single device lookup:**\n- By device_id: ha_get_device(device_id=\"abc123\")\n- By entity_id: ha_get_device(entity_id=\"light.living_room\")\n\n**Zigbee automation tips:**\n- ZHA triggers: Use `ieee_address` for zha_event triggers\n- Z2M triggers: Use `friendly_name` for MQTT topics (zigbee2mqtt/{friendly_name}/action)\n\n**Returns (list mode):**\n- List of devices with device_id, name, manufacturer, model, area_id\n\n**Returns (single device):**\n- Full device details including integration_type, ieee_address, entities",
+    "title": "Get Device (incl. Zigbee/ZHA/Z2M and Z-Wave)",
+    "description": "Get device information, including Zigbee (ZHA/Z2M) and Z-Wave JS devices with protocol-specific details.\n\nWithout device_id/entity_id: Lists all devices with optional filters.\nWith device_id or entity_id: Returns detailed info for that specific device.\n\n**List all devices:**\n- All devices: ha_get_device()\n- By area: ha_get_device(area_id=\"living_room\")\n- By manufacturer: ha_get_device(manufacturer=\"Philips\")\n- By integration: ha_get_device(integration=\"zigbee2mqtt\")\n- Combined filters: ha_get_device(integration=\"zha\", area_id=\"kitchen\")\n\n**Single device lookup:**\n- By device_id: ha_get_device(device_id=\"abc123\")\n- By entity_id: ha_get_device(entity_id=\"light.living_room\")\n\n**Zigbee device support:**\n- Use integration=\"zha\" or integration=\"zigbee2mqtt\" to list Zigbee devices\n- Returns ieee_address, integration_type, and radio metrics (LQI/RSSI) for ZHA devices\n- ZHA triggers: Use `ieee_address` for zha_event triggers\n- Z2M triggers: Use `friendly_name` for MQTT topics (zigbee2mqtt/{friendly_name}/action)\n\n**Z-Wave JS device support:**\n- Use integration=\"zwave_js\" to list Z-Wave devices\n- Returns node_id extracted from device identifiers\n- Single device lookup includes node_status (security class, routing, Z-Wave+ version)\n\n**Returns (list mode):**\n- List of devices with device_id, name, manufacturer, model, area_id\n\n**Returns (single device):**\n- Full device details including integration_type, ieee_address/node_id, radio_metrics/node_status, entities",
     "inputSchema": {
       "properties": {
         "device_id": {
@@ -744,7 +744,7 @@
           "default": null
         },
         "integration": {
-          "type": "Annotated[str | None, Field(description=\"Filter devices by integration: 'zha', 'zigbee2mqtt', 'mqtt', 'hue', etc.\", default=None)]",
+          "type": "Annotated[str | None, Field(description=\"Filter devices by integration: 'zha', 'zigbee2mqtt', 'zwave_js', 'mqtt', 'hue', etc.\", default=None)]",
           "default": null
         },
         "area_id": {
@@ -762,7 +762,9 @@
       "readOnlyHint": true
     },
     "tags": [
-      "Device Registry"
+      "Device Registry",
+      "Z-Wave",
+      "Zigbee"
     ],
     "source_file": "tools_registry.py"
   },
@@ -1671,11 +1673,23 @@
     "source_file": "tools_history.py"
   },
   {
-    "name": "ha_get_logbook",
-    "title": "Get Logbook Entries",
-    "description": "Get Home Assistant logbook entries for the specified time period.\n\nReturns paginated logbook entries to prevent excessively large responses.\n\n**Parameters:**\n- hours_back: Number of hours to look back (default: 1)\n- entity_id: Optional entity ID to filter entries\n- end_time: Optional end time in ISO format (defaults to now)\n- limit: Maximum number of entries to return (default: 50, max: 500)\n- offset: Number of entries to skip for pagination (default: 0)\n- compact: Return only essential fields per entry (default: True).\n  When True, each entry contains only: when, entity_id, state, name, message, domain, context_id.\n  Set to False to include full attribute dictionaries and all fields.\n\n**Pagination:**\nWhen the logbook has more entries than the limit, use offset to get\nadditional pages. The response includes `has_more` to indicate if\nmore entries are available.\n\n**IMPORTANT - Pagination Stability:**\nPagination is performed client-side on the full result set returned\nby Home Assistant. If new logbook entries are created between page\nrequests, results may shift and items could be missed or duplicated\nacross pages. For best results, use consistent time ranges (start/end)\nand retrieve pages in quick succession.\n\n**Example:**\n- First page: ha_get_logbook(hours_back=24, limit=50, offset=0)\n- Second page: ha_get_logbook(hours_back=24, limit=50, offset=50)\n- Full details: ha_get_logbook(hours_back=1, compact=False)",
+    "name": "ha_get_logs",
+    "title": "Get Logs",
+    "description": "Get Home Assistant logs from various sources.\n\n**Sources:**\n- \"logbook\" (default): Entity state change history with pagination\n- \"system\": Structured system log entries (errors, warnings) via system_log/list\n- \"error_log\": Raw home-assistant.log text\n- \"supervisor\": Add-on container logs (requires slug parameter)\n\n**Shared params:** limit, search (keyword filter on entries/lines)\n**Logbook params:** hours_back, entity_id, end_time, offset, compact (default True — strips attribute dicts to save context)\n**System/error_log params:** level (ERROR, WARNING, INFO, DEBUG)\n**Supervisor params:** slug (add-on slug, e.g. \"core_mosquitto\")",
     "inputSchema": {
       "properties": {
+        "source": {
+          "type": "Literal['logbook', 'system', 'error_log', 'supervisor']",
+          "default": "logbook"
+        },
+        "limit": {
+          "type": "int | str | None",
+          "default": null
+        },
+        "search": {
+          "type": "str | None",
+          "default": null
+        },
         "hours_back": {
           "type": "int | str",
           "default": 1
@@ -1688,17 +1702,21 @@
           "type": "str | None",
           "default": null
         },
-        "limit": {
-          "type": "int | str | None",
-          "default": null
-        },
         "offset": {
           "type": "int | str",
           "default": 0
         },
         "compact": {
           "type": "bool | str",
           "default": true
+        },
+        "level": {
+          "type": "str | None",
+          "default": null
+        },
+        "slug": {
+          "type": "str | None",
+          "default": null
         }
       }
     },
@@ -2139,15 +2157,27 @@
   {
     "name": "ha_get_overview",
     "title": "Get System Overview",
-    "description": "Get AI-friendly system overview with intelligent categorization.\n\nReturns comprehensive system information at the requested detail level,\nincluding Home Assistant base_url, version, location, timezone, entity overview,\nand active persistent notifications (if any).\nDefault is 'minimal' — use this unless you specifically need all entities.",
+    "description": "Get AI-friendly system overview with intelligent categorization.\n\nReturns comprehensive system information at the requested detail level,\nincluding Home Assistant base_url, version, location, timezone, entity overview,\nand active persistent notifications (if any).\nUse 'minimal' (default) for most queries. Domain counts and states_summary\nare always complete regardless of entity pagination.\nStandard/full modes paginate entities (default 200 per page) — use offset\nto fetch more. Use 'domains' filter to narrow scope.",
     "inputSchema": {
       "properties": {
         "detail_level": {
-          "type": "Annotated[Literal['minimal', 'standard', 'full'], Field(default='minimal', description=\"'minimal': 10 entities per domain sample (default); 'standard': ALL entities per domain (friendly_name only); 'full': ALL entities with entity_id + friendly_name + state + system_info\")]",
+          "type": "Annotated[Literal['minimal', 'standard', 'full'], Field(default='minimal', description=\"'minimal': 10 entities/domain, top-5 states (default); 'standard': 200 entities/page, top-10 states (use offset for more); 'full': 200 entities/page + entity_id + state + full states. Use 'domains', 'limit', or max_entities_per_domain to control size\")]",
           "default": "minimal"
         },
+        "domains": {
+          "type": "Annotated[str | list[str] | None, Field(default=None, description=\"Filter to specific domains (e.g. 'light,sensor' or ['light','sensor']). None = all domains. Useful to avoid context window overload.\")]",
+          "default": null
+        },
+        "limit": {
+          "type": "Annotated[int | str | None, Field(default=None, description='Max total entities across all domains (default: unlimited for minimal, 200 for standard/full). Counts and states always complete. Use with offset for pagination.')]",
+          "default": null
+        },
+        "offset": {
+          "type": "Annotated[int | str, Field(default=0, description='Number of entities to skip for pagination (default: 0)')]",
+          "default": 0
+        },
         "max_entities_per_domain": {
-          "type": "Annotated[int | None, Field(default=None, description='Override max entities per domain (None = all). Minimal defaults to 10.')]",
+          "type": "Annotated[int | None, Field(default=None, description='Override default entity cap per domain (minimal=10, standard/full=unlimited). 0 = no limit on entities or states.')]",
           "default": null
         },
         "include_state": {
@@ -2486,15 +2516,24 @@
   },
   {
     "name": "ha_get_system_health",
-    "title": "Get System Health",
-    "description": "Get Home Assistant system health information.\n\nReturns health check results from integrations, system resources, and connectivity.\nAvailable information varies by installation type and loaded integrations.",
-    "inputSchema": {},
+    "title": "Get System Health (incl. ZHA/Z-Wave diagnostics)",
+    "description": "Get Home Assistant system health, including Zigbee (ZHA) and Z-Wave JS network diagnostics.\n\nReturns health check results from integrations, system resources, and connectivity.\nAvailable information varies by installation type and loaded integrations.\n\n**Parameters:**\n- include: Optional comma-separated list of additional data to include.\n  - \"repairs\": Repair items from Settings > System > Repairs\n  - \"zha_network\": ZHA Zigbee devices with radio signal summary (name, LQI, RSSI)\n  - \"zha_network_full\": ZHA Zigbee devices with all device details (can be large on 100+ device networks; prefer \"zha_network\" for summary)\n  - \"zwave_network\": Z-Wave JS network status and node summary (status, security, routing)\n  - Example: include=\"repairs,zha_network,zwave_network\"",
+    "inputSchema": {
+      "properties": {
+        "include": {
+          "type": "str | None",
+          "default": null
+        }
+      }
+    },
     "annotations": {
       "idempotentHint": true,
       "readOnlyHint": true
     },
     "tags": [
-      "System"
+      "System",
+      "Z-Wave",
+      "Zigbee"
     ],
     "source_file": "tools_system.py"
   },