x-troubleshooting

What problem does it solve?

It helps you quickly identify the root causes of test, environment, and service failures by collecting a focused local diagnostic snapshot instead of following a long generic guide.

Core Features & Use Cases

• Environment and .env inspection: Checks for relevant environment files (including .env.*) when tests behave unexpectedly.
• Docker and external service reachability signals: Captures running containers to support troubleshooting of dependent services.
• Port, readiness, and timeout clues: Collects process-level port usage for specified ports to narrow down connectivity issues.
• State mismatch hints: Helps spot differences between process-wide state and what the test expects by tying observed runtime context to test assumptions.
• Targeted BDD runner troubleshooting: Guides you to split investigation paths for API vs browser BDD runner failures and to verify feature/tag discovery when needed.

Quick Start

Run the local diagnostic snapshot for the candidate failing ports (for example, 5432, 5672, 9000, 9092) by executing the diagnostics collection script with those port arguments.