ace-overseer 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c671f6791c3a1fc868e5aaa602140ed7fb70e6afbc1865650eb20c40d847ebcd
-  data.tar.gz: 3ca93220672da054795c719797b8daa9730baa47a840fdbe1caad49097beea01
+  metadata.gz: 105fc700308987490a9f933ca8ce93eb6ce73a1322bd1892df9d7c7aaf94dd9f
+  data.tar.gz: 14574baa5c684cc096927171dbdae1fc2a3070939ad3160c1ace410c2304eae6
 SHA512:
-  metadata.gz: ec96c284abc889beeaa32042d592307c6ed7aabd0c157f0c3fd1fd74e478bafbe1ff89d749dd0857f9770a2a8c7ed1d9993a86e92edd1723d3e4987ec459f1f3
-  data.tar.gz: de556356bf1092727d848b271d867f06473980dab3450120632fac57cfc2443bdf59006ab63ed3a61ff96e45b3f624b04ca04ef26b014f0a57a5fc24c4e97940
+  metadata.gz: 66ee73e26f7a17d4d090d86e12b24e93292cefbddd44d11eb445297a2dab4e9f37a691b2aabc74e528d6715737046be4fd7296aa5a21cceaff97d8922807adbd
+  data.tar.gz: 88e2d7c66ec0d186a872c1deca9a47a2e0d0da984f122465029f627b46642def5a45363cf436b3f50111e85cf4ac53fb41d8174ef47cfcf8443e8dee1c15edfc

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-10-23
+
+### Added
+
+- Expose canonical report observation and adoption filtering for event-driven continuation without creating another state owner.
+
+## [0.25.1] - 2026-10-20
+
+### Fixed
+- Preserve installed toolchain selection in next-role handoff commands.
+
 
 ## [0.25.0] - 2026-10-20
 

data/README.md

@@ -98,3 +98,14 @@ or create your own.
 
 ---
 [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)
+
+### Read-only event observation
+
+`ace-overseer observe --owner self --scope all --limit 500` combines the HITL
+owner's semantic incoming-event projection with canonical report adoption from
+the existing private task tree. `self` must be a configured HITL recipient alias.
+The JSON contains `events` requiring reconciliation and `settled` revisions whose
+matched managing tree is fully terminal (including archived managers). Recorded
+reports on active managers remain eligible: adoption does not prove continuation.
+No report, task, assignment, worktree, process or external operation is mutated.
+Pi eyes uses this view, then the agent uses normal `process-reports` gates.

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

@@ -56,7 +56,7 @@ module Ace
             end
 
             puts "Handoff ready. In the worktree terminal run:"
-            puts "  ace-coworker start --config #{next_leg["start_config"]}"
+            puts "  #{Ace::Support::Cli::Toolchain.shell_command("ace-coworker", "start", "--config", next_leg["start_config"])}"
           rescue Ace::Support::Cli::Error
             raise
           rescue => e

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+require "json"
+require_relative "../../molecules/event_observation"
+module Ace
+  module Overseer
+    module CLI
+      module Commands
+        class Observe < Ace::Support::Cli::Command
+          desc "Read incoming semantic revisions requiring owner reconciliation; no effects"
+          option :owner, type: :string, required: true, desc: "Configured HITL recipient for this observer"
+          option :scope, type: :string, default: "current", desc: "current or all linked worktrees"
+          option :limit, type: :integer, default: 500, desc: "Maximum canonical events"
+          def call(owner:, scope: "current", limit: 500, **)
+            raise Ace::Support::Cli::Error, "invalid scope" unless %w[current all].include?(scope)
+            puts JSON.generate(Molecules::EventObservation.new.call(owner: owner, scope: scope, limit: limit))
+          rescue ArgumentError, Ace::Hitl::Molecules::HitlAddressResolver::UnknownRecipientError,
+            Ace::Hitl::Molecules::HitlAddressResolver::InvalidAddressError => e
+            raise Ace::Support::Cli::Error, e.message
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/overseer/cli.rb

@@ -6,6 +6,7 @@ require_relative "cli/commands/work_on"
 require_relative "cli/commands/handoff"
 require_relative "cli/commands/process_reports"
 require_relative "cli/commands/status"
+require_relative "cli/commands/observe"
 require_relative "cli/commands/prune"
 require_relative "cli/commands/projects"
 require_relative "cli/commands/agents"
@@ -21,6 +22,7 @@ module Ace
         ["work-on", "Start local task work"],
         ["handoff", "Hand the task worktree to the next role"],
         ["process-reports", "Process ace-hitl reports and continue the queue"],
+        ["observe", "Read semantic events needing reconciliation"],
         ["status", "Show status of task worktrees"],
         ["prune", "Remove stale task worktrees"],
         ["projects", "List visible public projects"],
@@ -38,6 +40,7 @@ module Ace
       register "work-on", Commands::WorkOn
       register "handoff", Commands::Handoff
       register "process-reports", Commands::ProcessReports
+      register "observe", Commands::Observe
       register "status", Commands::Status
       register "prune", Commands::Prune
       register "projects", Commands::Projects

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+require "ace/hitl/molecules/event_observation"
+
+module Ace
+  module Overseer
+    module Molecules
+      # Read-only adoption filter. HITL owns semantic revisions; the existing
+      # private task tree owns report adoption and continuation, never this view.
+      class EventObservation
+        def initialize(hitl: nil, task_manager: nil)
+          @hitl = hitl || Ace::Hitl::Molecules::EventObservation.new
+          @tasks = task_manager || Ace::Task::Organisms::TaskManager.new
+        end
+
+        def call(owner:, scope: "current", limit: 500)
+          projection = @hitl.call(owner: owner, scope: scope, limit: limit)
+          managers = @tasks.list(in_folder: "all").select { |task| !task.metadata["project_task"].to_s.empty? }
+          settled, pending = projection.fetch("events").partition do |event|
+            next false unless event["type"] == "report"
+            verdict = Atoms::ReportInterpretation.evaluate(event: event, managers: managers)
+            next false unless verdict[:status] == :duplicate
+            manager = managers.find { |task| task.id.to_s == verdict[:manager_ref] }
+            # A persisted report alone is not proof its continuation ran. Keep
+            # active managers eligible after restart; their existing gates reconcile
+            # the same attempt. Only completed trees suppress historical reports.
+            manager && ([manager] + Array(manager.subtasks)).all? { |task| Ace::Task::Atoms::TaskValidationRules.terminal_status?(task.status.to_s) }
+          end
+          projection.merge("events" => pending, "settled" => settled)
+        end
+      end
+    end
+  end
+end

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

@@ -159,7 +159,7 @@ module Ace
         # guess, and so does this description).
         def start_command_of(next_leg)
           config = next_leg.is_a?(Hash) ? next_leg["start_config"].to_s : ""
-          config.empty? ? nil : "ace-coworker start --config #{config}"
+          config.empty? ? nil : Ace::Support::Cli::Toolchain.shell_command("ace-coworker", "start", "--config", config)
         end
 
         # First non-terminal step (id order) whose recorded dependencies

data/lib/ace/overseer/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Overseer
-    VERSION = "0.25.0"
+    VERSION = "0.26.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-overseer
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
@@ -16,6 +16,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -23,6 +26,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.10
 - !ruby/object:Gem::Dependency
   name: ace-support-core
   requirement: !ruby/object:Gem::Requirement
@@ -72,6 +78,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.70'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.73.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -79,6 +88,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.70'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.73.1
 - !ruby/object:Gem::Dependency
   name: ace-git
   requirement: !ruby/object:Gem::Requirement
@@ -127,28 +139,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: 0.6.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: 0.6.2
 - !ruby/object:Gem::Dependency
   name: ace-hitl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.23'
+        version: '0.24'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.23'
+        version: '0.24'
 - !ruby/object:Gem::Dependency
   name: ace-runtime
   requirement: !ruby/object:Gem::Requirement
@@ -184,6 +196,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -191,6 +206,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
 - !ruby/object:Gem::Dependency
   name: ace-lab
   requirement: !ruby/object:Gem::Requirement
@@ -211,14 +229,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.62.0
+        version: 0.62.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.62.0
+        version: 0.62.2
 - !ruby/object:Gem::Dependency
   name: ace-support-test-helpers
   requirement: !ruby/object:Gem::Requirement
@@ -313,6 +331,7 @@ files:
 - lib/ace/overseer/cli.rb
 - lib/ace/overseer/cli/commands/agents.rb
 - lib/ace/overseer/cli/commands/handoff.rb
+- lib/ace/overseer/cli/commands/observe.rb
 - lib/ace/overseer/cli/commands/process_reports.rb
 - lib/ace/overseer/cli/commands/projects.rb
 - lib/ace/overseer/cli/commands/prune.rb
@@ -324,6 +343,7 @@ files:
 - lib/ace/overseer/models/work_context.rb
 - lib/ace/overseer/molecules/assignment_launcher.rb
 - lib/ace/overseer/molecules/assignment_prune_safety_checker.rb
+- lib/ace/overseer/molecules/event_observation.rb
 - lib/ace/overseer/molecules/git_preservation_checker.rb
 - lib/ace/overseer/molecules/handoff_probe.rb
 - lib/ace/overseer/molecules/hitl_inbox.rb