@llblab/pi-actors 0.26.1 → 0.26.2

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.26.2: Terminal Progress Hotfix
+
+- `[Async Runs]` Keep `progress.json` aligned with terminal kill/cancel handling by writing `phase=killed` or `phase=cancelled` and clearing active subagent counts when a run is stopped by runtime control.
+- `[Inspector]` Prevent killed runs from showing contradictory `status=killed` with `progress.phase=running`, preserving compact operator status trust after `control.kill`.
+
 ## 0.26.1: Coordinator Empty-Synthesis Hotfix
 
 - `[Coordinator]` Treat all-failed participant rounds and empty synthesis as a failed coordinator run instead of a clean success, preserving operator trust when swarm branches all exit non-zero.

package/dist/lib/async-runs.js

@@ -565,6 +565,10 @@ export function readRunStateIndex(stateRoot = DEFAULT_STATE_ROOT) {
     });
     if (valid.some((entry) => !existsSync(join(entry.state_dir, "run.json"))))
         return undefined;
+    const indexedDirs = new Set(valid.map((entry) => resolve(entry.state_dir)));
+    const stateDirs = listRunStateDirs(stateRoot).map((stateDir) => resolve(stateDir));
+    if (stateDirs.some((stateDir) => !indexedDirs.has(stateDir)))
+        return undefined;
     return valid;
 }
 export function listRuns(stateRoot = DEFAULT_STATE_ROOT, statusFilter) {
@@ -1010,6 +1014,20 @@ function markTerminalHandled(stateDir, details) {
         ts: new Date().toISOString(),
     });
 }
+function markTerminalProgress(stateDir, phase) {
+    const existing = readJson(join(stateDir, "progress.json"));
+    const progress = existing && typeof existing === "object" && !Array.isArray(existing)
+        ? existing
+        : {};
+    const { activeSubagents: _activeSubagents, ...rest } = progress;
+    writeJsonAtomic(join(stateDir, "progress.json"), {
+        ...rest,
+        completed: typeof progress.completed === "number" ? progress.completed : 0,
+        failures: Array.isArray(progress.failures) ? progress.failures : [],
+        phase,
+        updatedAt: new Date().toISOString(),
+    });
+}
 function stopRun(runOrDir, signal, event) {
     const status = getRunStatus(runOrDir);
     const pid = Number(status.pid || 0);
@@ -1024,6 +1042,10 @@ function stopRun(runOrDir, signal, event) {
     const signalResult = signalOwnedRunProcess(pid, signal);
     writeFileSync(join(stateDir, "events.jsonl"), `${JSON.stringify({ event, pid, signal, ...signalResult, ts: new Date().toISOString() })}\n`, { flag: "a" });
     markTerminalHandled(stateDir, { event, signal });
+    if (event === "run.kill")
+        markTerminalProgress(stateDir, "killed");
+    if (event === "run.cancel")
+        markTerminalProgress(stateDir, "cancelled");
     return { stopped: true, pid, signal, ...signalResult, state_dir: stateDir };
 }
 export function cancelRun(runOrDir) {

package/dist/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.26.1
+  version: 0.26.2
 ---
 
 # Actors (pi-actors)

package/dist/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.26.1
+  version: 0.26.2
 ---
 
 # Swarm

package/lib/async-runs.ts

@@ -805,6 +805,9 @@ export function readRunStateIndex(
   });
   if (valid.some((entry) => !existsSync(join(entry.state_dir, "run.json"))))
     return undefined;
+  const indexedDirs = new Set(valid.map((entry) => resolve(entry.state_dir)));
+  const stateDirs = listRunStateDirs(stateRoot).map((stateDir) => resolve(stateDir));
+  if (stateDirs.some((stateDir) => !indexedDirs.has(stateDir))) return undefined;
   return valid;
 }
 
@@ -1403,6 +1406,25 @@ function markTerminalHandled(
   });
 }
 
+function markTerminalProgress(
+  stateDir: string,
+  phase: "cancelled" | "killed",
+): void {
+  const existing = readJson(join(stateDir, "progress.json"));
+  const progress =
+    existing && typeof existing === "object" && !Array.isArray(existing)
+      ? (existing as Record<string, unknown>)
+      : {};
+  const { activeSubagents: _activeSubagents, ...rest } = progress;
+  writeJsonAtomic(join(stateDir, "progress.json"), {
+    ...rest,
+    completed: typeof progress.completed === "number" ? progress.completed : 0,
+    failures: Array.isArray(progress.failures) ? progress.failures : [],
+    phase,
+    updatedAt: new Date().toISOString(),
+  });
+}
+
 function stopRun(
   runOrDir: string,
   signal: NodeJS.Signals,
@@ -1425,6 +1447,8 @@ function stopRun(
     { flag: "a" },
   );
   markTerminalHandled(stateDir, { event, signal });
+  if (event === "run.kill") markTerminalProgress(stateDir, "killed");
+  if (event === "run.cancel") markTerminalProgress(stateDir, "cancelled");
   return { stopped: true, pid, signal, ...signalResult, state_dir: stateDir };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "private": false,
   "description": "Local Actor Kernel for Pi",
   "keywords": [

package/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.26.1
+  version: 0.26.2
 ---
 
 # Actors (pi-actors)

package/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.26.1
+  version: 0.26.2
 ---
 
 # Swarm