acstack 0.50.0 → 0.50.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.50.0",
+  "version": "0.50.2",
   "author": {
     "name": "ac8318740"
   },

package/README.md

@@ -66,10 +66,10 @@ Then, in your project:
 
 ### 1.2. Install on pi
 
-*The same project installs as a [pi](https://pi.dev) package. Subagents come from the `pi-subagents` package.*
+*The same project installs as a [pi](https://pi.dev) package with `@tintinweb/pi-subagents` or `pi-subagents` for delegation.*
 
 ```
-pi install npm:pi-subagents
+pi install npm:@tintinweb/pi-subagents
 pi install npm:acstack
 ```
 
@@ -91,16 +91,20 @@ Then, in your project, run `/acstack:setup`.
         - Freshness uses `/acstack:handoff` when a fresh window or independent read helps more
         - With no thresholds set, the first nudge comes at 200k tokens or half the window, whichever is lower
         - The urgent nudge comes at 500k tokens or 80% of the window, whichever is lower
-- `pi-subagents` finds the four agents through the `pi.subagents` field in `package.json`
-    - The agents use your `pi-subagents` default model
-    - ACStack warns at session start when `pi-subagents` is missing
-- Allow delegation in `~/.pi/agent/AGENTS.md` – `pi-subagents` only delegates when your request or your instructions allow it:
+- ACStack includes the question-status bridge automatically
+    - With `@juicesharp/rpiv-ask-user-question` and Herdr's Pi integration installed, Herdr shows blocked while Pi waits for an answer
+    - Existing setup-installed bridges can stay installed without counting the same wait twice
+- Both subagent packages find the four agents through the `pi.subagents` field in `package.json`
+    - `@tintinweb/pi-subagents` exposes `Agent`; `pi-subagents` exposes `subagent`
+    - The agents use your subagent package's default model
+    - ACStack warns at session start when pi lists neither tool
+- Allow delegation in `~/.pi/agent/AGENTS.md`:
 
     ```
     When an ACStack skill or the ACStack orchestrator says to launch a subagent, you may delegate to it.
     ```
 
-    - Set `"toolActivation": "eager"` in `~/.pi/agent/extensions/subagent/config.json` to offer the `subagent` tool from the first turn (restart pi after)
+    - For `pi-subagents`, set `"toolActivation": "eager"` in `~/.pi/agent/extensions/subagent/config.json` to offer `subagent` from the first turn (restart pi after)
 - pi gets the ACStack writing style from the extension by default
     - Run `/acstack-writing-style default` to use the bundled style again
     - Run `/acstack-writing-style off` to disable style injection

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

@@ -1,31 +1,19 @@
 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;
-    }
-  });
+const TAKEOVER = "acstack:question-blocked:takeover";
 
-  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;
-      }
+export default function (pi: ExtensionAPI) {
+  pi.on("session_start", () => {
+    pi.events.emit(TAKEOVER, {});
+    // Register after legacy factories so our synchronous relay suppresses their queued copy.
+    // shortcut: legacy compatibility excludes recursively emitted public events; remove the legacy copy if needed
+    const stopRelay = pi.events.on("rpiv:ask-user:blocked", (event: unknown) => {
+      const active = (event as { active?: unknown } | null)?.active;
+      if (typeof active === "boolean") pi.events.emit("herdr:blocked", { active });
+    });
+    const stopTakeover = pi.events.on(TAKEOVER, () => {
+      stopRelay();
+      stopTakeover();
     });
   });
 }

package/cli/package.json

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

package/docs/terminal-workspace.md

@@ -365,11 +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`
-    - Setup installs a managed question bridge under pi's agent directory, honoring `PI_CODING_AGENT_DIR`
+    - ACStack's Pi package loads the question bridge automatically, including installations made without terminal-workspace setup
+    - Setup also installs a fallback copy under pi's agent directory, honoring `PI_CODING_AGENT_DIR`
+    - The packaged bridge and fallback copy count each wait once when both load
     - 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
+    - Anonymous native Herdr events remain independent from question events, including simultaneous waits
+    - A producer emitting both event types contributes two balanced blockers, which clear when both sources finish
+    - Older fallback copies work unless another extension recursively emits public question events; remove the older copy in that case
     - 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

package/orchestrator/AGENTS.md

@@ -40,8 +40,8 @@ ACStack runs on Claude Code, Codex, and pi. The skills name each capability once
 
 - **Launch a subagent** – start a child agent with its own context, by its ACStack name (`test-writer`, `task-executor`, `task-checker`, `frontend-verifier`)
     - Claude Code: the Agent tool, with `subagent_type` set to that name
-    - pi: the `subagent` tool from `pi-subagents`
-    - **Read-only codebase-search subagent** – Claude Code's `Explore`, pi's `scout`
+    - pi: `Agent` from `@tintinweb/pi-subagents` (`subagent_type`), or `subagent` from `pi-subagents` (`agent`)
+    - **Read-only codebase-search subagent** – `Explore` on Claude Code and pi's `Agent`, or `scout` on pi's `subagent`
     - `debugger` names a debugging agent
     - On a host without a matching built-in agent, launch a general subagent with that brief
 - **Agent team** – parallel full sessions, each owning one scope and launching its own subagents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acstack",
-  "version": "0.50.0",
+  "version": "0.50.2",
   "private": false,
   "description": "Agentic coding stack with first-class Claude Code and pi support: skills, orchestrator instructions, and verification agents.",
   "license": "MIT",
@@ -38,7 +38,8 @@
   ],
   "pi": {
     "extensions": [
-      "./pi/extension.ts"
+      "./pi/extension.ts",
+      "./assets/terminal-workspace/pi/acstack-question-blocked.ts"
     ],
     "subagents": {
       "agents": [

package/pi/extension.ts

@@ -603,11 +603,11 @@ export default function acstack(pi: ExtensionAPI): void {
 	pi.on("session_start", async (event, ctx) => {
 		linkClis(ctx);
 
-		if (!warnedSubagents && !pi.getAllTools().some((tool) => tool.name === "subagent")) {
+		if (!warnedSubagents && !pi.getAllTools().some((tool) => tool.name === "subagent" || tool.name === "Agent")) {
 			warnedSubagents = true;
 			report(
 				ctx,
-				"acstack: pi-subagents is not loaded, so the test-writer, task-executor, task-checker and frontend-verifier agents cannot run. Install it with `pi install npm:pi-subagents`.",
+				"acstack: no supported subagent tool is loaded (Agent or subagent), so the test-writer, task-executor, task-checker, and frontend-verifier agents cannot run. Install `npm:@tintinweb/pi-subagents` or `npm:pi-subagents` with `pi install`.",
 				"warning",
 			);
 		}