saboteur 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +199 -0
  3. data/README.md +427 -20
  4. data/exe/saboteur +6 -2
  5. data/lib/saboteur/agent_skill.rb +6 -0
  6. data/lib/saboteur/baseline/acceptance.rb +218 -0
  7. data/lib/saboteur/baseline/command.rb +80 -0
  8. data/lib/saboteur/baseline/comparison.rb +106 -0
  9. data/lib/saboteur/baseline/completeness.rb +53 -0
  10. data/lib/saboteur/baseline/evidence.rb +124 -0
  11. data/lib/saboteur/baseline/identity.rb +78 -0
  12. data/lib/saboteur/baseline/manifest.rb +164 -0
  13. data/lib/saboteur/baseline/run_evidence.rb +117 -0
  14. data/lib/saboteur/baseline/workflow.rb +121 -0
  15. data/lib/saboteur/baseline_health.rb +1 -1
  16. data/lib/saboteur/cli/exit_status.rb +93 -0
  17. data/lib/saboteur/cli/run_reporting.rb +75 -0
  18. data/lib/saboteur/cli.rb +113 -122
  19. data/lib/saboteur/config.rb +96 -6
  20. data/lib/saboteur/doctor.rb +64 -9
  21. data/lib/saboteur/engine/baseline_guard.rb +33 -11
  22. data/lib/saboteur/engine/bytecode_equivalence.rb +95 -0
  23. data/lib/saboteur/engine/canary.rb +74 -0
  24. data/lib/saboteur/engine/candidate_selection.rb +18 -5
  25. data/lib/saboteur/engine/candidates.rb +62 -7
  26. data/lib/saboteur/engine/coverage_store.rb +34 -14
  27. data/lib/saboteur/engine/diagnostics.rb +150 -4
  28. data/lib/saboteur/engine/diff_scope.rb +10 -0
  29. data/lib/saboteur/engine/distribution.rb +54 -13
  30. data/lib/saboteur/engine/result_cache.rb +10 -5
  31. data/lib/saboteur/engine/run_fingerprint.rb +7 -5
  32. data/lib/saboteur/engine/sandbox_policy.rb +108 -0
  33. data/lib/saboteur/engine/scheduler.rb +92 -20
  34. data/lib/saboteur/engine/subject_selection.rb +24 -1
  35. data/lib/saboteur/engine/test_guess.rb +89 -0
  36. data/lib/saboteur/engine/unchanged_syntax.rb +87 -0
  37. data/lib/saboteur/engine/verdict_check.rb +7 -6
  38. data/lib/saboteur/engine.rb +201 -19
  39. data/lib/saboteur/execution/protocol.rb +2 -1
  40. data/lib/saboteur/execution/reevaluator.rb +72 -10
  41. data/lib/saboteur/execution/runner.rb +120 -17
  42. data/lib/saboteur/execution/sandbox.rb +271 -0
  43. data/lib/saboteur/execution/stale_captures.rb +43 -0
  44. data/lib/saboteur/execution/supervisor.rb +101 -9
  45. data/lib/saboteur/execution/worker_pool.rb +20 -4
  46. data/lib/saboteur/execution/wrapper.rb +45 -0
  47. data/lib/saboteur/frameworks/database_hosts.rb +30 -0
  48. data/lib/saboteur/frameworks/rails.rb +8 -10
  49. data/lib/saboteur/gates.rb +83 -0
  50. data/lib/saboteur/help.rb +32 -7
  51. data/lib/saboteur/ignore_list.rb +5 -0
  52. data/lib/saboteur/inline_suppression.rb +65 -0
  53. data/lib/saboteur/integration/base.rb +1 -0
  54. data/lib/saboteur/integration/focus_guard.rb +83 -0
  55. data/lib/saboteur/integration/rspec.rb +21 -1
  56. data/lib/saboteur/mutation_source/builtin.rb +22 -3
  57. data/lib/saboteur/mutation_source/chain_removal.rb +80 -0
  58. data/lib/saboteur/mutation_source/condition_negation.rb +50 -0
  59. data/lib/saboteur/mutation_source/endpoint_replacement.rb +61 -0
  60. data/lib/saboteur/mutation_source/hazard_guard.rb +136 -0
  61. data/lib/saboteur/mutation_source/operator_assignment.rb +52 -0
  62. data/lib/saboteur/mutation_source/operator_examples.rb +35 -0
  63. data/lib/saboteur/mutation_source/operator_registry.rb +82 -0
  64. data/lib/saboteur/mutation_source/range_replacement.rb +43 -0
  65. data/lib/saboteur/preview.rb +115 -0
  66. data/lib/saboteur/reporter/agent_commands.rb +19 -5
  67. data/lib/saboteur/reporter/agent_incomplete.rb +24 -1
  68. data/lib/saboteur/reporter/agent_summary.rb +12 -6
  69. data/lib/saboteur/reporter/findings.rb +4 -19
  70. data/lib/saboteur/reporter/history_paths.rb +38 -0
  71. data/lib/saboteur/reporter/history_policy.rb +35 -0
  72. data/lib/saboteur/reporter/history_record.rb +131 -0
  73. data/lib/saboteur/reporter/html.rb +12 -1
  74. data/lib/saboteur/reporter/mutation_text.rb +36 -0
  75. data/lib/saboteur/reporter/next_steps.rb +30 -0
  76. data/lib/saboteur/reporter/palette.rb +37 -0
  77. data/lib/saboteur/reporter/score_history.rb +135 -0
  78. data/lib/saboteur/reporter/score_table.rb +57 -0
  79. data/lib/saboteur/reporter/stryker.rb +18 -3
  80. data/lib/saboteur/reporter/survivor_hints.rb +68 -0
  81. data/lib/saboteur/reporter/survivor_list.rb +126 -0
  82. data/lib/saboteur/reporter/survivor_ranking.rb +34 -0
  83. data/lib/saboteur/reporter/terminal.rb +140 -79
  84. data/lib/saboteur/reporter/test_matrix.rb +57 -0
  85. data/lib/saboteur/result.rb +44 -6
  86. data/lib/saboteur/selection/coverage_map.rb +119 -13
  87. data/lib/saboteur/selection/git_diff.rb +28 -1
  88. data/lib/saboteur/selection/recorder.rb +55 -13
  89. data/lib/saboteur/subject.rb +40 -4
  90. data/lib/saboteur/subject_finder.rb +62 -12
  91. data/lib/saboteur/version.rb +1 -1
  92. data/lib/saboteur/working_tree.rb +8 -0
  93. data/lib/saboteur.rb +6 -0
  94. metadata +46 -2
data/lib/saboteur.rb CHANGED
@@ -9,6 +9,9 @@ module Saboteur
9
9
  # Invalid configuration or input files (exit code 2).
10
10
  class ConfigError < Error; end
11
11
 
12
+ # Files vanished from the working tree while mutants ran (exit code 3).
13
+ class CanaryTripped < Error; end
14
+
12
15
  class << self
13
16
  # Set while hook files from config load, so they can call Saboteur.hook.
14
17
  attr_accessor :current_hooks
@@ -36,14 +39,17 @@ require_relative "saboteur/execution/process_table"
36
39
  require_relative "saboteur/execution/process_tree"
37
40
  require_relative "saboteur/execution/supervisor"
38
41
  require_relative "saboteur/execution/reevaluator"
42
+ require_relative "saboteur/execution/wrapper"
39
43
  require_relative "saboteur/execution/runner"
40
44
  require_relative "saboteur/execution/worker_pool"
41
45
  require_relative "saboteur/execution/fork_readiness"
46
+ require_relative "saboteur/execution/sandbox"
42
47
  require_relative "saboteur/selection/coverage_map"
43
48
  require_relative "saboteur/selection/recorder"
44
49
  require_relative "saboteur/selection/git_diff"
45
50
  require_relative "saboteur/result"
46
51
  require_relative "saboteur/custom_map"
52
+ require_relative "saboteur/gates"
47
53
  require_relative "saboteur/config"
48
54
  require_relative "saboteur/ignore_list"
49
55
  require_relative "saboteur/frameworks/rails"
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: saboteur
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Vamsi Pavan Mahesh Gunturu
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2026-10-12 00:00:00.000000000 Z
11
+ date: 2026-10-14 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: fiddle
@@ -61,8 +61,19 @@ files:
61
61
  - lib/generators/saboteur/install/install_generator.rb
62
62
  - lib/saboteur.rb
63
63
  - lib/saboteur/agent_skill.rb
64
+ - lib/saboteur/baseline/acceptance.rb
65
+ - lib/saboteur/baseline/command.rb
66
+ - lib/saboteur/baseline/comparison.rb
67
+ - lib/saboteur/baseline/completeness.rb
68
+ - lib/saboteur/baseline/evidence.rb
69
+ - lib/saboteur/baseline/identity.rb
70
+ - lib/saboteur/baseline/manifest.rb
71
+ - lib/saboteur/baseline/run_evidence.rb
72
+ - lib/saboteur/baseline/workflow.rb
64
73
  - lib/saboteur/baseline_health.rb
65
74
  - lib/saboteur/cli.rb
75
+ - lib/saboteur/cli/exit_status.rb
76
+ - lib/saboteur/cli/run_reporting.rb
66
77
  - lib/saboteur/config.rb
67
78
  - lib/saboteur/config_file.rb
68
79
  - lib/saboteur/custom_map.rb
@@ -70,6 +81,8 @@ files:
70
81
  - lib/saboteur/engine.rb
71
82
  - lib/saboteur/engine/baseline_guard.rb
72
83
  - lib/saboteur/engine/boot.rb
84
+ - lib/saboteur/engine/bytecode_equivalence.rb
85
+ - lib/saboteur/engine/canary.rb
73
86
  - lib/saboteur/engine/candidate_selection.rb
74
87
  - lib/saboteur/engine/candidates.rb
75
88
  - lib/saboteur/engine/coverage_store.rb
@@ -79,9 +92,12 @@ files:
79
92
  - lib/saboteur/engine/distribution.rb
80
93
  - lib/saboteur/engine/result_cache.rb
81
94
  - lib/saboteur/engine/run_fingerprint.rb
95
+ - lib/saboteur/engine/sandbox_policy.rb
82
96
  - lib/saboteur/engine/scheduler.rb
83
97
  - lib/saboteur/engine/subject_selection.rb
84
98
  - lib/saboteur/engine/suite_files.rb
99
+ - lib/saboteur/engine/test_guess.rb
100
+ - lib/saboteur/engine/unchanged_syntax.rb
85
101
  - lib/saboteur/engine/verdict_check.rb
86
102
  - lib/saboteur/execution/fork_readiness.rb
87
103
  - lib/saboteur/execution/process_table.rb
@@ -89,23 +105,39 @@ files:
89
105
  - lib/saboteur/execution/protocol.rb
90
106
  - lib/saboteur/execution/reevaluator.rb
91
107
  - lib/saboteur/execution/runner.rb
108
+ - lib/saboteur/execution/sandbox.rb
109
+ - lib/saboteur/execution/stale_captures.rb
92
110
  - lib/saboteur/execution/supervisor.rb
93
111
  - lib/saboteur/execution/worker_pool.rb
112
+ - lib/saboteur/execution/wrapper.rb
113
+ - lib/saboteur/frameworks/database_hosts.rb
94
114
  - lib/saboteur/frameworks/rails.rb
115
+ - lib/saboteur/gates.rb
95
116
  - lib/saboteur/help.rb
96
117
  - lib/saboteur/hooks.rb
97
118
  - lib/saboteur/ignore_list.rb
119
+ - lib/saboteur/inline_suppression.rb
98
120
  - lib/saboteur/install.rb
99
121
  - lib/saboteur/integration/base.rb
122
+ - lib/saboteur/integration/focus_guard.rb
100
123
  - lib/saboteur/integration/rspec.rb
101
124
  - lib/saboteur/mutation_source/argument_removal.rb
102
125
  - lib/saboteur/mutation_source/base.rb
103
126
  - lib/saboteur/mutation_source/builtin.rb
127
+ - lib/saboteur/mutation_source/chain_removal.rb
128
+ - lib/saboteur/mutation_source/condition_negation.rb
104
129
  - lib/saboteur/mutation_source/edit.rb
130
+ - lib/saboteur/mutation_source/endpoint_replacement.rb
105
131
  - lib/saboteur/mutation_source/filter_replacement.rb
132
+ - lib/saboteur/mutation_source/hazard_guard.rb
106
133
  - lib/saboteur/mutation_source/literal_replacement.rb
107
134
  - lib/saboteur/mutation_source/mutation.rb
135
+ - lib/saboteur/mutation_source/operator_assignment.rb
136
+ - lib/saboteur/mutation_source/operator_examples.rb
137
+ - lib/saboteur/mutation_source/operator_registry.rb
108
138
  - lib/saboteur/mutation_source/pair_removal.rb
139
+ - lib/saboteur/mutation_source/range_replacement.rb
140
+ - lib/saboteur/preview.rb
109
141
  - lib/saboteur/replay.rb
110
142
  - lib/saboteur/reporter/agent.rb
111
143
  - lib/saboteur/reporter/agent_clipping.rb
@@ -114,10 +146,22 @@ files:
114
146
  - lib/saboteur/reporter/agent_summary.rb
115
147
  - lib/saboteur/reporter/diff.rb
116
148
  - lib/saboteur/reporter/findings.rb
149
+ - lib/saboteur/reporter/history_paths.rb
150
+ - lib/saboteur/reporter/history_policy.rb
151
+ - lib/saboteur/reporter/history_record.rb
117
152
  - lib/saboteur/reporter/html.rb
153
+ - lib/saboteur/reporter/mutation_text.rb
154
+ - lib/saboteur/reporter/next_steps.rb
155
+ - lib/saboteur/reporter/palette.rb
118
156
  - lib/saboteur/reporter/replay.rb
157
+ - lib/saboteur/reporter/score_history.rb
158
+ - lib/saboteur/reporter/score_table.rb
119
159
  - lib/saboteur/reporter/stryker.rb
160
+ - lib/saboteur/reporter/survivor_hints.rb
161
+ - lib/saboteur/reporter/survivor_list.rb
162
+ - lib/saboteur/reporter/survivor_ranking.rb
120
163
  - lib/saboteur/reporter/terminal.rb
164
+ - lib/saboteur/reporter/test_matrix.rb
121
165
  - lib/saboteur/result.rb
122
166
  - lib/saboteur/score.rb
123
167
  - lib/saboteur/selection/coverage_map.rb