j1_dZddlmZddlZddlmZdZd"dZd#dZed Gd d Z ed Gd d Z ddddZ d$dZ dZ dZddddZd%dZd&dZd'dZd(dZdZdZGddZd)d Zd*d!Zy)+u4The recreational CRUISE tour — the producer-side visit scheduler. A cruise broadcast has no race to score: the picture pans the venue, visits every device one by one with a fly-in, shows each boat's own camera as a large panel, and presents nothing but the boat's NAME (plus a small verification strip — the mode exists so an operator can watch the tour and confirm, device by device, that the position is live, the video arrives, and nothing is mixed up). This module is the schedule and nothing else: pure functions of (second, device snapshot), no clock, no store, no server — the `_Cruise` driver in `serve_v3_live.py` feeds it once a second and publishes whatever it returns over the ordinary delta channel. It is deliberately a PRODUCER module. The renderer already knows how to honour a focus beat (`focus` + `focusUntilSec` + `shotType`), an onboard directive (`rieOnboardDirectives`) and a spoken line (`text`); the tour only composes those. The broadcast presents, the producer decides — and what the tour decides is visible in the beats it emits, which is what the tests pin. Truthfulness rules the scheduler enforces itself: * a device with no FRESH clip gets a shorter visit and NO picture directive — the panel is simply absent, never invented; * a device with no finite fix is skipped THIS LAP only (a camera cannot be aimed at a position nobody has), and rejoins the tour the moment it reports again; * ages ride the beat as data (`fixAgeS`/`clipAgeS`), `None` when the reading never arrived — the renderer draws an em dash, never a zero. ) annotationsN) dataclass)north northeasteast southeastsouth southwestwest northwestc8tt|dzdz dzS)uAThe spoken 8-point compass name of a bearing (0/360 → "north").ih-) _COMPASS8round)degs >/srv/vr/releases/25f455cc4e75/v3/broadcast/live/cruise_tour.py compass_wordsr#s UC#I+,q0 11cjt|xsdj}|jrd|S|S)uA sailing boat referred to by NUMBER is always "Boat {n}" (Ulf 2026-08-10) — a bare "10" on a plate or in a spoken line is a number, not a name (the same judgement `commentary_i18n.boat_reference` makes when a team label is a bare number). A real name ("Alpha") passes through untouched. Applied where the tour resolves its names, so the plate, the panel caption, the roll-call and the spoken line cannot disagree.zBoat )strstripisdigit)rawss rboat_display_namer(s3 CI2A))+U1#;,1,rT)frozenc eZdZUdZdZded<dZded<dZded<dZded <d Z ded <d Z ded <dZ ded<dZ ded<dZ ded<dddd d d dddd ZeddZy) CruiseConfiguThe tour's knobs. Defaults here; an event overrides via `presentation.cruise` (camelCase), carried to the driver on `meta.cruise` — event data, never a renderer constant.intdwell_srdwell_no_video_s interlude_s opening_pan_sfly_in_sZfresh_clip_max_age_svenue_tour_every_laps landmark_dwell_srexcursion_every_laps) dwellS dwellNoVideoS interludeS openingPanSflyInSfreshClipMaxAgeSvenueTourEveryLapslandmarkDwellSexcursionEveryLapsc(i}|jjD]l\}}|xsij|}t|tt fs2t|t rCtj|sY|dk\s_t |||<n|di|S)uThe event's `presentation.cruise` block → a config; unknown keys ignored, non-numeric values ignored (a malformed knob falls back to the default rather than crashing the show).r) _KEYSitemsget isinstancer"floatboolmathisfinite)clsblockkwargswire field_namevs r from_metazCruiseConfig.from_metaIs #  1 , D*"!!$'A!c5\*:a3F4==YZK[`aef`f%(Vz" ,}V}rN)rE dict | Nonereturnr )__name__ __module__ __qualname____doc__r#__annotations__r$r%r'r)r+r-r/r0r< classmethodrJr;rrr r 2sYGScKM3Hc "#"!"3"c!"#! 3E(!7M#:1#9  ;Err ceZdZUdZded<ded<dZded<dZded <dZd ed <dZd ed <dZ d ed <dZ d ed<dZ d ed<dZ d ed<dZ d ed<dZd ed<dZd ed<ddZy)TourStopuOne device (or robotic mark) as the tour sees it THIS tick — a snapshot, rebuilt by the driver every second from the store, never cached here.rrefnameboatkindN str | None slot_label float | Nonelatlon fix_age_s clip_age_s speed_kts wind_from_degwind_kts course_degvenue_wind_from_degc t|jttfxrbt|jttfxr@t j |jxrt j |jSN)r?r\r"r@r]rBrC)selfs r positionedzTourStop.positionedls^488c5\2Hz$((SRWL7YHMM$((+H04 dhh0G Ir)rLrA)rMrNrOrPrQrXrZr\r]r^r_r`rarbrcrdrhr;rrrTrTUs> H ID#!J !CC"I|"#J #"I|""&M<&!Hl! $J #(,,IrrT)rWvesselmarkc|jjddd}|jr-tj |j ddt ||fStj |j ddd|fS)uSort key: kind (boats → buoys → marks), then the ref's own NUMBER (numerically, so Boat 2 precedes Boat 10), letters after numbers within a kind (buoy A, B … after any numbered one).:rir,r)rUrsplitr _KIND_RANKr>rXr")rtails r stop_orderrswsf 55<<Q  #D ||~qvvq)1c$i>> NN1661 %q!T 22rg?gd@beatingreachingrunning)upwindreachdownwindc`t|ttfxrt|t xrt|ttfxryt|t xrft j |xrOt j |xr8t|ttfxr t j |xr |t k\}|sy ddlm}m }m }t|t|}}tj|||} | sy|||tkDr| S| d|||dS#t$rYywxYw)u"beating on starboard tack" — what a boat is DOING, from her course against the true wind (Ulf 2026-08-11). A plain OBSERVATION: both facts are measured, and the derivation is the geometry every sailor reads off the same two numbers — never an inference about intent. `None` (and the line simply says less) whenever the geometry cannot support the claim: a missing or non-finite course or wind, or a hull too slow for her course to mean anything (`SAILING_MIN_KTS`). The shared `v3/scoring/race_rules` helpers do the maths, so the tour and the scoring engine can never disagree about which tack a boat is on; imported lazily, and a scoring path that is not there costs the clause rather than the show.Nr)ang_diff point_of_sailtack_ofz on z tack)r?r"r@rArBrCSAILING_MIN_KTS race_rulesr{r|r} ImportError_POINT_OF_SAIL_VERBr>SAILING_BY_THE_LEE_TWA) rcrar`okr{r|r}cogwindverbs r sailing_wordsrs0 Z#u . +z*d7S3S +e 5 +>HX\>]:] +mmJ' +,0MM-,H +S%L1 +7;mmI6N +?*  ??j!5#7C  " "=d#; _=`a$T]]34A7 8*499+Q77 ..C3e %$--*<sq V# doot/G/GM dii[5':c?:K1M M$))Ijo->a@@ dii[ ""rc6t|}|dk(r|dS|dS)Nriz knotz knots)r)rns rrrs( c Aq&aS;26l2rcN|rd|nd}dt|dt||dS)Nz over rzWind from the rr)rr)rarb venue_namewheres r weather_liners?%/fZL !RE]=9:;X&'wa 12rFceZdZdZdddd ddZ d ddZddZddZddZdd Z dd Z dd Z dd Z dd Z ddZddZddZy) TourScheduleruThe sequencer: one segment at a time, forever. `tick(now_sec, stops, wind)` is called once a second (idempotent — extra calls inside a running segment return nothing) and answers `(events, directives)` to publish at this second. The choreography: OPENING pan (+ spoken weather) → guided landmark tour → per lap: visit → interlude → … → skyline pan → next lap (the landmark tour re-runs every `venue_tour_every_laps` laps) Visit order is the operator's own checklist (Ulf 2026-08-10): the boats in NUMBER order, then the buoys, then the robotic marks — `stop_order`. Reproducible, and the operator ticking devices off always knows who comes next. N) landmarksr excursioncT||_|xsgDcgc]N}t|jdttfr't|jdttfr|Pc}|_||_||_d|_d|_ d|_ t|_ g|_ ycc}w)Nr\r]startr)cfgr?r>r"r@rrr_state_until_lapset_visited _lm_queue)rgrrrrlms r__init__zTourScheduler.__init__s(1RG'u U|D(e EG%# "&  "%% %'GsAB%ct|}|j||jkrggfS|jdk(r|j||S|j ||S)uAdvance the tour to `now_sec`. Returns `(events, directives)` — empty while the current segment is still running. `wind` is the feed-meta shape (`windFromDeg`/`windKts`).r)r"rr_opening_advance)rgnow_secstopsrs rtickzTourScheduler.ticksYg, ;; "w'<r6M ;;' !==$/ /}}We,,rc d|_||jjz|_g}|r`|j dO|j d>|j |j |dt|d|d|j|gfS)Nopened windFromDegwindKts tour_weather)text) rrr'rr>append_beatrr)rgtreventss rrzTourScheduler._openings $((000  DHH]+7DHHY>  ??1e, ,! ##Au--rc|jj|}|jjr|j||S|dz|_|gfS)Nri)rrrrr)rgrrbeatss rrzTourScheduler._tick_excursionBsI##A& >>  ??1e, ,!e byrc |js|j||S|jjd}t|j dxsd}t |j j|j jt|z}||z|_ |j|dt|j dxsd|t|dt|ddt||zd }|ggfS) Nrlinertour_poirVr\r]r\r] boat-feature)rVrpoipoiDistM focusUntilSecshotType)rrpoprr>maxrr/r)_speech_secondsrrr@POI_DIST_LANDMARK_M)rgrrrrdwellevs rrzTourScheduler._next_landmarkIs~~??1e, , ^^   "266&>'R(DHH--HH%%(==?%i ZZ:Cv0D",ED$)"U)$4U2e9=MN!4&'%i.JtRxrc|xjdz c_t|_|s3d|_|t d|j j z|_ggfSd|_||_|j|d|jggfS)Nrir tour_lap)r) rrrrrrr%rrrs rrzTourScheduler._begin_lapWsy Q  DKc"dhh&:&:;;DKr6M   1jdii 892==rc |j|}||j|S|jj|jd|_|j duxr#|j |jjk}|r|jjn|jj}||jjz|z}||_ |j|d|j|j|jt!|j"t!|j t%||d }|j&dk(r|jg|d<n%|j(|j*d|d<t,|d <g}|rE|j/||jjz||jd d d d |jd|g|fS)Nr tour_visitr)deviceIdrV slotLabelfixAgeSclipAgeSrrrrWfocusrrrz tour-visitFritour)tSecendSecboatIdr fullFramepriorityreasonrV)_pick_skylineraddrUrr_rr+r#r$r)rrrVrZ_ager^rrXr\r]POI_DIST_VESSEL_Mr) rgrrnxtfreshrendr directivess rrzTourScheduler._next_visitfsjj ;==# # #''" t+E^^txx'D'DD $)  txx/H/H$((###e+ ZZ<#''"%..$s}}:M!%cnn!5JsO&)ND 88v 77)BwK!$8BuI.BzN    q488+<+<'<WZW^W^+7eYZ)/C DtZrc|Dcgc].}|j|jvs|js-|0}}|rt|tSdScc}w)uThe next unvisited POSITIONED stop in checklist order (`stop_order`); a stop with no finite fix skips this lap only — a camera cannot be aimed at a position nobody has.)keyN)rUrrhminrs)rgrrtodos rrzTourScheduler._picksH!RaAEE$>1<<>RR,0s4Z(:d:SsAAAcd|_t|jjd}||z|_|jj }|jj }|j9|dkDr4|j|zdk(r"|jjrd|_n*|jr|dkDr|j|zdk(rd|_|j|dd||z}|ggfS) uThe between-laps breather: the venue establishing camera pans the city skyline (`cam: "venue"`, aimed along `venue.cityBearingDeg` by the renderer). `camUntilSec` bounds it explicitly — without it the renderer holds a cine until the next cam event, i.e. forever.rrrrr tour_venuevenue)cam camUntilSec) rrrr%rr-r0rr availablerr)rgrholdeveryevery_xrs rrzTourScheduler._skylines  488'',$h ..((// NN &7Q;499w;NRS;SNN,,.2DK ^^ dii%.?1.D2DK ZZ.* .  > 8;,rrc4|dStdt|S)zTAges ride the wire as whole seconds; `None` stays `None` (an em dash, never a zero).Nr)rr")rIs rrrs940#aQ.0rctt|xsdjDcgc]}|s| c}}tdt j |dz dzScc}w)uThe same conservative words-per-second model the renderer's camera pacing uses (`estimatedSpeechSeconds`, app.js) — so a segment is never shorter than its own sentence.rr,g@g?)lenrsplitrrBceil)rwwordss rrrsP C O1139qq9 :E q$))ECK#-. //:s AA)rr@rLr)rrrLr)rrTrLtuple)rLrY)rrTrLr)rr@rLr)rar@rbr@rrYrLr)rIr[rLz int | None)rrrLr")rP __future__rrB dataclassesrrrrr rTrqrsr~rrrrrrrrrrrr;rrrs.# ! 8 2 - $D $III<1a 0 3 "+ZYW2<#,3 2(DDN1 0r