rrt/docs/atlas/editor-and-site-service.md

# Editor and Site Service

Primary atlas sources:

- [station-detail-overlay.md](/home/jan/projects/rrt/docs/control-loop-atlas/station-detail-overlay.md)
- [station-detail-overlay.md](/home/jan/projects/rrt/docs/control-loop-atlas/station-detail-overlay.md)

This view isolates the map-editor page families, candidate and site-service runtime chain, and the
station-detail or station-list read-side consumers.

Current grounded editor owners:

- `map_editor_panel_select_active_section`
- `map_editor_panel_dispatch_active_section_message`
- `map_editor_scenario_metadata_panel_refresh_controls`
- `map_editor_scenario_special_conditions_panel_handle_message`
- `map_editor_economic_cost_slider_panel_construct`
- `map_editor_available_chairman_panel_handle_message`
- `map_editor_city_region_panel_handle_message`
- `map_editor_territory_panel_handle_message`
- `map_editor_locomotive_availability_panel_handle_message`
- `map_editor_industry_availability_panel_handle_message`
- `map_editor_port_warehouse_cargo_panel_handle_message`

Current grounded runtime chain:

- `scenario_state_rebuild_port_warehouse_cargo_recipe_runtime_tables`
- `structure_candidate_collection_rebuild_runtime_records_from_scenario_state`
- `structure_candidate_rebuild_cargo_membership_and_scaled_rate_tables`
- `structure_candidate_query_cargo_runtime_summary_channels`
- `structure_candidate_collection_refresh_cargo_economy_filter_flags`
- `placed_structure_rebuild_candidate_cargo_service_bitsets`
- `placed_structure_rebuild_candidate_local_service_tables`
- `placed_structure_refresh_local_service_score_bundle`
- `placed_structure_query_candidate_local_service_metrics`
- `placed_structure_count_candidates_with_local_service_metrics`
- `placed_structure_get_nth_candidate_id_with_local_service_metrics`
- `placed_structure_query_cached_express_service_class_score`
- `placed_structure_refresh_candidate_local_service_comparison_cache_against_peer_site`
- `placed_structure_select_best_candidate_id_by_local_service_score`

Current grounded shell-side consumers:

- `shell_station_detail_format_freight_and_express_summary`
- `shell_station_detail_format_candidate_local_service_summary`
- `shell_station_list_format_freight_and_express_availability_summary`
- `world_render_station_candidate_service_map_overlay`

What this note is for:

- Editor page ownership and field semantics
- Port or warehouse cargo recipe runtime path
- Candidate enablement and cargo-economy filtering
- Per-site local service tables and caps
- Station-detail and station-list read-side summaries

Resolved edge:

- The per-site local service query family is now bounded as predominantly read-side. Above the
  mutation and rebuild lane, the grounded helpers are:
  `placed_structure_query_candidate_local_service_metrics`,
  `placed_structure_count_candidates_with_local_service_metrics`,
  `placed_structure_get_nth_candidate_id_with_local_service_metrics`,
  `placed_structure_query_cached_express_service_class_score`,
  `placed_structure_refresh_candidate_local_service_comparison_cache_against_peer_site`, and
  `placed_structure_select_best_candidate_id_by_local_service_score`.
- Their grounded callers are shell summaries, shell detail rows and popups, the world preview
  overlay, one company-side autoroute score cache rebuild, and one peer-site comparison cache.
  None of the newly closed callers acts as a policy writer back into candidate or site state.
- The only grounded mutation bridge on this edge remains
  `structure_candidate_collection_refresh_cargo_economy_filter_flags`, which writes the derived
  enabled or filtered state into `[entry+0x56]` before rebuilding the visible counts.