pi-better-harness 0.33.0 → 0.34.0

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,7 +79,8 @@ 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}`);

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.2",
   "description": "Pi extension for goal tracking with background-aware continuation.",
   "license": "MIT",
   "type": "module",

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

@@ -882,6 +882,11 @@ 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;

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

@@ -39,10 +39,11 @@ Linux confinement requires a usable `bubblewrap` backend and Pi SDK 0.82.1 or ne
 
 The user config sets `delegationMode` to `manual`, `adaptive` (default), or
 `coordinator`. `/subagents settings` (or `/subagents`) opens a settings page
-for delegation mode and the concurrent-subagent cap (default 4). Edits apply to
+for delegation mode and the concurrent-subagent cap (default 6). Edits apply to
 this session and persist across reloads; Ctrl+S saves both as defaults, and
 Reset to defaults clears
-session overrides. `/subagents mode manual|adaptive|coordinator` and
+session overrides. Agents opens the same catalog as `/agents`.
+`/subagents mode manual|adaptive|coordinator` and
 `/subagents cap <number>` are command equivalents; `/subagents save` persists
 both. Lowering the cap blocks new single and batch launches, including launches
 still preparing, without stopping running work. Saved configuration changes are

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

@@ -72,7 +72,7 @@ export const PARSER_LIMITS = {
  * runtime already uses. Tiers are catalog policy, not benchmark rankings.
  */
 export const APPROVED_ROLE_DEFAULTS = [
-    { id: "role.researcher", name: "Researcher", model: "openai/gpt-6.1-sol", effort: "medium", tier: "balanced" },
+    { id: "role.researcher", name: "Researcher", model: "openai/gpt-6.1-terra", effort: "medium", tier: "balanced" },
     { id: "role.explorer", name: "Explorer", model: "openai/gpt-6-luna", effort: "medium", tier: "efficient" },
     { id: "role.product-manager", name: "Product Manager", model: "openai/gpt-6.1-sol", effort: "medium", tier: "balanced" },
     { id: "role.developer", name: "Developer", model: "openai/gpt-6.1-sol", effort: "high", tier: "balanced" },

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

@@ -1,7 +1,7 @@
 {
   "defaultModel": null,
   "defaultTools": "read, bash, edit, write, web_search, web_fetch",
-  "maxConcurrent": 4,
+  "maxConcurrent": 6,
   "delegationMode": "adaptive",
 
   "toolExtensions": {

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

@@ -73,7 +73,7 @@ export interface SubagentConfig extends TimingSettings {
 }
 
 /** Concurrency cap when config.json sets none. */
-export const DEFAULT_MAX_CONCURRENT = 4;
+export const DEFAULT_MAX_CONCURRENT = 6;
 
 export function isConcurrencyCap(value: unknown): value is number {
     return typeof value === "number" && Number.isSafeInteger(value) && value > 0;

package/node_modules/pi-better-subagents/docs/agent-catalog.md

@@ -100,7 +100,7 @@ Model availability, same-tier fallback, and nearest-effort adjustment are not de
 
 | Role | Stored id | Name | Model | Effort | Tier |
 | --- | --- | --- | --- | --- | --- |
-| `researcher` | `role.researcher` | Researcher | `openai/gpt-6.1-sol` | medium | balanced |
+| `researcher` | `role.researcher` | Researcher | `openai/gpt-6.1-terra` | medium | balanced |
 | `explorer` | `role.explorer` | Explorer | `openai/gpt-6-luna` | medium | efficient |
 | `product-manager` | `role.product-manager` | Product Manager | `openai/gpt-6.1-sol` | medium | balanced |
 | `developer` | `role.developer` | Developer | `openai/gpt-6.1-sol` | high | balanced |

package/node_modules/pi-better-subagents/docs/usage.md

@@ -19,7 +19,8 @@ Set `delegationMode` in the user config described under
 `coordinator` (default `adaptive`). This controls foreground delegation guidance,
 not child permissions or catalog definitions. `/subagents settings` (or simply
 `/subagents`) opens the terminal settings page with mode and concurrent-subagent
-cap controls and Reset to defaults. The page uses the same selected-row and
+cap controls, an Agents shortcut to `/agents`, and Reset to defaults.
+The page uses the same selected-row and
 active-cell styling as `/sandbox`, with one editable value column.
 Edits automatically persist for this session, including across reloads; Escape
 closes the page without undoing them.
@@ -35,7 +36,7 @@ Command equivalents also work outside the terminal UI:
 /subagents reset
 ```
 
-The cap defaults to 4 and applies to both single and batch launches. Lowering it
+The cap defaults to 6 and applies to both single and batch launches. Lowering it
 below the running count leaves existing work untouched and blocks new admissions
 until capacity becomes available. Slots already reserved by an in-flight launch
 remain admitted. Settings apply to this parent Pi process, not
@@ -481,7 +482,7 @@ The effective config also sets:
 - `delegationMode` — foreground policy (`manual`, `adaptive`, or `coordinator`;
   default `adaptive`). `/subagents mode ...` changes only the current session.
   `/subagents save` saves mode and cap together as config defaults.
-- `maxConcurrent` — positive whole-number concurrency cap (**default 4**).
+- `maxConcurrent` — positive whole-number concurrency cap (**default 6**).
   `/subagents cap <number>` overrides it for this session. Both single and batch
   admissions respect the cap; existing runs are never stopped by a cap change.
   Use `/subagents settings` to edit both controls or `/subagents reset` to return

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

@@ -2298,7 +2298,7 @@ export default function (pi: ExtensionAPI) {
     });
     const openSettings = async (ctx: ExtensionCommandContext): Promise<void> => {
         if (ctx.mode === "tui" && ctx.hasUI && typeof ctx.ui.custom === "function") {
-            await ctx.ui.custom<void>((tui, theme, _kb, done) => createSubagentSettingsPage(theme, {
+            const next = await ctx.ui.custom<"agents" | undefined>((tui, theme, _kb, done) => createSubagentSettingsPage(theme, {
                 get: () => {
                     const settings = effectiveSettings();
                     return {
@@ -2310,7 +2310,10 @@ export default function (pi: ExtensionAPI) {
                     };
                 },
                 changeMode, changeCap, save: saveSettings, reset: resetSettings,
-            }, () => { refreshBackgroundWorkNavigator(ctx); tui.requestRender(); }, () => done()));
+                // Close this page first; the catalog opens after ui.custom resolves.
+                openAgents: () => done("agents"),
+            }, () => { refreshBackgroundWorkNavigator(ctx); tui.requestRender(); }, () => done(undefined)));
+            if (next === "agents") await agentOperations.openCatalog(ctx);
         } else {
             ctx.ui.notify(`Delegation mode: ${activeDelegationMode()}. Concurrent subagents: ${activeConcurrencyCap()}. Use /subagents mode <mode> or /subagents cap <number>; /subagents save persists both.`, "info");
         }

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

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

package/node_modules/pi-better-subagents/roles/role.researcher.md

@@ -5,7 +5,7 @@ id: role.researcher
 name: Researcher
 description: Owns external-source evidence and factual uncertainty; excludes repo mapping and changes.
 defaults:
-  model: openai/gpt-6.1-sol
+  model: openai/gpt-6.1-terra
   effort: medium
   tier: balanced
 ---

package/node_modules/pi-better-subagents/settings-page.ts

@@ -18,9 +18,11 @@ export interface SubagentSettingsHandlers {
     changeCap(cap: number): void;
     save(): { ok: boolean; message: string };
     reset(): void;
+    /** Opens the same catalog as `/agents`. The caller closes this page first. */
+    openAgents?(): void;
 }
 
-const labels = ["Delegation mode", "Concurrent subagents", "Reset to defaults"];
+const labels = ["Delegation mode", "Concurrent subagents", "Agents", "Reset to defaults"];
 
 function cell(text: string, width: number): string {
     const clipped = Tui.truncateToWidth(text, width, "");
@@ -57,6 +59,8 @@ export function createSubagentSettingsPage(
                 input.handleInput("\x05");
                 input.focused = focused;
                 report("");
+            } else if (row === 2) {
+                handlers.openAgents?.();
             } else {
                 handlers.reset();
                 report("Session settings reset to saved defaults.");
@@ -118,7 +122,7 @@ export function createSubagentSettingsPage(
             const lines: string[] = [theme.fg("accent", theme.bold("  Subagent settings")), ""];
             labels.forEach((label, index) => {
                 const selected = index === row;
-                if (index === 2) lines.push("");
+                if (index === labels.length - 1) lines.push("");
                 const title = theme.fg(selected ? "accent" : "text", marker(selected) + label);
                 if (index >= 2) {
                     lines.push(highlight(title, selected));

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.0",
+  "version": "0.34.0",
   "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.2",
     "pi-better-sandbox": "0.14.0",
     "pi-better-ssh": "0.1.3",
-    "pi-better-subagents": "0.21.0",
+    "pi-better-subagents": "0.22.0",
     "proper-lockfile": "^4.1.2",
     "smol-toml": "1.9.0",
     "yaml": "^2.9.1"