@flowscripter/dynamic-cli-framework 1.7.3 → 1.7.4

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

@@ -51,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");
 
 /**
@@ -233,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(
@@ -303,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,

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/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,66 +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 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");
-    }
-  }
-}
-
-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}" 2>/dev/null) )`,
+      `  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) 2>/dev/null)'`;
+    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" 2>$null`,
+      `  $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}" 2>/dev/null)}")`,
+      `  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);
+  }
+}

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

@@ -0,0 +1,42 @@
+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 { 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 PluginSearchSubCommand implements SubCommand {
+  readonly name = "search";
+  readonly description = "Search remote plugins";
+  readonly enableConfiguration = false;
+  readonly options = [];
+  readonly positionals = [
+    {
+      name: "query",
+      description: "Search query",
+      type: ArgumentValueTypeName.STRING,
+      isVarargOptional: true,
+    },
+  ];
+
+  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 query = (argumentValues["query"] as string | undefined) ?? "";
+    let found = false;
+    for await (const descriptor of pluginService.search({ text: query })) {
+      if (!found) {
+        found = true;
+        await printerService.print("Available plugins:\n");
+      }
+      await printerService.print(`  ${getPluginId(descriptor)}  ${descriptor.version}\n`);
+    }
+    if (!found) {
+      await printerService.print("No plugins found.\n");
+    }
+  }
+}

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

@@ -0,0 +1,36 @@
+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 { 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 { getPluginId } from "./getPluginId.ts";
+
+export class PluginUpgradeSubCommand implements SubCommand {
+  readonly name = "upgrade";
+  readonly description = "Upgrade 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 upgraded = 0;
+    for await (const update of pluginService.checkForUpdates()) {
+      const id = getPluginId(update.descriptor);
+      await printerService.info(
+        `Upgrading ${id} to ${update.availableVersion}...\n`,
+        Icon.INFORMATION,
+      );
+      await pluginService.install(update.descriptor);
+      await printerService.print(`Upgraded ${id} to ${update.availableVersion}.\n`, Icon.SUCCESS);
+      upgraded++;
+    }
+    if (upgraded === 0) {
+      await printerService.print("All plugins are up to date.\n");
+    }
+  }
+}

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

@@ -0,0 +1,5 @@
+import type { VersionedPluginDescriptor } from "@flowscripter/dynamic-plugin-framework";
+
+export function getPluginId(descriptor: VersionedPluginDescriptor): string {
+  return descriptor.scope ? `@${descriptor.scope}/${descriptor.name}` : descriptor.name;
+}

package/src/service/tableGenerator/DefaultTableGeneratorService.ts

@@ -1,6 +1,7 @@
 import type TableGeneratorService from "../../api/service/core/TableGeneratorService.ts";
 import { Align } from "../../api/service/core/TableGeneratorService.ts";
-import type Table from "../../api/service/core/Table.ts";
+import type { TableOptions } from "../../api/service/core/TableGeneratorService.ts";
+import Table from "../../api/service/core/Table.ts";
 
 const BORDER_TOP_LEFT = "┌";
 const BORDER_TOP = "─";
@@ -23,6 +24,10 @@ export default class DefaultTableGeneratorService implements TableGeneratorServi
   colorFunction: (text: string, hexFormattedColor: string) => string = (text) => text;
   backgroundColorFunction: (text: string, hexFormattedColor: string) => string = (text) => text;
 
+  createTable(rowCount: number, columnCount: number, options?: TableOptions): Table {
+    return new Table(rowCount, columnCount, options);
+  }
+
   #resolveAlign(table: Table, rowIndex: number, columnIndex: number): Align {
     const cellOpts = table.getCell(rowIndex, columnIndex)?.options;
     if (cellOpts?.align !== undefined) return cellOpts.align;

package/src/util/helpHelper.ts

@@ -19,7 +19,6 @@ import type PrinterService from "../api/service/core/PrinterService.ts";
 import type SubCommandArgument from "../api/argument/SubCommandArgument.ts";
 import type ComplexOption from "../api/argument/ComplexOption.ts";
 import type TableGeneratorService from "../api/service/core/TableGeneratorService.ts";
-import Table from "../api/service/core/Table.ts";
 
 const SYNTAX_INDENT_WIDTH = 2;
 const MINIMUM_SYNTAX_COLUMN_WIDTH = 15;
@@ -112,7 +111,7 @@ export async function printHelpSections(
     const hasDescriptions = rows.some((r) => r.description !== undefined);
 
     if (hasDescriptions) {
-      const table = new Table(rows.length, 2, {
+      const table = tableGeneratorService.createTable(rows.length, 2, {
         border: false,
         padding: 1,
         maxWidth: terminalWidth,

package/dist/src/command/CompletionCommand.d.ts

@@ -1,32 +0,0 @@
-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 } from "../api/argument/ArgumentValueTypes.ts";
-export declare class CompletionIntegrationSubCommand implements SubCommand {
-    readonly name = "integration";
-    readonly description = "Install shell completion integration";
-    readonly enableConfiguration = false;
-    readonly options: ReadonlyArray<Option>;
-    readonly positionals: ReadonlyArray<Positional>;
-    execute(context: Context, argumentValues: ArgumentValues): Promise<void>;
-}
-export declare 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>;
-    execute(context: Context, argumentValues: ArgumentValues): Promise<void>;
-}
-export declare 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);
-    execute(_context: Context): Promise<void>;
-}
-//# sourceMappingURL=CompletionCommand.d.ts.map

package/dist/src/command/CompletionCommand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CompletionCommand.d.ts","sourceRoot":"","sources":["../../../src/command/CompletionCommand.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,cAAc,EAAyB,MAAM,uCAAuC,CAAC;AAMnG,qBAAa,+BAAgC,YAAW,UAAU;IAChE,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,0CAA0C;IAC9D,QAAQ,CAAC,mBAAmB,SAAS;IAErC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAOrC;IAEF,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAO7C;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA4D/E;AAED,qBAAa,4BAA6B,YAAW,UAAU;IAC7D,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,gDAAgD;IACpE,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,yBAAyB,QAAQ;IAE1C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAM;IAE7C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAc7C;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAqB/E;AAED,qBAAa,sBAAuB,YAAW,YAAY;IACzD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,kCAAkC;IACtD,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;gBAGpD,kBAAkB,EAAE,+BAA+B,EACnD,eAAe,EAAE,4BAA4B;IAKzC,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD"}