tape-six-proc 1.2.4 → 1.2.6

package/README.md

@@ -88,6 +88,8 @@ LLM-friendly documentation is available:
 
 The most recent releases:
 
+- 1.2.6 _Updated dependencies. Added AI agent rule files. Improved workflows._
+- 1.2.5 _Synchronized with `tape-six` 1.7.6+. Simplified CLI via shared config utilities. Added `--info` flag. Fixed Deno stdout flush._
 - 1.2.4 _Synchronized with `tape-six` 1.7.4. Added Min reporter support. Improved docs and npm keywords._
 - 1.2.3 _Updated dependencies, cleaned up docs, added AI-friendly links and TS info._
 - 1.2.2 _Synchronized the implementation with `tape-six` 1.7.0._

package/bin/tape6-proc-node.js

@@ -1,29 +1,16 @@
 #!/usr/bin/env node
 
 import process from 'node:process';
-import os from 'node:os';
 import {fileURLToPath} from 'node:url';
 
-import {
-  getReporterFileName,
-  getReporterType,
-  resolveTests,
-  resolvePatterns,
-  runtime
-} from 'tape-six/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from 'tape-six/utils/config.js';
 
 import {getReporter, setReporter} from 'tape-six/test.js';
 import {selectTimer} from 'tape-six/utils/timer.js';
 
 import TestWorker from '../src/TestWorker.js';
 
-const options = {},
-  rootFolder = process.cwd();
-
-let flags = '',
-  parallel = '',
-  runFileArgs = [],
-  files = [];
+const rootFolder = process.cwd();
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -35,125 +22,44 @@ const showSelf = () => {
   process.exit(0);
 };
 
-const config = () => {
-  if (process.argv.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  let parIsSet = false;
-
-  for (let i = 2; i < process.argv.length; ++i) {
-    const arg = process.argv[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < process.argv.length) {
-        flags += process.argv[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      if (++i < process.argv.length) {
-        parallel = process.argv[i];
-        parIsSet = true;
-        if (!parallel || isNaN(parallel)) {
-          parallel = '';
-          parIsSet = false;
-        }
-      }
-      continue;
-    }
-    if (arg == '-r' || arg == '--runFileArgs') {
-      if (++i < process.argv.length) {
-        runFileArgs.push(process.argv[i]);
-      }
-      continue;
-    }
-    files.push(arg);
-  }
-
-  flags = (process.env.TAPE6_FLAGS || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
-
-  if (!parIsSet) {
-    parallel = process.env.TAPE6_PAR || parallel;
-  }
-  if (parallel) {
-    parallel = Math.max(0, +parallel);
-    if (parallel === Infinity) parallel = 0;
-  } else {
-    parallel = 0;
-  }
-  if (!parallel) {
-    if (typeof navigator !== 'undefined' && navigator.hardwareConcurrency) {
-      parallel = navigator.hardwareConcurrency;
-    } else {
-      try {
-        parallel = os.availableParallelism();
-      } catch (e) {
-        void e;
-        parallel = 1;
-      }
+const main = async () => {
+  const runFileArgs = [];
+  const options = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false},
+    '--runFileArgs': {
+      aliases: ['-r'],
+      isValueRequired: true,
+      fn: (_, _name, value) => runFileArgs.push(value)
     }
-  }
-
-  options.runFileArgs = runFileArgs;
-};
-
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('tape-six/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        process.env.NO_COLOR ||
-        process.env.NODE_DISABLE_COLORS ||
-        process.env.FORCE_COLOR === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
-  }
-
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, runtime.name);
-  }
-};
+  });
+  options.flags.runFileArgs = runFileArgs;
 
-const main = async () => {
-  config();
-  await init();
-  await selectTimer();
+  const [files] = await Promise.all([
+    initFiles(options.files, rootFolder),
+    initReporter(getReporter, setReporter, options.flags),
+    selectTimer()
+  ]);
 
   process.on('uncaughtException', (error, origin) => {
     console.error('UNHANDLED ERROR:', origin, error);
     process.exit(1);
   });
 
+  if (options.optionFlags['--info'] === '') {
+    showInfo(options, files);
+    await new Promise(r => process.stdout.write('', r));
+    process.exit(0);
+  }
+
   if (!files.length) {
     console.log('No files found.');
+    await new Promise(r => process.stdout.write('', r));
     process.exit(1);
   }
 
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, parallel, options);
+    worker = new TestWorker(reporter, options.parallel, options.flags);
 
   reporter.report({type: 'test', test: 0});
 
@@ -170,6 +76,7 @@ const main = async () => {
     fail: hasFailed
   });
 
+  await new Promise(r => process.stdout.write('', r));
   process.exit(hasFailed ? 1 : 0);
 };
 

package/llms-full.txt

@@ -55,8 +55,10 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 - `--flags FLAGS` (`-f`) — output control flags (see Supported flags below).
 - `--par N` (`-p`) — number of parallel processes. Default: all CPU cores (via `os.availableParallelism()` or `navigator.hardwareConcurrency`).
 - `--runFileArgs ARGS` (`-r`) — extra arguments passed to the spawned interpreter. Can be specified multiple times. Mainly used for Deno permissions.
+- `--info` — prints runtime, reporter, parallelism, flags, and test files, then exits.
 - `--self` — prints the absolute path to `tape6-proc.js` and exits. Used in cross-runtime scripts.
 - Positional arguments: test file glob patterns. If none given, reads from configuration.
+- Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
 ### Examples
 
@@ -161,9 +163,11 @@ Environment-specific subsections (`node`, `deno`, `bun`) are supported. The runn
 
 ### Main CLI (`bin/tape6-proc-node.js`)
 
-1. Parses CLI arguments (`--flags`, `--par`, `--runFileArgs`, positional test patterns).
-2. Selects reporter: TTY (default for terminals), TAP, JSONL, or Min (based on environment variables).
-3. Resolves test files from configuration or CLI patterns using `tape-six/utils/config.js`.
+Delegates argument parsing, reporter setup, and file resolution to `tape-six/utils/config.js`:
+
+1. Calls `getOptions()` to parse CLI arguments (`--flags`, `--par`, `--runFileArgs`, `--info`, positional test patterns).
+2. Calls `initReporter()` to select the reporter: TTY (default for terminals), TAP, JSONL, or Min (based on environment variables).
+3. Calls `initFiles()` to resolve test files from configuration or CLI patterns.
 4. Creates a `TestWorker` instance and executes all test files.
 5. Reports final results and exits with code 0 (success) or 1 (failures).
 
@@ -174,7 +178,6 @@ Extends `EventServer` from `tape-six`. Manages parallel subprocess execution:
 - **`constructor(reporter, numberOfTasks, options)`** — initializes with a reporter, concurrency limit, and options. Generates a UUID prefix for JSONL parsing.
 - **`makeTask(fileName)`** — spawns a child process for a test file using `dollar-shell`. Sets up stream pipelines for stdout and stderr. Returns a task ID.
 - **`destroyTask(id)`** — cleans up a completed task.
-- **`getConcurrency()`** — static method, returns available CPU cores.
 
 ### Stream pipeline
 
@@ -205,7 +208,7 @@ process.stderr → TextDecoderStream → lines → wrap-lines → report
 
 ## Dependencies
 
-- **`tape-six`** — the core test library. Imports: `State.js`, `utils/EventServer.js`, `utils/makeDeferred.js`, `utils/config.js`, `test.js`, reporters (`TTYReporter`, `TapReporter`, `JSONLReporter`, `MinReporter`), `utils/timer.js`.
+- **`tape-six`** — the core test library. Imports: `utils/config.js` (`getOptions`, `initFiles`, `initReporter`, `showInfo`), `test.js` (`getReporter`, `setReporter`), `utils/timer.js`, `State.js`, `utils/EventServer.js`, `utils/makeDeferred.js`.
 - **`dollar-shell`** — cross-runtime process spawning. Imports: `spawn`, `currentExecPath`, `runFileArgs`.
 
 ## Writing tests

package/llms.txt

@@ -54,8 +54,10 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 - `--flags FLAGS` (`-f`) — output control flags (same as tape6: F=failures only, T=time, B=banner, D=data, O=fail once, N=assert number, M=monochrome, C=don't capture console, H=hide streams). Can be specified multiple times.
 - `--par N` (`-p`) — number of parallel processes (default: all CPU cores).
 - `--runFileArgs ARGS` (`-r`) — extra arguments for the spawned interpreter. Can be specified multiple times. Mainly for Deno permissions.
+- `--info` — prints runtime, reporter, parallelism, flags, and test files, then exits.
 - `--self` — prints the path to `tape6-proc.js` (for cross-runtime scripts).
 - No arguments: runs tests from configuration.
+- Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
 ### Cross-runtime usage
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six-proc",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Process-isolated test runner for tape-six. Runs each test file in its own subprocess. Works with Node, Deno, and Bun. Supports TypeScript without transpilation.",
   "type": "module",
   "bin": {
@@ -56,8 +56,8 @@
     "llms-full.txt"
   ],
   "dependencies": {
-    "dollar-shell": "^1.1.10",
-    "tape-six": "^1.7.4"
+    "dollar-shell": "^1.1.12",
+    "tape-six": "^1.7.11"
   },
   "tape6": {
     "tests": [

package/src/TestWorker.js

@@ -1,5 +1,4 @@
 import process from 'node:process';
-import os from 'node:os';
 import {sep} from 'node:path';
 import {pathToFileURL, fileURLToPath} from 'node:url';
 import crypto from 'node:crypto';
@@ -17,7 +16,7 @@ import wrap from './streams/wrap-lines.js';
 const baseName = pathToFileURL(process.cwd() + sep);
 
 export default class TestWorker extends EventServer {
-  constructor(reporter, numberOfTasks = TestWorker.getConcurrency(), options) {
+  constructor(reporter, numberOfTasks, options) {
     super(reporter, numberOfTasks, options);
     this.counter = 0;
     this.idToWorker = {};
@@ -38,7 +37,10 @@ export default class TestWorker extends EventServer {
             TAPE6_TEST: id,
             TAPE6_TEST_FILE_NAME: fileName,
             TAPE6_JSONL: 'Y',
-            TAPE6_JSONL_PREFIX: this.prefix
+            TAPE6_JSONL_PREFIX: this.prefix,
+            TAPE6_MIN: '',
+            TAPE6_TAP: '',
+            TAPE6_TTY: ''
           }
         }
       );
@@ -112,16 +114,4 @@ export default class TestWorker extends EventServer {
       delete this.idToWorker[id];
     }
   }
-  static getConcurrency() {
-    if (typeof navigator !== 'undefined' && navigator.hardwareConcurrency) {
-      return navigator.hardwareConcurrency;
-    }
-    try {
-      return os.availableParallelism();
-    } catch (e) {
-      void e;
-      // squelch
-    }
-    return 1;
-  }
 }