@maxiaochao/pi-toolkit 0.11.17 → 0.11.19

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 2026-10-14 - v0.11.19
+
+- herdr-subagents v0.5.2: stop Pi startup from scanning historical runs or closing recorded Herdr tabs
+
+## 2026-10-14 - v0.11.18
+
+- simplify global worktree isolation guidance
+
 ## 2026-10-14 - v0.11.17
 
 - openai-account-pool v0.1.7: fix the session account marker after successful requests and failover

package/global/AGENTS.md

@@ -62,5 +62,3 @@ For frontend feature development, load the `web-browser` skill and verify the re
 ## 9. Worktree Isolation
 
 For a Git-repository task that coordinates substantial changes across multiple files or modules, or implements a feature intended for release, ask before editing whether to isolate it in a worktree. Skip the question when already in a linked worktree.
-
-If the user agrees, read the `pi-worktree` skill and establish the worktree before changing code. When no human is reachable, create a worktree only when the task explicitly requests one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-toolkit",
-  "version": "0.11.17",
+  "version": "0.11.19",
   "description": "Personal pi coding agent toolkit: scheduler, /btw, /cache_export, apply_patch, browser automation, and bundled theme/skills.",
   "type": "module",
   "workspaces": [

package/packages/herdr-subagents/ARCHITECTURE.md

@@ -107,6 +107,6 @@ There is no fixed drain delay and no transcript parsing. Pi retries are internal
 
 Writing the same report again is idempotent. A conflicting replacement is rejected.
 
-## Cancellation and recovery
+## Cancellation and shutdown
 
-Caller or parent-session cancellation aborts active waits, marks nonterminal tasks cancelled, and closes the owned Herdr tab. Startup recovery is scoped by recorded parent ownership and retains readers for prior record formats. Recovery never resumes or mutates an already terminal task.
+Caller or parent-session cancellation aborts active waits, marks nonterminal tasks cancelled, and closes the Herdr tab owned by that session. A new Pi session never scans, mutates, resumes, or closes historical runs during startup. If Pi is terminated before its shutdown handlers run, its visible Subagent tabs remain for explicit user inspection or cleanup.

package/packages/herdr-subagents/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2026-10-14 - v0.5.2
+
+- stop Pi startup from scanning historical runs or closing recorded Herdr tabs
+
 ## 2026-10-14 - v0.5.1
 
 - fix focus-safe run cleanup and compact report output

package/packages/herdr-subagents/README.md

@@ -36,6 +36,8 @@ The reproducible source recording is retained as [`docs/demo.webm`](docs/demo.we
 
 Each task starts a single-task interactive Pi process in its own Herdr pane. Herdr first confirms the interactive Pi is ready, then the prompt is delivered exactly once. Prompt acknowledgement never decides task completion. Panes remain ordinary Herdr panes: they can be focused and inspected while work is running or after it settles. An early-finishing child stays at the Pi UI while sibling tasks continue. After the whole run settles, cleanup closes an unfocused run tab immediately or waits for the user to leave a focused run tab.
 
+Cleanup belongs to the Pi session that created the run. Starting a new Pi session never scans historical runs or closes their recorded Herdr tabs. If Pi terminates before shutdown cleanup runs, any surviving Subagent tab remains visible for explicit inspection or cleanup.
+
 ## Result protocol
 
 The child must call `subagent_report` once with a terminal status:

package/packages/herdr-subagents/TESTING.md

@@ -16,6 +16,7 @@ It verifies:
 - waiting through a delayed authoritative report after a prompt transport error while the Pi process is alive;
 - explicit failure when the process exits without a report;
 - parent cancellation of running and queued tasks;
+- startup isolation: a new Pi session neither mutates historical records nor closes their recorded Herdr tabs;
 - immutable terminal task records;
 - idempotent duplicate reports and rejection of conflicting replacements;
 - keeping a settled child alive for focus-aware cleanup instead of force-exiting its TUI.

package/packages/herdr-subagents/extensions/herdr-subagents.ts

@@ -6,8 +6,7 @@ import { loadSubagentConfiguration } from "../src/config.ts";
 import { CliHerdrAutomation, type HerdrAutomation } from "../src/herdr.ts";
 import { activeRunText } from "../src/monitor.ts";
 import { historyText, listSubagentHistory } from "../src/history.ts";
-import { cancelQueuedRuns, loadQueuedRuns } from "../src/queued-runs.ts";
-import { cancelActiveSubagentRuns, reconcileSubagentRuns } from "../src/reconcile.ts";
+import { cancelActiveSubagentRuns } from "../src/reconcile.ts";
 import { executeHerdrSubagents, executeHerdrSubagentsControl, type HerdrSubagentsBatchDetails, type HerdrSubagentsControlToolParams, type HerdrSubagentsRunParams } from "../src/tool.ts";
 import { HerdrSubagentsControlParams, HerdrSubagentsParams } from "../src/parameters.ts";
 import { HERDR_ACTIONS } from "../src/validation.ts";
@@ -108,19 +107,6 @@ export interface HerdrSubagentsExtensionDependencies {
 	fleetWidgetRuntime?: FleetWidgetRuntime;
 }
 
-async function recoverParentSession(cwd: string, herdr: HerdrAutomation, owner: { sessionId?: string; processId: number }, notify: (message: string) => void): Promise<void> {
-	try {
-		const queued = await loadQueuedRuns(cwd, notify);
-		await cancelQueuedRuns(cwd, queued.map((run) => run.runId), { reason: "Owning parent Pi session is no longer active.", owner, onlyOrphaned: true, onError: notify });
-	}
-	catch (error) { notify(`Subagent queue recovery failed: ${error instanceof Error ? error.message : String(error)}`); }
-	try {
-		const reconciliation = await reconcileSubagentRuns(cwd, herdr, owner);
-		for (const message of reconciliation.cleanupErrors) notify(message);
-	}
-	catch (error) { notify(`Subagent recovery could not inspect active runs: ${error instanceof Error ? error.message : String(error)}`); }
-}
-
 async function shutdownParentSession(options: { cwd: string; herdr: HerdrAutomation; owner: { sessionId?: string; processId: number }; fleet: FleetController; sessionController: AbortController; runControllers: Map<string, AbortController>; inFlight: Set<Promise<unknown>>; notify: (message: string) => void }): Promise<void> {
 	options.sessionController.abort(new Error("Parent Pi session closed."));
 	for (const controller of options.runControllers.values()) controller.abort(new Error("Parent Pi session closed."));
@@ -146,12 +132,11 @@ export function registerHerdrSubagents(pi: ExtensionAPI, dependencies: HerdrSuba
 	pi.on("session_shutdown", async (_event, ctx) => {
 		await shutdownParentSession({ cwd: ctx.cwd, herdr, owner: { sessionId: ownerSessionId, processId: process.pid }, fleet, sessionController, runControllers, inFlight, notify: (message) => ctx.ui.notify(message, "error") });
 	});
-	pi.on("session_start", async (_event, ctx) => {
+	pi.on("session_start", (_event, ctx) => {
 		sessionController.abort(new Error("Parent Pi session changed."));
 		sessionController = new AbortController();
 		ownerSessionId = `${ctx.sessionManager.getSessionId()}:${randomUUID()}`;
 		fleet.bind(ctx.ui, ctx.mode === "tui");
-		await recoverParentSession(ctx.cwd, herdr, { sessionId: ownerSessionId, processId: process.pid }, (message) => ctx.ui.notify(message, "error"));
 	});
 
 	pi.registerTool({

package/packages/herdr-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-herdr-subagents",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Run inspectable interactive Pi subagent batches through Herdr.",
   "type": "module",
   "keywords": [

package/packages/herdr-subagents/tests/core-state-machine.mjs

@@ -4,6 +4,7 @@ import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { runHerdrSubagentsBatch } from "../src/batch-runner.ts";
 import registerSubagentReport from "../extensions/subagent-report.ts";
+import { registerHerdrSubagents } from "../extensions/herdr-subagents.ts";
 import { applyTaskStatus } from "../src/records.ts";
 
 process.env.HERDR_ENV = "1";
@@ -150,6 +151,37 @@ await assert.rejects(() => run([task("writer", "edit", "write"), task("reader",
 const terminal = { id: "task", runId: "run", order: 1, status: "completed" };
 assert.throws(() => applyTaskStatus(terminal, "running"), /terminal tasks are immutable/);
 
+{
+	const lifecycleRoot = join(root, "startup-history-isolation");
+	const runDirectory = join(lifecycleRoot, ".pi", "herdr-subagents", "runs", "historical-run");
+	const taskDirectory = join(runDirectory, "tasks", "01-task");
+	mkdirSync(taskDirectory, { recursive: true });
+	const historicalRun = { id: "historical-run", label: "historical", status: "completed", ownerSessionId: "old-session", ownerProcessId: 99999999, tabId: "w1:t-reused", taskIds: ["historical-task"], completedAt: "2026-10-01T00:00:00.000Z" };
+	writeFileSync(join(runDirectory, "run.json"), JSON.stringify(historicalRun));
+	writeFileSync(join(taskDirectory, "task.json"), JSON.stringify({ id: "historical-task", runId: "historical-run", order: 1, status: "completed", completedAt: historicalRun.completedAt }));
+	const events = new Map();
+	const herdrCalls = [];
+	registerHerdrSubagents({
+		on(name, handler) { events.set(name, handler); },
+		registerTool() {},
+		registerCommand() {},
+	}, {
+		herdr: {
+			async isTabFocused(tabId) { herdrCalls.push(["isTabFocused", tabId]); return false; },
+			async closeTab(tabId) { herdrCalls.push(["closeTab", tabId]); },
+		},
+		isEditor: () => false,
+	});
+	await events.get("session_start")?.({}, {
+		cwd: lifecycleRoot,
+		mode: "rpc",
+		sessionManager: { getSessionId: () => "new-session" },
+		ui: { notify() {} },
+	});
+	assert.deepEqual(herdrCalls, [], "Pi startup must not inspect or close historical Subagent tabs");
+	assert.deepEqual(JSON.parse(readFileSync(join(runDirectory, "run.json"), "utf8")), historicalRun, "Pi startup must not mutate historical Subagent records");
+}
+
 {
 	const directory = join(root, "report-idempotency");
 	mkdirSync(directory, { recursive: true });