Add container visualization to network map and improve layout

- Add show_containers parameter to create_network_map tool
- Fetch and display Docker containers running on devices as child nodes
- Separate gateway devices into their own Network Infrastructure subgraph
- Fix embedded device styling (use embedded_controllers CSS class instead of online)
- Improve device type detection for embedded devices (Sentai boards, iMX boards)
- Increase subgraph title font size from 20px to 32px for better readability
- Add container nodes with status indicators and image names
- Update MCP help documentation with network visualization features
- Add browser rendering best practices to LEARNINGS.md

Containers are displayed as child nodes connected to their parent devices
with 'Runs' edges, showing container name, status (Running/Stopped), and
image name. Gateway devices are now separated from regular devices for
cleaner visualization.

Author: Alex J Lennon

docs/LEARNINGS.md

@@ -164,3 +164,32 @@ Foundries devices discovered via FoundriesFactory API using `fioctl devices list
 - Tools provide actionable troubleshooting steps
 - Link to relevant documentation and workflows
 - Suggest alternative approaches when primary method fails
+
+## Network Mapping Best Practices
+
+### Browser Rendering for Mermaid Diagrams
+**When debugging or verifying network map visualizations, always use browser rendering instead of static PNG exports.**
+
+**Why:**
+- Browser renderers (using Mermaid.js) provide more accurate rendering of complex diagrams
+- Power connection lines and relationships render correctly in browsers
+- Static PNG exports may miss connections or have rendering issues
+- Better for verifying that power switch relationships are correctly wired
+
+**How to do it:**
+1. Generate the network map with `create_network_map()` (export_format="mermaid" or "html")
+2. Create an HTML file that includes the Mermaid diagram
+3. Start a local web server: `python3 -m http.server 8000` (in directory with HTML file)
+4. Navigate browser to `http://localhost:8000/network_map.html`
+5. Use browser snapshot/screenshot tools to capture the rendered diagram
+
+**Example workflow:**
+```python
+# Generate HTML with embedded Mermaid
+result = create_network_map(export_format="html", export_path="network_map.html")
+
+# Serve locally and view in browser
+# Browser rendering shows power connections and relationships accurately
+```
+
+**Note:** This is especially important when troubleshooting power switch relationships or verifying that device connections are correctly represented in the diagram.

lab_testing/resources/help.py

@@ -209,6 +209,7 @@ def get_help_content() -> Dict[str, Any]:
                 "get_foundries_registration_status": "Check Foundries.io registration, connection, update status (device_id)",
                 "get_secure_boot_status": "Get detailed secure boot status: U-Boot, kernel, EFI, HAB/CAAM (device_id)",
                 "get_device_identity": "Get device identity: hostname, SOC unique ID, Foundries registration name (device_id)",
+                "create_network_map": "Create a visual map of running systems on the target network showing what's up and what isn't. Supports multiple layouts, export formats, device grouping, historical tracking, performance metrics visualization, and container visualization. Use show_containers=true to display Docker containers running on devices. Export formats: mermaid (default), png, svg, pdf, html, json, csv. Use quick_mode=true for faster generation (<5s) by skipping network scanning. Layouts: lr (left-right, default), tb (top-bottom), radial, hierarchical, grid. Group by: type, status, location, power_circuit, none. Example: create_network_map(show_containers=true, quick_mode=true, export_format='html')",
             },
             "batch_operations": {
                 "batch_operation": "Execute operation on multiple devices in parallel (device_ids[], operation, max_concurrent=5, ...)",

lab_testing/server/tool_definitions.py

@@ -663,6 +663,11 @@ def get_all_tools() -> List[Tool]:
                         "description": "If true, show historical status changes and uptime indicators",
                         "default": False,
                     },
+                    "show_containers": {
+                        "type": "boolean",
+                        "description": "If true, fetch and display Docker containers running on devices",
+                        "default": False,
+                    },
                     "export_format": {
                         "type": "string",
                         "enum": ["mermaid", "png", "svg", "pdf", "html", "json", "csv"],

lab_testing/server/tool_handlers.py

@@ -1001,6 +1001,7 @@ def handle_tool(
             show_metrics = arguments.get("show_metrics", True)
             show_alerts = arguments.get("show_alerts", True)
             show_history = arguments.get("show_history", False)
+            show_containers = arguments.get("show_containers", False)
             export_format = arguments.get("export_format", "mermaid")
             export_path = arguments.get("export_path")
 
@@ -1036,6 +1037,7 @@ def handle_tool(
                 show_metrics=show_metrics,
                 show_alerts=show_alerts,
                 show_history=show_history,
+                show_containers=show_containers,
                 export_format=export_format,
                 export_path=export_path,
             )