@flowscripter/dynamic-cli-framework 1.7.2 → 1.7.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -35,7 +35,7 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
-    "./plugin": {
+    "./cli-plugin": {
       "bun": "./cli-plugin.ts",
       "types": "./dist/cli-plugin.d.ts",
       "default": "./dist/cli-plugin.js"
@@ -45,7 +45,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bun build index.ts cli-plugin.ts --outdir dist --target bun && tsc -p tsconfig.build.json"
+    "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
     "@flowscripter/dynamic-plugin-framework": "1.10.1",

package/src/api/command/Command.ts

@@ -19,4 +19,10 @@ export default interface Command {
    * default argument values may be sourced using a configuration source provided by the CLI runtime.
    */
   readonly enableConfiguration?: boolean;
+
+  /**
+   * Optionally hide the command from generic help listings. The command remains registered and
+   * executable, and its own usage help (`help <command>`) is still shown if explicitly requested.
+   */
+  readonly disableGenericHelpDisplay?: boolean;
 }

package/src/api/service/core/TableGeneratorService.ts

@@ -32,6 +32,7 @@ export interface CellOptions {
 }
 
 export default interface TableGeneratorService {
+  createTable(rowCount: number, columnCount: number, options?: TableOptions): Table;
   render(table: Table): string;
 }
 

package/src/cli/BaseCLI.ts

@@ -33,6 +33,7 @@ import ConfigurationServiceProvider from "../service/configuration/Configuration
 import PrinterServiceProvider from "../service/printer/PrinterServiceProvider.ts";
 import TableGeneratorServiceProvider from "../service/tableGenerator/TableGeneratorServiceProvider.ts";
 import { run } from "../runtime/runner.ts";
+import { printRuntimeError } from "../util/runnerHelper.ts";
 
 import { WritableStream } from "node:stream/web";
 import type Terminal from "../terminal/Terminal.ts";
@@ -50,11 +51,6 @@ import ArgumentPrompterServiceProvider from "../service/argumentPrompter/Argumen
 import DefaultCompletionService from "../service/completion/DefaultCompletionService.ts";
 import CompletionServiceProvider from "../service/completion/CompletionServiceProvider.ts";
 import ImagePrinterServiceProvider from "../service/imagePrinter/ImagePrinterServiceProvider.ts";
-import {
-  CompletionCompleteSubCommand,
-  CompletionGroupCommand,
-  CompletionIntegrationSubCommand,
-} from "../command/CompletionCommand.ts";
 const logger = getLogger("BaseCLI");
 
 /**
@@ -232,10 +228,11 @@ export default class BaseCLI implements CLI {
       this.addServiceProvider(new ImagePrinterServiceProvider(55, this.#stdoutTerminal));
     }
 
-    let completionService: DefaultCompletionService | undefined;
     if (this.#options.completionServiceEnabled) {
-      completionService = new DefaultCompletionService();
-      this.addServiceProvider(new CompletionServiceProvider(5, completionService));
+      const completionService = new DefaultCompletionService();
+      this.addServiceProvider(
+        new CompletionServiceProvider(5, completionService, this.#commandRegistry),
+      );
     }
 
     const configurationServiceProvider = new ConfigurationServiceProvider(
@@ -302,16 +299,6 @@ export default class BaseCLI implements CLI {
       // register the version command
       this.#commandRegistry.addCommand(new VersionCommand());
 
-      // register completion commands (need CommandRegistry reference like help commands)
-      if (completionService) {
-        completionService.setCommandRegistry(this.#commandRegistry);
-        const integrationCommand = new CompletionIntegrationSubCommand();
-        const completeCommand = new CompletionCompleteSubCommand();
-        this.#commandRegistry.addCommand(
-          new CompletionGroupCommand(integrationCommand, completeCommand),
-        );
-      }
-
       // run...
       const runResult = await run(
         args,
@@ -345,6 +332,7 @@ export default class BaseCLI implements CLI {
         return { runState: RunState.INTERRUPTED };
       }
       logger.error("Runtime error: %s", (error as Error).message);
+      await printRuntimeError(this.#context, error as Error);
       return {
         runState: RunState.RUNTIME_ERROR,
         error: error as Error,

package/src/cli/DefaultRuntimeCLI.ts

@@ -1,7 +1,6 @@
 import process from "node:process";
 import BaseCLI from "./BaseCLI.ts";
 import type RunResult from "../api/RunResult.ts";
-import { RunState } from "../api/RunResult.ts";
 import type CLIConfig from "../api/CLIConfig.ts";
 import type BaseCLIFeatureOptions from "../api/BaseCLIFeatureOptions.ts";
 import { Writable } from "node:stream";
@@ -35,9 +34,6 @@ export default class DefaultRuntimeCLI extends BaseCLI {
 
   override async run(): Promise<RunResult> {
     const runResult = await super.run(process.argv.slice(2));
-    if (runResult.runState === RunState.RUNTIME_ERROR) {
-      console.error(runResult.error);
-    }
     process.exit(runResult.runState);
   }
 }

package/src/command/MultiCommandCliHelpCommand.ts

@@ -94,11 +94,15 @@ abstract class MultiCommandCliAbstractHelpCommand {
       );
     }
     groupCommands.forEach((groupCommand) => {
+      const visibleMemberSubCommands = groupCommand.memberSubCommands.filter(
+        (memberCommand) => !memberCommand.disableGenericHelpDisplay,
+      );
+      if (visibleMemberSubCommands.length === 0) return;
       const topicSection: HelpSection = {
         title: `${groupCommand.name.charAt(0).toUpperCase() + groupCommand.name.slice(1)} Commands`,
         helpEntries: [],
       };
-      groupCommand.memberSubCommands.forEach((memberCommand) => {
+      visibleMemberSubCommands.forEach((memberCommand) => {
         topicSection.helpEntries.push({
           syntax: `${groupCommand.name}:${memberCommand.name}`,
           description: memberCommand.description,
@@ -166,10 +170,18 @@ abstract class MultiCommandCliAbstractHelpCommand {
       TABLE_GENERATOR_SERVICE_ID,
     ) as TableGeneratorService;
 
-    const globalModifierCommands = this.#commandRegistry.getGlobalModifierCommands();
-    const globalCommands = this.#commandRegistry.getGlobalCommands();
-    const groupCommands = this.#commandRegistry.getGroupCommands();
-    const subCommands = this.#commandRegistry.getSubCommands();
+    const globalModifierCommands = this.#commandRegistry
+      .getGlobalModifierCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
+    const globalCommands = this.#commandRegistry
+      .getGlobalCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
+    const groupCommands = this.#commandRegistry
+      .getGroupCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
+    const subCommands = this.#commandRegistry
+      .getSubCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
     const helpSections: Array<HelpSection> = [];
     helpSections.push({
       title: "Usage",
@@ -205,8 +217,12 @@ abstract class MultiCommandCliAbstractHelpCommand {
       TABLE_GENERATOR_SERVICE_ID,
     ) as TableGeneratorService;
 
-    const groupCommands = this.#commandRegistry.getGroupCommands();
-    const subCommands = this.#commandRegistry.getSubCommands();
+    const groupCommands = this.#commandRegistry
+      .getGroupCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
+    const subCommands = this.#commandRegistry
+      .getSubCommands()
+      .filter((command) => !command.disableGenericHelpDisplay);
 
     // find sub-command or group sub-command
     let subCommand = this.#commandRegistry.getSubCommandByName(commandName);

package/src/service/completion/CompletionServiceProvider.ts

@@ -13,7 +13,11 @@ import { KEY_VALUE_SERVICE_ID } from "../../api/service/core/KeyValueService.ts"
 import type KeyValueService from "../../api/service/core/KeyValueService.ts";
 import { Icon, PRINTER_SERVICE_ID } from "../../api/service/core/PrinterService.ts";
 import type PrinterService from "../../api/service/core/PrinterService.ts";
+import type CommandRegistry from "../../runtime/registry/CommandRegistry.ts";
 import getLogger from "../../util/logger.ts";
+import { CompletionIntegrationSubCommand } from "./command/CompletionIntegrationSubCommand.ts";
+import { CompletionCompleteSubCommand } from "./command/CompletionCompleteSubCommand.ts";
+import { CompletionGroupCommand } from "./command/CompletionGroupCommand.ts";
 
 const logger = getLogger("CompletionServiceProvider");
 
@@ -23,16 +27,26 @@ export default class CompletionServiceProvider implements ServiceProvider {
   readonly #completionService: DefaultCompletionService;
   #cliName = "";
 
-  public constructor(servicePriority: number, completionService: DefaultCompletionService) {
+  public constructor(
+    servicePriority: number,
+    completionService: DefaultCompletionService,
+    commandRegistry: CommandRegistry,
+  ) {
     this.servicePriority = servicePriority;
     this.#completionService = completionService;
+    this.#completionService.setCommandRegistry(commandRegistry);
   }
 
   public getServiceInfo(cliConfig: CLIConfig): Promise<ServiceInfo> {
     this.#cliName = cliConfig.name;
     return Promise.resolve({
       service: this.#completionService,
-      commands: [],
+      commands: [
+        new CompletionGroupCommand(
+          new CompletionIntegrationSubCommand(),
+          new CompletionCompleteSubCommand(),
+        ),
+      ],
     });
   }
 

package/src/service/completion/DefaultCompletionService.ts

@@ -112,6 +112,20 @@ export default class DefaultCompletionService implements CompletionService {
       }
     }
 
+    // Check global command (--name pattern)
+    if (commandWord.startsWith("--")) {
+      const globalCommandName = commandWord.substring(2);
+      const globalCommand = this.#commandRegistry!.getGlobalCommandByName(globalCommandName);
+      if (globalCommand) {
+        if (globalCommand.argument?.allowableValues) {
+          return globalCommand.argument.allowableValues
+            .filter((v) => String(v).startsWith(currentWord))
+            .map((v) => ({ value: String(v) }));
+        }
+        return [];
+      }
+    }
+
     // Check sub-command
     const subCommand = this.#commandRegistry!.getSubCommandByName(commandWord);
     if (subCommand) {

package/src/service/completion/command/CompletionCompleteSubCommand.ts

@@ -0,0 +1,59 @@
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Option from "../../../api/argument/Option.ts";
+import type Positional from "../../../api/argument/Positional.ts";
+import type Context from "../../../api/Context.ts";
+import {
+  type ArgumentValues,
+  ArgumentValueTypeName,
+} from "../../../api/argument/ArgumentValueTypes.ts";
+import { COMPLETION_SERVICE_ID, ShellType } from "../../../api/service/core/CompletionService.ts";
+import type DefaultCompletionService from "../DefaultCompletionService.ts";
+import { PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
+import type PrinterService from "../../../api/service/core/PrinterService.ts";
+
+export class CompletionCompleteSubCommand implements SubCommand {
+  readonly name = "complete";
+  readonly description = "Generate completions for shell integration";
+  readonly enableConfiguration = false;
+  readonly disableGenericHelpDisplay = true;
+
+  readonly options: ReadonlyArray<Option> = [];
+
+  readonly positionals: ReadonlyArray<Positional> = [
+    {
+      name: "shell",
+      type: ArgumentValueTypeName.STRING,
+      allowableValues: Object.values(ShellType),
+      description: "Shell type",
+    },
+    {
+      name: "args",
+      type: ArgumentValueTypeName.STRING,
+      isVarargMultiple: true,
+      isVarargOptional: true,
+      description: "Shell-specific completion context arguments",
+    },
+  ];
+
+  async execute(context: Context, argumentValues: ArgumentValues): Promise<void> {
+    const completionService = context.getServiceById(
+      COMPLETION_SERVICE_ID,
+    ) as DefaultCompletionService;
+    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
+
+    const shellType = argumentValues.shell as ShellType;
+    const args = (argumentValues.args || []) as string[];
+
+    const completionContext = completionService.parseCompletionContext(shellType, args);
+    const completions = await completionService.generateCompletions(
+      shellType,
+      completionContext.line,
+      completionContext.cursorPosition,
+    );
+
+    const output = completionService.formatCompletions(shellType, completions);
+    if (output.length > 0) {
+      await printerService.print(output + "\n");
+    }
+  }
+}

package/src/service/completion/command/CompletionGroupCommand.ts

@@ -0,0 +1,21 @@
+import type GroupCommand from "../../../api/command/GroupCommand.ts";
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Context from "../../../api/Context.ts";
+import type { CompletionIntegrationSubCommand } from "./CompletionIntegrationSubCommand.ts";
+import type { CompletionCompleteSubCommand } from "./CompletionCompleteSubCommand.ts";
+
+export class CompletionGroupCommand implements GroupCommand {
+  readonly name = "completion";
+  readonly description = "Manage shell auto-completion";
+  readonly enableConfiguration = false;
+  readonly memberSubCommands: ReadonlyArray<SubCommand>;
+
+  constructor(
+    integrationCommand: CompletionIntegrationSubCommand,
+    completeCommand: CompletionCompleteSubCommand,
+  ) {
+    this.memberSubCommands = [integrationCommand, completeCommand];
+  }
+
+  async execute(_context: Context): Promise<void> {}
+}

package/src/{command/CompletionCommand.ts → service/completion/command/CompletionIntegrationSubCommand.ts}

@@ -1,14 +1,16 @@
 import process from "node:process";
-import type GroupCommand from "../api/command/GroupCommand.ts";
-import type SubCommand from "../api/command/SubCommand.ts";
-import type Option from "../api/argument/Option.ts";
-import type Positional from "../api/argument/Positional.ts";
-import type Context from "../api/Context.ts";
-import { type ArgumentValues, ArgumentValueTypeName } from "../api/argument/ArgumentValueTypes.ts";
-import { COMPLETION_SERVICE_ID, ShellType } from "../api/service/core/CompletionService.ts";
-import type DefaultCompletionService from "../service/completion/DefaultCompletionService.ts";
-import { Icon, PRINTER_SERVICE_ID } from "../api/service/core/PrinterService.ts";
-import type PrinterService from "../api/service/core/PrinterService.ts";
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Option from "../../../api/argument/Option.ts";
+import type Positional from "../../../api/argument/Positional.ts";
+import type Context from "../../../api/Context.ts";
+import {
+  type ArgumentValues,
+  ArgumentValueTypeName,
+} from "../../../api/argument/ArgumentValueTypes.ts";
+import { COMPLETION_SERVICE_ID, ShellType } from "../../../api/service/core/CompletionService.ts";
+import type DefaultCompletionService from "../DefaultCompletionService.ts";
+import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
+import type PrinterService from "../../../api/service/core/PrinterService.ts";
 
 export class CompletionIntegrationSubCommand implements SubCommand {
   readonly name = "integration";
@@ -94,65 +96,3 @@ export class CompletionIntegrationSubCommand implements SubCommand {
     );
   }
 }
-
-export class CompletionCompleteSubCommand implements SubCommand {
-  readonly name = "complete";
-  readonly description = "Generate completions for shell integration";
-  readonly enableConfiguration = false;
-
-  readonly options: ReadonlyArray<Option> = [];
-
-  readonly positionals: ReadonlyArray<Positional> = [
-    {
-      name: "shell",
-      type: ArgumentValueTypeName.STRING,
-      allowableValues: Object.values(ShellType),
-      description: "Shell type",
-    },
-    {
-      name: "args",
-      type: ArgumentValueTypeName.STRING,
-      isVarargMultiple: true,
-      isVarargOptional: true,
-      description: "Shell-specific completion context arguments",
-    },
-  ];
-
-  async execute(context: Context, argumentValues: ArgumentValues): Promise<void> {
-    const completionService = context.getServiceById(
-      COMPLETION_SERVICE_ID,
-    ) as DefaultCompletionService;
-    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
-
-    const shellType = argumentValues.shell as ShellType;
-    const args = (argumentValues.args || []) as string[];
-
-    const completionContext = completionService.parseCompletionContext(shellType, args);
-    const completions = await completionService.generateCompletions(
-      shellType,
-      completionContext.line,
-      completionContext.cursorPosition,
-    );
-
-    const output = completionService.formatCompletions(shellType, completions);
-    if (output.length > 0) {
-      await printerService.print(output + "\n");
-    }
-  }
-}
-
-export class CompletionGroupCommand implements GroupCommand {
-  readonly name = "completions";
-  readonly description = "Manage shell auto-completion";
-  readonly enableConfiguration = false;
-  readonly memberSubCommands: ReadonlyArray<SubCommand>;
-
-  constructor(
-    integrationCommand: CompletionIntegrationSubCommand,
-    completeCommand: CompletionCompleteSubCommand,
-  ) {
-    this.memberSubCommands = [integrationCommand, completeCommand];
-  }
-
-  async execute(_context: Context): Promise<void> {}
-}

package/src/service/completion/shell/bash.ts

@@ -16,7 +16,7 @@ export default class BashShellHandler implements ShellHandler {
     return [
       `_${cliName}_completions() {`,
       `  local IFS=$'\\n'`,
-      `  COMPREPLY=( $("${executablePath}" completions:complete bash "\${COMP_LINE}" "\${COMP_POINT}") )`,
+      `  COMPREPLY=( $("${executablePath}" completion:complete bash "\${COMP_LINE}" "\${COMP_POINT}" 2>/dev/null) )`,
       `}`,
       `complete -F _${cliName}_completions ${cliName}`,
     ].join("\n");

package/src/service/completion/shell/fish.ts

@@ -13,7 +13,7 @@ export default class FishShellHandler implements ShellHandler {
   }
 
   getBootstrapScript(cliName: string, executablePath: string): string {
-    return `complete -c ${cliName} -f -a '("${executablePath}" completions:complete fish (commandline -cp) (commandline -C))'`;
+    return `complete -c ${cliName} -f -a '("${executablePath}" completion:complete fish (commandline -cp) (commandline -C) 2>/dev/null)'`;
   }
 
   validateEnvironment(): Promise<boolean> {

package/src/service/completion/shell/powershell.ts

@@ -19,7 +19,7 @@ export default class PowerShellShellHandler implements ShellHandler {
     return [
       `Register-ArgumentCompleter -Native -CommandName ${cliName} -ScriptBlock {`,
       `  param($wordToComplete, $commandAst, $cursorPosition)`,
-      `  $completions = & "${executablePath}" completions:complete powershell "$commandAst" "$cursorPosition"`,
+      `  $completions = & "${executablePath}" completion:complete powershell "$commandAst" "$cursorPosition" 2>$null`,
       `  $completions -split '\\n' | ForEach-Object {`,
       `    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)`,
       `  }`,

package/src/service/completion/shell/zsh.ts

@@ -16,7 +16,7 @@ export default class ZshShellHandler implements ShellHandler {
     return [
       `_${cliName}_completions() {`,
       `  local -a completions`,
-      `  completions=("\${(@f)$("${executablePath}" completions:complete zsh "\${words}" "\${CURSOR}")}")`,
+      `  completions=("\${(@f)$("${executablePath}" completion:complete zsh "\${words}" "\${CURSOR}" 2>/dev/null)}")`,
       `  _describe '${cliName}' completions`,
       `}`,
       `compdef _${cliName}_completions ${cliName}`,

package/src/service/plugin/DefaultPluginServiceProvider.ts

@@ -1,10 +1,10 @@
-import type { ServiceProvider, ServiceInfo } from "../../api/service/ServiceProvider.ts";
+import type { ServiceInfo, ServiceProvider } from "../../api/service/ServiceProvider.ts";
 import type Context from "../../api/Context.ts";
 import type CLIConfig from "../../api/CLIConfig.ts";
 import type { MarketplacePluginManager } from "@flowscripter/dynamic-plugin-framework";
 import { PLUGIN_SERVICE_ID } from "../../api/service/core/PluginService.ts";
 import DefaultPluginService from "./DefaultPluginService.ts";
-import { PluginGroupCommand } from "../../command/PluginCommand.ts";
+import { PluginGroupCommand } from "./command/PluginGroupCommand.ts";
 
 export default class DefaultPluginServiceProvider implements ServiceProvider {
   readonly serviceId = PLUGIN_SERVICE_ID;

package/src/service/plugin/command/PluginAddSubCommand.ts

@@ -0,0 +1,64 @@
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Context from "../../../api/Context.ts";
+import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
+import { ArgumentValueTypeName } from "../../../api/argument/ArgumentValueTypes.ts";
+import type PrinterService from "../../../api/service/core/PrinterService.ts";
+import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
+import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
+import type PluginService from "../../../api/service/core/PluginService.ts";
+import type { VersionedPluginDescriptor } from "@flowscripter/dynamic-plugin-framework";
+import { getPluginId } from "./getPluginId.ts";
+
+export class PluginAddSubCommand implements SubCommand {
+  readonly name = "add";
+  readonly description = "Install a remote plugin";
+  readonly enableConfiguration = false;
+  readonly options = [];
+  readonly positionals = [
+    {
+      name: "pluginId",
+      description: "Plugin ID to install (e.g. @scope/name)",
+      type: ArgumentValueTypeName.STRING,
+    },
+  ];
+
+  async execute(context: Context, argumentValues: ArgumentValues): Promise<void> {
+    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
+    const pluginService = context.getServiceById(PLUGIN_SERVICE_ID) as PluginService;
+
+    const pluginId = argumentValues["pluginId"] as string;
+    await printerService.info(`Searching for plugin: ${pluginId}\n`, Icon.INFORMATION);
+
+    let descriptor: VersionedPluginDescriptor | undefined;
+    for await (const d of pluginService.search({ text: pluginId })) {
+      if (getPluginId(d) === pluginId || d.pluginId === pluginId) {
+        descriptor = d;
+        break;
+      }
+    }
+
+    if (!descriptor) {
+      // Search did not find an exact match - attempt direct install by plugin ID.
+      // This handles cases where the package exists on the registry but is not
+      // returned by search (e.g. recently published or low search ranking).
+      await printerService.info(
+        `Plugin not found via search, attempting direct install of ${pluginId}...\n`,
+        Icon.INFORMATION,
+      );
+      const parts = pluginId.startsWith("@") ? pluginId.slice(1).split("/") : [undefined, pluginId];
+      const scope = pluginId.startsWith("@") ? `@${parts[0]}` : undefined;
+      const name = pluginId.startsWith("@") ? parts[1]! : pluginId;
+      descriptor = {
+        pluginId,
+        scope,
+        name,
+        version: "latest",
+        extensionPoints: [],
+      };
+    }
+
+    await printerService.info(`Installing ${descriptor.pluginId}...\n`, Icon.INFORMATION);
+    await pluginService.install(descriptor);
+    await printerService.print(`Plugin ${descriptor.pluginId} installed.\n`, Icon.SUCCESS);
+  }
+}

package/src/service/plugin/command/PluginGroupCommand.ts

@@ -0,0 +1,27 @@
+import type GroupCommand from "../../../api/command/GroupCommand.ts";
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Context from "../../../api/Context.ts";
+import { PluginListSubCommand } from "./PluginListSubCommand.ts";
+import { PluginSearchSubCommand } from "./PluginSearchSubCommand.ts";
+import { PluginAddSubCommand } from "./PluginAddSubCommand.ts";
+import { PluginRemoveSubCommand } from "./PluginRemoveSubCommand.ts";
+import { PluginUpgradeSubCommand } from "./PluginUpgradeSubCommand.ts";
+
+export class PluginGroupCommand implements GroupCommand {
+  readonly name = "plugin";
+  readonly description = "Manage CLI plugins";
+  readonly enableConfiguration = false;
+  readonly memberSubCommands: ReadonlyArray<SubCommand>;
+
+  constructor() {
+    this.memberSubCommands = [
+      new PluginListSubCommand(),
+      new PluginSearchSubCommand(),
+      new PluginAddSubCommand(),
+      new PluginRemoveSubCommand(),
+      new PluginUpgradeSubCommand(),
+    ];
+  }
+
+  async execute(_context: Context): Promise<void> {}
+}

package/src/service/plugin/command/PluginListSubCommand.ts

@@ -0,0 +1,33 @@
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Context from "../../../api/Context.ts";
+import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
+import type PrinterService from "../../../api/service/core/PrinterService.ts";
+import { PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
+import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
+import type PluginService from "../../../api/service/core/PluginService.ts";
+import { getPluginId } from "./getPluginId.ts";
+
+export class PluginListSubCommand implements SubCommand {
+  readonly name = "list";
+  readonly description = "List locally installed plugins";
+  readonly enableConfiguration = false;
+  readonly options = [];
+  readonly positionals = [];
+
+  async execute(context: Context, _argumentValues: ArgumentValues): Promise<void> {
+    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
+    const pluginService = context.getServiceById(PLUGIN_SERVICE_ID) as PluginService;
+
+    let found = false;
+    for await (const descriptor of pluginService.listInstalled()) {
+      if (!found) {
+        found = true;
+        await printerService.print("Installed plugins:\n");
+      }
+      await printerService.print(`  ${getPluginId(descriptor)}  ${descriptor.version}\n`);
+    }
+    if (!found) {
+      await printerService.print("No plugins installed.\n");
+    }
+  }
+}

package/src/service/plugin/command/PluginRemoveSubCommand.ts

@@ -0,0 +1,32 @@
+import type SubCommand from "../../../api/command/SubCommand.ts";
+import type Context from "../../../api/Context.ts";
+import type { ArgumentValues } from "../../../api/argument/ArgumentValueTypes.ts";
+import { ArgumentValueTypeName } from "../../../api/argument/ArgumentValueTypes.ts";
+import type PrinterService from "../../../api/service/core/PrinterService.ts";
+import { Icon, PRINTER_SERVICE_ID } from "../../../api/service/core/PrinterService.ts";
+import { PLUGIN_SERVICE_ID } from "../../../api/service/core/PluginService.ts";
+import type PluginService from "../../../api/service/core/PluginService.ts";
+
+export class PluginRemoveSubCommand implements SubCommand {
+  readonly name = "remove";
+  readonly description = "Remove a locally installed plugin";
+  readonly enableConfiguration = false;
+  readonly options = [];
+  readonly positionals = [
+    {
+      name: "pluginId",
+      description: "Plugin ID to remove (e.g. @scope/name)",
+      type: ArgumentValueTypeName.STRING,
+    },
+  ];
+
+  async execute(context: Context, argumentValues: ArgumentValues): Promise<void> {
+    const printerService = context.getServiceById(PRINTER_SERVICE_ID) as PrinterService;
+    const pluginService = context.getServiceById(PLUGIN_SERVICE_ID) as PluginService;
+
+    const pluginId = argumentValues["pluginId"] as string;
+    await printerService.info(`Removing plugin: ${pluginId}...\n`, Icon.INFORMATION);
+    await pluginService.uninstall(pluginId);
+    await printerService.print(`Plugin ${pluginId} removed.\n`, Icon.SUCCESS);
+  }
+}