ace-overseer 0.13.8 → 0.14.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: debc37b9d66ae937fb227ae69cf7e91d44b9433e9fcb7274d814b3e32db207cf
-  data.tar.gz: 68f4a63c201c5bdc8954e98d7a7e6ce6d90ff049467a28c701d33e75141166e2
+  metadata.gz: fb292ef843ffd5c7253b24cefe7e30f214be59f9e5b7dc1f4bd7ad263fc7bf4f
+  data.tar.gz: 21bbfe1148509df32512f1bbbf2aa2b001531c29e7da92407c7083e6dc822a5b
 SHA512:
-  metadata.gz: a71de2ee77251750eaf1245ca025073001dfc82d24319bc5443f796ebb3df83a24f993c3c3b744fc180bfceafea0c0b92acb53fdec6825b4bb7934986a681b4b
-  data.tar.gz: 6fcd307e247f6453d8ab1d55e7eb94e2dddf33604693cfbecaf9b946e00b221f7765caa6a829c6777579a0205519b85937263e58d926f8edb15ef34f2f3a6f60
+  metadata.gz: 52acbe53a83d98c940feb512bde7059b8f0bc60343d9ad1e1b83fe841691afc5177f550743fe444177b00952e2ed66df34037c2214095ddc4d397b4715e69b4d
+  data.tar.gz: d479e4f2444a12c12687f7b8cf4f329bb2c43e74ea855017d79299e89354fa1cd2bd81bafb7302dd34853059d5c07bc9a8ed9d645f3f94fac3b6dc5716bf4c57

data/CHANGELOG.md

@@ -7,6 +7,101 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+
+### Fixed
+- Updated the `ace-assign` runtime dependency constraint to `~> 0.42` so overseer remains compatible with the new assign minor release line.
+
 ## [0.13.8] - 2026-03-29
 
 ### Technical

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/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

@@ -4,11 +4,13 @@ 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 +23,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}'])
+          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/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

data/lib/ace/overseer/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Overseer
-    VERSION = "0.13.8"
+    VERSION = '0.14.12'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-overseer
 version: !ruby/object:Gem::Version
-  version: 0.13.8
+  version: 0.14.12
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-03-29 00:00:00.000000000 Z
+date: 2026-04-20 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.41'
+        version: '0.53'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.41'
+        version: '0.53'
 - !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.20'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.19'
+        version: '0.20'
 - !ruby/object:Gem::Dependency
   name: ace-task
   requirement: !ruby/object:Gem::Requirement