formatLineage

formatLineage(lineage, ast, options): FormattedLineage

Defined in: execution/lineage-formatter.ts:257

Format a RuntimeLineage into a human-readable structure.

Parameters

lineage

RuntimeLineage

The runtime lineage from plan execution

ast

PlanAst

The plan’s AST for node descriptions

options

FormatLineageOptions = {}

Formatting options

Returns

FormattedLineage

Structured, human-readable lineage

Example

const result = await run(plan, ctx)
if (!result.ok) {
  const formatted = formatLineage(result.lineage, plan.ast)
  console.log(formatted.summary)
  for (const step of formatted.steps) {
    console.log(`${step.step}. ${step.description}`)
    if (step.error) console.log(`   Error: ${step.error}`)
  }
}