@launch77/cli 1.5.0 → 1.7.0

package/dist/templates/library/src/index.d.ts.hbs

@@ -0,0 +1,14 @@
+/**
+ * Type definitions for @{{workspaceName}}/lib-{{libraryName}}
+ *
+ * Add your type exports here.
+ *
+ * Example:
+ * export { MyComponent, type MyComponentProps } from './components/MyComponent'
+ * export { myUtility } from './utils/myUtility'
+ */
+
+// Add your type exports here
+declare module '@{{workspaceName}}/lib-{{libraryName}}' {
+  // Add declarations here
+}

package/dist/templates/library/src/index.js

@@ -0,0 +1,11 @@
+/**
+ * Main entry point for @{{workspaceName}}/lib-{{libraryName}}
+ *
+ * Add your library exports here.
+ *
+ * Example:
+ * export { MyComponent } from './components/MyComponent.js'
+ * export { myUtility } from './utils/myUtility.js'
+ */
+
+// Add your exports here

package/dist/templates/library/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM"],
+    "jsx": "react-jsx",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.test.tsx"]
+}

package/package.json

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

package/src/cli.ts

@@ -2,14 +2,15 @@
 
 import { Command } from 'commander'
 
-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 { appCreateCommand, appDeleteCommand } from './modules/app/index.js'
+// import { catalogScanCommand, catalogGenerateCommand } 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 { libraryCreateCommand, libraryDeleteCommand } from './modules/library/index.js'
+import { pluginInstallCommand, pluginCreateCommand, pluginDeleteCommand } from './modules/plugin/index.js'
 import { releaseInitCommand } from './modules/release/index.js'
-import { getPackageVersion } from './utils/version.js'
 import { initWorkspaceCommand } from './modules/workspace/index.js'
+import { getPackageVersion } from './utils/version.js'
 
 const program = new Command()
   .name('launch77')
@@ -18,13 +19,15 @@ const program = new Command()
 
 // Register module commands
 program.addCommand(initWorkspaceCommand())
-program.addCommand(createAppCommand())
-program.addCommand(deleteAppCommand())
-program.addCommand(validateManifestCommand())
-program.addCommand(pluginInstallCommand())
+program.addCommand(appCreateCommand())
+program.addCommand(appDeleteCommand())
+program.addCommand(libraryCreateCommand())
+program.addCommand(libraryDeleteCommand())
 program.addCommand(pluginCreateCommand())
-program.addCommand(scanCommand())
-program.addCommand(createGenerateCommand())
+program.addCommand(pluginDeleteCommand())
+program.addCommand(pluginInstallCommand())
+// program.addCommand(catalogGenerateCommand())
+// program.addCommand(catalogScanCommand())
 
 // Git commands
 program.addCommand(gitConnectCommand())
@@ -33,8 +36,8 @@ program.addCommand(gitConnectCommand())
 program.addCommand(releaseInitCommand())
 
 // Deploy commands
-program.addCommand(deployInitCommand())
-program.addCommand(deployStatusCommand())
-program.addCommand(deployLogsCommand())
+// program.addCommand(deployInitCommand())
+// program.addCommand(deployStatusCommand())
+// program.addCommand(deployLogsCommand())
 
 program.parse()

package/src/infrastructure/template.ts

@@ -44,7 +44,6 @@ export async function processTemplate(templatePath: string, destinationPath: str
 
 /**
  * Get the path to a template directory
- * Templates are always in dist/app-templates/ (copied during build)
  */
 export function getTemplatePath(templateName: string): string {
   const __filename = fileURLToPath(import.meta.url)
@@ -70,6 +69,20 @@ export function getPluginTemplatePath(templateName: string): string {
   return path.join(baseDir, templateName)
 }
 
+/**
+ * Get the path to a library template directory
+ * Library templates are in dist/templates/ (copied during build)
+ */
+export function getLibraryTemplatePath(templateName: string): string {
+  const __filename = fileURLToPath(import.meta.url)
+  const __dirname = path.dirname(__filename)
+
+  // From dist/infrastructure/ to dist/templates/
+  const baseDir = path.join(__dirname, '../templates')
+
+  return path.join(baseDir, templateName)
+}
+
 /**
  * Check if a template exists
  */

package/src/modules/app/commands/create-app.ts

@@ -8,7 +8,7 @@ import ora from 'ora'
 import { detectLaunch77Context } from '@launch77/plugin-runtime'
 import { AppService } from '../services/app-svc.js'
 
-export function createAppCommand(): Command {
+export function appCreateCommand(): Command {
   const command = new Command('app:create')
     .argument('<template>', 'App template name (e.g., webapp, api, marketing-site)')
     .argument('<app-name>', 'Name of the application')

package/src/modules/app/commands/delete-app.ts

@@ -9,7 +9,7 @@ import ora from 'ora'
 import { detectLaunch77Context } from '@launch77/plugin-runtime'
 import { AppService } from '../services/app-svc.js'
 
-export function deleteAppCommand(): Command {
+export function appDeleteCommand(): Command {
   const command = new Command('app:delete')
     .argument('<app-name>', 'Name of the app to delete')
     .description('Delete an app from the workspace (requires confirmation)')

package/src/modules/app/index.ts

@@ -10,6 +10,5 @@ export type { AppManifest, DeploymentConfig } from './lib/manifest-schema.js'
 export { AppAlreadyExistsError, AppNotFoundError, InvalidAppNameError, TemplateNotFoundError, ManifestNotFoundError, InvalidManifestError } from './errors/app-errors.js'
 
 // Commands
-export { createAppCommand } from './commands/create-app.js'
-export { deleteAppCommand } from './commands/delete-app.js'
-export { validateManifestCommand } from './commands/validate-manifest.js'
+export { appCreateCommand } from './commands/create-app.js'
+export { appDeleteCommand } from './commands/delete-app.js'

package/src/modules/catalog/commands/generate.ts

@@ -21,7 +21,7 @@ interface GenerateOptions {
 /**
  * Create the catalog:generate command
  */
-export function createGenerateCommand(): Command {
+export function catalogGenerateCommand(): Command {
   const command = new Command('catalog:generate')
     .description('Generate catalog metadata for a component library')
     .option('-l, --library <path>', 'Library directory path', process.cwd())

package/src/modules/catalog/commands/scan.ts

@@ -10,7 +10,7 @@ import { CatalogService } from '../services/catalog-svc.js'
  * Scans UI components, libraries, plugins, and utilities from the Launch77 monorepo
  * and generates a machine-readable catalog for AI discovery.
  */
-export function scanCommand(): Command {
+export function catalogScanCommand(): Command {
   const command = new Command('catalog:scan')
     .description('Scan Launch77 artifacts and generate catalog.json')
     .option('--no-strict', 'Skip validation errors and generate catalog anyway')

package/src/modules/library/commands/create-library.ts

@@ -0,0 +1,70 @@
+/* eslint-disable no-console */
+import * as path from 'path'
+
+import chalk from 'chalk'
+import { Command } from 'commander'
+import ora from 'ora'
+
+import { detectLaunch77Context } from '@launch77/plugin-runtime'
+import { LibraryCreateService } from '../services/library-create-svc.js'
+
+export function libraryCreateCommand(): Command {
+  const command = new Command('library:create')
+    .argument('<library-name>', 'Name of the library to create (e.g., ui, marketing-ui)')
+    .option('-d, --description <description>', 'Library description')
+    .description('Create a new library from template')
+    .action(async (libraryName: string, options) => {
+      try {
+        console.log(chalk.blue(`\n📚 Creating library: ${libraryName}\n`))
+
+        // Detect context
+        const context = await detectLaunch77Context(process.cwd())
+
+        // Create library service
+        const libraryCreateService = new LibraryCreateService()
+
+        // Create library
+        const spinner = ora('Generating library structure...').start()
+        let result
+        try {
+          result = await libraryCreateService.createLibrary(
+            {
+              libraryName,
+              description: options.description,
+            },
+            context
+          )
+          spinner.succeed('Library structure generated')
+        } catch (error) {
+          spinner.fail('Failed to generate library structure')
+          throw error
+        }
+
+        // Success message
+        const relativePath = path.relative(process.cwd(), result.libraryPath)
+        const displayPath = relativePath.startsWith('..') ? result.libraryPath : relativePath
+        console.log(chalk.green(`\n✅ Library created successfully at ${displayPath}`))
+
+        // Next steps
+        console.log(chalk.white('\n' + '─'.repeat(60) + '\n'))
+        console.log(chalk.cyan('📋 Next Steps:\n'))
+        const cdPath = path.relative(process.cwd(), result.libraryPath)
+        console.log(chalk.gray('1. Navigate to your library directory:'))
+        console.log(chalk.cyan(`   cd ${cdPath}\n`))
+        console.log(chalk.gray('2. Add your library code to src/\n'))
+        console.log(chalk.gray('3. Update package.json with proper exports and dependencies\n'))
+        console.log(chalk.gray('4. Configure build system if needed (tsup, tsc, etc.)\n'))
+        console.log(chalk.gray('5. Add README.md documentation\n'))
+        console.log(chalk.gray('6. Run type checking:'))
+        console.log(chalk.cyan('   npm run typecheck\n'))
+        console.log(chalk.gray('7. Build your library:'))
+        console.log(chalk.cyan('   npm run build\n'))
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        console.error(chalk.red('Error:'), message)
+        process.exit(1)
+      }
+    })
+
+  return command
+}

package/src/modules/library/commands/delete-library.ts

@@ -0,0 +1,126 @@
+/* eslint-disable no-console */
+import * as path from 'path'
+
+import chalk from 'chalk'
+import { Command } from 'commander'
+import inquirer from 'inquirer'
+import ora from 'ora'
+
+import { detectLaunch77Context } from '@launch77/plugin-runtime'
+import { LibraryService } from '../services/library-svc.js'
+
+export function libraryDeleteCommand(): Command {
+  const command = new Command('library:delete')
+    .argument('<library-name>', 'Name of the library to delete')
+    .description('Delete a library from the workspace (requires confirmation)')
+    .action(async (libraryName: string) => {
+      try {
+        console.log(chalk.yellow(`\n⚠️  WARNING: You are about to delete the library '${libraryName}'\n`))
+
+        // Detect context
+        const context = await detectLaunch77Context(process.cwd())
+
+        // Create library service
+        const libraryService = new LibraryService()
+
+        // Get library path for display (before deletion)
+        const libraryPath = path.join(context.workspaceRoot, 'libraries', libraryName)
+
+        // Display what will be deleted
+        console.log(chalk.red('Library location:'), libraryPath)
+        console.log(chalk.red('\nThis will permanently delete:'))
+        console.log(chalk.gray('  • All source code and configuration files'))
+        console.log(chalk.gray('  • All node_modules (will be cleaned from monorepo)'))
+        console.log(chalk.gray('  • All build artifacts'))
+
+        console.log(chalk.yellow('\n⚠️  Important notes:'))
+        console.log(chalk.gray('  • Check if other packages depend on this library'))
+        console.log(chalk.gray('  • If published to npm, you may want to deprecate/unpublish it manually'))
+        console.log(chalk.gray('  • Update import statements in dependent packages manually'))
+
+        console.log(chalk.red('\n⚠️  THIS ACTION CANNOT BE UNDONE!\n'))
+
+        // First confirmation: Type library name
+        const { confirmName } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'confirmName',
+            message: `Type the library name to confirm:`,
+            validate: (input: string) => {
+              if (input === libraryName) {
+                return true
+              }
+              return `Please type '${libraryName}' exactly to confirm`
+            },
+          },
+        ])
+
+        if (confirmName !== libraryName) {
+          console.log(chalk.gray('\n✖ Deletion cancelled\n'))
+          return
+        }
+
+        // Second confirmation: Type DELETE
+        const { confirmDelete } = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'confirmDelete',
+            message: 'Type DELETE (all caps) to confirm permanent deletion:',
+            validate: (input: string) => {
+              if (input === 'DELETE') {
+                return true
+              }
+              return 'Please type DELETE (all caps) to confirm'
+            },
+          },
+        ])
+
+        if (confirmDelete !== 'DELETE') {
+          console.log(chalk.gray('\n✖ Deletion cancelled\n'))
+          return
+        }
+
+        // Delete the library
+        const deleteSpinner = ora('Deleting library directory...').start()
+        try {
+          await libraryService.deleteLibrary({ libraryName }, context)
+          deleteSpinner.succeed('Library directory deleted')
+        } catch (error) {
+          deleteSpinner.fail('Failed to delete library directory')
+          throw error
+        }
+
+        // Update dependencies
+        const installSpinner = ora('Updating workspace dependencies...').start()
+        try {
+          // This is already done by library service, just show spinner for consistency
+          installSpinner.succeed('Dependencies updated (package-lock.json cleaned)')
+        } catch (error) {
+          installSpinner.fail('Failed to update dependencies')
+          console.log(chalk.yellow('\n⚠️  You may need to run "npm install" manually at the workspace root\n'))
+        }
+
+        // Success message
+        console.log(chalk.green(`\n✅ Library '${libraryName}' has been deleted\n`))
+
+        // Reminder about cleanup
+        console.log(chalk.yellow('📝 Remember to:'))
+        console.log(chalk.gray('   • Check and update dependent packages (remove from dependencies)'))
+        console.log(chalk.gray('   • Update import statements in code that used this library'))
+        console.log(chalk.gray('   • Consider deprecating/unpublishing from npm if published'))
+        console.log()
+
+        // Reminder about Git
+        console.log(chalk.yellow('📝 Remember to commit the deletion:'))
+        console.log(chalk.gray('   git add -A'))
+        console.log(chalk.gray(`   git commit -m "Remove ${libraryName} library"`))
+        console.log()
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        console.error(chalk.red('Error:'), message)
+        process.exit(1)
+      }
+    })
+
+  return command
+}

package/src/modules/library/errors/library-errors.ts

@@ -0,0 +1,13 @@
+export class LibraryNotFoundError extends Error {
+  constructor(libraryName: string, expectedPath: string) {
+    super(`Library '${libraryName}' does not exist.\n\n` + `Expected location: ${expectedPath}\n\n` + `Available libraries:\n` + `  cd libraries/\n` + `  ls`)
+    this.name = 'LibraryNotFoundError'
+  }
+}
+
+export class InvalidLibraryNameError extends Error {
+  constructor(message: string) {
+    super(message)
+    this.name = 'InvalidLibraryNameError'
+  }
+}

package/src/modules/library/index.ts

@@ -0,0 +1,13 @@
+// Services
+export { LibraryService } from './services/library-svc.js'
+export { LibraryCreateService } from './services/library-create-svc.js'
+
+// Types
+export type { CreateLibraryRequest, CreateLibraryResult, DeleteLibraryRequest, DeleteLibraryResult } from './types/library-types.js'
+
+// Errors
+export { LibraryNotFoundError, InvalidLibraryNameError } from './errors/library-errors.js'
+
+// Commands
+export { libraryCreateCommand } from './commands/create-library.js'
+export { libraryDeleteCommand } from './commands/delete-library.js'

package/src/modules/library/services/library-create-svc.ts

@@ -0,0 +1,75 @@
+import * as path from 'path'
+
+import fs from 'fs-extra'
+
+import { processTemplate, getLibraryTemplatePath } from '../../../infrastructure/template.js'
+import { validateAppName } from '../../../utils/validation.js'
+import { toPascalCase } from '../../../utils/string.js'
+
+import type { Launch77Context } from '@launch77/plugin-runtime'
+
+export interface CreateLibraryRequest {
+  libraryName: string
+  description?: string
+}
+
+export interface CreateLibraryResult {
+  libraryName: string
+  libraryPath: string
+  packageName: string
+}
+
+export class LibraryCreateService {
+  /**
+   * Create a new library from template
+   */
+  async createLibrary(request: CreateLibraryRequest, context: Launch77Context): Promise<CreateLibraryResult> {
+    const { libraryName, description } = request
+
+    // 1. Validate library name (same validation as app/plugin names)
+    const nameValidation = validateAppName(libraryName)
+    if (!nameValidation.valid) {
+      throw new Error(nameValidation.errorMessage || 'Invalid library name')
+    }
+
+    // 2. Validate workspace context
+    if (!context.isValid) {
+      throw new Error('Must be run from within a Launch77 workspace')
+    }
+
+    // 3. Determine library path
+    const libraryPath = path.join(context.workspaceRoot, 'libraries', libraryName)
+
+    // 4. Check if library already exists
+    if (await fs.pathExists(libraryPath)) {
+      throw new Error(`Library '${libraryName}' already exists at ${libraryPath}`)
+    }
+
+    // 5. Get library template path
+    const templatePath = getLibraryTemplatePath('library')
+
+    // 6. Check if template exists
+    if (!(await fs.pathExists(templatePath))) {
+      throw new Error(`Library template not found at ${templatePath}`)
+    }
+
+    // 7. Build package name
+    const packageName = `@${context.workspaceName}/lib-${libraryName}`
+
+    // 8. Process template with context
+    await processTemplate(templatePath, libraryPath, {
+      appName: libraryName, // Required by TemplateContext but not semantically used for libraries
+      libraryName,
+      libraryNamePascal: toPascalCase(libraryName),
+      workspaceName: context.workspaceName,
+      packageName,
+      description: description || `Launch77 library for ${libraryName}`,
+    })
+
+    return {
+      libraryName,
+      libraryPath,
+      packageName,
+    }
+  }
+}

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

@@ -0,0 +1,50 @@
+import * as path from 'path'
+
+import fs from 'fs-extra'
+
+import * as npm from '../../../infrastructure/npm.js'
+import { validateWorkspaceContext } from '../../../utils/launch77-validation.js'
+import { validateAppName } from '../../../utils/validation.js'
+import { LibraryNotFoundError, InvalidLibraryNameError } from '../errors/library-errors.js'
+
+import type { DeleteLibraryRequest, DeleteLibraryResult } from '../types/library-types.js'
+import type { Launch77Context } from '@launch77/plugin-runtime'
+
+export class LibraryService {
+  /**
+   * Delete a library from the workspace
+   */
+  async deleteLibrary(request: DeleteLibraryRequest, context: Launch77Context): Promise<DeleteLibraryResult> {
+    const { libraryName } = request
+
+    // 1. Validate library name (reusing app name validation since format is the same)
+    const nameValidation = validateAppName(libraryName)
+    if (!nameValidation.valid) {
+      throw new InvalidLibraryNameError(nameValidation.errorMessage || 'Invalid library name')
+    }
+
+    // 2. Validate workspace context
+    const contextValidation = validateWorkspaceContext(context)
+    if (!contextValidation.valid) {
+      throw new Error(contextValidation.errorMessage || 'Invalid workspace context')
+    }
+
+    // 3. Determine library path
+    const libraryPath = path.join(context.workspaceRoot, 'libraries', libraryName)
+
+    // 4. Check if library exists
+    if (!(await fs.pathExists(libraryPath))) {
+      throw new LibraryNotFoundError(libraryName, libraryPath)
+    }
+
+    // 5. Delete the library directory
+    await fs.remove(libraryPath)
+
+    // 6. Update dependencies
+    await npm.install(context.workspaceRoot)
+
+    return {
+      libraryName,
+    }
+  }
+}

package/src/modules/library/types/library-types.ts

@@ -0,0 +1,18 @@
+export interface CreateLibraryRequest {
+  libraryName: string
+  description?: string
+}
+
+export interface CreateLibraryResult {
+  libraryName: string
+  libraryPath: string
+  packageName: string
+}
+
+export interface DeleteLibraryRequest {
+  libraryName: string
+}
+
+export interface DeleteLibraryResult {
+  libraryName: string
+}