ProposalProvenanceLineage
Models & Types · AiDotNet.Evolution.Programs.Provenance
The full ancestry of one program, rebuilt from a recorded provenance stream.
For Beginners
Read this as the family tree of one program, from its earliest ancestor down to
itself, with a transcript of the AI conversation that produced each generation. Depth tells you
how many successful improvements it took to get there.
How It Works
A lineage is the chain of accepted edits that turned a seed program into a final one, oldest first, with the language-model exchange that caused each edit attached to it. It is the answer to “where did this program come from?”, assembled after the fact from nothing but the recorded stream — no live engine, no archive, no checkpoint required. The same reconstruction is what the reference implementation performs over the per-program JSON files in a saved checkpoint directory, and it exists for the same two reasons: explaining a finished run, and harvesting successful trajectories as training data.
Only accepted steps appear in the chain, because only they moved the program forward. The failed attempts are still in the stream and are still worth reading — they are what a rejection-sampling or preference-training dataset needs — but they are not ancestry, so they are not links in this chain.
Constructors
| Constructor | Summary |
|---|---|
ProposalProvenanceLineage(string finalGenomeId, IReadOnlyList<ProposalProvenanceLineageStep> steps) |
Initializes a lineage. |
Properties
| Property | Summary |
|---|---|
IReadOnlyList<ProposalProvenanceLineageStep> Steps { get; } |
Gets the accepted edits, oldest first. |
int Depth { get; } |
Gets how many accepted edits separate the root from the final program. |
long TotalTokens { get; } |
Gets the prompt and answer tokens every step in this lineage cost, as the provider reported them. |
string FinalGenomeId { get; } |
Gets the canonical identity of the program at the end of the chain. |
string RootGenomeId { get; } |
Gets the canonical identity of the earliest ancestor, or the final program when there are no steps. |
Methods
| Method | Summary |
|---|---|
string ToString() |
Returns the final program, the root, and the chain length. |