feat: soil intelligence & decision support (v0.8.0)

Milestone 11 - Soil Intelligence & Decision Support:
- Soil intelligence engine (2,200+ lines) with crop suitability, nutrient analysis, carbon estimation, sampling zones, stress monitoring
- 4-pillar crop suitability scoring (Soil 40%, Water 25%, Climate 20%, Stress 15%) with 68 crop profiles
- Weather-aware suitability integrating rainfall, temperature, drought/flood indices
- Sampling zone recommendations from within-field soil variability analysis
- Nutrient risk classification (loss_risk / retentive / responsive)
- Carbon sequestration estimation (Hassink 1997 model with climate adjustment)
- Soil x weather stress indicators combining AWC with water balance
- Rosetta PTF integration for hydraulic property estimation
- Soil-aware alerts for pH, SOC, compaction, waterlogging, sand, CEC
- Soil summary in share reports
- Map markers: bullseye sampling zones + circle scouting observations
- Interactive popups with dark mode support
- Tab-based marker visibility toggling
- 6 new API endpoints, 2 Alembic migrations, ~100 i18n keys

Author: superzero11

.gitignore

@@ -47,3 +47,4 @@ docs/
 
 # ── MinIO / Storage (local dev volumes) ──────────────────────────────
 minio-data/
+.agents/

CHANGELOG.md

@@ -8,6 +8,51 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ---
 
+## [0.8.0] - 2026-03-19
+
+### Added
+- **Soil intelligence engine** — 2,200+ lines of agronomic logic in `core/soil_intelligence.py` powering crop suitability, nutrient analysis, carbon estimation, sampling recommendations, and stress monitoring.
+- **Crop suitability assessment** — 4-pillar weighted scoring system: Soil Fit (40%), Water Match (25%), Climate Fit (20%), Stress Resilience (15%) with 68 crop profiles spanning cereals, legumes, industrial crops, root/tuber, vegetables, fruits, plantations, and spices.
+- Weather-aware crop suitability — integrates annual rainfall, temperature range, drought/flood indices from `weather_daily`; requires ≥180 days of weather data.
+- `GET /fields/{id}/soil/crop-suitability` endpoint — returns top 10 most suitable crops with scores, ratings, and limiting factors; field's current crop type highlighted even if outside top 10.
+- **Sampling zone recommendations** — within-field soil variability analysis identifies locations where clay%, SOC, pH, or AWC differ most from field mean.
+- `GET /fields/{id}/soil/sampling-zones` endpoint — returns GeoJSON FeatureCollection with prioritized sampling points (P1–P3) and rationale.
+- **Nutrient risk classification** — classifies fields into nutrient_loss_risk, nutrient_retentive, or nutrient_responsive zones based on CEC, sand/clay, SOC, pH, and leaching risk.
+- `GET /fields/{id}/soil/nutrient-context` endpoint — returns zone classification with confidence score and agronomic interpretation.
+- **Carbon sequestration estimation** — Hassink (1997) clay-dependent protective capacity model with climate zone adjustment; estimates current SOC stock, saturation deficit, and sequestration potential range.
+- `GET /fields/{id}/soil/carbon-estimate` endpoint — returns current SOC stock, estimated saturation, and conservative sequestration potential (30–70% of deficit).
+- **Soil × weather stress indicators** — combines rootzone AWC with 30-day water balance, drought index, and soil moisture to detect drought/wet/optimal conditions.
+- `GET /fields/{id}/soil/weather-stress` endpoint — returns stress status with severity score (0–1) and contributing factors.
+- **Rosetta PTF integration** — pedotransfer functions estimate field capacity, wilting point, and saturated hydraulic conductivity from texture + bulk density on soil layers.
+- Derived agronomic columns on soil layers — `field_capacity`, `wilting_point`, `saturated_conductivity`, `awc_derived`.
+- SOC stock depth-integrated calculation (t/ha) in field summary.
+- Refined risk scoring — waterlogging risk from poor drainage + low Ksat; updated compaction and leaching formulas.
+- **Soil-aware alerts** — automatic alert generation on soil fetch for: pH < 5.5 (acidic), pH < 4.5 (very acidic), SOC < 10 g/kg (low), SOC < 5 g/kg (very low), compaction risk > 0.6, waterlogging risk > 0.6, sand > 80% (leaching), CEC < 5 cmol/kg (low retention).
+- `soil_context` JSONB column on alerts table — stores soil property values at alert creation time (same pattern as `weather_context`).
+- Soil alerts displayed in alert list with soil-specific icons, property values, and thresholds.
+- **Soil summary in share reports** — texture class, pH, SOC, CEC, drainage included in public share page report alongside weather summary.
+- `soil_summary` in `ShareReportOut` API schema.
+- Soil summary section on public share page with cards for texture, pH, organic carbon, CEC, AWC, drainage.
+- **Sampling zone map markers** — bullseye-style markers on MapLibre (outer ring + inner disc + center dot) with priority color coding (P1=red, P2=yellow, P3=blue).
+- **Scouting observation map markers** — amber circle markers with white stroke and observation detail popups.
+- **Interactive map popups** — CSS-based popup styling using shadcn design tokens (`--popover`, `--popover-foreground`, `--muted-foreground`) for dark mode compatibility.
+- Click-to-zoom on sampling zone sidebar cards — `flyTo` with zoom level 17.
+- Tab-based marker visibility toggling — scouting markers only visible on scouting tab, sampling markers only visible on soil tab.
+- Soil tab intelligence panels — crop suitability card with ranked list, nutrient context badges, carbon estimation gauge with sequestration range, weather stress traffic-light indicator, sampling zones sidebar.
+- Crop suitability weather-required info banner when weather data is insufficient.
+- Alembic migration `0012_add_derived_agronomic_columns` — field capacity, wilting point, saturated conductivity, AWC derived columns on soil layers.
+- Alembic migration `0013_add_soil_context_to_alerts` — `soil_context` JSONB column on alerts table.
+- English and Spanish translations for all intelligence UI strings (~100 i18n keys).
+
+### Fixed
+- **Crop suitability sign convention** — drought severity now correctly uses `di < 0` for drought (was `di > 0`) in soil router; flood detection uses `drought_idx > 1.0` (was `< -1.0`) in intelligence engine.
+- Field's own crop suitability returned even when outside top 10 — endpoint now searches full list before truncating.
+- Race condition in field creation task dispatch — weather refresh and backfill tasks now dispatched after commit.
+- Rosetta-soil API compatibility — updated to work with rosetta-soil v0.3.x response format.
+- Popup title no longer overlaps close button — added `padding-right: 18px` to popup title CSS.
+
+---
+
 ## [0.7.0] - 2026-03-19
 
 ### Added

README.md

@@ -40,7 +40,7 @@ Open source self-hostable and reproducible Crop Intelligence Platform
 - Multi-index vegetation monitoring — NDVI, EVI, SAVI (configurable L factor), and NDWI from Sentinel-2 imagery with automatic 24-month historical backfill
 - ML-powered automatic field boundary detection (FTW model) with interactive review workflow
 - Daily weather data with agricultural indices (GDD, water balance, drought index) via Open-Meteo
-- Soil intelligence — automatic soil profile ingestion from SoilGrids (global, 250m) and POLARIS (US, 30m) with texture, pH, carbon, risk scoring, and interactive depth visualization
+- Soil intelligence — automatic soil profile ingestion from SoilGrids (global, 250m) and POLARIS (US, 30m) with crop suitability scoring (68 crops), sampling zone recommendations, carbon sequestration estimation, nutrient risk classification, and soil×weather stress monitoring
 - Reproducible pipeline with provenance (Element84 STAC → COG → TiTiler tiles)
 - Tenant isolation via `X-Org-Id` + JWT; RBAC (`owner`/`admin`/`member`/`viewer`)
 - MapLibre + PMTiles (no Mapbox token needed), ECharts for time series
@@ -171,17 +171,19 @@ ruff format --check .
 ### Layer A — Observation
 - **Satellite Intelligence**: NDVI, EVI, SAVI (configurable L), NDWI from Sentinel-2 — STAC search → COG → TiTiler tiles → time-series stats, with automatic 24-month historical backfill and weekly auto-compute
 - **Weather Intelligence**: daily historical + 7-day forecast via Open-Meteo — temperature, precipitation, ET₀, soil moisture/temperature, VPD, GDD, water balance, drought index
-- **Soil Intelligence**: automatic soil profile from SoilGrids (global, 250m) and POLARIS (US, 30m) — texture-by-depth, pH, organic carbon, CEC, bulk density, AWC, risk scoring, data quality indicators
+- **Soil Intelligence**: automatic soil profile from SoilGrids (global, 250m) and POLARIS (US, 30m) — texture-by-depth, pH, organic carbon, CEC, bulk density, AWC, Rosetta PTF hydraulic properties, risk scoring, crop suitability (68 profiles, 4-pillar model), sampling zones, carbon estimation, nutrient context
 - **Boundary Detection**: ML-powered field boundary detection (FTW model) from Sentinel-2 — draw area, review with confidence scores, accept as fields
 - **Farms & Fields**: draw/upload GeoJSON/KML polygons, auto area calculation, soft delete
 
 ### Layer B — Intelligence
 - **Per-Index Alerts**: configurable threshold and drop-percentage rules, enriched with weather context and soil data
-- **Risk Scoring**: acidification, compaction, leaching, and rooting risk from soil properties
+- **Crop Suitability**: 4-pillar weighted scoring (Soil 40%, Water 25%, Climate 20%, Stress 15%) across 68 crop profiles with limiting factors
+- **Soil Intelligence**: nutrient risk zones, carbon sequestration potential, sampling zone recommendations, soil×weather stress indicators
+- **Risk Scoring**: acidification, compaction, leaching, waterlogging, and rooting risk from soil properties
 - **Multi-Signal Context**: alerts combine vegetation anomalies + weather conditions + soil characteristics
 
 ### Layer C — Delivery
-- **Interactive Map**: MapLibre + PMTiles (no Mapbox needed), multi-layer toggle, per-index colormaps
+- **Interactive Map**: MapLibre + PMTiles (no Mapbox needed), multi-layer toggle, per-index colormaps, scouting and sampling zone markers with interactive popups
 - **Time-Series Charts**: ECharts with percentile bands, NDVI + weather overlay, soil depth visualization
 - **Scouting**: geotagged observations with photo upload and auto-attached weather snapshot
 - **Sharing**: read-only field health reports via share links with multi-index, weather, and soil summary