pi-better-background-tasks 0.2.10 → 0.2.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-background-tasks",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Pi extension for durable background shell tasks, watchers, logs, and status inspection.",
   "license": "MIT",
   "type": "module",

package/src/shared-navigator.ts

@@ -97,7 +97,6 @@ type NavigatorState = {
 };
 
 const GLOBAL_KEY = Symbol.for("pi-better-harness.navigator.state");
-const PLAN_NAVIGATION_KEY = Symbol.for("pi-better-harness.plan-navigation.state");
 const FACTORY_MARK = "__piBetterHarnessNavigatorFactory";
 const FACTORY_REFRESH = "__piBetterHarnessNavigatorRefresh";
 
@@ -121,14 +120,6 @@ function state(): NavigatorState {
   return g[GLOBAL_KEY]!;
 }
 
-type PlanNavigationState = { visible: boolean; releaseWorkFocus?: () => void };
-
-function planNavigationState(): PlanNavigationState {
-  const global = globalThis as typeof globalThis & { [PLAN_NAVIGATION_KEY]?: PlanNavigationState };
-  if (!global[PLAN_NAVIGATION_KEY]) global[PLAN_NAVIGATION_KEY] = { visible: false };
-  return global[PLAN_NAVIGATION_KEY]!;
-}
-
 export function registerBackgroundWorkProvider(provider: BackgroundWorkProvider): () => void {
   const s = state();
   const previousUnsub = s.unsubscribers.get(provider.id);
@@ -194,7 +185,6 @@ export function ensureBackgroundWorkNavigator(ctx: ExtensionContext, deps: HostD
   s.mainListRequestRender = undefined;
   s.mainListDeadlineScheduler?.dispose();
   s.mainListDeadlineScheduler = createRenderScheduler(() => refreshMainListWidget());
-  planNavigationState().releaseWorkFocus = unfocusMainList;
   installNavigatorEditor(ctx.ui as any, deps);
   s.lastHint = undefined;
   refreshBackgroundWorkNavigator(ctx);
@@ -223,7 +213,6 @@ export function disposeBackgroundWorkNavigator(ctx?: ExtensionContext): void {
   s.mainListRequestRender = undefined;
   s.editorComponent = undefined;
   s.detailOverlayRows = undefined;
-  planNavigationState().releaseWorkFocus = undefined;
   s.mainListSelectedId = undefined;
   s.mainListFocused = false;
 }
@@ -471,10 +460,9 @@ function buildMainListLines(
 }
 
 function shortcutsLine(focused: boolean, fg: (color: string, value: string) => string): string {
-  const plan = planNavigationState().visible ? " · → plan" : "";
   const keys = focused
-    ? `↑↓ switch · Enter detail · x stop${plan} · Esc unfocus`
-    : `← work navigator${plan}`;
+    ? "↑↓ switch · Enter detail · x stop · Esc unfocus"
+    : "← work navigator";
   return dim(keys, fg);
 }
 

package/src/tools.ts

@@ -103,6 +103,12 @@ const StatusActionParams = Type.Object({
   verbose: Type.Optional(Type.Boolean()),
 });
 
+const BACKGROUND_ORCHESTRATION_GUIDELINES = [
+  "Use background tasks for genuinely long-running processes or repeated checks. Run short commands in the foreground.",
+  "When a structured plan is active, keep it as the coordinator ledger: launch relevant background work early, continue unblocked foreground work without polling, and update the plan after inspecting each terminal result or failure.",
+  "Do not treat launch as completion of the parent milestone; relevant background work must be terminal, inspected, and integrated before verification or completion.",
+];
+
 export function registerTools(pi: ExtensionAPI): void {
   let activeSession: BackgroundTaskCallbackOrigin | undefined;
   const getActiveSession = () => activeSession;
@@ -125,6 +131,7 @@ export function registerTools(pi: ExtensionAPI): void {
     name: "bg_task_spawn",
     label: "BG Spawn",
     description: "Start a long-running background process and return immediately with its task id. For remote work, prefer structured ssh: pass ssh:{host,user} and put the remote command in command; spawn defaults to a remote tmux session with durable local logs and real remote stop. For short synchronous remote commands that should return output now, use remote_bash from pi-better-ssh. If tmux is missing, the preset attempts to install tmux non-interactively and fails closed with operator guidance when setup cannot proceed. Explicit remote.session=direct skips tmux, but direct mode has weaker stop semantics and may leave the remote process running. Never wait or poll in the foreground.",
+    promptGuidelines: BACKGROUND_ORCHESTRATION_GUIDELINES,
     parameters: SpawnParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       activeSession = getCallbackOrigin(ctx);
@@ -138,6 +145,7 @@ export function registerTools(pi: ExtensionAPI): void {
     name: "bg_task_watch",
     label: "BG Watch",
     description: "Poll a command in the background until success_when, failure_when, or timeout matches. For remote work, prefer structured ssh: pass ssh:{host,user} and provide the remote command in command; each interval opens a direct one-shot SSH poll without tmux installation. For short synchronous remote commands that should return output now, use remote_bash from pi-better-ssh. Returns immediately with its task id. Default timeout 900 seconds; pass timeout_seconds:0 to disable.",
+    promptGuidelines: BACKGROUND_ORCHESTRATION_GUIDELINES,
     parameters: WatchParams,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
       activeSession = getCallbackOrigin(ctx);
@@ -198,6 +206,7 @@ export function registerTools(pi: ExtensionAPI): void {
     name: "bg_task",
     label: "BG Task",
     description: "Action wrapper for background tasks: spawn, watch, list, status, log, stop, or clear. For remote work, prefer structured ssh: pass ssh:{host,user} and provide the remote command in command. For short synchronous remote commands that should return output now, use remote_bash from pi-better-ssh. SSH spawn defaults to durable tmux; SSH watches use direct one-shot polls without tmux installation; remote.session=direct is a weaker-stop spawn escape hatch. Spawn/watch return immediately; do not poll in foreground. For action:status, default compact output and use verbose:true only for full metadata. For action:log, default compact tail and use tail_lines:0 only for explicit full logs.",
+    promptGuidelines: BACKGROUND_ORCHESTRATION_GUIDELINES,
     parameters: ActionParams,
     renderResult(result: unknown, options: unknown, theme: unknown) {
       return renderBackgroundTaskLogDisplay(result, options, theme);