@kitschpatrol/shared-config 5.6.0 → 5.7.1

package/bin/cli.js

@@ -11084,7 +11084,7 @@ var Yargs = YargsFactory(esm_default);
 var yargs_default = Yargs;
 
 // ../../package.json
-var version = "5.6.0";
+var version = "5.7.1";
 
 // ../../src/execa-utilities.ts
 function isErrorExecaError(error) {
@@ -11975,7 +11975,7 @@ var commandDefinition = {
   description: "Kitschpatrol's CSpell shared configuration tools. (Automated fixes are handled by ESLint.)",
   logColor: "cyan",
   logPrefix: "[CSpell]",
-  name: "kpi-cspell",
+  name: "ksc-cspell",
   order: 6
 };
 
@@ -12045,7 +12045,7 @@ var commandDefinition2 = {
   description: "Kitschpatrol's ESLint shared configuration tools.",
   logColor: "magenta",
   logPrefix: `[ESLint]`,
-  name: "kpi-eslint",
+  name: "ksc-eslint",
   order: 4
 };
 
@@ -12068,17 +12068,17 @@ var sharedKnipConfig = {
     "prettier.config.{js,mjs,cjs,ts,mts,cts}",
     "stylelint.config.{js,mjs,cjs,ts,mts,cts}"
   ],
-  // Allow calling of individual kpi binaries...
+  // Allow calling of individual ksc binaries...
   ignoreBinaries: [
-    "kpi-repo",
-    "kpi-mdat",
-    "kpi-typescript",
-    "kpi-eslint",
-    "kpi-stylelint",
-    "kpi-cspell",
-    "kpi-knip",
-    "kpi-remark",
-    "kpi-prettier",
+    "ksc-repo",
+    "ksc-mdat",
+    "ksc-typescript",
+    "ksc-eslint",
+    "ksc-stylelint",
+    "ksc-cspell",
+    "ksc-knip",
+    "ksc-remark",
+    "ksc-prettier",
     // 1Password CLI, typically a global install...
     "op",
     // GitHub CLI, typically a global install...
@@ -12128,8 +12128,8 @@ function getKnipPackageJsonObject() {
 var commandDefinition3 = {
   commands: {
     // In practice, Knip's auto-fix behavior is too dangerous for most projects.
-    // Since kpi doesn't currently have per-tool configuration options, we'll
-    // just disable `kpi-knip fix` for now.
+    // Since ksc doesn't currently have per-tool configuration options, we'll
+    // just disable `ksc-knip fix` for now.
     //
     // fix: {
     // 	commands: [
@@ -12181,7 +12181,7 @@ var commandDefinition3 = {
   description: "Kitschpatrol's Knip shared configuration tools.",
   logColor: "cyan",
   logPrefix: "[Knip]",
-  name: "kpi-knip",
+  name: "ksc-knip",
   order: 7
 };
 
@@ -12262,7 +12262,7 @@ var commandDefinition4 = {
   description: "Kitschpatrol's Mdat shared configuration tools.",
   logColor: "green",
   logPrefix: "[Mdat Config]",
-  name: "kpi-mdat",
+  name: "ksc-mdat",
   order: 2
 };
 
@@ -12326,7 +12326,7 @@ var commandDefinition5 = {
   description: "Kitschpatrol's Prettier shared configuration tools.",
   logColor: "blue",
   logPrefix: "[Prettier]",
-  name: "kpi-prettier",
+  name: "ksc-prettier",
   order: 9
 };
 
@@ -12352,18 +12352,19 @@ var commandDefinition6 = {
   description: "Kitschpatrol's Remark and Remark Lint shared configuration tools. (Actual linting and fixing is managed through @kitschpatrol/eslint-config.)",
   logColor: "blue",
   logPrefix: "[remarklint]",
-  name: "kpi-remark",
+  name: "ksc-remark",
   order: 8
 };
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/index.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/index.js
 import process5 from "node:process";
 import fs6 from "node:fs";
 import nodePath from "node:path";
+import { Readable } from "node:stream";
 
-// ../../node_modules/.pnpm/@sindresorhus+merge-streams@2.3.0/node_modules/@sindresorhus/merge-streams/index.js
+// ../../node_modules/.pnpm/@sindresorhus+merge-streams@4.0.0/node_modules/@sindresorhus/merge-streams/index.js
 import { on, once } from "node:events";
-import { PassThrough as PassThroughStream } from "node:stream";
+import { PassThrough as PassThroughStream, getDefaultHighWaterMark } from "node:stream";
 import { finished } from "node:stream/promises";
 function mergeStreams(streams) {
   if (!Array.isArray(streams)) {
@@ -12382,14 +12383,11 @@ function mergeStreams(streams) {
   for (const stream of streams) {
     passThroughStream.add(stream);
   }
-  if (streams.length === 0) {
-    endStream(passThroughStream);
-  }
   return passThroughStream;
 }
 var getHighWaterMark = (streams, objectMode) => {
   if (streams.length === 0) {
-    return 16384;
+    return getDefaultHighWaterMark(objectMode);
   }
   const highWaterMarks = streams.filter(({ readableObjectMode }) => readableObjectMode === objectMode).map(({ readableHighWaterMark }) => readableHighWaterMark);
   return Math.max(...highWaterMarks);
@@ -12399,39 +12397,49 @@ var MergedStream = class extends PassThroughStream {
   #ended = /* @__PURE__ */ new Set([]);
   #aborted = /* @__PURE__ */ new Set([]);
   #onFinished;
+  #unpipeEvent = Symbol("unpipe");
+  #streamPromises = /* @__PURE__ */ new WeakMap();
   add(stream) {
     validateStream(stream);
     if (this.#streams.has(stream)) {
       return;
     }
     this.#streams.add(stream);
-    this.#onFinished ??= onMergedStreamFinished(this, this.#streams);
-    endWhenStreamsDone({
+    this.#onFinished ??= onMergedStreamFinished(this, this.#streams, this.#unpipeEvent);
+    const streamPromise = endWhenStreamsDone({
       passThroughStream: this,
       stream,
       streams: this.#streams,
       ended: this.#ended,
       aborted: this.#aborted,
-      onFinished: this.#onFinished
+      onFinished: this.#onFinished,
+      unpipeEvent: this.#unpipeEvent
     });
+    this.#streamPromises.set(stream, streamPromise);
     stream.pipe(this, { end: false });
   }
-  remove(stream) {
+  async remove(stream) {
     validateStream(stream);
     if (!this.#streams.has(stream)) {
       return false;
     }
+    const streamPromise = this.#streamPromises.get(stream);
+    if (streamPromise === void 0) {
+      return false;
+    }
+    this.#streamPromises.delete(stream);
     stream.unpipe(this);
+    await streamPromise;
     return true;
   }
 };
-var onMergedStreamFinished = async (passThroughStream, streams) => {
+var onMergedStreamFinished = async (passThroughStream, streams, unpipeEvent) => {
   updateMaxListeners(passThroughStream, PASSTHROUGH_LISTENERS_COUNT);
   const controller = new AbortController();
   try {
     await Promise.race([
       onMergedStreamEnd(passThroughStream, controller),
-      onInputStreamsUnpipe(passThroughStream, streams, controller)
+      onInputStreamsUnpipe(passThroughStream, streams, unpipeEvent, controller)
     ]);
   } finally {
     controller.abort();
@@ -12439,9 +12447,14 @@ var onMergedStreamFinished = async (passThroughStream, streams) => {
   }
 };
 var onMergedStreamEnd = async (passThroughStream, { signal }) => {
-  await finished(passThroughStream, { signal, cleanup: true });
+  try {
+    await finished(passThroughStream, { signal, cleanup: true });
+  } catch (error) {
+    errorOrAbortStream(passThroughStream, error);
+    throw error;
+  }
 };
-var onInputStreamsUnpipe = async (passThroughStream, streams, { signal }) => {
+var onInputStreamsUnpipe = async (passThroughStream, streams, unpipeEvent, { signal }) => {
   for await (const [unpipedStream] of on(passThroughStream, "unpipe", { signal })) {
     if (streams.has(unpipedStream)) {
       unpipedStream.emit(unpipeEvent);
@@ -12453,20 +12466,34 @@ var validateStream = (stream) => {
     throw new TypeError(`Expected a readable stream, got: \`${typeof stream}\`.`);
   }
 };
-var endWhenStreamsDone = async ({ passThroughStream, stream, streams, ended, aborted, onFinished }) => {
+var endWhenStreamsDone = async ({ passThroughStream, stream, streams, ended, aborted, onFinished, unpipeEvent }) => {
   updateMaxListeners(passThroughStream, PASSTHROUGH_LISTENERS_PER_STREAM);
   const controller = new AbortController();
   try {
     await Promise.race([
-      afterMergedStreamFinished(onFinished, stream),
-      onInputStreamEnd({ passThroughStream, stream, streams, ended, aborted, controller }),
-      onInputStreamUnpipe({ stream, streams, ended, aborted, controller })
+      afterMergedStreamFinished(onFinished, stream, controller),
+      onInputStreamEnd({
+        passThroughStream,
+        stream,
+        streams,
+        ended,
+        aborted,
+        controller
+      }),
+      onInputStreamUnpipe({
+        stream,
+        streams,
+        ended,
+        aborted,
+        unpipeEvent,
+        controller
+      })
     ]);
   } finally {
     controller.abort();
     updateMaxListeners(passThroughStream, -PASSTHROUGH_LISTENERS_PER_STREAM);
   }
-  if (streams.size === ended.size + aborted.size) {
+  if (streams.size > 0 && streams.size === ended.size + aborted.size) {
     if (ended.size === 0 && aborted.size > 0) {
       abortStream(passThroughStream);
     } else {
@@ -12474,22 +12501,26 @@ var endWhenStreamsDone = async ({ passThroughStream, stream, streams, ended, abo
     }
   }
 };
-var isAbortError = (error) => error?.code === "ERR_STREAM_PREMATURE_CLOSE";
-var afterMergedStreamFinished = async (onFinished, stream) => {
+var afterMergedStreamFinished = async (onFinished, stream, { signal }) => {
   try {
     await onFinished;
-    abortStream(stream);
-  } catch (error) {
-    if (isAbortError(error)) {
+    if (!signal.aborted) {
       abortStream(stream);
-    } else {
-      errorStream(stream, error);
+    }
+  } catch (error) {
+    if (!signal.aborted) {
+      errorOrAbortStream(stream, error);
     }
   }
 };
 var onInputStreamEnd = async ({ passThroughStream, stream, streams, ended, aborted, controller: { signal } }) => {
   try {
-    await finished(stream, { signal, cleanup: true, readable: true, writable: false });
+    await finished(stream, {
+      signal,
+      cleanup: true,
+      readable: true,
+      writable: false
+    });
     if (streams.has(stream)) {
       ended.add(stream);
     }
@@ -12504,18 +12535,28 @@ var onInputStreamEnd = async ({ passThroughStream, stream, streams, ended, abort
     }
   }
 };
-var onInputStreamUnpipe = async ({ stream, streams, ended, aborted, controller: { signal } }) => {
+var onInputStreamUnpipe = async ({ stream, streams, ended, aborted, unpipeEvent, controller: { signal } }) => {
   await once(stream, unpipeEvent, { signal });
+  if (!stream.readable) {
+    return once(signal, "abort", { signal });
+  }
   streams.delete(stream);
   ended.delete(stream);
   aborted.delete(stream);
 };
-var unpipeEvent = Symbol("unpipe");
 var endStream = (stream) => {
   if (stream.writable) {
     stream.end();
   }
 };
+var errorOrAbortStream = (stream, error) => {
+  if (isAbortError(error)) {
+    abortStream(stream);
+  } else {
+    errorStream(stream, error);
+  }
+};
+var isAbortError = (error) => error?.code === "ERR_STREAM_PREMATURE_CLOSE";
 var abortStream = (stream) => {
   if (stream.readable || stream.writable) {
     stream.destroy();
@@ -12538,7 +12579,7 @@ var updateMaxListeners = (passThroughStream, increment2) => {
 var PASSTHROUGH_LISTENERS_COUNT = 2;
 var PASSTHROUGH_LISTENERS_PER_STREAM = 1;
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/index.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/index.js
 var import_fast_glob2 = __toESM(require_out4(), 1);
 
 // ../../node_modules/.pnpm/path-type@6.0.0/node_modules/path-type/index.js
@@ -12588,7 +12629,7 @@ function toPath2(urlOrPath) {
 }
 var TEN_MEGABYTES_IN_BYTES = 10 * 1024 * 1024;
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/ignore.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/ignore.js
 var import_fast_glob = __toESM(require_out4(), 1);
 var import_ignore = __toESM(require_ignore(), 1);
 import process4 from "node:process";
@@ -12605,10 +12646,10 @@ function slash(path10) {
   return path10.replace(/\\/g, "/");
 }
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/utilities.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/utilities.js
 var isNegativePattern = (pattern) => pattern[0] === "!";
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/ignore.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/ignore.js
 var defaultIgnoredDirectories = [
   "**/node_modules",
   "**/flow-typed",
@@ -12620,7 +12661,24 @@ var ignoreFilesGlobOptions = {
   dot: true
 };
 var GITIGNORE_FILES_PATTERN = "**/.gitignore";
-var applyBaseToPattern = (pattern, base) => isNegativePattern(pattern) ? "!" + path7.posix.join(base, pattern.slice(1)) : path7.posix.join(base, pattern);
+var applyBaseToPattern = (pattern, base) => {
+  if (!base) {
+    return pattern;
+  }
+  const isNegative = isNegativePattern(pattern);
+  const cleanPattern = isNegative ? pattern.slice(1) : pattern;
+  const slashIndex = cleanPattern.indexOf("/");
+  const hasNonTrailingSlash = slashIndex !== -1 && slashIndex !== cleanPattern.length - 1;
+  let result;
+  if (!hasNonTrailingSlash) {
+    result = path7.posix.join(base, "**", cleanPattern);
+  } else if (cleanPattern.startsWith("/")) {
+    result = path7.posix.join(base, cleanPattern.slice(1));
+  } else {
+    result = path7.posix.join(base, cleanPattern);
+  }
+  return isNegative ? "!" + result : result;
+};
 var parseIgnoreFile = (file, cwd) => {
   const base = slash(path7.relative(cwd, path7.dirname(file.filePath)));
   return file.content.split(/\r?\n/).filter((line) => line && !line.startsWith("#")).map((pattern) => applyBaseToPattern(pattern, base));
@@ -12633,6 +12691,12 @@ var toRelativePath = (fileOrDirectory, cwd) => {
     }
     throw new Error(`Path ${fileOrDirectory} is not in cwd ${cwd}`);
   }
+  if (fileOrDirectory.startsWith("./")) {
+    return fileOrDirectory.slice(2);
+  }
+  if (fileOrDirectory.startsWith("../")) {
+    return void 0;
+  }
   return fileOrDirectory;
 };
 var getIsIgnoredPredicate = (files, cwd) => {
@@ -12641,6 +12705,9 @@ var getIsIgnoredPredicate = (files, cwd) => {
   return (fileOrDirectory) => {
     fileOrDirectory = toPath2(fileOrDirectory);
     fileOrDirectory = toRelativePath(fileOrDirectory, cwd);
+    if (fileOrDirectory === void 0) {
+      return false;
+    }
     return fileOrDirectory ? ignores.ignores(slash(fileOrDirectory)) : false;
   };
 };
@@ -12659,12 +12726,10 @@ var isIgnoredByIgnoreFiles = async (patterns, options) => {
     ignore,
     ...ignoreFilesGlobOptions
   });
-  const files = await Promise.all(
-    paths.map(async (filePath) => ({
-      filePath,
-      content: await fsPromises3.readFile(filePath, "utf8")
-    }))
-  );
+  const files = await Promise.all(paths.map(async (filePath) => ({
+    filePath,
+    content: await fsPromises3.readFile(filePath, "utf8")
+  })));
   return getIsIgnoredPredicate(files, cwd);
 };
 var isIgnoredByIgnoreFilesSync = (patterns, options) => {
@@ -12683,7 +12748,7 @@ var isIgnoredByIgnoreFilesSync = (patterns, options) => {
   return getIsIgnoredPredicate(files, cwd);
 };
 
-// ../../node_modules/.pnpm/globby@14.1.0/node_modules/globby/index.js
+// ../../node_modules/.pnpm/globby@15.0.0/node_modules/globby/index.js
 var assertPatternsInput = (patterns) => {
   if (patterns.some((pattern) => typeof pattern !== "string")) {
     throw new TypeError("Patterns must be a string or an array of strings");
@@ -12693,6 +12758,16 @@ var normalizePathForDirectoryGlob = (filePath, cwd) => {
   const path10 = isNegativePattern(filePath) ? filePath.slice(1) : filePath;
   return nodePath.isAbsolute(path10) ? path10 : nodePath.join(cwd, path10);
 };
+var shouldExpandGlobstarDirectory = (pattern) => {
+  const match = pattern?.match(/\*\*\/([^/]+)$/);
+  if (!match) {
+    return false;
+  }
+  const dirname3 = match[1];
+  const hasWildcards = /[*?[\]{}]/.test(dirname3);
+  const hasExtension = nodePath.extname(dirname3) && !dirname3.startsWith(".");
+  return !hasWildcards && !hasExtension;
+};
 var getDirectoryGlob = ({ directoryPath, files, extensions }) => {
   const extensionGlob = extensions?.length > 0 ? `.${extensions.length > 1 ? `{${extensions.join(",")}}` : extensions[0]}` : "";
   return files ? files.map((file) => nodePath.posix.join(directoryPath, `**/${nodePath.extname(file) ? file : `${file}${extensionGlob}`}`)) : [nodePath.posix.join(directoryPath, `**${extensionGlob ? `/*${extensionGlob}` : ""}`)];
@@ -12702,16 +12777,28 @@ var directoryToGlob = async (directoryPaths, {
   files,
   extensions
 } = {}) => {
-  const globs = await Promise.all(
-    directoryPaths.map(async (directoryPath) => await isDirectory(normalizePathForDirectoryGlob(directoryPath, cwd)) ? getDirectoryGlob({ directoryPath, files, extensions }) : directoryPath)
-  );
+  const globs = await Promise.all(directoryPaths.map(async (directoryPath) => {
+    const checkPattern = isNegativePattern(directoryPath) ? directoryPath.slice(1) : directoryPath;
+    if (shouldExpandGlobstarDirectory(checkPattern)) {
+      return getDirectoryGlob({ directoryPath, files, extensions });
+    }
+    const pathToCheck = normalizePathForDirectoryGlob(directoryPath, cwd);
+    return await isDirectory(pathToCheck) ? getDirectoryGlob({ directoryPath, files, extensions }) : directoryPath;
+  }));
   return globs.flat();
 };
 var directoryToGlobSync = (directoryPaths, {
   cwd = process5.cwd(),
   files,
   extensions
-} = {}) => directoryPaths.flatMap((directoryPath) => isDirectorySync(normalizePathForDirectoryGlob(directoryPath, cwd)) ? getDirectoryGlob({ directoryPath, files, extensions }) : directoryPath);
+} = {}) => directoryPaths.flatMap((directoryPath) => {
+  const checkPattern = isNegativePattern(directoryPath) ? directoryPath.slice(1) : directoryPath;
+  if (shouldExpandGlobstarDirectory(checkPattern)) {
+    return getDirectoryGlob({ directoryPath, files, extensions });
+  }
+  const pathToCheck = normalizePathForDirectoryGlob(directoryPath, cwd);
+  return isDirectorySync(pathToCheck) ? getDirectoryGlob({ directoryPath, files, extensions }) : directoryPath;
+});
 var toPatternsArray = (patterns) => {
   patterns = [...new Set([patterns].flat())];
   assertPatternsInput(patterns);
@@ -12753,15 +12840,11 @@ var getIgnoreFilesPatterns = (options) => {
 };
 var getFilter = async (options) => {
   const ignoreFilesPatterns = getIgnoreFilesPatterns(options);
-  return createFilterFunction(
-    ignoreFilesPatterns.length > 0 && await isIgnoredByIgnoreFiles(ignoreFilesPatterns, options)
-  );
+  return createFilterFunction(ignoreFilesPatterns.length > 0 && await isIgnoredByIgnoreFiles(ignoreFilesPatterns, options));
 };
 var getFilterSync = (options) => {
   const ignoreFilesPatterns = getIgnoreFilesPatterns(options);
-  return createFilterFunction(
-    ignoreFilesPatterns.length > 0 && isIgnoredByIgnoreFilesSync(ignoreFilesPatterns, options)
-  );
+  return createFilterFunction(ignoreFilesPatterns.length > 0 && isIgnoredByIgnoreFilesSync(ignoreFilesPatterns, options));
 };
 var createFilterFunction = (isIgnored) => {
   const seen = /* @__PURE__ */ new Set();
@@ -12814,19 +12897,17 @@ var generateTasks = async (patterns, options) => {
     return globTasks;
   }
   const directoryToGlobOptions = normalizeExpandDirectoriesOption(expandDirectories, cwd);
-  return Promise.all(
-    globTasks.map(async (task) => {
-      let { patterns: patterns2, options: options2 } = task;
-      [
-        patterns2,
-        options2.ignore
-      ] = await Promise.all([
-        directoryToGlob(patterns2, directoryToGlobOptions),
-        directoryToGlob(options2.ignore, { cwd })
-      ]);
-      return { patterns: patterns2, options: options2 };
-    })
-  );
+  return Promise.all(globTasks.map(async (task) => {
+    let { patterns: patterns2, options: options2 } = task;
+    [
+      patterns2,
+      options2.ignore
+    ] = await Promise.all([
+      directoryToGlob(patterns2, directoryToGlobOptions),
+      directoryToGlob(options2.ignore, { cwd })
+    ]);
+    return { patterns: patterns2, options: options2 };
+  }));
 };
 var generateTasksSync = (patterns, options) => {
   const globTasks = convertNegativePatterns(patterns, options);
@@ -12863,12 +12944,13 @@ var globbyStream = normalizeArgumentsSync((patterns, options) => {
   const tasks = generateTasksSync(patterns, options);
   const filter = getFilterSync(options);
   const streams = tasks.map((task) => import_fast_glob2.default.stream(task.patterns, task.options));
+  if (streams.length === 0) {
+    return Readable.from([]);
+  }
   const stream = mergeStreams(streams).filter((fastGlobResult) => filter(fastGlobResult));
   return stream;
 });
-var isDynamicPattern = normalizeArgumentsSync(
-  (patterns, options) => patterns.some((pattern) => import_fast_glob2.default.isDynamicPattern(pattern, options))
-);
+var isDynamicPattern = normalizeArgumentsSync((patterns, options) => patterns.some((pattern) => import_fast_glob2.default.isDynamicPattern(pattern, options)));
 var generateGlobTasks = normalizeArguments(generateTasks);
 var generateGlobTasksSync = normalizeArgumentsSync(generateTasksSync);
 var { convertPathToPattern } = import_fast_glob2.default;
@@ -12977,7 +13059,7 @@ var commandDefinition7 = {
   description: "Kitschpatrol's repository-related shared configuration tools.",
   logColor: "gray",
   logPrefix: "[Repo Config]",
-  name: "kpi-repo",
+  name: "ksc-repo",
   order: 1
 };
 
@@ -13080,7 +13162,7 @@ var commandDefinition8 = {
   description: "Kitschpatrol's Stylelint shared configuration tools.",
   logColor: "greenBright",
   logPrefix: "[Stylelint]",
-  name: "kpi-stylelint",
+  name: "ksc-stylelint",
   order: 5
 };
 
@@ -13145,7 +13227,7 @@ var commandDefinition9 = {
   description: "Kitschpatrol's TypeScript shared configuration tools.",
   logColor: "blueBright",
   logPrefix: "[TypeScript Config]",
-  name: "kpi-typescript",
+  name: "ksc-typescript",
   order: 3
 };
 
@@ -13209,7 +13291,7 @@ var commandDefinition10 = {
   description: "Run aggregated @kitschpatrol/shared-config commands.",
   logColor: "yellow",
   logPrefix: "\u{1F52C}",
-  name: "kpi",
+  name: "ksc",
   order: 0,
   showSummary: true,
   verbose: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitschpatrol/shared-config",
-  "version": "5.6.0",
+  "version": "5.7.1",
   "description": "A collection of shared configurations, linters, and formatting tools for TypeScript projects. All managed as a single dependency, and invoked via a single CLI command.",
   "keywords": [
     "shared-config",
@@ -13,7 +13,7 @@
     "cspell",
     "mdat",
     "cli",
-    "kpi"
+    "ksc"
   ],
   "homepage": "https://github.com/kitschpatrol/shared-config",
   "bugs": "https://github.com/kitschpatrol/shared-config/issues",
@@ -30,7 +30,8 @@
   },
   "type": "module",
   "bin": {
-    "kpi": "bin/cli.js"
+    "kpi": "bin/cli.js",
+    "ksc": "bin/cli.js"
   },
   "files": [
     "bin/*"
@@ -41,20 +42,20 @@
     "cosmiconfig-typescript-loader": "^6.1.0",
     "execa": "^9.6.0",
     "find-workspaces": "^0.3.1",
-    "fs-extra": "^11.3.1",
+    "fs-extra": "^11.3.2",
     "prettier": "^3.6.2",
-    "@kitschpatrol/mdat-config": "5.6.0",
-    "@kitschpatrol/cspell-config": "5.6.0",
-    "@kitschpatrol/eslint-config": "5.6.0",
-    "@kitschpatrol/prettier-config": "5.6.0",
-    "@kitschpatrol/knip-config": "5.6.0",
-    "@kitschpatrol/repo-config": "5.6.0",
-    "@kitschpatrol/remark-config": "5.6.0",
-    "@kitschpatrol/stylelint-config": "5.6.0",
-    "@kitschpatrol/typescript-config": "5.6.0"
+    "@kitschpatrol/cspell-config": "5.7.1",
+    "@kitschpatrol/knip-config": "5.7.1",
+    "@kitschpatrol/eslint-config": "5.7.1",
+    "@kitschpatrol/remark-config": "5.7.1",
+    "@kitschpatrol/mdat-config": "5.7.1",
+    "@kitschpatrol/repo-config": "5.7.1",
+    "@kitschpatrol/prettier-config": "5.7.1",
+    "@kitschpatrol/stylelint-config": "5.7.1",
+    "@kitschpatrol/typescript-config": "5.7.1"
   },
   "devDependencies": {
-    "globby": "^14.1.0",
+    "globby": "^15.0.0",
     "picocolors": "^1.1.1"
   },
   "engines": {

package/readme.md

@@ -35,15 +35,15 @@
 
 ## Overview
 
-This project attempts to consolidate most of the configuration and tooling shared by my open-source and internal TypeScript / Node based projects into a single dependency with a single CLI meta-command to lint and fix issues.
+This project consolidates most of the configuration and tooling shared by my open-source and internal TypeScript-based projects into a single dependency with a single CLI meta-command to lint and fix issues.
 
-By installing `@kitschpatrol/shared-config` and then running `kpi`, you can run a half-dozen pre-configured code quality and linting tools in one shot. This spares you from cluttering your project's `devDependencies` with packages tangential to the task at hand.
+By installing `@kitschpatrol/shared-config` and then running `ksc`, you can run a half-dozen pre-configured code quality and linting tools in one shot. This spares you from cluttering your project's `devDependencies` with packages tangential to the task at hand.
 
-If you don't plan to customize tool configurations, `@kitschpatrol/shared-config init` exposes an option to store references to each tool's shared configuration in your `package.json` instead of in files in your project root (at least where permitted by the tool). This can save a bit of file clutter in your project's root directory, at the expense of the immediate discoverability of the tools.
+If you don't plan to customize tool configurations, `ksc init` exposes an option to store references to each tool's shared configuration in your `package.json` instead of in files in your project root (at least where permitted by the tool). This can save a bit of file clutter in your project's root directory, at the expense of the immediate discoverability of the tools.
 
 In addition, each tool exports a typed configuration factory function to simplify specifying and extending the default configuration.
 
-The command name `kpi` might stand for "Kitschpatrol Project Inspector", or the more McKinseyan "Key Performance Indicators".
+The command name `ksc` is just an initialism for "Kitschpatrol Shared Configuration".
 
 ### Tools
 
@@ -67,51 +67,51 @@ This particular readme is for the [`@kitschpatrol/shared-config`](https://www.np
 
 #### Primary package
 
-- [`@kitschpatrol/shared-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/shared-config/readme.md) (`kpi` command)
+- [`@kitschpatrol/shared-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/shared-config/readme.md) (`ksc` command)
 
 #### Sub-packages
 
-- [`@kitschpatrol/cspell-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/cspell-config/readme.md) (`kpi-cspell` command)
-- [`@kitschpatrol/eslint-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/eslint-config/readme.md) (`kpi-eslint` command)
-- [`@kitschpatrol/knip-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/knip-config/readme.md) (`kpi-knip` command)
-- [`@kitschpatrol/mdat-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/mdat-config/readme.md) (`kpi-mdat` command)
-- [`@kitschpatrol/prettier-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/prettier-config/readme.md) (`kpi-prettier` command)
-- [`@kitschpatrol/remark-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/remark-config/readme.md) (`kpi-remark` command)
-- [`@kitschpatrol/repo-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/repo-config/readme.md) (`kpi-repo` command)
-- [`@kitschpatrol/stylelint-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/stylelint-config/readme.md) (`kpi-stylelint` command)
-- [`@kitschpatrol/typescript-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/typescript-config/readme.md) (`kpi-typescript` command)
+- [`@kitschpatrol/cspell-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/cspell-config/readme.md) (`ksc-cspell` command)
+- [`@kitschpatrol/eslint-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/eslint-config/readme.md) (`ksc-eslint` command)
+- [`@kitschpatrol/knip-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/knip-config/readme.md) (`ksc-knip` command)
+- [`@kitschpatrol/mdat-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/mdat-config/readme.md) (`ksc-mdat` command)
+- [`@kitschpatrol/prettier-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/prettier-config/readme.md) (`ksc-prettier` command)
+- [`@kitschpatrol/remark-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/remark-config/readme.md) (`ksc-remark` command)
+- [`@kitschpatrol/repo-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/repo-config/readme.md) (`ksc-repo` command)
+- [`@kitschpatrol/stylelint-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/stylelint-config/readme.md) (`ksc-stylelint` command)
+- [`@kitschpatrol/typescript-config`](https://github.com/kitschpatrol/shared-config/blob/main/packages/typescript-config/readme.md) (`ksc-typescript` command)
 
 > [!IMPORTANT]
 >
 > Any of these packages may be installed and run on their own via CLI if desired. However, in general, the idea is to use `@kitschpatrol/shared-config` to easily run them all simultaneously over a repo with a single command with options to either check or (where possible) fix problems, with output aggregated into a single report.
 
-Running `kpi <command>` calls the same command across the entire collection of sub-packages.
+Running `ksc <command>` calls the same command across the entire collection of sub-packages.
 
 So assuming you've installed `@kitschpatrol/shared-config`...
 
 Running:
 
 ```sh
-kpi init
+ksc init
 ```
 
 Is the same as running:
 
 ```sh
-kpi-repo init
-kpi-mdat init
-kpi-typescript init
-kpi-eslint init
-kpi-stylelint init
-kpi-cspell init
-kpi-knip init
-kpi-remark init
-kpi-prettier init
+ksc-repo init
+ksc-mdat init
+ksc-typescript init
+ksc-eslint init
+ksc-stylelint init
+ksc-cspell init
+ksc-knip init
+ksc-remark init
+ksc-prettier init
 ```
 
 _(Sub-commands are always executed in the above order.)_
 
-The top-level `kpi` command also takes care of some nuances in terms of _which_ sub-packages implement _which_ commands, and which subcommands take arguments.
+The top-level `ksc` command also takes care of some nuances in terms of _which_ sub-packages implement _which_ commands, and which subcommands take arguments.
 
 ## Getting started
 
@@ -126,19 +126,19 @@ The top-level `kpi` command also takes care of some nuances in terms of _which_
 Bootstrap a new project and open in VS Code:
 
 ```sh
-git init && pnpm init && pnpm pkg set type="module" && pnpm dlx @kitschpatrol/repo-config init && pnpm add -D @kitschpatrol/shared-config && pnpm kpi init && pnpm i && code .
+git init && pnpm init && pnpm pkg set type="module" && pnpm dlx @kitschpatrol/repo-config init && pnpm add -D @kitschpatrol/shared-config && pnpm ksc init && pnpm i && code .
 ```
 
-Note that `kpi init` takes an optional `--location package` flag will put as much configuration in your `package.json` as possible instead of creating discrete config files in your project root for each tool. Putting config in `package.json` can save some clutter, but can make it clunkier to extend or customize configurations.
+Note that `ksc init` takes an optional `--location package` flag will put as much configuration in your `package.json` as possible instead of creating discrete config files in your project root for each tool. Putting config in `package.json` can save some clutter, but can make it clunkier to extend or customize configurations.
 
-At any point, you can call `kpi init` again with the `--location package` or `--location file` flag to reinitialize your configuration files in one place or the other and restore the default configurations.
+At any point, you can call `ksc init` again with the `--location package` or `--location file` flag to reinitialize your configuration files in one place or the other and restore the default configurations.
 
 #### Quick add to an existing project:
 
 This might overwrite certain config files, so commit first:
 
 ```sh
-pnpm dlx @kitschpatrol/repo-config init && pnpm i && pnpm add -D @kitschpatrol/shared-config && pnpm kpi init
+pnpm dlx @kitschpatrol/repo-config init && pnpm i && pnpm add -D @kitschpatrol/shared-config && pnpm ksc init
 ```
 
 #### Step-by-step:
@@ -158,13 +158,13 @@ pnpm dlx @kitschpatrol/repo-config init && pnpm i && pnpm add -D @kitschpatrol/s
 3. Add default config files for all the tools to your project root:
 
    ```sh
-   pnpm kpi init
+   pnpm ksc init
    ```
 
    Or, if you don't plan to customize tool configurations, you might want to put as much config as possible under tool-specific keys in 'package.json':
 
    ```sh
-   pnpm kpi init --location package
+   pnpm ksc init --location package
    ```
 
 4. Add helper scripts to your `package.json`:
@@ -174,8 +174,8 @@ pnpm dlx @kitschpatrol/repo-config init && pnpm i && pnpm add -D @kitschpatrol/s
    ```json
    {
      "scripts": {
-       "fix": "kpi fix",
-       "lint": "kpi lint"
+       "fix": "ksc fix",
+       "lint": "ksc lint"
      }
    }
    ```
@@ -208,18 +208,18 @@ pnpm run fix
 
 ### CLI
 
-<!-- cli-help cliCommand: 'kpi' -->
+<!-- cli-help cliCommand: 'ksc' -->
 
-#### Command: `kpi`
+#### Command: `ksc`
 
 Run aggregated @kitschpatrol/shared-config commands.
 
-This section lists top-level commands for `kpi`.
+This section lists top-level commands for `ksc`.
 
 Usage:
 
 ```txt
-kpi <command>
+ksc <command>
 ```
 
 | Command        | Argument    | Description                                                                                                                                                                                 |
@@ -236,14 +236,14 @@ kpi <command>
 
 _See the sections below for more information on each subcommand._
 
-#### Subcommand: `kpi init`
+#### Subcommand: `ksc init`
 
 Initialize configuration files for the entire suite of @kitschpatrol/shared-config tools. Will use option flags where possible if provided, but some of the invoked tools will ignore them.
 
 Usage:
 
 ```txt
-kpi init
+ksc init
 ```
 
 | Option              | Description         | Type                 | Default  |
@@ -252,14 +252,14 @@ kpi init
 | `--help`<br>`-h`    | Show help           | `boolean`            |          |
 | `--version`<br>`-v` | Show version number | `boolean`            |          |
 
-#### Subcommand: `kpi lint`
+#### Subcommand: `ksc lint`
 
 Lint your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package-scope.
 
 Usage:
 
 ```txt
-kpi lint [files..]
+ksc lint [files..]
 ```
 
 | Positional Argument | Description                    | Type    | Default |
@@ -271,14 +271,14 @@ kpi lint [files..]
 | `--help`<br>`-h`    | Show help           | `boolean` |
 | `--version`<br>`-v` | Show version number | `boolean` |
 
-#### Subcommand: `kpi fix`
+#### Subcommand: `ksc fix`
 
 Fix your project with multiple tools in one go. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package-scope.
 
 Usage:
 
 ```txt
-kpi fix [files..]
+ksc fix [files..]
 ```
 
 | Positional Argument | Description                   | Type    | Default |
@@ -290,14 +290,14 @@ kpi fix [files..]
 | `--help`<br>`-h`    | Show help           | `boolean` |
 | `--version`<br>`-v` | Show version number | `boolean` |
 
-#### Subcommand: `kpi print-config`
+#### Subcommand: `ksc print-config`
 
 Print aggregated tool configuration data. Will use file arguments / globs where possible if provided, but some of the invoked tools only operate at the package-scope.
 
 Usage:
 
 ```txt
-kpi print-config [file]
+ksc print-config [file]
 ```
 
 | Positional Argument | Description                 | Type     |
@@ -311,7 +311,7 @@ kpi print-config [file]
 
 <!-- /cli-help -->
 
-Recall that the `@kitschpatrol/shared-config` package aggregates integration and invocation of the other tool-specific packages in this monorepo. Running a cli command on `kpi` effectively runs the same command against all the tool-specific packages.
+Recall that the `@kitschpatrol/shared-config` package aggregates integration and invocation of the other tool-specific packages in this monorepo. Running a cli command on `ksc` effectively runs the same command against all the tool-specific packages.
 
 ## Implementation notes