fix: address Copilot review round 4

The comment stripper had a real hole: the line-comment regex was anchored, so it
only removed `//` at the start of a line and a call disabled after code —
`const disabled = true; // configure({ asyncUtilTimeout: 1000 });` — survived it
and the guard passed with no effective configuration. Replaced with a scanner,
because a regex gets this wrong in both directions: it has to strip a comment
that follows code, and it must NOT treat the `//` inside a string literal as one,
which would silently truncate any line holding a URL. Quote tracking (with
escapes) is the only way to have both. Three regression tests.

Two documentation claims were also wrong. The guard header and quality-gate.md
cited #2278 and #2250 as instances of a budget nobody chose; they were not —
#2278 was a missing condition wait around a geometry read and #2250 a real race
in a test's own timing, both fixed by making the test wait for the right thing.
Presenting a race fix as evidence for a larger ceiling argues against #1596,
which this guard exists to uphold. Only the budget and poll-ceiling cases are
cited now, and both files say explicitly why those two are excluded.

And browser-timeouts.mjs overstated its own behavior twice: `bestEffort` can
spend its full budget on an otherwise passing smoke precisely because its expiry
is caught, and raising any budget does delay the report when the thing waited on
never arrives. The diagnostics improve the eventual message; they do not make
the wait shorter. Both now stated plainly, so the header is something to weigh a
change against rather than a reassurance.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PsmUAZ6aLUAFqenjJKSSRp
Signed-off-by: cliffhall <cliff@futurescale.com>
This commit is contained in:
cliffhall 2026-09-12 14:21:54 -04:00
commit 7b794de0b0

View file

@ -10,16 +10,23 @@
* has, and for the same reason: a budget nobody can find is a budget nobody
* revisits.
*
* These are generous on purpose and cost a passing run nothing. Playwright
* budgets are ceilings on a poll, not sleeps: every one of them returns the
* instant its locator condition holds. What they have to absorb is a smoke
* running against a cold `dist/` build on a machine already carrying three
* other agent sessions' gates.
* Three of the four are ceilings on a poll rather than sleeps — `ui`,
* `roundTrip` and `nested` each return the instant their locator condition
* holds, so a passing smoke pays only the time the app actually took. What they
* absorb is a smoke running against a cold `dist/` build on a machine already
* carrying other agent sessions' gates.
*
* ⚠️ Raising one of these does NOT make a smoke wait longer for a server that
* is never coming: the launcher-death race in `smoke-web-browser.mjs` and the
* `waitForStage` diagnostics in the other two are what report that, and they
* report it with a cause rather than a timeout.
* ⚠️ `bestEffort` is the exception and is not free: its expiry is caught and
* ignored, so a smoke that never reaches network idle spends the full budget on
* an otherwise **passing** run. That is why it is the smallest of the four, and
* why it should stay that way.
*
* ⚠️ Raising any of these does delay the report when the thing waited on never
* arrives — a larger budget is a longer wait before the failure. What the
* launcher-death race in `smoke-web-browser.mjs` and the `waitForStage`
* diagnostics in the other two buy is a better *eventual* message, naming a
* cause instead of a locator; they do not make the wait shorter. Weigh both
* when changing a value here.
*/
export const BROWSER_TIMEOUTS = Object.freeze({