Skip to content

Changelog

All notable changes to CropForge are documented here.
Format: Keep a Changelog
Versioning: Semantic Versioning

[0.5.0] — 2026-06-28

Added

  • Beer-Lambert Radiation Interception Engine (cropforge/physics/radiation.py): calculate_intercepted_par(solar_rad_mj, lai, k_extinction=0.45). Enabled via farm.use_physics(radiation=True). Writes plant.custom['intercepted_par_mj'] per plant per day. Crucible verified: LAI=3.0, k=0.45, 15 MJ → 5.5557 MJ ±0.001.
  • Spatial Disease / Pest Pressure Engine (cropforge/physics/pathology.py): Wind-anisotropic SIR grid model. Enabled via farm.use_physics(disease=True, ...). Writes plant.custom['disease_state'], disease_stress, days_infected. Crucible verified: East/West ratio ≥ 2.5× when wind=270° over 20+ days.
  • StandardWheat plugin (cropforge/plugins/wheat.py): 6-stage CERES-Wheat phenology (thermal time), RUE biomass, grain-fill partitioning.
  • StandardMaize plugin (cropforge/plugins/maize.py): C4 parameters, hard-pan root clamping, water-stress mortality.
  • cropforge/plugins/ package with from cropforge.plugins import StandardWheat, StandardMaize.
  • field.use_plugin(PluginClass, **kwargs) — class-based plugin API.
  • farm.use_physics(radiation=, disease=, k_extinction=, disease_*) parameters.
  • examples/wheat_basic_v2.py, examples/maize_dual_plot_v2.py — plugin-edition examples.
  • examples/disease_outbreak_trial.py — complete spatial disease scenario.
  • docs/tutorials/disease_modeling.md — step-by-step disease engine walkthrough.
  • docs/features/physics.md — updated with v0.5.0 Radiation and Disease engines.
  • .readthedocs.yaml — ReadTheDocs v2 configuration.
  • 55 new tests (604 total; 1 skipped; 0 failures).

Changed

  • White Minimal Scientific Dashboard: clean light theme, persistent Farm Inspector, animated preloader.
  • farm.use_physics() now accepts radiation, disease, and all disease_* parameters.
  • pyproject.toml: version 0.5.0; added cropforge.physics and cropforge.plugins packages.

Breaking Changes

  • DAY_CHANGE postMessage now originates from Dash sidebar (not iframe scrubber). Iframe-internal listeners break — see CHANGELOG note in dashboard layer.

[0.4.0] — 2026-06-27

Added

  • Event System (cropforge.Event): Event.irrigation(), Event.fertiliser(), Event.custom() — schedule management actions on specific days or at repeating intervals.
  • API Reference Docs: Seven complete reference pages (crop, farm, state, loaders, runtime, logger, viz, events).
  • CropForgeEventError for invalid event configuration.

Changed

  • Event execution order: events now fire after all @farm.step functions (end-of-day), not before. This correctly mirrors the PRD Section 4.3 contract.

[0.2.0] — 2026-06-25

Added

  • Opt-In Physics: FAO-56 Penman-Monteith ET0 engine (phase=-2) and Root Impedance engine (phase=-1).
  • @farm.use_physics(et0=True, root_impedance=True) decorator.
  • EnvironmentState extended with four FAO-56 intermediate fields.
  • Multi-Field Dashboard: Field Selector dropdown, comparative time-series, FieldBufferRegistry.
  • cf_set_field postMessage support in Three.js viewport (full scene teardown and re-bootstrap).
  • Dual-plot GxE example (examples/maize_dual_plot.py).
  • Documentation: docs/features/physics.md, docs/tutorials/maize_dual_plot.md.
  • Published to PyPI: pip install cropforge.

Fixed

  • Replaced broken pytest-dash with dash[testing] in dev dependencies.
  • Moved PRD files to internal_dev/ (gitignored, not public).

[0.1.0] — 2026-06-24

Added

  • Core Engine: Farm, Field, Crop, Weather, Soil public API.
  • @farm.step(phase=N) decorator and phase-ordered step dispatcher.
  • EnvironmentState, PlantState, SoilVoxelState, FieldState dataclasses.
  • Weather.from_csv() and Soil.from_csv() with uniform, row, col apply strategies.
  • StateLogger — partitioned Parquet output with Snappy compression.
  • Three.js 3D Viewport: InstancedMesh binary streaming, raycaster click-to-inspect, OrbitControls.
  • Plotly Dash Dashboard: 4-panel layout (3D viewport, time-series, heatmap, farm inspector).
  • FastAPI binary buffer server with Float32Array frame API.
  • postMessage bridge: cf_set_day, cf_set_variable, cf_deselect, PLANT_CLICKED.
  • GitHub Actions CI: test matrix (Python 3.12/3.13) → build → OIDC publish to PyPI on v* tags.
  • 304 passing tests.