Struct GanaRegistry 

pub struct GanaRegistry { /* private fields */ }

Tracks co-usage patterns between Ganas and allows taxonomy drift.

When two Ganas are frequently used together (e.g., memory.create + memory.search), the registry records the co-usage. Over time, if a Gana pair exceeds a threshold, the registry can suggest merging or reorganizing the taxonomy.

This implements the “mutable structures” principle: the taxonomy itself becomes a learnable structure rather than a fixed design decision.

Implementations

impl GanaRegistry

pub fn new() -> Self

Create a new GanaRegistry with default settings.

pub fn with_threshold(drift_threshold: u64) -> Self

Create a registry with a custom drift threshold.

pub fn record_usage(&mut self, gana: Gana, success: bool)

Record a tool dispatch within a Gana.

pub fn record_co_usage(&mut self, gana_a: Gana, gana_b: Gana)

Record co-usage of two Ganas in the same session/context.

pub fn success_rate(&self, gana: Gana) -> f32

Get the success rate for a Gana.

pub fn usage_count(&self, gana: Gana) -> u64

Get the usage count for a Gana.

pub const fn usage_counts(&self) -> &HashMap<u8, u64>

Get all usage counts (Gana index → count).

pub const fn co_usage(&self) -> &HashMap<String, u64>

Get all co-usage counts (string key “a:b” → count).

pub fn co_usage_count(&self, gana_a: Gana, gana_b: Gana) -> u64

Get the co-usage count between two Ganas.

pub fn suggested_merges(&self) -> &[GanaMerge]

Get all suggested merges from drift analysis.

pub fn analyze_drift(&self, top_n: usize) -> Vec<GanaMerge>

Analyze drift and return the top N suggested reorganizations.

pub fn rebuild_pairs(&mut self)

Rebuild the co_usage_pairs lookup from co_usage data.

Call this after deserializing a GanaRegistry, since co_usage_pairs is skipped during serialization.

pub fn clear(&mut self)

Clear all co-usage data (e.g., after applying a reorganization).

pub fn snapshot(&self) -> Value

Get a snapshot of the registry as JSON.

Trait Implementations

impl Clone for GanaRegistry

fn clone(&self) -> GanaRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GanaRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GanaRegistry

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GanaRegistry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GanaRegistry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.