mb-run 1.0.2-dev-20260929-2a0c292 → 1.0.2

package/CHANGELOG.md

@@ -23,7 +23,7 @@ If you like this project and find it useful, please consider giving it a star on
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
 
-## [1.0.2] - Dev branch
+## [1.0.2] - 2026-09-29
 
 ### Added
 
@@ -49,7 +49,13 @@ If you like this project and find it useful, please consider giving it a star on
 
 - [antigravity]: Bump the vendored `.antigravity/settings.json` to v.1.0.5: count the removed sandboxing comments and allow the read-only git commands already approved in `.vscode/settings.json`.
 - [vscode]: Bump the vendored `.vscode/settings.json` to v.1.0.14: ask before dependency installs and removals and approve `npm run test:watch` and `npm run test:verbose`, in sync with `.antigravity/settings.json`.
-- [scripts]: Remove the obsolete `eslint-disable` comments from the vendored `scripts/*.mjs` and bump each touched script's patch version (scripts are ignored by oxlint).
+- [scripts]: Remove the obsolete `eslint-disable` comments from the vendored `scripts/*.mjs` and bump each touched script's patch version.
+- [scripts]: Make the vendored `scripts/*.mjs` pass oxlint: file-level `no-console` disables, behavior-preserving fixes, and local disables where a fix would change runtime behavior.
+- [esbuild]: Make the vendored `scripts/esbuild.mjs` pass oxlint: file-level `no-console` disable, JSDoc descriptions and an optional chain.
+- [oxlint]: Bump the vendored `.oxlintrc.root.json` to v.1.0.19: lint `scripts/` and `bin/`, and ignore `docs/**`, `**/tmp/**` and `**/bun.lock`.
+- [oxfmt]: Bump the vendored `.oxfmtrc.root.json` to v.1.0.7: ignore `docs/**`, `**/tmp/**` and `**/bun.lock`, and drop the `scripts/*.html` and `eslint.config.js` ignores.
+- [scripts]: Remove the unused vendored `scripts/run-automator.mjs`, which every upgrade deleted right after copying it.
+- [upgrade]: Delete the obsolete `scripts/install-experimental.mjs` from upgraded repositories.
 - [version]: Breaking change: rename `--version [tag]` to `--set-version [tag]`, so `--version` no longer rewrites `package.json`. The old `mb-run --version <tag>` form exits with an error pointing to `--set-version`.
 - [package]: Upgrade package.
 - [package]: Bump `oxfmt` to v.0.71.0.

package/dist/upgrade.js

@@ -197,6 +197,7 @@ export async function runPackageJsonUpgrade(opts, pkgPath, pkgJson, isMonorepo =
             unlinkSafe(path.join(dstDir, 'scripts', 'run-chip-tests.mjs'));
         unlinkSafe(path.join(dstDir, 'scripts', 'run-automator.mjs'));
         unlinkSafe(path.join(dstDir, 'scripts', 'runAutomator.mjs'));
+        unlinkSafe(path.join(dstDir, 'scripts', 'install-experimental.mjs'));
         unlinkSafe(path.join(dstDir, 'scripts', 'prune-tags.sh'));
         unlinkSafe(path.join(dstDir, 'scripts', 'git-status.sh'));
         unlinkSafe(path.join(dstDir, 'scripts', 'mb-run.mjs'));

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "mb-run",
-  "version": "1.0.2-dev-20260929-2a0c292",
+  "version": "1.0.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "mb-run",
-      "version": "1.0.2-dev-20260929-2a0c292",
+      "version": "1.0.2",
       "license": "Apache-2.0",
       "dependencies": {
         "cross-spawn": "7.0.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mb-run",
-  "version": "1.0.2-dev-20260929-2a0c292",
+  "version": "1.0.2",
   "description": "Matterbridge command line executor",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",

package/vendor/.oxfmtrc.root.json

@@ -1,4 +1,4 @@
-// .oxfmtrc.json 1.0.6
+// .oxfmtrc.json 1.0.7
 
 // This Oxfmt configuration (shared between all matterbridge packages) is designed for a TypeScript project using ESM modules.
 {
@@ -10,16 +10,16 @@
     "**/build/**",
     "chip/**",
     "**/coverage/**",
-    "docs",
+    "docs/**",
     "**/dist/**",
     "**/temp/**",
+    "**/tmp/**",
     "**/node_modules/**",
     "**/out/**",
     "**/screenshots/**",
     "vendor/**",
     "**/package-lock.json",
-    "scripts/*.html",
-    "eslint.config.js"
+    "**/bun.lock"
   ],
   "printWidth": 180,
   "tabWidth": 2,

package/vendor/.oxlintrc.root.json

@@ -1,4 +1,4 @@
-// .oxlintrc.json 1.0.18
+// .oxlintrc.json 1.0.19
 
 // This Oxlint configuration (shared between all matterbridge packages) is designed for a TypeScript project using ESM modules.
 {
@@ -10,16 +10,16 @@
     "**/build/**",
     "chip/**",
     "**/coverage/**",
+    "docs/**",
     "**/dist/**",
     "**/temp/**",
+    "**/tmp/**",
     "**/node_modules/**",
     "**/out/**",
-    "**/scripts/**",
     "**/screenshots/**",
     "vendor/**",
     "**/package-lock.json",
-    "**/bin/**",
-    "**/src/mock/**"
+    "**/bun.lock"
   ],
   "env": {
     "builtin": true,

package/vendor/scripts/clean.mjs

@@ -21,6 +21,8 @@
  * Unknown arguments are rejected with exit code 1, so a mistyped flag never starts a clean.
  */
 
+/* oxlint-disable no-console */
+
 import { lstatSync, existsSync, readdirSync, readFileSync, rmSync } from 'node:fs';
 import path from 'node:path';
 
@@ -37,20 +39,17 @@ const handleArgs = () => {
   const knownArgs = new Set(['--workspaces', '--version', '-v', '--help', '-h']);
   const unknownArgs = args.filter((arg) => !knownArgs.has(arg));
   if (unknownArgs.length > 0) {
-    // oxlint-disable-next-line no-console
     console.error(`Unknown argument${unknownArgs.length === 1 ? '' : 's'}: ${unknownArgs.join(', ')}. Run with --help for usage.`);
     process.exitCode = 1;
     return false;
   }
 
   if (args.includes('--version') || args.includes('-v')) {
-    // oxlint-disable-next-line no-console
     console.log(version);
     return false;
   }
 
   if (args.includes('--help') || args.includes('-h')) {
-    // oxlint-disable-next-line no-console
     console.log(`${scriptName} v.${version}
 
 Remove every *.tsbuildinfo file and the dist and build directories.
@@ -71,7 +70,6 @@ Options:
 const shouldClean = handleArgs();
 
 if (shouldClean) {
-  // oxlint-disable-next-line no-console
   console.log(`${scriptName} v.${version}`);
 }
 
@@ -80,7 +78,7 @@ const root = process.cwd();
 
 // Colors follow the NO_COLOR convention and are left out when the output is redirected,
 // so a piped or captured log stays free of escape sequences.
-const useColor = process.env.NO_COLOR === undefined && (process.stdout.isTTY === true || process.env.FORCE_COLOR !== undefined);
+const useColor = process.env.NO_COLOR === undefined && (process.stdout.isTTY || process.env.FORCE_COLOR !== undefined);
 const red = (text) => (useColor ? `\u001B[31m${text}\u001B[0m` : text);
 
 let removed = 0;
@@ -91,11 +89,9 @@ const logRemoved = (dir, entry) => {
   if (loggedDir !== dir) {
     loggedDir = dir;
     const name = path.relative(root, dir);
-    // oxlint-disable-next-line no-console
     console.log(name === '' ? path.basename(dir) : name);
   }
   removed += 1;
-  // oxlint-disable-next-line no-console
   console.log(`  ${red('-')} ${entry}`);
 };
 
@@ -114,7 +110,6 @@ const rm = (dir, target) => {
     rmSync(path.resolve(dir, target), { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
   } catch (error) {
     if (error.code === 'EPERM' || error.code === 'EBUSY' || error.code === 'ENOTEMPTY') {
-      // oxlint-disable-next-line no-console
       console.warn(`Skipped locked path (${error.code}): ${error.path ?? target} — likely held by a running process.`);
       return;
     }
@@ -177,6 +172,5 @@ if (shouldClean) {
   }
 
   const elapsed = `${Math.round(performance.now() - start)}ms`;
-  // oxlint-disable-next-line no-console
   console.log(removed === 0 ? `Nothing to clean in ${elapsed}.` : `Cleaned ${removed} path${removed === 1 ? '' : 's'} in ${elapsed}.`);
 }

package/vendor/scripts/create-release.mjs

@@ -16,6 +16,8 @@
  * - Print tag/title/description and pause for user confirmation before creating
  */
 
+/* oxlint-disable no-console */
+
 import { spawn } from 'node:child_process';
 import fs from 'node:fs/promises';
 import os from 'node:os';
@@ -90,6 +92,7 @@ async function promptToContinue({ tag, title, description }) {
   console.log(`Tag: ${tag}`);
   console.log(`Title: ${title}`);
   console.log('Description:');
+  // oxlint-disable-next-line typescript/prefer-nullish-coalescing
   console.log(description || '(empty)');
   console.log('---');
 
@@ -106,7 +109,7 @@ async function promptToContinue({ tag, title, description }) {
   }
 }
 
-function runGhReleaseCreate({ tag, title, notesFilePath }) {
+async function runGhReleaseCreate({ tag, title, notesFilePath }) {
   return new Promise((resolve, reject) => {
     const args = ['release', 'create', tag, '--title', title, '--notes-file', notesFilePath, '--target', 'main'];
     const child = spawn('gh', args, {
@@ -157,6 +160,7 @@ async function main() {
   }
 }
 
+// oxlint-disable-next-line typescript/use-unknown-in-catch-callback-variable
 main().catch((err) => {
   console.error(`create-release: ${err?.message ?? err}`);
   console.error('Make sure you are authenticated with GitHub CLI: gh auth status');

package/vendor/scripts/deep-clean.mjs

@@ -28,6 +28,8 @@
  * Unknown arguments are rejected with exit code 1, so a mistyped flag never starts a clean.
  */
 
+/* oxlint-disable no-console */
+
 import { existsSync, lstatSync, readdirSync, readFileSync, rmSync } from 'node:fs';
 import path from 'node:path';
 
@@ -44,20 +46,17 @@ const handleArgs = () => {
   const knownArgs = new Set(['--workspaces', '--version', '-v', '--help', '-h']);
   const unknownArgs = args.filter((arg) => !knownArgs.has(arg));
   if (unknownArgs.length > 0) {
-    // oxlint-disable-next-line no-console
     console.error(`Unknown argument${unknownArgs.length === 1 ? '' : 's'}: ${unknownArgs.join(', ')}. Run with --help for usage.`);
     process.exitCode = 1;
     return false;
   }
 
   if (args.includes('--version') || args.includes('-v')) {
-    // oxlint-disable-next-line no-console
     console.log(version);
     return false;
   }
 
   if (args.includes('--help') || args.includes('-h')) {
-    // oxlint-disable-next-line no-console
     console.log(`${scriptName} v.${version}
 
 Remove every *.tsbuildinfo file, the build/test output directories and the lock files,\nand empty .cache and node_modules.
@@ -78,7 +77,6 @@ Options:
 const shouldClean = handleArgs();
 
 if (shouldClean) {
-  // oxlint-disable-next-line no-console
   console.log(`${scriptName} v.${version}`);
 }
 
@@ -87,7 +85,7 @@ const root = process.cwd();
 
 // Colors follow the NO_COLOR convention and are left out when the output is redirected,
 // so a piped or captured log stays free of escape sequences.
-const useColor = process.env.NO_COLOR === undefined && (process.stdout.isTTY === true || process.env.FORCE_COLOR !== undefined);
+const useColor = process.env.NO_COLOR === undefined && (process.stdout.isTTY || process.env.FORCE_COLOR !== undefined);
 const red = (text) => (useColor ? `\u001B[31m${text}\u001B[0m` : text);
 
 let removed = 0;
@@ -98,11 +96,9 @@ const logRemoved = (dir, entry, count = 1) => {
   if (loggedDir !== dir) {
     loggedDir = dir;
     const name = path.relative(root, dir);
-    // oxlint-disable-next-line no-console
     console.log(name === '' ? path.basename(dir) : name);
   }
   removed += count;
-  // oxlint-disable-next-line no-console
   console.log(`  ${red('-')} ${entry}`);
 };
 
@@ -123,7 +119,6 @@ const rm = (dir, target) => {
     rmSync(path.resolve(dir, target), { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
   } catch (error) {
     if (error.code === 'EPERM' || error.code === 'EBUSY' || error.code === 'ENOTEMPTY') {
-      // oxlint-disable-next-line no-console
       console.warn(`Skipped locked path (${error.code}): ${error.path ?? target} — likely held by a running process.`);
       return null;
     }
@@ -214,6 +209,5 @@ if (shouldClean) {
   }
 
   const elapsed = `${Math.round(performance.now() - start)}ms`;
-  // oxlint-disable-next-line no-console
   console.log(removed === 0 ? `Nothing to clean in ${elapsed}.` : `Cleaned ${removed} path${removed === 1 ? '' : 's'} in ${elapsed}.`);
 }

package/vendor/scripts/downloads.mjs

@@ -11,6 +11,12 @@
  *   Node.js 18+ (for global fetch)
  */
 
+/* oxlint-disable no-console */
+/* oxlint-disable typescript/no-unnecessary-type-conversion */
+/* oxlint-disable typescript/use-unknown-in-catch-callback-variable */
+/* oxlint-disable typescript/prefer-nullish-coalescing */
+/* oxlint-disable typescript/no-unsafe-type-assertion */
+
 import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 
@@ -94,7 +100,7 @@ async function fetchCurrentDayDownloads(pkgName) {
  */
 function sumDownloads(rows) {
   let total = 0;
-  for (const r of rows) total += Number(r.downloads) || 0;
+  for (const r of rows) total += r.downloads || 0;
   return total;
 }
 
@@ -106,8 +112,7 @@ function sumDownloads(rows) {
  * @returns {string} Left-padded string.
  */
 function padLeft(s, width) {
-  const str = String(s);
-  return str.length >= width ? str : ' '.repeat(width - str.length) + str;
+  return s.length >= width ? s : ' '.repeat(width - s.length) + s;
 }
 
 /**
@@ -118,8 +123,7 @@ function padLeft(s, width) {
  * @returns {string} Right-padded string.
  */
 function padRight(s, width) {
-  const str = String(s);
-  return str.length >= width ? str : str + ' '.repeat(width - str.length);
+  return s.length >= width ? s : s + ' '.repeat(width - s.length);
 }
 
 /**
@@ -129,7 +133,7 @@ function padRight(s, width) {
  * @returns {string} Formatted number.
  */
 function formatNumber(n) {
-  return new Intl.NumberFormat(undefined, { maximumFractionDigits: 0 }).format(Number(n) || 0);
+  return new Intl.NumberFormat(undefined, { maximumFractionDigits: 0 }).format(n || 0);
 }
 
 /**
@@ -230,10 +234,14 @@ async function main() {
   const total = sumDownloads(summaryRows);
   const days = summaryRows.length || 1;
   const avg = Math.round(total / days);
-  const minRow = summaryRows.reduce((m, r) => (r.downloads < m.downloads ? r : m), summaryRows[0] ?? { day: '-', downloads: 0 });
-  const maxRow = summaryRows.reduce((m, r) => (r.downloads > m.downloads ? r : m), summaryRows[0] ?? { day: '-', downloads: 0 });
+  let minRow = summaryRows[0] ?? { day: '-', downloads: 0 };
+  let maxRow = minRow;
+  for (const r of summaryRows) {
+    if (r.downloads < minRow.downloads) minRow = r;
+    if (r.downloads > maxRow.downloads) maxRow = r;
+  }
 
-  const dayWidth = Math.max(3, ...rows.map((r) => String(r.day).length));
+  const dayWidth = Math.max(3, ...rows.map((r) => r.day.length));
   const downloadStrings = rows.map((r) => formatNumber(r.downloads));
   const downloadsWidth = Math.max('DOWNLOADS'.length, ...downloadStrings.map((s) => s.length));
   const rangeStart = rows[0]?.day ?? lastMonthData.start;

package/vendor/scripts/esbuild.mjs

@@ -11,6 +11,8 @@
  *   Node.js 18+ (for global fetch)
  */
 
+/* oxlint-disable no-console */
+
 import { readdir, rm, stat, writeFile } from 'node:fs/promises';
 import { createRequire } from 'node:module';
 import path from 'node:path';
@@ -47,14 +49,14 @@ if (dirs.length === 0) {
 /**
  * Recursively lists all files under a directory.
  *
- * @param {string} rootDir
- * @returns {Promise<string[]>}
+ * @param {string} rootDir - Directory to walk.
+ * @returns {Promise<string[]>} Absolute paths of all files below rootDir.
  */
 const listFilesRecursive = async (rootDir) => {
   /** @type {string[]} */
   const files = [];
 
-  /** @param {string} currentDir */
+  /** @param {string} currentDir - Directory being walked. */
   const walk = async (currentDir) => {
     const entries = await readdir(currentDir, { withFileTypes: true });
     for (const entry of entries) {
@@ -71,11 +73,11 @@ const listFilesRecursive = async (rootDir) => {
   return files;
 };
 
-/** @param {string} distDir */
+/** @param {string} distDir - Dist directory to bundle in place. */
 const bundleDir = async (distDir) => {
   console.log(`[esbuild] dir: ${distDir}`);
   const dirStat = await stat(distDir).catch(() => null);
-  if (!dirStat || !dirStat.isDirectory()) {
+  if (!dirStat?.isDirectory()) {
     throw new Error(`Not a directory: ${distDir}`);
   }
 

package/vendor/scripts/git-status.mjs

@@ -8,6 +8,9 @@
  *   node scripts/git-status.mjs
  */
 
+/* oxlint-disable no-console */
+/* oxlint-disable typescript/prefer-nullish-coalescing */
+
 import { spawnSync } from 'node:child_process';
 
 class ExitError extends Error {
@@ -67,6 +70,13 @@ function section(title) {
   hr();
 }
 
+/**
+ * Throw an ExitError.
+ *
+ * @param {string} message - Error message.
+ * @param {number} [code] - Exit code.
+ * @returns {never} Never returns.
+ */
 function fail(message, code = 1) {
   throw new ExitError(message, code);
 }
@@ -74,6 +84,7 @@ function fail(message, code = 1) {
 function parseArgs(argv) {
   if (argv.includes('--help') || argv.includes('-h')) {
     console.log(usage());
+    // oxlint-disable-next-line unicorn/no-useless-undefined
     return undefined;
   }
 
@@ -88,6 +99,7 @@ function parseArgs(argv) {
   };
 }
 
+// oxlint-disable-next-line typescript/consistent-return -- ends with fail(), which always throws
 function git(args, options = {}) {
   const { allowFailure = false, input } = options;
   const result = spawnSync('git', args, {
@@ -106,6 +118,7 @@ function git(args, options = {}) {
   }
 
   if (allowFailure) {
+    // oxlint-disable-next-line unicorn/no-useless-undefined
     return undefined;
   }
 
@@ -132,6 +145,7 @@ function printKeyValue(key, value, colorizer) {
 function parseRemoteTagCount(remote) {
   const raw = git(['ls-remote', '--tags', remote], { allowFailure: true });
   if (raw === undefined) {
+    // oxlint-disable-next-line unicorn/no-useless-undefined
     return undefined;
   }
 
@@ -263,7 +277,7 @@ function main() {
 
   section('Repository status');
   const repoRoot = git(['rev-parse', '--show-toplevel']);
-  const repoName = repoRoot.split(/[\\/]/).filter(Boolean).pop() || repoRoot;
+  const repoName = repoRoot.split(/[\\/]/).findLast(Boolean) ?? repoRoot;
   const branch = git(['branch', '--show-current'], { allowFailure: true }) || '(detached)';
   const head = git(['rev-parse', '--short', 'HEAD']);
   const dirty = git(['status', '--porcelain']) ? 'yes' : 'no';
@@ -281,11 +295,11 @@ function main() {
   section('Tag reachability');
   const tagOnlyCount = git(['rev-list', '--tags', '--not', '--branches', '--count'], { allowFailure: true }) || '0';
   printKeyValue('Tag-only commits (should be 0):', tagOnlyCount, Number(tagOnlyCount) === 0 ? colors.green : colors.yellow);
-  if (git(['remote', 'get-url', remote], { allowFailure: true }) !== undefined) {
+  if (git(['remote', 'get-url', remote], { allowFailure: true }) === undefined) {
+    printKeyValue('Remote tag count:', '(remote not found)', colors.yellow);
+  } else {
     const remoteTagCount = parseRemoteTagCount(remote);
     printKeyValue(`Remote tag count (${remote}):`, remoteTagCount ?? '(remote query failed)');
-  } else {
-    printKeyValue('Remote tag count:', '(remote not found)', colors.yellow);
   }
   console.log();
 

package/vendor/scripts/git-sync-dev.mjs

@@ -10,6 +10,8 @@
  *   node scripts/git-sync-dev.mjs rebase
  */
 
+/* oxlint-disable no-console */
+
 import { execFileSync } from 'node:child_process';
 
 /**

package/vendor/scripts/prepublish-clean.mjs

@@ -18,8 +18,10 @@
  *   node scripts/prepublish-clean.mjs --workspaces
  */
 
+/* oxlint-disable no-console */
+
 import { existsSync, readdirSync, readFileSync, rmSync } from 'node:fs';
-import { resolve } from 'node:path';
+import path from 'node:path';
 
 const root = process.cwd();
 
@@ -29,7 +31,7 @@ const root = process.cwd();
 // so warn and continue instead of aborting the whole clean.
 const rm = (dir, target) => {
   try {
-    rmSync(resolve(dir, target), { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+    rmSync(path.resolve(dir, target), { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
   } catch (error) {
     if (error.code === 'EPERM' || error.code === 'EBUSY' || error.code === 'ENOTEMPTY') {
       console.warn(`Skipped locked path (${error.code}): ${error.path ?? target} — likely held by a running process.`);
@@ -42,8 +44,8 @@ const rm = (dir, target) => {
 const clean = (dir) => {
   // Empty the contents (including dotfiles) of node_modules but keep the directory itself.
   try {
-    for (const entry of readdirSync(resolve(dir, 'node_modules'))) {
-      rm(resolve(dir, 'node_modules'), entry);
+    for (const entry of readdirSync(path.resolve(dir, 'node_modules'))) {
+      rm(path.resolve(dir, 'node_modules'), entry);
     }
   } catch {
     // node_modules does not exist, nothing to empty.
@@ -55,18 +57,18 @@ const clean = (dir) => {
 };
 
 const getWorkspaceDirs = () => {
-  const { workspaces = [] } = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'));
+  const { workspaces = [] } = JSON.parse(readFileSync(path.resolve(root, 'package.json'), 'utf8'));
   const patterns = Array.isArray(workspaces) ? workspaces : (workspaces.packages ?? []);
   const dirs = [];
 
   for (const pattern of patterns) {
     if (!pattern.endsWith('/*')) {
-      const dir = resolve(root, pattern);
-      if (existsSync(resolve(dir, 'package.json'))) dirs.push(dir);
+      const dir = path.resolve(root, pattern);
+      if (existsSync(path.resolve(dir, 'package.json'))) dirs.push(dir);
       continue;
     }
 
-    const parentDir = resolve(root, pattern.slice(0, -2));
+    const parentDir = path.resolve(root, pattern.slice(0, -2));
     let entries;
     try {
       entries = readdirSync(parentDir, { withFileTypes: true });
@@ -76,8 +78,8 @@ const getWorkspaceDirs = () => {
 
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      const dir = resolve(parentDir, entry.name);
-      if (existsSync(resolve(dir, 'package.json'))) dirs.push(dir);
+      const dir = path.resolve(parentDir, entry.name);
+      if (existsSync(path.resolve(dir, 'package.json'))) dirs.push(dir);
     }
   }
 

package/vendor/scripts/prune-releases.mjs

@@ -8,6 +8,9 @@
  *   node scripts/prune-releases.mjs [--help|-h] [--dry-run|-n] <tag-prefix-to-keep>
  */
 
+/* oxlint-disable no-console */
+/* oxlint-disable typescript/prefer-nullish-coalescing */
+
 import { spawnSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
@@ -70,6 +73,13 @@ function section(title) {
   hr();
 }
 
+/**
+ * Throw an ExitError.
+ *
+ * @param {string} message - Error message.
+ * @param {number} [code] - Exit code.
+ * @returns {never} Never returns.
+ */
 function fail(message, code = 1) {
   throw new ExitError(message, code);
 }
@@ -77,6 +87,7 @@ function fail(message, code = 1) {
 function parseArgs(argv) {
   if (argv.includes('--help') || argv.includes('-h')) {
     console.log(usage());
+    // oxlint-disable-next-line unicorn/no-useless-undefined
     return undefined;
   }
 
@@ -88,8 +99,7 @@ function parseArgs(argv) {
     fail(`Unknown option(s): ${unknownFlags.join(', ')}\n\n${usage()}`);
   }
 
-  const positional = argv.filter((value) => !value.startsWith('-'));
-  const [keepPrefix] = positional;
+  const keepPrefix = argv.find((value) => !value.startsWith('-'));
   if (!keepPrefix) {
     fail(usage());
   }
@@ -97,6 +107,7 @@ function parseArgs(argv) {
   return { dryRun, keepPrefix };
 }
 
+// oxlint-disable-next-line typescript/consistent-return -- ends with fail(), which always throws
 function runCapture(command, args, options = {}) {
   const { allowFailure = false } = options;
   const result = spawnSync(command, args, {
@@ -178,7 +189,7 @@ function normalizeRepositoryUrl(remoteUrl) {
 /**
  * Read the repository from git remote.origin.url.
  *
- * @returns {Promise<string | null>} Repository in owner/repo form, or null.
+ * @returns {string | null} Repository in owner/repo form, or null.
  */
 function getRepositoryFromGit() {
   const result = runCapture('git', ['remote', 'get-url', 'origin'], { allowFailure: true });
@@ -191,7 +202,7 @@ function getRepositoryFromGit() {
 /**
  * Read the repository from package.json.
  *
- * @returns {Promise<string | null>} Repository in owner/repo form, or null.
+ * @returns {string | null} Repository in owner/repo form, or null.
  */
 function getRepositoryFromPackageJson() {
   try {
@@ -208,7 +219,7 @@ function getRepositoryFromPackageJson() {
 /**
  * Determine the current GitHub repository.
  *
- * @returns {Promise<string>} Repository in owner/repo form.
+ * @returns {string} Repository in owner/repo form.
  */
 function getRepositoryNameWithOwner() {
   const fromGit = getRepositoryFromGit();
@@ -228,7 +239,7 @@ function getRepositoryNameWithOwner() {
  * Call the GitHub API and parse a JSON response.
  *
  * @param {string} pathname - GitHub API path.
- * @returns {Promise<unknown>} Parsed JSON payload.
+ * @returns {unknown} Parsed JSON payload.
  */
 function ghApiJson(pathname) {
   const { stdout } = runCapture('gh', ['api', '--method', 'GET', pathname]);

package/vendor/scripts/prune-tags.mjs

@@ -8,6 +8,8 @@
  *   node scripts/prune-tags.mjs [--dry-run|-n] <tag-prefix-to-keep> [remote]
  */
 
+/* oxlint-disable no-console */
+
 import { spawnSync } from 'node:child_process';
 import { createInterface } from 'node:readline';
 
@@ -68,6 +70,13 @@ function section(title) {
   hr();
 }
 
+/**
+ * Throw an ExitError.
+ *
+ * @param {string} message - Error message.
+ * @param {number} [code] - Exit code.
+ * @returns {never} Never returns.
+ */
 function fail(message, code = 1) {
   throw new ExitError(message, code);
 }
@@ -75,6 +84,7 @@ function fail(message, code = 1) {
 function parseArgs(argv) {
   if (argv.includes('--help') || argv.includes('-h')) {
     console.log(usage());
+    // oxlint-disable-next-line unicorn/no-useless-undefined
     return undefined;
   }
 
@@ -95,6 +105,7 @@ function parseArgs(argv) {
   return { dryRun, keepPrefix, remote };
 }
 
+// oxlint-disable-next-line typescript/consistent-return -- ends with fail(), which always throws
 function runGit(args, options = {}) {
   const { allowFailure = false, input, inherit = false } = options;
   const result = spawnSync('git', args, {
@@ -158,7 +169,7 @@ function parseTagNames(raw) {
     tags.add(ref.replace(/^refs\/tags\//, '').replace(/\^\{\}$/, ''));
   }
 
-  return Array.from(tags).sort((left, right) => left.localeCompare(right));
+  return Array.from(tags).toSorted((left, right) => left.localeCompare(right));
 }
 
 function printTagTable(tags, colorizer = (value) => value) {
@@ -306,7 +317,7 @@ async function main() {
     ? localTagsRaw
         .split('\n')
         .filter(Boolean)
-        .sort((left, right) => left.localeCompare(right))
+        .toSorted((left, right) => left.localeCompare(right))
     : [];
   printTagTable(localTags, colors.green);
 }

package/vendor/scripts/remove-workflows.mjs

@@ -13,6 +13,9 @@
  *   git remote.origin.url configured, or package.json repository.url set
  */
 
+/* oxlint-disable no-console */
+/* oxlint-disable typescript/prefer-nullish-coalescing */
+
 import { spawn } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 
@@ -92,7 +95,7 @@ function parseArgs(argv) {
  * @param {string[]} args - Command arguments.
  * @returns {Promise<{ stdout: string, stderr: string }>} Captured output.
  */
-function execCapture(command, args) {
+async function execCapture(command, args) {
   return new Promise((resolve, reject) => {
     const child = spawn(command, args, {
       shell: false,
@@ -411,6 +414,7 @@ async function main() {
   }
 }
 
+// oxlint-disable-next-line typescript/use-unknown-in-catch-callback-variable
 main().catch((error) => {
   console.error(`remove-workflows: ${error?.message || error}`);
   console.error('Make sure GitHub CLI is installed and authenticated: gh auth status');

package/vendor/scripts/run-chip-tests.mjs

@@ -52,16 +52,18 @@
  * requiring the CSA reference app's --app-pipe debug hook, which Matterbridge doesn't implement).
  */
 
+/* oxlint-disable no-console */
+
 import { spawnSync } from 'node:child_process';
 import { appendFileSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import path from 'node:path';
 
 const root = process.cwd();
 const containerName = 'chip-test';
 const image = 'luligu/matterbridge:chip-test';
-const testsFile = resolve(root, 'chipTests.json');
-const logFile = resolve(root, 'chipTests.log');
-const summaryLogFile = resolve(root, 'chipTestsSummary.log');
+const testsFile = path.resolve(root, 'chipTests.json');
+const logFile = path.resolve(root, 'chipTests.log');
+const summaryLogFile = path.resolve(root, 'chipTestsSummary.log');
 // Node storage for the bridged endpoints; only stateful cluster attributes that get written during a
 // test create a file here, so these globs only ever remove test-mutated state, never device identity.
 const matterstorageRoot = '/root/.matterbridge/matterstorage/Matterbridge';
@@ -175,7 +177,7 @@ function start() {
     '-p',
     '8585:8283',
     '-v',
-    `${join(root, 'temp')}:/tmp/matter_testing/logs`,
+    `${path.join(root, 'temp')}:/tmp/matter_testing/logs`,
     '-v',
     `${root}:/root/Matterbridge/${pluginName}`,
     // Shadows just the node_modules subpath of the bind mount above with a named volume backed by the
@@ -236,6 +238,7 @@ function waitForContainerReady(sinceIso, timeoutMs = 45000, pollMs = 1000) {
     const result = run('docker', ['logs', '--since', sinceIso, containerName], { capture: true });
     // Matterbridge colorizes its log output with ANSI escapes even without a TTY, splitting the marker
     // text across escape sequences (e.g. "Matterbridge " <esc> "is online"); strip them before matching.
+    // oxlint-disable-next-line eslint/no-control-regex
     const plainOutput = `${result.stdout ?? ''}${result.stderr ?? ''}`.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
     if (plainOutput.includes(readyLogMarker)) {
       return;
@@ -280,7 +283,7 @@ function loadChipTestsFile() {
   const parsed = JSON.parse(raw);
 
   pluginConfig = parsed.config;
-  if (!pluginConfig || !pluginConfig.name) {
+  if (!pluginConfig?.name) {
     fail(`Expected a "config" object with a "name" property in ${testsFile}`);
   }
   pluginName = pluginConfig.name;
@@ -355,6 +358,7 @@ function filterTests(tests, nameFilter) {
   }
 
   const needle = nameFilter.toLowerCase();
+  // oxlint-disable-next-line typescript/prefer-nullish-coalescing
   const filtered = tests.filter((test) => test.name.toLowerCase().includes(needle) || test.test.toLowerCase().includes(needle));
   if (filtered.length === 0) {
     fail(`No test found with "name" or "test" including ${JSON.stringify(nameFilter)}`);

package/vendor/scripts/version.mjs

@@ -9,6 +9,8 @@
  *   node scripts/version.mjs <dev|edge|git|local|bun> [--dry-run]
  */
 
+/* oxlint-disable no-console */
+
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs/promises';
 import path from 'node:path';
@@ -40,7 +42,7 @@ function shortSha7FromGit(repoRoot) {
     encoding: 'utf8',
     stdio: ['ignore', 'pipe', 'ignore'],
   });
-  const sha = String(out).trim();
+  const sha = out.trim();
   if (!/^[0-9a-f]{7}$/i.test(sha)) {
     throw new Error(`Unexpected git short SHA output: ${JSON.stringify(sha)}`);
   }
@@ -74,8 +76,7 @@ if (unknownFlags.length > 0) {
 }
 
 const dryRun = args.includes('--dry-run') || args.includes('-n');
-const positional = args.filter((a) => !a.startsWith('-'));
-const tag = positional[0]?.toLowerCase();
+const tag = args.find((a) => !a.startsWith('-'))?.toLowerCase();
 if (tag !== 'dev' && tag !== 'edge' && tag !== 'git' && tag !== 'local' && tag !== 'bun') {
   console.error(usage());
   process.exitCode = 1;

package/vendor/scripts/run-automator.mjs

@@ -1,77 +0,0 @@
-/**
- * run-automator.mjs
- * Version: 1.0.2
- *
- * Launcher script for a developer "automator".
- *
- * The automator is a tool that automates package updates for internal projects.
- *
- * - Locates `automator.mjs` either via `AUTOMATOR_PATH` or common OneDrive roots.
- * - Invokes it with the current Node executable, forwarding CLI args and stdio.
- * - Exits with the same status code (or 1 on failure).
- *
- * Usage:
- *   node scripts/run-automator.mjs [args...]
- */
-
-import { spawnSync } from 'node:child_process';
-import { access } from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-
-const argv = process.argv.slice(2);
-
-const candidateOneDriveRoots = [
-  process.env.ONE_DRIVE_ROOT,
-  process.env.OneDriveCommercial,
-  process.env.OneDriveConsumer,
-  process.env.OneDrive,
-  process.env.ONEDRIVE,
-  process.env.HOMEPATH && process.env.HOMEDRIVE ? path.join(process.env.HOMEDRIVE, process.env.HOMEPATH, 'OneDrive') : undefined,
-  process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'OneDrive') : undefined,
-  process.env.HOME ? path.join(process.env.HOME, 'OneDrive') : undefined,
-].filter(Boolean);
-
-const defaultAutomatorRelative = path.join('Code', 'automator', 'automator.mjs');
-
-const candidateAutomatorPaths = [process.env.AUTOMATOR_PATH, ...candidateOneDriveRoots.map((root) => path.join(root, defaultAutomatorRelative))].filter(Boolean);
-
-const exists = async (filePath) => {
-  try {
-    await access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-};
-
-let automatorPath;
-for (const candidate of candidateAutomatorPaths) {
-  if (await exists(candidate)) {
-    automatorPath = candidate;
-    break;
-  }
-}
-
-if (!automatorPath) {
-  const lines = [
-    '[automator] Could not locate automator.mjs.',
-    '',
-    'Tried:',
-    ...candidateAutomatorPaths.map((p) => `  - ${p}`),
-    '',
-    'Fix options:',
-    '  - Set env var AUTOMATOR_PATH to the full path of automator.mjs',
-    '  - Or set env var ONE_DRIVE_ROOT to your OneDrive root directory',
-    '  - Or ensure OneDrive env vars (OneDrive/OneDriveCommercial/OneDriveConsumer) are set',
-  ];
-  console.error(lines.join(os.EOL));
-  process.exit(1);
-}
-
-const result = spawnSync(process.execPath, [automatorPath, ...argv], {
-  stdio: 'inherit',
-  windowsHide: true,
-});
-
-process.exit(result.status ?? 1);