X7 Live status glyphs: pull requests, Paperclip tasks and providers

Open
#410 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
electron, github, typescript
Domain
desktop, devtools

Research direction

Start with issue #399 for the experience rework and #396 for the Paperclip live status source, then locate the chat rows, task rows, Inbox, summary card, and git panel that display these items. Implement a shared status store and refresh behavior across those surfaces, following the listed glyph, accessibility, and performance requirements. Done means the state mapping, refresh triggers, hidden-window behavior, and ETag reuse are covered by tests.

Written by the indexing model from the issue text.

Description

Part of the experience rework (#399). Target branch: claude/experience-integration.

One glyph system that updates live, wherever an item appears: chat rows, task rows, the Inbox, the summary card and the git panel.

Pull requests

State Glyph
Draft grey
Open, checks passing green
Checks running amber ring with a stepped animation
Checks failing red dot
Review requested or changes requested amber or orange
Merged purple
Closed muted red

The tooltip summarises it, e.g. 'PR #124 · checks running · 2 of 5'.

Paperclip tasks

State Glyph
Todo grey circle
In progress blue half circle; animated only while an agent runs
In review / handed back purple
Needs you amber dot
Blocked red
Done green check
Cancelled grey strike
Checked out on this machine laptop badge

Providers
The provider logo on the chat row glows while working, shows a dot when there's an unseen completion, and turns red when failed.

Data

  • PR status (state, draft, review decision, combined check status) comes from GitHub with ETag-conditional requests, only for visible items.
  • It refreshes about every 60 s while the window is active, immediately on focus, and immediately after an agent pushes or opens a PR. It never polls while hidden.
  • Paperclip status reuses the live socket or badge poll (#396), with optimistic local updates.
  • One shared store keyed by repo#number and task id, so every surface stays in sync.

Accessibility
Each state has a distinct shape as well as a colour, plus a text label in the tooltip and aria.

Performance
No polling when hidden. One request batch per refresh. Animation only for running states, stepped and paused off screen.

Tests
State-to-glyph mapping, the refresh triggers (focus, push, interval, hidden), and ETag reuse.

Dominant language
TypeScript
Stars
3
Forks
0
Avg merge
17h 33m
Merged PRs (30d)
163

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from musterhq/muster-code

All issues in musterhq/muster-code

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.