diff --git a/design/pap-14557-monitor-visibility/.paperclip-page/state.json b/design/pap-14557-monitor-visibility/.paperclip-page/state.json deleted file mode 100644 index 1e3344d4d97..00000000000 --- a/design/pap-14557-monitor-visibility/.paperclip-page/state.json +++ /dev/null @@ -1,10 +0,0 @@ -{ - "bucket": "pages.paperclip.ing", - "prefix": "pap-14557-monitor-visibility/", - "slug": "pap-14557-monitor-visibility", - "url": "https://pages.paperclip.ing/pap-14557-monitor-visibility/", - "baseUrl": "https://pages.paperclip.ing", - "publishedAt": "2026-07-17T15:51:31Z", - "sourceHash": "4d276364eb4e122d782247da6f1f0996763c12175ec0d7efa8ac7a0568fb6f2c", - "version": 1 -} diff --git a/design/pap-14557-monitor-visibility/index.html b/design/pap-14557-monitor-visibility/index.html deleted file mode 100644 index 28963350dd0..00000000000 --- a/design/pap-14557-monitor-visibility/index.html +++ /dev/null @@ -1,420 +0,0 @@ - - - - - -PAP-14557 — Monitor visibility wireframes - - - -
-
- - - PAP-14557 · Monitor visibility
- Jump to a screen -
- -
- -
- -
-
-
PAP-14557 · Wireframes
-

Make a waiting monitor obvious

-

When an issue has a monitor armed, nothing on the page says so unless you squint at a truncated properties row. These wireframes surface the same monitor state in three places — a banner at the top of the task page, a strip directly above the reply composer, and a readable two-line properties row with a hover tooltip for full details. Every surface shows both the exact time and how far away it is from now.

-
- 4 screens + 2 mobile - Desktop + mobile - Lo-fi · monochrome - Click any wireframe to zoom -
-
- -
-
Flow
-

One monitor state, three surfaces

-

The banner, the composer strip, and the properties row are all fed by the same state + copy rules (screen 04), so they can never disagree. Red dashed marks are annotation callouts, not UI.

-
-
flow.svg1280×304
- Flow diagram of the three monitor surfaces -
-
- -
-
Step 1 · Task page top
-

1.Monitor banner under the title

-

A full-width banner sits between the issue title and the description whenever a monitor is scheduled, due, or overdue. Headline leads with the relative time ("resumes in 2h 12m"); the second line gives the exact local time, the attempt count, and what is being watched. "Check now" fires the monitor immediately; "Edit" opens the existing monitor editor.

-
-
-
01-issue-top.svg1280×800 · desktop
- Task page top with monitor banner (desktop) wireframe -
-
-
mobile375×812
- Task page with monitor banner (mobile) wireframe -
-
-
-

Annotations

-
    -
  • 1 — Monitor banner: bold relative time first, exact time + attempt + watched service second, actions on the right. On mobile the actions drop below the text.
  • -
  • 2 — Properties Monitor row switches to the two-line layout (detail on screen 3). On mobile (callouts 2–3 on the phone frame) the collapsed properties bar carries a compact "in 2h 12m" chip and the strip repeats above the composer.
  • -
-
Why this changes: today the only always-visible signal is the truncated properties row; the existing "Monitor scheduled" card renders in the description area where it scrolls away and is easy to miss. The banner is pinned to the page header area so the very first glance answers "why is nothing happening, and when will it?"
-
-
-
-
- -
-
Step 2 · Thread bottom
-

2.Strip above the reply composer

-

The bottom of the thread is where you go to ask "what's happening?" — so the answer sits right there. A compact strip directly above the composer repeats the resume time (exact + relative + attempt) with a "Check now" action, and a one-line hint under the composer explains that replying wakes the agent before the scheduled check.

-
-
-
02-composer.svg1280×800 · desktop
- Monitor strip above composer (desktop) wireframe -
-
-
mobile375×812
- Monitor strip above composer (mobile) wireframe -
-
-
-
Referencecurrent thread bottom
- Current thread bottom with no monitor indication -
-
-

Annotations

-
    -
  • 1 — Monitor strip: anchored to the composer (scrolls with it), not part of the comment list. Same copy system as the banner.
  • -
  • 2 — Wake hint under the composer: sets the expectation that sending a message preempts the scheduled check.
  • -
-
Why this changes: in the reference screenshot the last comment says a monitor is armed only in prose ("issue monitor fires 16:08Z"), and once more comments land even that disappears. The strip keeps the resume time visible at the exact spot where a human decides whether to wait or to nudge.
-
-
-
-
- -
-
Step 3 · Properties pane
-

3.Readable Monitor row + details tooltip

-

The properties row stops cramming label, date, and attempt onto one colliding line. Collapsed: two lines — bold relative time, then muted "absolute time · Attempt N". Hover (tap on mobile) opens a details card with the full timestamp incl. timezone, watched service, notes, last-trigger info, and quick actions. Click still opens the existing editor popover.

-
-
-
03-properties-monitor.svg1280×800 · component sheet
- Properties monitor row redesign wireframe -
-
-
-
Referencecurrent properties row
- Current cramped monitor properties row -
-
-

Annotations

-
    -
  • 1 — Current failure: "Next check" truncates to "Ne…", the date shows the year but no time, and "Attempt 1" wraps into a two-line crumb.
  • -
  • 2 — Proposed collapsed row: relative time is the headline; absolute time and attempt live on a second muted line sized for the 352px pane.
  • -
  • 3 — Hover/tap tooltip: exact timestamp with timezone, watched service, notes, last-trigger state, and Check now / Edit / Clear without opening the editor.
  • -
-
Why this changes: the row currently tries to show four facts in one 200px slot, so none of them are readable. Two lines fit the pane; everything else moves to a tooltip you summon only when you care about specifics.
-
-
-
-
- -
-
Step 4 · System
-

4.State matrix and copy rules

-

All three surfaces share one formatter. Relative time always leads and uses two units under 24h ("in 2h 12m", not "in 2h" — today's single-unit rounding is why the current UI feels vague). Overdue and due-now states get explicit copy instead of silently showing a past date.

-
-
-
04-states.svg1280×800 · component sheet
- Monitor state matrix wireframe -
-
-
-

States covered

-
    -
  • Scheduled — under 1h / under 24h / beyond today.
  • -
  • Retrying — attempt count > 1 gets visual weight.
  • -
  • Due now / overdue — explicit copy, never a stale-looking past date.
  • -
  • Cleared / none — muted, no clock icon, banner and strip hidden.
  • -
-
Why this changes: a single copy system means the banner, strip, and row can never disagree about when the task resumes, and edge states (overdue, cleared) stop looking like bugs.
-
-
-
-
- -
-
For reviewer
-

Open questions

-
-
    -
  • Banner vs. existing card — there is already an "IssueMonitorActivityCard" that renders in the description area. Proposal: promote/replace it with the pinned banner (screen 1) rather than showing both. OK?
  • -
  • Strip stickiness — should the composer strip scroll with the thread (inline, as drawn) or stick to the composer even mid-scroll? Drawn as anchored to the composer.
  • -
  • Relative-time precision — adopt the two-unit format ("in 2h 12m") everywhere, including the existing scheduled-retry row which uses the same formatter?
  • -
  • Hover vs. click — the properties row currently opens the editor on click. Proposal keeps click = editor, hover/tap = read-only details tooltip. Fine, or should tap open the editor directly on mobile?
  • -
  • Live countdown — should the relative time tick live (re-render every minute) or is on-load accuracy enough?
  • -
-
-
- - -
-
- - - - - - diff --git a/design/pap-14557-monitor-visibility/screenshots/current-properties-monitor.png b/design/pap-14557-monitor-visibility/screenshots/current-properties-monitor.png deleted file mode 100644 index f3255e33fec..00000000000 Binary files a/design/pap-14557-monitor-visibility/screenshots/current-properties-monitor.png and /dev/null differ diff --git a/design/pap-14557-monitor-visibility/screenshots/current-thread-bottom.png b/design/pap-14557-monitor-visibility/screenshots/current-thread-bottom.png deleted file mode 100644 index 9e87ca95462..00000000000 Binary files a/design/pap-14557-monitor-visibility/screenshots/current-thread-bottom.png and /dev/null differ diff --git a/design/pap-14557-monitor-visibility/wireframes/01-issue-top-mobile.svg b/design/pap-14557-monitor-visibility/wireframes/01-issue-top-mobile.svg deleted file mode 100644 index aeb3f5f8511..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/01-issue-top-mobile.svg +++ /dev/null @@ -1,105 +0,0 @@ - - - - - - - - PAP-14557 - - - - Nightly model comparison sweep - - - In Progress - - - - - - - - - Waiting on monitor — in 2h 12m - Thu Jul 17, 4:08 PM · Attempt 1 - - - Check now - - - - - - - - - - - - - - - Senior Engineer Fable - 15m ago - - - - - - - - - Properties - - - - in 2h 12m - - - - - - - - - - Resumes in 2h 12m - Jul 17, 4:08 PM · Attempt 1 - Check now - - - - - - Reply… - - - - - - - Send - - - - - - - - - 1 - - - - - 2 - - - - - 3 - - - diff --git a/design/pap-14557-monitor-visibility/wireframes/01-issue-top.svg b/design/pap-14557-monitor-visibility/wireframes/01-issue-top.svg deleted file mode 100644 index cbf09bab1ed..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/01-issue-top.svg +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - Issues / - PAP-14557 - - - - - - - Nightly model comparison sweep - - - In Progress - - - - - - - - - - Waiting on monitor — resumes in 2h 12m - Thu Jul 17, 4:08 PM (your time) · Attempt 1 · Watching: vercel-deploy - - - Check now - - - - Edit - - - - - - - - - - - - Activity - - - - - - Senior Engineer Fable - 15m ago - - - - - - ⌄ thread continues — see screen 02 for the composer - - - PROPERTIES - Status - In Progress - Priority - Medium - Assignee - - Fable - Approvers - None - - - Monitor - - - - In 2h 12m - Jul 17, 4:08 PM · Attempt 1 - - Watchdog - None - - - - - - - 1 - - - - - 2 - - - diff --git a/design/pap-14557-monitor-visibility/wireframes/02-composer-mobile.svg b/design/pap-14557-monitor-visibility/wireframes/02-composer-mobile.svg deleted file mode 100644 index 895d8be5260..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/02-composer-mobile.svg +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - - - PAP-14557 - - - ⌃ earlier comments - - - - Senior Engineer Fable - 15m ago - - - - Next action (armed): - - - - - - - - Previous · PAP-14544 - Phase 3 — rescore… - - - - - - - - - Resumes in 2h 12m - Thu Jul 17, 4:08 PM · Attempt 1 - - - Check now - - - - - - - Reply… - - - - - - - Agent mode - - - - - Send - - - - - - - - - 1 - - - diff --git a/design/pap-14557-monitor-visibility/wireframes/02-composer.svg b/design/pap-14557-monitor-visibility/wireframes/02-composer.svg deleted file mode 100644 index cc417d0f538..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/02-composer.svg +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - Issues / - PAP-14557 - - - - - PROPERTIES - Status - In Progress - Monitor - - - - In 2h 12m - Jul 17, 4:08 PM · Attempt 1 - - - ⌃ earlier comments - - - - Senior Engineer Fable - 15m ago - - - - Next action (armed): - - - - - - - - - Previous · PAP-14544 - Phase 3 — rescore + gap re-runs… - - - - - - - - - Resumes in 2h 12m - Thu Jul 17, 4:08 PM · Attempt 1 · Watching: vercel-deploy - - - Check now - - - - - - - Reply… - - - - - - - Agent mode - - - - - Senior Engineer Fable - - - - Send - - - - - Sending a reply wakes the agent now — before the scheduled check. - - - - - - - 1 - - - - - 2 - - - diff --git a/design/pap-14557-monitor-visibility/wireframes/03-properties-monitor.svg b/design/pap-14557-monitor-visibility/wireframes/03-properties-monitor.svg deleted file mode 100644 index bb39e5f302a..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/03-properties-monitor.svg +++ /dev/null @@ -1,121 +0,0 @@ - - - - - Properties pane — Monitor row redesign - Side pane fragment, 352px wide. The same row is reused in the mobile properties sheet. - - - A · Current — cramped, truncated - - - Approvers - None - - Monitor - - - - Ne… - Jul 17, 2026 - Attempt - 1 - - Watchdog - None - - Label truncates to “Ne…”, date is ambiguous (which year matters, - not the time?), attempt badge wraps into two lines. - - - B · Proposed — two-line row - - - Approvers - None - - Monitor - - - - In 2h 12m - Jul 17, 4:08 PM · Attempt 1 - - Watchdog - None - - Relative time leads and is bold; absolute time + attempt get their - own muted line. Nothing truncates at 352px. Row grows to 2 lines. - - - C · Hover / tap — full details - - - - Monitor - - - - In 2h 12m - Jul 17, 4:08 PM · Attempt 1 - - - - - - Monitor - Attempt 1 - - - Next check - Thu, Jul 17, 2026 · 4:08 PM PDT - in 2h 12m - - Watching - vercel-deploy - - Notes - Verify completion, commit ledger / - scores, extend comparison site. - - Last triggered - — not yet triggered - - - - - Check now - - - - Edit - - - - Clear - - - - Hover on desktop, tap on mobile. Exact timestamp with timezone, - service, notes and quick actions — no digging into the edit popover. - - - - - - - 1 - - - - - 2 - - - - - 3 - - - diff --git a/design/pap-14557-monitor-visibility/wireframes/04-states.svg b/design/pap-14557-monitor-visibility/wireframes/04-states.svg deleted file mode 100644 index 105dbc4b840..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/04-states.svg +++ /dev/null @@ -1,103 +0,0 @@ - - - - - Monitor row — state matrix - One copy system across banner, composer strip and properties row. Relative time always leads. - - - - - SCHEDULED · UNDER 1 HOUR - Monitor - - - - In 24m - Today, 2:20 PM - - - - - - SCHEDULED · UNDER 24 HOURS - Monitor - - - - In 2h 12m - Today, 4:08 PM - - - - - - SCHEDULED · BEYOND TODAY - Monitor - - - - In 3d - Mon Jul 20, 9:00 AM - - - - - - RETRYING · ATTEMPT > 1 - Monitor - - - - In 2h 12m - Today, 4:08 PM · - Attempt 3 - - - - - - DUE NOW - Monitor - - - - Due now - checking momentarily… - - - - - - OVERDUE - Monitor - - - - Overdue by 18m - Jul 17, 1:38 PM · fires on next tick - - - - - - CLEARED - Monitor - Cleared - 2h ago · after attempt 2 - - - - - - NONE - Monitor - None - - - - Copy rules - < 1h → “In 24m” · < 24h → “In 2h 12m” (two units, not “in 2h”) · beyond → “In 3d” + weekday date · past due → “Overdue by …”. - Absolute time says “Today” when it is today; adds the year only when it is not the current year. Banner + strip render only in scheduled / due / overdue states. - diff --git a/design/pap-14557-monitor-visibility/wireframes/flow.svg b/design/pap-14557-monitor-visibility/wireframes/flow.svg deleted file mode 100644 index 3e6d9403c21..00000000000 --- a/design/pap-14557-monitor-visibility/wireframes/flow.svg +++ /dev/null @@ -1,65 +0,0 @@ - - - - One monitor state, three surfaces — banner (top), strip (composer), row (properties) — all fed by the same copy rules (04). - - - - - - - - - - - - - 01 · Task page top — banner - - - - - - - - - - - - - - - 02 · Above the composer — strip - - - - - - - - - - - - - - - - - - 03 · Properties row + tooltip - - - - - - - - - - - - - 04 · State matrix + copy rules -