@hominis/fireforge 0.54.0 → 0.60.0

package/dist/src/core/test-harness-crash.js

@@ -1,780 +0,0 @@
-// SPDX-License-Identifier: EUPL-1.2
-/**
- * Harness-crash classification for `fireforge test`.
- *
- * The wrapped mach harness exhibits flaky non-test failures that an exit
- * code (or a "did it print a summary" grep) cannot distinguish from real
- * test results:
- *
- *  - startup crashes from the mozlog resource monitor on macOS
- *    (`AttributeError: 'SystemResourceMonitor' object has no attribute
- *    'poll_interval'`, `host_statistics64(HOST_VM_INFO64) syscall failed`,
- *    `(ipc/mig) array not large enough`, a psutil/macOS mismatch) which
- *    abort the run before any test executes.
- *  - hangs after browser startup that die at the no-output timeout yet still
- *    emit a `Passed: 0` summary.
- *  - post-green shutdown re-entry, where a fully green run stalls on "must
- *    wait for focus" and records "Application shut down (without crashing)
- *    in the middle of a test!" as the only unexpected failure.
- *
- * Classification therefore keys on `TEST-START` presence, so summary lines
- * never count as proof that tests ran, and recognizes the crash shapes
- * above so the command layer can retry them with a bounded budget instead of
- * reporting phantom test failures (or phantom passes).
- */
-import { hasKnownTeardownNoise } from './mach-known-noise-filter.js';
-import { detectServerStartupFailure } from './test-harness-infra.js';
-import { truncateEvidence, unmarkedFailureEvidenceNote, } from './test-harness-verdict-notes.js';
-import { classifyProfileArgumentFailure } from './test-profile-files.js';
-import { formatIncompleteSuffix, formatShardsSuffix, } from './test-harness-signature.js';
-// The operator message after exhausted retries lives beside the
-// server-startup shape in `test-harness-infra.ts`.
-export { buildHarnessCrashMessage } from './test-harness-infra.js';
-// The no-output-stall triage text lives in `test-stall-triage.ts` (it is
-// operator advice, not classification) and is re-exported here so the
-// command layer keeps importing its harness diagnostics from one module.
-export { headedDisplayAsleepVerdictNote, headedNoOutputTimeoutHint } from './test-stall-triage.js';
-const TEST_START_PATTERN = /\bTEST-START\b/;
-/**
- * Structured-log execution marker (`mach xpcshell-test` mozlog output uses
- * `TEST_START`/`SUITE_END` with underscores, not the hyphenated
- * `TEST-START` the browser-chrome dispatch prints).
- */
-const STRUCTURED_TEST_START_PATTERN = /\bTEST_START\b/;
-const SUITE_END_PATTERN = /\bSUITE_END\b/;
-const GREEN_UNEXPECTED_SUMMARY_PATTERN = /\bUnexpected results:\s*0\b/;
-const NONZERO_UNEXPECTED_SUMMARY_PATTERN = /\bUnexpected results:\s*[1-9]/;
-/**
- * Execution signals emitted by the suite-specific xpcshell dispatch
- * (`mach xpcshell-test`), which does not print `TEST-START` lines the way
- * the generic `mach test` / browser-chrome dispatch does. A passing
- * single-file xpcshell run prints a result-summary block instead
- * (`TEST_END: Test PASS`, `Ran 16 checks`, `Unexpected results: 0`), so
- * keying execution purely on `TEST-START` mis-reads a green xpcshell run as
- * "no tests started".
- *
- * These markers are xpcshell-specific on purpose: the bare `Passed: 0` /
- * `Failed: 0` summary that the no-output hang shape prints is deliberately
- * not matched here, because that case must still read as `no-tests`.
- */
-const XPCSHELL_RESULT_SUMMARY_PATTERN = /\bTEST_END\b|\bRan \d+ checks?\b|\bResult summary:/i;
-const UNEXPECTED_LINE_PATTERN = /^.*\bTEST-UNEXPECTED-[A-Z-]+\b.*$/gm;
-/**
- * A `FAIL` token that is harness-shaped. Not a bare `\bFAIL\b`
- * word match: that matched any output line containing the ordinary English
- * word, so a test's own passing diagnostic could manufacture a red run (see
- * {@link realUnexpectedFailureLines}). It also matched `TEST-KNOWN-FAIL`,
- * an expected failure, and counted it as a real one.
- *
- * The `TEST-` prefix is what makes the token the harness's rather than
- * prose, and the negative lookahead is what keeps a known-fail annotation
- * out of the evidence set.
- */
-const FAIL_LINE_PATTERN = /^.*\bTEST-(?!KNOWN-FAIL\b)[A-Z-]*FAIL\b.*$/gm;
-/**
- * The three concrete shapes Gecko prints for a real assertion failure.
- * Case-sensitive and punctuation-anchored on purpose: the previous
- * `/\b(?:Assertion failure|MOZ_ASSERT|ASSERTION)\b/gim` was
- * case-insensitive, so the ordinary English word "assertion" in a passing
- * diagnostic ("If an assertion below times out, this is why") was read as
- * a failure, and the verdict then named that diagnostic as the first real
- * test failure, pointing the reader at the wrong line.
- */
-const ASSERTION_LINE_PATTERN = /^.*(?:Assertion failure:|MOZ_ASSERT\(|###!!! ASSERTION).*$/gm;
-export const SHUTDOWN_REENTRY_PATTERN = /Application shut down \(without crashing\) in the middle of a test/i;
-const FOCUS_STALL_PATTERN = /must wait for focus/i;
-const TRACEBACK_PATTERN = /Traceback \(most recent call last\)/;
-const NO_OUTPUT_TIMEOUT_PATTERN = /timed out after \d+ seconds with no output/i;
-/**
- * Crash-marker lines mozcrash / the mochitest harness print when the browser
- * process itself died. Matched against the raw output (never noise-stripped):
- * any of these proves the run was truncated by a crash, so an embedded green
- * summary is under-reporting, not a result. `Main app process: killed by
- * SIGSEGV` at the second of eight files with a `Passed: 2 / Failed: 0`
- * summary is the shape this exists to catch.
- */
-const CRASH_MARKER_PATTERNS = [
-    /Main app process: killed by SIG\w+/,
-    /\bPROCESS-CRASH\b/,
-    // The minidump-processing header shapes mozcrash emits when it walks a
-    // crash dump after the run.
-    /mozcrash.*minidump/i,
-    /Crash dump filename/i,
-    /Thread \d+ \(crashed\)/,
-];
-/**
- * Startup-traceback fingerprints from the mozlog resource monitor / psutil
- * on macOS. Each is matched per-line so the evidence line in the report is
- * the concrete failure, not the whole traceback.
- */
-// A `_DegradedReading` fallback that is not a real namedtuple duck type
-// crashes mozsystemmonitor on the fallback itself (`_build_meta` subscripts
-// the reading, `_collect` unpacks it). A startup abort with zero TEST-START
-// lines from this family is a crash, not a test failure. The `_collect
-// failed` variant is caught-and-logged, so it carries no Traceback header.
-// It gets its own zero-TEST-START check in `detectHarnessCrashSignature`
-// besides joining the traceback cluster.
-const DEGRADED_READING_CRASH_SIGNALS = [
-    /'_DegradedReading' object is not subscriptable/,
-    /'_DegradedReading' object is not iterable/,
-];
-const STARTUP_TRACEBACK_SIGNALS = [
-    /AttributeError:.*SystemResourceMonitor/,
-    /'SystemResourceMonitor' object has no attribute/,
-    /poll_interval/,
-    /host_statistics64/,
-    /HOST_VM_INFO64/,
-    /\(ipc\/mig\) array not large enough/,
-    /psutil\.[A-Za-z]*Error/,
-    // On a degraded host every collector sample is rejected, aggregation has
-    // nothing, and mozbuild's log_resource_usage dies on
-    // usage["io"].read_bytes AFTER a fully successful compile ("Error running
-    // mach" with complete artifacts). Environmental, not a build regression:
-    // the protected build retries it, since an incremental retry is cheap and
-    // the guard keeps the retry green.
-    /AttributeError: 'NoneType' object has no attribute 'read_bytes'/,
-    ...DEGRADED_READING_CRASH_SIGNALS,
-];
-function findLine(output, patterns) {
-    for (const line of output.split(/\r?\n/)) {
-        if (patterns.some((p) => p.test(line)))
-            return line.trim();
-    }
-    return undefined;
-}
-/**
- * Non-signal noise lines: the resource-monitor degrade path (FireForge's own
- * guard plus mozlog's `_collect failed`) prints warnings on runs that then
- * complete green. Without excluding them, every multi-file suite reports
- * CRASH because these lines match the startup-traceback signals even though
- * the embedded summary is fully green.
- */
-const NOISE_LINE_PATTERNS = [
-    /\bUserWarning\b/,
-    /psutil failed to run/i,
-    // `_collect failed` chatter is noise on green runs, EXCEPT the
-    // `_DegradedReading` variant: that is the crash evidence for the
-    // "object is not iterable" startup-abort signature above and must
-    // survive stripNonSignalNoise.
-    /_collect failed(?!.*_DegradedReading)/i,
-    /FireForge: host resource monitor degraded/i,
-    /warnings\.warn\(/,
-    // mozsystemmonitor's parent-side drain loop rejecting a malformed sample.
-    // mach sometimes reprints the warning text without the `UserWarning:`
-    // token, and a run that completes despite the stream must never classify
-    // as crash on it.
-    /failed to read the received data/i,
-];
-/** Matches the caught/telemetry context that marks a traceback as benign. */
-const BENIGN_TRACEBACK_CONTEXT = /telemetry|glean/i;
-/**
- * Strips non-signal noise from captured output before crash-signature
- * matching: resource-monitor degradation warnings, and traceback blocks
- * that mach caught itself (telemetry submission tracebacks are printed but
- * never abort the run). The stripped text is used only as crash evidence.
- * Classification of test results still reads the full output.
- */
-export function stripNonSignalNoise(output) {
-    const lines = output.split(/\r?\n/);
-    const kept = [];
-    for (let i = 0; i < lines.length; i += 1) {
-        const line = lines[i] ?? '';
-        if (NOISE_LINE_PATTERNS.some((p) => p.test(line)))
-            continue;
-        if (TRACEBACK_PATTERN.test(line)) {
-            // Collect the whole traceback block: the header, indented frame/code
-            // lines, and the trailing unindented exception line.
-            const block = [line];
-            let j = i + 1;
-            for (; j < lines.length; j += 1) {
-                const blockLine = lines[j] ?? '';
-                block.push(blockLine);
-                const isIndented = /^\s/.test(blockLine) || blockLine.trim().length === 0;
-                if (!isIndented)
-                    break; // unindented exception line terminates the block
-            }
-            if (BENIGN_TRACEBACK_CONTEXT.test(block.join('\n'))) {
-                i = j; // drop the whole caught-telemetry traceback block
-                continue;
-            }
-            // A real traceback stays in evidence line-by-line (minus noise lines
-            // already filtered above).
-        }
-        kept.push(line);
-    }
-    return kept.join('\n');
-}
-/**
- * True when the output carries any execution signal: the browser-chrome
- * `TEST-START` marker, the structured-log `TEST_START` marker, or the
- * suite-specific xpcshell result-summary block.
- */
-function hasExecutionSignal(output) {
-    return (TEST_START_PATTERN.test(output) ||
-        STRUCTURED_TEST_START_PATTERN.test(output) ||
-        hasXpcshellResultSummary(output));
-}
-/**
- * Finds the first crash-marker line in the RAW output (see
- * {@link CRASH_MARKER_PATTERNS}), or undefined when the run shows no
- * crash evidence. Exported for direct unit testing.
- */
-export function findCrashMarkerLine(output) {
-    return findLine(output, CRASH_MARKER_PATTERNS);
-}
-/**
- * True when the summary lines LOOK green: execution signal, `Unexpected
- * results: 0` with no non-zero count, `SUITE_END`, no real
- * `TEST-UNEXPECTED-*` lines. Blind to crash/truncation
- * evidence: {@link hasCompletedGreenSummary} layers that on top, and
- * {@link classifyHarnessRun} needs the distinction to report why a
- * green-shaped summary was rejected.
- */
-function hasGreenShapedSummary(output) {
-    return (hasExecutionSignal(output) &&
-        SUITE_END_PATTERN.test(output) &&
-        GREEN_UNEXPECTED_SUMMARY_PATTERN.test(output) &&
-        !NONZERO_UNEXPECTED_SUMMARY_PATTERN.test(output) &&
-        realUnexpectedFailureLines(output).length === 0);
-}
-/**
- * True when the output embeds a completed, green suite summary: an execution
- * signal, `Unexpected results: 0` (and no non-zero unexpected count), a
- * `SUITE_END` marker, no real `TEST-UNEXPECTED-*` lines, and no crash
- * marker. Such a run finished its suite, so any startup-traceback-shaped
- * noise in the same output is non-fatal and this vetoes
- * signature-based crash classification. Without the veto, fully green
- * sharded runs report `CRASH (N attempts)` because degradation warnings
- * match the psutil signals. A summary printed after a crash marker is not
- * "completed": it only covers the files that ran before the crash.
- * Exported for direct unit testing.
- */
-export function hasCompletedGreenSummary(output) {
-    return hasGreenShapedSummary(output) && findCrashMarkerLine(output) === undefined;
-}
-/** Basename shape of a mozbuild-manifest test implementation file. */
-export const TEST_FILE_BASENAME_PATTERN = /^(?:browser|test)_.*\.m?js$/;
-/**
- * Start/end execution markers, both log dialects: the structured mozlog
- * `TEST_START`/`TEST_END` pair and the human browser-chrome
- * `TEST-START`/`TEST-OK` pair. `TEST-UNEXPECTED-*` end shapes are
- * irrelevant here, since any such line already fails the green-summary check
- * before completeness is consulted.
- */
-export const START_MARKER_PATTERN = /\bTEST[-_]START\b[:| ]*\s*(\S+)?/;
-const END_MARKER_PATTERN = /\bTEST[-_]END\b|\bTEST-OK\b/;
-/**
- * Cross-checks run completeness against the requested test files: every
- * requested file must produce a start marker, and every started test must
- * produce an end marker (the harness emits both even for failing files).
- *
- * Ends are paired with starts positionally (last open start is closed by
- * the next end), not by filename: the xpcshell dialect's `TEST_END: Test
- * PASS` lines do not name the file. Requested paths that are not
- * test-file-shaped (directories, manifests) are skipped for the
- * never-started check. The start/end pairing scan covers them regardless.
- * Exported for direct unit testing.
- */
-export function analyzeTestCompleteness(output, requestedPaths) {
-    const startedNames = [];
-    const openTests = [];
-    for (const line of output.split(/\r?\n/)) {
-        const startMatch = START_MARKER_PATTERN.exec(line);
-        if (startMatch) {
-            const name = startMatch[1] ?? '(unnamed test)';
-            startedNames.push(name);
-            openTests.push(name);
-            continue;
-        }
-        if (END_MARKER_PATTERN.test(line)) {
-            openTests.pop();
-        }
-    }
-    const neverStarted = requestedPaths.filter((path) => {
-        const base = path.slice(path.lastIndexOf('/') + 1);
-        if (!TEST_FILE_BASENAME_PATTERN.test(base))
-            return false;
-        return !startedNames.some((name) => name.includes(base));
-    });
-    return { neverStarted, neverEnded: openTests };
-}
-/**
- * True when the captured output carries the suite-specific xpcshell
- * result-summary block, which proves tests executed even though the
- * xpcshell dispatch emits no `TEST-START` line. Used alongside
- * `TEST_START_PATTERN` so a green single-file xpcshell run is not
- * mis-classified as `no-tests`. Exported for direct unit testing.
- */
-function hasXpcshellResultSummary(output) {
-    return XPCSHELL_RESULT_SUMMARY_PATTERN.test(output);
-}
-/** Unexpected-failure lines that are not the shutdown re-entry artifact. */
-function realUnexpectedFailureLines(output) {
-    const matches = [
-        ...(output.match(UNEXPECTED_LINE_PATTERN) ?? []),
-        ...(output.match(FAIL_LINE_PATTERN) ?? []),
-        ...(output.match(ASSERTION_LINE_PATTERN) ?? []),
-    ];
-    if (NONZERO_UNEXPECTED_SUMMARY_PATTERN.test(output)) {
-        const summary = output
-            .split(/\r?\n/)
-            .find((line) => NONZERO_UNEXPECTED_SUMMARY_PATTERN.test(line));
-        if (summary)
-            matches.push(summary);
-    }
-    return [...new Set(matches.map((line) => line.trim()))].filter((line) => !SHUTDOWN_REENTRY_PATTERN.test(line));
-}
-/**
- * Non-global copies of the unexpected/assertion patterns for per-line use.
- * The `g`-flagged module patterns carry `lastIndex` state across `.test()`
- * calls and must never be reused line-by-line.
- */
-const UNEXPECTED_LINE_SINGLE = /\bTEST-UNEXPECTED-[A-Z-]+\b/;
-/**
- * Context lines the chrome/xpcshell harnesses print directly under a
- * TEST-UNEXPECTED line: `Got …` / `Expected …` / `Actual …`, Assert
- * messages, diff markers, stack-trace heads, and indented continuation
- * lines.
- */
-const FAILURE_CONTEXT_LINE_PATTERN = /^(?:\s*(?:Got\b|Expected\b|Actual\b|Assert\w*\b|Stack trace:|[-+]\s)|\s{2,}\S)/;
-/** Cap on context lines echoed under a single TEST-UNEXPECTED line. */
-const FAILURE_BLOCK_CONTEXT_LIMIT = 6;
-/**
- * Collects the first `limit` TEST-UNEXPECTED-* lines with their trailing
- * assertion/diff context, one string per block. The shutdown-reentry
- * artifact is excluded (it is harness noise, not a test result). When more
- * than `limit` blocks exist, a final `…(+N more …)` note is appended so the
- * operator knows the echo was truncated. Pure. Exported for unit tests.
- */
-export function collectUnexpectedFailureBlocks(output, limit = 5) {
-    const lines = output.split(/\r?\n/);
-    const blocks = [];
-    let skipped = 0;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i] ?? '';
-        if (!UNEXPECTED_LINE_SINGLE.test(line) || SHUTDOWN_REENTRY_PATTERN.test(line))
-            continue;
-        if (blocks.length >= limit) {
-            skipped++;
-            continue;
-        }
-        const block = [line.trim()];
-        let contextCount = 0;
-        for (let j = i + 1; j < lines.length && contextCount < FAILURE_BLOCK_CONTEXT_LIMIT; j++) {
-            const next = lines[j] ?? '';
-            if (UNEXPECTED_LINE_SINGLE.test(next))
-                break;
-            if (!FAILURE_CONTEXT_LINE_PATTERN.test(next))
-                break;
-            block.push(next.trimEnd());
-            contextCount++;
-        }
-        blocks.push(block.join('\n'));
-    }
-    if (skipped > 0) {
-        blocks.push(`…(+${skipped} more TEST-UNEXPECTED line${skipped === 1 ? '' : 's'} not shown)`);
-    }
-    return blocks;
-}
-function detectSecondaryHarnessNoise(output) {
-    const evidence = stripNonSignalNoise(output);
-    if (TRACEBACK_PATTERN.test(evidence)) {
-        const signalLine = findLine(evidence, STARTUP_TRACEBACK_SIGNALS);
-        if (signalLine) {
-            return {
-                reason: 'harness traceback also present (resource monitor/psutil)',
-                line: signalLine,
-            };
-        }
-    }
-    const timeoutLine = findLine(evidence, [NO_OUTPUT_TIMEOUT_PATTERN]);
-    if (timeoutLine) {
-        return { reason: 'harness no-output timeout also present', line: timeoutLine };
-    }
-    return undefined;
-}
-/**
- * Detects the known harness-crash shapes in captured mach output.
- * Returns undefined for anything that looks like a genuine test result.
- */
-export function detectHarnessCrashSignature(output) {
-    // Browser/app process crashes are deterministic crash evidence, not
-    // retriable environmental harness noise. Leave them to
-    // `classifyHarnessRun` so it can reject green-looking truncated summaries
-    // with the crash line plus never-started/never-ended file evidence.
-    if (findCrashMarkerLine(output) !== undefined) {
-        return undefined;
-    }
-    const hasTestStart = hasExecutionSignal(output);
-    const realFailures = realUnexpectedFailureLines(output);
-    // A completed green embedded summary vetoes signature-based crash
-    // classification outright: the suite finished, so any startup-shaped
-    // noise in the same output was non-fatal. (The post-green shutdown
-    // re-entry shape below is exempt: it is a crash verdict on
-    // an otherwise-green log, keyed on its own explicit markers.)
-    const greenSummaryVeto = hasCompletedGreenSummary(output);
-    // Startup traceback cluster (resource monitor / psutil), scanned over
-    // noise-stripped evidence so degradation warnings and caught telemetry
-    // tracebacks never count. Real test failures take precedence: a
-    // traceback printed during teardown of a genuinely failing run must not
-    // get the whole run retried.
-    const evidence = stripNonSignalNoise(output);
-    if (!greenSummaryVeto && TRACEBACK_PATTERN.test(evidence) && realFailures.length === 0) {
-        const signalLine = findLine(evidence, STARTUP_TRACEBACK_SIGNALS);
-        if (signalLine) {
-            return { reason: 'harness startup traceback (resource monitor/psutil)', line: signalLine };
-        }
-    }
-    // Post-browser-startup hang: no test ever started, the harness died at
-    // the no-output timeout. A trailing "Passed: 0" summary is part of this
-    // shape and must not be read as a result.
-    if (!hasTestStart) {
-        // Startup abort on the degraded-reading fallback family: the `_collect
-        // failed: '_DegradedReading' ...` variant is caught-and-logged (no
-        // Traceback header), so the traceback cluster above never sees it.
-        if (realFailures.length === 0) {
-            const degradedLine = findLine(evidence, DEGRADED_READING_CRASH_SIGNALS);
-            if (degradedLine) {
-                return {
-                    reason: 'degraded resource reading crashed the harness fallback (_DegradedReading)',
-                    line: degradedLine,
-                };
-            }
-        }
-        const timeoutLine = findLine(evidence, [NO_OUTPUT_TIMEOUT_PATTERN]);
-        if (timeoutLine) {
-            return { reason: 'no-output timeout before any test started', line: timeoutLine };
-        }
-        return undefined;
-    }
-    // Post-green shutdown re-entry: every unexpected line is the
-    // shutdown-mid-test artifact, the run stalled on focus, and at least one
-    // such artifact exists, on an otherwise green log.
-    const shutdownLine = findLine(output, [SHUTDOWN_REENTRY_PATTERN]);
-    if (shutdownLine && realFailures.length === 0 && FOCUS_STALL_PATTERN.test(output)) {
-        return { reason: 'post-green shutdown re-entry during harness teardown', line: shutdownLine };
-    }
-    return undefined;
-}
-/**
- * Classifies a completed harness run. The decision tree, in order:
- *
- * 1. A recognized crash signature wins regardless of exit code (the
- *    shutdown re-entry shape exits non-zero on an otherwise green run,
- *    and the hang shape can even exit zero with a `Passed: 0` summary).
- * 2. No execution signal with explicit paths requested means no test ran.
- *    A mochitest server that failed to start explains that, and is a
- *    retriable infrastructure failure (`harness-crash` with
- *    `reason=server-startup` on the verdict line). Otherwise it is
- *    `no-tests`, even when the exit code is zero. The execution signal is
- *    a `TEST-START` line (generic `mach test` / browser-chrome dispatch)
- *    or the suite-specific xpcshell result-summary block (the xpcshell
- *    dispatch prints no `TEST-START`). Bare `Passed:`/`Failed:` summary
- *    lines are still not trusted as evidence of execution.
- * 3. Exit code zero with tests started is a pass. Anything else is a
- *    test failure for the regular diagnosis chain, except a non-zero
- *    exit whose embedded summary completed green and shows no crash
- *    marker and no truncated/never-started requested file, which is a
- *    pass with a `greenSummaryOverride` note (harness noise owns the
- *    exit code). A green-shaped summary with such evidence is rejected
- *    (`greenSummaryRejected`) and fails.
- */
-export function classifyHarnessRun(exitCode, output, requestedPaths) {
-    const counts = extractSummaryCounts(output);
-    const profileFailure = classifyProfileArgumentFailure(output);
-    if (profileFailure)
-        return { ...profileFailure, ...counts };
-    const realFailures = realUnexpectedFailureLines(output);
-    const firstRealFailure = realFailures[0];
-    const failureBlocks = collectUnexpectedFailureBlocks(output);
-    const secondaryHarnessSignature = firstRealFailure !== undefined ? detectSecondaryHarnessNoise(output) : undefined;
-    // Checked before signature detection: a suite that ran clean and then died
-    // in known upstream teardown noise is a pass, not a crash. The teardown
-    // traceback matches the startup-traceback cluster, and the green-summary
-    // veto over that cluster requires a `SUITE_END` marker, which this very
-    // traceback is what prevents from printing. Without this check a
-    // substantively green suite (`Ran N checks` / `Unexpected results: 0`, no
-    // unexpected lines) reports CRASH, indistinguishable at the summary level
-    // from a red run. Every hard-evidence veto still applies: a crash marker,
-    // a non-zero unexpected count, any real TEST-UNEXPECTED line, the
-    // shutdown-re-entry shape, or a requested file that never started keeps
-    // the run failing. Only the missing shutdown marker is forgiven, and only
-    // when the recognized teardown traceback explains it.
-    const teardownOverride = evaluateGreenTeardownOverride(output, counts, realFailures, requestedPaths);
-    if (teardownOverride.accepted) {
-        return { kind: 'tests-ran-ok', note: 'harness teardown noise ignored', ...counts };
-    }
-    // A run that carried the recognized teardown noise and still failed says
-    // WHICH condition rejected the override, on the one greppable line.
-    const teardownNote = teardownOverride.rejectedBy !== undefined
-        ? `green-teardown override rejected: ${teardownOverride.rejectedBy}`
-        : undefined;
-    const withNotes = (verdict, extra) => {
-        const notes = [teardownNote, extra].filter((n) => n !== undefined);
-        return notes.length > 0 ? { ...verdict, note: notes.join('; ') } : verdict;
-    };
-    const signature = detectHarnessCrashSignature(output);
-    if (signature) {
-        return withNotes({ kind: 'harness-crash', signature, ...counts });
-    }
-    const ranTests = hasExecutionSignal(output);
-    if (!ranTests && requestedPaths.length > 0) {
-        const serverStartup = detectServerStartupFailure(output);
-        return serverStartup === undefined
-            ? { kind: 'no-tests', ...counts }
-            : { kind: 'harness-crash', signature: serverStartup, ...counts };
-    }
-    if (exitCode === 0) {
-        return { kind: 'tests-ran-ok', ...counts };
-    }
-    // Exit codes follow the corrected verdict: a run whose embedded summary
-    // completed green is a pass even when the wrapper exit code went non-zero
-    // on harness noise. Real failures always carry a non-zero unexpected count
-    // or TEST-UNEXPECTED lines, both of which fail the green-summary check.
-    //
-    // The override must never win over crash or truncation evidence: a SIGSEGV
-    // at the second of eight files produces a "green" `Passed: 2 / Failed: 0`
-    // summary and mach exit 1, green only because the crash prevented the
-    // other six files from producing any results. A crash marker or an
-    // unpaired/never-started requested file rejects the override with the
-    // evidence attached, so the caller can say why.
-    if (hasGreenShapedSummary(output)) {
-        const crashLine = findCrashMarkerLine(output);
-        const completeness = analyzeTestCompleteness(output, requestedPaths);
-        if (crashLine !== undefined ||
-            completeness.neverStarted.length > 0 ||
-            completeness.neverEnded.length > 0) {
-            return withNotes({
-                kind: 'test-failures',
-                ...counts,
-                ...(firstRealFailure !== undefined ? { realFailureLine: firstRealFailure } : {}),
-                ...(failureBlocks.length > 0 ? { realFailureBlocks: failureBlocks } : {}),
-                ...(secondaryHarnessSignature !== undefined ? { secondaryHarnessSignature } : {}),
-                greenSummaryRejected: {
-                    ...(crashLine !== undefined ? { crashLine } : {}),
-                    neverStarted: completeness.neverStarted,
-                    neverEnded: completeness.neverEnded,
-                },
-            });
-        }
-        return { kind: 'tests-ran-ok', greenSummaryOverride: true, ...counts };
-    }
-    const wordMatchNote = unmarkedFailureEvidenceNote(counts, realFailures);
-    return withNotes({
-        kind: 'test-failures',
-        ...counts,
-        ...(firstRealFailure !== undefined ? { realFailureLine: firstRealFailure } : {}),
-        ...(failureBlocks.length > 0 ? { realFailureBlocks: failureBlocks } : {}),
-        ...(secondaryHarnessSignature !== undefined ? { secondaryHarnessSignature } : {}),
-    }, wordMatchNote);
-}
-/**
- * True when the capture shows a substantively GREEN suite whose only
- * unexplained residue is the recognized mozsystemmonitor teardown
- * traceback.
- *
- * Requires, all of them: tests actually executed, the summary printed
- * `Ran N checks` with an explicit `Unexpected results: 0`, no non-zero
- * unexpected count anywhere, no real `TEST-UNEXPECTED-*`/assertion line,
- * no crash marker, every requested test file both started and ended, and
- * the recognized teardown traceback is present. Anything short of that
- * falls through to the normal (failing) chain, with the failing condition
- * named, so the next occurrence is a filed bug rather than another
- * undiagnosable re-run.
- *
- * The conditions are evaluated in a fixed order and the first failing one
- * is reported. A run can violate several, and reporting one deterministic
- * condition beats an unordered list of everything that happened to be true.
- */
-function evaluateGreenTeardownOverride(output, counts, realFailures, requestedPaths) {
-    if (!hasKnownTeardownNoise(output))
-        return { accepted: false };
-    const reject = (rejectedBy) => ({ accepted: false, rejectedBy });
-    if (!hasExecutionSignal(output))
-        return reject('no execution signal (no TEST-START/TEST_START)');
-    if (counts.checks === undefined)
-        return reject('summary printed no "Ran N checks" line');
-    // `counts.unexpected === 0` IS the explicit-`Unexpected results: 0` test
-    // the previous revision spelled a second time with
-    // GREEN_UNEXPECTED_SUMMARY_PATTERN: the count is parsed from the same
-    // line and an absent line leaves it undefined. The two are kept apart in
-    // the message because "printed no such line" and "printed a non-zero one"
-    // are different findings for the reader.
-    if (counts.unexpected === undefined) {
-        return reject('summary printed no "Unexpected results:" line');
-    }
-    if (counts.unexpected !== 0) {
-        return reject(`summary reported unexpected=${counts.unexpected}`);
-    }
-    if (NONZERO_UNEXPECTED_SUMMARY_PATTERN.test(output)) {
-        return reject('a non-zero "Unexpected results:" line is present somewhere in the output');
-    }
-    if (realFailures.length > 0) {
-        return reject(`${realFailures.length} matched failure line(s), first: ${truncateEvidence(realFailures[0] ?? '')}`);
-    }
-    const crashLine = findCrashMarkerLine(output);
-    if (crashLine !== undefined)
-        return reject(`crash marker present: ${truncateEvidence(crashLine)}`);
-    // The post-green shutdown re-entry shape is deliberately a crash verdict
-    // on an otherwise-green log. It must not be swept up here.
-    if (SHUTDOWN_REENTRY_PATTERN.test(output)) {
-        return reject('post-green shutdown re-entry shape present');
-    }
-    const completeness = analyzeTestCompleteness(output, requestedPaths);
-    if (completeness.neverStarted.length > 0) {
-        return reject(`requested file(s) never started: ${completeness.neverStarted.join(', ')}`);
-    }
-    if (completeness.neverEnded.length > 0) {
-        return reject(`requested file(s) never ended: ${completeness.neverEnded.join(', ')}`);
-    }
-    return { accepted: true };
-}
-/**
- * Parses the numeric counts from the harness's embedded result summary
- * (`Ran N checks` / `Unexpected results: N`). The last occurrence of each
- * wins: a multi-suite run prints one summary per suite and the final one
- * covers the aggregate the operator sees. Absent counts are omitted (the
- * `FIREFORGE-VERDICT:` contract: an absent key means "summary did not
- * print it", never zero).
- */
-export function extractSummaryCounts(output) {
-    const checks = lastCapturedCount(output, /\bRan (\d+) checks?\b/g);
-    const unexpected = lastCapturedCount(output, /\bUnexpected results:\s*(\d+)\b/g);
-    return {
-        ...(checks !== undefined ? { checks } : {}),
-        ...(unexpected !== undefined ? { unexpected } : {}),
-    };
-}
-/** Last captured integer for `pattern` in `output`, if any occurrence matches. */
-function lastCapturedCount(output, pattern) {
-    let last;
-    for (const match of output.matchAll(pattern)) {
-        const captured = match[1];
-        if (captured !== undefined) {
-            last = Number.parseInt(captured, 10);
-        }
-    }
-    return last;
-}
-/**
- * Formats the machine-readable `FIREFORGE-VERDICT:` line: the stable,
- * greppable last line every `fireforge test` run prints so harness-verdict
- * consumers stop regexing mach internals. The status follows this
- * classifier, never the raw exit code: a crash-classified run says
- * `FAIL reason=crash` even at exit 0, and a green-summary-override pass
- * says `PASS` despite a non-zero mach exit. Count keys are omitted when
- * the embedded summary did not print them. Sharded aggregate lines carry
- * a trailing `shards=<passed>/<total>` instead of counts (counts belong
- * to a single embedded suite summary).
- */
-export function formatFireforgeVerdictLine(verdict, shards) {
-    const counts = (verdict.checks !== undefined ? ` checks=${verdict.checks}` : '') +
-        (verdict.unexpected !== undefined ? ` unexpected=${verdict.unexpected}` : '');
-    const tail = `${formatShardsSuffix(shards)}${verdict.note !== undefined ? ` (${verdict.note})` : ''}`;
-    if (verdict.kind === 'tests-ran-ok')
-        return `FIREFORGE-VERDICT: PASS${counts}${tail}`;
-    const reason = verdict.kind === 'harness-crash' ? (verdict.signature?.verdictReason ?? 'crash') : verdict.kind;
-    return `FIREFORGE-VERDICT: FAIL reason=${reason}${counts}${formatIncompleteSuffix(verdict.incomplete)}${tail}`;
-}
-/**
- * Builds the operator-facing failure message for a green-looking summary
- * that was rejected on crash or truncation evidence (never trusted as a
- * pass, regardless of how green the embedded counts look).
- */
-export function buildGreenSummaryRejectedMessage(rejection, exitCode) {
-    const evidence = [];
-    if (rejection.crashLine !== undefined) {
-        evidence.push(`  - crash evidence: ${rejection.crashLine}`);
-    }
-    if (rejection.neverStarted.length > 0) {
-        evidence.push(`  - requested test file(s) that never started: ${rejection.neverStarted.join(', ')}`);
-    }
-    if (rejection.neverEnded.length > 0) {
-        evidence.push(`  - test file(s) that started but never finished: ${rejection.neverEnded.join(', ')}`);
-    }
-    return (`mach exited ${exitCode} and the embedded suite summary looks green, but FireForge did NOT ` +
-        'treat the run as passed:\n\n' +
-        `${evidence.join('\n')}\n\n` +
-        'A crash- or truncation-shortened run under-reports: the "green" counts only cover the ' +
-        'files that ran before the run died, so the summary is not a suite result. Treat this as a ' +
-        'FAILED run — check the crash/truncation point in the output above, then re-run the ' +
-        'remaining files.');
-}
-/**
- * Exit codes that mean "the child died on SIGSEGV": Node reports a
- * signal-killed child as the negated signal number, while a shell layer
- * in between reports `128 + signal`. Both shapes reach FireForge
- * depending on how mach wrapped the harness.
- */
-const SIGSEGV_EXIT_CODES = new Set([-11, 139]);
-/**
- * True when a harness run died on SIGSEGV having produced no test evidence
- * whatsoever.
- *
- * `xpcshell return code: -11` with zero output is the signature of an
- * `.sys.mjs` that a packaged module imports but whose `EXTRA_JS_MODULES`
- * registration never landed: the module loader faults before any logging
- * exists, so there is no import error, no stack, no test output, just a
- * dead process. It is indistinguishable from a genuine product crash
- * unless someone names the cause.
- *
- * "Produced no evidence" is semantic rather than a byte
- * budget: no execution signal, no real failure line, and no mozcrash
- * marker. A run that got far enough to start a test, report a failure, or
- * leave a crash dump has evidence of its own, and the regular diagnosis
- * chain reads it. This branch is only for the case where there is
- * nothing else to say.
- *
- * Pure. Exported for direct unit testing.
- *
- * @param exitCode - The harness process exit code
- * @param output - Combined stdout/stderr from the run
- */
-export function isSilentSegfault(exitCode, output) {
-    if (!SIGSEGV_EXIT_CODES.has(exitCode))
-        return false;
-    if (hasExecutionSignal(output))
-        return false;
-    if (realUnexpectedFailureLines(output).length > 0)
-        return false;
-    return findCrashMarkerLine(output) === undefined;
-}
-/**
- * Names the known cause of a silent SIGSEGV so the operator checks
- * moz.build registration FIRST instead of paying a full rebuild cycle to
- * rediscover it.
- *
- * @param exitCode - The harness process exit code
- * @param requestedPaths - Test paths the run requested
- */
-export function buildSilentSegfaultMessage(exitCode, requestedPaths) {
-    return (`The test harness died on SIGSEGV (exit ${exitCode}) having printed NO output at all.\n\n` +
-        'Known cause, check this FIRST: a `.sys.mjs` imported from a packaged module whose ' +
-        '`EXTRA_JS_MODULES` (or namespaced module list) registration is missing from moz.build. ' +
-        'The module loader faults before any logging exists, so an unregistered module produces ' +
-        'exactly this shape — a dead process with no import error and no stack.\n\n' +
-        'What to do, in order:\n' +
-        '  1. Run `fireforge lint --per-patch`: the unregistered-system-module check names a new ' +
-        'module imported as a resource URL with no moz.build line.\n' +
-        '  2. Run `fireforge verify`: its module-resolution preflight resolves every ' +
-        '`resource:///modules/…` specifier the queue-owned modules import, including imports ' +
-        'added to an EXISTING module — the shape the new-file lint cannot see, and the one that ' +
-        'recurs.\n' +
-        '  3. Only then look for a product crash: a real one prints a crash dump or a stack.\n\n' +
-        `Requested paths: ${requestedPaths.join(', ')}`);
-}
-/**
- * Builds the message for a run that produced no `TEST-START` despite
- * requesting paths, including exit-code-zero runs whose `Passed: 0`
- * summary would otherwise read as a silent false green.
- */
-export function buildNoTestsRanMessage(exitCode, requestedPaths) {
-    const exitNote = exitCode === 0
-        ? 'The harness exited 0 and may have printed a summary line, but a summary without a single TEST-START is not a test result.'
-        : `The harness exited ${exitCode} before any TEST-START line.`;
-    return ('mach test finished without starting any of the requested tests.\n\n' +
-        `${exitNote}\n\n` +
-        `Requested paths: ${requestedPaths.join(', ')}\n\n` +
-        'Check that the paths are registered in their test manifest (browser.toml / xpcshell.toml) ' +
-        'and that the manifest is reachable from moz.build, then retry.');
-}