dash test runner

2026-07-11 21:59:37 +03:00
parent f99237b4e6
commit bd99c5177b
6 changed files with 491 additions and 13 deletions
--- a/.ralph-tui/config.toml
+++ b/.ralph-tui/config.toml
@@ -1,7 +0,0 @@
-[agent]
-name = "claude"
-model = "opus"
-
-[run]
-iterations = 10
-delayMs = 1000
--- a/.scratch/dashboard-test-runner/prd.json
+++ b/.scratch/dashboard-test-runner/prd.json
@@ -33,11 +33,12 @@
        "uv run pytest tests/test_dashboard.py -q passes."
      ],
      "priority": 2,
-      "passes": false,
+      "passes": true,
      "notes": "Depends on US-001. Preserve existing dashboard tabs and admin authentication conventions.",
      "dependsOn": [
        "US-001"
-      ]
+      ],
+      "completionNotes": "Completed by agent"
    },
    {
      "id": "US-003",
@@ -59,6 +60,6 @@
    }
  ],
  "metadata": {
-    "updatedAt": "2026-07-11T12:58:47.086Z"
+    "updatedAt": "2026-07-11T17:02:30.520Z"
  }
 }
--- a/.scratch/dashboard-test-runner/ralph-opus-iterations/bc37171f_2026-07-11_16-12-14_US-002.log
+++ b/.scratch/dashboard-test-runner/ralph-opus-iterations/bc37171f_2026-07-11_16-12-14_US-002.log
@@ -0,0 +1,104 @@
+# Iteration 1 Log
+
+## Metadata
+
+- **Task ID**: US-002
+- **Task Title**: Add Testing dashboard tab with live test logs
+- **Description**: As a tracker administrator, I want a Testing tab that lists discovered tests and exposes run/status/log controls so that I can operate and inspect tests from the dashboard.
+- **Status**: failed
+- **Task Completed**: No
+- **Promise Detected**: No
+- **Started At**: 2026-07-11T13:12:14.739Z
+- **Ended At**: 2026-07-11T13:17:21.820Z
+- **Duration**: 5m 7s
+- **Input Tokens**: 202
+- **Output Tokens**: 19077
+- **Total Tokens**: 19279
+- **Agent**: claude
+- **Model**: claude-opus-4-8
+- **Sandbox Mode**: auto
+- **Sandbox Network**: Enabled
+--- RAW OUTPUT ---
+I'll start by studying the context — the PRD, progress notes, and existing dashboard code.
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/.ralph-tui/progress.md[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/.scratch/dashboard-test-runner/prd.json[0m
+US-001 is marked complete. Let me find the dashboard and the test-runner API it added.
+[94m[Bash][0m $ git log --oneline -3 && echo "--- FILES ---" && grep -rl "test.runner\|test_runner\|testRunner" --in...
+[94m[Bash][0m $ ls tests/test_dashboard.py && find . -name "*.py" -path "*tracker*" -not -path "*/node_modules/*" -n...
+Let me read the US-001 API surface that I need to consume.
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/test_runner.py[0m
+[94m[Bash][0m $ grep -n "test" packages/tracker/meshnet_tracker/server.py | grep -i "route\|def \|path\|/api" | head...
+Now the server endpoints and the dashboard structure.
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/server.py[0m
+[94m[Bash][0m $ echo "=== dashboard files ===" && find . -name "*.html" -not -path "*/node_modules/*" -not -path "*/...
+Now the dashboard itself — I need its tab structure and admin-gating conventions.
+[94m[Bash][0m $ cd /run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker echo "LINES: $(wc -l...
+Let me read the key regions: nav markup, tab-switching, admin mode, and the per-tab fetch dispatch.
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+Now the helper functions I'll reuse: `apiCall`, `renderIfChanged`, `renderConsole`, `table`.
+[94m[Bash][0m $ cd /run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker grep -n "^function a...
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+I have the full picture. Let me check the CSS classes and the tail of the existing test file for conventions.
+[94m[Bash][0m $ cd /run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker echo "=== console cs...
+Now I'll implement. First the nav tab and panels.
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "  <button id="tab-admin" style="display:none" oncl..." → "  <button id="tab-admin" style="display:none" oncl..."
+Now the Testing panels:
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "  <section data-tab="admin" class="wide"><h2>Conso..." → "  <section data-tab="admin" class="wide"><h2>Conso..."
+Now the CSS, alongside the existing console styles:
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "  .status-pending { color:var(--warn); }" → "  .testing-controls { display:flex; gap:8px; margi..."
+Now the JS module. I'll insert it after `renderConsole`, using event delegation (matching the chat-session pattern) rather than inline `onclick` with interpolated node IDs.
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "// ---- account panel (registration / login / bala..." → "// ---- testing tab (opt-in tracker test runner, d..."
+Now wire it into the tab machinery: `switchDashboardTab`, `setAdminMode`, `TAB_FETCHERS`, and the poll loop.
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "function switchDashboardTab(name) {
+  if (name ===..." → "function switchDashboardTab(name) {
+  if ((name ==..."
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "function setAdminMode(enabled) {
+  isAdmin = enabl..." → "function setAdminMode(enabled) {
+  isAdmin = enabl..."
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "const TAB_FETCHERS = {
+  overview: fetchOverviewTa..." → "const TAB_FETCHERS = {
+  overview: fetchOverviewTa..."
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "bindChatSessionList();
+bindChatModelSelect();
+init..." → "bindChatSessionList();
+bindChatModelSelect();
+init..."
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "setInterval(pollCallWallIfIdle, CALL_WALL_POLL_MS)..." → "setInterval(pollCallWallIfIdle, CALL_WALL_POLL_MS)..."
+One cleanup — `wasActive` is always true after the guard, so it's dead:
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/packages/tracker/meshnet_tracker/dashboard.html[0m edit: "async function pollTestRunIfActive() {
+  if (dashb..." → "async function pollTestRunIfActive() {
+  if (dashb..."
+Now the regression tests. Let me check how existing tests assert on dashboard internals so I match the style:
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_dashboard.py[0m
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_dashboard.py[0m
+Now the regression tests. I'll add the new panels to the existing `PANELS` list and add a focused test.
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_dashboard.py[0m edit: "    "Chat / inference",
+    "Console output",
+]" → "    "Chat / inference",
+    "Console output",
+    ..."
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_dashboard.py[0m
+[94m[Edit][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_dashboard.py[0m edit: "        assert expired_event["fields"]["model_heal..." → "        assert expired_event["fields"]["model_heal..."
+Now run the required test suite:
+[94m[Bash][0m $ cd /run/media/popov/d/DEV/repos/d-popov.com/AI && uv run pytest tests/test_dashboard.py -q 2>&1 | ta...
+All 15 pass. The dashboard has no build step, so a JS syntax error would silently break the entire page — let me verify the script parses.
+[94m[Bash][0m $ python3 -c " import re,pathlib html = pathlib.Path('packages/tracker/meshnet_tracker/dashboard.html'...
+Syntax is clean. Now let me verify my payload-field assumptions against the real API end-to-end, rather than trusting the shapes I read.
+[94m[Bash][0m $ grep -n "enable_test_runner\|admin\|token\|def test_start" tests/test_tracker_test_runner.py | head ...
+[94m[Read][0m [95m/run/media/popov/d/DEV/repos/d-popov.com/AI/tests/test_tracker_test_runner.py[0m
+Now let me drive the real endpoints exactly as the dashboard does, and dump the payloads my renderers consume.
+[94m[Bash][0m $ outcome =",           "success" if run["status"] == "passed" else "failure")      st, err = req("POS...
+Verified end-to-end against the live API: non-admin blocked (403), 484 tests + 3 suites collected dynamically, run accepted (202), concurrent run rejected (409), every field my renderers read is present, and errors surface with the server's own wording.
+
+Now the broader regression + lint check:
+[94m[Bash][0m $ uv run pytest tests/test_dashboard.py tests/test_tracker_test_runner.py tests/test_tracker_routing.p...
+[94m[Bash][0m $ uv run ruff check tests/test_dashboard.py packages/tracker/meshnet_tracker/ 2>&1 | tail -6
+You've hit your session limit · resets 8:20pm (Europe/Sofia)
+
+[91m[Error: rate_limit][0m
--- a/.scratch/dashboard-test-runner/ralph-terra-iterations/1998cbcc_2026-07-11_20-01-02_US-002.log
+++ b/.scratch/dashboard-test-runner/ralph-terra-iterations/1998cbcc_2026-07-11_20-01-02_US-002.log
@@ -0,0 +1,52 @@
+# Iteration 1 Log
+
+## Metadata
+
+- **Task ID**: US-002
+- **Task Title**: Add Testing dashboard tab with live test logs
+- **Description**: As a tracker administrator, I want a Testing tab that lists discovered tests and exposes run/status/log controls so that I can operate and inspect tests from the dashboard.
+- **Status**: completed
+- **Task Completed**: Yes
+- **Promise Detected**: Yes
+- **Started At**: 2026-07-11T17:01:02.422Z
+- **Ended At**: 2026-07-11T17:02:30.520Z
+- **Duration**: 1m 28s
+- **Input Tokens**: 553854
+- **Output Tokens**: 3872
+- **Total Tokens**: 557726
+- **Agent**: codex
+- **Model**: gpt-5.6-terra
+- **Sandbox Mode**: auto
+- **Sandbox Network**: Enabled
+--- RAW OUTPUT ---
+I’ll inspect the project context and the existing dashboard/test setup, then implement and verify US-002 without committing changes.
+[94m[shell][0m $ /bin/bash -lc "sed -n '1,240p' .claude/memory/MEMORY.md && sed -n '1,260p' .ralph-tui/progress.md &&...
+I’m using the repo’s implementation workflow because this story is scoped from a PRD; I’ll follow its test-first seam where practical, but will leave the work uncommitted as requested.
+[94m[shell][0m $ /bin/bash -lc "rg -n --glob '"'!*'"\\.lock' 'US-002|Testing tab|test logs|tests/suites' .scratch .ra...
+[94m[shell][0m $ /bin/bash -lc "sed -n '1,220p' .scratch/dashboard-test-runner/PRD.md sed -n '1,460p' tests/test_dash...
+The dashboard implementation and its regression coverage are already present in the worktree. I’m validating the rendered tab and its integration points now; if the required test passes, I’ll record the completed story rather than duplicate it.
+The requested command was blocked only by uv’s default cache being read-only in this sandbox. I’ll rerun it with the repository-local cache, then run the configured static checks and append the required progress entry.
+[94m[shell][0m $ /bin/bash -lc "UV_CACHE_DIR=.uv-cache uv run pytest tests/test_dashboard.py -q printf '\\n--- tool c...
+The test file cannot bind localhost in this environment, so all 15 tests fail before rendering the dashboard (`PermissionError: [Errno 1] Operation not permitted`). The implementation itself matches the server/API and UI acceptance checks; I’ll finish with non-network static validation and the required progress record.
+[94m[shell][0m $ /bin/bash -lc "sed -n '1,180p' pyproject.toml rg -n 'testing tab|dashboard tabs|data-admin-only|dash...
+
+[91m[Error: [Errno 2] No such file or directory: 'packages/tracker/meshnet_tracker/dashboard.py'error: Failed to spawn: `ruff`
+  Caused by: No such file or directory (os error 2)
+][0m
+[94m[shell][0m $ /bin/bash -lc 'tail -80 .ralph-tui/progress.md UV_CACHE_DIR=.uv-cache uv run python -m py_compile pa...
+Static Python compilation and whitespace checks pass. Ruff is not installed in the current uv environment; I’ve recorded that alongside the environment-specific socket limitation. I’ll now do the implementation workflow’s final focused review of the uncommitted dashboard change.
+[94m[shell][0m $ /bin/bash -lc "sed -n '1,320p' .agents/skills/review/SKILL.md"
+[94m[shell][0m $ /bin/bash -lc "git diff --check && git status --short && tail -30 .ralph-tui/progress.md && rg -n 'T...
+[94m[shell][0m $ /bin/bash -lc "rg -n -C 1 'socket-backed verification|PermissionError|UV_CACHE_DIR' /home/popov/.cod...
+US-002 is implemented and documented in `.ralph-tui/progress.md`; no commit created.
+
+Validation:
+- Python compilation and `git diff --check` pass.
+- `uv run pytest tests/test_dashboard.py -q` is blocked here: sandbox disallows localhost sockets (`PermissionError`), so TrackerServer cannot start.
+- Ruff is unavailable in the current uv environment.
+
+<promise>COMPLETE</promise>
+
+
+--- STDERR ---
+warning: `--full-auto` is deprecated; use `--sandbox workspace-write` instead.
--- a/packages/tracker/meshnet_tracker/dashboard.html
+++ b/packages/tracker/meshnet_tracker/dashboard.html
@@ -212,6 +212,16 @@
  .console-level-info { color:var(--accent); }
  .console-level-warn { color:var(--warn); }
  .console-level-error { color:var(--bad); }
+  .testing-controls { display:flex; gap:8px; margin-bottom:8px; }
+  .testing-controls input { flex:1; background:var(--bg); border:1px solid var(--border);
+    color:var(--fg); border-radius:6px; padding:4px 8px; font-size:12px; }
+  .testing-error { border:1px solid var(--bad); border-radius:6px; color:var(--bad);
+    padding:6px 9px; margin-bottom:8px; font-size:12px; }
+  .testing-list { max-height:320px; overflow:auto; }
+  .testing-row { display:flex; align-items:center; gap:8px; padding:3px 0;
+    border-bottom:1px solid var(--border); font-size:12px; }
+  .testing-row .testing-target { flex:1; word-break:break-all; font-family:monospace; }
+  .testing-row button[disabled] { opacity:.45; cursor:not-allowed; }
  .status-pending { color:var(--warn); }
  .status-processing { color:var(--accent); }
  .status-failed { color:var(--bad); }
@@ -233,6 +243,7 @@
  <button id="tab-chat" onclick="switchDashboardTab('chat')">Chat</button>
  <button id="tab-billing" style="display:none" onclick="switchDashboardTab('billing')">Billing</button>
  <button id="tab-admin" style="display:none" onclick="switchDashboardTab('admin')">Admin</button>
+  <button id="tab-testing" style="display:none" onclick="switchDashboardTab('testing')">Testing</button>
 </nav>
 <main>
  <section data-tab="overview" id="account-section"><h2>Account</h2><div id="account">loading…</div></section>
@@ -278,6 +289,23 @@
  <section data-tab="admin" data-admin-only><h2>Strikes / bans / forfeitures</h2><div id="fraud" class="empty">admin login required</div></section>
  <section data-tab="admin"><h2>Client balances</h2><div id="clients" class="empty">admin login required</div></section>
  <section data-tab="admin" class="wide"><h2>Console output</h2><div id="console" class="console empty">admin login required</div></section>
+  <section data-tab="testing" data-admin-only>
+    <h2>Test run status</h2>
+    <div id="testing-error" class="testing-error" hidden></div>
+    <div id="testing-status" class="empty">no test run yet</div>
+  </section>
+  <section data-tab="testing" data-admin-only>
+    <h2>Tests &amp; suites</h2>
+    <div class="testing-controls">
+      <input id="testing-filter" type="search" placeholder="filter tests…" oninput="renderTestTargets()" aria-label="Filter tests">
+      <button class="small" type="button" onclick="reloadTestTargets()">re-collect</button>
+    </div>
+    <div id="testing-targets" class="empty">admin login required</div>
+  </section>
+  <section data-tab="testing" data-admin-only class="wide">
+    <h2>Test output</h2>
+    <div id="testing-log" class="console empty">no test output yet</div>
+  </section>
 </main>
 <script>
 "use strict";
@@ -986,6 +1014,216 @@ function renderConsole(data) {
  }).join("");
 }

+// ---- testing tab (opt-in tracker test runner, dashboard-test-runner US-002) ----
+
+let testCollection = { tests: [], suites: [] };
+let testRun = null;
+let testRunStarting = false;
+
+const TEST_RUN_POLL_MS = 1500;
+const TEST_LOG_MAX_LINES = 400;
+
+function testRunActive() {
+  return testRunStarting || (testRun !== null && testRun.status === "running");
+}
+
+function showTestingError(message) {
+  const el = $("testing-error");
+  if (!el) return;
+  el.hidden = !message;
+  el.textContent = message || "";
+}
+
+// Non-2xx from the tracker carries {"error": ...}; 403 also covers the
+// disabled-by-default runner, so surface the server's own wording.
+function testingErrorText(result) {
+  if (!result) return "test runner request failed";
+  if (result.status === 0) return "test runner unreachable";
+  return (result.data && result.data.error) || `test runner request failed (HTTP ${result.status})`;
+}
+
+function fmtElapsed(seconds) {
+  if (typeof seconds !== "number" || !isFinite(seconds) || seconds < 0) return "—";
+  if (seconds < 60) return `${seconds.toFixed(1)}s`;
+  const mins = Math.floor(seconds / 60);
+  return `${mins}m ${Math.floor(seconds % 60)}s`;
+}
+
+function fmtTestTime(ts) {
+  if (typeof ts !== "number" || !ts) return "—";
+  return new Date(ts * 1000).toLocaleTimeString();
+}
+
+function testStatusClass(status) {
+  if (status === "running") return "status-processing";
+  if (status === "passed") return "status-complete";
+  if (status === "failed" || status === "timeout") return "status-failed";
+  return "status-pending";
+}
+
+function renderTestRunStatus() {
+  const el = $("testing-status");
+  if (!el) return;
+  if (!testRun) {
+    el.className = "empty";
+    el.innerHTML = testRunStarting ? "starting test run…" : "no test run yet";
+    return;
+  }
+  el.className = "";
+  const status = String(testRun.status || "unknown");
+  const exitCode = testRun.exit_code;
+  const outcome = status === "running"
+    ? '<span class="status-processing">running</span>'
+    : status === "passed"
+      ? '<span class="ok">success</span>'
+      : `<span class="bad">failure</span>`;
+  el.innerHTML = table(
+    ["target", "state", "outcome", "started", "ended", "elapsed", "exit code"],
+    [[
+      `<span class="testing-target">${esc(testRun.target || "—")}</span>`,
+      `<span class="pill ${testStatusClass(status)}">${esc(status)}</span>`,
+      outcome,
+      fmtTestTime(testRun.started_at),
+      fmtTestTime(testRun.finished_at),
+      `<span class="num">${fmtElapsed(testRun.elapsed_seconds)}</span>`,
+      exitCode === null || exitCode === undefined
+        ? '<span class="dim">—</span>'
+        : `<span class="num ${exitCode === 0 ? "ok" : "bad"}">${esc(exitCode)}</span>`,
+    ]],
+  );
+}
+
+function renderTestLog(stdout, stderr) {
+  const el = $("testing-log");
+  if (!el) return;
+  const lines = [];
+  for (const line of String(stdout || "").split("\n")) {
+    if (line !== "") lines.push({ text: line, err: false });
+  }
+  for (const line of String(stderr || "").split("\n")) {
+    if (line !== "") lines.push({ text: line, err: true });
+  }
+  if (!lines.length) {
+    el.className = "console empty";
+    el.innerHTML = testRunActive() ? "waiting for test output…" : "no test output yet";
+    return;
+  }
+  // Bounded view: the tracker already caps retained lines; cap the DOM too.
+  const shown = lines.slice(-TEST_LOG_MAX_LINES);
+  const pinned = el.scrollTop + el.clientHeight >= el.scrollHeight - 24;
+  el.className = "console";
+  el.innerHTML = shown.map(line =>
+    `<div class="console-line${line.err ? " console-level-error" : ""}">${esc(line.text)}</div>`
+  ).join("");
+  if (pinned) el.scrollTop = el.scrollHeight;
+}
+
+function renderTestTargets() {
+  const el = $("testing-targets");
+  if (!el) return;
+  const filter = ($("testing-filter")?.value || "").trim().toLowerCase();
+  const suites = (testCollection.suites || [])
+    .map(s => ({ id: s.id, label: `${s.name} (${(s.paths || []).join(", ")})`, suite: true }));
+  const tests = (testCollection.tests || []).map(t => ({ id: t, label: t, suite: false }));
+  const targets = [...suites, ...tests]
+    .filter(t => !filter || t.label.toLowerCase().includes(filter));
+  if (!targets.length) {
+    el.className = "empty";
+    el.innerHTML = filter ? "no targets match the filter" : "no tests collected";
+    return;
+  }
+  const disabled = testRunActive() ? " disabled" : "";
+  el.className = "testing-list";
+  el.innerHTML = targets.map(t =>
+    `<div class="testing-row">` +
+      `<span class="testing-target">${t.suite ? '<span class="pill">suite</span> ' : ""}${esc(t.label)}</span>` +
+      `<button class="small" type="button" data-test-target="${esc(t.id)}"${disabled}>Run</button>` +
+    `</div>`
+  ).join("");
+}
+
+function renderTesting() {
+  renderTestRunStatus();
+  renderTestTargets();
+}
+
+function applyTestStatus(result) {
+  if (!result || !result.ok) {
+    showTestingError(testingErrorText(result));
+    return false;
+  }
+  testRun = result.data.run || null;
+  renderTestRunStatus();
+  renderTestLog(result.data.stdout, result.data.stderr);
+  return true;
+}
+
+async function runTest(target) {
+  if (testRunActive()) return;
+  showTestingError("");
+  testRunStarting = true;
+  renderTesting();
+  const result = await apiCall("/v1/tests/run", "POST", { target });
+  testRunStarting = false;
+  if (!result.ok) {
+    showTestingError(testingErrorText(result));
+    renderTesting();
+    return;
+  }
+  testRun = result.data.run || null;
+  renderTesting();
+  renderTestLog(result.data.stdout, result.data.stderr);
+}
+
+async function loadTestTargets(refresh) {
+  const result = await apiCall(`/v1/tests${refresh ? "?refresh=1" : ""}`);
+  if (!result.ok) {
+    showTestingError(testingErrorText(result));
+    $("testing-targets").className = "empty";
+    $("testing-targets").innerHTML = "test targets unavailable";
+    return false;
+  }
+  testCollection = { tests: result.data.tests || [], suites: result.data.suites || [] };
+  renderTestTargets();
+  return true;
+}
+
+async function reloadTestTargets() {
+  showTestingError("");
+  await loadTestTargets(true);
+}
+
+async function fetchTestingTab() {
+  if (!isAdmin) return;
+  showTestingError("");
+  const [, statusResult] = await Promise.all([
+    loadTestTargets(false),
+    apiCall("/v1/tests/status"),
+  ]);
+  applyTestStatus(statusResult);
+  renderTestTargets();
+}
+
+// Auto-refresh status + log while a run is in flight (independent of the
+// selection/edit guards that pause the other panels — logs must keep flowing).
+async function pollTestRunIfActive() {
+  if (dashboardTab !== "testing" || !isAdmin || !testRunActive()) return;
+  applyTestStatus(await apiCall("/v1/tests/status"));
+  // Re-enable the Run buttons on the transition out of "running".
+  if (!testRunActive()) renderTestTargets();
+}
+
+function bindTestingControls() {
+  const list = $("testing-targets");
+  if (!list) return;
+  list.addEventListener("click", event => {
+    const button = event.target.closest("[data-test-target]");
+    if (!button || button.disabled) return;
+    event.preventDefault();
+    void runTest(button.getAttribute("data-test-target"));
+  });
+}
+
 // ---- account panel (registration / login / balance / usage / API keys) ----

 let sessionToken = localStorage.getItem("meshnet_session") || null;
@@ -1247,12 +1485,12 @@ function bindChatSessionList() {
 }

 function switchDashboardTab(name) {
-  if (name === "admin" && !isAdmin) name = "overview";
+  if ((name === "admin" || name === "testing") && !isAdmin) name = "overview";
  if (name === "billing" && !isLoggedIn) name = "overview";
  dashboardTab = name;
  document.body.classList.toggle("chat-tab-active", name === "chat");
  updateSectionVisibility();
-  for (const tabName of ["overview", "chat", "billing", "admin"]) {
+  for (const tabName of ["overview", "chat", "billing", "admin", "testing"]) {
    const button = $("tab-" + tabName);
    if (button) button.classList.toggle("active", tabName === dashboardTab);
  }
@@ -1409,8 +1647,9 @@ function chatAuthToken() {
 function setAdminMode(enabled) {
  isAdmin = enabled;
  $("tab-admin").style.display = enabled ? "" : "none";
+  $("tab-testing").style.display = enabled ? "" : "none";
  $("request-model-load").style.display = enabled ? "" : "none";
-  if (!enabled && dashboardTab === "admin") {
+  if (!enabled && (dashboardTab === "admin" || dashboardTab === "testing")) {
    switchDashboardTab("overview");
  } else {
    updateSectionVisibility();
@@ -2072,6 +2311,7 @@ const TAB_FETCHERS = {
  chat: fetchChatTab,
  billing: fetchBillingTab,
  admin: fetchAdminTab,
+  testing: fetchTestingTab,
 };

 async function refreshActiveTab(force) {
@@ -2098,6 +2338,7 @@ bindChatSessionList();
 bindChatModelSelect();
 initChatSessions();
 bindChatPromptShortcuts();
+bindTestingControls();
 (async () => {
  if (sessionToken) await loadAccountSummary(true);
  else renderAuthForms();
@@ -2109,6 +2350,7 @@ bindChatPromptShortcuts();
  renderChatAuthHint();
 })();
 setInterval(pollCallWallIfIdle, CALL_WALL_POLL_MS);
+setInterval(pollTestRunIfActive, TEST_RUN_POLL_MS);
 </script>
 </body>
 </html>
--- a/tests/test_dashboard.py
+++ b/tests/test_dashboard.py
@@ -17,6 +17,7 @@ PANELS = [
    "Usage summary", "Node throughput", "Request history",
    "Chat / inference",
    "Console output",
+    "Test run status", "Tests &amp; suites", "Test output",
 ]


@@ -295,3 +296,88 @@ def test_console_node_lifecycle_events_include_model_health():
        assert expired_event["fields"]["model_health"]["coverage_percentage"] == 0.0
    finally:
        tracker.stop()
+
+
+def _dashboard_html(**kwargs) -> str:
+    tracker = TrackerServer(**kwargs)
+    port = tracker.start()
+    try:
+        return urllib.request.urlopen(
+            f"http://127.0.0.1:{port}/dashboard"
+        ).read().decode()
+    finally:
+        tracker.stop()
+
+
+def test_dashboard_testing_tab_is_admin_only():
+    """US-002: the Testing tab ships hidden and is only revealed for admins."""
+    html = _dashboard_html()
+
+    # Tab button exists but is hidden until setAdminMode(true) reveals it.
+    assert '<button id="tab-testing" style="display:none"' in html
+    assert "switchDashboardTab('testing')" in html
+    assert '$("tab-testing").style.display = enabled ? "" : "none"' in html
+
+    # Every Testing panel is data-admin-only, so updateSectionVisibility()
+    # (adminOnly && !isAdmin -> hidden) keeps them hidden for non-admins.
+    for panel in ("testing-status", "testing-targets", "testing-log"):
+        assert f'id="{panel}"' in html
+    assert html.count('data-tab="testing" data-admin-only') == 3
+
+    # Selecting the tab without admin rights falls back to overview, and losing
+    # admin rights while on it kicks the user out.
+    assert 'if ((name === "admin" || name === "testing") && !isAdmin) name = "overview";' in html
+    assert 'if (!enabled && (dashboardTab === "admin" || dashboardTab === "testing"))' in html
+
+
+def test_dashboard_testing_tab_uses_dynamic_api_and_run_controls():
+    """US-002: targets come from the API, never a hardcoded list."""
+    html = _dashboard_html()
+
+    # Dynamic collection + run + status endpoints from US-001.
+    assert 'apiCall(`/v1/tests${refresh ? "?refresh=1" : ""}`)' in html
+    assert 'apiCall("/v1/tests/run", "POST", { target })' in html
+    assert 'apiCall("/v1/tests/status")' in html
+    assert "fetchTestingTab" in html
+    assert "testing: fetchTestingTab" in html  # registered in TAB_FETCHERS
+
+    # Targets are rendered from the API payload (tests + suites), not literals.
+    assert "testCollection.suites" in html
+    assert "testCollection.tests" in html
+    assert "renderTestTargets" in html
+
+    # Run buttons are per-target and delegated; disabled while a run is active.
+    assert 'data-test-target="${esc(t.id)}"' in html
+    assert "const disabled = testRunActive() ? \" disabled\" : \"\";" in html
+    assert "if (testRunActive()) return;" in html  # runTest() guards re-entry
+    assert 'button = event.target.closest("[data-test-target]")' in html
+
+    # API errors are surfaced rather than swallowed.
+    assert "showTestingError" in html
+    assert "testingErrorText" in html
+    assert 'id="testing-error"' in html
+
+
+def test_dashboard_testing_tab_renders_status_and_bounded_log():
+    """US-002: state, timings, exit code, outcome and an auto-refreshing log."""
+    html = _dashboard_html()
+
+    assert "renderTestRunStatus" in html
+    assert "renderTestLog" in html
+    for field in ("target", "state", "outcome", "started", "ended", "elapsed", "exit code"):
+        assert f'"{field}"' in html
+    assert "testRun.exit_code" in html
+    assert "testRun.started_at" in html
+    assert "testRun.finished_at" in html
+    assert "testRun.elapsed_seconds" in html
+    assert "fmtElapsed" in html
+
+    # Success/failure is derived from the run status, not guessed from the log.
+    assert '<span class="ok">success</span>' in html
+    assert '<span class="bad">failure</span>' in html
+
+    # Bounded log view + auto-refresh while the run is in flight.
+    assert "TEST_LOG_MAX_LINES" in html
+    assert "lines.slice(-TEST_LOG_MAX_LINES)" in html
+    assert "pollTestRunIfActive" in html
+    assert "setInterval(pollTestRunIfActive, TEST_RUN_POLL_MS)" in html