Message Log
The status bar’s echo line shows one message and replaces it with the next; the Message Log keeps them, so nothing the app said is lost because it scrolled past.
- MLOG-01 MUST Every app with a status bar keeps a Message Log: the session’s status-bar messages, newest
first, opened from the status bar.
- Check (code): every status-bar message is also added to one log model, and a view lists that model.
- Reference: Editora
ui/MessageLog.java(the model, no JavaFX) andui/MessageLogPopup.java(the view); Torrenta carries the same pair.
Anatomy
Section titled “Anatomy”Messages1
Filter messages…
214:32:07Saved Shelf.java3
14:31:52Language server for Java failed to start: jdtls was not found4
14:30:18Settings sync: not connected, retrying
14:29:40Line numbers: on
14:29:05Opened ~/workspace/shelf/src/main/java/com/example/shelf/Shelf.java
- 1Title "Messages", 14 px bold.
- 2Filter, focused on open. Filters as you type; ↓ or Enter moves into the results without leaving the field.
- 3Entry. The time as
HH:mm:ss(11 px, monospace, muted) and the message as it appeared in the echo line. Newest first. - 4Severity colors the message, not the row: errors red, warnings amber, information in the default color. The time stays muted.
- 5Actions: Copy (the visible entries as text), Clear (empties the session log and its unread count), and Open Doctor: messages carry no actions of their own, and a missing tool or a server that would not start is where Doctor helps.
- 6Key hint, muted, 11 px.
- 7Echo line. The status bar's latest message; a click opens the log.
- 8Unread errors. A red count beside the echo line while errors have arrived since the log was last opened; a click opens the log.
| Property | Value | Reference |
|---|---|---|
| Kind | A card in the shared in-scene overlay host, anchored just above the status bar’s echo area, over the window | MessageLogPopup.show, OverlayHost |
| Size | 773 px wide; the list 336 px high, scrolling past that | WIDTH, LIST_HEIGHT |
| Card | -color-bg-overlay, radius 12, like the palette | .message-log |
| Rows | Padding 2 4, radius 5; selected row -state-sel | .message-log-list .list-cell |
| Capacity | The newest 200 messages; older ones drop off | MessageLog.MAX_ENTRIES |
| Repeats | A message repeated within 2 s moves to the top as one entry, unread once | REPEAT_MILLIS |
| Lifetime | This session only, in memory. Not written to disk: the Debug Log is the persistent record | MessageLog |
| Blank messages | Not recorded (a blank message only clears the echo line) | MessageLog.add |
Behavior
Section titled “Behavior”- MLOG-02 SHOULD A click on the echo line or on the unread-error count opens the log, as does the
view.messageLogcommand.- Check (code): both status-bar nodes run
view.messageLogon a click. - Reference: Editora
StatusBar(echo,unreadErrors),StatusBar.showMessageLog.
- Check (code): both status-bar nodes run
- MLOG-03 SHOULD Esc,
C-gor a click outside closes the log.- Check (code): the card’s key handler hides it on Escape and
C-g; the overlay’s backdrop hides it on a press. - Reference: Editora
MessageLogPopup,OverlayHost.
- Check (code): the card’s key handler hides it on Escape and
- MLOG-04 SHOULD
Ctrl+C(Cmd+Con macOS) copies the selected entries.- Check (code): the card’s key handler copies the selection on the shortcut-down C.
- Reference: Editora
MessageLogPopup.copySelection.
- MLOG-05 SHOULD A message’s severity comes from its key: a
status.*key whose last segment containsfailorerroris an error, one containingcannotorinvalida warning. Name new keys accordingly, or report through the error channel directly.- Check (test): a severity test classifies keys by those rules.
- Reference: Editora
ui/StatusSeverity.java(ofKey),StatusSeverityTest.
- MLOG-06 SHOULD Opening the log, or clearing it, resets the unread-error count.
- Check (code): opening the log marks it read, and
clearzeroes the count. - Reference: Editora
MessageLog.markRead,MessageLog.clear,StatusBar.showMessageLog.
- Check (code): opening the log marks it read, and
- MLOG-07 SHOULD An unread error is never evicted silently: the count keeps it even when the entry drops off
the end.
- Check (test): an error pushed past the capacity still counts as unread.
- Reference: Editora
MessageLogSeverityTest(anEvictedErrorStillCounts).
| Key | English |
|---|---|
messagelog.title | Messages |
messagelog.filter | Filter messages… |
messagelog.empty | No messages yet |
messagelog.copy / messagelog.clear | Copy / Clear |
messagelog.doctor | Open Doctor |
messagelog.hint | Esc to close |
In the apps
Section titled “In the apps”
Pauta 3.0.0 · · Changelog · This page in the latest edition