hecks 1.3.0 → 1.4.0

data/lib/hecks/vocabulary.rb

@@ -1,7 +1,7 @@
-# GENERATED — projected from the language's own Vocabulary aggregate
+# Generated — projected from the language's own Vocabulary aggregate
 # (lib/hecks/language/bluebook/vocabulary.bluebook).
 #
-# DO NOT EDIT. spec/vocabulary_table_spec.rb re-projects this in memory
+# Do not edit. spec/vocabulary_table_spec.rb re-projects this in memory
 # and refuses a diff, so an edit here fails the ordinary suite.
 #
 # Plain data on purpose — no requires, no dependency on the model —
@@ -13,6 +13,7 @@ module Hecks
   module Vocabulary
     TABLES = {
       "AggregateDispatchOrder" => [
+        {"step"=>"decode_arguments"}.freeze,
         {"step"=>"refuse_unknown_arguments"}.freeze,
         {"step"=>"refuse_absent_arguments"}.freeze,
         {"step"=>"normalize_args"}.freeze,
@@ -30,6 +31,24 @@ module Hecks
         {"step"=>"save"}.freeze,
         {"step"=>"emit"}.freeze
       ].freeze,
+      "CargoReservedName" => [
+        {"name"=>"name"}.freeze,
+        {"name"=>"version"}.freeze,
+        {"name"=>"edition"}.freeze,
+        {"name"=>"path"}.freeze,
+        {"name"=>"authors"}.freeze,
+        {"name"=>"license"}.freeze,
+        {"name"=>"description"}.freeze,
+        {"name"=>"default"}.freeze,
+        {"name"=>"features"}.freeze,
+        {"name"=>"package"}.freeze,
+        {"name"=>"lib"}.freeze,
+        {"name"=>"bin"}.freeze,
+        {"name"=>"dependencies"}.freeze,
+        {"name"=>"dev-dependencies"}.freeze,
+        {"name"=>"build-dependencies"}.freeze,
+        {"name"=>"workspace"}.freeze
+      ].freeze,
       "Comparison" => [
         {"symbol"=>">=", "compares_less_than"=>"true", "compares_equal"=>"false", "negated"=>"true"}.freeze,
         {"symbol"=>"<=", "compares_less_than"=>"true", "compares_equal"=>"true", "negated"=>"false"}.freeze,
@@ -56,6 +75,7 @@ module Hecks
         {"name"=>"UnknownVerb"}.freeze
       ].freeze,
       "EntityDispatchOrder" => [
+        {"step"=>"decode_arguments"}.freeze,
         {"step"=>"refuse_unknown_arguments"}.freeze,
         {"step"=>"refuse_absent_arguments"}.freeze,
         {"step"=>"normalize_args"}.freeze,
@@ -123,6 +143,136 @@ module Hecks
         {"name"=>"contains"}.freeze,
         {"name"=>"none_in_state"}.freeze
       ].freeze,
+      "RefusalSiteArgument" => [
+        {"refusal"=>"NotFound", "site"=>"creating_no_identity", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"creating_no_identity", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"creating_no_identity", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"creating_duplicate", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"creating_duplicate", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"creating_duplicate", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"creating_duplicate", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"entity_duplicate", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"entity_duplicate", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"entity_duplicate", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AlreadyExists", "site"=>"entity_duplicate", "argument"=>"offered", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"acting_no_identity", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"acting_no_identity", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"acting_no_identity", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"record_missing", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"record_missing", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"record_missing", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_parent_no_identity", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_parent_no_identity", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_parent_no_identity", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_parent_no_identity", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_unknown", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_unknown", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_no_identity", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_no_identity", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_no_identity", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_missing", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_missing", "argument"=>"identity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_missing", "argument"=>"wants", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_missing", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"entity_element_missing", "argument"=>"parent_id", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"reference_target_missing", "argument"=>"target", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"reference_target_missing", "argument"=>"heads", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"reference_target_missing", "argument"=>"key", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"read_model_reference_missing", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"NotFound", "site"=>"read_model_reference_missing", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"read_model_object_reference", "argument"=>"query", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"read_model_object_reference", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_query", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_query", "argument"=>"query", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_query_missing", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_query_missing", "argument"=>"query", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_holds_no_list", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_holds_no_list", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_no_command", "argument"=>"entity", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"entity_no_command", "argument"=>"command", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"aggregate_no_command", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"aggregate_no_command", "argument"=>"command", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"port_no_operation", "argument"=>"port", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"port_no_operation", "argument"=>"operation", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_domain", "argument"=>"domain", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_domain", "argument"=>"verb", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_read_model", "argument"=>"domain", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_read_model", "argument"=>"query", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"not_fully_qualified", "argument"=>"verb", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_aggregate", "argument"=>"domain", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownVerb", "site"=>"no_aggregate", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"inspect", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"LifecycleRefused", "site"=>"transition_blocked", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"LifecycleRefused", "site"=>"transition_blocked", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"LifecycleRefused", "site"=>"transition_blocked", "argument"=>"current", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"LifecycleRefused", "site"=>"transition_blocked", "argument"=>"allowed", "shape"=>"list", "quoting"=>"inspect", "separator"=>" or ", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"value_object_shape", "argument"=>"name", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"value_object_shape", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"value_object_shape", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"reference_wrong_shape", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"reference_wrong_shape", "argument"=>"attribute", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"reference_wrong_shape", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"reference_wrong_shape", "argument"=>"known_by", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"multi_field_scalar", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"composite_identity", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"numeric_field", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"numeric_field", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"numeric_field", "argument"=>"expected", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"numeric_field", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"non_finite_field", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"non_finite_field", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"non_finite_field", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"integer_range", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"integer_range", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"integer_range", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"pattern_mismatch", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"pattern_mismatch", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"pattern_mismatch", "argument"=>"pattern", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"pattern_mismatch", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_amount", "argument"=>"op", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_amount", "argument"=>"target", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_amount", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_current", "argument"=>"op", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_current", "argument"=>"target", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_current", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_shared_field", "argument"=>"op", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"TypeMismatch", "site"=>"arithmetic_shared_field", "argument"=>"target", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownArgument", "site"=>"unknown_args", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownArgument", "site"=>"unknown_args", "argument"=>"unknown", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"true", "when_empty"=>""}.freeze,
+        {"refusal"=>"UnknownArgument", "site"=>"unknown_args", "argument"=>"declared", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"false", "when_empty"=>"none"}.freeze,
+        {"refusal"=>"AbsentArgument", "site"=>"absent_args", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AbsentArgument", "site"=>"absent_args", "argument"=>"absent", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"true", "when_empty"=>""}.freeze,
+        {"refusal"=>"AbsentArgument", "site"=>"absent_args", "argument"=>"declared", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"false", "when_empty"=>"none"}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"closed_set_member", "argument"=>"type", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"closed_set_member", "argument"=>"admitted", "shape"=>"list", "quoting"=>"inspect", "separator"=>", ", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"closed_set_member", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"value_object_invariant", "argument"=>"name", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"value_object_invariant", "argument"=>"description", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"value_object_invariant", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "argument"=>"name", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "argument"=>"admits", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "argument"=>"admitted", "shape"=>"list", "quoting"=>"inspect", "separator"=>", ", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"undeclared_set", "argument"=>"name", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"undeclared_set", "argument"=>"admits", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"tenant_required", "argument"=>"query", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"tenant_required", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"role_mismatch", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"role_mismatch", "argument"=>"role", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"role_mismatch", "argument"=>"caller_role", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"tenant", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"attribute", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"target", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"target_field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "argument"=>"other", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AttributeAbsent", "site"=>"absent_read", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"AttributeAbsent", "site"=>"absent_read", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"ProjectionAbsent", "site"=>"absent_read", "argument"=>"aggregate", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"ProjectionAbsent", "site"=>"absent_read", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"ProjectionAbsent", "site"=>"absent_read", "argument"=>"reference", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"ProjectionAbsent", "site"=>"absent_read", "argument"=>"remote_field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze
+      ].freeze,
       "RefusalTemplate" => [
         {"refusal"=>"NotFound", "site"=>"creating_no_identity", "template"=>"{command} creates a {aggregate} — pass {identity}:"}.freeze,
         {"refusal"=>"AlreadyExists", "site"=>"creating_duplicate", "template"=>"{command} creates a {aggregate} that already exists — {identity} {offered}"}.freeze,
@@ -170,6 +320,57 @@ module Hecks
         {"refusal"=>"AttributeAbsent", "site"=>"absent_read", "template"=>"{aggregate} {field} is absent on this record — declared, not optional, and added since it was written. Backfill it in a translation (backfill :{field}, default: ...), or declare it optional: true"}.freeze,
         {"refusal"=>"ProjectionAbsent", "site"=>"absent_read", "template"=>"{aggregate} {field} is not yet projected on this record — declared via projects :{field}, but no rebuild sweep has populated it. Run the sweep, or read {reference}.{remote_field} directly if this rule cannot wait"}.freeze
       ].freeze,
+      "RustReservedWord" => [
+        {"word"=>"as"}.freeze,
+        {"word"=>"break"}.freeze,
+        {"word"=>"const"}.freeze,
+        {"word"=>"continue"}.freeze,
+        {"word"=>"crate"}.freeze,
+        {"word"=>"dyn"}.freeze,
+        {"word"=>"else"}.freeze,
+        {"word"=>"enum"}.freeze,
+        {"word"=>"extern"}.freeze,
+        {"word"=>"false"}.freeze,
+        {"word"=>"fn"}.freeze,
+        {"word"=>"for"}.freeze,
+        {"word"=>"if"}.freeze,
+        {"word"=>"impl"}.freeze,
+        {"word"=>"in"}.freeze,
+        {"word"=>"let"}.freeze,
+        {"word"=>"loop"}.freeze,
+        {"word"=>"match"}.freeze,
+        {"word"=>"mod"}.freeze,
+        {"word"=>"move"}.freeze,
+        {"word"=>"mut"}.freeze,
+        {"word"=>"pub"}.freeze,
+        {"word"=>"ref"}.freeze,
+        {"word"=>"return"}.freeze,
+        {"word"=>"self"}.freeze,
+        {"word"=>"Self"}.freeze,
+        {"word"=>"static"}.freeze,
+        {"word"=>"struct"}.freeze,
+        {"word"=>"super"}.freeze,
+        {"word"=>"trait"}.freeze,
+        {"word"=>"true"}.freeze,
+        {"word"=>"type"}.freeze,
+        {"word"=>"unsafe"}.freeze,
+        {"word"=>"use"}.freeze,
+        {"word"=>"where"}.freeze,
+        {"word"=>"while"}.freeze,
+        {"word"=>"abstract"}.freeze,
+        {"word"=>"become"}.freeze,
+        {"word"=>"box"}.freeze,
+        {"word"=>"do"}.freeze,
+        {"word"=>"final"}.freeze,
+        {"word"=>"macro"}.freeze,
+        {"word"=>"override"}.freeze,
+        {"word"=>"priv"}.freeze,
+        {"word"=>"typeof"}.freeze,
+        {"word"=>"unsized"}.freeze,
+        {"word"=>"virtual"}.freeze,
+        {"word"=>"yield"}.freeze,
+        {"word"=>"try"}.freeze
+      ].freeze,
       "SignTest" => [
         {"name"=>"positive?", "compares_via"=>">"}.freeze,
         {"name"=>"negative?", "compares_via"=>"<"}.freeze,
@@ -196,8 +397,8 @@ module Hecks
       ].freeze
     }.freeze
 
-    # THE TERMS — the first field of each row, which for a
-    # one-field vocabulary is the whole of it. Derived ONCE and
+    # The terms — the first field of each row, which for a
+    # one-field vocabulary is the whole of it. Derived once and
     # frozen rather than mapped per call: these are constant
     # tables, and a constant that allocates a new array every
     # time it is read is not one.

data/lib/hecks.rb

@@ -1,4 +1,5 @@
 require_relative "hecks/version"
+require_relative "hecks/deprecation"
 # The closed sets the runtime computes with, generated from
 # vocabulary.bluebook. Plain data, required first, because some of
 # them are read while a bluebook is still being parsed.
@@ -22,16 +23,17 @@ require_relative "hecks/router"
 require_relative "hecks/runtime"
 require_relative "hecks/adapters"
 require_relative "hecks/projector"
-# AFTER the projector registry and its `Target` mixin are both real —
-# every target registers itself as it loads, so this require IS the
+# After the projector registry and its `Target` mixin are both real —
+# every target registers itself as it loads, so this require is the
 # installation of them.
 require_relative "hecks/projections"
-# AFTER `Projector` (dispatches against the `:cli` projection) and
+# After `Projector` (dispatches against the `:cli` projection) and
 # `Ports::Clock` (fills a staleness rule's `now` at the door) both exist.
 require_relative "hecks/facade/cli_door"
 require_relative "hecks/facade/cli_runner"
 require_relative "hecks/storehouse"
 require_relative "hecks/framework"
+require_relative "hecks/corpus"
 require_relative "hecks/embryonaut_bluebook"
 
 # The root namespace and public facade of the whole DSL/runtime: `Hecks.boot`/
@@ -44,14 +46,14 @@ module Hecks
   class LoadOutsideBoot < StandardError; end
 
   class << self
-    # The loading words below collect into the registry the RUNTIME is
+    # The loading words below collect into the registry the runtime is
     # holding open ; booting and that ambient state belong to the runtime
     # layer, so this module is their facade and Hecks::Runtime is where
     # they live.
     # `install_facade:` — see Runtime::Loader.boot. Defaults on; a caller
     # that only dispatches by FQN string can skip the global sugar.
     #
-    # `environment:` — RECOVERED, not new: this parameter (and the
+    # `environment:` — recovered, not new: this parameter (and the
     # `environments/<name>.hecksagon` / `.world` overlay it loads —
     # see Adapters::Folder#load_domain) existed on a prior commit of
     # this repo (933d1dd), was vendored out to a real consumer
@@ -86,14 +88,14 @@ module Hecks
     # default), a command's role stays exactly what it is without this:
     # decoration.
     #
-    # `actor_id` is OPTIONAL — a caller naming only a role is checked by
+    # `actor_id` is optional — a caller naming only a role is checked by
     # string equality against the command's own `role`, exactly as
-    # before. A caller that also names WHO it is lets the check run
+    # before. A caller that also names who it is lets the check run
     # against a real Governance `RoleAssignment` instead, once the
     # command's domain has Governance attached — see
     # `CommandRules::Authorization`'s own header.
     #
-    # `as_of` and `scope` are OPTIONAL too, same shape — see
+    # `as_of` and `scope` are optional too, same shape — see
     # `Runtime.as_caller`'s own header for what each does.
     def as_caller(role:, actor_id: nil, as_of: nil, scope: nil, &)
       Runtime.as_caller(role: role, actor_id: actor_id, as_of: as_of, scope: scope, &)
@@ -104,7 +106,7 @@ module Hecks
     end
 
     def hecksagon(name, &) = collect(:add_hecksagon, Bluebook::DSL::HecksagonBuilder.build(name, &))
-    # REPOINTED TO DomainPortBuilder — the migration DomainPort's own
+    # Repointed to DomainPortBuilder — the migration DomainPort's own
     # class comment names as its goal, now landed for the top-level
     # `.port` file callers too (the aggregate-scoped `Thing.port(...)`,
     # binding_proxy.rb, already went through this builder). Every real
@@ -115,12 +117,12 @@ module Hecks
     # identity check) — a pure repoint, no behavior change for any
     # existing caller reading `.verb`/`.signal` off what comes back.
     #
-    # `legacy_bare_port: true` — the ONE real semantic gap this repoint
+    # `legacy_bare_port: true` — the one real semantic gap this repoint
     # would otherwise open: `PortBuilder#build` never refused a
     # completely empty build (no verb, no signal even), a real shape
     # dsl_spec.rb's own "a port" tests exercise (`signal`-only, no
     # `verb`). `DomainPortBuilder`'s own "declares no verb and no
-    # operations" refusal is real and correct for its OTHER two callers
+    # operations" refusal is real and correct for its other two callers
     # (`BindingProxy#port`, `HecksagonBuilder#port_impl`) — only this,
     # the literal top-level `.port` file entry point, keeps the older,
     # looser rule (see `DomainPortBuilder#initialize`'s own comment).

data/lib/rubocop/cop/hecks/fallback_hash_lookup.rb

@@ -1,11 +1,11 @@
 module RuboCop
   module Cop
     module Hecks
-      # FLAGS THE EXACT SHAPE behind 8+ real bugs already fixed one at a
+      # Flags the exact shape behind 8+ real bugs already fixed one at a
       # time across this codebase (Tiers 1-5): `holder[a] || holder[b]` —
-      # the SAME receiver looked up by two different keys, falling back to
+      # the same receiver looked up by two different keys, falling back to
       # the second lookup whenever the first is falsy. `||` cannot tell a
-      # genuinely STORED `false` from a MISSING key — both are falsy in
+      # genuinely stored `false` from a missing key — both are falsy in
       # Ruby — so a real `false` sitting at `holder[a]` is silently
       # discarded and `holder[b]` (usually absent, so `nil`) is returned
       # instead. Every one of those 8+ instances was the identical
@@ -13,26 +13,26 @@ module RuboCop
       # `h[k.to_sym] || h[k]`, reading a value that could arrive keyed
       # either by symbol or by string off the wire).
       #
-      # THE FIX THIS CODEBASE ALREADY CONVERGED ON — see
+      # The fix this codebase already converged on — see
       # `lib/hecks/query_specification/field_path.rb#read`, the shared
       # digger this whole bug class got consolidated behind: check
-      # `key?` FIRST, never fall back through `||`.
+      # `key?` first, never fall back through `||`.
       #
       #   sym = segment.to_sym
       #   return current.key?(sym) ? current[sym] : current[segment]
       #
       # That method's own comment says it plainly: "`key?` first, never
       # `||`, because `||` falls through a genuinely-stored `false` to
-      # the OTHER spelling (usually absent) and returns `nil` instead."
-      # This cop exists so the NEXT `holder[a] || holder[b]` gets caught
+      # the other spelling (usually absent) and returns `nil` instead."
+      # This cop exists so the next `holder[a] || holder[b]` gets caught
       # mechanically, before it becomes bug #9, rather than found by
       # hand again in a future audit.
       #
-      # SCOPED TO THE `[]`/`[]` SHAPE ONLY, deliberately — a receiver
+      # Scoped to the `[]`/`[]` shape only, deliberately — a receiver
       # method-call is compared by AST structure (`==`, which ignores
       # source location), so `hash[a] || hash[b]` is flagged whether
       # `hash` is a local variable, a method call, or a constant, but
-      # `a[k] || b[k]` (DIFFERENT receivers) and `value || default`
+      # `a[k] || b[k]` (different receivers) and `value || default`
       # (an ordinary default, not a second lookup at all) are both left
       # alone — neither one can silently drop a stored `false` the way
       # a same-receiver double-lookup can.
@@ -65,11 +65,11 @@ module RuboCop
           rhs_receiver, rhs_key = bracket_lookup(node.rhs)
           return unless rhs_receiver
 
-          # THE STRUCTURAL EQUALITY CHECK — `==` on an AST node (from the
+          # **The structural equality check** — `==` on an AST node (from the
           # `ast` gem `Node` this compiles down to) compares `type` and
           # `children` recursively and ignores source location, so
           # `hash[a] || hash[b]` matches even though the two `hash`
-          # sub-nodes are two distinct node OBJECTS parsed from two
+          # sub-nodes are two distinct node objects parsed from two
           # different source ranges. A different receiver on each side
           # (`a[k] || b[k]`) fails this check and is correctly left alone.
           return unless lhs_receiver == rhs_receiver

data/lib/rubocop/cop/hecks/sequential_hash_rename_in_loop.rb

@@ -1,47 +1,48 @@
 module RuboCop
   module Cop
     module Hecks
-      # FLAGS `hash[new] = hash.delete(old)` INSIDE A LOOP — a method that
-      # both READS and WRITES the same hash across a loop's iterations,
+      # Flags `hash[new] = hash.delete(old)` inside a loop — a method that
+      # both reads and writes the same hash across a loop's iterations,
       # in the specific rename/permutation shape this codebase has
       # already lost real data to once.
       #
-      # THE BUG THIS IS THE MECHANICAL FOLLOW-UP TO (M27,
+      # The bug this is the mechanical follow-up to (M27,
       # docs/audits/2026-08-10-main-bug-audit.md,
       # docs/audits/2026-08-11-bug-triage.md; fixed in
       # `Hecks::Ports::Persistence::Lineage#apply_renames`,
       # lib/hecks/ports/persistence/plugins/era/lineage.rb): a rename
       # rule set applied one rule at a time, `state[new_name] =
-      # state.delete(old_name)` per rule, against the SAME hash it was
+      # state.delete(old_name)` per rule, against the same hash it was
       # reading from — so a swap (`rename :a, to: :b` alongside `rename
       # :b, to: :a`) on `{a: 1, b: 2}` collapsed to `{a: 1}`. The first
       # rule wrote `b: 1` (clobbering the real `b: 2`) before the second
       # rule ever got a chance to read the value that was supposed to
       # move to `:a` — sequential edits stepping on each other, not the
       # simultaneous permutation a rename set actually means. The same
-      # shape loses data identically for ANY chain longer than one link
+      # shape loses data identically for any chain longer than one link
       # (`a->b->c->a`), not just a two-element swap.
       #
-      # THE FIX THIS COP POINTS AT — snapshot every old key's value
-      # FIRST, delete all old keys, THEN write all new keys, so no
+      # **The fix this cop points at** — snapshot every old key's value
+      # first, delete all old keys, then write all new keys, so no
       # rename in the pass ever reads a key this same pass has already
       # written:
       #
-      #   snapshot = renames.filter_map { |old_name, new_name| [old_name, new_name, state[old_name]] if state.key?(old_name) }
+      #   snapshot = renames.filter_map { |old_name, new_name| [old_name, new_name, state[old_name]]
+      #   if state.key?(old_name) }
       #   snapshot.each { |old_name, _new_name, _value| state.delete(old_name) }
       #   snapshot.each { |_old_name, new_name, value| state[new_name] = value }
       #
-      # WHAT THIS COP DOES NOT ATTEMPT — the general checklist item is
+      # **What this cop does not attempt** — the general checklist item is
       # broader than any AST pattern can safely automate ("any method
       # that both reads and writes the same collection across a loop"
       # covers plenty of correct code too — accumulating into a result
       # hash, memoizing into a cache). This cop stays narrow and
-      # precise: only the EXACT `recv[x] = recv.delete(y)` shape, same
+      # precise: only the exact `recv[x] = recv.delete(y)` shape, same
       # receiver both sides, inside something that iterates. A single
       # rename outside any loop is not this bug (nothing else can have
       # run first); `hash.store(...)` instead of `hash[...] =`, or
       # `hash.delete(...)` whose result is not immediately written back
-      # into the SAME hash, are not this shape either and are left to
+      # into the same hash, are not this shape either and are left to
       # the broader code-review checklist item, not this cop.
       #
       # @example
@@ -51,7 +52,8 @@ module RuboCop
       #   end
       #
       #   # good — snapshot first, then delete, then write: one permutation
-      #   snapshot = renames.filter_map { |old_name, new_name| [old_name, new_name, state[old_name]] if state.key?(old_name) }
+      #   snapshot = renames.filter_map { |old_name, new_name| [old_name, new_name, state[old_name]]
+      #   if state.key?(old_name) }
       #   snapshot.each { |old_name, _new_name, _value| state.delete(old_name) }
       #   snapshot.each { |_old_name, new_name, value| state[new_name] = value }
       class SequentialHashRenameInLoop < Base

data/lib/rubocop/cop/hecks/thread_shared_ivar_mutation.rb

@@ -1,7 +1,7 @@
 module RuboCop
   module Cop
     module Hecks
-      # FLAGS PLAIN `@ivar` MUTATION inside a class this codebase already
+      # Flags plain `@ivar` mutation inside a class this codebase already
       # knows is a thread-shared singleton — one `Dispatcher`/`Registry`
       # instance lives for the life of a boot and is dispatched through
       # from every thread of a Puma worker pool (or any other multi-
@@ -9,29 +9,29 @@ module RuboCop
       # shared, mutable state with no per-thread or mutex-guarded
       # isolation at all.
       #
-      # THIS IS THE MECHANICAL FOLLOW-UP to a real bug already fixed here
+      # This is the mechanical follow-up to a real bug already fixed here
       # (see `dispatcher.rb`'s own `#reenter` comment, and
       # `spec/runtime/dispatcher_spec.rb`): `@reaction_depth` used to be a
       # plain ivar on `Dispatcher`, so two threads' concurrent top-level
       # dispatches corrupted each other's view of "how deep into a
       # reaction cascade am I". The fix moved that one ivar to
       # `Thread.current[:hecks_reaction_depth]`. This cop exists so the
-      # NEXT plain ivar someone adds to either class gets flagged before
+      # next plain ivar someone adds to either class gets flagged before
       # it becomes the next instance of the same bug, rather than after.
       #
-      # SCOPED NARROWLY ON PURPOSE — by class name
+      # **Scoped narrowly on purpose** — by class name
       # (`Hecks::Runtime::Dispatcher`/`Hecks::Runtime::Registry`), not by
       # blanket-flagging every ivar mutation in the codebase. Most classes
-      # in this codebase are NOT shared across threads (a fresh value
+      # in this codebase are not shared across threads (a fresh value
       # object per call, a builder used once at boot) and ivar mutation
       # there is completely ordinary Ruby with no hazard behind it at
       # all — flagging it everywhere would be noise nobody trusts, the
       # same reasoning `.rubocop.yml`'s own header gives for every other
       # cop in this repo.
       #
-      # WHAT COUNTS AS "PLAIN": `@ivar = ...`, `@ivar ||= ...`, `@ivar +=
+      # What counts as "PLAIN": `@ivar = ...`, `@ivar ||= ...`, `@ivar +=
       # ...`, `@ivar << ...`, `@ivar[k] = v`. `initialize` is exempt — an
-      # ivar being SET UP for the first time, before any other thread can
+      # ivar being set up for the first time, before any other thread can
       # possibly hold a reference to this object, is not the hazard (see
       # `Registry#initialize`'s own `@saga_mutex = Mutex.new`, which this
       # cop must not flag). `Thread.current[...]`-backed state and a
@@ -68,8 +68,8 @@ module RuboCop
         RESTRICT_ON_SEND = [:<<, :[]=].freeze
 
         def on_ivasgn(node)
-          # A PLAIN `@x = 1` parses as `(ivasgn :@x (int 1))` — two
-          # children. The commissioner also visits the BARE `(ivasgn :@x)`
+          # A plain `@x = 1` parses as `(ivasgn :@x (int 1))` — two
+          # children. The commissioner also visits the bare `(ivasgn :@x)`
           # node nested one level inside an `op_asgn`/`or_asgn` (`@x += 1`,
           # `@x ||= 1`) as its own `ivasgn` node with only one child — that
           # one is handled by `on_op_asgn`/`on_or_asgn` below instead, so
@@ -81,7 +81,7 @@ module RuboCop
 
         def on_op_asgn(node)
           # `@x += 1` parses as `(op_asgn (ivasgn :@x) :+ (int 1))` — the
-          # target is an `ivasgn` node carrying JUST the name (no value
+          # target is an `ivasgn` node carrying just the name (no value
           # child, unlike a plain `@x = 1`), not an `ivar` node.
           ivar_node = node.children.first
           return unless ivar_node.is_a?(RuboCop::AST::Node) && ivar_node.ivasgn_type?
@@ -99,7 +99,7 @@ module RuboCop
           receiver = node.receiver
           return unless receiver
 
-          # `@ivar << x` — the receiver IS the ivar.
+          # `@ivar << x` — the receiver is the ivar.
           # `@ivar[k] = v` — the receiver is a `send(@ivar, :[], k)`, whose
           # own receiver is the ivar (`node.receiver.receiver`).
           ivar_node = if receiver.ivar_type?