lineage<T> abstract method
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
payloadorstep) 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
- The method starts at the current pulse and walks up the
parentchain until it reaches the root. - For each pulse in the chain, it extracts the requested value using the
provided
arg. - 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);