Enum Family 

pub enum Family {
    Core,
    Lifecycle,
    Graph,
    Governance,
    Power,
    Meta,
    Archive,
    Other,
}

A tool family. Source-anchored at crate::mcp::registry::tool_definitions() 2026-05-05. Counts must sum to 51 (the v0.6.3.1 baseline of 43 + v0.7.0 I4 memory_replay + v0.7 H4 memory_verify (both in Family::Graph) + v0.7 B1 memory_load_family and v0.7 B2 memory_smart_load in Family::Core + v0.7 K7 memory_subscription_replay and memory_subscription_dlq_list in Family::Power + v0.7 J7 memory_find_paths in Family::Graph + v0.7 K8 memory_quota_status in Family::Power).

Variants

Core

store, recall, list, get, search, load_family, smart_load — 7 (load_family added in v0.7 B1 — always-on family loader that returns the top-k recent + high-priority memories whose metadata.family matches one of the eight enum names; smart_load added in v0.7 B2 — intent-routed front door that picks the best Family from a free-text intent and forwards to memory_load_family.)

Lifecycle

update, delete, forget, gc, promote — 5

Graph

kg_query, kg_timeline, kg_invalidate, link, get_links, entity_register, entity_get_by_alias, get_taxonomy, replay, verify, find_paths — 11 (replay added in v0.7.0 I4 — joins to the I2 transcript-link substrate to reconstruct a memory’s source transcript chain; verify added in v0.7 H4 — re-checks the Ed25519 signature on a stored memory_links row.)

Governance

pending_list/approve/reject, namespace_set/get/clear_standard, subscribe, unsubscribe — 8

Power

consolidate, detect_contradiction, check_duplicate, auto_tag, expand_query, inbox, subscription_replay, subscription_dlq_list, quota_status — 9 (v0.7 K7 added the two operator/governance subscription-reliability tools — replay events from the audit log + inspect the DLQ; v0.7 K8 added memory_quota_status for the per-agent rate-limit + storage-cap substrate.)

Meta

capabilities, agent_register, agent_list, session_start, stats — 5

Archive

archive_list, archive_purge, archive_restore, archive_stats — 4

Other

list_subscriptions, notify — 2

Implementations

impl Family

pub fn for_tool(name: &str) -> Option<Self>

Lookup the family that owns a given tool name. Source-anchored at crate::mcp::registry::tool_definitions() 2026-05-04. Every name listed in the v0.6.3.1 baseline is covered; None means the tool is either unknown to this enumeration or moved out of bounds (which should make tool_definitions_returns_43_tools red and force a reconciliation).

pub const fn name(self) -> &'static str

Lowercase canonical name as used in CLI/env/config.

pub const fn all() -> &'static [Family]

All eight families in declaration order. Useful for --profile full and for the ProfileParseError::UnknownFamily diagnostic.

pub const fn expected_tool_count(self) -> usize

Number of MCP tools advertised by this family.

Derived from Family::tool_names — that slice is the single source of truth for both the names AND the count. Adding a tool to a family is therefore exactly one edit (append a tn::* entry to the slice arm); every count that depends on it — per-profile expectations, the full-profile total, the registry lockstep — recomputes automatically. There are NO hand-maintained per-family magic numbers here by design (the historical match self { Core => 7, … } form drifted whenever a tool landed without the matching count bump).

pub const fn tool_names(self) -> &'static [&'static str]

v0.7.0 A2 — tool names belonging to this family. Forward of the Family::for_tool reverse map; source-anchored at crate::mcp::registry::tool_definitions() 2026-05-04 (same anchor as Family::for_tool and Family::expected_tool_count). Order is the order each tool appears in tool_definitions_for_profile’s registration walk, so an LLM-facing preview (“the first three tools loaded”) aligns with the actual tools/list output.

This slice is the single source of truth for the family’s tool set. Family::expected_tool_count derives its return value from self.tool_names().len(), and the family_tool_names_cover_registry_all unit test pins the union of all families against the canonical registry set.

Trait Implementations

impl Clone for Family

fn clone(&self) -> Family

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Family

impl Debug for Family

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

Formats the value using the given formatter.

impl Eq for Family

impl FromStr for Family

type Err = ProfileParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Family

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Family

fn cmp(&self, other: &Family) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Family

fn eq(&self, other: &Family) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Family

fn partial_cmp(&self, other: &Family) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Family