1 rollouts
rollouts
Target-conditioned rollout generation and replay Zarr stores.
aria_nbv.rollouts owns the multi-step thesis replay surface. It composes VIN offline samples, actor-visible target selection, finite candidate generation, and target-RRI oracle scoring into standalone rollout artifacts. Raw snippet access and immutable VIN offline stores remain in aria_nbv.data_handling.
1.1 Attributes
| Name | Description |
|---|---|
| ROLLOUT_MANIFEST_FILENAME | Filename of the human-readable rollout-store sidecar manifest. |
| ROLLOUT_MANIFEST_VERSION | Version tag for the top-level rollout-store manifest payload. |
| ROLLOUT_SHARD_MANIFEST_VERSION | Version label for rollout generation JSONL shard manifests. |
| ROLLOUT_SHARD_OWNER_FILENAME | Shard owner/provenance sidecar written before final promotion. |
| ROLLOUT_SHARD_SUCCESS_FILENAME | Completion marker written last for a validated rollout shard. |
| INVALID_REASON_CODES | Version-1 invalidity reason bit positions for rollout replay tables. |
| INVALID_REASON_VERSION | Version label for INVALID_REASON_CODES. |
| DEFAULT_RETURN_SEMANTICS | Default return target family for root-normalized Q_H replay views. |
| ROLLOUT_ZARR_SCHEMA_ID | Schema id stored as a root attribute on rollout replay stores. |
| ROLLOUT_ZARR_SCHEMA_VERSION | Target-first rollout schema with hot candidate provenance and core parent-depth history. |
1.2 Classes
| Name | Description |
|---|---|
| RolloutDatasetWriter | Generate target-RRI rollout records and write a standalone Zarr store. |
| RolloutDatasetWriterConfig | Configuration for building standalone target-RRI rollout Zarr stores. |
| RolloutDatasetWriterStats | Counters reported by one rollout-store build. |
| RolloutRecipeConfig | One rollout policy recipe materialized into the replay store. |
| RolloutTargetSource | Target source protocol used by the rollout writer. |
| SelectedDepthRetentionConfig | High-resolution selected-action depth retention for rollout stores. |
| RolloutSuspiciousQueryConfig | Thresholds used by suspicious_rollout_rows. |
| RolloutStoreInvocation | How a rollout store generation run was invoked. |
| RolloutStoreManifestContext | Optional rich context attached by higher-level rollout writers. |
| RolloutShardEntry | One deterministic rollout generation shard entry. |
| RolloutShardRow | One VIN offline source row owned by a rollout shard. |
| RolloutShardCampaignStatus | Status summary for all shards planned by one rollout manifest. |
| RolloutShardRunResult | Result of one strict rollout shard build or resume check. |
| RolloutShardStatus | Status for one planned rollout shard in a generation campaign. |
| RolloutLineage | Deterministic provenance for one rollout root, target, and policy. |
| RolloutZarrRecord | One counterfactual rollout result plus source/target lineage. |
| RolloutZarrStoreConfig | Filesystem and target metadata for one standalone rollout replay store. |
| RolloutZarrStoreReader | Open and validate standalone rollout replay stores. |
| RolloutZarrValidationResult | Validation summary for a rollout Zarr store. |
| RolloutZarrWriteResult | Summary of one rollout Zarr write. |
1.3 Functions
| Name | Description |
|---|---|
| candidate_audit_rows | Return candidate rows joined with candidate-generation diagnostics. |
| candidate_group_summary_rows | Summarize candidate validity and labels by a decoded categorical field. |
| candidate_result_diagnostic_counts | Return live CandidateSamplingResult counts by position and invalid reason. |
| decode_invalid_reason | Return the stable invalid-reason name for one numeric code. |
| decode_position_id | Return the stable position-family name for one numeric id. |
| decode_strategy_id | Return the stable orientation/strategy name for one numeric id. |
| decode_target_invalid_reason | Return the stable target-invalidity reason name for one numeric code. |
| discover_rollout_store_paths | Return rollout Zarr store candidates under a cache directory. |
| rollout_step_objective_rows | Return per-step objective, branching, and selected-action audit rows. |
| rollout_store_inventory_rows | Return schema, validation, count, lineage, and storage rows for stores. |
| rollout_tree_summary_rows | Summarize selected rollout-tree provenance by policy, step, and family. |
| selected_depth_preview | Return one downsampled selected-depth payload for Plotly app previews. |
| selected_depth_summary_rows | Return bounded summaries for persisted selected-action depth rasters. |
| suspicious_rollout_rows | Return heuristic anomaly rows for rollout-store QA triage. |
| target_audit_rows | Return stored target rows with actor-visible and GT-audit fields. |
| validity_waterfall_rows | Return full-shell to selected counts for one rollout store. |
| plan_rollout_shards | Plan deterministic source-row rollout shard entries from a writer config. |
| run_rollout_shard | Build one rollout shard with strict temp-to-final promotion semantics. |
| summarize_rollout_shard_campaign | Summarize completion state for a rollout shard campaign. |
| write_rollout_shard_manifest_from_config | Plan and write a rollout shard JSONL manifest. |
| validate_rollout_zarr_store | Validate a standalone rollout replay store and return all discovered errors. |
| write_rollout_zarr_store | Write rollout records into a standalone rollouts.zarr store. |