Skip to content

About

LegionIO agentic domain gem: memory cognition extensions

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

lex-agentic-memory

Domain consolidation gem for memory storage, retrieval, and consolidation. Bundles 19 sub-modules into one loadable unit under Legion::Extensions::Agentic::Memory.

Overview

Gem: lex-agentic-memory Version: 0.2.0 Namespace: Legion::Extensions::Agentic::Memory

Sub-Modules

Sub-Module Purpose
Memory::Trace Memory trace storage, power-law decay, Hebbian association, tiered retrieval
Memory::Episodic Baddeley & Hitch episodic buffer — integrates working memory channels
Memory::Semantic Long-term conceptual knowledge — spreading activation
Memory::SemanticPriming Prior exposure boosts retrieval speed for related concepts
Memory::SemanticSatiation Repeated activation reduces salience — cognitive desensitization
Memory::SourceMonitoring Attribution of memories to origin source
Memory::Transfer Knowledge transfer between domains
Memory::Archaeology Excavates dormant or deeply buried traces
Memory::Paleontology Excavating old knowledge layers
Memory::Palimpsest Layered memory overwriting — recovering original layers
Memory::Compression Memory compression for storage efficiency
Memory::Hologram Distributed memory storage with holographic properties
Memory::Offloading Externalizing memory to reduce cognitive load
Memory::Nostalgia Nostalgic retrieval bias — past warmth enhancement
Memory::Echo Echo/resonance of past experiences
Memory::EchoChamber Self-reinforcing memory patterns
Memory::ImmuneMemory Immune-style memory for threat patterns
Memory::Reserve Cognitive reserve capacity
Memory::CommunicationPattern Tracks temporal and channel communication patterns across traces; exposes update_patterns, analyze_patterns, pattern_stats

Actors

16 actors handle autonomous background processing (all interval-based):

  • Memory::Archaeology::Actor::Decay — every 120s
  • Memory::Compression::Actor::Maintenance — every 300s
  • Memory::Echo::Actor::Decay — every 60s
  • Memory::EchoChamber::Actor::Decay — every 60s
  • Memory::Episodic::Actor::Decay — every 15s
  • Memory::ImmuneMemory::Actor::Decay — every 60s
  • Memory::Nostalgia::Actor::Maintenance — every 120s
  • Memory::Palimpsest::Actor::Decay — every 60s
  • Memory::Reserve::Actor::Maintenance — every 60s
  • Memory::Semantic::Actor::Decay — every 300s
  • Memory::SemanticPriming::Actor::Decay — every 30s
  • Memory::SemanticSatiation::Actor::Recovery — every 60s
  • Memory::SourceMonitoring::Actor::Decay — every 60s
  • Memory::Trace::Actor::Decay — every 60s
  • Memory::Trace::Actor::Quota — every 300s
  • Memory::Trace::Actor::TierMigration — every 300s

Installation

gem 'lex-agentic-memory'

Scoped retrieval

Trace::Client#retrieve_ranked(trace_ids:, domain_tag:, identity:) filters explicit candidates before ranking and returns the existing { trace:, score: } entries without reinforcing them. retrieve_and_reinforce accepts optional trace_ids:, domain_tag:, and identity: selectors before its limit is applied. An explicit empty ID list selects nothing; duplicate IDs cannot reinforce twice.

Omitting identity: retains legacy unscoped retrieval. Explicit identity: nil or a blank identity selects only traces without partner/owner tags. A supplied identity excludes other or conflicting partner:/owner: tags. Callers must derive identity and candidates from authorized input; retrieval is not proof of usefulness or consent.

Default decay derives cumulative age from persisted last_reinforced at the existing 60-second tick interval. Explicit tick_count: remains an absolute age override. Maintenance never raises strength; reinforcement remains explicit.

Cache upgrade and rollback

Version 0.2.0 partitions fallback-cache keys by the agent's existing partition_id. Old global cache keys cannot establish safe ownership and are not automatically imported, read as a fallback, overwritten, or deleted. Cache-only upgrades therefore start with an empty scoped cache and log a warning when legacy global history is present. Preserve any required history through controlled, ownership-verified recovery before adopting this release. Agent-local database storage and its schema are unchanged.

Rollback to an unpartitioned cache reader is not safe: it cannot read new scoped writes and can resurrect old global history. Use a forward fix or a controlled cache purge/recovery with verified ownership; do not restore stale shared cache data after selective erasure. No dual-write compatibility mode or automatic migration is provided.

Development

bundle install
bundle exec rspec
bundle exec rubocop

License

MIT

About

LegionIO agentic domain gem: memory cognition extensions

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages