Module taskview 

What the task pages show, in words: the next step and why, the board, the list, the timeline, one task in full. The core decides and words it; the window only lays it out (docs/architecture.md).

The words follow docs/tasks.md: nothing is “overdue”, “late” or “missed”; a date asked is said as the time left, and once passed only as the date it was; a day to start that passed says nothing at all; nothing commands, and nothing counts what you did not do.

Structs

BarView

One bar of the timeline.

BoardView

The board: free to start, started, waiting, done.

CardView

One task, as every view shows it.

ColumnView

One column of the board.

Context

What every view needs.

DayHead

One day of the timeline’s head.

DetailView

One task in full, for its panel.

Filter

What the task pages show: tasks of one kind, of one category; empty, all of them. The plan stays whole: a call that waits for a message still waits for it.

GroupView

A group of the list: a project, or a list.

ListView

NowView

The Now page: the next step, why, and the one after it.

Offices

Whether offices are open now, for tasks that need one.

PinView

Where a task is pinned, as its panel shows it.

RelatedView

Something tied to the task open, in words.

TimelineView

Constants

OPTIONAL_JOY 🔒

The groups of the list that hold optional tasks.

OPTIONAL_SOMEDAY 🔒

Functions

alike 🔒

Whether two steps rank alike, before their titles and ages break the tie.

board

The board shows the steps you act on: a bigger task stands for itself only when all its steps are done.

card

A task in words.

dates_after 🔒

The open tasks that wait for this one, further down too, with a date asked still ahead: (title, date), the soonest first.

days_between 🔒

Days from today to date.

detail

done_effect

What finishing a task changed, in one line: what it frees, or the bigger task now complete. Empty when nothing visible changed.

due_text 🔒

The date asked, as time left; once passed, only the date it was.

estimate_text

“About 15 minutes”, “About an hour”, “About 1 h 30”.

gap_words 🔒

A wait’s gap in words: “a day after it”, “two weeks after it”, “three hours after it” (a gap another program wrote in hours); “” without one.

list

The list: every open task, a bigger task followed by its steps, in the plan’s order, grouped by project (“project”) or by list (“list”). Done tasks of the last two weeks come last when done is asked.

minutes_text 🔒

“1 minute so far”, “25 minutes”: the minutes as a number, so the plural is chosen by it (as a word, “1 minutes”); with a date before them.

now

pin_view

Where a task is pinned, for its panel; None when it is not.

pinned_short 🔒

“14:00” today, “Thu 8 Oct 10:00” another day: where a task is pinned, beside a pin on its row.

pinned_when 🔒

“today, 14:00–14:45”, “Thursday 8 October, 10:00–10:30”: a block’s time in words.

related_views

What the Related panel shows.

time_left 🔒

“four weeks left”, “five days left”, “tomorrow”, “today”.

timeline

The timeline (Gantt chart): each open task on the days the plan gives it, from today; the dates asked as marks. project keeps one project.

wait_gap 🔒

The gap of task’s wait for other, in minutes, as the plan reads it (plan::Graph): a FINISHTOSTART or NEXT in the other, else its own DEPENDS-ON.