ace-hitl 0.25.1 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a02c62f4939a60bf11cecc65e359987ef263fe520191bf42ac806326eb9cebaf
-  data.tar.gz: 998d00803a4a9b88e3f92bdd506288e4ca536339dd9cb328a9d79568be689e79
+  metadata.gz: 64cb514390029a16b5a139d1d0db8da63b36c8fc08b21df9525d2f84bb94c1c3
+  data.tar.gz: 20118ea180abf1437a63d32c48c72581ca6e0aa115b79422b83f77aabc9afc04
 SHA512:
-  metadata.gz: c5745f91860ee25c500cecdbaff63efec395c4588cd064fa0df225a8844abdadf4a3f8ab10ba8fde9a83817212a3924a799b2909b79ea244a68c4d7df2dbb46f
-  data.tar.gz: 64a33f6d3de1f218fd60702a0c37072b95688fef66c853b8c8c02f1936108ff156e79f8761a70bb4e9b6c263288de77a7b2478469ce494be53d7198351adad7e
+  metadata.gz: e096433ca99b4cbc9455f21494d42d2cb08bc4dcf305e8e14d1e4c516a470ab8aa6a6e3eb723c3cb142570dc661197695cc30bb088c6c0713698ea6eda390446
+  data.tar.gz: d23bcb8c437f671d91d3661e3f27041939b4b3007acf680e19bb0c2c3315dd13f8250197cc60501786d4f7f875d20913db58c43694a65009f1442341f4a7982b

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-11-12
+
+### Added
+
+- Expose canonical local case cancellation through `cancel --case --reason`, preserving audited reasons and idempotence without fabricating human answers or contacting relay services.
+
 ## [0.25.1] - 2026-11-10
 
 ### Fixed

data/handbook/workflow-instructions/hitl.wf.md

@@ -165,3 +165,16 @@ Canonical lifecycle namespace: `hitl.event.*`
 - Blockers always produce canonical `HITL: <id> <path>` failure reason.
 - Human-required completion handoffs generate approval HITL events.
 - Resolved HITL events are archived only after successful resume dispatch.
+
+## Withdraw an obsolete local question
+
+If the reason for an unanswered or unapplied question no longer exists, cancel
+the exact local case with the evidence. Do not manufacture a human answer:
+
+```bash
+ace-hitl cancel <case-id> --case --reason "Obsolete: verified new review commit and active next round"
+```
+
+This records terminal cancellation in the canonical case. Repetition is a no-op;
+an applied effect must be closed instead. Without `--case`, cancel addresses the
+relay request owner; it never guesses a different owner on lookup failure.

data/lib/ace/hitl/cli/commands/cancel.rb

@@ -14,16 +14,29 @@ module Ace
           include Ace::Support::Cli::Base
           include LifecycleCommand
 
-          desc "Cancel one HITL relay request with an audited reason"
+          desc "Cancel a relay request or an explicit local case with an audited reason"
 
           argument :id, required: true, desc: "HITL relay request id"
 
+          option :case, type: :boolean, desc: "Cancel an exact local case instead of a relay request; requires --reason"
+
           option :reason, type: :string, desc: "Audited reason recorded in the public lifecycle record"
 
           option :quiet, type: :boolean, aliases: %w[-q], desc: "Suppress non-essential output"
 
           def call(id:, **options)
-            emit(lifecycle_client.cancel(id, reason: options[:reason] || ""))
+            if options[:case]
+              reason = options[:reason].to_s.strip
+              raise Ace::Support::Cli::Error.new("local case cancellation requires --reason") if reason.empty?
+              state = Organisms::HitlManager.new.cancel_case(id, reason: reason)
+              emit({"case" => id, "state" => state.to_s})
+            else
+              emit(lifecycle_client.cancel(id, reason: options[:reason] || ""))
+            end
+          rescue Organisms::HitlManager::UnknownCaseError,
+            Organisms::HitlManager::AmbiguousReferenceError,
+            Organisms::HitlManager::LifecycleTransitionError => e
+            raise_lifecycle_error("not cancelled: #{e.message}")
           rescue Lifecycle::Error, Providers::ProviderUnavailableError => e
             raise_lifecycle_error(e.message)
           end

data/lib/ace/hitl/cli.rb

@@ -47,7 +47,7 @@ module Ace
         ["wait", "Wait for an answer on a specific HITL event"],
         ["deliver", "Deliver an answer (stdin) to a pending HITL relay request"],
         ["consume", "Wait for and consume the answer of one own HITL relay request"],
-        ["cancel", "Cancel one HITL relay request with an audited reason"],
+        ["cancel", "Cancel a relay request or explicit local case (--case)"],
         ["pending", "List answerable HITL relay requests (transport)"],
         ["states", "List public HITL lifecycle projections (transport)"],
         ["duty", "Project pending and escalated HITL requests (transport)"],

data/lib/ace/hitl/organisms/hitl_manager.rb

@@ -267,7 +267,7 @@ module Ace
         # Only from the not-yet-applied states — an applied effect is
         # history and is closed, not cancelled.
         # @return [Symbol] :cancelled or :duplicate
-        def cancel_case(ref, scope: nil)
+        def cancel_case(ref, scope: nil, reason: nil)
           event = exact_case(ref, scope: scope)
 
           transition(event.file_path) do |frontmatter, _body|
@@ -276,6 +276,7 @@ module Ace
             when "", "pending"
               frontmatter["application"] = {"state" => "cancelled",
                 "cancelled_at" => timestamp}
+              frontmatter["application"]["reason"] = reason.to_s.strip unless reason.to_s.strip.empty?
               :cancelled
             when "cancelled"
               :duplicate

data/lib/ace/hitl/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Hitl
-    VERSION = "0.25.1"
+    VERSION = "0.26.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-hitl
 version: !ruby/object:Gem::Version
-  version: 0.25.1
+  version: 0.26.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-11-10 00:00:00.000000000 Z
+date: 2026-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-hitl-contract