name: error-correlation description: Links runtime errors to their static context which concept , action , variant , sync , widget , file , and line produced the error , and what was the state of the flow at failure time . The root_cause action walks backward through the flow to find the earliest deviation from the expected FlowGraph path argument-hint: [command] [flowId] [errorKind] [message] [rawEvent] allowed-tools: Read, Grep, Glob, Bash

ErrorCorrelation

Links runtime errors to their static context which concept , action , variant , sync , widget , file , and line produced the error , and what was the state of the flow at failure time . The root_cause action walks backward through the flow to find the earliest deviation from the expected FlowGraph path

Commands

record

Record a runtime error with auto resolution of static context . Parses the stack trace to resolve handler entity , action method , and exact AST node at the error site ( e . g . , the await storage.put() inside the if-branch of create ) . Error kind is one of : action error , sync mismatch , where clause failure , transport error , machine invalid event , signal cycle .

Arguments: $0 flowId (string), $1 errorKind (string), $2 message (string), $3 rawEvent (string)

findByEntity

Return all errors associated with a static entity . Results as serialized JSON array .

Arguments: $0 symbol (string), $1 since (string)

findByKind

Return all errors of a given kind . Results as serialized JSON array .

Arguments: $0 errorKind (string), $1 since (string)

errorHotspots

Return entities with the most errors . Results as serialized JSON array of { symbol , count , lastSeen , sampleMessage } .

Arguments: $0 since (string), $1 topN (int)

rootCause

Walk backward through the flow s execution steps to find the earliest deviation from the expected FlowGraph path . Chain as serialized JSON array of { step , entity , status } . LikelyCause as { entity , reason } . Source as { file , line , col } . astContext as serialized JSON { node : { kind , text , startLine , endLine } , ancestors : [ { kind , startLine , endLine } ] , actionMethod , concept , handler } the exact AST node in the handler where the root cause originates ( e . g . , ReturnStatement returning variant 'error' inside catch block of User/create ) .

Arguments: $0 error (E)

get

Retrieve error metadata with resolved Score entity symbols and source location parsed from stack trace .

Arguments: $0 error (E)