kbs 0.2.0 → 0.3.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 +86 -0
  3. data/README.md +52 -25
  4. data/lib/kbs/agenda.rb +208 -0
  5. data/lib/kbs/alpha_memory.rb +55 -7
  6. data/lib/kbs/alpha_network.rb +83 -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 +39 -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 +104 -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 +75 -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 +27 -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 +60 -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,286 +0,0 @@
1
- #!/usr/bin/env ruby
2
-
3
- require_relative '../lib/kbs'
4
- require 'time'
5
-
6
- class TimestampedTradingSystem
7
- def initialize
8
- @engine = KBS::Engine.new
9
- @market_open = Time.parse("09:30:00")
10
- @market_close = Time.parse("16:00:00")
11
- setup_time_aware_rules
12
- end
13
-
14
- def setup_time_aware_rules
15
- # Rule 1: Fresh data only
16
- fresh_momentum_rule = KBS::Rule.new(
17
- "fresh_momentum",
18
- conditions: [
19
- KBS::Condition.new(:stock, {
20
- price_change: ->(p) { p && p > 2 },
21
- timestamp: ->(t) { t && (Time.now - t) < 60 }, # Within 1 minute
22
- market_session: "regular"
23
- })
24
- ],
25
- action: lambda do |facts, bindings|
26
- stock = facts.find { |f| f.type == :stock }
27
- age = Time.now - stock[:timestamp]
28
- puts "šŸš€ FRESH MOMENTUM: #{stock[:symbol]}"
29
- puts " Price Change: +#{stock[:price_change]}%"
30
- puts " Data Age: #{age.round(1)} seconds"
31
- puts " Market Time: #{stock[:market_time]}"
32
- puts " Recommendation: BUY (fresh signal)"
33
- end,
34
- priority: 15
35
- )
36
-
37
- # Rule 2: Stale data warning
38
- stale_data_rule = KBS::Rule.new(
39
- "stale_data_warning",
40
- conditions: [
41
- KBS::Condition.new(:stock, {
42
- timestamp: ->(t) { t && (Time.now - t) > 300 } # Older than 5 minutes
43
- })
44
- ],
45
- action: lambda do |facts, bindings|
46
- stock = facts.find { |f| f.type == :stock }
47
- age = Time.now - stock[:timestamp]
48
- puts "āš ļø STALE DATA: #{stock[:symbol]}"
49
- puts " Data Age: #{(age / 60).round(1)} minutes"
50
- puts " Last Update: #{stock[:timestamp]}"
51
- puts " ACTION: IGNORE - Data too old"
52
- end,
53
- priority: 20
54
- )
55
-
56
- # Rule 3: Market hours validation
57
- market_hours_rule = KBS::Rule.new(
58
- "market_hours_check",
59
- conditions: [
60
- KBS::Condition.new(:stock, {
61
- market_session: "after_hours",
62
- volume: ->(v) { v && v > 100_000 }
63
- })
64
- ],
65
- action: lambda do |facts, bindings|
66
- stock = facts.find { |f| f.type == :stock }
67
- puts "šŸŒ™ AFTER HOURS ACTIVITY: #{stock[:symbol]}"
68
- puts " Volume: #{format_volume(stock[:volume])}"
69
- puts " Time: #{stock[:market_time]}"
70
- puts " ACTION: Monitor for gap potential"
71
- end
72
- )
73
-
74
- # Rule 4: Rapid price movement detection
75
- rapid_movement_rule = KBS::Rule.new(
76
- "rapid_movement",
77
- conditions: [
78
- KBS::Condition.new(:price_tick, {
79
- time_delta: ->(d) { d && d < 5 }, # Within 5 seconds
80
- price_delta: ->(d) { d && d.abs > 0.50 } # More than $0.50 move
81
- })
82
- ],
83
- action: lambda do |facts, bindings|
84
- tick = facts.find { |f| f.type == :price_tick }
85
- direction = tick[:price_delta] > 0 ? "šŸ“ˆ UP" : "šŸ“‰ DOWN"
86
- puts "⚔ RAPID MOVEMENT: #{tick[:symbol]} #{direction}"
87
- puts " Price Change: #{tick[:price_delta] > 0 ? '+' : ''}$#{tick[:price_delta]}"
88
- puts " Time Frame: #{tick[:time_delta]} seconds"
89
- puts " ACTION: Check for news catalyst"
90
- end
91
- )
92
-
93
- # Rule 5: Time-based strategy
94
- opening_gap_rule = KBS::Rule.new(
95
- "opening_gap",
96
- conditions: [
97
- KBS::Condition.new(:stock, {
98
- market_time: ->(t) {
99
- t && (t.hour == 9 && t.min >= 30 && t.min <= 35) # First 5 minutes
100
- },
101
- gap_percentage: ->(g) { g && g.abs > 1 }
102
- })
103
- ],
104
- action: lambda do |facts, bindings|
105
- stock = facts.find { |f| f.type == :stock }
106
- direction = stock[:gap_percentage] > 0 ? "GAP UP" : "GAP DOWN"
107
- puts "šŸ”” OPENING #{direction}: #{stock[:symbol]}"
108
- puts " Gap: #{stock[:gap_percentage] > 0 ? '+' : ''}#{stock[:gap_percentage]}%"
109
- puts " Time: #{stock[:market_time]}"
110
- puts " Volume: #{format_volume(stock[:volume])}"
111
- puts " ACTION: Monitor for gap fill or continuation"
112
- end
113
- )
114
-
115
- # Rule 6: End of day positioning
116
- eod_rule = KBS::Rule.new(
117
- "end_of_day",
118
- conditions: [
119
- KBS::Condition.new(:stock, {
120
- market_time: ->(t) {
121
- t && (t.hour == 15 && t.min >= 45) # Last 15 minutes
122
- }
123
- }),
124
- KBS::Condition.new(:position, { status: "open" })
125
- ],
126
- action: lambda do |facts, bindings|
127
- stock = facts.find { |f| f.type == :stock }
128
- position = facts.find { |f| f.type == :position }
129
- puts "šŸ• END OF DAY: #{position[:symbol]}"
130
- puts " Current Time: #{stock[:market_time]}"
131
- puts " Position P&L: #{position[:unrealized_pnl]}"
132
- puts " ACTION: Consider closing before market close"
133
- end
134
- )
135
-
136
- @engine.add_rule(fresh_momentum_rule)
137
- @engine.add_rule(stale_data_rule)
138
- @engine.add_rule(market_hours_rule)
139
- @engine.add_rule(rapid_movement_rule)
140
- @engine.add_rule(opening_gap_rule)
141
- @engine.add_rule(eod_rule)
142
- end
143
-
144
- def format_volume(volume)
145
- if volume >= 1_000_000
146
- "#{(volume / 1_000_000.0).round(1)}M"
147
- elsif volume >= 1_000
148
- "#{(volume / 1_000.0).round(1)}K"
149
- else
150
- volume.to_s
151
- end
152
- end
153
-
154
- def determine_market_session(time)
155
- hour_min = time.hour * 100 + time.min
156
-
157
- case hour_min
158
- when 400..929 then "pre_market"
159
- when 930..1559 then "regular"
160
- when 1600..2000 then "after_hours"
161
- else "closed"
162
- end
163
- end
164
-
165
- def add_timestamped_stock_fact(symbol, price, volume, options = {})
166
- timestamp = options[:timestamp] || Time.now
167
- market_time = options[:market_time] || timestamp
168
-
169
- @engine.add_fact(:stock, {
170
- symbol: symbol,
171
- price: price,
172
- volume: volume,
173
- timestamp: timestamp,
174
- market_time: market_time,
175
- market_session: determine_market_session(market_time),
176
- price_change: options[:price_change] || 0,
177
- gap_percentage: options[:gap_percentage] || 0
178
- })
179
- end
180
-
181
- def add_price_tick(symbol, old_price, new_price, old_time, new_time)
182
- price_delta = new_price - old_price
183
- time_delta = new_time - old_time
184
-
185
- @engine.add_fact(:price_tick, {
186
- symbol: symbol,
187
- old_price: old_price,
188
- new_price: new_price,
189
- price_delta: price_delta,
190
- time_delta: time_delta,
191
- timestamp: new_time
192
- })
193
- end
194
-
195
- def simulate_trading_day
196
- puts "šŸ¦ TIMESTAMPED STOCK TRADING SYSTEM"
197
- puts "=" * 60
198
-
199
- base_time = Time.parse("2024-08-15 09:30:00")
200
-
201
- # Scenario 1: Market Open with Gap
202
- puts "\nšŸ“Š SCENARIO 1: Market Open Gap Up"
203
- puts "-" * 40
204
- @engine.working_memory.facts.clear
205
-
206
- add_timestamped_stock_fact("AAPL", 185.50, 2_500_000, {
207
- market_time: base_time + 2*60, # 9:32 AM
208
- price_change: 2.1,
209
- gap_percentage: 2.3
210
- })
211
- @engine.run
212
-
213
- # Scenario 2: Fresh Momentum Signal
214
- puts "\nšŸ“Š SCENARIO 2: Fresh Momentum (Recent Data)"
215
- puts "-" * 40
216
- @engine.working_memory.facts.clear
217
-
218
- add_timestamped_stock_fact("GOOGL", 142.80, 1_200_000, {
219
- timestamp: Time.now - 30, # 30 seconds ago
220
- market_time: Time.now - 30,
221
- price_change: 3.2
222
- })
223
- @engine.run
224
-
225
- # Scenario 3: Stale Data
226
- puts "\nšŸ“Š SCENARIO 3: Stale Data Warning"
227
- puts "-" * 40
228
- @engine.working_memory.facts.clear
229
-
230
- add_timestamped_stock_fact("TSLA", 195.40, 800_000, {
231
- timestamp: Time.now - 600, # 10 minutes ago
232
- market_time: Time.now - 600,
233
- price_change: 1.5
234
- })
235
- @engine.run
236
-
237
- # Scenario 4: After Hours Activity
238
- puts "\nšŸ“Š SCENARIO 4: After Hours Trading"
239
- puts "-" * 40
240
- @engine.working_memory.facts.clear
241
-
242
- after_hours_time = Time.parse("2024-08-15 17:30:00")
243
- add_timestamped_stock_fact("NVDA", 425.80, 150_000, {
244
- market_time: after_hours_time,
245
- timestamp: after_hours_time
246
- })
247
- @engine.run
248
-
249
- # Scenario 5: Rapid Price Movement
250
- puts "\nšŸ“Š SCENARIO 5: Rapid Price Tick"
251
- puts "-" * 40
252
- @engine.working_memory.facts.clear
253
-
254
- tick_time = Time.now
255
- add_price_tick("META", 298.50, 299.25, tick_time - 3, tick_time)
256
- @engine.run
257
-
258
- # Scenario 6: End of Day
259
- puts "\nšŸ“Š SCENARIO 6: End of Trading Day"
260
- puts "-" * 40
261
- @engine.working_memory.facts.clear
262
-
263
- eod_time = Time.parse("2024-08-15 15:50:00")
264
- add_timestamped_stock_fact("AMZN", 142.30, 900_000, {
265
- market_time: eod_time,
266
- timestamp: eod_time
267
- })
268
-
269
- @engine.add_fact(:position, {
270
- symbol: "AMZN",
271
- status: "open",
272
- shares: 100,
273
- entry_price: 140.00,
274
- unrealized_pnl: 230.00
275
- })
276
- @engine.run
277
-
278
- puts "\n" + "=" * 60
279
- puts "TIMESTAMPED TRADING SIMULATION COMPLETE"
280
- end
281
- end
282
-
283
- if __FILE__ == $0
284
- system = TimestampedTradingSystem.new
285
- system.simulate_trading_day
286
- end
@@ -1,258 +0,0 @@
1
- #!/usr/bin/env ruby
2
-
3
- require_relative '../lib/kbs'
4
- require 'time'
5
-
6
- class TimestampedTradingSystem
7
- include KBS::DSL::ConditionHelpers
8
-
9
- def initialize
10
- @kb = nil
11
- @market_open = Time.parse("09:30:00")
12
- @market_close = Time.parse("16:00:00")
13
- setup_time_aware_rules
14
- end
15
-
16
- def format_volume(volume)
17
- if volume >= 1_000_000
18
- "#{(volume / 1_000_000.0).round(1)}M"
19
- elsif volume >= 1_000
20
- "#{(volume / 1_000.0).round(1)}K"
21
- else
22
- volume.to_s
23
- end
24
- end
25
-
26
- def setup_time_aware_rules
27
- ts_sys = self # Capture self for use in perform blocks
28
- @kb = KBS.knowledge_base do
29
- rule "fresh_momentum" do
30
- priority 15
31
- on :stock,
32
- price_change: satisfies { |p| p && p > 2 },
33
- timestamp: satisfies { |t| t && (Time.now - t) < 60 },
34
- market_session: "regular"
35
-
36
- perform do |facts|
37
- stock = facts.find { |f| f.type == :stock }
38
- age = Time.now - stock[:timestamp]
39
- puts "šŸš€ FRESH MOMENTUM: #{stock[:symbol]}"
40
- puts " Price Change: +#{stock[:price_change]}%"
41
- puts " Data Age: #{age.round(1)} seconds"
42
- puts " Market Time: #{stock[:market_time]}"
43
- puts " Recommendation: BUY (fresh signal)"
44
- end
45
- end
46
-
47
- rule "stale_data_warning" do
48
- priority 20
49
- on :stock, timestamp: satisfies { |t| t && (Time.now - t) > 300 }
50
-
51
- perform do |facts|
52
- stock = facts.find { |f| f.type == :stock }
53
- age = Time.now - stock[:timestamp]
54
- puts "āš ļø STALE DATA: #{stock[:symbol]}"
55
- puts " Data Age: #{(age / 60).round(1)} minutes"
56
- puts " Last Update: #{stock[:timestamp]}"
57
- puts " ACTION: IGNORE - Data too old"
58
- end
59
- end
60
-
61
- rule "market_hours_check" do
62
- on :stock,
63
- market_session: "after_hours",
64
- volume: satisfies { |v| v && v > 100_000 }
65
-
66
- perform do |facts|
67
- stock = facts.find { |f| f.type == :stock }
68
- puts "šŸŒ™ AFTER HOURS ACTIVITY: #{stock[:symbol]}"
69
- puts " Volume: #{ts_sys.format_volume(stock[:volume])}"
70
- puts " Time: #{stock[:market_time]}"
71
- puts " ACTION: Monitor for gap potential"
72
- end
73
- end
74
-
75
- rule "rapid_movement" do
76
- on :price_tick,
77
- time_delta: satisfies { |d| d && d < 5 },
78
- price_delta: satisfies { |d| d && d.abs > 0.50 }
79
-
80
- perform do |facts|
81
- tick = facts.find { |f| f.type == :price_tick }
82
- direction = tick[:price_delta] > 0 ? "šŸ“ˆ UP" : "šŸ“‰ DOWN"
83
- puts "⚔ RAPID MOVEMENT: #{tick[:symbol]} #{direction}"
84
- puts " Price Change: #{tick[:price_delta] > 0 ? '+' : ''}$#{tick[:price_delta]}"
85
- puts " Time Frame: #{tick[:time_delta]} seconds"
86
- puts " ACTION: Check for news catalyst"
87
- end
88
- end
89
-
90
- rule "opening_gap" do
91
- on :stock,
92
- market_time: satisfies { |t|
93
- t && (t.hour == 9 && t.min >= 30 && t.min <= 35)
94
- },
95
- gap_percentage: satisfies { |g| g && g.abs > 1 }
96
-
97
- perform do |facts|
98
- stock = facts.find { |f| f.type == :stock }
99
- direction = stock[:gap_percentage] > 0 ? "GAP UP" : "GAP DOWN"
100
- puts "šŸ”” OPENING #{direction}: #{stock[:symbol]}"
101
- puts " Gap: #{stock[:gap_percentage] > 0 ? '+' : ''}#{stock[:gap_percentage]}%"
102
- puts " Time: #{stock[:market_time]}"
103
- puts " Volume: #{ts_sys.format_volume(stock[:volume])}"
104
- puts " ACTION: Monitor for gap fill or continuation"
105
- end
106
- end
107
-
108
- rule "end_of_day" do
109
- on :stock, market_time: satisfies { |t|
110
- t && (t.hour == 15 && t.min >= 45)
111
- }
112
- on :position, status: "open"
113
-
114
- perform do |facts|
115
- stock = facts.find { |f| f.type == :stock }
116
- position = facts.find { |f| f.type == :position }
117
- puts "šŸ• END OF DAY: #{position[:symbol]}"
118
- puts " Current Time: #{stock[:market_time]}"
119
- puts " Position P&L: #{position[:unrealized_pnl]}"
120
- puts " ACTION: Consider closing before market close"
121
- end
122
- end
123
- end
124
- end
125
-
126
- def determine_market_session(time)
127
- hour_min = time.hour * 100 + time.min
128
-
129
- case hour_min
130
- when 400..929 then "pre_market"
131
- when 930..1559 then "regular"
132
- when 1600..2000 then "after_hours"
133
- else "closed"
134
- end
135
- end
136
-
137
- def add_timestamped_stock_fact(symbol, price, volume, options = {})
138
- timestamp = options[:timestamp] || Time.now
139
- market_time = options[:market_time] || timestamp
140
-
141
- @kb.fact :stock, {
142
- symbol: symbol,
143
- price: price,
144
- volume: volume,
145
- timestamp: timestamp,
146
- market_time: market_time,
147
- market_session: determine_market_session(market_time),
148
- price_change: options[:price_change] || 0,
149
- gap_percentage: options[:gap_percentage] || 0
150
- }
151
- end
152
-
153
- def add_price_tick(symbol, old_price, new_price, old_time, new_time)
154
- price_delta = new_price - old_price
155
- time_delta = new_time - old_time
156
-
157
- @kb.fact :price_tick, {
158
- symbol: symbol,
159
- old_price: old_price,
160
- new_price: new_price,
161
- price_delta: price_delta,
162
- time_delta: time_delta,
163
- timestamp: new_time
164
- }
165
- end
166
-
167
- def simulate_trading_day
168
- puts "šŸ¦ TIMESTAMPED STOCK TRADING SYSTEM"
169
- puts "=" * 60
170
-
171
- base_time = Time.parse("2024-08-15 09:30:00")
172
-
173
- # Scenario 1: Market Open with Gap
174
- puts "\nšŸ“Š SCENARIO 1: Market Open Gap Up"
175
- puts "-" * 40
176
- @kb.reset
177
-
178
- add_timestamped_stock_fact("AAPL", 185.50, 2_500_000, {
179
- market_time: base_time + 2*60, # 9:32 AM
180
- price_change: 2.1,
181
- gap_percentage: 2.3
182
- })
183
- @kb.run
184
-
185
- # Scenario 2: Fresh Momentum Signal
186
- puts "\nšŸ“Š SCENARIO 2: Fresh Momentum (Recent Data)"
187
- puts "-" * 40
188
- @kb.reset
189
-
190
- add_timestamped_stock_fact("GOOGL", 142.80, 1_200_000, {
191
- timestamp: Time.now - 30, # 30 seconds ago
192
- market_time: Time.now - 30,
193
- price_change: 3.2
194
- })
195
- @kb.run
196
-
197
- # Scenario 3: Stale Data
198
- puts "\nšŸ“Š SCENARIO 3: Stale Data Warning"
199
- puts "-" * 40
200
- @kb.reset
201
-
202
- add_timestamped_stock_fact("TSLA", 195.40, 800_000, {
203
- timestamp: Time.now - 600, # 10 minutes ago
204
- market_time: Time.now - 600,
205
- price_change: 1.5
206
- })
207
- @kb.run
208
-
209
- # Scenario 4: After Hours Activity
210
- puts "\nšŸ“Š SCENARIO 4: After Hours Trading"
211
- puts "-" * 40
212
- @kb.reset
213
-
214
- after_hours_time = Time.parse("2024-08-15 17:30:00")
215
- add_timestamped_stock_fact("NVDA", 425.80, 150_000, {
216
- market_time: after_hours_time,
217
- timestamp: after_hours_time
218
- })
219
- @kb.run
220
-
221
- # Scenario 5: Rapid Price Movement
222
- puts "\nšŸ“Š SCENARIO 5: Rapid Price Tick"
223
- puts "-" * 40
224
- @kb.reset
225
-
226
- tick_time = Time.now
227
- add_price_tick("META", 298.50, 299.25, tick_time - 3, tick_time)
228
- @kb.run
229
-
230
- # Scenario 6: End of Day
231
- puts "\nšŸ“Š SCENARIO 6: End of Trading Day"
232
- puts "-" * 40
233
- @kb.reset
234
-
235
- eod_time = Time.parse("2024-08-15 15:50:00")
236
- add_timestamped_stock_fact("AMZN", 142.30, 900_000, {
237
- market_time: eod_time,
238
- timestamp: eod_time
239
- })
240
-
241
- @kb.fact :position, {
242
- symbol: "AMZN",
243
- status: "open",
244
- shares: 100,
245
- entry_price: 140.00,
246
- unrealized_pnl: 230.00
247
- }
248
- @kb.run
249
-
250
- puts "\n" + "=" * 60
251
- puts "TIMESTAMPED TRADING SIMULATION COMPLETE"
252
- end
253
- end
254
-
255
- if __FILE__ == $0
256
- system = TimestampedTradingSystem.new
257
- system.simulate_trading_day
258
- end