Python
Drill-round polish: calm rail, digest diet, gate replies, criteria clamp, composer fix
Rohit C Prasadb2418d5a3025
diff --git a/coworker/personas/builtin/swe-lead/manifest.md b/coworker/personas/builtin/swe-lead/manifest.mdindex 40ba0554..b1ce0616 100644--- a/coworker/personas/builtin/swe-lead/manifest.md+++ b/coworker/personas/builtin/swe-lead/manifest.md@@ -17,10 +17,16 @@ NOT implement — you carry no shell or git on purpose. The board is the sharedtruth; your context window is disposable, the board is not.How you run a piece of work:-1. UNDERSTAND: read enough of the repo (files, search) to decompose honestly.+1. UNDERSTAND: read enough of the repo (files, search) to decompose honestly. The+ board is per-PROJECT and outlives sessions — before proposing anything, read it+ (list_items) and triage leftovers from earlier efforts: reassign or cancel stale+ in-progress items, never stack duplicates of existing open ones.2. PLAN: split the work into items with crisp acceptance criteria — "Done when:" that averifier can actually check. Acceptance criteria are the single biggest quality lever- you own; vague criteria produce vague work. Present the decomposition with+ you own; vague criteria produce vague work. Criteria are 1–3 SHORT, independently+ checkable statements — mechanics (setup commands, file paths, how-to) belong in the+ item's description, never in the criteria; a verifier can pass/fail three checks,+ it cannot pass/fail an essay. Present the decomposition withpropose_work_items (works in any mode; approval creates the items on the board andreturns their ids) and revise until the user approves. Use create_item only forone-off additions after the plan is approved.diff --git a/coworker/personas/builtin/swe-worker/manifest.md b/coworker/personas/builtin/swe-worker/manifest.mdindex f3860ff0..da65a8df 100644--- a/coworker/personas/builtin/swe-worker/manifest.md+++ b/coworker/personas/builtin/swe-worker/manifest.md@@ -31,8 +31,10 @@ The team contract (this is how you work):- Discover a bug or follow-up outside your item's scope? File it (create_item) withreal acceptance criteria and keep moving. The lead triages it.- Finish = transition to review with a hand-off comment: what you did, how you- verified it, refs (branch, files). You NEVER mark your own work done — done is the- verdict after verification.+ verified it, refs (branch, files). Keep the hand-off TIGHT — a short paragraph+ plus refs; full evidence and long output belong in the journal, not the comment+ (long comments get clamped in wake digests anyway). You NEVER mark your own work+ done — done is the verdict after verification.- Steering arrives attributed [Lead] or [User]; [User] outranks [Lead].- House rules hold: no silent skips — if you couldn't do part of the work, thehand-off comment says which part and why.diff --git a/coworker/server/manager.py b/coworker/server/manager.pyindex 7c6ba258..3bad327e 100644--- a/coworker/server/manager.py+++ b/coworker/server/manager.py@@ -1955,9 +1955,9 @@ class SessionManager:if not self.teams.count_wake(team.team_id, cap=self.TEAM_WAKE_CAP_PER_HOUR):logger.warning("team %s paused for budget this hour", team.team_id)return 0- message = self._team_digest(team, directs, subs, chats, is_lead=is_lead)+ message, rows = self._team_digest(team, directs, subs, chats, is_lead=is_lead)self._team_inflight.add(session_id)- source = self._board_source(team, message)+ source = self._board_source(team, message, rows=rows)async def _deliver() -> None:try:@@ -1980,6 +1980,21 @@ class SessionManager:asyncio.create_task(_deliver())return 1+ # Long comment/hand-off bodies are already durable on the board — the wake+ # message's job is to say what needs DECISIONS, not to re-carry the evidence+ # into the recipient's context on every wake (owner ruling 2026-08-16). The+ # model text clamps hard; the UI sidecar rows clamp softer (the human gets a+ # bigger excerpt on click without re-inflating the lead's prompt).+ DIGEST_CLAMP_MODEL = 300+ DIGEST_CLAMP_UI = 600++ @staticmethod+ def _clamp(text: str, limit: int, *, suffix: str = "…") -> str:+ text = (text or "").strip()+ if len(text) <= limit:+ return text+ return text[:limit].rstrip() + suffix+def _team_digest(self,team,@@ -1988,10 +2003,16 @@ class SessionManager:chats: Optional[list[dict]] = None,*,is_lead: bool,- ) -> str:+ ) -> tuple[str, list[dict]]:"""Coalesce one queue batch into one wake message. Deterministic, computed- by code — the model does judgment, not arithmetic."""+ by code — the model does judgment, not arithmetic. Returns (model text,+ structured rows) — the rows ride the display sidecar so the GUI renders a+ collapsed BoardWakeCard instead of re-parsing prose."""+ clamp = lambda text: self._clamp( # noqa: E731 — two-site local shorthand+ text, self.DIGEST_CLAMP_MODEL, suffix=" … (full text on the board)"+ )lines: list[str] = []+ rows: list[dict] = []for event in directs + subs:item_id = event.get("item_id")payload = event.get("payload") or {}@@ -2002,6 +2023,11 @@ class SessionManager:except Exception:item = Nonetitle = f"#{item_id} {item['title']}" if item else f"#{item_id}"+ row = {+ "item": item_id,+ "title": item["title"] if item else "",+ "actor": event.get("actor", ""),+ }if event["kind"] == "item_assigned":if item is None:continue@@ -2012,15 +2038,18 @@ class SessionManager:f"{event['actor']} claimed {title} — it's theirs now;"" reassign or cancel if that's wrong.")+ rows.append({**row, "kind": "claimed"})continuelines.append(f"You've been assigned work item {title}.\n"f" Done when: {item['criteria']}"+ (f"\n Details: {item['description']}" if item["description"] else ""))+ rows.append({**row, "kind": "assigned"})elif event["kind"] == "item_transitioned":to = payload.get("to", "?")- note = f" — “{payload.get('comment')}”" if payload.get("comment") else ""+ comment = clamp(payload.get("comment") or "")+ note = f" — “{comment}”" if comment else ""if to == "canceled" and not is_lead:lines.append(f"{title} was CANCELED by {event['actor']}{note} — stop any"@@ -2028,32 +2057,63 @@ class SessionManager:)else:lines.append(f"{title} moved to {to} by {event['actor']}{note}")+ rows.append(+ {+ **row,+ "kind": "moved",+ "to": to,+ "note": self._clamp(+ payload.get("comment") or "", self.DIGEST_CLAMP_UI+ ),+ }+ )elif event["kind"] == "item_created":lines.append(f"New item filed by {event['actor']}: {title}")+ rows.append({**row, "kind": "filed"})elif event["kind"] == "item_commented":lines.append(- f"Comment on {title} by {event['actor']}: {payload.get('body', '')}"+ f"Comment on {title} by {event['actor']}:"+ f" {clamp(payload.get('body', ''))}"+ )+ rows.append(+ {+ **row,+ "kind": "comment",+ "note": self._clamp(+ payload.get("body") or "", self.DIGEST_CLAMP_UI+ ),+ })for chat in chats or []:who = chat["author"] if chat["author_role"] != "user" else "[User]"- lines.append(f"# team chat — {who}: {chat['text']}")+ lines.append(f"# team chat — {who}: {clamp(chat['text'])}")+ rows.append(+ {+ "kind": "chat",+ "actor": who,+ "note": self._clamp(chat["text"], self.DIGEST_CLAMP_UI),+ }+ )body = "\n".join(f"- {line}" for line in lines) or "- (no detail)"if is_lead:- return (+ message = ("⏰ Board wake — your team needs decisions:\n"+ body- + "\n\nVerify review items against their acceptance criteria (then"+ + "\n\nFull hand-off comments live on the board (get_item)."+ " Verify review items against their acceptance criteria (then"" done, or send back with a comment), unblock or reassign blocked"" items, and triage new filings. Steer only where needed.")- return (- "[Lead] Board update:\n"- + body- + self._roster_note(team)- + "\n\nMove your item to in_progress when you start; blocked (with a"- " comment) if stuck; review with a hand-off comment when finished."- " Journal evidence as you go."- )+ else:+ message = (+ "[Lead] Board update:\n"+ + body+ + self._roster_note(team)+ + "\n\nMove your item to in_progress when you start; blocked (with a"+ " comment) if stuck; review with a hand-off comment when finished."+ " Journal evidence as you go."+ )+ return message, rows@staticmethoddef _roster_note(team) -> str:@@ -2074,11 +2134,15 @@ class SessionManager:return f"\n\nYour team: {mates}; lead (coordinator).{reach}"@staticmethod- def _board_source(team, message: str) -> dict[str, Any]:+ def _board_source(+ team, message: str, *, rows: Optional[list[dict]] = None+ ) -> dict[str, Any]:"""Display-only MessageSource sidecar for board deliveries — the samemechanism connector messages use, so the GUI renders a structured cardinstead of a fake user bubble (owner ask 2026-08-16). The framed message- stays the model-facing text; this only shapes presentation."""+ stays the model-facing text; this only shapes presentation. `rows` are+ the digest's structured events — the BoardWakeCard renders those+ (collapsed to one line by default) instead of re-parsing the prose."""return {"connector": "board","kind": "channel",@@ -2088,6 +2152,7 @@ class SessionManager:"sender_name": "Board","ts": time.time(),"text": message,+ "board": {"rows": rows or []},}def team_staleness_digest(self, session_id: str) -> str:diff --git a/surfaces/gui/e2e/board.spec.ts b/surfaces/gui/e2e/board.spec.tsindex 1ac8f1e7..6f0dfc16 100644--- a/surfaces/gui/e2e/board.spec.ts+++ b/surfaces/gui/e2e/board.spec.ts@@ -61,6 +61,26 @@ test("expand opens the overlay board; the user verifies review items and removesawait expect(page.getByTestId("board-overlay")).toHaveCount(0);});+test("finished items leave the rail; a quiet toggle reveals them", async ({ page }) => {+ await planTheWork(page);+ const rail = page.getByTestId("board-rail");+ await expect(rail.getByText("Report rollup")).toBeVisible(); // review = active+ await page.getByTestId("board-expand").click();+ await page+ .getByTestId("board-col-review")+ .getByRole("button", { name: "Mark done" })+ .click();+ await page.keyboard.press("Escape");+ // done vanishes from the rail — a fresh session on an old board starts calm+ await expect(rail.getByText("Report rollup")).toHaveCount(0);+ const toggle = page.getByTestId("board-finished-toggle");+ await expect(toggle).toHaveText("1 finished · show");+ await toggle.click();+ await expect(rail.getByText("Report rollup")).toBeVisible();+ await toggle.click();+ await expect(rail.getByText("Report rollup")).toHaveCount(0);+});+test("journal section lists cases once a board exists", async ({ page }) => {await planTheWork(page);await page.getByRole("button", { name: /Journal/ }).click();diff --git a/surfaces/gui/e2e/fixtures.ts b/surfaces/gui/e2e/fixtures.tsindex 1811ca31..1b45d5f2 100644--- a/surfaces/gui/e2e/fixtures.ts+++ b/surfaces/gui/e2e/fixtures.ts@@ -642,10 +642,42 @@ export async function mockApi(page: import("@playwright/test").Page) {}// Agent teams: the decomposition gate — the lead proposes work items and// SUSPENDS until the items_response verdict arrives (approval creates them).+ // A board wake arriving on this session: the digest rides `source` with+ // structured rows — the BoardWakeCard renders collapsed by default.+ if (/board wake/i.test(msg.text)) {+ send("turn_start", {+ source: {+ connector: "board",+ kind: "channel",+ channel_id: "/Users/test/OpenWorker/launch-note",+ channel_name: "Team board",+ sender_id: "board",+ sender_name: "Board",+ ts: Date.now() / 1000,+ text: "⏰ Board wake — your team needs decisions:\n- #2 moved to review by webb",+ board: {+ rows: [+ {+ kind: "moved",+ item: 2,+ title: "Statements page",+ actor: "webb",+ to: "review",+ note: "Ready for review on feat/customer-statements, commit 029f9f7. Build verified; final verdict stays with the tester.",+ },+ { kind: "filed", item: 5, title: "Follow-up: rate limit", actor: "nia" },+ ],+ },+ },+ });+ send("assistant_message", { text: "Reviewing the hand-off now." });+ send("turn_done");+ return;+ }if (/propose the split/i.test(msg.text)) {send("items_proposed", {items: [- { title: "Statement API endpoint", criteria: "returns opening/closing balances; 8 endpoint tests green" },+ { title: "Statement API endpoint", criteria: "returns opening/closing balances over the chosen range; 8 endpoint tests green; malformed, missing, and reversed date ranges return 400; draft invoices are excluded from issued totals; inclusive boundaries verified end to end" },{ title: "Statements dashboard page", criteria: "renders seeded data for Ada / Northgate; empty + error states covered" },{ title: "Statement totals reconcile", criteria: "running balance matches invoices minus payments for the range" },{ title: "Verification pass", criteria: "tester confirms page renders with live API data" },diff --git a/surfaces/gui/e2e/team.spec.ts b/surfaces/gui/e2e/team.spec.tsindex b3d311d0..18efa244 100644--- a/surfaces/gui/e2e/team.spec.ts+++ b/surfaces/gui/e2e/team.spec.ts@@ -27,11 +27,59 @@ test("the decomposition gate shows items with criteria; approval lands them on tawait card.getByRole("button", { name: /1 more item/ }).click();await expect(card.getByText("Verification pass")).toBeVisible();+ // essay-length criteria clamp behind a per-item expander (owner-hit 2026-08-16)+ const acToggle = page.getByTestId("itemsreq-ac-toggle-0");+ await expect(acToggle).toHaveText("Show full criteria");+ await acToggle.click();+ await expect(acToggle).toHaveText("Show less");+ // the short-criteria items get no toggle+ await expect(page.getByTestId("itemsreq-ac-toggle-1")).toHaveCount(0);+await page.getByTestId("itemsreq-approve").click();await expect(page.getByText(/Items created on the board/)).toBeVisible();await expect(page.getByTestId("board-rail")).toBeVisible();});+test("typing while a gate is pending sends the reply as feedback to the lead", async ({+ page,+}) => {+ await proposeTeam(page);+ // the composer re-opens for a typed answer instead of hard-blocking on "running"+ const box = page.getByPlaceholder(/Reply to adjust the proposal/);+ await box.fill("use openai:gpt-5.6-sol for all the workers");+ await page.getByRole("button", { name: "Send" }).click();+ // the reply lands as a user message AND resolves the gate as decline-with-feedback+ await expect(+ page.getByText("use openai:gpt-5.6-sol for all the workers"),+ ).toBeVisible();+ await expect(page.getByText(/tell me how to change the roster/)).toBeVisible();+ await expect(page.getByTestId("teamreq-card")).toHaveCount(0);+});++test("a board wake renders collapsed; expanding reveals rows, hand-offs stay one more click away", async ({+ page,+}) => {+ await page.goto("/");+ await page.getByPlaceholder(/Ask the coworker/).fill("board wake");+ await page.getByRole("button", { name: "Send" }).click();+ const card = page.getByTestId("boardwake-card");+ await expect(card).toBeVisible();+ await expect(card).toContainText("Board wake");+ await expect(card).toContainText("1 review, 1 filing");+ // collapsed by default: ambient awareness, not reading assignment+ await expect(page.getByTestId("boardwake-body")).toHaveCount(0);+ await expect(card).not.toContainText("029f9f7");+ await page.getByTestId("boardwake-toggle").click();+ const body = page.getByTestId("boardwake-body");+ await expect(body).toBeVisible();+ await expect(body).toContainText("#2 Statements page → review by webb");+ await expect(body).toContainText("nia filed #5 Follow-up: rate limit");+ // the hand-off comment sits behind its own per-row toggle+ await expect(body).not.toContainText("029f9f7");+ await body.getByRole("button", { name: "show hand-off" }).click();+ await expect(body).toContainText("029f9f7");+});+test("declining the split returns feedback to the lead", async ({ page }) => {await page.goto("/");await page.getByPlaceholder(/Ask the coworker/).fill("propose the split");diff --git a/surfaces/gui/src/App.tsx b/surfaces/gui/src/App.tsxindex f7df71d0..ec3f44f4 100644--- a/surfaces/gui/src/App.tsx+++ b/surfaces/gui/src/App.tsx@@ -1020,6 +1020,24 @@ export function App() {setSendGate({ text, attachments, skill });return;}+ // A typed message while a proposal gate is pending IS the answer: it resolves+ // the gate as decline-with-feedback, so "use gpt-5.6-sol for all workers"+ // reaches the lead instead of bouncing off a blocked composer (owner-hit+ // 2026-08-16). The card buttons stay the approve/plain-decline paths.+ if (!unattended && pendingTeam?.kind === "teamreq" && !pendingTeam.resolved) {+ setItems((p) => [...p, { kind: "user", text, ts: Date.now() / 1000 }]);+ respondTeam(false, text);+ return;+ }+ if (+ !unattended &&+ pendingItemsReq?.kind === "itemsreq" &&+ !pendingItemsReq.resolved+ ) {+ setItems((p) => [...p, { kind: "user", text, ts: Date.now() / 1000 }]);+ respondItemsReq(false, text);+ return;+ }// Force-run shows exactly what the user typed: "/name rest". Must match the server's// `display` sidecar formula so the turn_start dedupe recognizes the local echo.const shown = skill ? `/${skill}${text ? ` ${text}` : ""}` : text;@@ -1952,6 +1970,7 @@ export function App() {models={models}modelLabels={modelLabels}running={running}+ gateOpen={!unattended && (!!pendingTeam || !!pendingItemsReq)}connected={connected}modelReady={modelReady}onConnectModel={openModelSetup}diff --git a/surfaces/gui/src/api.ts b/surfaces/gui/src/api.tsindex 83baa7bb..5a684aa0 100644--- a/surfaces/gui/src/api.ts+++ b/surfaces/gui/src/api.ts@@ -162,6 +162,20 @@ export interface MessageSource {sender_name: string; // resolved; may equal the idts: number; // epoch secondstext: string; // the RAW message (what the card shows)+ // Board wakes only (connector === "board"): the digest as structured rows, so+ // the BoardWakeCard renders collapsed summaries instead of re-parsing prose.+ board?: { rows: BoardWakeRow[] };+}++// One digest event on a board wake. `note` is a UI-clamped excerpt of a hand-off+// comment (the full text lives on the board).+export interface BoardWakeRow {+ kind: "assigned" | "claimed" | "moved" | "filed" | "comment" | "chat" | string;+ item?: number | null;+ title?: string;+ actor?: string;+ to?: string;+ note?: string;}// A transcript message from GET /v1/sessions/{id}/messages. Kept permissive (open shape) becausediff --git a/surfaces/gui/src/components/BoardPanel.tsx b/surfaces/gui/src/components/BoardPanel.tsxindex c8048366..cb4174c5 100644--- a/surfaces/gui/src/components/BoardPanel.tsx+++ b/surfaces/gui/src/components/BoardPanel.tsx@@ -5,7 +5,7 @@// endpoints and act as the USER. There is NO proposed/draft state: a plan// proposal lives in the conversation (plan-approval flow); the board only ever// contains accepted work, and work starts at ASSIGNMENT.-import { useEffect } from "react";+import { useEffect, useState } from "react";import type { Board, BoardItem } from "../api";import { Icon } from "./Icon";@@ -39,12 +39,30 @@ export function boardSummary(board: Board): string {}export function BoardSection({ board, onExpand }: { board: Board; onExpand: () => void }) {- const groups = GROUPS.map((g) => ({- ...g,- items: board.items.filter((i) => i.state === g.state),- })).filter((g) => g.items.length > 0);+ // The rail shows ACTIVE work only (owner ruling 2026-08-16): a project board+ // outlives its sessions, so finished history from a past effort would greet+ // every fresh session as a long stale list. Done/canceled sit behind a quiet+ // count; the expanded overlay keeps the full picture.+ const [showFinished, setShowFinished] = useState(false);+ const finished = board.items.filter(+ (i) => i.state === "done" || i.state === "canceled"+ ).length;+ const shown = showFinished+ ? GROUPS+ : GROUPS.filter((g) => g.state !== "done" && g.state !== "canceled");+ const groups = shown+ .map((g) => ({+ ...g,+ items: board.items.filter((i) => i.state === g.state),+ }))+ .filter((g) => g.items.length > 0);return (<div className="board-rail" data-testid="board-rail">+ {groups.length === 0 && (+ <div className="board-rail-quiet" data-testid="board-rail-quiet">+ No active work+ </div>+ )}{groups.map((group) => (<div key={group.state}><div className="board-group">{group.label}</div>@@ -61,6 +79,15 @@ export function BoardSection({ board, onExpand }: { board: Board; onExpand: () =))}</div>))}+ {finished > 0 && (+ <button+ className="board-finished-toggle"+ data-testid="board-finished-toggle"+ onClick={() => setShowFinished((v) => !v)}+ >+ {showFinished ? "Hide finished" : `${finished} finished · show`}+ </button>+ )}</div>);}diff --git a/surfaces/gui/src/components/BoardWakeCard.tsx b/surfaces/gui/src/components/BoardWakeCard.tsxnew file mode 100644index 00000000..688545f6--- /dev/null+++ b/surfaces/gui/src/components/BoardWakeCard.tsx@@ -0,0 +1,116 @@+// BoardWakeCard — a board wake in the lead's transcript, collapsed to ONE line by+// default (owner ruling 2026-08-16): most of the time the user just wants the+// feel that something is happening. Click to expand into per-event rows; long+// hand-off comments hide behind a per-row "show hand-off". NOT the connector+// card: a connector message is a foreign message, a board wake is a report —+// different shape, different affordances (they only share the visual family).+import { useState } from "react";+import type { BoardWakeRow, MessageSource } from "../api";+import { Icon } from "./Icon";++function summarize(rows: BoardWakeRow[]): { text: string; attention: boolean } {+ const counts: Record<string, number> = {};+ const bump = (key: string) => (counts[key] = (counts[key] || 0) + 1);+ for (const row of rows) {+ if (row.kind === "moved" && row.to === "review") bump("review");+ else if (row.kind === "moved" && row.to === "blocked") bump("blocked");+ else if (row.kind === "moved" && row.to === "canceled") bump("canceled");+ else if (row.kind === "moved") bump("move");+ else if (row.kind === "filed") bump("filing");+ else if (row.kind === "claimed") bump("claim");+ else if (row.kind === "assigned") bump("assignment");+ else if (row.kind === "comment") bump("comment");+ else if (row.kind === "chat") bump("chat message");+ }+ const parts = Object.entries(counts).map(+ ([label, n]) => `${n} ${label}${n === 1 ? "" : "s"}`+ );+ // reviews/blocked demand a decision — those tint the collapsed line amber+ const attention = (counts.review || 0) + (counts.blocked || 0) > 0;+ return { text: parts.join(", ") || "update", attention };+}++function rowText(row: BoardWakeRow): string {+ const item = row.item != null ? `#${row.item}` : "";+ const title = row.title ? ` ${row.title}` : "";+ switch (row.kind) {+ case "moved":+ return `${item}${title} → ${row.to} by ${row.actor}`;+ case "filed":+ return `${row.actor} filed ${item}${title}`;+ case "claimed":+ return `${row.actor} claimed ${item}${title}`;+ case "assigned":+ return `${item}${title} assigned to you`;+ case "comment":+ return `${row.actor} commented on ${item}${title}`;+ case "chat":+ return `# team chat — ${row.actor}`;+ default:+ return `${item}${title}`;+ }+}++function stateDot(row: BoardWakeRow): string {+ if (row.kind === "moved" && row.to === "review") return "board-dot review";+ if (row.kind === "moved" && row.to === "blocked") return "board-dot blocked";+ if (row.kind === "moved" && row.to === "done") return "board-dot done";+ if (row.kind === "claimed" || row.kind === "assigned") return "board-dot work";+ return "board-dot idle";+}++export function BoardWakeCard({ source }: { source: MessageSource }) {+ const [open, setOpen] = useState(false);+ const [openNotes, setOpenNotes] = useState<Record<number, boolean>>({});+ const rows = source.board?.rows || [];+ const { text, attention } = summarize(rows);+ return (+ <div+ className={"boardwake" + (attention ? " attention" : "")}+ data-testid="boardwake-card"+ >+ <button+ className="boardwake-head"+ data-testid="boardwake-toggle"+ onClick={() => setOpen((v) => !v)}+ aria-expanded={open}+ >+ <Icon name="table" size={14} />+ <span className="boardwake-title">Board wake</span>+ <span className="boardwake-summary">{text}</span>+ <span className="spacer" />+ <span className={"boardwake-chevron" + (open ? " open" : "")}>+ <Icon name="chevronDown" size={13} />+ </span>+ </button>+ {open && (+ <div className="boardwake-body" data-testid="boardwake-body">+ {rows.map((row, i) => (+ <div className="boardwake-row" key={i}>+ <span className={stateDot(row)} />+ <span className="boardwake-row-main">+ <span className="boardwake-row-text">{rowText(row)}</span>+ {row.note &&+ (openNotes[i] ? (+ <span className="boardwake-note">{row.note}</span>+ ) : (+ <button+ className="boardwake-note-toggle"+ onClick={() => setOpenNotes((s) => ({ ...s, [i]: true }))}+ >+ {row.kind === "chat" || row.kind === "comment"+ ? "show message"+ : "show hand-off"}+ </button>+ ))}+ </span>+ </div>+ ))}+ {rows.length === 0 && (+ <div className="boardwake-note">{source.text}</div>+ )}+ </div>+ )}+ </div>+ );+}diff --git a/surfaces/gui/src/components/Composer.tsx b/surfaces/gui/src/components/Composer.tsxindex 532c437d..4c557cbb 100644--- a/surfaces/gui/src/components/Composer.tsx+++ b/surfaces/gui/src/components/Composer.tsx@@ -53,6 +53,10 @@ interface Props {// session; after the first turn the fact lives in the topbar subtitle (§22) — no// interactive-then-disabled control.running: boolean;+ // A proposal gate (team/items) is awaiting the user: the engine is suspended,+ // so `running` is true — but typing must stay possible, because a typed reply+ // IS an answer (decline-with-feedback). Unblocks Send while the gate is up.+ gateOpen?: boolean;connected: boolean;// False when the default model's provider has no key — the composer shows a "connect a model"// banner and routes sends to setup (preserving the draft) instead of dropping them.@@ -156,7 +160,14 @@ export function Composer(props: Props) {const el = textareaRef.current;if (!el) return;el.style.height = "auto";- const max = parseFloat(getComputedStyle(el).lineHeight || "22") * 4;+ // The cap must include the vertical PADDING: scrollHeight does, so a+ // padding-blind cap left the box ~20px short and scrolled the top padding+ // (plus the first line) out of the clip while typing (OPE-106). Six lines —+ // team briefs outgrew four.+ const cs = getComputedStyle(el);+ const pad =+ (parseFloat(cs.paddingTop) || 0) + (parseFloat(cs.paddingBottom) || 0);+ const max = (parseFloat(cs.lineHeight) || 22) * 6 + pad;const next = Math.min(el.scrollHeight, max);el.style.height = `${Math.max(next, 24)}px`;el.style.overflowY = el.scrollHeight > max ? "auto" : "hidden";@@ -318,7 +329,7 @@ export function Composer(props: Props) {const t = (skill ? text.slice(skill.length + 1) : text).trim();if ((!t && attachments.length === 0 && !skill) ||- props.running ||+ (props.running && !props.gateOpen) ||dictation?.recording ||dictationBusy)@@ -513,7 +524,11 @@ export function Composer(props: Props) {<textarearef={textareaRef}className="w-full block px-3.5 pt-3.5 pb-1.5 text-[14.5px]"- placeholder={props.placeholder || "Ask the coworker… (drop or paste files)"}+ placeholder={+ props.gateOpen+ ? "Reply to adjust the proposal — or use the buttons above"+ : props.placeholder || "Ask the coworker… (drop or paste files)"+ }value={text}onChange={(e) => setText(e.target.value)}onKeyDown={onKey}@@ -650,8 +665,8 @@ export function Composer(props: Props) {</button>)}- {/* send / stop */}- {props.running ? (+ {/* send / stop — a pending gate re-opens Send: the reply resolves it */}+ {props.running && !props.gateOpen ? (<button className="btn danger" onClick={props.onInterrupt}>⏹ Stop</button>diff --git a/surfaces/gui/src/components/Transcript.tsx b/surfaces/gui/src/components/Transcript.tsxindex cd6168bc..e2fa8af4 100644--- a/surfaces/gui/src/components/Transcript.tsx+++ b/surfaces/gui/src/components/Transcript.tsx@@ -3,6 +3,7 @@ import type { ApprovalDecision, Item } from "../types";import { shortArgs } from "./ApprovalCard";import { humanizeAsk, humanizeTool, type HumanLine } from "../humanize";import { Markdown } from "./Markdown";+import { BoardWakeCard } from "./BoardWakeCard";import { ConnectorMessageCard } from "./ConnectorMessageCard";import { Icon } from "./Icon";@@ -415,7 +416,13 @@ export function Transcript({ items, running, streamingText, onRetry, onUndoMemorconst { item } = block;switch (item.kind) {case "connector":- return <ConnectorMessageCard source={item.source} key={bi} />;+ // Board wakes get their own collapsed-by-default card — a report,+ // not a foreign message (owner ask 2026-08-16).+ return item.source.connector === "board" ? (+ <BoardWakeCard source={item.source} key={bi} />+ ) : (+ <ConnectorMessageCard source={item.source} key={bi} />+ );case "user":return (<div className="group self-end max-w-[78%] flex flex-col items-end" key={bi}>diff --git a/surfaces/gui/src/components/WorkItemsCard.tsx b/surfaces/gui/src/components/WorkItemsCard.tsxindex e3c3f48b..7cbec4a4 100644--- a/surfaces/gui/src/components/WorkItemsCard.tsx+++ b/surfaces/gui/src/components/WorkItemsCard.tsx@@ -6,6 +6,12 @@ import { useState } from "react";import type { Item } from "../types";import { Icon } from "./Icon";+// Past this length, "Done when" clamps to two lines with a per-item expander —+// a model that writes essay criteria must not occupy two screens of gate card+// (owner-hit 2026-08-16). The full text is one click away; the lead's prompt+// separately pushes criteria back toward 1–3 crisp checks.+const CRITERIA_CLAMP_CHARS = 160;+export function WorkItemsCard({item,onRespond,@@ -14,6 +20,7 @@ export function WorkItemsCard({onRespond: (approved: boolean, feedback?: string) => void;}) {const [expanded, setExpanded] = useState(false);+ const [openCriteria, setOpenCriteria] = useState<Record<number, boolean>>({});const visible = expanded ? item.items : item.items.slice(0, 3);const hidden = item.items.length - visible.length;return (@@ -25,23 +32,38 @@ export function WorkItemsCard({</span></div>{item.note && <div className="itemsreq-note">{item.note}</div>}- {visible.map((entry, i) => (- <div className="itemsreq-item" key={i}>- <span className="itemsreq-num">{i + 1}.</span>- <span className="itemsreq-body">- <span className="itemsreq-item-title">{entry.title}</span>- <span className="itemsreq-ac">- <b>Done when:</b> {entry.criteria}- </span>- </span>- </div>- ))}- {hidden > 0 && (- <button className="itemsreq-more" onClick={() => setExpanded(true)}>- + {hidden} more item{hidden === 1 ? "" : "s"}- <Icon name="chevronDown" size={12} />- </button>- )}+ <div className="itemsreq-list">+ {visible.map((entry, i) => {+ const long = (entry.criteria || "").length > CRITERIA_CLAMP_CHARS;+ const open = !!openCriteria[i];+ return (+ <div className="itemsreq-item" key={i}>+ <span className="itemsreq-num">{i + 1}.</span>+ <span className="itemsreq-body">+ <span className="itemsreq-item-title">{entry.title}</span>+ <span className={"itemsreq-ac" + (long && !open ? " clamped" : "")}>+ <b>Done when:</b> {entry.criteria}+ </span>+ {long && (+ <button+ className="itemsreq-ac-toggle"+ data-testid={`itemsreq-ac-toggle-${i}`}+ onClick={() => setOpenCriteria((s) => ({ ...s, [i]: !s[i] }))}+ >+ {open ? "Show less" : "Show full criteria"}+ </button>+ )}+ </span>+ </div>+ );+ })}+ {hidden > 0 && (+ <button className="itemsreq-more" onClick={() => setExpanded(true)}>+ + {hidden} more item{hidden === 1 ? "" : "s"}+ <Icon name="chevronDown" size={12} />+ </button>+ )}+ </div><div className="dirreq-actions"><span className="itemsreq-grant">Reply to edit the split; approval creates these on the board.diff --git a/surfaces/gui/src/styles.css b/surfaces/gui/src/styles.cssindex f32581c4..f5bc8290 100644--- a/surfaces/gui/src/styles.css+++ b/surfaces/gui/src/styles.css@@ -456,7 +456,9 @@ button.btn.danger { color: var(--accent); }(Composer.tsx); only the textarea reset + drag-ring remain in CSS. */.composer textarea {width: 100%; border: none; outline: none; resize: none; font: inherit; font-size: 14.5px; line-height: 1.45;- background: transparent; color: var(--ink); min-height: 24px; max-height: 88px; overflow: hidden;+ background: transparent; color: var(--ink); min-height: 24px; overflow: hidden;+ /* Height (incl. the cap) is owned by the autogrow effect in Composer.tsx — a+ CSS max-height here fought it and re-created the OPE-106 clipping. */}.composer textarea::placeholder { color: var(--faint); }.voice-wave-line { flex: 1; min-width: 28px; border-top: 1px dashed var(--line-strong); }@@ -1640,6 +1642,42 @@ html[data-platform="linux"] ::-webkit-scrollbar-thumb:hover { background-color:/* ── Agent teams (OPE-96): board rail, expanded overlay, plan gate ─────────── */.board-rail { display: flex; flex-direction: column; gap: 2px; }+.board-rail-quiet { font-size: 12px; color: var(--faint); padding: 2px 0 4px; }+.board-finished-toggle {+ align-self: flex-start; border: none; background: none; padding: 4px 0 0; cursor: pointer;+ font-size: 11.5px; color: var(--faint);+}+.board-finished-toggle:hover { color: var(--muted); text-decoration: underline; }++/* -- BoardWakeCard: a board wake collapsed to one line (click to expand) ------- */+.boardwake {+ border: 1px solid var(--line); border-radius: 10px; background: var(--panel);+ margin: 2px 0; overflow: hidden;+}+.boardwake.attention { border-color: color-mix(in srgb, var(--warn, #b98a2f) 45%, var(--line)); }+.boardwake-head {+ display: flex; align-items: center; gap: 7px; width: 100%; text-align: left;+ border: none; background: none; cursor: pointer; padding: 7px 10px;+ font-size: 12.5px; color: var(--muted);+}+.boardwake-head:hover { background: var(--paper); }+.boardwake-title { font-weight: 600; color: var(--ink); }+.boardwake-chevron { display: inline-flex; transition: transform 0.15s; }+.boardwake-chevron.open { transform: rotate(180deg); }+.boardwake-summary { color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }+.boardwake-body { border-top: 1px solid var(--line); padding: 6px 10px 8px; max-height: 260px; overflow-y: auto; }+.boardwake-row { display: flex; align-items: baseline; gap: 8px; padding: 4px 0; }+.boardwake-row-main { display: flex; flex-direction: column; gap: 3px; min-width: 0; }+.boardwake-row-text { font-size: 12px; color: var(--ink); }+.boardwake-note {+ font-size: 11.5px; color: var(--muted); white-space: pre-wrap; overflow-wrap: anywhere;+ border-left: 2px solid var(--line); padding-left: 8px;+}+.boardwake-note-toggle {+ align-self: flex-start; border: none; background: none; padding: 0; cursor: pointer;+ font-size: 11px; color: var(--accent);+}+.boardwake-note-toggle:hover { text-decoration: underline; }.board-group {font-size: 10.5px; letter-spacing: 0.06em; text-transform: uppercase;color: var(--faint); font-weight: 700; margin: 8px 0 3px;@@ -1746,6 +1784,17 @@ html[data-platform="linux"] ::-webkit-scrollbar-thumb:hover { background-color:.itemsreq-item-title { font-size: 12.5px; color: var(--ink); }.itemsreq-ac { font-size: 11.5px; color: var(--muted); }.itemsreq-ac b { font-weight: 600; }+/* Essay-length criteria clamp to two lines; the expander reveals the rest. The+ list itself caps so a big proposal never occupies two screens of chat. */+.itemsreq-ac.clamped {+ display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden;+}+.itemsreq-ac-toggle {+ align-self: flex-start; border: none; background: none; padding: 0; cursor: pointer;+ font-size: 11px; color: var(--accent);+}+.itemsreq-ac-toggle:hover { text-decoration: underline; }+.itemsreq-list { max-height: 320px; overflow-y: auto; }.itemsreq-more { display: flex; align-items: center; gap: 5px; border: 0; background: transparent; color: var(--accent); font-size: 12px; cursor: pointer; padding: 6px 0; }.itemsreq-grant { font-size: 11.5px; color: var(--faint); }diff --git a/tests/test_team_wake.py b/tests/test_team_wake.pyindex 895878e4..72d2bb1b 100644--- a/tests/test_team_wake.py+++ b/tests/test_team_wake.py@@ -333,11 +333,44 @@ def test_create_team_uses_callnames_and_creates_the_chat_group(manager, monkeypagroup = manager.chat_store.get_group(team.chat_group)assert {m["name"] for m in group["members"]} == {"nia", "nia-2", "lead"}# the worker digest carries the roster + how to reach teammates- digest = manager._team_digest(team, [], [], is_lead=False)+ digest, _rows = manager._team_digest(team, [], [], is_lead=False)assert "Your team: nia (swe-worker — implementation)" in digestassert "@name in # team chat" in digest+def test_digest_clamps_long_comments_and_carries_structured_rows(manager):+ """Hand-off essays live on the board; the wake message carries a head, the+ sidecar carries UI rows (owner ruling 2026-08-16 — the digest was arriving+ as a wall of text)."""+ from coworker.teams.registry import Team++ space = str(manager.default_workspace)+ lead = Actor(id="lead-1", role=Role.LEAD)+ worker = Actor(id="nia", role=Role.WORKER)+ item = manager.team_store.create_item(+ space, lead, title="Big item", criteria="c"+ )+ manager.team_store.assign(space, lead, item["id"], "nia")+ essay = "verified the endpoint thoroughly. " * 40 # ~1300 chars+ manager.team_store.transition(+ space, worker, item["id"], "in_progress"+ )+ manager.team_store.transition(+ space, worker, item["id"], "review", comment=essay+ )+ team = Team(team_id="t1", space=space, lead_session="s", lead_actor="lead-1")+ subs = manager.team_store.subscribed_events(space, "lead-1")+ message, rows = manager._team_digest(team, [], subs, is_lead=True)+ # model text: clamped hard, with the pointer back to the board+ assert essay not in message+ assert "(full text on the board)" in message+ assert len(message) < 1200+ # sidecar rows: structured, softer clamp for the human on click+ moved = [r for r in rows if r["kind"] == "moved" and r["to"] == "review"]+ assert moved and moved[0]["item"] == item["id"]+ assert moved[0]["note"].endswith("…") and len(moved[0]["note"]) < 700++def test_cancel_notice_is_addressed_to_the_assignee(store):item_id = assigned(store)store.consume("swe-worker", store.pending_for("swe-worker")[-1]["seq"])