lex-agentic-inference 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (328) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +12 -0
  3. data/Gemfile +5 -0
  4. data/LICENSE +21 -0
  5. data/README.md +13 -0
  6. data/lex-agentic-inference.gemspec +30 -0
  7. data/lib/legion/extensions/agentic/inference/abductive/client.rb +25 -0
  8. data/lib/legion/extensions/agentic/inference/abductive/helpers/abduction_engine.rb +164 -0
  9. data/lib/legion/extensions/agentic/inference/abductive/helpers/constants.rb +39 -0
  10. data/lib/legion/extensions/agentic/inference/abductive/helpers/hypothesis.rb +106 -0
  11. data/lib/legion/extensions/agentic/inference/abductive/helpers/observation.rb +39 -0
  12. data/lib/legion/extensions/agentic/inference/abductive/runners/abductive_reasoning.rb +129 -0
  13. data/lib/legion/extensions/agentic/inference/abductive/version.rb +13 -0
  14. data/lib/legion/extensions/agentic/inference/abductive.rb +20 -0
  15. data/lib/legion/extensions/agentic/inference/affordance/actors/scan.rb +31 -0
  16. data/lib/legion/extensions/agentic/inference/affordance/client.rb +28 -0
  17. data/lib/legion/extensions/agentic/inference/affordance/helpers/affordance_field.rb +123 -0
  18. data/lib/legion/extensions/agentic/inference/affordance/helpers/affordance_item.rb +75 -0
  19. data/lib/legion/extensions/agentic/inference/affordance/helpers/constants.rb +42 -0
  20. data/lib/legion/extensions/agentic/inference/affordance/runners/affordance.rb +90 -0
  21. data/lib/legion/extensions/agentic/inference/affordance/version.rb +13 -0
  22. data/lib/legion/extensions/agentic/inference/affordance.rb +19 -0
  23. data/lib/legion/extensions/agentic/inference/analogical/client.rb +28 -0
  24. data/lib/legion/extensions/agentic/inference/analogical/helpers/analogy_engine.rb +209 -0
  25. data/lib/legion/extensions/agentic/inference/analogical/helpers/constants.rb +38 -0
  26. data/lib/legion/extensions/agentic/inference/analogical/helpers/structure_map.rb +113 -0
  27. data/lib/legion/extensions/agentic/inference/analogical/runners/analogical_reasoning.rb +106 -0
  28. data/lib/legion/extensions/agentic/inference/analogical/version.rb +13 -0
  29. data/lib/legion/extensions/agentic/inference/analogical.rb +19 -0
  30. data/lib/legion/extensions/agentic/inference/argument_mapping/client.rb +19 -0
  31. data/lib/legion/extensions/agentic/inference/argument_mapping/helpers/argument.rb +102 -0
  32. data/lib/legion/extensions/agentic/inference/argument_mapping/helpers/argument_engine.rb +131 -0
  33. data/lib/legion/extensions/agentic/inference/argument_mapping/helpers/constants.rb +44 -0
  34. data/lib/legion/extensions/agentic/inference/argument_mapping/runners/argument_mapping.rb +78 -0
  35. data/lib/legion/extensions/agentic/inference/argument_mapping/version.rb +13 -0
  36. data/lib/legion/extensions/agentic/inference/argument_mapping.rb +19 -0
  37. data/lib/legion/extensions/agentic/inference/bayesian/client.rb +28 -0
  38. data/lib/legion/extensions/agentic/inference/bayesian/helpers/belief.rb +96 -0
  39. data/lib/legion/extensions/agentic/inference/bayesian/helpers/belief_network.rb +147 -0
  40. data/lib/legion/extensions/agentic/inference/bayesian/helpers/constants.rb +36 -0
  41. data/lib/legion/extensions/agentic/inference/bayesian/runners/bayesian_belief.rb +125 -0
  42. data/lib/legion/extensions/agentic/inference/bayesian/version.rb +13 -0
  43. data/lib/legion/extensions/agentic/inference/bayesian.rb +19 -0
  44. data/lib/legion/extensions/agentic/inference/belief_revision/client.rb +19 -0
  45. data/lib/legion/extensions/agentic/inference/belief_revision/helpers/belief.rb +155 -0
  46. data/lib/legion/extensions/agentic/inference/belief_revision/helpers/belief_network.rb +193 -0
  47. data/lib/legion/extensions/agentic/inference/belief_revision/helpers/constants.rb +54 -0
  48. data/lib/legion/extensions/agentic/inference/belief_revision/helpers/evidence.rb +49 -0
  49. data/lib/legion/extensions/agentic/inference/belief_revision/runners/belief_revision.rb +89 -0
  50. data/lib/legion/extensions/agentic/inference/belief_revision/version.rb +13 -0
  51. data/lib/legion/extensions/agentic/inference/belief_revision.rb +21 -0
  52. data/lib/legion/extensions/agentic/inference/causal_attribution/client.rb +27 -0
  53. data/lib/legion/extensions/agentic/inference/causal_attribution/helpers/attribution.rb +92 -0
  54. data/lib/legion/extensions/agentic/inference/causal_attribution/helpers/attribution_engine.rb +159 -0
  55. data/lib/legion/extensions/agentic/inference/causal_attribution/runners/causal_attribution.rb +111 -0
  56. data/lib/legion/extensions/agentic/inference/causal_attribution/version.rb +13 -0
  57. data/lib/legion/extensions/agentic/inference/causal_attribution.rb +18 -0
  58. data/lib/legion/extensions/agentic/inference/causal_reasoning/client.rb +24 -0
  59. data/lib/legion/extensions/agentic/inference/causal_reasoning/helpers/causal_edge.rb +101 -0
  60. data/lib/legion/extensions/agentic/inference/causal_reasoning/helpers/causal_graph.rb +184 -0
  61. data/lib/legion/extensions/agentic/inference/causal_reasoning/helpers/constants.rb +40 -0
  62. data/lib/legion/extensions/agentic/inference/causal_reasoning/runners/causal_reasoning.rb +111 -0
  63. data/lib/legion/extensions/agentic/inference/causal_reasoning/version.rb +13 -0
  64. data/lib/legion/extensions/agentic/inference/causal_reasoning.rb +19 -0
  65. data/lib/legion/extensions/agentic/inference/coherence/client.rb +28 -0
  66. data/lib/legion/extensions/agentic/inference/coherence/helpers/coherence_engine.rb +170 -0
  67. data/lib/legion/extensions/agentic/inference/coherence/helpers/constants.rb +35 -0
  68. data/lib/legion/extensions/agentic/inference/coherence/helpers/proposition.rb +100 -0
  69. data/lib/legion/extensions/agentic/inference/coherence/runners/cognitive_coherence.rb +123 -0
  70. data/lib/legion/extensions/agentic/inference/coherence/version.rb +13 -0
  71. data/lib/legion/extensions/agentic/inference/coherence.rb +19 -0
  72. data/lib/legion/extensions/agentic/inference/counterfactual/client.rb +19 -0
  73. data/lib/legion/extensions/agentic/inference/counterfactual/helpers/constants.rb +40 -0
  74. data/lib/legion/extensions/agentic/inference/counterfactual/helpers/counterfactual_engine.rb +157 -0
  75. data/lib/legion/extensions/agentic/inference/counterfactual/helpers/scenario.rb +98 -0
  76. data/lib/legion/extensions/agentic/inference/counterfactual/runners/counterfactual.rb +106 -0
  77. data/lib/legion/extensions/agentic/inference/counterfactual/version.rb +13 -0
  78. data/lib/legion/extensions/agentic/inference/counterfactual.rb +19 -0
  79. data/lib/legion/extensions/agentic/inference/debugging/client.rb +30 -0
  80. data/lib/legion/extensions/agentic/inference/debugging/helpers/causal_trace.rb +51 -0
  81. data/lib/legion/extensions/agentic/inference/debugging/helpers/constants.rb +58 -0
  82. data/lib/legion/extensions/agentic/inference/debugging/helpers/correction.rb +56 -0
  83. data/lib/legion/extensions/agentic/inference/debugging/helpers/debugging_engine.rb +156 -0
  84. data/lib/legion/extensions/agentic/inference/debugging/helpers/reasoning_error.rb +97 -0
  85. data/lib/legion/extensions/agentic/inference/debugging/runners/cognitive_debugging.rb +178 -0
  86. data/lib/legion/extensions/agentic/inference/debugging/version.rb +13 -0
  87. data/lib/legion/extensions/agentic/inference/debugging.rb +21 -0
  88. data/lib/legion/extensions/agentic/inference/enactive_cognition/client.rb +27 -0
  89. data/lib/legion/extensions/agentic/inference/enactive_cognition/helpers/enaction_engine.rb +120 -0
  90. data/lib/legion/extensions/agentic/inference/enactive_cognition/helpers/sensorimotor_loop.rb +122 -0
  91. data/lib/legion/extensions/agentic/inference/enactive_cognition/runners/enactive_cognition.rb +124 -0
  92. data/lib/legion/extensions/agentic/inference/enactive_cognition/version.rb +13 -0
  93. data/lib/legion/extensions/agentic/inference/enactive_cognition.rb +18 -0
  94. data/lib/legion/extensions/agentic/inference/expectation_violation/helpers/client.rb +17 -0
  95. data/lib/legion/extensions/agentic/inference/expectation_violation/helpers/constants.rb +47 -0
  96. data/lib/legion/extensions/agentic/inference/expectation_violation/helpers/expectation.rb +82 -0
  97. data/lib/legion/extensions/agentic/inference/expectation_violation/helpers/violation_engine.rb +126 -0
  98. data/lib/legion/extensions/agentic/inference/expectation_violation/runners/expectation_violation.rb +76 -0
  99. data/lib/legion/extensions/agentic/inference/expectation_violation/version.rb +13 -0
  100. data/lib/legion/extensions/agentic/inference/expectation_violation.rb +19 -0
  101. data/lib/legion/extensions/agentic/inference/free_energy/client.rb +19 -0
  102. data/lib/legion/extensions/agentic/inference/free_energy/helpers/belief.rb +127 -0
  103. data/lib/legion/extensions/agentic/inference/free_energy/helpers/constants.rb +58 -0
  104. data/lib/legion/extensions/agentic/inference/free_energy/helpers/free_energy_engine.rb +156 -0
  105. data/lib/legion/extensions/agentic/inference/free_energy/runners/free_energy.rb +97 -0
  106. data/lib/legion/extensions/agentic/inference/free_energy/version.rb +13 -0
  107. data/lib/legion/extensions/agentic/inference/free_energy.rb +19 -0
  108. data/lib/legion/extensions/agentic/inference/gravity/client.rb +29 -0
  109. data/lib/legion/extensions/agentic/inference/gravity/helpers/attractor.rb +77 -0
  110. data/lib/legion/extensions/agentic/inference/gravity/helpers/constants.rb +76 -0
  111. data/lib/legion/extensions/agentic/inference/gravity/helpers/gravity_engine.rb +164 -0
  112. data/lib/legion/extensions/agentic/inference/gravity/helpers/orbiting_thought.rb +64 -0
  113. data/lib/legion/extensions/agentic/inference/gravity/runners/gravity.rb +132 -0
  114. data/lib/legion/extensions/agentic/inference/gravity/version.rb +13 -0
  115. data/lib/legion/extensions/agentic/inference/gravity.rb +20 -0
  116. data/lib/legion/extensions/agentic/inference/horizon/actors/adjust.rb +45 -0
  117. data/lib/legion/extensions/agentic/inference/horizon/client.rb +28 -0
  118. data/lib/legion/extensions/agentic/inference/horizon/helpers/constants.rb +43 -0
  119. data/lib/legion/extensions/agentic/inference/horizon/helpers/horizon_engine.rb +110 -0
  120. data/lib/legion/extensions/agentic/inference/horizon/helpers/projection.rb +59 -0
  121. data/lib/legion/extensions/agentic/inference/horizon/runners/cognitive_horizon.rb +107 -0
  122. data/lib/legion/extensions/agentic/inference/horizon/version.rb +13 -0
  123. data/lib/legion/extensions/agentic/inference/horizon.rb +19 -0
  124. data/lib/legion/extensions/agentic/inference/hypothesis_testing/client.rb +28 -0
  125. data/lib/legion/extensions/agentic/inference/hypothesis_testing/helpers/constants.rb +37 -0
  126. data/lib/legion/extensions/agentic/inference/hypothesis_testing/helpers/hypothesis.rb +83 -0
  127. data/lib/legion/extensions/agentic/inference/hypothesis_testing/helpers/hypothesis_engine.rb +97 -0
  128. data/lib/legion/extensions/agentic/inference/hypothesis_testing/runners/hypothesis_testing.rb +115 -0
  129. data/lib/legion/extensions/agentic/inference/hypothesis_testing/version.rb +13 -0
  130. data/lib/legion/extensions/agentic/inference/hypothesis_testing.rb +19 -0
  131. data/lib/legion/extensions/agentic/inference/intuition/client.rb +19 -0
  132. data/lib/legion/extensions/agentic/inference/intuition/helpers/constants.rb +60 -0
  133. data/lib/legion/extensions/agentic/inference/intuition/helpers/heuristic.rb +66 -0
  134. data/lib/legion/extensions/agentic/inference/intuition/helpers/intuition_engine.rb +157 -0
  135. data/lib/legion/extensions/agentic/inference/intuition/helpers/pattern.rb +105 -0
  136. data/lib/legion/extensions/agentic/inference/intuition/runners/intuition.rb +87 -0
  137. data/lib/legion/extensions/agentic/inference/intuition/version.rb +13 -0
  138. data/lib/legion/extensions/agentic/inference/intuition.rb +20 -0
  139. data/lib/legion/extensions/agentic/inference/magnet/client.rb +29 -0
  140. data/lib/legion/extensions/agentic/inference/magnet/helpers/constants.rb +57 -0
  141. data/lib/legion/extensions/agentic/inference/magnet/helpers/field.rb +105 -0
  142. data/lib/legion/extensions/agentic/inference/magnet/helpers/magnet_engine.rb +179 -0
  143. data/lib/legion/extensions/agentic/inference/magnet/helpers/pole.rb +80 -0
  144. data/lib/legion/extensions/agentic/inference/magnet/runners/cognitive_magnet.rb +124 -0
  145. data/lib/legion/extensions/agentic/inference/magnet/version.rb +13 -0
  146. data/lib/legion/extensions/agentic/inference/magnet.rb +21 -0
  147. data/lib/legion/extensions/agentic/inference/momentum/helpers/client.rb +17 -0
  148. data/lib/legion/extensions/agentic/inference/momentum/helpers/constants.rb +65 -0
  149. data/lib/legion/extensions/agentic/inference/momentum/helpers/idea.rb +112 -0
  150. data/lib/legion/extensions/agentic/inference/momentum/helpers/momentum_engine.rb +127 -0
  151. data/lib/legion/extensions/agentic/inference/momentum/runners/cognitive_momentum.rb +101 -0
  152. data/lib/legion/extensions/agentic/inference/momentum/version.rb +13 -0
  153. data/lib/legion/extensions/agentic/inference/momentum.rb +19 -0
  154. data/lib/legion/extensions/agentic/inference/perceptual_inference/client.rb +28 -0
  155. data/lib/legion/extensions/agentic/inference/perceptual_inference/helpers/constants.rb +34 -0
  156. data/lib/legion/extensions/agentic/inference/perceptual_inference/helpers/perceptual_field.rb +154 -0
  157. data/lib/legion/extensions/agentic/inference/perceptual_inference/helpers/perceptual_hypothesis.rb +100 -0
  158. data/lib/legion/extensions/agentic/inference/perceptual_inference/runners/perceptual_inference.rb +120 -0
  159. data/lib/legion/extensions/agentic/inference/perceptual_inference/version.rb +13 -0
  160. data/lib/legion/extensions/agentic/inference/perceptual_inference.rb +19 -0
  161. data/lib/legion/extensions/agentic/inference/prediction/actors/expire_predictions.rb +45 -0
  162. data/lib/legion/extensions/agentic/inference/prediction/client.rb +27 -0
  163. data/lib/legion/extensions/agentic/inference/prediction/helpers/modes.rb +28 -0
  164. data/lib/legion/extensions/agentic/inference/prediction/helpers/prediction_store.rb +66 -0
  165. data/lib/legion/extensions/agentic/inference/prediction/runners/prediction.rb +146 -0
  166. data/lib/legion/extensions/agentic/inference/prediction/version.rb +13 -0
  167. data/lib/legion/extensions/agentic/inference/prediction.rb +18 -0
  168. data/lib/legion/extensions/agentic/inference/predictive_coding/actors/decay.rb +45 -0
  169. data/lib/legion/extensions/agentic/inference/predictive_coding/client.rb +28 -0
  170. data/lib/legion/extensions/agentic/inference/predictive_coding/helpers/constants.rb +46 -0
  171. data/lib/legion/extensions/agentic/inference/predictive_coding/helpers/generative_model.rb +187 -0
  172. data/lib/legion/extensions/agentic/inference/predictive_coding/helpers/prediction_error.rb +59 -0
  173. data/lib/legion/extensions/agentic/inference/predictive_coding/runners/predictive_coding.rb +171 -0
  174. data/lib/legion/extensions/agentic/inference/predictive_coding/version.rb +13 -0
  175. data/lib/legion/extensions/agentic/inference/predictive_coding.rb +20 -0
  176. data/lib/legion/extensions/agentic/inference/predictive_processing/client.rb +28 -0
  177. data/lib/legion/extensions/agentic/inference/predictive_processing/helpers/constants.rb +35 -0
  178. data/lib/legion/extensions/agentic/inference/predictive_processing/helpers/generative_model.rb +142 -0
  179. data/lib/legion/extensions/agentic/inference/predictive_processing/helpers/predictive_processor.rb +129 -0
  180. data/lib/legion/extensions/agentic/inference/predictive_processing/runners/predictive_processing.rb +104 -0
  181. data/lib/legion/extensions/agentic/inference/predictive_processing/version.rb +13 -0
  182. data/lib/legion/extensions/agentic/inference/predictive_processing.rb +19 -0
  183. data/lib/legion/extensions/agentic/inference/reality_testing/client.rb +28 -0
  184. data/lib/legion/extensions/agentic/inference/reality_testing/helpers/belief.rb +98 -0
  185. data/lib/legion/extensions/agentic/inference/reality_testing/helpers/constants.rb +41 -0
  186. data/lib/legion/extensions/agentic/inference/reality_testing/helpers/reality_engine.rb +104 -0
  187. data/lib/legion/extensions/agentic/inference/reality_testing/runners/reality_testing.rb +94 -0
  188. data/lib/legion/extensions/agentic/inference/reality_testing/version.rb +13 -0
  189. data/lib/legion/extensions/agentic/inference/reality_testing.rb +19 -0
  190. data/lib/legion/extensions/agentic/inference/schema/client.rb +26 -0
  191. data/lib/legion/extensions/agentic/inference/schema/helpers/causal_relation.rb +70 -0
  192. data/lib/legion/extensions/agentic/inference/schema/helpers/constants.rb +50 -0
  193. data/lib/legion/extensions/agentic/inference/schema/helpers/world_model.rb +173 -0
  194. data/lib/legion/extensions/agentic/inference/schema/runners/schema.rb +101 -0
  195. data/lib/legion/extensions/agentic/inference/schema/version.rb +13 -0
  196. data/lib/legion/extensions/agentic/inference/schema.rb +19 -0
  197. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/client.rb +28 -0
  198. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/constants.rb +42 -0
  199. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/decision.rb +66 -0
  200. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/tolerance_engine.rb +139 -0
  201. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/runners/uncertainty_tolerance.rb +129 -0
  202. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance/version.rb +13 -0
  203. data/lib/legion/extensions/agentic/inference/uncertainty_tolerance.rb +19 -0
  204. data/lib/legion/extensions/agentic/inference/version.rb +11 -0
  205. data/lib/legion/extensions/agentic/inference.rb +44 -0
  206. data/spec/legion/extensions/agentic/inference/abductive/client_spec.rb +25 -0
  207. data/spec/legion/extensions/agentic/inference/abductive/runners/abductive_reasoning_spec.rb +349 -0
  208. data/spec/legion/extensions/agentic/inference/affordance/client_spec.rb +26 -0
  209. data/spec/legion/extensions/agentic/inference/affordance/helpers/affordance_field_spec.rb +131 -0
  210. data/spec/legion/extensions/agentic/inference/affordance/helpers/affordance_item_spec.rb +107 -0
  211. data/spec/legion/extensions/agentic/inference/affordance/runners/affordance_spec.rb +78 -0
  212. data/spec/legion/extensions/agentic/inference/analogical/client_spec.rb +31 -0
  213. data/spec/legion/extensions/agentic/inference/analogical/helpers/analogy_engine_spec.rb +276 -0
  214. data/spec/legion/extensions/agentic/inference/analogical/helpers/structure_map_spec.rb +255 -0
  215. data/spec/legion/extensions/agentic/inference/analogical/runners/analogical_reasoning_spec.rb +213 -0
  216. data/spec/legion/extensions/agentic/inference/argument_mapping/client_spec.rb +18 -0
  217. data/spec/legion/extensions/agentic/inference/argument_mapping/helpers/argument_engine_spec.rb +218 -0
  218. data/spec/legion/extensions/agentic/inference/argument_mapping/helpers/argument_spec.rb +231 -0
  219. data/spec/legion/extensions/agentic/inference/argument_mapping/runners/argument_mapping_spec.rb +171 -0
  220. data/spec/legion/extensions/agentic/inference/bayesian/client_spec.rb +20 -0
  221. data/spec/legion/extensions/agentic/inference/bayesian/helpers/belief_network_spec.rb +178 -0
  222. data/spec/legion/extensions/agentic/inference/bayesian/helpers/belief_spec.rb +137 -0
  223. data/spec/legion/extensions/agentic/inference/bayesian/runners/bayesian_belief_spec.rb +176 -0
  224. data/spec/legion/extensions/agentic/inference/belief_revision/client_spec.rb +31 -0
  225. data/spec/legion/extensions/agentic/inference/belief_revision/helpers/belief_network_spec.rb +176 -0
  226. data/spec/legion/extensions/agentic/inference/belief_revision/helpers/belief_spec.rb +153 -0
  227. data/spec/legion/extensions/agentic/inference/belief_revision/helpers/evidence_spec.rb +51 -0
  228. data/spec/legion/extensions/agentic/inference/belief_revision/runners/belief_revision_spec.rb +106 -0
  229. data/spec/legion/extensions/agentic/inference/causal_attribution/client_spec.rb +24 -0
  230. data/spec/legion/extensions/agentic/inference/causal_attribution/helpers/attribution_engine_spec.rb +181 -0
  231. data/spec/legion/extensions/agentic/inference/causal_attribution/helpers/attribution_spec.rb +108 -0
  232. data/spec/legion/extensions/agentic/inference/causal_attribution/runners/causal_attribution_spec.rb +142 -0
  233. data/spec/legion/extensions/agentic/inference/causal_reasoning/client_spec.rb +35 -0
  234. data/spec/legion/extensions/agentic/inference/causal_reasoning/helpers/causal_edge_spec.rb +158 -0
  235. data/spec/legion/extensions/agentic/inference/causal_reasoning/helpers/causal_graph_spec.rb +259 -0
  236. data/spec/legion/extensions/agentic/inference/causal_reasoning/runners/causal_reasoning_spec.rb +161 -0
  237. data/spec/legion/extensions/agentic/inference/coherence/client_spec.rb +17 -0
  238. data/spec/legion/extensions/agentic/inference/coherence/runners/cognitive_coherence_spec.rb +267 -0
  239. data/spec/legion/extensions/agentic/inference/counterfactual/client_spec.rb +48 -0
  240. data/spec/legion/extensions/agentic/inference/counterfactual/helpers/constants_spec.rb +55 -0
  241. data/spec/legion/extensions/agentic/inference/counterfactual/helpers/counterfactual_engine_spec.rb +234 -0
  242. data/spec/legion/extensions/agentic/inference/counterfactual/helpers/scenario_spec.rb +193 -0
  243. data/spec/legion/extensions/agentic/inference/counterfactual/runners/counterfactual_spec.rb +179 -0
  244. data/spec/legion/extensions/agentic/inference/debugging/client_spec.rb +46 -0
  245. data/spec/legion/extensions/agentic/inference/debugging/helpers/causal_trace_spec.rb +84 -0
  246. data/spec/legion/extensions/agentic/inference/debugging/helpers/constants_spec.rb +97 -0
  247. data/spec/legion/extensions/agentic/inference/debugging/helpers/correction_spec.rb +98 -0
  248. data/spec/legion/extensions/agentic/inference/debugging/helpers/debugging_engine_spec.rb +290 -0
  249. data/spec/legion/extensions/agentic/inference/debugging/helpers/reasoning_error_spec.rb +164 -0
  250. data/spec/legion/extensions/agentic/inference/debugging/runners/cognitive_debugging_spec.rb +301 -0
  251. data/spec/legion/extensions/agentic/inference/enactive_cognition/client_spec.rb +19 -0
  252. data/spec/legion/extensions/agentic/inference/enactive_cognition/helpers/enaction_engine_spec.rb +181 -0
  253. data/spec/legion/extensions/agentic/inference/enactive_cognition/helpers/sensorimotor_loop_spec.rb +184 -0
  254. data/spec/legion/extensions/agentic/inference/enactive_cognition/runners/enactive_cognition_spec.rb +214 -0
  255. data/spec/legion/extensions/agentic/inference/expectation_violation/expectation_violation_spec.rb +11 -0
  256. data/spec/legion/extensions/agentic/inference/expectation_violation/helpers/expectation_spec.rb +102 -0
  257. data/spec/legion/extensions/agentic/inference/expectation_violation/helpers/violation_engine_spec.rb +121 -0
  258. data/spec/legion/extensions/agentic/inference/expectation_violation/runners/expectation_violation_spec.rb +59 -0
  259. data/spec/legion/extensions/agentic/inference/free_energy/client_spec.rb +46 -0
  260. data/spec/legion/extensions/agentic/inference/free_energy/helpers/belief_spec.rb +183 -0
  261. data/spec/legion/extensions/agentic/inference/free_energy/helpers/free_energy_engine_spec.rb +211 -0
  262. data/spec/legion/extensions/agentic/inference/free_energy/runners/free_energy_spec.rb +118 -0
  263. data/spec/legion/extensions/agentic/inference/gravity/client_spec.rb +24 -0
  264. data/spec/legion/extensions/agentic/inference/gravity/helpers/attractor_spec.rb +143 -0
  265. data/spec/legion/extensions/agentic/inference/gravity/helpers/constants_spec.rb +107 -0
  266. data/spec/legion/extensions/agentic/inference/gravity/helpers/gravity_engine_spec.rb +193 -0
  267. data/spec/legion/extensions/agentic/inference/gravity/helpers/orbiting_thought_spec.rb +103 -0
  268. data/spec/legion/extensions/agentic/inference/gravity/runners/gravity_spec.rb +159 -0
  269. data/spec/legion/extensions/agentic/inference/horizon/client_spec.rb +58 -0
  270. data/spec/legion/extensions/agentic/inference/horizon/helpers/constants_spec.rb +98 -0
  271. data/spec/legion/extensions/agentic/inference/horizon/helpers/horizon_engine_spec.rb +325 -0
  272. data/spec/legion/extensions/agentic/inference/horizon/helpers/projection_spec.rb +155 -0
  273. data/spec/legion/extensions/agentic/inference/horizon/runners/cognitive_horizon_spec.rb +269 -0
  274. data/spec/legion/extensions/agentic/inference/hypothesis_testing/helpers/constants_spec.rb +38 -0
  275. data/spec/legion/extensions/agentic/inference/hypothesis_testing/helpers/hypothesis_engine_spec.rb +182 -0
  276. data/spec/legion/extensions/agentic/inference/hypothesis_testing/helpers/hypothesis_spec.rb +172 -0
  277. data/spec/legion/extensions/agentic/inference/hypothesis_testing/hypothesis_testing_spec.rb +16 -0
  278. data/spec/legion/extensions/agentic/inference/hypothesis_testing/runners/hypothesis_testing_spec.rb +159 -0
  279. data/spec/legion/extensions/agentic/inference/intuition/client_spec.rb +33 -0
  280. data/spec/legion/extensions/agentic/inference/intuition/helpers/heuristic_spec.rb +82 -0
  281. data/spec/legion/extensions/agentic/inference/intuition/helpers/intuition_engine_spec.rb +163 -0
  282. data/spec/legion/extensions/agentic/inference/intuition/helpers/pattern_spec.rb +160 -0
  283. data/spec/legion/extensions/agentic/inference/intuition/runners/intuition_spec.rb +107 -0
  284. data/spec/legion/extensions/agentic/inference/magnet/client_spec.rb +30 -0
  285. data/spec/legion/extensions/agentic/inference/magnet/helpers/constants_spec.rb +120 -0
  286. data/spec/legion/extensions/agentic/inference/magnet/helpers/field_spec.rb +193 -0
  287. data/spec/legion/extensions/agentic/inference/magnet/helpers/magnet_engine_spec.rb +281 -0
  288. data/spec/legion/extensions/agentic/inference/magnet/helpers/pole_spec.rb +211 -0
  289. data/spec/legion/extensions/agentic/inference/magnet/runners/cognitive_magnet_spec.rb +201 -0
  290. data/spec/legion/extensions/agentic/inference/momentum/cognitive_momentum_spec.rb +11 -0
  291. data/spec/legion/extensions/agentic/inference/momentum/helpers/idea_spec.rb +152 -0
  292. data/spec/legion/extensions/agentic/inference/momentum/helpers/momentum_engine_spec.rb +154 -0
  293. data/spec/legion/extensions/agentic/inference/momentum/runners/cognitive_momentum_spec.rb +97 -0
  294. data/spec/legion/extensions/agentic/inference/perceptual_inference/client_spec.rb +39 -0
  295. data/spec/legion/extensions/agentic/inference/perceptual_inference/helpers/constants_spec.rb +97 -0
  296. data/spec/legion/extensions/agentic/inference/perceptual_inference/helpers/perceptual_field_spec.rb +270 -0
  297. data/spec/legion/extensions/agentic/inference/perceptual_inference/helpers/perceptual_hypothesis_spec.rb +206 -0
  298. data/spec/legion/extensions/agentic/inference/perceptual_inference/runners/perceptual_inference_spec.rb +305 -0
  299. data/spec/legion/extensions/agentic/inference/prediction/actors/expire_predictions_spec.rb +46 -0
  300. data/spec/legion/extensions/agentic/inference/prediction/client_spec.rb +14 -0
  301. data/spec/legion/extensions/agentic/inference/prediction/helpers/modes_spec.rb +118 -0
  302. data/spec/legion/extensions/agentic/inference/prediction/helpers/prediction_store_spec.rb +262 -0
  303. data/spec/legion/extensions/agentic/inference/prediction/runners/prediction_spec.rb +116 -0
  304. data/spec/legion/extensions/agentic/inference/predictive_coding/client_spec.rb +74 -0
  305. data/spec/legion/extensions/agentic/inference/predictive_coding/helpers/generative_model_spec.rb +194 -0
  306. data/spec/legion/extensions/agentic/inference/predictive_coding/helpers/prediction_error_spec.rb +109 -0
  307. data/spec/legion/extensions/agentic/inference/predictive_coding/runners/predictive_coding_spec.rb +210 -0
  308. data/spec/legion/extensions/agentic/inference/predictive_processing/client_spec.rb +82 -0
  309. data/spec/legion/extensions/agentic/inference/predictive_processing/helpers/generative_model_spec.rb +220 -0
  310. data/spec/legion/extensions/agentic/inference/predictive_processing/helpers/predictive_processor_spec.rb +206 -0
  311. data/spec/legion/extensions/agentic/inference/predictive_processing/runners/predictive_processing_spec.rb +213 -0
  312. data/spec/legion/extensions/agentic/inference/reality_testing/client_spec.rb +29 -0
  313. data/spec/legion/extensions/agentic/inference/reality_testing/helpers/belief_spec.rb +197 -0
  314. data/spec/legion/extensions/agentic/inference/reality_testing/helpers/constants_spec.rb +78 -0
  315. data/spec/legion/extensions/agentic/inference/reality_testing/helpers/reality_engine_spec.rb +191 -0
  316. data/spec/legion/extensions/agentic/inference/reality_testing/runners/reality_testing_spec.rb +154 -0
  317. data/spec/legion/extensions/agentic/inference/schema/client_spec.rb +53 -0
  318. data/spec/legion/extensions/agentic/inference/schema/helpers/causal_relation_spec.rb +108 -0
  319. data/spec/legion/extensions/agentic/inference/schema/helpers/constants_spec.rb +54 -0
  320. data/spec/legion/extensions/agentic/inference/schema/helpers/world_model_spec.rb +179 -0
  321. data/spec/legion/extensions/agentic/inference/schema/runners/schema_spec.rb +146 -0
  322. data/spec/legion/extensions/agentic/inference/uncertainty_tolerance/client_spec.rb +18 -0
  323. data/spec/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/constants_spec.rb +62 -0
  324. data/spec/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/decision_spec.rb +125 -0
  325. data/spec/legion/extensions/agentic/inference/uncertainty_tolerance/helpers/tolerance_engine_spec.rb +184 -0
  326. data/spec/legion/extensions/agentic/inference/uncertainty_tolerance/runners/uncertainty_tolerance_spec.rb +157 -0
  327. data/spec/spec_helper.rb +46 -0
  328. metadata +412 -0
@@ -0,0 +1,171 @@
1
+ # frozen_string_literal: true
2
+
3
+ RSpec.describe Legion::Extensions::Agentic::Inference::ArgumentMapping::Runners::ArgumentMapping do
4
+ let(:client) { Legion::Extensions::Agentic::Inference::ArgumentMapping::Client.new }
5
+
6
+ describe '#create_argument' do
7
+ it 'creates an argument and returns success' do
8
+ result = client.create_argument(claim: 'We should reduce emissions')
9
+ expect(result[:success]).to be true
10
+ expect(result[:argument][:claim]).to eq('We should reduce emissions')
11
+ end
12
+
13
+ it 'accepts a warrant' do
14
+ result = client.create_argument(claim: 'Test', warrant: 'Evidence shows it')
15
+ expect(result[:argument][:warrant]).to eq('Evidence shows it')
16
+ end
17
+
18
+ it 'accepts a qualifier' do
19
+ result = client.create_argument(claim: 'Test', qualifier: :certainly)
20
+ expect(result[:argument][:qualifier]).to eq(:certainly)
21
+ end
22
+ end
23
+
24
+ describe '#add_argument_ground' do
25
+ let(:argument_id) { client.create_argument(claim: 'Test claim')[:argument][:id] }
26
+
27
+ it 'adds a ground successfully' do
28
+ result = client.add_argument_ground(argument_id: argument_id, ground: 'Strong evidence')
29
+ expect(result[:success]).to be true
30
+ expect(result[:argument][:grounds]).to include('Strong evidence')
31
+ end
32
+
33
+ it 'returns failure for unknown id' do
34
+ result = client.add_argument_ground(argument_id: 'bad', ground: 'Evidence')
35
+ expect(result[:success]).to be false
36
+ end
37
+ end
38
+
39
+ describe '#add_argument_backing' do
40
+ let(:argument_id) { client.create_argument(claim: 'Test claim')[:argument][:id] }
41
+
42
+ it 'adds backing successfully' do
43
+ result = client.add_argument_backing(argument_id: argument_id, backing: 'Academic study')
44
+ expect(result[:success]).to be true
45
+ expect(result[:argument][:backing]).to include('Academic study')
46
+ end
47
+
48
+ it 'returns failure for unknown id' do
49
+ result = client.add_argument_backing(argument_id: 'bad', backing: 'Source')
50
+ expect(result[:success]).to be false
51
+ end
52
+ end
53
+
54
+ describe '#add_argument_rebuttal' do
55
+ let(:argument_id) { client.create_argument(claim: 'Test claim')[:argument][:id] }
56
+
57
+ it 'adds a rebuttal successfully' do
58
+ result = client.add_argument_rebuttal(argument_id: argument_id, content: 'Counter', impact: 0.7)
59
+ expect(result[:success]).to be true
60
+ expect(result[:argument][:rebuttals].first[:impact]).to eq(0.7)
61
+ end
62
+
63
+ it 'returns failure for unknown id' do
64
+ result = client.add_argument_rebuttal(argument_id: 'bad', content: 'Counter')
65
+ expect(result[:success]).to be false
66
+ end
67
+ end
68
+
69
+ describe '#assess_argument_strength' do
70
+ let(:argument_id) do
71
+ id = client.create_argument(claim: 'Test', warrant: 'Because')[:argument][:id]
72
+ 3.times { |i| client.add_argument_ground(argument_id: id, ground: "G#{i}") }
73
+ id
74
+ end
75
+
76
+ it 'returns a strength assessment' do
77
+ result = client.assess_argument_strength(argument_id: argument_id)
78
+ expect(result[:success]).to be true
79
+ expect(result[:strength]).to be_a(Float)
80
+ expect(result[:strength_label]).to be_a(Symbol)
81
+ end
82
+
83
+ it 'includes sound and rebutted flags' do
84
+ result = client.assess_argument_strength(argument_id: argument_id)
85
+ expect(result).to include(:sound, :rebutted)
86
+ end
87
+
88
+ it 'returns failure for unknown id' do
89
+ result = client.assess_argument_strength(argument_id: 'nope')
90
+ expect(result[:success]).to be false
91
+ end
92
+ end
93
+
94
+ describe '#sound_arguments_report' do
95
+ it 'returns success with count and arguments list' do
96
+ result = client.sound_arguments_report
97
+ expect(result[:success]).to be true
98
+ expect(result[:count]).to be_a(Integer)
99
+ expect(result[:arguments]).to be_an(Array)
100
+ end
101
+
102
+ it 'includes sound arguments after creation' do
103
+ id = client.create_argument(claim: 'Sound arg', warrant: 'Valid reason')[:argument][:id]
104
+ 3.times { |i| client.add_argument_ground(argument_id: id, ground: "G#{i}") }
105
+ 2.times { |i| client.add_argument_backing(argument_id: id, backing: "B#{i}") }
106
+
107
+ result = client.sound_arguments_report
108
+ expect(result[:count]).to be >= 1
109
+ end
110
+ end
111
+
112
+ describe '#rebutted_arguments_report' do
113
+ it 'returns success with count and arguments list' do
114
+ result = client.rebutted_arguments_report
115
+ expect(result[:success]).to be true
116
+ expect(result[:count]).to be_a(Integer)
117
+ expect(result[:arguments]).to be_an(Array)
118
+ end
119
+
120
+ it 'includes rebutted arguments after rebuttal added' do
121
+ id = client.create_argument(claim: 'Rebutted arg')[:argument][:id]
122
+ client.add_argument_rebuttal(argument_id: id, content: 'Devastating counter', impact: 0.9)
123
+
124
+ result = client.rebutted_arguments_report
125
+ expect(result[:count]).to be >= 1
126
+ end
127
+ end
128
+
129
+ describe '#strongest_arguments_report' do
130
+ before do
131
+ 2.times do |i|
132
+ id = client.create_argument(claim: "Claim #{i}", warrant: "Warrant #{i}")[:argument][:id]
133
+ i.times { |j| client.add_argument_ground(argument_id: id, ground: "G#{j}") }
134
+ end
135
+ end
136
+
137
+ it 'returns success with ordered arguments' do
138
+ result = client.strongest_arguments_report(limit: 2)
139
+ expect(result[:success]).to be true
140
+ expect(result[:arguments]).to be_an(Array)
141
+ end
142
+
143
+ it 'respects the limit' do
144
+ result = client.strongest_arguments_report(limit: 1)
145
+ expect(result[:count]).to be <= 1
146
+ end
147
+ end
148
+
149
+ describe '#update_argument_mapping' do
150
+ it 'runs decay and returns success' do
151
+ client.create_argument(claim: 'Test')
152
+ result = client.update_argument_mapping
153
+ expect(result[:success]).to be true
154
+ expect(result[:arguments_processed]).to be_a(Integer)
155
+ end
156
+ end
157
+
158
+ describe '#argument_mapping_stats' do
159
+ it 'returns success with counts' do
160
+ result = client.argument_mapping_stats
161
+ expect(result[:success]).to be true
162
+ expect(result).to include(:total_arguments, :sound_arguments, :rebutted_arguments)
163
+ end
164
+
165
+ it 'reflects created arguments' do
166
+ client.create_argument(claim: 'Stat test')
167
+ result = client.argument_mapping_stats
168
+ expect(result[:total_arguments]).to be >= 1
169
+ end
170
+ end
171
+ end
@@ -0,0 +1,20 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'legion/extensions/agentic/inference/bayesian/client'
4
+
5
+ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Client do
6
+ let(:client) { described_class.new }
7
+
8
+ it 'responds to all runner methods' do
9
+ expect(client).to respond_to(:add_bayesian_belief)
10
+ expect(client).to respond_to(:update_bayesian_belief)
11
+ expect(client).to respond_to(:batch_bayesian_update)
12
+ expect(client).to respond_to(:most_probable_beliefs)
13
+ expect(client).to respond_to(:least_probable_beliefs)
14
+ expect(client).to respond_to(:posterior_distribution)
15
+ expect(client).to respond_to(:information_gain)
16
+ expect(client).to respond_to(:belief_entropy)
17
+ expect(client).to respond_to(:update_bayesian_beliefs)
18
+ expect(client).to respond_to(:bayesian_belief_stats)
19
+ end
20
+ end
@@ -0,0 +1,178 @@
1
+ # frozen_string_literal: true
2
+
3
+ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Helpers::BeliefNetwork do
4
+ let(:network) { described_class.new }
5
+ let(:consts) { Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants }
6
+
7
+ def add(content: 'hypothesis', domain: :general, prior: 0.5)
8
+ network.add_belief(content: content, domain: domain, prior: prior)
9
+ end
10
+
11
+ describe '#add_belief' do
12
+ it 'adds a belief and returns it' do
13
+ belief = add
14
+ expect(belief).to be_a(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Belief)
15
+ expect(network.count).to eq(1)
16
+ end
17
+
18
+ it 'uses provided prior' do
19
+ belief = add(prior: 0.7)
20
+ expect(belief.prior).to eq(0.7)
21
+ end
22
+ end
23
+
24
+ describe '#update_belief' do
25
+ it 'updates and returns the belief' do
26
+ belief = add
27
+ result = network.update_belief(belief_id: belief.id, evidence_id: 'ev-1', likelihood: 0.9)
28
+ expect(result).to be_a(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Belief)
29
+ expect(result.posterior).to be > 0.5
30
+ end
31
+
32
+ it 'returns nil for unknown belief_id' do
33
+ result = network.update_belief(belief_id: 'nonexistent', evidence_id: 'ev-1', likelihood: 0.8)
34
+ expect(result).to be_nil
35
+ end
36
+ end
37
+
38
+ describe '#batch_update' do
39
+ it 'updates multiple beliefs with same evidence' do
40
+ b1 = add(content: 'h1', domain: :test)
41
+ b2 = add(content: 'h2', domain: :test)
42
+ likelihoods = { b1.id => 0.8, b2.id => 0.3 }
43
+
44
+ result = network.batch_update(evidence_id: 'ev-batch', likelihoods: likelihoods)
45
+ expect(result.size).to eq(2)
46
+ end
47
+
48
+ it 'returns empty hash for empty likelihoods' do
49
+ result = network.batch_update(evidence_id: 'ev-1', likelihoods: {})
50
+ expect(result).to be_empty
51
+ end
52
+ end
53
+
54
+ describe '#most_probable' do
55
+ it 'returns beliefs sorted by posterior descending' do
56
+ add(content: 'low', domain: :test, prior: 0.2)
57
+ add(content: 'high', domain: :test, prior: 0.8)
58
+ add(content: 'mid', domain: :test, prior: 0.5)
59
+
60
+ beliefs = network.most_probable
61
+ expect(beliefs.first.posterior).to be >= beliefs.last.posterior
62
+ end
63
+
64
+ it 'limits results' do
65
+ 3.times { |idx| add(content: "h#{idx}", domain: :test) }
66
+ expect(network.most_probable(limit: 2).size).to eq(2)
67
+ end
68
+
69
+ it 'filters by domain' do
70
+ add(content: 'a', domain: :alpha)
71
+ add(content: 'b', domain: :beta)
72
+ results = network.most_probable(domain: :alpha)
73
+ expect(results.all? { |b| b.domain == :alpha }).to be true
74
+ end
75
+ end
76
+
77
+ describe '#least_probable' do
78
+ it 'returns beliefs sorted by posterior ascending' do
79
+ add(content: 'low', domain: :test, prior: 0.1)
80
+ add(content: 'high', domain: :test, prior: 0.9)
81
+
82
+ beliefs = network.least_probable
83
+ expect(beliefs.first.posterior).to be <= beliefs.last.posterior
84
+ end
85
+ end
86
+
87
+ describe '#by_domain' do
88
+ it 'returns only beliefs in specified domain' do
89
+ add(content: 'a', domain: :alpha)
90
+ add(content: 'b', domain: :beta)
91
+ result = network.by_domain(domain: :alpha)
92
+ expect(result.size).to eq(1)
93
+ expect(result.first.domain).to eq(:alpha)
94
+ end
95
+ end
96
+
97
+ describe '#posterior_distribution' do
98
+ it 'returns normalized probabilities that sum to ~1' do
99
+ add(content: 'h1', domain: :test, prior: 0.3)
100
+ add(content: 'h2', domain: :test, prior: 0.7)
101
+
102
+ dist = network.posterior_distribution(domain: :test)
103
+ expect(dist.values.sum).to be_within(0.001).of(1.0)
104
+ end
105
+
106
+ it 'returns empty hash when no beliefs exist' do
107
+ expect(network.posterior_distribution).to eq({})
108
+ end
109
+ end
110
+
111
+ describe '#information_gain' do
112
+ it 'returns a non-negative float' do
113
+ belief = add
114
+ gain = network.information_gain(belief_id: belief.id, evidence_id: 'ev-1', likelihood: 0.9)
115
+ expect(gain).to be >= 0.0
116
+ end
117
+
118
+ it 'returns 0.0 for unknown belief' do
119
+ gain = network.information_gain(belief_id: 'nonexistent', evidence_id: 'ev-1', likelihood: 0.8)
120
+ expect(gain).to eq(0.0)
121
+ end
122
+
123
+ it 'does not mutate the belief posterior' do
124
+ belief = add
125
+ before = belief.posterior
126
+ network.information_gain(belief_id: belief.id, evidence_id: 'ev-1', likelihood: 0.9)
127
+ expect(belief.posterior).to eq(before)
128
+ end
129
+
130
+ it 'returns higher gain for more extreme likelihoods' do
131
+ b1 = add(content: 'h1')
132
+ b2 = add(content: 'h2')
133
+
134
+ gain_strong = network.information_gain(belief_id: b1.id, evidence_id: 'ev', likelihood: 0.95)
135
+ gain_weak = network.information_gain(belief_id: b2.id, evidence_id: 'ev', likelihood: 0.55)
136
+ expect(gain_strong).to be > gain_weak
137
+ end
138
+ end
139
+
140
+ describe '#entropy' do
141
+ it 'returns 0.0 when no beliefs' do
142
+ expect(network.entropy).to eq(0.0)
143
+ end
144
+
145
+ it 'returns a positive float when beliefs exist' do
146
+ 2.times { |idx| add(content: "h#{idx}") }
147
+ expect(network.entropy).to be > 0.0
148
+ end
149
+ end
150
+
151
+ describe '#decay_all' do
152
+ it 'returns count of beliefs updated' do
153
+ 3.times { |idx| add(content: "h#{idx}") }
154
+ expect(network.decay_all).to eq(3)
155
+ end
156
+
157
+ it 'drifts posterior toward prior' do
158
+ belief = add(prior: 0.5)
159
+ belief.update(likelihood: 0.9, evidence_id: 'ev-1')
160
+ before = belief.posterior
161
+
162
+ network.decay_all
163
+
164
+ after = belief.posterior
165
+ expect(after).to be < before
166
+ end
167
+ end
168
+
169
+ describe '#to_h' do
170
+ it 'includes belief_count and beliefs keys' do
171
+ add
172
+ hash = network.to_h
173
+ expect(hash).to have_key(:belief_count)
174
+ expect(hash).to have_key(:beliefs)
175
+ expect(hash[:belief_count]).to eq(1)
176
+ end
177
+ end
178
+ end
@@ -0,0 +1,137 @@
1
+ # frozen_string_literal: true
2
+
3
+ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Belief do
4
+ let(:belief) { described_class.new(content: 'test hypothesis', domain: :general) }
5
+
6
+ describe '#initialize' do
7
+ it 'sets prior and posterior to default' do
8
+ expect(belief.prior).to eq(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::DEFAULT_PRIOR)
9
+ expect(belief.posterior).to eq(belief.prior)
10
+ end
11
+
12
+ it 'generates a uuid id' do
13
+ expect(belief.id).to match(/\A[0-9a-f-]{36}\z/)
14
+ end
15
+
16
+ it 'starts with empty evidence_history' do
17
+ expect(belief.evidence_history).to be_empty
18
+ end
19
+
20
+ it 'clamps prior to floor/ceiling' do
21
+ high = described_class.new(content: 'test', domain: :x, prior: 1.5)
22
+ low = described_class.new(content: 'test', domain: :x, prior: -0.1)
23
+ expect(high.prior).to eq(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::PRIOR_CEILING)
24
+ expect(low.prior).to eq(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::PRIOR_FLOOR)
25
+ end
26
+ end
27
+
28
+ describe '#update' do
29
+ it 'raises posterior when likelihood is high' do
30
+ before = belief.posterior
31
+ belief.update(likelihood: 0.9, evidence_id: 'ev-1')
32
+ expect(belief.posterior).to be > before
33
+ end
34
+
35
+ it 'lowers posterior when likelihood is low' do
36
+ before = belief.posterior
37
+ belief.update(likelihood: 0.1, evidence_id: 'ev-1')
38
+ expect(belief.posterior).to be < before
39
+ end
40
+
41
+ it 'records evidence in history' do
42
+ belief.update(likelihood: 0.8, evidence_id: 'ev-1')
43
+ expect(belief.evidence_history.size).to eq(1)
44
+ expect(belief.evidence_history.first[:evidence_id]).to eq('ev-1')
45
+ end
46
+
47
+ it 'increments update_count' do
48
+ belief.update(likelihood: 0.7, evidence_id: 'ev-1')
49
+ belief.update(likelihood: 0.6, evidence_id: 'ev-2')
50
+ expect(belief.update_count).to eq(2)
51
+ end
52
+
53
+ it 'clamps posterior within bounds' do
54
+ 10.times { |idx| belief.update(likelihood: 0.999, evidence_id: "ev-#{idx}") }
55
+ expect(belief.posterior).to be <= Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::PRIOR_CEILING
56
+ expect(belief.posterior).to be >= Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::PRIOR_FLOOR
57
+ end
58
+ end
59
+
60
+ describe '#log_odds' do
61
+ it 'returns 0.0 at prior 0.5' do
62
+ expect(belief.log_odds).to be_within(0.001).of(0.0)
63
+ end
64
+
65
+ it 'returns positive value when posterior > 0.5' do
66
+ belief.update(likelihood: 0.9, evidence_id: 'ev-1')
67
+ expect(belief.log_odds).to be > 0.0
68
+ end
69
+
70
+ it 'returns negative value when posterior < 0.5' do
71
+ belief.update(likelihood: 0.1, evidence_id: 'ev-1')
72
+ expect(belief.log_odds).to be < 0.0
73
+ end
74
+ end
75
+
76
+ describe '#confidence_label' do
77
+ it 'returns :leaning for default prior 0.5' do
78
+ expect(belief.confidence_label).to eq(:leaning)
79
+ end
80
+
81
+ it 'returns :certain for high posterior' do
82
+ high = described_class.new(content: 'test', domain: :x, prior: 0.95)
83
+ expect(high.confidence_label).to eq(:certain)
84
+ end
85
+
86
+ it 'returns :doubtful for low posterior' do
87
+ low = described_class.new(content: 'test', domain: :x, prior: 0.1)
88
+ expect(low.confidence_label).to eq(:doubtful)
89
+ end
90
+
91
+ it 'returns :confident for posterior in 0.7..0.9' do
92
+ conf = described_class.new(content: 'test', domain: :x, prior: 0.8)
93
+ expect(conf.confidence_label).to eq(:confident)
94
+ end
95
+
96
+ it 'returns :uncertain for posterior in 0.3..0.5' do
97
+ unc = described_class.new(content: 'test', domain: :x, prior: 0.4)
98
+ expect(unc.confidence_label).to eq(:uncertain)
99
+ end
100
+ end
101
+
102
+ describe '#surprise' do
103
+ it 'returns 0.0 for certain observation (likelihood 1.0)' do
104
+ expect(belief.surprise(observation_likelihood: 1.0)).to be_within(0.001).of(0.0)
105
+ end
106
+
107
+ it 'returns positive surprise for unlikely observation' do
108
+ expect(belief.surprise(observation_likelihood: 0.125)).to be_within(0.001).of(3.0)
109
+ end
110
+ end
111
+
112
+ describe '#reset_to_prior!' do
113
+ it 'resets posterior to original prior' do
114
+ belief.update(likelihood: 0.9, evidence_id: 'ev-1')
115
+ expect(belief.posterior).not_to eq(belief.prior)
116
+ belief.reset_to_prior!
117
+ expect(belief.posterior).to eq(belief.prior)
118
+ end
119
+
120
+ it 'clears evidence history and update count' do
121
+ belief.update(likelihood: 0.8, evidence_id: 'ev-1')
122
+ belief.reset_to_prior!
123
+ expect(belief.evidence_history).to be_empty
124
+ expect(belief.update_count).to eq(0)
125
+ end
126
+ end
127
+
128
+ describe '#to_h' do
129
+ it 'includes all required keys' do
130
+ hash = belief.to_h
131
+ %i[id content domain prior posterior confidence_label log_odds update_count
132
+ evidence_history created_at last_updated_at].each do |key|
133
+ expect(hash).to have_key(key)
134
+ end
135
+ end
136
+ end
137
+ end
@@ -0,0 +1,176 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'legion/extensions/agentic/inference/bayesian/client'
4
+
5
+ RSpec.describe Legion::Extensions::Agentic::Inference::Bayesian::Runners::BayesianBelief do
6
+ let(:client) { Legion::Extensions::Agentic::Inference::Bayesian::Client.new }
7
+
8
+ describe '#add_bayesian_belief' do
9
+ it 'adds a belief and returns success' do
10
+ result = client.add_bayesian_belief(content: 'test hypothesis', domain: :general)
11
+ expect(result[:success]).to be true
12
+ expect(result[:belief_id]).to match(/\A[0-9a-f-]{36}\z/)
13
+ expect(result[:domain]).to eq(:general)
14
+ end
15
+
16
+ it 'uses default prior when none provided' do
17
+ result = client.add_bayesian_belief(content: 'test', domain: :test)
18
+ expect(result[:prior]).to eq(Legion::Extensions::Agentic::Inference::Bayesian::Helpers::Constants::DEFAULT_PRIOR)
19
+ end
20
+
21
+ it 'uses provided prior' do
22
+ result = client.add_bayesian_belief(content: 'test', domain: :test, prior: 0.7)
23
+ expect(result[:prior]).to be_within(0.001).of(0.7)
24
+ end
25
+ end
26
+
27
+ describe '#update_bayesian_belief' do
28
+ it 'updates an existing belief' do
29
+ added = client.add_bayesian_belief(content: 'h1', domain: :test)
30
+ result = client.update_bayesian_belief(
31
+ belief_id: added[:belief_id],
32
+ evidence_id: 'ev-1',
33
+ likelihood: 0.9
34
+ )
35
+ expect(result[:success]).to be true
36
+ expect(result[:posterior]).to be > 0.5
37
+ expect(result[:update_count]).to eq(1)
38
+ end
39
+
40
+ it 'returns not_found for unknown belief' do
41
+ result = client.update_bayesian_belief(belief_id: 'nonexistent', evidence_id: 'ev-1', likelihood: 0.8)
42
+ expect(result[:success]).to be false
43
+ expect(result[:reason]).to eq(:not_found)
44
+ end
45
+
46
+ it 'returns confidence_label' do
47
+ added = client.add_bayesian_belief(content: 'h1', domain: :test, prior: 0.95)
48
+ result = client.update_bayesian_belief(
49
+ belief_id: added[:belief_id],
50
+ evidence_id: 'ev-1',
51
+ likelihood: 0.9
52
+ )
53
+ expect(result[:confidence_label]).to eq(:certain)
54
+ end
55
+ end
56
+
57
+ describe '#batch_bayesian_update' do
58
+ it 'updates multiple beliefs' do
59
+ b1 = client.add_bayesian_belief(content: 'h1', domain: :test)
60
+ b2 = client.add_bayesian_belief(content: 'h2', domain: :test)
61
+ likelihoods = { b1[:belief_id] => 0.8, b2[:belief_id] => 0.3 }
62
+
63
+ result = client.batch_bayesian_update(evidence_id: 'ev-batch', likelihoods: likelihoods)
64
+ expect(result[:success]).to be true
65
+ expect(result[:updated]).to eq(2)
66
+ end
67
+
68
+ it 'handles empty likelihoods gracefully' do
69
+ result = client.batch_bayesian_update(evidence_id: 'ev-1', likelihoods: {})
70
+ expect(result[:success]).to be true
71
+ expect(result[:updated]).to eq(0)
72
+ end
73
+ end
74
+
75
+ describe '#most_probable_beliefs' do
76
+ it 'returns beliefs sorted by probability' do
77
+ client.add_bayesian_belief(content: 'low', domain: :ranked, prior: 0.2)
78
+ client.add_bayesian_belief(content: 'high', domain: :ranked, prior: 0.8)
79
+
80
+ result = client.most_probable_beliefs(domain: :ranked)
81
+ expect(result[:success]).to be true
82
+ expect(result[:beliefs].first[:posterior]).to be >= result[:beliefs].last[:posterior]
83
+ end
84
+
85
+ it 'respects limit parameter' do
86
+ 5.times { |idx| client.add_bayesian_belief(content: "h#{idx}", domain: :limit_test) }
87
+ result = client.most_probable_beliefs(domain: :limit_test, limit: 3)
88
+ expect(result[:count]).to eq(3)
89
+ end
90
+ end
91
+
92
+ describe '#least_probable_beliefs' do
93
+ it 'returns beliefs sorted by ascending probability' do
94
+ client.add_bayesian_belief(content: 'low', domain: :sorted, prior: 0.1)
95
+ client.add_bayesian_belief(content: 'high', domain: :sorted, prior: 0.9)
96
+
97
+ result = client.least_probable_beliefs(domain: :sorted)
98
+ expect(result[:beliefs].first[:posterior]).to be <= result[:beliefs].last[:posterior]
99
+ end
100
+ end
101
+
102
+ describe '#posterior_distribution' do
103
+ it 'returns normalized distribution summing to 1' do
104
+ client.add_bayesian_belief(content: 'h1', domain: :dist, prior: 0.3)
105
+ client.add_bayesian_belief(content: 'h2', domain: :dist, prior: 0.7)
106
+
107
+ result = client.posterior_distribution(domain: :dist)
108
+ expect(result[:success]).to be true
109
+ expect(result[:distribution].values.sum).to be_within(0.001).of(1.0)
110
+ end
111
+
112
+ it 'returns empty distribution when no beliefs' do
113
+ result = client.posterior_distribution(domain: :empty_domain)
114
+ expect(result[:distribution]).to be_empty
115
+ end
116
+ end
117
+
118
+ describe '#information_gain' do
119
+ it 'computes gain without mutating the belief' do
120
+ added = client.add_bayesian_belief(content: 'h1', domain: :ig)
121
+ before = added[:posterior]
122
+ result = client.information_gain(belief_id: added[:belief_id], evidence_id: 'ev-1', likelihood: 0.9)
123
+ expect(result[:success]).to be true
124
+ expect(result[:information_gain]).to be >= 0.0
125
+
126
+ check = client.most_probable_beliefs(domain: :ig)
127
+ expect(check[:beliefs].first[:posterior]).to be_within(0.001).of(before)
128
+ end
129
+ end
130
+
131
+ describe '#belief_entropy' do
132
+ it 'returns entropy for all beliefs' do
133
+ client.add_bayesian_belief(content: 'h1', domain: :ent)
134
+ client.add_bayesian_belief(content: 'h2', domain: :ent)
135
+
136
+ result = client.belief_entropy(domain: :ent)
137
+ expect(result[:success]).to be true
138
+ expect(result[:entropy]).to be >= 0.0
139
+ end
140
+
141
+ it 'returns 0.0 entropy when no beliefs exist' do
142
+ fresh = Legion::Extensions::Agentic::Inference::Bayesian::Client.new
143
+ result = fresh.belief_entropy
144
+ expect(result[:entropy]).to eq(0.0)
145
+ end
146
+ end
147
+
148
+ describe '#update_bayesian_beliefs (decay)' do
149
+ it 'returns success and decayed count' do
150
+ 2.times { |idx| client.add_bayesian_belief(content: "h#{idx}", domain: :decay) }
151
+ result = client.update_bayesian_beliefs
152
+ expect(result[:success]).to be true
153
+ expect(result[:decayed]).to eq(2)
154
+ end
155
+ end
156
+
157
+ describe '#bayesian_belief_stats' do
158
+ it 'returns stats hash with expected keys' do
159
+ client.add_bayesian_belief(content: 'h1', domain: :stats)
160
+ result = client.bayesian_belief_stats
161
+ expect(result[:success]).to be true
162
+ expect(result).to have_key(:total_beliefs)
163
+ expect(result).to have_key(:entropy)
164
+ expect(result).to have_key(:most_probable)
165
+ expect(result).to have_key(:least_probable)
166
+ expect(result).to have_key(:capacity)
167
+ end
168
+
169
+ it 'returns nil for most/least probable when no beliefs' do
170
+ fresh = Legion::Extensions::Agentic::Inference::Bayesian::Client.new
171
+ result = fresh.bayesian_belief_stats
172
+ expect(result[:most_probable]).to be_nil
173
+ expect(result[:least_probable]).to be_nil
174
+ end
175
+ end
176
+ end