@launch77/cli 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @launch77/cli
 
+## 1.4.1
+
+### Patch Changes
+
+- 535ae04: Moved manifest writing from generatros to CLI
+- Updated dependencies [535ae04]
+  - @launch77/plugin-runtime@0.2.2
+
 ## 1.4.0
 
 ### Minor Changes

package/dist/modules/plugin/services/plugin-svc.d.ts

@@ -1,6 +1,22 @@
 import type { Launch77Context } from '@launch77/plugin-runtime';
 import type { InstallPluginRequest, InstallPluginResult } from '../types/plugin-types.js';
 export declare class PluginService {
+    /**
+     * Validate that we're in a valid package directory and return the target type
+     */
+    private validateContext;
+    /**
+     * Validate plugin name, resolve its location, and download if needed
+     */
+    private validateAndResolvePlugin;
+    /**
+     * Read plugin metadata and validate it supports the current target
+     */
+    private validatePluginTargets;
+    /**
+     * Check if plugin is already installed and return early-exit result if so
+     */
+    private checkExistingInstallation;
     /**
      * Install a plugin to the current package
      */
@@ -11,5 +27,10 @@ export declare class PluginService {
     private downloadNpmPlugin;
     private getPackagePath;
     private runGenerator;
+    private isPluginInstalled;
+    /**
+     * Write plugin installation metadata to the target package's package.json
+     */
+    private writePluginManifest;
 }
 //# sourceMappingURL=plugin-svc.d.ts.map

package/dist/modules/plugin/services/plugin-svc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-svc.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/services/plugin-svc.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAA;AACrF,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAoBzF,qBAAa,aAAa;IACxB;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8D3J;;OAEG;YACW,iBAAiB;IAkB/B,OAAO,CAAC,cAAc;YAgBR,YAAY;CAY3B"}
+{"version":3,"file":"plugin-svc.d.ts","sourceRoot":"","sources":["../../../../src/modules/plugin/services/plugin-svc.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAA0F,MAAM,0BAA0B,CAAA;AACvJ,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAoBzF,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;YACW,wBAAwB;IAkCtC;;OAEG;YACW,qBAAqB;IAcnC;;OAEG;YACW,yBAAyB;IAmBvC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6B3J;;OAEG;YACW,iBAAiB;IAkB/B,OAAO,CAAC,cAAc;YAgBR,YAAY;YAeZ,iBAAiB;IAmB/B;;OAEG;YACW,mBAAmB;CA4BlC"}

package/dist/modules/plugin/services/plugin-svc.js

@@ -1,4 +1,5 @@
 import * as path from 'path';
+import * as fs from 'fs/promises';
 import chalk from 'chalk';
 import { execa } from 'execa';
 import { readPluginMetadata } from '@launch77/plugin-runtime';
@@ -23,17 +24,20 @@ function locationTypeToTarget(locationType) {
 }
 export class PluginService {
     /**
-     * Install a plugin to the current package
+     * Validate that we're in a valid package directory and return the target type
      */
-    async installPlugin(request, context, logger = console.log) {
-        const { pluginName } = request;
-        // Must be in a package directory (app, library, plugin, or app-template)
+    validateContext(context) {
         const currentTarget = locationTypeToTarget(context.locationType);
         if (!currentTarget)
             throw createInvalidContextError(context.locationType);
         if (!context.appName)
             throw new InvalidPluginContextError('Could not determine package name. This is a bug. Please report it.');
-        // Step 1: Validate plugin input
+        return currentTarget;
+    }
+    /**
+     * Validate plugin name, resolve its location, and download if needed
+     */
+    async validateAndResolvePlugin(pluginName, workspaceRoot, logger) {
         logger(chalk.blue(`\n🔍 Resolving plugin "${pluginName}"...`));
         logger(`  ├─ Validating plugin name...`);
         const validation = validatePluginInput(pluginName);
@@ -41,9 +45,8 @@ export class PluginService {
             throw new PluginResolutionError(pluginName, validation.error || 'Invalid plugin name');
         }
         logger(`  │  └─ ${chalk.green('✓')} Valid plugin name`);
-        // Step 2: Resolve plugin location
         logger(`  ├─ Checking local workspace: ${chalk.dim(`plugins/${pluginName}`)}`);
-        const resolution = await resolvePluginLocation(pluginName, context.workspaceRoot);
+        const resolution = await resolvePluginLocation(pluginName, workspaceRoot);
         let pluginPath;
         if (resolution.source === 'local') {
             logger(`  │  └─ ${chalk.green('✓')} Found local plugin`);
@@ -52,11 +55,19 @@ export class PluginService {
         else {
             logger(`  │  └─ ${chalk.dim('Not found locally')}`);
             logger(`  ├─ Resolving to npm package: ${chalk.cyan(resolution.npmPackage)}`);
-            // Download npm plugin
-            pluginPath = await this.downloadNpmPlugin(resolution.npmPackage, context.workspaceRoot, logger);
+            pluginPath = await this.downloadNpmPlugin(resolution.npmPackage, workspaceRoot, logger);
         }
         logger(`  └─ ${chalk.green('✓')} Plugin resolved\n`);
-        // Step 3: Read plugin metadata and validate targets
+        return {
+            pluginPath,
+            source: resolution.source,
+            npmPackage: resolution.npmPackage,
+        };
+    }
+    /**
+     * Read plugin metadata and validate it supports the current target
+     */
+    async validatePluginTargets(pluginPath, pluginName, currentTarget) {
         const metadata = await readPluginMetadata(pluginPath);
         if (!metadata.targets || metadata.targets.length === 0) {
             throw new MissingPluginTargetsError(pluginName);
@@ -64,10 +75,49 @@ export class PluginService {
         if (!metadata.targets.includes(currentTarget)) {
             throw createInvalidTargetError(pluginName, currentTarget, metadata.targets);
         }
-        // Step 4: Get package directory path
+        return metadata;
+    }
+    /**
+     * Check if plugin is already installed and return early-exit result if so
+     */
+    async checkExistingInstallation(pluginName, packagePath, logger) {
+        const existingInstallation = await this.isPluginInstalled(pluginName, packagePath);
+        if (existingInstallation) {
+            logger(chalk.yellow(`\nℹ️  Plugin '${pluginName}' is already installed in this package.\n`));
+            logger(`Package: ${chalk.cyan(existingInstallation.package)} (${existingInstallation.source})`);
+            logger(`Version: ${existingInstallation.version}`);
+            logger(`Installed: ${existingInstallation.installedAt}\n`);
+            logger(chalk.gray('To reinstall: Remove from package.json launch77.installedPlugins'));
+            logger(chalk.gray('(plugin:remove command coming soon)\n'));
+            return {
+                pluginName,
+                filesInstalled: false,
+                packageJsonUpdated: false,
+                dependenciesInstalled: false,
+            };
+        }
+        return null;
+    }
+    /**
+     * Install a plugin to the current package
+     */
+    async installPlugin(request, context, logger = console.log) {
+        const { pluginName } = request;
+        const currentTarget = this.validateContext(context);
+        const { pluginPath, source, npmPackage } = await this.validateAndResolvePlugin(pluginName, context.workspaceRoot, logger);
+        const metadata = await this.validatePluginTargets(pluginPath, pluginName, currentTarget);
         const packagePath = this.getPackagePath(context);
-        // Step 5: Run generator
+        const earlyExit = await this.checkExistingInstallation(pluginName, packagePath, logger);
+        if (earlyExit)
+            return earlyExit;
         await this.runGenerator(pluginPath, packagePath, context);
+        const packageName = source === 'npm' ? npmPackage : pluginName;
+        await this.writePluginManifest(packagePath, {
+            pluginName,
+            packageName,
+            version: metadata.version,
+            source,
+        });
         return {
             pluginName,
             filesInstalled: true,
@@ -112,7 +162,8 @@ export class PluginService {
     async runGenerator(pluginPath, appPath, context) {
         try {
             const generatorPath = path.join(pluginPath, 'dist/generator.js');
-            await execa('node', [generatorPath, `--appPath=${appPath}`, `--appName=${context.appName}`, `--workspaceName=${context.workspaceName}`, `--pluginPath=${pluginPath}`], {
+            const args = [generatorPath, `--appPath=${appPath}`, `--appName=${context.appName}`, `--workspaceName=${context.workspaceName}`, `--pluginPath=${pluginPath}`];
+            await execa('node', args, {
                 cwd: pluginPath,
                 stdio: 'inherit',
             });
@@ -121,5 +172,48 @@ export class PluginService {
             throw new PluginInstallationError(`Generator failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
         }
     }
+    async isPluginInstalled(pluginName, packagePath) {
+        try {
+            const packageJsonPath = path.join(packagePath, 'package.json');
+            const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8');
+            const packageJson = JSON.parse(packageJsonContent);
+            const manifest = packageJson.launch77;
+            if (manifest?.installedPlugins?.[pluginName]) {
+                return manifest.installedPlugins[pluginName];
+            }
+            return null;
+        }
+        catch (error) {
+            // If package.json doesn't exist or can't be read, assume not installed
+            return null;
+        }
+    }
+    /**
+     * Write plugin installation metadata to the target package's package.json
+     */
+    async writePluginManifest(packagePath, installationInfo) {
+        try {
+            const packageJsonPath = path.join(packagePath, 'package.json');
+            const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8');
+            const packageJson = JSON.parse(packageJsonContent);
+            if (!packageJson.launch77) {
+                packageJson.launch77 = {};
+            }
+            if (!packageJson.launch77.installedPlugins) {
+                packageJson.launch77.installedPlugins = {};
+            }
+            const manifest = packageJson.launch77;
+            manifest.installedPlugins[installationInfo.pluginName] = {
+                package: installationInfo.packageName,
+                version: installationInfo.version,
+                installedAt: new Date().toISOString(),
+                source: installationInfo.source,
+            };
+            await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf-8');
+        }
+        catch (error) {
+            throw new PluginInstallationError(`Failed to write plugin manifest: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+        }
+    }
 }
 //# sourceMappingURL=plugin-svc.js.map

package/dist/modules/plugin/services/plugin-svc.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-svc.js","sourceRoot":"","sources":["../../../../src/modules/plugin/services/plugin-svc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-svc.js","sourceRoot":"","sources":["../../../../src/modules/plugin/services/plugin-svc.ts"],"names":[],"mappings":"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"}

package/dist/modules/plugin/services/plugin-svc.test.d.ts

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

package/dist/modules/plugin/services/plugin-svc.test.d.ts.map

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

package/dist/modules/plugin/services/plugin-svc.test.js

@@ -0,0 +1,362 @@
+import { describe, test, expect, beforeEach, afterEach } from 'vitest';
+import * as path from 'path';
+import * as os from 'os';
+import fs from 'fs-extra';
+import { PluginService } from './plugin-svc.js';
+describe('PluginService', () => {
+    let tempDir;
+    let service;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'plugin-svc-test-'));
+        service = new PluginService();
+    });
+    afterEach(async () => {
+        await fs.remove(tempDir);
+    });
+    describe('validateContext', () => {
+        // Valid contexts - test return values
+        test('should return "app" for workspace-app location', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-app',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-app',
+                appName: 'test-app',
+            };
+            const result = service.validateContext(context);
+            expect(result).toBe('app');
+        });
+        test('should return "library" for workspace-library location', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-library',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-library',
+                appName: 'test-library',
+            };
+            const result = service.validateContext(context);
+            expect(result).toBe('library');
+        });
+        test('should return "plugin" for workspace-plugin location', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-plugin',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-plugin',
+                appName: 'test-plugin',
+            };
+            const result = service.validateContext(context);
+            expect(result).toBe('plugin');
+        });
+        test('should return "app-template" for workspace-app-template location', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-app-template',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-template',
+                appName: 'test-template',
+            };
+            const result = service.validateContext(context);
+            expect(result).toBe('app-template');
+        });
+        // Invalid contexts - test exact error messages
+        test('should throw InvalidPluginContextError for workspace-root', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-root',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'workspace',
+                appName: undefined,
+            };
+            expect(() => service.validateContext(context)).toThrow('plugin:install must be run from within a package directory.');
+        });
+        test('should throw InvalidPluginContextError for non-workspace', () => {
+            const context = {
+                isValid: false,
+                locationType: 'non-workspace',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'unknown',
+                appName: undefined,
+            };
+            expect(() => service.validateContext(context)).toThrow('plugin:install must be run from within a package directory.');
+        });
+        test('should throw InvalidPluginContextError when appName is missing', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-app',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-app',
+                appName: undefined,
+            };
+            expect(() => service.validateContext(context)).toThrow('Could not determine package name. This is a bug. Please report it.');
+        });
+        test('should throw InvalidPluginContextError when appName is empty string', () => {
+            const context = {
+                isValid: true,
+                locationType: 'workspace-app',
+                workspaceRoot: tempDir,
+                workspaceName: 'test-workspace',
+                workspaceVersion: '1.0.0',
+                appsDir: path.join(tempDir, 'apps'),
+                packageName: 'test-app',
+                appName: '',
+            };
+            expect(() => service.validateContext(context)).toThrow('Could not determine package name. This is a bug. Please report it.');
+        });
+    });
+    describe('validatePluginTargets', () => {
+        // Valid scenarios - verify metadata returned
+        test('should return metadata when plugin targets current package type', async () => {
+            const pluginDir = path.join(tempDir, 'test-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'test-plugin',
+                version: '1.0.0',
+                targets: ['app', 'library'],
+            });
+            const result = await service.validatePluginTargets(pluginDir, 'test-plugin', 'app');
+            expect(result).toEqual({
+                name: 'test-plugin',
+                version: '1.0.0',
+                targets: ['app', 'library'],
+            });
+        });
+        test('should accept plugin with multiple targets including current', async () => {
+            const pluginDir = path.join(tempDir, 'multi-target-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'multi-target-plugin',
+                version: '2.0.0',
+                targets: ['app', 'library', 'plugin', 'app-template'],
+            });
+            const result = await service.validatePluginTargets(pluginDir, 'multi-target-plugin', 'library');
+            expect(result.targets).toContain('library');
+            expect(result.targets).toHaveLength(4);
+        });
+        test('should handle plugin.json with optional fields (pluginDependencies, libraryDependencies)', async () => {
+            const pluginDir = path.join(tempDir, 'full-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'full-plugin',
+                version: '1.5.0',
+                targets: ['app'],
+                pluginDependencies: { 'other-plugin': '^1.0.0' },
+                libraryDependencies: { react: '^18.0.0' },
+            });
+            const result = await service.validatePluginTargets(pluginDir, 'full-plugin', 'app');
+            expect(result.pluginDependencies).toEqual({ 'other-plugin': '^1.0.0' });
+            expect(result.libraryDependencies).toEqual({ react: '^18.0.0' });
+        });
+        // Error scenarios - test exact error messages
+        test('should throw MissingPluginTargetsError when targets is undefined', async () => {
+            const pluginDir = path.join(tempDir, 'no-targets-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'no-targets-plugin',
+                version: '1.0.0',
+            });
+            await expect(service.validatePluginTargets(pluginDir, 'no-targets-plugin', 'app')).rejects.toThrow("Plugin 'no-targets-plugin' is missing the required 'targets' field in plugin.json.");
+        });
+        test('should throw MissingPluginTargetsError when targets is empty array', async () => {
+            const pluginDir = path.join(tempDir, 'empty-targets-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'empty-targets-plugin',
+                version: '1.0.0',
+                targets: [],
+            });
+            await expect(service.validatePluginTargets(pluginDir, 'empty-targets-plugin', 'app')).rejects.toThrow("Plugin 'empty-targets-plugin' is missing the required 'targets' field in plugin.json.");
+        });
+        test('should throw error when targets does not include current target', async () => {
+            const pluginDir = path.join(tempDir, 'incompatible-plugin');
+            await fs.ensureDir(pluginDir);
+            await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+                name: 'incompatible-plugin',
+                version: '1.0.0',
+                targets: ['library', 'plugin'],
+            });
+            await expect(service.validatePluginTargets(pluginDir, 'incompatible-plugin', 'app')).rejects.toThrow("Plugin 'incompatible-plugin' cannot be installed in a 'app' package.");
+        });
+        test('should handle missing plugin.json file gracefully', async () => {
+            const pluginDir = path.join(tempDir, 'no-plugin-json');
+            await fs.ensureDir(pluginDir);
+            await expect(service.validatePluginTargets(pluginDir, 'no-plugin-json', 'app')).rejects.toThrow();
+        });
+    });
+    describe('checkExistingInstallation', () => {
+        const mockLogger = (message) => {
+            /* capture logs */
+        };
+        // Not installed - return null
+        test('should return null when plugin is not installed', async () => {
+            const packageDir = path.join(tempDir, 'app1');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app1',
+                version: '1.0.0',
+                launch77: {
+                    installedPlugins: {},
+                },
+            });
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        test('should return null when package.json does not exist', async () => {
+            const packageDir = path.join(tempDir, 'nonexistent');
+            await fs.ensureDir(packageDir);
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        test('should return null when launch77 field is missing', async () => {
+            const packageDir = path.join(tempDir, 'app2');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app2',
+                version: '1.0.0',
+            });
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        test('should return null when installedPlugins is missing', async () => {
+            const packageDir = path.join(tempDir, 'app3');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app3',
+                version: '1.0.0',
+                launch77: {},
+            });
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        test('should return null when installedPlugins exists but plugin not in it', async () => {
+            const packageDir = path.join(tempDir, 'app4');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app4',
+                version: '1.0.0',
+                launch77: {
+                    installedPlugins: {
+                        'other-plugin': {
+                            package: 'other-plugin',
+                            version: '1.0.0',
+                            installedAt: '2024-01-01T00:00:00.000Z',
+                            source: 'local',
+                        },
+                    },
+                },
+            });
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        // Already installed - return result object
+        test('should return early-exit result with correct structure when plugin is installed', async () => {
+            const packageDir = path.join(tempDir, 'app5');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app5',
+                version: '1.0.0',
+                launch77: {
+                    installedPlugins: {
+                        'test-plugin': {
+                            package: 'test-plugin',
+                            version: '1.5.0',
+                            installedAt: '2024-01-15T10:30:00.000Z',
+                            source: 'local',
+                        },
+                    },
+                },
+            });
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toEqual({
+                pluginName: 'test-plugin',
+                filesInstalled: false,
+                packageJsonUpdated: false,
+                dependenciesInstalled: false,
+            });
+        });
+        test('should log correct message for local plugin (package name matches plugin name)', async () => {
+            const packageDir = path.join(tempDir, 'app6');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app6',
+                version: '1.0.0',
+                launch77: {
+                    installedPlugins: {
+                        release: {
+                            package: 'release',
+                            version: '2.0.0',
+                            installedAt: '2024-02-01T12:00:00.000Z',
+                            source: 'local',
+                        },
+                    },
+                },
+            });
+            const logs = [];
+            const captureLogger = (message) => logs.push(message);
+            const result = await service.checkExistingInstallation('release', packageDir, captureLogger);
+            expect(result).not.toBeNull();
+            expect(logs.some((log) => log.includes("Plugin 'release' is already installed"))).toBe(true);
+            expect(logs.some((log) => log.includes('release') && log.includes('local'))).toBe(true);
+        });
+        test('should log correct message for npm plugin (package name is scoped)', async () => {
+            const packageDir = path.join(tempDir, 'app7');
+            await fs.ensureDir(packageDir);
+            await fs.writeJson(path.join(packageDir, 'package.json'), {
+                name: 'app7',
+                version: '1.0.0',
+                launch77: {
+                    installedPlugins: {
+                        analytics: {
+                            package: '@myorg/analytics-plugin',
+                            version: '3.1.0',
+                            installedAt: '2024-03-01T15:45:00.000Z',
+                            source: 'npm',
+                        },
+                    },
+                },
+            });
+            const logs = [];
+            const captureLogger = (message) => logs.push(message);
+            const result = await service.checkExistingInstallation('analytics', packageDir, captureLogger);
+            expect(result).not.toBeNull();
+            expect(logs.some((log) => log.includes("Plugin 'analytics' is already installed"))).toBe(true);
+            expect(logs.some((log) => log.includes('@myorg/analytics-plugin') && log.includes('npm'))).toBe(true);
+        });
+        // Edge cases
+        test('should handle malformed package.json gracefully (invalid JSON)', async () => {
+            const packageDir = path.join(tempDir, 'app8');
+            await fs.ensureDir(packageDir);
+            await fs.writeFile(path.join(packageDir, 'package.json'), '{ invalid json }');
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+        test('should handle package.json read errors (permissions, etc.)', async () => {
+            const packageDir = path.join(tempDir, 'app9');
+            // Don't create the directory - simulate permission/access error
+            const result = await service.checkExistingInstallation('test-plugin', packageDir, mockLogger);
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=plugin-svc.test.js.map

package/dist/modules/plugin/services/plugin-svc.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-svc.test.js","sourceRoot":"","sources":["../../../../src/modules/plugin/services/plugin-svc.test.ts"],"names":[],"mappings":"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"}

package/dist/templates/workspace/package.json

@@ -19,7 +19,8 @@
     "changeset": "changeset",
     "version-packages": "changeset version",
     "release": "turbo run build lint typecheck test && changeset publish",
-    "prepare": "husky"
+    "prepare": "husky",
+    "clean": "rm -rf node_modules apps/*/node_modules libraries/*/node_modules plugins/*/node_modules app-templates/*/node_modules package-lock.json apps/*/package-lock.json libraries/*/package-lock.json plugins/*/package-lock.json app-templates/*/package-lock.json dist apps/*/dist libraries/*/dist plugins/*/dist app-templates/*/dist .next apps/*/.next .turbo apps/*/.turbo libraries/*/.turbo plugins/*/.turbo app-templates/*/.turbo build apps/*/build out apps/*/out coverage apps/*/coverage .cache *.log .eslintcache"
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@launch77/cli",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Launch77 Platform CLI",
   "license": "UNLICENSED",
   "type": "module",

package/src/modules/plugin/services/plugin-svc.test.ts

@@ -0,0 +1,418 @@
+import { describe, test, expect, beforeEach, afterEach } from 'vitest'
+import * as path from 'path'
+import * as os from 'os'
+import fs from 'fs-extra'
+import { PluginService } from './plugin-svc.js'
+import type { Launch77Context } from '@launch77/plugin-runtime'
+
+describe('PluginService', () => {
+  let tempDir: string
+  let service: PluginService
+
+  beforeEach(async () => {
+    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'plugin-svc-test-'))
+    service = new PluginService()
+  })
+
+  afterEach(async () => {
+    await fs.remove(tempDir)
+  })
+
+  describe('validateContext', () => {
+    // Valid contexts - test return values
+    test('should return "app" for workspace-app location', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-app',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-app',
+        appName: 'test-app',
+      }
+
+      const result = (service as any).validateContext(context)
+      expect(result).toBe('app')
+    })
+
+    test('should return "library" for workspace-library location', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-library',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-library',
+        appName: 'test-library',
+      }
+
+      const result = (service as any).validateContext(context)
+      expect(result).toBe('library')
+    })
+
+    test('should return "plugin" for workspace-plugin location', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-plugin',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-plugin',
+        appName: 'test-plugin',
+      }
+
+      const result = (service as any).validateContext(context)
+      expect(result).toBe('plugin')
+    })
+
+    test('should return "app-template" for workspace-app-template location', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-app-template',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-template',
+        appName: 'test-template',
+      }
+
+      const result = (service as any).validateContext(context)
+      expect(result).toBe('app-template')
+    })
+
+    // Invalid contexts - test exact error messages
+    test('should throw InvalidPluginContextError for workspace-root', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-root',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'workspace',
+        appName: undefined,
+      }
+
+      expect(() => (service as any).validateContext(context)).toThrow('plugin:install must be run from within a package directory.')
+    })
+
+    test('should throw InvalidPluginContextError for non-workspace', () => {
+      const context = {
+        isValid: false,
+        locationType: 'non-workspace' as const,
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'unknown',
+        appName: undefined,
+      }
+
+      expect(() => (service as any).validateContext(context)).toThrow('plugin:install must be run from within a package directory.')
+    })
+
+    test('should throw InvalidPluginContextError when appName is missing', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-app',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-app',
+        appName: undefined,
+      }
+
+      expect(() => (service as any).validateContext(context)).toThrow('Could not determine package name. This is a bug. Please report it.')
+    })
+
+    test('should throw InvalidPluginContextError when appName is empty string', () => {
+      const context: Launch77Context = {
+        isValid: true,
+        locationType: 'workspace-app',
+        workspaceRoot: tempDir,
+        workspaceName: 'test-workspace',
+        workspaceVersion: '1.0.0',
+        appsDir: path.join(tempDir, 'apps'),
+        packageName: 'test-app',
+        appName: '',
+      }
+
+      expect(() => (service as any).validateContext(context)).toThrow('Could not determine package name. This is a bug. Please report it.')
+    })
+  })
+
+  describe('validatePluginTargets', () => {
+    // Valid scenarios - verify metadata returned
+    test('should return metadata when plugin targets current package type', async () => {
+      const pluginDir = path.join(tempDir, 'test-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'test-plugin',
+        version: '1.0.0',
+        targets: ['app', 'library'],
+      })
+
+      const result = await (service as any).validatePluginTargets(pluginDir, 'test-plugin', 'app')
+      expect(result).toEqual({
+        name: 'test-plugin',
+        version: '1.0.0',
+        targets: ['app', 'library'],
+      })
+    })
+
+    test('should accept plugin with multiple targets including current', async () => {
+      const pluginDir = path.join(tempDir, 'multi-target-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'multi-target-plugin',
+        version: '2.0.0',
+        targets: ['app', 'library', 'plugin', 'app-template'],
+      })
+
+      const result = await (service as any).validatePluginTargets(pluginDir, 'multi-target-plugin', 'library')
+      expect(result.targets).toContain('library')
+      expect(result.targets).toHaveLength(4)
+    })
+
+    test('should handle plugin.json with optional fields (pluginDependencies, libraryDependencies)', async () => {
+      const pluginDir = path.join(tempDir, 'full-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'full-plugin',
+        version: '1.5.0',
+        targets: ['app'],
+        pluginDependencies: { 'other-plugin': '^1.0.0' },
+        libraryDependencies: { react: '^18.0.0' },
+      })
+
+      const result = await (service as any).validatePluginTargets(pluginDir, 'full-plugin', 'app')
+      expect(result.pluginDependencies).toEqual({ 'other-plugin': '^1.0.0' })
+      expect(result.libraryDependencies).toEqual({ react: '^18.0.0' })
+    })
+
+    // Error scenarios - test exact error messages
+    test('should throw MissingPluginTargetsError when targets is undefined', async () => {
+      const pluginDir = path.join(tempDir, 'no-targets-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'no-targets-plugin',
+        version: '1.0.0',
+      })
+
+      await expect((service as any).validatePluginTargets(pluginDir, 'no-targets-plugin', 'app')).rejects.toThrow("Plugin 'no-targets-plugin' is missing the required 'targets' field in plugin.json.")
+    })
+
+    test('should throw MissingPluginTargetsError when targets is empty array', async () => {
+      const pluginDir = path.join(tempDir, 'empty-targets-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'empty-targets-plugin',
+        version: '1.0.0',
+        targets: [],
+      })
+
+      await expect((service as any).validatePluginTargets(pluginDir, 'empty-targets-plugin', 'app')).rejects.toThrow("Plugin 'empty-targets-plugin' is missing the required 'targets' field in plugin.json.")
+    })
+
+    test('should throw error when targets does not include current target', async () => {
+      const pluginDir = path.join(tempDir, 'incompatible-plugin')
+      await fs.ensureDir(pluginDir)
+      await fs.writeJson(path.join(pluginDir, 'plugin.json'), {
+        name: 'incompatible-plugin',
+        version: '1.0.0',
+        targets: ['library', 'plugin'],
+      })
+
+      await expect((service as any).validatePluginTargets(pluginDir, 'incompatible-plugin', 'app')).rejects.toThrow("Plugin 'incompatible-plugin' cannot be installed in a 'app' package.")
+    })
+
+    test('should handle missing plugin.json file gracefully', async () => {
+      const pluginDir = path.join(tempDir, 'no-plugin-json')
+      await fs.ensureDir(pluginDir)
+
+      await expect((service as any).validatePluginTargets(pluginDir, 'no-plugin-json', 'app')).rejects.toThrow()
+    })
+  })
+
+  describe('checkExistingInstallation', () => {
+    const mockLogger = (message: string) => {
+      /* capture logs */
+    }
+
+    // Not installed - return null
+    test('should return null when plugin is not installed', async () => {
+      const packageDir = path.join(tempDir, 'app1')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app1',
+        version: '1.0.0',
+        launch77: {
+          installedPlugins: {},
+        },
+      })
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    test('should return null when package.json does not exist', async () => {
+      const packageDir = path.join(tempDir, 'nonexistent')
+      await fs.ensureDir(packageDir)
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    test('should return null when launch77 field is missing', async () => {
+      const packageDir = path.join(tempDir, 'app2')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app2',
+        version: '1.0.0',
+      })
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    test('should return null when installedPlugins is missing', async () => {
+      const packageDir = path.join(tempDir, 'app3')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app3',
+        version: '1.0.0',
+        launch77: {},
+      })
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    test('should return null when installedPlugins exists but plugin not in it', async () => {
+      const packageDir = path.join(tempDir, 'app4')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app4',
+        version: '1.0.0',
+        launch77: {
+          installedPlugins: {
+            'other-plugin': {
+              package: 'other-plugin',
+              version: '1.0.0',
+              installedAt: '2024-01-01T00:00:00.000Z',
+              source: 'local',
+            },
+          },
+        },
+      })
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    // Already installed - return result object
+    test('should return early-exit result with correct structure when plugin is installed', async () => {
+      const packageDir = path.join(tempDir, 'app5')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app5',
+        version: '1.0.0',
+        launch77: {
+          installedPlugins: {
+            'test-plugin': {
+              package: 'test-plugin',
+              version: '1.5.0',
+              installedAt: '2024-01-15T10:30:00.000Z',
+              source: 'local',
+            },
+          },
+        },
+      })
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toEqual({
+        pluginName: 'test-plugin',
+        filesInstalled: false,
+        packageJsonUpdated: false,
+        dependenciesInstalled: false,
+      })
+    })
+
+    test('should log correct message for local plugin (package name matches plugin name)', async () => {
+      const packageDir = path.join(tempDir, 'app6')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app6',
+        version: '1.0.0',
+        launch77: {
+          installedPlugins: {
+            release: {
+              package: 'release',
+              version: '2.0.0',
+              installedAt: '2024-02-01T12:00:00.000Z',
+              source: 'local',
+            },
+          },
+        },
+      })
+
+      const logs: string[] = []
+      const captureLogger = (message: string) => logs.push(message)
+
+      const result = await (service as any).checkExistingInstallation('release', packageDir, captureLogger)
+      expect(result).not.toBeNull()
+      expect(logs.some((log) => log.includes("Plugin 'release' is already installed"))).toBe(true)
+      expect(logs.some((log) => log.includes('release') && log.includes('local'))).toBe(true)
+    })
+
+    test('should log correct message for npm plugin (package name is scoped)', async () => {
+      const packageDir = path.join(tempDir, 'app7')
+      await fs.ensureDir(packageDir)
+      await fs.writeJson(path.join(packageDir, 'package.json'), {
+        name: 'app7',
+        version: '1.0.0',
+        launch77: {
+          installedPlugins: {
+            analytics: {
+              package: '@myorg/analytics-plugin',
+              version: '3.1.0',
+              installedAt: '2024-03-01T15:45:00.000Z',
+              source: 'npm',
+            },
+          },
+        },
+      })
+
+      const logs: string[] = []
+      const captureLogger = (message: string) => logs.push(message)
+
+      const result = await (service as any).checkExistingInstallation('analytics', packageDir, captureLogger)
+      expect(result).not.toBeNull()
+      expect(logs.some((log) => log.includes("Plugin 'analytics' is already installed"))).toBe(true)
+      expect(logs.some((log) => log.includes('@myorg/analytics-plugin') && log.includes('npm'))).toBe(true)
+    })
+
+    // Edge cases
+    test('should handle malformed package.json gracefully (invalid JSON)', async () => {
+      const packageDir = path.join(tempDir, 'app8')
+      await fs.ensureDir(packageDir)
+      await fs.writeFile(path.join(packageDir, 'package.json'), '{ invalid json }')
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+
+    test('should handle package.json read errors (permissions, etc.)', async () => {
+      const packageDir = path.join(tempDir, 'app9')
+      // Don't create the directory - simulate permission/access error
+
+      const result = await (service as any).checkExistingInstallation('test-plugin', packageDir, mockLogger)
+      expect(result).toBeNull()
+    })
+  })
+})

package/src/modules/plugin/services/plugin-svc.ts

@@ -1,4 +1,5 @@
 import * as path from 'path'
+import * as fs from 'fs/promises'
 
 import chalk from 'chalk'
 import { execa } from 'execa'
@@ -7,7 +8,7 @@ import { readPluginMetadata } from '@launch77/plugin-runtime'
 import { PluginInstallationError, InvalidPluginContextError, createInvalidContextError, MissingPluginTargetsError, createInvalidTargetError, NpmInstallationError, PluginResolutionError } from '../errors/plugin-errors.js'
 import { validatePluginInput, resolvePluginLocation } from '../lib/plugin-resolver.js'
 
-import type { Launch77Context, Launch77LocationType } from '@launch77/plugin-runtime'
+import type { Launch77Context, Launch77LocationType, Launch77PackageManifest, InstalledPluginMetadata, PluginMetadata } from '@launch77/plugin-runtime'
 import type { InstallPluginRequest, InstallPluginResult } from '../types/plugin-types.js'
 
 /**
@@ -30,17 +31,19 @@ function locationTypeToTarget(locationType: Launch77LocationType): string | null
 
 export class PluginService {
   /**
-   * Install a plugin to the current package
+   * Validate that we're in a valid package directory and return the target type
    */
-  async installPlugin(request: InstallPluginRequest, context: Launch77Context, logger: (message: string) => void = console.log): Promise<InstallPluginResult> {
-    const { pluginName } = request
-
-    // Must be in a package directory (app, library, plugin, or app-template)
+  private validateContext(context: Launch77Context): string {
     const currentTarget = locationTypeToTarget(context.locationType)
     if (!currentTarget) throw createInvalidContextError(context.locationType)
     if (!context.appName) throw new InvalidPluginContextError('Could not determine package name. This is a bug. Please report it.')
+    return currentTarget
+  }
 
-    // Step 1: Validate plugin input
+  /**
+   * Validate plugin name, resolve its location, and download if needed
+   */
+  private async validateAndResolvePlugin(pluginName: string, workspaceRoot: string, logger: (message: string) => void): Promise<{ pluginPath: string; source: 'local' | 'npm'; npmPackage?: string }> {
     logger(chalk.blue(`\n🔍 Resolving plugin "${pluginName}"...`))
     logger(`  ├─ Validating plugin name...`)
 
@@ -50,9 +53,8 @@ export class PluginService {
     }
     logger(`  │  └─ ${chalk.green('✓')} Valid plugin name`)
 
-    // Step 2: Resolve plugin location
     logger(`  ├─ Checking local workspace: ${chalk.dim(`plugins/${pluginName}`)}`)
-    const resolution = await resolvePluginLocation(pluginName, context.workspaceRoot)
+    const resolution = await resolvePluginLocation(pluginName, workspaceRoot)
 
     let pluginPath: string
 
@@ -63,13 +65,22 @@ export class PluginService {
       logger(`  │  └─ ${chalk.dim('Not found locally')}`)
       logger(`  ├─ Resolving to npm package: ${chalk.cyan(resolution.npmPackage)}`)
 
-      // Download npm plugin
-      pluginPath = await this.downloadNpmPlugin(resolution.npmPackage!, context.workspaceRoot, logger)
+      pluginPath = await this.downloadNpmPlugin(resolution.npmPackage!, workspaceRoot, logger)
     }
 
     logger(`  └─ ${chalk.green('✓')} Plugin resolved\n`)
 
-    // Step 3: Read plugin metadata and validate targets
+    return {
+      pluginPath,
+      source: resolution.source,
+      npmPackage: resolution.npmPackage,
+    }
+  }
+
+  /**
+   * Read plugin metadata and validate it supports the current target
+   */
+  private async validatePluginTargets(pluginPath: string, pluginName: string, currentTarget: string): Promise<PluginMetadata> {
     const metadata = await readPluginMetadata(pluginPath)
 
     if (!metadata.targets || metadata.targets.length === 0) {
@@ -80,12 +91,55 @@ export class PluginService {
       throw createInvalidTargetError(pluginName, currentTarget, metadata.targets)
     }
 
-    // Step 4: Get package directory path
+    return metadata
+  }
+
+  /**
+   * Check if plugin is already installed and return early-exit result if so
+   */
+  private async checkExistingInstallation(pluginName: string, packagePath: string, logger: (message: string) => void): Promise<InstallPluginResult | null> {
+    const existingInstallation = await this.isPluginInstalled(pluginName, packagePath)
+    if (existingInstallation) {
+      logger(chalk.yellow(`\nℹ️  Plugin '${pluginName}' is already installed in this package.\n`))
+      logger(`Package: ${chalk.cyan(existingInstallation.package)} (${existingInstallation.source})`)
+      logger(`Version: ${existingInstallation.version}`)
+      logger(`Installed: ${existingInstallation.installedAt}\n`)
+      logger(chalk.gray('To reinstall: Remove from package.json launch77.installedPlugins'))
+      logger(chalk.gray('(plugin:remove command coming soon)\n'))
+      return {
+        pluginName,
+        filesInstalled: false,
+        packageJsonUpdated: false,
+        dependenciesInstalled: false,
+      }
+    }
+    return null
+  }
+
+  /**
+   * Install a plugin to the current package
+   */
+  async installPlugin(request: InstallPluginRequest, context: Launch77Context, logger: (message: string) => void = console.log): Promise<InstallPluginResult> {
+    const { pluginName } = request
+
+    const currentTarget = this.validateContext(context)
+    const { pluginPath, source, npmPackage } = await this.validateAndResolvePlugin(pluginName, context.workspaceRoot, logger)
+    const metadata = await this.validatePluginTargets(pluginPath, pluginName, currentTarget)
+
     const packagePath = this.getPackagePath(context)
+    const earlyExit = await this.checkExistingInstallation(pluginName, packagePath, logger)
+    if (earlyExit) return earlyExit
 
-    // Step 5: Run generator
     await this.runGenerator(pluginPath, packagePath, context)
 
+    const packageName = source === 'npm' ? npmPackage! : pluginName
+    await this.writePluginManifest(packagePath, {
+      pluginName,
+      packageName,
+      version: metadata.version,
+      source,
+    })
+
     return {
       pluginName,
       filesInstalled: true,
@@ -135,7 +189,9 @@ export class PluginService {
     try {
       const generatorPath = path.join(pluginPath, 'dist/generator.js')
 
-      await execa('node', [generatorPath, `--appPath=${appPath}`, `--appName=${context.appName}`, `--workspaceName=${context.workspaceName}`, `--pluginPath=${pluginPath}`], {
+      const args = [generatorPath, `--appPath=${appPath}`, `--appName=${context.appName}`, `--workspaceName=${context.workspaceName}`, `--pluginPath=${pluginPath}`]
+
+      await execa('node', args, {
         cwd: pluginPath,
         stdio: 'inherit',
       })
@@ -143,4 +199,55 @@ export class PluginService {
       throw new PluginInstallationError(`Generator failed: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined)
     }
   }
+
+  private async isPluginInstalled(pluginName: string, packagePath: string): Promise<InstalledPluginMetadata | null> {
+    try {
+      const packageJsonPath = path.join(packagePath, 'package.json')
+      const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8')
+      const packageJson = JSON.parse(packageJsonContent)
+
+      const manifest = packageJson.launch77 as Launch77PackageManifest | undefined
+
+      if (manifest?.installedPlugins?.[pluginName]) {
+        return manifest.installedPlugins[pluginName]
+      }
+
+      return null
+    } catch (error) {
+      // If package.json doesn't exist or can't be read, assume not installed
+      return null
+    }
+  }
+
+  /**
+   * Write plugin installation metadata to the target package's package.json
+   */
+  private async writePluginManifest(packagePath: string, installationInfo: { pluginName: string; packageName: string; version: string; source: 'local' | 'npm' }): Promise<void> {
+    try {
+      const packageJsonPath = path.join(packagePath, 'package.json')
+      const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8')
+      const packageJson = JSON.parse(packageJsonContent)
+
+      if (!packageJson.launch77) {
+        packageJson.launch77 = {}
+      }
+
+      if (!packageJson.launch77.installedPlugins) {
+        packageJson.launch77.installedPlugins = {}
+      }
+
+      const manifest = packageJson.launch77 as Launch77PackageManifest
+
+      manifest.installedPlugins![installationInfo.pluginName] = {
+        package: installationInfo.packageName,
+        version: installationInfo.version,
+        installedAt: new Date().toISOString(),
+        source: installationInfo.source,
+      }
+
+      await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf-8')
+    } catch (error) {
+      throw new PluginInstallationError(`Failed to write plugin manifest: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined)
+    }
+  }
 }

package/templates/workspace/package.json

@@ -19,7 +19,8 @@
     "changeset": "changeset",
     "version-packages": "changeset version",
     "release": "turbo run build lint typecheck test && changeset publish",
-    "prepare": "husky"
+    "prepare": "husky",
+    "clean": "rm -rf node_modules apps/*/node_modules libraries/*/node_modules plugins/*/node_modules app-templates/*/node_modules package-lock.json apps/*/package-lock.json libraries/*/package-lock.json plugins/*/package-lock.json app-templates/*/package-lock.json dist apps/*/dist libraries/*/dist plugins/*/dist app-templates/*/dist .next apps/*/.next .turbo apps/*/.turbo libraries/*/.turbo plugins/*/.turbo app-templates/*/.turbo build apps/*/build out apps/*/out coverage apps/*/coverage .cache *.log .eslintcache"
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.8",