tasker-rb 0.1.3-x86_64-linux

data/lib/tasker_core/observability/types.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require 'dry-struct'
+require 'dry-types'
+
+module TaskerCore
+  module Observability
+    # Type definitions for observability data structures
+    #
+    # These types use dry-struct for automatic validation and provide
+    # structured access to health, metrics, and configuration data.
+    module Types
+      include Dry.Types()
+
+      # ==========================================================================
+      # Health Types
+      # ==========================================================================
+
+      # Basic health check response
+      class BasicHealth < Dry::Struct
+        attribute :status, Types::Strict::String
+        attribute :worker_id, Types::Strict::String
+        attribute :timestamp, Types::Strict::String
+      end
+
+      # Individual health check result
+      class HealthCheck < Dry::Struct
+        attribute :status, Types::Strict::String
+        attribute :message, Types::Strict::String.optional
+        attribute :duration_ms, Types::Strict::Integer
+        attribute :last_checked, Types::Strict::String
+      end
+
+      # Worker system information
+      class WorkerSystemInfo < Dry::Struct
+        attribute :version, Types::Strict::String
+        attribute :environment, Types::Strict::String
+        attribute :uptime_seconds, Types::Strict::Integer
+        attribute :worker_type, Types::Strict::String
+        attribute :database_pool_size, Types::Strict::Integer
+        attribute :command_processor_active, Types::Strict::Bool
+        attribute :supported_namespaces, Types::Strict::Array.of(Types::Strict::String)
+      end
+
+      # Detailed health check response
+      class DetailedHealth < Dry::Struct
+        attribute :status, Types::Strict::String
+        attribute :timestamp, Types::Strict::String
+        attribute :worker_id, Types::Strict::String
+        attribute :checks, Types::Strict::Hash.map(Types::Strict::String, HealthCheck)
+        attribute :system_info, WorkerSystemInfo
+      end
+
+      # ==========================================================================
+      # Metrics Types
+      # ==========================================================================
+
+      # Event router statistics
+      class EventRouterStats < Dry::Struct
+        attribute :total_routed, Types::Strict::Integer
+        attribute :durable_routed, Types::Strict::Integer
+        attribute :fast_routed, Types::Strict::Integer
+        attribute :broadcast_routed, Types::Strict::Integer
+        attribute :fast_delivery_errors, Types::Strict::Integer
+        attribute :routing_errors, Types::Strict::Integer
+      end
+
+      # In-process event bus statistics
+      class InProcessEventBusStats < Dry::Struct
+        attribute :total_events_dispatched, Types::Strict::Integer
+        attribute :rust_handler_dispatches, Types::Strict::Integer
+        attribute :ffi_channel_dispatches, Types::Strict::Integer
+        attribute :rust_handler_errors, Types::Strict::Integer
+        attribute :ffi_channel_drops, Types::Strict::Integer
+        attribute :rust_subscriber_patterns, Types::Strict::Integer
+        attribute :rust_handler_count, Types::Strict::Integer
+        attribute :ffi_subscriber_count, Types::Strict::Integer
+      end
+
+      # Domain event statistics
+      class DomainEventStats < Dry::Struct
+        attribute :router, EventRouterStats
+        attribute :in_process_bus, InProcessEventBusStats
+        attribute :captured_at, Types::Strict::String
+        attribute :worker_id, Types::Strict::String
+      end
+
+      # ==========================================================================
+      # Template Types
+      # ==========================================================================
+
+      # Template cache statistics
+      class CacheStats < Dry::Struct
+        attribute :total_entries, Types::Strict::Integer
+        attribute :hits, Types::Strict::Integer
+        attribute :misses, Types::Strict::Integer
+        attribute :evictions, Types::Strict::Integer
+        attribute :last_maintenance, Types::Strict::String.optional
+      end
+
+      # Cache operation result
+      class CacheOperationResult < Dry::Struct
+        attribute :success, Types::Strict::Bool
+        attribute :message, Types::Strict::String
+        attribute :timestamp, Types::Strict::String
+      end
+
+      # Template validation result
+      class TemplateValidation < Dry::Struct
+        attribute :valid, Types::Strict::Bool
+        attribute :namespace, Types::Strict::String
+        attribute :name, Types::Strict::String
+        attribute :version, Types::Strict::String
+        attribute :handler_count, Types::Strict::Integer
+        attribute :issues, Types::Strict::Array.of(Types::Strict::String)
+        attribute :handler_metadata, Types::Strict::Hash.optional
+      end
+
+      # ==========================================================================
+      # Config Types (TAS-150: whitelist-only safe config exposure)
+      # ==========================================================================
+
+      # Configuration metadata (non-sensitive system info)
+      class ConfigMetadata < Dry::Struct
+        attribute :timestamp, Types::Strict::String
+        attribute :environment, Types::Strict::String
+        attribute :version, Types::Strict::String
+      end
+
+      # Non-sensitive auth configuration summary
+      class SafeAuthConfig < Dry::Struct
+        attribute :enabled, Types::Strict::Bool
+        attribute :verification_method, Types::Strict::String
+        attribute :jwt_issuer, Types::Strict::String
+        attribute :jwt_audience, Types::Strict::String
+        attribute :api_key_header, Types::Strict::String
+        attribute :api_key_count, Types::Strict::Integer
+        attribute :strict_validation, Types::Strict::Bool
+        attribute :allowed_algorithms, Types::Strict::Array.of(Types::Strict::String)
+      end
+
+      # Non-sensitive messaging configuration
+      class SafeMessagingConfig < Dry::Struct
+        attribute :backend, Types::Strict::String
+        attribute :queues, Types::Strict::Array.of(Types::Strict::String)
+      end
+
+      # Worker configuration response (safe fields only)
+      class RuntimeConfig < Dry::Struct
+        attribute :metadata, ConfigMetadata
+        attribute :worker_id, Types::Strict::String
+        attribute :worker_type, Types::Strict::String
+        attribute :auth, SafeAuthConfig
+        attribute :messaging, SafeMessagingConfig
+      end
+    end
+  end
+end

data/lib/tasker_core/observability.rb

@@ -0,0 +1,292 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'observability/types'
+
+module TaskerCore
+  # Observability - Access worker health, metrics, and configuration via FFI
+  #
+  # TAS-77: This module provides Ruby-friendly access to worker observability data
+  # without requiring the HTTP web API. Data is fetched directly from Rust via FFI.
+  #
+  # @example Check worker health
+  #   health = TaskerCore::Observability.health_basic
+  #   puts health.status  # => "healthy"
+  #   puts health.worker_id
+  #
+  # @example Get detailed health for K8s probes
+  #   if TaskerCore::Observability.ready?
+  #     puts "Worker ready to receive requests"
+  #   end
+  #
+  # @example Get metrics
+  #   events = TaskerCore::Observability.event_stats
+  #   puts "Events routed: #{events.router.total_routed}"
+  #
+  # @example Query configuration
+  #   config = TaskerCore::Observability.config
+  #   puts "Environment: #{config.metadata.environment}"
+  #
+  # @example List templates
+  #   templates_json = TaskerCore::Observability.templates_list
+  #   templates = JSON.parse(templates_json)
+  #
+  module Observability
+    class << self
+      # ========================================================================
+      # Health Methods
+      # ========================================================================
+
+      # Get basic health status
+      #
+      # @return [Types::BasicHealth] Basic health response
+      def health_basic
+        json = TaskerCore::FFI.health_basic
+        data = JSON.parse(json)
+        Types::BasicHealth.new(
+          status: data['status'],
+          worker_id: data['worker_id'],
+          timestamp: data['timestamp']
+        )
+      end
+
+      # Get liveness status (Kubernetes liveness probe)
+      #
+      # @return [Types::BasicHealth] Liveness response
+      def health_live
+        json = TaskerCore::FFI.health_live
+        data = JSON.parse(json)
+        Types::BasicHealth.new(
+          status: data['status'],
+          worker_id: data['worker_id'],
+          timestamp: data['timestamp']
+        )
+      end
+
+      # Get readiness status (Kubernetes readiness probe)
+      #
+      # @return [Types::DetailedHealth] Detailed health with checks
+      def health_ready
+        json = TaskerCore::FFI.health_ready
+        parse_detailed_health(json)
+      end
+
+      # Get detailed health information
+      #
+      # @return [Types::DetailedHealth] Comprehensive health data
+      def health_detailed
+        json = TaskerCore::FFI.health_detailed
+        parse_detailed_health(json)
+      end
+
+      # Check if worker is ready to receive requests
+      #
+      # @return [Boolean] true if worker is ready
+      def ready?
+        health_ready.status == 'healthy'
+      rescue StandardError
+        false
+      end
+
+      # Check if worker is alive
+      #
+      # @return [Boolean] true if worker is alive
+      def alive?
+        # Liveness probe returns 'alive' status, not 'healthy'
+        health_live.status == 'alive'
+      rescue StandardError
+        false
+      end
+
+      # ========================================================================
+      # Metrics Methods
+      # ========================================================================
+
+      # Get worker metrics as JSON string
+      #
+      # @return [String] JSON-formatted metrics
+      def metrics_worker
+        TaskerCore::FFI.metrics_worker
+      end
+
+      # Get domain event statistics
+      #
+      # @return [Types::DomainEventStats] Event routing statistics
+      def event_stats
+        json = TaskerCore::FFI.metrics_events
+        data = JSON.parse(json)
+
+        Types::DomainEventStats.new(
+          router: Types::EventRouterStats.new(
+            total_routed: data['router']['total_routed'],
+            durable_routed: data['router']['durable_routed'],
+            fast_routed: data['router']['fast_routed'],
+            broadcast_routed: data['router']['broadcast_routed'],
+            fast_delivery_errors: data['router']['fast_delivery_errors'],
+            routing_errors: data['router']['routing_errors']
+          ),
+          in_process_bus: Types::InProcessEventBusStats.new(
+            total_events_dispatched: data['in_process_bus']['total_events_dispatched'],
+            rust_handler_dispatches: data['in_process_bus']['rust_handler_dispatches'],
+            ffi_channel_dispatches: data['in_process_bus']['ffi_channel_dispatches'],
+            rust_handler_errors: data['in_process_bus']['rust_handler_errors'],
+            ffi_channel_drops: data['in_process_bus']['ffi_channel_drops'],
+            rust_subscriber_patterns: data['in_process_bus']['rust_subscriber_patterns'],
+            rust_handler_count: data['in_process_bus']['rust_handler_count'],
+            ffi_subscriber_count: data['in_process_bus']['ffi_subscriber_count']
+          ),
+          captured_at: data['captured_at'],
+          worker_id: data['worker_id']
+        )
+      end
+
+      # Get Prometheus-formatted metrics
+      #
+      # @return [String] Prometheus text format metrics
+      def prometheus_metrics
+        TaskerCore::FFI.metrics_prometheus
+      end
+
+      # ========================================================================
+      # Template Methods
+      # ========================================================================
+
+      # List all templates as JSON
+      #
+      # @param include_cache_stats [Boolean] Include cache statistics
+      # @return [String] JSON-formatted template list
+      def templates_list(include_cache_stats: false)
+        TaskerCore::FFI.templates_list(include_cache_stats)
+      end
+
+      # Get a specific template as JSON
+      #
+      # @param namespace [String] Template namespace
+      # @param name [String] Template name
+      # @param version [String] Template version
+      # @return [String] JSON-formatted template
+      def template_get(namespace:, name:, version:)
+        TaskerCore::FFI.template_get(namespace, name, version)
+      end
+
+      # Validate a template for worker execution
+      #
+      # @param namespace [String] Template namespace
+      # @param name [String] Template name
+      # @param version [String] Template version
+      # @return [Types::TemplateValidation] Validation result
+      def template_validate(namespace:, name:, version:)
+        json = TaskerCore::FFI.template_validate(namespace, name, version)
+        data = JSON.parse(json)
+
+        Types::TemplateValidation.new(
+          valid: data['valid'],
+          namespace: data['namespace'],
+          name: data['name'],
+          version: data['version'],
+          handler_count: data['handler_count'],
+          issues: data['issues'] || [],
+          handler_metadata: data['handler_metadata']
+        )
+      end
+
+      # Get template cache statistics
+      #
+      # @return [Types::CacheStats] Cache statistics
+      def cache_stats
+        json = TaskerCore::FFI.templates_cache_stats
+        data = JSON.parse(json)
+
+        # Map Rust field names to Ruby struct names
+        Types::CacheStats.new(
+          total_entries: data['total_cached'] || 0,
+          hits: data['cache_hits'] || 0,
+          misses: data['cache_misses'] || 0,
+          evictions: data['cache_evictions'] || 0,
+          last_maintenance: nil # Not provided by Rust API
+        )
+      end
+
+      # TAS-169: Removed cache_clear and template_refresh methods.
+      # Cache operations are now internal-only. Restart worker to refresh templates.
+      # Distributed cache status is available via health_detailed.
+
+      # ========================================================================
+      # Config Methods
+      # ========================================================================
+
+      # Get runtime configuration (safe fields only, no secrets)
+      #
+      # @return [Types::RuntimeConfig] Configuration data
+      def config
+        json = TaskerCore::FFI.config_runtime
+        data = JSON.parse(json)
+
+        Types::RuntimeConfig.new(
+          metadata: Types::ConfigMetadata.new(
+            timestamp: data['metadata']['timestamp'],
+            environment: data['metadata']['environment'],
+            version: data['metadata']['version']
+          ),
+          worker_id: data['worker_id'],
+          worker_type: data['worker_type'],
+          auth: Types::SafeAuthConfig.new(
+            enabled: data['auth']['enabled'],
+            verification_method: data['auth']['verification_method'],
+            jwt_issuer: data['auth']['jwt_issuer'],
+            jwt_audience: data['auth']['jwt_audience'],
+            api_key_header: data['auth']['api_key_header'],
+            api_key_count: data['auth']['api_key_count'],
+            strict_validation: data['auth']['strict_validation'],
+            allowed_algorithms: data['auth']['allowed_algorithms']
+          ),
+          messaging: Types::SafeMessagingConfig.new(
+            backend: data['messaging']['backend'],
+            queues: data['messaging']['queues']
+          )
+        )
+      end
+
+      # Get the current environment name
+      #
+      # @return [String] Environment name
+      def environment
+        TaskerCore::FFI.config_environment
+      end
+
+      private
+
+      # Parse detailed health JSON into typed struct
+      def parse_detailed_health(json)
+        data = JSON.parse(json)
+
+        checks = data['checks'].transform_values do |check|
+          Types::HealthCheck.new(
+            status: check['status'],
+            message: check['message'],
+            duration_ms: check['duration_ms'],
+            last_checked: check['last_checked']
+          )
+        end
+
+        system_info = Types::WorkerSystemInfo.new(
+          version: data['system_info']['version'],
+          environment: data['system_info']['environment'],
+          uptime_seconds: data['system_info']['uptime_seconds'],
+          worker_type: data['system_info']['worker_type'],
+          database_pool_size: data['system_info']['database_pool_size'],
+          command_processor_active: data['system_info']['command_processor_active'],
+          supported_namespaces: data['system_info']['supported_namespaces']
+        )
+
+        Types::DetailedHealth.new(
+          status: data['status'],
+          timestamp: data['timestamp'],
+          worker_id: data['worker_id'],
+          checks: checks,
+          system_info: system_info
+        )
+      end
+    end
+  end
+end