browserctl 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db03c20d156ddbfc0c81267889ce46be79cb9973f2ff55af65739ddfe370f9f6
-  data.tar.gz: 712a9ffd6206cd0c1e3614d0d7230bb1c998beed56d315313328b0c768c5d3ea
+  metadata.gz: 2976bab368591b4cb06cd3a34d64c1078bd8588590d70c67ba3d78ecd721e572
+  data.tar.gz: 0fa9c86ec532df2c6763780bfb6c2ac47380ff1df400ae2639fe914fc66e0d04
 SHA512:
-  metadata.gz: 7780abfa304abcbfb252fee4a41ff5bd592275e8fe6ac66b30ab3e2022b8e0a48c94b046458f5d10b215cef89f75c94691de16b0158378357f863bf6a2dc5a15
-  data.tar.gz: d7b0051c9b2c13bf79313cb0e5edb58062ebe4a9ae9a77a836a2e1394a5f537d72aa2bf61bbb3003dcb30d8eef66cd873d68b6cda394eb9a5c6f078ae6143c90
+  metadata.gz: ef5ab4df359bde2cc6b635f6ac77c1147df57e85c57ff61222179f223e4d41ef4d58b622aa928cde19c41b1927d6ebafd273847ada8c55bf74cfdc09b6ddb5c7
+  data.tar.gz: 0af88adb9b7076a4408c65ac25e7d13fd0f70aa2cdf79448fe9be7953695bd12de01d9c98626628163ce8edb738b4d2c83a925a77e2504924b1ee6bfe85c39d3

data/CHANGELOG.md

@@ -5,24 +5,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.1.1](https://github.com/patrick204nqh/browserctl/compare/v0.1.0...v0.1.1) (2026-04-19)
 
-### Fixed
-- Thread safety: all server dispatch calls now protected by a Mutex
-- `fill` no longer queries the DOM twice; returns an error if selector is not found
-- `click` now returns an error when the selector is not found instead of silently succeeding
-- `wait_for` now polls for the selector until timeout instead of checking once after network idle
-- Circular workflow `invoke` calls now raise a descriptive `WorkflowError`
 
-### Added
-- GitHub Actions CI (lint + test across Ruby 3.2–3.4)
-- Gemspec metadata: `changelog_uri`, `source_code_uri`, `bug_tracker_uri`, `rubygems_mfa_required`
+### Bug Fixes
+
+* resolve rubocop offenses in gemspec ([dfb67dc](https://github.com/patrick204nqh/browserctl/commit/dfb67dc135d9538847a2b58a17d1dd03b7ab4b45))
+* synchronize access to pages in CommandDispatcher methods ([c61d129](https://github.com/patrick204nqh/browserctl/commit/c61d129076026d8cae200fdbebb2337f9feccd70))
 
-## [0.1.0] - 2025-01-01
+## [0.1.0] - 2026-04-19
 
 ### Added
-- Initial release: persistent browser daemon (`browserd`) over Unix socket
-- CLI (`browserctl`) with commands: open, close, pages, goto, fill, click, shot, snap, url, eval, ping, shutdown
-- Ruby workflow DSL with params, steps, assertions, and `invoke`
-- AI-optimized DOM snapshot format (JSON with ref IDs)
-- Ferrum-backed Chrome/Chromium automation
+- Persistent browser daemon (`browserd`) over Unix socket — preserves cookies, localStorage, and open tabs across discrete commands
+- CLI (`browserctl`) with commands: `open`, `close`, `pages`, `goto`, `fill`, `click`, `shot`, `snap`, `url`, `eval`, `ping`, `shutdown`
+- Ruby workflow DSL with `param`, `step`, `assert`, `page(:name)`, and `invoke` for composing workflows
+- AI-optimized DOM snapshot format (`snap --format ai`) — compact JSON array of interactable elements with stable ref IDs
+- Ferrum-backed Chrome/Chromium automation via Chrome DevTools Protocol
+- Named page handles — multiple pages open simultaneously under descriptive names
+- `wait_for(selector, timeout:)` — polls until an element appears, useful for async content
+- Workflow search paths: `.browserctl/workflows/` (project) and `~/.browserctl/workflows/` (user)
+- `browserctl run <name|file.rb>` — run workflows by name or directly by file path
+- `browserctl workflows` and `browserctl describe <name>` — discover and inspect available workflows
+- GitHub Actions CI: lint (RuboCop) and integration tests
+- Gemspec metadata: `changelog_uri`, `source_code_uri`, `bug_tracker_uri`, `rubygems_mfa_required`
+- Release automation via release-please and RubyGems push on `v*.*.*` tags
+- AI agent skill (`skills/browserctl/SKILL.md`) with probe-before-workflow guidance
+- Workflow authoring guide (`docs/writing-workflows.md`)
+- Smoke test examples against the-internet.herokuapp.com with auto-generated screenshots
+
+### Fixed
+- Thread safety: all server dispatch calls protected by a Mutex
+- `fill` returns an error when selector is not found instead of querying the DOM twice
+- `click` returns an error when selector is not found instead of silently succeeding
+- `wait_for` polls for the selector until timeout instead of checking once after network idle
+- Circular workflow `invoke` calls raise a descriptive `WorkflowError`
+- Chrome launch on CI: added `--no-sandbox` and `--disable-dev-shm-usage` flags for container environments
+- Daemon shutdown no longer hangs: `browser.quit` is wrapped in a 5s timeout; `stop_daemon` sends `SIGKILL` as a fallback after grace period

data/lib/browserctl/server/command_dispatcher.rb

@@ -20,10 +20,11 @@ module Browserctl
       "shutdown" => :cmd_shutdown
     }.freeze
 
-    def initialize(pages, browser, snapshot_builder = SnapshotBuilder.new)
+    def initialize(pages, browser, snapshot_builder = SnapshotBuilder.new, mutex: Mutex.new)
       @pages    = pages
       @browser  = browser
       @snapshot = snapshot_builder
+      @mutex    = mutex
     end
 
     def dispatch(req)
@@ -36,18 +37,21 @@ module Browserctl
     private
 
     def cmd_open_page(req)
-      page = @pages[req[:name]] ||= @browser.create_page
+      page = @mutex.synchronize { @pages[req[:name]] } || begin
+        new_page = @browser.create_page
+        @mutex.synchronize { @pages[req[:name]] ||= new_page }
+      end
       page.go_to(req[:url]) if req[:url]
       { ok: true, name: req[:name] }
     end
 
     def cmd_close_page(req)
-      @pages.delete(req[:name])&.close
+      @mutex.synchronize { @pages.delete(req[:name]) }&.close
       { ok: true }
     end
 
     def cmd_list_pages(_req)
-      { pages: @pages.keys }
+      { pages: @mutex.synchronize { @pages.keys } }
     end
 
     def cmd_goto(req)
@@ -126,7 +130,7 @@ module Browserctl
     end
 
     def with_page(name)
-      page = @pages[name]
+      page = @mutex.synchronize { @pages[name] }
       return { error: "no page named '#{name}'" } unless page
 
       yield page

data/lib/browserctl/server.rb

@@ -13,7 +13,7 @@ module Browserctl
   class Server
     def initialize(headless: true)
       prepare_runtime(headless)
-      @dispatcher = CommandDispatcher.new(@pages, @browser)
+      @dispatcher = CommandDispatcher.new(@pages, @browser, mutex: @mutex)
     end
 
     def run
@@ -35,12 +35,12 @@ module Browserctl
     end
 
     def init_browser(headless)
-      Ferrum::Browser.new(
-        headless: headless,
-        timeout: 30,
-        process_timeout: 30,
-        browser_options: { "no-sandbox" => nil, "disable-dev-shm-usage" => nil, "disable-gpu" => nil }
-      )
+      Ferrum::Browser.new(headless: headless, **ferrum_options)
+    end
+
+    def ferrum_options
+      { timeout: 30, process_timeout: 30,
+        browser_options: { "no-sandbox" => nil, "disable-dev-shm-usage" => nil, "disable-gpu" => nil } }
     end
 
     def init_state
@@ -76,19 +76,24 @@ module Browserctl
     end
 
     def handle(socket)
-      if (line = socket.gets)
-        @mutex.synchronize { @last_used = Time.now }
-        socket.puts JSON.generate(process(line))
-      end
+      dispatch(socket, socket.gets)
     rescue StandardError => e
       quietly { socket.puts JSON.generate({ error: e.message }) }
     ensure
       quietly { socket.close }
     end
 
+    def dispatch(socket, line)
+      return unless line
+
+      @mutex.synchronize { @last_used = Time.now }
+      socket.puts JSON.generate(process(line))
+    end
+
     def process(line)
       req = JSON.parse(line.chomp, symbolize_names: true)
-      @mutex.synchronize { @dispatcher.dispatch(req) }
+      @mutex.synchronize { @last_used = Time.now }
+      @dispatcher.dispatch(req)
     end
 
     def teardown(idle, server)

data/lib/browserctl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Browserctl
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: browserctl
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Patrick
@@ -80,8 +80,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.65'
-description: Ferrum-backed browser daemon with a CLI and Ruby workflow DSL, designed
-  for AI agent use.
+description: Named browser sessions, Ruby workflow DSL, and a token-efficient DOM
+  snapshot format. Built on Ferrum (Chrome DevTools Protocol).
 email:
 - patrick204nqh@gmail.com
 executables:
@@ -144,5 +144,6 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Persistent browser automation daemon + CLI for AI agents
+summary: Persistent browser automation daemon and CLI for AI agents and developer
+  workflows
 test_files: []