# Changelog

## Score

- CAI 48 → 54 (+5.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 62 → 62 (+0.2)
- Architecture 69 → 69 (+0.0)
- Maturity 36 → 54 (+17.6)
- Readiness 46 → 46 (+0.0)
- Security 100 → 75 (-24.6)

## Resolved (7)

- Change coupling: browser.rb ↔ node.rb (lib/capybara/cuprite/browser.rb)
- Documentation: no installation or build instructions (docs/7-javascript.md)
- FixmeComment (lib/capybara/cuprite/node.rb)
- Inconsistent collection management patterns. `Driver` uses explicit `set_cookie`, `remove_cookie`, and `clear_cookies`. `Browser` uses setter methods (`url_whitelist=`, `url_blacklist=`) for configuration. While these are different domains (runtime state vs config), the lack of a consistent pattern for 'adding/removing items from a list' (e.g., `add_header` vs `headers=`) is slightly jarring, though less severe than the others. However, `Driver.add_headers` and `Driver.add_header` exist alongside `Driver.headers=`, which is redundant.
- Inconsistent locator strategy naming. The `Browser` and `Node` classes use a generic `find(method, selector)` pattern where `method` is likely a symbol (e.g., :css, :xpath). However, the `Driver` class exposes explicit `find_xpath` and `find_css` methods. This forces consumers to know the internal implementation details of the `Browser`/`Node` abstraction to use the more explicit `Driver` API, or conversely, prevents the use of the generic `find` on the `Driver` if it doesn't support it, creating a fragmented API surface for the same intent.
- Redundant property accessors. `Browser.property` and `Node.property` do the same thing (accessing a DOM property). Additionally, `Node` exposes `Node.[](name)` which is an alias for `Node.property(name)`. While `[]` is idiomatic Ruby, having both `property` and `[]` on `Node` alongside a separate `Browser.property` creates confusion about whether one should use the node method or the browser method for property access.
- TooManyMethods: Browser (lib/capybara/cuprite/browser.rb)

## New (7)

- Hotspot: lib/capybara/cuprite/node.rb (lib/capybara/cuprite/node.rb)
- Low cohesion: Page (LCOM4 4) (lib/capybara/cuprite/page.rb)
- No SBOM
- No artifact signing
- No build provenance
- Unpinned build actions
- Workflow token permissions not restricted (.github/workflows/docs.yml)

## Changes since last survey

- 74 commits — 71 feature/other, 3 fixes

## By area

- (root) — 39 commits
- lib/capybara — 29 commits
- spec/features — 2 commits
- .github/workflows — 1 commit
- docs/13-screenshots.md — 1 commit
- docs/6-node.md — 1 commit
- spec/support — 1 commit

## Notable commits

- fix: fix(node): keep Node#attributes, Ferrum has no counterpart
- fix: fix(node): pass the color input value to JavaScript as an argument
- fix: fix(page): leave touch emulation alone on resize unless mobile is set (#352)
- change: chore(deps): drop the ferrum pin from Gemfile now that 0.20.1 is released
- change: chore(release): bump version to 0.20
- change: chore: drop Ruby 3.1 support (#348)
- change: ci(docs): notify docs.rubycdp.com on release tags (#358)
- change: docs(page): explain why the dialog handler skips Page#command
- change: docs: document Node#property and Node#attributes
- change: docs: fix drag_by example and changelog order
- change: docs: fix page.driver.reset! name in README
- change: docs: introduce page.driver.browser as the Ferrum API
- change: docs: note Ferrum 0.20 upgrade impact and base_url override in changelog
- change: docs: point deprecated driver methods to their replacements
- change: docs: wrap changelog line
- change: feat(driver): expose Ferrum console as Driver#console (#351)
- change: feat(driver): set Ferrum's base_url from Capybara so cookies default their domain
- change: ref(browser): deprecate Browser#visit and Browser#status_code in favor of goto and network.status
- change: ref(browser): deprecate Browser#window_handle in favor of current_window_handle
- change: ref(browser): make Browser#find private, remove active_element and within_window
- …and 54 more

## Architecture

- Unchanged — 0 containers · 1 contexts · 0 edges
