ace-overseer 0.13.9 → 0.15.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4267353d4b28e609ce53853dedd016a4e4f3d6155abe6d9e4098417a38fab460
-  data.tar.gz: 69141dbe8fa9bd0bd182f2bd7dbbcd38eeaf43c120d22b5cbe591dca454abd08
+  metadata.gz: 3ad5c1cd73b433965d9e8ac955ca8230dd677c6c5067bcdee1a2ff6427603deb
+  data.tar.gz: efa22f74cc5af23a2e686c924558ca276d539369646f89825739b5255c3d307d
 SHA512:
-  metadata.gz: e422836882f2d5da8176c1a27072379c7d487555b7a0764c6a60f7a63babb4722e197f1a3487e5d79d73cef667db2fdea1b35d0eb51af53ec526efd0aaf70899
-  data.tar.gz: c9082cbcb5e4ca4d9a0475c4f0cb31fb13848024812bccee23fe53d2871e25547bff939951c2bcee3a87e247a6db9a8b20cb4b0ed33c9b86ec3a6ae6f12fff21
+  metadata.gz: 819bcbfad49d1edacfb604f39727573b83524c8fd49370ca35f8ff342f0a24850e7f25e8de59f1097f3c1d644fac2721a05bd0cae92df34231d0d4dfe6511f1e
+  data.tar.gz: 4cc5095cf8a5189e1b000234eda8fda11f8d841a7e8f3c294ca0756477e6f0e4b90aa84b9854c3648c6a783128c08bf4472fb5fd15b3501a09dec8b0f0bdc60a

data/CHANGELOG.md

@@ -6,6 +6,132 @@ 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).
 
 ## [Unreleased]
+### Fixed
+- Updated the `ace-tmux` runtime dependency constraint to `~> 0.17` so overseer stays compatible with the current tmux runtime control release line.
+
+## [0.15.3] - 2026-04-23
+
+### Technical
+- Tightened retained `status --watch` E2E coverage to use a controlled bounded-session shutdown with explicit command captures, keeping refresh verification aligned with the documented watch contract.
+
+## [0.15.2] - 2026-04-23
+
+### Technical
+- Aligned retained `work-on` E2E verification with the current prepared-assignment contract so post-launch status accepts `paused` plus `next_step` until `/ace-assign-drive` actually starts work.
+
+## [0.15.1] - 2026-04-23
+
+### Technical
+- Updated the `ace-git-worktree` runtime dependency constraint to `~> 0.21` so overseer stays aligned with the current worktree minor release line.
+
+## [0.15.0] - 2026-04-23
+
+### Changed
+- Updated overseer status collection, formatting, and work-on orchestration to consume `ace-assign`'s `active_steps`/`next_step` lifecycle contract instead of the old singular `current_step`/`in_progress` model.
+- Revised overseer test fixtures and resume behavior so existing assignments now prefer the focused active step and otherwise fall back to the next pending step in scope.
+
+## [0.14.14] - 2026-04-23
+
+
+### Changed
+- Reworked tmux window-open behavior to align with shared session targeting and reduce ambiguity when launching and reusing worktree windows.
+- Updated overseer tmux-window coverage to verify the current session/window lifecycle against the improved launcher behavior.
+
+
+## [0.14.13] - 2026-04-22
+
+### Fixed
+- Matched existing tmux windows through the shared `ace-tmux` sanitized window-name policy so worktrees with punctuation are not reopened under duplicate names.
+
+## [0.14.12] - 2026-04-19
+
+### Technical
+- Tightened retained overseer E2E runner and verifier contracts so `work-on` postcondition captures cannot run before the primary command has completed, and preset-override verification requires public `r8x` worktree evidence.
+
+## [0.14.11] - 2026-04-18
+
+### Technical
+- Relaxed retained watch-mode E2E verification to tolerate bounded `Open3` stream-closure noise when the visible `status --watch` behavior and controlled shutdown codes are otherwise correct.
+
+## [0.14.10] - 2026-04-16
+
+### Fixed
+- Normalized `status --watch` interrupt handling so watch-mode exits no longer dump a Ruby stack trace, and aligned retained E2E verification with the bounded termination codes the command now emits.
+
+## [0.14.9] - 2026-04-16
+
+### Fixed
+- Reused the orchestrator task manager when launching default assignments so multi-task `work-on` flows no longer partially provision a task and then fail lookup against a different task-resolution path.
+
+## [0.14.8] - 2026-04-16
+
+### Fixed
+- Relaxed `TS-OVERSEER-001` prune verification to judge the documented public prune flow from captured dry-run/prune artifacts and resulting state instead of requiring echoed command lines.
+
+## [0.14.7] - 2026-04-16
+
+### Fixed
+- Taught tmux window opening to create the target session when it is missing so sandboxed overseer E2E runs can open task windows reliably on the intended socket.
+
+## [0.14.6] - 2026-04-15
+
+### Changed
+- Reworked `TS-OVERSEER-001` into a public-surface goal contract by absorbing standalone help survey into Goal 2 preflight, simplifying prune flow to normal lifecycle commands, and tightening rerun/override checks to stable status/worktree oracles.
+- Added `TS-OVERSEER-002` status-and-operations coverage with watch-refresh and multi-task bundle journeys.
+- Updated `docs/usage.md` with explicit public verification paths for preset override, idempotent rerun, and minimal prune lifecycle checks.
+
+### Fixed
+- Updated the `ace-assign` runtime dependency constraint to `~> 0.53` so overseer remains aligned with the current assign minor release line.
+
+## [0.14.4] - 2026-04-13
+
+### Fixed
+- Rewrote the retained `TS-OVERSEER-001` workflow-value cases around final sandbox state and runner observations so preset-override and prune verification no longer depend on brittle helper artifacts.
+
+## [0.14.3] - 2026-04-13
+
+### Fixed
+- Tightened `TS-OVERSEER-001` preset-override and prune scenario contracts so path-check artifacts are explicit and optional pre-completion status captures no longer fail the workflow before semantic verification.
+
+## [0.14.2] - 2026-04-13
+
+### Fixed
+- Updated the `ace-assign` runtime dependency constraint to `~> 0.49` so overseer remains compatible with the new assign minor release line.
+
+## [0.14.1] - 2026-04-13
+
+### Changed
+- Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
+
+### Technical
+- Included in the coordinated assignment-driven patch release for batch i05 package updates.
+
+
+## [0.14.0] - 2026-04-12
+
+### Changed
+- Migrated package tests to the `fast` / `feat` / `e2e` model by moving deterministic coverage from `test/{atoms,commands,models,molecules,organisms}` into `test/fast/*`.
+- Added E2E migration decision tracking for `TS-OVERSEER-001` via `test/e2e/TS-OVERSEER-001-overseer-workflow/e2e-decision-record.md`.
+- Updated package README testing guidance to teach only `ace-test ace-overseer`, `ace-test ace-overseer feat`, `ace-test ace-overseer all`, and `ace-test-e2e ace-overseer`.
+
+### Fixed
+- Hardened `TS-OVERSEER-001` sandbox setup by loading `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}`.
+- Updated TC-002/TC-003 verifier expectations to use the JSON status oracle and task-window-scoped tmux duplicate checks, eliminating false negatives in rerun validation.
+
+## [0.13.12] - 2026-04-12
+
+### Fixed
+- Updated the `ace-git-worktree` runtime dependency constraint to `~> 0.20` so overseer remains compatible with the new worktree minor release line.
+
+## [0.13.11] - 2026-04-11
+
+### Fixed
+- Updated the `ace-assign` runtime dependency constraint to `~> 0.47` so overseer remains compatible with the latest assign minor release line.
+
+## [0.13.10] - 2026-04-07
+
+### Fixed
+- Updated the `ace-assign` runtime dependency constraint to `~> 0.44` so overseer remains compatible with the new assign minor release line.
 
 ## [0.13.9] - 2026-04-01
 

data/README.md

@@ -46,5 +46,17 @@ ace-overseer status --watch
 
 **Customize the workflow** - the full pipeline is defined in two layers: the [assignment preset](../ace-assign/.ace-defaults/assign/presets/work-on-task.yml) controls which steps run and in what order (onboard, implement, test, release, review, PR), while each step references a [workflow instruction](../ace-task/handbook/workflow-instructions/task/work.wf.md) that defines how it executes. Browse [available presets](../ace-assign/.ace-defaults/assign/presets/) or create your own to tailor the pipeline to your project.
 
+For explicit end-to-end validation paths, see [Public Verification Paths](docs/usage.md#public-verification-paths).
+
+## Testing
+
+- `ace-test ace-overseer` runs deterministic fast coverage from `test/fast/`.
+- `ace-test ace-overseer feat` runs deterministic feature coverage from `test/feat/` when present.
+- `ace-test ace-overseer all` runs fast + feat deterministic coverage.
+- `ace-test-e2e ace-overseer` runs retained workflow scenarios from `test/e2e/`.
+
+The package no longer uses deterministic `*_test.rb` files under `test/e2e/` and
+does not use `ace-test ace-overseer e2e` as a deterministic test path.
+
 ---
 [Getting Started](docs/getting-started.md) | [Usage Guide](docs/usage.md) | [Handbook - Skills, Agents, Templates](docs/handbook.md) | Part of [ACE](https://github.com/cs3b/ace)

data/docs/usage.md

@@ -72,3 +72,27 @@ Start task work: `ace-overseer work-on --task 8q4.t.umu.1`.
 Check dashboard: `ace-overseer status`.
 
 Preview then prune: `ace-overseer prune --dry-run`, then `ace-overseer prune --yes`.
+
+## Public Verification Paths
+
+Use these user-visible checks when validating behavior end-to-end:
+
+- Preset override path:
+
+  1. `ace-overseer work-on --task <task-ref> --preset <preset-name>`
+  2. `ace-git-worktree list` (confirm worktree exists for `<task-ref>`)
+  3. `ace-overseer status --format json` (confirm the task appears with assignment/preset details)
+
+- Idempotent rerun oracle:
+
+  1. Run `ace-overseer work-on --task <task-ref>` twice
+  2. Verify one task entry remains in `ace-overseer status --format json`
+  3. Verify only one matching worktree exists in `ace-git-worktree list`
+
+- Prune lifecycle minimal flow:
+
+  1. `ace-task done <task-ref>`
+  2. `ace-overseer prune --dry-run`
+  3. `ace-overseer prune --yes`
+  4. `ace-git-worktree list` to confirm removed vs retained task worktrees
+  5. `ace-overseer prune --dry-run` to confirm no remaining safe candidates

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

@@ -128,9 +128,14 @@ module Ace
           bar = progress_bar(done.to_i, total.to_i)
           counts = "#{done}/#{total}"
           counts = "#{counts} (#{failed} failed)" if failed.positive?
-          current = assignment["current_step"] || assignment[:current_step]
+          active_steps = assignment["active_steps"] || assignment[:active_steps]
+          next_step = assignment["next_step"] || assignment[:next_step]
           parts = "#{bar} #{counts}"
-          parts = "#{parts} #{colorize(current, :dim)}" if current
+          if active_steps.is_a?(Array) && !active_steps.empty?
+            parts = "#{parts} #{colorize(active_steps.join(", "), :dim)}"
+          elsif next_step
+            parts = "#{parts} #{colorize("next: #{next_step}", :dim)}"
+          end
           parts
         end
         private_class_method :format_progress

data/lib/ace/overseer/cli/commands/status.rb

@@ -31,6 +31,8 @@ module Ace
             else
               run_once(format)
             end
+          rescue Interrupt
+            nil
           rescue => e
             raise Ace::Support::Cli::Error.new(e.message)
           end

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

@@ -1,14 +1,18 @@
 # frozen_string_literal: true
 
+require "ace/tmux"
+
 module Ace
   module Overseer
     module Molecules
       class TmuxWindowOpener
-        def initialize(tmux_window_command: nil)
+        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(
@@ -21,13 +25,21 @@ module Ace
 
         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 = File.basename(worktree_path.to_s)
-          executor = Ace::Tmux::Molecules::TmuxExecutor.new
-          result = executor.capture(["tmux", "list-windows", "-t", session, "-F", '#{window_name}'])
+          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 }

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

@@ -54,7 +54,8 @@ module Ace
         end
 
         def assignment_info_to_h(info)
-          current = info.queue_state.current
+          active_steps = info.queue_state.active_steps
+          next_step = active_steps.empty? ? info.queue_state.next_workable : nil
           {
             "assignment" => {
               "id" => info.id,
@@ -65,10 +66,11 @@ module Ace
               "total" => info.queue_state.summary[:total],
               "done" => info.queue_state.summary[:done],
               "failed" => info.queue_state.summary[:failed],
-              "in_progress" => info.queue_state.summary[:in_progress],
+              "active" => info.queue_state.summary[:active],
               "pending" => info.queue_state.summary[:pending]
             },
-            "current_step" => current ? current.name : nil
+            "active_steps" => active_steps.map(&:name),
+            "next_step" => next_step&.name
           }
         end
 

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

@@ -11,8 +11,8 @@ module Ace
           task_loader: nil, config: nil, assignment_detector: nil)
           @worktree_provisioner = worktree_provisioner || Molecules::WorktreeProvisioner.new
           @tmux_window_opener = tmux_window_opener || Molecules::TmuxWindowOpener.new
-          @assignment_launcher = assignment_launcher || Molecules::AssignmentLauncher.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
           @assignment_detector = assignment_detector
         end
@@ -70,9 +70,10 @@ module Ace
           end
           assignment_result = if existing
             progress.call("Assignment already active: #{existing.dig("assignment", "id")}")
+            focused_step = existing.dig("focus_step", "number") || existing.dig("next_step", "number")
             {
               assignment_id: existing.dig("assignment", "id"),
-              first_step: existing.dig("current_step", "number"),
+              first_step: focused_step,
               created: false
             }
           else
@@ -185,15 +186,29 @@ module Ace
             Ace::Assign.reset_config!
             executor = Ace::Assign::Organisms::AssignmentExecutor.new
             result = executor.status
+            focus_step = result[:current]
+            next_step = result[:state].active_steps.empty? ? result[:state].next_workable : nil
             {
               "assignment" => {
                 "id" => result[:assignment].id,
                 "name" => result[:assignment].name,
                 "state" => result[:state].assignment_state.to_s
               },
-              "current_step" => result[:current] && {
-                "number" => result[:current].number,
-                "name" => result[:current].name
+              "active_steps" => result[:state].active_steps.map do |step|
+                {
+                  "number" => step.number,
+                  "name" => step.name
+                }
+              end,
+              "next_step" => if result[:state].active_steps.empty? && result[:state].next_workable
+                {
+                  "number" => next_step.number,
+                  "name" => next_step.name
+                }
+              end,
+              "focus_step" => focus_step && {
+                "number" => focus_step.number,
+                "name" => focus_step.name
               }
             }
           rescue Ace::Assign::AssignmentErrors::NoActive

data/lib/ace/overseer/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Overseer
-    VERSION = "0.13.9"
+    VERSION = '0.15.3'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-overseer
 version: !ruby/object:Gem::Version
-  version: 0.13.9
+  version: 0.15.3
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-26 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.42'
+        version: '0.54'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.42'
+        version: '0.54'
 - !ruby/object:Gem::Dependency
   name: ace-git
   requirement: !ruby/object:Gem::Requirement
@@ -99,14 +99,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.19'
+        version: '0.21'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.19'
+        version: '0.21'
 - !ruby/object:Gem::Dependency
   name: ace-task
   requirement: !ruby/object:Gem::Requirement
@@ -127,14 +127,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.17'
 - !ruby/object:Gem::Dependency
   name: ace-support-test-helpers
   requirement: !ruby/object:Gem::Requirement