pi-better-harness 0.33.1 → 0.34.1

package/README.md

@@ -13,15 +13,26 @@ Use `pi-better-harness` when you want the full working set for Pi. It manages:
 - `pi-better-background-tasks` for durable shell tasks and watchers.
 - `pi-better-ssh` for short remote commands over reusable SSH connections.
 - `pi-better-goal` for explicit triggers, pause/resume, and background-aware continuation.
-- Harness-owned Outcome & Todo for session context and checklist progress. It starts off; enable **Outcome & Todo** in `/harness-settings`.
+- Harness-owned Outcome & Todo for session context and checklist progress. Saved state displays by default; its hooks start off.
 
 `pi-better-read-aloud` is intentionally not included yet.
 
 ## Outcome & Todo
 
-In `/harness-settings`, **Outcome & Todo** starts **Off**. Turn it on to expose
-`update_todo`, `get_todo`, and the native Todo widget. `/todo` opens the full view;
-`/todo expand` and `/todo collapse` control the compact checklist.
+In `/harness-settings`, **Outcome & Todo display** (`outcome-todo-display`)
+defaults to **On**, and **Outcome & Todo hooks** (`outcome-todo`) defaults to
+**Off**. Saved outcomes and checklists display even when hooks are off; missing
+state creates no placeholder, state, or settings. Turning display off does not
+disable hooks. Saved v1 `enabled` remains the hooks authority; the new optional
+display preference defaults to true.
+
+The compact widget has one Todo heading, with a caret after Todo and the completion
+count on the left. A matching Goal's status and existing active-time clock appear
+on the right. The outcome is one muted, truncated subtitle. The collapsed view
+shows up to five relevant rows; the expanded view shows all rows. Click to toggle.
+`/todo` shows the full objective, acceptance criteria, boundaries, and plan;
+`/todo expand` and `/todo collapse` also control the compact checklist. Todo
+commands remain available with hooks off for explicit user control.
 
 An accepted outcome can be saved without a checklist. Completing or clearing its
 Todo does not complete or remove the outcome. Write labels as short, plain actions,
@@ -32,15 +43,20 @@ existing saved labels remain unchanged until deliberately updated.
 
 Use `newTask: true` with a new
 outcome for unrelated work; a correction to the current task keeps its binding.
-Harness includes a short reminder before each model call while the outcome is
-active. Disabling the feature hides its tools and display and stops reminders,
-without deleting saved state or starting a turn. `/goal` and skills never enable it.
+Hooks enable `update_todo`, `get_todo`, capture, matching Goal lifecycle bridge
+writes, reminders, and automated cleanup. While hooks are enabled and the outcome is active, Harness
+includes a short reminder before each model call. Turning hooks off stops those
+hooks without deleting saved state or starting a turn. `/goal` and skills never
+enable them.
 
 Existing Plan session histories restore as Todo. Workflow task-plan files and
 revision checks stay unchanged; skills continue using their own records when the
 optional interface is off. See the [usage guide](docs/usage.md#outcome--todo).
 
-<p><img src="https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/todo-examples/middle.png" alt="Compact Harness Todo" width="49%" /><img src="https://raw.githubusercontent.com/1aboveio/pi-better-harness/main/docs/images/package-gallery/todo-examples/expanded.png" alt="Expanded Harness Todo" width="49%" /></p>
+Subagent and background-task rows can be clicked to open their existing navigator
+details. Enter and keyboard controls remain available, and editor input stays
+passive. No permanent status bar is added; existing critical permission and
+paused notices remain unchanged.
 
 ## Screenshots
 
@@ -71,7 +87,7 @@ pi install npm:pi-better-harness
 After a normal bundle install or `pi update`, Harness masks any separately loaded
 `pi-better-plan` package before Pi registers its tools, `/plan` command, widgets,
 or prompt hooks. This applies in either load order, including when Outcome & Todo
-is off. The old registration and cached files may remain, but are inactive while
+hooks are off. The old registration and cached files may remain, but are inactive while
 Harness is loaded. Settings and session history are not rewritten. The explicit
 installer above removes the old registration in its selected scope instead.
 

package/extensions/task-context/compact-task-header.ts

@@ -0,0 +1,35 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import type { PlanRenderTheme } from "./plan-presentation.js";
+
+export interface CompactTaskHeader {
+  subtitle?: string;
+  disclosure?: string;
+  runtime?: { status: string; clock?: string };
+}
+
+export function canRenderTaskRuntime(width: number, runtime: CompactTaskHeader["runtime"]): boolean {
+  if (!runtime || !Number.isFinite(width)) return false;
+  return visibleWidth(runtime.status + (runtime.clock ? `  ${runtime.clock}` : "")) + 6 <= Math.floor(width);
+}
+
+export function renderCompactTaskHeader(summary: string | undefined, width: number, theme: PlanRenderTheme, header: CompactTaskHeader): string[] {
+  const size = Math.max(1, Math.floor(width));
+  const left = theme.fg("warning", "todo") + (header.disclosure ? theme.fg("accent", ` ${header.disclosure}`) : "") +
+    (summary ? theme.fg("dim", `  ${summary}`) : "");
+  const runtime = header.runtime;
+  const tone = runtime?.status === "complete" ? "success" : runtime?.status === "active" ? "accent" : "warning";
+  const right = runtime ? theme.fg(tone, runtime.status) + (runtime.clock ? theme.fg("dim", `  ${runtime.clock}`) : "") : "";
+  const rightWidth = visibleWidth(right);
+  const leftWidth = Math.max(4, size - rightWidth - 2);
+  const title = truncateToWidth(left, leftWidth);
+  const heading = right && canRenderTaskRuntime(size, runtime)
+    ? title + " ".repeat(Math.max(2, size - visibleWidth(title) - rightWidth)) + right
+    : truncateToWidth(left, size);
+  const lines = [truncateToWidth(heading, size)];
+  if (header.subtitle) {
+    const indent = Math.min(2, size - 1);
+    const text = header.subtitle.replace(/[\r\n\t]+/g, " ").replace(/ {2,}/g, " ").trim();
+    lines.push(" ".repeat(indent) + theme.fg("muted", truncateToWidth(text, size - indent)), "");
+  }
+  return lines;
+}

package/extensions/task-context/index.ts

@@ -4,7 +4,11 @@ import { Text, matchesKey, type AutocompleteItem } from "@earendil-works/pi-tui"
 import { Type } from "typebox";
 import { readHarnessSetting, updateHarnessSetting } from "../shared-harness-settings.js";
 import { reconstructGoalSnapshot } from "pi-better-goal/src/goal-state.ts";
+import { formatClockDuration, goalTiming } from "pi-better-goal/src/goal-clock.ts";
 import { OUTCOME_ENTRY, prepareOutcome, restoreOutcome, formatOutcome, type Outcome, type OutcomeInput } from "./outcome-state.js";
+import { changeOutcomeTodoPreference, parseOutcomeTodoPreferences } from "./preferences.js";
+import { canRenderTaskRuntime, renderCompactTaskHeader, type CompactTaskHeader } from "./compact-task-header.js";
+import type { GoalSnapshot } from "pi-better-goal/src/types.ts";
 
 import {
   completedPlanClearDelay,
@@ -87,6 +91,7 @@ const UpdatePlanSchema = Type.Object({
 type WorkflowPlanInput = Omit<RushPlanUpdate, "event"> & { path?: string; event?: string };
 
 const LEGACY_PLAN_NAV_STATUS_KEY = "pi-better-plan-nav";
+const goalHeaderRuntime = (goal: GoalSnapshot) => ({ status: goal.status, clock: formatClockDuration(goalTiming(goal).activeSeconds) });
 const PLAN_ACTIONS: readonly AutocompleteItem[] = [
   { value: "clear", label: "clear", description: "Remove the current Todo without changing its outcome" },
   { value: "hide", label: "hide", description: "Hide the Todo widget" },
@@ -120,12 +125,9 @@ function workflowPlanOwner(ctx: ExtensionContext): string | null {
 
 export default function taskContextExtension(pi: ExtensionAPI): void {
   let enabled = false;
+  let display = true;
+  let widgetContext: ExtensionContext | undefined;
   let outcome: Outcome | null = null;
-  const readEnabled = (value: unknown): boolean => {
-    if (value === undefined) return false;
-    if (!value || typeof value !== "object" || Array.isArray(value) || (value as any).version !== 1 || typeof (value as any).enabled !== "boolean") throw new Error("Invalid outcomeTodo setting.");
-    return (value as { enabled: boolean }).enabled;
-  };
   const syncTools = (): void => {
     if (typeof pi.getActiveTools !== "function" || typeof pi.setActiveTools !== "function") return;
     const active = pi.getActiveTools().filter(name => name !== "update_todo" && name !== "get_todo");
@@ -153,7 +155,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
   };
   const scheduleCancelledRowsClear = (): void => {
     cancelCancelledRowsTimer();
-    if (!rushPlan) return;
+    if (!enabled || !rushPlan) return;
     const delay = cancelledRowsClearDelay(rushPlan);
     if (delay === null) return;
     const timer = setTimeout(() => {
@@ -166,12 +168,13 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     timer.unref?.();
   };
   const observeCancellations = (plan: RushPlan, binding: WorkflowPlanBinding, ctx: ExtensionContext): void => {
+    if (!enabled) return;
     observeCancelledRows(plan, binding, ctx.sessionManager.getBranch(), (type, data) => pi.appendEntry(type, data));
   };
   const unsubscribeWorkflow = pi.events.on("pi-better-workflow:changed", (owner) => {
     displayedWorkflowOwner = owner && typeof owner === "object" && "name" in owner && typeof owner.name === "string"
       ? owner.name : null;
-    if (!enabled) return;
+    if (!enabled && !display) return;
     if (displayedWorkflowOwner) {
       cancelCancelledRowsTimer();
       rushBinding = null;
@@ -283,7 +286,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     rushBinding = binding && (!displayedWorkflowOwner || binding.owner === displayedWorkflowOwner) ? binding : null;
     rushPlan = null;
     rushError = null;
-    if (enabled && rushBinding) loadRushPlan(ctx);
+    if ((enabled || display) && rushBinding) loadRushPlan(ctx);
     displayMode = state.displayMode;
     expanded = state.expanded;
     if (ctx.hasUI) ctx.ui.setStatus(LEGACY_PLAN_NAV_STATUS_KEY, undefined);
@@ -313,24 +316,32 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
 
   const installWidget = (ctx: ExtensionContext): void => {
     if (!ctx.hasUI) return;
+    widgetContext = ctx;
     ctx.ui.setWidget(
       EXTENSION_NAME,
       (tui, theme) => {
         const localRefresh = (force = false): void => tui.requestRender(force);
         refreshWidget = localRefresh;
         const widget = createPlanWidget(
-          (width: number): string[] => {
-            if (!enabled || displayMode === "hidden" || displayedWorkflowOwner !== workflowPlanOwner(ctx)) return [];
-            const heading = outcome ? new Text(`Outcome (${outcome.status}): ${outcome.objective}`, 0, 0).render(width).slice(0, 2) : [];
+          (width: number, disclosure?: string): string[] => {
+            if (!display || displayMode === "hidden" || displayedWorkflowOwner !== workflowPlanOwner(ctx)) return [];
+            const goal = reconstructGoalSnapshot(ctx.sessionManager.getBranch());
+            const boundGoal = goal && outcome?.goalId === goal.goalId ? goal : null;
+            const header: CompactTaskHeader = {
+              subtitle: outcome?.objective, disclosure,
+              runtime: boundGoal ? goalHeaderRuntime(boundGoal)
+                : outcome ? { status: outcome.status } : undefined,
+            };
+            const heading = outcome ? renderCompactTaskHeader(undefined, width, theme as never, header) : [];
             if (displayedWorkflowOwner || rushBinding) {
               if (!rushBinding || (displayedWorkflowOwner && rushBinding.owner !== displayedWorkflowOwner) ||
                   !workflowBinding(ctx.sessionManager.getBranch())) return heading;
               const fg = typeof theme?.fg === "function"
                 ? (color: string, value: string) => theme.fg(color as never, value)
                 : undefined;
-              return [...heading, ...(rushPlan ? renderRushPlan(rushPlan, width, false, fg, rushBinding.owner, !displayedWorkflowOwner, expanded) : [])];
+              return rushPlan ? renderRushPlan(rushPlan, width, false, fg, rushBinding.owner, !displayedWorkflowOwner, expanded, header) : heading;
             }
-            return [...heading, ...(currentPlan ? renderCompactPlan(currentPlan, width, theme as never, expanded) : [])];
+            return currentPlan ? renderCompactPlan(currentPlan, width, theme as never, expanded, header) : heading;
           },
           () => (rushBinding && rushPlan ? visibleRushUnits(rushPlan).length : currentPlan?.steps.length ?? 0) > COMPACT_PLAN_ROWS,
           () => expanded,
@@ -368,7 +379,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
             ? (color: string, value: string) => theme.fg(color as never, value)
             : undefined;
           const component = createRushPlanComponent(() => rushPlan ?? { ...plan, issues: [] }, () => done(), fg, planOwner, !owner);
-          return { render: (width) => [...(outcome ? new Text(formatOutcome(outcome, true), 0, 0).render(width).slice(0, 6) : []), ...component.render(width)], handleInput(data) {
+          return { render: (width) => [...(outcome ? new Text(formatOutcome(outcome), 0, 0).render(width) : []), ...component.render(width)], handleInput(data) {
             component.handleInput?.(data);
             tui.requestRender();
           }, invalidate: () => component.invalidate() };
@@ -396,7 +407,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     await ctx.ui.custom<void>((tui, theme, _keybindings, done) => {
       const component = createFullPlanComponent(snapshot, theme as never, () => done());
       return {
-        render: (width) => [...(outcome ? new Text(formatOutcome(outcome, true), 0, 0).render(width).slice(0, 6) : []), ...component.render(width)],
+        render: (width) => [...(outcome ? new Text(formatOutcome(outcome), 0, 0).render(width) : []), ...component.render(width)],
         handleInput(data) {
           component.handleInput?.(data);
           tui.requestRender();
@@ -426,7 +437,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     ],
     parameters: UpdatePlanSchema,
     async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
-      if (!enabled) throw new Error("Outcome & Todo is off. Enable it in /harness-settings.");
+      if (!enabled) throw new Error("Outcome & Todo hooks are off. Enable them in /harness-settings.");
       const owner = workflowPlanOwner(ctx);
       const input = params as { explanation?: string; newTask?: boolean; todo?: PlanStepInput[]; outcome?: OutcomeInput; workflow?: WorkflowPlanInput };
       if (!input.outcome && input.todo === undefined && !input.workflow) throw new Error("Send outcome, todo, or workflow.");
@@ -541,7 +552,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     promptSnippet: "Inspect the current outcome and Todo",
     parameters: getTodoParameters,
     async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
-      if (!enabled) throw new Error("Outcome & Todo is off. Enable it in /harness-settings.");
+      if (!enabled) throw new Error("Outcome & Todo hooks are off. Enable them in /harness-settings.");
       const owner = workflowPlanOwner(ctx);
       const binding = workflowBinding(ctx.sessionManager.getBranch());
       if (owner || binding) {
@@ -573,7 +584,6 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     description: "Inspect, show, hide, or clear the current Todo and inspect its outcome",
     getArgumentCompletions: planArgumentCompletions,
     handler: async (args, ctx) => {
-      if (!enabled) { ctx.ui.notify("Enable Outcome & Todo in /harness-settings.", "info"); return; }
       const input = args.trim().toLowerCase();
       if (!input) return showFullPlan(ctx);
       if (input === "clear") {
@@ -608,25 +618,35 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     },
   });
 
-  const setting = {
-    id: "outcome-todo", label: "Outcome & Todo", values: ["Off", "On"],
-    get: () => enabled ? "On" : "Off",
+  const setting = (key: "enabled" | "display") => ({
+    id: key === "enabled" ? "outcome-todo" : "outcome-todo-display",
+    label: key === "enabled" ? "Outcome & Todo hooks" : "Outcome & Todo display", values: ["Off", "On"],
+    get: () => (key === "enabled" ? enabled : display) ? "On" : "Off",
     async change(value: string, ctx: ExtensionContext) {
       if (value !== "On" && value !== "Off") throw new Error("Invalid Outcome & Todo mode.");
-      updateHarnessSetting("outcomeTodo", current => { readEnabled(current); return { version: 1, enabled: value === "On" }; });
-      enabled = value === "On";
+      const preferences = updateHarnessSetting("outcomeTodo", current => changeOutcomeTodoPreference(current, key, value === "On"));
+      enabled = preferences.enabled;
+      display = preferences.display;
       syncTools();
-      if (enabled) { installWidget(ctx); restore(ctx); }
-      else { cancelCompletedPlanClear(); cancelCancelledRowsTimer(); if (ctx.hasUI) ctx.ui.setWidget(EXTENSION_NAME, undefined); refreshWidget = undefined; }
+      if (!enabled) { cancelCompletedPlanClear(); cancelCancelledRowsTimer(); }
+      installWidget(ctx);
+      restore(ctx);
     },
-  };
-  const registerSettings = () => pi.events.emit("harness-settings:register", setting);
+  });
+  const controls = [setting("display"), setting("enabled")];
+  const registerSettings = () => controls.forEach(control => pi.events.emit("harness-settings:register", control));
   const unsubscribeSettings = pi.events.on("harness-settings:request", registerSettings);
   registerSettings();
   const unsubscribeTask = pi.events.on("pi-better-harness:task-context", (event: unknown) => {
     if (!event || typeof event !== "object") return;
-    const request = event as { action: string; goalId?: string; objective?: string; enabled?: boolean };
+    const request = event as { action: string; goalId?: string; width?: number; objective?: string; enabled?: boolean; display?: boolean };
     request.enabled = enabled;
+    if (request.action === "inspect") {
+      const goal = widgetContext ? reconstructGoalSnapshot(widgetContext.sessionManager.getBranch()) : null;
+      request.display = !!(typeof request.goalId === "string" && widgetContext && display && displayMode !== "hidden" &&
+        outcome && request.goalId === outcome.goalId && goal?.goalId === request.goalId && typeof request.width === "number" &&
+        canRenderTaskRuntime(request.width, goalHeaderRuntime(goal)) && displayedWorkflowOwner === workflowPlanOwner(widgetContext));
+    }
     if (!enabled || request.action === "inspect") return;
     if (request.action === "start" && request.goalId && request.objective?.trim()) {
       if (outcome?.goalId === request.goalId) return;
@@ -642,9 +662,13 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
   const onSessionStart = async (_event: unknown, ctx: ExtensionContext): Promise<void> => {
     // Retire a separately installed pi-better-plan before installing our Todo widget.
     await legacyPlanMask?.cleanup(ctx);
-    try { enabled = readEnabled(readHarnessSetting("outcomeTodo")); } catch (error) { enabled = false; if (ctx.hasUI) ctx.ui.notify(String(error), "warning"); }
+    try {
+      const preferences = parseOutcomeTodoPreferences(readHarnessSetting("outcomeTodo"));
+      enabled = preferences.enabled;
+      display = preferences.display;
+    } catch (error) { enabled = false; display = true; if (ctx.hasUI) ctx.ui.notify(String(error), "warning"); }
     syncTools();
-    if (enabled) installWidget(ctx);
+    installWidget(ctx);
     restore(ctx);
     registerSettings();
   };
@@ -669,6 +693,7 @@ export default function taskContextExtension(pi: ExtensionAPI): void {
     if (typeof unsubscribeSettings === "function") unsubscribeSettings();
     if (typeof unsubscribeTask === "function") unsubscribeTask();
     refreshWidget = undefined;
+    widgetContext = undefined;
     try {
       ctx.ui.setStatus(LEGACY_PLAN_NAV_STATUS_KEY, undefined);
       ctx.ui.setWidget(EXTENSION_NAME, undefined);

package/extensions/task-context/plan-presentation.ts

@@ -1,5 +1,6 @@
 import type { Component } from "@earendil-works/pi-tui";
 import { matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import { renderCompactTaskHeader, type CompactTaskHeader } from "./compact-task-header.js";
 
 export interface PlanRenderTheme {
   fg(color: string, value: string): string;
@@ -64,6 +65,7 @@ export function planText(value: string): string {
 export function renderPlanPresentation(
   plan: PlanPresentation, width: number, theme: PlanRenderTheme,
   full = false, selectedIndex = -1, expanded = false,
+  header?: CompactTaskHeader,
 ): string[] {
   const size = Math.max(1, Math.floor(width));
   const count = (status: DisplayStatus) => plan.rows.filter((row) => row.status === status).length;
@@ -77,13 +79,14 @@ export function renderPlanPresentation(
     if (count(status)) summary.push(`${count(status)} ${label}`);
   }
   if (count("pending") && summary.length === 1) summary.push(`${count("pending")} pending`);
-  const lines = [theme.fg("warning", "todo") + theme.fg("dim", `  ${summary.join(" · ")}`)];
+  const lines = !full && header ? renderCompactTaskHeader(summary[0], size, theme, header)
+    : [theme.fg("warning", "todo") + theme.fg("dim", `  ${summary.join(" · ")}`)];
   for (const metadata of plan.metadata ?? []) {
     const content = metadata.map((part) => theme.fg(part.color, planText(part.text))).join("");
     for (const line of wrapTextWithAnsi(content, Math.max(1, size - 2))) lines.push(`  ${line}`);
   }
 
-  const labelWidth = Math.min(12, Math.max(4, ...plan.rows.map((row) => visibleWidth(planText(row.label)))));
+  const labelWidth = Math.min(12, Math.max(1, ...plan.rows.map((row) => visibleWidth(planText(row.label)))));
   const statusWidth = Math.min(24, Math.max(0, ...plan.rows.map((row) =>
     visibleWidth(planText(row.statusLabel ?? statusStyle(row.status).label)))));
   const indices = full || expanded ? plan.rows.map((_, index) => index) : compactRowIndices(plan.rows);
@@ -99,7 +102,7 @@ export function renderPlanPresentation(
     const label = truncateToWidth(planText(row.label), labelWidth);
     const prefix = (index === selectedIndex ? theme.fg("accent", "› ") : "  ") +
       theme.fg(style.color, style.glyph) + " " + theme.fg("dim", label) +
-      " ".repeat(Math.max(0, labelWidth - visibleWidth(label)) + 2);
+      " ".repeat(Math.max(0, labelWidth - visibleWidth(label)) + 1);
     const titleColor = row.status === "blocked" ? "warning" : row.status === "failed" ? "error" :
       row.status === "in_progress" || row.status === "implemented" || row.status === "reviewed" ? "text" : "muted";
     const badge = planText(row.statusLabel ?? style.label);

package/extensions/task-context/plan-render.ts

@@ -4,6 +4,7 @@ import {
   type PlanPresentation, type PlanRenderTheme,
 } from "./plan-presentation.js";
 import type { PlanSnapshot } from "./types.js";
+import type { CompactTaskHeader } from "./compact-task-header.js";
 
 export type { PlanRenderTheme } from "./plan-presentation.js";
 
@@ -20,8 +21,8 @@ function presentPlan(plan: PlanSnapshot, showIds = false): PlanPresentation {
   };
 }
 
-export function renderCompactPlan(plan: PlanSnapshot, width: number, theme: PlanRenderTheme, expanded = false): string[] {
-  return renderPlanPresentation(presentPlan(plan), width, theme, false, -1, expanded);
+export function renderCompactPlan(plan: PlanSnapshot, width: number, theme: PlanRenderTheme, expanded = false, header?: CompactTaskHeader): string[] {
+  return renderPlanPresentation(presentPlan(plan), width, theme, false, -1, expanded, header);
 }
 
 export function renderFullPlan(plan: PlanSnapshot, width: number, theme: PlanRenderTheme, selectedIndex = -1): string[] {

package/extensions/task-context/plan-widget.ts

@@ -1,5 +1,5 @@
 import type { Component } from "@earendil-works/pi-tui";
-import { truncateToWidth } from "@earendil-works/pi-tui";
+
 
 // Structural typing keeps keyboard-only Pi versions compatible with the fullscreen mouse API.
 interface PlanMouseEvent {
@@ -14,7 +14,7 @@ interface PlanMouseEvent {
 }
 
 export function createPlanWidget(
-  render: (width: number) => string[],
+  render: (width: number, disclosure?: string) => string[],
   isFoldable: () => boolean,
   isExpanded: () => boolean,
   toggle: () => void,
@@ -22,10 +22,7 @@ export function createPlanWidget(
   let lines: string[] = [];
   return {
     render(width) {
-      lines = render(width);
-      if (lines.length && isFoldable()) {
-        lines = [truncateToWidth(`${isExpanded() ? "▾" : "▸"} ${lines[0]}`, width), ...lines.slice(1)];
-      }
+      lines = render(width, isFoldable() ? isExpanded() ? "▾" : "▸" : undefined);
       return lines.length ? ["", ...lines] : [];
     },
     handleMouse(event) {

package/extensions/task-context/preferences.ts

@@ -0,0 +1,24 @@
+export interface OutcomeTodoPreferences {
+  version: 1;
+  enabled: boolean;
+  display: boolean;
+}
+
+export function parseOutcomeTodoPreferences(value: unknown): OutcomeTodoPreferences {
+  if (value === undefined) return { version: 1, enabled: false, display: true };
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid outcomeTodo setting.");
+  const record = value as Record<string, unknown>;
+  if (record.version !== 1) throw new Error("Invalid outcomeTodo setting.");
+  for (const key of ["enabled", "display"] as const) {
+    if (record[key] !== undefined && typeof record[key] !== "boolean") throw new Error(`Invalid outcomeTodo setting: ${key} must be boolean.`);
+  }
+  return { version: 1, enabled: record.enabled === undefined ? false : record.enabled as boolean,
+    display: record.display === undefined ? true : record.display as boolean };
+}
+
+export function changeOutcomeTodoPreference(current: unknown, key: "enabled" | "display", value: boolean): OutcomeTodoPreferences {
+  const preferences = parseOutcomeTodoPreferences(current);
+  if (key !== "enabled" && key !== "display") throw new Error("Invalid outcomeTodo preference.");
+  if (typeof value !== "boolean") throw new Error("Invalid outcomeTodo preference value.");
+  return { ...preferences, [key]: value };
+}

package/extensions/task-context/workflow-plan.ts

@@ -1,6 +1,7 @@
 import { readFileSync, realpathSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import type { Component } from "@earendil-works/pi-tui";
+import type { CompactTaskHeader } from "./compact-task-header.js";
 import {
   createPlanPresentationComponent, plainPlanTheme, planText, renderPlanPresentation, statusStyle,
   type DisplayStatus, type PlanPresentation,
@@ -191,9 +192,10 @@ export function renderRushPlan(
   owner = "rush-issues",
   readOnly = false,
   expanded = false,
+  header?: CompactTaskHeader,
 ): string[] {
   const theme = fg ? { fg } : plainPlanTheme;
-  return renderPlanPresentation(presentRushPlan(plan, owner, readOnly), width, theme, full, -1, expanded);
+  return renderPlanPresentation(presentRushPlan(plan, owner, readOnly), width, theme, full, -1, expanded, header);
 }
 
 export function createRushPlanComponent(

package/node_modules/pi-better-background-tasks/package.json

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

package/node_modules/pi-better-background-tasks/src/shared-navigator.ts

@@ -328,28 +328,92 @@ function themeFgFromTheme(theme: unknown): (color: string, value: string) => str
   return (color, value) => maybeTheme?.fg ? maybeTheme.fg(color, value) : value;
 }
 
-function createMainListWidget(tui: { requestRender?(): void }, theme: unknown, deps: HostDeps): Component & { dispose?(): void } {
+// Structural typing keeps keyboard-only Pi hosts (no mouse API) loading this widget unchanged.
+type WidgetMouseEvent = {
+  type: string;
+  button: string;
+  /** Coordinates local to this component, zero-based. */
+  x: number;
+  y: number;
+  width: number;
+  shift?: boolean;
+  alt?: boolean;
+  ctrl?: boolean;
+};
+
+type WidgetMouseResult = { handled: true; render: boolean };
+
+type MainListWidget = Component & {
+  dispose?(): void;
+  handleMouse(event: WidgetMouseEvent): WidgetMouseResult | undefined;
+};
+
+function createMainListWidget(tui: { requestRender?(): void }, theme: unknown, deps: HostDeps): MainListWidget {
   const requestRender = () => tui.requestRender?.();
   state().mainListRequestRender = requestRender;
+  // navigatorId per rendered line, so a pointer row resolves by structure, never by row text.
+  let lineOwners: Array<string | undefined> = [];
+  let lineWidth = MAIN_LIST_FALLBACK_WIDTH;
+  // Pi synthesizes a click only for the component that handled the initial press.
+  let pressedRow: { navigatorId: string; y: number } | undefined;
+  const rowAt = (event: WidgetMouseEvent): string | undefined => {
+    const width = Number.isFinite(event.width) && event.width > 0 ? Math.floor(event.width) : lineWidth;
+    if (!Number.isFinite(event.x) || event.x < 0 || event.x >= width) return undefined;
+    if (!Number.isInteger(event.y) || event.y < 0 || event.y >= lineOwners.length) return undefined;
+    return lineOwners[event.y];
+  };
   return {
     render(width: number): string[] {
       const rows = listRows();
       syncMainListSelection(rows);
       if (!rows.length) {
         state().lastMainListLines = undefined;
+        lineOwners = [];
+        pressedRow = undefined;
         return [];
       }
-      const lines = ["", ...buildMainListLines(rows, renderWidth(width), deps.truncate, themeFgFromTheme(theme), {
+      const layout = buildMainListLayout(rows, renderWidth(width), deps.truncate, themeFgFromTheme(theme), {
         selectedId: state().mainListFocused ? state().mainListSelectedId : undefined,
         focused: state().mainListFocused === true,
-      })];
+      });
+      lineWidth = renderWidth(width);
+      // The leading gap line belongs to the widget too, so its slot stays ownerless.
+      lineOwners = [undefined, ...layout.owners];
+      const lines = ["", ...layout.lines];
       state().lastMainListLines = lines;
       return lines;
     },
-    invalidate() { state().lastMainListLines = undefined; },
+    handleMouse(event: WidgetMouseEvent): WidgetMouseResult | undefined {
+      // Only an unmodified left press is ours; every other gesture reaches the host untouched.
+      if (event.button !== "left" || event.shift === true || event.alt === true || event.ctrl === true) {
+        pressedRow = undefined;
+        return undefined;
+      }
+      if (event.type === "press") {
+        pressedRow = undefined;
+        const navigatorId = rowAt(event);
+        if (!navigatorId || !listRows().some((row) => row.navigatorId === navigatorId)) return undefined;
+        pressedRow = { navigatorId, y: event.y };
+        return { handled: true, render: false };
+      }
+      if (event.type !== "click") return undefined;
+      const pressed = pressedRow;
+      pressedRow = undefined;
+      // A click after another component's press, or after the layout moved, is not the row we claimed.
+      if (!pressed || pressed.y !== event.y || rowAt(event) !== pressed.navigatorId) return undefined;
+      if (!openNavigatorRow(pressed.navigatorId)) return undefined;
+      return { handled: true, render: true };
+    },
+    invalidate() {
+      state().lastMainListLines = undefined;
+      lineOwners = [];
+      pressedRow = undefined;
+    },
     dispose() {
       const s = state();
       if (s.mainListRequestRender === requestRender) s.mainListRequestRender = undefined;
+      lineOwners = [];
+      pressedRow = undefined;
     },
   };
 }
@@ -454,7 +518,26 @@ function buildMainListLines(
   fg: (color: string, value: string) => string,
   options: { selectedId?: string; focused?: boolean } = {},
 ): string[] {
+  return buildMainListLayout(rows, width, truncate, fg, options).lines;
+}
+
+/**
+ * The list's lines plus the navigatorId each line shows, so pointer input maps a rendered row to its
+ * stable row identity. Headers, separators and the shortcut line keep an undefined owner.
+ */
+function buildMainListLayout(
+  rows: InternalRow[],
+  width: number,
+  truncate: (s: string, width: number) => string,
+  fg: (color: string, value: string) => string,
+  options: { selectedId?: string; focused?: boolean } = {},
+): { lines: string[]; owners: Array<string | undefined> } {
   const lines: string[] = [];
+  const owners: Array<string | undefined> = [];
+  const push = (line: string, owner?: string) => {
+    lines.push(line);
+    owners.push(owner);
+  };
   const grouped = new Map<string, InternalRow[]>();
   for (const row of rows) {
     const existing = grouped.get(row.providerLabel) ?? [];
@@ -466,16 +549,16 @@ function buildMainListLines(
   for (let i = 0; i < orderedLabels.length; i += 1) {
     const label = orderedLabels[i]!;
     const group = grouped.get(label)!;
-    if (i > 0) lines.push("");
-    lines.push(providerGroupLabel(label, fg));
+    if (i > 0) push("");
+    push(providerGroupLabel(label, fg));
     for (const row of group) {
       const selected = options.focused && row.navigatorId === options.selectedId;
-      lines.push(formatMainListRow(row, selected === true, fg, width));
+      push(formatMainListRow(row, selected === true, fg, width), row.navigatorId);
     }
   }
-  lines.push("");
-  lines.push(shortcutsLine(options.focused === true, fg));
-  return lines.map((line) => safeTruncate(line, width, truncate));
+  push("");
+  push(shortcutsLine(options.focused === true, fg));
+  return { lines: lines.map((line) => safeTruncate(line, width, truncate)), owners };
 }
 
 function shortcutsLine(focused: boolean, fg: (color: string, value: string) => string): string {
@@ -766,6 +849,20 @@ function handleMainListCloseKey(): void {
   refreshMainListWidget();
 }
 
+/**
+ * Open the shared detail overlay on the row a pointer chose. Setting the selection first keeps the
+ * keyboard path identical: Enter, x and the overlay's own keys then act on the clicked row.
+ */
+function openNavigatorRow(navigatorId: string): boolean {
+  const rows = listRows();
+  if (!rows.some((row) => row.navigatorId === navigatorId)) return false;
+  clearMainListCloseArm();
+  state().mainListSelectedId = navigatorId;
+  refreshMainListWidget();
+  openNavigator();
+  return true;
+}
+
 function openNavigator(): void {
   const s = state();
   const ctx = s.uiCtx;

package/node_modules/pi-better-goal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-goal",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "Pi extension for goal tracking with background-aware continuation.",
   "license": "MIT",
   "type": "module",

package/node_modules/pi-better-goal/src/index.ts

@@ -882,10 +882,15 @@ export default function (pi: ExtensionAPI): void {
             }
             const nextRenderDelay = goalClockRefreshDelayMs(goal);
             if (nextRenderDelay !== null) scheduler.schedule(nextRenderDelay);
+            // Schedule before handing visual ownership to Harness so its header
+            // keeps ticking. An absent display response preserves standalone Goal.
+            if (requestTaskContext(pi, "inspect", goal, width).display === true) {
+              return [];
+            }
             const fg = typeof theme?.fg === "function"
               ? (color: string, value: string) => theme.fg(color as never, value)
               : undefined;
-            return [renderGoalClockLine(goal, width, undefined, fg), ""];
+            return [renderGoalClockLine(goal, width, undefined, fg)];
           },
         };
       },

package/node_modules/pi-better-goal/src/task-context.ts

@@ -14,9 +14,19 @@ export type TaskContextAction = "inspect" | "start" | "pause" | "resume" | "comp
 export interface TaskContextRequest {
   action: TaskContextAction;
   goalId?: string;
+  /** Current widget width on a visual ownership inspection. */
+  width?: number;
   /** The raw original goal trigger; only start requests carry it. */
   objective?: string;
+  /** Hooks authority: a present Harness runtime sets this even when Outcome & Todo is off. */
   enabled?: boolean;
+  /**
+   * Visual ownership. A Harness runtime sets this on `inspect` responses when
+   * its combined Todo header is rendering the requested `goalId`. It is
+   * independent of `enabled` and stays undefined without Harness, so Goal keeps
+   * its standalone clock widget whenever that header does not own the goal.
+   */
+  display?: boolean;
 }
 
 /**
@@ -27,8 +37,10 @@ export function requestTaskContext(
   pi: Pick<ExtensionAPI, "events">,
   action: TaskContextAction,
   goal?: GoalSnapshot | null,
+  width?: number,
 ): TaskContextRequest {
   const request: TaskContextRequest = { action };
+  if (width !== undefined) request.width = width;
   if (goal) {
     request.goalId = goal.goalId;
     if (action === "start") request.objective = goal.objective;

package/node_modules/pi-better-subagents/README.md

@@ -19,6 +19,12 @@ Use `pi-better-subagents` when you want Pi to launch independent agent work with
 - Live background-work navigator for active runs.
 - Harness-owned run timing: every run gets a no-progress wake (10 min), while wall-clock soft deadlines and hard ceilings are opt-in so productive agents are not stopped solely for taking a long time. Configure per spawn with `deadline_minutes`, `grace_minutes`, `max_minutes`, `stuck_minutes`, or globally in `config.json` / `PI_SUBAGENT_*_MINUTES`. See [usage notes](docs/usage.md#run-timing-deadline-ceiling-stuck).
 
+Every single or batch launch automatically joins one shared supervision watcher in the
+foreground Pi process. The last active run's exit or stop tears it down; a later
+launch starts it again. No separate background task or coordinator heartbeat is
+needed. Completion delivery retries use the callback batcher's own timer. Lost-run
+alerts retain supervision until their handoff is handled, so lost work is not silent.
+
 ## Install
 
 ```sh

package/node_modules/pi-better-subagents/catalog-ui.ts

@@ -1,5 +1,5 @@
-import { Input, SelectList, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import type { OperationField, OperationList, OperationView } from "./agent-inspection.ts";
+import { Input, SelectList, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { OperationList, OperationView } from "./agent-inspection.ts";
 import { EFFORT_LEVELS } from "./catalog-schema.ts";
 import type { AgentSessionOverrides, AgentSettingKey } from "./agent-session-settings.ts";
 
@@ -19,9 +19,6 @@ function stateLabel(entry: OperationView): string {
     return "unresolved";
 }
 
-function fieldLine(label: string, field: OperationField): string {
-    return `${label.padEnd(8)} ${field.value ?? "(unset)"}  ${field.source === "role-default" ? "inherited" : field.source === "agent-override" ? "override" : "absent"}`;
-}
 
 function modelLabel(entry: OperationView): string {
     return entry.actualModel ?? entry.requestedModel ?? entry.fields?.model.value ?? "not resolved";
@@ -49,6 +46,7 @@ export function catalogColumns(entry: OperationView | null, width: number): stri
 }
 
 function wrapLine(text: string, width: number): string[] {
+    if (text.includes("\x1b")) return wrapTextWithAnsi(text, width);
     const rows: string[] = [];
     let row = "";
     for (const { segment } of new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text)) {
@@ -62,31 +60,67 @@ function wrapLine(text: string, width: number): string[] {
     return rows;
 }
 
-export function catalogDetailLines(entry: OperationView, editable = false): string[] {
+function settingLines(label: string, value: string, origin: string, width: number, marker = "  ", theme?: Theme): string[] {
+    const title = (text: string) => theme?.fg(marker === "> " ? "accent" : "muted", text) ?? text;
+    const source = (text: string) => theme?.fg("dim", text) ?? text;
+    if (width < 54) return [title(`${marker}${label}`), ...wrapLine(`${value}  ${source(origin)}`, Math.max(1, width - 4)).map((row) => `    ${row}`)];
+    const valueWidth = Math.max(1, width - 34);
+    return wrapLine(value, valueWidth).map((row, index) =>
+        `${index === 0 ? title(marker + label.padEnd(10)) : " ".repeat(12)}${cell(row, valueWidth)}  ${index === 0 ? source(origin) : ""}`.trimEnd());
+}
+
+export function catalogDetailLines(entry: OperationView, editable = false, width = 80, controls: string[] = [], theme?: Theme): string[] {
+    const label = (text: string) => theme?.fg("muted", text) ?? text;
+    const heading = (text: string) => label(theme?.bold?.(text) ?? text);
+    const contentWidth = Math.max(1, width - 4);
+    const columnWidth = width >= 90 ? Math.floor((contentWidth - 4) / 2) : contentWidth;
+    const fact = (title: string, value: string) => wrapLine(value, Math.max(1, columnWidth - 13))
+        .map((text, index) => `${index === 0 ? label(title.padEnd(13)) : " ".repeat(13)}${text}`);
+    const identity = [
+        ...fact("ID", entry.id),
+        ...fact("Kind", entry.identity.kind ?? "unknown"),
+        ...(entry.role ? fact("Base role", `${entry.role.id ?? "(missing)"}${entry.role.found ? "" : " (missing)"}`) : []),
+    ];
+    const state = [
+        ...fact("Status", stateLabel(entry)),
+        ...fact("Scope", entry.identity.scope ?? "unknown"),
+        ...(entry.instructionMode ? fact("Instructions", entry.instructionMode) : []),
+    ];
+    const overview = width >= 90
+        ? Array.from({ length: Math.max(identity.length, state.length) }, (_, i) =>
+            `${cell(identity[i] ?? "", columnWidth)}    ${state[i] ?? ""}`.trimEnd())
+        : [...identity, ...state];
     const lines = [
-        `${entry.identity.name || entry.id}  ·  ${entry.identity.kind ?? "unknown"}`,
-        entry.id,
+        theme?.fg("accent", `${entry.identity.name || entry.id}  ·  ${entry.identity.kind ?? "unknown"}`) ?? `${entry.identity.name || entry.id}  ·  ${entry.identity.kind ?? "unknown"}`,
+        ...(entry.identity.description ? wrapLine(entry.identity.description, contentWidth) : []),
         "",
-        `Status    ${stateLabel(entry)}  ·  ${entry.launchabilityReason}`,
-        `Source    ${entry.identity.scope ?? "unknown"}  ·  ${entry.identity.path ?? "(none)"}`,
-        ...(entry.identity.description ? [`About     ${entry.identity.description}`] : []),
-        ...(entry.role ? [`Base role ${entry.role.id ?? "(missing)"}${entry.role.found ? "" : "  ·  missing"}`] : []),
-        ...(entry.instructionMode ? [`Instructions ${entry.instructionMode}`] : []),
+        ...overview,
         "",
-        "Configuration",
+        heading("Configuration"),
+        ...(contentWidth >= 54 ? [label(settingLines("SETTING", "VALUE", "ORIGIN", contentWidth)[0])] : []),
+        ...controls,
         ...(entry.fields ? [
-            ...(!editable ? [fieldLine("Model", entry.fields.model), fieldLine("Effort", entry.fields.effort)] : []),
-            fieldLine("Tier", entry.fields.tier),
+            ...(!editable ? ["model", "effort"].flatMap((key) => {
+                const field = entry.fields![key as "model" | "effort"];
+                return settingLines(key === "model" ? "Model" : "Effort", field.value ?? "(unset)", field.inherited || field.source === "role-default" ? "inherited" : field.source === "agent-override" ? "override" : "absent", contentWidth, "  ", theme);
+            }) : []),
+            ...settingLines("Tier", entry.fields.tier.value ?? "(unset)", entry.fields.tier.source === "role-default" ? "inherited" : entry.fields.tier.source === "agent-override" ? "override" : "absent", contentWidth, "  ", theme),
         ] : []),
-        `Actual   ${entry.actualModel ?? "not resolved"}${entry.actualEffort ? `  ·  ${entry.actualEffort}` : ""}`,
-        ...(entry.validation.length ? ["", "Diagnostics", ...entry.validation.map((item) => `${item.blocking ? "!" : "·"} ${item.message}`)] : []),
-        ...(entry.shadowed.length ? ["", "Shadowed sources", ...entry.shadowed.map((source) => `${source.scope}  ${source.path}`)] : []),
-        ...(entry.restrictions.length ? ["", "Execution restrictions", ...entry.restrictions.map((item) => `${item.honored ? "honored" : "not honored"}  ${item.name}`)] : []),
+        `${label("Actual")}   ${entry.actualModel ?? "not resolved"}${entry.actualEffort ? `  ·  ${entry.actualEffort}` : ""}`,
+        "",
+        heading("Effective prompt"),
+        ...(entry.instructions?.trim() ? entry.instructions.split(/\r\n|\r|\n/) : ["(No resolved instructions)"]),
         "",
-        "Effective prompt",
-        "Press p to read the complete resolved instructions.",
+        heading("Launch resolution"),
+        entry.launchabilityReason,
+        "",
+        heading("Definition source"),
+        entry.identity.path ?? "(none)",
+        ...(entry.validation.length ? ["", heading("Diagnostics"), ...entry.validation.map((item) => `${item.blocking ? "!" : "·"} ${item.message}`)] : []),
+        ...(entry.shadowed.length ? ["", heading("Shadowed sources"), ...entry.shadowed.map((source) => `${source.scope}  ${source.path}`)] : []),
+        ...(entry.restrictions.length ? ["", heading("Execution restrictions"), ...entry.restrictions.map((item) => `${item.honored ? "honored" : "not honored"}  ${item.name}`)] : []),
     ];
-    return lines;
+    return lines.flatMap((text) => text ? wrapLine(text, contentWidth).map((row) => `  ${row}`) : [""]);
 }
 
 export function createCatalogComponent(
@@ -103,6 +137,8 @@ export function createCatalogComponent(
     let query = "";
     let scroll = 0;
     let settingRow = 0;
+    let settingPositions: number[] = [];
+    let revealSetting = false;
     let picker: SelectList | undefined;
     let filterPicker: ((filter: string) => void) | undefined;
     let pickerKey: AgentSettingKey | undefined;
@@ -159,11 +195,11 @@ export function createCatalogComponent(
         [entry.id, entry.identity.name, entry.identity.description, entry.role?.id]
             .some((value) => value?.toLowerCase().includes(query.toLowerCase())));
     const selected = () => filtered().find((entry) => entry.id === selectedId);
-    const detailRows = (entry: OperationView, width: number) => (mode === "prompt"
+    const detailRows = (entry: OperationView, width: number, controls: string[] = []) => (mode === "prompt"
         ? [`${entry.identity.name || entry.id}  ·  effective instructions`, "", ...(entry.instructions?.split("\n") ?? ["(none)"])]
-        : catalogDetailLines(entry, !!editor))
+        : catalogDetailLines(entry, !!editor, width, controls, theme))
         .flatMap((text) => text ? wrapLine(text, Math.max(1, width - 2)) : [""]);
-    let lastDetailWidth = 80;
+
 
     return {
         get focused() { return focused; },
@@ -174,21 +210,20 @@ export function createCatalogComponent(
             const footerRows = (editor && mode !== "prompt" ? 2 : 0) + (message ? 2 : 0);
             const diagnosticRows = Math.min(catalog.diagnostics.length, 3);
             const listSize = Math.max(1, height - 5 - footerRows - diagnosticRows - 1);
-            const controlRows = editor && mode === "detail" ? (safeWidth < 42 ? 5 : 3) : 0;
-            const detailSize = Math.max(1, height - 5 - footerRows - controlRows);
+            const detailSize = Math.max(1, height - 5 - footerRows);
             const fit = (lines: string[]) => {
                 const result = lines.slice(0, height).map(line);
                 while (result.length < height) result.push("");
                 return result;
             };
-            lastDetailWidth = safeWidth;
+
             const line = (text: string) => truncateToWidth(text, safeWidth);
             const rows = filtered();
             const current = selected();
-            const detailLines = current ? detailRows(current, safeWidth) : [];
+
             const selectedIndex = rows.findIndex((entry) => entry.id === selectedId);
             const start = Math.max(0, Math.min(selectedIndex - Math.floor(listSize / 2), rows.length - listSize));
-            scroll = Math.max(0, Math.min(scroll, detailLines.length - detailSize));
+
             if (picker) return fit([
                 theme.fg("accent", `Agents / ${pickerKey}`), "",
                 ...(pickerKey === "model" ? search.render(safeWidth) : []),
@@ -203,23 +238,29 @@ export function createCatalogComponent(
                     const ownSession = Object.hasOwn(own ?? {}, key);
                     const roleSession = field?.inherited && Object.hasOwn(editor?.settings()[current.role?.id ?? ""] ?? {}, key);
                     const origin = ownSession && own?.[key] === null ? "inherit / session" : ownSession ? "session" : roleSession ? "inherited / session" : field?.inherited ? "inherited" : "catalog";
-                    const value = `${field?.value ?? "(unset)"}  ${origin}`;
-                    const text = `${settingRow === index ? "> " : "  "}${label.padEnd(18)} ${value}`;
-                    if (safeWidth < 42) {
-                        const title = `${settingRow === index ? "> " : "  "}${label}`;
-                        return [settingRow === index ? highlight(title, safeWidth) : title, `  ${truncateToWidth(value, Math.max(1, safeWidth - 2))}`];
-                    }
-                    return [settingRow === index ? highlight(text, safeWidth) : text];
+                    return settingLines(label, field?.value ?? "(unset)", origin, Math.max(1, safeWidth - 4), settingRow === index ? "> " : "  ", theme);
                 }),
-                "",
             ] : [];
+            const detailLines = current ? detailRows(current, safeWidth, controls) : [];
+            if (editor && mode === "detail") {
+                settingPositions = ["Model", "Effort"].map((label) => detailLines.findIndex((text) =>
+                    new RegExp(`^  [> ] ${label}(?:\\s|$)`).test(text.replace(/\x1b\[[0-9;]*m/g, ""))));
+                if (revealSetting && settingPositions[settingRow] >= 0) {
+                    const position = settingPositions[settingRow];
+                    if (position < scroll) scroll = position;
+                    else if (position >= scroll + detailSize) scroll = position - detailSize + 1;
+                }
+                revealSetting = false;
+            }
+            scroll = Math.max(0, Math.min(scroll, detailLines.length - detailSize));
             const lines = mode !== "list" && current ? [
                 theme.fg("accent", mode === "prompt" ? "Agents / prompt" : editor ? `Agents / ${current.identity.name || current.id}` : "Agents / inspect"),
                 theme.fg("dim", mode === "prompt" ? "← details  ·  ↑↓ scroll  ·  Esc back" : `${editor ? "Enter change  ·  " : ""}p prompt  ·  ← list  ·  ↑↓ ${editor ? "select / scroll" : "scroll"}  ·  Esc back`),
                 "",
-                ...controls,
+
                 ...detailLines.slice(scroll, scroll + detailSize).map((text, i) =>
-                    i === 0 && scroll === 0 ? theme.fg("accent", text) : text),
+                    i === 0 && scroll === 0 ? theme.fg("accent", text)
+                        : text),
                 "",
                 theme.fg("dim", `Showing ${scroll + 1}-${Math.min(scroll + detailSize, detailLines.length)} of ${detailLines.length} lines`),
             ] : [
@@ -261,8 +302,12 @@ export function createCatalogComponent(
                 else { close(); return; }
             } else if (matchesKey(data, "up") || matchesKey(data, "down")) {
                 const delta = matchesKey(data, "down") ? 1 : -1;
-                if (mode === "detail" && editor && scroll === 0 && (delta < 0 || settingRow === 0)) settingRow = Math.max(0, Math.min(1, settingRow + delta));
-                else if (mode !== "list" && selected()) scroll = Math.max(0, Math.min(detailRows(selected()!, lastDetailWidth).length - 1, scroll + delta));
+                if (mode === "detail" && editor && scroll <= (settingPositions[1] ?? 0)
+                    && ((delta > 0 && settingRow === 0) || (delta < 0 && settingRow === 1))) {
+                    settingRow += delta;
+                    revealSetting = true;
+                }
+                else if (mode !== "list" && selected()) scroll = Math.max(0, scroll + delta);
                 else if (rows.length) selectedId = rows[Math.max(0, Math.min(rows.length - 1, rows.findIndex((entry) => entry.id === selectedId) + delta))]?.id;
             } else if (matchesKey(data, "enter") && mode === "list" && selected()) {
                 mode = "detail";
@@ -274,6 +319,7 @@ export function createCatalogComponent(
             } else if (editor && (data === "e" || data === "E") && mode === "detail" && selected()) {
                 settingRow = 0;
                 scroll = 0;
+                revealSetting = true;
             } else if (editor && mode === "detail" && (matchesKey(data, "enter") || data === " ")) {
                 try { edit(); } catch (cause) { report(cause instanceof Error ? cause.message : String(cause), true); }
             } else if (mode === "list" && matchesKey(data, "backspace")) {

package/node_modules/pi-better-subagents/index.ts

@@ -879,7 +879,7 @@ function reconcileHealth(): void {
         if (meta && meta.completionCallbackPendingAt !== undefined && meta.completionCallbackSentAt === undefined && meta.completionCallbackSuppressedAt === undefined) enqueueCompletionCallback(pi!, meta.id);
     }
     pruneProgressCache();
-    if (!needsMonitoring(listMetasForParent(process.pid)) && !hasPendingFailureCallbacks()) stopHealthTicker();
+    syncHealthTicker();
 }
 
 /** Release progress state for runs that are no longer live (lost, stopped, or finished by any path). */
@@ -948,10 +948,10 @@ function reconcileAbandonedRuns(now: number = Date.now()): number {
     return adopted;
 }
 
-function hasPendingFailureCallbacks(): boolean {
-    return listMetasForParent(process.pid).some((m) => ownedByThisParent(m) && m.callback !== false &&
-        m.completionCallbackPendingAt !== undefined && m.completionCallbackSentAt === undefined && m.completionCallbackSuppressedAt === undefined &&
-        !callbackSuppressionReason(m));
+/** Completion batches own their retry timer; only supervision keeps this one alive. */
+function syncHealthTicker(): void {
+    if (needsMonitoring(listMetasForParent(process.pid))) ensureHealthTicker();
+    else stopHealthTicker();
 }
 
 /** Start the reconciliation loop if it isn't already running. */
@@ -1099,6 +1099,7 @@ function navigatorCloseRun(id: string) {
     healthLogCache.delete(id);
     resetChildEventLogCursor(id);
     resetParseRunCursor(id);
+    syncHealthTicker();
     return outcome;
 }
 
@@ -1451,14 +1452,14 @@ function finalizeRun(pi: ExtensionAPI, ctx: ExtensionContext, id: string, code:
     // Host-facing wrapper around first-party finalizer (finalization.ts).
     // Coherent child-exit evidence may supersede provisional orphaned/lost
     // reconciliation; finalization.ts enforces canExitFinalize + lifecycle authority.
-    const result = finalizeRunCore(id, code, {
+    finalizeRunCore(id, code, {
         renderWidget,
         notify: (message, level) => {
             try { ctx.ui.notify(message, level); } catch { /* ignore */ }
         },
         sendMessage: () => enqueueCompletionCallback(pi, id),
     });
-    if (result.applied && hasPendingFailureCallbacks()) ensureHealthTicker();
+    syncHealthTicker();
 }
 
 function timingSchemaFields() {
@@ -1938,7 +1939,7 @@ export default function (pi: ExtensionAPI) {
             "The tools param is both the tool allowlist AND what determines which extensions load in the child (e.g. tools='read,bash,web_fetch' loads only the web-tools package). Ask for the tools the task needs and nothing more; clean:true gives a built-ins-only child. Without an agent or role, pick a model with the model param (e.g. 'xai/grok-4.5@high'); providerless model patterns are resolved by Pi, while provider/model is deterministic and loads mapped provider extensions.",
             ...CATALOG_GUIDELINES,
             "Subagent sandboxing defaults to off. Human settings in /sandbox control file, credential-file, command, and network permissions; sandbox:false cannot override an enabled human profile. Set sandbox:true to request kernel confinement, including without published settings. Set callback:false to finish quietly — then read the result on demand via subagent_result.",
-            "Every run has harness-owned stall detection: no progress for stuck_minutes (default 10) wakes you once without stopping the run. Elapsed-time limits are opt-in: deadline_minutes steers the child to wrap up and later stops it after grace_minutes, while max_minutes stops it without grace. Do not set elapsed-time limits merely because a task may take a while; use them only when the work needs a real wall-clock bound.",
+            "Every launch automatically joins one shared harness-owned watcher, including batch launches; it stops when the last active run ends. Do not start a separate heartbeat or background watcher for subagents. No progress for stuck_minutes (default 10) wakes you once without stopping the run. Elapsed-time limits are opt-in: deadline_minutes steers the child to wrap up and later stops it after grace_minutes, while max_minutes stops it without grace. Do not set elapsed-time limits merely because a task may take a while; use them only when the work needs a real wall-clock bound.",
             "Use git_clone_workspace:true when the subagent will mutate Git in a sandbox. The parent prepares a disposable, self-contained clone with a real .git/ directory inside the sandbox root, so linked-worktree metadata outside the sandbox cannot stall the child.",
         ],
         parameters: Type.Object({
@@ -2263,7 +2264,10 @@ export default function (pi: ExtensionAPI) {
     const acceptanceResultTool = subagentResultTool(Type, toolSession);
     pi.registerTool(acceptanceResultTool);
     publishAcceptanceHooks(acceptanceResultTool);
-    const acceptanceStopTool = subagentStopTool(Type, { onStopped: renderWidget });
+    const acceptanceStopTool = subagentStopTool(Type, { onStopped: () => {
+        renderWidget();
+        syncHealthTicker();
+    } });
     acceptanceStopToolRef = acceptanceStopTool;
     pi.registerTool(acceptanceStopTool);
     publishAcceptanceHooks();
@@ -2475,10 +2479,8 @@ export default function (pi: ExtensionAPI) {
         // Clear the retired legacy widget so the shared navigator is the only
         // list surface for running/orphaned subagents.
         renderWidget();
-        // Resume supervision reconciliation + durable health-callback recovery
-        // across /reload while current-parent work still needs the ticker
-        // (running/orphaned, or unmarked lost); it stops itself when idle.
-        if (needsMonitoring(listMetasForParent(process.pid)) || hasPendingFailureCallbacks()) ensureHealthTicker();
+        // Reattach one watcher after reload; ordinary completion retries belong to the batcher.
+        syncHealthTicker();
     });
 
     pi.on("session_before_switch", () => {

package/node_modules/pi-better-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-subagents",
-  "version": "0.21.1",
+  "version": "0.22.1",
   "description": "Pi extension for detached, sandboxed subagent runs that keep the foreground session free.",
   "license": "MIT",
   "type": "module",

package/node_modules/pi-better-subagents/shared-navigator.ts

@@ -328,28 +328,92 @@ function themeFgFromTheme(theme: unknown): (color: string, value: string) => str
   return (color, value) => maybeTheme?.fg ? maybeTheme.fg(color, value) : value;
 }
 
-function createMainListWidget(tui: { requestRender?(): void }, theme: unknown, deps: HostDeps): Component & { dispose?(): void } {
+// Structural typing keeps keyboard-only Pi hosts (no mouse API) loading this widget unchanged.
+type WidgetMouseEvent = {
+  type: string;
+  button: string;
+  /** Coordinates local to this component, zero-based. */
+  x: number;
+  y: number;
+  width: number;
+  shift?: boolean;
+  alt?: boolean;
+  ctrl?: boolean;
+};
+
+type WidgetMouseResult = { handled: true; render: boolean };
+
+type MainListWidget = Component & {
+  dispose?(): void;
+  handleMouse(event: WidgetMouseEvent): WidgetMouseResult | undefined;
+};
+
+function createMainListWidget(tui: { requestRender?(): void }, theme: unknown, deps: HostDeps): MainListWidget {
   const requestRender = () => tui.requestRender?.();
   state().mainListRequestRender = requestRender;
+  // navigatorId per rendered line, so a pointer row resolves by structure, never by row text.
+  let lineOwners: Array<string | undefined> = [];
+  let lineWidth = MAIN_LIST_FALLBACK_WIDTH;
+  // Pi synthesizes a click only for the component that handled the initial press.
+  let pressedRow: { navigatorId: string; y: number } | undefined;
+  const rowAt = (event: WidgetMouseEvent): string | undefined => {
+    const width = Number.isFinite(event.width) && event.width > 0 ? Math.floor(event.width) : lineWidth;
+    if (!Number.isFinite(event.x) || event.x < 0 || event.x >= width) return undefined;
+    if (!Number.isInteger(event.y) || event.y < 0 || event.y >= lineOwners.length) return undefined;
+    return lineOwners[event.y];
+  };
   return {
     render(width: number): string[] {
       const rows = listRows();
       syncMainListSelection(rows);
       if (!rows.length) {
         state().lastMainListLines = undefined;
+        lineOwners = [];
+        pressedRow = undefined;
         return [];
       }
-      const lines = ["", ...buildMainListLines(rows, renderWidth(width), deps.truncate, themeFgFromTheme(theme), {
+      const layout = buildMainListLayout(rows, renderWidth(width), deps.truncate, themeFgFromTheme(theme), {
         selectedId: state().mainListFocused ? state().mainListSelectedId : undefined,
         focused: state().mainListFocused === true,
-      })];
+      });
+      lineWidth = renderWidth(width);
+      // The leading gap line belongs to the widget too, so its slot stays ownerless.
+      lineOwners = [undefined, ...layout.owners];
+      const lines = ["", ...layout.lines];
       state().lastMainListLines = lines;
       return lines;
     },
-    invalidate() { state().lastMainListLines = undefined; },
+    handleMouse(event: WidgetMouseEvent): WidgetMouseResult | undefined {
+      // Only an unmodified left press is ours; every other gesture reaches the host untouched.
+      if (event.button !== "left" || event.shift === true || event.alt === true || event.ctrl === true) {
+        pressedRow = undefined;
+        return undefined;
+      }
+      if (event.type === "press") {
+        pressedRow = undefined;
+        const navigatorId = rowAt(event);
+        if (!navigatorId || !listRows().some((row) => row.navigatorId === navigatorId)) return undefined;
+        pressedRow = { navigatorId, y: event.y };
+        return { handled: true, render: false };
+      }
+      if (event.type !== "click") return undefined;
+      const pressed = pressedRow;
+      pressedRow = undefined;
+      // A click after another component's press, or after the layout moved, is not the row we claimed.
+      if (!pressed || pressed.y !== event.y || rowAt(event) !== pressed.navigatorId) return undefined;
+      if (!openNavigatorRow(pressed.navigatorId)) return undefined;
+      return { handled: true, render: true };
+    },
+    invalidate() {
+      state().lastMainListLines = undefined;
+      lineOwners = [];
+      pressedRow = undefined;
+    },
     dispose() {
       const s = state();
       if (s.mainListRequestRender === requestRender) s.mainListRequestRender = undefined;
+      lineOwners = [];
+      pressedRow = undefined;
     },
   };
 }
@@ -454,7 +518,26 @@ function buildMainListLines(
   fg: (color: string, value: string) => string,
   options: { selectedId?: string; focused?: boolean } = {},
 ): string[] {
+  return buildMainListLayout(rows, width, truncate, fg, options).lines;
+}
+
+/**
+ * The list's lines plus the navigatorId each line shows, so pointer input maps a rendered row to its
+ * stable row identity. Headers, separators and the shortcut line keep an undefined owner.
+ */
+function buildMainListLayout(
+  rows: InternalRow[],
+  width: number,
+  truncate: (s: string, width: number) => string,
+  fg: (color: string, value: string) => string,
+  options: { selectedId?: string; focused?: boolean } = {},
+): { lines: string[]; owners: Array<string | undefined> } {
   const lines: string[] = [];
+  const owners: Array<string | undefined> = [];
+  const push = (line: string, owner?: string) => {
+    lines.push(line);
+    owners.push(owner);
+  };
   const grouped = new Map<string, InternalRow[]>();
   for (const row of rows) {
     const existing = grouped.get(row.providerLabel) ?? [];
@@ -466,16 +549,16 @@ function buildMainListLines(
   for (let i = 0; i < orderedLabels.length; i += 1) {
     const label = orderedLabels[i]!;
     const group = grouped.get(label)!;
-    if (i > 0) lines.push("");
-    lines.push(providerGroupLabel(label, fg));
+    if (i > 0) push("");
+    push(providerGroupLabel(label, fg));
     for (const row of group) {
       const selected = options.focused && row.navigatorId === options.selectedId;
-      lines.push(formatMainListRow(row, selected === true, fg, width));
+      push(formatMainListRow(row, selected === true, fg, width), row.navigatorId);
     }
   }
-  lines.push("");
-  lines.push(shortcutsLine(options.focused === true, fg));
-  return lines.map((line) => safeTruncate(line, width, truncate));
+  push("");
+  push(shortcutsLine(options.focused === true, fg));
+  return { lines: lines.map((line) => safeTruncate(line, width, truncate)), owners };
 }
 
 function shortcutsLine(focused: boolean, fg: (color: string, value: string) => string): string {
@@ -766,6 +849,20 @@ function handleMainListCloseKey(): void {
   refreshMainListWidget();
 }
 
+/**
+ * Open the shared detail overlay on the row a pointer chose. Setting the selection first keeps the
+ * keyboard path identical: Enter, x and the overlay's own keys then act on the clicked row.
+ */
+function openNavigatorRow(navigatorId: string): boolean {
+  const rows = listRows();
+  if (!rows.some((row) => row.navigatorId === navigatorId)) return false;
+  clearMainListCloseArm();
+  state().mainListSelectedId = navigatorId;
+  refreshMainListWidget();
+  openNavigator();
+  return true;
+}
+
 function openNavigator(): void {
   const s = state();
   const ctx = s.uiCtx;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-harness",
-  "version": "0.33.1",
+  "version": "0.34.1",
   "description": "Pi extension bundle for a write sandbox, subagents, background tasks, SSH, goals, and Outcome & Todo.",
   "license": "MIT",
   "type": "module",
@@ -53,11 +53,11 @@
     "test": "node --import tsx --import ../../scripts/isolate-registry.mjs --test test/*.test.mjs test/task-context/*.test.ts"
   },
   "dependencies": {
-    "pi-better-background-tasks": "0.11.0",
-    "pi-better-goal": "0.10.1",
+    "pi-better-background-tasks": "0.12.0",
+    "pi-better-goal": "0.10.3",
     "pi-better-sandbox": "0.14.0",
     "pi-better-ssh": "0.1.3",
-    "pi-better-subagents": "0.21.1",
+    "pi-better-subagents": "0.22.1",
     "proper-lockfile": "^4.1.2",
     "smol-toml": "1.9.0",
     "yaml": "^2.9.1"