trace property

List<String> get trace

An ordered sequence of steps documenting the signal's journey.

When to use

  • Forensic Auditing: Use this for debugging or auditing — it shows every step the pulse has taken through the graph.
  • Debugging to see what transformations were applied.
  • Auditing to understand a signal's journey.
  • Explainable AI (XAI) to show decision steps.
  • Understanding the evolution of a signal.

How it works

Every call to evolve or withStep appends to the trace. The list is accumulated by walking up the parent chain.

Example

final evolved = root
  .withStep('validation')
  .withStep('transformation')
  .withStep('persistence');

print(evolved.trace); // ['validation', 'transformation', 'persistence']

Implementation

List<String> get trace;