ac-teams 0.0.15 → 0.0.16

package/src/panel.ts

@@ -2,17 +2,22 @@ import { basename } from "node:path";
 import type { ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import { Editor, indexedColor, matchesKey, sliceByColumn, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { contextSummary } from "./telemetry.ts";
-import { buildTaskGraph, moveTaskSelection, taskStatus } from "./graph.ts";
+import { buildTaskGraph, moveTaskSelection, taskStatus, type TaskGraph } from "./graph.ts";
 import { cleanText as clean } from "./render.ts";
 import type { PanelHost } from "./ui-types.ts";
-import { taskName, type TaskView } from "./types.ts";
+import { taskName, type Message, type TaskView } from "./types.ts";
 
 export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Promise<void> {
   if (ctx.mode !== "tui") throw new Error("Teams panel requires interactive terminal mode");
   let snapshot = await host.snapshot();
   let tasks = snapshot.tasks;
   let events = snapshot.messages.slice().reverse();
-  let taskGraph = buildTaskGraph(tasks);
+  // Zoom is the title width each box gets, from the longest title (100%) down to none (number and status only).
+  const longest = () => Math.max(1, ...tasks.map(task => visibleWidth(clean(task.title))));
+  let graphs = new Map<number, TaskGraph | null>();
+  const graphAt = (budget: number) => { if (!graphs.has(budget)) graphs.set(budget, buildTaskGraph(tasks, budget)); return graphs.get(budget)!; };
+  let zoom: number | "fit" = "fit", shownZoom = longest();
+  let taskGraph = graphAt(shownZoom);
   const drafts = host.drafts;
   const name = (id: string | undefined) => id === "root" ? "Main" : clean(snapshot.members.find(member => member.id === id)?.name ?? id ?? "Unassigned");
   const creator = (task: TaskView) => (task as TaskView & { creator?: string }).creator ?? "root";
@@ -26,7 +31,7 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
     let timer: ReturnType<typeof setTimeout> | undefined;
     let focused = true;
     let memberQuery = "", searching = false, hideStopped = false;
-    const tabs = ["Tasks", "Teammates", "Activity"];
+    const tabs = ["Tasks", "Teammates", "Board"];
     const selectedTask = () => tasks[taskIndex];
     const memberIds = () => ["root", ...snapshot.members.filter(member => member.id !== "root").map(member => member.id)]
       .filter(id => name(id).toLowerCase().includes(memberQuery.toLowerCase())
@@ -46,7 +51,7 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         taskIndex = Math.max(0, tasks.findIndex(task => task.id === taskId));
         memberIndex = Math.max(0, memberIds().indexOf(memberId));
         eventIndex = Math.max(0, events.findIndex(event => event.id === eventId));
-        if (changed) taskGraph = buildTaskGraph(tasks);
+        if (changed) { graphs = new Map(); taskGraph = graphAt(Math.min(shownZoom, longest())); }
       } catch (error) { if (!disposed) receipt = `Refresh failed: ${clean(String(error))}`; }
       finally { if (!disposed) { refresh(); timer = setTimeout(() => void poll(), 2000); } }
     }
@@ -115,23 +120,36 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       const task = selectedTask();
       if (!task) return wrap([heading("No tasks yet"), "Request a task with N. Main creates and organizes it."], width);
       const unlocked = tasks.filter(other => other.dependencies.includes(task.id));
+      const outcome = task.outcome ? snapshot.messages.find(message => message.id === task.outcome) : undefined;
+      const [first = "", ...rest] = outcome ? clean(outcome.summary).split("\n") : [];
+      const prerequisites = task.dependencies.map(id => {
+        const parent = tasks.find(item => item.id === id);
+        return parent ? `${taskTitle(parent.id)} · ${stateLabel(parent)}` : `${clean(id)} · Unavailable`;
+      });
       return wrap([
-        heading(clean(taskName(task))), label("Title", clean(task.title)), label("ID", task.id), "",
-        label("State", stateLabel(task)), label("Owner", name(task.owner)), label("Creator", name(creator(task))), "",
-        heading("Description"), clean(task.description), "",
-        heading("Prerequisites"),
-        ...(task.dependencies.length ? task.dependencies.map(id => {
-          const parent = tasks.find(item => item.id === id);
-          return parent ? `${clean(taskName(parent))} · ${taskStatus(parent)}` : `${clean(id)} · Unavailable`;
-        }) : [fg("muted", "None; this task can start independently.")]), "",
-        heading("Unlocks"), ...(unlocked.length ? unlocked.map(item => clean(taskName(item))) : [fg("muted", "No dependent tasks.")]),
-        "",
-        fg("accent", "C  Give feedback to creator"), fg("accent", "O  Open owner's full session"),
-        ...(!detail ? [fg("muted", "Enter  Full details")] : []),
+        heading(taskTitle(task.id)) + fg("muted", " · ") + stateLabel(task), "",
+        label("Owner", name(task.owner)), ...(task.delegator ? [label("Delegator", name(task.delegator))] : []),
+        label("Creator", name(creator(task))), "",
+        ...(outcome ? [section(`Outcome from ${name(outcome.from)}`, width), theme.bold(first), ...rest, ...(outcome.detail ? ["", fg("muted", clean(outcome.detail))] : []), ""] : []),
+        section("Description", width), clean(task.description), "",
+        section("Dependencies", width),
+        label("Needs", prerequisites.length ? prerequisites.join(", ") : fg("muted", "Nothing; can start now")),
+        label("Unlocks", unlocked.length ? unlocked.map(item => taskTitle(item.id)).join(", ") : fg("muted", "No other tasks")), "",
+        section("Actions", width), fg("accent", "C") + "  Give feedback to creator", fg("accent", "O") + "  Open owner's session", "",
+        fg("dim", `ID ${task.id}`),
       ], width);
     }
 
     function graphLines(width: number) {
+      if (zoom === "fit") {
+        // Largest title width that still fits the pane (binary search; graphs are cached per width).
+        const fits = (budget: number) => { const g = graphAt(budget); return !!g && g.art.width <= width && g.art.plain.length <= bodyHeight - 1; };
+        let low = 0, high = longest();
+        if (fits(high)) low = high;
+        else while (low < high - 1) { const mid = (low + high) >> 1; if (fits(mid)) low = mid; else high = mid; }
+        shownZoom = low;
+      } else shownZoom = zoom;
+      taskGraph = graphAt(shownZoom);
       if (!taskGraph) return undefined;
       const { art, bounds } = taskGraph;
       const selected = bounds.get(selectedTask()?.id ?? "");
@@ -150,10 +168,12 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
           if (active && y === box.top + 1) text = text.replace("○ ", "● ");
           const border = y === box.top || y === box.bottom;
           const content = sliceByColumn(text, 1, box.right - box.left - 1), status = taskStatus(task);
-          const color = status === "Done" ? "dim" : "text";
+          const color = active ? "accent" : status === "Done" ? "dim" : "text";
           const index = y === box.bottom - 1 && content.trimEnd().endsWith(status) ? content.lastIndexOf(status) : -1;
           const interior = index < 0 ? fg(color, content) : fg(color, content.slice(0, index)) + stateLabel(task) + fg(color, content.slice(index + status.length));
-          const styled = border ? statusText(task, text) : statusText(task, "│") + (active ? theme.bold(interior) : interior) + statusText(task, "│");
+          // The selected box keeps its status colour but gets a heavy border and bold text, so selection never competes with status.
+          const edge = (part: string) => statusText(task, active ? part.replace(/[┌┐└┘─│┬┴]/g, ch => ({ "┌": "┏", "┐": "┓", "└": "┗", "┘": "┛", "─": "━", "│": "┃", "┬": "┯", "┴": "┷" })[ch]!) : part);
+          const styled = border ? edge(text) : edge("│") + (active ? theme.bold(interior) : interior) + edge("│");
           row = sliceByColumn(row, 0, box.left) + styled + sliceByColumn(row, box.right + 1, art.width);
         }
         const indent = " ".repeat(Math.max(0, Math.floor((width - art.width) / 2)));
@@ -184,9 +204,9 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       let selectedHeight = 1, graphWidth = 0;
       if (tab === 0) {
         const graphData = graph ? graphLines(leftWidth) : undefined;
-        left = graphData ? graphData.rows : tasks.length ? [fg("muted", "  Task / State"), "",
+        left = graphData ? graphData.rows : tasks.length ? [fg("muted", "  Task"), "",
           ...tasks.map((task, index) => {
-            const text = `${index === taskIndex ? "●" : " "} ${clean(taskName(task))}`;
+            const text = `${index === taskIndex ? "●" : " "} ${taskTitle(task.id)}`;
             const body = fg(taskStatus(task) === "Done" ? "dim" : "text", truncateToWidth(text, Math.max(1, leftWidth - 10)));
             return (index === taskIndex ? theme.bold(body) : body) + " · " + stateLabel(task);
           })] : [heading("No tasks yet"), "N  Request a task from Main"];
@@ -211,8 +231,8 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         const nameExtra = Math.min(spare, Math.max(0, ...ids.map(id => visibleWidth(name(id)) - nameWidth)));
         const gap = " ".repeat(4 + Math.floor((spare - nameExtra) / gaps));
         nameWidth += nameExtra + (spare - nameExtra) % gaps;
-        left = [fg("muted", `  ${pad("Member", nameWidth)}${gap}${pad("Session", sessionWidth)}`
-          + (showTasks ? `${gap}${pad("Tasks", tasksWidth)}` : "") + (showDirectory ? `${gap}Directory` : "")), ...ids.map((id, index) => {
+        left = [fg("muted", `  ${pad("Member", nameWidth)}${gap}${pad("State", sessionWidth)}`
+          + (showTasks ? `${gap}${pad("Done", tasksWidth)}` : "") + (showDirectory ? `${gap}Directory` : "")), ...ids.map((id, index) => {
           const member = snapshot.members.find(member => member.id === id);
           const selected = index === memberIndex;
           const stopped = member && ["stopped", "interrupted"].includes(member.status);
@@ -230,11 +250,19 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         selectedRow = memberIndex + 1;
         right = split ? memberDetails(rightWidth) : [];
       } else {
-        left = events.length ? [fg("muted", "  Recent messages · newest first"), "", ...events.flatMap((event, index) => [
-          `${index === eventIndex ? "●" : " "} ${name(event.from)} → ${event.recipients.map(name).join(", ") || "Team"}`,
-          fg("muted", `  ${clean(event.time)} · ${clean(event.text).split("\n")[0]}`), "",
-        ])] : [heading("No activity yet"), fg("muted", "Recent persistent team messages appear here.")];
-        selectedRow = eventIndex * 3 + 2;
+        // One row per post: who, what kind, its summary headline, then task and time as quieter context.
+        const fromWidth = Math.min(16, Math.max(4, ...events.map(event => visibleWidth(name(event.from)))));
+        const taskWidth = Math.min(5, Math.max(4, ...events.map(event => event.task ? visibleWidth(taskRef(event.task)) : 0)));
+        const summaryWidth = Math.max(1, leftWidth - (2 + fromWidth + 2 + 7 + 2 + 2 + taskWidth + 2 + 5));
+        left = events.length ? [fg("muted", `  ${pad("From", fromWidth)}  ${pad("Kind", 7)}  ${pad("Summary", summaryWidth)}  ${pad("Task", taskWidth)}  Time`),
+          ...events.map((event, index) => {
+            const selected = index === eventIndex;
+            const from = pad(name(event.from), fromWidth), summary = pad(headline(event), summaryWidth);
+            return fg(selected ? "accent" : "dim", `${selected ? "●" : " "} `) + (selected ? theme.bold(fg("accent", from)) : from) + "  "
+              + kindLabel(event) + "  " + (selected ? theme.bold(summary) : summary) + "  "
+              + fg("muted", pad(event.task ? taskRef(event.task) : "", taskWidth)) + "  " + fg("dim", clock(event.time).slice(0, 5));
+          })] : [heading("No posts yet"), fg("muted", "Updates, questions, replies, and outcomes appear here.")];
+        selectedRow = eventIndex + 1;
         right = split ? eventDetails(rightWidth) : [];
       }
 
@@ -243,8 +271,12 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       if (selectedRow + selectedHeight > scroll + viewHeight) scroll = selectedRow + selectedHeight - viewHeight;
       scroll = Math.max(0, Math.min(scroll, Math.max(0, left.length - viewHeight)));
       const viewport = left.slice(scroll, scroll + viewHeight);
-      if (graphWidth) viewport.unshift(fg("muted", `↑ ${scroll} rows above · ↓ ${Math.max(0, left.length - scroll - viewHeight)} below`
-        + (graphWidth > leftWidth ? ` · ← ${columnScroll} cols · ${Math.max(0, graphWidth - columnScroll - leftWidth)} →` : "")));
+      if (graphWidth) {
+        const hidden = scroll || left.length > scroll + viewHeight || graphWidth > leftWidth;
+        viewport.unshift(fg("muted", `Zoom ${Math.round(100 * shownZoom / longest())}%${zoom === "fit" ? " (fit)" : ""}`
+          + (hidden ? ` · ↑ ${scroll} rows · ↓ ${Math.max(0, left.length - scroll - viewHeight)} rows` : "")
+          + (graphWidth > leftWidth ? ` · ← ${columnScroll} cols · ${Math.max(0, graphWidth - columnScroll - leftWidth)} cols →` : "")));
+      }
       return Array.from({ length: bodyHeight }, (_, index) => {
         let row = viewport[index] ?? "";
         if (!graphWidth && index === 0 && scroll > 0) row = fg("muted", `↑ ${scroll} rows above`);
@@ -253,10 +285,39 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       });
     }
 
+    /** Task number and full title; labels are too short to say what a post is about. */
+    function taskTitle(id: string) {
+      const task = tasks.find(item => item.id === id);
+      return task ? clean(`#${task.number} ${task.title}`) : clean(id);
+    }
+
+    const headline = (event: Message) => clean(event.summary).split("\n")[0];
+    const taskRef = (id: string) => { const task = tasks.find(item => item.id === id); return task ? `#${task.number}` : "#?"; };
+    const kindLabel = (event: Message) => event.kind === "outcome" ? fg("success", pad("Outcome", 7))
+      : event.replyTo ? fg("accent", pad("Reply", 7)) : fg("muted", pad("Post", 7));
+    // A labelled rule separates tiers more clearly than bold text alone.
+    const section = (title: string, width: number) => theme.bold(fg("accent", title)) + " " + fg("dim", "─".repeat(Math.max(0, width - visibleWidth(title) - 1)));
+    const post = (id: string | undefined) => snapshot.messages.find(message => message.id === id);
+    const clock = (time: string) => { const date = new Date(time); return isNaN(+date) ? clean(time) : date.toTimeString().slice(0, 8); };
+
+    // Tiers: headline (first summary line), the rest of the summary, then optional detail and the thread around it.
     function eventDetails(width: number) {
       const event = events[eventIndex];
-      if (!event) return wrap([heading("No activity yet"), "Recent persistent team messages appear here."], width);
-      return wrap([heading("Team message"), "", label("From", name(event.from)), label("To", event.recipients.map(name).join(", ") || "Team"), label("Time", clean(event.time)), "", clean(event.text)], width);
+      if (!event) return wrap([heading("No posts yet"), "Updates, questions, replies, and outcomes appear here."], width);
+      const [first = "", ...rest] = clean(event.summary).split("\n");
+      const parent = post(event.replyTo), task = event.task ? tasks.find(item => item.id === event.task) : undefined;
+      const replies = snapshot.messages.filter(message => message.replyTo === event.id);
+      const date = new Date(event.time);
+      return wrap([
+        kindLabel(event).trimEnd() + fg("muted", ` from ${name(event.from)}`),
+        label("To", event.recipients.map(name).join(", ") || "Team"),
+        ...(event.task ? [label("Task", `${taskTitle(event.task)}${task ? ` · ${stateLabel(task)}` : ""}`)] : []),
+        ...(parent ? [label("Reply to", `${name(parent.from)}: ${headline(parent)}`)] : []),
+        label("Time", isNaN(+date) ? clean(event.time) : date.toLocaleString()), "",
+        section("Summary", width), theme.bold(first), ...rest,
+        ...(event.detail ? ["", section("Detail", width), clean(event.detail)] : []),
+        ...(replies.length ? ["", section(`Replies (${replies.length})`, width), ...replies.map(reply => `${name(reply.from)}: ${headline(reply)}`)] : []),
+      ], width);
     }
 
     function memberDetails(width: number) {
@@ -265,20 +326,21 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       if (!id) return wrap([heading("No matching teammates"), "Change the name filter or show stopped members."], width);
       const member = snapshot.members.find(member => member.id === id);
       const assigned = tasks.filter(task => task.owner === id);
-      return wrap([heading(name(id)), "", label("State", member?.needsInput ? fg("error", "Needs input") : clean(member?.status ?? (id === "root" ? "Main conversation" : "Unavailable")).replace(/^./, char => char.toUpperCase())),
+      const stopped = member && ["stopped", "interrupted"].includes(member.status);
+      return wrap([
+        heading(name(id)) + fg("muted", " · ") + (member?.needsInput ? fg("error", "Needs input") : clean(member?.status ?? (id === "root" ? "Main conversation" : "Unavailable")).replace(/^./, char => char.toUpperCase())), "",
         label("Model", clean(member?.modelName || member?.model?.slice(member.model.indexOf("/") + 1) || "Unknown")),
         label("Context", clean(contextSummary(member?.contextUsage).replace(/^context unknown/, "Unknown"))),
         label("Directory", clean(member?.cwd ?? (id === host.self ? ctx.cwd : "Unavailable"))),
-        label("Tasks", taskProgress(id)), fg("muted", "Completed / currently assigned"),
-        ...(member?.error ? [label("Error", clean(member.error))] : []), "", heading("Assigned tasks"),
-        ...assigned.map(task => `${clean(taskName(task))} · ${taskStatus(task)}`),
-        ...(assigned.length ? [] : [fg("muted", "No assigned tasks.")]), "",
-        fg("accent", member && ["stopped", "interrupted"].includes(member.status) ? "Enter  Resume and open" : "Enter  Open session"),
-        ...(!detail ? [fg("muted", "→  Details")] : []),
-        ...(!host.child && member?.role === "member" ? [fg("accent", "P  Promote to main session"), fg("muted", "Stops member; reopens transcript as a main session.")] : []),
-        "", heading("Session details"), label("ID", id),
-        label("Session", clean(member?.sessionFile ?? member?.sessionId ?? "Unavailable")),
-        label("Worktree", member?.worktree ? clean(`${member.worktree.path} (${member.worktree.branch})`) : "None"),
+        ...(member?.error ? [label("Error", fg("error", clean(member.error)))] : []), "",
+        section(`Tasks (${assigned.filter(task => task.status === "done").length} of ${assigned.length} done)`, width),
+        ...(assigned.length ? assigned.map(task => `${taskTitle(task.id)} · ${stateLabel(task)}`) : [fg("muted", "No assigned tasks.")]), "",
+        section("Actions", width), fg("accent", "Enter") + (stopped ? "  Resume and open session" : "  Open session"),
+        ...(!host.child && member?.role === "member" ? [fg("accent", "P") + "  Promote to main session " + fg("muted", "(stops the member, reopens its transcript as a main session)")] : []), "",
+        section("Session", width),
+        fg("muted", label("ID", id)),
+        fg("muted", label("File", clean(member?.sessionFile ?? member?.sessionId ?? "Unavailable"))),
+        fg("muted", label("Worktree", member?.worktree ? clean(`${member.worktree.path} (${member.worktree.branch})`) : "None")),
       ], width);
     }
 
@@ -297,7 +359,7 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
           : compose ? "Enter Send · Shift+Enter Newline · Esc Keep draft"
           : detail ? tab === 0 ? "↑↓ Scroll · C Feedback · O Open owner · Esc Back"
             : tab === 1 ? "↑↓ Scroll · Enter Open session · Esc Back" : "↑↓ Scroll · O Open related session · Esc Back"
-          : tab === 0 ? `${graph ? "↑↓←→" : "↑↓"} Select · Enter Details · G Graph/List · C Feedback · N New task · Tab Next · Esc Close`
+          : tab === 0 ? `${graph ? "↑↓←→" : "↑↓"} Select · Enter Details · G Graph/List${graph ? " · +/- Zoom · F Fit" : ""} · C Feedback · N New task · Tab Next · Esc Close`
           : tab === 1 ? `${filters} · ↑↓ Select · → Details · Enter Open session · N New task · Tab Next · Esc Close`
           : "↑↓ Select · Enter Details · O Open related session · Tab Next · Esc Close";
         const teammates = snapshot.members.filter(member => member.id !== "root");
@@ -307,7 +369,7 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         const summaryText = tab === 0
           ? `${tasks.length} tasks · ${["Working", "Ready", "Blocked", "Done"].map(state => `${tasks.filter(task => taskStatus(task) === state).length} ${state.toLowerCase()}`).join(" · ")}`
           : tab === 1 ? `${teammates.length} teammate${teammates.length === 1 ? "" : "s"} · ${["working", "idle", "stopped", "needs input"].map(state => `${memberStates.filter(value => value === state).length} ${state}`).join(" · ")}`
-          : `${events.length} message${events.length === 1 ? "" : "s"} · newest first`;
+          : `${events.length} post${events.length === 1 ? "" : "s"} · ${events.filter(event => event.kind === "outcome").length} outcomes · ${events.filter(event => event.replyTo).length} replies`;
         const summary = wrapTextWithAnsi(fg("muted", summaryText), inner);
         const receipts = receipt ? wrapTextWithAnsi(fg("muted", receipt), inner) : [];
         const hints = wrapTextWithAnsi(fg("dim", help), inner);
@@ -360,6 +422,13 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
           else if (tab === 1) memberIndex = Math.max(0, Math.min(memberIds().length - 1, memberIndex + delta));
           else eventIndex = Math.max(0, Math.min(events.length - 1, eventIndex + delta));
         } else if (data.toLowerCase() === "g" && tab === 0 && !detail) { graph = !graph; scroll = 0; }
+        else if (tab === 0 && graph && !detail && ["+", "=", "-"].includes(data)) {
+          // Steps of 1.25x title width, like a smooth zoom; always at least one column so each press shows a change.
+          const at = zoom === "fit" ? shownZoom : zoom;
+          zoom = data === "-" ? Math.max(0, Math.min(at - 1, Math.floor(at / 1.25)))
+            : Math.min(longest(), Math.max(at + 1, Math.ceil(at * 1.25)));
+          scroll = 0; columnScroll = 0;
+        } else if (tab === 0 && graph && !detail && data.toLowerCase() === "f") { zoom = "fit"; scroll = 0; columnScroll = 0; }
         else if (data.toLowerCase() === "n") begin("new");
         else if (data.toLowerCase() === "c" && tab === 0) begin("feedback");
         else if (data.toLowerCase() === "p" && tab === 1 && !host.child) {

package/src/render.ts

@@ -62,7 +62,7 @@ function toolSummary(data: unknown, theme: Theme, labels: Readonly<Record<string
     const value = data as Record<string, unknown>;
     if (Array.isArray(value.members)) return preview(value.members, `${value.members.length} members`, theme, labels);
     if (Array.isArray(value.tasks)) return preview(value.tasks, value.total === undefined ? `${value.tasks.length} tasks` : `${value.tasks.length} of ${value.total} tasks`, theme, labels);
-    const label = value.title ?? value.name ?? value.brief ?? value.text ?? value.query ?? (Array.isArray(value.recipients) ? undefined : value.id === undefined ? undefined : memberLabel(value.id, labels));
+    const label = value.title ?? value.name ?? value.brief ?? value.summary ?? value.text ?? value.query ?? (Array.isArray(value.recipients) ? undefined : value.id === undefined ? undefined : memberLabel(value.id, labels));
     const status = value.status === undefined ? "" : inline(value.status);
     const color = status === "done" ? "success"
       : status === "interrupted" ? "error"
@@ -75,7 +75,7 @@ function toolSummary(data: unknown, theme: Theme, labels: Readonly<Record<string
     }
     return parts.filter(Boolean).join(" ");
   }
-  return data === undefined || data === null ? "" : inline(data);
+  return data === undefined || data === null ? "" : memberLabel(data, labels);
 }
 
 export function teamToolRenderers(name: string, getLabels: MemberLabels = defaultLabels): ToolRenderers {
@@ -97,12 +97,12 @@ export function teamToolRenderers(name: string, getLabels: MemberLabels = defaul
         try { data = JSON.parse(text); } catch { data = text; }
       }
       const labels = getLabels();
-      const outcome = context.isError ? `error · ${inline(text)}` : toolSummary(data, theme, labels) || "done";
+      const waiting = action === "wait" && Array.isArray(data) && data.length === 0;
+      const outcome = context.isError ? `error · ${inline(text)}` : waiting ? "turn ended; the next post wakes this session" : toolSummary(data, theme, labels) || "done";
       const request = toolSummary(fields, theme, labels);
       const heading = `${theme.fg(context.isError ? "error" : "success", "●")} ${theme.fg("toolTitle", name)} · ${inline(action ?? "...")} → ${outcome}${request && !outcome.includes(request) ? ` · ${request}` : ""}`;
-      const requestJSON = cleanText(JSON.stringify(context.args, null, 2));
       const responseJSON = cleanText(result.details === undefined ? text : JSON.stringify(result.details, null, 2));
-      const hiddenLines = requestJSON.split("\n").length + responseJSON.split("\n").length + 2;
+      const hiddenLines = responseJSON.split("\n").length;
       const hint = theme.fg("muted", options.expanded ? " (" : ` … +${hiddenLines} lines (`)
         + keyHint("app.tools.expand", options.expanded ? "to collapse" : "to expand") + theme.fg("muted", ")");
       const row = new Container();
@@ -117,9 +117,6 @@ export function teamToolRenderers(name: string, getLabels: MemberLabels = defaul
         },
       });
       if (options.expanded) {
-        row.addChild(new Text(theme.fg("muted", "Request"), context.outputPad, 0));
-        row.addChild(new Text(requestJSON, context.outputPad, 0));
-        row.addChild(new Text(theme.fg("muted", "Response"), context.outputPad, 0));
         row.addChild(new Text(responseJSON, context.outputPad, 0));
       }
       return row;
@@ -129,12 +126,15 @@ export function teamToolRenderers(name: string, getLabels: MemberLabels = defaul
 
 export function teamMessageRenderer(getLabels: MemberLabels = defaultLabels): MessageRenderer {
   return (message, { expanded }, theme) => {
-    const details = message.details as { through?: number; messages?: { from: string; text: string; recipients: string[] }[] } | undefined;
-    const recent = details?.messages?.at(-1);
+    const details = message.details as { through?: number; messages?: { from: string; summary: string; recipients: string[]; task?: string; kind?: string }[] } | undefined;
+    const posts = details?.messages ?? [], recent = posts.at(-1);
+    const more = posts.length > 1 ? ` (+${posts.length - 1} more)` : "";
     const labels = getLabels();
     const name = (id: string) => memberLabel(id, labels);
-    const preview = recent ? `${name(recent.from)} → ${recent.recipients.map(name).join(", ")} · ${recent.text.split("\n")[0]}` : `Updates through ${details?.through ?? "unknown"}`;
-    return entry("Team message", details ?? { content: message.content }, expanded, theme, false, preview);
+    // Lead with what happened: "count-a completed #1 Count lines · 37 lines", or "count-a → Main · #1 … · question".
+    const what = recent && (recent.kind === "outcome" && recent.task ? `${name(recent.from)} completed ${name(recent.task)}` : `${name(recent.from)} → ${recent.recipients.map(name).join(", ")}${recent.task ? ` · ${name(recent.task)}` : ""}`);
+    const preview = recent ? `${what} · ${recent.summary.split("\n")[0]}${more}` : `Updates through ${details?.through ?? "unknown"}`;
+    return entry("ac-teams", details ?? { content: message.content }, expanded, theme, false, preview);
   };
 }
 

package/src/schemas.ts

@@ -13,6 +13,7 @@ export const AgentSchema = Type.Object({
   worktree: Type.Optional(Type.Boolean()), base: Type.Optional(id), target: Type.Optional(id),
   limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
   depth: Type.Optional(Type.Integer({ minimum: 0, maximum: 10 })),
+  task: Type.Optional(Type.String({ minLength: 1, maxLength: 128, description: "Launch only: an existing to-do task the new member owns, with you as its delegator. Its activity reaches you; include its goal in the brief." })),
   access: Type.Optional(Type.Object({
     read: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: 4096 }), { maxItems: 32 })),
     write: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: 4096 }), { maxItems: 32 })),
@@ -32,12 +33,19 @@ export const TaskSchema = Type.Object({
   offset: Type.Optional(Type.Integer({ minimum: 0 })), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
   action: Type.Union(["create", "list", "read", "edit", "claim", "start", "release", "complete", "reopen"].map(v => Type.Literal(v))),
   id: Type.Optional(id), ...taskFields,
+  summary: Type.Optional(Type.String({ minLength: 1, maxLength: 16000, description: "Complete: the outcome, published atomically with done: what was done, how it was checked, and caveats. Start with the result itself (e.g. 37 lines); the first line is the one people see. Complete enough that the delegator can act without reading detail." })),
+  detail: Type.Optional(Type.String({ minLength: 1, maxLength: 16000, description: "Complete: optional supporting detail, read on demand." })),
   tasks: Type.Optional(Type.Array(Type.Object({ ...taskFields, title: Type.String({ minLength: 1, maxLength: 500 }) }, { additionalProperties: false }), { minItems: 1, maxItems: 100, description: "Create several tasks atomically. Use instead of top-level task fields. Dependencies must refer to existing task IDs, not items in this batch." })),
 }, { additionalProperties: false });
 export const MessageSchema = Type.Object({
-  action: Type.Union(["send", "history", "search"].map(v => Type.Literal(v))),
-  recipients: Type.Optional(Type.Array(id, { minItems: 1, maxItems: 100, uniqueItems: true, description: "Exact teammate names or member IDs. Each must resolve to a different live member. Omit to notify all other live members." })),
-  text: Type.Optional(text), query: Type.Optional(Type.String({ minLength: 1, maxLength: 500 })),
+  action: Type.Union(["send", "history", "search", "wait"].map(v => Type.Literal(v))),
+  tasks: Type.Optional(Type.Array(id, { maxItems: 100, uniqueItems: true, description: "Wait: also wake on posts linked to these tasks, e.g. ones you delegated." })),
+  recipients: Type.Optional(Type.Array(id, { minItems: 1, maxItems: 100, uniqueItems: true, description: "Exact teammate names or member IDs." })),
+  summary: Type.Optional(Type.String({ minLength: 1, maxLength: 16000, description: "Send: delivered directly to recipients. Start with the point (the first line is the one people see) and what it changes; complete enough to act on." })),
+  detail: Type.Optional(Type.String({ minLength: 1, maxLength: 16000, description: "Send: optional supporting detail, read only when needed." })),
+  task: Type.Optional(Type.String({ minLength: 1, maxLength: 128, description: "Send: link an existing task; its owner and delegator receive the post." })),
+  replyTo: Type.Optional(Type.String({ minLength: 1, maxLength: 128, description: "Send: the post ID this answers; its author receives the reply and it stays on that post's task." })),
+  query: Type.Optional(Type.String({ minLength: 1, maxLength: 500 })),
   after: Type.Optional(Type.Integer({ minimum: 0 })), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
 }, { additionalProperties: false });
 const UserActionSchema = Type.Object({
@@ -67,6 +75,7 @@ export function validate(operation: string, value: unknown): void {
     const args = value as { action: string; name?: string };
     if (args.action === "launch" && !args.name) throw new Error("A descriptive teammate name is required on launch");
     if (args.action !== "launch" && args.name !== undefined) throw new Error("A teammate name can only be set on launch");
+    if (args.action !== "launch" && (value as { task?: unknown }).task !== undefined) throw new Error("A task can only be assigned on launch");
     if (args.action !== "launch" && (value as { access?: unknown }).access !== undefined) throw new Error("Access can only be set on launch; resume keeps the member's access");
   }
 }

package/src/store.ts

@@ -4,7 +4,7 @@ import { randomUUID } from "node:crypto";
 import { stateRoot } from "./config.ts";
 import { validatePolicy } from "./egress.ts";
 import { stripVTControlCharacters } from "node:util";
-import { isDescendant, isLive, isMain, memberName, memberNamePattern, memberNameMaxLength, taskLabelMaxLength, taskLabelPattern } from "./types.ts";
+import { isDescendant, isMain, memberName, memberNamePattern, memberNameMaxLength, taskLabelMaxLength, taskLabelPattern } from "./types.ts";
 import type { TeamState, TaskArgs, MessageArgs, Task, TaskView, Message, Worktree } from "./types.ts";
 
 // UI envelopes add task context after the public 16,000-character input limit.
@@ -58,7 +58,15 @@ function taskLabel(title: string): string {
 }
 
 function migrate(state: unknown): boolean {
-  if (!object(state) || ![1, 2, 3].includes(state.version as number)) return false;
+  if (!object(state) || ![1, 2, 3, 4].includes(state.version as number)) return false;
+  if (state.version !== 4) migrateRoles(state);
+  // Schema 5: a post's former text becomes its summary, unchanged.
+  requireValue(Array.isArray(state.messages), "Invalid legacy messages");
+  for (const message of state.messages) if (object(message) && Object.hasOwn(message, "text")) { message.summary = message.text; delete message.text; }
+  state.version = 5;
+  return true;
+}
+function migrateRoles(state: Record<string, unknown>): void {
   if (state.version !== 3) migrateTasks(state);
   // Schema 4: roles replace the special root ID; the creator's record becomes a main session.
   const root = state.root ?? "root";
@@ -67,7 +75,6 @@ function migrate(state: unknown): boolean {
   delete state.root;
   state.key = randomUUID();
   state.version = 4;
-  return true;
 }
 function migrateTasks(state: Record<string, unknown>): void {
   requireValue(object(state.tasks), "Invalid legacy state tasks");
@@ -89,7 +96,7 @@ function migrateTasks(state: Record<string, unknown>): void {
 function validate(state: unknown): asserts state is TeamState {
   requireValue(object(state), "Invalid state snapshot");
   id(state.id);
-  requireValue(state.version === 4 && text(state.key) && integer(state.limit, 1) && integer(state.depth) && object(state.members) && object(state.tasks) && Array.isArray(state.messages), "Invalid state snapshot schema");
+  requireValue(state.version === 5 && text(state.key) && integer(state.limit, 1) && integer(state.depth) && object(state.members) && object(state.tasks) && Array.isArray(state.messages), "Invalid state snapshot schema");
   const members = state.members;
   const names = new Set<string>(["main", "root", ...Object.keys(members)]);
   for (const [key, member] of Object.entries(members)) {
@@ -108,6 +115,7 @@ function validate(state: unknown): asserts state is TeamState {
     requireValue(member.role !== "main" || member.parent === undefined, "A main session has no parent");
     requireValue(member.handover === undefined || ["busy", "idle", "input"].includes(String(member.handover)), "Invalid member handover state");
     requireValue(member.promotion === undefined || (object(member.promotion) && ["stopped", "moved", "role", "entry"].includes(String(member.promotion.step)) && text(member.promotion.sessionFile)), "Invalid member promotion");
+    requireValue(member.waiting === undefined || (object(member.waiting) && Array.isArray(member.waiting.tasks) && member.waiting.tasks.every(task => typeof task === "string" && Object.hasOwn(state.tasks as object, task))), "Invalid member wait");
     requireValue(member.terminal === undefined || typeof member.terminal === "boolean", "Invalid member terminal flag");
     requireValue(member.needsInput === undefined || typeof member.needsInput === "boolean", "Invalid member input flag");
     requireValue(member.pid === undefined || integer(member.pid, 1), "Invalid member PID");
@@ -132,7 +140,8 @@ function validate(state: unknown): asserts state is TeamState {
     requireValue(task.completedAt === undefined || integer(task.completedAt), "Invalid task completion time");
     requireValue(task.dependencies.every(dep => typeof dep === "string" && dep !== key && Object.hasOwn(tasks, dep)) && new Set(task.dependencies).size === task.dependencies.length, "Invalid task dependencies");
     requireValue(task.owner === undefined || (typeof task.owner === "string" && Object.hasOwn(members, task.owner)), "Invalid task owner");
-    requireValue(task.creator === undefined || (typeof task.creator === "string" && Object.hasOwn(members, task.creator)), "Invalid task creator");
+    requireValue([task.creator, task.delegator].every(member => member === undefined || (typeof member === "string" && Object.hasOwn(members, member))), "Invalid task creator or delegator");
+    requireValue(task.outcome === undefined || (task.status === "done" && state.messages.some(message => object(message) && message.id === task.outcome && message.task === key)), "Invalid task outcome");
     requireValue(task.status !== "in_progress" || task.owner !== undefined, "In-progress task requires an owner");
     requireValue(task.status === "todo" || task.dependencies.every(dep => (tasks[dep] as Record<string, unknown>).status === "done"), "Active or done task has unfinished dependencies");
     edges[key] = task.dependencies;
@@ -150,11 +159,44 @@ function validate(state: unknown): asserts state is TeamState {
   let last = 0;
   const messageIds = new Set<string>();
   for (const message of state.messages) {
-    requireValue(object(message) && integer(message.seq, last + 1) && text(message.id) && !messageIds.has(message.id) && typeof message.from === "string" && Object.hasOwn(members, message.from) && Array.isArray(message.recipients) && message.recipients.every(recipient => typeof recipient === "string" && Object.hasOwn(members, recipient)) && new Set(message.recipients).size === message.recipients.length && text(message.text, maxMessageText) && typeof message.time === "string" && Number.isFinite(Date.parse(message.time)), "Invalid state message");
+    requireValue(object(message) && integer(message.seq, last + 1) && text(message.id) && !messageIds.has(message.id) && typeof message.from === "string" && Object.hasOwn(members, message.from) && Array.isArray(message.recipients) && message.recipients.every(recipient => typeof recipient === "string" && Object.hasOwn(members, recipient)) && new Set(message.recipients).size === message.recipients.length && text(message.summary, maxMessageText) && typeof message.time === "string" && Number.isFinite(Date.parse(message.time)), "Invalid state message");
+    requireValue((message.detail === undefined || text(message.detail)) && (message.task === undefined || (typeof message.task === "string" && Object.hasOwn(tasks, message.task))) && (message.replyTo === undefined || (typeof message.replyTo === "string" && messageIds.has(message.replyTo))) && (message.kind === undefined || (message.kind === "outcome" && message.task !== undefined)), "Invalid message detail or link");
     last = message.seq; messageIds.add(message.id);
   }
 }
 
+/**
+ * Appends a post. Attention goes to explicit recipients, the linked task's owner and delegator (else creator),
+ * and the replied-to post's author; never the sender, and never an implicit broadcast.
+ */
+function post(state: TeamState, actor: string, args: Pick<MessageArgs, "recipients" | "summary" | "detail" | "task" | "replyTo">, user = false): Message {
+  // A user's request is authored in a session but addressed to that session's own model.
+  const limit = user ? maxMessageText : 16000;
+  requireValue(text(args.summary, limit), `A post needs a nonempty summary of at most ${limit} characters`);
+  requireValue(args.detail === undefined || text(args.detail), "Detail must be nonempty and at most 16000 characters");
+  const original = args.replyTo === undefined ? undefined : state.messages.find(message => message.id === args.replyTo);
+  requireValue(args.replyTo === undefined || original, "Unknown post to reply to");
+  requireValue(!args.task || !original?.task || args.task === original.task, "A reply stays on the replied-to post's task");
+  const taskId = args.task ?? original?.task;
+  const task = taskId === undefined ? undefined : state.tasks[taskId];
+  requireValue(taskId === undefined || task, "Unknown task");
+  requireValue(args.recipients === undefined || Array.isArray(args.recipients), "Recipients must be unique known member names or IDs");
+  const members = Object.values(state.members);
+  // Names resolve to durable IDs; a stopped member still receives its post on resume.
+  const explicit = (args.recipients ?? []).map(recipient => typeof recipient === "string" ? members.find(member => member.id === recipient || member.name === recipient)?.id : undefined);
+  requireValue(new Set(explicit).size === explicit.length && explicit.every((recipient): recipient is string => recipient !== undefined), "Recipients must be unique known member names or IDs");
+  requireValue(explicit.length > 0 || task || original, "Name recipients, a task, or a post to reply to; posts are never broadcast");
+  const waiters = taskId === undefined ? [] : Object.values(state.members).filter(member => member.waiting?.tasks.includes(taskId)).map(member => member.id);
+  const routed = [...explicit, task?.owner, task?.delegator ?? task?.creator, original?.from, ...waiters];
+  const recipients = [...new Set(routed.filter((id): id is string => !!id && (id !== actor || (user && explicit.includes(id)))))];
+  const message: Message = { seq: (state.messages.at(-1)?.seq ?? 0) + 1, id: randomUUID(), from: actor, recipients, summary: args.summary, time: new Date().toISOString() };
+  if (args.detail !== undefined) message.detail = args.detail;
+  if (taskId !== undefined) message.task = taskId;
+  if (original) message.replyTo = original.id;
+  state.messages.push(message);
+  return message;
+}
+
 // Check every component rather than following a symlink into another home.
 function ensureHome(path: string): void {
   const parent = dirname(path);
@@ -183,6 +225,11 @@ export function readState(dir: string): TeamState {
   } finally { closeSync(fd); }
 }
 
+/** Display names for members and tasks; their IDs are distinct UUIDs, so one map names both. */
+export function stateLabels(state: TeamState): Record<string, string> {
+  return Object.fromEntries([...Object.values(state.members).map(member => [member.id, memberName(member)]), ...Object.values(state.tasks).map(task => [task.id, `#${task.number} ${task.title}`])]);
+}
+
 /** Cache only display names, not histories; atomic snapshot replacements invalidate the cache. */
 export function createMemberLabels(): (dir: string) => Record<string, string> {
   let key: string | undefined, labels: Record<string, string>;
@@ -190,7 +237,7 @@ export function createMemberLabels(): (dir: string) => Record<string, string> {
     const file = join(dir, "state.json"), stat = lstatSync(file, { bigint: true });
     const next = `${file}:${stat.dev}:${stat.ino}:${stat.mtimeNs}:${stat.size}:${stat.mode}:${stat.uid}:${stat.nlink}`;
     if (next !== key) {
-      labels = Object.fromEntries(Object.values(readState(dir).members).map(member => [member.id, memberName(member)]));
+      labels = stateLabels(readState(dir));
       key = next;
     }
     return labels;
@@ -325,6 +372,12 @@ export class Store {
       }
       requireValue(args.id && Object.hasOwn(state.tasks, args.id), "Unknown task");
       const task = state.tasks[args.id];
+      if (args.action === "complete" && task.outcome) {
+        // A retried completion returns the original; a different outcome is a conflict, not a second post.
+        const published = state.messages.find(message => message.id === task.outcome)!;
+        requireValue(published.from === actor && published.summary === args.summary && published.detail === args.detail, "Task is already done with a different outcome; reopen it before completing again");
+        return taskView(state, task);
+      }
       requireValue(args.revision === undefined || (integer(args.revision) && args.revision === task.revision), "Stale or invalid task revision; read the task before retrying");
       if (args.action === "edit") {
         requireValue(task.status === "todo", "Only to-do tasks can be edited");
@@ -348,6 +401,10 @@ export class Store {
         requireValue(task.owner === actor, "Only the owner can complete this task");
         requireValue(task.status === "in_progress", "Only in-progress tasks can be completed; start it first");
         requireValue(args.acceptance === true, "Completion requires acceptance=true after checking acceptance criteria");
+        requireValue(text(args.summary), "Completion requires an outcome summary: what was done, how it was checked, and any caveats");
+        const outcome = post(state, actor, { summary: args.summary, detail: args.detail, task: task.id });
+        outcome.kind = "outcome";
+        task.outcome = outcome.id;
         task.status = "done";
         task.completedAt = Date.now();
       } else if (args.action === "release") {
@@ -362,7 +419,7 @@ export class Store {
         const dependents = Object.values(state.tasks).filter(other => other.dependencies.includes(task.id) && other.status !== "todo");
         requireValue(dependents.length === 0, `Cannot reopen task with active or done dependents: ${dependents.map(t => t.id).join(", ")}`);
         task.status = "todo";
-        delete task.completedAt;
+        delete task.completedAt; delete task.outcome;
       } else throw new Error("Unknown task action");
       task.revision++;
       return taskView(state, task);
@@ -371,17 +428,16 @@ export class Store {
 
   message(actor: string, args: MessageArgs, enveloped = false): Message | Message[] {
     requireValue(!this.closed && Object.hasOwn(this.state.members, actor), "Unknown actor or closed store");
-    if (args.action === "send") return this.update(state => {
-      const limit = enveloped ? maxMessageText : 16000;
-      requireValue(text(args.text, limit), `Message text must be nonempty and at most ${limit} characters`);
-      const members = Object.values(state.members);
-      requireValue(args.recipients === undefined || Array.isArray(args.recipients), "Recipients must be unique live member names or IDs");
-      const recipients = args.recipients === undefined ? members.filter(member => member.id !== actor && isLive(member)).map(member => member.id)
-        : args.recipients.map(recipient => typeof recipient === "string" ? members.find(member => member.id === recipient || member.name === recipient)?.id : undefined);
-      requireValue((args.recipients === undefined || recipients.length > 0) && new Set(recipients).size === recipients.length && recipients.every((recipient): recipient is string => recipient !== undefined && isLive(state.members[recipient])), "Recipients must be unique live member names or IDs");
-      const message = { seq: (state.messages.at(-1)?.seq ?? 0) + 1, id: randomUUID(), from: actor, recipients: [...recipients], text: args.text, time: new Date().toISOString() };
-      state.messages.push(message);
-      return structuredClone(message);
+    if (args.action === "send") return this.update(state => structuredClone(post(state, actor, args, enveloped)));
+    if (args.action === "wait") return this.update(state => {
+      const tasks = args.tasks ?? [];
+      requireValue(Array.isArray(tasks) && tasks.length <= 100 && tasks.every(task => Object.hasOwn(state.tasks, task)), "Wait tasks must be existing task IDs");
+      // Register and recheck in one mutation, so a post committed after the caller last looked still wakes it.
+      const after = args.after ?? state.members[actor].notified;
+      const ready = state.messages.filter(message => message.seq > after && (message.recipients.includes(actor) || (message.task !== undefined && tasks.includes(message.task))));
+      if (ready.length) delete state.members[actor].waiting;
+      else state.members[actor].waiting = { tasks: [...new Set(tasks)] };
+      return structuredClone(ready);
     });
     requireValue(args.action === "history" || args.action === "search", "Unknown message action");
     const after = args.after ?? 0, limit = args.limit ?? 20;
@@ -389,7 +445,7 @@ export class Store {
     if (args.action === "search") requireValue(text(args.query, 500), "Search requires a nonempty query (max 500)");
     const results = [];
     for (const message of this.state.messages) {
-      if (message.seq > after && (args.action !== "search" || message.text.includes(args.query!))) results.push(message);
+      if (message.seq > after && (args.action !== "search" || (message.summary.includes(args.query!) || !!message.detail?.includes(args.query!)))) results.push(message);
       if (results.length === limit) break;
     }
     return structuredClone(results);