ace-overseer 0.20.0 → 0.20.2

data/lib/ace/overseer/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Overseer
-    VERSION = "0.20.0"
+    VERSION = "0.20.2"
   end
 end

data/lib/ace/overseer.rb

@@ -24,7 +24,6 @@ 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/window_opener"
 require_relative "overseer/molecules/assignment_launcher"
 require_relative "overseer/molecules/worktree_context_collector"
@@ -32,9 +31,9 @@ require_relative "overseer/molecules/preservation_manifest"
 require_relative "overseer/molecules/git_preservation_checker"
 require_relative "overseer/molecules/prune_safety_checker"
 require_relative "overseer/molecules/assignment_prune_safety_checker"
-require_relative "overseer/molecules/lab_prune_safety_checker"
 require_relative "overseer/organisms/work_on_orchestrator"
 require_relative "overseer/organisms/status_collector"
+require_relative "overseer/organisms/protected_status"
 require_relative "overseer/organisms/prune_orchestrator"
 require_relative "overseer/cli"
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-overseer
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.20.2
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-05 00:00:00.000000000 Z
+date: 2026-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
@@ -71,28 +71,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.64'
+        version: 0.66.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.64'
+        version: 0.66.1
 - !ruby/object:Gem::Dependency
   name: ace-git
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.29'
+        version: '0.30'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.29'
+        version: '0.30'
 - !ruby/object:Gem::Dependency
   name: ace-git-worktree
   requirement: !ruby/object:Gem::Requirement
@@ -127,14 +127,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: ace-tmux
   requirement: !ruby/object:Gem::Requirement
@@ -155,14 +155,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 0.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+- !ruby/object:Gem::Dependency
+  name: ace-lab
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+- !ruby/object:Gem::Dependency
+  name: ace-review
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.60.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 0.60.1
 - !ruby/object:Gem::Dependency
   name: ace-support-test-helpers
   requirement: !ruby/object:Gem::Requirement
@@ -245,6 +273,9 @@ files:
 - exe/ace-overseer
 - handbook/skills/as-overseer/SKILL.md
 - handbook/workflow-instructions/overseer.wf.md
+- handbook/workflow-instructions/roles/lab-coordinator.wf.md
+- handbook/workflow-instructions/roles/project-overseer.wf.md
+- handbook/workflow-instructions/roles/second-commander.wf.md
 - lib/ace/overseer.rb
 - lib/ace/overseer/atoms/preset_resolver.rb
 - lib/ace/overseer/atoms/repo_guard.rb
@@ -252,7 +283,6 @@ files:
 - lib/ace/overseer/atoms/status_formatter.rb
 - lib/ace/overseer/cli.rb
 - lib/ace/overseer/cli/commands/agents.rb
-- lib/ace/overseer/cli/commands/prepare.rb
 - lib/ace/overseer/cli/commands/projects.rb
 - lib/ace/overseer/cli/commands/prompt.rb
 - lib/ace/overseer/cli/commands/prune.rb
@@ -267,14 +297,21 @@ files:
 - lib/ace/overseer/molecules/assignment_launcher.rb
 - lib/ace/overseer/molecules/assignment_prune_safety_checker.rb
 - lib/ace/overseer/molecules/git_preservation_checker.rb
-- lib/ace/overseer/molecules/lab_client.rb
-- lib/ace/overseer/molecules/lab_prune_safety_checker.rb
+- lib/ace/overseer/molecules/launch_request.rb
+- lib/ace/overseer/molecules/original_launch_child.rb
 - lib/ace/overseer/molecules/preservation_manifest.rb
 - lib/ace/overseer/molecules/proposal_tick.rb
+- lib/ace/overseer/molecules/protected_selection.rb
 - lib/ace/overseer/molecules/prune_safety_checker.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/launch_recovery.rb
+- lib/ace/overseer/organisms/protected_prune.rb
+- lib/ace/overseer/organisms/protected_review.rb
+- lib/ace/overseer/organisms/protected_status.rb
+- lib/ace/overseer/organisms/protected_steering.rb
+- lib/ace/overseer/organisms/protected_work_on.rb
 - lib/ace/overseer/organisms/prune_orchestrator.rb
 - lib/ace/overseer/organisms/status_collector.rb
 - lib/ace/overseer/organisms/work_on_orchestrator.rb

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

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-module Ace
-  module Overseer
-    module CLI
-      module Commands
-        class Prepare < Ace::Support::Cli::Command
-          include Ace::Support::Cli::Base
-          desc "Prepare a Work through the Lab runtime"
-          option :runtime, required: true, desc: "Runtime (lab)"
-          option :project, required: true, desc: "Lab project slug"
-          option :source, required: true, desc: "Source KIND:ID"
-          option :work, required: true, desc: "Work ID"
-          option :planner, required: true, desc: "Planner agent ID"
-          option :title, required: true, desc: "Reviewed Work title"
-          def initialize(client: nil)
-            super()
-            @client = client || Molecules::LabClient.new
-          end
-          def call(runtime:, project:, source:, work:, planner:, title:, **)
-            raise Ace::Support::Cli::Error, "unsupported runtime: #{runtime}" unless runtime == "lab"
-            puts @client.call(
-              "work", "prepare", project,
-              "--source", source,
-              "--work", work,
-              "--planner", planner,
-              "--title", title,
-              json: false
-            )
-          rescue Ace::Support::Cli::Error
-            raise
-          rescue => error
-            raise Ace::Support::Cli::Error.new(error.message)
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "open3"
-
-module Ace
-  module Overseer
-    module Molecules
-      class LabClient
-        BINARY = "/usr/local/bin/lab"
-
-        def initialize(runner: Open3)
-          @runner = runner
-        end
-
-        def call(*arguments, stdin_data: nil, json: true)
-          stdout, stderr, status = @runner.capture3(
-            BINARY,
-            *arguments.map(&:to_s),
-            stdin_data: stdin_data.to_s
-          )
-          raise Error, stderr.to_s.strip.empty? ? "Lab command failed" : stderr.to_s.strip unless status.success?
-
-          return stdout unless json
-
-          JSON.parse(stdout)
-        rescue Errno::ENOENT
-          raise Error, "Lab runtime unavailable: #{BINARY} is not installed"
-        rescue JSON::ParserError => error
-          raise Error, "Lab returned invalid JSON: #{error.message}"
-        end
-
-        # Whether this surface can make the no-writer state check and the
-        # destruction one atomic operation. The raw CLI cannot: between
-        # `work status` and `work destroy` another writer may start. Prune
-        # treats the path as unsupported (preserve) unless the adapter
-        # guarantees atomicity.
-        def supports_atomic_destroy?
-          false
-        end
-
-        # The authoritative status entry for one Work, or nil when the Work
-        # is absent from the surface. Missing state is a blocking condition
-        # for prune — never treated as safe.
-        #
-        # @param work_id [String] Exact Lab Work ID
-        # @return [Hash, nil] Status entry or nil
-        def work_entry(work_id)
-          data = call("work", "status", "--json")
-          works = data.is_a?(Hash) ? Array(data["works"]) : []
-          works.find { |entry| entry.is_a?(Hash) && entry["id"].to_s == work_id.to_s }
-        end
-      end
-    end
-  end
-end

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

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-module Ace
-  module Overseer
-    module Molecules
-      # Fail-closed Lab Work classification for prune.
-      #
-      # A Lab Work may only be destroyed when the authoritative Lab surface
-      # reports a documented terminal state AND preservation evidence is
-      # available (declared destination proof). Active work, unknown states,
-      # unreadable state, or missing preservation evidence block the
-      # candidate — including under --yes. When the Lab surface cannot supply
-      # the state, the path reports blocked rather than assuming safety.
-      class LabPruneSafetyChecker
-        STATES_KEY = %w[state status].freeze
-        TERMINAL_STATES = %w[completed done archived cancelled].freeze
-        ACTIVE_STATES = %w[
-          running in_flight in-flight in_progress in-progress
-          active pending reserved claimed started queued
-        ].freeze
-
-        Classification = Struct.new(:safe?, :reason, keyword_init: true)
-
-        # @param lab_client [LabClient] Lab surface adapter
-        # @param work_id [String] Exact Lab Work ID
-        # @param preservation_proof [Models::PreservationProof, nil] Proof
-        #   built from the Work's documented preservation data
-        # @return [Classification]
-        def check(lab_client:, work_id:, preservation_proof: nil)
-          entry = read_entry(lab_client, work_id)
-          return classify(false, entry) if entry.is_a?(String)
-
-          value = STATES_KEY.filter_map { |key| entry[key] }.find { |state| state.is_a?(String) }
-          return classify(false, "lab state for #{work_id} is unreadable") if value.nil?
-
-          normalized = value.strip.downcase
-          return classify(false, "lab work #{work_id} is #{normalized} (active writer)") if ACTIVE_STATES.include?(normalized)
-
-          unless TERMINAL_STATES.include?(normalized)
-            return classify(false, "lab work #{work_id} state #{normalized.inspect} is not a documented terminal state")
-          end
-
-          if preservation_proof.nil?
-            return classify(false, "no preservation evidence for lab work #{work_id}; " \
-              "the Lab surface does not document surviving repo/head/branch data")
-          end
-          unless preservation_proof.preserved?
-            return classify(false, preservation_proof.reason)
-          end
-
-          Classification.new(safe?: true, reason: nil)
-        end
-
-        private
-
-        def read_entry(lab_client, work_id)
-          entry = lab_client.work_entry(work_id)
-          entry.nil? ? "lab work #{work_id} not found in authoritative status (missing state)" : entry
-        rescue Ace::Overseer::Error => e
-          "lab state for #{work_id} is unavailable: #{e.message}"
-        end
-
-        def classify(safe, reason)
-          Classification.new(safe?: safe, reason: reason)
-        end
-      end
-    end
-  end
-end