fix(inference): let unofficial run overlays win the cross-engine AgentX guard / 修复：让非官方 run 的 overlay 在跨引擎 AgentX 互斥中优先显示

[cquil11]

Summary

Fixes ?unofficialrun=<id> overlays never rendering on agentic (AgentX) charts when the run's engine family conflicts with the active official selection — reported for run 29272097721 (benchmark PR SemiAnalysisAI/InferenceX#2153, lmcache/agentix, vLLM).

Root cause

The cross-engine AgentX STP exclusion (#549) resolves engine-family conflicts with a sticky set (resolveExclusionGroups(proposed, prev, …, 'keep-sticky')), and both resolution sites passed the official selection as prev:

1. ChartDisplay — resolvedScopedOverlayHwTypes resolved with officials-first previous, and its reconciliation effect then stripped the run's hw types from the UnofficialRunProvider (setActiveOverlayHwTypes), so the overlay was gone before the chart rendered.
2. ScatterGraph — the unified official+overlay selection used rawOfficialHwTypes as the sticky set, dropping overlay:* keys at render time.

The run's legend entry is not a toggle, so there was no UI affordance to recover — the loaded run was permanently invisible (its "Points" dialog reported "No visible points for this series under the current filters").

Fix

An unofficial run is loaded to be seen: whenever overlay hw types are in scope, use the run's engine family as the sticky set in both resolution sites, falling back to the official selection otherwise. Consequences:

• The overlay renders on load; conflicting official series deselect (dim in the legend).
• Same-family officials can be re-enabled with a normal legend click (fallthrough, verified).
• Clicking a conflicting dim official still hits the existing block toast explaining engine-specific benchmark implementations (verified).
• Dismissing the run restores the official selection (mechanism unchanged).
• With no overlay in scope, behavior is byte-identical to before (officials-sticky).

Tests

• exclusion.test.ts: extended the sticky-resolution unit test to cover both official-sticky and overlay-sticky prev (documents the new caller contract).
• scatter-graph.cy.tsx component specs:
  • flipped the fix(inference): block cross-engine AgentX STP comparisons / 阻止 AgentX STP 跨引擎对比 #549 guard test — the cross-engine overlay roofline now renders and the conflicting official hides (opacity: 0), with no reconciliation write-back;
  • new same-engine-family test — official and overlay both render;
  • new ChartDisplay table-mode test — the overlay row survives, the conflicting official row drops, and setActiveOverlayHwTypes is not called (guards the provider-strip regression).

tsc --noEmit, oxlint, oxfmt, vitest (2568 tests), and the full Cypress component suite (178 tests) all pass locally.

Overlay support

This change is entirely about the ?unofficialrun= overlay path — verified manually against a local dev server with the real run ?unofficialrun=29272097721: the lmcache/agentix vLLM roofline renders on the DeepSeek V4 Pro agentic chart, same-family official re-enable works, conflicting-family click shows the block toast. Will re-verify on the Vercel preview once it builds.

中文说明

修复当非官方 run（?unofficialrun=<id>）的引擎家族与当前官方选择冲突时，agentic（AgentX）图表上 overlay 永远不渲染的问题——由 run 29272097721（基准测试 PR SemiAnalysisAI/InferenceX#2153，lmcache/agentix 分支，vLLM）报告。

根因：#549 引入的跨引擎 AgentX STP 互斥规则在解析冲突时以官方选择作为粘性集合。ChartDisplay 的同步 effect 会把 run 的硬件类型从 provider 中剥离，ScatterGraph 的统一选择解析也会在渲染时丢弃 overlay:* 键；而 run 的图例项不是开关，用户没有任何方式恢复显示。

修复：只要 overlay 硬件类型在作用域内，两处解析均以 run 的引擎家族作为粘性集合，否则回退到官方选择。overlay 加载后立即渲染；冲突的官方系列被取消选择（图例中变暗），同家族官方配置可通过点击图例恢复，点击冲突家族仍会触发原有的拦截提示；关闭 run 即可恢复官方选择。无 overlay 时行为与之前完全一致。

测试：扩展了 exclusion.test.ts 的粘性解析单元测试；翻转了 #549 的组件测试预期并新增同家族用例；新增 ChartDisplay 表格模式测试，验证 overlay 行保留、冲突官方行剔除、且不会向 provider 写回剥离后的选择。本地 tsc、oxlint、oxfmt、vitest（2568 项）与 Cypress 组件套件（178 项）全部通过，并已用真实 run ?unofficialrun=29272097721 在本地手动验证。

🤖 Generated with Claude Code

---

Note

Medium Risk
Changes legend/comparison selection and provider sync on agentic charts with unofficial overlays; behavior is unchanged when no overlay is in scope, but cross-engine conflicts now prefer overlays over officials.

Overview
Fixes unofficial run overlays never showing on agentic charts when the loaded run’s engine family conflicts with the active official selection (e.g. vLLM overlay vs SGLang official).

ScatterGraph adds exclusionStickySet: if any overlay hw types are in scope, resolveComparisonSelection uses overlay:* keys as the sticky prev instead of the official selection, so the run’s family wins and conflicting officials are deselected (dimmed) rather than dropping the overlay. Reset filter uses the same sticky preference so it does not flip back to officials and hide the run.

ChartDisplay mirrors that logic in resolvedScopedOverlayHwTypes and visibleComparisonRows, preventing the reconciliation effect from calling setActiveOverlayHwTypes to strip overlay keys before render. Table mode follows the same resolution (overlay row kept, conflicting official dropped).

Tests: exclusion.test.ts documents both official-sticky and overlay-sticky prev; Cypress specs flip the cross-engine guard expectation, add same-family coexistence, and guard the provider write-back regression.

^{Reviewed by Cursor Bugbot for commit 986e355. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
inferencemax-app	Ready	Preview, Comment	Jul 14, 2026 12:07am

[cquil11]

Note: the Vercel preview deployment is protected by Vercel Authentication and a share link could not be generated, so the ?unofficialrun=29272097721 verification was done against a local dev server running this exact commit (real read-only DB + real GitHub artifacts): the lmcache/agentix vLLM overlay roofline renders on the DeepSeek V4 Pro agentic chart, same-family official re-enable works via legend click, and clicking a conflicting-family official shows the block toast. / 说明：Vercel 预览部署受 Vercel Authentication 保护、无法生成共享链接，因此 ?unofficialrun=29272097721 的验证是在运行本 commit 的本地 dev server（真实只读数据库 + 真实 GitHub 产物）上完成的：lmcache/agentix 的 vLLM overlay 曲线在 DeepSeek V4 Pro agentic 图表上正常渲染，同引擎家族官方配置可通过图例点击恢复，点击冲突家族官方配置会触发拦截提示。

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2b38d36. Configure here.}