npm - scenescout - Versions diffs - 1.4.0 → 1.5.0 - Mend

scenescout 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,11 @@
 # scenescout
+## 1.5.0
+### Minor Changes
+- 791b4d0: The live view now hands over the report when the run ends. Closing the last session used to take the report with it — the view served it from the live engine, so the moment the browsers went the page said there was nothing to report. The last rendering is now kept, and when the board empties the page says the run has finished, opens the report by itself, and names the file it belongs in: `saved at <path>` once `scout_report` has written it, or plainly that it is not on disk and this page holds the only copy. A **Save a copy** button downloads that copy through the viewer's own browser (nothing is asked of the engine, which still answers `GET` and nothing else), and closing the tab on a finished run whose report was never written asks for confirmation first.
 ## 1.4.0
 ### Minor Changes

package/dist/engine/live-page.js CHANGED Viewed

@@ -48,6 +48,13 @@ export const LIVE_PAGE = `<!doctype html>
   button[aria-pressed="true"] { background: var(--accent); border-color: var(--accent); color: #fff; }
   #banner { display: none; margin: 12px 16px 0; padding: 8px 12px; border-radius: 6px; background: var(--stuck-bg); color: var(--stuck); }
   #empty { display: none; padding: 48px 16px; text-align: center; color: var(--muted); }
+  #finished { display: none; max-width: 640px; margin: 48px auto; padding: 24px; text-align: center;
+    background: var(--panel); border: 1px solid var(--line); border-radius: 8px; }
+  #finished.open { display: block; }
+  #finished h2 { margin: 0 0 8px; font-size: 18px; }
+  #finished p { margin: 0 0 8px; color: var(--muted); }
+  #finished .where { font: 12px/1.6 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; overflow-wrap: anywhere; }
+  #finished button { margin-top: 8px; padding: 7px 14px; font-weight: 600; }
   main { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 320px), 1fr)); gap: 12px; padding: 16px; }
   .card { background: var(--panel); border: 1px solid var(--line); border-radius: 8px; overflow: hidden; display: flex; flex-direction: column; }
   .card.stuck { border-color: var(--stuck); }
@@ -143,12 +150,19 @@ export const LIVE_PAGE = `<!doctype html>
 </header>
 <div id="banner" role="alert" data-testid="live-unreachable-banner">The engine is not answering. It may have exited; this page will pick up again if it comes back.</div>
 <div id="empty" data-testid="live-empty-state">No session is attached yet. Cards appear here as soon as one attaches.</div>
+<div id="finished" data-testid="live-finished-state">
+  <h2>The run has finished</h2>
+  <p>Its browsers are closed, so there is nothing left to watch. What it found is in the report.</p>
+  <p class="where" id="finished-where" data-testid="live-finished-where"></p>
+  <button type="button" id="finished-report" data-testid="live-finished-report">Read the report</button>
+</div>
 <main id="grid"></main>
 <div id="report" role="dialog" aria-modal="true" aria-label="The run's report" data-testid="live-report-dialog">
   <div class="bar">
     <strong>Report</strong>
     <span class="meta" id="report-meta" data-testid="live-report-meta"></span>
     <span class="spacer"></span>
+    <button type="button" id="report-save" data-testid="live-report-save">Save a copy</button>
     <button type="button" id="report-close" data-testid="live-report-close">Close</button>
   </div>
   <div class="doc" id="report-doc" data-testid="live-report-doc"></div>
@@ -187,6 +201,14 @@ export const LIVE_PAGE = `<!doctype html>
   var reportOpen = false;
   var reportTimer = null;
   var reportProblem = null;
+  // The run had sessions and has none now: its browsers are gone, and this
+  // page holds the only rendering of the report unless it was written to disk.
+  var sawRun = false;
+  var finished = false;
+  var reportShown = false;
+  var reportFile = null;
+  var reportMarkdown = null;
+  var savedACopy = false;
   // A result that reads as a failure is shown in red.
   var BAD_RESULT = /error|fail|refus|block|violation|abandoned/i;
@@ -435,7 +457,8 @@ export const LIVE_PAGE = `<!doctype html>
           meta.textContent = '';
           return;
         }
-        meta.textContent = 'as the run stands at ' + clock(d.at) + ' · scout_report writes this document to .scenescout/report.md at the end';
+        reportMarkdown = d.markdown;
+        meta.textContent = (finished ? 'as the run left it at ' : 'as the run stands at ') + clock(d.at) + ' · ' + whereItIs();
         renderMarkdown(doc, d.markdown);
       })
       .catch(function (err) {
@@ -448,6 +471,28 @@ export const LIVE_PAGE = `<!doctype html>
         }
       });
   }
+  /** Where the report's file is, and whether the agent has written it there. */
+  function whereItIs() {
+    if (!reportFile) return 'scout_report writes this document to .scenescout/report.md at the end';
+    if (reportFile.written) return 'saved at ' + reportFile.path;
+    return 'NOT saved: ' + reportFile.path + ' does not exist — the agent has not run scout_report, so this page holds the only copy';
+  }
+  // Saving is the viewer's own browser writing a file the page already has;
+  // nothing is sent to the engine, which only ever answers GET (ADR 7).
+  function saveACopy() {
+    if (!reportMarkdown) return;
+    var url = URL.createObjectURL(new Blob([reportMarkdown], { type: 'text/markdown' }));
+    var a = document.createElement('a');
+    a.href = url;
+    a.download = 'scenescout-report.md';
+    document.body.appendChild(a);
+    a.click();
+    a.remove();
+    setTimeout(function () { URL.revokeObjectURL(url); }, 10000);
+    savedACopy = true;
+  }
   function openReport() {
     reportOpen = true;
     document.getElementById('report').classList.add('open');
@@ -608,7 +653,21 @@ export const LIVE_PAGE = `<!doctype html>
       delete frames[name];
     });
     syncEvents();
-    document.getElementById('empty').style.display = snap.sessions.length ? 'none' : 'block';
+    reportFile = snap.report || reportFile;
+    if (snap.sessions.length > 0) sawRun = true;
+    finished = sawRun && snap.sessions.length === 0;
+    document.getElementById('empty').style.display = snap.sessions.length || finished ? 'none' : 'block';
+    document.getElementById('finished').classList.toggle('open', finished);
+    if (finished) {
+      var where = document.getElementById('finished-where');
+      where.textContent = whereItIs();
+      where.className = 'where' + (reportFile && reportFile.written ? '' : ' unset');
+      // The moment somebody wants the report is the moment the run ends: show it.
+      if (!reportShown) {
+        reportShown = true;
+        if (!reportOpen) openReport();
+      }
+    }
     document.getElementById('engine').textContent = 'engine pid ' + snap.pid + ' · v' + snap.version;
     document.getElementById('counts').textContent = snap.sessions.length + ' session' + (snap.sessions.length === 1 ? '' : 's') +
       ' · ' + counts.running + ' running · ' + counts.idle + ' idle' + (counts.stuck ? ' · ' + counts.stuck + ' stuck' : '');
@@ -633,6 +692,16 @@ export const LIVE_PAGE = `<!doctype html>
   document.getElementById('focus-feed').addEventListener('mouseleave', function () { showObjective(null); });
   document.getElementById('focus').addEventListener('click', function (e) { if (e.target === this) closeFocus(); });
   document.getElementById('report-open').addEventListener('click', openReport);
+  document.getElementById('finished-report').addEventListener('click', openReport);
+  document.getElementById('report-save').addEventListener('click', saveACopy);
+  // Closing the tab on a finished run whose report was never written to disk
+  // throws the only copy away. The browser shows its own confirm/dismiss, and
+  // only when the person has interacted with the page at least once.
+  window.addEventListener('beforeunload', function (e) {
+    if (!finished || savedACopy || (reportFile && reportFile.written)) return;
+    e.preventDefault();
+    e.returnValue = '';
+  });
   document.getElementById('report-close').addEventListener('click', closeReport);
   document.addEventListener('keydown', function (e) {
     if (e.key !== 'Escape') return;

package/dist/mcp-server.js CHANGED Viewed

@@ -37,7 +37,7 @@ import { reapOrphanBrowsers } from "./engine/reaper.js";
 import { MemoryStore, redactSecrets } from "./engine/memory.js";
 import { SessionQueue, withWatchdog } from "./engine/dispatch.js";
 import { FIXTURE_KINDS } from "./engine/fixtures.js";
-import { feedForSession, LIVE_ENV, writeStatusFile, LIVE_TOKEN_FILE, LiveServer, StatusBoard } from "./engine/live.js";
+import { feedForSession, LIVE_ENV, writeStatusFile, LIVE_TOKEN_FILE, LiveServer, StatusBoard, } from "./engine/live.js";
 import { computeGaps, formatRouteCoverage, generateReport } from "./engine/report.js";
 import { EXPLORE_PROMPT_ARGUMENTS, explorePrompt, loadPlaybook, PLAYBOOK_PROMPT, PLAYBOOK_TOOL, SERVER_INSTRUCTIONS } from "./playbook.js";
 import { formatScan, scanProject } from "./scan.js";
@@ -105,8 +105,44 @@ const liveTokenWrites = new Map();
 let liveTokenWarned = false;
 /** Why the live view could not start, when it could not: told to the agent and written to status.json. */
 let liveError = null;
+/**
+ * The last run's report, kept after its sessions close. The engines are gone
+ * by then, so this is the only way the live view can still show what the run
+ * found — which is the moment somebody most wants to read it.
+ */
+let lastRun = null;
+/** Render the report for a session that is about to close, so the live view keeps it. */
+function keepReport(eng) {
+    if (!eng.memory)
+        return;
+    try {
+        const { markdown } = generateReport(eng.memory, eng.oracleLog.all, reportExtras(eng), { write: false });
+        lastRun = { markdown: redactSecrets(markdown), at: new Date().toISOString(), dir: eng.memory.dir };
+    }
+    catch {
+        // Best-effort: a report that cannot be rendered must not fail a close.
+    }
+}
+/** Where this run's report belongs, and whether the agent has written it there yet. */
+function reportFile(dir) {
+    if (!dir)
+        return undefined;
+    const file = path.join(dir, "report.md");
+    try {
+        return { path: file, written: fs.existsSync(file) };
+    }
+    catch {
+        return { path: file, written: false };
+    }
+}
 const liveProvider = {
-    snapshot: () => ({ pid: process.pid, version: PKG_VERSION, at: new Date().toISOString(), sessions: board.list() }),
+    snapshot: () => ({
+        pid: process.pid,
+        version: PKG_VERSION,
+        at: new Date().toISOString(),
+        sessions: board.list(),
+        report: reportFile(engines.values().next().value?.memory?.dir ?? lastRun?.dir),
+    }),
     // The engine holds no reasoning — it never sees one — so the feed is what the
     // session DID: the action log, which is the same trail a finding's repro uses.
     activity: (session, limit) => feedForSession(engines.get(session)?.memory?.actionLog ?? [], session, limit, redactSecrets),
@@ -118,7 +154,7 @@ const liveProvider = {
     report: () => {
         const eng = (lastWriter && engines.get(lastWriter.session)) ?? engines.values().next().value;
         if (!eng?.memory)
-            return null;
+            return lastRun ? { markdown: lastRun.markdown, at: lastRun.at } : null;
         const { markdown } = generateReport(eng.memory, eng.oracleLog.all, reportExtras(eng), { write: false });
         return { markdown: redactSecrets(markdown), at: new Date().toISOString() };
     },
@@ -976,6 +1012,8 @@ server.registerTool("scout_close", {
             for (const e of engines.values())
                 if (e.memory?.dir)
                     dirs.add(e.memory.dir);
+            for (const e of engines.values())
+                keepReport(e);
             for (const name of engines.keys())
                 live?.dropSession(name);
             await Promise.allSettled([...engines.values()].map((e) => e.close()));
@@ -991,6 +1029,7 @@ server.registerTool("scout_close", {
         const eng = engines.get(name);
         if (!eng)
             return text(`No live session "${name}".`, name);
+        keepReport(eng);
         live?.dropSession(name);
         await eng.close();
         const saveError = eng.memory?.lastSaveError;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "scenescout",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "SceneScout — exploratory UI testing for AI coding agents. An MCP server that gives any agent (Claude Code, Cursor, VS Code Copilot, Codex, Gemini CLI and others) a structured view of a running web app, always-on oracles, a network-level write policy, memory across runs and a gap-checked report.",
   "license": "MIT",
   "author": "brunoboto96",