pi-better-harness 0.33.1 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-subagents",
-  "version": "0.21.1",
+  "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/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.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.1",
+    "pi-better-subagents": "0.22.0",
     "proper-lockfile": "^4.1.2",
     "smol-toml": "1.9.0",
     "yaml": "^2.9.1"