1 rollouts.candidate_support.preflight

rollouts.candidate_support.preflight

Candidate-family admission evidence and rollout-store preflight reduction.

1.1 Functions

Name Description
benchmarks_from_reader Build state-keyed facts from canonical candidate rows and geometry.
candidate_family_preflight_config_from_writer Resolve the complete family policy from one typed rollout writer config.
candidate_family_preflight_from_payload Reconstruct the immutable reducer result from a primitive payload.
candidate_family_preflight_from_reader Reduce only the complete scientific policy persisted by the store.
read_candidate_family_phase_a Validate content, source, config, and revision identities before use.
reduce_candidate_family_preflight Evaluate the canonical gate for complete, serializable benchmarks.
write_candidate_family_phase_a Atomically write one compact, canonical Phase-A JSON artifact.

1.1.1 benchmarks_from_reader

rollouts.candidate_support.preflight.benchmarks_from_reader(
    reader,
    *,
    state_key=None,
    candidate_limit=500,
    include_geometry=True,
)

Build state-keyed facts from canonical candidate rows and geometry.

Candidate audit rows own attempted, valid, and selected counts. Proposal geometry is an optional visualization join: projection failures retain the affected state and counts with an explicit lineage reason. For one requested state, the complete shell is projected before the display row limit is applied, so a limit smaller than the shell cannot fabricate empty support. Complete policy preflight uses the private streaming facts reader; this public projection remains a uniformly serializable benchmark DTO whether or not display geometry is requested.

1.1.2 candidate_family_preflight_config_from_writer

rollouts.candidate_support.preflight.candidate_family_preflight_config_from_writer(
    writer_config,
    *,
    expected_population_size=None,
)

Resolve the complete family policy from one typed rollout writer config.

1.1.3 candidate_family_preflight_from_payload

rollouts.candidate_support.preflight.candidate_family_preflight_from_payload(
    payload,
)

Reconstruct the immutable reducer result from a primitive payload.

1.1.4 candidate_family_preflight_from_reader

rollouts.candidate_support.preflight.candidate_family_preflight_from_reader(
    reader,
)

Reduce only the complete scientific policy persisted by the store.

1.1.5 read_candidate_family_phase_a

rollouts.candidate_support.preflight.read_candidate_family_phase_a(
    path,
    *,
    expected,
)

Validate content, source, config, and revision identities before use.

1.1.6 reduce_candidate_family_preflight

rollouts.candidate_support.preflight.reduce_candidate_family_preflight(
    records,
    config,
    *,
    coverage=None,
)

Evaluate the canonical gate for complete, serializable benchmarks.

1.1.7 write_candidate_family_phase_a

rollouts.candidate_support.preflight.write_candidate_family_phase_a(
    path,
    evidence,
)

Atomically write one compact, canonical Phase-A JSON artifact.

Back to top