detached 547efab

docs(queries): clarify computeEffectiveStatus is read-time only

commit
547efabeec2388efe2722be71a628698f25a2eef
author
bnema · · 2026-01-18 22:29 UTC
parent
b4dc098
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
1 file · +5 -1
M src/convex/queries.ts +5 -1
@@ -5,7 +5,11 @@ import { v } from 'convex/values';
55 // Timeout threshold for marking users as offline (2 minutes)
66 const ONLINE_TIMEOUT_MS = 2 * 60 * 1000;
77
8-// Helper to compute effective status based on lastSeen timeout
8+// Helper to compute effective status based on lastSeen timeout.
9+// Returns 'online', 'away', 'busy', 'idle', or 'offline'.
10+// Note: This is a read-time computation - the database stores the last known status
11+// and lastSeen timestamp. The client heartbeat (via /api/status) updates these values.
12+// This function computes what to display when a user stops sending heartbeats.
913 function computeEffectiveStatus(
1014 status: string,
1115 lastSeen: number | undefined
@@ -5,7 +5,11 @@ import { v } from 'convex/values';
5 // Timeout threshold for marking users as offline (2 minutes)5 // Timeout threshold for marking users as offline (2 minutes)
6 const ONLINE_TIMEOUT_MS = 2 * 60 * 1000;6 const ONLINE_TIMEOUT_MS = 2 * 60 * 1000;
7 7
8-// Helper to compute effective status based on lastSeen timeout8+// Helper to compute effective status based on lastSeen timeout.
9+// Returns 'online', 'away', 'busy', 'idle', or 'offline'.
10+// Note: This is a read-time computation - the database stores the last known status
11+// and lastSeen timestamp. The client heartbeat (via /api/status) updates these values.
12+// This function computes what to display when a user stops sending heartbeats.
9 function computeEffectiveStatus(13 function computeEffectiveStatus(
10 status: string,14 status: string,
11 lastSeen: number | undefined15 lastSeen: number | undefined

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 3

Tags 8

↑↓ moveenter openesc close