@launch77/cli 1.4.3 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @launch77/cli
 
+## 1.5.0
+
+### Minor Changes
+
+- 1517d3e: Remove startup module and generate-manifest commandAdd dynamic app template support from npmSimplify plugin/app metadata (derive from package.json)Enforce version requirements
+
+### Patch Changes
+
+- Updated dependencies [1517d3e]
+  - @launch77/plugin-runtime@0.3.0
+
+## 1.4.4
+
+### Patch Changes
+
+- 1504a6d: Added support for creating apps from tempaltes published in npm
+- Updated dependencies [1504a6d]
+  - @launch77/plugin-runtime@0.2.3
+
 ## 1.4.3
 
 ### Patch Changes

package/dist/cli.js

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { createAppCommand, deleteAppCommand, generateManifestCommand, validateManifestCommand } from './modules/app/index.js';
+import { createAppCommand, deleteAppCommand, validateManifestCommand } from './modules/app/index.js';
 import { scanCommand, createGenerateCommand } from './modules/catalog/index.js';
 import { deployInitCommand, deployLogsCommand, deployStatusCommand } from './modules/deploy/index.js';
 import { gitConnectCommand } from './modules/git/index.js';
 import { pluginInstallCommand, pluginCreateCommand } from './modules/plugin/index.js';
 import { releaseInitCommand } from './modules/release/index.js';
-import { createStartupCommand } from './modules/startup/index.js';
 import { getPackageVersion } from './utils/version.js';
 import { initWorkspaceCommand } from './modules/workspace/index.js';
 const program = new Command()
@@ -15,10 +14,8 @@ const program = new Command()
     .version(getPackageVersion(import.meta.url));
 // Register module commands
 program.addCommand(initWorkspaceCommand());
-program.addCommand(createStartupCommand());
 program.addCommand(createAppCommand());
 program.addCommand(deleteAppCommand());
-program.addCommand(generateManifestCommand());
 program.addCommand(validateManifestCommand());
 program.addCommand(pluginInstallCommand());
 program.addCommand(pluginCreateCommand());

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAC7H,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,uBAAuB,CAAC;KACpC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAE9C,2BAA2B;AAC3B,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AACtC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AACtC,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAA;AAC7C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAA;AAC7C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;AACzC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAA;AAE3C,eAAe;AACf,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAEvC,mBAAmB;AACnB,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAA;AAExC,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;AACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAEvC,OAAO,CAAC,KAAK,EAAE,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACpG,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,uBAAuB,CAAC;KACpC,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAE9C,2BAA2B;AAC3B,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AACtC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAA;AACtC,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAA;AAC7C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA;AAC1C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;AACzC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAA;AACjC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAA;AAE3C,eAAe;AACf,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAEvC,mBAAmB;AACnB,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAA;AAExC,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AACvC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAA;AACzC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAEvC,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/infrastructure/npm-package.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Options for downloading an npm package
+ */
+export interface DownloadNpmPackageOptions {
+    /** The npm package name to download */
+    packageName: string;
+    /** The workspace root directory where node_modules will be */
+    workspaceRoot: string;
+    /** Optional logger function for status messages */
+    logger?: (message: string) => void;
+}
+/**
+ * Result of downloading an npm package
+ */
+export interface DownloadNpmPackageResult {
+    /** Full path to the downloaded package in node_modules */
+    packagePath: string;
+    /** The package name that was downloaded */
+    packageName: string;
+}
+/**
+ * Download and install an npm package to workspace node_modules
+ *
+ * This function:
+ * - Runs `npm install {packageName} --save-dev` in the workspace root
+ * - Adds the package to workspace package.json devDependencies
+ * - Returns the path to the installed package in node_modules
+ *
+ * @param options - Download options
+ * @returns The path to the installed package
+ * @throws NpmInstallationError if the download fails
+ *
+ * @example
+ * const result = await downloadNpmPackage({
+ *   packageName: '@launch77-shared/plugin-release',
+ *   workspaceRoot: '/path/to/workspace',
+ *   logger: (msg) => console.log(msg)
+ * })
+ * // result.packagePath: '/path/to/workspace/node_modules/@launch77-shared/plugin-release'
+ */
+export declare function downloadNpmPackage(options: DownloadNpmPackageOptions): Promise<DownloadNpmPackageResult>;
+//# sourceMappingURL=npm-package.d.ts.map

package/dist/infrastructure/npm-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-package.d.ts","sourceRoot":"","sources":["../../src/infrastructure/npm-package.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAA;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAwB9G"}

package/dist/infrastructure/npm-package.js

@@ -0,0 +1,46 @@
+import * as path from 'path';
+import { execa } from 'execa';
+import { NpmInstallationError } from '../modules/plugin/errors/plugin-errors.js';
+/**
+ * Download and install an npm package to workspace node_modules
+ *
+ * This function:
+ * - Runs `npm install {packageName} --save-dev` in the workspace root
+ * - Adds the package to workspace package.json devDependencies
+ * - Returns the path to the installed package in node_modules
+ *
+ * @param options - Download options
+ * @returns The path to the installed package
+ * @throws NpmInstallationError if the download fails
+ *
+ * @example
+ * const result = await downloadNpmPackage({
+ *   packageName: '@launch77-shared/plugin-release',
+ *   workspaceRoot: '/path/to/workspace',
+ *   logger: (msg) => console.log(msg)
+ * })
+ * // result.packagePath: '/path/to/workspace/node_modules/@launch77-shared/plugin-release'
+ */
+export async function downloadNpmPackage(options) {
+    const { packageName, workspaceRoot, logger } = options;
+    if (logger) {
+        logger(`Installing from npm: ${packageName}...`);
+    }
+    try {
+        // Install the npm package to the workspace
+        await execa('npm', ['install', packageName, '--save-dev'], {
+            cwd: workspaceRoot,
+            stdio: 'pipe', // Capture output for clean logging
+        });
+        // Return path to installed package in node_modules
+        const packagePath = path.join(workspaceRoot, 'node_modules', packageName);
+        return {
+            packagePath,
+            packageName,
+        };
+    }
+    catch (error) {
+        throw new NpmInstallationError(packageName, error instanceof Error ? error : undefined);
+    }
+}
+//# sourceMappingURL=npm-package.js.map

package/dist/infrastructure/npm-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-package.js","sourceRoot":"","sources":["../../src/infrastructure/npm-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAwBhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAEtD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,wBAAwB,WAAW,KAAK,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,CAAC;QACH,2CAA2C;QAC3C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;YACzD,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,MAAM,EAAE,mCAAmC;SACnD,CAAC,CAAA;QAEF,mDAAmD;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,CAAC,CAAA;QAEzE,OAAO;YACL,WAAW;YACX,WAAW;SACZ,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,oBAAoB,CAAC,WAAW,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}

package/dist/infrastructure/package-resolver.d.ts

@@ -0,0 +1,117 @@
+import type { ValidationResult } from '@launch77/plugin-runtime';
+/**
+ * Base interface for package resolution results
+ */
+export interface PackageResolution {
+    /** The source of the package */
+    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;
+    /** The version from package.json (required for local packages, undefined for npm until installed) */
+    version?: string;
+}
+/**
+ * Abstract base class for resolving Launch77 packages
+ *
+ * Provides generic resolution logic for finding packages in:
+ * 1. Local workspace directory (e.g., plugins/, app-templates/)
+ * 2. npm packages with configured prefix (e.g., @launch77-shared/plugin-*, @launch77-shared/app-template-*)
+ *
+ * Concrete implementations must provide:
+ * - Folder name for local resolution
+ * - Package prefix for npm resolution
+ * - Verification logic to validate local packages
+ */
+export declare abstract class PackageResolver {
+    /**
+     * Get the local folder name where packages of this type are stored
+     * @example 'plugins' or 'app-templates'
+     */
+    protected abstract getFolderName(): string;
+    /**
+     * Get the npm package prefix for unscoped packages
+     * @example '@launch77-shared/plugin-' or '@launch77-shared/app-template-'
+     */
+    protected abstract getPackagePrefix(): string;
+    /**
+     * Verify that a local package is valid and complete
+     * @param localPath - The local directory path to verify
+     * @returns true if the package is valid, false otherwise
+     */
+    protected abstract verify(localPath: string): Promise<boolean>;
+    /**
+     * Validate package input name
+     *
+     * Accepts:
+     * - Unscoped names (e.g., "release", "my-package")
+     * - Scoped npm packages (e.g., "@ibm/package-name")
+     *
+     * Rejects:
+     * - Invalid formats
+     * - Empty strings
+     * - Names with invalid characters
+     *
+     * @param name - The package name to validate
+     * @returns ValidationResult with isValid and optional error message
+     *
+     * @example
+     * validateInput('release') // { isValid: true }
+     * validateInput('@ibm/analytics') // { isValid: true }
+     * validateInput('@invalid') // { isValid: false, error: '...' }
+     */
+    validateInput(name: string): ValidationResult;
+    /**
+     * Convert an unscoped package name to an npm package name
+     *
+     * Rules:
+     * - Unscoped names: prefix with configured package prefix
+     * - Scoped names: use as-is
+     *
+     * @param name - The package name (must be validated first)
+     * @returns The npm package name
+     *
+     * @example
+     * toNpmPackageName('release') // '@launch77-shared/plugin-release' (for PluginResolver)
+     * toNpmPackageName('@ibm/analytics') // '@ibm/analytics'
+     */
+    toNpmPackageName(name: string): string;
+    /**
+     * Read version from package.json
+     * @param packagePath - The path to the package directory
+     * @returns The version string from package.json
+     * @throws If package.json doesn't exist, can't be read, or is missing the version field
+     */
+    private readVersion;
+    /**
+     * Resolve package location from name
+     *
+     * Resolution order:
+     * 1. Check local workspace directory (configured by getFolderName())
+     * 2. Verify local package is valid (using verify())
+     * 3. Fall back to npm package name (with configured prefix)
+     * 4. Read version from package.json (if available)
+     *
+     * @param name - The package name to resolve
+     * @param workspaceRoot - The workspace root directory
+     * @returns PackageResolution with source, resolved location, and version
+     *
+     * @example
+     * // Local package found
+     * await resolveLocation('my-package', '/workspace')
+     * // { source: 'local', resolvedName: 'my-package', localPath: '/workspace/plugins/my-package', version: '1.0.0' }
+     *
+     * // Not found locally, resolve to npm
+     * await resolveLocation('release', '/workspace')
+     * // { source: 'npm', resolvedName: 'release', npmPackage: '@launch77-shared/plugin-release' }
+     *
+     * // Scoped package always resolves to npm
+     * await resolveLocation('@ibm/analytics', '/workspace')
+     * // { source: 'npm', resolvedName: '@ibm/analytics', npmPackage: '@ibm/analytics' }
+     */
+    resolveLocation(name: string, workspaceRoot: string): Promise<PackageResolution>;
+}
+//# sourceMappingURL=package-resolver.d.ts.map

package/dist/infrastructure/package-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.d.ts","sourceRoot":"","sources":["../../src/infrastructure/package-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,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;IACnB,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,eAAe;IACnC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM;IAE1C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,MAAM;IAE7C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IA8B7C;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYtC;;;;;OAKG;YACW,WAAW;IAkBzB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAyCvF"}

package/dist/infrastructure/package-resolver.js

@@ -0,0 +1,170 @@
+import * as path from 'path';
+import { parsePluginName, isValidNpmPackageName } from '@launch77/plugin-runtime';
+import fs from 'fs-extra';
+/**
+ * Abstract base class for resolving Launch77 packages
+ *
+ * Provides generic resolution logic for finding packages in:
+ * 1. Local workspace directory (e.g., plugins/, app-templates/)
+ * 2. npm packages with configured prefix (e.g., @launch77-shared/plugin-*, @launch77-shared/app-template-*)
+ *
+ * Concrete implementations must provide:
+ * - Folder name for local resolution
+ * - Package prefix for npm resolution
+ * - Verification logic to validate local packages
+ */
+export class PackageResolver {
+    /**
+     * Validate package input name
+     *
+     * Accepts:
+     * - Unscoped names (e.g., "release", "my-package")
+     * - Scoped npm packages (e.g., "@ibm/package-name")
+     *
+     * Rejects:
+     * - Invalid formats
+     * - Empty strings
+     * - Names with invalid characters
+     *
+     * @param name - The package name to validate
+     * @returns ValidationResult with isValid and optional error message
+     *
+     * @example
+     * validateInput('release') // { isValid: true }
+     * validateInput('@ibm/analytics') // { isValid: true }
+     * validateInput('@invalid') // { isValid: false, error: '...' }
+     */
+    validateInput(name) {
+        if (!name || name.trim().length === 0) {
+            return {
+                isValid: false,
+                error: 'Package name cannot be empty',
+            };
+        }
+        const trimmedName = name.trim();
+        // Parse the name to determine type and validate
+        //TODO: move/rename parsePluginName() to parsePackageName()
+        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 package name to an npm package name
+     *
+     * Rules:
+     * - Unscoped names: prefix with configured package prefix
+     * - Scoped names: use as-is
+     *
+     * @param name - The package name (must be validated first)
+     * @returns The npm package name
+     *
+     * @example
+     * toNpmPackageName('release') // '@launch77-shared/plugin-release' (for PluginResolver)
+     * toNpmPackageName('@ibm/analytics') // '@ibm/analytics'
+     */
+    toNpmPackageName(name) {
+        const trimmedName = name.trim();
+        // If already scoped, use as-is
+        if (trimmedName.startsWith('@')) {
+            return trimmedName;
+        }
+        // Otherwise, convert using configured prefix
+        return `${this.getPackagePrefix()}${trimmedName}`;
+    }
+    /**
+     * Read version from package.json
+     * @param packagePath - The path to the package directory
+     * @returns The version string from package.json
+     * @throws If package.json doesn't exist, can't be read, or is missing the version field
+     */
+    async readVersion(packagePath) {
+        const packageJsonPath = path.join(packagePath, 'package.json');
+        try {
+            const packageJson = await fs.readJson(packageJsonPath);
+            if (!packageJson.version) {
+                throw new Error(`Invalid package structure: package.json at ${packagePath} is missing required version field. ` + `All Launch77 packages must include a valid package.json with a version field.`);
+            }
+            return packageJson.version;
+        }
+        catch (error) {
+            // Re-throw our own error messages
+            if (error instanceof Error && error.message.includes('Invalid package structure')) {
+                throw error;
+            }
+            // File not found or invalid JSON
+            throw new Error(`Invalid package structure: package.json not found or invalid at ${packagePath}. ` + `All Launch77 packages must include a valid package.json with a version field.`);
+        }
+    }
+    /**
+     * Resolve package location from name
+     *
+     * Resolution order:
+     * 1. Check local workspace directory (configured by getFolderName())
+     * 2. Verify local package is valid (using verify())
+     * 3. Fall back to npm package name (with configured prefix)
+     * 4. Read version from package.json (if available)
+     *
+     * @param name - The package name to resolve
+     * @param workspaceRoot - The workspace root directory
+     * @returns PackageResolution with source, resolved location, and version
+     *
+     * @example
+     * // Local package found
+     * await resolveLocation('my-package', '/workspace')
+     * // { source: 'local', resolvedName: 'my-package', localPath: '/workspace/plugins/my-package', version: '1.0.0' }
+     *
+     * // Not found locally, resolve to npm
+     * await resolveLocation('release', '/workspace')
+     * // { source: 'npm', resolvedName: 'release', npmPackage: '@launch77-shared/plugin-release' }
+     *
+     * // Scoped package always resolves to npm
+     * await resolveLocation('@ibm/analytics', '/workspace')
+     * // { source: 'npm', resolvedName: '@ibm/analytics', npmPackage: '@ibm/analytics' }
+     */
+    async resolveLocation(name, workspaceRoot) {
+        const trimmedName = name.trim();
+        const parsed = parsePluginName(trimmedName);
+        // If scoped, always use npm (local packages are never scoped)
+        if (parsed.type === 'scoped') {
+            return {
+                source: 'npm',
+                resolvedName: trimmedName,
+                npmPackage: trimmedName,
+            };
+        }
+        // Check local workspace directory
+        const localPath = path.join(workspaceRoot, this.getFolderName(), trimmedName);
+        const localExists = await fs.pathExists(localPath);
+        if (localExists) {
+            // Verify it's a valid package
+            const isValid = await this.verify(localPath);
+            if (isValid) {
+                const version = await this.readVersion(localPath);
+                return {
+                    source: 'local',
+                    resolvedName: trimmedName,
+                    localPath,
+                    version,
+                };
+            }
+        }
+        // Not found locally or invalid, resolve to npm package
+        const npmPackage = this.toNpmPackageName(trimmedName);
+        return {
+            source: 'npm',
+            resolvedName: trimmedName,
+            npmPackage,
+        };
+    }
+}
+//# sourceMappingURL=package-resolver.js.map

package/dist/infrastructure/package-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.js","sourceRoot":"","sources":["../../src/infrastructure/package-resolver.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/package-resolver.test.d.ts

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

package/dist/infrastructure/package-resolver.test.d.ts.map

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