lex-agentic-inference 0.1.11 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1f50bf66664bcdee5e444a4b0fcde83953fb040d387fdb4c334b00d9410b74d
-  data.tar.gz: fb0bfb4cba7f06a6de06179f0dd879a17854bf5e532fe8273f6f058f1912c2be
+  metadata.gz: 82dc037dc5706c8daa4c1a9a3688a5384f9e4312dd8352dca6a0ff2a13892778
+  data.tar.gz: 689d77694b89d51bfac49e14a01ff7cc99d4e1c4e5235cfc5dbcd6fc6b6f3bb1
 SHA512:
-  metadata.gz: df96d191230ff4dc7ba69b8c2effb445c26e6a8dafefaae46dd30bc1fcb365908fe800c527f54ecac786fd8c42b46f97790e23dcc110c769b84a7c2707b196c6
-  data.tar.gz: cd098aea29e07d96434a2a45012f5affb91637c05ba551e8bcd29eb9aeb1d5d41a2f184e91d3ce7d426fe07501776dc4966bcbdfe918b6dd3b45adb2329dff70
+  metadata.gz: b6aa092e075d7ae2110b1225fe44aa778d647d1a89ccfb421837f1ce06f9ea39dd078dcc594232b6fad8c4246c6421002ccd59bab3882505f77b0c9310bd1e30
+  data.tar.gz: eaba3c1bad5020560999363354687dec884c975c8467f8df01cebf4c98fd5872b421ce858d1bb4b2be3a7c36766b7bf514217986695cffdde4cf37480a9907fe

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0] - 2026-10-29
+### Changed
+- Default prediction clients and runner instances now share process-local state within the same identity partition. Pass `prediction_stores: {}` to a client when independent state ownership is required.
+### Fixed
+- Make prediction resolution single-use so duplicate or conflicting feedback cannot skew accuracy, overwrite accepted outcomes, or emit repeated outcome traces.
+- Keep wrong-identity lookup, resolution, and erasure isolated. This release does not add restart persistence or infer missing caller identity.
+
 ## [0.1.11] - 2026-07-23
 ### Fixed
 - Move `prediction_store` accessor into `Runners::Prediction` module so it works when extended onto RunnerHost (fixes NoMethodError during GAIA heartbeat tick)

data/README.md

@@ -5,7 +5,7 @@ Domain consolidation gem for reasoning, inference, and belief management. Bundle
 ## Overview
 
 **Gem**: `lex-agentic-inference`
-**Version**: 0.1.8
+**Version**: 0.2.0
 **Namespace**: `Legion::Extensions::Agentic::Inference`
 
 ## Sub-Modules
@@ -62,6 +62,22 @@ Domain consolidation gem for reasoning, inference, and belief management. Bundle
 gem 'lex-agentic-inference'
 ```
 
+## Prediction state ownership
+
+Default `Prediction::Client` objects and prediction runners share a process-local
+store for each `identity:`. Use the same verified identity for prediction,
+lookup, resolution, and erasure. Omitting identity selects the shared unscoped
+partition; it is not a substitute for principal attribution.
+
+For an independent standalone client, pass `prediction_stores: {}` to
+`Legion::Extensions::Agentic::Inference::Prediction::Client.new`. That client's
+stores are not visible to default runtime runners.
+
+Only the first resolution of a pending prediction is accepted. Repeated or
+conflicting feedback returns `resolved: false, reason: :already_resolved`;
+unknown IDs in the selected partition return `reason: :not_found`. These
+stores are not durable across process restarts.
+
 ## Development
 
 ```bash

data/lib/legion/extensions/agentic/inference/bayesian/helpers/belief_network.rb

@@ -64,7 +64,7 @@ module Legion
                 subset.to_h { |b| [b.id, b.posterior / total] }
               end
 
-              def information_gain(belief_id:, evidence_id:, likelihood:) # rubocop:disable Lint/UnusedMethodArgument
+              def information_gain(belief_id:, likelihood:)
                 belief = @beliefs[belief_id]
                 return 0.0 unless belief
 
@@ -134,8 +134,8 @@ module Legion
                 prior_q = 1.0 - prior_p
                 post_q  = 1.0 - post_p
 
-                term1 = post_p  * Math.log2(post_p  / prior_p)
-                term2 = post_q  * Math.log2(post_q  / prior_q)
+                term1 = post_p * Math.log2(post_p / prior_p)
+                term2 = post_q * Math.log2(post_q / prior_q)
                 term1 + term2
               end
             end

data/lib/legion/extensions/agentic/inference/bayesian/runners/bayesian_belief.rb

@@ -77,7 +77,7 @@ module Legion
 
               def information_gain(belief_id:, evidence_id:, likelihood:, **)
                 clamped = likelihood.clamp(Helpers::Constants::LIKELIHOOD_FLOOR, Helpers::Constants::LIKELIHOOD_CEILING)
-                gain    = belief_network.information_gain(belief_id: belief_id, evidence_id: evidence_id, likelihood: clamped)
+                gain    = belief_network.information_gain(belief_id: belief_id, likelihood: clamped)
                 log.debug "[bayesian_belief] information_gain: id=#{belief_id[0..7]} likelihood=#{clamped.round(3)} gain=#{gain.round(4)}"
                 { success: true, belief_id: belief_id, evidence_id: evidence_id, likelihood: clamped, information_gain: gain }
               end

data/lib/legion/extensions/agentic/inference/causal_attribution/helpers/attribution.rb

@@ -46,7 +46,7 @@ module Legion
                 @controllability   = controllability
                 @confidence        = confidence.clamp(CONFIDENCE_FLOOR, CONFIDENCE_CEILING)
                 @emotional_response = ATTRIBUTION_EMOTIONS[pattern]
-                @created_at        = Time.now.utc
+                @created_at = Time.now.utc
               end
 
               def pattern

data/lib/legion/extensions/agentic/inference/magnet/helpers/field.rb

@@ -17,7 +17,7 @@ module Legion
                 @pole_ids    = []
                 @alignment   = 0.0
                 @flux_density = 0.0
-                @created_at  = Time.now.utc
+                @created_at = Time.now.utc
               end
 
               def add_pole(pole_id)

data/lib/legion/extensions/agentic/inference/prediction/client.rb

@@ -12,8 +12,8 @@ module Legion
           class Client
             include Runners::Prediction
 
-            def initialize(**)
-              @prediction_stores = {}
+            def initialize(prediction_stores: nil, **)
+              @prediction_stores = prediction_stores
             end
           end
         end

data/lib/legion/extensions/agentic/inference/prediction/helpers/prediction_store.rb

@@ -9,12 +9,20 @@ module Legion
         module Prediction
           module Helpers
             class PredictionStore
+              @stores = {} # rubocop:disable ThreadSafety/MutableClassInstanceVariable -- Registry access is protected by @stores_mutex.
+              @stores_mutex = Mutex.new
+
+              def self.for_identity(identity:)
+                @stores_mutex.synchronize { @stores[identity] ||= new(identity: identity) }
+              end
+
               attr_reader :predictions, :outcomes, :identity
 
               def initialize(identity: nil)
                 @identity = identity
                 @predictions = {}
                 @outcomes = []
+                @mutex = Mutex.new
               end
 
               def store(prediction)
@@ -31,16 +39,18 @@ module Legion
               end
 
               def resolve(prediction_id, outcome:, actual: nil)
-                pred = @predictions[prediction_id]
-                return nil unless pred
+                @mutex.synchronize do
+                  pred = @predictions[prediction_id]
+                  return nil unless pred && pred[:status] == :pending
 
-                pred[:status] = outcome # :correct, :incorrect, :partial, :expired
-                pred[:resolved_at] = Time.now.utc
-                pred[:actual] = actual
+                  pred[:status] = outcome # :correct, :incorrect, :partial, :expired
+                  pred[:resolved_at] = Time.now.utc
+                  pred[:actual] = actual
 
-                @outcomes << { prediction_id: prediction_id, outcome: outcome, at: Time.now.utc }
-                @outcomes.shift while @outcomes.size > 500
-                pred
+                  @outcomes << { prediction_id: prediction_id, outcome: outcome, at: pred[:resolved_at] }
+                  @outcomes.shift while @outcomes.size > 500
+                  pred
+                end
               end
 
               def pending

data/lib/legion/extensions/agentic/inference/prediction/runners/prediction.rb

@@ -53,8 +53,9 @@ module Legion
                   record_outcome_trace(pred, outcome)
                   { resolved: true, prediction_id: prediction_id, outcome: outcome }
                 else
-                  log.debug "[prediction] resolve failed: #{prediction_id[0..7]} not found"
-                  { resolved: false, reason: :not_found }
+                  reason = store.get(prediction_id) ? :already_resolved : :not_found
+                  log.debug "[prediction] resolve failed: #{prediction_id[0..7]} #{reason}"
+                  { resolved: false, reason: reason }
                 end
               end
 
@@ -81,8 +82,7 @@ module Legion
                   age = Time.now.utc - pred[:created_at]
                   next unless age > pred[:horizon]
 
-                  store.resolve(pred[:prediction_id], outcome: :expired, actual: nil)
-                  expired_count += 1
+                  expired_count += 1 if store.resolve(pred[:prediction_id], outcome: :expired, actual: nil)
                 end
 
                 remaining = store.pending.size
@@ -105,8 +105,9 @@ module Legion
               end
 
               def prediction_store(identity: nil)
-                @prediction_stores ||= {}
-                @prediction_stores[identity] ||= Helpers::PredictionStore.new(identity: identity)
+                return @prediction_stores[identity] ||= Helpers::PredictionStore.new(identity: identity) if @prediction_stores
+
+                Helpers::PredictionStore.for_identity(identity: identity)
               end
 
               def estimate_confidence(mode, context)

data/lib/legion/extensions/agentic/inference/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Inference
-        VERSION = '0.1.11'
+        VERSION = '0.2.0'
       end
     end
   end

data/spec/legion/extensions/agentic/inference/bayesian/helpers/belief_network_spec.rb

@@ -111,19 +111,19 @@ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Belief
   describe '#information_gain' do
     it 'returns a non-negative float' do
       belief = add
-      gain = network.information_gain(belief_id: belief.id, evidence_id: 'ev-1', likelihood: 0.9)
+      gain = network.information_gain(belief_id: belief.id, likelihood: 0.9)
       expect(gain).to be >= 0.0
     end
 
     it 'returns 0.0 for unknown belief' do
-      gain = network.information_gain(belief_id: 'nonexistent', evidence_id: 'ev-1', likelihood: 0.8)
+      gain = network.information_gain(belief_id: 'nonexistent', likelihood: 0.8)
       expect(gain).to eq(0.0)
     end
 
     it 'does not mutate the belief posterior' do
       belief = add
       before = belief.posterior
-      network.information_gain(belief_id: belief.id, evidence_id: 'ev-1', likelihood: 0.9)
+      network.information_gain(belief_id: belief.id, likelihood: 0.9)
       expect(belief.posterior).to eq(before)
     end
 
@@ -131,8 +131,8 @@ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Belief
       b1 = add(content: 'h1')
       b2 = add(content: 'h2')
 
-      gain_strong = network.information_gain(belief_id: b1.id, evidence_id: 'ev', likelihood: 0.95)
-      gain_weak   = network.information_gain(belief_id: b2.id, evidence_id: 'ev', likelihood: 0.55)
+      gain_strong = network.information_gain(belief_id: b1.id, likelihood: 0.95)
+      gain_weak   = network.information_gain(belief_id: b2.id, likelihood: 0.55)
       expect(gain_strong).to be > gain_weak
     end
   end

data/spec/legion/extensions/agentic/inference/prediction/runners/prediction_identity_spec.rb

@@ -3,7 +3,7 @@
 require 'legion/extensions/agentic/inference/prediction/client'
 
 RSpec.describe Legion::Extensions::Agentic::Inference::Prediction::Runners::Prediction do
-  let(:client) { Legion::Extensions::Agentic::Inference::Prediction::Client.new }
+  let(:client) { Legion::Extensions::Agentic::Inference::Prediction::Client.new(prediction_stores: {}) }
 
   describe 'per-identity isolation' do
     it 'predictions for identity X are not visible to identity Y' do
@@ -42,6 +42,38 @@ RSpec.describe Legion::Extensions::Agentic::Inference::Prediction::Runners::Pred
     end
   end
 
+  describe 'shared runtime state' do
+    let(:identity) { SecureRandom.uuid }
+    let(:other_identity) { SecureRandom.uuid }
+    let(:producer) { Legion::Extensions::Agentic::Inference::Prediction::Client.new }
+    let(:consumer) { Object.new.extend(described_class) }
+
+    after do
+      producer.erase_partner!(identity: identity)
+      producer.erase_partner!(identity: other_identity)
+    end
+
+    it 'resolves a client prediction through separate runner instances without crossing identities' do
+      prediction = producer.predict(mode: :functional_mapping, confidence: 0.9, identity: identity)
+      other = producer.predict(mode: :functional_mapping, identity: other_identity)
+
+      expect(consumer.pending_predictions(identity: identity)[:predictions].map { |entry| entry[:prediction_id] })
+        .to eq([prediction[:prediction_id]])
+      expect(consumer.resolve_prediction(prediction_id: prediction[:prediction_id], outcome: :incorrect,
+                                         identity: other_identity)).to include(resolved: false, reason: :not_found)
+
+      resolver = Object.new.extend(described_class)
+      resolver.resolve_prediction(prediction_id: prediction[:prediction_id], outcome: :correct, identity: identity)
+
+      expect(producer.prediction_accuracy(identity: identity)).to eq(accuracy: 1.0, total_outcomes: 1)
+      expect(producer.pending_predictions(identity: identity)[:predictions]).to be_empty
+      expect(consumer.get_prediction(prediction_id: other[:prediction_id], identity: other_identity)[:prediction])
+        .to include(status: :pending)
+      consumer.erase_partner!(identity: identity)
+      expect(producer.get_prediction(prediction_id: prediction[:prediction_id], identity: identity)[:found]).to be false
+    end
+  end
+
   describe '#erase_partner!' do
     it 'removes all predictions and outcomes for the identity' do
       3.times do

data/spec/legion/extensions/agentic/inference/prediction/runners/prediction_spec.rb

@@ -3,7 +3,7 @@
 require 'legion/extensions/agentic/inference/prediction/client'
 
 RSpec.describe Legion::Extensions::Agentic::Inference::Prediction::Runners::Prediction do
-  let(:client) { Legion::Extensions::Agentic::Inference::Prediction::Client.new }
+  let(:client) { Legion::Extensions::Agentic::Inference::Prediction::Client.new(prediction_stores: {}) }
 
   describe '#predict' do
     it 'creates a prediction with valid mode' do
@@ -45,6 +45,22 @@ RSpec.describe Legion::Extensions::Agentic::Inference::Prediction::Runners::Pred
       result = client.resolve_prediction(prediction_id: 'nonexistent', outcome: :correct)
       expect(result[:resolved]).to be false
     end
+
+    it 'counts a prediction outcome once and preserves the first resolution' do
+      correct = client.predict(mode: :functional_mapping)
+      incorrect = client.predict(mode: :functional_mapping)
+      client.resolve_prediction(prediction_id: correct[:prediction_id], outcome: :correct, actual: 'observed')
+      client.resolve_prediction(prediction_id: incorrect[:prediction_id], outcome: :incorrect)
+
+      repeated = client.resolve_prediction(prediction_id: correct[:prediction_id], outcome: :correct)
+      conflicting = client.resolve_prediction(prediction_id: correct[:prediction_id], outcome: :incorrect)
+
+      expect(repeated).to include(resolved: false, reason: :already_resolved)
+      expect(conflicting).to include(resolved: false, reason: :already_resolved)
+      expect(client.prediction_accuracy).to eq(accuracy: 0.5, total_outcomes: 2)
+      expect(client.get_prediction(prediction_id: correct[:prediction_id])[:prediction])
+        .to include(status: :correct, actual: 'observed')
+    end
   end
 
   describe '#pending_predictions' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-inference
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.2.0
 platform: ruby
 authors:
 - Esity