Bring the docs up to the chat window we actually built

The readmes still described a single expand glyph and a chevron for saved chats, and neither knew about the banner, the two expanded sizes or the shortcuts list.
2026-08-09 13:45:30 -04:00
parent 66f9d6f435
commit 4b6c5fe1cc
3 changed files with 30 additions and 7 deletions
@@ -128,8 +128,20 @@ composed from a prefix so instances can coexist, and each tears down the previou
 prefix, because Unraid swaps tab content by AJAX without unloading the old page's JavaScript.

 A placement chooses how much room it gets and which extra controls it needs. It does not choose
-the shape: the control row is fixed everywhere — profile chip hard left, `⤢` `▾` `New` `Ask` hard
-right — because a chat that rearranges itself per tab is three components wearing one name.
+the shape, because a chat that rearranges itself per tab is three components wearing one name.
+The layout is fixed everywhere:
+
+- **Banner** — title, then `Medium`/`Large` and `Shortcuts` at the right.
+- **Transcript**.
+- **Composer**, then one row grouped by what each control acts on: the profile chip at the left
+  for what is *answering*, `New` `Saved` `Ask` centred for what you do to the *conversation*, `⤢`
+  at the right for what you do to the *window*.
+
+`⤢` and `Medium`/`Large` are deliberately separate: whether the conversation is expanded is an
+action taken constantly, how much expanded is worth is a preference set once. The shortcuts list
+is subtracted from the transcript rather than added above it, so opening it never changes the
+window's total height — which matters on the Scheduler, where that height is a fixed share of a
+panel that clips.

 The Scheduler panel was exactly that until it was folded in, and it proved the cost: a thread
 there died on reload while the other two were saved, and its bar had drifted into a different
@@ -61,8 +61,10 @@ as the GPU and UPS cards.
 | Conversations | The last `$AI_CHAT_HISTORY_MAX` chats. Click to reopen, × to delete |
 | Assistant | Ask a question without leaving the dashboard |
 | Profile chip | Which contract answers — General Chat, Varaverk Assistant, Code Sketcher, Troubleshoot |
-| ⤢ | Trades more room for the conversation, and back. Always opens at the smaller size |
-| ▾ | Saved conversations, the same ones the Conversations card lists |
+| ⤢ | Expands the conversation, and collapses it again. Always opens collapsed |
+| Medium / Large | In the banner, once expanded — how much room expanding is worth |
+| Shortcuts | In the banner — the keyboard list, paid for out of the transcript rather than added to it |
+| Saved | Saved conversations, the same ones the Conversations card lists |

 ---

@@ -176,8 +176,10 @@ on disk is never touched until you press Save.
 | **+ Folder** | Custom Scripts | A collapsible subfolder you can drag scripts into |
 | **why? / recap** | Recent Activity | Opens that run's log and asks the assistant about it in one click |
 | **Profile chip** | Assistant | What is answering, and what it is pointed at. Click to change the profile |
-| **⤢** | Assistant | Trades more of the panel for the conversation, and back |
-| **▾** | Assistant | Saved conversations, shared with the AI tab and the Monitor dashboard |
+| **⤢** | Assistant | Expands the conversation into the panel, and collapses it again |
+| **Medium / Large** | Assistant banner | How much of the panel expanding is worth — 20% or 40% |
+| **Shortcuts** | Assistant banner | The keyboard list. Taken out of the transcript, so the panel keeps its height |
+| **Saved** | Assistant | Saved conversations, shared with the AI tab and the Monitor dashboard |
 | **New** | Assistant | Starts a fresh conversation; the old one stays in the store |

 ## Reference — orchestrator and step behaviour
@@ -197,11 +199,18 @@ on disk is never touched until you press Save.
 The right-hand panel is the default view and everything returns to it. **← Scheduler Info** comes
 back here from any log, editor, conf form or script view.

- **Notification board** — how many jobs are scheduled out of the total, and what is running now.
+- **Notification board** — how many orchestrators are scheduled, how many scripts carry a cron of
+  their own, and what is running now. Pinned, so it stays visible while you read the rest.
 - **Next Runs** — what fires next, and when.
 - **Recent Activity** / **Recent Errors** — described above.
 - **Cron Calculator** — described above.

+The board counts **orchestrators**, not scripts. A schedule here is normally one cron on an
+orchestrator that then calls its steps in order, so the steps are deliberately cronless — counting
+them made a fully-scheduled system read as `10 / 82 scheduled`, which is alarming and wrong. Steps
+that *do* carry their own cron are counted separately as standalone, because that is the exception
+and the number of exceptions is the figure worth knowing. It shows only when there are any.
+
 ## Reference — Advanced mode

 The **Advanced** button at the top right turns blue when active. It is a display and editing