objective_elements 1.1.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e2d1f8b25c51909941b93851d03b35750d6f565a96c79e15c4fc7b335c8569b
-  data.tar.gz: cfc29825193a34c5d5fe1c6aa279cd2d5767181639afa1080eba7faad0081091
+  metadata.gz: a8c175b8c8ee5cb41bcdc79101e658706bc82c930ba3bbb64675cf805375297d
+  data.tar.gz: 234cba6e82854442b3780df1cde7d0b394d5acca7b649c695d8e697379eb213f
 SHA512:
-  metadata.gz: 35c68f9a39dbe6da0ab4ff7681bff27ec230a1633c0d991c7015bd359225cd92b7d6b9ed02a1e5563a9a2675953e715ec55b851c62c59e4a61185ab7188f459a
-  data.tar.gz: a6fb2881ad600bde01391a56359a3a35459d957e561cc9b5c0cdd20bfe66b1028c6c636d7711bff67b89a6321a39230b6ed9ce18578898aa26d5449f3c55fbcb
+  metadata.gz: be1b67a8c7df385802f168ed9684453d378343c56180da10859be98d545e3ac934f56092f27573992c18cea56e7fd2a91fc2d7fc715dc486609d07186f15f7d9
+  data.tar.gz: b2220420f60c50ea537ac4bfeb94e6287452c38b820f7c9d59c16458ef00d2dc7b653e5802868cc330d4ad4742bceb2d570b55f1c237313cdece0cca33acc234

data/.github/workflows/ci.yml

@@ -0,0 +1,44 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  spec:
+    name: rspec (ruby ${{ matrix.ruby }})
+    runs-on: ${{ matrix.runs-on || 'ubuntu-latest' }}
+    continue-on-error: ${{ matrix.experimental || false }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["3.2", "3.3", "3.4", "4.0"]
+        include:
+          # setup-ruby has no 3.0 build for images newer than 22.04.
+          - ruby: "3.0"
+            runs-on: ubuntu-22.04
+          - ruby: ruby-head
+            experimental: true
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rspec
+
+  rubocop:
+    name: rubocop
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          # Matches the version mise.toml pins, so local and CI lint agree.
+          ruby-version: "3.4"
+          bundler-cache: true
+      - run: bundle exec rubocop

data/.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  # Publishes whatever version.rb says on the selected branch. Needed for
+  # v2.0.0, whose tag predates this workflow. `rake release` skips tagging when
+  # the tag already exists, so this is safe to re-run.
+  workflow_dispatch:
+
+jobs:
+  release:
+    name: push to rubygems
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      # Required for the OIDC token rubygems.org trades for a scoped API key.
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          # Matches the version mise.toml pins.
+          ruby-version: "3.4"
+          bundler-cache: true
+      - uses: rubygems/release-gem@v1

data/.gitignore

@@ -6,3 +6,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+Gemfile.lock

data/.rubocop.yml

@@ -0,0 +1,3 @@
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable

data/AGENTS.md

@@ -0,0 +1,35 @@
+# AGENTS.md
+
+This project is a small ruby gem for building HTML tags.
+
+## Commits
+
+- All AI assisted commits should have a trailer: `Assisted-by: <model>`
+- [Scoped commits](https://scopedcommits.com/), not conventional commits. Short version:
+
+```
+<scope>: <description>
+
+[optional body]
+
+[optional trailer(s)]
+```
+
+- <scope> — the subsystem, area, or module that the commit touches
+- <description> — a short description of the changes made
+- [optional body] — detailed information about the changes
+- [optional trailer(s)] — additional metadata about the commit
+
+## Agent skills
+
+### Issue tracker
+
+Issues live in GitHub Issues for `rbuchberger/objective_elements`, managed via the `gh` CLI. See `docs/agents/issue-tracker.md`.
+
+### Triage labels
+
+The five canonical triage roles, each using its default label string. See `docs/agents/triage-labels.md`.
+
+### Domain docs
+
+Single-context: `CONTEXT.md` and `docs/adr/` at the repo root. See `docs/agents/domain.md`.

data/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2026-08-12
+
+### Changed
+
+- **Breaking:** `required_ruby_version` is now `>= 3.0`, with no upper bound.
+  See [ADR 0001](docs/adr/0001-ruby-version-support-policy.md) for the support
+  policy and the April 2027 expiry of the 3.0 floor.
+- All source files now declare `# frozen_string_literal: true`.
+- `ShelfTag#initialize` calls `super`, so a ShelfTag now has a `nil` element and
+  an empty `HTMLAttributes` rather than no attributes at all.
+
+### Fixed
+
+- `HTMLAttributes#to_s` no longer mutates the attribute hash. Previously an
+  empty attribute gained an empty string on every render, so repeated calls
+  accumulated trailing spaces.
+- `HTMLAttributes#to_s`, `SingleTag#opening_tag`, and `DoubleTag#to_a` built
+  their output by mutating string literals, which raised `FrozenError` under
+  frozen string literals.
+- `bin/console` required the gem's pre-rename name and could not start.
+
+### Added
+
+- GitHub Actions CI: rspec on Ruby 3.0, 3.2, 3.3, 3.4, and 4.0, plus a
+  `ruby-head` leg that is allowed to fail, and rubocop on 3.4.
+- Gemspec metadata URIs, and `rubygems_mfa_required`.
+- `mise.toml`, pinning Ruby 3.4 for development.
+- This changelog. Earlier entries are transcribed from the README's old
+  "Changes" section.
+
+### Removed
+
+- `bundler`, `pry`, and `solargraph` as declared development dependencies, and
+  `.solargraph.yml`. Install those locally instead.
+- `Gemfile.lock`, which is now gitignored — one lockfile can't serve a Ruby
+  3.0 through 4.0 matrix.
+
+## [1.1.2] - 2020-01-16
+
+### Changed
+
+- Gemspec and dependency housekeeping. No functional changes.
+
+## [1.1.1] - 2019-11-14
+
+### Fixed
+
+- Duplicate attribute keys passed at the same time no longer overwrite each
+  other's values.
+
+## [1.1.0] - 2019-02-08
+
+### Added
+
+- `ShelfTag`, for creating siblings without a parent element.
+
+## [1.0.0] - 2018-10-23
+
+### Changed
+
+- **Breaking:** attributes syntax changed significantly. `.add_attributes`
+  became `.attributes <<`; see the README's usage section.
+
+[unreleased]: https://github.com/rbuchberger/objective_elements/compare/v1.1.2...HEAD
+[1.1.2]: https://github.com/rbuchberger/objective_elements/compare/v1.1.1...v1.1.2
+[1.1.1]: https://github.com/rbuchberger/objective_elements/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/rbuchberger/objective_elements/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/rbuchberger/objective_elements/releases/tag/v1.0.0

data/Gemfile

@@ -1,6 +1,9 @@
-source "https://rubygems.org"
+# frozen_string_literal: true
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+source 'https://rubygems.org'
 
-# Specify your gem's dependencies in elements.gemspec
 gemspec
+
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.13'
+gem 'rubocop', '~> 1.81'

data/README.md

@@ -18,7 +18,7 @@ you only need sometimes, it turns into a horrible mess.
 
 The problem, of course, is that building long, complex, varying blocks of text with string
 concatenation and interpolation is fragile, unreadable, and painful. You know this, but you're not
-going to write an entirely new class or pull in some big new dependency just for 10 lines of HTML, 
+going to write an entirely new class or pull in some big new dependency just for 10 lines of HTML,
 so instead you hammer through it and end up with code like this:
 
 ```ruby
@@ -29,7 +29,8 @@ picture_tag = "<picture>\n"\
               "#{html_attr_string}>\n"\"#{markdown_escape * 2}</picture>\n"
 ```
 
-or this: 
+or this:
+
 ```ruby
     def build_li(this_item_data, icon_location, label)
       li = "  <li#{@attributes['li']}>"
@@ -98,43 +99,46 @@ div = p.add_parent DoubleTag.new 'div'
 
 ## Changes
 
-### 1.1.0
-Add `ShelfTag`, which is useful when you want to create siblings without a parent element.
-
-### 1.0.0
-Attributes syntax has changed pretty significantly. Find `.add_attributes` & replace `.attributes << `
-will get you most of the way there, but you should read over the usage section again.
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## Installation
 
- ```ruby
- # Gemfile
- 
- gem 'objective_elements', '~> 1.0.0'
- ```
- 
- ```ruby
- # Anywhere else:
- 
- require 'objective_elements'
- ```
- 
+```ruby
+# Gemfile
+
+gem 'objective_elements', '~> 2.0'
+```
+
+```ruby
+# Anywhere else:
+
+require 'objective_elements'
+```
+
+### Supported Rubies
+
+Ruby 3.0 and up, with no upper bound. The policy is to support every non-EOL Ruby, plus EOL versions
+still shipped in a supported Ubuntu LTS — which is the only reason the floor is as low as 3.0. It
+rises to 3.2 when Ubuntu 22.04 leaves standard support in April 2027. See
+[ADR 0001](docs/adr/0001-ruby-version-support-policy.md).
+
 ## Terminology
 
 ```
 <p class="stumpy">Hello</p>
 |a|       b      |  c  | d |
 ```
-- a    -  element
-- b    -  attributes
-- a+b  -  opening tag
-- c    -  content
-- d    -  closing tag
 
+- a - element
+- b - attributes
+- a+b - opening tag
+- c - content
+- d - closing tag
 
 ## Usage
 
 For Attribute & SingleTag examples, we'll use this image tag:
+
 ```ruby
 
 img = SingleTag.new 'img', attributes: 'src="angry-baby.jpg"'
@@ -146,34 +150,39 @@ A `SingleTag` is a self-closing tag, meaning it has no content and no closing ta
 the other kind.
 
 ### Attributes
+
 Attributes are their own class, and can be accessed by the `.attributes` method on both single and
 double tags. Important methods:
 
-` << (attribute)` 
+`<< (attribute)`
+
 - Example: `p.attributes << 'alt="he does not look happy"'`
 - Example: `p.attributes << { alt: "he does not look happy" }`
 - Add new attributes, can accept a hash or a string. Hash keys will be converted
-to symbols if they are not already, and values will be split on spaces into an array if they are not
-already. Attributes can also be given as a string in the standard HTML syntax (`class="myclass"
-id="my-id"`).  **Every other method which adds attributes in some way, calls this method**. This
-means that any time you are adding attributes, you can use any format which this method understands.
- 
-`.delete(attribute)` 
+  to symbols if they are not already, and values will be split on spaces into an array if they are not
+  already. Attributes can also be given as a string in the standard HTML syntax (`class="myclass" id="my-id"`). **Every other method which adds attributes in some way, calls this method**. This
+  means that any time you are adding attributes, you can use any format which this method understands.
+
+`.delete(attribute)`
+
 - Example: `img.attributes.delete 'src'`
 - Example: `img.attributes.delete :src`
 - Example: `img.attributes.delete [:src, 'alt']`
 - Delete one or more attributes. Accepts a string, symbol, or an array of
-strings and/or symbols.
+  strings and/or symbols.
+
+`.replace(attribute)`
 
-`.replace(attribute)` 
 - Example: `img.attributes.replace 'src="happy-baby.jpg"'`
 - Replaces one or more attributes and values individually.
 
-`.content[:attribute_name] = ` 
+`.content[:attribute_name] =`
+
 - Example: `img.attributes.content[:src] = 'dirty-baby.jpg'` < This just broke everything.
-- Don't do it. Use `.replace`, `.(attribute name) = `, or `<<` 
+- Don't do it. Use `.replace`, `.(attribute name) =`, or `<<`
+
+`.content[:attribute_name]`
 
-`.content[:attribute_name]` 
 - Example: `img.attributes[:src] # returns 'angry-baby.jpg`
 - Retrieve the content for a given attribute, as an array of strings. Must be a symbol. You'll
 - mostly need this when you don't know which attribute you need ahead of
@@ -181,18 +190,20 @@ strings and/or symbols.
 
 **There is a shorthand for the next two methods. Keep reading.**
 
-`.(attribute_name)` 
+`.(attribute_name)`
+
 - Example: `img.attributes.src # 'angry-baby.jpg'`
 - Convenience method/syntactic sugar: Returns the value of a given attribute name, as a
 - space-separated string. This relies on method_missing, which means that any overlap with
-  already existing methods won't work.  
+  already existing methods won't work.
 - **You can't access `class` or `method` html attributes this way, because
   basic objects in ruby already have those methods.**
 - **Ruby methods can't have dashes in them.** This means `p.data-awesomeness` won't work.
 
-`.(attribute_name) = value` 
+`.(attribute_name) = value`
+
 - Example: `img.attributes.src = 'happy-baby.jpg'`
-- Same as above. Similar to `.replace(attribute)`. Interestingly, `method = ` and `class = ` both
+- Same as above. Similar to `.replace(attribute)`. Interestingly, `method =` and `class =` both
   work (`.class` is defined on the basic object class, but `.class=` is not.). Still, you
   probably shouldn't use them.
 
@@ -203,36 +214,43 @@ strings and/or symbols.
 
 ### SingleTag Properties:
 
- #### element
- - String
- - Mandatory
- - Which type of tag, such as 'hr' or 'img'
- 
- #### attributes
- - Instance of the class described above.
+#### element
+
+- String
+- Mandatory
+- Which type of tag, such as 'hr' or 'img'
+
+#### attributes
+
+- Instance of the class described above.
 
 ### SingleTag Methods (that you care about)
 
 `SingleTag.new(element, attributes: nil)`
 
-`.to_s` 
+`.to_s`
+
 - Example: `img.to_s`
 - The big one. Returns your HTML as a string, nondestructively.
 
-`.add_parent(DoubleTag)` 
+`.add_parent(DoubleTag)`
+
 - Example: `img.add_parent DoubleTag.new 'picture'`
 - returns supplied DoubleTag, with self added as a child.
 
-`.attributes` 
+`.attributes`
+
 - Example: `img.attributes`
 - attr_reader for HTML attributes. This is how you can access any attribute method
-described above.
+  described above.
+
+`.reset_attributes`
 
-`.reset_attributes` 
 - Example: `img.reset_attributes`
 - Removes all attributes.
 
-`.attributes=(new)` 
+`.attributes=(new)`
+
 - Example: `img.attributes = 'src="grumpy-baby.jpg" id="muddy"'`
 - Equivalent to `reset_attributes` and `.attributes << new`
 
@@ -241,40 +259,43 @@ described above.
 
 ### DoubleTag Properties:
 
-
 #### `DoubleTag` Inherits all of `SingleTag`'s properties and methods, and adds content and a
+
 closing tag.
 
- #### content
+#### content
 
-   - Array
-   - Optional
-   - Contains anything (but probably just strings and tags. Anything else will be turned into a
-     string with `.to_s`, which is an alias for `.inspect` most of the time).
-   - Each element in the array corresponds to at least one line of HTML
-   - Multiline child tags will get as many lines as they need (like you'd expect).
-   - Child elements are not rendered until the parent is rendered, meaning you can access and
-     modify them after defining a parent.
-   - add with `.add_content`, or modify the content array directly.
+- Array
+- Optional
+- Contains anything (but probably just strings and tags. Anything else will be turned into a
+  string with `.to_s`, which is an alias for `.inspect` most of the time).
+- Each element in the array corresponds to at least one line of HTML
+- Multiline child tags will get as many lines as they need (like you'd expect).
+- Child elements are not rendered until the parent is rendered, meaning you can access and
+  modify them after defining a parent.
+- add with `.add_content`, or modify the content array directly.
 
- #### oneline
-  - Boolean
-  - optional, defaults to false.
-  - When true, the entire element and its content will be rendered as a single line. Useful for
-    anchor tags and list items.
+#### oneline
+
+- Boolean
+- optional, defaults to false.
+- When true, the entire element and its content will be rendered as a single line. Useful for
+  anchor tags and list items.
 
 ### DoubleTag Methods (that you care about)
 
-For DoubleTag Examples, we're working with a div tag: 
+For DoubleTag Examples, we're working with a div tag:
 
 ```
 div = DoubleTag.new 'div'
 ```
 
-`DoubleTag.new(element, attributes: {}, oneline: false, content: [])` 
+`DoubleTag.new(element, attributes: {}, oneline: false, content: [])`
+
 - You can initialize it with content.
 
-`add_content(anything)` 
+`add_content(anything)`
+
 - Example: `div.add_content 'example text!'`
 - Example: `div.add_content ['splits', 'across', 'lines']`
 - Example: `div.add_content img # image tag from earlier`
@@ -300,91 +321,105 @@ tag.
 Convert it into an actual tag with `.add_parent(DoubleTag)`
 
 ## Configuration
- 
- Indentation is defined by the `indent` method on the DoubleTag class, which is two escaped
- spaces by default ("\ \ "). If you'd like to change it:
 
- 1. Make a new class, inherit from DoubleTag.
- 2. Override `indent` with whatever you want.
- 3. Use your new class instead of DoubleTag.
+Indentation is defined by the `indent` method on the DoubleTag class, which is two escaped
+spaces by default ("\ \ "). If you'd like to change it:
+
+1.  Make a new class, inherit from DoubleTag.
+2.  Override `indent` with whatever you want.
+3.  Use your new class instead of DoubleTag.
+
+Example:
 
- Example:
+```ruby
 
- ```ruby
- 
- require 'objective_elements'
+require 'objective_elements'
 
- class MyDoubleTag < DoubleTag
-  def indent
-    # 4 escaped spaces:
-    "\ \ \ \ "
-  end
+class MyDoubleTag < DoubleTag
+ def indent
+   # 4 escaped spaces:
+   "\ \ \ \ "
  end
+end
 
 MyDoubleTag.new('p', content: 'hello').to_s
 # <p>
 #     hello
 # </p>
 
- ```
-
- ## Limitations
-
-* It doesn't know a single HTML element on its own, so it does nothing to ensure your HTML is valid.
-
-* A parent tag can't put siblings on the same line. You can either do this (with `oneline: true` on
-   the strong tag):
+```
 
-    ```html
+## Limitations
 
-    <p>
-      Here is some
-      <strong>strong</strong>
-      text.
-    </p>
+- It doesn't know a single HTML element on its own, so it does nothing to ensure your HTML is valid.
 
-    ```
-    or this (default behavior):
+- A parent tag can't put siblings on the same line. You can either do this (with `oneline: true` on
+  the strong tag):
 
-    ```html
+  ```html
+  <p>
+    Here is some
+    <strong>strong</strong>
+    text.
+  </p>
+  ```
 
-    <p>
-      Here is some
-      <strong>
-        strong
-      </strong>
-      text.
-    </p>
+  or this (default behavior):
 
-    ```
-    But you can't do this without string interpolation or something:
+  ```html
+  <p>
+    Here is some
+    <strong>
+      strong
+    </strong>
+    text.
+  </p>
+  ```
 
-    ```html
+  But you can't do this without string interpolation or something:
 
-    <p>Here is some <strong>strong</strong> text.</p>
+  ```html
+  <p>
+    Here is some
+    <strong>strong</strong>
+    text.
+  </p>
+  ```
 
-    ```
-    This doesn't affect how the browser will render it, but it might bug you if you're particular about
-    source code layout.
+  This doesn't affect how the browser will render it, but it might bug you if you're particular about
+  source code layout.
 
-* If you set 'oneline: true' on a parent DoubleTag, but not all its children DoubleTags, the output
+- If you set 'oneline: true' on a parent DoubleTag, but not all its children DoubleTags, the output
   will not be pretty. I advise against it. Handling this situation is on the TODO list.
 
-* It doesn't wrap long lines of text, and it doesn't indent text with newlines embedded. It's on the
+- It doesn't wrap long lines of text, and it doesn't indent text with newlines embedded. It's on the
   TODO list.
 
-## Contributing
+## Development
+
+Ruby is managed with [mise](https://mise.jdx.dev/); `mise.toml` pins 3.4, which is the version CI
+lints on, so local rubocop can't disagree with CI. Any supported Ruby will run the tests.
+
+```sh
+mise install     # optional; only if you use mise
+bundle install
+bundle exec rake # rspec + rubocop
+```
+[Scoped commits](https://scopedcommits.com/)
 
-For code style, I've been using rubocop with the default settings and would appreciate if you did the
-same.
+## AI Policy
 
-If you add new functionality, or change existing functionality, please update the rspec tests to
-reflect it.
+The use of LLM powered coding tools is permitted so long as:
 
-https://github.com/rbuchberger/objective_elements
+* Any commits with any AI generated code have a trailer: `Assisted-by: <model>`
+* All changes are read completely and reviewed thoroughly by a knowledgable human before merging to
+  master. This has always been the case, but it is especially true for AI-generated code.
+* Pull request authors are expected to have done the same before submitting.
 
-contact:
-robert@robert-buchberger.com
+If you don't want to run AI generated code, you can use versions prior to `2.0.0`. You are likely
+using this project as a dependency of jekyll_picture_tag; it is pinned to OE `1.x` for JPT versions
+prior to `3.0.0` which carries a similar policy change. In other words, If you use the non-ai
+version of JPT, you'll get the non-ai version of this.
 
 ## License
 

data/Rakefile

@@ -1,2 +1,10 @@
-require "bundler/gem_tasks"
-task :default => :spec
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rubocop/rake_task'
+require 'rspec/core/rake_task'
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:spec)
+
+task default: %i[spec rubocop]

data/bin/console

@@ -1,14 +1,11 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-require "bundler/setup"
-require "elements"
+require 'bundler/setup'
+require 'objective_elements'
 
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
 
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
+require 'irb'
 IRB.start(__FILE__)

data/docs/adr/0001-ruby-version-support-policy.md

@@ -0,0 +1,68 @@
+# 1. Ruby version support policy
+
+Date: 2026-08-11
+
+## Status
+
+Accepted. The Ruby 3.0 floor expires April 2027 — see "Consequences".
+
+## Context
+
+The gem sat dormant long enough that its tooling and its implicit Ruby support
+window had both drifted. Reviving it meant answering a question that had never
+been written down: which Rubies does this gem promise to work on?
+
+Two failure modes were on the table. Setting the floor too high strands users on
+distro-packaged Rubies they don't control. Setting an upper bound strands
+everyone the moment a new Ruby ships — which is exactly the state
+`jekyll_picture_tag` is in, uninstallable on Ruby 4.0 because of its own
+`< 4.0` cap.
+
+This gem is ~100 lines, has no runtime dependencies, and uses no recent syntax.
+The cost of supporting an old Ruby is close to zero; the cost of an upper bound
+is a broken install.
+
+## Decision
+
+`required_ruby_version = '>= 3.0'`, with no upper bound.
+
+The rule behind that number: **support every non-EOL Ruby, plus EOL versions
+still shipped in a supported Ubuntu LTS.**
+
+| Ruby | Status (Aug 2026) | Ubuntu LTS            |
+| ---- | ----------------- | --------------------- |
+| 4.0  | supported         | —                     |
+| 3.4  | supported         | —                     |
+| 3.3  | supported         | 26.04                 |
+| 3.2  | EOL 2026-03       | 24.04 (to Apr 2029)   |
+| 3.0  | EOL 2024-04       | 22.04 (to Apr 2027)   |
+
+No upper bound. A dependency-free library has nothing to break against a new
+Ruby that a cap would protect against, and a cap guarantees breakage the day
+that Ruby ships.
+
+CI tests the full supported range — 3.0, 3.2, 3.3, 3.4, 4.0 — plus a
+`continue-on-error` `ruby-head` leg for early warning. The 3.0 leg pins
+`ubuntu-22.04`, because `setup-ruby` publishes no 3.0 build for newer images.
+Rubocop runs once, on 3.4, matching the version `mise.toml` pins so local lint
+and CI lint cannot disagree. No JRuby or TruffleRuby: no runtime dependencies
+and no C extensions means nothing platform-specific to catch.
+
+## Consequences
+
+The floor is user-visible metadata, so raising it is a breaking change. That is
+what makes this release 2.0.0.
+
+Ruby 3.0 is here **only** because Ubuntu 22.04 ships it. **Revisit in April
+2027**, when 22.04 leaves standard support: at that point the floor should rise
+to 3.2 (Ubuntu 24.04's Ruby, supported until April 2029) in the next major
+version.
+
+Applying the rule mechanically means the floor moves on Ubuntu LTS's schedule
+rather than upstream Ruby's, which is slower than most gems — deliberately.
+That is the point: the users least able to upgrade Ruby are the ones on a
+distro-packaged one.
+
+Out of scope, and tracked separately in that repo: `jekyll_picture_tag`'s own
+`< 4.0` cap, and its `objective_elements ~> 1.1` constraint. Both need their own
+support decision.

data/docs/agents/domain.md

@@ -0,0 +1,51 @@
+# Domain Docs
+
+How the engineering skills should consume this repo's domain documentation when exploring the codebase.
+
+## Before exploring, read these
+
+- **`CONTEXT.md`** at the repo root, or
+- **`CONTEXT-MAP.md`** at the repo root if it exists — it points at one `CONTEXT.md` per context. Read each one relevant to the topic.
+- **`docs/adr/`** — read ADRs that touch the area you're about to work in. In multi-context repos, also check `src/<context>/docs/adr/` for context-scoped decisions.
+
+If any of these files don't exist, **proceed silently**. Don't flag their absence; don't suggest creating them upfront. The `/domain-modeling` skill (reached via `/grill-with-docs` and `/improve-codebase-architecture`) creates them lazily when terms or decisions actually get resolved.
+
+## File structure
+
+Single-context repo (most repos):
+
+```
+/
+├── CONTEXT.md
+├── docs/adr/
+│   ├── 0001-event-sourced-orders.md
+│   └── 0002-postgres-for-write-model.md
+└── src/
+```
+
+Multi-context repo (presence of `CONTEXT-MAP.md` at the root):
+
+```
+/
+├── CONTEXT-MAP.md
+├── docs/adr/                          ← system-wide decisions
+└── src/
+    ├── ordering/
+    │   ├── CONTEXT.md
+    │   └── docs/adr/                  ← context-specific decisions
+    └── billing/
+        ├── CONTEXT.md
+        └── docs/adr/
+```
+
+## Use the glossary's vocabulary
+
+When your output names a domain concept (in an issue title, a refactor proposal, a hypothesis, a test name), use the term as defined in `CONTEXT.md`. Don't drift to synonyms the glossary explicitly avoids.
+
+If the concept you need isn't in the glossary yet, that's a signal — either you're inventing language the project doesn't use (reconsider) or there's a real gap (note it for `/domain-modeling`).
+
+## Flag ADR conflicts
+
+If your output contradicts an existing ADR, surface it explicitly rather than silently overriding:
+
+> _Contradicts ADR-0007 (event-sourced orders) — but worth reopening because…_

data/docs/agents/issue-tracker.md

@@ -0,0 +1,45 @@
+# Issue tracker: GitHub
+
+Issues and specs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
+
+## Conventions
+
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
+
+Infer the repo from `git remote -v` — `gh` does this automatically when run inside a clone.
+
+## Pull requests as a triage surface
+
+**PRs as a request surface: no.** _(Set to `yes` if this repo treats external PRs as feature requests; `/triage` reads this flag.)_
+
+When set to `yes`, PRs run through the same labels and states as issues, using the `gh pr` equivalents:
+
+- **Read a PR**: `gh pr view <number> --comments` and `gh pr diff <number>` for the diff.
+- **List external PRs for triage**: `gh pr list --state open --json number,title,body,labels,author,authorAssociation,comments` then keep only `authorAssociation` of `CONTRIBUTOR`, `FIRST_TIME_CONTRIBUTOR`, or `NONE` (drop `OWNER`/`MEMBER`/`COLLABORATOR`).
+- **Comment / label / close**: `gh pr comment`, `gh pr edit --add-label`/`--remove-label`, `gh pr close`.
+
+GitHub shares one number space across issues and PRs, so a bare `#42` may be either — resolve with `gh pr view 42` and fall back to `gh issue view 42`.
+
+## When a skill says "publish to the issue tracker"
+
+Create a GitHub issue.
+
+## When a skill says "fetch the relevant ticket"
+
+Run `gh issue view <number> --comments`.
+
+## Wayfinding operations
+
+Used by `/wayfinder`. The **map** is a single issue with **child** issues as tickets.
+
+- **Map**: a single issue labelled `wayfinder:map`, holding the Notes / Decisions-so-far / Fog body. `gh issue create --label wayfinder:map`.
+- **Child ticket**: an issue linked to the map as a GitHub sub-issue (`gh api` on the sub-issues endpoint). Where sub-issues aren't enabled, add the child to a task list in the map body and put `Part of #<map>` at the top of the child body. Labels: `wayfinder:<type>` (`research`/`prototype`/`grilling`/`task`). Once claimed, the ticket is assigned to the driving dev.
+- **Blocking**: GitHub's **native issue dependencies** — the canonical, UI-visible representation. Add an edge with `gh api --method POST repos/<owner>/<repo>/issues/<child>/dependencies/blocked_by -F issue_id=<blocker-db-id>`, where `<blocker-db-id>` is the blocker's numeric **database id** (`gh api repos/<owner>/<repo>/issues/<n> --jq .id`, _not_ the `#number` or `node_id`). GitHub reports `issue_dependencies_summary.blocked_by` (open blockers only — the live gate). Where dependencies aren't available, fall back to a `Blocked by: #<n>, #<n>` line at the top of the child body. A ticket is unblocked when every blocker is closed.
+- **Frontier query**: list the map's open children (`gh issue list --state open`, scoped to the map's sub-issues / task list), drop any with an open blocker (`issue_dependencies_summary.blocked_by > 0`, or an open issue in the `Blocked by` line) or an assignee; first in map order wins.
+- **Claim**: `gh issue edit <n> --add-assignee @me` — the session's first write.
+- **Resolve**: `gh issue comment <n> --body "<answer>"`, then `gh issue close <n>`, then append a context pointer (gist + link) to the map's Decisions-so-far.

data/docs/agents/triage-labels.md

@@ -0,0 +1,15 @@
+# Triage Labels
+
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
+
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
+
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
+
+Edit the right-hand column to match whatever vocabulary you actually use.

data/lib/objective_elements/double_tag.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Non-Self-Closing tag. Can have content, but doesn't have to.
 class DoubleTag < SingleTag
   attr_accessor :oneline
@@ -29,23 +31,23 @@ class DoubleTag < SingleTag
 
   def to_a
     lines = content.map { |c| build_content_line c }
-    lines = lines.flatten.map { |l| l.prepend oneline ? '' : indent }
+    lines = lines.flatten.map { |l| oneline ? l : indent + l }
     lines.unshift(opening_tag).push(closing_tag)
   end
 
   def to_s
-    to_a.join(oneline ? '' : "\n") + "\n"
+    "#{to_a.join(oneline ? '' : "\n")}\n"
   end
 
   private
 
   def build_content_line(element)
     # Since DoubleTag inherits from SingleTag, it will slurp up those too.
-    element.is_a?(SingleTag) ? element.to_a : element.to_s.dup
+    element.is_a?(SingleTag) ? element.to_a : element.to_s
   end
 
   def indent
-    "\ \ "
+    '  '
   end
 
   def closing_tag

data/lib/objective_elements/html_attributes.rb

@@ -1,6 +1,9 @@
+# frozen_string_literal: true
+
 # Represents standard HTML attributes, such as class="myclass"
 class HTMLAttributes
   attr_reader :content
+
   def initialize(new = nil)
     @content = {}
     self << new
@@ -11,12 +14,9 @@ class HTMLAttributes
   end
 
   def to_s
-    return_string = ''
-    @content.each_pair do |k, v|
-      return_string << "#{k}=\"#{v.join ' '}\" "
-    end
-
-    return_string.strip
+    # An attribute with no values joins to an empty string, which is the
+    # correct format (alt="", for example).
+    @content.map { |k, v| "#{k}=\"#{v.join ' '}\"" }.join(' ')
   end
 
   # This is the only way we add new attributes. Flexible about what you give
@@ -86,29 +86,36 @@ class HTMLAttributes
     add_hash hashify_input new_string
   end
 
-  def add_hash(new)
+  # Input: Keys are attribute names (either strings or symbols), values are
+  # attribute values (either a string or an array of strings)
+  def add_hash(new_hash)
     formatted_new = {}
-    new.each_pair do |k, v|
-      v = v.split ' ' if v.is_a? String
+
+    new_hash.each_pair do |k, v|
+      v = v.split if v.is_a? String
+
       formatted_new[k.to_sym] = v
     end
 
-    @content.merge! formatted_new do |_key, oldval, newval|
-      oldval.concat newval
+    @content.merge!(formatted_new) do |_key, oldval, newval|
+      oldval.concat(newval)
     end
+
     self
   end
 
   def hashify_input(new_string)
     # looking for something like:
-    # 'class="something something-else" id="my-id"'
+    # 'class="something something-else" id="my-id" alt=""'
     new_hash = {}
-    new_string.scan(/ ?([^="]+)="([^"]+)"/).each do |m|
-      # [['class','something something-else'],['id','my-id']]
-      key = m.shift
-      val = m.pop
+    new_string.scan(/ ?([^="]+)="([^"]*)"/).each do |match|
+      # Returns something like:
+      # [['class','something something-else'],['id','my-id'],['alt', '']]
+
+      key, val = *match
+
       if new_hash[key]
-        new_hash[key] << ' ' + val
+        new_hash[key] << " #{val}"
       else
         new_hash[key] = val
       end

data/lib/objective_elements/shelf_tag.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 # This is a nonexistent HTML tag, which holds content like a double tag but has
 # no opening or closing tag. This allows us to group siblings without adding an
 # extra parent to the markup.
 class ShelfTag < DoubleTag
+  # A shelf has no element of its own, so it never renders an opening tag.
   def initialize(content: nil, oneline: false)
-    self.oneline = oneline
-    self.content = content
+    super(nil, content: content, oneline: oneline)
   end
 
   def to_a

data/lib/objective_elements/single_tag.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Collection of HTML element tags
 # Describes a basic, self-closing HTML tag.
 class SingleTag
@@ -34,7 +36,7 @@ class SingleTag
 
   # Renders our HTML.
   def to_s
-    opening_tag + "\n"
+    "#{opening_tag}\n"
   end
 
   # Allows us to work with attributes as methods:
@@ -53,8 +55,8 @@ class SingleTag
   private
 
   def opening_tag
-    output =  '<' + @element
-    output << ' ' + @attributes.to_s unless @attributes.empty?
-    output << '>'
+    return "<#{@element}>" if @attributes.empty?
+
+    "<#{@element} #{@attributes}>"
   end
 end

data/lib/objective_elements/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module ObjectiveElements
-  VERSION = '1.1.1'.freeze
+  VERSION = '2.0.0'
 end

data/lib/objective_elements.rb

@@ -1,3 +1,10 @@
+# frozen_string_literal: true
+
+# Author: Robert Buchberger <robert@buchberger.cc>
+#
+# This module provides a few helpful classes for generating HTML using simple
+# Ruby. Its goal is to be lightweight, and more focused than the general-purpose
+# nature of nokogiri.
 module ObjectiveElements
   require_relative 'objective_elements/single_tag'
   require_relative 'objective_elements/double_tag'

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4"

data/objective_elements.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'objective_elements/version'
@@ -6,12 +8,22 @@ Gem::Specification.new do |spec|
   spec.name          = 'objective_elements'
   spec.version       = ObjectiveElements::VERSION
   spec.authors       = ['Robert Buchberger']
-  spec.email         = ['robert@robert-buchberger.com']
+  spec.email         = ['robert@buchberger.cc']
 
-  spec.summary       = 'Build HTML without interpolating strings.'
+  spec.summary       = 'Build HTML with simple ruby.'
   spec.homepage      = 'https://github.com/rbuchberger/objective_elements'
   spec.license       = 'MIT'
 
+  spec.required_ruby_version = '>= 3.0'
+
+  spec.metadata = {
+    'homepage_uri' => spec.homepage,
+    'source_code_uri' => spec.homepage,
+    'bug_tracker_uri' => "#{spec.homepage}/issues",
+    'changelog_uri' => "#{spec.homepage}/blob/master/CHANGELOG.md",
+    'rubygems_mfa_required' => 'true'
+  }
+
   # Specify which files should be added to the gem when it is released.  The
   # `git ls-files -z` loads the files in the RubyGem that have been added into
   # git.
@@ -23,9 +35,4 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-
-  spec.add_development_dependency 'bundler', '~> 1.16'
-  spec.add_development_dependency 'pry', '~>0.11.3'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~>3.8.0'
 end

metadata

@@ -1,98 +1,53 @@
 --- !ruby/object:Gem::Specification
 name: objective_elements
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Robert Buchberger
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-14 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.16'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.16'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.11.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.11.3
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.8.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.8.0
-description: 
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
 email:
-- robert@robert-buchberger.com
+- robert@buchberger.cc
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
+- ".rubocop.yml"
+- AGENTS.md
+- CHANGELOG.md
 - Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/console
 - bin/setup
+- docs/adr/0001-ruby-version-support-policy.md
+- docs/agents/domain.md
+- docs/agents/issue-tracker.md
+- docs/agents/triage-labels.md
 - lib/objective_elements.rb
 - lib/objective_elements/double_tag.rb
 - lib/objective_elements/html_attributes.rb
 - lib/objective_elements/shelf_tag.rb
 - lib/objective_elements/single_tag.rb
 - lib/objective_elements/version.rb
+- mise.toml
 - objective_elements.gemspec
 homepage: https://github.com/rbuchberger/objective_elements
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/rbuchberger/objective_elements
+  source_code_uri: https://github.com/rbuchberger/objective_elements
+  bug_tracker_uri: https://github.com/rbuchberger/objective_elements/issues
+  changelog_uri: https://github.com/rbuchberger/objective_elements/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -100,15 +55,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Build HTML without interpolating strings.
+summary: Build HTML with simple ruby.
 test_files: []

data/Gemfile.lock

@@ -1,41 +0,0 @@
-PATH
-  remote: .
-  specs:
-    objective_elements (1.1.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    coderay (1.1.2)
-    diff-lcs (1.3)
-    method_source (0.9.0)
-    pry (0.11.3)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    rake (10.5.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  bundler (~> 1.16)
-  objective_elements!
-  pry (~> 0.11.3)
-  rake (~> 10.0)
-  rspec (~> 3.8.0)
-
-BUNDLED WITH
-   1.17.2