lex-narrative-identity

Personal narrative construction and identity coherence for LegionIO agents. Part of the LegionIO cognitive architecture extension ecosystem (LEX).

lex-narrative-identity gives an agent an autobiographical self. It records significant episodes (achievements, failures, discoveries, transformations) organized into chapters and threaded by recurring themes. Narrative coherence measures identity stability based on the consistency of the agent's emotional arc. The life story and identity summary answer the agent's "who am I" question.

Key capabilities:

• Episode types: achievement, failure, discovery, relationship, challenge, transformation, routine
• Theme types: growth, agency, communion, redemption, contamination, stability, exploration
• Chapters: temporal narrative segments with label, title, and open/closed lifecycle
• Coherence scoring: significance-weighted variance of emotional valence across episodes
• Coherence labels: coherent / mostly_coherent / fragmented / incoherent / disintegrated
• Significance labels: pivotal / significant / notable / minor / incidental

Add to your Gemfile:

gem 'lex-narrative-identity'

Or install directly:

gem install lex-narrative-identity

require 'legion/extensions/narrative_identity'

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

# Create a narrative chapter
chapter = client.create_chapter(label: :growth, title: 'Learning Phase')
chapter_id = chapter[:chapter][:id]

# Record significant episodes
ep = client.record_episode(
  type: :achievement,
  content: 'Successfully resolved a complex multi-agent coordination problem',
  significance: 0.9,
  emotional_valence: 0.8
)

# Assign to chapter and link themes
client.assign_episode_to_chapter(episode_id: ep[:episode][:id], chapter_id: chapter_id)

theme = client.add_theme(name: :growth)
client.link_theme(episode_id: ep[:episode][:id], theme_id: theme[:theme][:id])

# Get identity summary
summary = client.identity_summary
# => { coherence: 0.82, coherence_label: :coherent,
#      dominant_themes: [:growth], current_chapter: { label: :growth, ... },
#      most_significant: { content: '...', significance: 0.9 } }

# Full life story
client.life_story

# Stats
client.narrative_report

bundle install
bundle exec rspec
bundle exec rubocop

MIT