lineage<T> abstract method

List<T> lineage<T>(
  1. LineageArgument arg
)

Traverses the causal chain from the root ancestor to this pulse to reconstruct a historical timeline of values.

When to use

  • Value Evolution Auditing: Use this to see how a specific property (like payload or step) has changed across every hop in the graph.
  • Forensic Debugging: Identify exactly which transformation step introduced an unexpected value.
  • Explainable AI (XAI): Reconstruct the decision path of a signal through a complex reactive network.
  • State Drift Analysis: Compare the primordial root value with the current state to calculate total delta.

How it works

  1. The method starts at the current pulse and walks up the parent chain until it reaches the root.
  2. For each pulse in the chain, it extracts the requested value using the provided arg.
  3. The resulting collection is reversed to provide a chronological sequence (FIFO: First-In, First-Out).

Example

// Trace how the payload evolved from the original input
final history = pulse.lineage<double>(Pulse.payload);
print(history); // [100.0, 115.0, 103.5]

// Trace the causal "steps" taken through the graph
final steps = pulse.lineage<String>(Pulse.step);
print(steps); // ['origin', 'tax_calc', 'discount_apply']

Parameters:

  • arg: A LineageArgument defining which property to extract from the causal chain.

Returns:

A fixed-length List<T> containing the historical values in chronological order (Primordial -> Present).

Implementation

List<T> lineage<T>(LineageArgument arg);