Skip to content

fix(qclient): give the shard manager one vocabulary and an in-app legend - #652

Open
blacks1ne wants to merge 1 commit into
QuilibriumNetwork:v2.1.0.25from
blacks1ne:fix/qclient-prover-readability
Open

fix(qclient): give the shard manager one vocabulary and an in-app legend#652
blacks1ne wants to merge 1 commit into
QuilibriumNetwork:v2.1.0.25from
blacks1ne:fix/qclient-prover-readability

Conversation

@blacks1ne

@blacks1ne blacks1ne commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

The shard manager repeated QUIL/day five times in one title and printed eight decimals of a token worth a fraction of a cent, while its two action columns mixed frames with epochs and put a bare threshold under a header promising an action.

Rewards are now whole Q/d with the unit in the header; <1 keeps a trickle distinguishable from nothing. Checked against a live node: 91 shards collapse to nine tiers, so the ~15x spread that drives a join decision survives rounding, and sorting still uses full precision. The unit is spelled the same way in prover shards and prover shardinfo.

Both action columns share one grammar — lowercase verbs matching the keys that trigger them, grouped when they share a threshold — and Default Action names what the network does unprompted rather than repeating the Status column. e toggles both between @f<frame> and @e<epoch> without a refetch.

Next Action is the one column laid out flush left: it is the only one whose values do not all carry a threshold, so a tail-aligned column stops looking like a column.

The sorted column's header is underlined — free in monochrome — and in colour mode only the direction arrow takes a colour, distinct from every status palette, so the mark reads as layout rather than as a value. Mat, Lag and State are three readings of one fact and share one colour; a worker id is coloured only when it is -1.

h opens a help screen that is now the only place this vocabulary is defined: every column, every key, both modal editors and the worker picker. It outgrew a terminal, so it scrolls under a pinned title.

Base: 4eaf1f79

The shard manager repeated `QUIL/day` five times in one title and printed
eight decimals of a token worth a fraction of a cent, while its two action
columns mixed frames with epochs, spaced pipes inconsistently, and put a
bare threshold (`epoch 1118`) under a header promising an action.
`renew<f804960` was simply wrong — every other hint used `@`.

Rewards are now whole QUIL/day with the unit hoisted into the header, and
`<1` keeps a trickle distinguishable from nothing. Checked against a live
node: 91 shards collapse to nine tiers, so the ~15x spread that drives a
join decision survives rounding, and sorting still uses the full-precision
value. The unit is spelled `Q/d` everywhere, including `prover shards` and
`prover shardinfo`, so the TUI and the CLI no longer disagree.

Both action columns share one grammar — lowercase verbs matching the keys
that trigger them, grouped when they share a threshold
(`(reject|confirm)@f804960`) — and Default Action now names what the
network does unprompted (`expire`, `renew`, `activate`, `depart`) instead
of restating a threshold or repeating the Status column. Every threshold
is an epoch boundary, so `e` toggles the pair between `@f<frame>` and
`@e<epoch>` without a refetch. `prover status` shares the same hints, so
the TUI and the CLI can be reasoned about together.

Next Action is the one column laid out flush left. Right-justifying aligns
a column on its tail, which is what Default Action wants — its threshold
is always present, so the `@f804960`s line up. Next Action's is not:
`(pause|leave)` has no threshold at all, and aligned on the tail it lands
under the middle of the row above it.

The sorted column is now findable at a glance: its header is underlined,
which costs nothing in monochrome, and in colour mode the direction arrow
alone takes a colour distinct from every status palette, so the mark reads
as layout rather than as a value. Padding shares the header's style, so a
highlight stays one contiguous block. Mat, Lag and State are three
readings of one fact and take one colour between them; a worker id is
coloured only when it is `-1`, the single value in that column that asks
the operator to do something.

`h` opens a help screen that is now the only place this vocabulary is
defined: every column, every key, both modal editors and the worker
picker. It outgrew a terminal, so it scrolls under a pinned title.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@blacks1ne
blacks1ne force-pushed the fix/qclient-prover-readability branch from 423a6de to f8f940b Compare September 9, 2026 12:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant