@molecule/api-ai-tools 1.9.6 → 1.9.7

package/dist/trace-artifacts.js

@@ -49,6 +49,12 @@ export const TRACE_NOTE_URL_CHARS = 96;
 export const TRACE_NOTE_SENT_CHARS = 160;
 /** How much of the response body the note prints — the API's first error line. */
 export const TRACE_NOTE_GOT_CHARS = 120;
+/**
+ * How much of the FAILING STEP's response body the note prints. Longer than
+ * {@link TRACE_NOTE_GOT_CHARS}: it is the one line that answers "what did the click actually get
+ * back", and an app's own body (`{"profile":{…}}`) can carry the answer past its first clause.
+ */
+export const TRACE_NOTE_LEAD_GOT_CHARS = 200;
 /** How much of a network error's own text (`net::ERR_CONNECTION_REFUSED`) the note prints. */
 const TRACE_NOTE_FAILURE_CHARS = 120;
 /**
@@ -244,10 +250,38 @@ for (const one of found.slice(0, MAX_TRACES)) {
     if (sent) r.sent = sent
     if (got) r.got = got
   }
+  // The page's own actions, timed. before/after pair on the call id, and only the LIBRARY
+  // traces carry a class and a method (Frame.goto, Locator.fill); the test runner's own
+  // trace times its hooks and fixtures with class Test, which is not a page action. Read BEFORE
+  // the request buckets: whether the navigation itself finished decides whether a subresource
+  // with no response is evidence (see \`navigationOpen\` below).
+  const ended = {}
+  for (const entry of trace) {
+    if (entry && entry.type === 'after' && typeof entry.callId === 'string' && typeof entry.endTime === 'number')
+      ended[entry.callId] = entry.endTime
+  }
+  const actions = []
+  for (const entry of trace) {
+    if (!entry || entry.type !== 'before') continue
+    if (typeof entry.class !== 'string' || typeof entry.method !== 'string') continue
+    if (entry.class === 'Test' || typeof entry.startTime !== 'number') continue
+    actions.push({
+      api: entry.class + '.' + entry.method,
+      start: entry.startTime,
+      end: typeof ended[entry.callId] === 'number' ? ended[entry.callId] : null,
+    })
+  }
+  // A \`page.goto\` that has no end time: the page never finished loading. When that is the
+  // failure, a document subresource with no response is the reason — the navigation waits for
+  // its stylesheets and scripts — and it is evidence, not the aborted noise a finished
+  // navigation leaves behind (xr-molecule-flash-m135: three goto timeouts on a deployed app
+  // where one 88 KB stylesheet fetch stalled 27 s, and the trace of each held the pending CSS).
+  const navigationOpen = actions.some(function (a) { return /\\.goto$/.test(a.api) && a.end === null })
   // The page shell's own requests (a service worker probe, a manifest, a font) are not the
   // failing step's dependencies: a 404 on one, or no response at all, is not a cause and takes
   // no row (xr-molecule-flash-m125 +29:33 — "GET /sw.js; GET /fonts/ionicons.woff" sent the
-  // model to write a caching service worker into the app).
+  // model to write a caching service worker into the app). A document's OWN stylesheet or
+  // script is not shell noise: the navigation blocks on it.
   const SHELL_TYPE = { font: 1, image: 1, stylesheet: 1, script: 1, manifest: 1 }
   function shellPath(path) {
     return /^\\/(?:sw|service-worker)\\.js(?:[?#]|$)|\\/manifest\\.webmanifest(?:[?#]|$)|\\/favicon[^/]*(?:[?#]|$)|\\/fonts?\\//.test(path) ||
@@ -257,6 +291,13 @@ for (const one of found.slice(0, MAX_TRACES)) {
     if (r.type === 'document') return false
     return SHELL_TYPE[r.type] === 1 || shellPath(r.path)
   }
+  // The shell requests that stay noise even when they never finished: the PWA worker, the
+  // manifest, a favicon, a font. A pending \`/assets/*.css\` is the document's dependency.
+  function incidentalShell(r) {
+    if (r.type === 'document') return false
+    return r.type === 'font' || r.type === 'manifest' ||
+      /^\\/(?:sw|service-worker)\\.js(?:[?#]|$)|\\/manifest\\.webmanifest(?:[?#]|$)|\\/favicon[^/]*(?:[?#]|$)|\\/fonts?\\//.test(r.path)
+  }
   // A failed request: a 4xx/5xx, or no response at all WITH Playwright's error text (a refused
   // connection). No response and no text is an aborted/pending request, not a failure. A 404 on
   // the page shell is excepted, for the reason above.
@@ -264,18 +305,72 @@ for (const one of found.slice(0, MAX_TRACES)) {
     if (shellRequest(r) && r.status === 404) return false
     return r.status >= 400 || (r.status <= 0 && typeof r.failure === 'string')
   }
+  // No response and no error text at all — still in flight when the test ended.
+  function neverFinished(r) {
+    return r.status <= 0 && typeof r.failure !== 'string'
+  }
+  // The request the failing step itself sent: the page's LAST call to the app's own origin (a
+  // click's fetch/xhr), else the document load. It leads the test's line, because the request a
+  // click sent answers "why did nothing change?" — xr-molecule-flash-m135 clicked Follow and sent
+  // a DELETE (its \`following\` state was stale), and the trace held the whole exchange while the
+  // result listed only the test's earlier, answered requests.
+  //
+  // Never a request that is still in flight (no response, no error text): it says nothing about
+  // what came back, and the note has its own honest row for it (m112 +30:45). Never the page
+  // shell's own probe (a refused \`/sw.js\` is not the step's request — m125 +29:33).
+  function leadCandidate(r) {
+    if (r.status <= 0 && typeof r.failure !== 'string') return false
+    if (r.type === 'document') return true
+    if (r.type !== 'fetch' && r.type !== 'xhr') return false
+    // The request the page makes for its own shell is not the step's (m125 +29:33). The recorded
+    // path can be an absolute URL when the probe's origin differs from the document's, so judge
+    // its pathname.
+    var p = r.path
+    try { p = new URL(r.path, 'http://trace.local').pathname } catch (e) { p = String(r.path).split(/[?#]/)[0] }
+    return !shellPath(p)
+  }
+  let leadIndex = -1
+  for (let i = requests.length - 1; i >= 0; i--) {
+    const r = requests[i]
+    if ((r.type === 'fetch' || r.type === 'xhr') && leadCandidate(r)) { leadIndex = i; break }
+  }
+  if (leadIndex === -1) {
+    for (let i = requests.length - 1; i >= 0; i--) {
+      if (requests[i].type === 'document' && leadCandidate(requests[i])) { leadIndex = i; break }
+    }
+  }
+  let lead = null
+  if (leadIndex !== -1) {
+    const r = requests[leadIndex]
+    const sent = bodyText(buf, entries, r.postData, MAX_BODY)
+    const got = bodyText(buf, entries, r.content, MAX_BODY)
+    lead = {
+      method: r.method,
+      path: r.path,
+      status: r.status,
+      failure: r.failure,
+      type: r.type || undefined,
+      ...(sent ? { sent: sent } : {}),
+      ...(got ? { got: got } : {}),
+    }
+  }
   const failing = []
   const api = []
+  const pending = []
   const rest = []
   for (let i = 0; i < requests.length; i++) {
     const r = requests[i]
     // An answered/aborted shell request is no evidence at all — do not spend a kept row on it.
-    if (shellRequest(r) && !failedRequest(r)) continue
+    // The exception is a document subresource that never finished while the navigation was
+    // still open: that IS what the timeout waited on.
+    if (shellRequest(r) && !failedRequest(r) && !(navigationOpen && neverFinished(r) && !incidentalShell(r))) continue
     if (failedRequest(r)) failing.push(i)
     else if (r.type === 'fetch' || r.type === 'xhr' || r.type === 'document') api.push(i)
+    else if (navigationOpen && neverFinished(r)) pending.push(i)
     else rest.push(i)
   }
-  const keep = failing.slice(-MAX_REQUESTS).concat(api.slice(-MAX_REQUESTS)).concat(rest.slice(-2))
+  const keep = failing.slice(-MAX_REQUESTS).concat(api.slice(-MAX_REQUESTS))
+    .concat(pending.slice(-MAX_REQUESTS)).concat(rest.slice(-2))
   const chosen = []
   const seen = new Set()
   for (const i of keep.sort(function (a, b) {
@@ -297,25 +392,6 @@ for (const one of found.slice(0, MAX_TRACES)) {
       type: r.type || undefined,
     })
   }
-  // The page's own actions, timed. before/after pair on the call id, and only the LIBRARY
-  // traces carry a class and a method (Frame.goto, Locator.fill); the test runner's own
-  // trace times its hooks and fixtures with class Test, which is not a page action.
-  const ended = {}
-  for (const entry of trace) {
-    if (entry && entry.type === 'after' && typeof entry.callId === 'string' && typeof entry.endTime === 'number')
-      ended[entry.callId] = entry.endTime
-  }
-  const actions = []
-  for (const entry of trace) {
-    if (!entry || entry.type !== 'before') continue
-    if (typeof entry.class !== 'string' || typeof entry.method !== 'string') continue
-    if (entry.class === 'Test' || typeof entry.startTime !== 'number') continue
-    actions.push({
-      api: entry.class + '.' + entry.method,
-      start: entry.startTime,
-      end: typeof ended[entry.callId] === 'number' ? ended[entry.callId] : null,
-    })
-  }
   const consoleErrors = []
   let spec = null
   let line = 0
@@ -343,6 +419,7 @@ for (const one of found.slice(0, MAX_TRACES)) {
     dir: path.relative(ROOT, path.dirname(one.file)),
     spec: spec,
     line: line,
+    lead: lead,
     // Failures first, per the sort above; the keep-window is the HEAD of that order. Taking the
     // tail here dropped every failed request as soon as a page made more than MAX_REQUESTS of them
     // plus the answered ones (xr-molecule-flash-m112's note listed only -1s and 200s).
@@ -352,6 +429,26 @@ for (const one of found.slice(0, MAX_TRACES)) {
   }) + '\\n')
 }
 `;
+/**
+ * One request out of a `TRACE` line's json, or null when the value is not an object.
+ *
+ * @param value - One entry of the line's `requests` array, or its `lead`.
+ * @returns The request, or null.
+ */
+function parseTraceRequest(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const r = value;
+    return {
+        method: String(r.method ?? ''),
+        path: String(r.path ?? ''),
+        status: Number(r.status ?? 0) || 0,
+        ...(typeof r.failure === 'string' && r.failure ? { failure: r.failure } : {}),
+        ...(typeof r.sent === 'string' && r.sent ? { sent: r.sent } : {}),
+        ...(typeof r.got === 'string' && r.got ? { got: r.got } : {}),
+        ...(typeof r.type === 'string' && r.type ? { type: r.type } : {}),
+    };
+}
 /**
  * The traces {@link traceArtifactsScript} printed, parsed.
  *
@@ -371,20 +468,14 @@ export function parseTraceArtifacts(stdout) {
             const requests = Array.isArray(raw.requests) ? raw.requests : [];
             const consoleMessages = Array.isArray(raw.console) ? raw.console : [];
             const actions = Array.isArray(raw.actions) ? raw.actions : [];
+            const lead = parseTraceRequest(raw.lead);
             out.push({
                 spec: typeof raw.spec === 'string' ? raw.spec : null,
                 line: typeof raw.line === 'number' ? raw.line : 0,
                 requests: requests
-                    .filter((r) => typeof r === 'object' && r !== null)
-                    .map((r) => ({
-                    method: String(r.method ?? ''),
-                    path: String(r.path ?? ''),
-                    status: Number(r.status ?? 0) || 0,
-                    ...(typeof r.failure === 'string' && r.failure ? { failure: r.failure } : {}),
-                    ...(typeof r.sent === 'string' && r.sent ? { sent: r.sent } : {}),
-                    ...(typeof r.got === 'string' && r.got ? { got: r.got } : {}),
-                    ...(typeof r.type === 'string' && r.type ? { type: r.type } : {}),
-                })),
+                    .map(parseTraceRequest)
+                    .filter((request) => request !== null),
+                ...(lead === null ? {} : { lead }),
                 console: consoleMessages.map(String),
                 actions: actions
                     .filter((a) => typeof a === 'object' && a !== null)
@@ -445,6 +536,31 @@ function requestLine(request) {
         : '';
     return `${head}${sent}${got}`;
 }
+/**
+ * The failing step's own request as the note writes it first: `the failing step sent DELETE
+ * /api/profiles/x/follow → 200 got {"profile":{…}}`.
+ *
+ * It prints the response body whatever the status — an ANSWERED request is the point: m135's
+ * Follow click sent the DELETE an unfollow sends, got a 200 and a profile with `following: false`,
+ * and nothing in the result said which verb the click used.
+ *
+ * @param request - The trace's `lead` request.
+ * @returns The clause the test's row opens with.
+ */
+function leadRequestLine(request) {
+    const status = request.status > 0
+        ? String(request.status)
+        : request.failure
+            ? `no response (${bodyLine(redactSecrets(request.failure), TRACE_NOTE_FAILURE_CHARS)})`
+            : 'no response';
+    const sent = request.sent
+        ? ` sent ${bodyLine(redactSecrets(request.sent), TRACE_NOTE_SENT_CHARS)}`
+        : '';
+    const got = request.got
+        ? ` got ${bodyLine(redactSecrets(request.got), TRACE_NOTE_LEAD_GOT_CHARS)}`
+        : '';
+    return `the failing step sent ${requestLabel(request)} → ${status}${sent}${got}`;
+}
 /** Whether a sent body is an object whose only top-level key is `data` — the wrapped-body trap. */
 function wrappedInData(text) {
     try {
@@ -534,6 +650,33 @@ export function unansweredRequest(request) {
         return false;
     return request.status <= 0 && request.failure === undefined;
 }
+/**
+ * Whether a trace recorded a DOCUMENT SUBRESOURCE that never finished: a stylesheet, script or
+ * other asset the page itself loads, with no response and no error text — still in flight when
+ * the navigation timed out.
+ *
+ * The page shell's own incidental requests (`/sw.js`, the manifest, a favicon, a font) are
+ * excepted for the reason {@link isStaticAssetRequest} documents: m125's run was sent to write a
+ * caching service worker by an aborted `/sw.js`. A pending `/assets/*.css` is different — the
+ * navigation blocks on it, so it is the reason `page.goto` ran out of time rather than one of the
+ * app's API calls (xr-molecule-flash-m135 +34:10: three deployed `page.goto` timeouts on tests that
+ * pass locally, one 88 KB stylesheet fetch measured at 27 s, and the failing tests' traces each
+ * held the never-answered CSS while the note said "the cause is in the page").
+ *
+ * @param request - One request a trace recorded.
+ * @returns True when the request is a document subresource that never finished.
+ */
+export function stalledDocumentSubresource(request) {
+    if (request.status > 0 || request.failure !== undefined)
+        return false;
+    if (request.type === 'document')
+        return false;
+    if (request.type === 'font' || request.type === 'manifest')
+        return false;
+    if (STATIC_ASSET_PATH.test(requestPath(request)))
+        return false;
+    return isStaticAssetRequest(request);
+}
 /**
  * How far a trace's last recorded step can sit after an earlier walk's failing test and still be
  * that test. The trace names the LINE of the last step it recorded (the click, the wait), while the
@@ -591,14 +734,19 @@ function repeatsEarlierFailure(item, earlier) {
  * hidden in "… and 7 more traced failures".
  *
  * A request the page shell made (m125 +29:33: `/sw.js`, a font) is not evidence about the step
- * either, answered or not.
+ * either, answered or not. The exception is a document subresource that never finished while the
+ * page's own navigation was still open: the navigation waits on it, so it is the reason the
+ * `page.goto` timed out ({@link stalledDocumentSubresource}).
  *
  * @param item - One traced failure.
  * @returns True when the trace holds a request or console error worth a row.
  */
 function traceRowEvidence(item) {
     return (item.console.length > 0 ||
-        item.requests.some((request) => !isStaticAssetRequest(request) && !unansweredRequest(request)));
+        item.requests.some((request) => !isStaticAssetRequest(request) && !unansweredRequest(request)) ||
+        // The one shape in which a subresource with no response IS the cause: the navigation it was
+        // part of never finished (see {@link stalledDocumentSubresource}).
+        (navigationNeverFinished(item) && item.requests.some(stalledDocumentSubresource)));
 }
 /**
  * The note's row order: a row with a REAL failure first, then a row whose failure an earlier walk
@@ -609,6 +757,10 @@ function traceRowEvidence(item) {
 function traceRowTier(item, earlier) {
     if (item.requests.some(failedRequest))
         return 0;
+    // A navigation that never finished because its own subresource never got a response is as
+    // strong a cause as a failed request — it is the one fact the timeout was waiting on (m135).
+    if (navigationNeverFinished(item) && item.requests.some(stalledDocumentSubresource))
+        return 0;
     if (repeatsEarlierFailure(item, earlier))
         return 1;
     return 2;
@@ -678,6 +830,12 @@ function transportFailure(items) {
  * line rather than inferred from the status; when one of those bodies is an object whose only key
  * is `data`, the note names the call shape that produces it (xr-molecule-flash-m111 +11:36).
  *
+ * Every row opens with the request the failing step ITSELF sent ({@link TraceArtifact.lead}) and
+ * its response — whatever its status — because the question a `waiting for locator` failure asks
+ * is what the click did: xr-molecule-flash-m135's Follow click sent `DELETE …/follow → 200` (an
+ * unfollow, from a stale `following` state) and the run's result named only the test's earlier
+ * answered requests, so the executor spent 14 minutes on its own browser probes.
+ *
  * WHICH rows it spends is evidence, not artifact order (xr-molecule-flash-m112 +53:46): a row
  * needs a recorded response, a real failure or a console error ({@link traceRowEvidence}), rows are
  * deduplicated by the test's location, and they are ordered real failure → repeated from an
@@ -689,6 +847,13 @@ function transportFailure(items) {
  * transport error (`net::ERR_CONTENT_DECODING_FAILED` and friends) and the document it hit: nothing
  * rendered, so no row below is app evidence (xr-molecule-flash-m118 +37:09).
  *
+ * When a navigation never finished and one of the document's own subresources (a stylesheet, a
+ * script, an asset under `/assets/`) never got a response either, that request takes a row and the
+ * note says the page was waiting on it. It is not an API call, but on a `page.goto` timeout it is
+ * the only request that can explain the timeout — the deployed app was serving the page while one
+ * fetch stalled for 27 s (xr-molecule-flash-m135 +34:10). The page shell's incidental requests
+ * (`/sw.js`, the manifest, a favicon, a font) stay out, for m125's reason.
+ *
  * @param items - The traces {@link parseTraceArtifacts} read.
  * @param target - Where the run went — the deployed host, as the note names it.
  * @param earlierFailures - The failing `file:line`s earlier walks of this suite left, so a repeat
@@ -720,21 +885,52 @@ export function failureTraceNote(items, target, earlierFailures = []) {
     const wrapped = traced.some((item) => item.requests.some((request) => request.sent !== undefined && wrappedInData(request.sent)));
     // The "one of these requests failing" answer is only honest when a listed request really failed.
     const anyFailed = traced.some((item) => item.requests.some(failedRequest));
+    // The document subresources that never finished anywhere in this read — the assets a timed-out
+    // navigation was waiting on, when there is no failed request to explain the timeout.
+    const stalledAssets = [
+        ...new Set(traced
+            .filter(navigationNeverFinished)
+            .flatMap((item) => item.requests.filter(stalledDocumentSubresource))
+            .map(requestLabel)),
+    ];
     const rows = [];
     for (const [index, item] of traced.entries()) {
+        // The request the failing step itself sent LEADS the row (m135): a click that changed nothing
+        // is answered by the request it sent and what came back, whether or not that request failed.
+        // It is not repeated in the buckets below.
+        const lead = item.lead;
+        const isLead = (request) => lead !== undefined &&
+            request.method === lead.method &&
+            request.path === lead.path &&
+            request.status === lead.status;
         // The page shell's own requests take no row, in any bucket: an aborted `/sw.js` would
         // otherwise be printed as an "answered" request with no response (m125 +29:33).
-        const requests = item.requests.filter((request) => !isStaticAssetRequest(request));
+        const requests = item.requests.filter((request) => !isStaticAssetRequest(request) && !isLead(request));
         const failed = requests.filter(failedRequest);
         const unanswered = requests.filter(unansweredRequest);
         const answered = requests.filter((request) => !failedRequest(request) && !unansweredRequest(request));
+        // A document subresource that never finished, on a trace whose navigation never finished:
+        // the page was waiting on it when the test's budget ran out (m135).
+        const stalled = navigationNeverFinished(item)
+            ? item.requests.filter(stalledDocumentSubresource)
+            : [];
         let room = MAX_TRACE_NOTE_REQUESTS;
         const parts = [];
+        if (lead !== undefined) {
+            parts.push(leadRequestLine(lead));
+            room -= 1;
+        }
         if (failed.length > 0) {
             const shown = failed.slice(0, room);
             room -= shown.length;
             parts.push(`failed: ${shown.map(requestLine).join('; ')}`);
         }
+        if (stalled.length > 0 && room > 0) {
+            const shown = stalled.slice(0, room);
+            room -= shown.length;
+            parts.push(`never finished: ${shown.map(requestLabel).join('; ')} — a document subresource with no ` +
+                'response, still in flight when the navigation timed out');
+        }
         if (unanswered.length > 0 && room > 0) {
             const shown = unanswered.slice(0, room);
             room -= shown.length;
@@ -775,17 +971,42 @@ export function failureTraceNote(items, target, earlierFailures = []) {
                     '`MOL_E2E_PREVIEW_PLUGIN=0 npx vite preview --host 127.0.0.1 --port 4173 --strictPort`. '
                 : '') +
             'Fix the server before the app.\n\n';
+    // A navigation that never finished WITH a subresource that never got a response, and no
+    // transport error: the page was waiting on the asset when the budget ran out. That is the host
+    // or the network serving that file, not the app's state — say it before any app-side reading
+    // (xr-molecule-flash-m135 +34:10: three deployed goto timeouts on tests passing locally in
+    // 1.2-5.6 s, one 88 KB stylesheet fetch measured at 27 s, and the note said "the cause is in
+    // the page").
+    const stalledLead = transport !== null || stalledAssets.length === 0
+        ? ''
+        : `Every failure this run traced is a \`page.goto\` that never finished, and the document's ` +
+            `own ${stalledAssets.length === 1 ? 'subresource' : 'subresources'} ${stalledAssets.join(', ')} ` +
+            `never got a response — the navigation was waiting on ${stalledAssets.length === 1 ? 'it' : 'them'} ` +
+            `when the test's budget ran out. That is the host or the network serving the asset, not the ` +
+            `app's state or a selector: re-run the same tests once, unchanged, against ${target} before ` +
+            `editing anything, and if the stall repeats measure that exact fetch ` +
+            `(\`curl -o /dev/null -w '%{time_starttransfer} %{time_total}' <url>\`) before treating it as ` +
+            `the app's.\n\n`;
     return (transportLead +
+        stalledLead +
         `The platform read the failing tests' own Playwright traces from the run against ${target} ` +
-        `(what each page sent and got: the requests that failed, the ones that got no response, and ` +
-        `its last answered ones):\n` +
+        `(what each page sent and got — first the request the failing step itself sent, then the ` +
+        `requests that failed, the ones that got no response, and its last answered ones):\n` +
         `${rows.join('\n')}${more}\n` +
         (anyFailed
             ? 'A click that changed nothing is usually one of these requests failing, not the selector: ' +
                 'read the handler this route reaches in your own source, and stop `catch`-ing the request of a ' +
                 'user action silently — log it.'
-            : 'No listed request failed — none got a 4xx/5xx or a network error — so the cause is in the ' +
-                'page, not the API: read the state the failing test waited on.') +
+            : stalledAssets.length > 0
+                ? 'No listed request failed — none got a 4xx/5xx or a network error — but the document did ' +
+                    'not finish loading because its own subresource never answered. Do not read this as a ' +
+                    'page-state bug: re-run these tests against the same URL first, and change the app only ' +
+                    'if the same navigation times out again with no stalled asset in the trace.'
+                : 'No listed request failed — none got a 4xx/5xx or a network error — so the cause is in the ' +
+                    'page, not the API. Start with the request the failing step sent (the first line of each ' +
+                    'row): if it is not the request the test meant — an unfollow sent where the test clicked ' +
+                    'follow — the state the click read was stale before it. Otherwise read the state the ' +
+                    'failing test waited on.') +
         (wrapped
             ? ' The API received a body wrapped in `data`: app-http’s `post(url, data, config)` / ' +
                 '`put(url, data, config)` / `patch(url, data, config)` take the body as their SECOND ' +

package/dist/utilities.d.ts

@@ -107,8 +107,19 @@ export declare function outputIsWithheldUntilExit(command: string): boolean;
  * this leaves its task log empty, so the log is the wrong place to look and an empty
  * log proves nothing (X1 flash-m29).
  *
+ * Which redirect counts is decided by the command's own shell structure, from the same
+ * parse every other command reader uses: a redirect written in a BACKGROUNDED statement
+ * (`… &`) or inside a `( … )` / `{ … }` group writes that process's or group's output, not
+ * the command's. The platform's own preview launch is exactly that — the preview server is
+ * started with `>/tmp/mol-preview-4173.log 2>&1 &` inside the build/serve prelude, and the
+ * suite's foreground command follows it — so a reader that took the last `>` in the whole
+ * text told a run its output went to the PREVIEW's log (X1 flash-m136 +18:31).
+ *
+ * The target comes back without its shell quotes: `> '/tmp/x.log'` is `/tmp/x.log`, and
+ * the callers resolve a relative one against the command's cwd.
+ *
  * @param command - The shell command.
- * @returns The target as written, or null (`/dev/null` and `&1`/`&2` are not files).
+ * @returns The target, or null (`/dev/null` and `&1`/`&2` are not files).
  */
 export declare function outputRedirectTarget(command: string): string | null;
 /**
@@ -825,7 +836,28 @@ export interface UniversalCause {
     count: number;
     /** The distinct spec files they live in, in the order the log named them. */
     files: string[];
+    /**
+     * The cause is that the page rendered NOTHING: every failure so far is a wait for an element
+     * the page never painted, whatever the selector asked for ({@link emptyPageCause}). One cause
+     * is failing every test even though no two failures share an error signature, so the note says
+     * so in the page's terms instead of naming one locator as the signature.
+     */
+    pageRendersNothing?: true;
+    /** The page's own uncaught error, when the run printed one. */
+    pageError?: string;
+    /**
+     * The distinct failures this cause covers, in log order — the rows a note lists for
+     * {@link pageRendersNothing}. Absent for a signature cause, whose rows are the repeating
+     * failure's own tests.
+     */
+    tests?: FailedTest[];
 }
+/**
+ * How many tests a run must have walked — with nothing passing since its first failure — before
+ * "the page renders nothing" can be its one cause. A handful of failures is a handful of bugs;
+ * a page that never painted fails every spec that reaches it, and m141's walk had 36 by +20:30.
+ */
+export declare const EMPTY_PAGE_CAUSE_TESTS = 15;
 /**
  * How many tests a connection-class cause must cover before the run is stopped even when they
  * are all in one file — see {@link universalCause}.
@@ -875,12 +907,14 @@ export declare function specFilesSelected(command: string): number | null;
  * alongside the others.
  *
  * @param log - The log so far.
- * @param found - The repeating cause {@link repeatingFailure} found in it.
+ * @param found - The repeating cause {@link repeatingFailure} found in it, or null when no two
+ *   failures share a signature (a page that renders nothing fails each spec at its own first
+ *   locator — {@link emptyPageCause} still reads that run).
  * @param command - How the run was started, when the caller knows it: its spec-file selection
  *   scales the file threshold ({@link specFilesSelected}).
  * @returns The cause's count and files, or null when the run is not failing whole.
  */
-export declare function universalCause(log: string, found: RepeatingFailure, command?: string | null): UniversalCause | null;
+export declare function universalCause(log: string, found: RepeatingFailure | null, command?: string | null): UniversalCause | null;
 /**
  * The ONE finding that ends a wait early, and the only one a note may hand a stop command over
  * for: a PROVEN cause that is failing the whole run.
@@ -909,12 +943,12 @@ export declare function universalCause(log: string, found: RepeatingFailure, com
  * needs — is the run over as a measuring instrument — and it is THE one predicate behind both
  * that decision and the note's wording, so the two cannot come to different verdicts.
  *
- * @param found - What {@link repeatingFailure} found mid-run.
+ * @param found - What {@link repeatingFailure} found mid-run, or null when no signature repeats.
  * @param universal - What {@link universalCause} found for it, if anything.
  * @returns The cause to stop the run over, or null — in which case nothing may be stopped, the
  *   wait keeps going, and the finding rides the run's result as a note.
  */
-export declare function earlyReturnCause(found: RepeatingFailure, universal: UniversalCause | null | undefined): UniversalCause | null;
+export declare function earlyReturnCause(found: RepeatingFailure | null, universal: UniversalCause | null | undefined): UniversalCause | null;
 /**
  * The titles a request excludes that a test's heading names — the ONE matcher for "is this
  * failure one the request does not count?".

package/dist/utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"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"}