kaal 0.4.0 → 0.6.0

data/sig/kaal/backend/dispatch_logging.rbs

@@ -0,0 +1,23 @@
+module Kaal
+  module Backend
+    module DispatchLogging
+      @dispatch_attempt_logger: Kaal::rbs_any
+
+      def dispatch_registry: () -> nil
+
+      def log_dispatch_attempt: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def parse_lock_key: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def self.parse_lock_key: (Kaal::rbs_any key) -> ::Array[Kaal::rbs_any]
+
+      def self.validate_lock_key!: (Kaal::rbs_any valid, Kaal::rbs_any message) -> (Kaal::rbs_any | nil)
+
+      def self.invalid_dispatch_lock_key!: (Kaal::rbs_any message) -> Kaal::rbs_any
+
+      private
+
+      def dispatch_attempt_logger: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/backend/dispatch_registry_accessor.rbs

@@ -0,0 +1,17 @@
+module Kaal
+  module Backend
+    class DispatchRegistryAccessor
+      @configuration: Kaal::rbs_any
+
+      def initialize: (configuration: Kaal::rbs_any) -> void
+
+      def dispatched?: (Kaal::rbs_any key, Kaal::rbs_any fire_time) -> Kaal::rbs_any
+
+      def registry: () -> Kaal::rbs_any
+
+      private
+
+      def fetch_registry: () -> (nil | Kaal::rbs_any)
+    end
+  end
+end

data/sig/kaal/backend/memory_adapter.rbs

@@ -0,0 +1,33 @@
+module Kaal
+  module Backend
+    class MemoryAdapter < Adapter
+      @locks: Kaal::rbs_any
+
+      @mutex: Kaal::rbs_any
+
+      @dispatch_registry: Kaal::rbs_any
+
+      @definition_registry: Kaal::rbs_any
+
+      @delayed_store: Kaal::rbs_any
+
+      include DispatchLogging
+
+      def initialize: () -> void
+
+      def dispatch_registry: () -> Kaal::rbs_any
+
+      def definition_registry: () -> Kaal::rbs_any
+
+      def delayed_store: () -> Kaal::rbs_any
+
+      def acquire: (Kaal::rbs_any key, Kaal::rbs_any ttl) -> Kaal::rbs_any
+
+      def release: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      private
+
+      def prune_expired_locks: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/backend/mysql.rbs

@@ -0,0 +1,25 @@
+module Kaal
+  module Backend
+    class MySQL < Adapter
+      @engine: Kaal::rbs_any
+
+      UNSET_SKIP_LOCKED_SUPPORT: Kaal::rbs_any
+
+      def initialize: (?database: Kaal::rbs_any?, ?connection: Kaal::rbs_any?, ?namespace: Kaal::rbs_any?, ?use_skip_locked: Kaal::rbs_any) -> void
+
+      def dispatch_registry: () -> Kaal::rbs_any
+
+      def definition_registry: () -> Kaal::rbs_any
+
+      def delayed_store: () -> Kaal::rbs_any
+
+      def acquire: (Kaal::rbs_any key, Kaal::rbs_any ttl) -> Kaal::rbs_any
+
+      def release: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def self.build_sequel_backend: (Kaal::rbs_any database, Kaal::rbs_any namespace, Kaal::rbs_any use_skip_locked) -> Kaal::rbs_any
+
+      def self.build_active_record_backend: (Kaal::rbs_any connection, Kaal::rbs_any namespace, Kaal::rbs_any use_skip_locked) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/backend/postgres.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  module Backend
+    class Postgres < Adapter
+      @engine: Kaal::rbs_any
+
+      def initialize: (?database: Kaal::rbs_any?, ?connection: Kaal::rbs_any?, ?namespace: Kaal::rbs_any?) -> void
+
+      def dispatch_registry: () -> Kaal::rbs_any
+
+      def definition_registry: () -> Kaal::rbs_any
+
+      def delayed_store: () -> Kaal::rbs_any
+
+      def acquire: (Kaal::rbs_any key, Kaal::rbs_any ttl) -> Kaal::rbs_any
+
+      def release: (Kaal::rbs_any key) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/backend/redis_adapter.rbs

@@ -0,0 +1,41 @@
+module Kaal
+  module Backend
+    class RedisAdapter < Adapter
+      @redis: Kaal::rbs_any
+
+      @namespace: Kaal::rbs_any
+
+      @lock_value_generator: Kaal::rbs_any
+
+      @lock_values: Kaal::rbs_any
+
+      @mutex: Kaal::rbs_any
+
+      @dispatch_registry: Kaal::rbs_any
+
+      @definition_registry: Kaal::rbs_any
+
+      @delayed_store: Kaal::rbs_any
+
+      include DispatchLogging
+
+      def initialize: (Kaal::rbs_any redis, ?namespace: ::String) -> void
+
+      def dispatch_registry: () -> Kaal::rbs_any
+
+      def definition_registry: () -> Kaal::rbs_any
+
+      def delayed_store: () -> Kaal::rbs_any
+
+      def acquire: (Kaal::rbs_any key, Kaal::rbs_any ttl) -> Kaal::rbs_any
+
+      def release: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      private
+
+      def generate_lock_value: () -> Kaal::rbs_any
+
+      def prune_expired_lock_values: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/backend/sqlite.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  module Backend
+    class SQLite < Adapter
+      @engine: Kaal::rbs_any
+
+      def initialize: (?database: Kaal::rbs_any?, ?connection: Kaal::rbs_any?, ?namespace: Kaal::rbs_any?, **Kaal::rbs_any) -> void
+
+      def dispatch_registry: () -> Kaal::rbs_any
+
+      def definition_registry: () -> Kaal::rbs_any
+
+      def delayed_store: () -> Kaal::rbs_any
+
+      def acquire: (Kaal::rbs_any key, Kaal::rbs_any ttl) -> Kaal::rbs_any
+
+      def release: (Kaal::rbs_any key) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/cli.rbs

@@ -0,0 +1,41 @@
+module Kaal
+  class CLI < Thor
+    module Helpers
+      private
+
+      def load_project!: () -> Kaal::rbs_any
+
+      def root_path: () -> Kaal::rbs_any
+
+      def config_path: () -> Kaal::rbs_any
+
+      def scheduler_path: () -> Kaal::rbs_any
+
+      def render_config_template: (Kaal::rbs_any backend) -> Kaal::rbs_any
+
+      def scheduler_template: () -> "defaults:\n  jobs:\n    - key: \"example:heartbeat\"\n      cron: \"*/5 * * * *\"\n      job_class: \"ExampleHeartbeatJob\"\n      enabled: true\n      args:\n        - \"{{fire_time.iso8601}}\"\n      kwargs:\n        idempotency_key: \"{{idempotency_key}}\"\n      metadata:\n        owner: \"ops\"\n"
+    end
+
+    def init: () -> Kaal::rbs_any
+
+    def start: () -> Kaal::rbs_any
+
+    def status: () -> Kaal::rbs_any
+
+    def tick: () -> Kaal::rbs_any
+
+    def explain: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def next: (Kaal::rbs_any expression) -> Kaal::rbs_any
+
+    def self.exit_on_failure?: () -> true
+
+    def self.write_file: (Kaal::rbs_any path, Kaal::rbs_any contents) -> (nil | Kaal::rbs_any)
+
+    def self.install_foreground_signal_handlers: (Kaal::rbs_any signal_state) -> Kaal::rbs_any
+
+    def self.restore_signal_handlers: (Kaal::rbs_any previous_handlers) -> Kaal::rbs_any
+
+    def self.shutdown_scheduler: (signal: Kaal::rbs_any, signal_state: Kaal::rbs_any, ?previous_handler: Kaal::rbs_any?, ?shell: Kaal::rbs_any?) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/config/backend_factory.rbs

@@ -0,0 +1,41 @@
+module Kaal
+  module Config
+    module BackendFactory
+      SUPPORTED_BACKENDS: ::Array["memory" | "redis" | "sqlite" | "postgres" | "mysql"]
+
+      def self.normalize_name: (Kaal::rbs_any name) -> (nil | Kaal::rbs_any)
+
+      def self.build: (Kaal::rbs_any name, backend_config: Kaal::rbs_any, namespace: Kaal::rbs_any, ?runtime_context: Kaal::rbs_any?) -> Kaal::rbs_any
+
+      def self.normalize_backend_config: (Kaal::rbs_any backend_config) -> Kaal::rbs_any
+
+      def self.build_redis_backend: (Kaal::rbs_any config, Kaal::rbs_any namespace) -> Kaal::rbs_any
+
+      def self.build_sqlite_backend: (Kaal::rbs_any config, Kaal::rbs_any namespace, Kaal::rbs_any runtime_context) -> Kaal::rbs_any
+
+      def self.build_postgres_backend: (Kaal::rbs_any config, Kaal::rbs_any namespace) -> Kaal::rbs_any
+
+      def self.build_mysql_backend: (Kaal::rbs_any config, Kaal::rbs_any namespace) -> Kaal::rbs_any
+
+      def self.build_sqlite_connection: (Kaal::rbs_any connection, Kaal::rbs_any runtime_context) -> Kaal::rbs_any
+
+      def self.normalize_connection_hash: (Kaal::rbs_any connection, Kaal::rbs_any default_adapter, Kaal::rbs_any runtime_context) -> Kaal::rbs_any
+
+      def self.resolve_sqlite_database_path: (Kaal::rbs_any database, Kaal::rbs_any runtime_context) -> Kaal::rbs_any
+
+      def self.sqlite_uri?: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.sequel_sqlite_database: (Kaal::rbs_any target, Kaal::rbs_any runtime_context) -> Kaal::rbs_any
+
+      def self.ensure_sqlite_directory!: (Kaal::rbs_any database_path) -> Kaal::rbs_any
+
+      def self.adapter_name_for_error: (Kaal::rbs_any adapter) -> ("postgres" | "mysql")
+
+      def self.string_value: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def self.require_redis!: () -> Kaal::rbs_any
+
+      def self.require_sequel!: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/config/configuration.rbs

@@ -0,0 +1,70 @@
+module Kaal
+  class Configuration
+    @values: Kaal::rbs_any
+
+    @backend_name: Kaal::rbs_any
+
+    @backend_runtime_context: Kaal::rbs_any
+
+    DEFAULTS: { tick_interval: 5, window_lookback: 120, window_lookahead: 0, lease_ttl: 125, namespace: "kaal", backend: nil, backend_config: ::Hash[Kaal::rbs_any, Kaal::rbs_any], logger: nil, time_zone: nil, enable_log_dispatch_registry: false, enable_dispatch_recovery: true, recovery_window: 86400, recovery_startup_jitter: 5, scheduler_config_path: "config/kaal-scheduler.yml", scheduler_conflict_policy: :error, scheduler_missing_file_policy: :warn, delayed_job_allowed_class_prefixes: ::Array[Kaal::rbs_any] }
+
+    def initialize: () -> void
+
+    def method_missing: (Kaal::rbs_any method_name, *Kaal::rbs_any args) -> Kaal::rbs_any
+
+    def respond_to_missing?: (Kaal::rbs_any method_name, ?bool include_private) -> Kaal::rbs_any
+
+    def validate: () -> Kaal::rbs_any
+
+    attr_accessor backend_runtime_context: Kaal::rbs_any
+
+    def validation_warnings: () -> Kaal::rbs_any
+
+    def validate!: () -> self
+
+    def to_h: () -> { tick_interval: Kaal::rbs_any, window_lookback: Kaal::rbs_any, window_lookahead: Kaal::rbs_any, lease_ttl: Kaal::rbs_any, namespace: Kaal::rbs_any, backend: Kaal::rbs_any, backend_config: Kaal::rbs_any, logger: Kaal::rbs_any, time_zone: Kaal::rbs_any, enable_log_dispatch_registry: Kaal::rbs_any, enable_dispatch_recovery: Kaal::rbs_any, recovery_window: Kaal::rbs_any, recovery_startup_jitter: Kaal::rbs_any, scheduler_config_path: Kaal::rbs_any, scheduler_conflict_policy: Kaal::rbs_any, scheduler_missing_file_policy: Kaal::rbs_any, delayed_job_allowed_class_prefixes: Kaal::rbs_any }
+
+    private
+
+    def validation_errors: () -> Kaal::rbs_any
+
+    def add_tick_interval_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_window_lookback_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_window_lookahead_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_lease_ttl_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_namespace_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_backend_config_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_lease_ttl_window_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_scheduler_config_path_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_scheduler_conflict_policy_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_scheduler_missing_file_policy_error: (Kaal::rbs_any errors) -> (nil | Kaal::rbs_any)
+
+    def add_delayed_job_security_warning: (Kaal::rbs_any warnings) -> (nil | Kaal::rbs_any)
+
+    def handle_known_key: (Kaal::rbs_any method_name) { (Kaal::rbs_any, Kaal::rbs_any) -> Kaal::rbs_any } -> (::Array[false | nil] | ::Array[true | Kaal::rbs_any])
+
+    def set_value: (Kaal::rbs_any key, Kaal::rbs_any value) -> Kaal::rbs_any
+
+    def normalize_value: (Kaal::rbs_any key, Kaal::rbs_any value) -> Kaal::rbs_any
+
+    def normalize_backend: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+    def normalize_backend_config: (Kaal::rbs_any value) -> Kaal::rbs_any
+
+    def rebuild_symbolic_backend_if_needed: (Kaal::rbs_any key) -> (nil | Kaal::rbs_any)
+
+    def normalize_delayed_job_allowed_class_prefixes: (Kaal::rbs_any value) -> Kaal::rbs_any
+  end
+
+  class ConfigurationError < StandardError
+  end
+end

data/sig/kaal/config/delayed_job_security_policy.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  module Config
+    module DelayedJobSecurityPolicy
+      NON_SHARED_BACKEND_CLASS_NAMES: ::Array["NilClass" | "Kaal::Backend::MemoryAdapter" | "Kaal::Backend::NullAdapter"]
+
+      WARNING_MESSAGE: "Delayed jobs resolve stored job_class values at dispatch time. delayed_job_allowed_class_prefixes is empty, so class resolution is unrestricted on this shared backend. Configure a restrictive delayed_job_allowed_class_prefixes list for production deployments."
+
+      def self.warning_for: (Kaal::rbs_any configuration) -> (nil | Kaal::rbs_any)
+
+      def self.production_like_environment?: (?env: Kaal::rbs_any, ?rails: Kaal::rbs_any) -> Kaal::rbs_any
+
+      def self.shared_delayed_job_backend?: (Kaal::rbs_any backend) -> Kaal::rbs_any
+
+      def self.current_rails: () -> (nil | Kaal::rbs_any)
+
+      def self.rails_environment: (Kaal::rbs_any rails) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/config/file_loader.rbs

@@ -0,0 +1,35 @@
+module Kaal
+  module Config
+    class FileLoader
+      @configuration: Kaal::rbs_any
+
+      @runtime_context: Kaal::rbs_any
+
+      @env: Kaal::rbs_any
+
+      ENV_KEY_MAP: ::Hash[::String, ::Symbol]
+
+      def initialize: (configuration: Kaal::rbs_any, runtime_context: Kaal::rbs_any, ?env: Kaal::rbs_any) -> void
+
+      def load: (?path: ::String) -> Kaal::rbs_any
+
+      private
+
+      def parse_yaml: (Kaal::rbs_any path) -> Kaal::rbs_any
+
+      def merge_environment_config: (Kaal::rbs_any payload) -> Kaal::rbs_any
+
+      def hash_section: (Kaal::rbs_any value) -> (::Hash[Kaal::rbs_any, Kaal::rbs_any] | Kaal::rbs_any)
+
+      def apply_env_overrides: (Kaal::rbs_any config) -> Kaal::rbs_any
+
+      def coerce_env_value: (Kaal::rbs_any key, Kaal::rbs_any value) -> Kaal::rbs_any
+
+      def coerce_boolean_env: (Kaal::rbs_any key, Kaal::rbs_any value) -> (true | false | Kaal::rbs_any)
+
+      def env_name_for: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def apply_configuration: (Kaal::rbs_any config) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/config/scheduler_config_error.rbs

@@ -0,0 +1,4 @@
+module Kaal
+  class SchedulerConfigError < StandardError
+  end
+end

data/sig/kaal/config/scheduler_time_zone_resolver.rbs

@@ -0,0 +1,19 @@
+module Kaal
+  class SchedulerTimeZoneResolver
+    @configuration: Kaal::rbs_any
+
+    DEFAULT_TIME_ZONE: "UTC"
+
+    def initialize: (configuration: Kaal::rbs_any) -> void
+
+    def time_zone_identifier: () -> Kaal::rbs_any
+
+    private
+
+    def configured_time_zone: () -> Kaal::rbs_any
+
+    def normalized_time_zone_value: () -> Kaal::rbs_any
+
+    def raw_time_zone_value: () -> Kaal::rbs_any
+  end
+end

data/sig/kaal/config.rbs

@@ -0,0 +1,11 @@
+module Kaal
+  module Config
+    Configuration: Kaal::rbs_any
+
+    ConfigurationError: Kaal::rbs_any
+
+    SchedulerConfigError: Kaal::rbs_any
+
+    SchedulerTimeZoneResolver: Kaal::rbs_any
+  end
+end

data/sig/kaal/core/coordinator.rbs

@@ -0,0 +1,103 @@
+module Kaal
+  class Coordinator
+    @configuration: Kaal::rbs_any
+
+    @registry: Kaal::rbs_any
+
+    @thread: Kaal::rbs_any
+
+    @running: Kaal::rbs_any
+
+    @stop_requested: Kaal::rbs_any
+
+    @mutex: Kaal::rbs_any
+
+    @tick_cv: Kaal::rbs_any
+
+    @scheduler_time_zone_resolver: Kaal::rbs_any
+
+    @occurrence_finder: Kaal::rbs_any
+
+    @enabled_entry_enumerator: Kaal::rbs_any
+
+    DELAYED_JOB_BATCH_SIZE: 100
+
+    DELAYED_JOB_MAX_BATCHES_PER_TICK: 10
+
+    DELAYED_JOB_DELETE_CONFIRMATION_JITTER_MAX: ::Float
+
+    def initialize: (configuration: Kaal::rbs_any, registry: Kaal::rbs_any) -> void
+
+    def start!: () -> Kaal::rbs_any
+
+    def stop!: (?timeout: ::Integer) -> (false | true)
+
+    def running?: () -> Kaal::rbs_any
+
+    def restart!: () -> Kaal::rbs_any
+
+    def tick!: () -> Kaal::rbs_any
+
+    def reset!: () -> Kaal::rbs_any
+
+    private
+
+    def request_stop: () -> Kaal::rbs_any
+
+    def run_loop: () -> Kaal::rbs_any
+
+    def stop_requested?: () -> Kaal::rbs_any
+
+    def execute_tick: () -> Kaal::rbs_any
+
+    def calculate_and_dispatch_due_times: (Kaal::rbs_any entry) -> (nil | Kaal::rbs_any)
+
+    def parse_cron: (Kaal::rbs_any cron_expression) -> Kaal::rbs_any
+
+    def find_occurrences: (Kaal::rbs_any cron, Kaal::rbs_any start_time, Kaal::rbs_any end_time) -> Kaal::rbs_any
+
+    def dispatch_if_due: (Kaal::rbs_any entry, Kaal::rbs_any fire_time, Kaal::rbs_any now) -> Kaal::rbs_any
+
+    def recover_missed_runs: () -> Kaal::rbs_any
+
+    def recover_entry: (Kaal::rbs_any entry, Kaal::rbs_any start_time, Kaal::rbs_any end_time) -> Kaal::rbs_any
+
+    def cleanup_old_dispatch_records: (Kaal::rbs_any recovery_window) -> Kaal::rbs_any
+
+    def already_dispatched?: (Kaal::rbs_any key, Kaal::rbs_any fire_time) -> Kaal::rbs_any
+
+    def acquire_lock: (Kaal::rbs_any lock_key) -> Kaal::rbs_any
+
+    def each_enabled_entry: () { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+    def dispatch_work: (Kaal::rbs_any entry, Kaal::rbs_any fire_time) -> Kaal::rbs_any
+
+    def dispatch_due_delayed_jobs: () -> Kaal::rbs_any
+
+    def dispatch_delayed_job: (Kaal::rbs_any job, Kaal::rbs_any delayed_store) -> Kaal::rbs_any
+
+    def delayed_store_for_tick: () -> Kaal::rbs_any
+
+    def stop_delayed_dispatch?: () -> Kaal::rbs_any
+
+    def apply_delayed_job_claim_jitter_if_needed: (Kaal::rbs_any delayed_store) -> (nil | Kaal::rbs_any)
+
+    def generate_idempotency_key: (Kaal::rbs_any cron_key, Kaal::rbs_any fire_time) -> Kaal::rbs_any
+
+    def generate_lock_key: (Kaal::rbs_any cron_key, Kaal::rbs_any fire_time) -> ::String
+
+    def generate_delayed_lock_key: (Kaal::rbs_any job_id) -> ::String
+
+    def sleep_until_next_tick: () -> Kaal::rbs_any
+
+    def scheduler_time_zone_resolver: () -> Kaal::rbs_any
+
+    def occurrence_finder: () -> Kaal::rbs_any
+
+    def enabled_entry_enumerator: () -> Kaal::rbs_any
+
+    def log_configuration_error: (Kaal::rbs_any prefix, Kaal::rbs_any error, ?logger: Kaal::rbs_any) -> Kaal::rbs_any
+
+    def log_runtime_error: (Kaal::rbs_any prefix, Kaal::rbs_any error, ?logger: Kaal::rbs_any) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/core/enabled_entry_enumerator.rbs

@@ -0,0 +1,21 @@
+module Kaal
+  class EnabledEntryEnumerator
+    @configuration: Kaal::rbs_any
+
+    @registry: Kaal::rbs_any
+
+    @definition_registry_provider: Kaal::rbs_any
+
+    def initialize: (configuration: Kaal::rbs_any, registry: Kaal::rbs_any, ?definition_registry_provider: Kaal::rbs_any) -> void
+
+    def each: () { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+    private
+
+    def yield_registry_entries: () { (Kaal::rbs_any) -> Kaal::rbs_any } -> Kaal::rbs_any
+
+    def resolve_entries: () -> Kaal::rbs_any
+
+    def build_entry: (Kaal::rbs_any definition) -> (nil | Kaal::rbs_any)
+  end
+end

data/sig/kaal/core/occurrence_finder.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  class OccurrenceFinder
+    @configuration: Kaal::rbs_any
+
+    def initialize: (configuration: Kaal::rbs_any) -> void
+
+    def call: (cron: Kaal::rbs_any, start_time: Kaal::rbs_any, end_time: Kaal::rbs_any) -> Kaal::rbs_any
+  end
+end

data/sig/kaal/core.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  module Core
+    Coordinator: Kaal::rbs_any
+
+    OccurrenceFinder: Kaal::rbs_any
+
+    EnabledEntryEnumerator: Kaal::rbs_any
+  end
+end

data/sig/kaal/definition/database_engine.rbs

@@ -0,0 +1,25 @@
+module Kaal
+  module Definition
+    class DatabaseEngine < Registry
+      @database: Kaal::rbs_any
+
+      def initialize: (database: Kaal::rbs_any) -> void
+
+      def upsert_definition: (key: Kaal::rbs_any, cron: Kaal::rbs_any, ?enabled: bool, ?source: ::String, ?metadata: ::Hash[Kaal::rbs_any, Kaal::rbs_any]) -> Kaal::rbs_any
+
+      def remove_definition: (Kaal::rbs_any key) -> (nil | Kaal::rbs_any)
+
+      def find_definition: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def all_definitions: () -> Kaal::rbs_any
+
+      def enabled_definitions: () -> Kaal::rbs_any
+
+      def self.normalize_row: (Kaal::rbs_any row) -> (nil | { key: Kaal::rbs_any, cron: Kaal::rbs_any, enabled: Kaal::rbs_any, source: Kaal::rbs_any, metadata: Kaal::rbs_any, created_at: Kaal::rbs_any, updated_at: Kaal::rbs_any, disabled_at: Kaal::rbs_any })
+
+      private
+
+      def dataset: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/definition/memory_engine.rbs

@@ -0,0 +1,23 @@
+module Kaal
+  module Definition
+    class MemoryEngine < Registry
+      @definitions: Kaal::rbs_any
+
+      @mutex: Kaal::rbs_any
+
+      include Kaal::Support::HashTools
+
+      def initialize: () -> void
+
+      def upsert_definition: (key: Kaal::rbs_any, cron: Kaal::rbs_any, ?enabled: bool, ?source: ::String, ?metadata: ::Hash[Kaal::rbs_any, Kaal::rbs_any]) -> Kaal::rbs_any
+
+      def remove_definition: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def find_definition: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def all_definitions: () -> Kaal::rbs_any
+
+      def clear: () -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/definition/persistence_helpers.rbs

@@ -0,0 +1,9 @@
+module Kaal
+  module Definition
+    module PersistenceHelpers
+      def self.disabled_at_for: (Kaal::rbs_any existing, Kaal::rbs_any enabled, Kaal::rbs_any now) -> (nil | Kaal::rbs_any)
+
+      def self.parse_metadata: (Kaal::rbs_any value) -> Kaal::rbs_any
+    end
+  end
+end

data/sig/kaal/definition/redis_engine.rbs

@@ -0,0 +1,33 @@
+module Kaal
+  module Definition
+    class RedisEngine < Registry
+      @redis: Kaal::rbs_any
+
+      @namespace: Kaal::rbs_any
+
+      include Kaal::Support::HashTools
+
+      def initialize: (Kaal::rbs_any redis, ?namespace: ::String) -> void
+
+      def upsert_definition: (key: Kaal::rbs_any, cron: Kaal::rbs_any, ?enabled: bool, ?source: ::String, ?metadata: ::Hash[Kaal::rbs_any, Kaal::rbs_any]) -> Kaal::rbs_any
+
+      def remove_definition: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def find_definition: (Kaal::rbs_any key) -> Kaal::rbs_any
+
+      def all_definitions: () -> Kaal::rbs_any
+
+      private
+
+      def storage_key: () -> ::String
+
+      def deserialize: (Kaal::rbs_any raw) -> Kaal::rbs_any
+
+      def self.serialize_payload: (Kaal::rbs_any payload) -> Kaal::rbs_any
+
+      def self.deserialize_payload: (Kaal::rbs_any raw) -> Kaal::rbs_any
+
+      def self.parse_time: (Kaal::rbs_any value) -> Kaal::rbs_any
+    end
+  end
+end