jantu 1.1.0

Jantu — ethology and creature behavior engine for instinct, survival, social dynamics, and swarm intelligence
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! # 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

#![cfg_attr(not(feature = "std"), no_std)]
#![warn(missing_docs)]
extern crate alloc;

/// Cross-crate bridges — primitive-value conversions from other AGNOS science crates.
pub mod bridge;
/// Circadian rhythm drive modifiers.
pub mod circadian;
/// Predator-prey co-evolution hooks.
pub mod coevolution;
/// Emotional contagion — affective state spreading through groups.
pub mod contagion;
/// Error types and result alias.
pub mod error;
/// Optimal foraging theory — prey selection, patch departure, and vigilance.
pub mod foraging;
/// Evolutionary game theory — contest strategies and stable equilibria.
pub mod gametheory;
/// Genetic trait inheritance — heritable behavior parameters.
pub mod genetics;
/// Learning through habituation and sensitization (dual-process theory).
pub mod habituation;
/// Core instinct system — drives, priorities, and dominant instinct selection.
pub mod instinct;
/// Integration APIs for downstream consumers (soorat rendering).
pub mod integration;
/// Kin selection and inclusive fitness (Hamilton 1964).
pub mod kin;
/// Landscape of fear — spatial risk perception and fear-mediated behavior.
pub mod landscape;
/// Allometric lifecycle scaling (Kleiber's law).
pub mod lifecycle;
/// Mate selection and courtship behaviors.
pub mod mating;
/// Spatial and social memory — recognition of locations, individuals, and threats.
pub mod memory;
/// Seasonal migration patterns and movement behaviors.
pub mod migration;
/// Pack hunting coordination and food sharing.
pub mod pack;
/// Communication signals — alarm calls, mating calls, territorial displays.
pub mod signals;
/// Social hierarchy, roles, and group cohesion.
pub mod social;
/// Stress accumulation and its effects on drive baselines.
pub mod stress;
/// Survival states and threat response classification.
pub mod survival;
/// Swarm intelligence — pheromone trails, quorum sensing, collective behavior.
pub mod swarm;
/// Territory marking and territorial aggression.
pub mod territory;

/// Optional tracing subscriber initialization. Requires the `logging` feature.
#[cfg(feature = "logging")]
pub mod logging;

pub use error::{JantuError, Result};
pub use instinct::{DriveLevel, Instinct, InstinctType, PriorityWeights};
pub use social::{HierarchyPosition, SocialRole};
pub use survival::{SurvivalState, ThreatResponse};
pub use swarm::SwarmBehavior;