kbs 0.0.1 → 0.1.0

data/examples/timestamped_trading.rb

@@ -5,7 +5,7 @@ require 'time'
 
 class TimestampedTradingSystem
   def initialize
-    @engine = KBS::ReteEngine.new
+    @engine = KBS::Engine.new
     @market_open = Time.parse("09:30:00")
     @market_close = Time.parse("16:00:00")
     setup_time_aware_rules

data/examples/timestamped_trading_dsl.rb

@@ -0,0 +1,258 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/kbs/dsl'
+require 'time'
+
+class TimestampedTradingSystem
+  include KBS::DSL::ConditionHelpers
+
+  def initialize
+    @kb = nil
+    @market_open = Time.parse("09:30:00")
+    @market_close = Time.parse("16:00:00")
+    setup_time_aware_rules
+  end
+
+  def format_volume(volume)
+    if volume >= 1_000_000
+      "#{(volume / 1_000_000.0).round(1)}M"
+    elsif volume >= 1_000
+      "#{(volume / 1_000.0).round(1)}K"
+    else
+      volume.to_s
+    end
+  end
+
+  def setup_time_aware_rules
+    ts_sys = self  # Capture self for use in perform blocks
+    @kb = KBS.knowledge_base do
+      rule "fresh_momentum" do
+        priority 15
+        on :stock,
+          price_change: satisfies { |p| p && p > 2 },
+          timestamp: satisfies { |t| t && (Time.now - t) < 60 },
+          market_session: "regular"
+
+        perform do |facts|
+          stock = facts.find { |f| f.type == :stock }
+          age = Time.now - stock[:timestamp]
+          puts "🚀 FRESH MOMENTUM: #{stock[:symbol]}"
+          puts "   Price Change: +#{stock[:price_change]}%"
+          puts "   Data Age: #{age.round(1)} seconds"
+          puts "   Market Time: #{stock[:market_time]}"
+          puts "   Recommendation: BUY (fresh signal)"
+        end
+      end
+
+      rule "stale_data_warning" do
+        priority 20
+        on :stock, timestamp: satisfies { |t| t && (Time.now - t) > 300 }
+
+        perform do |facts|
+          stock = facts.find { |f| f.type == :stock }
+          age = Time.now - stock[:timestamp]
+          puts "⚠️  STALE DATA: #{stock[:symbol]}"
+          puts "   Data Age: #{(age / 60).round(1)} minutes"
+          puts "   Last Update: #{stock[:timestamp]}"
+          puts "   ACTION: IGNORE - Data too old"
+        end
+      end
+
+      rule "market_hours_check" do
+        on :stock,
+          market_session: "after_hours",
+          volume: satisfies { |v| v && v > 100_000 }
+
+        perform do |facts|
+          stock = facts.find { |f| f.type == :stock }
+          puts "🌙 AFTER HOURS ACTIVITY: #{stock[:symbol]}"
+          puts "   Volume: #{ts_sys.format_volume(stock[:volume])}"
+          puts "   Time: #{stock[:market_time]}"
+          puts "   ACTION: Monitor for gap potential"
+        end
+      end
+
+      rule "rapid_movement" do
+        on :price_tick,
+          time_delta: satisfies { |d| d && d < 5 },
+          price_delta: satisfies { |d| d && d.abs > 0.50 }
+
+        perform do |facts|
+          tick = facts.find { |f| f.type == :price_tick }
+          direction = tick[:price_delta] > 0 ? "📈 UP" : "📉 DOWN"
+          puts "⚡ RAPID MOVEMENT: #{tick[:symbol]} #{direction}"
+          puts "   Price Change: #{tick[:price_delta] > 0 ? '+' : ''}$#{tick[:price_delta]}"
+          puts "   Time Frame: #{tick[:time_delta]} seconds"
+          puts "   ACTION: Check for news catalyst"
+        end
+      end
+
+      rule "opening_gap" do
+        on :stock,
+          market_time: satisfies { |t|
+            t && (t.hour == 9 && t.min >= 30 && t.min <= 35)
+          },
+          gap_percentage: satisfies { |g| g && g.abs > 1 }
+
+        perform do |facts|
+          stock = facts.find { |f| f.type == :stock }
+          direction = stock[:gap_percentage] > 0 ? "GAP UP" : "GAP DOWN"
+          puts "🔔 OPENING #{direction}: #{stock[:symbol]}"
+          puts "   Gap: #{stock[:gap_percentage] > 0 ? '+' : ''}#{stock[:gap_percentage]}%"
+          puts "   Time: #{stock[:market_time]}"
+          puts "   Volume: #{ts_sys.format_volume(stock[:volume])}"
+          puts "   ACTION: Monitor for gap fill or continuation"
+        end
+      end
+
+      rule "end_of_day" do
+        on :stock, market_time: satisfies { |t|
+          t && (t.hour == 15 && t.min >= 45)
+        }
+        on :position, status: "open"
+
+        perform do |facts|
+          stock = facts.find { |f| f.type == :stock }
+          position = facts.find { |f| f.type == :position }
+          puts "🕐 END OF DAY: #{position[:symbol]}"
+          puts "   Current Time: #{stock[:market_time]}"
+          puts "   Position P&L: #{position[:unrealized_pnl]}"
+          puts "   ACTION: Consider closing before market close"
+        end
+      end
+    end
+  end
+
+  def determine_market_session(time)
+    hour_min = time.hour * 100 + time.min
+
+    case hour_min
+    when 400..929 then "pre_market"
+    when 930..1559 then "regular"
+    when 1600..2000 then "after_hours"
+    else "closed"
+    end
+  end
+
+  def add_timestamped_stock_fact(symbol, price, volume, options = {})
+    timestamp = options[:timestamp] || Time.now
+    market_time = options[:market_time] || timestamp
+
+    @kb.fact :stock, {
+      symbol: symbol,
+      price: price,
+      volume: volume,
+      timestamp: timestamp,
+      market_time: market_time,
+      market_session: determine_market_session(market_time),
+      price_change: options[:price_change] || 0,
+      gap_percentage: options[:gap_percentage] || 0
+    }
+  end
+
+  def add_price_tick(symbol, old_price, new_price, old_time, new_time)
+    price_delta = new_price - old_price
+    time_delta = new_time - old_time
+
+    @kb.fact :price_tick, {
+      symbol: symbol,
+      old_price: old_price,
+      new_price: new_price,
+      price_delta: price_delta,
+      time_delta: time_delta,
+      timestamp: new_time
+    }
+  end
+
+  def simulate_trading_day
+    puts "🏦 TIMESTAMPED STOCK TRADING SYSTEM"
+    puts "=" * 60
+
+    base_time = Time.parse("2024-08-15 09:30:00")
+
+    # Scenario 1: Market Open with Gap
+    puts "\n📊 SCENARIO 1: Market Open Gap Up"
+    puts "-" * 40
+    @kb.reset
+
+    add_timestamped_stock_fact("AAPL", 185.50, 2_500_000, {
+      market_time: base_time + 2*60, # 9:32 AM
+      price_change: 2.1,
+      gap_percentage: 2.3
+    })
+    @kb.run
+
+    # Scenario 2: Fresh Momentum Signal
+    puts "\n📊 SCENARIO 2: Fresh Momentum (Recent Data)"
+    puts "-" * 40
+    @kb.reset
+
+    add_timestamped_stock_fact("GOOGL", 142.80, 1_200_000, {
+      timestamp: Time.now - 30, # 30 seconds ago
+      market_time: Time.now - 30,
+      price_change: 3.2
+    })
+    @kb.run
+
+    # Scenario 3: Stale Data
+    puts "\n📊 SCENARIO 3: Stale Data Warning"
+    puts "-" * 40
+    @kb.reset
+
+    add_timestamped_stock_fact("TSLA", 195.40, 800_000, {
+      timestamp: Time.now - 600, # 10 minutes ago
+      market_time: Time.now - 600,
+      price_change: 1.5
+    })
+    @kb.run
+
+    # Scenario 4: After Hours Activity
+    puts "\n📊 SCENARIO 4: After Hours Trading"
+    puts "-" * 40
+    @kb.reset
+
+    after_hours_time = Time.parse("2024-08-15 17:30:00")
+    add_timestamped_stock_fact("NVDA", 425.80, 150_000, {
+      market_time: after_hours_time,
+      timestamp: after_hours_time
+    })
+    @kb.run
+
+    # Scenario 5: Rapid Price Movement
+    puts "\n📊 SCENARIO 5: Rapid Price Tick"
+    puts "-" * 40
+    @kb.reset
+
+    tick_time = Time.now
+    add_price_tick("META", 298.50, 299.25, tick_time - 3, tick_time)
+    @kb.run
+
+    # Scenario 6: End of Day
+    puts "\n📊 SCENARIO 6: End of Trading Day"
+    puts "-" * 40
+    @kb.reset
+
+    eod_time = Time.parse("2024-08-15 15:50:00")
+    add_timestamped_stock_fact("AMZN", 142.30, 900_000, {
+      market_time: eod_time,
+      timestamp: eod_time
+    })
+
+    @kb.fact :position, {
+      symbol: "AMZN",
+      status: "open",
+      shares: 100,
+      entry_price: 140.00,
+      unrealized_pnl: 230.00
+    }
+    @kb.run
+
+    puts "\n" + "=" * 60
+    puts "TIMESTAMPED TRADING SIMULATION COMPLETE"
+  end
+end
+
+if __FILE__ == $0
+  system = TimestampedTradingSystem.new
+  system.simulate_trading_day
+end

data/examples/trading_demo.rb

@@ -4,7 +4,7 @@ require_relative '../lib/kbs'
 
 class TradingDemo
   def initialize
-    @engine = KBS::ReteEngine.new
+    @engine = KBS::Engine.new
     setup_trading_rules
     puts "🏦 STOCK TRADING EXPERT SYSTEM LOADED"
     puts "📊 #{@engine.rules.size} trading strategies active"

data/examples/trading_demo_dsl.rb

@@ -0,0 +1,322 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/kbs/dsl'
+include KBS::DSL::ConditionHelpers
+
+class TradingDemo
+  attr_reader :kb
+
+  def initialize
+    @kb = create_knowledge_base
+    puts "🏦 STOCK TRADING EXPERT SYSTEM LOADED"
+    puts "📊 #{@kb.rules.size} trading strategies active"
+  end
+
+  def create_knowledge_base
+    demo = self  # Capture self for use in perform blocks
+    KBS.knowledge_base do
+      rule "golden_cross_buy" do
+        on :ma_signal, type: "golden_cross"
+        on :stock do
+          volume greater_than(500000)
+        end
+
+        perform do |facts, bindings|
+          stock = facts.find { |f| f.type == :stock }
+          signal = facts.find { |f| f.type == :ma_signal }
+          puts "📈 GOLDEN CROSS SIGNAL: #{stock[:symbol]}"
+          puts "   50-MA crossed above 200-MA"
+          puts "   Volume: #{demo.format_volume(stock[:volume])}"
+          puts "   Price: $#{stock[:price]}"
+          puts "   Recommendation: STRONG BUY"
+        end
+      end
+
+      rule "momentum_breakout" do
+        on :stock do
+          price_change greater_than(2)
+          rsi between(50, 75)
+        end
+
+        perform do |facts, bindings|
+          stock = facts.find { |f| f.type == :stock }
+          puts "🚀 MOMENTUM BREAKOUT: #{stock[:symbol]}"
+          puts "   Price Change: +#{stock[:price_change].round(1)}%"
+          puts "   RSI: #{stock[:rsi].round(1)} (strong but not overbought)"
+          puts "   Recommendation: BUY"
+        end
+      end
+
+      rule "oversold_reversal" do
+        on :stock do
+          rsi less_than(35)
+        end
+        on :market, trend: "bullish"
+
+        perform do |facts, bindings|
+          stock = facts.find { |f| f.type == :stock }
+          puts "🔄 OVERSOLD REVERSAL: #{stock[:symbol]}"
+          puts "   RSI: #{stock[:rsi].round(1)} (oversold)"
+          puts "   Market: Bullish environment"
+          puts "   Recommendation: CONTRARIAN BUY"
+        end
+      end
+
+      rule "earnings_play" do
+        on :earnings do
+          days_until satisfies { |d| d <= 3 }
+        end
+        on :options do
+          iv greater_than(40)
+        end
+
+        perform do |facts, bindings|
+          earnings = facts.find { |f| f.type == :earnings }
+          options = facts.find { |f| f.type == :options }
+          puts "💰 EARNINGS PLAY: #{earnings[:symbol]}"
+          puts "   Earnings in #{earnings[:days_until]} day(s)"
+          puts "   Implied Volatility: #{options[:iv].round(1)}%"
+          puts "   Recommendation: VOLATILITY STRATEGY"
+        end
+      end
+
+      rule "stop_loss_alert" do
+        on :position do
+          status "open"
+          loss_pct greater_than(8)
+        end
+
+        perform do |facts, bindings|
+          position = facts.find { |f| f.type == :position }
+          puts "🛑 STOP LOSS TRIGGERED: #{position[:symbol]}"
+          puts "   Loss: #{position[:loss_pct].round(1)}%"
+          puts "   Entry: $#{position[:entry_price]}"
+          puts "   Current: $#{position[:current_price]}"
+          puts "   Recommendation: SELL IMMEDIATELY"
+        end
+      end
+
+      rule "concentration_risk" do
+        on :portfolio do
+          concentration greater_than(25)
+        end
+
+        perform do |facts, bindings|
+          portfolio = facts.find { |f| f.type == :portfolio }
+          puts "⚠️  CONCENTRATION RISK: #{portfolio[:top_holding]}"
+          puts "   Position Size: #{portfolio[:concentration].round(1)}% of portfolio"
+          puts "   Recommendation: DIVERSIFY HOLDINGS"
+        end
+      end
+
+      rule "news_sentiment" do
+        on :news do
+          sentiment satisfies { |s| s.abs > 0.6 }
+          impact "high"
+        end
+
+        perform do |facts, bindings|
+          news = facts.find { |f| f.type == :news }
+          sentiment = news[:sentiment] > 0 ? "POSITIVE" : "NEGATIVE"
+          action = news[:sentiment] > 0 ? "BUY" : "SELL"
+          puts "📰 NEWS CATALYST: #{news[:symbol]}"
+          puts "   Sentiment: #{sentiment} (#{news[:sentiment].round(2)})"
+          puts "   Impact: HIGH"
+          puts "   Recommendation: #{action} ON NEWS"
+        end
+      end
+
+      rule "sector_strength" do
+        on :sector do
+          performance greater_than(5)
+          trend "accelerating"
+        end
+
+        perform do |facts, bindings|
+          sector = facts.find { |f| f.type == :sector }
+          puts "🔄 SECTOR ROTATION: #{sector[:name]}"
+          puts "   Performance: +#{sector[:performance].round(1)}%"
+          puts "   Trend: Accelerating"
+          puts "   Recommendation: INCREASE ALLOCATION"
+        end
+      end
+    end
+  end
+
+  def format_volume(volume)
+    if volume >= 1_000_000
+      "#{(volume / 1_000_000.0).round(1)}M"
+    elsif volume >= 1_000
+      "#{(volume / 1_000.0).round(1)}K"
+    else
+      volume.to_s
+    end
+  end
+
+  def generate_scenario(name, &block)
+    puts "\n" + "="*60
+    puts "SCENARIO: #{name}"
+    puts "="*60
+
+    @kb.reset
+
+    yield
+
+    puts "\nFacts in working memory:"
+    @kb.facts.each do |fact|
+      puts "  #{fact}"
+    end
+    puts ""
+
+    @kb.run
+
+    puts "-"*60
+  end
+
+  def demo_scenarios
+    generate_scenario("Bull Market with Golden Cross") do
+      @kb.fact :stock, {
+        symbol: "AAPL",
+        price: 185.50,
+        volume: 1_250_000,
+        price_change: 1.2,
+        rsi: 65
+      }
+
+      @kb.fact :ma_signal, {
+        symbol: "AAPL",
+        type: "golden_cross"
+      }
+
+      @kb.fact :market, { trend: "bullish" }
+    end
+
+    generate_scenario("Momentum Breakout") do
+      @kb.fact :stock, {
+        symbol: "NVDA",
+        price: 425.80,
+        volume: 980_000,
+        price_change: 4.7,
+        rsi: 68
+      }
+
+      @kb.fact :market, { trend: "bullish" }
+    end
+
+    generate_scenario("Oversold Bounce Opportunity") do
+      @kb.fact :stock, {
+        symbol: "TSLA",
+        price: 178.90,
+        volume: 750_000,
+        price_change: -2.1,
+        rsi: 28
+      }
+
+      @kb.fact :market, { trend: "bullish" }
+    end
+
+    generate_scenario("Earnings Volatility Play") do
+      @kb.fact :earnings, {
+        symbol: "GOOGL",
+        days_until: 2,
+        expected_move: 8.5
+      }
+
+      @kb.fact :options, {
+        symbol: "GOOGL",
+        iv: 45.2,
+        iv_rank: 75
+      }
+    end
+
+    generate_scenario("Stop Loss Alert") do
+      @kb.fact :position, {
+        symbol: "META",
+        status: "open",
+        entry_price: 320.00,
+        current_price: 285.40,
+        loss_pct: 10.8,
+        shares: 100
+      }
+    end
+
+    generate_scenario("Portfolio Risk Warning") do
+      @kb.fact :portfolio, {
+        total_value: 250_000,
+        top_holding: "AAPL",
+        concentration: 32.5,
+        cash_pct: 5
+      }
+    end
+
+    generate_scenario("News-Driven Trade") do
+      @kb.fact :news, {
+        symbol: "MSFT",
+        sentiment: -0.75,
+        impact: "high",
+        headlines: "Major cloud outage affects services"
+      }
+
+      @kb.fact :stock, {
+        symbol: "MSFT",
+        price: 395.20,
+        price_change: -1.2,
+        volume: 890_000
+      }
+    end
+
+    generate_scenario("Sector Rotation Signal") do
+      @kb.fact :sector, {
+        name: "Technology",
+        performance: 7.3,
+        trend: "accelerating",
+        leaders: ["AAPL", "MSFT", "GOOGL"]
+      }
+    end
+
+    generate_scenario("Complex Multi-Signal Day") do
+      @kb.fact :stock, {
+        symbol: "AMZN",
+        price: 142.50,
+        volume: 1_800_000,
+        price_change: 3.8,
+        rsi: 72
+      }
+
+      @kb.fact :ma_signal, {
+        symbol: "AMZN",
+        type: "golden_cross"
+      }
+
+      @kb.fact :news, {
+        symbol: "AMZN",
+        sentiment: 0.8,
+        impact: "high",
+        headlines: "AWS wins major government contract"
+      }
+
+      @kb.fact :earnings, {
+        symbol: "AMZN",
+        days_until: 1,
+        expected_move: 6.2
+      }
+
+      @kb.fact :options, {
+        symbol: "AMZN",
+        iv: 52.1,
+        iv_rank: 85
+      }
+
+      @kb.fact :market, { trend: "bullish" }
+    end
+  end
+end
+
+if __FILE__ == $0
+  demo = TradingDemo.new
+  demo.demo_scenarios
+
+  puts "\n" + "="*60
+  puts "TRADING SYSTEM DEMONSTRATION COMPLETE"
+  puts "="*60
+end

data/examples/working_demo.rb

@@ -4,7 +4,7 @@ require_relative '../lib/kbs'
 
 class WorkingTradingDemo
   def initialize
-    @engine = KBS::ReteEngine.new
+    @engine = KBS::Engine.new
     setup_simple_rules
   end