@flowscripter/dynamic-cli-framework 1.6.1 → 1.7.0

package/dist/src/api/plugin/CLIPlugin.d.ts

@@ -0,0 +1,31 @@
+import type { Plugin, ExtensionDescriptor } from "@flowscripter/dynamic-plugin-framework";
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+/**
+ * {@link ExtensionDescriptor} for a {@link CommandFactory} extension.
+ */
+export interface CommandFactoryExtensionDescriptor extends ExtensionDescriptor {
+    readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT;
+    readonly factory: {
+        create(hostData?: Map<string, string>): Promise<CommandFactory>;
+    };
+}
+/**
+ * {@link ExtensionDescriptor} for a {@link ServiceProviderFactory} extension.
+ */
+export interface ServiceProviderFactoryExtensionDescriptor extends ExtensionDescriptor {
+    readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT;
+    readonly factory: {
+        create(hostData?: Map<string, string>): Promise<ServiceProviderFactory>;
+    };
+}
+/**
+ * A {@link Plugin} for {@link DynamicPluginRuntimeCLI} whose {@link extensionDescriptors} are
+ * limited to the {@link CommandFactory} and {@link ServiceProviderFactory} extension points.
+ */
+export default interface CLIPlugin extends Plugin {
+    readonly extensionDescriptors: ReadonlyArray<CommandFactoryExtensionDescriptor | ServiceProviderFactoryExtensionDescriptor>;
+}
+//# sourceMappingURL=CLIPlugin.d.ts.map

package/dist/src/api/plugin/CLIPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIPlugin.d.ts","sourceRoot":"","sources":["../../../../src/api/plugin/CLIPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,qDAAqD,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,8DAA8D,EAAE,MAAM,6BAA6B,CAAC;AAE7G;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,mBAAmB;IAC5E,QAAQ,CAAC,cAAc,EAAE,OAAO,qDAAqD,CAAC;IACtF,QAAQ,CAAC,OAAO,EAAE;QAChB,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;KACjE,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yCAA0C,SAAQ,mBAAmB;IACpF,QAAQ,CAAC,cAAc,EAAE,OAAO,8DAA8D,CAAC;IAC/F,QAAQ,CAAC,OAAO,EAAE;QAChB,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;KACzE,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,SAAU,SAAQ,MAAM;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAC1C,iCAAiC,GAAG,yCAAyC,CAC9E,CAAC;CACH"}

package/dist/src/api/plugin/createCLIPlugin.d.ts

@@ -0,0 +1,14 @@
+import type CommandFactory from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import type CLIPlugin from "./CLIPlugin.ts";
+export interface CLIPluginOptions {
+    readonly commandFactory?: CommandFactory | (() => Promise<CommandFactory>);
+    readonly serviceProviderFactory?: ServiceProviderFactory | (() => Promise<ServiceProviderFactory>);
+    readonly pluginData?: ReadonlyMap<string, string>;
+}
+/**
+ * Build a {@link CLIPlugin} from optional {@link CommandFactory} and {@link ServiceProviderFactory}
+ * instances (or factory functions), without needing to hand-construct extension descriptors.
+ */
+export default function createCLIPlugin(options: CLIPluginOptions): CLIPlugin;
+//# sourceMappingURL=createCLIPlugin.d.ts.map

package/dist/src/api/plugin/createCLIPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCLIPlugin.d.ts","sourceRoot":"","sources":["../../../../src/api/plugin/createCLIPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,sBAAsB,CAAC,EAC5B,sBAAsB,GACtB,CAAC,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA4B5E"}

package/dist/src/api/service/core/CompletionService.d.ts

@@ -14,7 +14,7 @@ export interface CompletionItem {
  */
 export default interface CompletionService {
     generateCompletions(shellType: ShellType, line: string, cursorPosition: number): Promise<ReadonlyArray<CompletionItem>>;
-    getBootstrapScript(shellType: ShellType, cliName: string): string;
+    getBootstrapScript(shellType: ShellType, cliName: string, executablePath: string): string;
     getDefaultConfigPath(shellType: ShellType): string;
     validateShellEnvironment(shellType: ShellType): Promise<boolean>;
     formatCompletions(shellType: ShellType, completions: ReadonlyArray<CompletionItem>): string;

package/dist/src/api/service/core/CompletionService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompletionService.d.ts","sourceRoot":"","sources":["../../../../../src/api/service/core/CompletionService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,2DAA2D,CAAC;AAE9F,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC,mBAAmB,CACjB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAE1C,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAElE,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;IAEnD,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;CAC7F"}
+{"version":3,"file":"CompletionService.d.ts","sourceRoot":"","sources":["../../../../../src/api/service/core/CompletionService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,2DAA2D,CAAC;AAE9F,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC,mBAAmB,CACjB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAE1C,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1F,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;IAEnD,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;CAC7F"}

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

@@ -1 +1 @@
-{"version":3,"file":"CompletionCommand.d.ts","sourceRoot":"","sources":["../../../src/command/CompletionCommand.ts"],"names":[],"mappings":"AAAA,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;CAwD/E;AAED,qBAAa,4BAA6B,YAAW,UAAU;IAC7D,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,gDAAgD;IACpE,QAAQ,CAAC,mBAAmB,SAAS;IAErC,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"}
+{"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;IAErC,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/command/PluginCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAW9E,qBAAa,oBAAqB,YAAW,UAAU;IACrD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,oCAAoC;IACxD,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW,UAAM;IAEpB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhF;AAED,qBAAa,sBAAuB,YAAW,UAAU;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,2BAA2B;IAC/C,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;;QAOlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB/E;AAED,qBAAa,mBAAoB,YAAW,UAAU;IACpD,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,6BAA6B;IACjD,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;QAMlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA0B/E;AAED,qBAAa,sBAAuB,YAAW,UAAU;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,uCAAuC;IAC3D,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;QAMlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/E;AAED,qBAAa,uBAAwB,YAAW,UAAU;IACxD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,uCAAuC;IAC3D,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW,UAAM;IAEpB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBhF;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;;IAYhD,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD"}
+{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/command/PluginCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,UAAU,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAW9E,qBAAa,oBAAqB,YAAW,UAAU;IACrD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,oCAAoC;IACxD,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW,UAAM;IAEpB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBhF;AAED,qBAAa,sBAAuB,YAAW,UAAU;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,2BAA2B;IAC/C,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;;QAOlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB/E;AAED,qBAAa,mBAAoB,YAAW,UAAU;IACpD,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,6BAA6B;IACjD,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;QAMlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAuC/E;AAED,qBAAa,sBAAuB,YAAW,UAAU;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,uCAAuC;IAC3D,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW;;;;QAMlB;IAEI,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/E;AAED,qBAAa,uBAAwB,YAAW,UAAU;IACxD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,uCAAuC;IAC3D,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,OAAO,UAAM;IACtB,QAAQ,CAAC,WAAW,UAAM;IAEpB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBhF;AAED,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,mBAAmB,SAAS;IACrC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;;IAYhD,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD"}

package/dist/src/service/completion/CompletionServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompletionServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/completion/CompletionServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAGhD,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAC;AAY1E,MAAM,CAAC,OAAO,OAAO,yBAA0B,YAAW,eAAe;;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAyB;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAId,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,wBAAwB;IAKhF,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAkJ1D"}
+{"version":3,"file":"CompletionServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/completion/CompletionServiceProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,SAAS,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC;AAGhD,OAAO,KAAK,wBAAwB,MAAM,+BAA+B,CAAC;AAY1E,MAAM,CAAC,OAAO,OAAO,yBAA0B,YAAW,eAAe;;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAyB;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAId,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,wBAAwB;IAKhF,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAsJ1D"}

package/dist/src/service/completion/DefaultCompletionService.d.ts

@@ -4,7 +4,7 @@ import type CommandRegistry from "../../runtime/registry/CommandRegistry.ts";
 export default class DefaultCompletionService implements CompletionService {
     #private;
     setCommandRegistry(registry: CommandRegistry): void;
-    getBootstrapScript(shellType: ShellType, cliName: string): string;
+    getBootstrapScript(shellType: ShellType, cliName: string, executablePath: string): string;
     getDefaultConfigPath(shellType: ShellType): string;
     validateShellEnvironment(shellType: ShellType): Promise<boolean>;
     formatCompletions(shellType: ShellType, completions: ReadonlyArray<CompletionItem>): string;

package/dist/src/service/completion/DefaultCompletionService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultCompletionService.d.ts","sourceRoot":"","sources":["../../../../src/service/completion/DefaultCompletionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,iBAAiB,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,KAAK,eAAe,MAAM,2CAA2C,CAAC;AAS7E,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,iBAAiB;;IAUxE,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInD,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAIjE,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIlD,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhE,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAI3F,sBAAsB,CACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAI3C,mBAAmB,CACjB,UAAU,EAAE,SAAS,EACrB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;CAgR1C"}
+{"version":3,"file":"DefaultCompletionService.d.ts","sourceRoot":"","sources":["../../../../src/service/completion/DefaultCompletionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,iBAAiB,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,KAAK,eAAe,MAAM,2CAA2C,CAAC;AAS7E,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,iBAAiB;;IAUxE,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAInD,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAIzF,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIlD,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhE,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAI3F,sBAAsB,CACpB,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAI3C,mBAAmB,CACjB,UAAU,EAAE,SAAS,EACrB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;CAgR1C"}

package/dist/src/service/completion/shell/ShellHandler.d.ts

@@ -5,7 +5,7 @@ export interface CompletionContext {
 }
 export default interface ShellHandler {
     getDefaultConfigPath(): string;
-    getBootstrapScript(cliName: string): string;
+    getBootstrapScript(cliName: string, executablePath: string): string;
     validateEnvironment(): Promise<boolean>;
     formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
     parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

package/dist/src/service/completion/shell/ShellHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShellHandler.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/ShellHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,YAAY;IACnC,oBAAoB,IAAI,MAAM,CAAC;IAC/B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IACtE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC;CACxE"}
+{"version":3,"file":"ShellHandler.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/ShellHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,CAAC,OAAO,WAAW,YAAY;IACnC,oBAAoB,IAAI,MAAM,CAAC;IAC/B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IACpE,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IACtE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAAC;CACxE"}

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

@@ -3,7 +3,7 @@ import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 export default class BashShellHandler implements ShellHandler {
     getDefaultConfigPath(): string;
-    getBootstrapScript(cliName: string): string;
+    getBootstrapScript(cliName: string, executablePath: string): string;
     validateEnvironment(): Promise<boolean>;
     formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
     parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

package/dist/src/service/completion/shell/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/bash.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,YAAY;IAC3D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAU3C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAIrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/bash.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,YAAY;IAC3D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAUnE,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAIrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}

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

@@ -3,7 +3,7 @@ import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 export default class FishShellHandler implements ShellHandler {
     getDefaultConfigPath(): string;
-    getBootstrapScript(cliName: string): string;
+    getBootstrapScript(cliName: string, executablePath: string): string;
     validateEnvironment(): Promise<boolean>;
     formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
     parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

package/dist/src/service/completion/shell/fish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fish.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/fish.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,YAAY;IAC3D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAMrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}
+{"version":3,"file":"fish.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/fish.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,YAAY;IAC3D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAInE,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAMrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}

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

@@ -3,7 +3,7 @@ import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 export default class PowerShellShellHandler implements ShellHandler {
     getDefaultConfigPath(): string;
-    getBootstrapScript(cliName: string): string;
+    getBootstrapScript(cliName: string, executablePath: string): string;
     validateEnvironment(): Promise<boolean>;
     formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
     parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

package/dist/src/service/completion/shell/powershell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"powershell.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/powershell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,YAAY;IACjE,oBAAoB,IAAI,MAAM;IAO9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAY3C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBvC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAIrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}
+{"version":3,"file":"powershell.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/powershell.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,YAAY;IACjE,oBAAoB,IAAI,MAAM;IAO9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAYnE,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBvC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAIrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}

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

@@ -3,7 +3,7 @@ import type ShellHandler from "./ShellHandler.ts";
 import type { CompletionContext } from "./ShellHandler.ts";
 export default class ZshShellHandler implements ShellHandler {
     getDefaultConfigPath(): string;
-    getBootstrapScript(cliName: string): string;
+    getBootstrapScript(cliName: string, executablePath: string): string;
     validateEnvironment(): Promise<boolean>;
     formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
     parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

package/dist/src/service/completion/shell/zsh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/zsh.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,YAAY;IAC1D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAW3C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAMrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}
+{"version":3,"file":"zsh.d.ts","sourceRoot":"","sources":["../../../../../src/service/completion/shell/zsh.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,MAAM,CAAC,OAAO,OAAO,eAAgB,YAAW,YAAY;IAC1D,oBAAoB,IAAI,MAAM;IAI9B,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAWnE,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAavC,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,MAAM;IAMrE,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,iBAAiB;CAKvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",
@@ -48,20 +48,20 @@
     "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",
+    "@flowscripter/dynamic-plugin-framework": "1.10.0",
     "emphasize": "^7.0.0",
     "fastest-levenshtein": "^1.0.16",
     "figlet": "^1.11.0",
     "highlight.js": "^11.11.1",
-    "prettier": "^3.8.4",
+    "prettier": "^3.9.4",
     "supports-color": "^10.2.2",
     "supports-terminal-graphics": "^0.1.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
-    "@types/node": "^26.0.1",
-    "oxfmt": "0.56.0",
-    "oxlint": "1.71.0"
+    "@types/node": "^26.1.0",
+    "oxfmt": "0.57.0",
+    "oxlint": "1.72.0"
   },
   "peerDependencies": {
     "typescript": "^6.0.3"

package/src/api/plugin/CLIPlugin.ts

@@ -0,0 +1,35 @@
+import type { Plugin, ExtensionDescriptor } from "@flowscripter/dynamic-plugin-framework";
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+
+/**
+ * {@link ExtensionDescriptor} for a {@link CommandFactory} extension.
+ */
+export interface CommandFactoryExtensionDescriptor extends ExtensionDescriptor {
+  readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT;
+  readonly factory: {
+    create(hostData?: Map<string, string>): Promise<CommandFactory>;
+  };
+}
+
+/**
+ * {@link ExtensionDescriptor} for a {@link ServiceProviderFactory} extension.
+ */
+export interface ServiceProviderFactoryExtensionDescriptor extends ExtensionDescriptor {
+  readonly extensionPoint: typeof DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT;
+  readonly factory: {
+    create(hostData?: Map<string, string>): Promise<ServiceProviderFactory>;
+  };
+}
+
+/**
+ * A {@link Plugin} for {@link DynamicPluginRuntimeCLI} whose {@link extensionDescriptors} are
+ * limited to the {@link CommandFactory} and {@link ServiceProviderFactory} extension points.
+ */
+export default interface CLIPlugin extends Plugin {
+  readonly extensionDescriptors: ReadonlyArray<
+    CommandFactoryExtensionDescriptor | ServiceProviderFactoryExtensionDescriptor
+  >;
+}

package/src/api/plugin/createCLIPlugin.ts

@@ -0,0 +1,47 @@
+import type CommandFactory from "./CommandFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT } from "./CommandFactory.ts";
+import type ServiceProviderFactory from "./ServiceProviderFactory.ts";
+import { DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT } from "./ServiceProviderFactory.ts";
+import type CLIPlugin from "./CLIPlugin.ts";
+
+export interface CLIPluginOptions {
+  readonly commandFactory?: CommandFactory | (() => Promise<CommandFactory>);
+  readonly serviceProviderFactory?:
+    | ServiceProviderFactory
+    | (() => Promise<ServiceProviderFactory>);
+  readonly pluginData?: ReadonlyMap<string, string>;
+}
+
+/**
+ * Build a {@link CLIPlugin} from optional {@link CommandFactory} and {@link ServiceProviderFactory}
+ * instances (or factory functions), without needing to hand-construct extension descriptors.
+ */
+export default function createCLIPlugin(options: CLIPluginOptions): CLIPlugin {
+  const extensionDescriptors: CLIPlugin["extensionDescriptors"][number][] = [];
+
+  if (options.commandFactory) {
+    const commandFactory = options.commandFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_COMMAND_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () =>
+          typeof commandFactory === "function" ? commandFactory() : commandFactory,
+      },
+    });
+  }
+
+  if (options.serviceProviderFactory) {
+    const serviceProviderFactory = options.serviceProviderFactory;
+    extensionDescriptors.push({
+      extensionPoint: DYNAMIC_CLI_FRAMEWORK_SERVICE_PROVIDER_FACTORY_EXTENSION_POINT,
+      factory: {
+        create: async () =>
+          typeof serviceProviderFactory === "function"
+            ? serviceProviderFactory()
+            : serviceProviderFactory,
+      },
+    });
+  }
+
+  return { extensionDescriptors, pluginData: options.pluginData };
+}

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

@@ -22,7 +22,7 @@ export default interface CompletionService {
     cursorPosition: number,
   ): Promise<ReadonlyArray<CompletionItem>>;
 
-  getBootstrapScript(shellType: ShellType, cliName: string): string;
+  getBootstrapScript(shellType: ShellType, cliName: string, executablePath: string): string;
 
   getDefaultConfigPath(shellType: ShellType): string;
 

package/src/command/CompletionCommand.ts

@@ -1,3 +1,4 @@
+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";
@@ -51,7 +52,11 @@ export class CompletionIntegrationSubCommand implements SubCommand {
 
     const configPath = configPathArg || completionService.getDefaultConfigPath(shellType);
     const cliName = context.cliConfig.name;
-    const bootstrapScript = completionService.getBootstrapScript(shellType, cliName);
+    const bootstrapScript = completionService.getBootstrapScript(
+      shellType,
+      cliName,
+      process.execPath,
+    );
 
     const beginMarker = `# BEGIN ${cliName} completion`;
     const endMarker = `# END ${cliName} completion`;

package/src/command/PluginCommand.ts

@@ -98,17 +98,30 @@ export class PluginAddSubCommand implements SubCommand {
         break;
       }
     }
+
     if (!descriptor) {
-      await printerService.error(`Plugin not found: ${pluginId}`, Icon.FAILURE);
-      return;
+      // 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}...`,
+        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 ${getPluginId(descriptor)}@${descriptor.version}...`,
-      Icon.INFORMATION,
-    );
+    await printerService.info(`Installing ${descriptor.pluginId}...`, Icon.INFORMATION);
     await pluginService.install(descriptor);
-    await printerService.print(`Plugin ${getPluginId(descriptor)} installed.\n`, Icon.SUCCESS);
+    await printerService.print(`Plugin ${descriptor.pluginId} installed.\n`, Icon.SUCCESS);
   }
 }
 

package/src/service/completion/CompletionServiceProvider.ts

@@ -1,3 +1,4 @@
+import process from "node:process";
 import type { ServiceProvider } from "../../api/service/ServiceProvider.ts";
 import type { ServiceInfo } from "../../api/service/ServiceProvider.ts";
 import type CLIConfig from "../../api/CLIConfig.ts";
@@ -141,7 +142,11 @@ export default class CompletionServiceProvider implements ServiceProvider {
 
   async #installCompletion(context: Context, shellType: ShellType): Promise<void> {
     const configPath = this.#completionService.getDefaultConfigPath(shellType);
-    const bootstrapScript = this.#completionService.getBootstrapScript(shellType, this.#cliName);
+    const bootstrapScript = this.#completionService.getBootstrapScript(
+      shellType,
+      this.#cliName,
+      process.execPath,
+    );
     const beginMarker = `# BEGIN ${this.#cliName} completion`;
     const endMarker = `# END ${this.#cliName} completion`;
     const block = `${beginMarker}\n${bootstrapScript}\n${endMarker}`;

package/src/service/completion/DefaultCompletionService.ts

@@ -23,8 +23,8 @@ export default class DefaultCompletionService implements CompletionService {
     this.#commandRegistry = registry;
   }
 
-  getBootstrapScript(shellType: ShellType, cliName: string): string {
-    return this.#getHandler(shellType).getBootstrapScript(cliName);
+  getBootstrapScript(shellType: ShellType, cliName: string, executablePath: string): string {
+    return this.#getHandler(shellType).getBootstrapScript(cliName, executablePath);
   }
 
   getDefaultConfigPath(shellType: ShellType): string {

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

@@ -7,7 +7,7 @@ export interface CompletionContext {
 
 export default interface ShellHandler {
   getDefaultConfigPath(): string;
-  getBootstrapScript(cliName: string): string;
+  getBootstrapScript(cliName: string, executablePath: string): string;
   validateEnvironment(): Promise<boolean>;
   formatCompletions(completions: ReadonlyArray<CompletionItem>): string;
   parseCompletionContext(args: ReadonlyArray<string>): CompletionContext;

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

@@ -12,11 +12,11 @@ export default class BashShellHandler implements ShellHandler {
     return join(homedir(), ".bashrc");
   }
 
-  getBootstrapScript(cliName: string): string {
+  getBootstrapScript(cliName: string, executablePath: string): string {
     return [
       `_${cliName}_completions() {`,
       `  local IFS=$'\\n'`,
-      `  COMPREPLY=( $(${cliName} completions:complete bash "\${COMP_LINE}" "\${COMP_POINT}") )`,
+      `  COMPREPLY=( $("${executablePath}" completions:complete bash "\${COMP_LINE}" "\${COMP_POINT}") )`,
       `}`,
       `complete -F _${cliName}_completions ${cliName}`,
     ].join("\n");

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

@@ -12,8 +12,8 @@ export default class FishShellHandler implements ShellHandler {
     return join(homedir(), ".config", "fish", "config.fish");
   }
 
-  getBootstrapScript(cliName: string): string {
-    return `complete -c ${cliName} -f -a '(${cliName} completions:complete fish (commandline -cp) (commandline -C))'`;
+  getBootstrapScript(cliName: string, executablePath: string): string {
+    return `complete -c ${cliName} -f -a '("${executablePath}" completions:complete fish (commandline -cp) (commandline -C))'`;
   }
 
   validateEnvironment(): Promise<boolean> {

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

@@ -15,11 +15,11 @@ export default class PowerShellShellHandler implements ShellHandler {
     return join(homedir(), ".config", "powershell", "Microsoft.PowerShell_profile.ps1");
   }
 
-  getBootstrapScript(cliName: string): string {
+  getBootstrapScript(cliName: string, executablePath: string): string {
     return [
       `Register-ArgumentCompleter -Native -CommandName ${cliName} -ScriptBlock {`,
       `  param($wordToComplete, $commandAst, $cursorPosition)`,
-      `  $completions = & ${cliName} completions:complete powershell "$commandAst" "$cursorPosition"`,
+      `  $completions = & "${executablePath}" completions:complete powershell "$commandAst" "$cursorPosition"`,
       `  $completions -split '\\n' | ForEach-Object {`,
       `    [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)`,
       `  }`,
@@ -37,7 +37,9 @@ export default class PowerShellShellHandler implements ShellHandler {
       // try powershell fallback
     }
     try {
-      const result = Bun.spawnSync(["powershell", "-Command", "echo ok"], { timeout: 2000 });
+      const result = Bun.spawnSync(["powershell", "-Command", "echo ok"], {
+        timeout: 2000,
+      });
       return Promise.resolve(result.exitCode === 0);
     } catch {
       return Promise.resolve(false);

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

@@ -12,11 +12,11 @@ export default class ZshShellHandler implements ShellHandler {
     return join(homedir(), ".zshrc");
   }
 
-  getBootstrapScript(cliName: string): string {
+  getBootstrapScript(cliName: string, executablePath: string): string {
     return [
       `_${cliName}_completions() {`,
       `  local -a completions`,
-      `  completions=("\${(@f)$(${cliName} completions:complete zsh "\${words}" "\${CURSOR}")}")`,
+      `  completions=("\${(@f)$("${executablePath}" completions:complete zsh "\${words}" "\${CURSOR}")}")`,
       `  _describe '${cliName}' completions`,
       `}`,
       `compdef _${cliName}_completions ${cliName}`,