Repository is archived
No release in over 3 years
Models finite cognitive energy reserves with extraction, combustion, and depletion dynamics for brain-modeled AI agents
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-cognitive-fossil-fuel

Historical experience energy reserves for brain-modeled agentic AI in the LegionIO ecosystem.

What It Does

Models cognitive energy derived from compressed historical experience. Past knowledge accumulates as fuel reserves of varying type and quality. Reserves can be extracted gradually or combusted in larger amounts to release energy. The engine tracks total energy released, flags scarce reserves, and provides a full status report.

The metaphor: just as fossil fuels store ancient organic energy, deep experiential knowledge stores cognitive energy that can be drawn on for demanding tasks.

Usage

require 'legion/extensions/cognitive_fossil_fuel'

client = Legion::Extensions::CognitiveFossilFuel::Client.new

# Create a reserve of compressed experience
result = client.create_reserve(
  fuel_type: :oil,
  domain:    'user_interaction',
  content:   'Five years of conversation patterns'
)
reserve_id = result[:reserve][:id]

# Extract a small amount
client.extract(reserve_id: reserve_id)
# => { success: true, reserve: { volume: 0.95, ... }, extracted: 0.05 }

# Combust for a larger energy release
client.combust(reserve_id: reserve_id, grade: :refined)

# Check overall fuel status
client.fuel_status
# => { success: true, report: { total_reserves: 1, total_energy: 0.035, ... } }

Development

bundle install
bundle exec rspec
bundle exec rubocop

License

MIT