Module harness 

The spike harness: build the study, drive oniro over the executor, re-rank.

run_spike is the whole pipeline (04-rl-and-oniro.md §B): a search space from a TOML overlay, a TPE (or random, for the honest comparison) study with the multi-seed protocol (k tune seeds, paired CRN, an aggregate, disjoint test seeds), the subprocess executor over the oniro-trial child (process-per-trial), and the final held-out re-evaluation stage. It touches oniro only through the oniro_cli binary named in SpikeConfig::oniro_cli.

Structs

SpikeConfig

The full configuration of one spike run.

SpikeReport

The result of a spike run: the study and the (optional) test-seed report.

Enums

SamplerChoice

Which sampler the study uses.

Constants

MAX_CONCURRENT_DESCRIPTORS

Maximum descriptors held concurrently by one admitted spike.

MAX_PARALLELISM

The most concurrent trial processes one spike run may hold open.

MAX_TOTAL_DESCRIPTORS

Maximum descriptor units admitted by one objective lifetime.

MAX_TOTAL_OPERATIONS

Maximum train/eval operations admitted by one objective lifetime.

MAX_TOTAL_PROCESSES

Maximum process invocations admitted by one objective lifetime.

MAX_TRIALS

Maximum logical trials admitted by one objective lifetime.

Functions

capture_default_config

Captures oniro_cli default-config with the production output and timeout bounds used by the tune binary.

child_inputs_from_env

Gathers one child invocation’s typed inputs from the executor environment.

evaluate_config_on_test_seeds

Evaluates a single, already-complete RunConfig TOML on the protocol’s disjoint test seeds and returns the same aggregate the tune/test split reports for a tuned trial.

read_bounded_text

Reads the base RunConfig file without letting its size decide the child’s.

run_spike

Runs the whole oniro tuning spike and returns its report.

sibling_bin

Finds a sibling binary next to the current executable.