pi-goal-list-loop-audit 0.38.21 → 0.38.22

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.38.22 — subagent display unification: richness ladder + upstream triple-render report (2026-09-05)
+
+### Fixed
+- Subagent display unification (field: triple-rendered run panels swapping order with agent prose, 2026-09-05 screenshot). New `subagentDisplayRichness` setting (`/glla` → Subagents): `rich` (default — detailed worker rows + the task-linkage header `→ <objective>` native UI can never show), `compact` (today's count line), `quiet` (hung/aborting workers only — HUNG is never silent at any level). Rich is safe against the v0.37.1 jumping because `renderAgentsWidgetLines` now buckets silence ages exactly like the compact line, so the widget key only moves on genuine state transitions. Status-bar worker count follows the same ladder automatically. `/glla agents` keeps full detail regardless. Upstream triple-render + order-swap filed as nicobailon/pi-subagents#1931 (read-only diagnosis; GLLA cannot suppress/reorder/merge native panels — no ordering API, transcript components order by arrival); README documents the coexistence escapes (`inlineToolDisplay: "summary"` + `fleetViewPlacement` pin). Coverage: `tests/subagent-display-richness.test.ts` (5 tests: default/normalization, ladder assembly + linkage header, bucket stability, hung invariant, width safety).
+
 ## 0.38.21 — objection-attached retries + PR #43 auditor observability (2026-09-04)
 
 ### Fixed

package/README.md

@@ -298,6 +298,16 @@ GLLA is the supervisor. These companions add capabilities around it:
   sequential goal can still run cleanly without workers — install when
   parallelism will pay for its coordination and model usage.
 
+  Display coexistence: pi-subagents renders its own inline run panels +
+  FleetView, GLLA renders one compact widget line + the status-bar worker
+  count + `/glla agents`. If you see the same run stacked 3× or panels
+  swapping order, set pi-subagents `inlineToolDisplay: "summary"` (one
+  stable row per run) and pin `fleetViewPlacement`; GLLA's own richness is
+  the `subagentDisplayRichness` setting (`/glla` → Subagents): `rich`
+  (default — worker rows + task linkage), `compact` (count line), `quiet`
+  (hung/aborting workers only). Upstream triple-render report:
+  nicobailon/pi-subagents#1931.
+
 Install (or keep pinned):
 
 ```bash

package/docs/DESIGN-subagent-visibility.md

@@ -74,3 +74,17 @@ children so idle rigs see no change.
   pin hung classification, cap behavior, loud-missing-file behavior for
   --tail, and widget hide-at-zero.
 - Version + CHANGELOG + README at ship time; full release gate.
+
+## v0.38.22 supersede — display unification (2026-09-05)
+
+The compact-only doctrine above was the v0.37.1 jitter fix (raw per-second
+silence ages re-laid out the editor every tick). v0.38.22 keeps the doctrine's
+safety property by other means — `renderAgentsWidgetLines` buckets silence
+ages exactly like the compact line, so the widget key only moves on genuine
+state transitions — and restores rich ambient rows behind the
+`subagentDisplayRichness` ladder (`rich` default / `compact` / `quiet`, HUNG
+never silent), plus the task-linkage header (`→ <objective>`) only GLLA can
+show. Triplication/ordering against pi-subagents native panels is upstream
+(nicobailon/pi-subagents#1931, read-only); GLLA owns its slot only and
+documents the native escapes. Assembly is the pure `assembleAgentsExtras`
+(pinned in `tests/subagent-display-richness.test.ts`).

package/docs/INDEX.md

@@ -18,7 +18,7 @@ For shipped docs, the relevant entry points are:
   failback; v0.35.9 hardened cross-version npm tarball checks; v0.35.10
   handles multi-entry npm dry-run reports; v0.35.11 accepts both npm report
   shapes; v0.35.12 supports npm 12's keyed pack reports; v0.35.13 fixes stale-API recovery loops.
-  v0.35.14–v0.38.21 continue through the supervisor freeze (`/glla pause`),
+  v0.35.14–v0.38.22 continue through the supervisor freeze (`/glla pause`),
   load hold, auditor picker parity, Windows launch fix, zombie-watchdog
   subagent carve-out, due-wait backstop, the `/glla agents` visibility panel,
   durable state-root selection, blank-until-resume auditor context, frozen

package/extensions/goal-agents-panel.ts

@@ -159,12 +159,45 @@ export function renderAgentsWidgetLines(rows: AgentsPanelRow[], now = Date.now()
     lines.push(`${rowLabel(row)} · id ${cleanField(row.recordId, 10)}`);
     const evidence = row.evidence !== "live" ? ` · ${row.evidence}` : "";
     const action = row.action === "abort-requested" ? " · aborting" : row.action === "unavailable" ? " · abort unavailable" : row.action === "failed" ? " · abort failed" : "";
-    lines.push(`  ${rowStateWord(row, now)} · silent ${fmtDuration(row.silentMs)}${evidence}${action}`);
+    // v0.38.22 (display unification): bucket the silence age like the
+    // compact line — raw per-second values churn the widget key and
+    // re-layout the editor every tick (the v0.37.1 jumping, reintroduced
+    // the moment rich lines render ambiently).
+    lines.push(`  ${rowStateWord(row, now)} · silent ${fmtDuration(bucketSilentMs(row.silentMs))}${evidence}${action}`);
   }
   if (active.length > shown.length) lines.push(`… ${active.length - shown.length} more agents · /glla agents`);
   return lines;
 }
 
+/** v0.38.22: safety invariant for the richness ladder — HUNG/aborting
+ * workers are never silent, so `quiet` still surfaces them. */
+export function hasHungWorker(rows: AgentsPanelRow[]): boolean {
+  return rows.some((r) => r.status !== "ended" && (r.status === "hung" || r.action === "abort-requested"));
+}
+
+export type AgentsExtras = { line: string; lines: string[] };
+
+/** v0.38.22 (display unification): the pure richness switch behind the
+ * widget/status worker presence. Rich restores detailed rows (capped,
+ * bucketed — the widget key only moves on genuine state transitions)
+ * plus the task-linkage header native UI can never show; compact keeps
+ * the count line; quiet surfaces hung/aborting workers only. Pure and
+ * hermetic for tests; the caller supplies rows + richness + objective. */
+export function assembleAgentsExtras(
+  rows: AgentsPanelRow[],
+  richness: "rich" | "compact" | "quiet",
+  objective: string,
+  now = Date.now(),
+): AgentsExtras | undefined {
+  const line = renderAgentsWidgetLine(rows);
+  if (!line) return undefined;
+  if (richness === "quiet" && !hasHungWorker(rows)) return undefined;
+  if (richness !== "rich") return { line, lines: [] };
+  const clean = objective.replace(/\s+/g, " ").trim();
+  const header = clean ? [`→ ${truncate(clean, 60)}`] : [];
+  return { line, lines: [...header, ...renderAgentsWidgetLines(rows, now)] };
+}
+
 /** The compact footer summary: count + the least-live child.
  * v0.37.1 (ui-jitter fix): bucket the silent age so the status/widget
  * text stays stable between ticks — a per-second change made the footer

package/extensions/goal-settings.ts

@@ -26,6 +26,8 @@ import {
   piGlaDir,
 } from "./goal-loop-core.ts";
 import type { SubagentModelStrategy } from "./goal-loop-subagents.js";
+/** v0.38.22: ambient worker display richness (see subagentDisplayRichness). */
+export type SubagentDisplayRichness = "rich" | "compact" | "quiet";
 import {
   DEFAULT_MAIN_MODEL_PRIMARY_PROBE_MINUTES,
   normalizeMainModelFallbackRefs,
@@ -243,6 +245,12 @@ export interface Settings {
   /** v0.27.5: post-completion audit config. Same shape as `reviewer`. */
   postaudit?: Record<string, unknown>;
   subagentModelStrategy?: SubagentModelStrategy;
+  /** v0.38.22 (display unification): ambient worker richness. `rich`
+   * (default) shows detailed worker rows + the task-linkage header;
+   * `compact` shows the single count line; `quiet` shows worker presence
+   * only when a child is hung/aborting — HUNG is never silent at any
+   * level. `/glla agents` keeps full detail regardless. */
+  subagentDisplayRichness?: SubagentDisplayRichness;
   /** Per-agent-type model pin, e.g. { "scout": "minimax/MiniMax-M3" }.
    * Always wins over subagentModelStrategy — the managed override is written
    * WITH this pin regardless of strategy. */
@@ -345,6 +353,9 @@ export const DEFAULT_SETTINGS: Settings = {
   // v0.24.6: subagents inherit the session model by default, avoiding a
   // surprise provider/model pin from the upstream default agent.
   subagentModelStrategy: "inherit-parent",
+  // v0.38.22 (display unification): rich by default — full worker rows +
+  // task linkage; trimmable to compact/quiet, never silent on hangs.
+  subagentDisplayRichness: "rich",
   auditFeedbackChars: DEFAULT_AUDIT_FEEDBACK_CHARS,
   // v0.34.141: keep-going is the production default. Set false explicitly
   // for the conservative pause-first policy; the dial flips DEFAULTS, never
@@ -376,7 +387,7 @@ export function readSettingsFile(file: string): Partial<Settings> {
   }
 }
 
-function normalizeLoadedSettings(settings: Settings): Settings {
+export function normalizeLoadedSettings(settings: Settings): Settings {
   // Settings files can be edited by hand or survive an older UI. Normalize
   // the main fallback chain at every read so runtime, display, and persistence
   // all see the same bounded value.
@@ -402,6 +413,13 @@ function normalizeLoadedSettings(settings: Settings): Settings {
   if (settings.stateRoot !== "sessionDir" && settings.stateRoot !== "workingDir") {
     settings.stateRoot = "workingDir";
   }
+  // v0.38.22: hand-edited richness falls back to rich (the default) —
+  // unknown values must not blank the worker display.
+  if (settings.subagentDisplayRichness !== "rich"
+      && settings.subagentDisplayRichness !== "compact"
+      && settings.subagentDisplayRichness !== "quiet") {
+    settings.subagentDisplayRichness = "rich";
+  }
   if (settings.mainModelFailback !== "auto" && settings.mainModelFailback !== "sticky") {
     settings.mainModelFailback = "auto";
   }

package/extensions/loops/goal-settings-ui.ts

@@ -293,6 +293,7 @@ import {
   syncSubagentModelOverrides,
   type SubagentModelStrategy,
 } from "../goal-loop-subagents.js";
+import type { SubagentDisplayRichness } from "../goal-settings.js";
 import {
   buildSettingsRows,
   SettingsMenuComponent,
@@ -1578,6 +1579,19 @@ export async function handleSettingChoice(id: string, ctx: ExtensionContext): Pr
       }
       return;
     }
+    case "subagentDisplayRichness": {
+      const v = await ctx.ui.select("Subagent display richness (ambient worker UI)", [
+      "rich — worker rows + task linkage (recommended)",
+      "compact — the count line only",
+      "quiet — hung/aborting workers only (HUNG is never silent)",
+      ]);
+      if (v) {
+        const richness: SubagentDisplayRichness = v.startsWith("compact") ? "compact" : v.startsWith("quiet") ? "quiet" : "rich";
+        saveSettings("global", ctx.cwd, { subagentDisplayRichness: richness });
+        ctx.ui.notify(`Subagent display richness saved (${richness}) — applies on the next UI refresh.`, "info");
+      }
+      return;
+    }
     case "subagentResolved":
       // Read-only (effective resolution row) — no editor; row just shows the
       // current effective subagent models. Treat as no-op.

package/extensions/loops/goal-ui.ts

@@ -265,7 +265,7 @@ import {
   type HeartbeatFlags,
 } from "../goal-heartbeat.js"; // decomposition step 4 (v0.34.112)
 import { getSubagentAgentsSnapshot } from "../goal-heartbeat.js";
-import { renderAgentsWidgetLine, type AgentsPanelRow } from "../goal-agents-panel.js";
+import { assembleAgentsExtras, type AgentsPanelRow } from "../goal-agents-panel.js";
 import {
   clearMainModelRecoveryTimer,
   createGoalRecovery,
@@ -797,18 +797,19 @@ function refreshUI(ctx: ExtensionContext, force = false): void {
     const extras = {
       stalls: consecutiveStalls,
       recent: recentActions,
-      // v0.37.1 (ui-jitter fix): compact-only widget — one stable footer
-      // line "● N agents · scout silent Xm". Detailed per-agent rows live
-      // in `/glla agents` / `--tail` (DESIGN intent); splicing 2 lines per
-      // scout into the above-editor card made height swing 4→10 lines and
-      // re-laid out the editor every 2–5s. Keep lines empty so
-      // buildWidgetLines does not splice.
+      // v0.38.22 (display unification): richness ladder for ambient
+      // workers — `rich` (default) restores the detailed rows the v0.37.1
+      // jitter fix removed, now safe because silence ages are bucketed
+      // (widget key only changes on genuine state transitions, not every
+      // tick) plus the task-linkage header native UI can never show.
+      // `compact` keeps the single line; `quiet` surfaces hung/aborting
+      // workers only (HUNG is never silent at any level).
       ...(() => {
         try {
           const { agents } = getSubagentAgentsSnapshot();
           const rows = agents as AgentsPanelRow[];
-          const line = renderAgentsWidgetLine(rows);
-          return line ? { agents: { line, lines: [] } } : {};
+          const extras = assembleAgentsExtras(rows, settings.subagentDisplayRichness ?? "rich", state.goal?.objective ?? "", now);
+          return extras ? { agents: extras } : {};
         } catch { return {}; }
       })(),
       ...activity,

package/extensions/settings-menu.ts

@@ -557,6 +557,15 @@ export function buildSettingsRows(
     description:
       "inherit-parent shares your session model; agent-default uses upstream defaults; Designer remains available as a glla role",
   });
+  rows.push({
+    id: "subagentDisplayRichness",
+    section: "subagents",
+    label: "Subagent display richness",
+    valueText: show("subagentDisplayRichness", "rich"),
+    sourceText: src("subagentDisplayRichness"),
+    description:
+      "rich shows worker rows + task linkage (default); compact shows the count line; quiet shows hung/aborting workers only — HUNG is never silent",
+  });
   for (const name of OVERRIDABLE_AGENT_TYPES) {
     rows.push({
       id: `subagentModelOverrides.${name}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-list-loop-audit",
-  "version": "0.38.21",
+  "version": "0.38.22",
   "description": "Mission control for autonomous pi: interview-drafted goals, an audited task queue, and forever-loops (metric, spec, project-audit) that run for hours. A detached extension-less auditor process re-verifies every completion with raw evidence without holding the main pi turn; confirmed drafts, decision pauses and consent gates keep you in charge.",
   "license": "AGPL-3.0-only",
   "author": "dracon",