@launch77/cli 1.2.0 → 1.4.0

package/src/modules/workspace/commands/init-workspace.ts

@@ -38,14 +38,12 @@ export function initWorkspaceCommand(): Command {
       try {
         const spinner = ora('Creating workspace structure...').start()
 
-        const result = await service.initWorkspace({ name: workspaceName }, process.cwd())
-
-        spinner.succeed('Workspace structure created')
+        const cwd = process.cwd()
+        const result = await service.initWorkspace({ name: workspaceName }, cwd, spinner)
 
         // Success message
-        const cwd = process.cwd()
-        console.log(chalk.green(`\n✅ Workspace created successfully at ${path.relative(cwd, result.workspacePath)}\n`))
-        console.log(chalk.gray(`Next steps:\n` + `  1. cd ${workspaceName}\n` + `  2. npm install\n` + `  3. Create your first app with launch77 commands\n`))
+        console.log(chalk.green(`\n✅ Workspace ready at ${path.relative(cwd, result.workspacePath)}\n`))
+        console.log(chalk.gray(`Next steps:\n` + `  1. cd ${workspaceName}\n` + `  2. Create your first app with launch77 commands\n`))
       } catch (error) {
         if (error instanceof WorkspaceAlreadyExistsError) {
           console.error(chalk.red(`\n❌ ${error.message}\n`))

package/src/modules/workspace/services/workspace-service.ts

@@ -1,14 +1,18 @@
 import * as path from 'path'
 import { fileURLToPath } from 'url'
 
+import { execa } from 'execa'
+
 import * as filesystem from '../../../infrastructure/filesystem.js'
+import * as npm from '../../../infrastructure/npm.js'
 import { WorkspaceAlreadyExistsError } from '../errors/workspace-errors.js'
 import { validateWorkspaceName } from '../utils/workspace-validators.js'
 
 import type { InitWorkspaceRequest, InitWorkspaceResult } from '../types/workspace-types.js'
+import type { Ora } from 'ora'
 
 export class WorkspaceService {
-  async initWorkspace(request: InitWorkspaceRequest, cwd: string): Promise<InitWorkspaceResult> {
+  async initWorkspace(request: InitWorkspaceRequest, cwd: string, spinner?: Ora): Promise<InitWorkspaceResult> {
     const { name } = request
 
     // 1. Validate name
@@ -38,6 +42,31 @@ export class WorkspaceService {
       throw new Error('Failed to create workspace manifest (.launch77/workspace.json)')
     }
 
+    // 7. Stop spinner before npm install
+    if (spinner) {
+      spinner.succeed('Workspace structure created')
+    }
+
+    // 8. Install dependencies
+    console.log('\nInstalling dependencies...')
+    try {
+      await npm.install(workspacePath)
+      console.log('✓ Dependencies installed')
+    } catch (error) {
+      console.warn('⚠ Warning: npm install failed:', error instanceof Error ? error.message : String(error))
+      console.warn('You may need to run npm install manually in the workspace directory')
+    }
+
+    // 9. Initialize changesets
+    console.log('\nInitializing changesets...')
+    try {
+      await execa('npx', ['changeset', 'init'], { cwd: workspacePath })
+      console.log('✓ Changesets initialized')
+    } catch (error) {
+      console.warn('⚠ Warning: changeset init failed:', error instanceof Error ? error.message : String(error))
+      console.warn('You may need to run npx changeset init manually in the workspace directory')
+    }
+
     return {
       workspacePath,
       name,

package/src/utils/launch77-context.ts

@@ -2,7 +2,7 @@ import * as path from 'path'
 
 import fs from 'fs-extra'
 
-export type Launch77LocationType = 'workspace-root' | 'workspace-app' | 'unknown'
+export type Launch77LocationType = 'workspace-root' | 'workspace-app' | 'workspace-library' | 'workspace-plugin' | 'workspace-app-template' | 'unknown'
 
 export interface Launch77Context {
   isValid: boolean
@@ -64,6 +64,9 @@ interface ParsedLocation {
  * Parse the directory structure to determine location context
  * Based on patterns:
  * - apps/[name] → workspace-app
+ * - libraries/[name] → workspace-library
+ * - plugins/[name] → workspace-plugin
+ * - app-templates/[name] → workspace-app-template
  * - (empty or root) → workspace-root
  */
 function parseLocationFromPath(cwdPath: string, workspaceRoot: string): ParsedLocation {
@@ -84,8 +87,31 @@ function parseLocationFromPath(cwdPath: string, workspaceRoot: string): ParsedLo
     }
   }
 
-  // Somewhere else in workspace (libraries, plugins, etc.)
-  // Still considered workspace-root for now
+  // libraries/[lib-name]/...
+  if (parts[0] === 'libraries' && parts.length >= 2) {
+    return {
+      locationType: 'workspace-library',
+      appName: parts[1],
+    }
+  }
+
+  // plugins/[plugin-name]/...
+  if (parts[0] === 'plugins' && parts.length >= 2) {
+    return {
+      locationType: 'workspace-plugin',
+      appName: parts[1],
+    }
+  }
+
+  // app-templates/[template-name]/...
+  if (parts[0] === 'app-templates' && parts.length >= 2) {
+    return {
+      locationType: 'workspace-app-template',
+      appName: parts[1],
+    }
+  }
+
+  // Somewhere else in workspace
   return { locationType: 'workspace-root' }
 }
 

package/src/utils/launch77-validation.ts

@@ -1,4 +1,4 @@
-import type { Launch77Context } from './launch77-context.js'
+import type { Launch77Context } from '@launch77/plugin-runtime'
 
 /**
  * Validation result with helpful error messages

package/src/utils/string.ts

@@ -0,0 +1,17 @@
+/**
+ * Convert a kebab-case or snake_case string to PascalCase
+ *
+ * @param str - The string to convert (e.g., "my-plugin" or "my_plugin")
+ * @returns PascalCase string (e.g., "MyPlugin")
+ *
+ * @example
+ * toPascalCase('my-plugin') // 'MyPlugin'
+ * toPascalCase('release') // 'Release'
+ * toPascalCase('my-awesome-plugin') // 'MyAwesomePlugin'
+ */
+export function toPascalCase(str: string): string {
+  return str
+    .split(/[-_]/)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join('')
+}

package/templates/plugin/README.md.hbs

@@ -0,0 +1,39 @@
+# {{pluginNamePascal}} Plugin
+
+{{description}}
+
+## Installation
+
+```bash
+launch77 plugin:install {{pluginName}}
+```
+
+## Usage
+
+After installation, the plugin will:
+
+- TODO: Describe what the plugin does
+- TODO: List any files created or modified
+- TODO: Explain configuration options
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm run typecheck
+```
+
+## Template Files
+
+The `templates/` directory contains files that will be copied to the target application when this plugin is installed. Add any template files your plugin needs here.
+
+## License
+
+UNLICENSED

package/templates/plugin/package.json.hbs

@@ -0,0 +1,34 @@
+{
+  "name": "@{{workspaceName}}/plugin-{{pluginName}}",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "license": "UNLICENSED",
+  "private": true,
+  "type": "module",
+  "main": "dist/generator.js",
+  "bin": {
+    "generate": "./dist/generator.js"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "plugin.json"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@launch77/plugin-runtime": "^0.1.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/plugin/plugin.json.hbs

@@ -0,0 +1,7 @@
+{
+  "name": "{{pluginName}}",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "pluginDependencies": {},
+  "libraryDependencies": {}
+}

package/templates/plugin/src/generator.ts.hbs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import chalk from 'chalk'
+import { StandardGenerator } from '@launch77/plugin-runtime'
+import type { GeneratorContext } from '@launch77/plugin-runtime'
+
+export class {{pluginNamePascal}}Generator extends StandardGenerator {
+  constructor(context: GeneratorContext) {
+    super(context)
+  }
+
+  protected async injectCode(): Promise<void> {
+    console.log(chalk.cyan('🔧 Setting up {{pluginName}} plugin...\n'))
+
+    // TODO: Add your plugin's code injection logic here
+    // Examples:
+    // - Copy template files to the app
+    // - Modify package.json
+    // - Update configuration files
+
+    console.log(chalk.green('   ✓ Plugin setup complete\n'))
+  }
+
+  protected showNextSteps(): void {
+    console.log(chalk.white('\n' + '─'.repeat(60) + '\n'))
+    console.log(chalk.cyan('📋 {{pluginNamePascal}} Plugin Installed!\n'))
+    console.log(chalk.white('Next Steps:\n'))
+
+    console.log(chalk.gray('1. TODO: Add your first step'))
+    console.log(chalk.cyan('   npm run <command>\n'))
+
+    console.log(chalk.gray('2. TODO: Add your second step'))
+    console.log(chalk.cyan('   npm run <command>\n'))
+
+    console.log(chalk.white('Documentation:\n'))
+    console.log(chalk.gray('See README.md for detailed instructions.\n'))
+  }
+}
+
+// CLI entry point
+async function main() {
+  const args = process.argv.slice(2)
+  const appPath = args.find((arg) => arg.startsWith('--appPath='))?.split('=')[1]
+  const appName = args.find((arg) => arg.startsWith('--appName='))?.split('=')[1]
+  const workspaceName = args.find((arg) => arg.startsWith('--workspaceName='))?.split('=')[1]
+  const pluginPath = args.find((arg) => arg.startsWith('--pluginPath='))?.split('=')[1]
+
+  if (!appPath || !appName || !workspaceName || !pluginPath) {
+    console.error(chalk.red('Error: Missing required arguments'))
+    console.error(chalk.gray('Usage: --appPath=<path> --appName=<name> --workspaceName=<name> --pluginPath=<path>'))
+    process.exit(1)
+  }
+
+  const generator = new {{pluginNamePascal}}Generator({ appPath, appName, workspaceName, pluginPath })
+  await generator.run()
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error(chalk.red('\n❌ Error during plugin setup:'))
+    console.error(error)
+    process.exit(1)
+  })
+}

package/templates/plugin/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "module": "ESNext",
+    "target": "ES2022"
+  },
+  "include": ["src/**/*"]
+}

package/templates/plugin/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/generator.ts'],
+  format: ['esm'],
+  dts: false,
+  clean: true,
+  shims: true,
+})

package/templates/workspace/.github/workflows/ci.yml

@@ -0,0 +1,102 @@
+name: CI & Release
+
+on:
+  pull_request:
+    branches: [main, develop]
+  push:
+    branches: [main, develop]
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run linting
+        run: npm run lint
+
+      - name: Build packages
+        run: npm run build
+
+      - name: Run type checking
+        run: npm run typecheck
+
+      - name: Run tests
+        run: npm run test
+
+      - name: Run integration tests
+        run: npm run test:integration
+
+  quality-checks:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js 20.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Check for dependency vulnerabilities
+        run: npm audit --audit-level=high
+
+      - name: Check formatting
+        run: npx prettier --check "**/*.{js,jsx,ts,tsx,json,md}"
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    needs: [build-and-test, quality-checks]
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+
+    steps:
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js 20.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+
+      - name: Upgrade npm
+        run: npm i -g npm@latest
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Create Release Pull Request or Publish to npm
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: npm run release
+          title: "chore: version packages"
+          commit: "chore: version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN }}

package/templates/workspace/package.json

@@ -13,11 +13,16 @@
     "dev": "turbo run dev",
     "build": "turbo run build",
     "test": "turbo run test",
+    "test:integration": "turbo run test:integration",
     "lint": "turbo run lint",
     "typecheck": "turbo run typecheck",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "turbo run build lint typecheck test && changeset publish",
     "prepare": "husky"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.29.8",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
     "eslint": "^8.56.0",

package/templates/workspace/turbo.json

@@ -20,6 +20,11 @@
     "test": {
       "outputs": [],
       "dependsOn": ["build"]
+    },
+    "test:integration": {
+      "outputs": [],
+      "dependsOn": ["build"],
+      "cache": false
     }
   }
 }

package/tests/integration/cli.test.ts

@@ -0,0 +1,25 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import { existsSync } from 'fs'
+import { runCli } from './setup.js'
+
+describe('CLI Integration Tests', () => {
+  beforeAll(() => {
+    if (!existsSync('./dist/cli.js')) {
+      throw new Error('CLI not built. Run `npm run build` first.')
+    }
+  })
+
+  it('should display version', async () => {
+    const { stdout, exitCode } = await runCli(['--version'])
+
+    expect(exitCode).toBe(0)
+    expect(stdout).toMatch(/\d+\.\d+\.\d+/)
+  })
+
+  it('should display help', async () => {
+    const { stdout, exitCode } = await runCli(['--help'])
+
+    expect(exitCode).toBe(0)
+    expect(stdout).toContain('launch77')
+  })
+})

package/tests/integration/setup.ts

@@ -0,0 +1,20 @@
+import { execa } from 'execa'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const CLI_PATH = join(__dirname, '../../dist/cli.js')
+
+export async function runCli(args: string[], options?: { cwd?: string }) {
+  const result = await execa('node', [CLI_PATH, ...args], {
+    reject: false,
+    cwd: options?.cwd,
+    env: { ...process.env, CI: 'true' },
+  })
+
+  return {
+    stdout: result.stdout,
+    stderr: result.stderr,
+    exitCode: result.exitCode ?? 0,
+  }
+}

package/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+    testTimeout: 10000,
+    hookTimeout: 10000,
+  },
+})

package/vitest.integration.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    include: ['tests/integration/**/*.test.ts'],
+    testTimeout: 30000,
+    hookTimeout: 60000,
+  },
+})

package/dist/app-templates/webapp/.env.ci

@@ -1,6 +0,0 @@
-# CI/CD Build Environment Variables
-# These values allow Next.js to build and prerender static pages in CI
-# Real production values are set in deployment platform (Vercel)
-NEXT_PUBLIC_SITE_URL=http://localhost:3000
-NEXT_PUBLIC_API_URL=http://localhost:4000/graphql
-NEXT_PUBLIC_GTM_ID=

package/dist/app-templates/webapp/.env.example

@@ -1,9 +0,0 @@
-# Site Configuration
-NEXT_PUBLIC_SITE_URL=http://localhost:3000
-
-# Analytics
-# Get your GTM ID from Google Tag Manager (format: GTM-XXXXXXX)
-NEXT_PUBLIC_GTM_ID=
-
-# Feature Flags (optional)
-# NEXT_PUBLIC_ENABLE_ANALYTICS=true

package/dist/app-templates/webapp/.eslintrc.json

@@ -1,6 +0,0 @@
-{
-  "extends": ["next/core-web-vitals"],
-  "rules": {
-    "import/order": "off"
-  }
-}

package/dist/app-templates/webapp/README.md.hbs

@@ -1,80 +0,0 @@
-# {{appName}}
-
-{{#if startupName}}Part of the {{startupName}} startup{{/if}}
-
-A web application built with the Launch77 Platform.
-
-## Getting Started
-
-1. Install dependencies (from monorepo root):
-```bash
-npm install
-```
-
-2. Set up environment variables:
-```bash
-cp .env.example .env.local
-```
-
-3. Run the development server:
-```bash
-npm run dev
-```
-
-Open [http://localhost:{{port}}](http://localhost:{{port}}) in your browser.
-
-## Available Scripts
-
-- `npm run dev` - Start development server
-- `npm run build` - Build for production
-- `npm run start` - Start production server
-- `npm run lint` - Run ESLint
-- `npm run typecheck` - Run TypeScript type checking
-
-## Launch77 Packages
-
-This app uses the following Launch77 platform packages:
-
-- **@launch77/ui** - Shared component library
-- **@launch77/theme** - Tailwind preset and design tokens
-
-## Project Structure
-
-```
-app/
-├── layout.tsx       # Root layout
-├── page.tsx         # Homepage
-├── dashboard/       # Example dashboard page
-├── about/           # About page
-└── globals.css      # Global styles (imports @launch77/theme)
-```
-
-## Next Steps
-
-1. **Add Authentication**: Implement login/register pages and protect routes
-2. **Connect to API**: Set up API client to connect to your backend
-3. **Add Features**: Build out your application features
-
-## Using UI Components
-
-```tsx
-import { Button, Card, Input } from '@launch77/ui'
-
-export default function MyPage() {
-  return (
-    <Card>
-      <Input placeholder="Enter text" />
-      <Button>Submit</Button>
-    </Card>
-  )
-}
-```
-
-## Customizing Theme
-
-Extend `tailwind.config.ts` for theme customization.
-
-## Learn More
-
-- [Next.js Documentation](https://nextjs.org/docs)
-- [Launch77 Platform Docs](../../README.md)

package/dist/app-templates/webapp/app/about/page.tsx.hbs

@@ -1,41 +0,0 @@
-import Link from 'next/link'
-
-export default function AboutPage() {
-  return (
-    <div className="min-h-screen bg-gray-50">
-      <nav className="border-b border-gray-200">
-        <div className="max-w-7xl mx-auto px-4 py-4">
-          <div className="flex items-center justify-between">
-            <h1 className="text-xl font-bold text-gray-900">{{appName}}</h1>
-            <Link
-              href="/"
-              className="px-4 py-2 text-sm font-medium text-gray-700 hover:text-gray-900 hover:bg-gray-100 rounded-md transition-colors"
-            >
-              Home
-            </Link>
-          </div>
-        </div>
-      </nav>
-
-      <main className="max-w-3xl mx-auto px-4 py-16">
-        <h1 className="text-4xl font-bold text-gray-900 mb-4">
-          About {{appName}}
-        </h1>
-        <div className="prose prose-slate">
-          <p className="text-lg text-gray-600 mb-4">
-            This is a web application built with the Launch77 Platform.
-          </p>
-          <p className="text-gray-600 mb-4">
-            Launch77 provides a modern development environment with:
-          </p>
-          <ul className="list-disc list-inside text-gray-600 mb-4 space-y-2">
-            <li>Next.js for server-side rendering and routing</li>
-            <li>Tailwind CSS for styling</li>
-            <li>TypeScript for type safety</li>
-            <li>Plugin-based architecture for adding capabilities</li>
-          </ul>
-        </div>
-      </main>
-    </div>
-  )
-}