henitai 0.1.10 → 0.2.1

data/sig/henitai.rbs

@@ -73,6 +73,71 @@ module Henitai
   module Operators
   end
 
+  module Integration::ChildDebugSupport
+    private
+
+    def debug_child_puts: (String) -> void
+    def debug_child?: () -> bool
+    def debug_child_rspec_trace: (
+      test_files: Array[String],
+      rspec_options: Array[String],
+      rspec_argv: Array[String]
+    ) -> void
+    def debug_child_rspec_exit: (untyped) -> void
+    def debug_child_example_count: (String) -> void
+    def debug_child_activation_start: (String) -> void
+    def debug_child_activation_end: (untyped, test_files: Array[String]) -> void
+    def debug_child_mutant_meta: (Mutant) -> void
+    def debug_child_activation_check: () -> void
+    def loaded_feature_map: (Array[String]) -> Array[[String, bool]]
+    def loaded_feature?: (String) -> bool
+    def rspec_world_example_count: () -> Integer?
+    def pause: (Float) -> void
+  end
+
+  module Integration::ChildRuntimeControl
+    private
+
+    def suppress_simplecov!: () -> void
+    def suppress_coverage!: () -> void
+    def debug_child_timeout_dump: (Integer) -> void
+    def install_debug_timeout_trap: () -> void
+    def debug_child_thread_dump: (String) -> void
+  end
+
+  module Integration::RspecChildRunner
+    private
+
+    def run_rspec_runner: (Array[String]) -> untyped
+    def build_rspec_runner: () -> untyped
+    def configure_rspec_runner: (untyped) -> void
+    def load_rspec_spec_files: (Array[String]) -> void
+    def run_rspec_specs: (untyped) -> untyped
+  end
+
+  module Integration::RspecTestSelection
+    REQUIRE_DIRECTIVE_PATTERN: Regexp
+
+    def select_tests: (Subject) -> Array[String]
+
+    private
+
+    def spec_files: () -> Array[String]
+    def fallback_spec_files: (Subject) -> Array[String]
+    def excluded_spec_files: () -> Array[String]
+    def rspec_exclude_patterns: () -> Array[String]
+    def rspec_config_lines: () -> Array[String]
+    def rspec_config_path: () -> String
+    def selection_patterns: (Subject) -> Array[String]
+    def requires_source_file?: (String, String) -> bool
+    def requires_source_file_transitively?: (String, String, ?Array[String]) -> bool
+    def required_files: (String) -> Array[String]
+    def resolve_required_file: (String, String, String) -> String?
+    def relative_candidates: (String, String) -> Array[String]
+    def require_candidates: (String, String) -> Array[String]
+    def expand_candidates: (String, String) -> Array[String]
+  end
+
   class Configuration
     DEFAULT_TIMEOUT: Float
     DEFAULT_OPERATORS: Symbol
@@ -86,6 +151,7 @@ module Henitai
 
     attr_reader integration: untyped
     attr_reader includes: Array[String]
+    attr_reader excludes: Array[String]
     attr_reader operators: Symbol
     attr_reader timeout: Float
     attr_reader ignore_patterns: Array[untyped]
@@ -106,11 +172,14 @@ module Henitai
     private
 
     def load_raw_configuration: (String) -> Hash[Symbol, untyped]
+    def detect_integration: () -> String
     def apply_defaults: (Hash[Symbol, untyped]) -> void
     def apply_general_defaults: (Hash[Symbol, untyped]) -> void
     def apply_mutation_defaults: (Hash[Symbol, untyped]) -> void
     def apply_analysis_defaults: (Hash[Symbol, untyped]) -> void
     def merge_defaults: (Hash[Symbol, untyped], Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]
+    def resolve_integration_default: (untyped) -> untyped
+    def default_dashboard: (Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]
     def symbolize_keys: (untyped) -> untyped
   end
 
@@ -171,8 +240,11 @@ module Henitai
     attr_accessor duration: Float?
     attr_accessor covered_by: Array[String]?
     attr_accessor tests_completed: Integer?
+    attr_reader precomputed_stable_id: String?
+    attr_reader precomputed_activation_source: String?
 
-    def initialize: (subject: Subject, operator: String, nodes: Hash[Symbol, untyped], description: String, location: Hash[Symbol, untyped]) -> void
+    def initialize: (subject: Subject, operator: String, nodes: Hash[Symbol, untyped], description: String, location: Hash[Symbol, untyped], ?precomputed_stable_id: String?, ?precomputed_activation_source: String?) -> void
+    def stable_id: () -> String
     def killed?: () -> bool
     def survived?: () -> bool
     def pending?: () -> bool
@@ -256,9 +328,13 @@ module Henitai
     def self.for: (String) -> untyped
 
     class Base
+      include ChildDebugSupport
+      include ChildRuntimeControl
+
       def select_tests: (Subject) -> Array[String]
       def test_files: () -> Array[String]
       def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
       def run_suite: (Array[String], ?timeout: Float) -> ScenarioExecutionResult
       def per_test_coverage_supported?: () -> bool
       def wait_with_timeout: (Integer, Float) -> untyped
@@ -268,14 +344,41 @@ module Henitai
       private
 
       def pause: (Float) -> void
+      def wait_nonblocking: (Integer) -> untyped
       def handle_timeout: (Integer) -> Symbol
       def cleanup_child_process: (Integer) -> void
-      def rspec_options: () -> Array[String]
+      def suppress_simplecov!: () -> void
+      def suppress_coverage!: () -> void
+      def debug_child?: () -> bool
+      def debug_child_puts: (String) -> void
+      def debug_child_rspec_trace: (test_files: Array[String], rspec_options: Array[String], rspec_argv: Array[String]) -> void
+      def debug_child_rspec_exit: (untyped status) -> void
+      def debug_child_activation_start: (String mutant_id) -> void
+      def debug_child_activation_end: (untyped activation_result, test_files: Array[String]) -> void
+      def debug_child_mutant_meta: (Mutant) -> void
+      def debug_child_activation_check: () -> void
+      def debug_child_example_count: (String) -> void
+      def loaded_feature_map: (Array[String]) -> Array[[String, bool]]
+      def loaded_feature?: (String) -> bool
+      def rspec_world_example_count: () -> Integer?
+      def with_non_interactive_stdin: () { () -> untyped } -> untyped
       def subprocess_env: () -> Hash[String, String]
       def scenario_log_support: () -> ScenarioLogSupport
       def with_subprocess_env: () { () -> untyped } -> untyped
       def restore_subprocess_env: (Hash[String, String?]) -> void
-      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
+    end
+
+    module MutantRunSupport
+      def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
+      def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def scenario_log_paths: (String) -> Hash[Symbol, String]
+      def build_result: (untyped, Hash[Symbol, String]) -> ScenarioExecutionResult
+      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
+      def mutant_log_name: (Mutant) -> String
+
+      private
+
+      def run_child_activation_and_tests: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
     end
 
     class ScenarioLogSupport
@@ -300,66 +403,81 @@ module Henitai
       def stderr_stream: () -> IO
     end
 
+    module SchedulerDiagnostics
+      def self.enabled?: () -> bool
+      def self.child_started: (Integer?) -> void
+      def self.child_ended: (Integer?) -> void
+      def self.summary: () -> Hash[Symbol, untyped]
+      def self.reset!: () -> void
+    end
+
+    class ChildHandle
+      attr_accessor pid: Integer?
+      attr_accessor log_paths: Hash[Symbol, String]
+
+      def initialize: (pid: Integer?, log_paths: Hash[Symbol, String]) -> void
+    end
+
     class RspecProcessRunner
-      def run_mutant: (Rspec, mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
-      def run_suite: (Rspec, Array[String], timeout: Float) -> ScenarioExecutionResult
+      def run_mutant: (Base, mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def run_suite: (Base, Array[String], timeout: Float) -> ScenarioExecutionResult
+      def spawn_mutant: (Base, mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> ChildHandle
     end
 
     class Rspec < Base
-      REQUIRE_DIRECTIVE_PATTERN: Regexp
+      include MutantRunSupport
+      include RspecChildRunner
+      include RspecTestSelection
+
       DEFAULT_SUITE_TIMEOUT: Float
 
-      def select_tests: (Subject) -> Array[String]
       def test_files: () -> Array[String]
-      def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
       def run_suite: (Array[String], ?timeout: Float) -> ScenarioExecutionResult
       def per_test_coverage_supported?: () -> bool
+      def suite_command: (Array[String]) -> Array[String]
+      def rspec_suite_runner_script: () -> String
+      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
 
       private
 
-      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
-      def suite_command: (Array[String]) -> Array[String]
-      def build_result: (untyped, Hash[Symbol, String]) -> ScenarioExecutionResult
-      def scenario_status: (untyped) -> Symbol
-      def exit_status_for: (untyped) -> Integer?
-      def read_log_file: (String) -> String
-      def write_combined_log: (String, String, String) -> void
-      def combined_log: (String, String) -> String
-      def scenario_log_paths: (String) -> Hash[Symbol, String]
       def run_tests: (Array[String]) -> Integer
-      def with_subprocess_env: () { () -> untyped } -> untyped
-      def spec_files: () -> Array[String]
-      def fallback_spec_files: (Subject) -> Array[String]
-      def excluded_spec_files: () -> Array[String]
-      def rspec_exclude_patterns: () -> Array[String]
-      def rspec_config_lines: () -> Array[String]
-      def rspec_config_path: () -> String
-      def selection_patterns: (Subject) -> Array[String]
-      def requires_source_file?: (String, String) -> bool
-      def requires_source_file_transitively?: (String, String, ?Array[String]) -> bool
-      def required_files: (String) -> Array[String]
-      def resolve_required_file: (String, String, String) -> String?
-      def relative_candidates: (String, String) -> Array[String]
-      def require_candidates: (String, String) -> Array[String]
-      def expand_candidates: (String, String) -> Array[String]
+    end
+
+    module CoverageRuntimeSuppressors
+      def self.suppress_simplecov!: () -> void
+      def self.suppress_coverage!: () -> void
     end
 
     module SimpleCovStartSuppressor
       def start: (*untyped) -> nil
     end
 
-    class Minitest < Rspec
+    module CoverageStartSuppressor
+      def start: (*untyped) -> nil
+    end
+
+    class Minitest < Base
+      include MutantRunSupport
+      include RspecTestSelection
+
+      DEFAULT_SUITE_TIMEOUT: Float
+
+      def test_files: () -> Array[String]
+      def per_test_coverage_supported?: () -> bool
       def run_mutant: (mutant: Mutant, test_files: Array[String], timeout: Float) -> ScenarioExecutionResult
+      def spawn_mutant: (mutant: Mutant, test_files: Array[String]) -> ChildHandle
+      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
       def run_suite: (Array[String], ?timeout: Float) -> ScenarioExecutionResult
 
       private
 
-      def run_in_child: (mutant: Mutant, test_files: Array[String], log_paths: Hash[Symbol, String]) -> Integer
       def run_tests: (Array[String]) -> Integer
       def preload_environment: () -> void
       def setup_load_path: () -> void
+      def suppress_minitest_autorun!: () -> nil
       def suppress_simplecov!: () -> void
       def subprocess_env: () -> Hash[String, String]
+      def spawn_suite_process: (Array[String], Hash[Symbol, String]) -> Integer
       def cleanup_suite_process: (Integer?, untyped) -> void
       def spec_files: () -> Array[String]
     end
@@ -372,16 +490,31 @@ module Henitai
 
   class GitDiffAnalyzer
     def changed_files: (from: String, to: String, ?dir: String) -> Array[String]
+    def working_tree_changed_files: (?dir: String) -> Array[String]
+    def head_sha: (?dir: String) -> String?
   end
 
   class MutantGenerator
     def generate: (Array[Subject], Array[untyped], ?config: untyped) -> Array[Mutant]
   end
 
+  module MutantIdentity
+    def self.stable_id: (Mutant) -> String
+  end
+
   class MutantHistoryStore
+    attr_reader path: String
+
     def initialize: (path: String) -> void
-    def record: (Result, version: String, ?recorded_at: Time) -> void
+    def record: (untyped, version: String, ?recorded_at: Time) -> void
     def trend_report: () -> Hash[Symbol, untyped]
+
+    module Sql
+      RUNS_TABLE: String
+      MUTANTS_TABLE: String
+      INSERT_RUN: String
+      UPSERT_MUTANT: String
+    end
   end
 
   class EquivalenceDetector
@@ -420,6 +553,44 @@ module Henitai
     def run: (Array[Mutant], untyped, untyped, untyped, ?Hash[Symbol, untyped]) -> void
   end
 
+  class ProcessWorkerRunner
+    attr_reader worker_count: Integer
+    attr_reader runtime: untyped
+    attr_reader wakeup: untyped
+
+    def initialize: (worker_count: Integer, ?runtime: untyped, ?wakeup: untyped) -> void
+    def flaky_retry_count: () -> Integer
+    def shutdown_requested?: () -> bool
+    def request_shutdown: () -> void
+    def run: (Array[Mutant], untyped, untyped, untyped?, ?Hash[Symbol, untyped]) -> Array[ScenarioExecutionResult]
+  end
+
+  class SlotScheduler
+    PROCESS_DRAIN_WINDOW: Float
+
+    Slot: untyped
+
+    attr_reader flaky_retry_count: Integer
+    attr_reader results: Array[ScenarioExecutionResult]
+
+    def initialize: (
+      integration: untyped,
+      config: untyped,
+      progress_reporter: untyped?,
+      options: Hash[Symbol, untyped],
+      host: untyped
+    ) -> void
+    def enqueue: (Array[Mutant]) -> Array[Mutant]
+    def done?: () -> bool
+    def fill_idle_slots: () -> void
+    def reap_all_completed_children: () -> void
+    def next_event_timeout: () -> Float?
+    def check_timeouts: () -> void
+    def draining_slots?: () -> bool
+    def drain_draining_slots: () -> void
+    def interrupt_active_slots: () -> void
+  end
+
   class StaticFilter
     def initialize: (?coverage_report_reader: CoverageReportReader) -> void
     def apply: (Array[Mutant], untyped) -> Array[Mutant]
@@ -441,9 +612,7 @@ module Henitai
     def parallel_execution?: (untyped, Array[Mutant]) -> bool
     def worker_count: (untyped) -> Integer
     def run_linear: (Array[Mutant], untyped, untyped, untyped?, untyped) -> void
-    def run_parallel: (Array[Mutant], untyped, untyped, untyped?, untyped) -> void
-    def pipe_stdin?: () -> bool
-    def start_stdin_watcher: () { () -> void } -> Thread
+    def run_parallel: (Array[Mutant], untyped, untyped, untyped?) -> void
     def process_mutant: (Mutant, untyped, untyped, untyped?, ?untyped) -> void
     def prioritized_tests_for: (Mutant, untyped, untyped) -> Array[String]
     def test_prioritizer: () -> TestPrioritizer
@@ -454,9 +623,8 @@ module Henitai
   end
 
   class Mutant::Activator
-    SERIALIZER_METHODS: Hash[Symbol, Symbol]
-
     def self.activate!: (untyped) -> Symbol?
+    def self.activation_source_for: (Mutant) -> String?
     def initialize: () -> void
     def activate!: (untyped) -> Symbol?
 
@@ -468,6 +636,22 @@ module Henitai
     def method_source: (Mutant) -> String
     def body_source: (Mutant) -> String
     def parameter_source: (Mutant) -> String
+    def replace_node: (untyped, untyped, untyped) -> untyped
+    def same_node?: (untyped, untyped) -> bool
+    def replace_child: (untyped, untyped, untyped) -> untyped
+    def method_body: (untyped) -> untyped
+    def source_file_from_ast: (Subject) -> String?
+    def node_location_signature: (untyped) -> Array[untyped]?
+    def compile_safe_unparse: (untyped) -> String
+  end
+
+  class Mutant::ParameterSource
+    SERIALIZER_METHODS: Hash[Symbol, Symbol]
+
+    def build: (untyped) -> String
+
+    private
+
     def method_arguments: (untyped) -> untyped
     def parameter_fragment: (untyped) -> String?
     def argument_parameter_fragment: (untyped) -> String
@@ -479,26 +663,21 @@ module Henitai
     def block_parameter_fragment: (untyped) -> String
     def forward_parameter_fragment: (untyped) -> String
     def prefixed_parameter: (untyped, String) -> String
-    def replace_node: (untyped, untyped, untyped) -> untyped
-    def same_node?: (untyped, untyped) -> bool
-    def replace_child: (untyped, untyped, untyped) -> untyped
-    def method_body: (untyped) -> untyped
-    def source_file_from_ast: (Subject) -> String?
-    def node_location_signature: (untyped) -> Array[untyped]?
     def compile_safe_unparse: (untyped) -> String
   end
 
   module Reporter
-    def self.run_all: (names: Array[String], result: Result, config: Configuration) -> void
+    def self.run_all: (names: Array[String], result: Result, config: Configuration, ?history_store: MutantHistoryStore?) -> void
     def self.reporter_class: (String) -> untyped
 
     class Base
-      def initialize: (config: Configuration) -> void
+      def initialize: (config: Configuration, ?history_store: MutantHistoryStore?) -> void
       def report: (Result) -> void
 
       private
 
       def config: () -> Configuration
+      def history_store: () -> MutantHistoryStore?
     end
 
     class Terminal < Base
@@ -512,7 +691,10 @@ module Henitai
       private
 
       def report_lines: (Result) -> Array[String]
-      def summary_lines: (Result) -> Array[String]
+      def summary_lines: (untyped) -> Array[String]
+      def full_summary_lines: (untyped) -> Array[String]
+      def partial_summary_lines: (untyped) -> Array[String]
+      def append_survivor_stats: (Array[String], untyped) -> void
       def survived_detail_lines: (Result) -> Array[String]
       def survived_mutant_lines: (Mutant) -> Array[String]
       def survived_mutant_header: (Mutant) -> String
@@ -536,9 +718,15 @@ module Henitai
 
       private
 
-      def report_path: () -> String
+      def write_canonical: (Hash[Symbol, untyped]) -> void
+      def write_session_snapshot: (Hash[Symbol, untyped]) -> void
+      def write_activation_recipes: (untyped) -> void
+      def survived_mutants_for: (untyped) -> Array[Mutant]
+      def session_snapshot_path: (String) -> String
+      def session_recipe_path: (String) -> String
+      def canonical_path: () -> String
       def write_history_report: () -> void
-      def history_store_path: () -> String
+      def default_history_store: () -> MutantHistoryStore
       def history_report_path: () -> String
     end
 
@@ -595,8 +783,12 @@ module Henitai
     attr_reader started_at: Time
     attr_reader finished_at: Time
     attr_reader thresholds: Hash[Symbol, Integer]
+    attr_reader survivor_stats: Hash[Symbol, untyped]?
+    attr_reader session_id: String
+    attr_reader git_sha: String?
 
-    def initialize: (mutants: Array[Mutant], started_at: Time, finished_at: Time, ?thresholds: Hash[Symbol, Integer]?) -> void
+    def initialize: (mutants: Array[Mutant], started_at: Time, finished_at: Time, ?thresholds: Hash[Symbol, Integer]?, ?partial_rerun: bool, ?survivor_stats: Hash[Symbol, untyped]?, ?session_id: String, ?git_sha: String?, ?source_provider: ^(String) -> String) -> void
+    def partial_rerun?: () -> bool
     def killed: () -> Integer
     def survived: () -> Integer
     def equivalent: () -> Integer
@@ -609,6 +801,8 @@ module Henitai
 
     private
 
+    def base_schema: () -> Hash[Symbol, untyped]
+    def unmatched_survivor_ids: () -> Array[String]
     def build_files_section: () -> Hash[Symbol, untyped]
     def mutant_to_schema: (Mutant) -> Hash[Symbol, untyped]
     def coverage_schema: (Mutant) -> Hash[Symbol, untyped]
@@ -620,11 +814,56 @@ module Henitai
     def stryker_status: (Symbol) -> String
   end
 
+  class SurvivorLoader
+    FileNotFoundError: singleton(StandardError)
+    InvalidReportError: singleton(StandardError)
+    ScopeMismatchError: singleton(StandardError)
+
+    class Report
+      attr_reader survivor_ids: Array[String]
+      attr_reader coverage_map: Hash[String, Array[String]]
+      attr_reader git_sha: String?
+
+      def initialize: (survivor_ids: Array[String], coverage_map: Hash[String, Array[String]], git_sha: String?) -> void
+    end
+
+    def initialize: (String, ?include_paths: Array[String]) -> void
+    def load: () -> Report
+  end
+
+  class SurvivorTestFilter
+    def initialize: (
+      coverage_map: Hash[String, Array[String]],
+      git_sha: String?,
+      ?dirty_source_files: bool,
+      ?worktree_changed_files: Array[String],
+      ?diff_analyzer: GitDiffAnalyzer
+    ) -> void
+    def apply: (Array[Mutant]) -> Hash[Symbol, Array[Mutant]]
+  end
+
+  class SurvivorSelector
+    DRIFT_THRESHOLD: Float
+
+    def initialize: (survivor_ids: Array[String]) -> void
+    def select: (Array[Mutant]) -> Array[Mutant]
+    def unmatched_ids: () -> Array[String]
+    def drift_warning?: () -> bool
+  end
+
+  class SurvivorActivationCache
+    FILENAME: String
+
+    def self.compute: (Array[Mutant]) -> Hash[String, Hash[String, untyped]]
+    def self.load: (String) -> Hash[String, Hash[String, untyped]]?
+    def self.write: (String, Hash[String, Hash[String, untyped]]) -> void
+  end
+
   class Runner
     attr_reader config: Configuration
     attr_reader result: untyped
 
-    def initialize: (?config: Configuration, ?subjects: Array[Subject], ?since: String) -> void
+    def initialize: (?config: Configuration, ?subjects: Array[Subject], ?since: String, ?survivors_from: String?) -> void
     def run: () -> Result
     def resolve_subjects: (?Array[String]) -> untyped
     def generate_mutants: (untyped) -> untyped
@@ -643,6 +882,10 @@ module Henitai
     def history_store: () -> untyped
     def history_store_path: () -> String
     def source_files: () -> Array[String]
+    def included_source_files: () -> Array[String]
+    def reject_excluded: (Array[String]) -> Array[String]
+    def excluded_source_files: () -> Array[String]
+    def filter_changed: (Array[String]) -> Array[String]
     def pattern_subjects: () -> Array[Subject]
     def unique_subjects: (Array[Subject]) -> Array[Subject]
     def normalize_path: (String) -> String
@@ -650,12 +893,45 @@ module Henitai
     private
 
     def build_result: (Array[Mutant], Time, Time) -> Result
+    def source_provider: () -> ^(String) -> String
     def persist_history: (Result, Time) -> void
     def bootstrap_coverage: (Array[String], ?Array[String]?) -> void
     def bootstrap_mutants: (Array[String]) -> Thread
     def mutants_for: (Array[Subject], Array[String]) -> Array[Mutant]
     def with_reports_dir: () { () -> untyped } -> untyped
     def result_thresholds: () -> Hash[Symbol, Integer]?
+    def survivor_rerun?: () -> bool
+    def survivor_strategy: () -> SurvivorRerunStrategy
+    def safe_head_sha: () -> String?
+  end
+
+  class SurvivorRerunStrategy
+    attr_reader survivor_stats: Hash[Symbol, untyped]?
+
+    def initialize: (survivors_from: String?, config: Configuration, git_diff_analyzer: untyped) -> void
+    def active?: () -> bool
+    def try_recipe_run: () -> Array[Mutant]?
+    def apply_selection: (Array[Mutant]) -> Array[Mutant]
+
+    private
+
+    def load_survivor_report: () -> SurvivorLoader::Report
+    def run_from_recipes: (SurvivorLoader::Report, Array[String]?) -> Array[Mutant]?
+    def recipe_fast_path_safe?: (SurvivorLoader::Report, Array[String]?) -> bool
+    def recipe_selector_and_stubs: (Array[String], Hash[String, Hash[String, untyped]]) -> [SurvivorSelector, Array[Mutant]]
+    def load_activation_recipes: (Array[String]) -> Hash[String, Hash[String, untyped]]?
+    def build_stub_mutant: (String, Hash[String, untyped]) -> Mutant
+    def stub_subject_from_recipe: (Hash[String, untyped]) -> Subject
+    def recipe_location: (Hash[String, untyped]?) -> Hash[Symbol, untyped]
+    def finalize_survivor_split: (SurvivorSelector, Array[Mutant], Hash[Symbol, Array[Mutant]]) -> Array[Mutant]
+    def dirty_worktree_changed_files: () -> Array[String]?
+    def dirty_source_files?: (Array[String]?, ?git_sha: String?) -> bool
+    def committed_changed_files: (String?) -> Array[String]
+    def in_include_root?: (String, Array[String]) -> bool
+    def normalize_path: (String) -> String
+    def warn_survivor_drift: (SurvivorSelector) -> void
+    def build_survivor_stats: (SurvivorSelector, Array[Mutant], Hash[Symbol, Array[Mutant]]) -> Hash[Symbol, untyped]
+    def test_filter: (SurvivorLoader::Report, ?dirty_source_files: bool) -> SurvivorTestFilter
   end
 
   class CoverageBootstrapper