Module work 

Tasks, notes, links and focus behind the window (docs/tasks.md).

Tasks are written to their list’s folder at once, then the account’s sync sends them, as contacts and events are. The plan is computed again after every change, on a thread; the window only lays out what the core worded. Everything links reach (tasks, events, contacts, notes, drafts, mail headers) is read once per change and kept, so the Related panel answers at once.

Structs

Closed 🔒

The day closed: the screen to show, when work comes back, and its first step.

Closing 🔒

The screen after closing the day, read in ten seconds: where work went and when it comes back, what got done if anything, the first step, what still gets through. Nothing counts what was not done (docs/tasks.md).

Deadline 🔒

A date asked that falls before work comes back: told once, at closing.

Desk 🔒

The plan, and what it needs, from what was read.

FirstStep 🔒

The plan’s first step when work comes back: in words, and its task.

FocusShown 🔒

Found 🔒

KindChoice 🔒

ListChoice 🔒

NoteRow 🔒

NotesShown 🔒

ProjectChoice 🔒

TasksShown 🔒

What the task page shows: its four views at once, so switching is instant.

WorkState 🔒

What the task pages ask for: the list’s grouping, done tasks, a search, one project, one kind and category. All but the searches are kept between sessions.

Constants

EVENTS_AHEAD 🔒

How far ahead events take their time out of the plan’s room: four weeks.

NOTES_FOLDER 🔒

Where new notes go in the notes folder, unless the configuration says otherwise.

Statics

DAY_STEPS 🔒

Today’s steps as the day’s layout last laid them: (start, end, title).

SHOWN_ANYWAY 🔒

Asleep, the tasks all the same: the page asked (“Show anyway”), until it is left.

Functions

account_of 🔒

The account a task file syncs through.

add 🔒

A task from a typed line, a step of parent when given.

answer 🔒

calm_sounds 🔒

Your recordings to rest by: the sounds in a sounds folder of the notes (its names in the languages in use: words.tasks.sounds_folders), as JSON [{“title”, “url”}].

capitalized 🔒

The first letter capitalized, for a word starting a sentence (“lundi” → “Lundi”).

captured 🔒

What a typed line says, before it becomes a task: its chips, as JSON.

categories_in_use 🔒

Every category tasks have, those of open tasks first, the most used first.

change 🔒

Changes one task’s file with change, unless it can only be read.

closing 🔒

Closes the day in the plan: today’s room is taken away and everything flows on to the next days with room, as each morning; nothing is written into the tasks. Computed before the overrides change.

conflict_path 🔒

A free name beside a note for a version of it that lost the race: “Plan (conflict 2026-10-05 21.50).md”, named as the sharing names its copies, the same whatever the language (share::conflict_name).

create 🔒

Makes a task in a list; returns its UID.

create_note 🔒

create_note_in 🔒

A new note in a folder of the notes (“” for the notes’ own folder); returns its path.

create_task 🔒

A task in a list kept on this computer only, made the first time with list_name: what must never reach a server (health errands). Returns its UID. A task made in a list (“account/id”); returns its UID.

day_name 🔒

“tomorrow”, “Monday”, “Monday 19 October”: the nearer, the shorter.

day_steps 🔒

Today’s steps as last laid out, for the Health page’s day: faded, for context.

delete 🔒

Deletes a task after ten seconds to undo; its steps stay, as tasks of their own.

draft_about 🔒

A draft about anything: its title as subject, the people it involves as recipients (an event’s guests, a contact, the contacts tied to it), the thing linked. Returns its id.

draft_for_task 🔒

A draft to the people a task involves, linked both ways; returns its id.

event_ref 🔒

An event’s file and its ties.

event_task_edit 🔒

The task to prepare an event (the occurrence at start), before it is made.

find 🔒

find_task 🔒

A task by its UID, as last read.

focus_extend 🔒

More minutes for the session.

focus_json 🔒

focus_pause 🔒

Pauses the session, or goes on.

focus_start 🔒

Starts a focus session on a task; one already running ends first, kept.

focus_stop 🔒

Ends the session: kept with where you stopped; done marks the task done. Returns what it changed, in a sentence.

laid 🔒

The minutes the plan lays for a task, its margins with it (plan::Planned::laid); None when it plans none.

link 🔒

Ties two things, in the one that can hold the link: a task (its list syncs it to your other devices), an event whose calendar can be written, a note’s front matter; else the local file, as a message is never changed. Returns what the line says.

linked_edit 🔒

What a task made from from starts with: a message’s subject, the message linked, its sender and project; for an event, “Prepare: …”, its day as the date asked, the event linked, its projects; else the thing’s title and a tie to it (a contact involved, a project, a note describing it, anything related).

links_changed 🔒

What the links read is read again at the next question, and the open pages are told to ask: a tie made or undone shows at once.

list_accounts 🔒

The accounts a task list can be made in: contacts-and-calendars accounts (a Google one makes it in Google Tasks), and “local”.

loaded 🔒

Everything read, kept until the next change.

local_task 🔒

mail_note 🔒

A draft sending a note to the guests of the event it is about; returns its id.

mail_task_edit 🔒

A message’s task, before it is made.

make_folder 🔒

A new folder in parent; returns what went wrong, else “”.

make_linked 🔒

Something new tied to from: “task” or “note” (made here), “mail” (a draft). key and start say which message or which occurrence, when it is one. Returns {“uid”}, {“path”}, {“draft”} or {“error”}.

memo_url 🔒

Where a new audio memo is recorded: <notes>/memos/2026-10-03 18.40.ogg, as a file URL, its folder made; “” without a notes folder.

message_card 🔒

The message’s card, and its file.

move_task 🔒

A task moved to another list, its steps with it: written there, then taken out here (the accounts send both). When the list would not keep something the task uses, nothing moves until confirmed: returns {"losses": [words]}, else {"uid"} or {"error"}.

new_form 🔒

The form of a task not made yet, as task gives one made (no card: it is not read yet): blank, or what Add ▾ makes from from (key, start: which message, which occurrence). In list, else the usual list; what that list keeps. Nothing is written: save with an empty UID makes it, once it has a title. {“error”} when what it comes from is gone.

new_list 🔒

Makes a task list; the next sync creates it on the account’s server (“local”: kept here only).

new_note 🔒

A new note in the notes folder, its front matter linking links; returns its path, or “”.

not_now 🔒

Puts a task off until tomorrow.

note 🔒

One note: its text, its HTML, its tags and checkboxes, and what is tied to it, as JSON.

note_from_event 🔒

A note for an event: dated, the guests listed, linked both ways (the event’s LINK when its calendar can be written, the note’s front matter always).

note_from_mail 🔒

A note from a message: its subject as title, the message linked, its text quoted.

note_path_of 🔒

The vault path of a file URL in the notes folder: what opens a memo once recorded.

notes_folder 🔒

The folder new notes go into, in the notes folder: yours, else “notes”.

notes_list 🔒

read_loaded 🔒

Reads everything again, leaving out what waits ten seconds to be deleted.

refresh 🔒

Something changed on disk (a project, time noted, an invoice): read again.

related 🔒

What a thing is tied to, both ways, as JSON.

remove_folder 🔒

An empty folder taken out; returns what went wrong, else “”.

remove_routine 🔒

A routine taken out; returns what went wrong, else “”.

rename_category 🔒

A category renamed on every task that has it, or taken off them all (to empty); a name already there merges with it. Written at once, then the accounts send the changes.

rename_folder 🔒

A folder renamed, its notes with it, and everything naming them following; returns {“path”} or {“error”}.

rename_note 🔒

A note renamed, the notes, tasks and ties that name it following; returns {“path”} or {“error”}.

retarget_note 🔒

What names a note by its address follows it to its new path: the tasks’ links (changed, then sent), and the ties Sioul keeps itself.

retitle 🔒

A task renamed from its time block (its event’s form): its title only, from its file as it is.

rewrite 🔒

Writes what makes or undoes a tie, and has the account of a task or an event send it.

routines 🔒

The routines, as the page lists them: the admin window’s first (made from what is there now), then yours, each with its steps as lines to change.

save 🔒

Saves the task form; an empty UID makes a new task in list. Returns {“uid”} or {“error”}.

save_note 🔒

Saves a note’s text; returns what went wrong, else “”.

save_routine 🔒

A routine saved (new when id is empty) from its title and its steps, one a line; returns what went wrong, else “”.

search 🔒

Open tasks whose title holds query, for “waits for” and “a step of”: [{uid, title, list}].

search_notes 🔒

Shows the notes matching query.

search_things 🔒

Things to tie from to: matching query, of kind (“” for all), as JSON.

sender_contact 🔒

The sender of a message as a task’s CONTACT: their card when they have one.

set_at 🔒

A task pinned to a time (“2026-10-06T14:30”, your time zone) for minutes (0: as long as its block is, else what the plan lays for it), or left to the plan again (“”): its time block, an event, made, moved or taken away (blocks); its own dates stay as set (docs/tasks.md, “The plan proposes; your dates stay yours”, “Pinned to a time”); the day is laid again at once, and “Undo” offered for ten seconds. Returns what went wrong, else “”.

set_felt 🔒

How a task was, felt (“How was it?”): today’s rating, JSON {cognitive, emotional, anxiety, body, gain} (null: unsaid, never the forecast copied), written alone from the file as it is, whatever the window last read; every value null takes today’s back. Returns what went wrong, else “”.

set_filter 🔒

Tasks of one kind and one category only (“” for all), kept for next time.

set_notes_tree 🔒

set_status 🔒

Done, started, open again or dropped; returns what it changed, in a sentence.

set_stopped 🔒

A line left on where you stopped, about the task the timer runs for, if any; an empty line: done. Returns what went wrong, else “”.

set_view 🔒

The task page’s choices: how the list is grouped, done tasks, a search, one project.

set_view_flag 🔒

set_waits 🔒

Waits for other, or no longer. Without a gap, DEPENDS-ON in the task that waits. With one (gap_minutes: “the answer comes within two weeks”), FINISHTOSTART with its GAP in other, the one that comes first, as sioul tasks import writes it (tasks::set_gap, RFC 9253 §4), and no DEPENDS-ON beside it. No longer: both taken away, and a FINISHTOSTART or NEXT that another application wrote in other for the pair.

set_weather 🔒

How today is: “clear”, “haze” or “fog”.

settings 🔒

The room for tasks: your hours, each kind for its own tasks, less the events of the coming weeks and the blocks tasks are pinned to; today’s from now, scaled by the weather.

show_anyway 🔒

show_work 🔒

Reads everything again, computes the task and notes pages on a thread, and shows them.

situation 🔒

The moment, for the task pages: quiet or not, offices open or not.

stopped 🔒

Where you stopped, as JSON: {text, when, task, title}; “null” when no line is left.

target_list 🔒

The list a new task goes into: the one chosen (“account/id”), else the usual one (Tasks ⚙, “New tasks go into”), else the first made for tasks.

task 🔒

One task in full, with its lists and what it is tied to, as JSON.

task_from_event 🔒

A task to prepare an event: its date the event’s day, the event linked.

task_from_line 🔒

A task from a checkbox line of a note: its text, the note linked.

task_from_mail 🔒

A task from a message: its subject, the message linked, its sender, its project.

text_stamp 🔒

A fingerprint of a note’s text as it was read, given back when it is saved.

today_laid_out 🔒

Today, laid out: the events of today and the steps the plan gives today, those the page shows.

trash_note 🔒

A note moved to the vault’s trash, “Undo” offered; returns what went wrong, else “”.

unlink 🔒

Undoes a tie wherever it is written: a task, an event, a note’s front matter, the local file. A step, a wait, a guest or a link in a note’s text are changed where they are: that is said.

uri_of 🔒

The address of a thing a page knows by its file or id: a message’s file (“mail”), a note’s path, a task’s, an event’s or a contact’s UID.

view_flag 🔒

Notes as a tree of folders, or as one list; kept between sessions. How a page was left: a column folded, a section open.

writable_lists 🔒

The lists a task can go into.

write 🔒

Writes a task file, has its account send it, and shows everything again.

write_gaps 🔒

The waits the form gave a gap (TaskEdit::wait_gaps), written in the tasks waited for, as sioul tasks import writes them (tasks::set_gap): once the task that waits is written. What fails is said in the status line; the task itself is kept.