hecks 5.0.0 → 6.0.0

data/lib/hecks/hecks/translations/2-148748.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "f53248", to: "148748" do
+end

data/lib/hecks/hecks/translations/2-15a2e4.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Bluebook", from: "eea577", to: "15a2e4" do
+end

data/lib/hecks/hecks/translations/2-1b447c.bluebook

@@ -0,0 +1,5 @@
+Hecks.data_translation "Bluebook", from: "bfdb48", to: "1b447c" do
+  aggregate "Bluebook" do
+    retype "ChapterNamespace", to: "BluebookNamespace"
+  end
+end

data/lib/hecks/hecks/translations/2-240474.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "d43f71", to: "240474" do
+end

data/lib/hecks/hecks/translations/2-44446d.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "98d983", to: "44446d" do
+end

data/lib/hecks/hecks/translations/2-46ca26.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Bluebook", from: "15a2e4", to: "46ca26" do
+end

data/lib/hecks/hecks/translations/2-473eab.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "fbb677", to: "473eab" do
+end

data/lib/hecks/hecks/translations/2-75cc28.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Adapter", from: "b9a18b", to: "75cc28" do
+end

data/lib/hecks/hecks/translations/2-781c07.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "84c18b", to: "781c07" do
+end

data/lib/hecks/hecks/translations/2-84c18b.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "44446d", to: "84c18b" do
+end

data/lib/hecks/hecks/translations/2-aa5fff.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "148748", to: "aa5fff" do
+end

data/lib/hecks/hecks/translations/2-bfdb48.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Bluebook", from: "46ca26", to: "bfdb48" do
+end

data/lib/hecks/hecks/translations/2-cd96d8.bluebook

@@ -0,0 +1,10 @@
+# An Adr's `settles` was a one-field value object, {"value": "<finding>"}; it is now a reference to
+# the Finding, stored as the finding's bare key. `derive` reads the key out of the old object, and an
+# Adr that settles nothing keeps its null. The derive only writes the new `settles`; `drop` names the
+# old `settles.value` path as the source it replaces, which the era diff needs to see explained.
+Hecks.data_translation "Tickets", from: "556197", to: "cd96d8" do
+  aggregate "Adr" do
+    derive :settles, as: "settles.value"
+    drop "settles.value"
+  end
+end

data/lib/hecks/hecks/translations/2-d43f71.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "473eab", to: "d43f71" do
+end

data/lib/hecks/hecks/translations/2-eea577.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Bluebook", from: "ad9d9b", to: "eea577" do
+end

data/lib/hecks/hecks/translations/2-f53248.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "781c07", to: "f53248" do
+end

data/lib/hecks/hecks/translations/2-fbb677.bluebook

@@ -0,0 +1,2 @@
+Hecks.data_translation "Hecks", from: "aa5fff", to: "fbb677" do
+end

data/lib/hecks/hecks/translations/2-ffdf12.bluebook

@@ -0,0 +1,6 @@
+Hecks.data_translation "Composer", from: "6f042b", to: "ffdf12" do
+  aggregate "Draft" do
+    rename "chapter_name", to: "bluebook_name"
+    retype "ChapterName", to: "BluebookName"
+  end
+end

data/lib/hecks/ir.rb

@@ -30,6 +30,10 @@ module Hecks
     # A field that holds one construct, or nil.
     One  = Struct.new(:source)
 
+    # What a `Proc` rule answers to leave its key out of the emitted Hash, for a field that exists
+    # only when the declaration said something, so a construct that never says it emits as it did.
+    OMIT = Object.new.freeze
+
     # The declaration side: `emits_ir`, `many`, `one`, and `ir_spec` to read the shape back.
     module Declares
       # Records this construct's field -> emission-rule map.
@@ -70,7 +74,10 @@ module Hecks
         spec = ir_spec_for(self)
         raise Undeclared, "#{self} emits IR but never declared its shape with emits_ir" unless spec
 
-        spec.to_h { |key, rule| [key, emit(rule)] }
+        spec.each_with_object({}) do |(key, rule), emitted|
+          value = emit(rule)
+          emitted[key] = value unless value.equal?(OMIT)
+        end
       end
 
       private

data/lib/hecks/kernel_capabilities/templates.rb

@@ -15,7 +15,7 @@ module Hecks
 
         /// One variant per real %<kind>s the Ruby
         /// grammar admits, in the order %<doc_line>s declares them. Every match
-        /// over this enum in the kernel (rust/src/kernel/expr.rs) is written
+        /// over this enum in the kernel (rust/expr/src/expr.rs) is written
         /// WITHOUT a wildcard `_ =>` arm — see expr.rs's own header for why:
         /// a wildcard here would let a newly-admitted capability compile
         /// silently into a router that never calls the new file this same
@@ -26,7 +26,7 @@ module Hecks
         }
 
         impl %<enum_name>s {
-            /// The `rust/src/kernel/%<directory>s/<name>.rs` file this
+            /// The `rust/expr/src/%<directory>s/<name>.rs` file this
             /// variant names — `hecks measure_kernel_coverage`'s own existence
             /// check reads this, so the file-name spelling here is the ONE
             /// place that ever needs to change if a name is renamed.
@@ -85,7 +85,8 @@ module Hecks
       # @param name [String, Symbol] a snake_case capability name
       # @return [String] the PascalCase Rust variant
       def pascal(name)
-        name.to_s.split("_").map { |part| part[0].upcase + part[1..] }.join
+        parts = name.to_s.split("_")
+        parts.map { |part| part[0].upcase + part[1..] }.join
       end
     end
   end

data/lib/hecks/kernel_capabilities.rb

@@ -7,8 +7,8 @@ module Hecks
   # The capability enums the hand-written Rust kernel is matched against, and the check that every
   # capability the Ruby grammar admits has its hand-written file.
   #
-  # The `pub mod` roster and the enum of `rust/src/kernel/attribute_shapes/mod.rs` and
-  # `rust/src/kernel/expression_operators/mod.rs` are generated; the `<name>.rs` files beside them
+  # The `pub mod` roster and the enum of `rust/expr/src/attribute_shapes/mod.rs` and
+  # `rust/expr/src/expression_operators/mod.rs` are generated; the `<name>.rs` files beside them
   # are hand-written, so a grammar change can leave a `pub mod` naming a file nobody has written.
   # Ground truth is `Coercion::SHAPES` and `Grammar.admitted_operators`, never a copied list.
   # Query comparators are one flat hand-maintained file with no per-variant files to check.
@@ -37,7 +37,7 @@ module Hecks
       require "hecks"
       require "hecks/grammar"
       require "hecks/runtime/value/coercion"
-      kernel = File.join(root, "rust/src/kernel")
+      kernel = File.join(root, "rust/expr/src")
       content = {
         File.join(kernel, "attribute_shapes/mod.rs")     => shapes_module,
         File.join(kernel, "expression_operators/mod.rs") => operators_module
@@ -100,7 +100,7 @@ module Hecks
     # @return [String] the clean verdict
     def coverage_verdict(count)
       "#{count}/#{count} kernel capability files present — every attribute shape and " \
-        "expression-operator category the live Ruby grammar admits has a rust/src/kernel/ file " \
+        "expression-operator category the live Ruby grammar admits has a rust/expr/src/ file " \
         "at its conventional path."
     end
 
@@ -113,13 +113,13 @@ module Hecks
     end
 
     # @param root [String] the checkout
-    # @param category_dir [String] the directory below `rust/src/kernel/`
+    # @param category_dir [String] the directory below `rust/expr/src/`
     # @param names [Array<String>] the capabilities to look for
     # @param source [String] where they are declared
     # @return [Array<Row>] a row for each
     def check(root, category_dir, names, source)
       names.map do |name|
-        path = File.join(root, "rust/src/kernel", category_dir, "#{name}.rs")
+        path = File.join(root, "rust/expr/src", category_dir, "#{name}.rs")
         Row.new(name, path, File.file?(path), source)
       end
     end

data/lib/hecks/language/adapter.bluebook

@@ -10,6 +10,17 @@ Hecks.bluebook "Adapter" do
     attribute :port,    AdapterPortName
     attribute :fields,  list_of(AdapterField)
     attribute :secrets, list_of(AdapterField)
+    attribute :answers, list_of(AnsweredQuery)
+    attribute :runs,    PluginModule, optional: true
+    # What this adapter can do beyond its port's contract, such as `set_transform`. Absent is
+    # not empty: most adapters provide nothing more.
+    attribute :provides, list_of(AdapterCapability)
+
+    # **A plugin answers named queries** — one that `runs` a wasm module says which queries it
+    # answers, each qualified by bluebook and aggregate, and the runtime binds them to it.
+    invariant("only a plugin answers queries") do
+      answers.unset? || answers.size == 0 || !runs.unset?
+    end
 
     value_object "AdapterName" do
       attribute :value, String
@@ -27,6 +38,21 @@ Hecks.bluebook "Adapter" do
       invariant("a field names itself") { !value.to_s.empty? }
     end
 
+    # A query a plugin answers, written in full: `Calendar::Event.Occurrences`.
+    value_object "AnsweredQuery" do
+      attribute :value, String, matches: :command_ref
+    end
+
+    # A capability an adapter provides, named in snake case: `set_transform`.
+    value_object "AdapterCapability" do
+      attribute :value, String, matches: :snake_name
+    end
+
+    # The wasm module a plugin runs: a file beside its `.adapter`, never a path out of it.
+    value_object "PluginModule" do
+      attribute :value, String, pattern: '^[a-z0-9_-]+\.wasm$'
+    end
+
     # The text of a field's declared default, such as `"data"` or `true`. A `{name}` in a string
     # is filled from the aggregate the adapter is built for, so it names only what the framework
     # can supply.
@@ -41,9 +67,12 @@ Hecks.bluebook "Adapter" do
       attribute :name, AdapterName
       # Optional: an adapter may declare only fields or secrets and never name a port.
       attribute :port, AdapterPortName, optional: true
+      # Optional: only a plugin runs a wasm module.
+      attribute :runs, PluginModule, optional: true
 
       sets :name
       sets :port
+      sets :runs
 
       emits "AdapterDeclared"
     end
@@ -73,6 +102,30 @@ Hecks.bluebook "Adapter" do
       emits "AdapterSecretAdded"
     end
 
+    command "AnswerQuery" do
+      role "Deployment"
+      goal "Name a query this plugin answers, so the runtime binds it without a hecksagon line"
+
+      reference_to Adapter
+      attribute :value, AnsweredQuery
+
+      sets :answers, append: { value: :value }
+
+      emits "AdapterQueryAnswered"
+    end
+
+    command "Provide" do
+      role "Deployment"
+      goal "Name a capability this adapter provides, so the runtime can ask for it before relying on it"
+
+      reference_to Adapter
+      attribute :value, AdapterCapability
+
+      sets :provides, append: { value: :value }
+
+      emits "AdapterCapabilityProvided"
+    end
+
     # Grammar rows for the `adapter` keyword; SyntaxBoot discovers aggregate-local seed tables.
     value_object "KeywordSeed" do
       attribute :word,          String
@@ -90,7 +143,11 @@ Hecks.bluebook "Adapter" do
       member word: "port",            context: "Adapter",   body: "none", inner: "", opens: "", fills: "port"
       member word: "field",           context: "Adapter",   body: "none", inner: "", opens: "", fills: "fields"
       member word: "secret",          context: "Adapter",   body: "none", inner: "", opens: "", fills: "secrets"
+      member word: "answers_query",   context: "Adapter",   body: "none", inner: "", opens: "", fills: "answers"
+      member word: "runs",            context: "Adapter",   body: "none", inner: "", opens: "", fills: "runs"
 
+
+      member word: "provides", context: "Adapter", body: "none", inner: "", opens: "", fills: "provides"
     end
 
     value_object "ArgumentSeed" do
@@ -115,7 +172,11 @@ Hecks.bluebook "Adapter" do
       member keyword: "field",           context: "Adapter", at: "1", named: "", kind: "symbol", required: "true", fills: "fields"
       member keyword: "field",           context: "Adapter", at: "",  named: "default", kind: "literal", required: "false", fills: "default"
       member keyword: "secret",          context: "Adapter", at: "1", named: "", kind: "symbol", required: "true", fills: "secrets"
+      member keyword: "answers_query",   context: "Adapter", at: "1", named: "", kind: "text",   required: "true", fills: "answers"
+      member keyword: "runs",            context: "Adapter", at: "1", named: "", kind: "text",   required: "true", fills: "runs"
+
 
+      member keyword: "provides", context: "Adapter", at: "1", named: "", kind: "text", required: "true", fills: "provides"
     end
   end
 end

data/lib/hecks/language/bluebook/aggregate.bluebook

@@ -1,10 +1,10 @@
 Hecks.bluebook "Bluebook" do
   aggregate "Aggregate" do
-    description "One aggregate inside a chapter — the head a domain's declarations attach to."
+    description "One aggregate inside a bluebook — the head a domain's declarations attach to."
 
     reference_to Bluebook
 
-    # The chapter is part of the identity: two chapters may each declare an `Order`.
+    # The bluebook is part of the identity: two bluebooks may each declare an `Order`.
     identified_by :bluebook, :name
 
     attribute :name,          AggregateName
@@ -29,6 +29,8 @@ Hecks.bluebook "Bluebook" do
     # A field read through a reference and held locally (`projects :name, from: :"ref.field"`).
     # Kept out of `attributes`; see `projected_fields:` in `Aggregate#emits_ir` (ADR 0025).
     attribute :projected_fields, list_of(ProjectedField)
+    # A finding model_check would report, allowed with the reason it is allowed (ADR 0150).
+    attribute :acknowledgements, list_of(Acknowledgement)
 
     value_object "AggregateName" do
       attribute :value, String
@@ -96,9 +98,17 @@ Hecks.bluebook "Bluebook" do
       attribute :remote_field, String
     end
 
+    # `finding` names the kind of finding; `reason` is the text that says why it is allowed;
+    # `subject` names the attribute or referenced aggregate a finding reported once per subject is for.
+    value_object "Acknowledgement" do
+      attribute :finding, String
+      attribute :subject, String, optional: true
+      attribute :reason,  String
+    end
+
     command "Declare" do
       role "Language"
-      goal "Open an aggregate inside a chapter"
+      goal "Open an aggregate inside a bluebook"
 
       reference_to Bluebook
       attribute :name,          AggregateName
@@ -139,7 +149,7 @@ Hecks.bluebook "Bluebook" do
 
     attribute :position, Position
 
-    # The aggregates declared in a chapter; the parent reference is the query.
+    # The aggregates declared in a bluebook; the parent reference is the query.
     query "DeclaredIn" do
       attribute :bluebook, IdentityField
       where(bluebook: :bluebook)
@@ -210,7 +220,7 @@ Hecks.bluebook "Bluebook" do
 
       sets :attributes, append: { name: :name, type: :holds, list: :list, default: :default, optional: :optional, pattern: :pattern, admits: :admits, relationship: :relationship }
 
-      emits PieceHeld
+      emits PieceOptionDeclared
     end
 
     # The only rule that refuses an unnamed attribute. A `given` beside it could never fire:
@@ -332,8 +342,24 @@ Hecks.bluebook "Bluebook" do
       emits PreconditionAttached
     end
 
+    # Allows one finding about this aggregate, with its reason.
+    command "Acknowledges" do
+      role "Language"
+      goal "Allow a finding on the aggregate that means what it says"
+
+      attribute :finding, FieldName
+      attribute :reason,  Description
+      attribute :subject, FieldName, optional: true
+
+      given("an acknowledged finding is named") { !finding.value.to_s.empty? }
+
+      sets :acknowledgements, append: { finding: :finding, subject: :subject, reason: :reason }
+
+      emits AcknowledgementAttached
+    end
+
     # The local half of a cross-aggregate read. The target is checked in
-    # `BluebookBuilder#validate_projected_fields!` once every aggregate in the chapter exists.
+    # `BluebookBuilder#validate_projected_fields!` once every aggregate in the bluebook exists.
     command "Projects" do
       role "Language"
       goal "Declare a field read locally through a reference"
@@ -384,6 +410,7 @@ Hecks.bluebook "Bluebook" do
       member word: "attribute",       context: "Aggregate", body: "none",     inner: "",              opens: "",               fills: "attributes", calls: "attribute_impl"
       member word: "invariant",       context: "Aggregate", body: "source",   inner: "",              opens: "",               fills: "invariants", calls: "invariant_impl"
       member word: "given",           context: "Aggregate", body: "source",   inner: "",              opens: "",               fills: "preconditions", resolves_via: "owner_keyed", disambiguator: "declared_by", calls: "given_impl"
+      member word: "acknowledges",    context: "Aggregate", body: "none",     inner: "",              opens: "",               fills: "acknowledgements", calls: "acknowledges_impl"
       member word: "projects",        context: "Aggregate", body: "none",     inner: "",              opens: "",               fills: "projected_fields", calls: "projects_impl"
       member word: "transition",      context: "Lifecycle", body: "none", inner: "", opens: "",       fills: "transitions", calls: "transition_impl"
       member word: "mark",            context: "Lifecycle", body: "none", inner: "", opens: "",       fills: "marks", calls: "mark_impl"
@@ -446,6 +473,9 @@ Hecks.bluebook "Bluebook" do
       member keyword: "invariant",       context: "Aggregate", at: "1", named: "",         kind: "text",     required: "true",  fills: "description"
       member keyword: "given",           context: "Aggregate", at: "1", named: "",         kind: "text",     required: "true",  fills: "description"
       member keyword: "given",           context: "Aggregate", at: "",  named: "declared_by", kind: "constant", required: "false", fills: "declared_by"
+      member keyword: "acknowledges",    context: "Aggregate", at: "1", named: "",         kind: "symbol",   required: "true",  fills: "finding"
+      member keyword: "acknowledges",    context: "Aggregate", at: "2", named: "",         kind: "text",     required: "true",  fills: "reason", coerce: "false"
+      member keyword: "acknowledges",    context: "Aggregate", at: "",  named: "of",       kind: "symbol",   required: "false", fills: "subject"
       member keyword: "projects",        context: "Aggregate", at: "1", named: "",         kind: "symbol",   required: "true",  fills: "name"
       member keyword: "projects",        context: "Aggregate", at: "",  named: "from",     kind: "symbol",   required: "true",  fills: "from"
       member keyword: "transition",      context: "Lifecycle", at: "1", named: "",     kind: "pairs", required: "true",  fills: "", pair_key_fills: "command", pair_value_fills: "to_state", pairs_shape: "fields"

data/lib/hecks/language/bluebook/attaches/paging.bluebook

@@ -1,5 +1,5 @@
 Hecks.bluebook "Paging" do
-  vision "The four words a page of results is read through — limit, offset, cursor, nulls — held as their own sub-language rather than as four more rows in the core's own grammar table. ADR 0026's own worked example: the core grammar does not name its extension points, so this chapter names ITSELF onto them, with `attaches_to`."
+  vision "The four words a page of results is read through — limit, offset, cursor, nulls — held as their own sub-language rather than as four more rows in the core's own grammar table. ADR 0026's own worked example: the core grammar does not name its extension points, so this bluebook names ITSELF onto them, with `attaches_to`."
   generic
   attaches_to "Query", "ReadModel"
 

data/lib/hecks/language/bluebook/bluebook.behaviors

@@ -1,23 +1,23 @@
 Hecks.behaviors "Bluebook" do
-  vision "A chapter is opened with a name, a vision and a classification, and refuses a classification the language does not admit."
+  vision "A bluebook is opened with a name, a vision and a classification, and refuses a classification the language does not admit."
 
   loads "bluebook.bluebook", "bluebook.hecksagon"
 
-  test "Declare opens a chapter" do
+  test "Declare opens a bluebook" do
     tests "Declare", on: "Bluebook"
     input name: "Pizzas", vision: "Pizzas, built and sold.", classification: "core"
-    expect emits: ["ChapterDeclared"]
+    expect emits: ["BluebookDeclared"]
   end
 
   test "Declare refuses a classification that is not core, supporting or generic" do
     tests "Declare", on: "Bluebook"
     input name: "Pizzas", vision: "Pizzas, built and sold.", classification: "huge"
-    expect refused: "a chapter is core, supporting, or generic"
+    expect refused: "a bluebook is core, supporting, or generic"
   end
 
-  test "Declare refuses a chapter with no name" do
+  test "Declare refuses a bluebook with no name" do
     tests "Declare", on: "Bluebook"
     input name: "", vision: "Pizzas, built and sold.", classification: "core"
-    expect refused: "a chapter is named"
+    expect refused: "a bluebook is named"
   end
 end

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

@@ -2,9 +2,9 @@ Hecks.bluebook "Bluebook", version: "1" do
   vision "The bluebook language, declared in itself. Loading a domain becomes dispatching commands into this meta-domain ; the IR it stores must equal the IR the DSL builder produces. The floor that stays hand-written is the interpreter — evaluating a predicate held as data — and IO."
   core
 
-  # A whole bluebook in one read: every declaration gathered around the chapter itself.
+  # A whole bluebook in one read: every declaration gathered around the bluebook itself.
   read_model "WholeBluebook" do
-    description "Every declaration of one chapter, gathered around the chapter itself — the way back, in a single read."
+    description "Every declaration of one bluebook, gathered around the bluebook itself — the way back, in a single read."
     reference_to Bluebook
 
     include Bluebook
@@ -24,22 +24,22 @@ Hecks.bluebook "Bluebook", version: "1" do
   aggregate "Bluebook" do
     description "One .bluebook file — the root a domain declaration hangs from."
 
-    # A chapter is identified by its name; commands reach it through the `bluebook_id` reference.
+    # A bluebook is identified by its name; commands reach it through the `bluebook_id` reference.
     identified_by BluebookName, as: :name
 
     attribute :vision,         Vision
     attribute :classification, Classification
-    # Contract version pinned per chapter, e.g. `version: "v2"`. Absent is not empty.
+    # Contract version pinned per bluebook, e.g. `version: "v2"`. Absent is not empty.
     attribute :version,        Version
     # A rename is a declared fact. Absent is not empty.
     attribute :formerly_known_as, FormerlyKnownAs
-    attribute :namespace, ChapterNamespace
+    attribute :namespace, BluebookNamespace
     attribute :normalisations, list_of(NormalisationRule)
-    # Core contexts a sub-language chapter contributes Syntax rows for (ADR 0026).
-    # Absent is not empty: most chapters attach to nothing.
+    # Core contexts a sub-language bluebook contributes Syntax rows for (ADR 0026).
+    # Absent is not empty: most bluebooks attach to nothing.
     attribute :attaches_to, list_of(AttachesToContext)
-    # Capabilities this chapter answers for other domains, one row per (capability, key, verb).
-    # Absent is not empty: most chapters provide nothing.
+    # Capabilities this bluebook answers for other domains, one row per (capability, key, verb).
+    # Absent is not empty: most bluebooks provide nothing.
     attribute :provides, list_of(Provision)
 
     value_object "Provision" do
@@ -68,7 +68,7 @@ Hecks.bluebook "Bluebook", version: "1" do
 
     value_object "BluebookName" do
       attribute :value, String
-      invariant("a chapter is named") { !value.to_s.empty? }
+      invariant("a bluebook is named") { !value.to_s.empty? }
     end
 
     value_object "Vision" do
@@ -78,7 +78,7 @@ Hecks.bluebook "Bluebook", version: "1" do
 
     value_object "Classification" do
       attribute :value, String
-      invariant("a chapter is core, supporting, or generic") do
+      invariant("a bluebook is core, supporting, or generic") do
         value.to_s == "core" || value.to_s == "supporting" || value.to_s == "generic"
       end
     end
@@ -93,8 +93,8 @@ Hecks.bluebook "Bluebook", version: "1" do
       invariant("a formerly_known_as says something") { !value.to_s.empty? }
     end
 
-    # The Ruby module a chapter's constants install under instead of its own name.
-    value_object "ChapterNamespace" do
+    # The Ruby module a bluebook's constants install under instead of its own name.
+    value_object "BluebookNamespace" do
       attribute :value, String
       invariant("a namespace is a constant path") { value.to_s.match?(/\A[A-Z][A-Za-z0-9_]*(::[A-Z][A-Za-z0-9_]*)*\z/) }
     end
@@ -106,14 +106,14 @@ Hecks.bluebook "Bluebook", version: "1" do
 
     command "Declare" do
       role "Language"
-      goal "Open a chapter"
+      goal "Open a bluebook"
 
       attribute :name,           BluebookName
       attribute :vision,         Vision, optional: true
       attribute :classification, Classification, optional: true
       attribute :version,        Version, optional: true
       attribute :formerly_known_as, FormerlyKnownAs, optional: true
-      attribute :namespace,         ChapterNamespace, optional: true
+      attribute :namespace,         BluebookNamespace, optional: true
 
       sets :name
       sets :vision
@@ -122,27 +122,28 @@ Hecks.bluebook "Bluebook", version: "1" do
       sets :formerly_known_as
       sets :namespace
 
-      emits ChapterDeclared
+      emits BluebookDeclared
     end
 
     # Appends one context; `attaches_to "Query", "ReadModel"` names several at once.
     command "Attach" do
       role "Language"
-      goal "Name one core context this chapter's own Syntax rows attach to"
+      goal "Name one core context this bluebook's own Syntax rows attach to"
 
       attribute :context, AttachesToContext
 
       sets :attaches_to, append: { value: :context }
       # Appending grows the list by exactly one row.
       ensures("the list grew by exactly one") { attaches_to.size == old.attaches_to.size + 1 }
-      emits ChapterAttached
+      emits BluebookAttached
     end
 
     # One row of one capability: `provides "authorization", grant: ...` offers one row per key.
-    # `Capabilities::CONTRACTS` holds which keys a capability must name.
+    # `Capabilities::CONTRACTS` holds which keys a capability the language defines must name; any
+    # other capability's keys are its package's own.
     command "Provide" do
       role "Language"
-      goal "Declare one verb this chapter answers a capability with"
+      goal "Declare one verb this bluebook answers a capability with"
 
       attribute :capability, ProvisionText
       attribute :key,        ProvisionText
@@ -162,7 +163,7 @@ Hecks.bluebook "Bluebook", version: "1" do
 
     command "Normalise" do
       role "Language"
-      goal "Attach one canonical-form rule to the chapter"
+      goal "Attach one canonical-form rule to the bluebook"
 
       attribute :strategy,     RuleText
       attribute :source_token, RuleText
@@ -178,7 +179,7 @@ Hecks.bluebook "Bluebook", version: "1" do
       emits NormalisationAttached
     end
 
-    # Keyword rows for this chapter; SyntaxBoot discovers every aggregate-local seed table.
+    # Keyword rows for this bluebook; SyntaxBoot discovers every aggregate-local seed table.
     value_object "KeywordSeed" do
       attribute :word,          String
       attribute :context,       String, admits: "Syntax::Context"
@@ -239,44 +240,20 @@ Hecks.bluebook "Bluebook", version: "1" do
       member keyword: "provides",        context: "Bluebook", at: "",  named: "register",    kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "link",        kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "resolve",     kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "subscribe",   kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "add_name",    kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "confirm",     kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "unsubscribe", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "awaiting_confirmation", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "receives_issues", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "left", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "confirm_window", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "unsubscribe_window", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "webhook_tolerance", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "session_hold", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "initiate",    kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "succeeded",   kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "failed",      kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "lapse_reason", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "holds_seat",  kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "send_issue",      kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "record_delivery", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "schedule", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "request", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "registered_at", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "frees_seat"   , kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "connect", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "reconnect", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "disconnect", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "suspend", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "resume", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "enable", kind: "text", required: "false", fills: "provides"
-      member keyword: "provides",        context: "Bluebook", at: "",  named: "disable", kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "mark_sensitive", kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "markings_for", kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "key_for", kind: "text", required: "false", fills: "provides"
       member keyword: "provides",        context: "Bluebook", at: "",  named: "shred", kind: "text", required: "false", fills: "provides"
+      member keyword: "provides",        context: "Bluebook", at: "",  named: "",      kind: "pairs", required: "false", fills: "provides", pairs_shape: "verbatim"
       member keyword: "aggregate",       context: "Bluebook", at: "1", named: "",        kind: "text",     required: "true",  fills: "name"
       member keyword: "read_model", context: "Bluebook", at: "1", named: "", kind: "text", required: "true", fills: "name"
       member keyword: "policy",          context: "Bluebook", at: "1", named: "",        kind: "text",     required: "true",  fills: "name"
       member keyword: "process_manager", context: "Bluebook", at: "1", named: "",        kind: "text",     required: "true",  fills: "name"
 
+
+      member keyword: "provides", context: "Bluebook", at: "", named: "live_assignments", kind: "text", required: "false", fills: "provides"
+
+      member keyword: "provides", context: "Bluebook", at: "", named: "live_transitions", kind: "text", required: "false", fills: "provides"
     end
   end
 end