smart_message 0.0.10 → 0.0.12

data/examples/city_scenario/health_monitoring_system.svg

@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="900" height="600" viewBox="0 0 900 600" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .health { fill: #1a3a2a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .fire { fill: #4a2a1a; stroke: #ffaa4a; stroke-width: 2; rx: 8; }
+      .police { fill: #1a2a3a; stroke: #4aafff; stroke-width: 2; rx: 8; }
+      .bank { fill: #3a2a1a; stroke: #ffcc4a; stroke-width: 2; rx: 8; }
+      .house { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .check-msg { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .status-msg { stroke: #ffaa4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-orange); stroke-dasharray: 5,3; }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .note { fill: #aaaaaa; font-family: 'Arial', sans-serif; font-size: 9px; }
+    </style>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="900" height="600"/>
+  
+  <!-- Title -->
+  <text x="450" y="25" text-anchor="middle" class="title">Health Monitoring System</text>
+  <text x="450" y="45" text-anchor="middle" class="subtitle">COVID-19 Compliant Service Health Checks (Every 5 seconds)</text>
+  
+  <!-- Participants -->
+  <rect x="50" y="80" width="120" height="80" class="health"/>
+  <text x="110" y="105" text-anchor="middle" class="text">🏥 Health</text>
+  <text x="110" y="120" text-anchor="middle" class="text">Department</text>
+  <text x="110" y="140" text-anchor="middle" class="subtitle">Central Monitor</text>
+  <text x="110" y="155" text-anchor="middle" class="subtitle">COVID-19 Compliance</text>
+  
+  <rect x="240" y="80" width="120" height="80" class="fire"/>
+  <text x="300" y="105" text-anchor="middle" class="text">🚒 Fire</text>
+  <text x="300" y="120" text-anchor="middle" class="text">Department</text>
+  <text x="300" y="140" text-anchor="middle" class="subtitle">Emergency Response</text>
+  
+  <rect x="430" y="80" width="120" height="80" class="police"/>
+  <text x="490" y="105" text-anchor="middle" class="text">👮 Police</text>
+  <text x="490" y="120" text-anchor="middle" class="text">Department</text>
+  <text x="490" y="140" text-anchor="middle" class="subtitle">Law Enforcement</text>
+  
+  <rect x="620" y="80" width="120" height="80" class="bank"/>
+  <text x="680" y="105" text-anchor="middle" class="text">🏦 Local</text>
+  <text x="680" y="120" text-anchor="middle" class="text">Bank</text>
+  <text x="680" y="140" text-anchor="middle" class="subtitle">Financial Security</text>
+  
+  <rect x="810" y="80" width="80" height="80" class="house"/>
+  <text x="850" y="105" text-anchor="middle" class="text">🏠 House</text>
+  <text x="850" y="125" text-anchor="middle" class="subtitle">Residential</text>
+  <text x="850" y="140" text-anchor="middle" class="subtitle">Safety</text>
+  
+  <!-- Vertical lifelines -->
+  <line x1="110" y1="160" x2="110" y2="520" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="300" y1="160" x2="300" y2="520" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="490" y1="160" x2="490" y2="520" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="680" y1="160" x2="680" y2="520" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="850" y1="160" x2="850" y2="520" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  
+  <!-- Health check broadcast note -->
+  <rect x="50" y="180" width="120" height="30" fill="#1a3a2a" stroke="#4aff4a" rx="4"/>
+  <text x="110" y="200" text-anchor="middle" class="note">Every 5 seconds</text>
+  
+  <!-- Health check messages (broadcast to all) -->
+  <path d="M 110 220 L 300 220" class="check-msg"/>
+  <path d="M 110 240 L 490 240" class="check-msg"/>
+  <path d="M 110 260 L 680 260" class="check-msg"/>
+  <path d="M 110 280 L 850 280" class="check-msg"/>
+  
+  <text x="205" y="215" text-anchor="middle" class="text">HealthCheckMessage</text>
+  <text x="300" y="235" text-anchor="middle" class="text">HealthCheckMessage</text>
+  <text x="395" y="255" text-anchor="middle" class="text">HealthCheckMessage</text>
+  <text x="480" y="275" text-anchor="middle" class="text">HealthCheckMessage</text>
+  
+  <!-- Health status responses -->
+  <path d="M 300 320 L 110 320" class="status-msg"/>
+  <path d="M 490 340 L 110 340" class="status-msg"/>
+  <path d="M 680 360 L 110 360" class="status-msg"/>
+  <path d="M 850 380 L 110 380" class="status-msg"/>
+  
+  <text x="205" y="315" text-anchor="middle" class="text">HealthStatusMessage</text>
+  <text x="300" y="335" text-anchor="middle" class="text">HealthStatusMessage</text>
+  <text x="395" y="355" text-anchor="middle" class="text">HealthStatusMessage</text>
+  <text x="480" y="375" text-anchor="middle" class="text">HealthStatusMessage</text>
+  
+  <!-- Status indicators -->
+  <circle cx="300" cy="310" r="6" fill="#4aff4a"/>
+  <text x="320" y="315" class="note">Green</text>
+  
+  <circle cx="490" cy="330" r="6" fill="#ffff4a"/>
+  <text x="510" y="335" class="note">Yellow</text>
+  
+  <circle cx="680" cy="350" r="6" fill="#4aff4a"/>
+  <text x="700" y="355" class="note">Green</text>
+  
+  <circle cx="850" cy="370" r="6" fill="#ff4a4a"/>
+  <text x="820" y="375" class="note">Red</text>
+  
+  <!-- Countdown timer notes -->
+  <rect x="200" y="420" width="500" height="60" fill="#1a1a1a" stroke="#ffaa4a" rx="6"/>
+  <text x="210" y="440" class="text">10-second Countdown Timer System:</text>
+  <text x="210" y="455" class="note">• Resets on each HealthCheckMessage received</text>
+  <text x="210" y="470" class="note">• Services shut down after 10 seconds without health check (COVID-19 protocol)</text>
+  <text x="210" y="485" class="note">• Status: Green (healthy), Yellow (warning), Red (critical/offline)</text>
+  
+  <!-- Service status legend -->
+  <rect x="50" y="500" width="840" height="80" fill="#2a2a2a" stroke="#4a9eff" rx="6"/>
+  <text x="70" y="520" class="title">Service Health Status Indicators:</text>
+  
+  <circle cx="90" cy="540" r="8" fill="#4aff4a"/>
+  <text x="110" y="545" class="text">Green: Service healthy and responsive</text>
+  
+  <circle cx="320" cy="540" r="8" fill="#ffff4a"/>
+  <text x="340" y="545" class="text">Yellow: Service degraded or slow response</text>
+  
+  <circle cx="580" cy="540" r="8" fill="#ff4a4a"/>
+  <text x="600" y="545" class="text">Red: Service critical or unresponsive</text>
+  
+  <text x="70" y="565" class="text">All services implement countdown timer health monitoring for COVID-19 compliance</text>
+  <text x="70" y="580" class="text">Health Department broadcasts HealthCheckMessage every 5 seconds to maintain service operation</text>
+</svg>

data/examples/city_scenario/house.rb

@@ -0,0 +1,244 @@
+#!/usr/bin/env ruby
+# examples/multi_program_demo/house.rb
+
+require_relative '../../lib/smart_message'
+require_relative 'messages/fire_emergency_message'
+require_relative 'messages/fire_dispatch_message'
+
+require_relative 'common/health_monitor'
+require_relative 'common/logger'
+
+class House
+  include Common::HealthMonitor
+  include Common::Logger
+
+  def initialize(address = nil)
+    @address = address || generate_random_address
+    @service_name = "house-#{@address.gsub(/\s+/, '-').downcase}"
+    @status = 'healthy'
+    @start_time = Time.now
+    @fire_active = false
+    @last_fire_time = nil
+    @occupants = rand(1..4)
+    @occupant_status = 'safe'
+
+    setup_messaging
+    setup_signal_handlers
+    setup_health_monitor
+  end
+
+  # def setup_logging
+  #   # Create log file name based on address (sanitized)
+  #   address_slug = @address.gsub(/\s+/, '_').gsub(/[^\w\-_]/, '').downcase
+  #   log_file = File.join(__dir__, "house_#{address_slug}.log")
+  #   logger = Logger.new(log_file)
+  #   logger.level = Logger::INFO
+  #   logger.formatter = proc do |severity, datetime, progname, msg|
+  #     "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n"
+  #   end
+  #   logger.info("House at #{@address} logging started")
+  # end
+
+  def setup_messaging
+    Messages::FireEmergencyMessage.from = @service_name
+
+    # Subscribe to fire dispatch responses
+    Messages::FireDispatchMessage.subscribe(to: @service_name) do |message|
+      handle_fire_response(message)
+    end
+
+    address_slug = @address.gsub(/\s+/, '_').gsub(/[^\w\-_]/, '').downcase
+    puts "🏠 House at #{@address} monitoring systems active"
+    puts "   Occupants: #{@occupants}"
+    puts "   Status: #{@occupant_status}"
+    puts "   Press Ctrl+C to shutdown monitoring\n\n"
+    logger.info("House monitoring started: #{@occupants} occupants, status: #{@occupant_status}")
+  end
+
+  def setup_signal_handlers
+    %w[INT TERM].each do |signal|
+      Signal.trap(signal) do
+        puts "\n🏠 #{@address} monitoring system shutting down..."
+        logger.info("House monitoring system shutting down")
+        exit(0)
+      end
+    end
+  end
+
+
+  def start_monitoring
+    loop do
+      simulate_house_activity
+      sleep(rand(15..45))  # Random events every 15-45 seconds
+    end
+  rescue => e
+    puts "🏠 Error in house monitoring: #{e.message}"
+    logger.error("Error in house monitoring: #{e.message}")
+    retry
+  end
+
+  private
+
+  def service_emoji
+    "🏠"
+  end
+
+  def generate_random_address
+    street_numbers = (100..999).to_a
+    street_names = [
+      'Oak Street', 'Maple Avenue', 'Pine Lane', 'Cedar Drive', 'Elm Court',
+      'Birch Road', 'Willow Way', 'Ash Boulevard', 'Cherry Street', 'Poplar Lane'
+    ]
+    "#{street_numbers.sample} #{street_names.sample}"
+  end
+
+  def get_status_details
+    # Status depends on fire situation and occupant safety
+    @status = if @fire_active
+               'critical'
+             elsif @occupant_status.include?('trapped') || @occupant_status.include?('rescued')
+               'warning'
+             else
+               'healthy'
+             end
+
+    details = case @status
+             when 'healthy' then "All systems normal, #{@occupants} occupants #{@occupant_status}"
+             when 'warning' then "Emergency response active, #{@occupants} occupants #{@occupant_status}"
+             when 'critical' then "FIRE DETECTED - #{@occupants} occupants status: #{@occupant_status}"
+             when 'failed' then "Power outage, backup systems failed"
+             end
+
+    [@status, details]
+  end
+
+  def simulate_house_activity
+    # Only start fires occasionally and not too frequently
+    return if @fire_active
+    return if @last_fire_time && (Time.now - @last_fire_time) < 600  # 10 minutes minimum between fires
+
+    # 6% chance of fire
+    if rand(100) < 6
+      start_fire
+    else
+      # Normal house activities
+      activities = [
+        'Security system armed',
+        'Temperature adjusted',
+        'Motion detected - normal activity',
+        'Smoke detector test completed',
+        'Door/window sensor check',
+        'All systems operational'
+      ]
+      activity = activities.sample
+      puts "🏠 #{activity}"
+      logger.info("Normal activity: #{activity}")
+    end
+  end
+
+  def start_fire
+    @fire_active = true
+    @last_fire_time = Time.now
+
+    fire_types = ['kitchen', 'electrical', 'basement', 'garage']
+    severities = ['small', 'medium', 'large']
+
+    # Garage fires tend to be more severe
+    fire_type = fire_types.sample
+    severity = if fire_type == 'garage'
+                ['medium', 'large', 'out_of_control'].sample
+              else
+                severities.sample
+              end
+
+    # Determine occupant status based on fire severity and time of day
+    hour = Time.now.hour
+    if severity == 'out_of_control' || (hour >= 22 || hour <= 6)  # Night time
+      @occupant_status = ['safe - evacuated', 'trapped - need rescue'].sample
+    else
+      @occupant_status = 'safe - evacuated'
+    end
+
+    # Determine spread risk
+    spread_risk = case severity
+                 when 'small' then 'Low risk to neighboring structures'
+                 when 'medium' then 'Moderate risk if not contained quickly'
+                 when 'large' then 'High risk to adjacent buildings'
+                 when 'out_of_control' then 'EXTREME RISK - evacuate neighbors'
+                 end
+
+    emergency = Messages::FireEmergencyMessage.new(
+      house_address: @address,
+      fire_type: fire_type,
+      severity: severity,
+      timestamp: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+      occupants_status: @occupant_status,
+      spread_risk: spread_risk,
+    )
+    emergency.publish
+
+    puts "🏠 🔥 FIRE EMERGENCY 🔥"
+    puts "   Address: #{@address}"
+    puts "   Type: #{fire_type.upcase}"
+    puts "   Severity: #{severity.upcase}"
+    puts "   Occupants: #{@occupant_status}"
+    puts "   Spread Risk: #{spread_risk}"
+    logger.warn("FIRE EMERGENCY: #{fire_type} fire (#{severity}) - Occupants: #{@occupant_status}")
+  rescue => e
+    puts "🏠 Error starting fire emergency: #{e.message}"
+    logger.error("Error starting fire emergency: #{e.message}")
+  end
+
+  def handle_fire_response(dispatch)
+    # Process fire dispatch message
+    puts "🚒 \e[31mFIRE DISPATCH\e[0m ##{dispatch.dispatch_id}"
+    puts "   Engines: #{dispatch.engines_assigned.join(', ')}"
+    puts "   Location: #{dispatch.location}"
+    puts "   Fire Type: #{dispatch.fire_type}"
+    puts "   Equipment: #{dispatch.equipment_needed}" if dispatch.equipment_needed
+    puts "   ETA: #{dispatch.estimated_arrival}" if dispatch.estimated_arrival
+    puts "   Dispatched: #{dispatch.timestamp}"
+
+    puts "🏠 Fire department response received"
+    puts "   #{dispatch.engines_assigned.size} engines dispatched"
+    puts "   ETA: #{dispatch.estimated_arrival}"
+    puts "   Equipment: #{dispatch.equipment_needed}"
+    logger.info("Fire department response: #{dispatch.engines_assigned.join(', ')} dispatched, ETA #{dispatch.estimated_arrival}")
+
+    # If occupants were trapped, fire department rescues them
+    if @occupant_status.include?('trapped')
+      @occupant_status = 'rescued by fire department'
+      puts "🏠 🚒 Occupants successfully rescued!"
+      logger.info("Occupants rescued by fire department")
+    end
+
+    # Simulate fire resolution when fire department arrives
+    Thread.new do
+      sleep(rand(300..900))  # 5-15 minutes for fire suppression
+      extinguish_fire
+    end
+  rescue => e
+    puts "🏠 Error handling fire response: #{e.message}"
+    logger.error("Error handling fire response: #{e.message}")
+  end
+
+  def extinguish_fire
+    @fire_active = false
+    @occupant_status = 'safe'
+
+    puts "🏠 ✅ Fire extinguished by fire department"
+    puts "   All occupants accounted for and safe"
+    puts "   House systems returning to normal"
+    logger.info("Fire extinguished, all occupants safe, returning to normal")
+  rescue => e
+    puts "🏠 Error extinguishing fire: #{e.message}"
+    logger.error("Error extinguishing fire: #{e.message}")
+  end
+end
+
+if __FILE__ == $0
+  # Allow specifying address as command line argument
+  address = ARGV[0]
+  house = House.new(address)
+  house.start_monitoring
+end

data/examples/city_scenario/local_bank.rb

@@ -0,0 +1,217 @@
+#!/usr/bin/env ruby
+# examples/multi_program_demo/local_bank.rb
+
+require_relative '../../lib/smart_message'
+require_relative 'messages/health_check_message'
+require_relative 'messages/health_status_message'
+require_relative 'messages/silent_alarm_message'
+require_relative 'messages/police_dispatch_message'
+
+require_relative 'common/health_monitor'
+require_relative 'common/logger'
+
+class LocalBank
+  include Common::HealthMonitor
+  include Common::Logger
+
+  def initialize
+    @service_name = 'first-national-bank'
+    @location = '123 Main Street'
+    @status = 'healthy'
+    @start_time = Time.now
+    @alarm_active = false
+    @last_alarm_time = nil
+    @security_level = 'normal'
+
+    setup_messaging
+    setup_signal_handlers
+    setup_health_monitor
+  end
+
+  # def setup_logging
+  #   log_file = File.join(__dir__, 'local_bank.log')
+  #   logger = Logger.new(log_file)
+  #   logger.level = Logger::INFO
+  #   logger.formatter = proc do |severity, datetime, progname, msg|
+  #     "#{datetime.strftime('%Y-%m-%d %H:%M:%S')} [#{severity}] #{msg}\n"
+  #   end
+  #   logger.info("Local Bank logging started")
+  # end
+
+  def setup_messaging
+    # Subscribe to police dispatch responses
+    Messages::PoliceDispatchMessage.subscribe(to: @service_name) do |message|
+      handle_police_response(message)
+    end
+
+    puts "🏦 #{@service_name} open for business"
+    puts "   Location: #{@location}"
+    puts "   Security level: #{@security_level}"
+    puts "   Logging to: local_bank.log"
+    puts "   Press Ctrl+C to close\n\n"
+    logger.info("#{@service_name} open for business at #{@location}")
+  end
+
+  def setup_signal_handlers
+    %w[INT TERM].each do |signal|
+      Signal.trap(signal) do
+        puts "\n🏦 #{@service_name} closing for the day..."
+        logger.info("#{@service_name} closing for the day")
+        exit(0)
+      end
+    end
+  end
+
+
+  def start_operations
+    loop do
+      simulate_bank_activity
+      sleep(rand(10..30))  # Random activities every 10-30 seconds
+    end
+  rescue => e
+    puts "🏦 Error in bank operations: #{e.message}"
+    logger.error("Error in bank operations: #{e.message}")
+    retry
+  end
+
+  private
+
+  def service_emoji
+    "🏦"
+  end
+
+  def get_status_details
+    # Determine status based on security level and alarm state
+    @status = if @alarm_active
+                'critical'
+              elsif @security_level == 'high'
+                'warning'
+              else
+                'healthy'
+              end
+
+    details = case @status
+             when 'healthy' then "All systems operational, security level: #{@security_level}"
+             when 'warning' then "Elevated security, monitoring active"
+             when 'critical' then "Security breach detected, lockdown protocols active"
+             when 'failed' then "Systems offline, emergency procedures in effect"
+             end
+
+    [@status, details]
+  end
+
+  def simulate_bank_activity
+    # Only trigger alarms occasionally and not too frequently
+    return if @alarm_active
+    return if @last_alarm_time && (Time.now - @last_alarm_time) < 300  # 5 minutes minimum between alarms
+
+    # 8% chance of suspicious activity
+    if rand(100) < 8
+      trigger_silent_alarm
+    else
+      # Normal bank operations
+      activities = [
+        'Customer transaction completed',
+        'ATM refilled',
+        'Vault inspection completed',
+        'Security patrol completed',
+        'System backup completed'
+      ]
+      activity = activities.sample
+      puts "🏦 #{activity}"
+      logger.info("Normal operation: #{activity}")
+    end
+  end
+
+  def trigger_silent_alarm
+    @alarm_active = true
+    @last_alarm_time = Time.now
+    @security_level = 'high'
+
+    alarm_types = ['robbery', 'vault_breach', 'suspicious_activity']
+    severities = ['medium', 'high', 'critical']
+
+    alarm_type = alarm_types.sample
+    severity = alarm_type == 'robbery' ? 'critical' : severities.sample
+
+    details = case alarm_type
+             when 'robbery'
+               'Armed individuals at teller window, customers on floor'
+             when 'vault_breach'
+               'Unauthorized access attempt detected in vault area'
+             when 'suspicious_activity'
+               'Multiple individuals casing the building, unusual behavior'
+             end
+
+    alarm = Messages::SilentAlarmMessage.new(
+      bank_name: @service_name,
+      location: @location,
+      alarm_type: alarm_type,
+      timestamp: Time.now.strftime('%Y-%m-%d %H:%M:%S'),
+      severity: severity,
+      details: details
+    )
+    alarm._sm_from = @service_name
+    alarm._sm_to = 'police-department'
+    alarm.publish
+
+    puts "🏦 🚨 SILENT ALARM TRIGGERED 🚨"
+    puts "   Type: #{alarm_type.upcase}"
+    puts "   Severity: #{severity.upcase}"
+    puts "   Details: #{details}"
+    logger.warn("SILENT ALARM TRIGGERED: #{alarm_type} (#{severity}) - #{details}")
+  rescue => e
+    puts "🏦 Error triggering silent alarm: #{e.message}"
+    logger.error("Error triggering silent alarm: #{e.message}")
+  end
+
+  def handle_police_response(dispatch)
+    # Process police dispatch message with colored output
+    priority_color = case dispatch.priority
+                    when 'low' then "\e[32m"        # Green
+                    when 'medium' then "\e[33m"     # Yellow
+                    when 'high' then "\e[93m"       # Orange
+                    when 'emergency' then "\e[31m"  # Red
+                    else "\e[0m"
+                    end
+
+    puts "🚔 #{priority_color}POLICE DISPATCH\e[0m ##{dispatch.dispatch_id}"
+    puts "   Units: #{dispatch.units_assigned.join(', ')}"
+    puts "   Location: #{dispatch.location}"
+    puts "   Incident: #{dispatch.incident_type} (#{dispatch.priority.upcase} priority)"
+    puts "   ETA: #{dispatch.estimated_arrival}" if dispatch.estimated_arrival
+    puts "   Dispatched: #{dispatch.timestamp}"
+
+    puts "🏦 Police response received - #{dispatch.units_assigned.size} units dispatched"
+    puts "   ETA: #{dispatch.estimated_arrival}"
+    puts "   Implementing security protocols..."
+    logger.info("Police response received: #{dispatch.units_assigned.join(', ')} dispatched, ETA #{dispatch.estimated_arrival}")
+
+    # Simulate resolution after police arrive
+    Thread.new do
+      sleep(rand(180..600))  # 3-10 minutes for resolution
+      resolve_security_incident
+    end
+  rescue => e
+    puts "🏦 Error handling police response: #{e.message}"
+    logger.error("Error handling police response: #{e.message}")
+  end
+
+  def resolve_security_incident
+    @alarm_active = false
+    @security_level = 'normal'
+
+    puts "🏦 ✅ Security incident resolved"
+    puts "   Returning to normal operations"
+    puts "   Security level: #{@security_level}"
+    logger.info("Security incident resolved, returning to normal operations")
+  rescue => e
+    puts "🏦 Error resolving security incident: #{e.message}"
+    logger.error("Error resolving security incident: #{e.message}")
+  end
+end
+
+if __FILE__ == $0
+  bank = LocalBank.new
+  bank.start_operations
+end

data/examples/city_scenario/messages/emergency_911_message.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/env ruby
+# examples/messages/emergency_911_message.rb
+
+require_relative '../../../lib/smart_message'
+
+module Messages
+  class Emergency911Message < SmartMessage::Base
+    version 1
+
+    description 'Emergency 911 call for reporting fires, crimes, accidents, medical emergencies, or other urgent situations requiring police, fire, or medical response'
+
+    transport  SmartMessage::Transport::RedisTransport.new
+    serializer SmartMessage::Serializer::Json.new
+
+    VALID_EMERGENCY_TYPES = %w[fire medical crime accident hazmat rescue other]
+    VALID_SEVERITY = %w[critical high medium low]
+
+    # Caller information
+    property :caller_name,
+             description: 'Name of the person calling 911'
+
+    property :caller_phone,
+             description: 'Phone number of the caller'
+
+    property :caller_location,
+             required: true,
+             description: 'Location of the emergency (address or description)'
+
+    property :emergency_type,
+             required: true,
+             validate: ->(v) { VALID_EMERGENCY_TYPES.include?(v) },
+             validation_message: "Emergency type must be: #{VALID_EMERGENCY_TYPES.join(', ')}",
+             description: "Type of emergency being reported. Valid values: #{VALID_EMERGENCY_TYPES.join(', ')}"
+
+    property :description,
+             required: true,
+             description: 'Detailed description of the emergency'
+
+    property :severity,
+             validate: ->(v) { VALID_SEVERITY.include?(v) },
+             validation_message: "Severity must be: #{VALID_SEVERITY.join(', ')}",
+             description: "Perceived severity of the emergency. Valid values: #{VALID_SEVERITY.join(', ')}"
+
+    property :injuries_reported,
+             description: 'Are there injuries? (true/false)'
+
+    property :number_of_victims,
+             description: 'Number of people affected or injured'
+
+    property :fire_involved,
+             description: 'Is there fire involved? (true/false)'
+
+    property :weapons_involved,
+             description: 'Are weapons involved? (true/false)'
+
+    property :hazardous_materials,
+             description: 'Are hazardous materials involved? (true/false)'
+
+    property :vehicles_involved,
+             description: 'Number of vehicles involved (for accidents)'
+
+    property :suspects_on_scene,
+             description: 'Are suspects still on scene? (true/false)'
+
+    property :additional_info,
+             description: 'Any additional information provided by caller'
+
+    property :dispatch_to,
+             description: 'Which departments to dispatch to (array of department names)'
+
+    property :priority,
+             description: 'Dispatch priority level (1-5, 1 being highest)'
+
+    property :call_id,
+             description: 'Unique identifier for this 911 call'
+
+    property :call_received_at,
+             default: -> { Time.now.iso8601 },
+             description: 'When the 911 call was received'
+  end
+end