hecks 1.2.0 → 1.4.0

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?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Chris Young
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-09 00:00:00.000000000 Z
+date: 2026-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prism
@@ -83,6 +83,7 @@ files:
 - lib/hecks/adapters/driven/sqlite/schema_builder.rb
 - lib/hecks/adapters/driven/system_clock.adapter
 - lib/hecks/adapters/driven/system_clock.rb
+- lib/hecks/adapters/driving/github_webhook.rb
 - lib/hecks/behaviors.rb
 - lib/hecks/behaviors/dsl.rb
 - lib/hecks/behaviors/expectations.rb
@@ -113,6 +114,7 @@ files:
 - lib/hecks/bluebook/behaviour/read_model.rb
 - lib/hecks/bluebook/behaviour/traits.rb
 - lib/hecks/bluebook/behaviour/value_object.rb
+- lib/hecks/bluebook/capabilities.rb
 - lib/hecks/bluebook/chapter.rb
 - lib/hecks/bluebook/command.rb
 - lib/hecks/bluebook/domain_port.rb
@@ -124,6 +126,7 @@ files:
 - lib/hecks/bluebook/dsl/binding_proxy.rb
 - lib/hecks/bluebook/dsl/bluebook_builder.rb
 - lib/hecks/bluebook/dsl/bluebook_builder/validation.rb
+- lib/hecks/bluebook/dsl/bootstrap_table.rb
 - lib/hecks/bluebook/dsl/command_builder.rb
 - lib/hecks/bluebook/dsl/const_shim.rb
 - lib/hecks/bluebook/dsl/domain_port_builder.rb
@@ -181,10 +184,14 @@ files:
 - lib/hecks/bluebook/translation.rb
 - lib/hecks/bluebook/value_object.rb
 - lib/hecks/codemod.rb
+- lib/hecks/codemod/legacy_dispatch_args.rb
+- lib/hecks/codemod/legacy_dispatch_recorder.rb
 - lib/hecks/construct.rb
+- lib/hecks/corpus.rb
 - lib/hecks/deploy/bluebook/deploy.bluebook
 - lib/hecks/deploy/bluebook/deploy.hecksagon
 - lib/hecks/deploy/oidc.json
+- lib/hecks/deprecation.rb
 - lib/hecks/doc/reference.rb
 - lib/hecks/embryonaut_bluebook.rb
 - lib/hecks/facade.rb
@@ -223,20 +230,41 @@ files:
 - lib/hecks/freezer.rb
 - lib/hecks/fuzzing.rb
 - lib/hecks/fuzzing/bounded_exhaustive_expressions.rb
+- lib/hecks/fuzzing/combination_miner.rb
+- lib/hecks/fuzzing/concurrent_dispatch.rb
+- lib/hecks/fuzzing/coverage_campaign.rb
+- lib/hecks/fuzzing/differential.rb
+- lib/hecks/fuzzing/domain_generator.rb
+- lib/hecks/fuzzing/era_boundary.rb
+- lib/hecks/fuzzing/form_census.rb
+- lib/hecks/fuzzing/generated_domain_check.rb
 - lib/hecks/fuzzing/invalid_value_generator.rb
 - lib/hecks/fuzzing/isolated_boot.rb
+- lib/hecks/fuzzing/nondeterministic.rb
+- lib/hecks/fuzzing/persistence_parity.rb
 - lib/hecks/fuzzing/properties.rb
+- lib/hecks/fuzzing/properties/corrections.rb
 - lib/hecks/fuzzing/properties/dispatch_and_mutations.rb
 - lib/hecks/fuzzing/properties/guards.rb
 - lib/hecks/fuzzing/properties/invariants_and_aggregation.rb
 - lib/hecks/fuzzing/properties/lifecycle_and_replay.rb
+- lib/hecks/fuzzing/properties/outbox.rb
 - lib/hecks/fuzzing/properties/querying.rb
+- lib/hecks/fuzzing/qa_settings.rb
 - lib/hecks/fuzzing/replay.rb
+- lib/hecks/fuzzing/rotation_priority.rb
+- lib/hecks/fuzzing/rust_gap_manifest.rb
+- lib/hecks/fuzzing/self_consistency.rb
 - lib/hecks/fuzzing/sequence_generator.rb
+- lib/hecks/fuzzing/sequence_generator/adversary.rb
 - lib/hecks/fuzzing/sequence_generator/catalog.rb
 - lib/hecks/fuzzing/sequence_generator/outcome_tracker.rb
 - lib/hecks/fuzzing/sequence_generator/picker.rb
 - lib/hecks/fuzzing/sequence_generator/step_builder.rb
+- lib/hecks/fuzzing/shrinker.rb
+- lib/hecks/fuzzing/structural_skips.rb
+- lib/hecks/fuzzing/sweep_depth.rb
+- lib/hecks/fuzzing/target_capabilities.rb
 - lib/hecks/fuzzing/value_generator.rb
 - lib/hecks/grammar.rb
 - lib/hecks/grammar/evolve.rb
@@ -298,6 +326,7 @@ files:
 - lib/hecks/ports/persistence.rb
 - lib/hecks/ports/persistence/append_only.rb
 - lib/hecks/ports/persistence/binding_policy.rb
+- lib/hecks/ports/persistence/codec_boundary.rb
 - lib/hecks/ports/persistence/execution.rb
 - lib/hecks/ports/persistence/null_saga_store.rb
 - lib/hecks/ports/persistence/plugin.rb
@@ -337,20 +366,30 @@ files:
 - lib/hecks/ports/persistence/plugins/era/translation/scaffold/writer.rb
 - lib/hecks/ports/persistence/remote_runtime.rb
 - lib/hecks/ports/persistence/repository_factory.rb
+- lib/hecks/ports/persistence/state_codec.rb
 - lib/hecks/ports/projection.port
 - lib/hecks/ports/projection.rb
 - lib/hecks/ports/query.rb
 - lib/hecks/ports/query/in_memory.rb
 - lib/hecks/ports/query/ordering.rb
 - lib/hecks/projections.rb
+- lib/hecks/projections/bootstrap_table.rb
 - lib/hecks/projections/diagrams.rb
 - lib/hecks/projections/glossary.rb
+- lib/hecks/projections/glossary/html.rb
+- lib/hecks/projections/glossary/markdown.rb
+- lib/hecks/projections/glossary/mermaid.rb
+- lib/hecks/projections/glossary/page.css
+- lib/hecks/projections/glossary/page.js
+- lib/hecks/projections/glossary/sections.rb
+- lib/hecks/projections/glossary/sentences.rb
 - lib/hecks/projections/ir.rb
 - lib/hecks/projections/model.rb
 - lib/hecks/projections/model/deviations.rb
 - lib/hecks/projections/oidc.rb
 - lib/hecks/projections/parser_table.rb
 - lib/hecks/projections/reference.rb
+- lib/hecks/projections/rust_vocabulary.rb
 - lib/hecks/projections/shape.rb
 - lib/hecks/projections/statements.rb
 - lib/hecks/projections/vocabulary.rb
@@ -406,6 +445,7 @@ files:
 - lib/hecks/runtime/identity.rb
 - lib/hecks/runtime/instance.rb
 - lib/hecks/runtime/interpreting.rb
+- lib/hecks/runtime/invocation.rb
 - lib/hecks/runtime/loader.rb
 - lib/hecks/runtime/outbox.rb
 - lib/hecks/runtime/policy_interpreter.rb
@@ -429,6 +469,7 @@ files:
 - lib/hecks/runtime/value.rb
 - lib/hecks/runtime/value/admission.rb
 - lib/hecks/runtime/value/coercion.rb
+- lib/hecks/runtime/value/entity_list_coercion.rb
 - lib/hecks/runtime/value/invariant_violation.rb
 - lib/hecks/storehouse.rb
 - lib/hecks/version.rb