# Stability Report

Generated by ``scripts/generate_stability_report.py``.  Refreshed at
release time as part of the v0.3.0+ verification gate (see
``plans/MADDENING_v0.3.0_PLAN.md`` §A2).

Each public surface is tagged via ``@stability`` and registered at
import time.  Levels:

| Level | Meaning |
|---|---|
| ``stable`` | Locked at 1.0.0 — backwards-incompatible change needs a major bump. |
| ``evolving`` | Settled wire format / signature, additions allowed. |
| ``provisional`` | Synonym for ``evolving``, retained for pre-v0.3.0 surfaces. |
| ``experimental`` | May break in any minor release. Opt-in only. |
| ``internal`` | Implementation detail. Not part of the public API. |
| ``deprecated`` | Scheduled for removal. |

| API Surface | Stability Level |
|---|---|
| `maddening.api.binary_encoder.BinaryStateEncoder` | evolving |
| `maddening.cloud.multigpu.iterative_solver.sharded_cg` | stable |
| `maddening.cloud.multigpu.iterative_solver.sharded_gmres` | stable |
| `maddening.cloud.multigpu.sharded_node.ShardedPointwiseNode` | stable |
| `maddening.cloud.multigpu.sharded_node.ShardedStencilNode` | stable |
| `maddening.cloud.multigpu.sharded_unstructured.ShardedUnstructuredNode` | stable |
| `maddening.cloud.providers.CloudProvider` | evolving |
| `maddening.core.edge.EdgeSpec` | stable |
| `maddening.core.graph_manager.GraphManager` | stable |
| `maddening.core.node.SimulationNode` | stable |
| `maddening.core.static_data.StaticArray` | stable |
| `maddening.fmi.directional_derivatives.get_directional_derivative` | evolving |
| `maddening.fmi.fmu_state.deserialize_fmu_state` | evolving |
| `maddening.fmi.fmu_state.serialize_fmu_state` | evolving |
| `maddening.fmi.model_description.build_model_description` | evolving |
| `maddening.nodes.ball.BallNode` | stable |
| `maddening.nodes.health_check.HealthCheckNode` | experimental |
| `maddening.nodes.heart_pump.HeartPumpNode` | experimental |
| `maddening.nodes.heat.HeatNode` | stable |
| `maddening.nodes.lbm.LBMNode` | experimental |
| `maddening.nodes.lbm_pipe.LBMPipeNode` | experimental |
| `maddening.nodes.rigid_body.RigidBodyNode` | experimental |
| `maddening.nodes.rigid_body_2d.RigidBody2DNode` | experimental |
| `maddening.nodes.spring.SpringDamperNode` | stable |
| `maddening.nodes.table.TableNode` | stable |
| `maddening.surrogates.architecture.SurrogateArchitecture` | experimental |
| `maddening.surrogates.dataset.DatasetGenerator` | experimental |
| `maddening.surrogates.node.SurrogateNode` | experimental |
| `maddening.usd.live_stage.LiveStage` | evolving |

*29 API surfaces registered.*