lex-apollo 0.4.16 → 0.4.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c57e41cb0b9936b5b3933e847385ff6eed5581c29b2bd53ee15bab8d04972634
-  data.tar.gz: 0a48e91fafd9a6116e47b9c0e2c6fc411f915930669ad6b182e55b37fe7e26bf
+  metadata.gz: 87724ea9011349f5f7c008a360728975567903827b5cdcf9a42e2678ca84b134
+  data.tar.gz: ae10f48baf9522bd7087a20e1886fc26170c1f5e0a0c36a3ccac26c836f11885
 SHA512:
-  metadata.gz: e781def1a51ef817fb607300bd5439844289ad8d8a77de4ef103d6187c01a4681ee1cf2db917b03adf3df7898b6ab05b4f0a7330631fee6d4e5fa54a3054f805
-  data.tar.gz: 1f392189d7e2b42da4bfcf1d92d980e2b813b68fb6c88e18c275b57afdf5cb741d84311fd5092f8552ef7c18f62f660e2a197f79cfd8c7bcde709fe474aa368e
+  metadata.gz: b21c5413da8dfe9f60d9845a578bcfe8337982d128a5041df214004e144b9913dd34cd2da1514a30ea67e21d52604a11218c362a46f9c990c472ac4ec14a0fa9
+  data.tar.gz: ae07a4aba39ce05f20b6a495310b6a20c1c468e0d627393ab931af76d9cd57da5b52075a33706a8b94fadae01c32b65d818d4f5c1018f9eac08a8ffdc10c7ace

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.4.18] - 2026-04-24
+
+### Fixed
+- `store_knowledge`, `query_knowledge`, `related_entries` now execute directly when PostgreSQL is available instead of returning unexecuted command hashes — MCP tool calls were returning dispatch payloads (`{action: :query, ...}`) as their result, making the knowledge base unsearchable via LLM tools
+- `query_knowledge` and `retrieve_relevant` now include `candidate` status in default search filters so newly stored entries are immediately retrievable (previously only `confirmed` entries were returned)
+
+### Changed
+- Reduce `POWER_LAW_ALPHA` from 0.5 to 0.05 — decay was compounding hourly and crushing entry confidence within a day
+- Reduce `DECAY_THRESHOLD` from 0.1 to 0.05 — entries were being archived too eagerly
+- Decay cycle now operates on age in **days** instead of hours, preventing aggressive per-cycle compounding
+- Add `DECAY_MIN_AGE_HOURS` (168h / 7 days) — entries younger than this are completely exempt from decay and archival
+- `apply_decay` Ruby helper matches the new SQL behavior (days-based, minimum age guard)
+
+## [0.4.17] - 2026-04-03
+
+### Changed
+- resolve rubocop Style/IfUnlessModifier offense in runners/knowledge.rb
+
 ## [0.4.16] - 2026-03-30
 
 ### Changed

data/lib/legion/extensions/apollo/helpers/confidence.rb

@@ -8,12 +8,13 @@ module Legion
           INITIAL_CONFIDENCE = 0.5
           CORROBORATION_BOOST = 0.3
           RETRIEVAL_BOOST = 0.02
-          POWER_LAW_ALPHA = 0.5
-          DECAY_THRESHOLD = 0.1
+          POWER_LAW_ALPHA = 0.05
+          DECAY_THRESHOLD = 0.05
           CORROBORATION_SIMILARITY_THRESHOLD = 0.9
           WRITE_CONFIDENCE_GATE = 0.6
           WRITE_NOVELTY_GATE = 0.3
           STALE_DAYS = 90
+          DECAY_MIN_AGE_HOURS = 168
           CONTENT_TYPES = %i[fact concept procedure association observation].freeze
           STATUSES = %w[candidate confirmed disputed decayed archived].freeze
           RELATION_TYPES = %w[is_a has_a part_of causes similar_to contradicts supersedes depends_on].freeze
@@ -41,14 +42,18 @@ module Legion
           def write_confidence_gate  = apollo_setting(:confidence, :write_gate, default: WRITE_CONFIDENCE_GATE)
           def write_novelty_gate     = apollo_setting(:confidence, :novelty_gate, default: WRITE_NOVELTY_GATE)
           def stale_days             = apollo_setting(:stale_days, default: STALE_DAYS)
+          def decay_min_age_hours    = apollo_setting(:decay_min_age_hours, default: DECAY_MIN_AGE_HOURS)
 
           def corroboration_similarity_threshold
             apollo_setting(:confidence, :corroboration_similarity, default: CORROBORATION_SIMILARITY_THRESHOLD)
           end
 
           def apply_decay(confidence:, age_hours: nil, alpha: power_law_alpha, **)
+            return confidence if age_hours && age_hours < decay_min_age_hours
+
             if age_hours
-              [confidence * ((age_hours.clamp(0, Float::INFINITY) + 2.0)**(-alpha)) / ((age_hours.clamp(0, Float::INFINITY) + 1.0)**(-alpha)), 0.0].max
+              age_days = age_hours / 24.0
+              [confidence * ((age_days.clamp(1, Float::INFINITY) + 1.0)**(-alpha)) / (age_days.clamp(1, Float::INFINITY)**(-alpha)), 0.0].max
             else
               factor = 1.0 / (1.0 + alpha)
               [confidence * factor, 0.0].max

data/lib/legion/extensions/apollo/runners/knowledge.rb

@@ -20,6 +20,11 @@ module Legion
               raise ArgumentError, "invalid content_type: #{content_type}. Must be one of #{Helpers::Confidence::CONTENT_TYPES}"
             end
 
+            if defined?(Legion::Data::Model::ApolloEntry)
+              return handle_ingest(content: content, content_type: content_type,
+                                   tags: Array(tags), source_agent: source_agent, context: context, **)
+            end
+
             {
               action:       :store,
               content:      content,
@@ -30,7 +35,12 @@ module Legion
             }
           end
 
-          def query_knowledge(query:, limit: Helpers::GraphQuery.default_query_limit, min_confidence: Helpers::GraphQuery.default_query_min_confidence, status: [:confirmed], tags: nil, **) # rubocop:disable Layout/LineLength
+          def query_knowledge(query:, limit: Helpers::GraphQuery.default_query_limit, min_confidence: Helpers::GraphQuery.default_query_min_confidence, status: %i[confirmed candidate], tags: nil, **) # rubocop:disable Layout/LineLength
+            if defined?(Legion::Data::Model::ApolloEntry)
+              return handle_query(query: query, limit: limit, min_confidence: min_confidence,
+                                  status: status, tags: tags, **)
+            end
+
             {
               action:         :query,
               query:          query,
@@ -42,6 +52,8 @@ module Legion
           end
 
           def related_entries(entry_id:, relation_types: nil, depth: Helpers::GraphQuery.default_depth, **)
+            return handle_traverse(entry_id: entry_id, depth: depth, relation_types: relation_types, **) if defined?(Legion::Data::Model::ApolloEntry)
+
             {
               action:         :traverse,
               entry_id:       entry_id,
@@ -121,6 +133,7 @@ module Legion
           def handle_query(query:, limit: Helpers::GraphQuery.default_query_limit, min_confidence: Helpers::GraphQuery.default_query_min_confidence, status: [:confirmed], tags: nil, domain: nil, agent_id: 'unknown', **) # rubocop:disable Layout/LineLength
             return { success: false, error: 'apollo_data_not_available' } unless defined?(Legion::Data::Model::ApolloEntry)
 
+            query = normalize_text_input(query)
             embedding = embed_text(query)
             sql = Helpers::GraphQuery.build_semantic_search_sql(
               limit: limit, min_confidence: min_confidence,
@@ -228,12 +241,13 @@ module Legion
 
             return { success: false, error: 'apollo_data_not_available' } unless defined?(Legion::Data::Model::ApolloEntry)
 
+            query = normalize_text_input(query)
             return { success: true, entries: [], count: 0 } if query.nil? || query.to_s.strip.empty?
 
-            embedding = embed_text(query.to_s)
+            embedding = embed_text(query)
             sql = Helpers::GraphQuery.build_semantic_search_sql(
               limit: limit, min_confidence: min_confidence,
-              statuses: ['confirmed'], tags: tags, domain: domain
+              statuses: %w[confirmed candidate], tags: tags, domain: domain
             )
 
             db = Legion::Data::Model::ApolloEntry.db
@@ -313,6 +327,7 @@ module Legion
           private
 
           def embed_text(text)
+            text = normalize_text_input(text)
             result = Legion::LLM::Embeddings.generate(text: text)
             vector = result.is_a?(Hash) ? result[:vector] : result
             vector.is_a?(Array) && vector.any? ? vector : Array.new(1024, 0.0)
@@ -321,6 +336,15 @@ module Legion
             Array.new(1024, 0.0)
           end
 
+          def normalize_text_input(value)
+            return Legion::Apollo.send(:normalize_text_input, value) if defined?(Legion::Apollo) && Legion::Apollo.respond_to?(:normalize_text_input, true)
+
+            value.to_s
+          rescue StandardError => e
+            log.warn("Apollo Knowledge.normalize_text_input failed: #{e.message}")
+            value.to_s
+          end
+
           def allowed_domains_for(target_domain)
             rules = if defined?(Legion::Settings) && Legion::Settings.dig(:apollo, :domain_isolation)
                       Legion::Settings.dig(:apollo, :domain_isolation)

data/lib/legion/extensions/apollo/runners/maintenance.rb

@@ -23,28 +23,37 @@ module Legion
           def run_decay_cycle(alpha: nil, min_confidence: nil, **)
             alpha ||= Helpers::Confidence.power_law_alpha
             min_confidence ||= Helpers::Confidence.decay_threshold
+            min_age_hours = Helpers::Confidence.decay_min_age_hours
 
             return { decayed: 0, archived: 0 } unless defined?(Legion::Data) && Legion::Data.respond_to?(:connection) && Legion::Data.connection
 
             conn = Legion::Data.connection
 
-            hours_expr = Sequel.lit(
-              'GREATEST(EXTRACT(EPOCH FROM (NOW() - COALESCE(updated_at, created_at))) / 3600.0, 1.0)'
+            age_days_expr = Sequel.lit(
+              'GREATEST(EXTRACT(EPOCH FROM (NOW() - COALESCE(updated_at, created_at))) / 86400.0, 1.0)'
             )
             decay_factor = Sequel.lit(
-              'POWER(CAST(? AS double precision) / (CAST(? AS double precision) + 1.0), ?)', hours_expr, hours_expr, alpha
+              'POWER(CAST(? AS double precision) / (CAST(? AS double precision) + 1.0), ?)',
+              age_days_expr, age_days_expr, alpha
+            )
+
+            min_age_filter = Sequel.lit(
+              "COALESCE(updated_at, created_at) < NOW() - INTERVAL '? hours'", min_age_hours
             )
 
             decayed = conn[:apollo_entries]
                       .exclude(status: 'archived')
+                      .where(min_age_filter)
                       .update(confidence: Sequel[:confidence] * decay_factor)
 
             archived = conn[:apollo_entries]
                        .where { confidence < min_confidence }
+                       .where(min_age_filter)
                        .exclude(status: 'archived')
                        .update(status: 'archived')
 
-            { decayed: decayed, archived: archived, alpha: alpha, threshold: min_confidence }
+            { decayed: decayed, archived: archived, alpha: alpha, threshold: min_confidence,
+              min_age_hours: min_age_hours }
           rescue Sequel::Error => e
             { decayed: 0, archived: 0, error: e.message }
           end

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Apollo
-      VERSION = '0.4.16'
+      VERSION = '0.4.18'
     end
   end
 end

data/spec/legion/extensions/apollo/helpers/confidence_spec.rb

@@ -18,11 +18,15 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Confidence do
     end
 
     it 'defines POWER_LAW_ALPHA' do
-      expect(described_class::POWER_LAW_ALPHA).to eq(0.5)
+      expect(described_class::POWER_LAW_ALPHA).to eq(0.05)
     end
 
     it 'defines DECAY_THRESHOLD' do
-      expect(described_class::DECAY_THRESHOLD).to eq(0.1)
+      expect(described_class::DECAY_THRESHOLD).to eq(0.05)
+    end
+
+    it 'defines DECAY_MIN_AGE_HOURS' do
+      expect(described_class::DECAY_MIN_AGE_HOURS).to eq(168)
     end
 
     it 'defines CORROBORATION_SIMILARITY_THRESHOLD' do
@@ -45,12 +49,17 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Confidence do
   describe '.apply_decay' do
     it 'applies power-law decay with default alpha when no age given' do
       result = described_class.apply_decay(confidence: 1.0)
-      expected = 1.0 / (1.0 + 0.5) # ~0.6667
+      expected = 1.0 / (1.0 + 0.05) # ~0.9524
       expect(result).to be_within(0.0001).of(expected)
     end
 
-    it 'applies age-based power-law decay when age_hours is provided' do
+    it 'skips decay when age_hours is below minimum age' do
       result = described_class.apply_decay(confidence: 1.0, age_hours: 10)
+      expect(result).to eq(1.0)
+    end
+
+    it 'applies age-based power-law decay when age_hours exceeds minimum' do
+      result = described_class.apply_decay(confidence: 1.0, age_hours: 500)
       expect(result).to be > 0.0
       expect(result).to be < 1.0
     end
@@ -98,11 +107,11 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Confidence do
 
   describe '.decayed?' do
     it 'returns true when confidence below threshold' do
-      expect(described_class.decayed?(confidence: 0.05)).to be true
+      expect(described_class.decayed?(confidence: 0.01)).to be true
     end
 
     it 'returns false when confidence at or above threshold' do
-      expect(described_class.decayed?(confidence: 0.1)).to be false
+      expect(described_class.decayed?(confidence: 0.05)).to be false
     end
   end
 

data/spec/legion/extensions/apollo/runners/decay_cycle_spec.rb

@@ -14,11 +14,15 @@ RSpec.describe 'Apollo Decay Cycle' do
 
   describe 'configurable decay parameters' do
     it 'returns POWER_LAW_ALPHA as default' do
-      expect(Legion::Extensions::Apollo::Helpers::Confidence.power_law_alpha).to eq(0.5)
+      expect(Legion::Extensions::Apollo::Helpers::Confidence.power_law_alpha).to eq(0.05)
     end
 
     it 'returns default decay threshold' do
-      expect(Legion::Extensions::Apollo::Helpers::Confidence.decay_threshold).to eq(0.1)
+      expect(Legion::Extensions::Apollo::Helpers::Confidence.decay_threshold).to eq(0.05)
+    end
+
+    it 'returns default decay minimum age hours' do
+      expect(Legion::Extensions::Apollo::Helpers::Confidence.decay_min_age_hours).to eq(168)
     end
   end
 end

data/spec/legion/extensions/apollo/runners/maintenance_spec.rb

@@ -71,7 +71,7 @@ RSpec.describe Legion::Extensions::Apollo::Runners::Maintenance do
 
       it 'returns alpha in result hash' do
         result = host.run_decay_cycle
-        expect(result[:alpha]).to eq(0.5)
+        expect(result[:alpha]).to eq(0.05)
         expect(result).not_to have_key(:rate)
       end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-apollo
 version: !ruby/object:Gem::Version
-  version: 0.4.16
+  version: 0.4.18
 platform: ruby
 authors:
 - Esity
@@ -125,30 +125,30 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-legion
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0'
 description: Durable shared knowledge with vector search, concept graph, and expertise
   tracking
 email: