diff --git a/docs/testing.md b/docs/testing.md index 9a0f531692..089aed13da 100644 --- a/docs/testing.md +++ b/docs/testing.md @@ -209,6 +209,21 @@ was SIGKILLed by heap pressure under workspace worker budgeting. The top-level `pretest` artifact bootstrap runs once before the orchestrator; lane subprocesses must not re-run `scripts/ensure-test-artifacts.mjs`. +Use the exact aggregate command below to attempt all 15 app/API lanes, including after +one or more lanes fail: + +```bash +pnpm --filter @fusion/dashboard test -- --all +``` + +pnpm forwards that invocation as `-- --all`; the quality runner deliberately removes +only the leading package-script separator and still rejects genuine unknown options. +`--no-fail-fast` is an equivalent aggregate alias. Without either alias, the default is +fail-fast for quick local feedback: remaining lanes are reported as **NOT RUN** with +**UNKNOWN** status, never as passing. Aggregate mode attempts every lane exactly once; +any failed or signal-terminated lane keeps the command nonzero and is named in the +final failure summary. It must never print an all-passed summary when any lane failed. +