ace-assign 0.55.0 → 0.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f0f554ace326dc469a945fc93f86f81d087b7c4e6197cb59a23b38bd913c821
-  data.tar.gz: faf2665d5a3e0e88bf626ec35951bfac2af109fb465de44215c32aed766e3d54
+  metadata.gz: 2735356d8b6ca0c85cd065008a49099def711664666f2e6280419b4226609c9b
+  data.tar.gz: 18e4449c7bf1807bab4cfa84b8d3b7ae79d206fa6fabd56835df7e2483dbd4b5
 SHA512:
-  metadata.gz: d41c5204d7060d3359e1adcfb91a3a77adfc6fd3c193a531f3128a6e1e08759d835180fae64be3203acf5f8d0bb94905f278d61a731536702769a1f2fade90a9
-  data.tar.gz: 04c7d468bc85e49fccbc9b4250957803fbc7a204878e5fc47a0b804615aae66bcdf057b6cd7ed682aedbb530a204ae6274de2a77a6210f2c506bb8ebe6d2c742
+  metadata.gz: 7562bb372cd8ef57978616874139b403a78d71fc81ed35311426cba26c8fadafd1880564fc7ab7c4bae33ed2c6b0b5c2b4acc6058690fc723cf618158a637e60
+  data.tar.gz: 920c4a01f45060226ae96d75567d1a189c61471f8f88980f2ee986d6e1a9ecab620b13ff7c602230c7a2d44f850bf48e4a8c59770e2345ed03a56ba9f45f87a1

data/.ace-defaults/assign/presets/work-on-task-ace-development.yml

@@ -0,0 +1,59 @@
+# work-on-task-ace-development preset
+# Complete ACE framework development pipeline preset (batching, releases, demo recording, retro)
+
+name: work-on-task-ace-development
+description: Full ACE development pipeline with batching, releases, demo recording, and retrospectives
+
+parameters:
+  taskrefs:
+    required: true
+    type: array
+    description: Task references
+
+steps:
+  - name: onboard
+    number: "000"
+    workflow: wfi://onboard
+    instructions:
+      - "Load project context for the task batch: {{taskrefs}}."
+
+  - name: verify-test-suite
+    number: "012"
+    workflow: wfi://assign/verify-test-suite
+    instructions:
+      - "Verify test coverage and performance across batch tasks: {{taskrefs}}."
+
+  - name: release-minor
+    number: "020"
+    instructions:
+      - Release all modified packages touched by this batch.
+
+  - name: create-pr
+    number: "030"
+    workflow: wfi://github/pr/create
+    instructions:
+      - "Create a pull request summarizing batch tasks: {{taskrefs}}."
+
+  - name: review-valid-1
+    number: "040"
+    context: fork
+    sub_steps: [review-pr, apply-feedback, release]
+    instructions:
+      - Execute valid review cycle.
+
+  - name: record-demo
+    number: "145"
+    instructions:
+      - "Record a demo showing the feature implemented in this PR."
+
+  - name: mark-tasks-done
+    number: "155"
+    workflow: wfi://task/update
+    instructions:
+      - "Mark each top-level task in {{taskrefs}} as done and archive it."
+
+  - name: create-retro
+    number: "160"
+    skill: as-retro-create
+    instructions:
+      - "Create a retrospective for the batch work on: {{taskrefs}}."

data/.ace-defaults/assign/presets/work-on-task-auto-merge.yml

@@ -0,0 +1,47 @@
+# work-on-task-auto-merge preset
+# Advanced authorized guarded auto-merge task delivery preset
+
+name: work-on-task-auto-merge
+description: Work on a task with PR, review cycles, and advance authorization for guarded auto-merge
+
+parameters:
+  taskrefs:
+    required: true
+    type: array
+    description: Task references
+
+steps:
+  - name: onboard
+    number: "000"
+    workflow: wfi://onboard
+    instructions:
+      - "Load project context for the task: {{taskrefs}}."
+
+  - name: create-pr
+    number: "030"
+    workflow: wfi://github/pr/create
+    instructions:
+      - "Create a pull request summarizing task: {{taskrefs}}."
+
+  - name: review-valid-1
+    number: "040"
+    context: fork
+    sub_steps: [review-pr, apply-feedback]
+    instructions:
+      - Execute valid review cycle and apply feedback.
+
+  - name: push-to-remote
+    number: "140"
+    instructions:
+      - Push changes with force-with-lease.
+
+  - name: auto-merge
+    number: "150"
+    instructions:
+      - "Guarded auto-merge authorized PR when checks pass."
+
+  - name: mark-tasks-done
+    number: "155"
+    workflow: wfi://task/update
+    instructions:
+      - "Mark task {{taskrefs}} done during final delivery."

data/.ace-defaults/assign/presets/work-on-task-in-place.yml

@@ -0,0 +1,42 @@
+# work-on-task-in-place preset
+# In-place single checkout task delivery preset
+
+name: work-on-task-in-place
+description: Work on a task in the current checkout with reviewed, verified, scoped commit (no worktree, PR, or merge)
+
+parameters:
+  taskrefs:
+    required: true
+    type: array
+    description: Task references
+
+steps:
+  - name: onboard
+    number: "000"
+    workflow: wfi://onboard
+    instructions:
+      - "Load project context for the task: {{taskrefs}}."
+
+  - name: verify-test-suite
+    number: "012"
+    workflow: wfi://assign/verify-test-suite
+    instructions:
+      - "Verify test coverage for task in current checkout: {{taskrefs}}."
+
+  - name: review-valid-1
+    number: "040"
+    context: fork
+    sub_steps: [review-pr, apply-feedback]
+    instructions:
+      - Execute valid review cycle and apply feedback in current checkout.
+
+  - name: commit-in-place
+    number: "050"
+    instructions:
+      - "Create one reviewed, verified, scoped commit in the current authorized checkout."
+
+  - name: mark-tasks-done
+    number: "060"
+    workflow: wfi://task/update
+    instructions:
+      - "Mark task {{taskrefs}} done during final delivery."

data/CHANGELOG.md

@@ -6,6 +6,23 @@ 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]
+
+## [0.56.0] - 2026-08-13
+### Added
+- Calculate exact-head evidence for status
+- Add outcome-based task presets
+### Fixed
+- Resolve PR 316 findings and finalize cleanup proofs
+
+## [0.55.2] - 2026-08-12
+
+### Technical
+- Raised the `ace-support-core` dependency floor to `~> 0.31` after the principles-first bootstrap guidance release.
+## [0.55.1] - 2026-08-12
+
+### Technical
+- Aligned gemspec dependency floors with current ACE package minor release lines and safe external minor dependency bumps (no major version jumps).
+
 ## [0.55.0] - 2026-04-23
 
 ### Changed

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

@@ -83,6 +83,13 @@ module Ace
           end
 
           def status_to_h(assignment, state, active_steps, next_step, target:, scope_root:)
+            # Extract auto_merge config if present in assignment settings or preset
+            auto_merge = false
+            preset_name = Ace::Assign::Molecules::PresetInferrer.infer_from_assignment(assignment)
+            auto_merge = true if preset_name && preset_name.start_with?("work-on-task-auto-merge")
+
+            evidence = Ace::Assign::Molecules::EvidenceCalculator.calculate(auto_merge: auto_merge)
+
             payload = {
               assignment: {
                 id: assignment.id,
@@ -95,6 +102,10 @@ module Ace
             }
 
             payload[:next_step] = step_to_h(next_step, effective_fork_provider: effective_fork_provider_for(next_step, scoped_fork_metadata_step(state, next_step, target.scope, scope_root))) if active_steps.empty? && next_step
+            
+            # Merge exact head evidence into root payload
+            payload.merge!(evidence)
+
             payload
           end
 

data/lib/ace/assign/cli.rb

@@ -33,6 +33,7 @@ require_relative "molecules/skill_assign_source_resolver"
 require_relative "molecules/fork_session_launcher"
 require_relative "molecules/tmux_control_surface_runner"
 require_relative "molecules/preset_inferrer"
+require_relative "molecules/evidence_calculator"
 
 # Organisms
 require_relative "organisms/assignment_executor"

data/lib/ace/assign/molecules/evidence_calculator.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+require "digest"
+require "open3"
+require "ace/support/fs"
+
+module Ace
+  module Assign
+    module Molecules
+      # Computes exact-head evidence receipts and canonical decision digests for assignment delivery.
+      class EvidenceCalculator
+        def self.calculate(pr_number: nil, auto_merge: false)
+          new.calculate(pr_number: pr_number, auto_merge: auto_merge)
+        end
+
+        def calculate(pr_number: nil, auto_merge: false)
+          root = Ace::Support::Fs::Molecules::ProjectRootFinder.find_or_current
+
+          if pr_number.nil?
+            pr_output, s = Open3.capture2("ace-git", "pr", "--format", "json", chdir: root)
+            if s.success?
+              begin
+                require "json"
+                pr_data = JSON.parse(pr_output)
+                pr_number = pr_data["number"]
+              rescue StandardError
+              end
+            end
+          end
+
+          head, _s = Open3.capture2("git", "rev-parse", "HEAD", chdir: root)
+          head = head.to_s.strip
+
+          tree, _s = Open3.capture2("git", "rev-parse", "HEAD^{tree}", chdir: root)
+          tree = tree.to_s.strip
+
+          diff_output, _s = Open3.capture2("git", "diff", "HEAD", chdir: root)
+          changed_scope_digest = Digest::SHA256.hexdigest(diff_output.to_s)
+
+          review_receipt = evaluate_review_receipt(root, head)
+          release_receipt = evaluate_release_receipt(root, head)
+          feedback_state = "terminal"
+
+          merge_decision = evaluate_merge_decision(
+            auto_merge: auto_merge,
+            review_receipt: review_receipt,
+            release_receipt: release_receipt,
+            feedback_state: feedback_state
+          )
+
+          canonical_payload = [
+            pr_number || "none",
+            head,
+            tree,
+            changed_scope_digest,
+            review_receipt,
+            release_receipt,
+            feedback_state,
+            merge_decision
+          ].join(":")
+
+          decision_digest = Digest::SHA256.hexdigest(canonical_payload)
+
+          {
+            pr: pr_number || "none",
+            head: head,
+            tree: tree,
+            changed_scope_digest: changed_scope_digest,
+            review_receipt: review_receipt,
+            release_receipt: release_receipt,
+            feedback_state: feedback_state,
+            merge_decision: merge_decision,
+            decision_digest: decision_digest
+          }
+        end
+
+        private
+
+        def evaluate_review_receipt(root, current_head)
+          session_dir = File.join(root, ".ace-local", "review", "sessions")
+          return "missing" unless Dir.exist?(session_dir)
+
+          reviews = Dir.glob(File.join(session_dir, "*", "metadata.yml"))
+          return "missing" if reviews.empty?
+
+          latest = reviews.max_by { |f| File.mtime(f) }
+          session_dir = File.dirname(latest)
+          
+          # Review must actually be executed, not just prepared
+          return "missing" unless File.exist?(File.join(session_dir, "report.md")) || File.exist?(File.join(session_dir, "report.json"))
+          
+          begin
+            require "yaml"
+            metadata = YAML.safe_load_file(latest, permitted_classes: [Time, Date]) || {}
+            return "stale" unless metadata["head"] == current_head
+          rescue StandardError
+            return "missing"
+          end
+
+          "current"
+        end
+
+        def evaluate_release_receipt(root, current_head)
+          session_dir = File.join(root, ".ace-local", "release", "sessions")
+          return "missing" unless Dir.exist?(session_dir)
+
+          releases = Dir.glob(File.join(session_dir, "*", "metadata.yml"))
+          return "missing" if releases.empty?
+
+          latest = releases.max_by { |f| File.mtime(f) }
+          begin
+            require "yaml"
+            metadata = YAML.safe_load_file(latest, permitted_classes: [Time, Date]) || {}
+            return "stale" unless metadata["head"] == current_head
+          rescue StandardError
+            return "missing"
+          end
+
+          "current"
+        end
+
+        def evaluate_merge_decision(auto_merge:, review_receipt:, release_receipt:, feedback_state:)
+          return "report-only" unless auto_merge
+
+          if review_receipt == "current" && release_receipt == "current" && feedback_state == "terminal"
+            "authorized"
+          else
+            "approval-required"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ace/assign/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Assign
-    VERSION = '0.55.0'
+    VERSION = "0.56.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-assign
 version: !ruby/object:Gem::Version
-  version: 0.55.0
+  version: 0.56.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
@@ -29,56 +29,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.29'
+        version: '0.31'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.29'
+        version: '0.31'
 - !ruby/object:Gem::Dependency
   name: ace-support-config
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.18'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: ace-support-nav
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.25'
+        version: '0.28'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.25'
+        version: '0.28'
 - !ruby/object:Gem::Dependency
   name: ace-b36ts
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: ace-support-markdown
   requirement: !ruby/object:Gem::Requirement
@@ -99,28 +99,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.34'
+        version: '0.38'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.34'
+        version: '0.38'
 - !ruby/object:Gem::Dependency
   name: ace-task
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.37'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.31'
+        version: '0.37'
 - !ruby/object:Gem::Dependency
   name: ace-tmux
   requirement: !ruby/object:Gem::Requirement
@@ -141,14 +141,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -228,6 +228,9 @@ files:
 - ".ace-defaults/assign/presets/quick-implement.yml"
 - ".ace-defaults/assign/presets/release-only.yml"
 - ".ace-defaults/assign/presets/work-on-docs.yml"
+- ".ace-defaults/assign/presets/work-on-task-ace-development.yml"
+- ".ace-defaults/assign/presets/work-on-task-auto-merge.yml"
+- ".ace-defaults/assign/presets/work-on-task-in-place.yml"
 - ".ace-defaults/assign/presets/work-on-task.yml"
 - ".ace-defaults/nav/protocols/skill-sources/ace-assign.yml"
 - ".ace-defaults/nav/protocols/wfi-sources/ace-assign.yml"
@@ -303,6 +306,7 @@ files:
 - lib/ace/assign/models/step.rb
 - lib/ace/assign/molecules/assignment_discoverer.rb
 - lib/ace/assign/molecules/assignment_manager.rb
+- lib/ace/assign/molecules/evidence_calculator.rb
 - lib/ace/assign/molecules/fork_session_launcher.rb
 - lib/ace/assign/molecules/preset_inferrer.rb
 - lib/ace/assign/molecules/queue_scanner.rb