@flowscripter/dynamic-cli-framework 1.4.19 → 1.6.0

package/dist/tests/service/dataDumpGenerator/DefaultDataDumpGeneratorService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultDataDumpGeneratorService.test.d.ts.map

package/dist/tests/service/dataDumpGenerator/DefaultDataDumpGeneratorService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultDataDumpGeneratorService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/dataDumpGenerator/DefaultDataDumpGeneratorService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/imagePrinter/DefaultImagePrinterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultImagePrinterService.test.d.ts.map

package/dist/tests/service/imagePrinter/DefaultImagePrinterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultImagePrinterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/imagePrinter/DefaultImagePrinterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/imagePrinter/ImagePrinterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ImagePrinterServiceProvider.test.d.ts.map

package/dist/tests/service/imagePrinter/ImagePrinterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImagePrinterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/imagePrinter/ImagePrinterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/plugin/DefaultPluginServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultPluginServiceProvider.test.d.ts.map

package/dist/tests/service/plugin/DefaultPluginServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPluginServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/plugin/DefaultPluginServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prettyPrinter/DefaultPrettyPrinterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultPrettyPrinterService.test.d.ts.map

package/dist/tests/service/prettyPrinter/DefaultPrettyPrinterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPrettyPrinterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/prettyPrinter/DefaultPrettyPrinterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prettyPrinter/PrettyPrinterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PrettyPrinterServiceProvider.test.d.ts.map

package/dist/tests/service/prettyPrinter/PrettyPrinterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrettyPrinterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/prettyPrinter/PrettyPrinterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/DefaultPrinterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultPrinterService.test.d.ts.map

package/dist/tests/service/printer/DefaultPrinterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPrinterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/printer/DefaultPrinterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/PrinterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PrinterServiceProvider.test.d.ts.map

package/dist/tests/service/printer/PrinterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrinterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/printer/PrinterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/command/DarkModeCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DarkModeCommand.test.d.ts.map

package/dist/tests/service/printer/command/DarkModeCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DarkModeCommand.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/command/DarkModeCommand.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/command/LogLevelCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LogLevelCommand.test.d.ts.map

package/dist/tests/service/printer/command/LogLevelCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevelCommand.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/command/LogLevelCommand.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/command/NoColorCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NoColorCommand.test.d.ts.map

package/dist/tests/service/printer/command/NoColorCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoColorCommand.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/command/NoColorCommand.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/command/NoHyperlinksCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NoHyperlinksCommand.test.d.ts.map

package/dist/tests/service/printer/command/NoHyperlinksCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoHyperlinksCommand.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/command/NoHyperlinksCommand.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/terminal/Progress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Progress.test.d.ts.map

package/dist/tests/service/printer/terminal/Progress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/terminal/Progress.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/printer/terminal/Spinner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Spinner.test.d.ts.map

package/dist/tests/service/printer/terminal/Spinner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/printer/terminal/Spinner.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prompter/DefaultPrompterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultPrompterService.test.d.ts.map

package/dist/tests/service/prompter/DefaultPrompterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPrompterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/prompter/DefaultPrompterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prompter/PrompterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PrompterServiceProvider.test.d.ts.map

package/dist/tests/service/prompter/PrompterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrompterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/prompter/PrompterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prompter/command/NoPromptCommand.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NoPromptCommand.test.d.ts.map

package/dist/tests/service/prompter/command/NoPromptCommand.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoPromptCommand.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/prompter/command/NoPromptCommand.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/prompter/prompt/PromptContext.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PromptContext.test.d.ts.map

package/dist/tests/service/prompter/prompt/PromptContext.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptContext.test.d.ts","sourceRoot":"","sources":["../../../../../tests/service/prompter/prompt/PromptContext.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/shutdown/ShutdownServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ShutdownServiceProvider.test.d.ts.map

package/dist/tests/service/shutdown/ShutdownServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShutdownServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/shutdown/ShutdownServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/syntaxHighlighter/DefaultSyntaxHighlighterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultSyntaxHighlighterService.test.d.ts.map

package/dist/tests/service/syntaxHighlighter/DefaultSyntaxHighlighterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultSyntaxHighlighterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/syntaxHighlighter/DefaultSyntaxHighlighterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/syntaxHighlighter/SyntaxHighlighterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SyntaxHighlighterServiceProvider.test.d.ts.map

package/dist/tests/service/syntaxHighlighter/SyntaxHighlighterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyntaxHighlighterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/syntaxHighlighter/SyntaxHighlighterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/tableGenerator/DefaultTableGeneratorService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultTableGeneratorService.test.d.ts.map

package/dist/tests/service/tableGenerator/DefaultTableGeneratorService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultTableGeneratorService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/tableGenerator/DefaultTableGeneratorService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/tableGenerator/TableGeneratorServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TableGeneratorServiceProvider.test.d.ts.map

package/dist/tests/service/tableGenerator/TableGeneratorServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableGeneratorServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/tableGenerator/TableGeneratorServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/treePrinter/DefaultTreePrinterService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DefaultTreePrinterService.test.d.ts.map

package/dist/tests/service/treePrinter/DefaultTreePrinterService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultTreePrinterService.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/treePrinter/DefaultTreePrinterService.test.ts"],"names":[],"mappings":""}

package/dist/tests/service/treePrinter/TreePrinterServiceProvider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TreePrinterServiceProvider.test.d.ts.map

package/dist/tests/service/treePrinter/TreePrinterServiceProvider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreePrinterServiceProvider.test.d.ts","sourceRoot":"","sources":["../../../../tests/service/treePrinter/TreePrinterServiceProvider.test.ts"],"names":[],"mappings":""}

package/dist/tests/terminal/ImageRenderer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ImageRenderer.test.d.ts.map

package/dist/tests/terminal/ImageRenderer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageRenderer.test.d.ts","sourceRoot":"","sources":["../../../tests/terminal/ImageRenderer.test.ts"],"names":[],"mappings":""}

package/dist/tests/terminal/PngDecoder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PngDecoder.test.d.ts.map

package/dist/tests/terminal/PngDecoder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PngDecoder.test.d.ts","sourceRoot":"","sources":["../../../tests/terminal/PngDecoder.test.ts"],"names":[],"mappings":""}

package/dist/tests/terminal/supportsHyperlinks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=supportsHyperlinks.test.d.ts.map

package/dist/tests/terminal/supportsHyperlinks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportsHyperlinks.test.d.ts","sourceRoot":"","sources":["../../../tests/terminal/supportsHyperlinks.test.ts"],"names":[],"mappings":""}

package/dist/tests/util/configHelper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=configHelper.test.d.ts.map

package/dist/tests/util/configHelper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configHelper.test.d.ts","sourceRoot":"","sources":["../../../tests/util/configHelper.test.ts"],"names":[],"mappings":""}

package/dist/tests/util/envVarHelper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=envVarHelper.test.d.ts.map

package/dist/tests/util/envVarHelper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVarHelper.test.d.ts","sourceRoot":"","sources":["../../../tests/util/envVarHelper.test.ts"],"names":[],"mappings":""}

package/dist/tests/util/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/tests/util/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../../tests/util/logger.test.ts"],"names":[],"mappings":""}

package/index.ts

@@ -168,9 +168,19 @@ export {
   MultiCommandCliHelpSubCommand,
 } from "./src/command/MultiCommandCliHelpCommand.ts";
 
+// Plugin API
+export type { default as CommandFactory } from "./src/api/plugin/CommandFactory.ts";
+export { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./src/api/plugin/CommandFactory.ts";
+export type { default as ServiceProviderFactory } from "./src/api/plugin/ServiceProviderFactory.ts";
+export { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./src/api/plugin/ServiceProviderFactory.ts";
+export { PLUGIN_SERVICE_ID } from "./src/api/service/core/PluginService.ts";
+export type { default as PluginService } from "./src/api/service/core/PluginService.ts";
+export { default as DefaultPluginServiceProvider } from "./src/service/plugin/DefaultPluginServiceProvider.ts";
+
 // Core CLI
 export { default as BaseCLI } from "./src/cli/BaseCLI.ts";
 export { default as DefaultRuntimeCLI } from "./src/cli/DefaultRuntimeCLI.ts";
+export { default as DynamicPluginRuntimeCLI } from "./src/cli/DynamicPluginRuntimeCLI.ts";
 
 // Terminal API
 export type { default as Terminal } from "./src/terminal/Terminal.ts";
@@ -180,4 +190,8 @@ export { SpecialKey } from "./src/terminal/KeyReader.ts";
 export { default as TtyKeyReader } from "./src/terminal/TtyKeyReader.ts";
 
 // Convenience functions
-export { launchMultiCommandCLI, launchSingleCommandCLI } from "./src/launcher.ts";
+export {
+  launchMultiCommandCLI,
+  launchSingleCommandCLI,
+  launchDynamicPluginMultiCommandCLI,
+} from "./src/launcher.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "1.4.19",
+  "version": "1.6.0",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -17,12 +17,38 @@
     "type": "git",
     "url": "git+https://github.com/flowscripter/dynamic-cli-framework.git"
   },
+  "files": [
+    "dist",
+    "src",
+    "index.ts",
+    "cli-plugin.ts",
+    "README.md",
+    "LICENSE"
+  ],
   "type": "module",
-  "module": "index.ts",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "bun": "./cli-plugin.ts",
+      "types": "./dist/cli-plugin.d.ts",
+      "default": "./dist/cli-plugin.js"
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "bun build index.ts cli-plugin.ts --outdir dist --target bun && tsc -p tsconfig.build.json"
+  },
   "dependencies": {
+    "@flowscripter/dynamic-plugin-framework": "1.9.0",
     "emphasize": "^7.0.0",
     "fastest-levenshtein": "^1.0.16",
     "figlet": "^1.11.0",

package/src/api/plugin/CommandFactory.ts

@@ -0,0 +1,25 @@
+import type Command from "../command/Command.ts";
+
+/**
+ * Extension point identifier for {@link CommandFactory} extensions.
+ *
+ * Plugins register against this extension point to supply {@link Command} instances
+ * that are added to the CLI before execution begins.
+ */
+export const DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT =
+  "DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY";
+
+/**
+ * Extension interface implemented by a plugin to provide {@link Command} instances.
+ *
+ * A plugin registers an {@link CommandFactory} against
+ * {@link DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT}. On startup,
+ * {@link DynamicPluginRuntimeCLI} instantiates each factory and adds the returned
+ * commands to the CLI registry before the runner executes.
+ */
+export default interface CommandFactory {
+  /**
+   * Return the {@link Command} instances provided by this factory.
+   */
+  getCommands(): ReadonlyArray<Command>;
+}

package/src/api/plugin/ServiceProviderFactory.ts

@@ -0,0 +1,27 @@
+import type { ServiceProvider } from "../service/ServiceProvider.ts";
+
+/**
+ * Extension point identifier for {@link ServiceProviderFactory} extensions.
+ *
+ * Plugins register against this extension point to supply {@link ServiceProvider} instances
+ * that are initialised by the runner as part of the normal service lifecycle.
+ */
+export const DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT =
+  "DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY";
+
+/**
+ * Extension interface implemented by a plugin to provide {@link ServiceProvider} instances.
+ *
+ * A plugin registers a {@link ServiceProviderFactory} against
+ * {@link DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT}. On startup,
+ * {@link DynamicPluginRuntimeCLI} instantiates each factory and adds the returned
+ * service providers to the CLI registry before the runner executes, so they participate
+ * in the full initialization lifecycle (including {@link GlobalModifierCommand} scanning
+ * and {@link ServiceProvider.initService}).
+ */
+export default interface ServiceProviderFactory {
+  /**
+   * Return the {@link ServiceProvider} instances provided by this factory.
+   */
+  getServiceProviders(): ReadonlyArray<ServiceProvider>;
+}

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

@@ -0,0 +1,63 @@
+import type {
+  VersionedPluginDescriptor,
+  SearchQuery,
+} from "@flowscripter/dynamic-plugin-framework";
+
+/**
+ * Service ID for {@link PluginService}.
+ *
+ * Pass to {@link Context.getServiceById} to retrieve the active {@link PluginService} instance.
+ */
+export const PLUGIN_SERVICE_ID = "PLUGIN_SERVICE";
+
+/**
+ * Service providing plugin lifecycle management for a CLI with dynamic plugin support.
+ *
+ * Exposes search, install, uninstall, list, and update operations backed by a
+ * {@link MarketplacePluginManager}. Provided by {@link DefaultPluginServiceProvider}
+ * when plugin support is enabled via {@link DynamicPluginRuntimeCLI}.
+ *
+ * After {@link install} or an upgrade, the CLI must be restarted for new or updated
+ * plugin commands and service providers to become active.
+ */
+export default interface PluginService {
+  /**
+   * Search the remote marketplace for plugins matching the given query.
+   *
+   * @param query criteria to filter results by.
+   * @returns an async iterable of matching {@link VersionedPluginDescriptor} entries.
+   */
+  search(query: Readonly<SearchQuery>): AsyncIterable<Readonly<VersionedPluginDescriptor>>;
+
+  /**
+   * Install a plugin from the remote marketplace into the local plugin store.
+   *
+   * @param descriptor the plugin to install, as returned by {@link search}.
+   */
+  install(descriptor: Readonly<VersionedPluginDescriptor>): Promise<void>;
+
+  /**
+   * Remove a previously installed plugin from the local plugin store.
+   *
+   * @param pluginId the package identifier of the plugin to remove (e.g. `@scope/my-plugin`).
+   */
+  uninstall(pluginId: string): Promise<void>;
+
+  /**
+   * List all plugins currently installed in the local plugin store.
+   *
+   * @returns an async iterable of {@link VersionedPluginDescriptor} entries for each installed plugin.
+   */
+  listInstalled(): AsyncIterable<Readonly<VersionedPluginDescriptor>>;
+
+  /**
+   * Check each installed plugin for a newer version available on the remote marketplace.
+   *
+   * @returns an async iterable of objects pairing the installed plugin descriptor with the
+   * latest available version string for plugins that have an update available.
+   */
+  checkForUpdates(): AsyncIterable<{
+    descriptor: Readonly<VersionedPluginDescriptor>;
+    availableVersion: string;
+  }>;
+}

package/src/cli/DynamicPluginRuntimeCLI.ts

@@ -0,0 +1,77 @@
+import type { MarketplacePluginManager } from "@flowscripter/dynamic-plugin-framework";
+import type CLIConfig from "../api/CLIConfig.ts";
+import type BaseCLIFeatureOptions from "../api/BaseCLIFeatureOptions.ts";
+import type RunResult from "../api/RunResult.ts";
+import { RunState } from "../api/RunResult.ts";
+import DefaultRuntimeCLI from "./DefaultRuntimeCLI.ts";
+import DefaultPluginServiceProvider from "../service/plugin/DefaultPluginServiceProvider.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "../api/plugin/CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "../api/plugin/ServiceProviderFactory.ts";
+import type CommandFactory from "../api/plugin/CommandFactory.ts";
+import type ServiceProviderFactory from "../api/plugin/ServiceProviderFactory.ts";
+import process from "node:process";
+
+/**
+ * Extension of {@link DefaultRuntimeCLI} that discovers and loads installed plugins before running.
+ *
+ * On each invocation of {@link run}, all locally installed plugins are discovered via the
+ * {@link MarketplacePluginManager}. Commands provided by {@link CommandFactory} extensions and
+ * service providers provided by {@link ServiceProviderFactory} extensions are registered before
+ * the runner starts, so they participate in the full initialization lifecycle.
+ */
+export default class DynamicPluginRuntimeCLI extends DefaultRuntimeCLI {
+  readonly #pluginManager: MarketplacePluginManager;
+
+  constructor(
+    cliConfig: CLIConfig,
+    pluginManager: MarketplacePluginManager,
+    options?: BaseCLIFeatureOptions,
+  ) {
+    super(cliConfig, options);
+    this.#pluginManager = pluginManager;
+    this.addServiceProvider(new DefaultPluginServiceProvider(pluginManager));
+  }
+
+  override async run(): Promise<RunResult> {
+    try {
+      await this.loadPlugins();
+    } catch (err) {
+      console.error(err);
+      process.exit(RunState.RUNTIME_ERROR);
+    }
+    return super.run();
+  }
+
+  async loadPlugins(): Promise<void> {
+    await this.#pluginManager.registerExtensions(
+      DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT,
+    );
+    await this.#pluginManager.registerExtensions(
+      DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT,
+    );
+
+    const commandFactoryExtensions = await this.#pluginManager.getRegisteredExtensions(
+      DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT,
+    );
+    for (const ext of commandFactoryExtensions) {
+      const factory = (await this.#pluginManager.instantiate(
+        ext.extensionHandle,
+      )) as CommandFactory;
+      for (const command of factory.getCommands()) {
+        this.addCommand(command);
+      }
+    }
+
+    const spFactoryExtensions = await this.#pluginManager.getRegisteredExtensions(
+      DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT,
+    );
+    for (const ext of spFactoryExtensions) {
+      const factory = (await this.#pluginManager.instantiate(
+        ext.extensionHandle,
+      )) as ServiceProviderFactory;
+      for (const sp of factory.getServiceProviders()) {
+        this.addServiceProvider(sp);
+      }
+    }
+  }
+}