popeye-cli 1.2.1 → 1.3.0

package/dist/generators/all.js

@@ -0,0 +1,826 @@
+/**
+ * All project generator (FE + BE + Website)
+ * Orchestrates Python, TypeScript, and Website generators for complete monorepo
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { generateFullstackProject } from './fullstack.js';
+import { generateWebsiteProject } from './website.js';
+/**
+ * Create a directory if it doesn't exist
+ */
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+/**
+ * Write a file with content
+ */
+async function writeFile(filePath, content) {
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Convert project name to Python package name
+ */
+function toPythonPackageName(name) {
+    return name.toLowerCase().replace(/-/g, '_').replace(/[^a-z0-9_]/g, '');
+}
+/**
+ * Generate workspace.json for "all" projects
+ */
+function generateAllWorkspaceJson(projectName) {
+    const packageName = toPythonPackageName(projectName);
+    const config = {
+        version: '1.0',
+        apps: {
+            frontend: {
+                name: 'frontend',
+                path: 'apps/frontend',
+                language: 'typescript',
+                commands: {
+                    test: 'npm test',
+                    lint: 'npm run lint',
+                    build: 'npm run build',
+                    dev: 'npm run dev',
+                    typecheck: 'npm run typecheck',
+                },
+                docker: {
+                    dockerfile: 'apps/frontend/Dockerfile',
+                    imageName: `${projectName}-frontend`,
+                    context: 'apps/frontend',
+                },
+                dependsOn: ['packages/design-tokens', 'packages/ui'],
+                contextRoots: ['apps/frontend/src'],
+                uiSpec: '.popeye/ui-spec.json',
+            },
+            backend: {
+                name: 'backend',
+                path: 'apps/backend',
+                language: 'python',
+                commands: {
+                    test: 'pytest -v',
+                    lint: 'ruff check .',
+                    build: 'pip install -e .',
+                    dev: `uvicorn src.${packageName}.main:app --reload --port 8000`,
+                },
+                docker: {
+                    dockerfile: 'apps/backend/Dockerfile',
+                    imageName: `${projectName}-backend`,
+                    context: 'apps/backend',
+                },
+                contextRoots: ['apps/backend/src'],
+            },
+            website: {
+                name: 'website',
+                path: 'apps/website',
+                language: 'typescript',
+                commands: {
+                    test: 'npm test',
+                    lint: 'npm run lint',
+                    build: 'npm run build',
+                    dev: 'npm run dev',
+                    typecheck: 'npm run typecheck',
+                },
+                docker: {
+                    dockerfile: 'apps/website/Dockerfile',
+                    imageName: `${projectName}-website`,
+                    context: 'apps/website',
+                },
+                dependsOn: ['packages/design-tokens'],
+                contextRoots: ['apps/website/src'],
+            },
+        },
+        shared: {
+            contracts: 'packages/contracts',
+            ui: 'packages/ui',
+            designTokens: 'packages/design-tokens',
+        },
+        commands: {
+            testAll: 'npm run test --workspaces --if-present && cd apps/backend && pytest',
+            lintAll: 'npm run lint --workspaces --if-present && cd apps/backend && ruff check .',
+            buildAll: 'npm run build -w packages/design-tokens && npm run build -w packages/ui && npm run build --workspaces --if-present',
+            devAll: 'concurrently "npm run dev -w apps/frontend" "npm run dev -w apps/website" "cd apps/backend && make dev"',
+        },
+        docker: {
+            composePath: 'infra/docker/docker-compose.yml',
+            rootComposeSymlink: true,
+        },
+    };
+    return JSON.stringify(config, null, 2);
+}
+/**
+ * Generate root package.json for npm workspaces
+ */
+function generateRootPackageJson(projectName) {
+    return JSON.stringify({
+        name: `@${projectName}/root`,
+        private: true,
+        workspaces: ['apps/*', 'packages/*'],
+        scripts: {
+            dev: 'concurrently "npm run dev -w apps/frontend" "npm run dev -w apps/website"',
+            'dev:all': 'concurrently "npm run dev -w apps/frontend" "npm run dev -w apps/website" "cd apps/backend && make dev"',
+            build: 'npm run build -w packages/design-tokens && npm run build -w packages/ui && npm run build --workspaces --if-present',
+            test: 'npm run test --workspaces --if-present',
+            'test:all': 'npm run test --workspaces --if-present && cd apps/backend && pytest',
+            lint: 'npm run lint --workspaces --if-present',
+            'lint:all': 'npm run lint --workspaces --if-present && cd apps/backend && ruff check .',
+            typecheck: 'npm run typecheck --workspaces --if-present',
+        },
+        devDependencies: {
+            concurrently: '^8.2.0',
+        },
+        engines: {
+            node: '>=18.0.0',
+        },
+    }, null, 2);
+}
+/**
+ * Generate docker-compose.yml for "all" projects
+ */
+function generateAllDockerCompose(projectName) {
+    return `version: '3.8'
+
+services:
+  frontend:
+    build:
+      context: apps/frontend
+      dockerfile: Dockerfile
+    ports:
+      - "3000:80"
+    depends_on:
+      - backend
+    environment:
+      - VITE_API_URL=http://backend:8000
+    networks:
+      - ${projectName}-network
+
+  backend:
+    build:
+      context: apps/backend
+      dockerfile: Dockerfile
+    ports:
+      - "8000:8000"
+    environment:
+      - DEBUG=false
+      - FRONTEND_URL=http://frontend:80
+      - WEBSITE_URL=http://website:3000
+    volumes:
+      - backend-data:/app/data
+    networks:
+      - ${projectName}-network
+
+  website:
+    build:
+      context: apps/website
+      dockerfile: Dockerfile
+    ports:
+      - "3001:3000"
+    environment:
+      - NODE_ENV=production
+      - NEXT_PUBLIC_APP_URL=http://localhost:3000
+    networks:
+      - ${projectName}-network
+
+networks:
+  ${projectName}-network:
+    driver: bridge
+
+volumes:
+  backend-data:
+`;
+}
+/**
+ * Generate root README for "all" projects
+ */
+function generateAllRootReadme(projectName, idea) {
+    const title = projectName
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+    return `# ${title}
+
+${idea}
+
+## Architecture
+
+This is a monorepo containing:
+
+- **Frontend App** (\`apps/frontend\`): React + Vite + Tailwind CSS
+- **Backend API** (\`apps/backend\`): FastAPI (Python)
+- **Marketing Website** (\`apps/website\`): Next.js (SEO-optimized)
+- **Shared Packages** (\`packages/\`): Design tokens, UI components, API contracts
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- Python 3.10+
+- npm
+
+### Installation
+
+\`\`\`bash
+# Install all dependencies
+npm install
+
+# Install backend dependencies
+cd apps/backend && pip install -e ".[dev]"
+\`\`\`
+
+### Development
+
+\`\`\`bash
+# Run all apps in development mode
+npm run dev:all
+
+# Or run individual apps:
+npm run dev -w apps/frontend  # Frontend on :5173
+npm run dev -w apps/website   # Website on :3001
+cd apps/backend && make dev   # Backend on :8000
+\`\`\`
+
+### Testing
+
+\`\`\`bash
+# Run all tests
+npm run test:all
+
+# Run frontend tests
+npm run test -w apps/frontend
+
+# Run backend tests
+cd apps/backend && pytest
+
+# Run website tests
+npm run test -w apps/website
+\`\`\`
+
+### Building
+
+\`\`\`bash
+# Build all apps
+npm run build
+\`\`\`
+
+### Docker
+
+\`\`\`bash
+# Build and run with Docker Compose
+docker-compose up --build
+
+# Services:
+# - Frontend: http://localhost:3000
+# - Backend: http://localhost:8000
+# - Website: http://localhost:3001
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${projectName}/
+  apps/
+    frontend/       # React + Vite SPA
+    backend/        # FastAPI Python API
+    website/        # Next.js marketing site
+  packages/
+    design-tokens/  # Shared colors, typography
+    ui/             # Shared UI components
+    contracts/      # API contracts (OpenAPI)
+  infra/
+    docker/         # Docker configuration
+  docs/
+    PLAN.md         # Development plan
+    WORKFLOW_LOG.md # Progress log
+  .popeye/
+    workspace.json  # Workspace configuration
+    ui-spec.json    # UI design spec (frontend)
+    website-spec.json # Website design spec
+\`\`\`
+
+## Links
+
+- Frontend: http://localhost:5173 (dev) / http://localhost:3000 (prod)
+- Backend API: http://localhost:8000
+- Website: http://localhost:3001
+
+---
+
+Generated by [Popeye CLI](https://github.com/popeye-cli/popeye)
+`;
+}
+/**
+ * Generate design tokens package
+ */
+function generateDesignTokensPackage(projectName) {
+    return {
+        files: [
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name: `@${projectName}/design-tokens`,
+                    version: '1.0.0',
+                    type: 'module',
+                    main: './dist/index.js',
+                    types: './dist/index.d.ts',
+                    exports: {
+                        '.': './dist/index.js',
+                        './tailwind': './dist/tailwind-preset.js',
+                    },
+                    scripts: {
+                        build: 'tsc',
+                        dev: 'tsc --watch',
+                    },
+                    devDependencies: {
+                        typescript: '^5.3.3',
+                    },
+                }, null, 2),
+            },
+            {
+                path: 'tsconfig.json',
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2020',
+                        module: 'ESNext',
+                        moduleResolution: 'bundler',
+                        declaration: true,
+                        outDir: './dist',
+                        strict: true,
+                        esModuleInterop: true,
+                        skipLibCheck: true,
+                    },
+                    include: ['src'],
+                }, null, 2),
+            },
+            {
+                path: 'src/index.ts',
+                content: `/**
+ * Design tokens for ${projectName}
+ */
+
+export * from './colors.js';
+export * from './typography.js';
+`,
+            },
+            {
+                path: 'src/colors.ts',
+                content: `/**
+ * Color palette
+ */
+
+export const colors = {
+  primary: {
+    50: '#f0f9ff',
+    100: '#e0f2fe',
+    200: '#bae6fd',
+    300: '#7dd3fc',
+    400: '#38bdf8',
+    500: '#0ea5e9',
+    600: '#0284c7',
+    700: '#0369a1',
+    800: '#075985',
+    900: '#0c4a6e',
+  },
+  secondary: {
+    50: '#f8fafc',
+    100: '#f1f5f9',
+    200: '#e2e8f0',
+    300: '#cbd5e1',
+    400: '#94a3b8',
+    500: '#64748b',
+    600: '#475569',
+    700: '#334155',
+    800: '#1e293b',
+    900: '#0f172a',
+  },
+} as const;
+
+export type ColorScale = typeof colors.primary;
+export type Colors = typeof colors;
+`,
+            },
+            {
+                path: 'src/typography.ts',
+                content: `/**
+ * Typography settings
+ */
+
+export const typography = {
+  fontFamily: {
+    sans: ['Inter', 'system-ui', 'sans-serif'],
+    mono: ['JetBrains Mono', 'Fira Code', 'monospace'],
+  },
+  fontSize: {
+    xs: ['0.75rem', { lineHeight: '1rem' }],
+    sm: ['0.875rem', { lineHeight: '1.25rem' }],
+    base: ['1rem', { lineHeight: '1.5rem' }],
+    lg: ['1.125rem', { lineHeight: '1.75rem' }],
+    xl: ['1.25rem', { lineHeight: '1.75rem' }],
+    '2xl': ['1.5rem', { lineHeight: '2rem' }],
+    '3xl': ['1.875rem', { lineHeight: '2.25rem' }],
+    '4xl': ['2.25rem', { lineHeight: '2.5rem' }],
+    '5xl': ['3rem', { lineHeight: '1' }],
+    '6xl': ['3.75rem', { lineHeight: '1' }],
+  },
+} as const;
+
+export type Typography = typeof typography;
+`,
+            },
+            {
+                path: 'src/tailwind-preset.ts',
+                content: `/**
+ * Tailwind CSS preset with design tokens
+ */
+
+import { colors } from './colors.js';
+import { typography } from './typography.js';
+
+export const preset = {
+  theme: {
+    extend: {
+      colors,
+      fontFamily: typography.fontFamily,
+      fontSize: typography.fontSize,
+    },
+  },
+};
+
+export default preset;
+`,
+            },
+        ],
+    };
+}
+/**
+ * Generate UI components package
+ */
+function generateUiPackage(projectName) {
+    return {
+        files: [
+            {
+                path: 'package.json',
+                content: JSON.stringify({
+                    name: `@${projectName}/ui`,
+                    version: '1.0.0',
+                    type: 'module',
+                    main: './dist/index.js',
+                    types: './dist/index.d.ts',
+                    exports: {
+                        '.': './dist/index.js',
+                        './button': './dist/button.js',
+                        './card': './dist/card.js',
+                    },
+                    scripts: {
+                        build: 'tsc',
+                        dev: 'tsc --watch',
+                    },
+                    dependencies: {
+                        clsx: '^2.1.0',
+                        'tailwind-merge': '^2.2.0',
+                    },
+                    peerDependencies: {
+                        react: '>=18.0.0',
+                        'react-dom': '>=18.0.0',
+                    },
+                    devDependencies: {
+                        '@types/react': '^18.2.0',
+                        '@types/react-dom': '^18.2.0',
+                        typescript: '^5.3.3',
+                    },
+                }, null, 2),
+            },
+            {
+                path: 'tsconfig.json',
+                content: JSON.stringify({
+                    compilerOptions: {
+                        target: 'ES2020',
+                        module: 'ESNext',
+                        moduleResolution: 'bundler',
+                        declaration: true,
+                        outDir: './dist',
+                        strict: true,
+                        esModuleInterop: true,
+                        skipLibCheck: true,
+                        jsx: 'react-jsx',
+                    },
+                    include: ['src'],
+                }, null, 2),
+            },
+            {
+                path: 'src/index.ts',
+                content: `/**
+ * Shared UI components for ${projectName}
+ */
+
+export * from './button.js';
+export * from './card.js';
+export * from './utils.js';
+`,
+            },
+            {
+                path: 'src/utils.ts',
+                content: `import { clsx, type ClassValue } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+`,
+            },
+            {
+                path: 'src/button.tsx',
+                content: `import * as React from 'react';
+import { cn } from './utils.js';
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: 'primary' | 'secondary' | 'outline' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+}
+
+export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant = 'primary', size = 'md', ...props }, ref) => {
+    return (
+      <button
+        className={cn(
+          'inline-flex items-center justify-center rounded-md font-medium transition-colors',
+          'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2',
+          'disabled:pointer-events-none disabled:opacity-50',
+          {
+            // Variants
+            'bg-primary-600 text-white hover:bg-primary-500': variant === 'primary',
+            'bg-secondary-100 text-secondary-900 hover:bg-secondary-200': variant === 'secondary',
+            'border border-secondary-300 bg-transparent hover:bg-secondary-50': variant === 'outline',
+            'bg-transparent hover:bg-secondary-100': variant === 'ghost',
+            // Sizes
+            'h-8 px-3 text-sm': size === 'sm',
+            'h-10 px-4 text-sm': size === 'md',
+            'h-12 px-6 text-base': size === 'lg',
+          },
+          className
+        )}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+
+Button.displayName = 'Button';
+`,
+            },
+            {
+                path: 'src/card.tsx',
+                content: `import * as React from 'react';
+import { cn } from './utils.js';
+
+export interface CardProps extends React.HTMLAttributes<HTMLDivElement> {}
+
+export const Card = React.forwardRef<HTMLDivElement, CardProps>(
+  ({ className, ...props }, ref) => (
+    <div
+      ref={ref}
+      className={cn(
+        'rounded-lg border border-secondary-200 bg-white shadow-sm',
+        className
+      )}
+      {...props}
+    />
+  )
+);
+
+Card.displayName = 'Card';
+
+export const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn('flex flex-col space-y-1.5 p-6', className)}
+    {...props}
+  />
+));
+
+CardHeader.displayName = 'CardHeader';
+
+export const CardTitle = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLHeadingElement>
+>(({ className, ...props }, ref) => (
+  <h3
+    ref={ref}
+    className={cn('text-lg font-semibold leading-none tracking-tight', className)}
+    {...props}
+  />
+));
+
+CardTitle.displayName = 'CardTitle';
+
+export const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn('p-6 pt-0', className)} {...props} />
+));
+
+CardContent.displayName = 'CardContent';
+`,
+            },
+        ],
+    };
+}
+/**
+ * Generate a complete "all" project (FE + BE + Website)
+ *
+ * @param spec - Project specification
+ * @param outputDir - Output directory
+ * @returns Generation result
+ */
+export async function generateAllProject(spec, outputDir) {
+    const projectName = spec.name || 'my-project';
+    const projectDir = path.join(outputDir, projectName);
+    const filesCreated = [];
+    try {
+        // Create root structure
+        await ensureDir(projectDir);
+        await ensureDir(path.join(projectDir, 'packages'));
+        await ensureDir(path.join(projectDir, 'packages', 'design-tokens', 'src'));
+        await ensureDir(path.join(projectDir, 'packages', 'ui', 'src'));
+        await ensureDir(path.join(projectDir, 'packages', 'contracts'));
+        await ensureDir(path.join(projectDir, '.popeye'));
+        // Generate fullstack first (creates apps/frontend and apps/backend)
+        const fullstackResult = await generateFullstackProject(spec, outputDir);
+        if (!fullstackResult.success) {
+            return fullstackResult;
+        }
+        filesCreated.push(...fullstackResult.filesCreated);
+        // Generate website app
+        const websiteResult = await generateWebsiteProject(spec, projectDir, {
+            baseDir: path.join(projectDir, 'apps', 'website'),
+            workspaceMode: true,
+            skipDocker: false, // Website needs its own Dockerfile
+            skipReadme: false,
+        });
+        if (!websiteResult.success) {
+            return {
+                ...websiteResult,
+                filesCreated,
+            };
+        }
+        filesCreated.push(...websiteResult.filesCreated);
+        // Generate shared packages
+        const designTokens = generateDesignTokensPackage(projectName);
+        for (const file of designTokens.files) {
+            const filePath = path.join(projectDir, 'packages', 'design-tokens', file.path);
+            await ensureDir(path.dirname(filePath));
+            await writeFile(filePath, file.content);
+            filesCreated.push(filePath);
+        }
+        const uiPackage = generateUiPackage(projectName);
+        for (const file of uiPackage.files) {
+            const filePath = path.join(projectDir, 'packages', 'ui', file.path);
+            await ensureDir(path.dirname(filePath));
+            await writeFile(filePath, file.content);
+            filesCreated.push(filePath);
+        }
+        // Contracts placeholder
+        await writeFile(path.join(projectDir, 'packages', 'contracts', '.gitkeep'), '');
+        filesCreated.push(path.join(projectDir, 'packages', 'contracts', '.gitkeep'));
+        // Override root files for "all" project
+        const rootFiles = [
+            // Root package.json (npm workspaces)
+            {
+                path: path.join(projectDir, 'package.json'),
+                content: generateRootPackageJson(projectName),
+            },
+            // Workspace config
+            {
+                path: path.join(projectDir, '.popeye', 'workspace.json'),
+                content: generateAllWorkspaceJson(projectName),
+            },
+            // Docker compose (override to include website)
+            {
+                path: path.join(projectDir, 'docker-compose.yml'),
+                content: generateAllDockerCompose(projectName),
+            },
+            {
+                path: path.join(projectDir, 'infra', 'docker', 'docker-compose.yml'),
+                content: generateAllDockerCompose(projectName),
+            },
+            // README
+            {
+                path: path.join(projectDir, 'README.md'),
+                content: generateAllRootReadme(projectName, spec.idea),
+            },
+        ];
+        for (const file of rootFiles) {
+            await writeFile(file.path, file.content);
+            // Only add if not already in list (avoid duplicates)
+            if (!filesCreated.includes(file.path)) {
+                filesCreated.push(file.path);
+            }
+        }
+        return {
+            success: true,
+            projectDir,
+            filesCreated,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            projectDir,
+            filesCreated,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+/**
+ * Get the list of files that would be generated for an "all" project
+ *
+ * @param projectName - Project name
+ * @returns List of relative file paths
+ */
+export function getAllProjectFiles(projectName) {
+    const packageName = toPythonPackageName(projectName);
+    return [
+        // Root
+        'package.json',
+        '.popeye/workspace.json',
+        '.popeye/ui-spec.json',
+        'infra/docker/docker-compose.yml',
+        'docker-compose.yml',
+        'README.md',
+        '.gitignore',
+        'docs/PLAN.md',
+        'docs/WORKFLOW_LOG.md',
+        // Frontend (same as fullstack)
+        'apps/frontend/package.json',
+        'apps/frontend/src/main.tsx',
+        'apps/frontend/src/App.tsx',
+        // Backend (same as fullstack)
+        'apps/backend/pyproject.toml',
+        `apps/backend/src/${packageName}/main.py`,
+        // Website
+        'apps/website/package.json',
+        'apps/website/next.config.mjs',
+        'apps/website/src/app/layout.tsx',
+        'apps/website/src/app/page.tsx',
+        'apps/website/src/app/sitemap.ts',
+        'apps/website/src/app/robots.ts',
+        // Shared packages
+        'packages/design-tokens/package.json',
+        'packages/design-tokens/src/index.ts',
+        'packages/design-tokens/src/colors.ts',
+        'packages/design-tokens/src/tailwind-preset.ts',
+        'packages/ui/package.json',
+        'packages/ui/src/index.ts',
+        'packages/ui/src/button.tsx',
+        'packages/ui/src/card.tsx',
+        'packages/contracts/.gitkeep',
+    ];
+}
+/**
+ * Validate an "all" project structure
+ *
+ * @param projectDir - Project directory
+ * @returns Validation result
+ */
+export async function validateAllProject(projectDir) {
+    const missingFiles = [];
+    const requiredPaths = [
+        // Root
+        'package.json',
+        '.popeye/workspace.json',
+        'docker-compose.yml',
+        'README.md',
+        // Frontend
+        'apps/frontend/package.json',
+        'apps/frontend/src',
+        // Backend
+        'apps/backend/pyproject.toml',
+        'apps/backend/src',
+        // Website
+        'apps/website/package.json',
+        'apps/website/src/app/layout.tsx',
+        'apps/website/src/app/sitemap.ts',
+        // Shared packages
+        'packages/design-tokens/package.json',
+        'packages/ui/package.json',
+    ];
+    for (const file of requiredPaths) {
+        const filePath = path.join(projectDir, file);
+        try {
+            await fs.access(filePath);
+        }
+        catch {
+            missingFiles.push(file);
+        }
+    }
+    return {
+        valid: missingFiles.length === 0,
+        missingFiles,
+    };
+}
+//# sourceMappingURL=all.js.map