fix(science): support the full native MH range

README.md

@@ -202,4 +202,4 @@ The audited Overall design combines native ICON `T/P/TKE/HHL` turbulence from th
 
 Alongside that generic score, an explicitly separate Johnson-V zenith reference evaluates background-limited point-source efficiency during astronomical night. ICON supplies PWV and actual model-surface pressure reconstructed from the co-located lowest native `P/T` level and `HHL` geometry; mean-sea-level `PMSL` remains a weather field and is never used by SPECTRL2. NASA GEOS-CF supplies independently initialized AOD at 550 nm and total ozone, SPECTRL2 supplies the pinned clear-air spectral approximation, and the lunar term uses hourly topocentric geometry with a declared Krisciunas-Schaefer fallback. Missing pressure inputs or missing/stale composition are fail-open: the ring is omitted, input completeness is reported, and the ICON forecast remains available. The code also exposes target-conditioned airmass/wavelength seeing and Gaussian-equivalent delivered-IQ helpers, but does not insert a target-specific quantity into an anonymous location-only Overall score. This `1…10` result remains an auditable engineering mapping, not measured seeing or a universal scientific scale; see the scientific-method and implementation-status documents for the exact formulas and validation limits.
 
-The cloud heatmap uses `CLC/QC/QI/T` and native `HHL` thickness at 27 model levels; layer air mass is `P/(Rd*T)*dz`. Its low/middle/high unresolved-cloud guards are `45%/24.75%/8.1%` of diagnosed cover—conservative uncertainty bounds, not physical opacity—and resolved condensate always wins when stronger. Overall shares that optical-depth kernel and guard policy but uses total-column fields plus random overlap of the three aggregated tiers, so its transmission and individual heatmap cells are not expected to be identical. ICON-EU contracts are `surface-hourly-v17`, `cloud-hourly-v4`, and `point-v7-explicit-heuristics`; ICON Global uses `cloud-hourly-v1` and `point-v3-explicit-heuristics`. ICON Global cloud bundles contain the same 187 messages/hour through `+48 h`, then 169 messages/hour because DWD stops publishing TKE while continuing every cloud and wind field. The response also reports coordinate-interpolated LPI, modeled zenith SQM, and an explicitly approximate Bortle reference from the pinned Light Pollution Atlas 2024. Weather includes flow arrows, direct-VIS fog-heuristic signals where the selected provider publishes visibility, dew advice, and minute-level events for the Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto. The interactive site uses the same versioned hourly topocentric positions for exact altitude cells and Astrodome sky paths; shortest-arc interpolation only smooths the dashed line between stored hours. Synthetic fixture data are never sent to users. The serving process atomically publishes validated upper-air, surface, and cloud bundles below the selected provider's `current`; user requests only read the last complete publication.
+The cloud heatmap uses `CLC/QC/QI/T` and native `HHL` thickness at 27 model levels; layer air mass is `P/(Rd*T)*dz`. Its low/middle/high unresolved-cloud guards are `45%/24.75%/8.1%` of diagnosed cover—conservative uncertainty bounds, not physical opacity—and resolved condensate always wins when stronger. Overall shares that optical-depth kernel and guard policy but uses total-column fields plus random overlap of the three aggregated tiers, so its transmission and individual heatmap cells are not expected to be identical. A separate minimal native `P/T/U/V/TKE` chain on consecutive ICON-EU levels `44…74` and independently selected ICON Global levels `87…120` supports every positive ICON `MH` through its currently encoded `3000 m` ceiling without downloading additional cloud-condensate fields; a future deeper value remains unavailable rather than extrapolated. ICON-EU contracts are `surface-hourly-v17`, `cloud-hourly-v6-native-mh`, and `point-v8-native-mh-support`; ICON Global uses `cloud-hourly-v2-native-mh` and `point-v4-native-mh-support`. ICON Global bundles contain 260 messages/hour through `+48 h`, then 225 messages/hour because DWD stops publishing TKE while continuing every cloud, thermodynamic, and wind field. The response also reports coordinate-interpolated LPI, modeled zenith SQM, and an explicitly approximate Bortle reference from the pinned Light Pollution Atlas 2024. Weather includes flow arrows, direct-VIS fog-heuristic signals where the selected provider publishes visibility, dew advice, and minute-level events for the Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, and Pluto. The interactive site uses the same versioned hourly topocentric positions for exact altitude cells and Astrodome sky paths; shortest-arc interpolation only smooths the dashed line between stored hours. Synthetic fixture data are never sent to users. The serving process atomically publishes validated upper-air, surface, and cloud bundles below the selected provider's `current`; user requests only read the last complete publication.

README.ru.md

@@ -299,10 +299,16 @@ DIMM/MASS/SCIDAR или качественные журналы наблюден
 - комплекты из семи PNG хранятся до 48 часов, не более 256 комплектов;
 - временные файлы и устаревшие версии кешей удаляются автоматически.
 
-Контракты ICON-EU: `surface-hourly-v17`, `cloud-hourly-v4` и
-`point-v7-explicit-heuristics`; ICON Global использует `cloud-hourly-v1` и
-`point-v3-explicit-heuristics`. Global bundle содержит те же 187 GRIB-сообщений/час
-до `+48 ч`, затем 169: DWD прекращает TKE, продолжая все cloud и wind fields.
+Отдельная минимальная последовательность исходных `P/T/U/V/TKE` на уровнях
+ICON-EU `44…74` и независимо выбранных уровнях ICON Global `87…120`
+поддерживает любой положительный ICON `MH` до текущего закодированного
+предела `3000 м` без загрузки дополнительных полей облачного конденсата;
+будущее более глубокое значение останется недоступным без экстраполяции. Контракты
+ICON-EU: `surface-hourly-v17`, `cloud-hourly-v6-native-mh` и
+`point-v8-native-mh-support`; ICON Global использует
+`cloud-hourly-v2-native-mh` и `point-v4-native-mh-support`. Global bundle
+содержит 260 GRIB-сообщений/час до `+48 ч`, затем 225: DWD прекращает TKE,
+продолжая все cloud, thermodynamic и wind fields.
 
 ## Документация
 

config/config.example.yaml

@@ -117,7 +117,7 @@ sync:
   min_free_space: 150GiB
 
 algorithms:
-  seeing_version: seeing-hybrid-tke-native-mh-hmnsp99-logp-v8
+  seeing_version: seeing-hybrid-tke-native-mh-hmnsp99-logp-v9
   dew_version: dew-v1
   conditions_version: conditions-v8-precip-veto-penalty-decomposition
   overall_seeing_weight: 1.0

docs/architecture.en.md

@@ -1,7 +1,7 @@
 # bot-astrosferum: KISS architecture
 
 Status: implemented MVP, architecture revision 0.4; the
-`surface-hourly-v17`/`cloud-hourly-v4` data contract is live in production.
+`surface-hourly-v17`/`cloud-hourly-v6-native-mh` is the current data contract.
 The optional ICON-EU Horizon extension is implemented as a configuration-gated
 application capability. The directional atmospheric Astrodome calculator and
 authenticated account API are deployed here; the public application is owned
@@ -394,26 +394,28 @@ An incomplete run can never become current.
 
 The current hourly ICON-EU contract consists of two independently validated
 sets. `surface-hourly-v17` contains 17 single-level messages at every
-`f000…f078`, including `MH`/`mld` in metres. `cloud-hourly-v4` contains exactly
-187 messages per hour: `CLC/P/T/QC/QI` on all 27 retained full levels, `U/V`
-on consecutive lower levels `58…74`, and `TKE` on half levels `58…75`; a
-separate time-invariant bundle carries the required `HHL`. The manifest
+`f000…f078`, including `MH`/`mld` in metres. `cloud-hourly-v6-native-mh`
+contains exactly 245 messages per hour: `CLC/P/T/QC/QI` on all 27 retained
+cloud levels, a separate consecutive `P/T/U/V` turbulence chain on full
+levels `44…74`, and `TKE` on half levels `44…75`; P/T messages already present
+in the cloud subset are not duplicated. A separate time-invariant bundle
+carries the required `HHL`. The manifest
 switches only after every file passes message-count, shortName, level, size,
 and SHA-256 validation.
 
 ICON Global publishes the same cloud/PBL contract on the full native grid. Its
-height-equivalent indices are `71,76,81,86,91,94,96,98,
-100,102,104…120` for `CLC/P/T/QC/QI`, `104…120` for lower `U/V`, and
-`104…121` for half-level `TKE/HHL`. These are the ICON-EU indices shifted by
-`+46`, verified against actual HHL heights in the common domain. The complete
+cloud indices are `71,76,81,86,91,94,96,98,
+100,102,104…120` for `CLC/P/T/QC/QI`; an independent complete-grid HHL proof
+selects `87…120` for the native `P/T/U/V` turbulence chain and `87…121` for
+half-level `TKE/HHL`. The complete
 79-hour extension is validated in a staging directory and exposed by one
 atomic manifest replacement. Point extraction applies the official Global
 grid before the shared cloud extractor, so rendering and Overall use the same
 types and equations for both providers.
 
 DWD Global publishes model-level TKE only through `+48 h`. Bundles through
-that time contain 187 messages; `+49…+78 h` bundles retain every
-`CLC/P/T/QC/QI/U/V` message (169 total) and intentionally omit TKE. The cloud
+that time contain 260 messages; `+49…+78 h` bundles retain every required
+`CLC/P/T/QC/QI/U/V` message (225 total) and intentionally omit TKE. The cloud
 heatmap therefore remains hourly for the full horizon, while the hybrid
 TKE/HMNSP99 Overall series ends at the last native-TKE time instead of
 extrapolating turbulence. Pressure-level wind/seeing diagnostics continue.
@@ -486,8 +488,8 @@ in section 29, not the ordinary point cache.
 Provider-specific point cache keys:
 
 ```text
-ICON-EU:     point-v7-explicit-heuristics/<run>/<grid-cell>.gob.gz
-ICON Global: point-v3-explicit-heuristics/<run>/<grid-cell>.gob.gz
+ICON-EU:     point-v8-native-mh-support/<run>/<grid-cell>.gob.gz
+ICON Global: point-v4-native-mh-support/<run>/<grid-cell>.gob.gz
 ```
 
 ## 14. Normalization and quality checks
@@ -559,8 +561,10 @@ continuous lower section:
 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74
 ```
 
-Every one of the 27 levels carries `CLC/P/T/QC/QI`; consecutive full levels
-`58…74` also carry `U/V`, while TKE comes from bounding half levels `58…75`.
+Every one of the 27 cloud levels carries `CLC/P/T/QC/QI`. A distinct minimal
+native turbulence chain carries `P/T/U/V` on consecutive full levels `44…74`,
+while TKE comes from bounding half levels `44…75`; overlapping P/T messages
+are stored only once.
 `HHL` provides actual
 geometry and the model surface. The continuous lower section is required for
 the centred `theta` gradient and trapezoidal PBL integration; sparse levels
@@ -682,7 +686,7 @@ from single-level `ICON MH` and applies
 `h_PBL=MH m AGL` for a positive native mixed-layer depth. From the surface to `h_PBL`, native ICON
 `T/P/TKE/HHL` supplies `Cn²` through the Masciadri expression
 `3.35e−6·P^[2(1−2R/cp)]·theta^(−10/3)·|dtheta/dz|^(4/3)·TKE^(2/3)`;
-the centred gradient is evaluated on consecutive model levels `58…74`, then
+the centred gradient is evaluated on consecutive model levels `44…74`, then
 integrated trapezoidally from `HHL75`. Above that same hourly `h_PBL`, HMNSP99
 uses pressure-level `T/U/V/FI`. `J_total=J_ground+J_free` becomes zenith long-exposure seeing at
 `500 nm` through the standard integral. Wind enters
@@ -1081,7 +1085,7 @@ sync:
   min_free_space: 150GiB
 
 algorithms:
-  seeing_version: seeing-hybrid-tke-native-mh-hmnsp99-logp-v8
+  seeing_version: seeing-hybrid-tke-native-mh-hmnsp99-logp-v9
   dew_version: dew-v1
   conditions_version: conditions-v8-precip-veto-penalty-decomposition
   overall_seeing_weight: 1.0
@@ -1490,9 +1494,12 @@ and input-manifest SHA-256 digests. The coordinator verifies and atomically
 publishes under that final identity; the preparation key is never the final
 result-cache identity.
 
-The scientific marker is `horizon-spherical-straight-los-native-mh-logp-glo30-informational-v13`; the application
-cache schema is `horizon-cache-v7-glo30-informational-skyline`. Changing either a formula or the
-serialized/rendered contract requires changing the corresponding marker.
+The scientific marker is `horizon-spherical-straight-los-native-mh-logp-glo30-informational-v14`; the application
+cache schema is `horizon-cache-v8-native-mh-support`. The cache-schema change rejects
+same-run artifacts that recorded unavailable turbulence before the native `P/T/U/V/TKE`
+chain was extended through the encoded `3000 m` MH ceiling. Changing a formula,
+provider-input coverage, or the serialized/rendered contract requires changing the
+corresponding marker.
 
 PNG and metadata are published by staging plus atomic rename. Retention is
 bounded by a hard `CreatedAt` TTL and entry count; mtime is used only for LRU
@@ -1959,7 +1966,7 @@ when the current surface/cloud window extends beyond pressure-profile support.
 Additive Overall
 penalty points are serialized by Go, not reconstructed in JavaScript.
 `forecast-interactive-v6-observing-ephemerides` also pins `algorithms.overall` as
-`overall-astronomy-index-v3-native-mh-logp`, `algorithms.cloud_obstruction` as
+`overall-astronomy-index-v4-native-mh-logp`, `algorithms.cloud_obstruction` as
 `effective-cloud-obstruction-v1`, and carries
 `algorithms.overall_calibration_sha256` and the exact
 `celestial-observing-ephemerides-jpl-meeus-wgs84-h0-v4` ephemeris identity. It carries ten