Struct AxisDefinition 

pub struct AxisDefinition {
    pub name: &'static str,
    pub category: AxisCategory,
    pub description: &'static str,
    pub low_anchor: &'static str,
    pub high_anchor: &'static str,
    pub intent: &'static [&'static str],
    pub forbidden_uses: &'static [&'static str],
    pub since: &'static str,
    pub deprecated: Option<DeprecationInfo>,
}

Complete definition of a single axis with governance metadata.

This struct defines not just what an axis is, but what it’s for and what it must never be used for. This turns philosophy into enforceable data.

Example

use attuned_core::axes::{AxisDefinition, AxisCategory};

// Access a canonical axis definition
let axis = attuned_core::axes::COGNITIVE_LOAD;
assert_eq!(axis.name, "cognitive_load");
assert_eq!(axis.category, AxisCategory::Cognitive);
assert!(!axis.forbidden_uses.is_empty());

Fields

name: &'static str

Canonical name (immutable after v1.0).

Must be lowercase alphanumeric with underscores, no leading/trailing underscores.

category: AxisCategory

Semantic category for grouping.

description: &'static str

Human-readable description of what this axis measures.

low_anchor: &'static str

What a low value (near 0.0) represents.

high_anchor: &'static str

What a high value (near 1.0) represents.

intent: &'static [&'static str]

Intended use cases for this axis.

These are the legitimate ways to use this axis value when conditioning LLM behavior.

forbidden_uses: &'static [&'static str]

Explicitly forbidden uses of this axis.

These are anti-patterns that violate user agency or trust. Systems using Attuned MUST NOT use axis values for these purposes.

since: &'static str

Version when this axis was introduced.

deprecated: Option<DeprecationInfo>

Deprecation information, if this axis is deprecated.

Trait Implementations

impl Clone for AxisDefinition

fn clone(&self) -> AxisDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AxisDefinition

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

Formats the value using the given formatter.

impl Serialize for AxisDefinition

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

where __S: Serializer,

Serialize this value into the given Serde serializer.