← Feature notes · Status · Architecture · Open work
Ferail presents background work through one process-wide task model. The
status bar and the task popover both read the same TaskRegistry, so the small
bottom strip and the detailed task list cannot disagree.
Implemented:
TaskRegistryincrates/ferail-gpui/src/tasks.rs.- Process-wide registry ownership in
ProcessState. - Status-bar task text and thin progress strip.
- Determinate and indeterminate progress states.
- Foreground-task priority so copy/search/disk/dupes keep the spotlight over ambient prefetch work.
- 150 ms surfacing delay so instant work does not flicker in the UI.
- Task popover with active rows, recent foreground history, progress bars, elapsed time, transfer rate/ETA details, and cooperative cancel buttons.
- Screenshot simulation flags for progress and task-panel states.
Remaining work is mostly user feedback polish: completion notifications, accessibility announcements, and cancellation consistency across every worker.
TaskKind separates user-requested foreground work from ambient work.
Foreground:
- File operations.
- Search.
- Disk usage scans.
- Duplicate scans.
Ambient:
- Enumeration.
- Icon prefetch.
- Thumbnail prefetch.
- Magic/quarantine prefetch.
- Folder-size scans.
Foreground tasks are recorded in the recent-history ring when they finish. Ambient tasks are intentionally omitted from history because they are housekeeping and would drown out the work the user actually asked for.
TaskProgress::Indeterminate is used when a worker can say "running" but not
how far it is. The status bar renders the gpui-component loading animation.
TaskProgress::Determinate(f32) is used when a worker can report a fraction.
The value is clamped to 0.0..=1.0; stale task ids are ignored.
File transfers may also attach TransferStats:
- bytes done / total,
- items done / total,
- smoothed bytes per second,
- ETA,
- current file label.
The status bar shows a compact rate/ETA tail for the primary task. The popover shows the fuller transfer breakdown.
The status bar shows:
- active folder item count,
- selected count/size when a selection exists,
- total visible size,
- free space when available: swapped for "{volume} is read-only" when the
tab's volume is mounted read-only (CD/DVD, locked card,
romount): "0 B free" on a CD is true but buries the actual story. The macOS boot volume is exempt: its sealed snapshot statfs's read-only, but the Macintosh HD the user sees is writable via the firmlinked Data volume, - an "N filtered out · X B" companion beside the count whenever the filter
field is holding entries back, so a filtered listing never passes its
count and size off as the whole folder. Fed the same way as the hidden
chip: the enumeration's
Donemessage (loading::FilterSummary, counted after the hidden partition so nothing is reported twice, zeroed at load start and when a search replaces the listing), and suppressed in archive mode. When the filter matches nothing, the count itself becomes "All N items filtered out · X B" (never "Empty folder"), and the table's empty state says "All N items filtered out." for the same reason: a filtered-to-nothing folder is not an empty one, - task label or "N tasks running",
- progress strip,
- a passive "N hidden · X B" chip when show hidden is off and the folder
has hidden entries: count + summed sizes of what the listing skipped, so
hidden content is discoverable without unhiding it. Fed per-tab by the
enumeration's
Donemessage (loading::HiddenSummary; counted before the text filter, zeroed at load start; hidden folders count at their dirent size, like the item total). Suppressed in archive mode. Its sibling affordance: with show hidden on, hidden rows render dimmed (opacity(0.6), list + grid; a cut row's0.45wins), - Show Hidden toggle, always present at every window width (see Fitting It All In A Narrow Window).
Clicking the task label or progress strip toggles the task popover.
That is a lot of readouts for one row, and translation swells them unevenly:
English "up 3m" is French "en service depuis 3m". The bar is a single row of
flex_shrink_0 children, so an overflow does not compress: it pushes its own
tail, the Show Hidden switch, off the window edge. status_bar::plan decides
what fits before anything is built, from the window's logical width, the
strings that will actually be painted, and a character-count estimate (no text
measurement, no I/O). It is pure, so the ladder is unit-tested without a window.
Each wordy segment has three wordings (status_bar::Density):
| Segment | Full | Short | Minimal |
|---|---|---|---|
| Count | 12 items · 3.0 MB |
same | 12 · 3.0 MB |
| Selection | 3 of 12 selected · 1.0 KB |
same | 3/12 · 1.0 KB |
| Filtered chip | 48 filtered out · 12.0 MB |
48 filtered |
same |
| Hidden chip | 2 hidden · 52.0 KB |
2 hidden |
same |
| Free space | 126.3 GB free on Macintosh HD |
126.3 GB free |
126.3 GB |
| Read-only | Macintosh HD is read-only |
Read-only volume |
Read-only |
| Uptime | up 3m |
same | UP 3m |
| Show Hidden | Show hidden |
Hidden |
(tooltip only) |
The minimal uptime token is deliberately not translated: the bar already
ships CPU / MEM / rps unlocalized, and a universal two-letter code beats a
truncated word. The number-and-separator forms (12 · 3.0 MB, 3/12) are built
with format! rather than tr! for the same reason, there is nothing in them
to translate.
The ladder, widest first: Full → Short → Minimal → one type tier smaller (Xs → Xxs) → hide segments, least essential first: the app-footprint stats (the one segment that says nothing about the folder in front of the user), then the hidden chip, the filtered chip, free space, and last of all the task label. Gaps and the progress strip tighten with the density; nobody reads whitespace.
Two things are not on the ladder: the item count, and the Show Hidden
switch, at minimal density the switch loses its word and keeps a tooltip, but
it is always there to click. A density_ladder_tests case walks the width down
20 px at a time and asserts the ladder never runs backwards, so a slow resize
can't flap between two rungs.
The task popover shows:
- surfaced active tasks,
- determinate/indeterminate progress,
- elapsed time,
- cooperative cancel button when the task has a cancel flag,
- recent foreground tasks with completed/cancelled/failed outcome.
Current task producers include:
- directory enumeration,
- icon, thumbnail, magic, quarantine, and folder-size prefetch,
- file operations,
- search,
- disk usage,
- duplicate finding,
- screenshot simulation.
Workers begin/end tasks from the shared registry and notify the shell when foreground state needs to repaint.
- Starting a task must not block the UI.
- Progress updates must be throttled or sampled by the worker/poller.
- Instant tasks should not surface visually.
- Success notifications are gated by task visibility: if a task ended before it lived long enough to appear in the status bar/panel, the UI change itself is the confirmation.
- Errors become toasts, recent-history failures, or status details, never modal freezes. Include the raw technical error/enum/code plus actionable next steps.
- Cancellation is cooperative: the UI flips a shared flag and the worker exits at its next checkpoint.
- New status-bar text needs a Short and a Minimal wording, not just an English sentence: a segment that only knows how to say itself in full is a segment that pushes the Show Hidden switch off a narrow window.
Tracked in TODO.md:
- Completion feedback for secondary-window scans, such as Disk Usage, that do not yet have a clean notification handle.
- Accessibility announcements for file operations and long-running tasks.
- More consistent cancellation tokens for workers that currently only drop stale results at apply time.