Crate nexcore_homeostasis_primitives 

Homeostasis Machine — Primitives

Shared types, enums, and mathematical primitives for building self-regulating systems inspired by biological homeostasis.

This is the leaf crate — no internal nexcore dependencies.

Five Laws

This crate enforces 5 biological design laws structurally:

1. Paired Controls — amplification::PairedAmplificationSystem rejects attenuators weaker than their amplifier at registration time.
2. Signal Decay — signals::DecayingSignal requires a half_life duration; signals cannot persist indefinitely.
3. Response Ceilings — hill::HillCurve mathematically guarantees response < max_response for any finite signal.
4. Self-Measurement — enums::SensorType::SelfMeasurement enables proprioceptive monitoring.
5. Proportionality — state::SystemState::needs_dampening() flags over-response via configurable thresholds.

Re-exports

pub use amplification::AmplificationViolation;

pub use amplification::Amplifier;

pub use amplification::Attenuator;

pub use amplification::PairedAmplificationSystem;

pub use amplification::create_standard_pair;

pub use baseline::Baseline;

pub use baseline::BaselineConfig;

pub use baseline::BaselineMetric;

pub use data::ActionData;

pub use data::ActionResult;

pub use data::MetricSnapshot;

pub use data::SensorReading;

pub use enums::ActionType;

pub use enums::BaselineMetricType;

pub use enums::CircuitState;

pub use enums::DecayFunction;

pub use enums::HealthStatus;

pub use enums::ResponsePhase;

pub use enums::SensorType;

pub use enums::SignalType;

pub use enums::StormPhase;

pub use enums::TrendDirection;

pub use enums::sensor_to_signal_type;

pub use hill::HillCurve;

pub use hill::ResponseCeiling;

pub use hill::SaturatingResponse;

pub use hill::create_biological_response_curve;

pub use signals::DecayingSignal;

pub use signals::SignalManager;

pub use state::MetricHistory;

pub use state::StateTracker;

pub use state::SystemState;

Modules

amplification

Paired amplification system — enforces Law 1: every amplifier needs a paired attenuator.

baseline

Baseline definition system — the reference for healthy system operation.

cascade_order

Cascade order from dependency topology.

data

Data transfer structs for sensor readings, actions, and metric snapshots.

enums

Shared enums for the Homeostasis Machine.

hill

Hill curve response ceiling math — enforces Law 3: every response has a ceiling.

signals

Decaying signals and SignalManager — enforces Law 2: every signal must decay.

state

System state tracking and trend analysis — where in the response cycle are we?