tumwater 0.1.2 → 0.2.0

package/dist/src/ui/gui/gui-client-boot.js

@@ -1,5 +1,6 @@
+// vocabulary: plain
 /** The dashboard's boot, browser-side: view routing over #fragment links (Back/Forward and
- * bookmarks work, re-clicking the open tab refetches), #loop/<role> opening that loop's
+ * bookmarks work, re-clicking the open tab refetches), #role/<role> opening that loop's
  * drawer with the address bar following it, the global action dispatcher behind the
  * data-act/data-open attributes (alert and tile buttons, loop names anywhere, questions),
  * the keyboard shortcuts (Escape closes the drawer, "/" focuses the composer), the theme
@@ -7,11 +8,19 @@
  * when the serving build moves. Spliced into gui-client.ts's script as its last section,
  * reaching the shared state and the render helpers of every other section through that
  * concatenation. */
-export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
+export const GUI_CLIENT_BOOT_JS = String.raw `  // One tail for the "…written to the file but the worktree was left dirty" toasts: the
+  // cancel/edit/file backlog actions share the same committed===false copy, kept in one place
+  // so the operator-facing wording about an uncommitted edit cannot drift between them. The
+  // question-answer toast names QUESTIONS.md explicitly, so it stays inline.
+  function uncommittedTail(d) {
+    return d.committed === false ? ", but NOT committed to main (uncommitted in the checkout)" : "";
+  }
+  // ---- views ----
   // view-routing:start
-  const VIEWS = { fleet: "fleet-view", history: "history", usage: "report", failures: "failures", pending: "pending", settings: "settings-view" };
+  const VIEWS = { team: "team-view", history: "history", usage: "report", failures: "failures", pending: "pending", settings: "settings-view" }; // vocabulary-ok: view ids
   function switchView(v) {
-    if (!VIEWS[v]) v = "fleet";
+    if (v === "fleet") v = "team"; // vocabulary-ok: legacy dashboard hash, still routed
+    if (!VIEWS[v]) v = "team";
     activeView = v;
     for (const k of Object.keys(VIEWS)) {
       $(VIEWS[k]).hidden = k !== v;
@@ -20,15 +29,15 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
       if (k === v) tab.setAttribute("aria-current", "page");
       else tab.removeAttribute("aria-current");
     }
-    if (v === "fleet" && lastStatus) renderFleet(lastStatus);
+    if (v === "team" && lastStatus) renderTeam(lastStatus);
     if (v === "history") fetchHistory();
     if (v === "usage") fetchReport();
     if (v === "failures") fetchFailures();
     if (v === "pending") fetchPending();
-    if (v === "settings") { fetchSettings(); fetchDoctor(); }
+    if (v === "settings") { fetchSettings(); fetchDoctor(); fetchRetirable(); fetchBrief(); }
   }
   // Tabs are plain #fragment links, so Back/Forward and bookmarks work; re-clicking the open
-  // tab refetches its data. #loop/<role> opens that loop's drawer (over Fleet on a fresh load),
+  // tab refetches its data. #role/<role> opens that loop's drawer (over Team on a fresh load),
   // and the address bar follows the open drawer, so a loop's live view can be linked to.
   let routed = false;
   function route() {
@@ -38,9 +47,9 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
     // script and the dashboard never polls again — a frozen page from a hand-edited URL.
     let h = location.hash.slice(1);
     try { h = decodeURIComponent(h); } catch { /* malformed escape: route on the raw fragment */ }
-    if (h.startsWith("loop/")) {
-      if (!routed) switchView("fleet");
-      if (openLoopRole() !== h.slice(5)) openLoop(h.slice(5));
+    if (h.startsWith("role/") || h.startsWith("loop/")) { // vocabulary-ok: legacy dashboard hash, still routed
+      if (!routed) switchView("team");
+      if (openLoopRole() !== h.slice(h.indexOf("/") + 1)) openLoop(h.slice(h.indexOf("/") + 1));
     } else switchView(h);
     routed = true;
   }
@@ -58,6 +67,12 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
     const form = ev.target instanceof Element ? ev.target.closest("form.settings-row") : null;
     if (form) { ev.preventDefault(); saveSetting(form); }
   });
+  // The Initial prompt card's Save: its own form class, so the settings listener above never
+  // routes it to saveSetting.
+  document.addEventListener("submit", (ev) => {
+    const form = ev.target instanceof Element ? ev.target.closest("form.brief-form") : null;
+    if (form) { ev.preventDefault(); saveBrief(form); }
+  });
   // The Settings view's Clear buttons: one delegated click listener resolves the row's Clear
   // through clickClosest and calls clearSetting (gui-client-settings). No per-row wiring, so
   // the panel repaints freely.
@@ -69,26 +84,43 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
   // The Health check card's Re-run button: runs the doctor checks again.
   document.addEventListener("click", (ev) => {
     if (clickClosest(ev, "button[data-action='doctor-rerun']")) { ev.preventDefault(); fetchDoctor(); }
+    if (clickClosest(ev, "button[data-action='notify-test']")) { ev.preventDefault(); testNotify(); }
+    const retire = clickClosest(ev, "button[data-action='retire']");
+    if (retire) { ev.preventDefault(); confirmRetire(retire.dataset.role); }
+    const enable = clickClosest(ev, "button[data-action='enable']");
+    if (enable) { ev.preventDefault(); enableRole(enable.dataset.role); }
+  });
+  // The Health card's Problems only checkbox: repaint the cached report with only its warn
+  // and fail rows (toggleDoctorProblems, gui-client-settings), without rerunning the checks.
+  document.addEventListener("change", (ev) => {
+    const box = clickClosest(ev, "input[data-action='doctor-problems']");
+    if (box) toggleDoctorProblems(box.checked);
   });
   // ---- global actions: alert and tile buttons, loop names anywhere, questions ----
   // run-act:start
+  // The backlog drawer rows resolve a list entry's title from the last polled status by its
+  // backlog file and 0-based position (entry-cancel, entry-edit, and the mention action). The
+  // call sites keep their arg's "file:index" split because that shape is theirs alone.
+  function entryTitleAt(file, index) {
+    return ((lastStatus && lastStatus[file]) || [])[Number(index)];
+  }
   function runAct(act, arg) {
-    if (act === "loop") openLoop(arg);
+    if (act === "role") openLoop(arg);
     else if (act === "close") closeDrawer();
     else if (act === "view") location.hash = arg;
     else if (act === "budget") openBudgetEditor();
-    else if (act === "resume") setFleetPause(false);
+    else if (act === "resume") setTeamPause(false);
     else if (act === "copy") copyText(arg);
     else if (act === "restart")
       postAction("/api/restart", {}, (d) =>
         d && typeof d.message === "string"
           ? d.message
-          : "Restart requested — the fleet applies it within one poll");
+          : "Restart requested — tumwater applies it within one poll");
     else if (act === "reclaim")
       postAction("/api/reclaim", {}, (d) =>
         d && typeof d.message === "string" ? d.message : "Reclaim requested");
     else if (act === "questions" || act === "queued" || act === "backlog") {
-      if (activeView !== "fleet") location.hash = "fleet";
+      if (activeView !== "team") location.hash = "team";
       if (act !== "backlog") setBacklogTab(act);
       $("backlogcard").scrollIntoView({ behavior: "smooth", block: "start" });
     } else if (act === "answer") {
@@ -103,24 +135,50 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
       postAction("/api/question-answer", { position: Number(arg) + 1, title: q, decision }, (d) => {
         closeDrawer();
         return d && d.status === "answered"
-          ? "Answered “" + splitTitle(q).title + "” — moved to ## Answered"
+          ? "Answered “" + splitTitle(q).title + "” — moved to ## Answered" + (d.committed === false ? ", but NOT committed to main (QUESTIONS.md is uncommitted in the checkout)" : "")
           : "That question was already answered or moved — refreshed";
       });
     } else if (act === "entry-cancel") {
       const [file, index] = arg.split(":");
-      const title = ((lastStatus && lastStatus[file]) || [])[Number(index)];
+      const title = entryTitleAt(file, index);
       if (title === undefined) return;
       if (!entryCancelArmed(arg, title)) { armEntryCancel(arg, title); return; }
       disarmEntryCancel();
       postAction("/api/backlog-cancel", { kind: file === "bugs" ? "bug" : "plan", position: Number(index) + 1, title }, (d) => {
         closeDrawer();
         return d && d.status === "cancelled"
-          ? "Cancelled “" + splitTitle(title).title + "” from " + (file === "bugs" ? "BUGS.md" : "PLANS.md")
+          ? "Cancelled “" + splitTitle(title).title + "” from " + (file === "bugs" ? "BUGS.md" : "PLANS.md") + uncommittedTail(d)
           : "That entry was already removed or moved — refreshed";
       });
+    } else if (act === "entry-release") {
+      const [file, index] = arg.split(":");
+      const title = entryTitleAt(file, index);
+      if (title === undefined) return;
+      postAction("/api/backlog-release", { kind: file === "bugs" ? "bug" : "plan", position: Number(index) + 1, title }, (d) => {
+        closeDrawer();
+        if (d && d.status === "released") {
+          return "Released “" + splitTitle(title).title + "” in " + (file === "bugs" ? "BUGS.md" : "PLANS.md") + " — " + (file === "bugs" ? "bugfix" : "feature") + " will pick it up" + uncommittedTail(d);
+        }
+        return d && d.status === "not_refused"
+          ? "That entry carries no Refused or Waiting note — refreshed"
+          : "That entry was removed or moved — refreshed";
+      });
+    } else if (act === "entry-top") {
+      const [file, index] = arg.split(":");
+      const title = entryTitleAt(file, index);
+      if (title === undefined) return;
+      postAction("/api/backlog-top", { kind: file === "bugs" ? "bug" : "plan", position: Number(index) + 1, title }, (d) => {
+        closeDrawer();
+        if (d && d.status === "moved_to_top") {
+          return "Moved “" + splitTitle(title).title + "” to the top of " + (file === "bugs" ? "BUGS.md" : "PLANS.md") + " — " + (file === "bugs" ? "bugfix" : "feature") + " takes it next" + uncommittedTail(d);
+        }
+        return d && d.status === "already_first"
+          ? "That entry is already first — refreshed"
+          : "That entry was removed or moved — refreshed";
+      });
     } else if (act === "entry-edit") {
       const [file, index] = arg.split(":");
-      const title = ((lastStatus && lastStatus[file]) || [])[Number(index)];
+      const title = entryTitleAt(file, index);
       if (title !== undefined) startEntryEdit(arg, title);
     } else if (act === "entry-edit-discard") {
       stopEntryEdit();
@@ -139,11 +197,11 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
         stopEntryEdit();
         closeDrawer();
         return d && d.status === "edited"
-          ? "Edited “" + splitTitle(d.title).title + "” in " + (file === "bugs" ? "BUGS.md" : "PLANS.md")
+          ? "Edited “" + splitTitle(d.title).title + "” in " + (file === "bugs" ? "BUGS.md" : "PLANS.md") + uncommittedTail(d)
           : "That entry was removed or moved — refreshed";
       });
     } else if (act === "note-edit") {
-      const note = drawerRole && drawerRole.view && typeof drawerRole.view.note === "string" ? drawerRole.view.note : "";
+      const note = drawerRole && drawerRole.view && typeof drawerRole.view.notes === "string" ? drawerRole.view.notes : "";
       startNoteEdit(arg, note);
     } else if (act === "note-discard") {
       stopNoteEdit();
@@ -159,11 +217,129 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
       postAction("/api/role-notes", { role: arg, text }, (d) => {
         noteEditing = null;
         loadDrawerRole(arg);
-        return d && typeof d.message === "string" ? d.message : "Notebook updated";
+        return d && typeof d.message === "string" ? d.message : "Notes updated";
+      });
+    } else if (act === "cap-edit") {
+      startCapEdit(arg, drawerRole?.view?.dailyCap?.capUsd ?? 0);
+    } else if (act === "cap-discard") {
+      stopCapEdit();
+    } else if (act === "cap-save") {
+      const input = $("capeditinput");
+      if (!input) return;
+      // A type=number input reports "" both for a field cleared on purpose (no cap) and for
+      // text the browser rejected ("$2"); validity.badInput tells them apart, so a typo is an
+      // error instead of silently removing the cap — the team editor's guard, in scope from
+      // the operator blob concatenated earlier.
+      if (input.validity && input.validity.badInput) {
+        showFlash("error: the cap must be a number of 0 or more — leave it empty for no cap");
+        return;
+      }
+      const parsed = parseBudgetField(input.value);
+      if (!parsed.ok) {
+        showFlash("error: " + parsed.error);
+        return;
+      }
+      const value = parsed.value;
+      postAction("/api/role-cap", { role: arg, maxDailyCostUsd: value }, (d) => {
+        capEditing = null;
+        loadDrawerRole(arg);
+        return value > 0 ? "Daily cap set to " + fmtCap(value) : "Daily cap removed";
+      });
+    } else if (act === "interval-edit") {
+      startIntervalEdit(arg, drawerRole?.view?.minRunIntervalOverride ?? "");
+    } else if (act === "interval-discard") {
+      stopIntervalEdit();
+    } else if (act === "interval-save") {
+      const input = $("intervaleditinput");
+      if (!input) return;
+      // A type=number input reports "" both for a field cleared on purpose (the team
+      // default) and for text the browser rejected ("$2"); validity.badInput tells them
+      // apart, so a typo is an error instead of silently clearing the override — the cap
+      // arm's guard, in scope from the operator blob concatenated earlier.
+      if (input.validity && input.validity.badInput) {
+        showFlash("error: the interval must be a number of 0 or more — leave it empty for the team default");
+        return;
+      }
+      const raw = input.value.trim();
+      const value = raw === "" ? null : Number(raw);
+      postAction("/api/role-interval", { role: arg, minRunIntervalSeconds: value }, (d) => {
+        intervalEditing = null;
+        loadDrawerRole(arg);
+        return d && typeof d.message === "string" ? d.message : "Min run interval updated";
+      });
+    } else if (act === "instances-edit") {
+      startInstancesEdit(arg, drawerRole?.view?.instances ?? "");
+    } else if (act === "instances-discard") {
+      stopInstancesEdit();
+    } else if (act === "instances-save") {
+      const input = $("instanceseditinput");
+      if (!input) return;
+      // A type=number input reports "" both for a field cleared on purpose (the default 1)
+      // and for text the browser rejected ("$2"); validity.badInput tells them apart, so a
+      // typo is an error instead of silently clearing the count — the interval arm's guard,
+      // in scope from the operator blob concatenated earlier. (A rejected "2.5" is a real
+      // number the browser accepts, so it posts and validateConfig's 1–8 integer rule 400s
+      // it, flashed through postAction's error path.)
+      if (input.validity && input.validity.badInput) {
+        showFlash("error: the instances must be an integer from 1 to 8 — leave it empty for the default 1");
+        return;
+      }
+      const raw = input.value.trim();
+      const value = raw === "" ? null : Number(raw);
+      postAction("/api/role-instances", { role: arg, instances: value }, (d) => {
+        instancesEditing = null;
+        loadDrawerRole(arg);
+        return d && typeof d.message === "string" ? d.message : "Instances updated";
+      });
+    } else if (act === "instructions-edit") {
+      startInstructionsEdit(arg, drawerRole?.view?.instructions ?? "");
+    } else if (act === "instructions-discard") {
+      stopInstructionsEdit();
+    } else if (act === "instructions-save") {
+      const box = $("instructionsedittext");
+      const text = box ? box.value : "";
+      postAction("/api/role-instructions", { role: arg, text }, (d) => {
+        instructionsEditing = null;
+        loadDrawerRole(arg);
+        return d && typeof d.message === "string" ? d.message : "Instructions updated";
+      });
+    } else if (act === "quiet-edit") {
+      startQuietEdit(arg, drawerRole?.view?.quietHours?.find((w) => w && w.scope === "role")?.window ?? "");
+    } else if (act === "quiet-discard") {
+      stopQuietEdit();
+    } else if (act === "quiet-save") {
+      const input = $("quieteditinput");
+      const window = input ? input.value : "";
+      // A text input has no badInput guard; an empty value reaches the server's clear branch,
+      // and a malformed window is refused by checkQuietHours, flashed through postAction's
+      // error path.
+      postAction("/api/role-quiet-hours", { role: arg, window }, (d) => {
+        quietEditing = null;
+        loadDrawerRole(arg);
+        return d && typeof d.message === "string" ? d.message : "Quiet hours updated";
+      });
+    } else if (act === "model-edit") {
+      startModelEdit(arg, { provider: drawerRole?.view?.providerOverride ?? "", model: drawerRole?.view?.modelOverride ?? "", thinking: drawerRole?.view?.thinkingOverride ?? "" });
+    } else if (act === "model-discard") {
+      stopModelEdit();
+    } else if (act === "model-save") {
+      // Every field is a text input, so no badInput guard; an empty value reaches the
+      // server's clear branch for that field. All three are sent (each trimmed) — the server
+      // ignores whatever it does not recognize and requires at least one present.
+      const providerBox = $("modeleditprovider");
+      const modelBox = $("modeleditmodel");
+      const thinkingBox = $("modeleditthinking");
+      const provider = providerBox ? providerBox.value.trim() : "";
+      const model = modelBox ? modelBox.value.trim() : "";
+      const thinking = thinkingBox ? thinkingBox.value.trim() : "";
+      postAction("/api/role-model", { role: arg, provider, model, thinking }, (d) => {
+        modelEditing = null;
+        loadDrawerRole(arg);
+        return d && typeof d.message === "string" ? d.message : "Model overrides updated";
       });
     } else if (act === "mention") {
       const [file, index] = arg.split(":");
-      const title = ((lastStatus && lastStatus[file]) || [])[Number(index)];
+      const title = entryTitleAt(file, index);
       if (title !== undefined) draftForDirector("About “" + splitTitle(title).title + "”: ");
     }
   }
@@ -175,7 +351,10 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
     // A history row's drill-down button sits inside the row's data-open cell area but must not
     // open the drawer — expansion is the button's alone (gui-client-history's own delegated
     // handler toggles the card).
-    if (open && !t.closest("#loops") && !t.closest("[data-tickdetail]")) { ev.preventDefault(); toggleLoop(open.dataset.open); }
+    if (open && !t.closest("#rolerows") && !t.closest("[data-tickdetail]")) { // vocabulary-ok: element selectors
+      ev.preventDefault();
+      toggleLoop(open.dataset.open);
+    }
   });
   const typing = (el) => el instanceof Element && el.closest("input, textarea, select, [contenteditable]") !== null;
   document.addEventListener("keydown", (ev) => {
@@ -204,12 +383,12 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
   // ---- the poll ----
   function rerender() {
     if (!lastStatus) return;
-    if (activeView === "fleet") renderFleet(lastStatus);
+    if (activeView === "team") renderTeam(lastStatus);
     if (activeView === "pending") renderPendingQueue(lastStatus);
-    if (drawer && drawer.kind === "loop") renderLoopDrawer(lastStatus);
+    if (drawer && drawer.kind === "loop") renderLoopDrawer(lastStatus); // vocabulary-ok: drawer kind
   }
   let lastEventKey = null;
-  // New events are what move the numbers the other panels show (today's landings, the History
+  // New events are what move the numbers the other panels show (today's merges, the History
   // rows, the open loop's recent ticks), so they refetch on that signal, each throttled.
   function onNewEvents() {
     refreshToday(false);
@@ -221,7 +400,7 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
     let d;
     try {
       // The guarded getJson: the server's 500 sends a JSON {error} body, which must never be
-      // taken for fleet state — a failed poll keeps the last good frame and says so. The
+      // taken for team state — a failed poll keeps the last good frame and says so. The
       // bounded wait covers the other failure a bare fetch never reports: a connection the
       // server accepted but never answers (pollSignal).
       d = await getJson("/api/status", pollSignal());
@@ -245,14 +424,14 @@ export const GUI_CLIENT_BOOT_JS = String.raw `  // ---- views ----
       renderSidebar(d);
       renderAlerts(d);
       renderComposer(d);
-      if (activeView === "fleet") renderFleet(d);
+      if (activeView === "team") renderTeam(d);
       if (activeView === "pending") renderPendingQueue(d);
       if (activeView === "history") syncHistoryRoles(d);
-      // Keep the Usage/Failures Loop pickers in step with the fleet while either is open.
+      // Keep the Usage/Failures Loop pickers in step with the team while either is open.
       if (activeView === "usage" || activeView === "failures") syncReportRoles(d);
       const items = d.eventItems || [];
       const last = items[items.length - 1];
-      const key = last ? last.ts + ":" + last.type + ":" + last.loop : "";
+      const key = last ? last.ts + ":" + last.type + ":" + last.source : "";
       if (lastEventKey !== null && key !== lastEventKey) onNewEvents();
       lastEventKey = key;
     } catch (err) {

package/dist/src/ui/gui/gui-client-composer.js

@@ -1,13 +1,14 @@
+// vocabulary: plain
 /** The dashboard's composer, browser-side — the one input box that steers the director or any
  * single loop: the target selector with its per-target unsent drafts, the character counter,
  * the image attachments (dropped or pasted onto the box, rendered as removable chips), and
  * the submit that reads the bytes and queues the prompt through the same endpoints the CLI's
- * "prompt" and "prompt --role" use. Split out of gui-client-fleet.ts, which keeps the
- * read-only status rendering the composer sits on top of. renderFleet calls renderComposer
+ * "prompt" and "prompt --role" use. Split out of gui-client-team.ts, which keeps the
+ * read-only status rendering the composer sits on top of. renderTeam calls renderComposer
  * each poll; gui-client-boot.ts's question and backlog actions and gui-client-loops.ts's row
  * actions call draftForDirector and focusComposer. Spliced into gui-client.ts's script right
- * after the fleet view, reaching its helpers ($, esc, postJson, plural, showFlash, refresh)
- * and the fleet view's activeView/drawer state through that concatenation. */
+ * after the team view, reaching its helpers ($, esc, postJson, plural, showFlash, refresh)
+ * and the team view's activeView/drawer state through that concatenation. */
 import { DIRECTOR_PROMPT_MAX_CHARS } from "../../inbox/inbox-submit.js";
 import { PROMPT_IMAGE_EXTENSIONS, PROMPT_IMAGE_MAX_BYTES, PROMPT_IMAGES_MAX_COUNT } from "../../inbox/inbox-attachments.js";
 export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box for the director or any single loop ----
@@ -17,39 +18,73 @@ export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box fo
   let promptTarget = "director";
   let targetKey = "";
   const drafts = {}; // each target keeps its own unsent draft
+  // Recall of recently sent prompts, the composer's mirror of the TUI prompt line's
+  // tui-prompt-history.ts: Up steps back through the prompts you have sent, Down steps
+  // forward and restores the live draft you were typing. promptHistory holds the text of
+  // each successfully sent prompt, oldest first; recallIndex is null while the live draft
+  // is shown, an index while browsing history; recallDraft saves the live draft when the
+  // first Up leaves it, so Down past the newest entry hands it back untouched.
+  const promptHistory = [];
+  let recallIndex = null;
+  let recallDraft = "";
+  const PROMPT_HISTORY_MAX = 50;
+  // The last status payload, kept so setTarget can re-render the image note between polls.
+  let composerData = null;
+  // The image-input notice under the image chips (plans/image-input.md "Surfaces", part 5/5):
+  // when the selected non-director loop's model can't read images but reroutes a blind read
+  // to another tier, say so — read from the status payload (imageInput/imageReroute), the same
+  // facts the images alert and the submit gate use, so the composer never promises a run the
+  // gate would refuse.
+  function renderPromptImageNote() {
+    const loop = (composerData && composerData.roles || []).find((l) => l.role === promptTarget);
+    const note = $("promptimagenote");
+    const text = loop && loop.imageInput === false && loop.imageReroute
+      ? promptTarget + "'s model can't read images; image prompts run on " + loop.imageReroute
+      : "";
+    if (note.textContent !== text) note.textContent = text;
+    note.hidden = text === "";
+  }
   function renderComposer(d) {
-    const roles = (d.loops || []).map((l) => l.role).filter((r) => r !== "director");
+    const roles = (d.roles || []).map((l) => l.role).filter((r) => r !== "director");
     const key = roles.join(",");
     if (key !== targetKey) {
       targetKey = key;
-      targetSelect.innerHTML = "<option value='director'>Director</option>" + (roles.length ? "<optgroup label='One loop, at its next tick'>" +
-        roles.map((r) => "<option value='" + esc(r) + "'>" + esc(r) + "</option>").join("") + "</optgroup>" : "");
+      targetSelect.innerHTML = "<option value='director'>Director</option>" + (roles.length ? "<optgroup label='One role, at its next run'>" +
+        roles.map((r) => "<option value='" + esc(r) + "'>" + esc(roleLabel(r)) + "</option>").join("") + "</optgroup>" : "");
       if (promptTarget !== "director" && !roles.includes(promptTarget)) setTarget("director");
       targetSelect.value = promptTarget;
     }
     const n = (d.inbox || 0) + Object.values(d.roleInbox || {}).reduce((a, b) => a + b, 0);
     const link = $("queuelink");
     link.hidden = n === 0;
-    link.dataset.act = "queued";
-    const text = plural(n, "prompt") + " queued";
+    link.dataset.act = "queued"; // vocabulary-ok: data-act routing key the click handler matches
+    const text = plural(n, "message") + " in the inbox";
     if (link.textContent !== text) link.textContent = text;
+    composerData = d;
+    renderPromptImageNote();
   }
   function composerHint() {
     $("prompthint").innerHTML = esc(promptTarget === "director"
-      ? "The director runs this next, ahead of every loop."
-      : "Queued for the " + promptTarget + " loop's next tick; the loop wakes right away.") +
+      ? "The director runs this next, ahead of every role."
+      : "Goes to the " + roleLabel(promptTarget) + " inbox for its next run; the role wakes right away.") +
       " <kbd>Enter</kbd> sends · <kbd>Shift</kbd>+<kbd>Enter</kbd> adds a line · <kbd>/</kbd> jumps here";
-    promptInput.placeholder = promptTarget === "director" ? "Tell the fleet what to do next…" : "Tell the " + promptTarget + " loop what to do on its next tick…";
+    promptInput.placeholder = promptTarget === "director" ? "Tell the team what to do next…" : "Tell the " + roleLabel(promptTarget) + " role what to do on its next run…";
   }
   function setTarget(t) {
     if (t === promptTarget) return;
-    drafts[promptTarget] = promptInput.value;
+    // Mid-recall the box holds a recalled entry, not the draft; hand the saved draft to the
+    // old target's slot (the TUI's settlePromptRecall swaps the same way) so no unsent draft
+    // is lost, then end recall.
+    drafts[promptTarget] = recallIndex !== null ? recallDraft : promptInput.value;
     promptTarget = t;
+    recallIndex = null;
+    recallDraft = "";
     targetSelect.value = t;
     promptInput.value = drafts[t] || "";
     composerHint();
     autosize();
     updateCount();
+    renderPromptImageNote();
   }
   function autosize() {
     promptInput.style.height = "auto";
@@ -65,25 +100,66 @@ export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box fo
   // about a backlog entry), leaving the cursor at the end.
   function draftForDirector(text) {
     setTarget("director");
+    recallIndex = null;
+    recallDraft = "";
     promptInput.value = text;
     autosize();
     updateCount();
     focusComposer();
     promptInput.setSelectionRange(text.length, text.length);
   }
-  // The composer sits on the Fleet view; bring it into sight from anywhere and focus it.
+  // The composer sits on the Team view; bring it into sight from anywhere and focus it.
   function focusComposer() {
-    if (activeView !== "fleet") location.hash = "fleet";
+    if (activeView !== "team") location.hash = "team";
     if (window.innerWidth <= 1180 && drawer) closeDrawer();
     $("promptform").scrollIntoView({ behavior: "smooth", block: "center" });
     promptInput.focus({ preventScroll: true });
   }
   targetSelect.addEventListener("change", () => setTarget(targetSelect.value));
   promptInput.addEventListener("input", () => { autosize(); updateCount(); });
+  // Recall one recently sent prompt: step is -1 for Up (older) and 1 for Down (newer).
+  // Returns true when the box changed (so the caller can stop the browser's own Up/Down
+  // cursor move). Up from the live draft saves it and moves to the newest entry; Up steps
+  // one older while it can and holds the oldest end. Down steps newer; past the newest it
+  // restores the saved live draft and ends recall. Down while already live is a no-op. On a
+  // change the recalled text is set ready to send, sized, counted, and the cursor put at the
+  // end. The composer's mirror of the TUI's recallPromptHistory.
+  function recallSentPrompt(step) {
+    if (step === -1) {
+      if (promptHistory.length === 0) return false;
+      if (recallIndex === null) {
+        recallDraft = promptInput.value;
+        recallIndex = promptHistory.length - 1;
+      } else if (recallIndex === 0) {
+        return false; // already at the oldest end
+      } else {
+        recallIndex--;
+      }
+    } else {
+      if (recallIndex === null) return false; // already on the live draft
+      if (recallIndex >= promptHistory.length - 1) {
+        promptInput.value = recallDraft; // past the newest: the live draft returns
+        recallDraft = "";
+        recallIndex = null;
+        autosize();
+        updateCount();
+        promptInput.setSelectionRange(promptInput.value.length, promptInput.value.length);
+        return true;
+      }
+      recallIndex++;
+    }
+    promptInput.value = promptHistory[recallIndex];
+    autosize();
+    updateCount();
+    promptInput.setSelectionRange(promptInput.value.length, promptInput.value.length);
+    return true;
+  }
   promptInput.addEventListener("keydown", (ev) => {
     if (ev.key === "Enter" && !ev.shiftKey && !ev.isComposing) {
       ev.preventDefault();
       $("promptform").requestSubmit();
+    } else if ((ev.key === "ArrowUp" || ev.key === "ArrowDown") && !ev.isComposing && (recallIndex !== null || !promptInput.value.includes("\n"))) {
+      if (recallSentPrompt(ev.key === "ArrowUp" ? -1 : 1)) ev.preventDefault();
     } else if (ev.key === "Escape") promptInput.blur();
   });
   // composer-images:start
@@ -185,17 +261,15 @@ export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box fo
   // "prompt" and "prompt --role" use. Resolves to the confirmation to show; rejects when the
   // server did not take it (the caller keeps the text so it can be fixed and resent). Pending
   // images ride along as { name, dataBase64 } and are named in the confirmation.
-  async function sendPrompt(target, text, images, defer) {
+  async function sendPrompt(target, text, images) {
     const attached = images && images.length ? " with " + plural(images.length, "image") : "";
-    const deferred = defer ? " — delivers in " + defer : "";
     const body = images && images.length ? { text, images } : { text };
-    if (defer) body.defer = defer;
     if (target === "director") {
       await postJson("/api/prompt", body);
-      return "Queued for the director — it runs next" + attached + deferred;
+      return "Added to the director's inbox — it runs next" + attached;
     }
     await postJson("/api/prompt-role", { role: target, ...body });
-    return "Queued for the " + target + " loop's next tick — it wakes now" + attached + deferred;
+    return "Added to the " + roleLabel(target) + " inbox for its next run — it wakes now" + attached;
   }
   // composer-send:end
   let sending = false;
@@ -203,14 +277,13 @@ export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box fo
     ev.preventDefault();
     const text = promptInput.value.trim();
     if (!text || sending) return;
-    const defer = $("promptdefer").value.trim();
     const target = promptTarget;
     sending = true;
     $("promptsend").disabled = true;
     const images = [];
     try {
       for (const img of promptImages) images.push({ name: img.name, dataBase64: await readImageAsBase64(img.file) });
-      showFlash(await sendPrompt(target, text, images, defer));
+      showFlash(await sendPrompt(target, text, images));
     } catch (err) {
       // The prompt was not accepted: keep the text and the images so they can be fixed and resent.
       showFlash("error: " + err.message);
@@ -222,8 +295,14 @@ export const GUI_CLIENT_COMPOSER_JS = String.raw `  // ---- composer: one box fo
     promptImages.length = 0;
     renderPromptImages();
     promptInput.value = "";
-    $("promptdefer").value = "";
     drafts[target] = "";
+    // Record the sent prompt for recall: consecutive duplicates add one entry (re-sending the
+    // same nudge does not fill the history with copies), the oldest drop past the cap, and the
+    // recall position returns to the live draft for the next browse.
+    if (text && promptHistory[promptHistory.length - 1] !== text) promptHistory.push(text);
+    if (promptHistory.length > PROMPT_HISTORY_MAX) promptHistory.shift();
+    recallIndex = null;
+    recallDraft = "";
     if (target !== "director") setTarget("director");
     autosize();
     updateCount();