acstack 0.49.1 → 0.49.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "acstack",
   "description": "Agentic coding stack where planning grows only as far as needed: a map of decisions, tasks, checks, and handoffs behind a pluggable tracker.",
-  "version": "0.49.1",
+  "version": "0.49.2",
   "author": {
     "name": "ac8318740"
   },

package/assets/terminal-workspace/lib/commands.sh

@@ -58,6 +58,13 @@ acstack_tw_main() {
       for id in "$PI_ACSTACK" $(version_table | awk -F'\t' '$2=="pi" && $3=="npm" && $1!="pi"{print $1}' | while read -r name; do pi_npm_package "$name"; done); do
         src=$(pi_state pkg "$id") && say "pi package: $src" || say "pi package: $id not installed"
       done
+      if [ -e "$PI_QUESTION_BRIDGE" ] || [ -L "$PI_QUESTION_BRIDGE" ]; then
+        pi_state owns file "$PI_QUESTION_BRIDGE" \
+          && say "pi question blocked bridge: managed ($PI_QUESTION_BRIDGE)" \
+          || say "pi question blocked bridge: user-owned path ($PI_QUESTION_BRIDGE)"
+      else
+        say "pi question blocked bridge: absent ($PI_QUESTION_BRIDGE)"
+      fi
       [ -e "$PI_RETRO_EXT" ] && say "pi agentic-retro extension: present" \
         || say "pi agentic-retro extension: absent"
       grep -qsF "$PI_MD_BEGIN" "$PI_DIR"/AGENTS.override.md "$PI_DIR"/AGENTS.md "$PI_DIR"/AGENTS.MD \

package/assets/terminal-workspace/lib/pi-packages.sh

@@ -140,6 +140,32 @@ bili_client() {  # bili_client install|remove <client>
   fi
 }
 
+pi_question_bridge() {  # pi_question_bridge install|remove
+  local fresh=0 rc
+  if [ "$1" = "install" ]; then
+    if { [ -e "$PI_QUESTION_BRIDGE" ] || [ -L "$PI_QUESTION_BRIDGE" ]; } \
+        && ! pi_state owns file "$PI_QUESTION_BRIDGE"; then
+      say "pi: $PI_QUESTION_BRIDGE already exists, so the question bridge was left alone"
+      return 0
+    fi
+    [ -e "$PI_QUESTION_BRIDGE" ] || [ -L "$PI_QUESTION_BRIDGE" ] || fresh=1
+    mkdir -p "$(dirname "$PI_QUESTION_BRIDGE")" \
+      && cp "$SCRIPT_DIR/pi/acstack-question-blocked.ts" "$PI_QUESTION_BRIDGE" || return $?
+    if pi_state own file "$PI_QUESTION_BRIDGE"; then
+      say "pi: question blocked bridge written to $PI_QUESTION_BRIDGE"
+    else
+      rc=$?
+      [ "$fresh" = 1 ] && rm -f "$PI_QUESTION_BRIDGE"
+      say "pi: question blocked bridge ownership registration failed for $PI_QUESTION_BRIDGE"
+      return "$rc"
+    fi
+  elif pi_state owns file "$PI_QUESTION_BRIDGE"; then
+    rm -f "$PI_QUESTION_BRIDGE" \
+      && pi_state disown file "$PI_QUESTION_BRIDGE" \
+      && say "pi: question blocked bridge removed"
+  fi
+}
+
 apply_pi() {
   find_pi
   if ! have pi; then
@@ -195,7 +221,9 @@ apply_pi() {
   fi
   if [ "$(cfg_get pi.question_tool true)" = "true" ]; then
     pi_add npm:@juicesharp/rpiv-ask-user-question npm:@juicesharp/rpiv-ask-user-question
+    pi_question_bridge install
   else
+    pi_question_bridge remove
     pi_drop npm:@juicesharp/rpiv-ask-user-question
   fi
   if [ "$(cfg_get pi.web_access true)" = "true" ]; then
@@ -283,6 +311,7 @@ apply_pi() {
 # and leaves the pi binary, its logins and its sessions alone.
 remove_pi() {
   find_pi
+  pi_question_bridge remove
   if pi_state parses "$PI_SETTINGS"; then
     pi_unpin "$PI_ACSTACK"
     pi_drop "$PI_ACSTACK"

package/assets/terminal-workspace/pi/acstack-question-blocked.ts

@@ -0,0 +1,31 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+  let pending: { active: boolean; native: boolean } | undefined;
+  let forwarding = false;
+
+  pi.events.on("herdr:blocked", (event: unknown) => {
+    if (!forwarding && pending && (event as { active?: unknown } | null)?.active === pending.active) {
+      pending.native = true;
+      pending = undefined;
+    }
+  });
+
+  pi.events.on("rpiv:ask-user:blocked", (event: unknown) => {
+    const active = (event as { active?: unknown } | null)?.active;
+    if (typeof active !== "boolean") return;
+    const transition = { active, native: false };
+    pending = transition;
+    // shortcut: dual producers emit public then herdr synchronously; async pairs need an upstream source ID
+    queueMicrotask(() => {
+      if (pending === transition) pending = undefined;
+      if (transition.native) return;
+      forwarding = true;
+      try {
+        pi.events.emit("herdr:blocked", { active });
+      } finally {
+        forwarding = false;
+      }
+    });
+  });
+}

package/assets/terminal-workspace/setup.sh

@@ -41,6 +41,7 @@ END="# <<< acstack terminal-workspace <<<"
 PI_DIR="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
 PI_SETTINGS="$PI_DIR/settings.json"
 PI_KEYBINDINGS="$PI_DIR/keybindings.json"
+PI_QUESTION_BRIDGE="$PI_DIR/extensions/acstack-question-blocked.ts"
 PI_SUBAGENT_CFG="$PI_DIR/extensions/subagent/config.json"
 # agentic-retro install-pi picks its own directory, from $PI_HOME rather than
 # pi's override, so look where it writes.

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack-cli",
-  "version": "0.49.1",
+  "version": "0.49.2",
   "description": "CLI for the ACStack agentic coding stack",
   "type": "module",
   "license": "MIT",

package/docs/terminal-workspace.md

@@ -365,7 +365,14 @@ What `apply` does:
     - ACStack uses it because decisions can include markdown, code and artifact previews
     - It accepts freeform answers and notes, and needs no full-event telemetry environment variable
     - This setup still keeps pi's install telemetry disabled through `pi.settings.install_telemetry: false`
-    - Set `pi.question_tool: false` to leave it out, or to remove it later if this setup installed it
+    - Setup installs a managed question bridge under pi's agent directory, honoring `PI_CODING_AGENT_DIR`
+    - The bridge translates `rpiv:ask-user:blocked` into `herdr:blocked`, so herdr shows the question's input wait
+    - Answer, cancellation, and error completion release the question's blocker while other herdr blockers stay active
+    - A producer that also emits the matching herdr event synchronously contributes only one blocker
+    - Events carry no source ID, so the bridge treats a matching synchronous herdr event as the producer's own
+    - Reapply refreshes the owned bridge, but preserves a pre-existing file at the same path
+    - `pi.question_tool: false`, `disable pi`, and `uninstall` remove only the owned bridge and leave user workarounds alone
+    - Set `pi.question_tool: false` to leave the package out, or remove it later if this setup installed it
 - It installs `pi-web-access` by default for Pi web search and web access
     - The package is `pi-web-access` from `nicobailon/pi-web-access`
     - It adds web search, URL fetching, GitHub repo cloning, PDF extraction and media understanding tools to pi
@@ -402,6 +409,8 @@ How it treats pi's files:
 - `apply` never touches `auth.json`
     - Run `pi`, then `/login`, yourself
 - `setup.sh status` reports pi's version, its packages, the delegation line, `toolActivation`, and whether `auth.json` exists
+    - The question bridge line reports a managed asset, a user-owned path, or an absent asset
+    - Start a new pi session or run `/reload` after setup changes extensions
 - `setup.sh outdated` and `setup.sh upgrade` include `billion-context`, `@juicesharp/rpiv-todo`, `pi-plugin-manager`, `@juicesharp/rpiv-ask-user-question`, `pi-web-access`, `pi-lens`, and `pi-slash-anywhere` like pi's other npm packages
 
 ## 4. How you attach

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack",
-  "version": "0.49.1",
+  "version": "0.49.2",
   "private": false,
   "description": "Agentic coding stack with first-class Claude Code and pi support: skills, orchestrator instructions, and verification agents.",
   "license": "MIT",