samagotchi 0.54.0 → 0.55.0

data/lib/samagotchi/web/public/thinking_chip.js

@@ -37,13 +37,12 @@ export function chipModel(summary, { kind = SESSION } = {}) {
   return { text: `think ${summary.level}${own ? ` · ${kind}` : ""}`, title, own };
 }
 
-// The session bar's chip, as a string: the info bar is still built as one
-// (app.js); it becomes a template when the info bar moves to lit.
-export function chipHtml(summary, escapeHtml) {
+// The session bar's chip (a lit-html template; info_bar.js), nothing
+// without a summary.
+export function chipTemplate(summary) {
   const chip = chipModel(summary);
-  if (!chip) return "";
-  return `<button type="button" class="model think-chip${chip.own ? " own" : ""}" title="${escapeHtml(chip.title)}" ` +
-    `data-think-chip aria-haspopup="dialog">${escapeHtml(chip.text)}</button>`;
+  if (!chip) return nothing;
+  return html`<button type="button" class=${`model think-chip${chip.own ? " own" : ""}`} title=${chip.title} data-think-chip aria-haspopup="dialog">${chip.text}</button>`;
 }
 
 // The /thinking line for a select value ("default" unsets the session's
@@ -81,7 +80,7 @@ export function formTemplate(summary, { running = false, kind = SESSION, choice
 }
 
 // The chip's popover, as createLlmContextControl's: el is where the chip
-// is drawn (clicks are delegated: #infoText is redrawn every tick);
+// is drawn (clicks are delegated: #infoText, info_bar.js);
 // summary(): the open session's thinking; session(): its id; running():
 // a turn runs; run(line): sends the command. The start page's (kind
 // NEW_CHAT): summary() is the picked model's, choice() the pending level

data/lib/samagotchi/web/public/turn_events.js

@@ -1,6 +1,8 @@
 // Pure helpers for the Bridge's turn events (no DOM), so app.js's handlers
 // stay thin and the logic runs under `node --test`.
 
+import { ACTIVITY_FIELDS, EVENT_FIELDS, pickFields } from "./activity.js";
+
 // The answer text of a :turn_completed event. `turn_summary.output` is the
 // contract; `result` is the KernelLoop result, which reaches the wire as its
 // string form (older servers, other clients' fixtures).
@@ -189,6 +191,11 @@ export function llmContextHover({ groups = [], freed_tokens: freed, tail_tokens:
   return lines.join("\n");
 }
 
+// A ✂ row's notice data (turnDom.notice, placeTurnNotice).
+export function llmContextNotice(data) {
+  return { line: llmContextLine(data), cls: "llm-context", title: llmContextHover(data) };
+}
+
 // The one muted line for a turn that ended with no answer (turn_completed's
 // turn_summary.empty_answer, or a reloaded turn's marker): the TUI words
 // it the same (TurnNote.empty_answer_line; spec/shared/labels_matrix.json).
@@ -229,257 +236,6 @@ export function initWaitLine({ tasks } = {}) {
   return `waiting for ${labels.length ? labels.join(" · ") : "plugins"}…`;
 }
 
-// Whether a composer line in an open session is one of its commands
-// (+commands+: the session GET's listing), as the terminals decide
-// (Commands::Registry#lookup): a "!" line with something after the "!", or
-// a listed name alone or followed by a space; a terminal's own (/stats,
-// /exit) too, which the page answers itself (webLocalReply). An unknown
-// "/word" (a path, a typo) goes to the model as a prompt, as in a terminal.
-export function sessionCommandLine(text, commands) {
-  const line = String(text || "").trim();
-  if (/^!\s*\S/.test(line)) return true;
-  if (!line.startsWith("/")) return false;
-  if (webLocalReply(line)) return true;
-  return (Array.isArray(commands) ? commands : [])
-    .some((c) => c && typeof c.name === "string" && (line === c.name || line.startsWith(`${c.name} `)));
-}
-
-// /cut TEXT and /queue TEXT: the UIs' own words for a delivery (listed
-// for Tab and /help, never run as commands; TerminalUI::Formatting's
-// STEER_CHOICE: the word, then any whitespace and the text). During a
-// turn /cut TEXT is the text sent as a cut (POST /turn, delivery "cut"),
-// as chi send --cut does; /queue isn't in the web yet (the page says so,
-// as the attached TUI does). With no running turn both are the text as a
-// normal turn. The bare word gets the usage line.
-// @return {{send: string, delivery?: string} | {reply: string} | null}
-//   null: not a delivery line
-export const STEER_CHOICE_USAGE = "(/cut and /queue need a message: /cut TEXT, /queue TEXT)";
-export const QUEUE_UNAVAILABLE_WEB = "(/queue isn't available in the web yet; a plain message goes in at the running turn's next step, and /cut TEXT cuts in)";
-const STEER_CHOICE = /^\/(cut|queue)(?:\s+([\s\S]*))?$/;
-
-export function steerChoiceRoute(text, { running = false } = {}) {
-  const match = STEER_CHOICE.exec(String(text || "").trim());
-  if (!match) return null;
-  const message = (match[2] || "").trim();
-  if (!message) return { reply: STEER_CHOICE_USAGE };
-  if (!running) return { send: message };
-  if (match[1] === "queue") return { reply: QUEUE_UNAVAILABLE_WEB };
-  return { send: message, delivery: "cut" };
-}
-
-// A line that is one word: a slash and a name, no spaces, no second slash
-// (Commands::Registry#unknown_command_word?). `/modle` is one; `/foo bar`
-// and `/usr/bin/env` are not (they are prompts).
-const UNKNOWN_COMMAND_WORD = /^\/[A-Za-z][A-Za-z0-9_-]*$/;
-
-// The hint for a command word no command answers (a typo like `/modle`),
-// or null when the line is not one: `Unknown command /modle. Did you mean
-// /model? /help lists the commands.` The "Did you mean" part needs a close
-// name among the session's commands and the page's own (webLocalReply).
-export function unknownCommandHint(text, commands) {
-  const line = String(text || "").trim();
-  if (!UNKNOWN_COMMAND_WORD.test(line)) return null;
-  if (sessionCommandLine(line, commands)) return null;
-  const names = (Array.isArray(commands) ? commands : [])
-    .map((c) => (c && typeof c.name === "string" ? c.name : null))
-    .filter(Boolean)
-    .concat(Object.keys(WEB_LOCAL_REPLIES));
-  const close = closestName(line, names);
-  return `Unknown command ${line}. ${close ? `Did you mean ${close}? ` : ""}/help lists the commands.`;
-}
-
-// The closest name within an optimal string alignment distance of 2, or
-// null. Ties go to the first in the list.
-function closestName(line, names) {
-  let best = null;
-  let bestDistance = 3;
-  for (const name of names) {
-    const distance = osaDistance(line, name);
-    if (distance < bestDistance) {
-      best = name;
-      bestDistance = distance;
-    }
-  }
-  return best;
-}
-
-// Optimal string alignment distance: Levenshtein, with an adjacent
-// transposition counting as 1 (so `/modle` is 1 from `/model`, as Ruby's
-// DidYouMean reads it).
-function osaDistance(a, b) {
-  const rows = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
-  for (let j = 0; j <= b.length; j += 1) rows[0][j] = j;
-  for (let i = 1; i <= a.length; i += 1) {
-    for (let j = 1; j <= b.length; j += 1) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);
-      if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
-        rows[i][j] = Math.min(rows[i][j], rows[i - 2][j - 2] + 1);
-      }
-    }
-  }
-  return rows[a.length][b.length];
-}
-
-// The terminal's own commands (a button in the web, or none yet): the
-// reply the page shows itself (they never go to the worker, which doesn't
-// know them), or null.
-const WEB_LOCAL_REPLIES = {
-  "/archive": "/archive: use the archive button in the session bar",
-  "/detach": "/detach: a terminal's command; close the tab to leave, the worker keeps running",
-  "/exit": "/exit: close the tab to leave; stop in the session bar stops the worker",
-  "/quit": "/quit: close the tab to leave; stop in the session bar stops the worker",
-  "/recap": "/recap: not in the web yet; a recap shows here by itself when you come back to an idle session, and /recap in a terminal (chi --attach) makes one now",
-  "/stats": "/stats: not in the web yet; each turn shows its time, the session bar the context use and speed (hover ctx for tokens and cost), and /stats in a terminal (chi --attach) has the rest",
-};
-
-export function webLocalReply(text) {
-  const name = String(text || "").trim().split(/\s+/)[0].toLowerCase();
-  return WEB_LOCAL_REPLIES[name] || null;
-}
-
-// The start page's first message when the page answers it itself
-// (webLocalReply: /stats, /exit …): shown there, with no session made just
-// to hold the reply. With images it is a message, as in a session.
-export function startPageReply(text, { images = 0 } = {}) {
-  return images ? null : webLocalReply(text);
-}
-
-// The start page's reply to a first message that needs no session at all
-// (2.29): its own command's reply (startPageReply), or the hint for a
-// command word no command answers (a typo like /modle) — the hint the page
-// shows in a session too, as a command bubble. Decided before the session
-// is created, so a first /stats or /modle leaves none behind. A null here
-// means the message goes to a session (a prompt, or anything with images).
-export function startPageReplyOrHint(text, { commands = [], images = 0 } = {}) {
-  if (images) return null;
-  return startPageReply(text) || unknownCommandHint(text, commands);
-}
-
-// The continue card's answers, as the terminal's continue prompt reads them.
-export function continueLine(choice, reason = "") {
-  const why = String(reason || "").trim();
-  if (choice === "no" && why) return `/continue no, ${why}`;
-  return `/continue ${choice}`;
-}
-
-// How to show a command_ran: `label` names another client (null for this
-// tab's own), `resync` says the conversation changed (!rollback, !cmd, a
-// continue answered no) and must be read again. An anytime command's
-// (`anytime`, D8) bubble is drawn at its command_queued, before the cards
-// it shows; its command_ran fills that bubble in (`commandId`). So is a
-// command queued for after the running turn (`queued`): its command_queued
-// (waits: "turn_end") draws it `waiting`, saying so, until it ran or was
-// dropped (styled as failed).
-export const QUEUED_TEXT = "queued: runs after this turn";
-
-export function commandView(event, myId) {
-  const own = isOwn(event.client_id, myId);
-  const waiting = event.waits === "turn_end";
-  return {
-    label: own ? null : clientLabel(event.client_id),
-    line: event.line || "",
-    text: event.output || (waiting ? QUEUED_TEXT : ""),
-    busy: event.status === "busy",
-    failed: event.status === "error" || event.status === "dropped",
-    resync: (event.changed || []).includes("messages"),
-    modelName: event.model_name || null,
-    anytime: event.anytime === true,
-    queued: waiting || event.queued === true,
-    waiting,
-    commandId: event.command_id || null,
-    // A card's action (Nudge…): no bubble unless it says something back.
-    hidden: event.card === true && !event.output && event.status !== "error",
-  };
-}
-
-// Whether a command_ran that re-read the conversation (`resync`) needs its
-// own bubble: the redrawn history ends with a command bubble for its line
-// (a `!cmd` appends its "!(<command>)\n<output>" message, which renders as
-// one), so a second bubble would show the output twice. +historyBubbles+:
-// the `.bubble.command` elements in document order; +line+: the event's
-// line. Only the last one counts: it is the redrawn history's end.
-export function historyHasCommandBubble(historyBubbles, line) {
-  const last = historyBubbles[historyBubbles.length - 1];
-  return !!last && last.querySelector(":scope > .command-line")?.textContent === line;
-}
-
-// What a prompt_restored (the worker rolled a failed turn back and handed its
-// prompt back) does in this tab: `refill` is the text for an empty composer,
-// only for a prompt this page sent (`sentIds`, its acks' enqueued_ids), so a
-// replay after a reload never refills stale text; `own`/`label` mark the
-// failed bubble shown again after the resync.
-export function restoreAction(event, { myId, sentIds, composerEmpty }) {
-  const origin = event?.origin || {};
-  const own = isOwn(origin.client_id, myId);
-  const sent = own && !!origin.enqueued_id && sentIds.has(origin.enqueued_id);
-  // The images go back as chips with the text.
-  return withImages({
-    refill: sent && composerEmpty ? event.prompt : null,
-    own,
-    label: own ? null : clientLabel(origin.client_id),
-  }, sent && composerEmpty ? event.images : null);
-}
-
-// A turn that fails fast can have its prompt_restored come over the stream
-// before the /turn ack names its enqueued_id: `early` (a Map) keeps such a
-// restore of this tab's own prompt by that id, and the ack takes it back
-// (restoreOnAck), so the prompt goes into the composer the ack would clear.
-export function keepEarlyRestore(event, early, { myId, sentIds }) {
-  const origin = event?.origin || {};
-  const id = origin.enqueued_id;
-  if (!isOwn(origin.client_id, myId) || !id || sentIds.has(id)) return false;
-  early.set(id, event);
-  return true;
-}
-
-// The ack's enqueued_id (already in sentIds) was restored early: what the
-// composer gets back (as restoreAction for an empty composer), else null.
-export function restoreOnAck(enqueuedId, early, { myId, sentIds }) {
-  const event = enqueuedId && early.get(enqueuedId);
-  if (!event) return null;
-  early.delete(enqueuedId);
-  return restoreAction(event, { myId, sentIds, composerEmpty: true });
-}
-
-// The /turn this kept entry was for failed: no ack comes, so nothing would
-// take it back. The whole map goes: this tab sends one turn at a time, so
-// every entry waits for an ack that is now never coming (an older one is
-// left over from a send that failed the same way).
-export function dropEarlyRestores(early) {
-  const count = early.size;
-  early.clear();
-  return count;
-}
-
-// The composer's text with a restored prompt put back into it: the restored
-// text alone when nothing is typed, else the typed text with the restored
-// prompt under it (the user typed between the restore and the ack; their
-// text must not be replaced).
-export function restoreInto(refill, current) {
-  const restored = String(refill ?? "");
-  const typed = String(current ?? "");
-  if (!restored) return typed;
-  if (!typed.trim()) return restored;
-  return `${typed.replace(/\n+$/, "")}\n${restored}`;
-}
-
-// What the composer holds once a /turn ack lands (4.13): the composer still
-// carries the text that was just sent, so that text goes (it is the history's
-// now) — but text typed since the send stays, and a prompt restored before
-// this ack (restoreOnAck's refill) is put back without replacing it. The
-// sent text is trimmed (turnText), so the composer's is too before they are
-// compared: a trailing newline or space must not keep the message; and an
-// image-only send (placeholders sent) leaves nothing worth keeping.
-// @param sent the text the turn was sent with
-// @param current the composer's text as the ack lands
-// @param refill the prompt an early restore handed back, if any
-export function composerAfterAck({ sent = "", current = "", refill = "" } = {}) {
-  const typed = String(current ?? "").trim();
-  const kept = !typed || typed === String(sent ?? "").trim() ? "" : current;
-  return restoreInto(refill, kept);
-}
-
 // What an event does to the prompt bubbles, as a list of ops for app.js:
 //   add   — a bubble for a prompt this tab hasn't shown (state queued /
 //           started / steered, labelled by its sender)
@@ -580,10 +336,11 @@ export function snapshotEvents({ current_turn: turn = null, queued = [], queued_
           closeText();
           const call = { iteration: part.iteration, call_index: part.call_index, tool: part.tool };
           if (part.label) call.label = part.label;
-          const title = part.title ? { title: part.title } : {};
-          const alias = part.called_as ? { called_as: part.called_as } : {};
-          const view = part.view ? { view: part.view } : {};
-          events.push({ type: "tool_call_started", ...call, params: part.params, ...title, ...alias, ...view });
+          // Its row fields, each in its place (activity.js ACTIVITY_FIELDS,
+          // EVENT_FIELDS), as the live events carry them.
+          const title = pickFields(part, ACTIVITY_FIELDS);
+          const fields = pickFields(part, EVENT_FIELDS);
+          events.push({ type: "tool_call_started", ...call, params: part.params, ...title, ...fields });
           if (part.status !== "running") {
             // The activity as the live event had it; action and duration_ms
             // only in snapshots from a worker that keeps them (the TUI's
@@ -591,11 +348,13 @@ export function snapshotEvents({ current_turn: turn = null, queued = [], queued_
             const action = part.action ? { action: part.action } : {};
             const completed = {
               type: "tool_call_completed", ...call, output: part.output, output_truncated: !!part.output_truncated,
-              activity: { ...action, tool: part.tool, status: part.status, params: part.params, ...title, ...alias },
+              activity: { ...action, tool: part.tool, status: part.status, params: part.params, ...title },
             };
+            // A grep that found nothing: its row stays muted "no match".
+            if (part.no_match) completed.activity.no_match = true;
             if (part.duration_ms != null) completed.duration_ms = part.duration_ms;
             if (part.diff) completed.diff = part.diff;
-            if (part.view) completed.view = part.view;
+            Object.assign(completed, fields);
             events.push(withImages(completed, part.images));
           }
           break;
@@ -637,6 +396,6 @@ export function snapshotEvents({ current_turn: turn = null, queued = [], queued_
 
 // +object+ with `images` when there are any (the shapes stay as they were
 // for a turn without).
-function withImages(object, images) {
+export function withImages(object, images) {
   return images?.length ? { ...object, images } : object;
 }

data/lib/samagotchi/web/public/turn_html.js

@@ -7,6 +7,7 @@ import { commandBlockHtml, rowHover } from "./command_view.js";
 import { copySourceAttr } from "./copy.js";
 import { activityDiffHtml } from "./diff_view.js";
 import { escapeHtml, userBodyHtml } from "./format.js";
+import { refAttrs } from "./refs.js";
 import { formatDuration } from "./timing.js";
 import { emptyAnswerLine } from "./turn_events.js";
 
@@ -81,7 +82,10 @@ export function toolRowHtml(row, { thumbs = () => "" } = {}) {
 export function toolRowInnerHtml(row, { thumbs = () => "" } = {}) {
   const shown = row.title || row.params;
   const hover = rowHover(row) ? ` title="${escapeHtml(rowHover(row))}"` : "";
-  const params = shown ? `<span class="activity-params"${hover}>${escapeHtml(shown)}</span>` : "";
+  // A row with a ref (a file tool's file) carries it on its title, which
+  // opens it, and its diff lines open it at their line (refs.js).
+  const ref = shown ? refAttrs(row.ref) : "";
+  const params = shown ? `<span class="activity-params${ref ? " ref" : ""}"${hover}${ref}>${escapeHtml(shown)}</span>` : "";
   // The name the model called the tool by when it was an alias's, dim.
   const alias = row.called_as ? `<span class="activity-alias">(called as ${escapeHtml(row.called_as)})</span>` : "";
   const duration = formatDuration(row.duration_ms);

data/lib/samagotchi/web/server.rb

@@ -66,7 +66,7 @@ module Samagotchi
       # @return [Integer] the exit status
       def self.launch(port: nil, host: nil, scope: "project", dir: Dir.pwd, open_browser: false, markdown: false,
                       view: Config::BY_KEY["web.view"].default, annotate_presets: Config::BY_KEY["web.annotate_presets"].default,
-                      new_token: false)
+                      editor: Config::BY_KEY["web.editor"].default, new_token: false)
         rotate_token if new_token
         setting = host_setting(host)
         lan = Lan.wanted?(setting) ? Lan.choose(setting) : nil
@@ -95,7 +95,7 @@ module Samagotchi
             return 0
           end
           if start(port: port, host: host, url: url, open_browser: open_browser, markdown: markdown, view: view,
-                   annotate_presets: annotate_presets, lan: lan)
+                   annotate_presets: annotate_presets, editor: editor, lan: lan)
             0
           else
             1
@@ -119,7 +119,7 @@ module Samagotchi
       # @return [Boolean] false when the port was taken (said so on stderr)
       def self.start(port: nil, host: nil, url: nil, open_browser: false, state_dir: nil, manager: nil, markdown: false,
                      view: Config::BY_KEY["web.view"].default, annotate_presets: Config::BY_KEY["web.annotate_presets"].default, hub: nil, lan: nil,
-                     token_path: Token.path)
+                     editor: Config::BY_KEY["web.editor"].default, token_path: Token.path)
         port = resolve_port(port)
         host = resolve_host(host)
         url ||= "http://#{url_host(host)}:#{port}/"
@@ -130,7 +130,7 @@ module Samagotchi
           lan_option = { ip: lan.ip, token: Token::Source.new(token_path) }
         end
         app = App.new(manager: manager, state_dir: state_dir, markdown: markdown, view: view,
-                      annotate_presets: annotate_presets, hub: hub, lan: lan_option)
+                      annotate_presets: annotate_presets, editor: editor, hub: hub, lan: lan_option)
         Samagotchi::Log.info(:web, "start", url: "http://#{host}:#{port}", version: Samagotchi::VERSION)
         Samagotchi::Log.info(:web, "lan", ip: lan.ip, interface: lan.interface) if lan
         # Subscribed before the first scan, which makes the first check.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: samagotchi
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.55.0
 platform: ruby
 authors:
 - Dmitry Dedov
@@ -260,6 +260,7 @@ files:
 - lib/samagotchi/engine_peers.rb
 - lib/samagotchi/events.rb
 - lib/samagotchi/extension_load.rb
+- lib/samagotchi/file_ref.rb
 - lib/samagotchi/gem_update.rb
 - lib/samagotchi/generation_phase.rb
 - lib/samagotchi/git_head.rb
@@ -457,6 +458,7 @@ files:
 - lib/samagotchi/tool_declarations.rb
 - lib/samagotchi/tool_ids.rb
 - lib/samagotchi/tool_response.rb
+- lib/samagotchi/tool_row_fields.rb
 - lib/samagotchi/tool_runner.rb
 - lib/samagotchi/tool_view.rb
 - lib/samagotchi/tools/args.rb
@@ -506,6 +508,7 @@ files:
 - lib/samagotchi/waiting_steer.rb
 - lib/samagotchi/web/app.rb
 - lib/samagotchi/web/capabilities.rb
+- lib/samagotchi/web/editor.rb
 - lib/samagotchi/web/info_probe.rb
 - lib/samagotchi/web/lan.rb
 - lib/samagotchi/web/markdown_renderer.rb
@@ -521,6 +524,8 @@ files:
 - lib/samagotchi/web/public/command_complete.js
 - lib/samagotchi/web/public/command_list.js
 - lib/samagotchi/web/public/command_view.js
+- lib/samagotchi/web/public/commands.js
+- lib/samagotchi/web/public/composer.js
 - lib/samagotchi/web/public/composer_size.js
 - lib/samagotchi/web/public/context_chips.js
 - lib/samagotchi/web/public/copy.js
@@ -532,8 +537,10 @@ files:
 - lib/samagotchi/web/public/hold.js
 - lib/samagotchi/web/public/images.js
 - lib/samagotchi/web/public/index.html
+- lib/samagotchi/web/public/info_bar.js
 - lib/samagotchi/web/public/init_row.js
 - lib/samagotchi/web/public/kept_commands.js
+- lib/samagotchi/web/public/lists_view.js
 - lib/samagotchi/web/public/live_timing.js
 - lib/samagotchi/web/public/live_turn.js
 - lib/samagotchi/web/public/llm_context_chip.js
@@ -544,6 +551,8 @@ files:
 - lib/samagotchi/web/public/prompt_history.js
 - lib/samagotchi/web/public/question_card.js
 - lib/samagotchi/web/public/question_cards.js
+- lib/samagotchi/web/public/refs.js
+- lib/samagotchi/web/public/restore.js
 - lib/samagotchi/web/public/route.js
 - lib/samagotchi/web/public/scope.js
 - lib/samagotchi/web/public/scroll.js
@@ -552,9 +561,9 @@ files:
 - lib/samagotchi/web/public/session_title.js
 - lib/samagotchi/web/public/sessions_list.js
 - lib/samagotchi/web/public/shown_texts.js
-- lib/samagotchi/web/public/stable_html.js
 - lib/samagotchi/web/public/stage_model.js
 - lib/samagotchi/web/public/stage_view.js
+- lib/samagotchi/web/public/stream_handlers.js
 - lib/samagotchi/web/public/strip.js
 - lib/samagotchi/web/public/tally.js
 - lib/samagotchi/web/public/task_stop.js

data/lib/samagotchi/web/public/stable_html.js

@@ -1,18 +0,0 @@
-// A block redrawn every tick (the info bar, once a second while a turn
-// runs) keeps its nodes: +html+ is written only when it changed, so a
-// shown tooltip stays up and a press on one of its buttons isn't lost to a
-// rewrite between mousedown and mouseup. +live+ ({selector: text}) names
-// the parts that change every tick (a running clock): +html+ carries them
-// empty and only their text is set, so a tick alone rewrites nothing else.
-const shown = new WeakMap();
-
-export function renderStable(el, html, live = {}) {
-  if (shown.get(el) !== html) {
-    el.innerHTML = html;
-    shown.set(el, html);
-  }
-  for (const [selector, text] of Object.entries(live)) {
-    const part = el.querySelector(selector);
-    if (part && part.textContent !== text) part.textContent = text;
-  }
-}