Skip to content
Pauta3.0.0

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) and ui/MessageLogPopup.java (the view); Torrenta carries the same pair.
  1. 1Title "Messages", 14 px bold.
  2. 2Filter, focused on open. Filters as you type; ↓ or Enter moves into the results without leaving the field.
  3. 3Entry. The time as HH:mm:ss (11 px, monospace, muted) and the message as it appeared in the echo line. Newest first.
  4. 4Severity colors the message, not the row: errors red, warnings amber, information in the default color. The time stays muted.
  5. 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.
  6. 6Key hint, muted, 11 px.
  7. 7Echo line. The status bar's latest message; a click opens the log.
  8. 8Unread errors. A red count beside the echo line while errors have arrived since the log was last opened; a click opens the log.
PropertyValueReference
KindA card in the shared in-scene overlay host, anchored just above the status bar’s echo area, over the windowMessageLogPopup.show, OverlayHost
Size773 px wide; the list 336 px high, scrolling past thatWIDTH, LIST_HEIGHT
Card-color-bg-overlay, radius 12, like the palette.message-log
RowsPadding 2 4, radius 5; selected row -state-sel.message-log-list .list-cell
CapacityThe newest 200 messages; older ones drop offMessageLog.MAX_ENTRIES
RepeatsA message repeated within 2 s moves to the top as one entry, unread onceREPEAT_MILLIS
LifetimeThis session only, in memory. Not written to disk: the Debug Log is the persistent recordMessageLog
Blank messagesNot recorded (a blank message only clears the echo line)MessageLog.add
  • MLOG-02 SHOULD A click on the echo line or on the unread-error count opens the log, as does the view.messageLog command.
    • Check (code): both status-bar nodes run view.messageLog on a click.
    • Reference: Editora StatusBar (echo, unreadErrors), StatusBar.showMessageLog.
  • MLOG-03 SHOULD Esc, C-g or 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.
  • MLOG-04 SHOULD Ctrl+C (Cmd+C on 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 contains fail or error is an error, one containing cannot or invalid a 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 clear zeroes the count.
    • Reference: Editora MessageLog.markRead, MessageLog.clear, StatusBar.showMessageLog.
  • 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).
KeyEnglish
messagelog.titleMessages
messagelog.filterFilter messages…
messagelog.emptyNo messages yet
messagelog.copy / messagelog.clearCopy / Clear
messagelog.doctorOpen Doctor
messagelog.hintEsc to close
Editora's Message Log popup above the status bar
Editora.

Pauta 3.0.0 · · Changelog · This page in the latest edition