hecks 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 288ec2962d96e6d9772c6fd6155d15461f69259cd7f69e107e308a2710fcb668
-  data.tar.gz: e71d1ec056df32604dc6ef8de8cab5069ae998faa74d89acd377d79b217820ed
+  metadata.gz: b6180e44456a48f89b02b8812b4f327fe1642f98756e8e4c0b1bb295a04f826b
+  data.tar.gz: 6bc10cd76fb9c112ce9d7a5b82295a2e2a4c101d1b10b195ab48cd1afefd75c7
 SHA512:
-  metadata.gz: a2586bb29d327f576976c7573236abfde1f60deba2eec7529b13ea34fc1b4ea917abe996fd44076cb76690835fb7089f4d18f38d0693d0aa14da2a106334a1a7
-  data.tar.gz: 1101c11307086a6df1833e6cd7b4fb5fdaa5b0d265b0a4569fa9d4df5d85f27039975f46135dd90619ad69e50d553172eb82d203633177595503f9bbfb67998a
+  metadata.gz: 56cfe2cebc08a7aac900d8ef700590aa66855ea0baf28eebb9096f0f74c4d51da5ef42167cffdc6f1bcc733c3cacf8e329bf1352821655247c36e17275614123
+  data.tar.gz: 37cc4287ecf68af46b507dff79b3041de0a6e28fe2a1a7e5d89bea393b74d5f84eead4e11509c0f16d47d11ec8abfe9b292d73ec14845d9466e086dcec3bf350

data/lib/hecks/bluebook/dsl/hecksagon_builder.rb

@@ -57,9 +57,12 @@ module Hecks
           end
         end
 
-        # The release that drops the deprecated spellings of `attaches`; independent of
-        # `Hecks::Doors::REMOVAL`, which covers the older `Facade` aliases.
-        REMOVAL = "3.4.0".freeze
+        # Spellings of `attaches` that 3.4.0 removed, each with the form that replaces it. They
+        # are refused by name so an old hecksagon fails loudly, never as a stray default bind.
+        REMOVED_WORDS = {
+          "uses_framework"           => ->(name) { "attaches #{name.to_s.inspect}" },
+          "uses_embryonaut_bluebook" => ->(name) { "attaches #{name.to_s.inspect}, from: :vendor" }
+        }.freeze
 
         attr_reader :binds, :subscriptions, :attachments
 
@@ -100,20 +103,6 @@ module Hecks
           from == :vendor ? attach_vendored(name) : attach_gem(name)
         end
 
-        # The deprecated spelling of `attaches "Name"` for a framework member.
-        def uses_framework(name)
-          deprecated_word("uses_framework", "attaches #{name.to_s.inspect}")
-          @attachments << Attachment.new(name: name.to_s, source: :gem)
-          self.class.with_real_modules { Hecks::Framework.load!(name) }
-          Hecks.current_registry&.mark_bounded(name.to_s)
-        end
-
-        # The deprecated spelling of `attaches "name", from: :vendor`.
-        def uses_embryonaut_bluebook(name)
-          deprecated_word("uses_embryonaut_bluebook", "attaches #{name.to_s.inspect}, from: :vendor")
-          attach_vendored(name)
-        end
-
         # Declares a port at the hecksagon's root — the chapter as a whole, not one aggregate.
         def port_impl(name, &block)
           bluebook_ir = Hecks.current_registry.bluebook(@domain) or
@@ -170,15 +159,11 @@ module Hecks
         end
         private :attach_vendored
 
-        # Tells the author that a word is going away.
-        def deprecated_word(word, instead)
-          warn "[hecks] `#{word}` is deprecated and is removed in #{REMOVAL}; use `#{instead}`"
-        end
-        private :deprecated_word
-
         # Records any verb the grammar doesn't own as a domain-wide default bind, e.g. bare
         # `persisted_by "Heki"` at the top of a block, applied unless an aggregate overrides it.
         def method_missing(verb, *args, **kwargs, &block)
+          refuse_removed_word(verb, args.first)
+
           # Grammar words (like `port`) get first refusal via explicit dispatch; only when that's
           # not admitted does the open-ended `persisted_by`-style bind vocabulary below apply.
           result = word_gate_dispatch(verb, args, kwargs, block)
@@ -191,6 +176,19 @@ module Hecks
           self
         end
 
+        # Raises for a word 3.4.0 removed, naming the spelling that replaces it.
+        #
+        # @param verb [Symbol] the word the hecksagon block called
+        # @param name [Object, nil] its first argument, echoed into the replacement
+        # @raise [Malformed] when the word is one of `REMOVED_WORDS`
+        def refuse_removed_word(verb, name)
+          instead = REMOVED_WORDS[verb.to_s]
+          return unless instead
+
+          raise Malformed, "`#{verb}` was removed in 3.4.0; use `#{instead.call(name)}`"
+        end
+        private :refuse_removed_word
+
         def respond_to_missing?(_name, _include_private = false) = true
 
         # Evaluates a `Hecks.hecksagon` block with bare `Domain::Aggregate` constants resolving to

data/lib/hecks/cli/interview_draft.rb

@@ -113,7 +113,7 @@ module Hecks
       # The aggregates, with their commands: the part a later interview offers to merge.
       # @api private
       def fragment(interview)
-        things = accepted(interview, :things)
+        things = accepted(interview, :things).uniq { |t| word(t[:name]) }
         actions = accepted(interview, :actions)
         placed = things.map { |t| word(t[:name]) }
         blocks = things.map { |thing| aggregate(interview, thing, actions) }
@@ -151,7 +151,7 @@ module Hecks
       def shape_of(interview, thing, actions)
         name = word(thing[:name])
         identifier = Naming.snake(word(thing[:identifier]))
-        mine = actions.select { |a| word(a[:thing]) == name }
+        mine = InterviewShape.merged_actions(actions.select { |a| word(a[:thing]) == name })
         steps = accepted(interview, :transitions).select { |s| word(s[:thing]) == name }
         found = accepted(interview, :fields).select { |f| word(f[:thing]) == name }
         type = identifier_type(name, identifier)

data/lib/hecks/cli/interview_shape.rb

@@ -121,6 +121,25 @@ module Hecks
          "    end", *loose.map { |step| loose_line(step) }]
       end
 
+      # One action for each name: an expert who refines an answer gets the same action accepted more
+      # than once, and a command can be declared only once. The first one's event and place in the
+      # interview stay; what each takes is joined, who does it is joined, and it creates if any did.
+      #
+      # @param actions [Array<Hash>] a thing's accepted actions
+      # @return [Array<Hash>] the actions, with each name once and in the order first accepted
+      def merged_actions(actions)
+        actions.group_by { |action| InterviewDraft.word(action[:name]) }.values.map do |group|
+          group.first.merge(creates: group.any? { |a| a[:creates] }, takes: joined(group, :takes, ", "),
+                            by: joined(group, :by, " or "))
+        end
+      end
+
+      # @api private
+      def joined(group, key, separator)
+        parts = group.flat_map { |a| a[key].to_s.split(separator == ", " ? /\s*,\s*/ : /\s+or\s+/) }
+        parts.map(&:strip).reject(&:empty?).uniq.join(separator)
+      end
+
       # @api private
       def field_row(finding, taken, identifier, lifecycle)
         field = Naming.snake(InterviewDraft.word(finding[:name]))

data/lib/hecks/corpus.rb

@@ -241,8 +241,7 @@ module Hecks
                               "of rust/src/generated, and there is no directory to fuzz")
     }.freeze
 
-    # Every place a Rust-facing domain's own `attaches` (or the deprecated `uses_framework` /
-    # `uses_embryonaut_bluebook`) attachment could be declared.
+    # Every place a Rust-facing domain's own `attaches` attachment could be declared.
     #
     # @param root [String] repository root to search under
     # @return [String] every reachable hecksagon file's own text, joined by newlines
@@ -310,11 +309,10 @@ module Hecks
 
     # The stamp hecks project_rust writes into metadata.rs, e.g.
     # `examples/pizzas` or `the self-hosted language (...)`, with any
-    # ` (attaches "X")`/` (attaches "x", from: :vendor)` suffix stripped (the deprecated
-    # `uses_framework` / `uses_embryonaut_bluebook` spellings too).
+    # ` (attaches "X")`/` (attaches "x", from: :vendor)` suffix stripped.
     SOURCE_STAMP = /
       GENERATED\ by\ hecks\ project_rust\ —\ (.+?)
-      (?:\ \((?:attaches|uses_framework|uses_embryonaut_bluebook)\ "\w+"(?:,\ from:\ :vendor)?\))?
+      (?:\ \(attaches\ "\w+"(?:,\ from:\ :vendor)?\))?
       's\ own\ canonical\ IR,
     /x
 

data/lib/hecks/doors.rb

@@ -1,23 +1,6 @@
 module Hecks
   # The class-free public surface, installed per boot by `Runtime::Loader.bind_runtime`.
   module Doors
-    # The removal release of the `Facade` and `install_facade:` spellings.
-    REMOVAL = "3.4.0".freeze
-
-    module_function
-
-    # Resolves the boot switch from the current keyword and its deprecated spelling.
-    #
-    # @param install_doors [Boolean] the `install_doors:` keyword
-    # @param install_facade [Boolean, nil] the deprecated `install_facade:` keyword; nil when
-    #   the caller did not pass it
-    # @return [Boolean] whether to install the Ruby door constants
-    def install?(install_doors, install_facade = nil)
-      return install_doors if install_facade.nil?
-
-      warn "[hecks] `install_facade:` is deprecated and is removed in #{REMOVAL}; use `install_doors:`"
-      install_facade
-    end
   end
 
   # Installs facade constants at top level, replacing only what it installed itself.

data/lib/hecks/fuzzing/isolated_boot.rb

@@ -12,9 +12,6 @@ module Hecks
       # A vendored package named by `attaches "name", from: :vendor`.
       VENDORED_ATTACHED = /attaches\s*\(?\s*"([\w-]+)"\s*\)?\s*,\s*from:\s*:vendor/
 
-      # A vendored package named by the deprecated `uses_embryonaut_bluebook "name"`.
-      VENDORED_DEPRECATED = /uses_embryonaut_bluebook\s*\(?\s*"([\w-]+)"/
-
       module_function
 
       # Copies `domain_path` to a tmpdir, rebinds its persistence to `adapter`, and
@@ -74,7 +71,7 @@ module Hecks
       def carry_vendored_bluebooks!(source, destination)
         names = Dir.glob(File.join(destination, "**", "*.hecksagon")).flat_map do |path|
           text = File.read(path)
-          (text.scan(VENDORED_DEPRECATED) + text.scan(VENDORED_ATTACHED)).flatten
+          text.scan(VENDORED_ATTACHED).flatten
         end
         names.uniq.each do |name|
           package = File.join(File.dirname(source), "vendor", "embryonaut_bluebooks", name)

data/lib/hecks/fuzzing/target_capabilities.rb

@@ -16,7 +16,7 @@ module Hecks
       POSTGRES_ERA_VARIABLE = /^\s*([a-z_]\w*)\s*=\s*"PostgresEra"\s*(?:#.*)?$/
 
       # Captures the member a hecksagon attaches; authorization is read off its declaration.
-      FRAMEWORK_ATTACHED = /(?:attaches|uses_framework)\s*\(?\s*"([^"]+)"/
+      FRAMEWORK_ATTACHED = /attaches\s*\(?\s*"([^"]+)"/
 
       # A command-level `role "..."`, the only construct a role check can compare a caller against.
       ROLE_GATED = /^\s*role\s+"/

data/lib/hecks/language/hecksagon/hecksagon.bluebook

@@ -83,9 +83,6 @@ Hecks.bluebook "Hecksagon" do
       member word: "hecksagon",       context: "File",     body: "keywords", inner: "Hecksagon",      opens: "Hecksagon",      fills: ""
       member word: "subscribe",       context: "Hecksagon", body: "none", inner: "", opens: "", fills: "subscriptions"
       member word: "attaches",        context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments"
-      # Deprecated spellings of `attaches`; they warn and are removed in 3.4.0.
-      member word: "uses_framework",  context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments", status: "deprecated"
-      member word: "uses_embryonaut_bluebook", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments", status: "deprecated"
       member word: "port",            context: "Hecksagon",     body: "keywords", inner: "DomainPort",    opens: "DomainPort",    fills: "", calls: "port_impl"
       # A cross-domain reaction wired here rather than in the bluebook; reuses the Policy context.
       # No `calls:` — HecksagonBuilder#translates is an ordinary method, found before `word_gate`.
@@ -116,8 +113,6 @@ Hecks.bluebook "Hecksagon" do
       member keyword: "subscribe",       context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "subscriptions"
       member keyword: "attaches",        context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments"
       member keyword: "attaches",        context: "Hecksagon", at: "",  named: "from", kind: "symbol", required: "false", fills: "source"
-      member keyword: "uses_framework",  context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments"
-      member keyword: "uses_embryonaut_bluebook", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments"
       member keyword: "port",            context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "name"
       member keyword: "translates",      context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "name"
 

data/lib/hecks/runtime/loader.rb

@@ -27,9 +27,9 @@ module Hecks
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the booted dispatcher
       # @raise [Errno::ENOENT] if `path` names no domain directory
       # @raise [Runtime::WiringError] if a boot gate finds a wiring problem
-      def self.boot(path, shared: nil, install_doors: true, install_facade: nil, environment: FROM_ENV)
+      def self.boot(path, shared: nil, install_doors: true, environment: FROM_ENV)
         described = describe(path, shared: shared, environment: environment)
-        boot_described(described, install_doors: install_doors, install_facade: install_facade)
+        boot_described(described, install_doors: install_doors)
       end
 
       # Finishes a boot from declarations `describe` already loaded: runs every boot gate and binds
@@ -37,16 +37,15 @@ module Hecks
       #
       # @param described [Described] what `describe` answered for the domain to boot
       # @param install_doors [Boolean] install the `Widget::Item.Add(...)` global facade sugar
-      # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the booted dispatcher
       # @raise [Runtime::WiringError] if a boot gate finds a wiring problem
-      def self.boot_described(described, install_doors: true, install_facade: nil)
+      def self.boot_described(described, install_doors: true)
         registry = described.registry
         run_boot_gates!(registry, described.directory)
         dispatcher = dispatcher_for(registry)
         redrive_outbox!(dispatcher)
         seed_privacy_markings!(dispatcher, registry)
-        Doors.install?(install_doors, install_facade) ? bind_runtime(dispatcher) : dispatcher
+        install_doors ? bind_runtime(dispatcher) : dispatcher
       end
 
       # What `describe` answers: the loaded declarations and nothing bound to run them.
@@ -153,7 +152,7 @@ module Hecks
       #   defaults to `HECKS_ENVIRONMENT`, and an explicit nil loads none
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the booted dispatcher
       # @raise [Runtime::WiringError] if a boot gate finds a wiring problem
-      def self.boot_files(paths, shared: nil, install_doors: true, install_facade: nil, environment: FROM_ENV)
+      def self.boot_files(paths, shared: nil, install_doors: true, environment: FROM_ENV)
         loading   = Ports::Loading.bootstrap
         files     = Array(paths).map { |path| File.expand_path(path) }
         directory = File.dirname(files.first)
@@ -168,7 +167,7 @@ module Hecks
 
         run_boot_gates!(registry, directory)
         dispatcher = dispatcher_for(registry)
-        Doors.install?(install_doors, install_facade) ? bind_runtime(dispatcher) : dispatcher
+        install_doors ? bind_runtime(dispatcher) : dispatcher
       end
 
       # Runs every registered boot gate against `registry`, in order:

data/lib/hecks/runtime.rb

@@ -43,13 +43,11 @@ module Hecks
       # @param path [String] path to a domain directory, or a file inside one
       # @param shared [String, nil] a shared-root override
       # @param install_doors [Boolean] whether to install the Ruby facade constants
-      # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
       # @param environment [String, nil] the environment name for `Adapters::Folder#load_domain`
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the dispatcher bound
       #   to the booted domain
-      def boot(path, shared: nil, install_doors: true, install_facade: nil, environment: Runtime::Loader::FROM_ENV)
-        Loader.boot(path, shared: shared, install_doors: install_doors, environment: environment,
-          install_facade: install_facade)
+      def boot(path, shared: nil, install_doors: true, environment: Runtime::Loader::FROM_ENV)
+        Loader.boot(path, shared: shared, install_doors: install_doors, environment: environment)
       end
 
       # Loads a domain's declarations without binding any adapter. See Loader.describe.
@@ -66,11 +64,10 @@ module Hecks
       #
       # @param described [Runtime::Loader::Described] what `describe` answered
       # @param install_doors [Boolean] whether to install the Ruby facade constants
-      # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the dispatcher bound
       #   to the booted domain
-      def boot_described(described, install_doors: true, install_facade: nil)
-        Loader.boot_described(described, install_doors: install_doors, install_facade: install_facade)
+      def boot_described(described, install_doors: true)
+        Loader.boot_described(described, install_doors: install_doors)
       end
 
       # Loads only the given files of a domain; otherwise like `boot`. See Loader.boot_files.
@@ -78,13 +75,11 @@ module Hecks
       # @param paths [String, Array<String>] one or more file paths within the domain
       # @param shared [String, nil] a shared-root override
       # @param install_doors [Boolean] whether to install the Ruby facade constants
-      # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
       # @param environment [String, nil] the environment name for the selected-file loader
       # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] the dispatcher bound
       #   to the booted domain
-      def boot_files(paths, shared: nil, install_doors: true, install_facade: nil, environment: Runtime::Loader::FROM_ENV)
-        Loader.boot_files(paths, shared: shared, install_doors: install_doors, environment: environment,
-          install_facade: install_facade)
+      def boot_files(paths, shared: nil, install_doors: true, environment: Runtime::Loader::FROM_ENV)
+        Loader.boot_files(paths, shared: shared, install_doors: install_doors, environment: environment)
       end
 
       # Bind the ambient registry for the duration of the block, restoring

data/lib/hecks/version.rb

@@ -1,5 +1,5 @@
 module Hecks
   # Read directly by the gemspec, so this file must never require the
   # rest of the gem (its dependencies aren't resolved yet at that point).
-  VERSION = "3.3.0".freeze
+  VERSION = "3.4.0".freeze
 end

data/lib/hecks.rb

@@ -13,7 +13,6 @@ require_relative "hecks/construct"
 require_relative "hecks/ir"
 require_relative "hecks/literal"
 require_relative "hecks/doors"
-require_relative "hecks/facade"
 require_relative "hecks/query_specification"
 
 require_relative "hecks/ports"
@@ -58,13 +57,11 @@ module Hecks
     # @param path [String] path to a domain directory, or a file inside one
     # @param shared [String, nil] a shared-root override; see `Runtime::Loader.boot`
     # @param install_doors [Boolean] install the `Widget::Item.Add`-style facade
-    # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
     # @param environment [String, nil] env name; its `.hecksagon`/`.world` overlay,
     #   if present, loads after the domain's own. Defaults to `HECKS_ENVIRONMENT`; nil loads none
     # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] dispatcher bound to the domain
-    def boot(path, shared: nil, install_doors: true, install_facade: nil, environment: Runtime::Loader::FROM_ENV)
-      Runtime.boot(path, shared: shared, install_doors: install_doors, environment: environment,
-        install_facade: install_facade)
+    def boot(path, shared: nil, install_doors: true, environment: Runtime::Loader::FROM_ENV)
+      Runtime.boot(path, shared: shared, install_doors: install_doors, environment: environment)
     end
 
     # Loads a domain's declarations without binding any adapter or opening any store.
@@ -82,10 +79,9 @@ module Hecks
     #
     # @param described [Runtime::Loader::Described] what `describe` answered
     # @param install_doors [Boolean] install the `Widget::Item.Add`-style facade
-    # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
     # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] dispatcher bound to the domain
-    def boot_described(described, install_doors: true, install_facade: nil)
-      Runtime.boot_described(described, install_doors: install_doors, install_facade: install_facade)
+    def boot_described(described, install_doors: true)
+      Runtime.boot_described(described, install_doors: install_doors)
     end
 
     # Boots a domain from an explicit list of files (a `.bluebook`, its
@@ -94,12 +90,10 @@ module Hecks
     # @param paths [String, Array<String>] one or more file paths within the domain
     # @param shared [String, nil] a shared-root override; see `Runtime::Loader.boot_files`
     # @param install_doors [Boolean] install the `Widget::Item.Add`-style facade
-    # @param install_facade [Boolean, nil] the deprecated spelling of `install_doors`; warns
     # @param environment [String, nil] environment name passed to the selected-file loader
     # @return [Runtime::Dispatcher, Runtime::RemoteDispatcher] dispatcher bound to the domain
-    def boot_files(paths, shared: nil, install_doors: true, install_facade: nil, environment: Runtime::Loader::FROM_ENV)
-      Runtime.boot_files(paths, shared: shared, install_doors: install_doors, environment: environment,
-        install_facade: install_facade)
+    def boot_files(paths, shared: nil, install_doors: true, environment: Runtime::Loader::FROM_ENV)
+      Runtime.boot_files(paths, shared: shared, install_doors: install_doors, environment: environment)
     end
 
     # Binds the ambient registry for the duration of the block.

data/rust/host/HECKS_RELEASE

@@ -1 +1 @@
-3.3.0
+3.4.0

data/rust/parser/src/keywords.rs

@@ -184,8 +184,6 @@ pub static KEYWORDS: &[KeywordRow] = &[
     KeywordRow { word: "hecksagon", context: "File", body: "keywords", inner: "Hecksagon", opens: "Hecksagon", fills: "", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
     KeywordRow { word: "subscribe", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "subscriptions", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
     KeywordRow { word: "attaches", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
-    KeywordRow { word: "uses_framework", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments", status: "deprecated", was: "", resolves_via: "", disambiguator: "" },
-    KeywordRow { word: "uses_embryonaut_bluebook", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "attachments", status: "deprecated", was: "", resolves_via: "", disambiguator: "" },
     KeywordRow { word: "port", context: "Hecksagon", body: "keywords", inner: "DomainPort", opens: "DomainPort", fills: "", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
     KeywordRow { word: "translates", context: "Hecksagon", body: "keywords", inner: "Policy", opens: "Policy", fills: "", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
     KeywordRow { word: "bounded", context: "Hecksagon", body: "none", inner: "", opens: "", fills: "", status: "admitted", was: "", resolves_via: "", disambiguator: "" },
@@ -470,8 +468,6 @@ pub static ARGUMENTS: &[ArgumentRow] = &[
     ArgumentRow { keyword: "subscribe", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "subscriptions", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
     ArgumentRow { keyword: "attaches", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
     ArgumentRow { keyword: "attaches", context: "Hecksagon", at: "", named: "from", kind: "symbol", required: "false", fills: "source", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
-    ArgumentRow { keyword: "uses_framework", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
-    ArgumentRow { keyword: "uses_embryonaut_bluebook", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "attachments", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
     ArgumentRow { keyword: "port", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "name", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
     ArgumentRow { keyword: "translates", context: "Hecksagon", at: "1", named: "", kind: "text", required: "true", fills: "name", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },
     ArgumentRow { keyword: "reference_to", context: "PortOperation", at: "1", named: "", kind: "constant", required: "true", fills: "type", selects: "", pair_key_fills: "", pair_value_fills: "", pairs_shape: "", status: "admitted", variadic: "", minimum: "" },

data/rust/parser/src/lex.rs

@@ -567,7 +567,7 @@ mod tests {
     #[test]
     fn does_not_strip_a_bare_lowercase_call() {
         assert_eq!(
-            strip_aggregate_receiver("uses_framework \"Governance\""),
+            strip_aggregate_receiver("attaches \"Governance\""),
             None
         );
         assert_eq!(strip_aggregate_receiver("subscribe \"Deposited\""), None);

data/rust/parser/src/parse/hecksagon.rs

@@ -14,9 +14,8 @@ pub fn not_implemented(file: &str, line: usize, word: &str) -> Diagnostic {
 /// Applies a `.hecksagon` body onto an already-built `ir::Bluebook`, attaching
 /// aggregate-scoped ports to the aggregates the sibling `.bluebook` registered.
 ///
-/// `gem_chapter_names` collects each `attaches "Name"` (and the deprecated `uses_framework`) and
-/// `vendored_bluebook_names` each `attaches "name", from: :vendor` (and the deprecated
-/// `uses_embryonaut_bluebook`), in file order, for `hecks-parse resolve`; `ir.json` itself
+/// `gem_chapter_names` collects each `attaches "Name"` and
+/// `vendored_bluebook_names` each `attaches "name", from: :vendor`, in file order, for `hecks-parse resolve`; `ir.json` itself
 /// carries neither.
 ///
 /// `require_matching_aggregate` is `false` for resolve, which never sees a `.bluebook`, so an
@@ -65,8 +64,20 @@ pub fn apply(
         if let LineShape::Call(call) = lex::classify(file, &line)? {
             if !matches!(
                 call.word.as_str(),
-                "port" | "subscribe" | "uses_framework" | "uses_embryonaut_bluebook" | "attaches" | "translates" | "bounded" | "end"
+                "port" | "subscribe" | "attaches" | "translates" | "bounded" | "end"
             ) {
+                let instead = match call.word.as_str() {
+                    "uses_framework" => Some("attaches \"Name\""),
+                    "uses_embryonaut_bluebook" => Some("attaches \"name\", from: :vendor"),
+                    _ => None,
+                };
+                if let Some(instead) = instead {
+                    return Err(Diagnostic::new(
+                        file,
+                        line.number,
+                        format!("`{}` was removed in 3.4.0; use `{instead}`", call.word),
+                    ));
+                }
                 *pos += 1;
                 if matches!(call.opener, Opener::DoBlock { .. }) {
                     skip_dropped_body(file, lines, pos)?;
@@ -98,26 +109,6 @@ pub fn apply(
                     let built = policy::parse_body(file, lines, pos, &name)?;
                     bluebook.policies.push(built);
                 }
-                // Deprecated spelling of `attaches "Name"`; gated, then collected.
-                "uses_framework" => {
-                    gem_chapter_names.push(super::positional_text(
-                        file,
-                        gated.line.number,
-                        "uses_framework",
-                        &gated.args,
-                        1,
-                    )?);
-                }
-                // Deprecated spelling of `attaches "name", from: :vendor`; collected the same way.
-                "uses_embryonaut_bluebook" => {
-                    vendored_bluebook_names.push(super::positional_text(
-                        file,
-                        gated.line.number,
-                        "uses_embryonaut_bluebook",
-                        &gated.args,
-                        1,
-                    )?);
-                }
                 "subscribe" => {}
                 // One word for a chapter the gem carries and for a vendored package; a binding
                 // fact collected for `resolve`, absent from `ir.json`. Only `from: :vendor`

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.0
 platform: ruby
 authors:
 - Chris Young
@@ -288,7 +288,6 @@ files:
 - lib/hecks/embryonaut_bluebook/vendor.rb
 - lib/hecks/embryonaut_bluebook/vendor_cli.rb
 - lib/hecks/engine_agreement.rb
-- lib/hecks/facade.rb
 - lib/hecks/forms.rb
 - lib/hecks/forms/app.rb
 - lib/hecks/forms/banking_presentation.rb

data/lib/hecks/facade.rb

@@ -1,31 +0,0 @@
-# The deprecated alias shim: `Hecks::Facade` is now `Hecks::Doors` and `Doors::Surface` is
-# `Doors::RubyDoor`. Both old constants still resolve and warn; they are removed in
-# `Hecks::Doors::REMOVAL`.
-require_relative "doors"
-
-# The root namespace; this file holds only the deprecated aliases.
-module Hecks
-  # Resolves the constants that now live in `Doors` under their old names, warning on each use.
-  #
-  # Extended onto `Hecks` and `Hecks::Doors`, ahead of `Module#const_missing`.
-  module DoorsAliases
-    # Old constant name mapped to the new one, per namespace that carried it.
-    RENAMED = { Hecks => { Facade: "Hecks::Doors" }, Hecks::Doors => { Surface: "Hecks::Doors::RubyDoor" } }.freeze
-
-    # Answers a renamed constant with its replacement and a warning; anything else
-    # goes to the next `const_missing`.
-    #
-    # @param name [Symbol] the missing constant
-    # @return [Module] the replacement module
-    def const_missing(name)
-      target = RENAMED.fetch(self, {})[name]
-      return super unless target
-
-      warn "[hecks] #{self}::#{name} is deprecated and is removed in #{Hecks::Doors::REMOVAL}; use #{target}"
-      Object.const_get(target)
-    end
-  end
-
-  extend DoorsAliases
-  Doors.extend(DoorsAliases)
-end