@launch77/cli 1.2.0 → 1.4.0

package/dist/modules/plugin/errors/plugin-errors.js

@@ -14,19 +14,65 @@ export class InvalidPluginContextError extends Error {
 }
 /**
  * Factory function to create standardized InvalidPluginContextError
- * for when plugin:install is run outside of an app directory
+ * for when plugin:install is run outside of a package directory
  */
 export function createInvalidContextError(currentLocation) {
-    return new InvalidPluginContextError(`plugin:install must be run from within an app directory.
+    return new InvalidPluginContextError(`plugin:install must be run from within a package directory.
 
 Current location: ${currentLocation}
-Expected: apps/<app-name>/
+Expected: apps/<name>/, libraries/<name>/, plugins/<name>/, or app-templates/<name>/
 
-Navigate to an app directory:
+Navigate to a package directory:
   cd apps/<app-name>/
+  cd libraries/<lib-name>/
+  cd plugins/<plugin-name>/
+  cd app-templates/<template-name>/`);
+}
+/**
+ * Error when plugin.json is missing the required 'targets' field
+ */
+export class MissingPluginTargetsError extends Error {
+    constructor(pluginName) {
+        super(`Plugin '${pluginName}' is missing the required 'targets' field in plugin.json.
+
+The plugin.json file must include a 'targets' array specifying which package types
+the plugin can be installed into.
+
+Example plugin.json:
+{
+  "name": "${pluginName}",
+  "version": "1.0.0",
+  "targets": ["app", "library", "plugin", "app-template"],
+  "pluginDependencies": {},
+  "libraryDependencies": {}
+}`);
+        this.name = 'MissingPluginTargetsError';
+    }
+}
+/**
+ * Factory function to create error when plugin targets don't match current location
+ */
+export function createInvalidTargetError(pluginName, currentTarget, allowedTargets) {
+    const targetLocations = allowedTargets.map((target) => {
+        switch (target) {
+            case 'app':
+                return 'apps/<name>/';
+            case 'library':
+                return 'libraries/<name>/';
+            case 'plugin':
+                return 'plugins/<name>/';
+            case 'app-template':
+                return 'app-templates/<name>/';
+            default:
+                return target;
+        }
+    });
+    return new InvalidPluginContextError(`Plugin '${pluginName}' cannot be installed in a '${currentTarget}' package.
+
+This plugin can only be installed in: ${allowedTargets.join(', ')}
 
-Or create an app first:
-  launch77 app:create api <app-name>`);
+Allowed locations:
+${targetLocations.map((loc) => `  ${loc}`).join('\n')}`);
 }
 export class PluginInstallationError extends Error {
     cause;
@@ -36,4 +82,31 @@ export class PluginInstallationError extends Error {
         this.name = 'PluginInstallationError';
     }
 }
+/**
+ * Error when plugin resolution fails
+ */
+export class PluginResolutionError extends Error {
+    constructor(pluginName, reason) {
+        super(`Failed to resolve plugin '${pluginName}': ${reason}`);
+        this.name = 'PluginResolutionError';
+    }
+}
+/**
+ * Error when npm package installation fails
+ */
+export class NpmInstallationError extends Error {
+    cause;
+    constructor(packageName, cause) {
+        super(`Failed to install npm package '${packageName}'.
+
+Please check:
+- Your internet connection
+- npm registry access (https://registry.npmjs.org)
+- Package exists: https://www.npmjs.com/package/${packageName}
+
+${cause ? `\nOriginal error: ${cause.message}` : ''}`);
+        this.cause = cause;
+        this.name = 'NpmInstallationError';
+    }
+}
 //# sourceMappingURL=plugin-errors.js.map

package/dist/modules/plugin/errors/plugin-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-errors.js","sourceRoot":"","sources":["../../../../src/modules/plugin/errors/plugin-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU;;qDAEsB,CAAC,CAAA;QAClD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,eAAuB;IAC/D,OAAO,IAAI,yBAAyB,CAClC;;oBAEgB,eAAe;;;;;;;qCAOE,CAClC,CAAA;AACH,CAAC;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAG9B;IAFlB,YACE,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF"}
+{"version":3,"file":"plugin-errors.js","sourceRoot":"","sources":["../../../../src/modules/plugin/errors/plugin-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU;;qDAEsB,CAAC,CAAA;QAClD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,eAAuB;IAC/D,OAAO,IAAI,yBAAyB,CAClC;;oBAEgB,eAAe;;;;;;;oCAOC,CACjC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,UAAkB;QAC5B,KAAK,CAAC,WAAW,UAAU;;;;;;;aAOlB,UAAU;;;;;EAKrB,CAAC,CAAA;QACC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB,EAAE,aAAqB,EAAE,cAAwB;IAC1G,MAAM,eAAe,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACpD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,KAAK;gBACR,OAAO,cAAc,CAAA;YACvB,KAAK,SAAS;gBACZ,OAAO,mBAAmB,CAAA;YAC5B,KAAK,QAAQ;gBACX,OAAO,iBAAiB,CAAA;YAC1B,KAAK,cAAc;gBACjB,OAAO,uBAAuB,CAAA;YAChC;gBACE,OAAO,MAAM,CAAA;QACjB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,yBAAyB,CAClC,WAAW,UAAU,+BAA+B,aAAa;;wCAE7B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAG/D,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpD,CAAA;AACH,CAAC;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAG9B;IAFlB,YACE,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,6BAA6B,UAAU,MAAM,MAAM,EAAE,CAAC,CAAA;QAC5D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3B;IAFlB,YACE,WAAmB,EACH,KAAa;QAE7B,KAAK,CAAC,kCAAkC,WAAW;;;;;kDAKL,WAAW;;EAE3D,KAAK,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QATlC,UAAK,GAAL,KAAK,CAAQ;QAU7B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF"}

package/dist/modules/plugin/index.d.ts

@@ -1,6 +1,8 @@
 export { PluginService } from './services/plugin-svc.js';
+export { PluginCreateService } from './services/plugin-create-service.js';
 export type { InstallPluginRequest, InstallPluginResult, PluginMetadata, HookResult } from './types/plugin-types.js';
-export { PluginNotFoundError, InvalidPluginContextError, PluginInstallationError } from './errors/plugin-errors.js';
+export { PluginNotFoundError, InvalidPluginContextError, PluginInstallationError, PluginResolutionError, NpmInstallationError } from './errors/plugin-errors.js';
 export { pluginInstallCommand } from './commands/plugin-install.js';
-export { getPluginPath, pluginExists, listAvailablePlugins } from './lib/plugin-registry.js';
+export { pluginCreateCommand } from './commands/plugin-create.js';
+export { listAvailablePlugins } from './lib/plugin-registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/plugin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAGxD,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGpH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAGnH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAGnE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/plugin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAGzE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGpH,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAGhK,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/modules/plugin/index.js

@@ -1,9 +1,11 @@
 // Services
 export { PluginService } from './services/plugin-svc.js';
+export { PluginCreateService } from './services/plugin-create-service.js';
 // Errors
-export { PluginNotFoundError, InvalidPluginContextError, PluginInstallationError } from './errors/plugin-errors.js';
+export { PluginNotFoundError, InvalidPluginContextError, PluginInstallationError, PluginResolutionError, NpmInstallationError } from './errors/plugin-errors.js';
 // Commands
 export { pluginInstallCommand } from './commands/plugin-install.js';
+export { pluginCreateCommand } from './commands/plugin-create.js';
 // Utilities
-export { getPluginPath, pluginExists, listAvailablePlugins } from './lib/plugin-registry.js';
+export { listAvailablePlugins } from './lib/plugin-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/modules/plugin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/plugin/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAKxD,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAEnH,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/plugin/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAKzE,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhK,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,YAAY;AACZ,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/modules/plugin/lib/plugin-registry.d.ts

@@ -1,15 +1,9 @@
 /**
- * Get the path to a plugin directory
- * Plugins are bundled with the CLI at dist/plugins/
+ * List all available plugins in the workspace
+ * Scans the workspace plugins/ directory for valid plugins
+ *
+ * @param workspaceRoot - The root directory of the Launch77 workspace
+ * @returns Array of plugin names found in the workspace
  */
-export declare function getPluginPath(pluginName: string): string;
-/**
- * Check if a plugin exists
- * A plugin must have: dist/generator.js and plugin.json
- */
-export declare function pluginExists(pluginName: string): Promise<boolean>;
-/**
- * List all available plugins
- */
-export declare function listAvailablePlugins(): Promise<string[]>;
+export declare function listAvailablePlugins(workspaceRoot: string): Promise<string[]>;
 //# sourceMappingURL=plugin-registry.d.ts.map

package/dist/modules/plugin/lib/plugin-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-registry.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAuB9D"}
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-registry.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnF"}

package/dist/modules/plugin/lib/plugin-registry.js

@@ -1,43 +1,26 @@
 import * as path from 'path';
-import { fileURLToPath } from 'url';
 import fs from 'fs-extra';
 /**
- * Get the path to a plugin directory
- * Plugins are bundled with the CLI at dist/plugins/
+ * List all available plugins in the workspace
+ * Scans the workspace plugins/ directory for valid plugins
+ *
+ * @param workspaceRoot - The root directory of the Launch77 workspace
+ * @returns Array of plugin names found in the workspace
  */
-export function getPluginPath(pluginName) {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    // From dist/modules/plugin/lib/ to dist/plugins/
-    const baseDir = path.join(__dirname, '../../../plugins');
-    return path.join(baseDir, pluginName);
-}
-/**
- * Check if a plugin exists
- * A plugin must have: dist/generator.js and plugin.json
- */
-export async function pluginExists(pluginName) {
-    const pluginPath = getPluginPath(pluginName);
-    const hasGenerator = await fs.pathExists(path.join(pluginPath, 'dist/generator.js'));
-    const hasPluginJson = await fs.pathExists(path.join(pluginPath, 'plugin.json'));
-    return hasGenerator && hasPluginJson;
-}
-/**
- * List all available plugins
- */
-export async function listAvailablePlugins() {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    const baseDir = path.join(__dirname, '../../../plugins');
-    if (!(await fs.pathExists(baseDir))) {
+export async function listAvailablePlugins(workspaceRoot) {
+    const pluginsDir = path.join(workspaceRoot, 'plugins');
+    if (!(await fs.pathExists(pluginsDir))) {
         return [];
     }
-    const items = await fs.readdir(baseDir, { withFileTypes: true });
+    const items = await fs.readdir(pluginsDir, { withFileTypes: true });
     const plugins = [];
     for (const item of items) {
         if (item.isDirectory()) {
             // Verify it's a valid plugin
-            if (await pluginExists(item.name)) {
+            const pluginPath = path.join(pluginsDir, item.name);
+            const hasPluginJson = await fs.pathExists(path.join(pluginPath, 'plugin.json'));
+            const hasGenerator = await fs.pathExists(path.join(pluginPath, 'dist/generator.js'));
+            if (hasPluginJson && hasGenerator) {
                 plugins.push(item.name);
             }
         }

package/dist/modules/plugin/lib/plugin-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AAEnC,OAAO,EAAE,MAAM,UAAU,CAAA;AAEzB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAE1C,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;IAExD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAE5C,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAA;IACpF,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAA;IAE/E,OAAO,YAAY,IAAI,aAAa,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAA;IAExD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IAChE,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,6BAA6B;YAC7B,IAAI,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,OAAO,EAAE,MAAM,UAAU,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAqB;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAA;IAEtD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IACnE,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,6BAA6B;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YACnD,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAA;YAC/E,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAA;YAEpF,IAAI,aAAa,IAAI,YAAY,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/modules/plugin/lib/plugin-resolver.d.ts

@@ -0,0 +1,76 @@
+import type { ValidationResult } from '@launch77/plugin-runtime';
+/**
+ * Plugin resolution result
+ */
+export interface PluginResolution {
+    /** The source of the plugin */
+    source: 'local' | 'npm';
+    /** The resolved name/package to use */
+    resolvedName: string;
+    /** The local path if source is 'local' */
+    localPath?: string;
+    /** The npm package name if source is 'npm' */
+    npmPackage?: string;
+}
+/**
+ * Validate plugin input name
+ *
+ * Accepts:
+ * - Unscoped names (e.g., "release", "my-plugin")
+ * - Scoped npm packages (e.g., "@ibm/plugin-name")
+ *
+ * Rejects:
+ * - Invalid formats
+ * - Empty strings
+ * - Names with invalid characters
+ *
+ * @param name - The plugin name to validate
+ * @returns ValidationResult with isValid and optional error message
+ *
+ * @example
+ * validatePluginInput('release') // { isValid: true }
+ * validatePluginInput('@ibm/analytics') // { isValid: true }
+ * validatePluginInput('@invalid') // { isValid: false, error: '...' }
+ */
+export declare function validatePluginInput(name: string): ValidationResult;
+/**
+ * Convert an unscoped plugin name to an npm package name
+ *
+ * Rules:
+ * - Unscoped names: prefix with @launch77-shared/plugin-
+ * - Scoped names: use as-is
+ *
+ * @param name - The plugin name (must be validated first)
+ * @returns The npm package name
+ *
+ * @example
+ * toNpmPackageName('release') // '@launch77-shared/plugin-release'
+ * toNpmPackageName('@ibm/analytics') // '@ibm/analytics'
+ */
+export declare function toNpmPackageName(name: string): string;
+/**
+ * Resolve plugin location from name
+ *
+ * Resolution order:
+ * 1. Check local workspace plugins directory
+ * 2. Resolve to npm package name
+ *
+ * @param name - The plugin name to resolve
+ * @param workspaceRoot - The workspace root directory
+ * @returns PluginResolution with source and resolved location
+ *
+ * @example
+ * // Local plugin found
+ * await resolvePluginLocation('my-plugin', '/workspace')
+ * // { source: 'local', resolvedName: 'my-plugin', localPath: '/workspace/plugins/my-plugin' }
+ *
+ * // Not found locally, resolve to npm
+ * await resolvePluginLocation('release', '/workspace')
+ * // { source: 'npm', resolvedName: 'release', npmPackage: '@launch77-shared/plugin-release' }
+ *
+ * // Scoped package always resolves to npm
+ * await resolvePluginLocation('@ibm/analytics', '/workspace')
+ * // { source: 'npm', resolvedName: '@ibm/analytics', npmPackage: '@ibm/analytics' }
+ */
+export declare function resolvePluginLocation(name: string, workspaceRoot: string): Promise<PluginResolution>;
+//# sourceMappingURL=plugin-resolver.d.ts.map

package/dist/modules/plugin/lib/plugin-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-resolver.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,OAAO,GAAG,KAAK,CAAA;IACvB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA2BlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuC1G"}

package/dist/modules/plugin/lib/plugin-resolver.js

@@ -0,0 +1,128 @@
+import * as path from 'path';
+import fs from 'fs-extra';
+import { parsePluginName, isValidNpmPackageName } from '@launch77/plugin-runtime';
+/**
+ * Validate plugin input name
+ *
+ * Accepts:
+ * - Unscoped names (e.g., "release", "my-plugin")
+ * - Scoped npm packages (e.g., "@ibm/plugin-name")
+ *
+ * Rejects:
+ * - Invalid formats
+ * - Empty strings
+ * - Names with invalid characters
+ *
+ * @param name - The plugin name to validate
+ * @returns ValidationResult with isValid and optional error message
+ *
+ * @example
+ * validatePluginInput('release') // { isValid: true }
+ * validatePluginInput('@ibm/analytics') // { isValid: true }
+ * validatePluginInput('@invalid') // { isValid: false, error: '...' }
+ */
+export function validatePluginInput(name) {
+    if (!name || name.trim().length === 0) {
+        return {
+            isValid: false,
+            error: 'Plugin name cannot be empty',
+        };
+    }
+    const trimmedName = name.trim();
+    // Parse the name to determine type and validate
+    const parsed = parsePluginName(trimmedName);
+    if (!parsed.isValid) {
+        return {
+            isValid: false,
+            error: parsed.error,
+        };
+    }
+    // If it's scoped, it must be a valid npm package name
+    if (parsed.type === 'scoped') {
+        return isValidNpmPackageName(trimmedName);
+    }
+    // Unscoped names are valid for both local and npm
+    return { isValid: true };
+}
+/**
+ * Convert an unscoped plugin name to an npm package name
+ *
+ * Rules:
+ * - Unscoped names: prefix with @launch77-shared/plugin-
+ * - Scoped names: use as-is
+ *
+ * @param name - The plugin name (must be validated first)
+ * @returns The npm package name
+ *
+ * @example
+ * toNpmPackageName('release') // '@launch77-shared/plugin-release'
+ * toNpmPackageName('@ibm/analytics') // '@ibm/analytics'
+ */
+export function toNpmPackageName(name) {
+    const trimmedName = name.trim();
+    // If already scoped, use as-is
+    if (trimmedName.startsWith('@')) {
+        return trimmedName;
+    }
+    // Otherwise, convert to @launch77-shared/plugin-<name>
+    return `@launch77-shared/plugin-${trimmedName}`;
+}
+/**
+ * Resolve plugin location from name
+ *
+ * Resolution order:
+ * 1. Check local workspace plugins directory
+ * 2. Resolve to npm package name
+ *
+ * @param name - The plugin name to resolve
+ * @param workspaceRoot - The workspace root directory
+ * @returns PluginResolution with source and resolved location
+ *
+ * @example
+ * // Local plugin found
+ * await resolvePluginLocation('my-plugin', '/workspace')
+ * // { source: 'local', resolvedName: 'my-plugin', localPath: '/workspace/plugins/my-plugin' }
+ *
+ * // Not found locally, resolve to npm
+ * await resolvePluginLocation('release', '/workspace')
+ * // { source: 'npm', resolvedName: 'release', npmPackage: '@launch77-shared/plugin-release' }
+ *
+ * // Scoped package always resolves to npm
+ * await resolvePluginLocation('@ibm/analytics', '/workspace')
+ * // { source: 'npm', resolvedName: '@ibm/analytics', npmPackage: '@ibm/analytics' }
+ */
+export async function resolvePluginLocation(name, workspaceRoot) {
+    const trimmedName = name.trim();
+    const parsed = parsePluginName(trimmedName);
+    // If scoped, always use npm (local plugins are never scoped)
+    if (parsed.type === 'scoped') {
+        return {
+            source: 'npm',
+            resolvedName: trimmedName,
+            npmPackage: trimmedName,
+        };
+    }
+    // Check local workspace plugins directory
+    const localPath = path.join(workspaceRoot, 'plugins', trimmedName);
+    const localExists = await fs.pathExists(localPath);
+    if (localExists) {
+        // Verify it's a valid plugin (has plugin.json and dist/generator.js)
+        const hasPluginJson = await fs.pathExists(path.join(localPath, 'plugin.json'));
+        const hasGenerator = await fs.pathExists(path.join(localPath, 'dist/generator.js'));
+        if (hasPluginJson && hasGenerator) {
+            return {
+                source: 'local',
+                resolvedName: trimmedName,
+                localPath,
+            };
+        }
+    }
+    // Not found locally, resolve to npm package
+    const npmPackage = toNpmPackageName(trimmedName);
+    return {
+        source: 'npm',
+        resolvedName: trimmedName,
+        npmPackage,
+    };
+}
+//# sourceMappingURL=plugin-resolver.js.map

package/dist/modules/plugin/lib/plugin-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-resolver.js","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,OAAO,EAAE,MAAM,UAAU,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAkBjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,6BAA6B;SACrC,CAAA;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAE/B,gDAAgD;IAChD,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAE3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAA;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAA;IAC3C,CAAC;IAED,kDAAkD;IAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAE/B,+BAA+B;IAC/B,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,uDAAuD;IACvD,OAAO,2BAA2B,WAAW,EAAE,CAAA;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,aAAqB;IAC7E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAE3C,6DAA6D;IAC7D,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,WAAW;YACzB,UAAU,EAAE,WAAW;SACxB,CAAA;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IAClE,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAElD,IAAI,WAAW,EAAE,CAAC;QAChB,qEAAqE;QACrE,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;QAC9E,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAEnF,IAAI,aAAa,IAAI,YAAY,EAAE,CAAC;YAClC,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,YAAY,EAAE,WAAW;gBACzB,SAAS;aACV,CAAA;QACH,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAEhD,OAAO;QACL,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,WAAW;QACzB,UAAU;KACX,CAAA;AACH,CAAC"}

package/dist/modules/plugin/lib/plugin-resolver.test.d.ts

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

package/dist/modules/plugin/lib/plugin-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-resolver.test.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/lib/plugin-resolver.test.ts"],"names":[],"mappings":""}

package/dist/modules/plugin/lib/plugin-resolver.test.js

@@ -0,0 +1,175 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as path from 'path';
+import * as os from 'os';
+import fs from 'fs-extra';
+import { validatePluginInput, toNpmPackageName, resolvePluginLocation } from './plugin-resolver.js';
+describe('Plugin Resolver', () => {
+    describe('validatePluginInput', () => {
+        it('should accept valid unscoped plugin names', () => {
+            expect(validatePluginInput('release')).toEqual({ isValid: true });
+            expect(validatePluginInput('my-plugin')).toEqual({ isValid: true });
+            expect(validatePluginInput('analytics-v2')).toEqual({ isValid: true });
+        });
+        it('should accept valid scoped npm packages', () => {
+            expect(validatePluginInput('@ibm/plugin-name')).toEqual({ isValid: true });
+            expect(validatePluginInput('@launch77-shared/plugin-release')).toEqual({ isValid: true });
+            expect(validatePluginInput('@org/analytics')).toEqual({ isValid: true });
+        });
+        it('should reject empty names', () => {
+            const result = validatePluginInput('');
+            expect(result.isValid).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('should reject whitespace-only names', () => {
+            const result = validatePluginInput('   ');
+            expect(result.isValid).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('should reject invalid scoped packages', () => {
+            const result1 = validatePluginInput('@invalid');
+            expect(result1.isValid).toBe(false);
+            expect(result1.error).toBeDefined();
+            const result2 = validatePluginInput('@/package');
+            expect(result2.isValid).toBe(false);
+            expect(result2.error).toBeDefined();
+            const result3 = validatePluginInput('@org/');
+            expect(result3.isValid).toBe(false);
+            expect(result3.error).toBeDefined();
+        });
+        it('should reject names with uppercase letters', () => {
+            const result = validatePluginInput('MyPlugin');
+            expect(result.isValid).toBe(false);
+            expect(result.error).toContain('lowercase');
+        });
+        it('should reject names starting with numbers', () => {
+            const result = validatePluginInput('123plugin');
+            expect(result.isValid).toBe(false);
+            expect(result.error).toBeDefined();
+        });
+        it('should reject names with special characters', () => {
+            const result1 = validatePluginInput('plugin_name');
+            expect(result1.isValid).toBe(false);
+            const result2 = validatePluginInput('plugin.name');
+            expect(result2.isValid).toBe(false);
+            const result3 = validatePluginInput('plugin name');
+            expect(result3.isValid).toBe(false);
+        });
+        it('should trim whitespace before validation', () => {
+            expect(validatePluginInput('  release  ')).toEqual({ isValid: true });
+            expect(validatePluginInput('  @ibm/analytics  ')).toEqual({ isValid: true });
+        });
+    });
+    describe('toNpmPackageName', () => {
+        it('should prefix unscoped names with @launch77-shared/plugin-', () => {
+            expect(toNpmPackageName('release')).toBe('@launch77-shared/plugin-release');
+            expect(toNpmPackageName('my-plugin')).toBe('@launch77-shared/plugin-my-plugin');
+            expect(toNpmPackageName('analytics-v2')).toBe('@launch77-shared/plugin-analytics-v2');
+        });
+        it('should return scoped packages as-is', () => {
+            expect(toNpmPackageName('@ibm/analytics')).toBe('@ibm/analytics');
+            expect(toNpmPackageName('@launch77-shared/plugin-release')).toBe('@launch77-shared/plugin-release');
+            expect(toNpmPackageName('@org/package')).toBe('@org/package');
+        });
+        it('should trim whitespace', () => {
+            expect(toNpmPackageName('  release  ')).toBe('@launch77-shared/plugin-release');
+            expect(toNpmPackageName('  @ibm/analytics  ')).toBe('@ibm/analytics');
+        });
+    });
+    describe('resolvePluginLocation', () => {
+        let tempDir;
+        beforeEach(async () => {
+            // Create a temporary workspace directory
+            tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'plugin-resolver-test-'));
+            await fs.ensureDir(path.join(tempDir, 'plugins'));
+        });
+        afterEach(async () => {
+            // Clean up
+            await fs.remove(tempDir);
+        });
+        it('should resolve local plugins first', async () => {
+            // Create a valid local plugin
+            const pluginPath = path.join(tempDir, 'plugins', 'my-plugin');
+            await fs.ensureDir(pluginPath);
+            await fs.ensureDir(path.join(pluginPath, 'dist'));
+            await fs.writeFile(path.join(pluginPath, 'plugin.json'), JSON.stringify({ name: 'my-plugin', version: '1.0.0' }));
+            await fs.writeFile(path.join(pluginPath, 'dist/generator.js'), 'console.log("test")');
+            const result = await resolvePluginLocation('my-plugin', tempDir);
+            expect(result).toEqual({
+                source: 'local',
+                resolvedName: 'my-plugin',
+                localPath: pluginPath,
+            });
+        });
+        it('should resolve to npm if local plugin does not exist', async () => {
+            const result = await resolvePluginLocation('release', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: 'release',
+                npmPackage: '@launch77-shared/plugin-release',
+            });
+        });
+        it('should resolve to npm if local plugin is incomplete (missing plugin.json)', async () => {
+            // Create incomplete local plugin (no plugin.json)
+            const pluginPath = path.join(tempDir, 'plugins', 'incomplete');
+            await fs.ensureDir(pluginPath);
+            await fs.ensureDir(path.join(pluginPath, 'dist'));
+            await fs.writeFile(path.join(pluginPath, 'dist/generator.js'), 'console.log("test")');
+            const result = await resolvePluginLocation('incomplete', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: 'incomplete',
+                npmPackage: '@launch77-shared/plugin-incomplete',
+            });
+        });
+        it('should resolve to npm if local plugin is incomplete (missing generator.js)', async () => {
+            // Create incomplete local plugin (no generator.js)
+            const pluginPath = path.join(tempDir, 'plugins', 'incomplete');
+            await fs.ensureDir(pluginPath);
+            await fs.writeFile(path.join(pluginPath, 'plugin.json'), JSON.stringify({ name: 'incomplete', version: '1.0.0' }));
+            const result = await resolvePluginLocation('incomplete', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: 'incomplete',
+                npmPackage: '@launch77-shared/plugin-incomplete',
+            });
+        });
+        it('should always resolve scoped packages to npm', async () => {
+            // Even if a directory exists locally, scoped names go to npm
+            const pluginPath = path.join(tempDir, 'plugins', '@ibm');
+            await fs.ensureDir(pluginPath);
+            const result = await resolvePluginLocation('@ibm/analytics', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: '@ibm/analytics',
+                npmPackage: '@ibm/analytics',
+            });
+        });
+        it('should resolve scoped @launch77-shared packages to npm', async () => {
+            const result = await resolvePluginLocation('@launch77-shared/plugin-release', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: '@launch77-shared/plugin-release',
+                npmPackage: '@launch77-shared/plugin-release',
+            });
+        });
+        it('should handle plugins directory not existing', async () => {
+            // Remove plugins directory
+            await fs.remove(path.join(tempDir, 'plugins'));
+            const result = await resolvePluginLocation('release', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: 'release',
+                npmPackage: '@launch77-shared/plugin-release',
+            });
+        });
+        it('should trim whitespace from plugin names', async () => {
+            const result = await resolvePluginLocation('  release  ', tempDir);
+            expect(result).toEqual({
+                source: 'npm',
+                resolvedName: 'release',
+                npmPackage: '@launch77-shared/plugin-release',
+            });
+        });
+    });
+});
+//# sourceMappingURL=plugin-resolver.test.js.map