---
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
---

<!-- Auto-generated by Clef Clef Bind — claude-skills target -->
<!-- Concept: ErrorCorrelation -->
<!-- Do not edit manually; regenerate with: clef interface generate -->

# 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)