debug

Diagnose system hangs and dropped message flows in MeshWeaver actor-model architecture.

11|4|Updated Jan 15, 2024
One-click install
npx skills add https://github.com/Systemorph/MeshWeaver --skill debug-systemorph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/Systemorph/MeshWeaver/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/Systemorph/MeshWeaver --skill debug-systemorph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves complex system hangs, timeouts, and deadlocks in the MeshWeaver framework by identifying the exact broken edge in the message flow where communication stops.

Core Features & Use Cases

  • Flow Analysis: Grep and trace message tags to identify where a message was dropped or a handler failed.
  • Bulk Reproduction: Provides the methodology to reproduce intermittent cross-test interactions that only occur under full-suite load.
  • Use Case: When a test suite hangs during CI execution, use this Skill to trace the last fired message and determine if the issue is a missed reactive observation or a genuine system lock.

Quick Start

Use the debug skill to analyze the trace log at /tmp/trace.log and identify the last successful message flow tag.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose message flow deadlocks in the MeshWeaver actor model?

Message flow deadlocks in the MeshWeaver actor model are diagnosed by analyzing structured logs and correlating trace tags to isolate the exact broken edge where communication stops. This pinpoints dropped messages or failed handlers causing system hangs.

Why does my test suite hang during CI execution under high load?

Test suite hangs during CI execution under high load often stem from cross-test interactions or grain deactivation races. Trace the last successful message flow tag to determine if a missed reactive observation or a genuine system lock is causing the interruption.

How do I trace dropped reactive emissions in a high-load execution environment?

Dropped reactive emissions during high-load execution are traced by performing structured log analysis to map the message delivery pipeline. You identify the specific broken edge by correlating trace tags to see where the reactive observation was missed.

What is the best way to reproduce intermittent cross-test interactions that only happen in a full suite?

Reproducing intermittent cross-test interactions that only occur under full-suite load requires bulk reproduction methodology. This approach targets the specific conditions triggering grain deactivation races and message flow interruptions during high-load execution.

Can I use trace-tag correlation to isolate grain deactivation races?

Trace-tag correlation is used to isolate grain deactivation races by mapping the message delivery pipeline. By tracing message tags through structured logs, you can identify exactly where a grain deactivated prematurely and dropped a reactive emission.

What limitations exist when debugging system hangs without structured log analysis?

Debugging system hangs without structured log analysis prevents effective trace-tag correlation, making it nearly impossible to isolate the specific broken edge in the message delivery pipeline. You cannot accurately determine if the issue is a missed reactive observation or a genuine deadlock.