tape-six-proc 1.2.6 → 1.2.7

package/README.md

@@ -88,6 +88,7 @@ LLM-friendly documentation is available:
 
 The most recent releases:
 
+- 1.2.7 _Added `--help` and `--version` flags. Updated dependencies._
 - 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._

package/bin/tape6-proc-node.js

@@ -1,9 +1,17 @@
 #!/usr/bin/env node
 
+import {readFileSync} from 'node:fs';
+import path from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {getOptions, initFiles, initReporter, showInfo} from 'tape-six/utils/config.js';
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printFlagOptions
+} from 'tape-six/utils/config.js';
 
 import {getReporter, setReporter} from 'tape-six/test.js';
 import {selectTimer} from 'tape-six/utils/timer.js';
@@ -12,6 +20,11 @@ import TestWorker from '../src/TestWorker.js';
 
 const rootFolder = process.cwd();
 
+const getVersion = () => {
+  const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+  return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+};
+
 const showSelf = () => {
   const self = new URL(import.meta.url);
   if (self.protocol === 'file:') {
@@ -22,16 +35,44 @@ const showSelf = () => {
   process.exit(0);
 };
 
+const showVersion = () => {
+  console.log('tape6-proc ' + getVersion());
+  process.exit(0);
+};
+
+const showHelp = () => {
+  console.log('tape6-proc ' + getVersion() + ' \u2014 Process-isolated test runner for tape-six\n');
+  console.log('Usage: tape6-proc [options] [files...]\n');
+  const options = [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--runFileArgs, -r <args>', 'Extra arguments for spawned interpreter (repeatable)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ];
+  console.log('Options:');
+  const width = options.reduce((max, [flag]) => Math.max(max, flag.length), 0) + 2;
+  for (const [flag, desc] of options) {
+    console.log('  ' + flag.padEnd(width) + desc);
+  }
+  printFlagOptions();
+  process.exit(0);
+};
+
 const main = async () => {
   const runFileArgs = [];
   const options = getOptions({
-    '--self': showSelf,
+    '--self': {fn: showSelf, isValueRequired: false},
     '--info': {isValueRequired: false},
     '--runFileArgs': {
       aliases: ['-r'],
       isValueRequired: true,
       fn: (_, _name, value) => runFileArgs.push(value)
-    }
+    },
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
   options.flags.runFileArgs = runFileArgs;
 

package/bin/tape6-proc.js

@@ -1,9 +1,40 @@
 #!/usr/bin/env node
 
+import {readFileSync} from 'node:fs';
+import path from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-if (process.argv.includes('--self')) {
+import {printFlagOptions} from 'tape-six/utils/config.js';
+
+const getVersion = () => {
+  const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+  return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+};
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log('tape6-proc ' + getVersion() + ' \u2014 Process-isolated test runner for tape-six\n');
+  console.log('Usage: tape6-proc [options] [files...]\n');
+  const options = [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--runFileArgs, -r <args>', 'Extra arguments for spawned interpreter (repeatable)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ];
+  console.log('Options:');
+  const width = options.reduce((max, [flag]) => Math.max(max, flag.length), 0) + 2;
+  for (const [flag, desc] of options) {
+    console.log('  ' + flag.padEnd(width) + desc);
+  }
+  printFlagOptions();
+  process.exit(0);
+} else if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  console.log('tape6-proc ' + getVersion());
+  process.exit(0);
+} else if (process.argv.includes('--self')) {
   const self = new URL(import.meta.url);
   if (self.protocol === 'file:') {
     console.log(fileURLToPath(self));

package/llms-full.txt

@@ -57,6 +57,8 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 - `--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.
+- `--help` (`-h`) — show help message and exit.
+- `--version` (`-v`) — show version and exit.
 - 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.
 
@@ -165,7 +167,7 @@ Environment-specific subsections (`node`, `deno`, `bun`) are supported. The runn
 
 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).
+1. Calls `getOptions()` to parse CLI arguments (`--flags`, `--par`, `--runFileArgs`, `--info`, `--help`, `--version`, 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.
@@ -208,7 +210,7 @@ process.stderr → TextDecoderStream → lines → wrap-lines → report
 
 ## Dependencies
 
-- **`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`.
+- **`tape-six`** — the core test library. Imports: `utils/config.js` (`getOptions`, `initFiles`, `initReporter`, `showInfo`, `printFlagOptions`), `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

@@ -56,6 +56,8 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 - `--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).
+- `--help` (`-h`) — show help message and exit.
+- `--version` (`-v`) — show version and exit.
 - No arguments: runs tests from configuration.
 - Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six-proc",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "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.12",
-    "tape-six": "^1.7.11"
+    "dollar-shell": "^1.1.13",
+    "tape-six": "^1.7.12"
   },
   "tape6": {
     "tests": [