@ihyeon/flow-qa 0.6.0 → 0.8.0

package/README.ko.md

@@ -16,7 +16,7 @@ CLI와 `127.0.0.1` 전용 웹 UI를 제공합니다. UI는 영어로 시작하
 Node.js 24.x(24.22.1 이상) 또는 26.12.1 이상이 필요합니다. 브라우저는 첫 웹 실행 전에 설치합니다.
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.4.0
+npm install -g @ihyeon/flow-qa@0.8.0
 flow-qa browser install
 flow-qa ui --demo
 ```
@@ -70,9 +70,11 @@ CLI에서는 `flow-qa run cases/task-flow.json --target demo --case TC-001 --cas
 
 `0.5.0`부터 상세 보고서에서 **실패·오류 케이스 준비**를 누르면 실행 당시와 같은 저장된 케이스를 불러와 `실패`와 `실행 오류`만 선택합니다. 준비 후 케이스와 대상을 다시 검토하고 직접 실행하세요. 케이스·원본 파일이 없거나 바뀌었으면 준비를 중단하며, 실행 대상이 없거나 바뀌었으면 다시 선택해야 합니다. 자세한 동작은 [실패 케이스 준비](docs/ui.md#prepare-failed-cases)를 참고하세요.
 
+`0.8.0`부터 **상세 보고서**에서 케이스·오류 내용을 검색하고 상태별로 좁히거나 **실패·오류만** 볼 수 있습니다. 표시 건수와 보고서 전체 케이스 수를 구분하며, 다운로드와 실패·오류 재실행 준비는 보고서 전체 범위를 유지합니다. 자세한 동작은 [보고서 케이스 탐색](docs/ui.md#explore-cases-in-a-report)을 참고하세요.
+
 ## 실행 결과 비교
 
-`0.6.0`부터 **실행 기록**에서 저장된 전체 보고서를 스위트 ID·실행 ID·대상 이름으로 검색하고 실행 상태로 함께 좁힐 수 있습니다. 결과는 50건씩 표시하며 **더 보기**로 이전 기록을 불러옵니다. **실행 기록 새로고침**은 검색·상태 조건을 유지한 채 목록을 갱신합니다. 오래된 보고서도 다운로드와 실패 케이스 준비를 사용할 수 있습니다. 자세한 동작은 [기록 검색·페이지 조회](docs/ui.md#search-run-history)를 참고하세요.
+`0.6.0`부터 **실행 기록**에서 저장된 전체 보고서를 스위트 ID·실행 ID·대상 이름으로 검색하고 실행 상태로 함께 좁힐 수 있습니다. 결과는 50건씩 표시하며 **더 보기**로 이전 기록을 불러옵니다. **실행 기록 새로고침**은 검색·상태 조건을 유지한 채 목록을 갱신합니다. 오래된 보고서도 다운로드와 실패 케이스 준비를 사용할 수 있습니다. `0.7.0`부터 각 기록의 **기준으로 선택**·**현재로 선택**으로 이전 실행끼리 비교할 수 있으며, 검색이나 새로고침 후에도 선택을 유지합니다. 자세한 동작은 [기록 검색·페이지 조회](docs/ui.md#search-run-history)를 참고하세요.
 
 **실행 기록 → 실행 2건 비교**에서 같은 스위트와 대상의 두 기록을 선택하면 통과→실패, 실패→통과, 그 외 상태 변경, 동일 상태, 추가·누락 케이스를 확인할 수 있습니다. 분류별로 보거나 전체 비교를 Markdown·JSON으로 내려받으세요. 테스트 내용 변경과 불완전한 실행은 별도로 표시하며, 상태 변화만으로 제품 버그의 발생·해결을 확정하지 않습니다. 자세한 동작은 [UI 가이드](docs/ui.md#compare-two-runs)를 참고하세요.
 

package/README.md

@@ -16,7 +16,7 @@ Flow QA is available as a CLI and a web UI bound to `127.0.0.1`. Provide a targe
 Node.js 24.x (24.22.1 or later) or 26.12.1 or later is required. Install Chromium before the first web run:
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.4.0
+npm install -g @ihyeon/flow-qa@0.8.0
 flow-qa browser install
 flow-qa ui --demo
 ```
@@ -70,9 +70,11 @@ The CLI supports repeated IDs: `flow-qa run cases/task-flow.json --target demo -
 
 From `0.5.0`, open a detailed report and choose **Prepare failed/error cases** to load its unchanged saved suite with only `failed` and `error` cases selected. Preparation never starts a run: review the cases and target, then run explicitly. Changed or missing case/source files block preparation; a changed or missing target must be selected again. See [preparing failed cases](docs/ui.md#prepare-failed-cases).
 
+From `0.8.0`, **Detailed report** supports case/error-text search, status filters, and **Failed/error only**. Counts distinguish displayed matches from all recorded cases. Report downloads and failed/error preparation retain the full report scope. See [report case exploration](docs/ui.md#explore-cases-in-a-report).
+
 ## Compare recorded runs
 
-From `0.6.0`, **Run history** searches all valid saved reports by suite ID, run ID, or target name, combined with the run-status filter. Results load 50 at a time; use **Load more** for older results and **Refresh history** to update the list while keeping your filters. Older reports support the same downloads and failed-case preparation. See [history search and paging](docs/ui.md#search-run-history).
+From `0.6.0`, **Run history** searches all valid saved reports by suite ID, run ID, or target name, combined with the run-status filter. Results load 50 at a time; use **Load more** for older results and **Refresh history** to update the list while keeping your filters. Older reports support the same downloads and failed-case preparation. From `0.7.0`, choose **Use as baseline** and **Use as current** on any history rows to compare older runs, retaining the pair through searches and refreshes. See [history search and paging](docs/ui.md#search-run-history).
 
 In **Run history → Compare two runs**, select two reports from the same suite and target to see passed-to-failed, failed-to-passed, other status changes, unchanged, added, and missing cases. Filter the comparison or download all results as Markdown/JSON. Changed test definitions and incomplete runs carry explicit warnings; observed status changes do not prove a product defect was introduced or fixed. See the [UI guide](docs/ui.md#compare-two-runs).
 

package/dist/src/ui/public/app.js

@@ -4,7 +4,7 @@
   const i18n = window.FlowQAI18n;
   const t = i18n.t;
   const names = { scenario: 'nav.scenario', library: 'nav.library', history: 'nav.history', settings: 'nav.settings' };
-  const app = { state: null, connected: false, displayTargets: [], draft: null, selectedCaseIds: new Set(), script: '', savedFile: '', savedHash: '', origin: 'none', sourceFlow: '', boundSource: null, stale: false, dirty: false, busy: false, planning: false, planRequest: 0, stopping: false, report: null, reportMarkdown: '', selectedRun: '', rerunOrigin: null, rerunTargetMismatch: false, navigationVersion: 0, comparison: null, comparisonRequest: 0, comparisonBusy: false, comparisonStatus: 'comparison.selectBoth', history: { runs: [], nextCursor: null, pagesLoaded: 0, loaded: false, loading: false, request: 0, debounce: null, kind: null, error: null, updatesAvailable: false, pendingRecentUpdate: false }, view: 'scenario' };
+  const app = { state: null, connected: false, displayTargets: [], draft: null, selectedCaseIds: new Set(), script: '', savedFile: '', savedHash: '', origin: 'none', sourceFlow: '', boundSource: null, stale: false, dirty: false, busy: false, planning: false, planRequest: 0, stopping: false, report: null, reportMarkdown: '', selectedRun: '', reportFilter: { search: '', status: 'all' }, rerunOrigin: null, rerunTargetMismatch: false, navigationVersion: 0, comparison: null, comparisonRequest: 0, comparisonBusy: false, comparisonStatus: 'comparison.selectBoth', comparisonPins: { baseline: null, current: null }, comparisonSelectionGeneration: 0, comparisonValidation: null, history: { runs: [], nextCursor: null, pagesLoaded: 0, loaded: false, loading: false, request: 0, debounce: null, kind: null, error: null, updatesAvailable: false, pendingRecentUpdate: false }, view: 'scenario' };
 
   function el(tag, className, value) {
     const node = document.createElement(tag);
@@ -38,8 +38,10 @@
     try { result = await response.json(); } catch { throw localizedError('app.responseUnreadable', { status: response.status }); }
     if (!response.ok) {
       const issues = Array.isArray(result?.issues) ? result.issues.slice(0, 8).map((issue) => `${issue.path}: ${issue.message}`).join('\n') : '';
-      if (!result?.error && !issues) throw localizedError('app.requestFailed', { status: response.status });
-      throw new Error(`${result?.error || t('app.requestFailed', { status: response.status })}${issues ? `\n${issues}` : ''}`);
+      const error = !result?.error && !issues ? localizedError('app.requestFailed', { status: response.status })
+        : new Error(`${result?.error || t('app.requestFailed', { status: response.status })}${issues ? `\n${issues}` : ''}`);
+      error.status = response.status;
+      throw error;
     }
     return result;
   }
@@ -282,10 +284,20 @@
           : app.state?.active ? 'app.historyActiveEmpty' : 'app.historyEmpty';
       host.append(el('p', 'empty', t(key)));
     }
+    const pair = comparisonPair();
     for (const run of history.runs) {
-      const row = el('div', 'list-row'); const copy = el('div'); copy.append(el('strong', '', `${run.suiteId} · ${i18n.status(run.status)}`), el('small', '', t('app.runMeta', { date: formatDate(run.startedAt), target: targetDisplay(run.target), passed: run.passedCount ?? 0, total: run.caseCount ?? 0, id: run.runId })));
+      const row = el('div', 'list-row history-run-row'); row.dataset.runId = run.runId;
+      const copy = el('div'); copy.append(el('strong', '', `${run.suiteId} · ${i18n.status(run.status)}`), el('small', '', t('app.runMeta', { date: formatDate(run.startedAt), target: targetDisplay(run.target), passed: run.passedCount ?? 0, total: run.caseCount ?? 0, id: run.runId })));
       const scope = selectionScope(run.selection); if (scope) copy.append(el('small', 'selection-scope', scope));
-      const button = el('button', 'button', t('app.viewReport')); button.type = 'button'; button.disabled = run.status === 'running' || run.status === 'stopping'; button.addEventListener('click', () => loadReport(run.runId)); row.append(copy, button); host.append(row);
+      const actions = el('div', 'run-row-actions');
+      const button = el('button', 'button', t('app.viewReport')); button.type = 'button'; button.dataset.action = 'view-report'; button.disabled = run.status === 'running' || run.status === 'stopping'; button.addEventListener('click', () => loadReport(run.runId)); actions.append(button);
+      for (const [role, label] of [['baseline', 'comparison.useBaseline'], ['current', 'comparison.useCurrent']]) {
+        const select = el('button', 'button quiet', t(label)); select.type = 'button'; select.dataset.action = role === 'baseline' ? 'compare-baseline' : 'compare-current';
+        select.setAttribute('aria-pressed', String(pair[role] === run.runId));
+        select.disabled = run.status === 'running' || run.status === 'stopping';
+        select.addEventListener('click', () => selectComparisonRun(role, run)); actions.append(select);
+      }
+      row.append(copy, actions); host.append(row);
     }
     const messages = [];
     if (history.loaded) messages.push(t('history.pageCount', { count: history.runs.length }));
@@ -320,6 +332,7 @@
       history.loaded = true;
       history.error = null;
       if (!append) history.updatesAvailable = false;
+      renderComparisonOptions();
     } catch {
       if (request !== history.request) return;
       history.error = append ? 'more' : 'first';
@@ -341,7 +354,7 @@
     const request = ++history.request;
     history.runs = []; history.nextCursor = null; history.pagesLoaded = 0; history.loaded = false;
     history.loading = true; history.kind = 'first'; history.error = null; history.updatesAvailable = false; history.pendingRecentUpdate = false;
-    renderHistory();
+    renderHistory(); renderComparisonOptions();
     const filters = historyFilters();
     if (delay) history.debounce = setTimeout(() => { history.debounce = null; void fetchHistoryPage(request, filters); }, delay);
     else void fetchHistoryPage(request, filters);
@@ -367,7 +380,18 @@
   const comparisonCategoryKeys = { 'newly-failed': 'comparison.newlyFailed', 'now-passed': 'comparison.nowPassed', changed: 'comparison.changed', unchanged: 'comparison.unchanged', added: 'comparison.added', missing: 'comparison.missing' };
   const comparisonWarningKeys = { 'suite-changed': 'comparison.warningSuite', 'reverse-order': 'comparison.warningReverse', 'incomplete-run': 'comparison.warningIncomplete', 'mobile-identity-unverified': 'comparison.warningMobileIdentity', 'partial-run': 'comparison.warningPartial', 'selection-changed': 'comparison.warningSelectionChanged' };
   function comparisonPair() { return { baseline: $('compare-baseline').value, current: $('compare-current').value }; }
-  function comparisonValid() { const { baseline, current } = comparisonPair(); return !!baseline && !!current && baseline !== current; }
+  function comparisonRun(runId) {
+    return (app.state?.runs || []).find((run) => run.runId === runId)
+      || app.history.runs.find((run) => run.runId === runId)
+      || Object.values(app.comparisonPins).find((run) => run?.runId === runId);
+  }
+  function comparisonValid() {
+    const { baseline, current } = comparisonPair();
+    return !!baseline && !!current && baseline !== current && [baseline, current].every((id) => {
+      const run = comparisonRun(id);
+      return run && run.status !== 'running' && run.status !== 'stopping';
+    });
+  }
   function comparisonStatus(key, params = {}, error = false) {
     app.comparisonStatus = key; app.comparisonStatusParams = params;
     const node = $('comparison-status'); node.textContent = t(key, params); node.classList.toggle('report-errors', error);
@@ -385,23 +409,78 @@
     $('comparison-summary').replaceChildren(); $('comparison-warnings').replaceChildren(); $('comparison-content').replaceChildren();
     comparisonStatus('comparison.selectBoth'); comparisonControls();
   }
+  function selectComparisonRun(role, run) {
+    if (run && (run.status === 'running' || run.status === 'stopping')) return;
+    const select = $(role === 'baseline' ? 'compare-baseline' : 'compare-current');
+    const runId = run?.runId || '';
+    if (select.value === runId && (app.comparisonPins[role]?.runId || '') === runId) return;
+    app.comparisonPins[role] = run || null;
+    app.comparisonSelectionGeneration += 1;
+    renderComparisonOptions();
+    select.value = runId;
+    clearComparison(); renderHistory();
+  }
   function renderComparisonOptions() {
-    const runs = (app.state?.runs || []).slice(0, 50);
-    let missing = false;
+    const runs = new Map();
+    for (const run of [...(app.state?.runs || []).slice(0, 50), ...app.history.runs, ...Object.values(app.comparisonPins)]) {
+      if (run?.runId && !runs.has(run.runId)) runs.set(run.runId, run);
+    }
     for (const id of ['compare-baseline', 'compare-current']) {
       const select = $(id); const selected = select.value;
       select.replaceChildren(el('option', '', t('comparison.choose'))); select.firstChild.value = '';
-      for (const run of runs) {
+      for (const run of runs.values()) {
         const option = el('option', '', `${t('comparison.runLabel', { id: run.runId, shortId: run.runId.slice(-8), date: formatDate(run.startedAt), suite: run.suiteId, target: targetDisplay(run.target), status: i18n.status(run.status) })}${selectionScope(run.selection) ? ` · ${selectionScope(run.selection)}` : ''}`);
-        option.value = run.runId; select.append(option);
+        option.value = run.runId; option.disabled = run.status === 'running' || run.status === 'stopping'; select.append(option);
       }
-      select.value = runs.some((run) => run.runId === selected) ? selected : '';
-      if (selected && !select.value) missing = true;
+      select.value = runs.has(selected) ? selected : '';
     }
-    if (missing) clearComparison();
-    if (!runs.length && !app.comparison) comparisonStatus('comparison.noRuns');
+    if (!runs.size && !app.comparison) comparisonStatus('comparison.noRuns');
     comparisonControls();
   }
+  async function validateComparisonSelection(state) {
+    if (app.comparisonValidation) return app.comparisonValidation;
+    const pair = comparisonPair();
+    const generation = app.comparisonSelectionGeneration;
+    const recent = new Set((state.runs || []).map((run) => run.runId));
+    const ids = [...new Set(Object.values(pair).filter((id) => id && !recent.has(id)))];
+    if (!ids.length) return;
+    const validation = Promise.all(ids.map(async (runId) => {
+      try {
+        const result = await api(`/api/run-summary?runId=${encodeURIComponent(runId)}`);
+        if (result?.run?.runId !== runId) throw new Error('Invalid run summary response.');
+        return { runId, run: result.run };
+      } catch (error) { return { runId, error }; }
+    }));
+    app.comparisonValidation = validation;
+    try {
+      const outcomes = await validation;
+      const selected = comparisonPair();
+      if (generation !== app.comparisonSelectionGeneration || selected.baseline !== pair.baseline || selected.current !== pair.current) return;
+      let missing = false;
+      let updated = false;
+      for (const outcome of outcomes) {
+        if (outcome.error?.status === 404) {
+          for (const role of ['baseline', 'current']) {
+            if (selected[role] === outcome.runId) {
+              $(role === 'baseline' ? 'compare-baseline' : 'compare-current').value = '';
+              app.comparisonPins[role] = null;
+              missing = true;
+            }
+          }
+          app.history.runs = app.history.runs.filter((run) => run.runId !== outcome.runId);
+        } else if (outcome.run) {
+          for (const role of ['baseline', 'current']) if (selected[role] === outcome.runId) app.comparisonPins[role] = outcome.run;
+          updated = true;
+        }
+      }
+      if (missing) {
+        app.comparisonSelectionGeneration += 1;
+        clearComparison();
+        if (app.history.loading) refreshHistory(); else renderHistory();
+      }
+      if (missing || updated) renderComparisonOptions();
+    } finally { if (app.comparisonValidation === validation) app.comparisonValidation = null; }
+  }
   async function compareRuns() {
     if (!comparisonValid()) return;
     const { baseline, current } = comparisonPair(); const locale = i18n.locale(); const request = ++app.comparisonRequest;
@@ -478,6 +557,7 @@
     if (full || initialize) { targetOptions(); modelForms(); }
     if (previousActive?.kind === 'run' && !state.active) { if (state.lastError) notice(state.lastError, true); else noticeKey('app.runEnded'); }
     if (state.lastError && state.lastError !== app.lastError) { app.lastError = state.lastError; notice(state.lastError, true); }
+    await validateComparisonSelection(state);
   }
   async function work(fn) { if (app.busy) return; app.busy = true; readiness(); notice(''); try { await fn(); } catch (error) { showError(error); } finally { app.busy = false; readiness(); } }
   async function loadSuite(file) { await work(async () => { const result = await api(`/api/suite?file=${encodeURIComponent(file)}`); if (!confirmScenarioReplacement('app.confirmReplaceDraft')) return; $('flow-input').value = result.flow || ''; setDraft(result.suite, result.script, 'library', result.flow || '', file, result.suiteHash || ''); noticeKey('app.suiteLoaded'); view('scenario'); }); }
@@ -556,7 +636,7 @@
     catch (error) { showError(error); }
     finally { app.stopping = false; readiness(); }
   }
-  async function loadReport(runId) { await work(async () => { const result = await api(`/api/report?runId=${encodeURIComponent(runId)}`); app.report = result.report; app.reportMarkdown = result.markdown; app.selectedRun = runId; renderReport(); readiness(); $('report-panel').hidden = false; $('report-panel').scrollIntoView({ behavior: 'smooth', block: 'start' }); }); }
+  async function loadReport(runId) { await work(async () => { const result = await api(`/api/report?runId=${encodeURIComponent(runId)}`); if (app.selectedRun !== runId) app.reportFilter = { search: '', status: 'all' }; app.report = result.report; app.reportMarkdown = result.markdown; app.selectedRun = runId; renderReport(); readiness(); $('report-panel').hidden = false; $('report-panel').scrollIntoView({ behavior: 'smooth', block: 'start' }); }); }
   async function prepareFailedCases() { await work(async () => {
     const runId = app.selectedRun;
     const report = app.report;
@@ -591,14 +671,48 @@
       download(`${runId}.md`, result.markdown, 'text/markdown');
     } catch (error) { if (runId === app.selectedRun && locale === i18n.locale()) showError(error); }
   }
-  function renderReport() {
-    const report = app.report; if (!report) return;
-    $('report-heading').textContent = `${report.runId} · ${i18n.status(report.status)} · ${targetDisplay(report.target)}`;
-    const host = $('report-content'); replace(host);
-    const meta = el('div', 'report-meta'); for (const value of [t('app.reportStatus', { status: i18n.status(report.status) }), t('app.reportTarget', { target: targetDisplay(report.target) }), t('app.reportStarted', { date: formatDate(report.startedAt) }), t('app.reportFinished', { date: formatDate(report.finishedAt) })]) meta.append(el('span', '', value)); const scope = selectionScope(report.selection); if (scope) meta.append(el('span', 'selection-scope', scope)); host.append(meta);
-    if (report.usage) host.append(el('p', 'hint', t('app.usage', { tokens: report.usage.modelTokens ?? t('app.unavailable'), cost: typeof report.usage.estimatedCostUsd === 'number' ? `$${report.usage.estimatedCostUsd.toFixed(4)}` : t('app.unavailable') })));
-    if (report.errors?.length) host.append(el('p', 'report-errors', report.errors.join('\n')));
-    for (const item of report.cases || []) {
+  const reportStatuses = ['all', 'failed-error', 'passed', 'failed', 'error', 'blocked', 'flaky', 'skipped'];
+  function reportCaseMatchesSearch(item, query) {
+    if (!query) return true;
+    const values = [item.id, item.title, item.reason, ...(item.expected || [])];
+    for (const attempt of item.attempts || []) {
+      if (attempt.error) values.push(attempt.error.code, attempt.error.message);
+      for (const error of attempt.secondaryErrors || []) values.push(error.code, error.message);
+      for (const step of attempt.steps || []) {
+        values.push(step.label);
+        if (step.error) values.push(step.error.code, step.error.message);
+      }
+    }
+    return values.some((value) => String(value ?? '').toLowerCase().includes(query));
+  }
+  function renderReportFilters() {
+    const cases = app.report?.cases || [];
+    const counts = Object.fromEntries(reportStatuses.map((status) => [status, 0]));
+    counts.all = cases.length;
+    for (const item of cases) {
+      if (Object.hasOwn(counts, item.status)) counts[item.status] += 1;
+      if (item.status === 'failed' || item.status === 'error') counts['failed-error'] += 1;
+    }
+    for (const option of $('report-case-status').options) {
+      const label = option.value === 'all' ? t('report.filterAll') : option.value === 'failed-error' ? t('report.filterFailedError') : i18n.status(option.value);
+      option.textContent = `${label} (${counts[option.value]})`;
+    }
+    if ($('report-case-search').value !== app.reportFilter.search) $('report-case-search').value = app.reportFilter.search;
+    $('report-case-status').value = app.reportFilter.status;
+    $('report-case-reset').disabled = !app.reportFilter.search && app.reportFilter.status === 'all';
+    return cases;
+  }
+  function renderReportCases() {
+    if (!app.report) return;
+    const cases = renderReportFilters();
+    const query = app.reportFilter.search.trim().toLowerCase();
+    const status = app.reportFilter.status;
+    const shown = cases.filter((item) => (status === 'all' || (status === 'failed-error' ? item.status === 'failed' || item.status === 'error' : item.status === status)) && reportCaseMatchesSearch(item, query));
+    $('report-case-count').textContent = t('report.caseCount', { shown: shown.length, total: cases.length });
+    const host = $('report-case-list'); replace(host);
+    if (!cases.length) { host.append(el('p', 'empty', t('report.empty'))); return; }
+    if (!shown.length) { host.append(el('p', 'empty', t('report.noMatches'))); return; }
+    for (const item of shown) {
       const section = el('section', 'case-report'); section.append(el('h3', '', `${item.id} · ${item.title} · ${i18n.status(item.status)}`));
       if (item.reason) section.append(el('p', '', t('app.reason', { reason: item.reason })));
       section.append(el('p', '', t('app.expected'))); const expected = el('ul', 'compact-list'); for (const check of item.expected || []) expected.append(el('li', '', check)); section.append(expected);
@@ -622,6 +736,16 @@
       host.append(section);
     }
   }
+  function renderReport() {
+    const report = app.report; if (!report) return;
+    $('report-heading').textContent = `${report.runId} · ${i18n.status(report.status)} · ${targetDisplay(report.target)}`;
+    const host = $('report-content'); replace(host);
+    const meta = el('div', 'report-meta'); for (const value of [t('app.reportStatus', { status: i18n.status(report.status) }), t('app.reportTarget', { target: targetDisplay(report.target) }), t('app.reportStarted', { date: formatDate(report.startedAt) }), t('app.reportFinished', { date: formatDate(report.finishedAt) })]) meta.append(el('span', '', value)); const scope = selectionScope(report.selection); if (scope) meta.append(el('span', 'selection-scope', scope)); host.append(meta);
+    if (report.usage) host.append(el('p', 'hint', t('app.usage', { tokens: report.usage.modelTokens ?? t('app.unavailable'), cost: typeof report.usage.estimatedCostUsd === 'number' ? `$${report.usage.estimatedCostUsd.toFixed(4)}` : t('app.unavailable') })));
+    if (report.errors?.length) host.append(el('p', 'report-errors', report.errors.join('\n')));
+    const caseList = el('div'); caseList.id = 'report-case-list'; host.append(caseList);
+    renderReportCases();
+  }
   async function saveModel(event) { event.preventDefault(); const form = event.currentTarget; await work(async () => { const values = new FormData(form); const body = { role: form.dataset.role, baseURL: String(values.get('baseURL') || '').trim(), model: String(values.get('model') || '').trim() }; const apiKeyEnv = String(values.get('apiKeyEnv') || '').trim(); if (apiKeyEnv) body.apiKeyEnv = apiKeyEnv; await api('/api/models', body); await refresh(true); noticeKey('app.modelSaved'); }); }
   async function clearModel(role) { await work(async () => { await api('/api/models', { role, clear: true }); await refresh(true); noticeKey('app.modelCleared'); }); }
   function targetFields() { const mobile = $('target-kind').value !== 'web'; for (const [id, required] of [['target-url-field', !mobile], ['target-bundle-field', mobile], ['target-device-field', mobile]]) { const field = $(id); field.hidden = !required; field.querySelector('input').required = required; } }
@@ -660,9 +784,19 @@
     $('history-status-filter').addEventListener('change', () => refreshHistory());
     $('history-refresh').addEventListener('click', () => refreshHistory());
     $('history-load-more').addEventListener('click', loadMoreHistory);
-    for (const id of ['compare-baseline', 'compare-current']) $(id).addEventListener('change', clearComparison);
+    for (const [id, role] of [['compare-baseline', 'baseline'], ['compare-current', 'current']]) $(id).addEventListener('change', () => {
+      const run = comparisonRun($(id).value);
+      selectComparisonRun(role, run || null);
+    });
     $('compare-btn').addEventListener('click', compareRuns);
-    $('compare-swap').addEventListener('click', () => { const pair = comparisonPair(); $('compare-baseline').value = pair.current; $('compare-current').value = pair.baseline; clearComparison(); });
+    $('compare-swap').addEventListener('click', () => {
+      const pair = comparisonPair();
+      app.comparisonPins = { baseline: comparisonRun(pair.current), current: comparisonRun(pair.baseline) };
+      app.comparisonSelectionGeneration += 1;
+      renderComparisonOptions();
+      $('compare-baseline').value = pair.current; $('compare-current').value = pair.baseline;
+      clearComparison(); renderHistory();
+    });
     $('comparison-filter').addEventListener('change', renderComparison);
     $('comparison-md').addEventListener('click', downloadComparisonMarkdown);
     $('comparison-json').addEventListener('click', () => { if (app.comparison && comparisonValid()) { const { baseline, current } = comparisonPair(); download(`${baseline}-to-${current}.json`, JSON.stringify(app.comparison, null, 2), 'application/json'); } });
@@ -699,6 +833,9 @@
     $('report-md').addEventListener('click', downloadReportMarkdown);
     $('report-json').addEventListener('click', () => { if (app.report) download(`${app.selectedRun}.json`, JSON.stringify(app.report, null, 2), 'application/json'); });
     $('report-rerun').addEventListener('click', prepareFailedCases);
+    $('report-case-search').addEventListener('input', (event) => { app.reportFilter.search = event.currentTarget.value; renderReportCases(); });
+    $('report-case-status').addEventListener('change', (event) => { app.reportFilter.status = event.currentTarget.value; renderReportCases(); });
+    $('report-case-reset').addEventListener('click', () => { app.reportFilter = { search: '', status: 'all' }; renderReportCases(); });
     $('target-form').addEventListener('submit', saveTarget);
     $('target-kind').addEventListener('change', targetFields); targetFields();
     $('language-select').addEventListener('change', (event) => i18n.setLocale(event.currentTarget.value));

package/dist/src/ui/public/i18n.js

@@ -84,7 +84,7 @@
     'history.eyebrow': ['03 / RUNS', '03 / 실행'],
     'history.intro': ['Only runs that actually started appear here. Once results are saved, you can view the detailed report.', '실제로 시작된 실행만 표시합니다. 결과가 저장되면 상세 보고서를 볼 수 있습니다.'],
     'history.title': ['Runs', '실행 목록'],
-    'history.help': ['Check the completed report for the final status.', '상태는 완료된 보고서 기준으로 확인하세요.'],
+    'history.help': ['View a completed report or select a run as the comparison baseline or current run.', '완료된 보고서를 보거나 실행을 비교 기준 또는 현재 실행으로 선택하세요.'],
     'history.searchLabel': ['Search runs', '실행 기록 검색'],
     'history.searchPlaceholder': ['Suite ID, run ID, or target name', '스위트 ID, 실행 ID 또는 대상 이름'],
     'history.statusFilter': ['Run status', '실행 상태'],
@@ -100,12 +100,14 @@
     'history.loadMoreError': ['Could not load more runs. Retry loading more.', '실행 기록을 더 불러오지 못했습니다. 다시 시도하세요.'],
     'history.updatesAvailable': ['Recent runs changed. Refresh history to update this list.', '최근 실행 기록이 변경됐습니다. 실행 기록을 새로고침해 목록을 갱신하세요.'],
     'comparison.title': ['Compare two runs', '실행 2건 비교'],
-    'comparison.help': ['Choose a baseline and current run to compare case outcomes. Inspect detailed reports for evidence.', '기준 실행과 현재 실행을 선택해 케이스 결과를 비교하세요. 증거는 상세 보고서에서 확인하세요.'],
+    'comparison.help': ['Select a baseline and current run from history or the lists below. Inspect detailed reports for evidence.', '실행 기록이나 아래 목록에서 기준 실행과 현재 실행을 선택하세요. 증거는 상세 보고서에서 확인하세요.'],
     'comparison.baseline': ['Baseline run', '기준 실행'],
     'comparison.current': ['Current run', '현재 실행'],
     'comparison.choose': ['Choose a run', '실행 선택'],
     'comparison.compare': ['Compare', '비교하기'],
     'comparison.swap': ['Swap runs', '실행 순서 바꾸기'],
+    'comparison.useBaseline': ['Use as baseline', '기준으로 선택'],
+    'comparison.useCurrent': ['Use as current', '현재로 선택'],
     'comparison.filter': ['Show cases', '케이스 표시'],
     'comparison.all': ['All categories', '전체 분류'],
     'comparison.newlyFailed': ['Newly failed', '새로 실패'],
@@ -119,9 +121,9 @@
     'comparison.openBaseline': ['View baseline report', '기준 실행 보고서 보기'],
     'comparison.openCurrent': ['View current report', '현재 실행 보고서 보기'],
     'comparison.selectBoth': ['Select two different runs to compare.', '서로 다른 실행 2건을 선택하세요.'],
-    'comparison.noRuns': ['No recent runs available to compare.', '비교할 최근 실행이 없습니다.'],
+    'comparison.noRuns': ['No runs available to compare.', '비교할 실행이 없습니다.'],
     'comparison.loading': ['Comparing selected runs…', '선택한 실행을 비교하고 있습니다…'],
-    'comparison.limit': ['Choose from the 50 most recent runs. Comparison counts describe observed statuses; they do not establish failure cause or prove a defect was fixed.', '최근 실행 50건에서 선택하세요. 비교 수치는 관찰된 상태만 나타내며 실패 원인이나 결함 수정 여부를 입증하지 않습니다.'],
+    'comparison.limit': ['Search or load more in Run history to select from all saved runs. The lists include the 50 most recent runs, loaded history, and your selections. Comparison counts describe observed statuses; they do not establish failure cause or prove a defect was fixed.', '실행 기록을 검색하거나 더 불러와 저장된 전체 실행 중에서 선택하세요. 아래 목록에는 최근 50건, 불러온 기록, 현재 선택이 표시됩니다. 비교 수치는 관찰된 상태만 나타내며 실패 원인이나 결함 수정 여부를 입증하지 않습니다.'],
     'comparison.ready': ['Comparison ready. Categories describe observed case status changes.', '비교 결과가 준비됐습니다. 분류는 관찰된 케이스 상태 차이입니다.'],
     'comparison.noCases': ['No cases in this category.', '이 분류에 해당하는 케이스가 없습니다.'],
     'comparison.warningSuite': ['Suite content changed. Steps or expectations may differ, so these counts do not establish equivalent regressions or fixes.', '스위트 내용이 바뀌었습니다. 단계나 기대 결과가 다를 수 있으므로 이 수치만으로 같은 조건의 회귀나 수정이라고 판단할 수 없습니다.'],
@@ -141,6 +143,16 @@
     'comparison.error': ['Comparison failed: {message}', '비교 실패: {message}'],
     'comparison.runLabel': ['{date} · {suite} · {shortId} · {target} · {status} · {id}', '{date} · {suite} · {shortId} · {target} · {status} · {id}'],
     'history.report': ['Detailed report', '상세 보고서'],
+    'report.searchLabel': ['Search cases', '케이스 검색'],
+    'report.searchPlaceholder': ['Search ID, title, expected result, or errors', 'ID, 제목, 기대 결과 또는 오류 검색'],
+    'report.statusLabel': ['Case status', '케이스 상태'],
+    'report.filterAll': ['All statuses', '전체 상태'],
+    'report.filterFailedError': ['Failed/error only', '실패·오류만'],
+    'report.reset': ['Reset filters', '필터 초기화'],
+    'report.caseCount': ['Showing {shown} of {total} report cases', '보고서 케이스 {total}개 중 {shown}개 표시'],
+    'report.empty': ['This report has no cases.', '이 보고서에는 케이스가 없습니다.'],
+    'report.noMatches': ['No cases match these filters.', '필터에 맞는 케이스가 없습니다.'],
+    'report.filterHint': ['Filters only change the displayed cases. Downloads include all cases, and failed/error preparation uses all recorded failed/error cases regardless of visibility.', '필터는 표시되는 케이스에만 적용됩니다. 다운로드에는 모든 케이스가 포함되고, 실패·오류 준비에는 표시 여부와 관계없이 기록된 모든 실패·오류 케이스가 사용됩니다.'],
     'history.prepareFailed': ['Prepare failed/error cases', '실패·오류 케이스 준비'],
     'history.prepareHint': ['Only failed and error cases are selected. Passed, flaky, blocked, and skipped cases are excluded. Preparation never starts a run.', '실패·오류 케이스만 선택합니다. 통과·간헐 실패·차단·건너뜀 케이스는 제외됩니다. 준비만으로 실행은 시작되지 않습니다.'],
     'history.downloadMarkdown': ['Download Markdown', 'Markdown 다운로드'],

package/dist/src/ui/public/index.html

@@ -93,18 +93,18 @@
         </section>
         <section id="view-history" class="view" hidden>
           <div class="page-heading"><p class="eyebrow" data-i18n="history.eyebrow">03 / RUNS</p><h1 data-i18n="nav.history">Run history</h1><p data-i18n="history.intro">Only runs that actually started appear here. Once results are saved, you can view the detailed report.</p></div>
-          <section class="list-section"><div class="section-head"><span class="section-number">01</span><div><h2 data-i18n="history.title">Runs</h2><p data-i18n="history.help">Check the completed report for the final status.</p></div></div><div class="section-body form-stack"><label for="history-search" data-i18n="history.searchLabel">Search runs</label><input id="history-search" type="search" maxlength="200" aria-controls="history-list" placeholder="Suite ID, run ID, or target name" data-i18n-placeholder="history.searchPlaceholder"><label for="history-status-filter" data-i18n="history.statusFilter">Run status</label><select id="history-status-filter" aria-controls="history-list"><option value="" data-i18n="history.statusAll">All statuses</option><option value="passed" data-i18n="status.passed">passed</option><option value="failed" data-i18n="status.failed">failed</option><option value="blocked" data-i18n="status.blocked">blocked</option><option value="error" data-i18n="status.error">error</option><option value="interrupted" data-i18n="status.interrupted">interrupted</option></select><div id="history-list" class="list-body" aria-busy="false"></div><p id="history-page-status" class="hint" role="status" aria-live="polite"></p><div class="actions"><button type="button" id="history-load-more" class="button" data-i18n="history.loadMore" hidden>Load more</button><button type="button" id="history-refresh" class="button quiet" data-i18n="history.refresh">Refresh history</button></div></div></section>
+          <section class="list-section"><div class="section-head"><span class="section-number">01</span><div><h2 data-i18n="history.title">Runs</h2><p data-i18n="history.help">View a completed report or select a run as the comparison baseline or current run.</p></div></div><div class="section-body form-stack"><label for="history-search" data-i18n="history.searchLabel">Search runs</label><input id="history-search" type="search" maxlength="200" aria-controls="history-list" placeholder="Suite ID, run ID, or target name" data-i18n-placeholder="history.searchPlaceholder"><label for="history-status-filter" data-i18n="history.statusFilter">Run status</label><select id="history-status-filter" aria-controls="history-list"><option value="" data-i18n="history.statusAll">All statuses</option><option value="passed" data-i18n="status.passed">passed</option><option value="failed" data-i18n="status.failed">failed</option><option value="blocked" data-i18n="status.blocked">blocked</option><option value="error" data-i18n="status.error">error</option><option value="interrupted" data-i18n="status.interrupted">interrupted</option></select><div id="history-list" class="list-body" aria-busy="false"></div><p id="history-page-status" class="hint" role="status" aria-live="polite"></p><div class="actions"><button type="button" id="history-load-more" class="button" data-i18n="history.loadMore" hidden>Load more</button><button type="button" id="history-refresh" class="button quiet" data-i18n="history.refresh">Refresh history</button></div></div></section>
           <section id="comparison-panel" class="comparison-panel" aria-labelledby="comparison-title">
-            <div class="section-head"><span class="section-number">02</span><div><h2 id="comparison-title" data-i18n="comparison.title">Compare two runs</h2><p data-i18n="comparison.help">Choose a baseline and current run to compare case outcomes. This does not replace either detailed report.</p></div></div>
+            <div class="section-head"><span class="section-number">02</span><div><h2 id="comparison-title" data-i18n="comparison.title">Compare two runs</h2><p data-i18n="comparison.help">Select a baseline and current run from history or the lists below. Inspect detailed reports for evidence.</p></div></div>
             <div class="section-body">
-              <p class="hint" data-i18n="comparison.limit">Choose from the 50 most recent runs. Comparison counts describe observed statuses; they do not establish failure cause or prove a defect was fixed.</p>
+              <p class="hint" data-i18n="comparison.limit">Search or load more in Run history to select from all saved runs. The lists include the 50 most recent runs, loaded history, and your selections. Comparison counts describe observed statuses; they do not establish failure cause or prove a defect was fixed.</p>
               <div class="comparison-selects"><div><label for="compare-baseline" data-i18n="comparison.baseline">Baseline run</label><select id="compare-baseline" aria-controls="comparison-content"><option value="" data-i18n="comparison.choose">Choose a run</option></select></div><div><label for="compare-current" data-i18n="comparison.current">Current run</label><select id="compare-current" aria-controls="comparison-content"><option value="" data-i18n="comparison.choose">Choose a run</option></select></div></div>
               <div class="actions comparison-actions"><button type="button" id="compare-btn" class="button primary" data-i18n="comparison.compare" disabled>Compare</button><button type="button" id="compare-swap" class="button quiet" data-i18n="comparison.swap" disabled>Swap runs</button></div>
               <p id="comparison-status" class="hint" role="status" aria-live="polite"></p>
               <div id="comparison-results" hidden><div id="comparison-warnings"></div><div id="comparison-summary"></div><div class="comparison-filter-row"><label for="comparison-filter" data-i18n="comparison.filter">Show cases</label><select id="comparison-filter" aria-controls="comparison-content"><option value="" data-i18n="comparison.all">All categories</option><option value="newly-failed" data-i18n="comparison.newlyFailed">Newly failed</option><option value="now-passed" data-i18n="comparison.nowPassed">Now passed</option><option value="changed" data-i18n="comparison.changed">Changed status</option><option value="unchanged" data-i18n="comparison.unchanged">Same status</option><option value="added" data-i18n="comparison.added">Added to current</option><option value="missing" data-i18n="comparison.missing">Missing from current</option></select></div><div class="actions comparison-actions"><button type="button" id="comparison-md" class="button" data-i18n="comparison.downloadMarkdown" disabled>Download comparison Markdown</button><button type="button" id="comparison-json" class="button quiet" data-i18n="comparison.downloadJson" disabled>Download comparison JSON</button><button type="button" id="compare-open-baseline" class="button quiet" data-i18n="comparison.openBaseline" disabled>View baseline report</button><button type="button" id="compare-open-current" class="button quiet" data-i18n="comparison.openCurrent" disabled>View current report</button></div><div id="comparison-content"></div></div>
             </div>
           </section>
-          <section id="report-panel" class="report-panel" hidden><div class="section-head"><span class="section-number">03</span><div><h2 data-i18n="history.report">Detailed report</h2><p id="report-heading"></p></div></div><div class="section-body"><div class="actions"><button type="button" id="report-md" class="button" data-i18n="history.downloadMarkdown">Download Markdown</button><button type="button" id="report-json" class="button quiet" data-i18n="history.downloadJson">Download JSON</button><button type="button" id="report-rerun" class="button primary" disabled data-i18n="history.prepareFailed">Prepare failed/error cases</button></div><p class="hint" data-i18n="history.prepareHint">Passed, flaky, blocked, and skipped cases are excluded. Preparation does not start a run.</p><p class="hint" data-i18n="history.evidenceHint">The report summarizes results. Open or download screenshots and recordings from each attempt. Evidence files are not included in report downloads.</p><div id="report-content"></div></div></section>
+          <section id="report-panel" class="report-panel" hidden><div class="section-head"><span class="section-number">03</span><div><h2 data-i18n="history.report">Detailed report</h2><p id="report-heading"></p></div></div><div class="section-body"><div class="actions"><button type="button" id="report-md" class="button" data-i18n="history.downloadMarkdown">Download Markdown</button><button type="button" id="report-json" class="button quiet" data-i18n="history.downloadJson">Download JSON</button><button type="button" id="report-rerun" class="button primary" disabled data-i18n="history.prepareFailed">Prepare failed/error cases</button></div><p class="hint" data-i18n="history.prepareHint">Passed, flaky, blocked, and skipped cases are excluded. Preparation does not start a run.</p><p class="hint" data-i18n="history.evidenceHint">The report summarizes results. Open or download screenshots and recordings from each attempt. Evidence files are not included in report downloads.</p><div class="report-case-filters"><div><label for="report-case-search" data-i18n="report.searchLabel">Search cases</label><input id="report-case-search" type="search" aria-controls="report-case-list" placeholder="Search ID, title, expected result, or errors" data-i18n-placeholder="report.searchPlaceholder"></div><div><label for="report-case-status" data-i18n="report.statusLabel">Case status</label><select id="report-case-status" aria-controls="report-case-list"><option value="all">All</option><option value="failed-error">Failed/error only</option><option value="passed">passed</option><option value="failed">failed</option><option value="error">error</option><option value="blocked">blocked</option><option value="flaky">flaky</option><option value="skipped">skipped</option></select></div><button type="button" id="report-case-reset" class="button quiet" data-i18n="report.reset">Reset filters</button></div><p id="report-case-count" class="hint" role="status" aria-live="polite"></p><p class="hint" data-i18n="report.filterHint">Filters only change the displayed cases. Downloads include all cases, and failed/error preparation uses all recorded failed/error cases regardless of visibility.</p><div id="report-content"></div></div></section>
         </section>
         <section id="view-settings" class="view" hidden>
           <div class="page-heading"><p class="eyebrow" data-i18n="settings.eyebrow">04 / CONNECTIONS</p><h1 data-i18n="nav.settings">Connections</h1><p data-i18n="settings.intro">Configure run targets and models separately. Key values are read only from server environment variables.</p></div>

package/dist/src/ui/public/style.css

@@ -105,6 +105,11 @@ button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-
 .runtime-panel > p { margin: 0; overflow-wrap: anywhere; }
 #case-readiness { margin: 0 0 12px; }
 #report-content { margin-top: 20px; }
+.report-case-filters { display: grid; grid-template-columns: minmax(0, 2fr) minmax(0, 1fr) auto; align-items: end; gap: 12px; margin-top: 24px; }
+.report-case-filters > div { min-width: 0; }
+.report-case-filters label { display: block; margin-bottom: 8px; font-size: 13px; font-weight: 750; }
+.report-case-filters input, .report-case-filters select { display: block; width: 100%; min-width: 0; min-height: 44px; padding: 10px 12px; border: 1px solid var(--line); border-radius: var(--radius-control); background: var(--paper); color: var(--ink); }
+#report-case-count { margin: 12px 0 4px; }
 .blocked-title { margin-top: 21px !important; color: var(--accent-text); }
 .draft-actions { display: flex; align-items: center; flex-wrap: wrap; gap: 8px 14px; margin: calc(var(--space-factor) * 16px) 0; }
 .draft-actions span { color: var(--muted); font-size: 12px; }
@@ -147,6 +152,11 @@ button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-
 .list-row > div { min-width: 0; }
 .list-row strong { display: block; font-size: 15px; overflow-wrap: anywhere; }
 .list-row small { display: block; margin-top: 6px; color: var(--muted); font-size: 12px; line-height: 1.55; overflow-wrap: anywhere; }
+.history-run-row { flex-wrap: wrap; }
+.history-run-row > div:first-child { flex: 1 1 260px; }
+.run-row-actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 8px; }
+.run-row-actions .button[aria-pressed='true'] { border-color: var(--accent-solid); background: var(--accent-solid); color: var(--on-accent); opacity: 1; }
+.run-row-actions .button[aria-pressed='true']:hover:enabled { color: var(--on-accent); filter: brightness(.91); }
 .empty { max-width: 50ch; margin: 0; padding: 32px 0; color: var(--muted); line-height: 1.7; }
 
 .comparison-selects { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 18px; }
@@ -208,6 +218,8 @@ button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-
   .settings-grid { grid-template-columns: 1fr; }
 }
 @media (max-width: 550px) {
+  .report-case-filters { grid-template-columns: 1fr; }
+  .report-case-filters .button { justify-self: start; }
   .page-heading h1 { font-size: clamp(36px, 10vw, 46px); }
   .page-heading > p:last-child { font-size: 14px; }
   .topline-right { display: none; }
@@ -218,6 +230,8 @@ button:focus-visible, input:focus-visible, select:focus-visible, textarea:focus-
   .execution-grid { grid-template-columns: 1fr; gap: 16px; }
   .run-bar { align-items: start; flex-direction: column; }
   .list-row { align-items: start; flex-direction: column; gap: 12px; }
+  .history-run-row > div:first-child { flex: 0 1 auto; width: 100%; }
+  .run-row-actions { justify-content: flex-start; }
   .comparison-selects { grid-template-columns: 1fr; }
   .comparison-count { padding: 9px 5px; }
   .comparison-count strong { font-size: 19px; }

package/dist/src/ui/server.js

@@ -426,6 +426,12 @@ export async function startUIServer(options) {
         }
         return candidates.sort((a, b) => b.mtime - a.mtime || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
     }
+    function runSummary(item) {
+        return { runId: item.runId, suiteId: item.suiteId, status: item.status, startedAt: item.startedAt,
+            finishedAt: item.finishedAt, caseCount: item.cases.length,
+            passedCount: item.cases.filter((entry) => entry.status === 'passed' || entry.status === 'flaky').length,
+            target: item.target, ...(item.selection ? { selection: item.selection } : {}) };
+    }
     async function runSummaries(limit, query = '', status = '', after) {
         const history = [];
         for (const candidate of await runCandidates()) {
@@ -437,11 +443,7 @@ export async function startUIServer(options) {
                     continue;
                 if (query && ![item.suiteId, item.runId, item.target.name].some((field) => field.toLowerCase().includes(query)))
                     continue;
-                const summary = { runId: item.runId, suiteId: item.suiteId, status: item.status, startedAt: item.startedAt,
-                    finishedAt: item.finishedAt, caseCount: item.cases.length,
-                    passedCount: item.cases.filter((entry) => entry.status === 'passed' || entry.status === 'flaky').length,
-                    target: item.target, ...(item.selection ? { selection: item.selection } : {}) };
-                history.push({ candidate, summary });
+                history.push({ candidate, summary: runSummary(item) });
                 if (history.length === limit)
                     break;
             }
@@ -521,6 +523,24 @@ export async function startUIServer(options) {
                     nextCursor: rows.length > limit ? encodeRunCursor(runs.at(-1).candidate, filterHash) : null });
                 return;
             }
+            if (url.pathname === '/api/run-summary') {
+                if (url.searchParams.getAll('runId').length !== 1)
+                    invalid('A run ID is required.');
+                const runId = url.searchParams.get('runId');
+                if (!RUN_ID.test(runId))
+                    invalid('Invalid run ID.');
+                let item;
+                try {
+                    ({ report: item } = await report(runId, false));
+                }
+                catch (error) {
+                    if (error instanceof HTTPError && error.status === 400)
+                        notFound();
+                    throw error;
+                }
+                sendJSON(response, 200, { run: runSummary(item) });
+                return;
+            }
             if (url.pathname === '/api/suite') {
                 const file = url.searchParams.get('file');
                 if (!file)

package/docs/mobile.md

@@ -9,7 +9,7 @@ Choose **Mobile** on the scenario screen, describe the flow, and generate or dow
 With the installed CLI:
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.4.0
+npm install -g @ihyeon/flow-qa@0.8.0
 flow-qa init ./my-qa
 # Write your mobile flow in my-qa/flows/my-flow.md first.
 flow-qa plan flows/my-flow.md --platform mobile --prompt-only --workspace ./my-qa

package/docs/releases.md

@@ -2,6 +2,28 @@
 
 The alpha entries below are historical release records. They document earlier package versions and checks.
 
+## 0.8.0: explore cases and errors within a report
+
+Detailed reports now support case-content search and status filters, including **Failed/error only**. Search covers IDs, titles, reasons, expectations, attempt/secondary errors, and step labels/errors. Status choices show counts from the complete open report, while the match count describes displayed cases. Partial-run scope and report-level warnings remain visible; empty reports are distinguished from filters with no matches.
+
+Filters persist through navigation, language changes, polling, and reopening the same report. Opening a different report successfully resets them; a failed load preserves the existing view. Downloads and failed/error preparation continue to use every recorded case, and evidence URLs retain original attempt/artifact indices. No report, execution, or API schema changes are introduced. Installation examples now use this release.
+
+Locally verified on macOS with Node.js 24.22.1 on 2026-11-06: 118 tests, type checking, UI syntax/design-system audit, all existing UI checks, and the real Chromium demo passed. A dedicated browser smoke covered all six case statuses, case/expectation/error/step search, intersecting filters, complete Markdown/JSON exports, original evidence indices, full failed/error preparation scope, same/new/unreadable report transitions, partial and empty reports, draft/review preservation, English/Korean, and a 390px layout. A fresh tarball installation ran seven passing browser cases and exercised the installed report filter UI and complete JSON download. No model calls, external logins, or native-device runs were used.
+
+- Package: [`@ihyeon/flow-qa@0.8.0`](https://www.npmjs.com/package/@ihyeon/flow-qa/v/0.8.0)
+- Release: [GitHub 0.8.0](https://github.com/hyeonse-swing/flow-qa/releases/tag/v0.8.0)
+
+## 0.7.0: compare archived runs directly from history
+
+History rows now offer **Use as baseline** and **Use as current**, so older runs found by search or paging can be compared. The chosen pair stays available through query/status changes, history refresh, polling, navigation, and language changes. Selected row actions expose their pressed state, and changing a selection or swapping roles clears the old comparison and exports until compared again.
+
+A read-only summary lookup validates selected runs outside the recent 50 using the existing safe JSON report loader; comparison does not require a saved Markdown file. A confirmed deleted, invalid, or unsafe report clears its selection and comparison. Temporary request failures preserve the pair, and stale validation responses cannot change a newer selection. Choosing reports preserves the scenario draft, review state, and open detailed report, and never starts QA execution.
+
+Locally verified on macOS with Node.js 24.22.1 on 2026-11-06: 118 tests, type checking, UI syntax/design-system audit, all existing UI checks, and the real Chromium demo passed. A dedicated browser smoke used 61 synthetic records to verify comparison beyond the latest 50, JSON-only reports, row selection, filtering/paging, polling, navigation/language preservation, swaps, temporary failures, stale missing-file responses after changing away and back to the same selection, deleted archived files, and a 390px layout. A fresh tarball installation ran seven passing browser cases and verified archived summary lookup and comparison. No model calls, external logins, or native-device runs were used.
+
+- Package: [`@ihyeon/flow-qa@0.7.0`](https://www.npmjs.com/package/@ihyeon/flow-qa/v/0.7.0)
+- Release: [GitHub 0.7.0](https://github.com/hyeonse-swing/flow-qa/releases/tag/v0.7.0)
+
 ## 0.6.0: search and page through the full run history
 
 Run-history search and status filters now cover every valid saved report instead of only the latest 50. **Load more** appends up to 50 older matches, and **Refresh history** restarts the list with the same filters. Loaded counts, end-of-results, loading, and retry messages make the current scope explicit. Opening an older report supports the existing downloads and failed/error-case preparation.

package/docs/ui.md

@@ -7,7 +7,7 @@ Describe a user flow, review cases, and configure a target when ready to run. We
 Node.js 24.x (24.22.1 or later) or 26.12.1 or later is required. Node 25 is unsupported. Upgrade the Node runtime and restart any running UI process; updating Flow QA alone does not patch Node. Install Flow QA and start the web demo:
 
 ```sh
-npm install -g @ihyeon/flow-qa@0.4.0
+npm install -g @ihyeon/flow-qa@0.8.0
 flow-qa browser install
 flow-qa ui --demo
 ```
@@ -76,7 +76,17 @@ Results load 50 at a time, newest first by run-directory modification time, with
 
 Changing search or status restarts at the first page. The query, status, and loaded pages stay through navigation and language changes, and reset on page reload. The open report, its downloads, and scenario draft stay intact. A delayed response from an older query cannot replace newer results. Older reports support the same report downloads and failed/error-case preparation.
 
-When recent run records change, a single loaded page refreshes automatically. If several pages are loaded, the UI keeps them and shows an update hint. **Refresh history** restarts at the first page with the current filters and also picks up external edits or deletions of older records. Pagination is a live view, not a frozen snapshot: newly added records appear when refreshed, and reports changed externally while paging may move. Invalid, incomplete, or unsafe report files are excluded. The comparison selectors still offer the latest 50 reports independently of this search.
+When recent run records change, a single loaded page refreshes automatically. If several pages are loaded, the UI keeps them and shows an update hint. **Refresh history** restarts at the first page with the current filters and also picks up external edits or deletions of older records. Pagination is a live view, not a frozen snapshot: newly added records appear when refreshed, and reports changed externally while paging may move. Invalid, incomplete, or unsafe report files are excluded. Use the row actions to select any listed report for comparison, including older results.
+
+### Explore cases in a report
+
+From `0.8.0`, open **Run history → Detailed report** and use **Search cases** with **Case status** to narrow the displayed results. Search ignores case and surrounding whitespace, and matches case IDs, titles, reasons, expected results, attempt errors, secondary errors, step labels, and step errors. User-written Korean text is supported. Artifact paths and translated status labels are not search fields.
+
+**Failed/error only** shows those two recorded statuses; the other status choices distinguish passed, failed, error, blocked, flaky, and skipped. Status-option counts describe the entire open report, while the displayed count shows matches out of that report's recorded cases. A partial run's omitted cases are not included in those counts; its selected/full-suite scope remains visible separately. Report-level warnings remain visible even when no case matches. **Reset filters** clears both search and status.
+
+Filters stay while navigating, changing language, refreshing history/settings, or reopening the same report. Successfully opening another report resets them; a failed report load preserves the current report and filters. Filters reset on page reload. Evidence links still refer to each case's original attempt and artifact.
+
+These controls change only displayed cases. Markdown and JSON downloads contain every recorded case, and **Prepare failed/error cases** still prepares every recorded failed/error case from the report, even if hidden by the current filters. Filtering does not alter a saved report, the scenario draft, review confirmation, or execution selection.
 
 ### Prepare failed cases
 
@@ -90,13 +100,13 @@ The preparation notice identifies the original run. The next execution creates a
 
 ### Compare two runs
 
-From version `0.3.0`, open **Run history → Compare two runs**, choose a **Baseline run** and **Current run**, then compare. Both selectors use the most recent 50 loaded reports, independently of the history search and status filter. The reports must belong to the same suite ID and recorded target settings: a matching web URL, or mobile platform, app ID, and device. Target display names may differ. Mobile reports record the configured device selector, which can be a name; all mobile comparisons warn that matching selectors do not establish that the same physical device was used. Comparing does not run tests, call a model, or change case review.
+From version `0.3.0`, open **Run history → Compare two runs**, choose a **Baseline run** and **Current run**, then compare. From `0.7.0`, each history row offers **Use as baseline** and **Use as current**. Search or load older pages to choose any saved run, then press **Compare**. The selectors include the most recent 50 reports, currently loaded history rows, and the two selected runs. Selected runs stay available when searches or filters hide their rows. The reports must belong to the same suite ID and recorded target settings: a matching web URL, or mobile platform, app ID, and device. Target display names may differ. Mobile reports record the configured device selector, which can be a name; all mobile comparisons warn that matching selectors do not establish that the same physical device was used. Comparing does not run tests, call a model, or change case review.
 
 Cases are matched by ID. **Newly failed** means only `passed → failed`; **Now passed** means only `failed → passed`. Other status transitions, including flaky, blocked, skipped, and execution errors, appear under **Changed status**. Equal statuses are **Same status**. **Added to current** and **Missing from current** mean present in only one selected report; missing does not mean passed or deleted from the suite. Filter the visible rows by category, open either detailed report for its evidence, or download the complete comparison as Markdown or JSON. Downloads include every category, regardless of the display filter, and do not include evidence files. Markdown follows the existing report URL/link hiding policy; JSON retains the recorded target settings and case text.
 
 When suite hashes differ, the UI and exports warn that steps or expectations may have changed. These are recorded outcomes, not proof of equivalent tests, a product regression, or a fixed defect. Additional warnings identify reversed chronological order and interrupted/error runs. The comparison never treats a flaky pass as a clean pass. The existing report format remains unchanged; comparison JSON uses `flow-qa/comparison-1`.
 
-Swap reverses the baseline and current selections. Changing either selection clears the old result and downloads until a new comparison succeeds. Navigation, language changes, and history updates preserve valid selections and results; a selected run disappearing from the loaded list invalidates the comparison. Choices reset on page reload. Markdown product labels follow the selected language, while user-written case content and status codes are preserved.
+Swap reverses the baseline and current selections. Changing either selection clears the old result and downloads until a new comparison succeeds. Navigation, language changes, and history updates preserve valid selections and results; leaving the latest 50 or the visible history page does not clear a selected run. Background checks validate selected older records directly; a confirmed missing, invalid, or unsafe report clears that selection and invalidates the comparison. Temporary request failures preserve the pair for the next check. Choices reset on page reload. Markdown product labels follow the selected language, while user-written case content and status codes are preserved.
 
 ### Import existing case files
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihyeon/flow-qa",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "license": "MIT",
   "author": "Hyeonse Im",
   "repository": {
@@ -57,7 +57,7 @@
     "check:ui": "node --check src/ui/public/app.js && node --check src/ui/public/display.js && node --check src/ui/public/i18n.js && hds-audit .",
     "demo:serve": "node examples/demo/server.ts",
     "demo:smoke": "node scripts/demo-smoke.ts",
-    "smoke:ui": "node scripts/ui-i18n-smoke.mjs && node scripts/ui-comparison-smoke.mjs && node scripts/ui-selection-smoke.mjs && node scripts/ui-rerun-smoke.mjs && node scripts/ui-history-smoke.mjs"
+    "smoke:ui": "node scripts/ui-i18n-smoke.mjs && node scripts/ui-comparison-smoke.mjs && node scripts/ui-selection-smoke.mjs && node scripts/ui-rerun-smoke.mjs && node scripts/ui-history-smoke.mjs && node scripts/ui-archive-comparison-smoke.mjs && node scripts/ui-report-explorer-smoke.mjs"
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "3.0.53",