lex-synapse 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1961edd72029f290abdb673e1a4b23736cdc52b963d11243e4f47e4f38c65f1
-  data.tar.gz: 83be98e416e226e960e331fa24c197f99ff236cc419ea5afd26b050ee6e09fcd
+  metadata.gz: 15e9a0134efeddb2987af089e90c91d5f954524aa44c147ec5e11ae9eda9fd0f
+  data.tar.gz: b08d225fdd4d3db84155deb3a707dcc3f6f9ebfeb6e34cb1e71e057c1ef54801
 SHA512:
-  metadata.gz: ef8000741910d6a3532cafb21a4c82924e17067359609524d41df993947677bc7fe6f505f3230cbdc94a89cca0c6a8e3db7a026a77aed2a4edb5f1a43030c227
-  data.tar.gz: 86fccd6c3ecb7f4a43c0a5030c21a82af341ea50fc7e0b4e334ef77718c637358018a5fca556361ab2a26c2870879db1d54eb91505a947b9fbf3779aa05f16a4
+  metadata.gz: c6a75eff3fff57732dd4c50f2e5d2f9b94fde785ae4b5f7a3d7eedb3937eb96983c5ef1bb4f85f55229b744e80a4c98f779e69fca4d6cec3ff1fb3568694533a
+  data.tar.gz: da3a2b72741ddc1ac70319e3c2693c77ab050bc5c4b6fd6cefee301ba12bdfe820667356634de93ef8c614ea4a56e1e54f5761cc47ba76d42c1e32ae0ccb0745

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.2.3] - 2026-03-19
+
+### Fixed
+- Guard synapse model definition against missing table at require time; replace eager `class Synapse < Sequel::Model(:synapses)` with lazy `define_synapse_model` module method that checks `Legion::Data` connected and `table_exists?` before defining the constant — prevents `PG::UndefinedTable` error when gem loads before migrations run
+- Apply same lazy-define guard to `SynapseMutation` and `SynapseSignal` models
+- Add explicit `set_primary_key :id` and `key:` options on associations in anonymous Sequel model classes to prevent Sequel inferring `_id` column name for unnamed classes
+- Call `define_synapse_model` (and related) at the top of each runner method and `RelationshipWrapper` class method before first model reference
+
 ## [0.2.2] - 2026-03-18
 
 ### Fixed

data/CLAUDE.md

@@ -28,7 +28,11 @@ Legion::Extensions::Synapse
 │   ├── Crystallize     # unrouted traffic analysis, emergent creation
 │   ├── Mutate          # versioned self-modification with snapshots
 │   ├── Revert          # rollback to previous mutation version
-│   └── Report          # aggregate stats for GAIA consumption
+│   ├── Report          # aggregate stats for GAIA consumption
+│   ├── Dream           # replay historical signals in simulation mode; replay/simulate
+│   ├── GaiaReport      # GAIA tick hook: report confidence and health per synapse
+│   ├── Promote         # Apollo integration: promote high-confidence synapse patterns to shared knowledge
+│   └── Retrieve        # Apollo integration: retrieve relevant synapse patterns from shared knowledge
 ├── Helpers/
 │   ├── Confidence      # scoring, adjustments, autonomy ranges, decay
 │   ├── Homeostasis     # spike/drought detection, baseline tracking
@@ -75,6 +79,13 @@ Legion::Extensions::Synapse
 - **synapse_mutations**: Versioned change history with before/after JSON snapshots
 - **synapse_signals**: Per-signal outcome records (attention pass, transform success, latency, downstream outcome)
 
+## GAIA / Apollo Integration (v0.2.2)
+
+- **GaiaReport runner**: Called during the GAIA tick cycle to report per-synapse confidence and health metrics.
+- **Dream runner**: Replays historical signals in simulation mode. Used by the dream cycle to test routing hypothesis changes without affecting live state.
+- **Promote runner**: Publishes high-confidence synapse patterns to the Apollo shared knowledge store when confidence exceeds threshold.
+- **Retrieve runner**: Pulls relevant synapse patterns from Apollo to seed new synapses or adjust confidence for cold-start scenarios.
+
 ## Dependencies
 
 | Gem | Purpose |
@@ -87,8 +98,8 @@ Legion::Extensions::Synapse
 
 ```bash
 bundle install
-bundle exec rspec
-bundle exec rubocop
+bundle exec rspec     # 308 specs, 0 failures
+bundle exec rubocop   # 0 offenses
 ```
 
 308 specs, 96%+ coverage. Uses in-memory SQLite for model/runner tests.

data/lib/legion/extensions/synapse/client.rb

@@ -44,6 +44,7 @@ module Legion
 
         def create(source_function_id:, target_function_id:, attention: nil, transform: nil,
                    routing_strategy: 'direct', origin: 'explicit', relationship_id: nil)
+          Data::Model.define_synapse_model
           Data::Model::Synapse.create(
             source_function_id: source_function_id,
             target_function_id: target_function_id,

data/lib/legion/extensions/synapse/data/models/synapse.rb

@@ -5,9 +5,21 @@ module Legion
     module Synapse
       module Data
         module Model
-          class Synapse < Sequel::Model(:synapses)
-            one_to_many :mutations, class: 'Legion::Extensions::Synapse::Data::Model::SynapseMutation'
-            one_to_many :signals,   class: 'Legion::Extensions::Synapse::Data::Model::SynapseSignal'
+          def self.define_synapse_model
+            return if const_defined?(:Synapse, false)
+            return unless defined?(Legion::Data) && Legion::Settings.dig(:data, :connected)
+
+            db = Sequel::Model.db
+            return unless db&.table_exists?(:synapses)
+
+            klass = Class.new(Sequel::Model(:synapses)) do
+              one_to_many :mutations, class: 'Legion::Extensions::Synapse::Data::Model::SynapseMutation',
+                                      key:   :synapse_id
+              one_to_many :signals,   class: 'Legion::Extensions::Synapse::Data::Model::SynapseSignal',
+                                      key:   :synapse_id
+            end
+            klass.set_primary_key :id
+            const_set(:Synapse, klass)
           end
         end
       end

data/lib/legion/extensions/synapse/data/models/synapse_mutation.rb

@@ -5,8 +5,19 @@ module Legion
     module Synapse
       module Data
         module Model
-          class SynapseMutation < Sequel::Model(:synapse_mutations)
-            many_to_one :synapse, class: 'Legion::Extensions::Synapse::Data::Model::Synapse'
+          def self.define_synapse_mutation_model
+            return if const_defined?(:SynapseMutation, false)
+            return unless defined?(Legion::Data) && Legion::Settings.dig(:data, :connected)
+
+            db = Sequel::Model.db
+            return unless db&.table_exists?(:synapse_mutations)
+
+            klass = Class.new(Sequel::Model(:synapse_mutations)) do
+              many_to_one :synapse, class: 'Legion::Extensions::Synapse::Data::Model::Synapse',
+                                    key:   :synapse_id
+            end
+            klass.set_primary_key :id
+            const_set(:SynapseMutation, klass)
           end
         end
       end

data/lib/legion/extensions/synapse/data/models/synapse_signal.rb

@@ -5,8 +5,19 @@ module Legion
     module Synapse
       module Data
         module Model
-          class SynapseSignal < Sequel::Model(:synapse_signals)
-            many_to_one :synapse, class: 'Legion::Extensions::Synapse::Data::Model::Synapse'
+          def self.define_synapse_signal_model
+            return if const_defined?(:SynapseSignal, false)
+            return unless defined?(Legion::Data) && Legion::Settings.dig(:data, :connected)
+
+            db = Sequel::Model.db
+            return unless db&.table_exists?(:synapse_signals)
+
+            klass = Class.new(Sequel::Model(:synapse_signals)) do
+              many_to_one :synapse, class: 'Legion::Extensions::Synapse::Data::Model::Synapse',
+                                    key:   :synapse_id
+            end
+            klass.set_primary_key :id
+            const_set(:SynapseSignal, klass)
           end
         end
       end

data/lib/legion/extensions/synapse/helpers/relationship_wrapper.rb

@@ -10,6 +10,7 @@ module Legion
         module RelationshipWrapper
           class << self
             def wrap(relationship)
+              Data::Model.define_synapse_model
               existing = Data::Model::Synapse.where(relationship_id: relationship[:id]).first
               return existing if existing
 
@@ -27,6 +28,7 @@ module Legion
             end
 
             def unwrap(synapse_id)
+              Data::Model.define_synapse_model
               synapse = Data::Model::Synapse[synapse_id]
               return { success: false, error: 'synapse not found' } unless synapse
               return { success: false, error: 'not a wrapped relationship' } unless synapse.relationship_id

data/lib/legion/extensions/synapse/runners/crystallize.rb

@@ -11,6 +11,7 @@ module Legion
           EMERGENCE_THRESHOLD = 20
 
           def crystallize(signal_pairs: [], threshold: EMERGENCE_THRESHOLD)
+            Data::Model.define_synapse_model
             created = []
 
             signal_pairs.each do |pair|

data/lib/legion/extensions/synapse/runners/dream.rb

@@ -10,6 +10,8 @@ module Legion
       module Runners
         module Dream
           def dream_replay(synapse_id: nil, **)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_mutation_model
             synapses = if synapse_id
                          s = Data::Model::Synapse[synapse_id]
                          s ? [s] : []
@@ -27,6 +29,7 @@ module Legion
           end
 
           def dream_simulate(synapse_id:, mutation_type:, changes:, **)
+            Data::Model.define_synapse_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
 

data/lib/legion/extensions/synapse/runners/evaluate.rb

@@ -2,6 +2,7 @@
 
 require_relative '../helpers/confidence'
 require_relative '../data/models/synapse'
+require_relative '../data/models/synapse_mutation'
 require_relative '../data/models/synapse_signal'
 
 module Legion
@@ -10,6 +11,8 @@ module Legion
       module Runners
         module Evaluate
           def evaluate(synapse_id:, payload: {}, conditioner_client: nil, transformer_client: nil)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_signal_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
             return { success: false, error: 'synapse not active' } unless Helpers::Confidence::EVALUABLE_STATUSES.include?(synapse.status)

data/lib/legion/extensions/synapse/runners/gaia_report.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative '../data/models/synapse'
+require_relative '../data/models/synapse_mutation'
 require_relative '../data/models/synapse_signal'
 require_relative '../helpers/confidence'
 
@@ -10,6 +11,7 @@ module Legion
       module Runners
         module GaiaReport
           def gaia_summary(**)
+            Data::Model.define_synapse_model
             synapses = Data::Model::Synapse.all
             active = synapses.select { |s| s.status == 'active' }
             dampened = synapses.select { |s| s.status == 'dampened' }
@@ -32,6 +34,7 @@ module Legion
           end
 
           def gaia_reflection(**)
+            Data::Model.define_synapse_mutation_model
             summary = gaia_summary
             recent_mutations = Data::Model::SynapseMutation
                                .where { created_at >= Time.now - 3600 }

data/lib/legion/extensions/synapse/runners/mutate.rb

@@ -12,6 +12,8 @@ module Legion
           VALID_TRIGGERS = %w[hebbian pain dream gaia manual].freeze
 
           def mutate(synapse_id:, mutation_type:, changes:, trigger:)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_mutation_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
             return { success: false, error: "invalid mutation_type: #{mutation_type}" } unless VALID_MUTATION_TYPES.include?(mutation_type)

data/lib/legion/extensions/synapse/runners/pain.rb

@@ -12,6 +12,8 @@ module Legion
           CONSECUTIVE_FAILURE_THRESHOLD = 3
 
           def handle_pain(synapse_id:, task_id: nil)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_signal_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
 

data/lib/legion/extensions/synapse/runners/promote.rb

@@ -12,6 +12,8 @@ module Legion
           STABILITY_HOURS = 24
 
           def promote(synapse_id: nil, **)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_mutation_model
             candidates = if synapse_id
                            s = Data::Model::Synapse[synapse_id]
                            s ? [s] : []

data/lib/legion/extensions/synapse/runners/report.rb

@@ -10,6 +10,9 @@ module Legion
       module Runners
         module Report
           def report(synapse_id:)
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_mutation_model
+            Data::Model.define_synapse_signal_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
 

data/lib/legion/extensions/synapse/runners/retrieve.rb

@@ -11,6 +11,7 @@ module Legion
           SEED_CONFIDENCE_THRESHOLD = 0.7
 
           def retrieve_and_seed(knowledge_entries:, **)
+            Data::Model.define_synapse_model
             seeded = []
 
             knowledge_entries.each do |entry|

data/lib/legion/extensions/synapse/runners/revert.rb

@@ -9,6 +9,8 @@ module Legion
       module Runners
         module Revert
           def revert(synapse_id:, to_version: nil, trigger: 'pain')
+            Data::Model.define_synapse_model
+            Data::Model.define_synapse_mutation_model
             synapse = Data::Model::Synapse[synapse_id]
             return { success: false, error: 'synapse not found' } unless synapse
 

data/lib/legion/extensions/synapse/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Synapse
-      VERSION = '0.2.2'
+      VERSION = '0.2.3'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-synapse
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Esity