Expand description
The two rituals, for the window (docs/reviews.md): closing the work day
(“Done for today”) and closing the day before sleep, each with how the day
felt, all of it optional. The sheet’s view (DayReview.qml), the answers
kept (sioul_core::reviews), the status line’s offer, the one notice at the
end of the day’s last work or admin hours, and a day’s words for the Health
page. Words only: no count, no score, nothing about what was not done.
Structs§
- Offered 🔒
- A button of a closing notice: its words, and what it opens in the window
(
reminder_opened: “review” with “work” or “night” and the day it is for, “work:2026-10-14”, or “need” with a block’s key).
Enums§
- Work
Notice 🔒 - What the end-of-work notice does at a moment (
work_notice).
Constants§
- BACK_
DAYS 🔒 - The notes of the last days, read back in the sheet.
- NOTICE_
GRACE 🔒 - The end-of-work notice comes within this long of the hours’ end, or not at all.
- PHONE_
NOTICE_ 🔒KEPT - A phone’s notice stays in the shade this long after it comes at most,
then goes (the work’s at the turn of the day, 05:00, if sooner; the
night’s at waking): its press carries its day, and opens nothing once the
day turned (
view).
Functions§
- asked 🔒
- A sheet asked for: “work” or “night”, and the day it is for when a notice’s press carries one (“work:2026-10-14”); none for words that are neither.
- balance_
lines 🔒 - The day’s costs and gains in words, for the night: each scale whose level is known that day (“Thinking: heavy for you.”), the gain (“Some time gave back.”), then the plan’s own lines when the day changes tomorrow’s. Never a number, a percentage or a gauge (criteria CB45–49, G20).
- balance_
words 🔒 - The balance in words, in
tr‘s language: a scale not known that day says nothing (CB12), the total is the scales’ own; the gain in two words. - capitalized 🔒
- The first letter capitalized (“lundi” → “Lundi”).
- close 🔒
- The review kept for
date, the day its sheet was opened for (view), though the day turned meanwhile (a sheet opened at 04:58 and closed at 05:01 closes the day it showed; none given, the day ofkindnow); then for the work day the day closed as “Done for today” always did, unless it was already today, or the sheet was an earlier day’s: the closing screen’s JSON, else “”. The night: the status line says the day is closed. A review that cannot be kept is said; the work day closes all the same. - closes_
the_ 🔒work_ day - Whether closing a work day’s sheet closes the work day itself, as “Done for today” always did: only today’s, not closed yet; an earlier day’s sheet (opened before the turn of the day, closed after it) keeps its review alone, and never closes a day not begun.
- coming_
work 🔒 - When the end-of-work notice may come in the next days, for a phone’s
alarms (
eventalarms::coming): at the end of each day’s last work or admin hours, today’s while it may still come; each (day:work:<date>, Unix seconds). A time just past stays as it was, so that the list stays the same from one minute to the next: Android rings it at once. - day_
name 🔒 - “Tomorrow”, “Monday”, “Monday 19 October”: the nearer, the shorter.
- day_of 🔒
- The day a review closes, given now: the night’s day (after midnight, the evening before); the work day’s, today (before 05:00, yesterday).
- decide_
work 🔒 - A phone’s alarm at the end of work (
eventalarms, “day:work:…”): the notice as the window’s minute decides it on a computer (work_notice), who keeps the notices read, never claimed, from there: Sioul may be put away, or not running (share::looked). Shown in Android’s notifications with “Close the work day”, which opens Sioul on the sheet. {“shown”: true} once shown, its press carrying its day; {“again_at”: ms} rung early, kept here only lately, or held by the matrix while its ten minutes last, asked each minute as a computer’s minute asks it; {} when it does not come, nor asked again that day once it cannot (work_notice). - first_
step_ 🔒line - The first step named when the work day closed, for the day work comes back: “Tomorrow starts with: open the form (15 min)”. A plan for what remains helps sleep come (Scullin et al. 2018); none when none was named.
- line 🔒
- A day on the Health page, as JSON: its words when some were said (“How the day went: Morning: haze · End of work: heavy…”) and its notes; today, the button to close it while the evening offers it, and during the night.
- mark_
told 🔒 - meeting 🔒
- Whether an event goes on now (not a whole day’s, not cancelled).
- memo_
html 🔒 - A review’s note as the sheet and the Health page show it: Markdown read as Notes reads it.
- next_
turn 🔒 - The turn of the day (05:00) next after
end, when the work day it ended is no longer the one the sheet closes (day_of), Unix seconds; six hours on where the zone has no such time. - night 🔒
- The night going on or coming next, as Health keeps it: (winding down from, bed at).
- night_
open 🔒 - Whether the night’s review of the night
bedbelongs to is still to give: its notice then offers “Close the day”. - notice_
decision 🔒 - The end-of-work notice’s decision (
work_notice), each thing read only when those before let it on, in this order: whether it isdue(its ten minutes, not told yet); what the day offers (offer): anything but the work day’s (closed, its review given, the evening’s offer instead), and it cannot come that day, told fortodayand never asked again; whether the matrix of what reaches you lets it come now (comes): held while it does not; ameeting: nothing said, told; who keeps the notices (keeper), asked last. Gives the decision, and the day to mark told, if any. - notice_
offer 🔒 - What the notice “Work hours are over” would offer at
now, as the status line does, whatever the time now is for: the matrix of what reaches you says apart when it may come (work_notice). - offer_
at 🔒 - What the status line offers at
now, inmode. - offer_
json 🔒 - For the status line (
mode_json): {kind, date, line, button}; kind “” when nothing is offered: at work, while you sleep, once said. - show_
notice 🔒 - A closing notice (the end of work’s, the night’s), as the system shows it
(docs/reviews.md, “The notices”): on Linux and macOS with its buttons
(
notify::remind_offering), each opening what it offers; on Windows through Sioul’s icon in the tray (main.qml’sonTrayNotice, Tray.qml), whose message carries no button: a click opens what the first one offers. A phone’s are its alarm’s (decide_work,health::decide_night). - standing 🔒
- Where the day stands at
now, as the offer reads it: today’s end of work, the night, whether the work day was closed, and the reviews of yesterday and today. - still_
due 🔒 - Whether the end-of-work notice may still come at
stamp, the hours having ended atend(Unix seconds): within its ten minutes, never before. - tick 🔒
- Each minute: the end-of-work notice when it comes (
work_notice), “Work hours are over”, with “Close the work day”. On a phone its own alarm says it, Sioul shown or not (decide_work). Off the window’s thread. - told 🔒
- told_
path 🔒 - The day the end-of-work notice was given, on this device.
- view 🔒
- The sheet for
what(“work”, “night”), as JSON: its title and the day it closes; how the day started and went, in words; for the night the work’s review, tomorrow’s first step and the day’s balance; the answers already given (closed once, the sheet opens on them); the notes of the last days. A notice’s press carries its day (“work:2026-10-14”): pressed once the day turned (05:00 for the work day, the evening for the night), it opens nothing (“null”), rather than the sheet of a day not begun. - weather_
said 🔒 - The weather said for today, copied as the morning’s (
reviews::note_weather). - work_
day 🔒 - The work day a sheet closes at
now: today; before the turn of the day (05:00), yesterday. A notice’s button carries it, so that hours ending after midnight open the sheet of the day they belong to. - work_
end 🔒 - Today’s last hours of work or admin end then; none on a day without them, or in time off.
- work_
end_ 🔒on date’s last hours of work or admin end then, inzone; none on a day without them, or in time off.- work_
notice 🔒 - The end-of-work notice at
now: at the end of the day’s last work or admin hours, within ten minutes of it, once on this device (told); at the times the matrix of what reaches you lets it come (as usual, never while you sleep or work); never during a meeting, nor once the day was closed or its review given, nor when the evening’s offer takes its place: then it is told for the day, never asked again; from the device you are at, askeepersays it (the “notices” lease), asked last. The window’s minute and a phone’s alarm both decide it here (tick,decide_work).