Address PR feedback: rename isPluginOnly to providedByPlugin

Rename isPluginOnly → providedByPlugin for clarity per review feedback.
Also update the first changefile comment to reflect the globalPlugin design.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: iclanton

common/changes/@microsoft/rush/rush-published-versions-plugin_2026-03-15-04-22.json

@@ -2,7 +2,7 @@
   "changes": [
     {
       "packageName": "@microsoft/rush",
-      "comment": "Add `customParametersByLongName` and `setHandled()` to `IGlobalCommand`, enabling Rush plugins to implement native global commands. Plugins can now define global commands with an empty `shellCommand`, handle execution via the `runGlobalCustomCommand` hook, and access parsed command-line parameters.",
+      "comment": "Add `getCustomParametersByLongName()` and `setHandled()` to `IGlobalCommand`, enabling Rush plugins to implement native global commands. Add a new `\"globalPlugin\"` command kind for plugin-provided command-line.json files that requires no `shellCommand`.",
       "type": "none"
     }
   ],

libraries/rush-lib/src/api/CommandLineConfiguration.ts

@@ -129,10 +129,11 @@ export interface IPhasedCommandConfig extends IPhasedCommandWithoutPhasesJson, I
 
 export interface IGlobalCommandConfig extends IGlobalCommandJson, ICommandWithParameters {
   /**
-   * If true, this command was declared with commandKind "globalPlugin" and must be handled
-   * entirely by a Rush plugin. There is no shell command to execute.
+   * If true, this command was declared with commandKind "globalPlugin" and its implementation
+   * is provided by a Rush plugin via the `runGlobalCustomCommand` hook. There is no shell
+   * command to execute.
    */
-  isPluginOnly: boolean;
+  providedByPlugin: boolean;
 }
 
 export type Command = IGlobalCommandConfig | IPhasedCommandConfig;
@@ -414,7 +415,7 @@ export class CommandLineConfiguration {
           case RushConstants.globalCommandKind: {
             normalizedCommand = {
               ...command,
-              isPluginOnly: false,
+              providedByPlugin: false,
               associatedParameters: new Set<IParameterJson>()
             };
             break;
@@ -427,7 +428,7 @@ export class CommandLineConfiguration {
               ...command,
               commandKind: RushConstants.globalCommandKind,
               shellCommand: '',
-              isPluginOnly: true,
+              providedByPlugin: true,
               associatedParameters: new Set<IParameterJson>()
             };
             break;

libraries/rush-lib/src/cli/RushCommandLineParser.ts

@@ -435,7 +435,7 @@ export class RushCommandLineParser extends CommandLineParser {
     commandLineConfiguration: CommandLineConfiguration,
     command: IGlobalCommandConfig
   ): void {
-    const { name, shellCommand, autoinstallerName, isPluginOnly } = command;
+    const { name, shellCommand, autoinstallerName, providedByPlugin } = command;
 
     if (name === RushConstants.buildCommandName || name === RushConstants.rebuildCommandName) {
       throw new Error(
@@ -454,7 +454,7 @@ export class RushCommandLineParser extends CommandLineParser {
 
         shellCommand,
         autoinstallerName,
-        isPluginOnly
+        providedByPlugin
       })
     );
   }

libraries/rush-lib/src/cli/scriptActions/GlobalScriptAction.ts

@@ -30,7 +30,7 @@ import { measureAsyncFn } from '../../utilities/performance';
 export interface IGlobalScriptActionOptions extends IBaseScriptActionOptions<IGlobalCommandConfig> {
   shellCommand: string;
   autoinstallerName: string | undefined;
-  isPluginOnly: boolean;
+  providedByPlugin: boolean;
 }
 
 /**
@@ -47,16 +47,16 @@ export class GlobalScriptAction extends BaseScriptAction<IGlobalCommandConfig> {
   private readonly _shellCommand: string;
   private readonly _autoinstallerName: string;
   private readonly _autoinstallerFullPath: string;
-  private readonly _isPluginOnly: boolean;
+  private readonly _providedByPlugin: boolean;
 
   private _customParametersByLongName: ReadonlyMap<string, CommandLineParameter> | undefined;
   private _isHandled: boolean = false;
 
   public constructor(options: IGlobalScriptActionOptions) {
     super(options);
-    const { shellCommand, isPluginOnly, autoinstallerName = '' } = options;
+    const { shellCommand, providedByPlugin, autoinstallerName = '' } = options;
     this._shellCommand = shellCommand;
-    this._isPluginOnly = isPluginOnly;
+    this._providedByPlugin = providedByPlugin;
     this._autoinstallerName = autoinstallerName;
 
     if (this._autoinstallerName) {
@@ -163,7 +163,7 @@ export class GlobalScriptAction extends BaseScriptAction<IGlobalCommandConfig> {
       return;
     }
 
-    if (this._isPluginOnly) {
+    if (this._providedByPlugin) {
       throw new Error(
         `The custom command "${this.actionName}" is a "${RushConstants.globalPluginCommandKind}" command, ` +
           'meaning its implementation must be provided entirely by a Rush plugin. However, no plugin ' +