kbs 0.2.1 → 0.4.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 (134) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +87 -1
  3. data/README.md +66 -25
  4. data/lib/kbs/agenda.rb +301 -0
  5. data/lib/kbs/alpha_memory.rb +80 -9
  6. data/lib/kbs/alpha_network.rb +95 -0
  7. data/lib/kbs/beta_memory.rb +54 -19
  8. data/lib/kbs/blackboard/audit_log.rb +26 -25
  9. data/lib/kbs/blackboard/engine.rb +49 -40
  10. data/lib/kbs/blackboard/fact.rb +17 -21
  11. data/lib/kbs/blackboard/memory.rb +116 -40
  12. data/lib/kbs/blackboard/message_queue.rb +39 -28
  13. data/lib/kbs/blackboard/persistence/hybrid_store.rb +20 -9
  14. data/lib/kbs/blackboard/persistence/redis_store.rb +59 -51
  15. data/lib/kbs/blackboard/persistence/sqlite_store.rb +29 -32
  16. data/lib/kbs/blackboard/persistence/store.rb +11 -1
  17. data/lib/kbs/blackboard/redis_message_queue.rb +16 -7
  18. data/lib/kbs/condition.rb +42 -2
  19. data/lib/kbs/decompiler.rb +300 -124
  20. data/lib/kbs/dsl/condition_helpers.rb +8 -6
  21. data/lib/kbs/dsl/knowledge_base.rb +73 -93
  22. data/lib/kbs/dsl/pattern_evaluator.rb +38 -15
  23. data/lib/kbs/dsl/rule_builder.rb +118 -40
  24. data/lib/kbs/dsl/variable.rb +51 -6
  25. data/lib/kbs/dsl.rb +10 -3
  26. data/lib/kbs/engine.rb +395 -77
  27. data/lib/kbs/errors.rb +38 -0
  28. data/lib/kbs/exists_node.rb +12 -0
  29. data/lib/kbs/fact.rb +5 -19
  30. data/lib/kbs/fact_registry.rb +51 -0
  31. data/lib/kbs/introspection.rb +93 -0
  32. data/lib/kbs/join_indexing.rb +106 -0
  33. data/lib/kbs/join_node.rb +93 -57
  34. data/lib/kbs/join_test_builder.rb +80 -0
  35. data/lib/kbs/join_tests.rb +66 -0
  36. data/lib/kbs/memory_index.rb +104 -0
  37. data/lib/kbs/negation_node.rb +6 -82
  38. data/lib/kbs/network_node.rb +31 -0
  39. data/lib/kbs/pattern_matching.rb +52 -0
  40. data/lib/kbs/production_node.rb +50 -6
  41. data/lib/kbs/quantifier_node.rb +140 -0
  42. data/lib/kbs/rule.rb +26 -13
  43. data/lib/kbs/rule_source.rb +74 -0
  44. data/lib/kbs/rule_step.rb +27 -0
  45. data/lib/kbs/token.rb +76 -10
  46. data/lib/kbs/tracer.rb +80 -0
  47. data/lib/kbs/truth_maintenance.rb +82 -0
  48. data/lib/kbs/version.rb +1 -1
  49. data/lib/kbs/working_memory.rb +25 -3
  50. data/lib/kbs.rb +17 -4
  51. metadata +22 -129
  52. data/.envrc +0 -3
  53. data/.github/workflows/deploy-github-pages.yml +0 -52
  54. data/COMMITS.md +0 -196
  55. data/Rakefile +0 -8
  56. data/docs/advanced/custom-persistence.md +0 -775
  57. data/docs/advanced/debugging.md +0 -726
  58. data/docs/advanced/index.md +0 -8
  59. data/docs/advanced/performance.md +0 -865
  60. data/docs/advanced/testing.md +0 -827
  61. data/docs/api/blackboard.md +0 -1157
  62. data/docs/api/engine.md +0 -1047
  63. data/docs/api/facts.md +0 -1212
  64. data/docs/api/index.md +0 -12
  65. data/docs/api/rules.md +0 -1104
  66. data/docs/architecture/blackboard.md +0 -544
  67. data/docs/architecture/index.md +0 -277
  68. data/docs/architecture/network-structure.md +0 -343
  69. data/docs/architecture/rete-algorithm.md +0 -737
  70. data/docs/assets/css/custom.css +0 -83
  71. data/docs/assets/images/blackboard-architecture.svg +0 -136
  72. data/docs/assets/images/compiled-network.svg +0 -101
  73. data/docs/assets/images/fact-assertion-flow.svg +0 -117
  74. data/docs/assets/images/fact-rule-relationship.svg +0 -65
  75. data/docs/assets/images/fact-structure.svg +0 -42
  76. data/docs/assets/images/inference-cycle.svg +0 -47
  77. data/docs/assets/images/kb-components.svg +0 -43
  78. data/docs/assets/images/kbs.jpg +0 -0
  79. data/docs/assets/images/pattern-matching-trace.svg +0 -136
  80. data/docs/assets/images/rete-network-layers.svg +0 -96
  81. data/docs/assets/images/rule-structure.svg +0 -44
  82. data/docs/assets/images/system-layers.svg +0 -69
  83. data/docs/assets/images/trading-signal-network.svg +0 -139
  84. data/docs/assets/js/mathjax.js +0 -17
  85. data/docs/examples/index.md +0 -223
  86. data/docs/guides/blackboard-memory.md +0 -589
  87. data/docs/guides/dsl.md +0 -1321
  88. data/docs/guides/facts.md +0 -652
  89. data/docs/guides/getting-started.md +0 -385
  90. data/docs/guides/index.md +0 -23
  91. data/docs/guides/negation.md +0 -529
  92. data/docs/guides/pattern-matching.md +0 -561
  93. data/docs/guides/persistence.md +0 -451
  94. data/docs/guides/variable-binding.md +0 -491
  95. data/docs/guides/writing-rules.md +0 -914
  96. data/docs/index.md +0 -155
  97. data/docs/installation.md +0 -156
  98. data/docs/quick-start.md +0 -221
  99. data/docs/what-is-a-fact.md +0 -694
  100. data/docs/what-is-a-knowledge-base.md +0 -350
  101. data/docs/what-is-a-rule.md +0 -833
  102. data/examples/.gitignore +0 -1
  103. data/examples/README.md +0 -531
  104. data/examples/advanced_example.rb +0 -270
  105. data/examples/advanced_example_dsl.rb +0 -224
  106. data/examples/ai_enhanced_kbs.rb +0 -523
  107. data/examples/ai_enhanced_kbs_dsl.rb +0 -538
  108. data/examples/blackboard_demo.rb +0 -50
  109. data/examples/blackboard_demo_dsl.rb +0 -50
  110. data/examples/car_diagnostic.rb +0 -64
  111. data/examples/car_diagnostic_dsl.rb +0 -54
  112. data/examples/concurrent_inference_demo.rb +0 -362
  113. data/examples/concurrent_inference_demo_dsl.rb +0 -362
  114. data/examples/csv_trading_system.rb +0 -559
  115. data/examples/csv_trading_system_dsl.rb +0 -525
  116. data/examples/iot_demo_using_dsl.rb +0 -83
  117. data/examples/portfolio_rebalancing_system.rb +0 -651
  118. data/examples/portfolio_rebalancing_system_dsl.rb +0 -613
  119. data/examples/redis_trading_demo.rb +0 -177
  120. data/examples/redis_trading_demo_dsl.rb +0 -177
  121. data/examples/rule_source_demo.rb +0 -123
  122. data/examples/run_all.rb +0 -50
  123. data/examples/run_all_dsl.rb +0 -49
  124. data/examples/sample_stock_data.csv +0 -46
  125. data/examples/stock_trading_advanced.rb +0 -469
  126. data/examples/stock_trading_advanced_dsl.rb +0 -404
  127. data/examples/temp_dsl.txt +0 -9392
  128. data/examples/timestamped_trading.rb +0 -286
  129. data/examples/timestamped_trading_dsl.rb +0 -258
  130. data/examples/trading_demo.rb +0 -334
  131. data/examples/trading_demo_dsl.rb +0 -322
  132. data/examples/working_demo.rb +0 -176
  133. data/examples/working_demo_dsl.rb +0 -160
  134. data/mkdocs.yml +0 -181
@@ -1,404 +0,0 @@
1
- #!/usr/bin/env ruby
2
-
3
- require_relative '../lib/kbs'
4
-
5
- class AdvancedStockTradingSystem
6
- include KBS::DSL::ConditionHelpers
7
-
8
- def initialize
9
- @kb = nil
10
- @portfolio = {
11
- cash: 100000,
12
- positions: {},
13
- total_value: 100000
14
- }
15
- @market_data = {}
16
- setup_rules
17
- end
18
-
19
- def setup_rules
20
- @kb = KBS.knowledge_base do
21
- rule "golden_cross" do
22
- priority 15
23
- on :technical,
24
- indicator: "ma_crossover",
25
- ma50: satisfies { |v| v > 0 },
26
- ma200: satisfies { |v| v > 0 }
27
- on :stock, volume: satisfies { |v| v > 1000000 }
28
- without.on :position, status: "open"
29
-
30
- perform do |facts|
31
- tech = facts.find { |f| f.type == :technical }
32
- stock = facts.find { |f| f.type == :stock }
33
- if tech && stock && tech[:ma50] > tech[:ma200] && tech[:ma50_prev] <= tech[:ma200_prev]
34
- puts "📈 GOLDEN CROSS: #{stock[:symbol]}"
35
- puts " 50-MA: $#{tech[:ma50].round(2)}, 200-MA: $#{tech[:ma200].round(2)}"
36
- puts " Volume: #{stock[:volume].to_s.reverse.scan(/\d{1,3}/).join(',').reverse}"
37
- puts " ACTION: Strong BUY signal"
38
- end
39
- end
40
- end
41
-
42
- rule "momentum_breakout" do
43
- priority 12
44
- on :stock,
45
- price_change: satisfies { |v| v > 3 },
46
- volume_ratio: satisfies { |v| v > 1.5 },
47
- rsi: satisfies { |v| v.between?(40, 70) }
48
- on :market, sentiment: satisfies { |s| ["bullish", "neutral"].include?(s) }
49
-
50
- perform do |facts|
51
- stock = facts.find { |f| f.type == :stock }
52
- puts "🚀 MOMENTUM BREAKOUT: #{stock[:symbol]}"
53
- puts " Price Change: +#{stock[:price_change]}%"
54
- puts " Volume Spike: #{stock[:volume_ratio]}x average"
55
- puts " RSI: #{stock[:rsi]}"
56
- puts " ACTION: Momentum BUY"
57
- end
58
- end
59
-
60
- rule "oversold_bounce" do
61
- priority 10
62
- on :stock,
63
- rsi: satisfies { |v| v < 30 },
64
- price: satisfies { |p| p > 0 }
65
- on :support, level: satisfies { |l| l > 0 }
66
-
67
- perform do |facts|
68
- stock = facts.find { |f| f.type == :stock }
69
- support = facts.find { |f| f.type == :support }
70
- if stock && support && stock[:price] >= support[:level] * 0.98
71
- puts "🔄 OVERSOLD REVERSAL: #{stock[:symbol]}"
72
- puts " RSI: #{stock[:rsi]} (oversold)"
73
- puts " Price: $#{stock[:price]} near support $#{support[:level].round(2)}"
74
- puts " ACTION: Reversal BUY opportunity"
75
- end
76
- end
77
- end
78
-
79
- rule "trailing_stop" do
80
- priority 18
81
- on :position,
82
- status: "open",
83
- profit_pct: satisfies { |p| p > 5 }
84
- on :stock, price: satisfies { |p| p > 0 }
85
-
86
- perform do |facts|
87
- position = facts.find { |f| f.type == :position }
88
- stock = facts.find { |f| f.type == :stock }
89
- if position && stock
90
- trailing_stop = position[:high_water] * 0.95
91
- if stock[:price] <= trailing_stop
92
- puts "🛑 TRAILING STOP: #{position[:symbol]}"
93
- puts " Entry: $#{position[:entry_price]}"
94
- puts " Current: $#{stock[:price]}"
95
- puts " Stop: $#{trailing_stop.round(2)}"
96
- puts " Profit: #{position[:profit_pct].round(1)}%"
97
- puts " ACTION: SELL to lock profits"
98
- end
99
- end
100
- end
101
- end
102
-
103
- rule "position_sizing" do
104
- priority 8
105
- on :signal,
106
- action: "buy",
107
- confidence: satisfies { |c| c > 0.6 }
108
- on :portfolio, cash: satisfies { |c| c > 1000 }
109
-
110
- perform do |facts|
111
- signal = facts.find { |f| f.type == :signal }
112
- portfolio = facts.find { |f| f.type == :portfolio }
113
- if signal && portfolio
114
- kelly = (signal[:confidence] * signal[:expected_return] - (1 - signal[:confidence])) / signal[:expected_return]
115
- position_size = portfolio[:cash] * [kelly * 0.25, 0.1].min
116
- puts "📊 POSITION SIZING: #{signal[:symbol]}"
117
- puts " Confidence: #{(signal[:confidence] * 100).round}%"
118
- puts " Kelly %: #{(kelly * 100).round(1)}%"
119
- puts " Suggested Size: $#{position_size.round(0)}"
120
- end
121
- end
122
- end
123
-
124
- rule "earnings_play" do
125
- priority 11
126
- on :earnings,
127
- days_until: satisfies { |d| d.between?(1, 5) },
128
- expected_move: satisfies { |m| m > 5 }
129
- on :options,
130
- iv: satisfies { |v| v > 30 },
131
- iv_rank: satisfies { |r| r > 50 }
132
-
133
- perform do |facts|
134
- earnings = facts.find { |f| f.type == :earnings }
135
- options = facts.find { |f| f.type == :options }
136
- puts "💰 EARNINGS PLAY: #{earnings[:symbol]}"
137
- puts " Days to Earnings: #{earnings[:days_until]}"
138
- puts " Expected Move: ±#{earnings[:expected_move]}%"
139
- puts " IV: #{options[:iv]}% (Rank: #{options[:iv_rank]})"
140
- puts " ACTION: Consider volatility strategy"
141
- end
142
- end
143
-
144
- rule "sector_rotation" do
145
- priority 7
146
- on :sector,
147
- performance: satisfies { |p| p > 1.1 },
148
- trend: "up"
149
- on :position,
150
- sector: satisfies { |s| s != nil },
151
- profit_pct: satisfies { |p| p < 2 }
152
-
153
- perform do |facts|
154
- strong_sector = facts.find { |f| f.type == :sector }
155
- weak_position = facts.find { |f| f.type == :position }
156
- if strong_sector && weak_position && strong_sector[:name] != weak_position[:sector]
157
- puts "🔄 SECTOR ROTATION"
158
- puts " From: #{weak_position[:sector]} (underperforming)"
159
- puts " To: #{strong_sector[:name]} (RS: #{strong_sector[:performance]})"
160
- puts " ACTION: Rotate portfolio allocation"
161
- end
162
- end
163
- end
164
-
165
- rule "risk_concentration" do
166
- priority 16
167
- on :portfolio_metrics, concentration: satisfies { |c| c > 0.3 }
168
- on :market, volatility: satisfies { |v| v > 25 }
169
-
170
- perform do |facts|
171
- metrics = facts.find { |f| f.type == :portfolio_metrics }
172
- puts "⚠️ RISK CONCENTRATION ALERT"
173
- puts " Top Position: #{(metrics[:concentration] * 100).round}% of portfolio"
174
- puts " Market Volatility: Elevated"
175
- puts " ACTION: Reduce position sizes for risk management"
176
- end
177
- end
178
-
179
- rule "vwap_reversion" do
180
- priority 9
181
- on :intraday, distance_from_vwap: satisfies { |d| d.abs > 2 }
182
-
183
- perform do |facts|
184
- intraday = facts.find { |f| f.type == :intraday }
185
- direction = intraday[:distance_from_vwap] > 0 ? "OVERBOUGHT" : "OVERSOLD"
186
- puts "📊 VWAP REVERSION: #{intraday[:symbol]}"
187
- puts " Status: #{direction}"
188
- puts " Distance: #{intraday[:distance_from_vwap].round(1)} std devs"
189
- puts " Current: $#{intraday[:price]}"
190
- puts " VWAP: $#{intraday[:vwap].round(2)}"
191
- puts " ACTION: Mean reversion trade"
192
- end
193
- end
194
-
195
- rule "news_sentiment" do
196
- priority 13
197
- on :news,
198
- sentiment: satisfies { |s| s.abs > 0.7 },
199
- volume: satisfies { |v| v > 10 }
200
- on :stock, price_change: satisfies { |p| p.abs < 2 }
201
-
202
- perform do |facts|
203
- news = facts.find { |f| f.type == :news }
204
- stock = facts.find { |f| f.type == :stock }
205
- sentiment = news[:sentiment] > 0 ? "POSITIVE" : "NEGATIVE"
206
- action = news[:sentiment] > 0 ? "BUY" : "SELL"
207
- puts "📰 NEWS CATALYST: #{stock[:symbol]}"
208
- puts " Sentiment: #{sentiment} (#{news[:sentiment].round(2)})"
209
- puts " News Volume: #{news[:volume]} articles"
210
- puts " Price Reaction: #{stock[:price_change].round(1)}% (lagging)"
211
- puts " ACTION: #{action} on sentiment divergence"
212
- end
213
- end
214
-
215
- rule "correlation_warning" do
216
- priority 6
217
- on :correlation, value: satisfies { |v| v > 0.8 }
218
-
219
- perform do |facts|
220
- corr = facts.find { |f| f.type == :correlation }
221
- puts "⚠️ HIGH CORRELATION"
222
- puts " Pairs: #{corr[:symbol1]} <-> #{corr[:symbol2]}"
223
- puts " Correlation: #{corr[:value].round(2)}"
224
- puts " ACTION: Diversify or hedge positions"
225
- end
226
- end
227
-
228
- rule "gap_fade" do
229
- priority 8
230
- on :gap, size: satisfies { |s| s.abs > 2 }
231
- on :stock, atr: satisfies { |a| a > 0 }
232
-
233
- perform do |facts|
234
- gap = facts.find { |f| f.type == :gap }
235
- stock = facts.find { |f| f.type == :stock }
236
- if gap && stock
237
- gap_multiple = gap[:size].abs / (stock[:atr] / stock[:price] * 100)
238
- if gap_multiple > 2
239
- direction = gap[:size] > 0 ? "SHORT" : "LONG"
240
- puts "📉 GAP FADE: #{stock[:symbol]}"
241
- puts " Gap: #{gap[:size].round(1)}%"
242
- puts " ATR Multiple: #{gap_multiple.round(1)}x"
243
- puts " ACTION: #{direction} fade trade"
244
- end
245
- end
246
- end
247
- end
248
- end
249
- end
250
-
251
- def simulate_market_tick(symbols)
252
- symbols.each do |symbol|
253
- @market_data[symbol] ||= {
254
- price: 100 + rand(50),
255
- ma50: 100,
256
- ma200: 100,
257
- volume: 1000000,
258
- rsi: 50,
259
- high_water: 100
260
- }
261
-
262
- data = @market_data[symbol]
263
-
264
- price_change = rand(-5.0..5.0)
265
- data[:price] = (data[:price] * (1 + price_change / 100)).round(2)
266
- data[:ma50] = (data[:ma50] * 0.98 + data[:price] * 0.02).round(2)
267
- data[:ma200] = (data[:ma200] * 0.995 + data[:price] * 0.005).round(2)
268
- data[:volume] = (1000000 * (0.5 + rand * 2)).to_i
269
- data[:rsi] = [[data[:rsi] + rand(-10..10), 0].max, 100].min
270
- data[:high_water] = [data[:high_water], data[:price]].max
271
-
272
- @kb.fact :stock, {
273
- symbol: symbol,
274
- price: data[:price],
275
- volume: data[:volume],
276
- rsi: data[:rsi],
277
- price_change: price_change,
278
- volume_ratio: data[:volume] / 1000000.0,
279
- atr: rand(1.0..3.0)
280
- }
281
-
282
- @kb.fact :technical, {
283
- symbol: symbol,
284
- indicator: "ma_crossover",
285
- ma50: data[:ma50],
286
- ma200: data[:ma200],
287
- ma50_prev: data[:ma50] - rand(-1.0..1.0),
288
- ma200_prev: data[:ma200] - rand(-0.5..0.5)
289
- }
290
-
291
- @kb.fact :support, {
292
- symbol: symbol,
293
- level: data[:price] * 0.95
294
- }
295
-
296
- if rand > 0.7
297
- @kb.fact :intraday, {
298
- symbol: symbol,
299
- price: data[:price],
300
- vwap: data[:price] + rand(-2.0..2.0),
301
- distance_from_vwap: rand(-3.0..3.0)
302
- }
303
- end
304
-
305
- if rand > 0.8
306
- @kb.fact :news, {
307
- symbol: symbol,
308
- sentiment: rand(-1.0..1.0),
309
- volume: rand(5..50)
310
- }
311
- end
312
-
313
- if rand > 0.85
314
- @kb.fact :earnings, {
315
- symbol: symbol,
316
- days_until: rand(1..10),
317
- expected_move: rand(3.0..15.0)
318
- }
319
-
320
- @kb.fact :options, {
321
- symbol: symbol,
322
- iv: rand(20..80),
323
- iv_rank: rand(0..100)
324
- }
325
- end
326
-
327
- if rand > 0.9
328
- @kb.fact :gap, {
329
- symbol: symbol,
330
- size: rand(-5.0..5.0)
331
- }
332
- end
333
- end
334
-
335
- @kb.fact :market, {
336
- sentiment: ["bullish", "neutral", "bearish"].sample,
337
- volatility: rand(10..40)
338
- }
339
-
340
- if @portfolio[:positions].any?
341
- total_value = @portfolio[:cash] + @portfolio[:positions].values.sum { |p| p[:value] }
342
- max_position = @portfolio[:positions].values.map { |p| p[:value] }.max || 0
343
- @kb.fact :portfolio_metrics, {
344
- concentration: max_position.to_f / total_value
345
- }
346
- end
347
-
348
- @kb.fact :portfolio, {
349
- cash: @portfolio[:cash],
350
- risk_tolerance: 0.5
351
- }
352
-
353
- if rand > 0.85
354
- symbols_pair = symbols.sample(2)
355
- @kb.fact :correlation, {
356
- symbol1: symbols_pair[0],
357
- symbol2: symbols_pair[1],
358
- value: rand(0.5..0.95)
359
- }
360
- end
361
-
362
- sectors = ["Technology", "Healthcare", "Finance", "Energy", "Consumer"]
363
- @kb.fact :sector, {
364
- name: sectors.sample,
365
- performance: rand(0.8..1.3),
366
- trend: ["up", "down", "sideways"].sample
367
- }
368
- end
369
-
370
- def run_simulation(symbols: ["AAPL", "GOOGL", "MSFT", "NVDA"], iterations: 10)
371
- puts "\n" + "=" * 80
372
- puts "ADVANCED STOCK TRADING SYSTEM"
373
- puts "=" * 80
374
- puts "Initial Capital: $100,000"
375
- puts "Symbols: #{symbols.join(', ')}"
376
- puts "Rules: #{@kb.engine.rules.size} active trading strategies"
377
- puts "=" * 80
378
-
379
- iterations.times do |i|
380
- puts "\n⏰ MARKET TICK #{i + 1} - #{Time.now.strftime('%H:%M:%S')}"
381
- puts "-" * 60
382
-
383
- @kb.reset
384
-
385
- simulate_market_tick(symbols)
386
-
387
- @kb.run
388
-
389
- sleep(0.3) if i < iterations - 1
390
- end
391
-
392
- puts "\n" + "=" * 80
393
- puts "SIMULATION COMPLETE"
394
- puts "=" * 80
395
- end
396
- end
397
-
398
- if __FILE__ == $0
399
- system = AdvancedStockTradingSystem.new
400
- system.run_simulation(
401
- symbols: ["AAPL", "GOOGL", "MSFT", "NVDA", "TSLA", "META", "AMZN"],
402
- iterations: 12
403
- )
404
- end