@molecule/api-ai-tools 1.9.13 → 1.9.15

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-18T09:17:15.122Z
+Generated: 2026-10-18T11:04:38.283Z
 -->
 
 # @molecule/api-ai-tools
@@ -2274,22 +2274,43 @@ into the log twice, which on X1 flash-m83 (2026-10-16) made a `--reporter=list,l
 _(description truncated — read the full text in `node_modules/@molecule/api-ai-tools/dist/utilities.d.ts`.)_
 
 ```typescript
-function streamingBackgroundCommand(command: string): { command: string; changes: string[] }
+function streamingBackgroundCommand(command: string): {
+  command: string
+  changes: string[]
+  error?: string
+}
 ```
 
 - `command` — The command as the executor sent it.
 
-**Returns:** The command to run and one sentence per change made (empty when none).
+**Returns:** The command to run and one sentence per change made (empty when none), or `error` when the command starts the suite more than once.
 
-#### `isSuiteRunCommand(command)`
+#### `suiteRunStatements(command)`
 
-Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
-— rather than a build, an install or a one-off script.
+Every statement of a command that starts a whole test suite, in command order.
 
-A command that invokes a runner only to print is not one of these
+This is the ONE count of suite runs in a command: {@link isSuiteRunCommand} asks it,
+{@link streamingBackgroundCommand} refuses a command carrying more than one — each statement
+starts a whole walk of the same suite, and only the last of them is rewritten — and a re-run
+composed from a command ({@link ./suite-overlap.js} `scopedRerunCommand`) keeps only the first.
+
+A statement that invokes a runner only to print is not one of these
 ({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
 exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
 
+```typescript
+function suiteRunStatements(command: string): string[]
+```
+
+- `command` — The shell command.
+
+**Returns:** One entry per suite-running statement, as the parser read it (empty when none).
+
+#### `isSuiteRunCommand(command)`
+
+Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
+— rather than a build, an install or a one-off script.
+
 ```typescript
 function isSuiteRunCommand(command: string): boolean
 ```

package/dist/suite-overlap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suite-overlap.d.ts","sourceRoot":"","sources":["../src/suite-overlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,CAqCR;AAgHD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAMV;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQvD"}
+{"version":3,"file":"suite-overlap.d.ts","sourceRoot":"","sources":["../src/suite-overlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAoB1D;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,CA0CR;AAgHD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,SAAS,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAMV;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQvD"}

package/dist/suite-overlap.js

@@ -31,7 +31,7 @@
 import { posix } from 'node:path';
 import { commandSegments, locatedCommandSegments } from './command-position.js';
 import { commandRunsNoTests } from './no-test-run.js';
-import { shellQuote } from './utilities.js';
+import { shellQuote, suiteRunStatements } from './utilities.js';
 /**
  * A command with its heredoc bodies removed: the runs, kills and hosts it names in a file it
  * WRITES are not what the command itself does.
@@ -180,7 +180,12 @@ export function scopedRerunCommand(command, locations, excluded = [], config, cw
         .replace(/\s*--last-failed\b/g, '')
         .replace(/\s*--retries(?:[= ]\d+)?/g, '')
         .replace(/^(playwright\s+test)\b/, `$1 ${narrowed.join(' ')} --retries=0${carry}${invert}`);
-    return `${head}${scoped}${tail}`;
+    // A command that starts the suite AGAIN after this statement is a chain of walks, not a re-run:
+    // everything from the next suite runner on is dropped, so the composed command carries ONE walk.
+    // X1 xr-molecule-flash-m157 (+14:02) was handed a re-run that still carried the chain's second
+    // whole walk — 4.5 minutes measuring code it had not changed.
+    const rerunTail = suiteRunStatements(tail).length > 0 ? '' : tail;
+    return `${head}${scoped}${rerunTail}`;
 }
 /** A directory a `cd` can name literally: no `~`, no variable, no glob. */
 const LITERAL_DIR = /^[A-Za-z0-9_./+-]+$/;

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkJ9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAkOD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAsEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AAmBlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAokFxF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAkJ9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG;AAiSD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAsEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAEA,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,QAI6C,CAAA;AAmBlF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAoBpF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACxE,qBAAqB,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiCxB;AA2GD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAqlFxF"}

package/dist/tools.js

@@ -192,6 +192,58 @@ function logProgress(log) {
     const total = Number(last?.[2]);
     return last && total > 0 && done >= 0 && done <= total ? { done, total } : null;
 }
+/**
+ * Playwright's start-of-walk line, `Running 138 tests using 1 worker` — the first thing a walk
+ * prints, so a second one in one log is a second walk.
+ */
+const WALK_START = /^[ \t]*Running \d+ tests?\b/gm;
+/**
+ * One status line of a runner's closing tally — `  4 failed`, `  70 passed (4.5m)`,
+ * `  65 skipped`.
+ */
+const TALLY_STATUS = /^[ \t]*(\d+)[ \t]+(passed|failed|flaky|skipped|interrupted|timed out|did not run)\b[^\n]*/gm;
+/**
+ * A runner's CLOSING tally, the line that only prints once a walk has finished: Playwright's
+ * duration-bearing `70 passed (4.5m)`, a `1 flaky` summary, or Hurl's `Executed files:` count.
+ *
+ * The same reading as molecule-dev's `suite-proof.ts` `FINAL_TALLY_RE` (the platform's finished-run
+ * detector); this package cannot import it, so the shape is mirrored here and nowhere else.
+ */
+const FINISHED_TALLY = /\b\d+[ \t]+(?:passed|failed)[ \t]+\(\d+(?:\.\d+)?(?:ms|s|m|h)\)|^[ \t]*\d+[ \t]+flaky\b|^[ \t]*Executed files:/m;
+/**
+ * Whether a task's log holds a SECOND walk of the same suite — a finished tally followed by a
+ * fresh `Running N tests` header — and what the finished walk's tally said.
+ *
+ * A command that chained two suite runs starts the second walk the moment the first ends, and the
+ * wait used to read that log as one slow run ("slow, not stuck") for the whole second walk. X1
+ * xr-molecule-flash-m157 (+14:02) waited out 4.5 minutes of a duplicate walk that measured nothing:
+ * the first walk had already printed `4 failed / 65 skipped / 70 passed (4.5m)`.
+ *
+ * @param slice - The log slice this wait read.
+ * @returns The finished walk's tally lines, or null when the log shows one walk (or none).
+ */
+function secondSuiteWalk(slice) {
+    const header = [...slice.matchAll(WALK_START)].at(-1);
+    if (!header || header.index === undefined)
+        return null;
+    const finished = FINISHED_TALLY.exec(slice);
+    // One walk prints its header FIRST and its tally last, so a tally before the last header is
+    // another walk's. The slice repeats what it greps and then the log's own tail, so the same
+    // tally can appear twice; one line per status, taken at its last position, keeps it once.
+    if (!finished || finished.index === undefined || finished.index > header.index)
+        return null;
+    const seen = new Map();
+    for (const match of slice.matchAll(TALLY_STATUS)) {
+        if (match.index === undefined || match.index >= header.index)
+            continue;
+        seen.set(match[2] ?? '', { at: match.index, text: match[0].trim().replace(/\s+/g, ' ') });
+    }
+    const tally = [...seen.values()]
+        .sort((a, b) => a.at - b.at)
+        .map((v) => v.text)
+        .join(' / ');
+    return { tally: tally || 'its closing tally' };
+}
 /**
  * What a wait knows about the command BESIDES "it has not exited": how long it
  * has been running, whether its output is still growing, how far its own log
@@ -232,11 +284,17 @@ function waitProgressClauses(o) {
             ? `it has been running at least ${durationText(o.waitedMs)}`
             : `it has been running ${durationText(sinceStart)}`,
     ];
-    if (o.stillWriting)
+    // A log that already finished one walk and started another says so instead of "slow, not
+    // stuck": the growth is the SECOND walk printing, and its counter is not this run's progress.
+    const secondWalk = secondSuiteWalk(o.slice);
+    if (o.stillWriting && !secondWalk)
         clauses.push(`its output is still growing (${o.bytes} bytes) — slow, not stuck`);
-    else if (o.bytes !== null)
+    else if (o.bytes !== null && !secondWalk)
         clauses.push(`its log has not grown during this wait (${o.bytes} bytes)`);
-    const counter = logProgress(o.slice);
+    if (secondWalk)
+        clauses.push(`the first walk in this command has finished (${secondWalk.tally}); the command started a ` +
+            'SECOND walk of the same suite — stop it (it measures nothing new) and read the first tally');
+    const counter = secondWalk ? null : logProgress(o.slice);
     if (counter) {
         clauses.push(`its log is at ${counter.done} of ${counter.total}`);
         // The rate is the task's own elapsed time, never this call's wait: with no
@@ -2289,6 +2347,11 @@ export function buildTools(backend, config) {
                     // Keep the log growing while it runs (see streamingBackgroundCommand):
                     // an empty log is what wait_for_task reads as stuck.
                     const streaming = streamingBackgroundCommand(command);
+                    // A command that starts the suite more than once is refused here, before anything is
+                    // written or launched: each walk measures the same code, and only the last is rewritten
+                    // (X1 xr-molecule-flash-m157 +14:02 — two whole walks chained with `;`).
+                    if (streaming.error)
+                        return { error: streaming.error };
                     // …and the trace flag this tool added (above), which the streaming rewrite never saw:
                     // its changes are what this branch reports the run's own settings in.
                     if (traced.change)
@@ -2859,6 +2922,14 @@ export function buildTools(backend, config) {
                 // instruction — and not on a finished run's result, where `failureCausesNote` reads the
                 // whole log instead of the 40 KB tail a mid-run look is given.
                 const midRun = midRunNote ? ` ${midRunNote}` : '';
+                // A log that already finished one walk and started a second is not a run to keep waiting
+                // on: the first walk's tally is the measurement and the second only repeats it, so the
+                // advice below hands over the stop instead of "keep waiting" (m157 +14:02).
+                const secondWalk = secondSuiteWalk(soFar) !== null;
+                const stopInstead = secondWalk
+                    ? ` Stop it (\`exec_command: ${await taskStopCommand(backend, taskId)}\`) and read the ` +
+                        `first walk's tally in ${log} — the second walk measures nothing new.`
+                    : null;
                 if (stillWriting && waitedBefore + waitedMs >= stuckAfterMs()) {
                     waitedByTask.set(taskId, 0);
                     return {
@@ -2866,8 +2937,11 @@ export function buildTools(backend, config) {
                         status: 'running',
                         waitedMs,
                         ...sliceField,
-                        note: `${progress} Call wait_for_task again to keep waiting — it returns the moment the ` +
-                            `command ends and reports the failures as they appear.${midRun}`,
+                        note: `${progress}` +
+                            (stopInstead ??
+                                ` Call wait_for_task again to keep waiting — it returns the moment the ` +
+                                    `command ends and reports the failures as they appear.`) +
+                            `${midRun}`,
                     };
                 }
                 if (waitedBefore + waitedMs >= stuckAfterMs()) {
@@ -2889,24 +2963,26 @@ export function buildTools(backend, config) {
                     // No "Still running after Ns" lead here either: the clauses already say
                     // how long it has been running, and the lead said it a second time in
                     // the other format (X1 flash-m87 §+47:20).
-                    note: `${progress} Call wait_for_task again to ` +
-                        `keep waiting — its result carries the log output. ` +
-                        (soFar.trim()
-                            ? `outputSoFar is the failure lines so far (up to ${RUNNING_FAILURE_LINES}) and then the end of ` +
-                                `the log, not the whole run — \`grep -n '✘' ${log} | head -40\` lists every failure, ` +
-                                `\`grep -n -A 20 '<test name>' ${log}\` reads one failure's error: this run writes ` +
-                                `each failure's own report into the log as that test fails, right under its ✘ line, ` +
-                                `not only in the summary at the end. `
-                            : `Nothing has been printed yet — \`grep -n '✘' ${log} | head -40\` lists failures as they appear. `) +
-                        // What an edit does to this run depends on what the run MEASURES: the sandbox's own
-                        // app is re-served from app/src as it is edited, so the run's result stops counting; a
-                        // run against the deployed build is untouched by a local edit, and the executor can
-                        // spend the rest of the run fixing (xr-molecule-flash-m122 +19:00: a deployed run was
-                        // told editing changes what it tests, then handed "Start fixing it now" in the same
-                        // result — it waited out 1 min 11 s of free fixing time).
-                        (started !== undefined && suiteCommandTarget(started.command) !== 'local'
-                            ? `Meanwhile fix what it has already named: this run tests the deployed build, so editing app/src or api/src now does not change what it tests — fix the causes it has already named while it walks, run nothing against the app until it ends, then deploy once.`
-                            : `Meanwhile do work that leaves the code under test alone (read the failures so far, plan the fixes): editing app/src or api/src now changes the code the run is testing, and its result no longer counts.`) +
+                    note: `${progress}` +
+                        (stopInstead ??
+                            ` Call wait_for_task again to ` +
+                                `keep waiting — its result carries the log output. ` +
+                                (soFar.trim()
+                                    ? `outputSoFar is the failure lines so far (up to ${RUNNING_FAILURE_LINES}) and then the end of ` +
+                                        `the log, not the whole run — \`grep -n '✘' ${log} | head -40\` lists every failure, ` +
+                                        `\`grep -n -A 20 '<test name>' ${log}\` reads one failure's error: this run writes ` +
+                                        `each failure's own report into the log as that test fails, right under its ✘ line, ` +
+                                        `not only in the summary at the end. `
+                                    : `Nothing has been printed yet — \`grep -n '✘' ${log} | head -40\` lists failures as they appear. `) +
+                                // What an edit does to this run depends on what the run MEASURES: the sandbox's own
+                                // app is re-served from app/src as it is edited, so the run's result stops counting; a
+                                // run against the deployed build is untouched by a local edit, and the executor can
+                                // spend the rest of the run fixing (xr-molecule-flash-m122 +19:00: a deployed run was
+                                // told editing changes what it tests, then handed "Start fixing it now" in the same
+                                // result — it waited out 1 min 11 s of free fixing time).
+                                (started !== undefined && suiteCommandTarget(started.command) !== 'local'
+                                    ? `Meanwhile fix what it has already named: this run tests the deployed build, so editing app/src or api/src now does not change what it tests — fix the causes it has already named while it walks, run nothing against the app until it ends, then deploy once.`
+                                    : `Meanwhile do work that leaves the code under test alone (read the failures so far, plan the fixes): editing app/src or api/src now changes the code the run is testing, and its result no longer counts.`)) +
                         `${midRun}`,
                 };
             }

package/dist/trace-artifacts.d.ts.map

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

package/dist/trace-artifacts.js

@@ -42,6 +42,13 @@ export const MAX_TRACED_CONSOLE = 4;
 export const MAX_TRACED_ACTIONS = 40;
 /** How much of a 4xx request's sent body (or its response body) the trace read keeps. */
 export const MAX_TRACED_BODY_CHARS = 300;
+/**
+ * How much of a websocket's frames the trace read keeps. Longer than {@link MAX_TRACED_BODY_CHARS}
+ * because a frame read back to its own message still has the message, the module id and the
+ * location to carry — Vite's transform error alone is a sentence longer than the plain body cap,
+ * and the note prints its first 120–200 characters anyway (xr-molecule-flash-m157).
+ */
+const MAX_TRACED_WEBSOCKET_CHARS = 600;
 /** How many tests the note in a run's result names. */
 export const MAX_TRACE_NOTE_TESTS = 5;
 /** How many requests the note names per test. */
@@ -97,6 +104,7 @@ const MAX_NOTE = ${MAX_TRACE_NOTE_REQUESTS}
 const MAX_CONSOLE = ${MAX_TRACED_CONSOLE}
 const MAX_ACTIONS = ${MAX_TRACED_ACTIONS}
 const MAX_BODY = ${MAX_TRACED_BODY_CHARS}
+const MAX_WS = ${MAX_TRACED_WEBSOCKET_CHARS}
 const MAX_URL = 200
 // A console line that is not an error but still has to reach the note (m148): one a molecule
 // package wrote — it names the package, the \`[molecule/…]\` prefix, or the \`[scope]\` prefix
@@ -199,6 +207,51 @@ function bodyText(buf, entries, value, max) {
   return text.indexOf('\\u0000') === -1 ? text : ''
 }
 
+// A websocket's content is a JSONL stream of frames (\`{type, time, opcode, data}\`), and the data
+// is the page's own message. The envelope is ~35 characters on every frame, so cutting the raw
+// stream lands inside it and never reaches the text that names a cause: xr-molecule-flash-m157's
+// Vite HMR error frame was \`{"type":"receive","time":…,"opcode":1,"data":"{\\"type\\":\\"error\\",
+// \\"err\\":{\\"message\\":\\"Cannot import non-asset file /styles.css which is inside /public …\` and
+// every note stopped at \`{"type":"error","err":{"message":"Cannot…\`. Read the frames and print
+// what they carry — a Vite error's message, id and loc, or the JSON a frame sends — so the cut
+// lands in the message itself.
+function websocketText(raw) {
+  const errors = []
+  const others = []
+  for (const line of String(raw).split('\\n')) {
+    if (!line.trim()) continue
+    let frame
+    try { frame = JSON.parse(line) } catch (e) { continue }
+    if (!frame || typeof frame.data !== 'string') continue
+    let data = frame.data
+    try { data = JSON.parse(frame.data) } catch (e) { /* a text frame: print the data as it is */ }
+    const err = data && typeof data === 'object' && data.type === 'error' ? data.err : null
+    if (err && typeof err.message === 'string') {
+      let text = 'vite error: ' + err.message
+      if (err.id !== undefined && err.id !== null && err.id !== '')
+        text += ' (id: ' + String(err.id) + ')'
+      const loc = err.loc
+      if (loc && typeof loc === 'object') {
+        const file = typeof loc.file === 'string' && loc.file ? loc.file : String(err.id || '')
+        text += ' (loc: ' + file +
+          (typeof loc.line === 'number' ? ':' + loc.line + ':' + (typeof loc.column === 'number' ? loc.column : 0) : '') +
+          ')'
+      } else if (typeof loc === 'string' && loc) text += ' (loc: ' + loc + ')'
+      errors.push(text)
+    } else if (typeof data === 'string') others.push(data)
+    else others.push(JSON.stringify(data))
+  }
+  return errors.concat(others).join(' ')
+}
+
+// What a request got back, as the note reads it: a websocket's frames are read as the messages
+// they carry (m157), every other request's body as stored.
+function gotText(buf, entries, r) {
+  if (r.type !== 'websocket') return bodyText(buf, entries, r.content, MAX_BODY)
+  const raw = bodyText(buf, entries, r.content, 8000)
+  return (websocketText(raw) || raw).slice(0, MAX_WS)
+}
+
 let origin = ''
 function pathOf(url) {
   try {
@@ -431,7 +484,7 @@ for (const one of found.slice(0, MAX_TRACES)) {
   for (const i of actionIndexes) {
     const r = requests[i]
     const sent = bodyText(buf, entries, r.postData, MAX_BODY)
-    const got = bodyText(buf, entries, r.content, MAX_BODY)
+    const got = gotText(buf, entries, r)
     if (sent) r.sent = sent
     if (got) r.got = got
   }
@@ -439,7 +492,7 @@ for (const one of found.slice(0, MAX_TRACES)) {
     if (r.status < 400 || r.status >= 500) continue
     if (/^https?:/i.test(r.path)) continue
     const sent = bodyText(buf, entries, r.postData, MAX_BODY)
-    const got = bodyText(buf, entries, r.content, MAX_BODY)
+    const got = gotText(buf, entries, r)
     if (sent) r.sent = sent
     if (got) r.got = got
   }
@@ -509,7 +562,7 @@ for (const one of found.slice(0, MAX_TRACES)) {
     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)
+      const got = gotText(buf, entries, r)
       lead = wire(r)
       if (sent) lead.sent = sent
       if (got) lead.got = got
@@ -1178,19 +1231,36 @@ function sameOriginPath(request) {
  * the request carried no `Authorization` header at all and the app's hand-rolled session store
  * never handed its token to the shared client.
  *
+ * xr-molecule-flash-m156 (+16:15): the same 401 shape after a reload, and the page's own console
+ * named the cause — `@molecule/app-http` logged `no client is bonded`. The auth setup ran before
+ * the HTTP setup and kept the fallback client, so the restored token landed on a client nothing
+ * sent through. When the trace carries that line, the no-header sentence names the ordering fix
+ * instead of leaving the run to re-derive it.
+ *
  * The trace cannot name the file that made the call: a real HAR entry carries the request, response,
  * `_resourceType`, `_monotonicTime` and a frame ref, but no initiator stack. So the sentence names
  * the shared client and the auth bond instead of guessing a file.
  *
  * @param request - The refused request, a 401 or 403 on the app's own origin.
+ * @param unbondedClient - Whether the traced page logged `no client is bonded`, which explains a
+ *   request that carried no `Authorization` header.
  * @returns The sentence the note appends.
  */
-function authRefusalSentence(request) {
+function authRefusalSentence(request, unbondedClient = false) {
     const label = requestLabel(request);
     // The header's scheme, when it parsed; presence alone is still the server's half of the wire.
     const carried = request.authorization !== undefined
         ? `with \`Authorization: ${request.authorization} …\``
         : 'with an `Authorization` header';
+    // The console line names the mechanism the no-header branch otherwise has to guess at:
+    // `getClient()` ran before `setupHttpDefault()` and the token was mirrored into the
+    // client that later setup replaced (xr-molecule-flash-m156).
+    const unbonded = unbondedClient
+        ? ' The page logged `no client is bonded` — something called `getClient()` from ' +
+            '`@molecule/app-http` before `setupHttpDefault()` ran and kept that fallback client; ' +
+            'in `app/src/bonds/index.ts` call `setupHttpDefault()` before `setupAuthDefault()`, ' +
+            'and read the client per request instead of capturing it at setup.'
+        : '';
     if (request.status === 403) {
         return request.sentAuthorization === true
             ? `The browser sent \`${label}\` ${carried} and the API answered 403 — the token was ` +
@@ -1200,7 +1270,8 @@ function authRefusalSentence(request) {
                 '`Authorization` header, so either the client did not attach the token (check that the ' +
                 'request goes through the app’s HTTP client that the auth bond configures, and that the ' +
                 'token is stored where the client reads it) or the route refuses this user: read the ' +
-                'route’s role/permission check in your own source.';
+                'route’s role/permission check in your own source.' +
+                unbonded;
     }
     if (request.sentAuthorization === true) {
         return (`The browser sent \`${label}\` ${carried} and the API refused it: the token was sent and ` +
@@ -1218,7 +1289,8 @@ function authRefusalSentence(request) {
             ? 'The request did carry a `Cookie` header, so if this app signs in with a session cookie ' +
                 'that is the credential the server did not accept. '
             : '') +
-        'The API handler is not the problem.');
+        'The API handler is not the problem.' +
+        unbonded);
 }
 /**
  * The note's credential-refusal advice, one sentence per distinct shape — at most two.
@@ -1234,23 +1306,67 @@ function authRefusalSentence(request) {
 function authRefusalAdvice(items) {
     const sentences = [];
     const seen = new Set();
+    // A page that logged `no client is bonded` explains every request it sent without a
+    // token, so the advice names that mechanism once for the run
+    // (xr-molecule-flash-m156).
+    const unbondedClient = items.some((item) => item.console.some((line) => line.includes('no client is bonded')));
     for (const item of items) {
         for (const request of item.requests) {
             if (request.status !== 401 && request.status !== 403)
                 continue;
             if (sameOriginPath(request) === null)
                 continue;
+            // A 4xx on the logout endpoint is the shape the row itself answers: the auth client
+            // ignores it and clears the session, and the page owes the navigation (m156).
+            if (isLogoutRequest(request))
+                continue;
             const key = `${request.status} ${request.sentAuthorization ? (request.authorization ?? 'header') : 'none'} ${request.sentCookie ? 'cookie' : ''}`;
             if (seen.has(key))
                 continue;
             seen.add(key);
-            sentences.push(authRefusalSentence(request));
+            sentences.push(authRefusalSentence(request, unbondedClient));
             if (sentences.length === 2)
                 return ` ${sentences.join(' ')}`;
         }
     }
     return sentences.length === 0 ? '' : ` ${sentences.join(' ')}`;
 }
+/**
+ * Whether a request went to an auth client's logout endpoint. The client's default
+ * `logoutEndpoint` is `/users/logout` (`@molecule/app-auth`), and a project may name its own
+ * (`/auth/logout`), so the last segment is what identifies it — never a literal path.
+ *
+ * @param request - One request a trace recorded.
+ * @returns True for a POST to a path ending in `/logout`.
+ */
+function isLogoutRequest(request) {
+    if (request.method !== 'POST')
+        return false;
+    return /\/(?:users\/)?logout$/i.test(requestPath(request));
+}
+/**
+ * The sentence a 4xx on the auth client's logout endpoint owes when the page then stayed put.
+ *
+ * `@molecule/app-auth`'s `logout()` calls the endpoint inside a `.catch` and clears the session in
+ * `finally` (`packages/app/core/auth/src/client.ts`): a 401 there is EXPECTED on a sign-out and is
+ * not the failure. What the test waits for is the URL moving, which the page has to do itself.
+ * xr-molecule-flash-m156 (+24:02 → +33:52) read `POST /api/users/logout → 401` as a broken
+ * endpoint, added a backend logout route, and paid a re-run and a redeploy — while the real cause
+ * was the `navigate('/')` the refactor had dropped.
+ *
+ * @param request - The 4xx logout request.
+ * @param pageUrl - The URL the page stayed at, when the trace recorded one.
+ * @returns The sentence the note appends to the row.
+ */
+function logoutIgnoredSentence(request, pageUrl) {
+    const where = pageUrl === undefined ? 'The page' : `\`${pageUrl}\``;
+    return (`The ${request.status} on \`${requestLabel(request)}\` is ignored by the auth client — ` +
+        '`logout()` catches that call and clears the session in `finally` (`@molecule/app-auth`), so ' +
+        'the request is not what broke the test and the API is not the fix; do not add or change a ' +
+        `logout route. ${where} stayed on the same URL: the page has to navigate itself after ` +
+        "`logout()` (call `navigate('/')`, or the route the suite waits for) in the handler that " +
+        'signs out.');
+}
 /**
  * The API path prefixes the traced requests themselves show.
  *
@@ -1452,8 +1568,15 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
         : '';
     // A credential refusal (401/403 on the app's own API) is not the handler's answer: the trace's
     // own `Authorization` record says whether the CLIENT attached the token at all (m148 +29:18).
-    const authRefusals = failedRequests.filter((request) => sameOriginPath(request) !== null && (request.status === 401 || request.status === 403));
+    const authRefusals = failedRequests.filter((request) => sameOriginPath(request) !== null &&
+        (request.status === 401 || request.status === 403) &&
+        // A 4xx on the logout endpoint is not a credential refusal to diagnose: the auth client
+        // ignores it and clears the session anyway, and the row says so itself (m156).
+        !isLogoutRequest(request));
     const everyFailureAuth = failedRequests.length > 0 && authRefusals.length === failedRequests.length;
+    // Every recorded failure is the logout endpoint answering 4xx: the row's own sentence explains
+    // it, and neither the handler lead nor the credential reading applies (m156 +24:02).
+    const onlyLogoutFailures = failedRequests.length > 0 && failedRequests.every((request) => isLogoutRequest(request));
     const authAdvice = authRefusalAdvice(traced);
     // The stalled-navigation reading, per traced test: non-null only when the RUNNER says this
     // test's failing operation is a navigation and a document subresource still pending at the end
@@ -1524,6 +1647,19 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
                     ? `the page then navigated to ${step.pageAfter}`
                     : `the page stayed at ${step.pageAfter}`);
             }
+            // A 4xx on the logout endpoint with the page unmoved is not a backend failure: the auth
+            // client swallows the call and clears the session, and the URL can only move if the page
+            // navigates itself (xr-molecule-flash-m156 +24:02: the refactor dropped `navigate('/')` and
+            // the run went and added a logout route instead).
+            const stepLast = stepRequests.length > 0 ? stepRequests[stepRequests.length - 1] : undefined;
+            if (stepLast !== undefined &&
+                stepLast.status >= 400 &&
+                stepLast.status < 500 &&
+                isLogoutRequest(stepLast) &&
+                step.pageBefore !== undefined &&
+                step.pageAfter !== undefined &&
+                step.pageBefore === step.pageAfter)
+                parts.push(logoutIgnoredSentence(stepLast, step.pageAfter));
         }
         else if (lead !== undefined) {
             parts.push(leadRequestLine(lead));
@@ -1626,14 +1762,19 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
         (anyFailed
             ? everyFailureLacksPrefix
                 ? ''
-                : everyFailureAuth
-                    ? // Every failure was a credential refusal: the handler is not the problem, and the
-                        // auth advice already names what is (m148 was sent to the handler six walks running).
-                        authAdvice
-                    : '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.' +
-                        authAdvice
+                : onlyLogoutFailures
+                    ? // The rows already say it: a 4xx on the logout endpoint is ignored by the auth client
+                        // and the page's own navigation is the missing step. The handler lead would send the
+                        // run at the backend (m156 +33:52 added a logout route).
+                        ''
+                    : everyFailureAuth
+                        ? // Every failure was a credential refusal: the handler is not the problem, and the
+                            // auth advice already names what is (m148 was sent to the handler six walks running).
+                            authAdvice
+                        : '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.' +
+                            authAdvice
             : anyStalled
                 ? report.productionBuildAdvised
                     ? 'No listed request failed — none got a 4xx/5xx or a network error — but a navigation ' +

package/dist/utilities.d.ts

@@ -174,22 +174,45 @@ export declare const PLAYWRIGHT_FAILURES_INLINE_ENV = "PLAYWRIGHT_LIST_PRINT_FAI
  * something: `npx playwright test --list` takes two seconds and writes nothing per test, so
  * neither reporter nor `--retries=0` is added to it ({@link isPlaywrightRunCommand}).
  *
+ * A command that starts the suite MORE THAN ONCE is not launched at all: every run it carries is
+ * a whole walk of the same suite against the same app, and only the last step is rewritten, so the
+ * earlier walks run unmeasured for nothing. X1 xr-molecule-flash-m157 (+14:02) chained two whole
+ * walks of one 138-test suite with `;` — 4.5 minutes each — and the second measured nothing the
+ * first had not. The platform already refuses a second CONCURRENT run against one app; this is the
+ * same hazard inside one command ({@link suiteRunStatements}). `error` then carries the refusal,
+ * naming each suite step and the ONE command to send instead (the last suite step, rewritten as
+ * this function rewrites a run), and nothing is launched.
+ *
  * @param command - The command as the executor sent it.
- * @returns The command to run and one sentence per change made (empty when none).
+ * @returns The command to run and one sentence per change made (empty when none), or `error` when
+ *   the command starts the suite more than once.
  */
 export declare function streamingBackgroundCommand(command: string): {
     command: string;
     changes: string[];
+    error?: string;
 };
 /**
- * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
- * — rather than a build, an install or a one-off script.
+ * Every statement of a command that starts a whole test suite, in command order.
  *
- * A command that invokes a runner only to print is not one of these
+ * This is the ONE count of suite runs in a command: {@link isSuiteRunCommand} asks it,
+ * {@link streamingBackgroundCommand} refuses a command carrying more than one — each statement
+ * starts a whole walk of the same suite, and only the last of them is rewritten — and a re-run
+ * composed from a command ({@link ./suite-overlap.js} `scopedRerunCommand`) keeps only the first.
+ *
+ * A statement that invokes a runner only to print is not one of these
  * ({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
  * exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
  *
  * @param command - The shell command.
+ * @returns One entry per suite-running statement, as the parser read it (empty when none).
+ */
+export declare function suiteRunStatements(command: string): string[];
+/**
+ * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
+ * — rather than a build, an install or a one-off script.
+ *
+ * @param command - The shell command.
  * @returns True when the command starts one of those runners.
  */
 export declare function isSuiteRunCommand(command: string): boolean;

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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"}

package/dist/utilities.js

@@ -388,8 +388,18 @@ export const PLAYWRIGHT_FAILURES_INLINE_ENV = 'PLAYWRIGHT_LIST_PRINT_FAILURES_IN
  * something: `npx playwright test --list` takes two seconds and writes nothing per test, so
  * neither reporter nor `--retries=0` is added to it ({@link isPlaywrightRunCommand}).
  *
+ * A command that starts the suite MORE THAN ONCE is not launched at all: every run it carries is
+ * a whole walk of the same suite against the same app, and only the last step is rewritten, so the
+ * earlier walks run unmeasured for nothing. X1 xr-molecule-flash-m157 (+14:02) chained two whole
+ * walks of one 138-test suite with `;` — 4.5 minutes each — and the second measured nothing the
+ * first had not. The platform already refuses a second CONCURRENT run against one app; this is the
+ * same hazard inside one command ({@link suiteRunStatements}). `error` then carries the refusal,
+ * naming each suite step and the ONE command to send instead (the last suite step, rewritten as
+ * this function rewrites a run), and nothing is launched.
+ *
  * @param command - The command as the executor sent it.
- * @returns The command to run and one sentence per change made (empty when none).
+ * @returns The command to run and one sentence per change made (empty when none), or `error` when
+ *   the command starts the suite more than once.
  */
 export function streamingBackgroundCommand(command) {
     // A command that runs no test is not a run to keep a growing log for: nothing about it is
@@ -442,6 +452,30 @@ export function streamingBackgroundCommand(command) {
     // options are parsed and placed against this text, while the closer is kept in the command.
     const lastStep = rawLastStep.replace(/[\s)}]+$/, '');
     const stepStart = rawLastStep === '' ? out.length : Math.max(0, out.lastIndexOf(rawLastStep));
+    // A command that starts the suite more than once is not launched: each statement is a whole walk
+    // of the same suite against the same app, only the last of them is rewritten, and the earlier
+    // ones measure nothing the first did. X1 xr-molecule-flash-m157 (+14:02) chained two whole walks
+    // of one 138-test suite with `;` (4.5 minutes each); the platform already refuses a second
+    // CONCURRENT run against one app, and this is the same hazard inside one command.
+    const suiteSteps = suiteRunStatements(out);
+    if (suiteSteps.length > 1) {
+        // The ONE run to send instead: the last step that runs the suite, rewritten exactly as this
+        // function rewrites a run (its own count is one — guarded, so this cannot recurse).
+        const lastSuitePart = [...parts]
+            .reverse()
+            .map((p) => p.trim())
+            .find((p) => isSuiteRunCommand(p));
+        const single = lastSuitePart && suiteRunStatements(lastSuitePart).length === 1
+            ? streamingBackgroundCommand(lastSuitePart).command
+            : (lastSuitePart ?? '');
+        return {
+            command: out,
+            changes: [],
+            error: `This command runs the suite ${suiteSteps.length === 2 ? 'twice' : `${suiteSteps.length} times`} ` +
+                `(${suiteSteps.map((s, i) => `step ${i + 1}: \`${s}\``).join(', ')}). One walk is the ` +
+                `measurement; run exactly one: \`${single}\``,
+        };
+    }
     // The last step runs Playwright — whether or not anything is piped from it. Keying this on
     // "nothing is piped out of the last step" withheld the reporter, the inline-failure switch and
     // `--retries=0` from exactly the runs whose output was filtered (xr-molecule-flash-m101
@@ -478,12 +512,18 @@ export function streamingBackgroundCommand(command) {
     };
     // A diagnosis or a re-run (capped, last-failed, grepped, or named files) walks each failure
     // once: the suite's own `retries` doubled every failure of X1 flash-m71's first whole run,
-    // which had dropped the `--retries=0` it used one command earlier. The uncapped proof run
-    // keeps the suite's retries — including the `--max-failures=0` the platform's own note asks
-    // for on it (xr-molecule-flash-m89). Which runs those are is {@link isDiagnosisRun}'s answer
-    // and nobody else's: the platform's notes ask the same function, so a run cannot be a
-    // diagnosis to one of them and the whole suite to the other.
+    // which had dropped the `--retries=0` it used one command earlier. A whole run whose TARGET is
+    // local — its env names `localhost`/`127.0.0.1`/`0.0.0.0`, or names no URL at all, as the
+    // wrapper config's default does — is not the proof run either and walks them once too:
+    // xr-molecule-flash-m155 (+11:34) spent 10 minutes on its first local whole run, and the
+    // suite's `retries: 1` walked each of its 68 failures a second time (0 flaky) for nothing.
+    // The suite's retries are kept only for a run that names a non-local URL — the deployed proof
+    // (xr-molecule-flash-m89), where they absorb a network blip. Which runs are diagnoses is
+    // {@link isDiagnosisRun}'s answer and nobody else's: the platform's notes ask the same
+    // function, so a run cannot be a diagnosis to one of them and the whole suite to the other.
+    // Which targets are local is {@link suiteCommandTarget}'s answer.
     const diagnosis = isDiagnosisRun(lastStep);
+    const localTarget = suiteCommandTarget(lastStep) === 'local';
     // The last step's reporters: one printer, and it is `list`. Every branch below only ever moves
     // the command TO that shape — a reporter set is never left with two printers in it.
     const reporters = finalPlaywrightRun ? lastReporterFlag(lastStep) : null;
@@ -549,9 +589,9 @@ export function streamingBackgroundCommand(command) {
             'summary at the end — so a run that is still walking already says what its failures are, ' +
             'and you need not wait for it to end to start on them.');
     }
-    if (finalPlaywrightRun && diagnosis && !/--retries\b/.test(lastStep)) {
+    if (finalPlaywrightRun && (diagnosis || localTarget) && !/--retries\b/.test(lastStep)) {
         if (addToRun('--retries=0'))
-            changes.push('Added `--retries=0`: a diagnosis or re-run walks each failure once; keep the suite’s retries for the proof run.');
+            changes.push('Added `--retries=0`: a local run walks each failure once; the suite’s retries apply on the deployed proof run.');
     }
     return { command: out, changes };
 }
@@ -575,20 +615,39 @@ const SUITE_RUN_COMMANDS = [
     /^hurl\s+[^|\n]*(?:--test|\.hurl)/,
 ];
 /**
- * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
- * — rather than a build, an install or a one-off script.
+ * Every statement of a command that starts a whole test suite, in command order.
+ *
+ * This is the ONE count of suite runs in a command: {@link isSuiteRunCommand} asks it,
+ * {@link streamingBackgroundCommand} refuses a command carrying more than one — each statement
+ * starts a whole walk of the same suite, and only the last of them is rewritten — and a re-run
+ * composed from a command ({@link ./suite-overlap.js} `scopedRerunCommand`) keeps only the first.
  *
- * A command that invokes a runner only to print is not one of these
+ * A statement that invokes a runner only to print is not one of these
  * ({@link commandRunsNoTests}): `npx playwright test --list` prints the tests it would run and
  * exits, and `npx playwright install`, `vitest list` and `hurl --help` start no test either.
  *
  * @param command - The shell command.
+ * @returns One entry per suite-running statement, as the parser read it (empty when none).
+ */
+export function suiteRunStatements(command) {
+    if (commandRunsNoTests(command))
+        return [];
+    return commandSegments(command)
+        .filter((segment) => SUITE_RUN_COMMANDS.some((re) => re.test(segment.text)) &&
+        // A statement that only PRINTS (`playwright test --list`) is not a walk, so
+        // `npx playwright test --list && npx playwright test` is one run, not two.
+        !commandRunsNoTests(segment.text))
+        .map((segment) => segment.text);
+}
+/**
+ * Whether a command runs a whole test suite — a Playwright, Vitest or Hurl run
+ * — rather than a build, an install or a one-off script.
+ *
+ * @param command - The shell command.
  * @returns True when the command starts one of those runners.
  */
 export function isSuiteRunCommand(command) {
-    if (commandRunsNoTests(command))
-        return false;
-    return commandSegments(command).some((segment) => SUITE_RUN_COMMANDS.some((re) => re.test(segment.text)));
+    return suiteRunStatements(command).length > 0;
 }
 /**
  * The command with the `timeout <N>` wrapper lifted off the statement that runs the suite, and the
@@ -1953,6 +2012,23 @@ function largestGroup(groups) {
 function testKey(t) {
     return `${t.where}|${t.title}`;
 }
+/**
+ * One test's identity with the runner's retry marker taken off: `… a.spec.ts:32 › does x
+ * (retry #1)` is the same test as `… a.spec.ts:32 › does x`.
+ *
+ * A retried failure prints twice in a `list` log — its first attempt, then the same test with
+ * `(retry #1)` after the title — while its failure block names it without the marker. Keyed
+ * literally, the retry row is a test no cause claims, so it fell through to the duration arm and
+ * was listed as a "shared duration" cause beside the proven cause it repeated: on
+ * xr-molecule-flash-m155 (+21:50) every retry row of the run became one of six extra causes
+ * duplicating the causes above them.
+ *
+ * @param t - A failed test, as a result line or a failure block spelled it.
+ * @returns The key a test's retry row shares with its failure block.
+ */
+function retrylessTestKey(t) {
+    return `${t.where}|${t.title.replace(/\s*\(retry #\d+\)$/, '')}`;
+}
 /**
  * The same tests with each one kept once, in first-seen order.
  *
@@ -2600,6 +2676,10 @@ function groupFailures(log, excluded, pageErrors = []) {
     const listed = failedTests(text);
     named.push(...listed);
     const claimed = new Set(causes.flatMap((c) => c.tests.map(testKey)));
+    // The causes above as a test can recognise itself: a retried failure's second row carries the
+    // runner's `(retry #1)` marker, its failure block does not, and comparing the literal keys
+    // read the same test as an unclaimed one (xr-molecule-flash-m155 +21:50).
+    const proven = new Set(causes.flatMap((c) => c.tests.map(retrylessTestKey)));
     const unclaimed = distinctTests(listed).filter((t) => t.seconds !== null &&
         !claimed.has(testKey(t)) &&
         // A flaky test's `✘` row is its first attempt; its `✓` retry follows it in the same log,
@@ -2615,14 +2695,21 @@ function groupFailures(log, excluded, pageErrors = []) {
         else
             byDuration.push({ seconds: t.seconds, tests: [t] });
     }
-    for (const g of byDuration)
+    for (const g of byDuration) {
+        // A duration band is a LEAD, not a cause: a test already carrying a proven cause above is
+        // not named a second time here, and a band whose every member is one is not a cause at all —
+        // it reads as one more thing to fix. m155's retry rows made six such bands.
+        const tests = g.tests.filter((t) => !proven.has(retrylessTestKey(t)));
+        if (tests.length === 0)
+            continue;
         causes.push({
             message: null,
             seconds: g.seconds,
-            tests: g.tests,
+            tests,
             evidence: [],
             kind: 'assertion',
         });
+    }
     const ignored = distinctTests(named).filter((t) => matchingExcludedTitles(t.title, excluded).length > 0);
     return {
         causes: causes.sort((a, b) => b.tests.length - a.tests.length),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-tools",
-  "version": "1.9.13",
+  "version": "1.9.15",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",