ace-handbook 0.36.0 → 0.36.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cac18c57b00e46385b7f258503503282b9d5bd31949d76a168438c168bd23b76
-  data.tar.gz: 5f06acc867427e2642d24060af02d07f1feede570043eaebb85b3dd0d54887d9
+  metadata.gz: b7e0dbdef987c766d7465a9d825e42109f9e0cca131cbd72cbe86fd722ab3788
+  data.tar.gz: ebb309bf73b17f5fe41cdcf0ffeb7ecab58fee5f8b1034b4e8465a1921eb567d
 SHA512:
-  metadata.gz: c21f87773ce724a9fb852d99a6b09d48531a626bb8c2f65596e19418db4a5b98112cd6b27684d1a634926a45de3b08bfe4ec4e6210ed56fa0fd8437a8e136948
-  data.tar.gz: bbcba1e96230949433396d2e51b7d5740f240baceda031c5993cac2acaba42eecbc50c5c92c2de5991dadccaf72a53c6e28ba438ea12dd0e189600b26b005de0
+  metadata.gz: 62494535cfe334c728174675f69529e16a768875ca05876693a20a8e48e502f1a0c4ae8f575c48e7fa718f4435dbd6816b4a0dd5067eb132e6134d576053b152
+  data.tar.gz: 56b1fe6f7c586f89b294c267ab0125a3e528fcba74135d75b314027f54f611f6a0d173be3c77bdcdb7e957e9c86a6ea48d9e472b6af0c9707612bc2d7ddfabf9

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.36.2] - 2026-10-27
+
+### Added
+
+- Add the "Asking the Counterpart" guide: one-paragraph default agent behavior for asking a counterpart through `ace-hitl ask` (send + auto-arm wake + end turn, no block/poll, no urgency language), including the secret-into-environment-variable-only rule.
+
+## [0.36.1] - 2026-10-25
+
+### Changed
+
+- Extend the RubyGems publish workflow and release skill with the semantic-wake OTP handoff (PR74): readiness-only HITL fallback and the agent-driven single-OTP wait contract.
+
 
 ## [0.36.0] - 2026-10-20
 

data/handbook/guides/asking-the-counterpart.g.md

@@ -0,0 +1,12 @@
+---
+doc-type: guide
+title: Asking the Counterpart
+purpose: Default agent behavior for asking a human or another owner a question through ace-hitl
+ace-docs:
+  last-updated: 2026-10-27
+  last-checked: 2026-10-27
+---
+
+# Asking the Counterpart
+
+When your work needs a decision, an approval, or a secret from another owner, ask the actual counterpart directly — for the Captain, that is the captain route (`ace-hitl ask "…" --to captain --question "…"`), never a relay chain through other agents or panes. `ask` is the last action of your turn: it creates the question, sends it through the configured route, arms your own wake for the answer, and ends the turn — so never wrap it in sleep-poll waits, blocking waits, or asker-side timeouts, and never add urgency language or deadlines to the ask text (the Captain replies whenever he wants). The answer arrives as a wake carrying the content; on wake, act on it immediately — and a secret such as an OTP goes into an environment variable only: never echoed, never passed as a command argument, never written to logs, task files, or reports.

data/handbook/skills/as-release-rubygems-publish/SKILL.md

@@ -47,7 +47,7 @@ None
 - Do the work described by the workflow instead of only summarizing it.
 - When the workflow requires edits, tests, or commits, perform them in this project.
 - OTP timing: build every pending `.gem` first, then ask for one OTP (~30–45s), then push in ≤5-concurrent dependency waves aiming to finish within ~30s; verify metadata only after the burst.
-- Last-mile handoff: the agent shell is not the operator shell. Missing `GEM_HOST_API_KEY` / `~/.gem/credentials` (or no TTY) in the agent's subprocesses never means the operator is unconfigured — do not request credential setup. Finish the dry-run, state the wave plan, and hand off exactly `.ace-bin/ace-rubygems-publish --interactive` for the operator terminal (`--prepare` is optional; the live run re-resolves a stale prepared queue). If the operator explicitly authorizes agent-driven publishing, request one fresh OTP via `ace-hitl`/chat, wait for it, then run the publisher with `GEM_HOST_OTP_CODE` in the environment and never persist the OTP.
+- Last-mile handoff: the agent shell is not the operator shell. Missing `GEM_HOST_API_KEY` / `~/.gem/credentials` (or no TTY) in the agent's subprocesses never means the operator is unconfigured — do not request credential setup. Finish the dry-run, state the wave plan, and hand off exactly `.ace-bin/ace-rubygems-publish --interactive` for the operator terminal (`--prepare` is optional; the live run re-resolves a stale prepared queue). If the operator explicitly authorizes agent-driven publishing, request one fresh OTP via `ace-hitl`/chat, wait through the semantic wait — exactly ONE in-process `/watch` scoped to the project ace-hitl transport folder (the folder holding that case's request/reply files, e.g. `.ace-local/hitl`), then end the turn; on wake run the project `ace-hitl-hermes sync` ONCE and reconcile the exact case state (`ace-hitl show <ref>`, never merely replies>0); never block the turn with sleep/poll loops — then run the publisher with `GEM_HOST_OTP_CODE` in the environment and never persist the OTP.
 - Never re-run the publisher to confirm a completed release, and never replace the `TS-MONO-001` propagation proof with hand-rolled `bundle install` runs; if the agent runner is unavailable, report the blocked command and hand it off.
 
 - After live publishing, recommend running `ace-test-e2e ace-monorepo-e2e TS-MONO-001` for installation verification.

data/handbook/workflow-instructions/release/rubygems-publish.wf.md

@@ -7,7 +7,7 @@ doc-type: workflow
 purpose: specialized RubyGems publication baseline with non-mutating default
 update:
   frequency: on-change
-  last-updated: "2026-08-12"
+  last-updated: "2026-10-23"
 ---
 
 # RubyGems Publish Workflow (Baseline)
@@ -96,9 +96,10 @@ When a project overlay authorizes live `gem push`, use this timing contract so o
 2. **Build every pending `.gem` artifact** before asking for OTP
 3. Show the final queue (order, versions, artifact paths, count)
 4. Prompt once for OTP — codes are short-lived (**~30–45s**)
-5. Push immediately in dependency-respecting waves of **up to 5 concurrent** `gem push --otp` calls; aim to finish the burst in **≤30s**
-6. Verify RubyGems metadata **after** the burst (not between pushes)
-7. On expired/incorrect OTP: stop, list remaining gems, request a fresh OTP, resume without rebuilding unless an artifact is missing
+5. Wait for the OTP answer with the semantic wait: register exactly ONE in-process `/watch` scoped to the project ace-hitl transport folder (the folder holding that case's request/reply files), end the turn; on wake run the project `ace-hitl-hermes sync` ONCE and reconcile the exact case state — never a sleep/poll loop (during eyes-20261023 a 36x sleep-8 loop blocked the turn through the whole OTP window)
+6. Push immediately in dependency-respecting waves of **up to 5 concurrent** `gem push --otp` calls; aim to finish the burst in **≤30s**
+7. Verify RubyGems metadata **after** the burst (not between pushes)
+8. On expired/incorrect OTP: stop, list remaining gems, request a fresh OTP, resume without rebuilding unless an artifact is missing
 
 Suggested overlay commands (executed only under a project publication contract):
 

data/lib/ace/handbook/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Handbook
-    VERSION = "0.36.0"
+    VERSION = "0.36.2"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-handbook
 version: !ruby/object:Gem::Version
-  version: 0.36.0
+  version: 0.36.2
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config
@@ -131,6 +131,7 @@ files:
 - handbook/cookbooks/setup-starting-a-multi-ruby-gem-monorepo-with-ace.cookbook.md
 - handbook/cookbooks/setup-starting-an-astro-project-with-ace.cookbook.md
 - handbook/guides/ai-agent-integration.g.md
+- handbook/guides/asking-the-counterpart.g.md
 - handbook/guides/atom-pattern.g.md
 - handbook/guides/changelog.g.md
 - handbook/guides/cli-dry-cli.g.md