sxy-test-runner 2.4.2 → 2.4.4

package/AGENTS.md

@@ -19,8 +19,17 @@ For introductory human-facing usage, also see `readme.md`.
 4. Import only `describe` from `sxy-test-runner`. Obtain `it`, `test`, and local hooks from
    the `describe` callback.
 5. Run `npx sxy-test-runner once` for finite agent or CI work.
-6. Exit codes: `0` all tests passed, `3` test failure, `4` no test files matched the `tests`
-   pattern, `5` test files ran but `--filter-it`/`--filter-describe` matched nothing.
+6. Exit codes: `0` all tests passed, `2` an option was not recognised, `3` test failure,
+   `4` no test files matched the `tests` pattern, `5` test files ran but
+   `--filter-it`/`--filter-describe` matched nothing.
+
+An unrecognised option exits `2` before anything runs, rather than warning and carrying on -
+otherwise a typo like `--fitler-it` quietly runs the whole suite and reports a pass. Every
+unrecognised option is listed at once, with a suggestion where the intent is obvious. Options
+are per-command, so `watch --fail-fast` and `once --status-file` are usage errors too.
+
+These are process exit codes, and are **not** the status codes used by `--status-file` and
+`--agent`, where `2` means the run died partway. Read the exit code from the process.
 
 Do not run a test file directly with `node`. `describe()` requires runner-owned global
 state and deliberately throws if the framework has not initialized it.
@@ -85,6 +94,9 @@ npx sxy-test-runner once --filter-describe "users"
 # Run tests whose names contain "creates a user"
 npx sxy-test-runner once --filter-it "creates a user"
 
+# Stop at the first failure instead of running the whole suite
+npx sxy-test-runner once --fail-fast
+
 # Watch mode, reporting each run as single agent readable lines
 npx sxy-test-runner watch --agent
 
@@ -116,6 +128,29 @@ describes or tests afterward can therefore be much slower than file filtering. P
 `--filter` when a file glob can narrow the run, then use `--filter-describe` or
 `--filter-it` only for further narrowing inside those files.
 
+`--fail-fast` (`-x`) stops the run at the first failure - whether that is a failing test, a
+describe that threw, or a test file that would not load. It is a `once` flag with no config
+equivalent: it describes a single invocation rather than a project, and in watch mode it
+would silently truncate runs that report themselves as having covered everything.
+The failure is reported in full, then nothing further starts: not the rest of the describe,
+the file, or the remaining files. Hooks still unwind normally, so `afterEachTest`,
+`afterEachDescribe`, `afterEachFile` and `teardown` all run for whatever had started.
+
+Because the run is cut short, the tallies count only what ran - a suite of 500 tests can
+report `Tests: 0/1`. The summary therefore ends with `stopped at the first failure
+(failFast)`, and the status file's description gains `, stopped at the first failure`. Read
+those before treating a tally as the size of the suite. The exit code is unchanged: `3` for
+a test failure, so CI still fails the job.
+
+Under parallel execution it is best-effort: work already in flight finishes, so more than
+one failure can be reported. Sequential execution - the default - stops exactly at the
+first.
+
+CI usually wants this **off**, which is the default. A CI run is not interactive, so seeing
+every failure in one round beats fixing one, pushing, and waiting again. It earns its place
+on a slow suite where the first failure is enough to know the build is dead, or in a local
+edit-test loop.
+
 Test discovery uses Node's built-in glob implementation. Patterns are resolved relative to
 `testsBase`, and ignore patterns are resolved from that same base.
 
@@ -324,10 +359,12 @@ ever sees a complete status.
 
 ### Following a watch session as an agent
 
-`--agent` (or `watch.agent` in the config) replaces watch mode's usual output with one line
-per event, for an agent reading the process's stdout rather than a terminal. It applies to
-watch mode only - `once` already ends with an exit code, so a config setting it is ignored
-there.
+`--agent` (or `watch.agent` in the config, for watch mode) replaces the usual output with
+one line per event, for an agent reading the process's stdout rather than a terminal. It
+works in both modes. In `once` it leaves only the failures and the summary - no per-test
+listing - and the process still exits on its usual code, so `once --agent` is both readable
+and CI-safe. In `once` the flag is the only source: a config setting `watch.agent` is
+ignored there, so the output format cannot change out from under a caller.
 
 ```
 [sxyt] init | pid=16744
@@ -350,7 +387,7 @@ is always exactly one line and a field boundary is always a real one.
 | --- | --- |
 | `init` | the process is up, before the config is read - proof it started at all |
 | `found` | test discovery finished |
-| `run` | a run has started. `why` is `startup`, `auto` (a file changed), or `all`/`last`/`failed` from a keyboard command |
+| `run` | a run has started. `why` is `once`, `startup`, `auto` (a file changed), or `all`/`last`/`failed` from a keyboard command |
 | `fail` | one failure. `describe` is absent when a file would not load, `test` when the describe itself threw |
 | `done` | the run finished |
 | `change` | a watched file changed |
@@ -367,7 +404,8 @@ generalises:
 
 | covers | the run contained |
 | --- | --- |
-| `all` | every discovered test file - the startup run, `a` from the keyboard, or any change when `watch.dependencyEvaluation` is off |
+| `all` | every discovered test file - a `once` run, the watch startup run, `a` from the keyboard, or any change when `watch.dependencyEvaluation` is off |
+| `until-first-failure` | the run is set up to stop early (`--fail-fast`), so it can only speak for what it reached |
 | `changed+failing` | the changed files and every file still failing (`watch.reRunFailingTests` on, the default) |
 | `changed` | only the changed files (`watch.reRunFailingTests` off) |
 | `last` | the previous run's file set |
@@ -401,7 +439,15 @@ Widening `watch.watchFiles` (for example to `**/*.{js,json,env}`) closes the fir
 it matters, at the cost of more reruns.
 
 Diffs, logs and stack traces are not in the agent stream; errors are reduced to one line.
-Use `once` when a finite run and an exit code are all that is needed.
+
+In `once`, `code` on the `done` line is the status code above, **not** the process exit
+code - `code=1` accompanies exit `3`. Read the process's exit code for pass/fail; read the
+line for the detail. `watching` and `change` never appear, since there is no watcher.
+
+```sh
+# a finite, agent readable run: failures and a summary, exit code preserved
+npx sxy-test-runner once --agent
+```
 
 ## Configuration reference
 

package/dist/cli/help.js

@@ -24,13 +24,15 @@ export function help() {
         '  help   Show this help',
         '',
         'Options:',
-        '  -c, --config <file>      Use a specific configuration file',
-        '  -t, --test-files <glob>  Override the configured test pattern',
-        '  -f, --filter <glob>      Further constrain the configured test pattern',
+        '  -c, --config <file>                Use a specific configuration file',
+        '  -t, --test-files <glob>            Override the configured test pattern',
+        '  -f, --filter <glob>                Further constrain the configured test pattern',
         '  -d, --filter-describe <substring>  Run matching describe blocks',
         '  -i, --filter-it <substring>        Run matching tests',
+        '  -x, --fail-fast                    Stop at the first failure (once mode)',
         '  -s, --status-file <file>           Write the latest watch run status to a file',
-        '      --agent                        Report a watch session as single agent readable lines',
+        '      --agent                        Report the run as single agent readable lines',
+        '  -h, --help                         Show this help, for any command',
         '',
         'Watch controls:',
         '  r/l + Enter           Re-run the last set of tests',

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,MAAM,UAAU,IAAI;IAChB,MAAM,WAAW,GAAG,eAAe;SAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,eAAe,CAAC;SACnC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjB,MAAM,iBAAiB,GAAG,eAAe;SACpC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;SACtE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjB,GAAG,CAAC;QACA,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7B,EAAE;QACF,QAAQ;QACR,KAAK,OAAO,oBAAoB;QAChC,KAAK,OAAO,iBAAiB;QAC7B,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,OAAO;QACnB,EAAE;QACF,WAAW;QACX,iEAAiE;QACjE,2CAA2C;QAC3C,+CAA+C;QAC/C,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,8DAA8D;QAC9D,iEAAiE;QACjE,0EAA0E;QAC1E,mEAAmE;QACnE,yDAAyD;QACzD,kFAAkF;QAClF,4FAA4F;QAC5F,EAAE;QACF,iBAAiB;QACjB,sDAAsD;QACtD,0CAA0C;QAC1C,8CAA8C;QAC9C,qEAAqE;QACrE,EAAE;QACF,WAAW;QACX,KAAK,OAAO,EAAE;QACd,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,4CAA4C;QACxD,KAAK,OAAO,8BAA8B;QAC1C,KAAK,OAAO,sCAAsC;QAClD,EAAE;QACF,kBAAkB,WAAW,OAAO,iBAAiB,GAAG;QACxD,uBAAuB,OAAO,eAAe,WAAW,GAAG;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjB,CAAC","sourcesContent":["import chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\n\nexport function help(): void {\n    const configNames = configFileNames\n        .map(name => `${name}.{js,cjs,mjs}`)\n        .join(' or ')\n    const configDirectories = configLocations\n        .map(location => location === '' ? 'the project root' : `${location}/`)\n        .join(' or ')\n\n    out([\n        chalk.brightblue(packageName),\n        '',\n        'Usage:',\n        `  ${cliName} [watch] [options]`,\n        `  ${cliName} once [options]`,\n        `  ${cliName} init`,\n        `  ${cliName} help`,\n        '',\n        'Commands:',\n        '  watch  Run tests and watch for related file changes (default)',\n        '  once   Run the test suite once and exit',\n        '  init   Create an initial configuration file',\n        '  help   Show this help',\n        '',\n        'Options:',\n        '  -c, --config <file>      Use a specific configuration file',\n        '  -t, --test-files <glob>  Override the configured test pattern',\n        '  -f, --filter <glob>      Further constrain the configured test pattern',\n        '  -d, --filter-describe <substring>  Run matching describe blocks',\n        '  -i, --filter-it <substring>        Run matching tests',\n        '  -s, --status-file <file>           Write the latest watch run status to a file',\n        '      --agent                        Report a watch session as single agent readable lines',\n        '',\n        'Watch controls:',\n        '  r/l + Enter           Re-run the last set of tests',\n        '  a + Enter             Re-run all tests',\n        '  f + Enter             Re-run failing tests',\n        '  Set watch.ttyActionsOnKeypress to true to run these without Enter',\n        '',\n        'Examples:',\n        `  ${cliName}`,\n        `  ${cliName} once`,\n        `  ${cliName} watch --test-files \"**/*.focused.test.js\"`,\n        `  ${cliName} once --filter \"**/users/**\"`,\n        `  ${cliName} once --config config/sxyt.config.js`,\n        '',\n        `Configuration: ${configNames} in ${configDirectories}.`,\n        `Executable aliases: ${cliName}, sxy-test, ${packageName}.`\n    ].join('\\n'))\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,MAAM,UAAU,IAAI;IAChB,MAAM,WAAW,GAAG,eAAe;SAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,eAAe,CAAC;SACnC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjB,MAAM,iBAAiB,GAAG,eAAe;SACpC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;SACtE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjB,GAAG,CAAC;QACA,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7B,EAAE;QACF,QAAQ;QACR,KAAK,OAAO,oBAAoB;QAChC,KAAK,OAAO,iBAAiB;QAC7B,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,OAAO;QACnB,EAAE;QACF,WAAW;QACX,iEAAiE;QACjE,2CAA2C;QAC3C,+CAA+C;QAC/C,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,wEAAwE;QACxE,2EAA2E;QAC3E,oFAAoF;QACpF,mEAAmE;QACnE,yDAAyD;QACzD,4EAA4E;QAC5E,kFAAkF;QAClF,oFAAoF;QACpF,sEAAsE;QACtE,EAAE;QACF,iBAAiB;QACjB,sDAAsD;QACtD,0CAA0C;QAC1C,8CAA8C;QAC9C,qEAAqE;QACrE,EAAE;QACF,WAAW;QACX,KAAK,OAAO,EAAE;QACd,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,4CAA4C;QACxD,KAAK,OAAO,8BAA8B;QAC1C,KAAK,OAAO,sCAAsC;QAClD,EAAE;QACF,kBAAkB,WAAW,OAAO,iBAAiB,GAAG;QACxD,uBAAuB,OAAO,eAAe,WAAW,GAAG;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjB,CAAC","sourcesContent":["import chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\n\nexport function help(): void {\n    const configNames = configFileNames\n        .map(name => `${name}.{js,cjs,mjs}`)\n        .join(' or ')\n    const configDirectories = configLocations\n        .map(location => location === '' ? 'the project root' : `${location}/`)\n        .join(' or ')\n\n    out([\n        chalk.brightblue(packageName),\n        '',\n        'Usage:',\n        `  ${cliName} [watch] [options]`,\n        `  ${cliName} once [options]`,\n        `  ${cliName} init`,\n        `  ${cliName} help`,\n        '',\n        'Commands:',\n        '  watch  Run tests and watch for related file changes (default)',\n        '  once   Run the test suite once and exit',\n        '  init   Create an initial configuration file',\n        '  help   Show this help',\n        '',\n        'Options:',\n        '  -c, --config <file>                Use a specific configuration file',\n        '  -t, --test-files <glob>            Override the configured test pattern',\n        '  -f, --filter <glob>                Further constrain the configured test pattern',\n        '  -d, --filter-describe <substring>  Run matching describe blocks',\n        '  -i, --filter-it <substring>        Run matching tests',\n        '  -x, --fail-fast                    Stop at the first failure (once mode)',\n        '  -s, --status-file <file>           Write the latest watch run status to a file',\n        '      --agent                        Report the run as single agent readable lines',\n        '  -h, --help                         Show this help, for any command',\n        '',\n        'Watch controls:',\n        '  r/l + Enter           Re-run the last set of tests',\n        '  a + Enter             Re-run all tests',\n        '  f + Enter             Re-run failing tests',\n        '  Set watch.ttyActionsOnKeypress to true to run these without Enter',\n        '',\n        'Examples:',\n        `  ${cliName}`,\n        `  ${cliName} once`,\n        `  ${cliName} watch --test-files \"**/*.focused.test.js\"`,\n        `  ${cliName} once --filter \"**/users/**\"`,\n        `  ${cliName} once --config config/sxyt.config.js`,\n        '',\n        `Configuration: ${configNames} in ${configDirectories}.`,\n        `Executable aliases: ${cliName}, sxy-test, ${packageName}.`\n    ].join('\\n'))\n}\n"]}

package/dist/cli/index.js

@@ -1,27 +1,7 @@
 #!/usr/bin/env node
-const args = process.argv.slice(2);
-if (args.length > 0) {
-    const command = args[0];
-    switch (command) { // eslint-disable-line @typescript-eslint/switch-exhaustiveness-check
-        case 'init':
-        case 'once':
-        case 'watch':
-        case 'help':
-            await doCommand(command, args.slice(1));
-            break;
-        case '--init':
-        case '--once':
-        case '--watch':
-        case '--help':
-            await doCommand(command.substring(2), args.slice(1));
-            break;
-        default:
-            await doCommand('watch', args);
-    }
-}
-else {
-    await doCommand('watch', args);
-}
+const { resolveCommand } = await import('./lib/resolveCommand.js');
+const { command, commandArgs } = resolveCommand(process.argv.slice(2));
+await doCommand(command, commandArgs);
 async function doCommand(command, args) {
     global.__sxyt_commandLineArguments = args;
     // command-named dynamic import - no static type can express "a module matching an unknown command string"

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAElC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,QAAQ,OAAO,EAAE,CAAC,CAAC,qEAAqE;QACpF,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACP,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACvC,MAAK;QACT,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACT,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACpD,MAAK;QACT;YACI,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;AACL,CAAC;KAAM,CAAC;IACJ,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAClC,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IACpD,MAAM,CAAC,2BAA2B,GAAG,IAAI,CAAA;IACzC,0GAA0G;IAC1G,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAA;IAC9C,yGAAyG;IACzG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC","sourcesContent":["#!/usr/bin/env node\n\nconst args = process.argv.slice(2)\n\nif (args.length > 0) {\n    const command = args[0]\n    switch (command) { // eslint-disable-line @typescript-eslint/switch-exhaustiveness-check\n        case 'init':\n        case 'once':\n        case 'watch':\n        case 'help':\n            await doCommand(command, args.slice(1))\n            break\n        case '--init':\n        case '--once':\n        case '--watch':\n        case '--help':\n            await doCommand(command.substring(2), args.slice(1))\n            break\n        default:\n            await doCommand('watch', args)\n    }\n} else {\n    await doCommand('watch', args)\n}\n\nasync function doCommand(command: string, args: string[]): Promise<void> {\n    global.__sxyt_commandLineArguments = args\n    // command-named dynamic import - no static type can express \"a module matching an unknown command string\"\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const module = await import(`./${command}.js`)\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n    await module[command]()\n    process.exit(0)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;AAElE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtE,MAAM,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;AAErC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IACpD,MAAM,CAAC,2BAA2B,GAAG,IAAI,CAAA;IACzC,0GAA0G;IAC1G,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAA;IAC9C,yGAAyG;IACzG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC","sourcesContent":["#!/usr/bin/env node\n\nconst { resolveCommand } = await import('./lib/resolveCommand.js')\n\nconst { command, commandArgs } = resolveCommand(process.argv.slice(2))\n\nawait doCommand(command, commandArgs)\n\nasync function doCommand(command: string, args: string[]): Promise<void> {\n    global.__sxyt_commandLineArguments = args\n    // command-named dynamic import - no static type can express \"a module matching an unknown command string\"\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const module = await import(`./${command}.js`)\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n    await module[command]()\n    process.exit(0)\n}\n"]}

package/dist/cli/init.js

@@ -64,6 +64,7 @@ export default {
     // whether to show the full error trace when an error occurs in a test file
     showErrorTrace: false,
 
+
     // tasks to run on startup
     // accepts a function, file location (relative to project base), or array of functions and or files
     setup: undefined,

package/dist/cli/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,MAAM,UAAU,IAAI;IAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhC,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC3C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAA;YACP,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC,CAAA;YAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAED,SAAS,mBAAmB,CAAC,GAAW;QACpC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,yCAAyC,GAAG,EAAE;cACvE,kEAAkE,OAAO,SAAS,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,0BAA0B,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,2CAA2C;cACpE,gEAAgE;cAChE,iFAAiF,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAA;IAC1E,mEAAmE;IACnE,MAAM,WAAW,GAAsB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAEjE,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;QACpD,aAAa;QACb,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACxE,SAAS;QACT,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IAE7E,MAAM,aAAa,GACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkGE,CAAA;IAEE,EAAE,CAAC,aAAa,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAEjD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAA,IAAI,WAAW,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAC9F,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\nimport fs from 'fs'\n\nexport function init(): void {\n    const projectDir = process.cwd()\n\n    for (const configLocation of configLocations) {\n        for (const configFileName of configFileNames) {\n            let loc\n            loc = join(projectDir, configLocation, configFileName + '.js')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.cjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.mjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n        }\n    }\n\n    function configAlreadyExists(loc: string): void {\n        out(chalk.orange`[${packageName}] A matching config already exists at ${loc}`\n            + `\\nPlease remove this config before generating a new one with \\`${cliName} init\\``)\n    }\n\n    const projectPackageJsonLocation = join(projectDir, 'package.json')\n    if (!fs.existsSync(projectPackageJsonLocation)) {\n        out(chalk.orange`[${packageName}] No package.json exists in this location`\n            + '\\nPlease initialise the package with `yarn init` on `npm init`'\n            + ' before running this command, and run this command from the project root folder')\n    }\n\n    const packageJsonRaw = fs.readFileSync(projectPackageJsonLocation, 'utf8')\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const packageJson: { type?: string } = JSON.parse(packageJsonRaw)\n\n    const targetConfigName = (packageJson.type === 'module')\n        // ES6 module\n        ? join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.js')\n        // common\n        : join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.mjs')\n\n    const defaultConfig =\n`\n// @ts-check\n\n/** @satisfies {import('sxy-test-runner').Config} */\nexport default {\n\n    // base folder for tests match and ignore patterns\n    testsBase: '.',\n\n    // glob pattern or array of glob patterns of test files\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n\n    // glob pattern or array of patterns of test files to ignore\n    testsIgnore: ['**/node_modules/**'],\n\n    // whether to show the full error trace when an error occurs in a test file\n    showErrorTrace: false,\n\n    // tasks to run on startup\n    // accepts a function, file location (relative to project base), or array of functions and or files\n    setup: undefined,\n\n    // tasks to run before each test file is run\n    beforeEachFile: undefined,\n\n    // tasks to run after each test file is run\n    afterEachFile:  undefined,\n\n    // tasks to run before each describe block is processed\n    // if the function returns an object with named properties, or the file exports named exports,\n    // these will be passed to the callback function in argument 0, and can be access by destructruing e.g.\n    // describe('thing', ({exportA, exportB}) => { it('should', ...) })\n    beforeEachDescribe: undefined,\n\n    // tasks to run after each describe block\n    afterEachDescribe: undefined,\n\n    // tasks to run before each it/test block\n    // function returns and file exports will be passed to the it/test block as with describe above, e.g.\n    // it('should', ({exportA, exportB}) => { assert('something') })\n    beforeEachTest: undefined,\n\n    // tasks to run after each it/test block\n    afterEachTest: undefined,\n\n    // how to execute the different parts of test files\n    execution: {\n\n        // run test files in 'parallel' or 'sequential'ly\n        files: 'sequential',\n\n        // run describe blocks within a test file in 'parallel' or 'sequential'ly\n        describes: 'sequential',\n\n        // run it/test blocks within a describe blocks in 'parallel' or 'sequential'ly\n        tests: 'sequential'\n\n    },\n\n    // watch mode configurations\n    watch: {\n\n        //// the base directory to watch files in\n        watchFilesBase: '.',\n\n        //// glob filter or array of glob filters of files to watch\n        watchFiles: '**/*.js',\n\n        //// glob filter or array of globl filters of files to ignore\n        watchFilesIgnore: '**/node_modules/**',\n\n        // run all tests when starting the watcher\n        runAllOnStartup: true,\n\n        // re run all previously failed tests on each test run, until they pass\n        reRunFailingTests: true,\n\n        // evaluate the dependencies of each test file, and re-run that test file only when they change. \n        // Set this to false to re-run everything on any change\n        dependencyEvaluation: true,\n\n        // run watch mode keyboard commands immediately, without waiting for Enter\n        ttyActionsOnKeypress: false,\n\n        // file to write the latest run status to, or false for none\n        statusFile: false,\n\n        // report the session as single agent readable lines instead of the usual output\n        agent: false,\n\n    },\n\n}`\n\n    fs.writeFileSync(targetConfigName, defaultConfig)\n\n    out(chalk.mediumgreen`[${packageName}] Created config at ` + chalk.blue(targetConfigName))\n}\n"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,MAAM,UAAU,IAAI;IAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhC,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC3C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAA;YACP,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC,CAAA;YAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAED,SAAS,mBAAmB,CAAC,GAAW;QACpC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,yCAAyC,GAAG,EAAE;cACvE,kEAAkE,OAAO,SAAS,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,0BAA0B,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,2CAA2C;cACpE,gEAAgE;cAChE,iFAAiF,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAA;IAC1E,mEAAmE;IACnE,MAAM,WAAW,GAAsB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAEjE,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;QACpD,aAAa;QACb,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACxE,SAAS;QACT,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IAE7E,MAAM,aAAa,GACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmGE,CAAA;IAEE,EAAE,CAAC,aAAa,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAEjD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAA,IAAI,WAAW,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAC9F,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\nimport fs from 'fs'\n\nexport function init(): void {\n    const projectDir = process.cwd()\n\n    for (const configLocation of configLocations) {\n        for (const configFileName of configFileNames) {\n            let loc\n            loc = join(projectDir, configLocation, configFileName + '.js')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.cjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.mjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n        }\n    }\n\n    function configAlreadyExists(loc: string): void {\n        out(chalk.orange`[${packageName}] A matching config already exists at ${loc}`\n            + `\\nPlease remove this config before generating a new one with \\`${cliName} init\\``)\n    }\n\n    const projectPackageJsonLocation = join(projectDir, 'package.json')\n    if (!fs.existsSync(projectPackageJsonLocation)) {\n        out(chalk.orange`[${packageName}] No package.json exists in this location`\n            + '\\nPlease initialise the package with `yarn init` on `npm init`'\n            + ' before running this command, and run this command from the project root folder')\n    }\n\n    const packageJsonRaw = fs.readFileSync(projectPackageJsonLocation, 'utf8')\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const packageJson: { type?: string } = JSON.parse(packageJsonRaw)\n\n    const targetConfigName = (packageJson.type === 'module')\n        // ES6 module\n        ? join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.js')\n        // common\n        : join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.mjs')\n\n    const defaultConfig =\n`\n// @ts-check\n\n/** @satisfies {import('sxy-test-runner').Config} */\nexport default {\n\n    // base folder for tests match and ignore patterns\n    testsBase: '.',\n\n    // glob pattern or array of glob patterns of test files\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n\n    // glob pattern or array of patterns of test files to ignore\n    testsIgnore: ['**/node_modules/**'],\n\n    // whether to show the full error trace when an error occurs in a test file\n    showErrorTrace: false,\n\n\n    // tasks to run on startup\n    // accepts a function, file location (relative to project base), or array of functions and or files\n    setup: undefined,\n\n    // tasks to run before each test file is run\n    beforeEachFile: undefined,\n\n    // tasks to run after each test file is run\n    afterEachFile:  undefined,\n\n    // tasks to run before each describe block is processed\n    // if the function returns an object with named properties, or the file exports named exports,\n    // these will be passed to the callback function in argument 0, and can be access by destructruing e.g.\n    // describe('thing', ({exportA, exportB}) => { it('should', ...) })\n    beforeEachDescribe: undefined,\n\n    // tasks to run after each describe block\n    afterEachDescribe: undefined,\n\n    // tasks to run before each it/test block\n    // function returns and file exports will be passed to the it/test block as with describe above, e.g.\n    // it('should', ({exportA, exportB}) => { assert('something') })\n    beforeEachTest: undefined,\n\n    // tasks to run after each it/test block\n    afterEachTest: undefined,\n\n    // how to execute the different parts of test files\n    execution: {\n\n        // run test files in 'parallel' or 'sequential'ly\n        files: 'sequential',\n\n        // run describe blocks within a test file in 'parallel' or 'sequential'ly\n        describes: 'sequential',\n\n        // run it/test blocks within a describe blocks in 'parallel' or 'sequential'ly\n        tests: 'sequential'\n\n    },\n\n    // watch mode configurations\n    watch: {\n\n        //// the base directory to watch files in\n        watchFilesBase: '.',\n\n        //// glob filter or array of glob filters of files to watch\n        watchFiles: '**/*.js',\n\n        //// glob filter or array of globl filters of files to ignore\n        watchFilesIgnore: '**/node_modules/**',\n\n        // run all tests when starting the watcher\n        runAllOnStartup: true,\n\n        // re run all previously failed tests on each test run, until they pass\n        reRunFailingTests: true,\n\n        // evaluate the dependencies of each test file, and re-run that test file only when they change. \n        // Set this to false to re-run everything on any change\n        dependencyEvaluation: true,\n\n        // run watch mode keyboard commands immediately, without waiting for Enter\n        ttyActionsOnKeypress: false,\n\n        // file to write the latest run status to, or false for none\n        statusFile: false,\n\n        // report the session as single agent readable lines instead of the usual output\n        agent: false,\n\n    },\n\n}`\n\n    fs.writeFileSync(targetConfigName, defaultConfig)\n\n    out(chalk.mediumgreen`[${packageName}] Created config at ` + chalk.blue(targetConfigName))\n}\n"]}

package/dist/cli/lib/agentReport.d.ts

@@ -2,7 +2,7 @@ import type { FinalConfig, TestsResultsSummary } from '../../types.js';
 import type { FailureEntry } from './failureEntries.js';
 import type { RunType } from './reRunManager.js';
 import type { StatusCode } from './statusFile.js';
-export type RunReason = RunType | 'startup';
+export type RunReason = RunType | 'startup' | 'once';
 export declare function agentEnabled(config: FinalConfig): boolean;
 export declare function agentInit(enabled: boolean): void;
 export declare function agentFound(config: FinalConfig, files: number): void;

package/dist/cli/lib/agentReport.js

@@ -56,8 +56,13 @@ export function agentRunStart(config, files) {
 // what the run was built from. A reader needs this to know how far the run's own `code`
 // generalises - only a run covering everything can speak for the whole suite.
 function runScope(config) {
+    // known before the run starts: fail fast means it is built to stop early, so it cannot
+    // promise to have covered anything beyond the first failure
+    if (config.failFast)
+        return 'until-first-failure';
     switch (nextRunReason) {
         case 'startup':
+        case 'once':
         case 'all': return 'all';
         case 'last': return 'last';
         case 'failed': return 'failing';

package/dist/cli/lib/agentReport.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentReport.js","sourceRoot":"","sources":["../../../src/cli/lib/agentReport.ts"],"names":[],"mappings":"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","sourcesContent":["import { out as mainOut } from '../../output.js'\n\nimport type { FinalConfig, TestsResultsSummary } from '../../types.js'\nimport type { FailureEntry } from './failureEntries.js'\nimport type { RunType } from './reRunManager.js'\nimport type { StatusCode } from './statusFile.js'\n\n// Agent mode reports a watch session as a stream of single lines, for a reader tailing the\n// process rather than watching the terminal. Every line is one complete event:\n//\n//   [sxyt] <event> | <key>=<value> | <key>=<value>\n//\n// Values are never quoted, so free text is flattened to keep the grammar intact - one event\n// can never span two lines, and a stray `|` can never look like a field boundary.\n\nconst prefix = '[sxyt]'\n\nexport type RunReason = RunType | 'startup'\n\nlet runCounter = 0\n// requestRun sets this before handing a run to runTests; the initial run never goes through\n// the queue, so 'startup' is the right default\nlet nextRunReason: RunReason = 'startup'\n\ntype Field = [string, string | number]\n\nfunction emit(event: string, fields: Field[] = []): void {\n    mainOut(prefix + ` ${event}` + fields.map(([key, value]) => ` | ${key}=${value}`).join(''))\n}\n\n// newlines would split one event across two lines, and a `|` would read as a field boundary\nfunction flatten(text: string): string {\n    return text.replace(/\\s*[\\r\\n]+\\s*/g, ' ').replace(/\\|/g, '/').trim()\n}\n\nexport function agentEnabled(config: FinalConfig): boolean {\n    return config.watch.agent\n}\n\n// the process is up, before the config is even loaded - so a slow startup is\n// distinguishable from one that never began. Takes the flag rather than the config for that\n// reason, and resets the counters so repeated in process sessions start from 1.\nexport function agentInit(enabled: boolean): void {\n    runCounter = 0\n    nextRunReason = 'startup'\n    if (!enabled) return\n    emit('init', [['pid', process.pid]])\n}\n\nexport function agentFound(config: FinalConfig, files: number): void {\n    if (!agentEnabled(config)) return\n    emit('found', [['files', files]])\n}\n\nexport function agentSetRunReason(reason: RunReason): void {\n    nextRunReason = reason\n}\n\n// claims the next run number and announces the run, so a reader knows work is in flight\n// before any result arrives\nexport function agentRunStart(config: FinalConfig, files: number): number {\n    if (!agentEnabled(config)) return 0\n    runCounter++\n    emit('run', [\n        ['n', runCounter],\n        ['files', files],\n        ['why', nextRunReason],\n        ['covers', runScope(config)]\n    ])\n    return runCounter\n}\n\n// what the run was built from. A reader needs this to know how far the run's own `code`\n// generalises - only a run covering everything can speak for the whole suite.\nfunction runScope(config: FinalConfig): string {\n    switch (nextRunReason) {\n        case 'startup':\n        case 'all': return 'all'\n        case 'last': return 'last'\n        case 'failed': return 'failing'\n        case 'auto': {\n            // with dependency evaluation off a change runs the whole suite, so an auto run\n            // carries the same weight as a startup one\n            if (!config.watch.dependencyEvaluation) return 'all'\n            // the reRunFailingTests case is the one worth spelling out: without it a run says\n            // nothing about files that were already failing\n            return (config.watch.reRunFailingTests) ? 'changed+failing' : 'changed'\n        }\n        default: return 'changed'\n    }\n}\n\n// failures are emitted before the run's done line, so done is a complete end of run marker\nexport function agentFailure(config: FinalConfig, run: number, entry: FailureEntry): void {\n    if (!agentEnabled(config)) return\n    emit('fail', [\n        ['n', run],\n        ['file', flatten(entry.file)],\n        ...(entry.describe === undefined)\n            ? []\n            : [['describe', flatten(entry.describe)] as Field],\n        ...(entry.test === undefined) ? [] : [['test', flatten(entry.test)] as Field],\n        ['error', flatten(entry.error)]\n    ])\n}\n\n// `failing` counts the test files still failing across the whole session, not just this\n// run. A watch re-run usually covers only the changed files, so its own tallies can read as\n// a clean pass while the suite is still broken elsewhere.\nexport function agentDone(\n    config: FinalConfig,\n    run: number,\n    code: StatusCode,\n    description: string,\n    summary: TestsResultsSummary | null,\n    durationMs: number,\n    failingFiles: number\n): void {\n    if (!agentEnabled(config)) return\n    emit('done', [\n        ['n', run],\n        ['code', code],\n        ['desc', flatten(description)],\n        ...(summary === null) ? [] : [\n            ['tests', `${summary.itsPasses}/${summary.itsTotal}`] as Field,\n            ['items', `${summary.describesPasses}/${summary.describesTotal}`] as Field,\n            ['files', `${summary.passes}/${summary.total}`] as Field\n        ],\n        ['failing', failingFiles],\n        ['ms', durationMs]\n    ])\n}\n\nexport function agentWatching(config: FinalConfig, files: number): void {\n    if (!agentEnabled(config)) return\n    emit('watching', [['files', files]])\n}\n\nexport function agentChange(config: FinalConfig, file: string, event: string): void {\n    if (!agentEnabled(config)) return\n    emit('change', [['file', flatten(file)], ['event', flatten(event)]])\n}\n\n// agent mode owns stdout, so the ordinary coloured output is routed into a sink\nexport function agentSilentOut(): void {\n    // deliberately nothing - the agent lines are the whole stream\n}\n"]}
+{"version":3,"file":"agentReport.js","sourceRoot":"","sources":["../../../src/cli/lib/agentReport.ts"],"names":[],"mappings":"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","sourcesContent":["import { out as mainOut } from '../../output.js'\n\nimport type { FinalConfig, TestsResultsSummary } from '../../types.js'\nimport type { FailureEntry } from './failureEntries.js'\nimport type { RunType } from './reRunManager.js'\nimport type { StatusCode } from './statusFile.js'\n\n// Agent mode reports a watch session as a stream of single lines, for a reader tailing the\n// process rather than watching the terminal. Every line is one complete event:\n//\n//   [sxyt] <event> | <key>=<value> | <key>=<value>\n//\n// Values are never quoted, so free text is flattened to keep the grammar intact - one event\n// can never span two lines, and a stray `|` can never look like a field boundary.\n\nconst prefix = '[sxyt]'\n\nexport type RunReason = RunType | 'startup' | 'once'\n\nlet runCounter = 0\n// requestRun sets this before handing a run to runTests; the initial run never goes through\n// the queue, so 'startup' is the right default\nlet nextRunReason: RunReason = 'startup'\n\ntype Field = [string, string | number]\n\nfunction emit(event: string, fields: Field[] = []): void {\n    mainOut(prefix + ` ${event}` + fields.map(([key, value]) => ` | ${key}=${value}`).join(''))\n}\n\n// newlines would split one event across two lines, and a `|` would read as a field boundary\nfunction flatten(text: string): string {\n    return text.replace(/\\s*[\\r\\n]+\\s*/g, ' ').replace(/\\|/g, '/').trim()\n}\n\nexport function agentEnabled(config: FinalConfig): boolean {\n    return config.watch.agent\n}\n\n// the process is up, before the config is even loaded - so a slow startup is\n// distinguishable from one that never began. Takes the flag rather than the config for that\n// reason, and resets the counters so repeated in process sessions start from 1.\nexport function agentInit(enabled: boolean): void {\n    runCounter = 0\n    nextRunReason = 'startup'\n    if (!enabled) return\n    emit('init', [['pid', process.pid]])\n}\n\nexport function agentFound(config: FinalConfig, files: number): void {\n    if (!agentEnabled(config)) return\n    emit('found', [['files', files]])\n}\n\nexport function agentSetRunReason(reason: RunReason): void {\n    nextRunReason = reason\n}\n\n// claims the next run number and announces the run, so a reader knows work is in flight\n// before any result arrives\nexport function agentRunStart(config: FinalConfig, files: number): number {\n    if (!agentEnabled(config)) return 0\n    runCounter++\n    emit('run', [\n        ['n', runCounter],\n        ['files', files],\n        ['why', nextRunReason],\n        ['covers', runScope(config)]\n    ])\n    return runCounter\n}\n\n// what the run was built from. A reader needs this to know how far the run's own `code`\n// generalises - only a run covering everything can speak for the whole suite.\nfunction runScope(config: FinalConfig): string {\n    // known before the run starts: fail fast means it is built to stop early, so it cannot\n    // promise to have covered anything beyond the first failure\n    if (config.failFast) return 'until-first-failure'\n\n    switch (nextRunReason) {\n        case 'startup':\n        case 'once':\n        case 'all': return 'all'\n        case 'last': return 'last'\n        case 'failed': return 'failing'\n        case 'auto': {\n            // with dependency evaluation off a change runs the whole suite, so an auto run\n            // carries the same weight as a startup one\n            if (!config.watch.dependencyEvaluation) return 'all'\n            // the reRunFailingTests case is the one worth spelling out: without it a run says\n            // nothing about files that were already failing\n            return (config.watch.reRunFailingTests) ? 'changed+failing' : 'changed'\n        }\n        default: return 'changed'\n    }\n}\n\n// failures are emitted before the run's done line, so done is a complete end of run marker\nexport function agentFailure(config: FinalConfig, run: number, entry: FailureEntry): void {\n    if (!agentEnabled(config)) return\n    emit('fail', [\n        ['n', run],\n        ['file', flatten(entry.file)],\n        ...(entry.describe === undefined)\n            ? []\n            : [['describe', flatten(entry.describe)] as Field],\n        ...(entry.test === undefined) ? [] : [['test', flatten(entry.test)] as Field],\n        ['error', flatten(entry.error)]\n    ])\n}\n\n// `failing` counts the test files still failing across the whole session, not just this\n// run. A watch re-run usually covers only the changed files, so its own tallies can read as\n// a clean pass while the suite is still broken elsewhere.\nexport function agentDone(\n    config: FinalConfig,\n    run: number,\n    code: StatusCode,\n    description: string,\n    summary: TestsResultsSummary | null,\n    durationMs: number,\n    failingFiles: number\n): void {\n    if (!agentEnabled(config)) return\n    emit('done', [\n        ['n', run],\n        ['code', code],\n        ['desc', flatten(description)],\n        ...(summary === null) ? [] : [\n            ['tests', `${summary.itsPasses}/${summary.itsTotal}`] as Field,\n            ['items', `${summary.describesPasses}/${summary.describesTotal}`] as Field,\n            ['files', `${summary.passes}/${summary.total}`] as Field\n        ],\n        ['failing', failingFiles],\n        ['ms', durationMs]\n    ])\n}\n\nexport function agentWatching(config: FinalConfig, files: number): void {\n    if (!agentEnabled(config)) return\n    emit('watching', [['files', files]])\n}\n\nexport function agentChange(config: FinalConfig, file: string, event: string): void {\n    if (!agentEnabled(config)) return\n    emit('change', [['file', flatten(file)], ['event', flatten(event)]])\n}\n\n// agent mode owns stdout, so the ordinary coloured output is routed into a sink\nexport function agentSilentOut(): void {\n    // deliberately nothing - the agent lines are the whole stream\n}\n"]}

package/dist/cli/lib/defaultConfig.js

@@ -10,6 +10,7 @@ export const defaultConfig = {
     testsIgnore: ['**/node_modules/**'],
     showErrorTrace: false,
     compact: false,
+    failFast: false,
     execution: {
         files: 'sequential',
         describes: 'sequential',

package/dist/cli/lib/defaultConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACtC,SAAS,EAAE,GAAG;IACd,KAAK,EAAE;QACH,wBAAwB;QACxB,wBAAwB;QACxB,wBAAwB;QACxB,0BAA0B;QAC1B,8BAA8B;KACjC;IACD,WAAW,EAAE,CAAC,oBAAoB,CAAC;IACnC,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,KAAK;IACd,SAAS,EAAE;QACP,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,YAAY;KACtB;IACD,KAAK,EAAE;QACH,cAAc,EAAE,GAAG;QACnB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,IAAI;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,KAAK;KACf;CACJ,CAAA","sourcesContent":["import type { FinalConfig } from '../../types.js'\n\nexport const defaultConfig: FinalConfig = {\n    testsBase: '.',\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n    testsIgnore: ['**/node_modules/**'],\n    showErrorTrace: false,\n    compact: false,\n    execution: {\n        files: 'sequential',\n        describes: 'sequential',\n        tests: 'sequential'\n    },\n    watch: {\n        watchFilesBase: '.',\n        watchFiles: '**/*.js',\n        watchFilesIgnore: '**/node_modules/**',\n        runAllOnStartup: true,\n        reRunFailingTests: true,\n        dependencyEvaluation: true,\n        ttyActionsOnKeypress: false,\n        statusFile: false,\n        agent: false\n    }\n}\n"]}
+{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACtC,SAAS,EAAE,GAAG;IACd,KAAK,EAAE;QACH,wBAAwB;QACxB,wBAAwB;QACxB,wBAAwB;QACxB,0BAA0B;QAC1B,8BAA8B;KACjC;IACD,WAAW,EAAE,CAAC,oBAAoB,CAAC;IACnC,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE;QACP,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,YAAY;KACtB;IACD,KAAK,EAAE;QACH,cAAc,EAAE,GAAG;QACnB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,IAAI;QAC1B,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,KAAK;KACf;CACJ,CAAA","sourcesContent":["import type { FinalConfig } from '../../types.js'\n\nexport const defaultConfig: FinalConfig = {\n    testsBase: '.',\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n    testsIgnore: ['**/node_modules/**'],\n    showErrorTrace: false,\n    compact: false,\n    failFast: false,\n    execution: {\n        files: 'sequential',\n        describes: 'sequential',\n        tests: 'sequential'\n    },\n    watch: {\n        watchFilesBase: '.',\n        watchFiles: '**/*.js',\n        watchFilesIgnore: '**/node_modules/**',\n        runAllOnStartup: true,\n        reRunFailingTests: true,\n        dependencyEvaluation: true,\n        ttyActionsOnKeypress: false,\n        statusFile: false,\n        agent: false\n    }\n}\n"]}

package/dist/cli/lib/parseCommandLineArguments.d.ts

@@ -1,3 +1,4 @@
 import type { AllowedArguments, ParsedArguments } from '../../types.js';
+export declare const usageErrorExitCode = 2;
 export declare function parseCommandLineArguments(allowedArguments: AllowedArguments): ParsedArguments;
 //# sourceMappingURL=parseCommandLineArguments.d.ts.map

package/dist/cli/lib/parseCommandLineArguments.js

@@ -2,13 +2,19 @@
 // once:
 // // --config configLocation
 import { reduce as objectReduce } from 'sxy-lib/objects.js';
-import { packageName } from '../../config.js';
+import { packageName, cliName } from '../../config.js';
 import { log } from '../../output.js';
 import { getAllowedFlags } from './getAllowedFlags.js';
 import chalk from '../../packages/chalk.js';
+// exit code for a usage error - distinct from the run's own 0/3/4/5, so a caller can tell
+// "you asked for something I do not understand" from "the tests failed"
+export const usageErrorExitCode = 2;
 export function parseCommandLineArguments(allowedArguments) {
     const allowedFlags = getAllowedFlags(allowedArguments);
     const returnArgs = {};
+    // collected rather than reported one at a time, so a mistyped command line is fixed in
+    // one go rather than one option per run
+    const unknownArgs = [];
     for (let position = 0; position < __sxyt_commandLineArguments.length; position++) {
         const arg = __sxyt_commandLineArguments[position];
         if (arg === undefined)
@@ -27,6 +33,7 @@ export function parseCommandLineArguments(allowedArguments) {
                 }
             }
             else {
+                unknownArgs.push(`--${longFlag}`);
                 log(chalk.mediumred(`[${packageName}] Unknown option --${longFlag}`));
                 if (longFlag.length === 1
                     && objectReduce(allowedArguments, (prev, _key, value) => {
@@ -56,6 +63,7 @@ export function parseCommandLineArguments(allowedArguments) {
                 }
             }
             else {
+                unknownArgs.push(`-${shortFlag}`);
                 log(chalk.mediumred(`[${packageName}] Unknown flag -${shortFlag}`));
                 if (shortFlag.length > 1 && shortFlag in allowedArguments) {
                     log(chalk.mediumred(`I think you meant --${shortFlag}`));
@@ -63,6 +71,12 @@ export function parseCommandLineArguments(allowedArguments) {
             }
         }
     }
+    // stop rather than run something other than what was asked for: an ignored option can
+    // mean the wrong tests, or a whole suite where a single filtered test was wanted
+    if (unknownArgs.length > 0) {
+        log(chalk.orange(`Run \`${cliName} help\` to see the available options.`));
+        process.exit(usageErrorExitCode);
+    }
     return returnArgs;
 }
 //# sourceMappingURL=parseCommandLineArguments.js.map

package/dist/cli/lib/parseCommandLineArguments.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseCommandLineArguments.js","sourceRoot":"","sources":["../../../src/cli/lib/parseCommandLineArguments.ts"],"names":[],"mappings":"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","sourcesContent":["// watch:\n// once:\n// // --config configLocation\n\n\nimport { reduce as objectReduce } from 'sxy-lib/objects.js'\nimport { packageName } from '../../config.js'\nimport { log } from '../../output.js'\nimport type { AllowedArguments, ParsedArguments } from '../../types.js'\n\nimport { getAllowedFlags } from './getAllowedFlags.js'\nimport chalk from '../../packages/chalk.js'\n\nexport function parseCommandLineArguments(allowedArguments: AllowedArguments): ParsedArguments {\n    const allowedFlags = getAllowedFlags(allowedArguments)\n\n    const returnArgs: ParsedArguments = {}\n\n    for (let position = 0; position < __sxyt_commandLineArguments.length; position++) {\n        const arg = __sxyt_commandLineArguments[position]\n        if (arg === undefined) continue\n        if (arg.slice(0, 2) === '--') {\n            const longFlag = arg.slice(2)\n            const allowedArgument = allowedArguments[longFlag]\n            if (allowedArgument) {\n                if (allowedArgument.hasValue) {\n                    const value = __sxyt_commandLineArguments[++position]\n                    if (value !== undefined) returnArgs[longFlag] = value\n                } else {\n                    returnArgs[longFlag] = true\n                }\n            } else {\n                log(chalk.mediumred(`[${packageName}] Unknown option --${longFlag}`))\n                if (\n                    longFlag.length === 1\n                    && objectReduce(\n                        allowedArguments,\n                        (prev: boolean, _key: string, value: {\n                            flag?: string\n                            hasValue: boolean\n                        }) => {\n                            if (value.flag === longFlag) return true\n                            return prev\n                        },\n                        false\n                    )\n                ) {\n                    log(chalk.mediumred(`I think you meant -${longFlag}`))\n                }\n            }\n        } else if (arg.slice(0, 1) === '-') {\n            const shortFlag = arg.slice(1)\n            const longFlag = allowedFlags[shortFlag]\n            if (longFlag !== undefined) {\n                if (longFlag in returnArgs) {\n                    log(chalk.orange(\n                        `[${packageName}] Option --${longFlag} already set, being overwritten by -${shortFlag}`\n                    ))\n                }\n\n                const allowedArgument = allowedArguments[longFlag]\n                if (allowedArgument?.hasValue === true) {\n                    const value = __sxyt_commandLineArguments[++position]\n                    if (value !== undefined) returnArgs[longFlag] = value\n                } else {\n                    returnArgs[longFlag] = true\n                }\n            } else {\n                log(chalk.mediumred(`[${packageName}] Unknown flag -${shortFlag}`))\n                if (shortFlag.length > 1 && shortFlag in allowedArguments) {\n                    log(chalk.mediumred(`I think you meant --${shortFlag}`))\n                }\n            }\n        }\n    }\n\n    return returnArgs\n}\n"]}
+{"version":3,"file":"parseCommandLineArguments.js","sourceRoot":"","sources":["../../../src/cli/lib/parseCommandLineArguments.ts"],"names":[],"mappings":"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","sourcesContent":["// watch:\n// once:\n// // --config configLocation\n\n\nimport { reduce as objectReduce } from 'sxy-lib/objects.js'\nimport { packageName, cliName } from '../../config.js'\nimport { log } from '../../output.js'\nimport type { AllowedArguments, ParsedArguments } from '../../types.js'\n\nimport { getAllowedFlags } from './getAllowedFlags.js'\nimport chalk from '../../packages/chalk.js'\n\n// exit code for a usage error - distinct from the run's own 0/3/4/5, so a caller can tell\n// \"you asked for something I do not understand\" from \"the tests failed\"\nexport const usageErrorExitCode = 2\n\nexport function parseCommandLineArguments(allowedArguments: AllowedArguments): ParsedArguments {\n    const allowedFlags = getAllowedFlags(allowedArguments)\n\n    const returnArgs: ParsedArguments = {}\n    // collected rather than reported one at a time, so a mistyped command line is fixed in\n    // one go rather than one option per run\n    const unknownArgs: string[] = []\n\n    for (let position = 0; position < __sxyt_commandLineArguments.length; position++) {\n        const arg = __sxyt_commandLineArguments[position]\n        if (arg === undefined) continue\n        if (arg.slice(0, 2) === '--') {\n            const longFlag = arg.slice(2)\n            const allowedArgument = allowedArguments[longFlag]\n            if (allowedArgument) {\n                if (allowedArgument.hasValue) {\n                    const value = __sxyt_commandLineArguments[++position]\n                    if (value !== undefined) returnArgs[longFlag] = value\n                } else {\n                    returnArgs[longFlag] = true\n                }\n            } else {\n                unknownArgs.push(`--${longFlag}`)\n                log(chalk.mediumred(`[${packageName}] Unknown option --${longFlag}`))\n                if (\n                    longFlag.length === 1\n                    && objectReduce(\n                        allowedArguments,\n                        (prev: boolean, _key: string, value: {\n                            flag?: string\n                            hasValue: boolean\n                        }) => {\n                            if (value.flag === longFlag) return true\n                            return prev\n                        },\n                        false\n                    )\n                ) {\n                    log(chalk.mediumred(`I think you meant -${longFlag}`))\n                }\n            }\n        } else if (arg.slice(0, 1) === '-') {\n            const shortFlag = arg.slice(1)\n            const longFlag = allowedFlags[shortFlag]\n            if (longFlag !== undefined) {\n                if (longFlag in returnArgs) {\n                    log(chalk.orange(\n                        `[${packageName}] Option --${longFlag} already set, being overwritten by -${shortFlag}`\n                    ))\n                }\n\n                const allowedArgument = allowedArguments[longFlag]\n                if (allowedArgument?.hasValue === true) {\n                    const value = __sxyt_commandLineArguments[++position]\n                    if (value !== undefined) returnArgs[longFlag] = value\n                } else {\n                    returnArgs[longFlag] = true\n                }\n            } else {\n                unknownArgs.push(`-${shortFlag}`)\n                log(chalk.mediumred(`[${packageName}] Unknown flag -${shortFlag}`))\n                if (shortFlag.length > 1 && shortFlag in allowedArguments) {\n                    log(chalk.mediumred(`I think you meant --${shortFlag}`))\n                }\n            }\n        }\n    }\n\n    // stop rather than run something other than what was asked for: an ignored option can\n    // mean the wrong tests, or a whole suite where a single filtered test was wanted\n    if (unknownArgs.length > 0) {\n        log(chalk.orange(`Run \\`${cliName} help\\` to see the available options.`))\n        process.exit(usageErrorExitCode)\n    }\n\n    return returnArgs\n}\n"]}

package/dist/cli/lib/resolveCommand.d.ts

@@ -0,0 +1,8 @@
+export declare const commands: readonly ["init", "once", "watch", "help"];
+export type Command = typeof commands[number];
+export interface ResolvedCommand {
+    command: Command;
+    commandArgs: string[];
+}
+export declare function resolveCommand(args: string[]): ResolvedCommand;
+//# sourceMappingURL=resolveCommand.d.ts.map

package/dist/cli/lib/resolveCommand.js

@@ -0,0 +1,47 @@
+export const commands = ['init', 'once', 'watch', 'help'];
+function isCommand(value) {
+    return commands.includes(value);
+}
+// The options that consume the next argument, so `--filter-it -h` is understood as a filter
+// for "-h" rather than a request for help. Worst case if this drifts from the option lists
+// in watch.ts and once.ts is that such an argument shows help instead.
+const valueTakingFlags = new Set([
+    '--config', '-c',
+    '--test-files', '-t',
+    '--filter', '-f',
+    '--filter-it', '-i',
+    '--filter-describe', '-d',
+    '--status-file', '-s'
+]);
+function wantsHelp(commandArgs) {
+    for (let position = 0; position < commandArgs.length; position++) {
+        const arg = commandArgs[position];
+        if (arg === undefined)
+            continue;
+        if (valueTakingFlags.has(arg)) {
+            position++; // skip the value, whatever it looks like
+            continue;
+        }
+        if (arg === '--help' || arg === '-h')
+            return true;
+    }
+    return false;
+}
+// Routes the raw argv tail to a command. Extracted from the entry module so the routing can
+// be tested without running a command as a side effect of importing it.
+export function resolveCommand(args) {
+    const first = args[0];
+    if (first !== undefined && isCommand(first)) {
+        const commandArgs = args.slice(1);
+        // asking a command for help describes it rather than running it
+        return { command: (wantsHelp(commandArgs)) ? 'help' : first, commandArgs };
+    }
+    if (first !== undefined && first.startsWith('--') && isCommand(first.slice(2))) {
+        const commandArgs = args.slice(1);
+        const command = first.slice(2);
+        return { command: (wantsHelp(commandArgs)) ? 'help' : command, commandArgs };
+    }
+    // no command given - everything is an argument to the default
+    return { command: (wantsHelp(args)) ? 'help' : 'watch', commandArgs: args };
+}
+//# sourceMappingURL=resolveCommand.js.map

package/dist/cli/lib/resolveCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCommand.js","sourceRoot":"","sources":["../../../src/cli/lib/resolveCommand.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AASlE,SAAS,SAAS,CAAC,KAAa;IAC5B,OAAQ,QAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC1D,CAAC;AAED,4FAA4F;AAC5F,2FAA2F;AAC3F,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC7B,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;CACxB,CAAC,CAAA;AAEF,SAAS,SAAS,CAAC,WAAqB;IACpC,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;QACjC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ;QAC/B,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,EAAE,CAAA,CAAC,yCAAyC;YACpD,SAAQ;QACZ,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IACrD,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC;AAED,4FAA4F;AAC5F,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAc;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IAErB,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACjC,gEAAgE;QAChE,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAA;IAC9E,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAY,CAAA;QACzC,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,CAAA;IAChF,CAAC;IAED,8DAA8D;IAC9D,OAAO,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;AAC/E,CAAC","sourcesContent":["export const commands = ['init', 'once', 'watch', 'help'] as const\n\nexport type Command = typeof commands[number]\n\nexport interface ResolvedCommand {\n    command: Command\n    commandArgs: string[]\n}\n\nfunction isCommand(value: string): value is Command {\n    return (commands as readonly string[]).includes(value)\n}\n\n// The options that consume the next argument, so `--filter-it -h` is understood as a filter\n// for \"-h\" rather than a request for help. Worst case if this drifts from the option lists\n// in watch.ts and once.ts is that such an argument shows help instead.\nconst valueTakingFlags = new Set([\n    '--config', '-c',\n    '--test-files', '-t',\n    '--filter', '-f',\n    '--filter-it', '-i',\n    '--filter-describe', '-d',\n    '--status-file', '-s'\n])\n\nfunction wantsHelp(commandArgs: string[]): boolean {\n    for (let position = 0; position < commandArgs.length; position++) {\n        const arg = commandArgs[position]\n        if (arg === undefined) continue\n        if (valueTakingFlags.has(arg)) {\n            position++ // skip the value, whatever it looks like\n            continue\n        }\n        if (arg === '--help' || arg === '-h') return true\n    }\n    return false\n}\n\n// Routes the raw argv tail to a command. Extracted from the entry module so the routing can\n// be tested without running a command as a side effect of importing it.\nexport function resolveCommand(args: string[]): ResolvedCommand {\n    const first = args[0]\n\n    if (first !== undefined && isCommand(first)) {\n        const commandArgs = args.slice(1)\n        // asking a command for help describes it rather than running it\n        return { command: (wantsHelp(commandArgs)) ? 'help' : first, commandArgs }\n    }\n\n    if (first !== undefined && first.startsWith('--') && isCommand(first.slice(2))) {\n        const commandArgs = args.slice(1)\n        const command = first.slice(2) as Command\n        return { command: (wantsHelp(commandArgs)) ? 'help' : command, commandArgs }\n    }\n\n    // no command given - everything is an argument to the default\n    return { command: (wantsHelp(args)) ? 'help' : 'watch', commandArgs: args }\n}\n"]}

package/dist/cli/lib/runDescribe.d.ts

@@ -1,3 +1,4 @@
+import { type StopSignal } from './stopSignal.js';
 import type { FinalConfig, Describe, DescribeResult } from '../../types.js';
-export declare function runDescribe(config: FinalConfig, describe: Describe, itFilter?: string): Promise<DescribeResult>;
+export declare function runDescribe(config: FinalConfig, describe: Describe, itFilter?: string, stop?: StopSignal): Promise<DescribeResult>;
 //# sourceMappingURL=runDescribe.d.ts.map

package/dist/cli/lib/runDescribe.js

@@ -2,6 +2,7 @@ import { timeProfileAsync } from './timeProfier.js';
 import { parseDescribe } from './parseDescribe.js';
 import { runDescribeRun } from './runDescribeRun.js';
 import { captureLogs } from './consoleCapture.js';
+import { makeStopSignal, stopIfFailFast } from './stopSignal.js';
 function createDescribeErrorResult(describe, error) {
     return {
         counter: describe.counter,
@@ -16,7 +17,7 @@ function createDescribeErrorResult(describe, error) {
         error
     };
 }
-export function runDescribe(config, describe, itFilter) {
+export function runDescribe(config, describe, itFilter, stop = makeStopSignal()) {
     return timeProfileAsync(`run describe ${describe.thing}`, async () => {
         const logs = [];
         const startTime = new Date().getTime();
@@ -25,7 +26,7 @@ export function runDescribe(config, describe, itFilter) {
                 const parsedDescribe = await parseDescribe(config, describe, itFilter);
                 return parsedDescribe.error !== undefined
                     ? createDescribeErrorResult(describe, parsedDescribe.error)
-                    : await runDescribeRun(config, describe, parsedDescribe);
+                    : await runDescribeRun(config, describe, parsedDescribe, stop);
             }
             catch (e) {
                 return createDescribeErrorResult(describe, e);
@@ -33,6 +34,8 @@ export function runDescribe(config, describe, itFilter) {
         });
         describeResult.time = new Date().getTime() - startTime;
         describeResult.logs = logs;
+        // a describe that threw stops the run just as a failing test does
+        stopIfFailFast(config, stop, describeResult.error !== undefined);
         return describeResult;
     });
 }

package/dist/cli/lib/runDescribe.js.map

@@ -1 +1 @@
-{"version":3,"file":"runDescribe.js","sourceRoot":"","sources":["../../../src/cli/lib/runDescribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAIjD,SAAS,yBAAyB,CAAC,QAAkB,EAAE,KAAc;IACjE,OAAO;QACH,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,EAAE,6BAA6B;QACtC,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE;YACd,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;SACZ;QACD,KAAK;KACR,CAAA;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CACvB,MAAmB,EACnB,QAAkB,EAClB,QAAiB;IAEjB,OAAO,gBAAgB,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,IAAI,GAAgB,EAAE,CAAA;QAE5B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAA;QAEtC,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACtD,IAAI,CAAC;gBACD,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;gBACtE,OAAO,cAAc,CAAC,KAAK,KAAK,SAAS;oBACrC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC3D,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;YAChE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,yBAAyB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;YACjD,CAAC;QACL,CAAC,CAAC,CAAA;QAEF,cAAc,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAA;QACtD,cAAc,CAAC,IAAI,GAAG,IAAI,CAAA;QAE1B,OAAO,cAAc,CAAA;IACzB,CAAC,CAAC,CAAA;AACN,CAAC","sourcesContent":["import { timeProfileAsync } from './timeProfier.js'\nimport { parseDescribe } from './parseDescribe.js'\nimport { runDescribeRun } from './runDescribeRun.js'\nimport { captureLogs } from './consoleCapture.js'\n\nimport type { FinalConfig, Describe, DescribeResult } from '../../types.js'\n\nfunction createDescribeErrorResult(describe: Describe, error: unknown): DescribeResult {\n    return {\n        counter: describe.counter,\n        thing: describe.thing,\n        success: false,\n        time: 0, // overwritten by runDescribe\n        itResults: [],\n        itResultsSummary: {\n            total: 0,\n            passes: 0\n        },\n        error\n    }\n}\n\nexport function runDescribe(\n    config: FinalConfig,\n    describe: Describe,\n    itFilter?: string\n): Promise<DescribeResult> {\n    return timeProfileAsync(`run describe ${describe.thing}`, async () => {\n        const logs: unknown[][] = []\n\n        const startTime = new Date().getTime()\n\n        const describeResult = await captureLogs(logs, async () => {\n            try {\n                const parsedDescribe = await parseDescribe(config, describe, itFilter)\n                return parsedDescribe.error !== undefined\n                    ? createDescribeErrorResult(describe, parsedDescribe.error)\n                    : await runDescribeRun(config, describe, parsedDescribe)\n            } catch (e) {\n                return createDescribeErrorResult(describe, e)\n            }\n        })\n\n        describeResult.time = new Date().getTime() - startTime\n        describeResult.logs = logs\n\n        return describeResult\n    })\n}\n"]}
+{"version":3,"file":"runDescribe.js","sourceRoot":"","sources":["../../../src/cli/lib/runDescribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAmB,MAAM,iBAAiB,CAAA;AAIjF,SAAS,yBAAyB,CAAC,QAAkB,EAAE,KAAc;IACjE,OAAO;QACH,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,EAAE,6BAA6B;QACtC,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE;YACd,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;SACZ;QACD,KAAK;KACR,CAAA;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CACvB,MAAmB,EACnB,QAAkB,EAClB,QAAiB,EACjB,OAAmB,cAAc,EAAE;IAEnC,OAAO,gBAAgB,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,IAAI,GAAgB,EAAE,CAAA;QAE5B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAA;QAEtC,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACtD,IAAI,CAAC;gBACD,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;gBACtE,OAAO,cAAc,CAAC,KAAK,KAAK,SAAS;oBACrC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC3D,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,CAAA;YACtE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,yBAAyB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;YACjD,CAAC;QACL,CAAC,CAAC,CAAA;QAEF,cAAc,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAA;QACtD,cAAc,CAAC,IAAI,GAAG,IAAI,CAAA;QAE1B,kEAAkE;QAClE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;QAEhE,OAAO,cAAc,CAAA;IACzB,CAAC,CAAC,CAAA;AACN,CAAC","sourcesContent":["import { timeProfileAsync } from './timeProfier.js'\nimport { parseDescribe } from './parseDescribe.js'\nimport { runDescribeRun } from './runDescribeRun.js'\nimport { captureLogs } from './consoleCapture.js'\n\nimport { makeStopSignal, stopIfFailFast, type StopSignal } from './stopSignal.js'\n\nimport type { FinalConfig, Describe, DescribeResult } from '../../types.js'\n\nfunction createDescribeErrorResult(describe: Describe, error: unknown): DescribeResult {\n    return {\n        counter: describe.counter,\n        thing: describe.thing,\n        success: false,\n        time: 0, // overwritten by runDescribe\n        itResults: [],\n        itResultsSummary: {\n            total: 0,\n            passes: 0\n        },\n        error\n    }\n}\n\nexport function runDescribe(\n    config: FinalConfig,\n    describe: Describe,\n    itFilter?: string,\n    stop: StopSignal = makeStopSignal()\n): Promise<DescribeResult> {\n    return timeProfileAsync(`run describe ${describe.thing}`, async () => {\n        const logs: unknown[][] = []\n\n        const startTime = new Date().getTime()\n\n        const describeResult = await captureLogs(logs, async () => {\n            try {\n                const parsedDescribe = await parseDescribe(config, describe, itFilter)\n                return parsedDescribe.error !== undefined\n                    ? createDescribeErrorResult(describe, parsedDescribe.error)\n                    : await runDescribeRun(config, describe, parsedDescribe, stop)\n            } catch (e) {\n                return createDescribeErrorResult(describe, e)\n            }\n        })\n\n        describeResult.time = new Date().getTime() - startTime\n        describeResult.logs = logs\n\n        // a describe that threw stops the run just as a failing test does\n        stopIfFailFast(config, stop, describeResult.error !== undefined)\n\n        return describeResult\n    })\n}\n"]}

package/dist/cli/lib/runDescribeRun.d.ts

@@ -1,3 +1,4 @@
+import { type StopSignal } from './stopSignal.js';
 import type { FinalConfig, Describe, DescribeResult, ParsedDescribe } from '../../types.js';
-export declare function runDescribeRun(config: FinalConfig, describe: Describe, parsedIts: ParsedDescribe): Promise<DescribeResult>;
+export declare function runDescribeRun(config: FinalConfig, describe: Describe, parsedIts: ParsedDescribe, stop?: StopSignal): Promise<DescribeResult>;
 //# sourceMappingURL=runDescribeRun.d.ts.map

package/dist/cli/lib/runDescribeRun.js

@@ -2,7 +2,8 @@ import { timeProfileAsync } from './timeProfier.js';
 import { runTasks } from './runTasks.js';
 import { debug } from '../../output.js';
 import { runIt } from './runIt.js';
-export function runDescribeRun(config, describe, parsedIts) {
+import { makeStopSignal, stopIfFailFast } from './stopSignal.js';
+export function runDescribeRun(config, describe, parsedIts, stop = makeStopSignal()) {
     return timeProfileAsync(`run describe, run its ${describe.thing}`, async () => {
         const { its, beforeDescribeExports, afterDescribeFunc, beforeEachTestFunc, afterEachTestFunc } = parsedIts;
         const parallelOverride = describe.meta === undefined
@@ -11,12 +12,17 @@ export function runDescribeRun(config, describe, parsedIts) {
         const isParallel = parallelOverride ?? config.execution.tests === 'parallel';
         const itPromises = [];
         for (const it of its) {
+            // checked before starting, so the failing test is the last one that runs
+            if (stop.stopped)
+                break;
             const itPromise = runIt(config, it, beforeEachTestFunc, afterEachTestFunc);
             itPromises.push(itPromise);
             if (!isParallel)
-                await itPromise;
+                stopIfFailFast(config, stop, (await itPromise).success === false);
         }
         const itResults = await Promise.all(itPromises);
+        // in parallel mode the tests are already in flight, so this only stops later work
+        stopIfFailFast(config, stop, itResults.some(itResult => itResult.success === false));
         const itResultsSummary = {
             total: 0,
             passes: 0