vrr/ouroboros
2
0
Fork 0
mirror of https://github.com/razzant/ouroboros.git synced 2026-10-19 10:04:16 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Merge published ouroboros changes into main-notice candidate

Browse source
This commit is contained in:
Ouroboros 2026-09-30 13:58:05 +03:00
commit de110f6ba7
182 changed files with 10681 additions and 2222 deletions
Download patch file Download diff file Expand all files Collapse all files

36
docs/DESIGN.md
View file

@ -463,6 +463,39 @@ renderer regardless of `markdown`; ordinary System text is escaped unless
Voice does not confer task finality. The existing untyped terminal-host-notice
contract remains a documented exception, not a pattern for new notices.
Main's empty-chat greeting speaks in neither voice: it is host copy in a quiet
`.chat-empty-welcome` placeholder (a `Welcome` label over one sentence), never a
bubble, a history row or a model reply (`web/modules/welcome_preference.js`). It
appears only after a successful recent history read whose own window reports
complete coverage, over a feed with no message or task card (the typing indicator
and the ephemeral reconnect notice are chrome, by the same rule that gives an empty
feed its history loading state). Every later read withdraws it while in flight, so
that loading state, then any failure, shows instead; only a complete answer brings
it back, and it leaves with the first message or task card. Project rooms never
show it.
The sentence is a hidden install-wide preference with no Settings control: the
`welcome` key of `state/ui_preferences.json` under the data root
(`~/Ouroboros/data` by default). Change only that key and keep the file's others:
```json
"welcome": {"mode": "default", "text": ""}
"welcome": {"mode": "hidden", "text": ""}
"welcome": {"mode": "custom", "text": "Good morning."}
```
`default` shows the built-in "Ouroboros has awakened", `hidden` shows nothing, and
`custom` shows `text` as plain text, never markup (nonblank, at most 500
characters; other modes retain but do not display valid text). The object has
exactly these two keys. Prefer `POST /api/ui/preferences` with `{"welcome": {...}}`:
it validates and merges the value (400 on refusal, without writing). For a hand
edit, stop Ouroboros, back up the file, and preserve valid whole-document JSON
and neighboring keys. An invalid welcome inside valid JSON falls back to
`default` independently; the next save stores that default. Malformed JSON
instead follows the existing whole-file fallback: all preferences read as
defaults, and a later save may replace the unreadable contents. Main reads the
preference when it opens and on every reconnect; there is no file watcher.
## 5. Card and section composition
- A panel is one `.ui-card`-family surface: `--ui-card-border`,
@ -547,7 +580,8 @@ destination; a Send that fails keeps it with the draft and files. Reading on,
even inside a bounded box, supersedes a ↓ or question still loading. A wheel,
swipe or key over a bounded box moves that box, not the conversation, until the
box reaches its edge.
A scrollbar drag follows new replies only when released at the live edge.
A scrollbar drag follows new replies only when released at the live edge; a
wheel, swipe or key reading down follows once its scrolling ends there.
Expanding a line or receiving its full output leaves it in place; only a newer
line moves a card timeline to its end.
New replies remain below in the same live conversation without moving the passage.