mesh-diagnostics

What problem does it solve?

This Skill helps you quickly identify the root cause of failures in a libp2p-based decentralized messaging mesh, especially when peers cannot discover each other, relays flap, or NAT traversal breaks delivery.

Core Features & Use Cases

• Log collection: Gather runtime evidence for peer discovery, relay behavior, and NAT traversal events.
• Targeted parsing and correlation: Transform raw logs into actionable signals and correlate relay flap windows.
• Connectivity validation: Check whether bootstrap connectivity and network conditions (NAT/reflection) are consistent with expected traversal behavior.
• Use Case: When message delivery fails intermittently during real-world network changes (e.g., mobility, poor connectivity), use this Skill to determine whether the issue is in transport swarm behavior, relay protocol handling, routing engines, or NAT/reflection.

Quick Start

Run the mesh diagnostics workflow to capture logs, parse them, correlate relay flap windows, and determine the most likely root cause and remediation steps.