Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Fix/proximity a11y risk cues (#3193)

Tamer2b6e839771e5
diff --git a/scripts/lib/control-pane/proximity-viz.js b/scripts/lib/control-pane/proximity-viz.js
index b173605a6..27e6cf499 100644
--- a/scripts/lib/control-pane/proximity-viz.js
+++ b/scripts/lib/control-pane/proximity-viz.js
@@ -32,6 +32,7 @@ function renderProximityVizHtml() {
canvas { width: 100%; height: 100%; display: block; }
#side { border-left: 1px solid #1f2630; padding: 12px 14px; overflow-y: auto; }
#side h2 { font-size: 12px; text-transform: uppercase; letter-spacing: .04em; color: #8b949e; margin: 0 0 8px; }
+ #side h2:not(:first-child) { margin-top: 16px; }
.adv { border: 1px solid #1f2630; border-radius: 8px; padding: 8px 10px; margin-bottom: 8px; }
.adv.resolution { border-color: #b3402f; }
.adv.advisory { border-color: #9a6700; }
@@ -41,8 +42,11 @@ function renderProximityVizHtml() {
.adv .who { color: #c9d1d9; }
.adv .act { color: #8b949e; font-size: 12px; margin-top: 3px; }
.empty { color: #6e7681; }
+ .agent-row { display: flex; gap: 8px; align-items: baseline; padding: 3px 0; font-size: 12px; }
+ .agent-row .who { color: #c9d1d9; overflow-wrap: anywhere; }
+ .agent-row .risk { margin-left: auto; color: #8b949e; white-space: nowrap; }
#legend { position: absolute; left: 12px; bottom: 12px; font-size: 11px; color: #8b949e; background: rgba(11,14,20,.7); padding: 6px 8px; border-radius: 6px; }
- .dot { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-right: 5px; vertical-align: middle; }
+ .shape { display: inline-block; width: 12px; margin-right: 5px; text-align: center; font-weight: 700; }
</style>
</head>
<body>
@@ -53,16 +57,18 @@ function renderProximityVizHtml() {
</header>
<div id="wrap">
<div id="stage">
- <canvas id="c"></canvas>
+ <canvas id="c" role="img" aria-label="Agent airspace visualization. See the Agents panel for a text alternative.">Agent airspace visualization; see the Agents panel for per-agent risk.</canvas>
<div id="legend">
- <div><span class="dot" style="background:#3fb950"></span>clear</div>
- <div><span class="dot" style="background:#e3b341"></span>traffic advisory (transmit)</div>
- <div><span class="dot" style="background:#ff7b72"></span>resolution (steer)</div>
+ <div><span class="shape" style="color:#3fb950">●</span>clear</div>
+ <div><span class="shape" style="color:#e3b341">■</span>traffic advisory (transmit)</div>
+ <div><span class="shape" style="color:#ff7b72">▲</span>resolution (steer)</div>
</div>
</div>
<div id="side">
<h2>Advisories</h2>
<div id="advisories"><div class="empty">No advisories - airspace clear.</div></div>
+ <h2>Agents</h2>
+ <div id="agents"><div class="empty">No agents.</div></div>
</div>
</div>
<script>
@@ -81,12 +87,33 @@ function renderProximityVizHtml() {
}
window.addEventListener('resize', resize);
+ function riskLevel(risk) {
+ if (risk >= 0.7) return 'resolution';
+ if (risk >= 0.35) return 'advisory';
+ return 'clear';
+ }
+
function riskColor(risk) {
if (risk >= 0.7) return '#ff7b72';
if (risk >= 0.35) return '#e3b341';
return '#3fb950';
}
+ function drawRiskMarker(x, y, radius, level) {
+ ctx.beginPath();
+ if (level === 'resolution') {
+ ctx.moveTo(x, y - radius);
+ ctx.lineTo(x + radius, y + radius);
+ ctx.lineTo(x - radius, y + radius);
+ ctx.closePath();
+ } else if (level === 'advisory') {
+ ctx.rect(x - radius, y - radius, radius * 2, radius * 2);
+ } else {
+ ctx.arc(x, y, radius, 0, Math.PI * 2);
+ }
+ ctx.fill();
+ }
+
// 3D to 2D: rotate around Y, simple perspective.
function project(p, w, h) {
var x = p[0], y = p[1] || 0, z = p[2] || 0;
@@ -122,8 +149,9 @@ function renderProximityVizHtml() {
var ag = state.positions[k];
var p = pos[ag.agentId];
var radius = (6 + Math.sqrt(ag.fileCount || 1) * 3) * p[2];
- ctx.fillStyle = riskColor(state.riskByAgent[ag.agentId] || 0);
- ctx.beginPath(); ctx.arc(p[0], p[1], radius, 0, Math.PI * 2); ctx.fill();
+ var agentRisk = state.riskByAgent[ag.agentId] || 0;
+ ctx.fillStyle = riskColor(agentRisk);
+ drawRiskMarker(p[0], p[1], radius, riskLevel(agentRisk));
ctx.fillStyle = '#c9d1d9';
ctx.font = '11px -apple-system, system-ui, sans-serif';
ctx.fillText(String(ag.agentId).slice(0, 18), p[0] + radius + 4, p[1] + 3);
@@ -155,6 +183,25 @@ function renderProximityVizHtml() {
});
}
+ function renderAgents() {
+ var box = document.getElementById('agents');
+ box.textContent = '';
+ if (!state.positions.length) {
+ var empty = document.createElement('div'); empty.className = 'empty';
+ empty.textContent = 'No agents.'; box.appendChild(empty); return;
+ }
+ state.positions.forEach(function (agent) {
+ var risk = state.riskByAgent[agent.agentId] || 0;
+ var row = document.createElement('div'); row.className = 'agent-row';
+ var who = document.createElement('span'); who.className = 'who';
+ who.textContent = String(agent.agentId); row.appendChild(who);
+ var riskText = document.createElement('span'); riskText.className = 'risk';
+ riskText.textContent = Math.round(risk * 100) + '% - ' + riskLevel(risk);
+ row.appendChild(riskText);
+ box.appendChild(row);
+ });
+ }
+
function applySnapshot(prox) {
state.positions = prox.positions || [];
state.links = prox.links || [];
@@ -166,7 +213,11 @@ function renderProximityVizHtml() {
});
state.riskByAgent = risk;
renderAdvisories();
+ renderAgents();
var c = prox.counts || {};
+ canvas.setAttribute('aria-label',
+ (c.agents || state.positions.length) + ' agents in airspace, ' +
+ (c.advisories || state.advisories.length) + ' advisories. See the Agents panel for per-agent risk.');
document.getElementById('status').textContent =
(c.agents || 0) + ' agents - ' + (c.advisories || 0) + ' advisories - ' + (c.resolutions || 0) + ' steering';
}
diff --git a/tests/lib/proximity-viz-a11y.test.js b/tests/lib/proximity-viz-a11y.test.js
new file mode 100644
index 000000000..e60ecdd7c
--- /dev/null
+++ b/tests/lib/proximity-viz-a11y.test.js
@@ -0,0 +1,17 @@
+'use strict';
+
+const assert = require('assert');
+const { renderProximityVizHtml } = require('../../scripts/lib/control-pane/proximity-viz');
+
+const html = renderProximityVizHtml();
+
+assert.ok(html.includes('role="img"'), 'canvas should expose an image role');
+assert.ok(html.includes('id="agents"'), 'airspace should include a text alternative for every agent');
+assert.ok(html.includes("function riskLevel(risk)"), 'risk levels should be named independently of color');
+assert.ok(html.includes("ctx.rect(x - radius"), 'traffic advisories should use a square marker');
+assert.ok(html.includes("ctx.lineTo(x + radius"), 'resolution advisories should use a triangular marker');
+assert.ok(html.includes('●</span>clear'), 'legend should show the clear circle marker');
+assert.ok(html.includes('■</span>traffic advisory'), 'legend should show the advisory square marker');
+assert.ok(html.includes('▲</span>resolution'), 'legend should show the resolution triangle marker');
+
+console.log('Results: Passed: 8, Failed: 0');