Project

lex-cortex

0.0
No release in over 3 years
Cognitive wiring layer for LegionIO agentic architecture
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

 Project Readme

lex-cortex

Cognitive wiring layer for the LegionIO agentic architecture. Discovers loaded agentic extensions at runtime, builds phase handlers from their runners, and drives the tick cycle through lex-tick.

Installation

Add to your Gemfile:

gem 'lex-cortex'

How It Works

Cortex sits between the tick orchestrator and all other agentic extensions. On each 1-second tick cycle it:

  1. Drains the signal buffer (external stimuli pushed via ingest_signal)
  2. Discovers which agentic extensions are loaded
  3. Builds phase handlers that map tick phases to extension runner methods
  4. Delegates to lex-tick's execute_tick with the wired handlers

When cortex is loaded, the standalone tick actor automatically disables itself.

Wired Phases

Active tick phases (12):

Phase Extension Runner Method
sensory_processing lex-attention filter_signals
emotional_evaluation lex-emotion evaluate_valence
memory_retrieval lex-memory retrieve_and_reinforce
identity_entropy_check lex-identity check_entropy
working_memory_integration lex-curiosity detect_gaps
procedural_check lex-coldstart coldstart_progress
prediction_engine lex-prediction predict
mesh_interface lex-mesh mesh_status
gut_instinct lex-emotion gut_instinct
action_selection lex-volition form_intentions
memory_consolidation lex-memory decay_cycle
post_tick_reflection lex-reflection reflect

Dream cycle phases (7):

Phase Extension Runner Method
memory_audit lex-memory retrieve_ranked
association_walk lex-memory hebbian_link
contradiction_resolution lex-conflict active_conflicts
agenda_formation lex-curiosity form_agenda
consolidation_commit lex-memory migrate_tier
dream_reflection lex-reflection reflect
dream_narration lex-narrator narrate

All extensions are optional. Missing extensions result in { status: :no_handler } for their phases.

Usage

Cortex runs automatically as a Legion extension. To interact with it programmatically:

# Inject a signal
cortex.ingest_signal(signal: { event: 'user_message', text: 'hello' },
                     source_type: :human_direct,
                     salience: 0.8)

# Check status
cortex.cortex_status
# => { extensions_available: 8, wired_phases: 13, buffer_depth: 0, ... }

# Force rediscovery of extensions
cortex.rewire

Development

bundle install
bundle exec rspec
bundle exec rubocop

License

MIT