sxy-test-runner 2.3.19 → 2.3.22

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

@@ -1 +1 @@
-{"version":3,"file":"watchFilesAndRunTestsNodeWatch.js","sourceRoot":"","sources":["../../../src/cli/lib/watchFilesAndRunTestsNodeWatch.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\nimport chalk from '../../packages/chalk.js'\nimport minimatch from 'minimatch'\nimport slash from '../../packages/slash.js'\nimport { out, log, debug } from '../../output.js'\n\nimport { runTests } from './runTests.js'\nimport { buildDependencyTree } from './buildDependencyTree.js'\nimport { globArgCombine } from './globArgCombine.js'\nimport { addBasePath } from './addBasePath.js'\nimport { watchFilesNodeWatch } from './watchFilesNodeWatch.js'\nimport { filter } from './filter.js'\nimport { remove as arrayRemove } from 'sxy-lib/arrays.js'\n\nimport type { FinalConfig, DependencyTrees, OutFn, TestExecutionFilters } from '../../types.js'\nimport { ReRunManageState } from './makeWatchRunState.js'\nimport { ReRunManager } from './reRunManager.js'\nimport { inspect } from 'util'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport async function watchFilesAndRunTestsNodeWatch(\n    config: FinalConfig,\n    //testFiles: Set<string>,\n    dependencyTrees: DependencyTrees,\n    failingTests: string[],\n    reRunManager: ReRunManager,\n    //watchRunState: WatchRunState,\n    customOut?: OutFn,\n    executionFilters: TestExecutionFilters = {}\n): Promise<void> {\n    const projectDir = process.cwd()\n\n    await timeProfileAsync('init watching', async () => {\n        debug('failingTests', failingTests)\n\n        const testsGlobs = addBasePath(config.testsBase, config.tests)\n        const testsIgnoreGlobs = addBasePath(config.testsBase, config.testsIgnore)\n\n        // indentify a test file\n        const testFilter = (file: string): boolean => {\n            return minimatch(file, globArgCombine(testsGlobs))\n                && !minimatch(file, globArgCombine(testsIgnoreGlobs))\n                && (\n                    config.testsFilter === undefined\n                    || config.testsFilter === ''\n                    || filter(config.testsBase, config.testsFilter, file)\n                )\n        }\n\n        let changedFiles: Array<[string, string]> = []\n        let timeout: ReturnType<typeof setTimeout> | null = null\n\n        if (config.watch.watchFilesBase === '') {\n            out('No config.watch.watchFilesBase provided, defaulting to \\'.\\'')\n            config.watch.watchFilesBase = '.'\n        }\n\n        await watchFilesNodeWatch(config, watchEvent)\n\n        function watchEvent(filename: string, event: string): void {\n            debug('handle watch event ', filename, event)\n\n            filename = slash(filename)\n\n            // remove dep tree for any tests that are deleted, avoiding trying to run it later\n            if (event === 'remove') {\n                debug('removing test', filename)\n                if (filename in dependencyTrees) {\n                    reRunManager.state.allTestFiles.delete(filename)\n                    delete dependencyTrees[filename]\n                }\n            }\n\n            // info on the event found\n            out(chalk.grey`change: ${filename} (${event})`)\n\n            // add the file to changed files\n            changedFiles.push([filename, event])\n\n            // wait 100ms after any change before processing, to avoid multiple execution?\n            if (timeout) {\n                clearTimeout(timeout)\n            }\n\n            timeout = setTimeout(() => {\n                void timeProfileAsync('handle changed files', async () => {\n                    debug('changedFiles', changedFiles)\n                    try {\n                        // build related test list\n                        //const tests: string[] = []\n                        const tests = new Set<string>\n                        for (const [file, fileEvent] of changedFiles) {\n                            debug('check', file)\n                            debug('1 tests', tests)\n                            if (fileEvent !== 'remove') { // only check if it's a test if it exists (has not just been removed)\n                                if (testFilter(file)) { // it is a test file itself, add to run list\n                                    debug('its a test', file)\n                                    //tests.push(file)\n                                    tests.add(file)\n                                    if (!(file in dependencyTrees)) { // if its a new test\n                                        debug('try to add a new test', file)\n                                        addNewTest(file)\n                                    }\n                                }\n                            }\n                            debug('dtrees', dependencyTrees)\n                            debug('2 tests', tests)\n                            for (const f of Object.getOwnPropertyNames(dependencyTrees)) {\n                                debug('dep tree', f, dependencyTrees[f])\n                                if (dependencyTrees[f]?.some(dep => dep === file) === true) { // a test depends on this file\n                                    debug('its a dependency', file)\n                                    //tests.push(f)\n                                    tests.add(f)\n                                }\n                            }\n                        }\n\n                        changedFiles = []\n\n                        debug('tests', tests)\n\n                        if (tests.size > 0) {\n                            await timeProfileAsync('build list of files to test and request a run', async () => {\n                                debug('tests', tests)\n\n                                // NOTE: the original guarded this cleanup with `config.reRunFailingTests`\n                                // (missing the `.watch.` prefix every other reference here uses), which is\n                                // always undefined - so this block never ran. Preserved as dead code rather\n                                // than newly activating it as part of a TS conversion.\n\n                                debug('tests', tests)\n                                debug('failingTests', failingTests)\n                                debug('reRunFailingTests', config.watch.reRunFailingTests)\n\n                                const toTest = config.watch.reRunFailingTests\n                                    ? [...new Set([...tests, ...failingTests])].reverse()\n                                    : [...tests].reverse()\n\n                                //console.log('toTest', inspect(toTest))\n\n                                debug('run tests on change')\n                                debug('toTest', toTest)\n\n                                //console.log('reRunManager.state.untestedFiles', inspect(reRunManager.state.untestedFiles))\n\n                                //console.log('tests', inspect(tests))\n\n                                reRunManager.state.untestedFiles = reRunManager.state.untestedFiles.union(tests)\n\n                                //console.log('unioned', inspect(reRunManager.state.untestedFiles))\n\n                                reRunManager.requestRun(\n                                    'auto',\n                                    () => runTests(\n                                        config,\n                                        reRunManager.state.untestedFiles,\n                                        reRunManager,\n                                        //failingTests,\n                                        'refresh',\n                                        //reRunManager.state,\n                                        customOut,\n                                        executionFilters\n                                    )\n                                )\n                                //await watchRunState.currentRun\n                            })\n                        }\n                    } catch (e) {\n                        log('watch handler error', e)\n                    }\n                })\n            }, 33)\n        } // end of watch event\n\n        function addNewTest(testFile: string): void {\n            debug('new test', testFile)\n            const dependencyTree = buildDependencyTree(config, testFile)\n            dependencyTrees[testFile] = dependencyTree\n                .map(file => slash(file).slice(projectDir.length + 1))\n                .filter(f => f !== testFile)\n        }\n    })\n\n    // NOTE: \"watching...\" is intentionally NOT printed here. watch() already emits it,\n    // tied to a real milestone (the initial test run finishing, or no tests found).\n    // Printing it again here produced a duplicate \"watching...\" on every startup.\n    // out(chalk.brightblue`watching...`)\n}\n"]}
+{"version":3,"file":"watchFilesAndRunTestsNodeWatch.js","sourceRoot":"","sources":["../../../src/cli/lib/watchFilesAndRunTestsNodeWatch.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\nimport chalk from '../../packages/chalk.js'\nimport minimatch from 'minimatch'\nimport slash from '../../packages/slash.js'\nimport { out as mainOut, log, debug } from '../../output.js'\n\nimport { agentChange } from './agentReport.js'\nimport { runTests } from './runTests.js'\nimport { buildDependencyTree } from './buildDependencyTree.js'\nimport { globArgCombine } from './globArgCombine.js'\nimport { addBasePath } from './addBasePath.js'\nimport { watchFilesNodeWatch } from './watchFilesNodeWatch.js'\nimport { filter } from './filter.js'\nimport { remove as arrayRemove } from 'sxy-lib/arrays.js'\n\nimport type { FinalConfig, DependencyTrees, OutFn, TestExecutionFilters } from '../../types.js'\nimport { ReRunManageState } from './makeWatchRunState.js'\nimport { ReRunManager } from './reRunManager.js'\nimport { inspect } from 'util'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport async function watchFilesAndRunTestsNodeWatch(\n    config: FinalConfig,\n    //testFiles: Set<string>,\n    dependencyTrees: DependencyTrees,\n    failingTests: string[],\n    reRunManager: ReRunManager,\n    //watchRunState: WatchRunState,\n    customOut?: OutFn,\n    executionFilters: TestExecutionFilters = {}\n): Promise<void> {\n    const projectDir = process.cwd()\n    // agent mode passes a sink here, so its own change lines are the only ones printed\n    const out = customOut ?? mainOut\n\n    await timeProfileAsync('init watching', async () => {\n        debug('failingTests', failingTests)\n\n        const testsGlobs = addBasePath(config.testsBase, config.tests)\n        const testsIgnoreGlobs = addBasePath(config.testsBase, config.testsIgnore)\n\n        // indentify a test file\n        const testFilter = (file: string): boolean => {\n            return minimatch(file, globArgCombine(testsGlobs))\n                && !minimatch(file, globArgCombine(testsIgnoreGlobs))\n                && (\n                    config.testsFilter === undefined\n                    || config.testsFilter === ''\n                    || filter(config.testsBase, config.testsFilter, file)\n                )\n        }\n\n        let changedFiles: Array<[string, string]> = []\n        let timeout: ReturnType<typeof setTimeout> | null = null\n\n        if (config.watch.watchFilesBase === '') {\n            out('No config.watch.watchFilesBase provided, defaulting to \\'.\\'')\n            config.watch.watchFilesBase = '.'\n        }\n\n        await watchFilesNodeWatch(config, watchEvent)\n\n        function watchEvent(filename: string, event: string): void {\n            debug('handle watch event ', filename, event)\n\n            filename = slash(filename)\n\n            // remove dep tree for any tests that are deleted, avoiding trying to run it later\n            if (event === 'remove') {\n                debug('removing test', filename)\n                if (filename in dependencyTrees) {\n                    reRunManager.state.allTestFiles.delete(filename)\n                    delete dependencyTrees[filename]\n                }\n            }\n\n            // info on the event found\n            out(chalk.grey`change: ${filename} (${event})`)\n            agentChange(config, filename, event)\n\n            // add the file to changed files\n            changedFiles.push([filename, event])\n\n            // wait 100ms after any change before processing, to avoid multiple execution?\n            if (timeout) {\n                clearTimeout(timeout)\n            }\n\n            timeout = setTimeout(() => {\n                void timeProfileAsync('handle changed files', async () => {\n                    debug('changedFiles', changedFiles)\n                    try {\n                        // build related test list\n                        //const tests: string[] = []\n                        const tests = new Set<string>\n                        for (const [file, fileEvent] of changedFiles) {\n                            debug('check', file)\n                            debug('1 tests', tests)\n                            if (fileEvent !== 'remove') { // only check if it's a test if it exists (has not just been removed)\n                                if (testFilter(file)) { // it is a test file itself, add to run list\n                                    debug('its a test', file)\n                                    //tests.push(file)\n                                    tests.add(file)\n                                    if (!(file in dependencyTrees)) { // if its a new test\n                                        debug('try to add a new test', file)\n                                        addNewTest(file)\n                                    }\n                                }\n                            }\n                            debug('dtrees', dependencyTrees)\n                            debug('2 tests', tests)\n                            for (const f of Object.getOwnPropertyNames(dependencyTrees)) {\n                                debug('dep tree', f, dependencyTrees[f])\n                                if (dependencyTrees[f]?.some(dep => dep === file) === true) { // a test depends on this file\n                                    debug('its a dependency', file)\n                                    //tests.push(f)\n                                    tests.add(f)\n                                }\n                            }\n                        }\n\n                        changedFiles = []\n\n                        debug('tests', tests)\n\n                        if (tests.size > 0) {\n                            await timeProfileAsync('build list of files to test and request a run', async () => {\n                                debug('tests', tests)\n                                debug('reRunFailingTests', config.watch.reRunFailingTests)\n\n                                // changes accumulate here because an 'auto' request made while a\n                                // run is in flight is coalesced into the queued one - everything\n                                // edited in the meantime still has to be covered\n                                reRunManager.state.untestedFiles\n                                    = reRunManager.state.untestedFiles.union(tests)\n\n                                reRunManager.requestRun(\n                                    'auto',\n                                    () => {\n                                        // resolved when the run actually starts, not when it is\n                                        // queued, so a coalesced request picks up the later edits\n                                        const toTest = (config.watch.reRunFailingTests)\n                                            ? reRunManager.state.untestedFiles\n                                                .union(reRunManager.state.failedTestFiles)\n                                            : new Set(reRunManager.state.untestedFiles)\n\n                                        // consumed by this run - without this they are retested\n                                        // on every later run for the rest of the session\n                                        reRunManager.state.untestedFiles = new Set()\n\n                                        debug('run tests on change')\n                                        debug('toTest', toTest)\n\n                                        return runTests(\n                                            config,\n                                            toTest,\n                                            reRunManager,\n                                            'refresh',\n                                            customOut,\n                                            executionFilters\n                                        )\n                                    }\n                                )\n                            })\n                        }\n                    } catch (e) {\n                        log('watch handler error', e)\n                    }\n                })\n            }, 33)\n        } // end of watch event\n\n        function addNewTest(testFile: string): void {\n            debug('new test', testFile)\n            const dependencyTree = buildDependencyTree(config, testFile)\n            dependencyTrees[testFile] = dependencyTree\n                .map(file => slash(file).slice(projectDir.length + 1))\n                .filter(f => f !== testFile)\n        }\n    })\n\n    // NOTE: \"watching...\" is intentionally NOT printed here. watch() already emits it,\n    // tied to a real milestone (the initial test run finishing, or no tests found).\n    // Printing it again here produced a duplicate \"watching...\" on every startup.\n    // out(chalk.brightblue`watching...`)\n}\n"]}

package/dist/cli/once.js

@@ -63,6 +63,9 @@ export async function once() {
     }
     const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js');
     const config = applyConfigDefaults(userConfig);
+    // agent reporting is a watch mode concern - `once` already ends with an exit code, so a
+    // config setting it must not leak in here
+    config.watch.agent = false;
     const { validateConfig } = await import('./lib/validateConfig.js');
     validateConfig(config);
     //console.log('run setup')

package/dist/cli/once.js.map

@@ -1 +1 @@
-{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/cli/once.ts"],"names":[],"mappings":"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","sourcesContent":["\r\nimport chalk from '../packages/chalk.js'\r\n\r\nimport { packageName, configFileNames } from '../config.js'\r\nimport { out, log } from '../output.js'\r\n\r\nimport type { AllowedArguments } from '../types.js'\r\nimport { setEnv } from './lib/setEnv.js'\r\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\r\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\r\nimport { isTest } from './lib/isTest.js'\r\n\r\n\r\nexport async function once(): Promise<void> {\r\n    out(chalk.brightblue`[${packageName}]...`)\r\n\r\n    const startTime = new Date().getTime()\r\n\r\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\r\n    const allowedClArguments: AllowedArguments = {\r\n        config: {\r\n            flag: 'c',\r\n            hasValue: true\r\n        },\r\n        'test-files': {\r\n            flag: 't',\r\n            hasValue: true\r\n        },\r\n        filter: {\r\n            flag: 'f',\r\n            hasValue: true\r\n        },\r\n        'filter-it': {\r\n            flag: 'i',\r\n            hasValue: true\r\n        },\r\n        'filter-describe': {\r\n            flag: 'd',\r\n            hasValue: true\r\n        }\r\n    }\r\n    const clArguments = parseCommandLineArguments(allowedClArguments)\r\n    //debug('clArguments', clArguments)\r\n\r\n    setEnv()\r\n\r\n    const { loadConfig } = await import('./lib/loadConfig.js')\r\n    const userConfig = (typeof clArguments.config === 'string')\r\n        ? await loadConfig(clArguments.config)\r\n        : await loadConfig()\r\n\r\n    if ('test-files' in clArguments) {\r\n        const testFilesPattern = clArguments['test-files']\r\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\r\n            throw new Error('No pattern specified for --test-files or -t argument')\r\n        }\r\n        //console.log('Looking for tests using pattern: ' + testFilesPattern) // eslint-disable-line no-console\r\n        userConfig.tests = testFilesPattern\r\n    }\r\n\r\n    if ('filter' in clArguments) {\r\n        const filter = clArguments.filter\r\n        if (typeof filter !== 'string' || filter === '') {\r\n            throw new Error('No pattern specified for --filter or -f argument')\r\n        }\r\n        //console.log('Filtering tests using pattern: ' + filter) // eslint-disable-line no-console\r\n        userConfig.testsFilter = filter\r\n    }\r\n\r\n    const filterIt = clArguments['filter-it']\r\n    const filterDescribe = clArguments['filter-describe']\r\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\r\n    if (filterDescribe === true || filterDescribe === '') {\r\n        throw new Error('No substring specified for --filter-describe')\r\n    }\r\n\r\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\r\n    const config = applyConfigDefaults(userConfig)\r\n\r\n    const { validateConfig } = await import('./lib/validateConfig.js')\r\n    validateConfig(config)\r\n\r\n    //console.log('run setup')\r\n    //console.log(util.inspect(config))\r\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\r\n    await doUserSetup(config)\r\n    //console.log('ran setup')\r\n    \r\n    out(chalk.brightblue(findingTestsMessage(config)))\r\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\r\n    const testFiles = await findTestFiles(config)\r\n\r\n    if (testFiles.size === 0) {\r\n        out(chalk.mediumred(`[${packageName}] Found no tests.`\r\n            + '\\nCreate tests matching the patterns, '\r\n            + `\\nor set new patterns in ${configFileNames.map(x => `${x}.js/cjs/mjs`).join(' or ')}`))\r\n\r\n        const endTime = new Date().getTime()\r\n        const time = endTime - startTime\r\n        out(chalk.brightblue(`[${packageName}] time: ${time.toLocaleString()}ms`))\r\n\r\n        // setup has already run by this point, so teardown must run too, or its side\r\n        // effects are left behind\r\n        const { doUserTeardown } = await import('./lib/doUserTeardown.js')\r\n        await doUserTeardown(config)\r\n\r\n        process.exit(4)\r\n    }\r\n\r\n    out(chalk.brightblue(foundTestsMessage(testFiles.size)))\r\n\r\n    // testFiles.size is guaranteed non-zero here - the no-tests case exited above\r\n    const { runTests } = await import('./lib/runTests.js')\r\n    log(chalk.brightblue`running tests...`)\r\n    const testsResult = await runTests(\r\n        config, testFiles,\r\n        undefined,\r\n        (isTest) ? 'refresh' : 'cached',\r\n        undefined,\r\n        {\r\n            it: filterIt,\r\n            describe: filterDescribe\r\n        }\r\n    )\r\n    // 5 - not 4 - so callers can tell \"no test files matched\" from \"filters matched nothing\"\r\n    const exitCode = testsResult === null ? 5 : testsResult ? 0 : 3\r\n\r\n    const time = new Date().getTime() - startTime\r\n    out(chalk.grey`\\n${time.toLocaleString()}ms\\n`)\r\n\r\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\r\n    await doUserTeardown(config)\r\n\r\n    process.exit(exitCode)\r\n}\r\n"]}
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/cli/once.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport chalk from '../packages/chalk.js'\n\nimport { packageName, configFileNames } from '../config.js'\nimport { out, log } from '../output.js'\n\nimport type { AllowedArguments } from '../types.js'\nimport { setEnv } from './lib/setEnv.js'\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\nimport { isTest } from './lib/isTest.js'\n\n\nexport async function once(): Promise<void> {\n    out(chalk.brightblue`[${packageName}]...`)\n\n    const startTime = new Date().getTime()\n\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\n    const allowedClArguments: AllowedArguments = {\n        config: {\n            flag: 'c',\n            hasValue: true\n        },\n        'test-files': {\n            flag: 't',\n            hasValue: true\n        },\n        filter: {\n            flag: 'f',\n            hasValue: true\n        },\n        'filter-it': {\n            flag: 'i',\n            hasValue: true\n        },\n        'filter-describe': {\n            flag: 'd',\n            hasValue: true\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    setEnv()\n\n    const { loadConfig } = await import('./lib/loadConfig.js')\n    const userConfig = (typeof clArguments.config === 'string')\n        ? await loadConfig(clArguments.config)\n        : await loadConfig()\n\n    if ('test-files' in clArguments) {\n        const testFilesPattern = clArguments['test-files']\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\n            throw new Error('No pattern specified for --test-files or -t argument')\n        }\n        //console.log('Looking for tests using pattern: ' + testFilesPattern) // eslint-disable-line no-console\n        userConfig.tests = testFilesPattern\n    }\n\n    if ('filter' in clArguments) {\n        const filter = clArguments.filter\n        if (typeof filter !== 'string' || filter === '') {\n            throw new Error('No pattern specified for --filter or -f argument')\n        }\n        //console.log('Filtering tests using pattern: ' + filter) // eslint-disable-line no-console\n        userConfig.testsFilter = filter\n    }\n\n    const filterIt = clArguments['filter-it']\n    const filterDescribe = clArguments['filter-describe']\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\n    if (filterDescribe === true || filterDescribe === '') {\n        throw new Error('No substring specified for --filter-describe')\n    }\n\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\n    const config = applyConfigDefaults(userConfig)\n    // agent reporting is a watch mode concern - `once` already ends with an exit code, so a\n    // config setting it must not leak in here\n    config.watch.agent = false\n\n    const { validateConfig } = await import('./lib/validateConfig.js')\n    validateConfig(config)\n\n    //console.log('run setup')\n    //console.log(util.inspect(config))\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\n    await doUserSetup(config)\n    //console.log('ran setup')\n    \n    out(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n\n    if (testFiles.size === 0) {\n        out(chalk.mediumred(`[${packageName}] Found no tests.`\n            + '\\nCreate tests matching the patterns, '\n            + `\\nor set new patterns in ${configFileNames.map(x => `${x}.js/cjs/mjs`).join(' or ')}`))\n\n        const endTime = new Date().getTime()\n        const time = endTime - startTime\n        out(chalk.brightblue(`[${packageName}] time: ${time.toLocaleString()}ms`))\n\n        // setup has already run by this point, so teardown must run too, or its side\n        // effects are left behind\n        const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n        await doUserTeardown(config)\n\n        process.exit(4)\n    }\n\n    out(chalk.brightblue(foundTestsMessage(testFiles.size)))\n\n    // testFiles.size is guaranteed non-zero here - the no-tests case exited above\n    const { runTests } = await import('./lib/runTests.js')\n    log(chalk.brightblue`running tests...`)\n    const testsResult = await runTests(\n        config, testFiles,\n        undefined,\n        (isTest) ? 'refresh' : 'cached',\n        undefined,\n        {\n            it: filterIt,\n            describe: filterDescribe\n        }\n    )\n    // 5 - not 4 - so callers can tell \"no test files matched\" from \"filters matched nothing\"\n    const exitCode = testsResult === null ? 5 : testsResult ? 0 : 3\n\n    const time = new Date().getTime() - startTime\n    out(chalk.grey`\\n${time.toLocaleString()}ms\\n`)\n\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n    await doUserTeardown(config)\n\n    process.exit(exitCode)\n}\n"]}

package/dist/cli/watch.js

@@ -8,7 +8,6 @@ import { isTest } from './lib/isTest.js';
 import { makeRunManagerState } from './lib/makeWatchRunState.js';
 import { makeReRunManager } from './lib/reRunManager.js';
 export async function watch() {
-    out(chalk.brightblue `[${packageName}]...`);
     const startTime = new Date().getTime();
     const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js');
     const allowedClArguments = {
@@ -31,10 +30,26 @@ export async function watch() {
         'filter-describe': {
             flag: 'd',
             hasValue: true
+        },
+        'status-file': {
+            flag: 's',
+            hasValue: true
+        },
+        'agent': {
+            hasValue: false
         }
     };
     const clArguments = parseCommandLineArguments(allowedClArguments);
     //debug('clArguments', clArguments)
+    // agent mode owns stdout, so the banner and every later message below is routed through
+    // agentOut - a sink when the flag is on. Announced before the config loads, so a reader
+    // sees the process is alive even if startup is slow.
+    const agentMode = clArguments.agent === true;
+    const { agentInit, agentFound, agentRunStart, agentDone, agentWatching, agentSilentOut } = await import('./lib/agentReport.js');
+    agentInit(agentMode);
+    const agentOut = (agentMode) ? agentSilentOut : out;
+    const runsOut = (agentMode) ? agentSilentOut : undefined;
+    agentOut(chalk.brightblue `[${packageName}]...`);
     setEnv();
     const { loadConfig } = await import('./lib/loadConfig.js');
     const userConfig = (typeof clArguments.config === 'string')
@@ -54,6 +69,13 @@ export async function watch() {
         }
         userConfig.testsFilter = filter;
     }
+    if ('status-file' in clArguments) {
+        const statusFile = clArguments['status-file'];
+        if (typeof statusFile !== 'string' || statusFile === '') {
+            throw new Error('No file path specified for --status-file or -s argument');
+        }
+        userConfig.watch = { ...userConfig.watch, statusFile };
+    }
     const filterIt = clArguments['filter-it'];
     const filterDescribe = clArguments['filter-describe'];
     if (filterIt === true || filterIt === '')
@@ -64,8 +86,15 @@ export async function watch() {
     const executionFilters = { it: filterIt, describe: filterDescribe };
     const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js');
     const config = applyConfigDefaults(userConfig);
+    if (agentMode)
+        config.watch.agent = true;
+    // not silenced in agent mode - a config error is fatal, so losing the message is worse
+    // than breaking the one-line-per-event contract
     const { validateConfig } = await import('./lib/validateConfig.js');
     validateConfig(config);
+    // no run has finished yet, so the status file starts at -1 rather than stale
+    const { resetStatusFile, statusCodes, writeStatusFile } = await import('./lib/statusFile.js');
+    resetStatusFile(config);
     const { doUserSetup } = await import('./lib/doUserSetup.js');
     await doUserSetup(config);
     // watch mode never reaches an end of its own, so teardown only gets a chance on the way
@@ -76,10 +105,11 @@ export async function watch() {
         teardown: doUserTeardown,
         exit: code => process.exit(code)
     });
-    out(chalk.brightblue(findingTestsMessage(config)));
+    agentOut(chalk.brightblue(findingTestsMessage(config)));
     const { findTestFiles } = await import('./lib/findTestFiles.js');
     const testFiles = await findTestFiles(config);
     debug(testFiles);
+    agentFound(config, testFiles.size);
     // global store of the dependencies of tests
     let dependencyTrees = {};
     // store failing tests so we can re-run them.
@@ -87,20 +117,20 @@ export async function watch() {
     const reRunManager = makeReRunManager(null, makeRunManagerState({
         allTestFiles: testFiles,
         lastTestFiles: testFiles
-    }));
+    }), runsOut);
     const { runTests } = await import('./lib/runTests.js');
     let initialTestRun = null;
     if (testFiles.size > 0) {
-        out(chalk.brightblue(foundTestsMessage(testFiles.size)));
+        agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)));
         const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js');
-        out(chalk.brightblue `finding initial dependency trees...`);
+        agentOut(chalk.brightblue `finding initial dependency trees...`);
         dependencyTrees = await buildDependencyTrees(config, testFiles);
         if (config.watch.runAllOnStartup) {
-            out(chalk.brightblue `running initial tests...`);
-            initialTestRun = runTests(config, testFiles, reRunManager, (isTest) ? 'refresh' : 'cached', undefined, executionFilters).then(async (testsResult) => {
+            agentOut(chalk.brightblue `running initial tests...`);
+            initialTestRun = runTests(config, testFiles, reRunManager, (isTest) ? 'refresh' : 'cached', runsOut, executionFilters).then(async (testsResult) => {
                 const time = new Date().getTime() - startTime;
                 //await new Promise((resolve) => setTimeout(resolve, 100))
-                out(chalk.grey `\n${time.toLocaleString()}ms`);
+                agentOut(chalk.grey `\n${time.toLocaleString()}ms`);
                 return testsResult;
             });
             reRunManager.state.currentRun = initialTestRun;
@@ -109,7 +139,11 @@ export async function watch() {
         }
     }
     else {
-        out(chalk.orange `no test files found`);
+        agentOut(chalk.orange `no test files found`);
+        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found');
+        // still reported as a run, so a reader waiting on a done line always gets one
+        const run = agentRunStart(config, 0);
+        agentDone(config, run, statusCodes.couldNotRun, 'no test files found', null, new Date().getTime() - startTime, 0);
     }
     const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js');
     await watchFilesAndRunTests(config, 
@@ -117,12 +151,13 @@ export async function watch() {
     dependencyTrees, failingTests, // CHECK this should also be in state
     reRunManager, 
     //watchRunState,
-    undefined, executionFilters);
-    out(chalk.brightblue `watching...`);
+    runsOut, executionFilters);
+    agentOut(chalk.brightblue `watching...`);
+    agentWatching(config, testFiles.size);
     const { listenToUser } = await import('./lib/listenToUser.js');
     listenToUser(reRunManager, files => () => {
-        return runTests(config, files, reRunManager, 'refresh', undefined, executionFilters);
-    }, config.watch.ttyActionsOnKeypress, initialTestRun).catch(e => { throw e; });
+        return runTests(config, files, reRunManager, 'refresh', runsOut, executionFilters);
+    }, config.watch.ttyActionsOnKeypress, initialTestRun, process.stdin, runsOut).catch(e => { throw e; });
     // park forever - watch mode ends by being signalled, and the shutdown handlers registered
     // above run the user's teardown on the way out
     await new Promise(() => { });

package/dist/cli/watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from '../packages/chalk.js'\r\n\r\nimport { packageName } from '../config.js'\r\nimport { out, debug } from '../output.js'\r\n\r\nimport type { AllowedArguments, DependencyTrees } from '../types.js'\r\nimport { setEnv } from './lib/setEnv.js'\r\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\r\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\r\nimport { isTest } from './lib/isTest.js'\r\nimport { makeRunManagerState } from './lib/makeWatchRunState.js'\r\nimport { makeReRunManager } from './lib/reRunManager.js'\r\n\r\nexport async function watch(): Promise<void> {\r\n    out(chalk.brightblue`[${packageName}]...`)\r\n\r\n    const startTime = new Date().getTime()\r\n\r\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\r\n    const allowedClArguments: AllowedArguments = {\r\n        'config': {\r\n            flag: 'c',\r\n            hasValue: true\r\n        },\r\n        'test-files': {\r\n            flag: 't',\r\n            hasValue: true\r\n        },\r\n        'filter': {\r\n            flag: 'f',\r\n            hasValue: true\r\n        },\r\n        'filter-it': {\r\n            flag: 'i',\r\n            hasValue: true\r\n        },\r\n        'filter-describe': {\r\n            flag: 'd',\r\n            hasValue: true\r\n        }\r\n    }\r\n    const clArguments = parseCommandLineArguments(allowedClArguments)\r\n    //debug('clArguments', clArguments)\r\n\r\n    setEnv()\r\n\r\n    const { loadConfig } = await import('./lib/loadConfig.js')\r\n    const userConfig = (typeof clArguments.config === 'string')\r\n        ? await loadConfig(clArguments.config)\r\n        : await loadConfig()\r\n\r\n    if ('test-files' in clArguments) {\r\n        const testFilesPattern = clArguments['test-files']\r\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\r\n            throw new Error('No pattern specified for --test-files or -t argument')\r\n        }\r\n        userConfig.tests = testFilesPattern\r\n    }\r\n\r\n    if ('filter' in clArguments) {\r\n        const filter = clArguments.filter\r\n        if (typeof filter !== 'string' || filter === '') {\r\n            throw new Error('No pattern specified for --filter or -f argument')\r\n        }\r\n        userConfig.testsFilter = filter\r\n    }\r\n\r\n    const filterIt = clArguments['filter-it']\r\n    const filterDescribe = clArguments['filter-describe']\r\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\r\n    if (filterDescribe === true || filterDescribe === '') {\r\n        throw new Error('No substring specified for --filter-describe')\r\n    }\r\n    const executionFilters = { it: filterIt, describe: filterDescribe }\r\n\r\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\r\n    const config = applyConfigDefaults(userConfig)\r\n\r\n    const { validateConfig } = await import('./lib/validateConfig.js')\r\n    validateConfig(config)\r\n\r\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\r\n    await doUserSetup(config)\r\n\r\n    // watch mode never reaches an end of its own, so teardown only gets a chance on the way\r\n    // out. Registered here so it pairs with the setup above and covers the initial run too.\r\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\r\n    const { registerShutdownHandlers } = await import('./lib/shutdown.js')\r\n    registerShutdownHandlers(config, {\r\n        teardown: doUserTeardown,\r\n        exit: code => process.exit(code)\r\n    })\r\n\r\n    out(chalk.brightblue(findingTestsMessage(config)))\r\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\r\n    const testFiles = await findTestFiles(config)\r\n    debug(testFiles)\r\n\r\n    // global store of the dependencies of tests\r\n    let dependencyTrees: DependencyTrees = {}\r\n    // store failing tests so we can re-run them.\r\n    const failingTests: string[] = []\r\n   \r\n    const reRunManager = makeReRunManager(\r\n        null,\r\n        makeRunManagerState({\r\n            allTestFiles: testFiles,\r\n            lastTestFiles: testFiles\r\n        }),\r\n    )\r\n\r\n    const { runTests } = await import('./lib/runTests.js')\r\n    let initialTestRun: Promise<boolean | null> | null = null\r\n\r\n    if (testFiles.size > 0) {\r\n        out(chalk.brightblue(foundTestsMessage(testFiles.size)))\r\n        const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\r\n        out(chalk.brightblue`finding initial dependency trees...`)\r\n        dependencyTrees = await buildDependencyTrees(config, testFiles)\r\n\r\n        if (config.watch.runAllOnStartup) {\r\n            out(chalk.brightblue`running initial tests...`)\r\n            initialTestRun = runTests(\r\n                config, testFiles, reRunManager,\r\n                (isTest) ? 'refresh' : 'cached',\r\n                undefined, executionFilters\r\n            ).then(async testsResult => {\r\n                const time = new Date().getTime() - startTime\r\n                //await new Promise((resolve) => setTimeout(resolve, 100))\r\n                out(chalk.grey`\\n${time.toLocaleString()}ms`)\r\n                return testsResult\r\n            })\r\n            reRunManager.state.currentRun = initialTestRun\r\n            // do we need to catch errors like this?\r\n            initialTestRun.catch(err => `Error during initial test run: ${err}`)\r\n        }\r\n    } else {\r\n        out(chalk.orange`no test files found`)\r\n    }\r\n\r\n    const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js')\r\n    await watchFilesAndRunTests(\r\n        config,\r\n        //testFiles,\r\n        dependencyTrees,\r\n        failingTests, // CHECK this should also be in state\r\n        reRunManager,\r\n        //watchRunState,\r\n        undefined,\r\n        executionFilters\r\n    )\r\n\r\n\r\n    out(chalk.brightblue`watching...`)\r\n\r\n    const { listenToUser } = await import('./lib/listenToUser.js')\r\n    listenToUser(\r\n        reRunManager,\r\n        files => () => {\r\n            return runTests(config, files, reRunManager, 'refresh', undefined, executionFilters)\r\n        },\r\n        config.watch.ttyActionsOnKeypress,\r\n        initialTestRun\r\n    ).catch(e => { throw e })\r\n\r\n\r\n    // park forever - watch mode ends by being signalled, and the shutdown handlers registered\r\n    // above run the user's teardown on the way out\r\n    await new Promise<void>(() => {})\r\n}\r\n"]}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from '../packages/chalk.js'\n\nimport { packageName } from '../config.js'\nimport { out, debug } from '../output.js'\n\nimport type { AllowedArguments, DependencyTrees, OutFn } from '../types.js'\nimport { setEnv } from './lib/setEnv.js'\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\nimport { isTest } from './lib/isTest.js'\nimport { makeRunManagerState } from './lib/makeWatchRunState.js'\nimport { makeReRunManager } from './lib/reRunManager.js'\n\nexport async function watch(): Promise<void> {\n    const startTime = new Date().getTime()\n\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\n    const allowedClArguments: AllowedArguments = {\n        'config': {\n            flag: 'c',\n            hasValue: true\n        },\n        'test-files': {\n            flag: 't',\n            hasValue: true\n        },\n        'filter': {\n            flag: 'f',\n            hasValue: true\n        },\n        'filter-it': {\n            flag: 'i',\n            hasValue: true\n        },\n        'filter-describe': {\n            flag: 'd',\n            hasValue: true\n        },\n        'status-file': {\n            flag: 's',\n            hasValue: true\n        },\n        'agent': {\n            hasValue: false\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    // agent mode owns stdout, so the banner and every later message below is routed through\n    // agentOut - a sink when the flag is on. Announced before the config loads, so a reader\n    // sees the process is alive even if startup is slow.\n    const agentMode = clArguments.agent === true\n    const {\n        agentInit, agentFound, agentRunStart, agentDone, agentWatching, agentSilentOut\n    } = await import('./lib/agentReport.js')\n    agentInit(agentMode)\n    const agentOut: OutFn = (agentMode) ? agentSilentOut : out\n    const runsOut = (agentMode) ? agentSilentOut : undefined\n\n    agentOut(chalk.brightblue`[${packageName}]...`)\n\n    setEnv()\n\n    const { loadConfig } = await import('./lib/loadConfig.js')\n    const userConfig = (typeof clArguments.config === 'string')\n        ? await loadConfig(clArguments.config)\n        : await loadConfig()\n\n    if ('test-files' in clArguments) {\n        const testFilesPattern = clArguments['test-files']\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\n            throw new Error('No pattern specified for --test-files or -t argument')\n        }\n        userConfig.tests = testFilesPattern\n    }\n\n    if ('filter' in clArguments) {\n        const filter = clArguments.filter\n        if (typeof filter !== 'string' || filter === '') {\n            throw new Error('No pattern specified for --filter or -f argument')\n        }\n        userConfig.testsFilter = filter\n    }\n\n    if ('status-file' in clArguments) {\n        const statusFile = clArguments['status-file']\n        if (typeof statusFile !== 'string' || statusFile === '') {\n            throw new Error('No file path specified for --status-file or -s argument')\n        }\n        userConfig.watch = { ...userConfig.watch, statusFile }\n    }\n\n    const filterIt = clArguments['filter-it']\n    const filterDescribe = clArguments['filter-describe']\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\n    if (filterDescribe === true || filterDescribe === '') {\n        throw new Error('No substring specified for --filter-describe')\n    }\n    const executionFilters = { it: filterIt, describe: filterDescribe }\n\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\n    const config = applyConfigDefaults(userConfig)\n    if (agentMode) config.watch.agent = true\n\n    // not silenced in agent mode - a config error is fatal, so losing the message is worse\n    // than breaking the one-line-per-event contract\n    const { validateConfig } = await import('./lib/validateConfig.js')\n    validateConfig(config)\n\n    // no run has finished yet, so the status file starts at -1 rather than stale\n    const { resetStatusFile, statusCodes, writeStatusFile } = await import('./lib/statusFile.js')\n    resetStatusFile(config)\n\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\n    await doUserSetup(config)\n\n    // watch mode never reaches an end of its own, so teardown only gets a chance on the way\n    // out. Registered here so it pairs with the setup above and covers the initial run too.\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n    const { registerShutdownHandlers } = await import('./lib/shutdown.js')\n    registerShutdownHandlers(config, {\n        teardown: doUserTeardown,\n        exit: code => process.exit(code)\n    })\n\n    agentOut(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n    debug(testFiles)\n    agentFound(config, testFiles.size)\n\n    // global store of the dependencies of tests\n    let dependencyTrees: DependencyTrees = {}\n    // store failing tests so we can re-run them.\n    const failingTests: string[] = []\n   \n    const reRunManager = makeReRunManager(\n        null,\n        makeRunManagerState({\n            allTestFiles: testFiles,\n            lastTestFiles: testFiles\n        }),\n        runsOut\n    )\n\n    const { runTests } = await import('./lib/runTests.js')\n    let initialTestRun: Promise<boolean | null> | null = null\n\n    if (testFiles.size > 0) {\n        agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)))\n        const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\n        agentOut(chalk.brightblue`finding initial dependency trees...`)\n        dependencyTrees = await buildDependencyTrees(config, testFiles)\n\n        if (config.watch.runAllOnStartup) {\n            agentOut(chalk.brightblue`running initial tests...`)\n            initialTestRun = runTests(\n                config, testFiles, reRunManager,\n                (isTest) ? 'refresh' : 'cached',\n                runsOut, executionFilters\n            ).then(async testsResult => {\n                const time = new Date().getTime() - startTime\n                //await new Promise((resolve) => setTimeout(resolve, 100))\n                agentOut(chalk.grey`\\n${time.toLocaleString()}ms`)\n                return testsResult\n            })\n            reRunManager.state.currentRun = initialTestRun\n            // do we need to catch errors like this?\n            initialTestRun.catch(err => `Error during initial test run: ${err}`)\n        }\n    } else {\n        agentOut(chalk.orange`no test files found`)\n        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found')\n        // still reported as a run, so a reader waiting on a done line always gets one\n        const run = agentRunStart(config, 0)\n        agentDone(\n            config, run, statusCodes.couldNotRun, 'no test files found',\n            null, new Date().getTime() - startTime, 0\n        )\n    }\n\n    const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js')\n    await watchFilesAndRunTests(\n        config,\n        //testFiles,\n        dependencyTrees,\n        failingTests, // CHECK this should also be in state\n        reRunManager,\n        //watchRunState,\n        runsOut,\n        executionFilters\n    )\n\n\n    agentOut(chalk.brightblue`watching...`)\n    agentWatching(config, testFiles.size)\n\n    const { listenToUser } = await import('./lib/listenToUser.js')\n    listenToUser(\n        reRunManager,\n        files => () => {\n            return runTests(config, files, reRunManager, 'refresh', runsOut, executionFilters)\n        },\n        config.watch.ttyActionsOnKeypress,\n        initialTestRun,\n        process.stdin,\n        runsOut\n    ).catch(e => { throw e })\n\n\n    // park forever - watch mode ends by being signalled, and the shutdown handlers registered\n    // above run the user's teardown on the way out\n    await new Promise<void>(() => {})\n}\n"]}

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 export declare const packageName = "sxy-test-runner";
-export declare const cliName = "sxy-test";
+export declare const cliName = "sxyt";
 export declare const configFileNames: string[];
 export declare const configLocations: string[];
 export declare const debugging = false;

package/dist/config.js

@@ -1,5 +1,5 @@
 export const packageName = 'sxy-test-runner';
-export const cliName = 'sxy-test';
+export const cliName = 'sxyt';
 export const configFileNames = ['sxyt.config', 'sxy-test-runner.config'];
 export const configLocations = ['', 'config']; // locations where the configs may be placed in proj folder
 export const debugging = false;

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAA;AAEjC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA,CAAC,2DAA2D;AAEzG,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;AACxD,SAAS,OAAO,CAAC,KAAyB;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACzE,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,CAAA;AACtD,CAAC;AAED,sEAAsE;AACtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA","sourcesContent":["export const packageName = 'sxy-test-runner'\n\nexport const cliName = 'sxy-test'\n\nexport const configFileNames = ['sxyt.config', 'sxy-test-runner.config']\nexport const configLocations = ['', 'config'] // locations where the configs may be placed in proj folder\n\nexport const debugging = false\n\n// Parse a boolean-ish env var. Accepts true/false and 1/0, case-insensitive,\n// tolerant of surrounding quotes and whitespace (e.g. TIME_PROFILING=\"true\").\n// Anything unrecognised (or unset) is treated as false.\nfunction envFlag(value: string | undefined): boolean {\n    if (value === undefined) return false\n    const normalized = value.trim().replace(/^[\"']|[\"']$/g, '').toLowerCase()\n    return normalized === 'true' || normalized === '1'\n}\n\n// Toggle per-phase timing output with the SXYT_TIME_PROFILING env var\n// (SXYT_TIME_PROFILING=true | 1). Defaults to off so normal runs stay clean.\nexport const showTimeProfiling = envFlag(process.env.SXYT_TIME_PROFILING)\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAA;AAE7B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA,CAAC,2DAA2D;AAEzG,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;AACxD,SAAS,OAAO,CAAC,KAAyB;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACzE,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,CAAA;AACtD,CAAC;AAED,sEAAsE;AACtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA","sourcesContent":["export const packageName = 'sxy-test-runner'\n\nexport const cliName = 'sxyt'\n\nexport const configFileNames = ['sxyt.config', 'sxy-test-runner.config']\nexport const configLocations = ['', 'config'] // locations where the configs may be placed in proj folder\n\nexport const debugging = false\n\n// Parse a boolean-ish env var. Accepts true/false and 1/0, case-insensitive,\n// tolerant of surrounding quotes and whitespace (e.g. TIME_PROFILING=\"true\").\n// Anything unrecognised (or unset) is treated as false.\nfunction envFlag(value: string | undefined): boolean {\n    if (value === undefined) return false\n    const normalized = value.trim().replace(/^[\"']|[\"']$/g, '').toLowerCase()\n    return normalized === 'true' || normalized === '1'\n}\n\n// Toggle per-phase timing output with the SXYT_TIME_PROFILING env var\n// (SXYT_TIME_PROFILING=true | 1). Defaults to off so normal runs stay clean.\nexport const showTimeProfiling = envFlag(process.env.SXYT_TIME_PROFILING)\n"]}

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface ExecutionConfig {
     describes: ExecutionMode;
     tests: ExecutionMode;
 }
+export type StatusFileConfig = string | false;
 export interface WatchConfig {
     watchFilesBase: string;
     watchFiles: GlobPattern;
@@ -14,6 +15,8 @@ export interface WatchConfig {
     runAllOnStartup: boolean;
     reRunFailingTests: boolean;
     ttyActionsOnKeypress: boolean;
+    statusFile: StatusFileConfig;
+    agent: boolean;
 }
 export type TaskExports = Record<string, unknown>;
 export type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport { DescribeMeta } from './describe.js'\nimport { FileMeta } from './meta.js'\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport interface It {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\nexport interface TestError extends Error {\n    actual?: unknown\n    expected?: unknown\n}\n\nexport interface ItResult {\n    counter: number\n    should: string\n    success: boolean | null\n    time: number\n    error?: TestError\n    logs: unknown[][]\n}\n\nexport interface ItResultsSummary {\n    total: number\n    passes: number\n}\n\nexport interface DescribeResult {\n    counter: number\n    thing: string\n    success: boolean | null\n    // total elapsed for the whole describe, filled in by runDescribe once it has finished\n    time: number\n    itResults: ItResult[]\n    itResultsSummary: ItResultsSummary\n    logs?: unknown[][]\n    error?: unknown\n}\n\nexport interface DescribeResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport interface TestFile {\n    file: string\n    describes?: Describe[]\n    meta?: FileMeta\n    error?: string | false\n    logs?: unknown[][]\n}\n\nexport interface TestResult {\n    file: string\n    success: boolean | null\n    describeResults: DescribeResult[]\n    describeResultsSummary: DescribeResultsSummary\n    logs: unknown[][]\n}\n\nexport interface TestsResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    describesTotal: number\n    describesPasses: number\n    describesInvalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- CLI argument parsing ---------------------------------------------------\n\nexport interface AllowedArgument {\n    flag?: string\n    hasValue: boolean\n}\n\nexport type AllowedArguments = Record<string, AllowedArgument>\nexport type AllowedFlags = Record<string, string>\nexport type ParsedArguments = Record<string, string | true>\n\nexport interface TestExecutionFilters {\n    describe?: string\n    it?: string\n}\n\n// -- globals ----------------------------------------------------------------\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    // eslint-disable-next-line camelcase\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    // eslint-disable-next-line camelcase\n    var __sxyt_commandLineArguments: string[]\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport { DescribeMeta } from './describe.js'\nimport { FileMeta } from './meta.js'\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\n// path to write the latest watch run status to, or false to write none\nexport type StatusFileConfig = string | false\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n    // report the session as single agent readable lines instead of the usual output\n    agent: boolean\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport interface It {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\nexport interface TestError extends Error {\n    actual?: unknown\n    expected?: unknown\n}\n\nexport interface ItResult {\n    counter: number\n    should: string\n    success: boolean | null\n    time: number\n    error?: TestError\n    logs: unknown[][]\n}\n\nexport interface ItResultsSummary {\n    total: number\n    passes: number\n}\n\nexport interface DescribeResult {\n    counter: number\n    thing: string\n    success: boolean | null\n    // total elapsed for the whole describe, filled in by runDescribe once it has finished\n    time: number\n    itResults: ItResult[]\n    itResultsSummary: ItResultsSummary\n    logs?: unknown[][]\n    error?: unknown\n}\n\nexport interface DescribeResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport interface TestFile {\n    file: string\n    describes?: Describe[]\n    meta?: FileMeta\n    error?: string | false\n    logs?: unknown[][]\n}\n\nexport interface TestResult {\n    file: string\n    success: boolean | null\n    describeResults: DescribeResult[]\n    describeResultsSummary: DescribeResultsSummary\n    logs: unknown[][]\n}\n\nexport interface TestsResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    describesTotal: number\n    describesPasses: number\n    describesInvalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- CLI argument parsing ---------------------------------------------------\n\nexport interface AllowedArgument {\n    flag?: string\n    hasValue: boolean\n}\n\nexport type AllowedArguments = Record<string, AllowedArgument>\nexport type AllowedFlags = Record<string, string>\nexport type ParsedArguments = Record<string, string | true>\n\nexport interface TestExecutionFilters {\n    describe?: string\n    it?: string\n}\n\n// -- globals ----------------------------------------------------------------\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    // eslint-disable-next-line camelcase\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    // eslint-disable-next-line camelcase\n    var __sxyt_commandLineArguments: string[]\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sxy-test-runner",
-  "version": "2.3.19",
+  "version": "2.3.22",
   "license": "MIT",
   "homepage": "https://github.com/RobertSandiford/sxy-test-runner",
   "repository": {

package/readme.md

@@ -81,7 +81,7 @@ The other config options and fairly well explained in the config. More info on t
 ```
 npx sxy-test-runner
 ```
-*sxy-test is an alias for sxy-test-runner and can be used instead*
+*sxyt and sxy-test  are aliases for sxy-test-runner and can be used instead*
 
 ("npx" can be omitted in package.json scripts)
 
@@ -122,6 +122,52 @@ large set of files and filtering their describes or tests afterward can therefor
 slower than filtering files first. Prefer `--filter` when a file glob can select the work
 you need, and use the name filters for further narrowing within those files.
 
+To have watch mode record each run's result in a file, use `-s` or `--status-file`, or set
+`watch.statusFile` in the config. This is for anything watching the suite from outside - a
+script, a notifier, an agent - that would otherwise have to read the terminal:
+
+```
+npx sxy-test-runner --status-file .sxyt-status
+```
+
+The first line is a status code, a `-`, and a short description. The second is the time the
+run finished, then the summary, then any failures, and the run's duration last:
+
+```
+1 - 2 tests failed
+2026-08-03 20:14:52 +01:00
+Tests: 8/10
+Items: 4/5
+Test Files: 1/2
+Failures:
+  f: tests/users.test.js
+    d: creating a user
+      t: rejects a duplicate email
+        e: AssertionError: expected 409 to equal 200
+      t: sends a welcome email
+        e: Error: connect ECONNREFUSED 127.0.0.1:2525
+1,204ms
+```
+
+Failures nest as `f:` file, `d:` describe, `t:` test, `e:` error - one line each. Diffs, logs
+and stack traces stay in the terminal.
+
+| code | meaning |
+| --- | --- |
+| -1 | watch mode has started, but no run has finished |
+| 0 | everything passed |
+| 1 | tests ran and failed |
+| 2 | the run died partway - a test file would not load, or a describe threw |
+| 3 | nothing ran - no test files were found, or the filters matched nothing |
+
+Watch mode writes the `-1` status on startup, so a status left over from a previous session
+is never read as the current one. Each write goes to a temporary file and is renamed into
+place, so a poller only ever sees a complete status.
+
+Name the file `.sxys` and the VS Code extension in
+[`vscode-sxyt-status/`](vscode-sxyt-status) will colour it - green when the run passed, red
+where it did not.
+
 To specific an alternate config, use -c or --config
 ```
 npx sxy-test-runner --config sxy-test-runner.alternate.config.js