Crate jantu 

Jantu

Jantu (जन्तु — Sanskrit for “creature, living being”) — ethology and creature behavior engine for the AGNOS ecosystem.

Provides instinct modeling, survival drives, territorial behavior, social hierarchy, swarm intelligence, pack dynamics, and creature lifecycle. The biological foundation layer that bhava’s human personality builds upon — the medulla oblongata of the personality stack.

Relationship to Bhava

Bhava models the human mind (personality, emotion, reasoning). Jantu models the animal brain underneath — the instincts that evolution preserved. Human emotions are refined animal instincts:

• bhava::stress → jantu fight-or-flight (reptilian)
• bhava::relationship → jantu pair bonding (mammalian)
• bhava::contagion → jantu emotional contagion (pack behavior)
• bhava::flow → jantu predatory focus (hunting state)
• bhava::energy → jantu foraging/resting cycles

Re-exports

pub use error::JantuError;

pub use error::Result;

pub use instinct::DriveLevel;

pub use instinct::Instinct;

pub use instinct::InstinctType;

pub use instinct::PriorityWeights;

pub use social::HierarchyPosition;

pub use social::SocialRole;

pub use survival::SurvivalState;

pub use survival::ThreatResponse;

pub use swarm::SwarmBehavior;

Modules

circadian

Circadian rhythm drive modifiers. Circadian rhythm drive modifiers.

coevolution

Predator-prey co-evolution hooks. Predator-prey co-evolution hooks.

contagion

Emotional contagion — affective state spreading through groups. Emotional contagion — affective state spreading through groups.

error

Error types and result alias.

foraging

Optimal foraging theory — prey selection, patch departure, and vigilance. Optimal foraging theory — prey selection, patch departure, and vigilance.

gametheory

Evolutionary game theory — contest strategies and stable equilibria. Evolutionary game theory — contest strategies and stable equilibria.

genetics

Genetic trait inheritance — heritable behavior parameters. Genetic trait inheritance — heritable behavior parameters.

habituation

Learning through habituation and sensitization (dual-process theory). Learning through habituation and sensitization (dual-process theory).

instinct

Core instinct system — drives, priorities, and dominant instinct selection.

kin

Kin selection and inclusive fitness (Hamilton 1964). Kin selection and inclusive fitness (Hamilton 1964).

landscape

Landscape of fear — spatial risk perception and fear-mediated behavior. Landscape of fear — spatial risk perception and fear-mediated behavior.

lifecycle

Allometric lifecycle scaling (Kleiber’s law).

mating

Mate selection and courtship behaviors. Mate selection and courtship behaviors.

memory

Spatial and social memory — recognition of locations, individuals, and threats. Spatial and social memory — recognition of locations, individuals, and threats.

migration

Seasonal migration patterns and movement behaviors. Seasonal migration patterns and movement behaviors.

pack

Pack hunting coordination and food sharing.

signals

Communication signals — alarm calls, mating calls, territorial displays. Communication signals — alarm calls, mating calls, territorial displays.

social

Social hierarchy, roles, and group cohesion.

stress

Stress accumulation and its effects on drive baselines. Stress accumulation and its effects on drive baselines.

survival

Survival states and threat response classification.

swarm

Swarm intelligence — pheromone trails, quorum sensing, collective behavior.

territory

Territory marking and territorial aggression.