Graph Trace — Full System Flow

Trace connections from a target node through multiple edge types using BFS. Shows the complete chain: API endpoints → commands → entity events → bus messages → cross-service consumers.

When to Use

• "What happens when X is called/created/updated?" → --direction downstream
• "What calls/triggers X?" → --direction upstream
• "Show me the full flow through X" → --direction both (best when entry point is a middle file like a controller or command handler)
• Impact analysis — understand what's affected by a code change
• Cross-service tracing — follow MESSAGE_BUS edges to see which services consume events

Prerequisites

Graph must exist (.code-graph/graph.db). If missing, run /graph-build first.

Workflow

Step 1: Identify the target