lex-agentic-social
Domain consolidation gem for social cognition, governance, and multi-agent interaction. Bundles 17 sub-modules into one loadable unit under Legion::Extensions::Agentic::Social.
Overview
Gem: lex-agentic-social
Version: 0.1.14
Namespace: Legion::Extensions::Agentic::Social
Sub-Modules
| Sub-Module | Purpose |
|---|---|
Social::Social |
Group membership, multi-dimensional reputation, reciprocity, norm violations |
Social::TheoryOfMind |
BDI model — belief/desire/intention tracking, false-belief detection |
Social::Mentalizing |
Mentalizing network — tracking of mentalizing capacity |
Social::SocialLearning |
Learning by observation — vicarious reinforcement |
Social::PerspectiveShifting |
Deliberate perspective adoption |
Social::Trust |
Domain-scoped trust scores — asymmetric reinforcement and decay |
Social::Conflict |
Conflict registration, severity-based posture, optional LLM resolution |
Social::Conscience |
Internalized moral compass — guilt/pride signal generation |
Social::Consent |
Four-tier consent gradient with earned autonomy, HITL gate |
Social::MoralReasoning |
Six Haidt foundations, six Kohlberg stages, six ethical frameworks |
Social::Governance |
Four-layer governance — council proposals, quorum voting, action validation |
Social::JointAttention |
Shared attention between agents — coordinating focus |
Social::Mirror |
Mirror neuron analog — action observation, simulation, and resonance decay |
Social::MirrorSystem |
Extended mirror system with resonance-based familiarity tracking |
Social::Entrainment |
Rhythmic synchronization between agents |
Social::Symbiosis |
Mutually beneficial cognitive partnerships |
Social::Apprenticeship |
Expert-novice learning relationships |
Actors
9 actors handle autonomous background processing:
-
Social::Conflict::Actors::StaleCheck— every 3600s, checks for stale conflicts -
Social::Consent::Actors::TierEvaluation— every 3600s, evaluates and applies consent tiers -
Social::Governance::Actors::ShadowAiScan— interval actor, scans for shadow AI activity -
Social::Governance::Actors::VoteTimeout— every 300s, times out expired proposals -
Social::JointAttention::Actors::Decay— interval actor, decays joint attention focus -
Social::Mentalizing::Actors::Decay— interval actor, decays mentalizing model confidence -
Social::Mirror::Actor::ResonanceDecay— every 120s, decays resonance on observed actions -
Social::MirrorSystem::Actors::Decay— interval actor, decays mirror system activation -
Social::Trust::Actors::Decay— every 300s, decays all trust scores
Safety Notes
Social::Consent governs whether actions require human approval — the HITL gate must not be bypassed. Social::Governance provides the council approval mechanism used by Defense::Extinction for containment escalation.
Installation
gem 'lex-agentic-social'Development
bundle install
bundle exec rspec
bundle exec rubocopLicense
MIT