Skip to main content
Every Invocation creates a new Run. Its expected slots define that run’s denominator, and each slot has at most one Member. A Member has one of three forms: All three Members refer to one Attempt. The Attempt’s origin stays unchanged, so an adopted slot reads that Attempt’s current Verdict, Usage, and other channel values.

​
Inspect the plan first

Use --dry before a run. It reads the planning channels from a quiescent Record and lists why each slot will execute or be adopted.
Example output:
If information is missing, invalid, unsupported, or from a different domain, the planner explains the reason and executes that slot instead of treating it as adoptable.

​
Conditions for automatic adoption

An Attempt becomes a carried Member only when all of these conditions hold:
  • Its Verdict is a terminal Verdict that can be adopted.
  • Its input identity matches the current input.
  • Its execution duration satisfies the current timeout.
  • This Invocation’s --rerun setting permits the Verdict to be adopted.
  • This Invocation does not require a real execution through --keep-sandbox.
Input and configuration identity are opaque values with domains. NiceEval compares their values only when the domains match exactly. When it creates a carried Member, it writes eligibility, identity, and reason into the target Run’s niceeval.actions channel. The Member itself does not copy those explanations or the Attempt’s business values.

​
Control the rerun scope

Changing --rerun affects this Invocation only. It never changes an existing Run or Attempt.

​
Explicitly accept an existing Attempt

When automatic-adoption conditions do not hold but an existing Attempt is still valid, use its complete locator:
accept checks every input before it creates a Run with accepted Members. It writes the operator’s reason, differences, and eligibility into that Run’s niceeval.actions channel. It does not modify the source Attempt or copy the source Attempt’s channel values.

​
An edit affects the next read

After a directory becomes quiescent, editing an Attempt’s Verdict, Usage, or another channel changes what a later read of a carried or accepted Member sees. If an Attempt or its reference is invalid, the Sample marks that slot invalid, not not-recorded. After a run completes, select its results with the receipt’s runIds. See Viewing Results for the viewing workflow.