ProgramNoveltyDecision

Models & Types · AiDotNet.Evolution.Programs.Novelty

One novelty decision, with the rung that produced it and what that rung cost.

For Beginners

This is the answer to “should we bother evaluating this candidate?”, plus the receipt. IsNovel is the answer, DecidedBy says which check settled it, and the three count properties say how much that cost — the cheap check is free, the other two are not.

How It Works

The verdict alone is not enough to run a search responsibly. A gate that admits everything because its provider is unreachable looks identical, from the outside, to a gate that admits everything because the candidates really are new — unless the decision says which rung answered and how many paid comparisons it made. Those counts are what a run reports, what a cost claim is proved with, and what makes a misconfigured threshold visible.

Reason is bounded and describes the mechanism, never the program: it is safe to log. Program text never appears here at all, only NearestGenomeId, which is a hash.

Constructors

Constructor Summary
ProgramNoveltyDecision(bool isNovel, ProgramNoveltyStage decidedBy, string reason, string nearestGenomeId, double? nearestStructuralDistance, double? embeddingSimilarity, int structuralComparisons, int embeddingRequests, int judgeRequests) Initializes a novelty decision.

Properties

Property Summary
ProgramNoveltyStage DecidedBy { get; } Gets the rung of the novelty ladder that produced the verdict.
bool IsNovel { get; } Gets whether the candidate is novel enough to proceed.
bool WasFree { get; } Gets whether this decision reached neither a provider nor a model.
double? EmbeddingSimilarity { get; } Gets the highest embedding cosine similarity found, or null when none was computed.
double? NearestStructuralDistance { get; } Gets the smallest structural distance found, or null when none was computed.
int EmbeddingRequests { get; } Gets how many embedding requests this decision issued; zero unless the cheap rung was inconclusive.
int JudgeRequests { get; } Gets how many judging requests this decision issued; zero unless both cheaper rungs were inconclusive.
int StructuralComparisons { get; } Gets how many structural distances this decision computed; each one is local arithmetic.
string NearestGenomeId { get; } Gets the identity of the closest known genome, or null when nothing was compared.
string Reason { get; } Gets the bounded, program-free explanation of the verdict.

Methods

Method Summary
string ToString() Returns the verdict, the deciding rung, and the paid-call counts.

Fields

Field Summary
int MaxReasonLength The longest reason retained, in characters.