diff --git a/changelog.d/fixed-16484-tracker-chevron-state-word.md b/changelog.d/fixed-16484-tracker-chevron-state-word.md
new file mode 100644
index 0000000000..815c0a5480
--- /dev/null
+++ b/changelog.d/fixed-16484-tracker-chevron-state-word.md
@@ -0,0 +1 @@
+- The Activity Monitor's CI and Review chevrons always carry a state word beside their glyph — unknown or stale evidence now reads "CI waiting · test not observed · seen 14m ago" instead of a bare icon — and when both tracks share the current phase the text says which one the hive is waiting on ("· new head d3c0824", "· waiting on CI", "· waiting on the fix") ([#16484](https://github.com/hivecommons/hive/issues/16484)).
diff --git a/src/pkg/dashboard/stage_tracker_activity.test.js b/src/pkg/dashboard/stage_tracker_activity.test.js
index 3c54e831bf..5bccfa73e9 100644
--- a/src/pkg/dashboard/stage_tracker_activity.test.js
+++ b/src/pkg/dashboard/stage_tracker_activity.test.js
@@ -22,7 +22,7 @@ const STAGE_TRACKER_NEEDS_DECISION = 85, STAGE_TRACKER_ISSUE_NEEDS_DECISION = 45
const STAGE_TRACKER_ISSUE_DECISION_COLUMN = 10, STAGE_TRACKER_TRIAGE_NEEDED = 15, STAGE_TRACKER_POSSIBLY_EXISTS = 17;
const STAGE_TRACKER_PRE_MERGE_SOAK = 95;
`;
-const track = new Function('esc', 'stageTrackerIcon', fn(strip, 'stageTrackerActivityTrackHtml') + ';return stageTrackerActivityTrackHtml;')(esc, (n, cls) => ` `);
+const track = new Function('esc', 'stageTrackerIcon', fn(strip, 'stageTrackerTrackLead') + fn(strip, 'stageTrackerActivityTrackHtml') + ';return stageTrackerActivityTrackHtml;')(esc, (n, cls) => ` `);
const getAnchor = new Function(globals + anchor + ';return stageTrackerAnchor;')();
const header = new Function('esc', 'stageTrackerIcon', globals + fn(strip, 'stageTrackerHeaderHtml') + ';return stageTrackerHeaderHtml;')(esc, () => '');
const now = Date.parse('2026-11-02T21:00:00Z');
@@ -178,7 +178,8 @@ test('12:01 screenshot density preserves physical tracks for issue-only, one-to-
}
for (const cell of cells.filter(cell => /data-display-state="unknown"/.test(cell))) {
const content = cell.match(/aria-describedby="[^"]+">([^]*?)]*>/g, '').trim(), '', 'missing evidence remains icon-only at screenshot density');
+ assert.match(content, /]*>/g, '').trim(), /unknown/, 'missing evidence still says so in words (#16484)');
}
}
}
@@ -560,7 +561,7 @@ test('current-phase styling is steady and undimmed, including compact/reduced-mo
assert.doesNotMatch(css, /\.ham-track-position/);
});
-test('unknown tracks show only the canonical column glyph, preserving full focus/hover details and safe evidence links', () => {
+test('unknown tracks wear the canonical column glyph beside their caption, preserving full focus/hover details and safe evidence links', () => {
for (const kind of ['ci', 'review']) {
const item = livePR({
number: 16434, repo: 'hivecommons/hive',
@@ -569,7 +570,7 @@ test('unknown tracks show only the canonical column glyph, preserving full focus
const rendered = track(item, kind, { state: 'active' }, false, now);
const content = rendered.match(/aria-describedby="[^"]+">([^]*?)]*>/g, '').trim(), '', 'no CI/Review/unknown/reason/question-mark panel text');
+ assert.ok(content.replace(/<[^>]*>/g, '').includes((kind === 'ci' ? 'CI' : 'Review') + ' unknown · full precise reason'), 'the caption rides beside the glyph, never a bare icon (#16484)');
assert.match(content, /aria-label="Open current-head/);
assert.match(rendered, /class="ham-chevron-info config-info" tabindex="0"/);
assert.match(rendered, /role="tooltip">[^]*full precise reason[^]*head head/);
@@ -642,7 +643,7 @@ test('stale activity is visibly unknown and old green observations cannot look l
assert.match(html, /activity unknown · last observed reviewing/);
assert.doesNotMatch(html, /data-motion/);
assert.match(html, /data-display-state="unknown"/);
- assert.doesNotMatch(html, /ham-chevron-copy/);
+ assert.match(html, /ham-chevron-copy ham-track-state">]*>(<\/svg>)?Review working · reviewer · seen 5m ago/, 'stale evidence keeps its words and says how old it is');
item.review_activity = activity('approved', 'Review approved');
assert.doesNotMatch(track(item, 'review', {}, false, now + 300000), /ham-activity-track done/);
});
@@ -695,3 +696,56 @@ test('the backend detail sentence rides in the track tooltip, not on the chevron
assert.match(html, /role="tooltip">[^]*hasn't reported for this head yet · Branch protection requires a check named "test"/);
assert.match(html, /title="[^"]*Branch protection requires a check named "test", but no check run/);
});
+
+test('#16484: a PR-row track never renders as a bare glyph in any of the four operator shapes', () => {
+ const stale = (state, caption, extra = {}) => ({ head: 'head', state, caption, source: 'cache', observed_at: new Date(now - 14 * 60000).toISOString(), ...extra });
+ const shapes = {
+ 'new head, review findings': { stage: 70, display_column: 50, push: { state: 'pushed', sha: 'head', next: 're-review' }, code_activity: { head: 'head', state: 'pushed', caption: 'New head pushed · CI and re-review', source: 'recorded-push' }, ci_activity: stale('missing', 'CI waiting · test not observed'), review_activity: stale('changes_requested', 'Review findings · awaiting author') },
+ 'red CI, review findings': { stage: 70, display_column: 50, ci_activity: { ...stale('failing', 'CI failing · test (26)'), observed_at: new Date(now).toISOString() }, review_activity: stale('changes_requested', 'Review findings · awaiting author · adjudicator') },
+ 'both unknown': { stage: 50, display_column: 50, ci_activity: { head: 'head', state: 'unknown', caption: 'CI unknown · required checks not observed', source: 'unavailable' }, review_activity: { head: 'head', state: 'unknown', caption: 'Review unknown · current-head evidence unavailable', source: 'unavailable' } },
+ 'held, stale approval': { stage: 70, display_column: 50, modifiers: ['hold'], hold: { by: 'hanthor', pill: 'Held by @hanthor' }, code_activity: { head: 'head', state: 'waiting_fixer', caption: 'Waiting for fixer · no code work observed', source: 'native-fix-request' }, ci_activity: stale('missing', 'CI waiting · test not observed'), review_activity: stale('approved', 'Review approved') },
+ 'no evidence at all': { stage: 50, display_column: 50 },
+ };
+ for (const [name, fields] of Object.entries(shapes)) {
+ const cells = physicalTracks(livePR(fields));
+ for (const [kind, cell] of [['ci', cells.ci], ['review', cells.review]]) {
+ const content = cell.match(/aria-describedby="[^"]+">([^]*?)]*>/g, '').trim();
+ assert.match(content, / 0 && /CI|Review/.test(words), name + ' ' + kind + ' carries a state word: ' + JSON.stringify(words));
+ assert.match(cell, /ham-current/, name + ' ' + kind + ' stays in the current phase');
+ }
+ }
+ const noEvidence = physicalTracks(livePR(shapes['no evidence at all']));
+ assert.match(noEvidence.ci.replace(/<[^>]*>/g, ''), /CI unknown · no evidence for head/);
+});
+
+test('#16484: when CI and Review share the phase the chevrons say which one the hive waits on', () => {
+ const fresh = (state, caption, extra = {}) => ({ head: 'd3c0824304d4c97b8ee76a267fb1e91f6d4c79a4', state, caption, source: 'cache', observed_at: new Date(now).toISOString(), ...extra });
+ const head = 'd3c0824304d4c97b8ee76a267fb1e91f6d4c79a4';
+ const text = cell => cell.match(/aria-describedby="[^"]+">([^]*?)]*>/g, '');
+ // New head pushed, CI not yet reporting, review pending: CI leads on the new head, review waits on CI.
+ let cells = physicalTracks(livePR({ head, stage: 50, display_column: 50, push: { state: 'pushed', sha: head, next: 're-review' }, code_activity: { head, state: 'pushed', caption: 'New head pushed · CI and re-review', source: 'recorded-push' }, ci_activity: fresh('missing', 'CI waiting · test not observed'), review_activity: fresh('pending', 'Review pending · reviewer-2 queued') }));
+ assert.equal(text(cells.ci), 'CI waiting · test not observed · new head d3c0824');
+ assert.equal(text(cells.review), 'Review pending · reviewer-2 queued · waiting on CI');
+ assert.match(cells.review, /hive is waiting on CI for new head d3c0824/);
+ // Review findings: the fixer's turn; CI is not the blocker and says so.
+ cells = physicalTracks(livePR({ head, stage: 70, display_column: 50, ci_activity: fresh('missing', 'CI waiting · test not observed'), review_activity: fresh('changes_requested', 'Review findings · awaiting author') }));
+ assert.equal(text(cells.ci), 'CI waiting · test not observed · waiting on the fix');
+ assert.equal(text(cells.review), 'Review findings · awaiting author');
+ // Red CI plus review findings: both are findings, neither defers to the other.
+ cells = physicalTracks(livePR({ head, stage: 70, display_column: 50, ci_activity: fresh('failing', 'CI failing · test (26)'), review_activity: fresh('changes_requested', 'Review findings · awaiting author') }));
+ assert.equal(text(cells.ci), 'CI failing · test (26)');
+ assert.equal(text(cells.review), 'Review findings · awaiting author');
+ // CI green, review pending: review leads, CI is done and says nothing extra.
+ cells = physicalTracks(livePR({ head, stage: 50, display_column: 50, ci_activity: fresh('passing', 'CI passed'), review_activity: fresh('pending', 'Review pending') }));
+ assert.equal(text(cells.ci), 'CI passed');
+ assert.equal(text(cells.review), 'Review pending');
+ // Both unknown (fresh PR): CI leads, review waits on CI.
+ cells = physicalTracks(livePR({ head, stage: 50, display_column: 50, ci_activity: { head, state: 'unknown', caption: 'CI unknown · required checks not observed', source: 'unavailable' }, review_activity: { head, state: 'unknown', caption: 'Review unknown · current-head evidence unavailable', source: 'unavailable' } }));
+ assert.equal(text(cells.ci), 'CI unknown · required checks not observed');
+ assert.equal(text(cells.review), 'Review unknown · current-head evidence unavailable · waiting on CI');
+ // Outside the current phase (merge gate) the lead clause is silent.
+ cells = physicalTracks(livePR({ head, stage: 80, display_column: 80, ci_activity: fresh('passing', 'CI passed'), review_activity: fresh('pending', 'Review pending') }));
+ assert.doesNotMatch(cells.review, /waiting on/);
+});
diff --git a/src/pkg/dashboard/static-src/js/tracker-row-strip.js b/src/pkg/dashboard/static-src/js/tracker-row-strip.js
index f5793609ff..4bf1458a1b 100644
--- a/src/pkg/dashboard/static-src/js/tracker-row-strip.js
+++ b/src/pkg/dashboard/static-src/js/tracker-row-strip.js
@@ -15,8 +15,33 @@
return `${cols}${stageTrackerIcon('history', 'ham-ico ham-history-ico', 'History — decisions and actions on this item')} since `;
}
+ // Pure: which of the two column-50 tracks the hive is waiting on when
+ // both share the current phase (hivecommons/hive#16484). Review
+ // findings and red CI are the fixer's turn ("the fix"); otherwise CI
+ // leads until it is green, then review. newHead: the head was just
+ // pushed, so CI is (re)running on it and the review is a re-review.
+ function stageTrackerTrackLead(item) {
+ if (!item || !item.head) return null;
+ const stateOf = k => { const a = item[k + '_activity']; return a && a.head === item.head && a.state ? a.state : 'unknown'; };
+ const ci = stateOf('ci');
+ const review = stateOf('review');
+ const done = s => s === 'passing' || s === 'approved';
+ const code = item.code_activity;
+ const push = item.push;
+ const newHead = !!((code && code.head === item.head && code.state === 'pushed') || (push && push.state === 'pushed' && push.sha === item.head));
+ if (review === 'changes_requested') return { track: 'review', waitingOn: 'the fix', newHead: false };
+ if (ci === 'failing') return { track: 'ci', waitingOn: 'the fix', newHead: false };
+ if (done(ci) && done(review)) return null;
+ if (done(ci)) return { track: 'review', waitingOn: 'review', newHead };
+ return { track: 'ci', waitingOn: 'CI', newHead };
+ }
+
// Evidence is supplied independently by the backend. A native 050 label
// cannot say who reviews, whether checks run, or whether an author codes.
+ // The chevron always carries a state word beside its glyph: unknown or
+ // stale evidence says so in words ("· seen 14m ago"), it never shrinks
+ // to a bare icon (hivecommons/hive#16484). Freshness still gates the
+ // pulse and the green fill, not the text.
function stageTrackerActivityTrackHtml(item, kind, sg, blank, nowMs) {
if (blank) return ` `;
const name = kind === 'ci' ? 'CI' : 'Review';
@@ -51,19 +76,34 @@
const codeObserved = Date.parse(code && code.observed_at || '');
const codeFresh = code && code.head === item.head && code.source === 'fix-dispatch+successful-edit+verified-git-worktree' && code.active && code.state === 'fixing' && Number.isFinite(codeObserved) && codeObserved <= clock && clock - codeObserved <= activityFreshMS;
if (!codeFresh) decided = decided.replace(/>(?:Fixing|Remediating)(?=\s|<)/g, '>Fix requested');
- const word = esc(caption);
+ const sha7 = item.head ? String(item.head).slice(0, 7) : '';
+ let seen = '';
+ if (matches && !known && state !== 'unknown') {
+ if (!Number.isFinite(observed)) seen = ' · observation time unknown';
+ else if (observed > clock) seen = ' · observation ahead of clock';
+ else {
+ const m = Math.floor((clock - observed) / 60000);
+ const h = Math.floor(m / 60);
+ seen = ' · seen ' + (m < 1 ? 'under a minute' : m < 60 ? m + 'm' : h < 48 ? h + 'h' : Math.floor(h / 24) + 'd') + ' ago';
+ }
+ }
+ let text = !matches ? name + ' unknown · no evidence for ' + (sha7 || 'this head') : (a.caption || name + ' ' + state) + seen;
+ const lead = current && ownsPR && typeof stageTrackerTrackLead === 'function' ? stageTrackerTrackLead(item) : null;
+ if (lead && lead.track === kind && lead.newHead && kind === 'ci' && sha7) text += ' · new head ' + sha7;
+ else if (lead && lead.track !== kind && !(state === 'passing' || state === 'approved' || state === 'failing' || state === 'changes_requested')) text += ' · waiting on ' + lead.waitingOn;
+ const word = esc(text);
const evidenceURL = matches && /^https?:\/\//i.test(String(a.url || '')) ? a.url : '';
- const evidenceLink = ownsPR && evidenceURL ? `${word} ` : word;
+ const icon = stageTrackerIcon(kind === 'ci' ? 'ci' : 50, 'ham-ico', name);
+ const evidenceLink = ownsPR && evidenceURL ? `${icon}${word} ` : icon + word;
const routeState = (sg.state || 'todo') + (sg.detour ? ' detoured' : '');
const hold = item.hold;
const fullTip = (current ? 'Current pipeline phase · ' : '') + name + ': ' + tip +
(matches && a.actor ? ' · actor ' + a.actor : '') +
(codeNote || contextWord ? ' · ' + (codeNote || contextWord) : '') +
- (hold ? ' · ' + (hold.pill || 'Held by @' + hold.by) + (hold.reason ? ' · ' + hold.reason : '') : '');
+ (hold ? ' · ' + (hold.pill || 'Held by @' + hold.by) + (hold.reason ? ' · ' + hold.reason : '') : '') +
+ (lead ? ' · hive is waiting on ' + lead.waitingOn + (lead.newHead && sha7 ? ' for new head ' + sha7 : '') : '');
const tipID = 'ham-track-tip-' + [item.repo || '', item.kind || '', item.number || 0, kind].map(x => encodeURIComponent(String(x))).join('-');
- const icon = stageTrackerIcon(kind === 'ci' ? 'ci' : 50, 'ham-ico', name);
- const content = known ? `${evidenceLink} ` : icon;
- const linkedIcon = !known && ownsPR && evidenceURL ? `${icon} ` : content;
+ const linkedIcon = `${evidenceLink} `;
return `${linkedIcon}${esc(fullTip)}${decided ? `${decided} ` : ''} `;
}
diff --git a/src/pkg/dashboard/static/index.html b/src/pkg/dashboard/static/index.html
index 46e302a2f5..7fd8fb7b73 100644
--- a/src/pkg/dashboard/static/index.html
+++ b/src/pkg/dashboard/static/index.html
@@ -17770,8 +17770,33 @@ Where to get help
return `${cols}${stageTrackerIcon('history', 'ham-ico ham-history-ico', 'History — decisions and actions on this item')} since `;
}
+ // Pure: which of the two column-50 tracks the hive is waiting on when
+ // both share the current phase (hivecommons/hive#16484). Review
+ // findings and red CI are the fixer's turn ("the fix"); otherwise CI
+ // leads until it is green, then review. newHead: the head was just
+ // pushed, so CI is (re)running on it and the review is a re-review.
+ function stageTrackerTrackLead(item) {
+ if (!item || !item.head) return null;
+ const stateOf = k => { const a = item[k + '_activity']; return a && a.head === item.head && a.state ? a.state : 'unknown'; };
+ const ci = stateOf('ci');
+ const review = stateOf('review');
+ const done = s => s === 'passing' || s === 'approved';
+ const code = item.code_activity;
+ const push = item.push;
+ const newHead = !!((code && code.head === item.head && code.state === 'pushed') || (push && push.state === 'pushed' && push.sha === item.head));
+ if (review === 'changes_requested') return { track: 'review', waitingOn: 'the fix', newHead: false };
+ if (ci === 'failing') return { track: 'ci', waitingOn: 'the fix', newHead: false };
+ if (done(ci) && done(review)) return null;
+ if (done(ci)) return { track: 'review', waitingOn: 'review', newHead };
+ return { track: 'ci', waitingOn: 'CI', newHead };
+ }
+
// Evidence is supplied independently by the backend. A native 050 label
// cannot say who reviews, whether checks run, or whether an author codes.
+ // The chevron always carries a state word beside its glyph: unknown or
+ // stale evidence says so in words ("· seen 14m ago"), it never shrinks
+ // to a bare icon (hivecommons/hive#16484). Freshness still gates the
+ // pulse and the green fill, not the text.
function stageTrackerActivityTrackHtml(item, kind, sg, blank, nowMs) {
if (blank) return ` `;
const name = kind === 'ci' ? 'CI' : 'Review';
@@ -17806,19 +17831,34 @@ Where to get help
const codeObserved = Date.parse(code && code.observed_at || '');
const codeFresh = code && code.head === item.head && code.source === 'fix-dispatch+successful-edit+verified-git-worktree' && code.active && code.state === 'fixing' && Number.isFinite(codeObserved) && codeObserved <= clock && clock - codeObserved <= activityFreshMS;
if (!codeFresh) decided = decided.replace(/>(?:Fixing|Remediating)(?=\s|<)/g, '>Fix requested');
- const word = esc(caption);
+ const sha7 = item.head ? String(item.head).slice(0, 7) : '';
+ let seen = '';
+ if (matches && !known && state !== 'unknown') {
+ if (!Number.isFinite(observed)) seen = ' · observation time unknown';
+ else if (observed > clock) seen = ' · observation ahead of clock';
+ else {
+ const m = Math.floor((clock - observed) / 60000);
+ const h = Math.floor(m / 60);
+ seen = ' · seen ' + (m < 1 ? 'under a minute' : m < 60 ? m + 'm' : h < 48 ? h + 'h' : Math.floor(h / 24) + 'd') + ' ago';
+ }
+ }
+ let text = !matches ? name + ' unknown · no evidence for ' + (sha7 || 'this head') : (a.caption || name + ' ' + state) + seen;
+ const lead = current && ownsPR && typeof stageTrackerTrackLead === 'function' ? stageTrackerTrackLead(item) : null;
+ if (lead && lead.track === kind && lead.newHead && kind === 'ci' && sha7) text += ' · new head ' + sha7;
+ else if (lead && lead.track !== kind && !(state === 'passing' || state === 'approved' || state === 'failing' || state === 'changes_requested')) text += ' · waiting on ' + lead.waitingOn;
+ const word = esc(text);
const evidenceURL = matches && /^https?:\/\//i.test(String(a.url || '')) ? a.url : '';
- const evidenceLink = ownsPR && evidenceURL ? `${word} ` : word;
+ const icon = stageTrackerIcon(kind === 'ci' ? 'ci' : 50, 'ham-ico', name);
+ const evidenceLink = ownsPR && evidenceURL ? `${icon}${word} ` : icon + word;
const routeState = (sg.state || 'todo') + (sg.detour ? ' detoured' : '');
const hold = item.hold;
const fullTip = (current ? 'Current pipeline phase · ' : '') + name + ': ' + tip +
(matches && a.actor ? ' · actor ' + a.actor : '') +
(codeNote || contextWord ? ' · ' + (codeNote || contextWord) : '') +
- (hold ? ' · ' + (hold.pill || 'Held by @' + hold.by) + (hold.reason ? ' · ' + hold.reason : '') : '');
+ (hold ? ' · ' + (hold.pill || 'Held by @' + hold.by) + (hold.reason ? ' · ' + hold.reason : '') : '') +
+ (lead ? ' · hive is waiting on ' + lead.waitingOn + (lead.newHead && sha7 ? ' for new head ' + sha7 : '') : '');
const tipID = 'ham-track-tip-' + [item.repo || '', item.kind || '', item.number || 0, kind].map(x => encodeURIComponent(String(x))).join('-');
- const icon = stageTrackerIcon(kind === 'ci' ? 'ci' : 50, 'ham-ico', name);
- const content = known ? `${evidenceLink} ` : icon;
- const linkedIcon = !known && ownsPR && evidenceURL ? `${icon} ` : content;
+ const linkedIcon = `${evidenceLink} `;
return `${linkedIcon}${esc(fullTip)}${decided ? `${decided} ` : ''} `;
}