@pixlcore/xycli 1.0.2 → 1.0.4

package/.github/workflows/offline-tests.yml

@@ -0,0 +1,39 @@
+name: Offline Tests
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / Node.js ${{ matrix.node }}
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+        node:
+          - 20.19.0
+          - 24
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Use Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v7
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run offline tests
+        run: npm run test:offline

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # xyCLI Changelog
 
+## Version v1.0.2
+
+> September 20, 2026
+
+- [`7b9023b`](https://github.com/pixlcore/xycli/commit/7b9023b390ea45b0615ff43b4d5a8d3daa3a68f3): Version 1.0.2
+- [`2114287`](https://github.com/pixlcore/xycli/commit/2114287dc98ca2cedcc6cf1b15eb7e164f697851): Feature: Sync Setup: Write out events and workflows into category sub-folders.  Fixes #2.
+- [`3f3e8a5`](https://github.com/pixlcore/xycli/commit/3f3e8a515be030e551c33a701c43e2bb3ff72569): Doc: Add two-way git tutorial
+- [`4336dc2`](https://github.com/pixlcore/xycli/commit/4336dc25924616038213b77c5892990c09fa22f5): Feature: Sync setup now supports its own "--down_cmd" for running a custom command if and only if files were written out.
+- [`7b94e63`](https://github.com/pixlcore/xycli/commit/7b94e632e2c0d86eaef5211325b259195cb30f3c): Feature: Add optional "--new" flag to sync setup, to add newly added items not already in sync set
+- [`90d065f`](https://github.com/pixlcore/xycli/commit/90d065f941578ed83783cc79bebbbdc7018a6664): Allow "--default_ext" switch to override default ".txt" file extension for neighbor property files when language cannot be detected.  Ref #1.
+
+## Version v1.0.1
+
+> September 20, 2026
+
+- [`ee12585`](https://github.com/pixlcore/xycli/commit/ee12585b36e7237d8514b9c34ce0411debf16494): Version 1.0.1
+- [`c18090a`](https://github.com/pixlcore/xycli/commit/c18090a03ebdb91772fc565b59eec22e4378df3f): Fix: Do not start delete pass if any warnings or errors occurred during the sync.
+- [`ef4e68b`](https://github.com/pixlcore/xycli/commit/ef4e68b229b8e0114c0af4a44dc1b61ba81e9e39): Test: Add more event unit tests
+
 ## Version v1.0.0
 
 > September 20, 2026

package/README.md

@@ -49,7 +49,7 @@ Save your xyOps URL and API Key:
 xy config --base_url https://xyops.example.com --api_key YOUR_API_KEY
 ```
 
-Use the base URL of your xyOps instance, without the `/api` endpoint suffix. The command creates `~/.config/xyops/cli.json` and saves the settings there.
+Use the base URL of your xyOps instance, without the `/api` endpoint suffix. On Unix and macOS, the command creates `~/.config/xyops/cli.json`. On Windows, it creates `%USERPROFILE%\.config\xyops\cli.json`.
 
 Now check your connection:
 
@@ -63,11 +63,11 @@ You should see the dashboard. If you need to set up xyOps itself, start with its
 
 xyCLI loads optional JSON configuration files on every invocation, then applies environment variables. Settings are merged in this order:
 
-| Order | Source | Purpose |
-| --- | --- | --- |
-| 1 | `/etc/xyops/cli.json` | Shared settings for the machine. |
-| 2 | `~/.config/xyops/cli.json` | Settings for your user account, overriding matching system settings. |
-| 3 | `XYOPS_` environment variables | Overrides for the current shell or command. |
+| Order | Unix and macOS | Windows | Purpose |
+| --- | --- | --- | --- |
+| 1 | `/etc/xyops/cli.json` | `%PROGRAMDATA%\xyops\cli.json` | Shared settings for the machine. |
+| 2 | `~/.config/xyops/cli.json` | `%USERPROFILE%\.config\xyops\cli.json` | Settings for your user account, overriding matching system settings. |
+| 3 | `XYOPS_` environment variables | `XYOPS_` environment variables | Overrides for the current shell or command. |
 
 Neither file is required if you supply your connection settings through the environment. Missing files are skipped; files you create must contain valid JSON. Matching top-level properties are replaced by later sources, so a user-level object such as `sync` replaces the system-level object of the same name.
 
@@ -92,7 +92,7 @@ xy config --suggest false
 xy config --color false
 ```
 
-`xy config` masks your API Key when displaying it. Updates load the **user configuration file** separately, apply only the settings specified on the command line, and save it with owner-only read/write permissions. Other user settings are preserved; settings inherited from the system file or environment are not copied into the user file. If the user file does not exist, it is created with only the settings you supply. Environment overrides still take precedence on the next invocation.
+`xy config` masks your API Key when displaying it. Updates load the **user configuration file** separately, apply only the settings specified on the command line, and save it with owner-only read/write permissions on Unix and macOS. On Windows, the file inherits the access controls of your user profile because Windows does not implement Unix permission modes. Other user settings are preserved; settings inherited from the system file or environment are not copied into the user file. If the user file does not exist, it is created with only the settings you supply. Environment overrides still take precedence on the next invocation.
 
 Every `XYOPS_` variable maps to a lowercase configuration key. For example, `XYOPS_BASE_URL` sets `base_url` and `XYOPS_ITEMS_PER_PAGE` sets `items_per_page`. Literal `true` and `false` become booleans, and numeric strings become numbers.
 
@@ -104,6 +104,14 @@ export XYOPS_API_KEY="YOUR_API_KEY"
 xy
 ```
 
+In Windows PowerShell, use the equivalent environment syntax:
+
+```powershell
+$env:XYOPS_BASE_URL = "https://xyops.example.com"
+$env:XYOPS_API_KEY = "YOUR_API_KEY"
+xy
+```
+
 Or override a display setting for one command:
 
 ```sh

package/docs/help.md

@@ -258,7 +258,7 @@ Every sync and setup command uses a built-in host-local PID lock keyed by `base_
 
 **Saved defaults**
 
-Put sync defaults under a `sync` object in `/etc/xyops/cli.json` or `~/.config/xyops/cli.json`:
+Put sync defaults under a `sync` object in the machine or user configuration file. These are `/etc/xyops/cli.json` and `~/.config/xyops/cli.json` on Unix and macOS, or `%PROGRAMDATA%\xyops\cli.json` and `%USERPROFILE%\.config\xyops\cli.json` on Windows:
 
 ```json
 {
@@ -341,7 +341,7 @@ Type `.exit` or hit `Ctrl-C` to exit.
 
 ## config
 
-View the effective CLI configuration or save one or more user settings. API keys are masked when displayed, and updated values are written to `~/.config/xyops/cli.json`.
+View the effective CLI configuration or save one or more user settings. API keys are masked when displayed. Updated values are written to `~/.config/xyops/cli.json` on Unix and macOS, or `%USERPROFILE%\.config\xyops\cli.json` on Windows.
 
 ```sh
 xy config
@@ -353,7 +353,7 @@ xy config --base_url http://localhost:5522 --api_key YOUR_API_KEY
 
 Updates load the user file separately and apply only the settings specified on the command line, preserving other user settings. System settings and environment overrides are not copied into the file. If the user file does not exist, it is created with only the supplied settings.
 
-Configuration loads `/etc/xyops/cli.json` first, then `~/.config/xyops/cli.json`, then `XYOPS_`-prefixed environment variables. Later sources override matching top-level settings. Environment overrides still take precedence over saved user settings. Common keys include `api_key`, `base_url`, `temp_dir`, `color`, `suggest`, `items_per_page`, `cache_ttl`, `raw`, and `invisible`.
+Configuration loads the machine file first, then the user file, then `XYOPS_`-prefixed environment variables. The machine and user files are `/etc/xyops/cli.json` and `~/.config/xyops/cli.json` on Unix and macOS, or `%PROGRAMDATA%\xyops\cli.json` and `%USERPROFILE%\.config\xyops\cli.json` on Windows. Later sources override matching top-level settings. Environment overrides still take precedence over saved user settings. Common keys include `api_key`, `base_url`, `temp_dir`, `color`, `suggest`, `items_per_page`, `cache_ttl`, `raw`, and `invisible`.
 
 ## doc
 

package/docs/sync.md

@@ -308,7 +308,7 @@ After changes begin, individual API or write failures are logged and the engine
 
 ### Save defaults in a CLI config file
 
-Put a `sync` object in `/etc/xyops/cli.json` for machine or service defaults, or `~/.config/xyops/cli.json` for your own user account:
+Put a `sync` object in the machine configuration file for machine or service defaults, or the user configuration file for your own account. These are `/etc/xyops/cli.json` and `~/.config/xyops/cli.json` on Unix and macOS, or `%PROGRAMDATA%\xyops\cli.json` and `%USERPROFILE%\.config\xyops\cli.json` on Windows:
 
 ```json
 {

package/index.js

@@ -198,6 +198,34 @@ const app = {
 			return;
 		}
 		
+		// Validate local command routing before requiring a configured server. This
+		// keeps help and typo diagnostics available during initial CLI setup. Export
+		// is excluded because it also supports portable resource types that do not
+		// have their own complete command routers yet.
+		if (!('export' in args) && !this['cmd_' + cmd]) {
+			// Allow the user to swap the first two args if the second is a known command.
+			if (this['cmd_' + args.other[0]]) {
+				var new_cmd = args.other[0];
+				args.other[0] = cmd;
+				cmd = new_cmd;
+			}
+			else {
+				var suggestion = this.findClosestString(cmd, TOP_LEVEL_COMMANDS);
+				this.die(
+					"Unknown command: " + cmd + (suggestion ? '. Did you mean "' + suggestion + '"?' : ''),
+					"Available Commands: " + TOP_LEVEL_COMMANDS.join(', ') + "\n\n"
+				);
+			}
+		}
+		
+		// Help is entirely local, so it should work before a user has configured an
+		// API key or server URL, and should never make a network request.
+		if (cmd == 'help') {
+			await this.cmd_help();
+			print("\n");
+			return;
+		}
+		
 		delete args.debug;
 		delete args.echo;
 		delete args.quiet;
@@ -273,22 +301,6 @@ const app = {
 			return;
 		}
 		
-		if (!this['cmd_' + cmd]) {
-			// allow user to swap first two args, if 2nd is known command
-			if (this['cmd_' + args.other[0]]) {
-				var new_cmd = args.other[0];
-				args.other[0] = cmd;
-				cmd = new_cmd;
-			}
-			else {
-				var suggestion = this.findClosestString(cmd, TOP_LEVEL_COMMANDS);
-				this.die(
-					"Unknown command: " + cmd + (suggestion ? '. Did you mean "' + suggestion + '"?' : ''),
-					"Available Commands: " + TOP_LEVEL_COMMANDS.join(', ') + "\n\n"
-				);
-			}
-		}
-		
 		// merge in config from xyops
 		await this.cacheConfig();
 		

package/lib/config.js

@@ -1,21 +1,37 @@
 // Config Layer
 
 const fs = require('fs');
+const os = require('os');
 const Path = require('path');
 const cli = require('pixl-cli');
 const Tools = cli.Tools;
 const chalk = cli.chalk;
 
-module.exports = {
+function getConfigFiles(platform, env, home_dir) {
+	// Keep the existing Unix paths, but use Windows's shared application-data
+	// directory instead of resolving /etc against whichever drive is current.
+	// ProgramData should always exist in an ordinary Windows login.  If a custom
+	// environment omits it, skip the optional machine file rather than guessing.
+	var path_api = (platform == 'win32') ? Path.win32 : Path.posix;
+	var config_files = [];
+	var system_dir = (platform == 'win32') ?
+		(env.ProgramData || env.PROGRAMDATA || env.ALLUSERSPROFILE) : '/etc';
+	
+	if (system_dir) config_files.push( path_api.join(system_dir, 'xyops', 'cli.json') );
+	
+	// os.homedir() uses USERPROFILE on Windows and has an operating-system
+	// fallback, unlike reading HOME or HOMEPATH directly.
+	config_files.push( path_api.join(home_dir, '.config', 'xyops', 'cli.json') );
+	return config_files;
+}
+
+var config_layer = module.exports = {
 	
 	loadConfig() {
 		// handle loading config at startup
 		// optional config files, sync with env, two-way
 		var config = {};
-		var config_files = this.configFiles = [
-			Path.join( '/etc', 'xyops', 'cli.json' ),
-			Path.join( process.env.HOME, '.config', 'xyops', 'cli.json' )
-		];
+		var config_files = this.configFiles = getConfigFiles(process.platform, process.env, os.homedir());
 		
 		config_files.forEach( function(file) {
 			if (!fs.existsSync(file)) return;
@@ -80,7 +96,13 @@ module.exports = {
 		Tools.mkdirpSync( Path.dirname(dest_file) );
 		println( "\n " + bold.cyan("Writing to: ") + dest_file );
 		fs.writeFileSync( dest_file, JSON.stringify(user_config, null, "\t") + "\n", { mode: 0o600 } );
-		fs.chmodSync(dest_file, 0o600);
+		
+		// Windows inherits an ACL from the user's profile directory and does not
+		// implement Unix owner/group/other mode distinctions.
+		if (process.platform != 'win32') fs.chmodSync(dest_file, 0o600);
 	}
-	
 };
+
+// Expose the pure path selector to unit tests without merging another command
+// method into the runtime app object.
+Object.defineProperty(config_layer, 'getConfigFiles', { value: getConfigFiles });

package/lib/sync.js

@@ -651,7 +651,8 @@ module.exports = {
 				cwd: cwd,
 				timeout: cmd_timeout * 1000,
 				encoding: 'utf8',
-				stdio: ['ignore', 'pipe', 'pipe']
+				stdio: ['ignore', 'pipe', 'pipe'],
+				windowsHide: true
 			});
 			
 			if (output.match(/\S/)) {

package/lib/utils.js

@@ -254,7 +254,21 @@ module.exports = {
 		// This mirrors the xyOps UI helper, while avoiding slow source auto-detection
 		// for common interpreters.
 		if ((typeof(bin) != 'string') || !bin.trim()) return null;
-		var cmd = Path.basename( bin.trim() ).replace(/\s+.+$/, '').replace(/\d+$/, '').toLowerCase();
+		
+		// Normalize both path styles because Plugin definitions may come from a
+		// different operating system than the CLI displaying them.  Remove command
+		// arguments before taking the basename, including quoted paths with spaces.
+		var cmdline = bin.trim().replace(/\\/g, '/');
+		var cmd = cmdline;
+		if (cmd.match(/^(?:.*\/)?env(?:\.exe)?\s+(?:\-S\s+)?(\S+)/i)) cmd = RegExp.$1;
+		else if (cmd.match(/^"([^"]+)"/)) cmd = RegExp.$1;
+		else if (cmd.match(/^'([^']+)'/)) cmd = RegExp.$1;
+		else cmd = cmd.replace(/\s+.+$/, '');
+		cmd = Path.posix.basename(cmd);
+		
+		// Windows executables conventionally include .exe.  Version suffixes are
+		// also common for interpreters such as python3.12 and node24.
+		cmd = cmd.replace(/\.exe$/i, '').replace(/\d+(?:\.\d+)*$/, '').toLowerCase();
 		
 		switch (cmd) {
 			case 'sh':
@@ -268,14 +282,26 @@ module.exports = {
 			break;
 			
 			case 'node':
+			case 'nodejs':
 			case 'deno':
 			case 'bun':
 				cmd = 'javascript';
 			break;
 			
 			case 'pwsh':
+			case 'powershell':
 				cmd = 'powershell';
 			break;
+			
+			case 'cmd':
+				cmd = 'dos';
+			break;
+			
+			case 'py':
+			case 'pythonw':
+			case 'pypy':
+				cmd = 'python';
+			break;
 		}
 		
 		return HIGHLIGHT_LANGUAGES.includes(cmd) ? cmd : null;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pixlcore/xycli",
-	"version": "1.0.2",
+	"version": "1.0.4",
 	"description": "A complete command-line interface for the xyOps workflow automation system.",
 	"author": "Joseph Huckaby <jhuckaby@pixlcore.com>",
 	"homepage": "https://github.com/pixlcore/xycli",
@@ -21,6 +21,7 @@
 	],
 	"scripts": {
 		"test": "node test.js",
+		"test:offline": "node --test test/config.test.js test/help.test.js test/markdown.test.js test/sync-unit.test.js test/toast.test.js test/utils-unit.test.js",
 		"changelog": "node tools/changelog.js"
 	},
 	"dependencies": {

package/test/config.test.js

@@ -4,12 +4,25 @@ const fs = require('node:fs');
 const os = require('node:os');
 const Path = require('node:path');
 const { spawnSync } = require('node:child_process');
+const config = require('../lib/config.js');
+
+function assertPrivateMode(file) {
+	// Windows permissions are represented by ACLs, not Unix owner/group/other
+	// mode bits.  The file still has to exist, but an exact 0600 assertion only
+	// describes the Unix behavior that fs.chmodSync can enforce.
+	assert.equal(fs.existsSync(file), true);
+	if (process.platform != 'win32') assert.equal(fs.statSync(file).mode & 0o777, 0o600);
+}
 
 function createConfigFixture(t, initial) {
 	// Give each CLI process a disposable home directory.  Config commands exit
 	// before contacting xyOps, so these checks need no development server.
 	const home_dir = fs.mkdtempSync(Path.join(os.tmpdir(), 'xycli-config-'));
-	t.after(() => fs.rmSync(home_dir, { recursive: true, force: true }));
+	const program_data = fs.mkdtempSync(Path.join(os.tmpdir(), 'xycli-program-data-'));
+	t.after(() => {
+		fs.rmSync(home_dir, { recursive: true, force: true });
+		fs.rmSync(program_data, { recursive: true, force: true });
+	});
 	const file = Path.join(home_dir, '.config', 'xyops', 'cli.json');
 	
 	if (initial) {
@@ -20,17 +33,26 @@ function createConfigFixture(t, initial) {
 	return {
 		file,
 		run(args) {
+			const env = {
+				...process.env,
+				HOME: home_dir,
+				USERPROFILE: home_dir,
+				ProgramData: program_data,
+				XYOPS_API_KEY: 'fixture-key',
+				XYOPS_BASE_URL: 'https://fixture.invalid',
+				XYOPS_ITEMS_PER_PAGE: '99',
+				XYOPS_COLOR: 'false'
+			};
+			
+			// Prove the Windows code path does not receive a compatibility HOME
+			// variable from Git Bash, WSL, or the parent test environment.
+			if (process.platform == 'win32') delete env.HOME;
+			
 			const result = spawnSync(process.execPath, [Path.join(__dirname, '..', 'index.js'), 'config', ...args], {
 				encoding: 'utf8',
 				timeout: 10000,
-				env: {
-					...process.env,
-					HOME: home_dir,
-					XYOPS_API_KEY: 'fixture-key',
-					XYOPS_BASE_URL: 'https://fixture.invalid',
-					XYOPS_ITEMS_PER_PAGE: '99',
-					XYOPS_COLOR: 'false'
-				}
+				windowsHide: true,
+				env
 			});
 			
 			// Keep captured CLI output out of assertion messages, since a config
@@ -43,6 +65,24 @@ function createConfigFixture(t, initial) {
 	};
 }
 
+test('config resolves native Unix and Windows source paths', () => {
+	assert.deepEqual(config.getConfigFiles('linux', {}, '/home/nick'), [
+		'/etc/xyops/cli.json',
+		'/home/nick/.config/xyops/cli.json'
+	]);
+	assert.deepEqual(config.getConfigFiles('win32', { ProgramData: 'C:\\ProgramData' }, 'C:\\Users\\Nick'), [
+		'C:\\ProgramData\\xyops\\cli.json',
+		'C:\\Users\\Nick\\.config\\xyops\\cli.json'
+	]);
+	assert.deepEqual(config.getConfigFiles('win32', { ALLUSERSPROFILE: 'D:\\SharedData' }, 'C:\\Users\\Nick'), [
+		'D:\\SharedData\\xyops\\cli.json',
+		'C:\\Users\\Nick\\.config\\xyops\\cli.json'
+	]);
+	assert.deepEqual(config.getConfigFiles('win32', {}, 'C:\\Users\\Nick'), [
+		'C:\\Users\\Nick\\.config\\xyops\\cli.json'
+	]);
+});
+
 test('config updates only requested user settings without saving inherited overrides', t => {
 	const fixture = createConfigFixture(t, {
 		items_per_page: 10,
@@ -61,7 +101,7 @@ test('config updates only requested user settings without saving inherited overr
 		suggest: true,
 		sync: { up: ['events'], down: false }
 	});
-	assert.equal(fs.statSync(fixture.file).mode & 0o777, 0o600);
+	assertPrivateMode(fixture.file);
 });
 
 test('config creates a missing user file with only supplied settings', t => {
@@ -69,7 +109,7 @@ test('config creates a missing user file with only supplied settings', t => {
 	fixture.run(['--items_per_page', '25']);
 	
 	assert.deepEqual(fixture.read(), { items_per_page: 25 });
-	assert.equal(fs.statSync(fixture.file).mode & 0o777, 0o600);
+	assertPrivateMode(fixture.file);
 });
 
 test('config dotted updates preserve sibling user settings and explicit false or zero values', t => {

package/test/help.test.js

@@ -2,25 +2,39 @@ const { test } = require('node:test');
 const assert = require('node:assert/strict');
 const { xy } = require('./helpers/common.js');
 
+// Deliberately shadow any developer-machine configuration. Help and command
+// diagnostics must remain useful before the user connects the CLI to xyOps.
+const offlineEnv = {
+	XYOPS_API_KEY: '',
+	XYOPS_BASE_URL: ''
+};
+
+const offlineFailure = { fail: true, env: offlineEnv };
+
+test('help is available without server credentials', () => {
+	const output = xy(['help'], { env: offlineEnv });
+	assert.match(output, /HELP: OVERVIEW/);
+});
+
 test('help suggests the closest chapter for a typo', () => {
-	const output = xy(['help', 'event', 'udpate'], { fail: true });
+	const output = xy(['help', 'event', 'udpate'], offlineFailure);
 	assert.match(output, /Could not find help chapter for "event udpate"\. Did you mean "event update"\?/);
 });
 
 test('help does not suggest an unrelated chapter', () => {
-	const output = xy(['help', 'completely', 'unrelated', 'words'], { fail: true });
+	const output = xy(['help', 'completely', 'unrelated', 'words'], offlineFailure);
 	assert.match(output, /Could not find help chapter for "completely unrelated words"\./);
 	assert.doesNotMatch(output, /Did you mean/);
 });
 
 test('unknown top-level command suggests the closest command', () => {
-	const output = xy(['evnets'], { fail: true });
+	const output = xy(['evnets'], offlineFailure);
 	assert.match(output, /Unknown command: evnets\. Did you mean "events"\?/);
 	assert.match(output, /Available Commands:.*events/);
 });
 
 test('unknown top-level command does not suggest an unrelated command', () => {
-	const output = xy(['completely_unrelated'], { fail: true });
+	const output = xy(['completely_unrelated'], offlineFailure);
 	assert.match(output, /Unknown command: completely_unrelated/);
 	assert.doesNotMatch(output, /Did you mean/);
 });

package/test/helpers/common.js

@@ -59,6 +59,7 @@ function runCLI(args, options = {}) {
 		timeout: 30000,
 		maxBuffer: 16 * 1024 * 1024,
 		input: options.input,
+		windowsHide: true,
 		env: {
 			...process.env,
 			XYOPS_COLOR: 'false',

package/test/sync-unit.test.js

@@ -104,7 +104,8 @@ function runSync(t, options) {
 	})], {
 		cwd: Path.join(__dirname, '..'),
 		encoding: 'utf8',
-		timeout: 10000
+		timeout: 10000,
+		windowsHide: true
 	});
 	assert.ifError(result.error);
 	assert.equal(result.signal, null);
@@ -659,7 +660,8 @@ test('sync PID lock rejects an overlapping run and cleans up afterward', async t
 	`;
 	const holder = spawn(process.execPath, ['-e', holderScript, lockFile], {
 		cwd: Path.join(__dirname, '..'),
-		stdio: ['ignore', 'pipe', 'pipe']
+		stdio: ['ignore', 'pipe', 'pipe'],
+		windowsHide: true
 	});
 	
 	await new Promise((resolve, reject) => {

package/test/utils-unit.test.js

@@ -0,0 +1,19 @@
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const utils = require('../lib/utils.js');
+
+test('executable language detection accepts Unix and Windows command forms', () => {
+	// Plugin definitions are portable, so exercise both path styles regardless of
+	// the operating system running this test.
+	assert.equal(utils.getLangFromBinary('/usr/bin/node --use-strict'), 'javascript');
+	assert.equal(utils.getLangFromBinary('/usr/bin/python3.12 -u'), 'python');
+	assert.equal(utils.getLangFromBinary('/bin/bash'), 'shell');
+	assert.equal(utils.getLangFromBinary('/usr/bin/env -S node --use-strict'), 'javascript');
+	assert.equal(utils.getLangFromBinary('"C:\\Program Files\\nodejs\\node.exe" --use-strict'), 'javascript');
+	assert.equal(utils.getLangFromBinary('C:\\Python312\\python.exe -u'), 'python');
+	assert.equal(utils.getLangFromBinary('pwsh.exe -File'), 'powershell');
+	assert.equal(utils.getLangFromBinary('powershell.exe -File'), 'powershell');
+	assert.equal(utils.getLangFromBinary('cmd.exe /c'), 'dos');
+	assert.equal(utils.getLangFromBinary('unknown-binary.exe'), null);
+	assert.equal(utils.getLangFromBinary(null), null);
+});

package/test.js

@@ -30,7 +30,8 @@ else {
 		// suite does not prevent the remaining suites from running and reporting.
 		const child = spawn(process.execPath, ['--test', '--test-concurrency=1', ...files], {
 			cwd: __dirname,
-			stdio: 'inherit'
+			stdio: 'inherit',
+			windowsHide: true
 		});
 		
 		child.on('error', error => {

package/tools/changelog.js

@@ -13,14 +13,14 @@ var debug = (process.argv[2] == 'debug');
 process.chdir( Path.dirname( __dirname ) );
 
 // make sure git sandbox is clean
-var porcelain = cp.execSync('git status --porcelain', { encoding: 'utf8' }).trim();
+var porcelain = cp.execSync('git status --porcelain', { encoding: 'utf8', windowsHide: true }).trim();
 if (!debug && porcelain.length) {
 	console.error("\nERROR: Git sandbox has local changes.  Please commit these before updating the changelog.\n");
 	process.exit(1);
 }
 
 // get list of tags
-var tags = cp.execSync('git tag --list --sort=version:refname', { encoding: 'utf8' }).trim().split(/\n/).reverse();
+var tags = cp.execSync('git tag --list --sort=version:refname', { encoding: 'utf8', windowsHide: true }).trim().split(/\n/).reverse();
 
 var md = '';
 md += "# xyCLI Changelog\n";
@@ -36,7 +36,7 @@ tags.forEach( function(tag, idx) {
 	md += `\n## Version ${tag}\n\n`;
 	
 	var cmd = `git log ${prev_tag}..${tag} --no-merges --pretty=format:'%h %H %ad %s%n%n%b%n----PX----' --date=short`;
-	var output = cp.execSync(cmd, { encoding: 'utf8' }).trim();
+	var output = cp.execSync(cmd, { encoding: 'utf8', windowsHide: true }).trim();
 	var commits = output.split('----PX----');
 	var first = true;
 	
@@ -77,10 +77,10 @@ if (debug) {
 fs.writeFileSync( 'CHANGELOG.md', md );
 
 // make sure log has actually changed
-porcelain = cp.execSync('git status --porcelain', { encoding: 'utf8' }).trim();
+porcelain = cp.execSync('git status --porcelain', { encoding: 'utf8', windowsHide: true }).trim();
 if (!porcelain.length) {
 	console.error("\nWarning: Changelog has not changed since last run.  Skipping actions.\n");
 	process.exit(1);
 }
 
-cp.execSync('git add CHANGELOG.md && git commit -m "Update CHANGELOG" && git push', { stdio: 'inherit' } );
+cp.execSync('git add CHANGELOG.md && git commit -m "Update CHANGELOG" && git push', { stdio: 'inherit', windowsHide: true } );