ace-overseer 0.18.2 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3fe6826e192a1bb720405c3b53d7fa5f61faeb3bf382ecdef6bfddcc3497c69
-  data.tar.gz: e46d2230ef2aac4b5e3c6eea8b3545d25efcdcc9b9481220a2efb6c922ff6102
+  metadata.gz: ac2050e4e153d6bed54441f8b9a64aaea6a6bc4bcefc06413e4b7187487a20dc
+  data.tar.gz: e430481b7d4824d5359f7e61f3d575c3e96311af90f3f07f79eacf6952a871da
 SHA512:
-  metadata.gz: 4b02701a464f6717a60095b7c29e4e05fa86a80a96885805c378a6fd7d26b265badc57ba17d318a7142364571729916edf15f23ac61bc66c2a96fd10ddf0a01a
-  data.tar.gz: 533d1502fc901da26569f44aa31e085489b639eac47418dba12b9f97e3987fee7fbb6d572dd8ff3ff57908accbc0f1355ab76a5bf043dc52cad880d8a641aea4
+  metadata.gz: 3106447b37e8b3e4faa21799da47441d1ce2b327231243148830480f507c490c86ec602b0fba2e8b1a5c1d7d584e8c7c92e26ce038b7a7a050e5cd6adf0c7801
+  data.tar.gz: e27c30a6e6e2cc318c05a348b6e01acbe4f6c5c692784512f1531830725edcd6210f65db5f9430f95f9fe0a9debe91732579534b091f4fc3d33f0230ed7911b6

data/.ace-defaults/overseer/config.yml

@@ -1,5 +1,6 @@
 default_assign_preset: "work-on-task"
-tmux_window_presets:
+runtime: auto # tmux | herdr | auto
+window_presets:
   "work-on-task": "work-on-task"
 watch:
   refresh_interval: 15

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.19.0] - 2026-10-04
+
+### Added
+- Work-on and prune manage worktree windows through the `ace-runtime` contract (`TmuxWindowOpener` replaced by `WindowOpener`); the terminal runtime comes from the new `runtime:` config key (`tmux` | `herdr` | `auto`; `ACE_RUNTIME` env wins, detection as fallback, explicit fail when nothing is live).
+- Config key `tmux_window_presets` renamed to `window_presets` (no legacy alias, ADR-024); "tmux window" progress text is runtime-neutral.
+- New dependency: `ace-runtime` (~> 0.1); `ace-tmux` is kept to install the tmux adapter.
+
 ## [0.18.2] - 2026-10-02
 
 ### Technical

data/README.md

@@ -18,7 +18,7 @@
 
 ![ace-overseer demo](docs/demo/ace-overseer-getting-started.gif)
 
-Starting task work means creating a worktree, opening a tmux window, and preparing an assignment - three manual steps before you even begin coding. ace-overseer collapses that into a single command, tracks what is running where, and cleans up finished worktrees so nothing lingers. You can jump straight to a focused worktree any time with a single invocation.
+Starting task work means creating a worktree, opening a terminal window, and preparing an assignment - three manual steps before you even begin coding. ace-overseer collapses that into a single command, tracks what is running where, and cleans up finished worktrees so nothing lingers. You can jump straight to a focused worktree any time with a single invocation.
 
 On a configured Lab machine, the same CLI can prepare and dispatch the Lab's
 system-owned `Work` objects. The default remains the existing tmux runtime;
@@ -27,8 +27,8 @@ using Lab always requires an explicit `--runtime lab` or a Lab-only command.
 ## How It Works
 
 1. Resolve task refs and create a scoped worktree.
-2. Route assignment creation through `ace-assign create --task ...`, which expands the assignment preset into concrete steps under `.ace-local/assign/`, then open a dedicated tmux window mapped to that worktree.
-3. Instruct the agent inside the tmux window to act as an orchestrator and drive the assignment step-by-step.
+2. Route assignment creation through `ace-assign create --task ...`, which expands the assignment preset into concrete steps under `.ace-local/assign/`, then open a dedicated terminal window mapped to that worktree.
+3. Instruct the agent inside the terminal window to act as an orchestrator and drive the assignment step-by-step.
 
 ## Use Cases
 

data/docs/usage.md

@@ -102,6 +102,24 @@ Check dashboard: `ace-overseer status`.
 
 Preview then prune: `ace-overseer prune --dry-run`, then `ace-overseer prune --yes`.
 
+## Terminal Runtime Configuration
+
+Work-on opens the task's terminal window and prune closes it through the
+runtime-neutral `ace-runtime` contract. Select the terminal runtime in
+`.ace/overseer/config.yml`:
+
+```yaml
+# tmux | herdr | auto (default) — auto detects tmux first, then herdr;
+# ACE_RUNTIME env wins over this key; nothing detected fails explicitly
+runtime: auto
+window_presets:
+  "work-on-task": "work-on-task"   # preset applied to the opened window/tab
+```
+
+The preset key is `window_presets` (renamed from `tmux_window_presets`
+pre-1.0; there is no legacy alias). The same configured runtime closes a
+worktree's window during accepted prunes.
+
 Prune migrated work with a declared destination:
 
 ```bash

data/lib/ace/overseer/atoms/runtime_setting.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Ace
+  module Overseer
+    module Atoms
+      # Normalizes the overseer `runtime:` config setting into a contract
+      # runtime name. The shipped default is `auto`, which is an
+      # overseer-level instruction to detect, never a contract runtime
+      # name; it normalizes to nil so the selector falls through to
+      # ACE_RUNTIME / detection.
+      module RuntimeSetting
+        module_function
+
+        def normalize(value)
+          normalized = value.to_s.strip
+          normalized.empty? || normalized == "auto" ? nil : normalized
+        end
+      end
+    end
+  end
+end

data/lib/ace/overseer/molecules/window_opener.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "ace/runtime"
+
+module Ace
+  module Overseer
+    module Molecules
+      # Opens the task's terminal window through the runtime contract.
+      # The window is named after the worktree basename under the shared
+      # naming policy and rooted at the worktree path.
+      class WindowOpener
+        def initialize(runtime: nil, config: nil, env: ENV)
+          @runtime = runtime
+          @config = config || Ace::Overseer.config
+          @env = env
+        end
+
+        def open(worktree_path:, preset: nil)
+          name = Ace::Runtime.sanitize_name(File.basename(worktree_path.to_s))
+          adapter.ensure_window(
+            name: name,
+            root: File.expand_path(worktree_path.to_s),
+            preset: preset
+          )
+          name
+        rescue Ace::Runtime::Error => e
+          raise Error, "Failed to open terminal window for #{worktree_path}: #{e.message}"
+        end
+
+        private
+
+        attr_reader :config, :env
+
+        def adapter
+          @adapter ||= @runtime || Ace::Runtime::Molecules::RuntimeSelector.new(
+            config: {runtime: Atoms::RuntimeSetting.normalize(config["runtime"])},
+            env: env
+          ).resolve
+        end
+      end
+    end
+  end
+end

data/lib/ace/overseer/organisms/prune_orchestrator.rb

@@ -19,12 +19,12 @@ module Ace
       # revalidation blocks; it only suppresses the interactive confirmation
       # for already-safe candidates.
       class PruneOrchestrator
-        def initialize(worktree_manager: nil, prune_checker: nil, tmux_executor: nil, config: nil,
+        def initialize(worktree_manager: nil, prune_checker: nil, runtime: nil, config: nil,
           assignment_prune_checker: nil, assignment_manager: nil, lifecycle_exclusion: nil,
           preservation_manifest_loader: nil)
           @worktree_manager = worktree_manager || Ace::Git::Worktree::Organisms::WorktreeManager.new
           @prune_checker = prune_checker || Molecules::PruneSafetyChecker.new
-          @tmux_executor = tmux_executor || Ace::Tmux::Molecules::TmuxExecutor.new
+          @runtime = runtime
           @config = config || Ace::Overseer.config
           @assignment_prune_checker = assignment_prune_checker || Molecules::AssignmentPruneSafetyChecker.new
           @assignment_manager = assignment_manager || Ace::Assign::Molecules::AssignmentManager.new
@@ -168,7 +168,7 @@ module Ace
           )
           return remove_result unless remove_result[:success]
 
-          close_tmux_window(candidate.worktree_path)
+          close_runtime_window(candidate.worktree_path)
           # Only the branch the recheck verified is deletable — never a
           # freshly observed branch name.
           branch_result = delete_branch(repo, branch: verified_branch, head: verified_head)
@@ -385,16 +385,21 @@ module Ace
           progress.call("Warning: failed to prune stale worktree metadata: #{e.message}")
         end
 
-        def close_tmux_window(worktree_path)
-          window_name = File.basename(worktree_path)
-          tmux_bin = @config["tmux_binary"] || "tmux"
-          session_name = @tmux_executor.run([tmux_bin, "display-message", "-p", "#S"]).to_s.strip
-          return false if session_name.empty?
-
-          @tmux_executor.run([tmux_bin, "kill-window", "-t", "#{session_name}:#{window_name}"])
-        rescue
+        def close_runtime_window(worktree_path)
+          window_name = Ace::Runtime.sanitize_name(File.basename(worktree_path.to_s))
+          runtime.close_window(window: window_name)
+          true
+        rescue StandardError
+          # Terminal cleanup must never fail the prune; a window that
+          # could not be closed is left in place.
           false
         end
+
+        def runtime
+          @runtime ||= Ace::Runtime::Molecules::RuntimeSelector.new(
+            config: {runtime: Atoms::RuntimeSetting.normalize(@config["runtime"])}
+          ).resolve
+        end
       end
     end
   end

data/lib/ace/overseer/organisms/work_on_orchestrator.rb

@@ -7,10 +7,10 @@ module Ace
         # B36TS subtask pattern: "8pp.t.q7w.a" (parent 9-char ID + dot + single char)
         SUBTASK_PATTERN = /^[0-9a-z]{3}\.[a-z]\.[0-9a-z]{3}\.[a-z0-9]$/
 
-        def initialize(worktree_provisioner: nil, tmux_window_opener: nil, assignment_launcher: nil,
+        def initialize(worktree_provisioner: nil, window_opener: nil, assignment_launcher: nil,
           task_loader: nil, config: nil, assignment_detector: nil, lifecycle_exclusion: nil)
           @worktree_provisioner = worktree_provisioner || Molecules::WorktreeProvisioner.new
-          @tmux_window_opener = tmux_window_opener || Molecules::TmuxWindowOpener.new
+          @window_opener = window_opener || Molecules::WindowOpener.new
           @task_manager = task_loader || Ace::Task::Organisms::TaskManager.new
           @assignment_launcher = assignment_launcher || Molecules::AssignmentLauncher.new(task_manager: @task_manager)
           @config = config || Ace::Overseer.config
@@ -47,7 +47,7 @@ module Ace
 
           expanded_taskrefs = expand_task_refs_in_order(resolved_refs)
           primary_subtask_refs = extract_subtask_refs(primary_task)
-          tmux_preset = @config.dig("tmux_window_presets", preset_name)
+          window_preset = @config.dig("window_presets", preset_name)
 
           # Participate in prune exclusion for the whole start: provisioning,
           # runtime window and assignment launch all hold the shared side of
@@ -67,10 +67,10 @@ module Ace
               progress.call("Worktree exists at #{worktree[:worktree_path]}")
             end
 
-            progress.call("Opening tmux window...")
-            @tmux_window_opener.open(
+            progress.call("Opening terminal window...")
+            @window_opener.open(
               worktree_path: worktree[:worktree_path],
-              preset: tmux_preset
+              preset: window_preset
             )
 
             progress.call("Checking assignment status...")

data/lib/ace/overseer/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Overseer
-    VERSION = "0.18.2"
+    VERSION = "0.19.0"
   end
 end

data/lib/ace/overseer.rb

@@ -6,7 +6,7 @@ require "ace/assign"
 require "ace/git"
 require "ace/git/worktree"
 require "ace/task"
-require "ace/tmux"
+require "ace/runtime"
 
 module Ace
   module Overseer
@@ -21,10 +21,11 @@ require_relative "overseer/models/assignment_prune_candidate"
 require_relative "overseer/models/preservation_proof"
 require_relative "overseer/atoms/repo_guard"
 require_relative "overseer/atoms/preset_resolver"
+require_relative "overseer/atoms/runtime_setting"
 require_relative "overseer/atoms/status_formatter"
 require_relative "overseer/molecules/worktree_provisioner"
 require_relative "overseer/molecules/lab_client"
-require_relative "overseer/molecules/tmux_window_opener"
+require_relative "overseer/molecules/window_opener"
 require_relative "overseer/molecules/assignment_launcher"
 require_relative "overseer/molecules/worktree_context_collector"
 require_relative "overseer/molecules/preservation_manifest"

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-overseer
 version: !ruby/object:Gem::Version
-  version: 0.18.2
+  version: 0.19.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-02 00:00:00.000000000 Z
+date: 2026-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.61'
+        version: '0.62'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.61'
+        version: '0.62'
 - !ruby/object:Gem::Dependency
   name: ace-git
   requirement: !ruby/object:Gem::Requirement
@@ -99,14 +99,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.25'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '0.25'
 - !ruby/object:Gem::Dependency
   name: ace-task
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +121,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.37'
+- !ruby/object:Gem::Dependency
+  name: ace-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: ace-tmux
   requirement: !ruby/object:Gem::Requirement
@@ -220,6 +234,7 @@ files:
 - lib/ace/overseer.rb
 - lib/ace/overseer/atoms/preset_resolver.rb
 - lib/ace/overseer/atoms/repo_guard.rb
+- lib/ace/overseer/atoms/runtime_setting.rb
 - lib/ace/overseer/atoms/status_formatter.rb
 - lib/ace/overseer/cli.rb
 - lib/ace/overseer/cli/commands/agents.rb
@@ -242,7 +257,7 @@ files:
 - lib/ace/overseer/molecules/lab_prune_safety_checker.rb
 - lib/ace/overseer/molecules/preservation_manifest.rb
 - lib/ace/overseer/molecules/prune_safety_checker.rb
-- lib/ace/overseer/molecules/tmux_window_opener.rb
+- lib/ace/overseer/molecules/window_opener.rb
 - lib/ace/overseer/molecules/worktree_context_collector.rb
 - lib/ace/overseer/molecules/worktree_provisioner.rb
 - lib/ace/overseer/organisms/prune_orchestrator.rb

data/lib/ace/overseer/molecules/tmux_window_opener.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require "ace/tmux"
-
-module Ace
-  module Overseer
-    module Molecules
-      class TmuxWindowOpener
-        def initialize(tmux_window_command: nil, tmux_executor: nil)
-          @tmux_window_command = tmux_window_command || Ace::Tmux::CLI::Commands::Window.new
-          @tmux_executor = tmux_executor || Ace::Tmux::Molecules::TmuxExecutor.new
-        end
-
-        def open(worktree_path:, preset: nil)
-          ensure_session_exists
-          return if window_already_open?(worktree_path)
-
-          @tmux_window_command.call(
-            root: worktree_path.to_s,
-            preset: preset,
-            quiet: true,
-            session: ENV["ACE_TMUX_SESSION"]
-          )
-        end
-
-        private
-
-        def ensure_session_exists
-          session = ENV["ACE_TMUX_SESSION"]
-          return unless session && !session.empty?
-          return if @tmux_executor.capture(["tmux", "has-session", "-t", session]).success?
-
-          created = @tmux_executor.run(["tmux", "new-session", "-d", "-s", session])
-          raise "Failed to create tmux session '#{session}'" unless created
-        end
-
-        def window_already_open?(worktree_path)
-          session = ENV["ACE_TMUX_SESSION"]
-          return false unless session
-
-          name = Ace::Tmux::Atoms::WindowNameSanitizer.call(File.basename(worktree_path.to_s))
-          result = @tmux_executor.capture(["tmux", "list-windows", "-t", session, "-F", '#{window_name}'])
-          return false unless result.success?
-
-          result.stdout.split("\n").any? { |w| w.strip == name }
-        rescue
-          false
-        end
-      end
-    end
-  end
-end