Commit fe7b667eb3

fe7b667eb3c4b5402de51c209c7422e287b2dde8

parent: c75998ff8e

Verified · cmc

cmc <hello@cleberg.net> · 2026-10-02 04:40 UTC

docs: every list and show is a screen

Closes #319

Layout: unified · split

.gitbay/wiki/Users.org +18 −35
@@ -1024,41 +1024,24 @@ then prints:
1024 =krz/gitbay=, SHAs) dim. A marker piped output keeps as its own 1024 =krz/gitbay=, SHAs) dim. A marker piped output keeps as its own
1025 trailing cell (=[archived]=, =primary=) joins the state at a terminal: 1025 trailing cell (=[archived]=, =primary=) joins the state at a terminal:
1026 =public, archived=; 1026 =public, archived=;
1027- =mr list=, =issue list= and =build list= as one-section screens: 1027- every list and show drawn as a screen: a header block of =Label:=
1028 each row led by =●= when it waits on you (your review requested, an 1028 lines (labels dim), the description or notes, sections titled =Title
1029 issue assigned to you), otherwise by its checks' or state's glyph; 1029 (n)= in bold blue, and a legend under a rule of the commands that
1030 =mr list= with review state, branch and age, =issue list= with 1030 apply now, grouped and chosen from the item's state and your access.
1031 labels, assignees, comments and age. A =dashboard= screen opens with 1031 Rows have no header (unless a column is a number or a size) and no
1032 what waits on you, then open merge requests, failed builds (a job's 1032 indent: a dim reference, a state glyph, the text, then dim facts
1033 latest build only), five lines of activity with a count of builds 1033 joined by =·=. The glyphs are =✓= passed, =✗= failed or blocked, =◐=
1034 that passed, and pinned repositories; for admins a =Problems= line 1034 still going, =●= waiting on you (your review requested, an issue
1035 counts background failures, and =admin stats= has the detail. A 1035 assigned to you, an unread notification, a pending account, an
1036 column empty on every row is left out. These columns are 1036 overdue milestone, the session's own key), =○= closed or draft. A
1037 terminal-only; piped rows keep their own; 1037 section cut short ends with =+n more= and the command for the rest.
1038- diffs coloured (file headers bold, hunks cyan, added green, removed 1038 Below 80 columns the legend's groups stack; a suggested command is
1039 red), and =build log= with its step lines bold, the failed one red; 1039 never cut, so it may run past the width. =dashboard= opens with what
1040 both made safe like any user text, the log's own colour codes dropped; 1040 waits on you; for admins a =Problems= line counts background
1041- ages as =2h ago= and =in 5h=, sizes as =3.0 MiB=, durations as 1041 failures, and =admin stats= has the detail. =repo commit= prints its
1042 =53m43s=, where piped output keeps RFC3339, bytes and seconds; 1042 screen, then the diff. Secrets never appear on a screen, and a
1043- =mr show=, =issue show=, =repo show= and =build show= drawn as 1043 webhook URL shows its scheme and host only. =wiki show= piped prints
1044 screens: a header block of =Label:= lines (labels dim), the 1044 the page source verbatim;
1045 description, sections titled =Title (n)= in bold blue (=Commits=,
1046 =Files=, =Discussion=, =Events=, =Steps=, open merge requests and
1047 issues), and a legend under a rule of the commands that apply now,
1048 grouped (=Unblock=, =Review=, =Merge=, =Read=, ...) and chosen from
1049 the item's state and your access. Rows have no header and no indent:
1050 a dim reference, a state glyph, the text, then dim facts joined by
1051 =·=. The glyphs are =✓= passed, =✗= failed or blocked, =◐= still
1052 going, =●= waiting on you, =○= closed or draft. A section cut short
1053 ends with =+n more= and the command for the rest. Below 80 columns the
1054 legend's groups stack; a suggested command is never cut, so it may run
1055 past the width;
1056- other =show= views with a title line, aligned fields, the body rendered
1057 from markdown or org, one line per event, and comments under a rule;
1058 a sub-table (labels, revisions, and the like) carries a section label
1059 line in both terminal and piped output; timestamps as
1060 =2026-09-23 23:26 UTC=. =wiki show= piped prints the page source
1061 verbatim; the rendered page is terminal-only;
1062- errors on stderr after a red =error:=, a mistyped flag with the flag 1045- errors on stderr after a red =error:=, a mistyped flag with the flag
1063 it is closest to (=did you mean --state?=), and a usage line wrapped 1046 it is closest to (=did you mean --state?=), and a usage line wrapped
1064 to the width between its bracketed groups, one alternative per line; 1047 to the width between its bracketed groups, one alternative per line;
CHANGELOG.org +7
@@ -39,6 +39,13 @@ anything beyond "replace the binary and restart" is needed.
39 milestone lists (repo and org), =org team list=/=show=. The session's 39 milestone lists (repo and org), =org team list=/=show=. The session's
40 own key leads with =●=; =pgp list= shows user IDs rather than their 40 own key leads with =●=; =pgp list= shows user IDs rather than their
41 JSON; a webhook URL on screen is its scheme and host only. 41 JSON; a webhook URL on screen is its scheme and host only.
42- The remaining commands at a terminal are screens (#319): saved
43 queries (and =issue list=/=mr list= with =--query=/=--q=), =search=
44 (a section per kind), =feed=, =mr revisions=, =issue templates=,
45 =build jobs=, =status list=, releases, snippets, wiki, =explore=,
46 =audit=, and the admin commands (=admin stats= lists the 20 largest
47 repositories). Every list and show is now a screen; the piped layout
48 is the only other one.
42 49
43* v1.41.0 — 2026-10-01 50* v1.41.0 — 2026-10-01
44 51