popeye-cli 1.0.1 → 1.2.0

package/src/generators/fullstack.ts

@@ -0,0 +1,551 @@
+/**
+ * Fullstack project generator
+ * Orchestrates Python and TypeScript generators for monorepo structure
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import type { ProjectSpec } from '../types/project.js';
+import type { GenerationResult } from './python.js';
+import {
+  generateWorkspaceJson,
+  generateRootDockerCompose,
+  generateRootReadme,
+  generateRootGitignore,
+  generateFrontendReadme,
+  generateBackendReadme,
+  generateUiSpec,
+  generateViteConfigReact,
+  generateTailwindConfig,
+  generatePostcssConfig,
+  generateMainCss,
+  generateAppTsx,
+  generateMainTsx,
+  generateIndexHtml,
+  generateFrontendPackageJson,
+  generateFrontendTsconfig,
+  generateFrontendTsconfigNode,
+  generateFrontendDockerfile,
+  generateNginxConfig,
+  generateFrontendTest,
+  generateVitestSetup,
+  generateFrontendVitestConfig,
+  generateFastAPIMain,
+  generateBackendDockerfile,
+  generateFastAPIRequirements,
+} from './templates/fullstack.js';
+
+/**
+ * Create a directory if it doesn't exist
+ */
+async function ensureDir(dirPath: string): Promise<void> {
+  await fs.mkdir(dirPath, { recursive: true });
+}
+
+/**
+ * Write a file with content
+ */
+async function writeFile(filePath: string, content: string): Promise<void> {
+  await fs.writeFile(filePath, content, 'utf-8');
+}
+
+/**
+ * Convert project name to Python package name
+ */
+function toPythonPackageName(name: string): string {
+  return name.toLowerCase().replace(/-/g, '_').replace(/[^a-z0-9_]/g, '');
+}
+
+/**
+ * Generate a complete fullstack project (React frontend + FastAPI backend)
+ *
+ * @param spec - Project specification
+ * @param outputDir - Output directory
+ * @returns Generation result
+ */
+export async function generateFullstackProject(
+  spec: ProjectSpec,
+  outputDir: string
+): Promise<GenerationResult> {
+  const projectName = spec.name || 'my-project';
+  const projectDir = path.join(outputDir, projectName);
+  const packageName = toPythonPackageName(projectName);
+  const filesCreated: string[] = [];
+
+  try {
+    // Create root directory structure
+    await ensureDir(projectDir);
+    await ensureDir(path.join(projectDir, 'apps'));
+    await ensureDir(path.join(projectDir, 'apps', 'frontend'));
+    await ensureDir(path.join(projectDir, 'apps', 'frontend', 'src'));
+    await ensureDir(path.join(projectDir, 'apps', 'frontend', 'tests'));
+    await ensureDir(path.join(projectDir, 'apps', 'frontend', 'public'));
+    await ensureDir(path.join(projectDir, 'apps', 'backend'));
+    await ensureDir(path.join(projectDir, 'apps', 'backend', 'src', packageName));
+    await ensureDir(path.join(projectDir, 'apps', 'backend', 'tests'));
+    await ensureDir(path.join(projectDir, 'packages', 'contracts'));
+    await ensureDir(path.join(projectDir, 'infra', 'docker'));
+    await ensureDir(path.join(projectDir, 'docs'));
+    await ensureDir(path.join(projectDir, '.popeye'));
+
+    // Generate root-level files
+    const rootFiles: Array<{ path: string; content: string }> = [
+      // Root config
+      {
+        path: path.join(projectDir, '.popeye', 'workspace.json'),
+        content: generateWorkspaceJson(projectName),
+      },
+      {
+        path: path.join(projectDir, '.popeye', 'ui-spec.json'),
+        content: generateUiSpec(projectName),
+      },
+      // Docker
+      {
+        path: path.join(projectDir, 'infra', 'docker', 'docker-compose.yml'),
+        content: generateRootDockerCompose(projectName),
+      },
+      {
+        path: path.join(projectDir, 'docker-compose.yml'),
+        content: generateRootDockerCompose(projectName),
+      },
+      // Documentation
+      {
+        path: path.join(projectDir, 'README.md'),
+        content: generateRootReadme(projectName, spec.idea),
+      },
+      {
+        path: path.join(projectDir, '.gitignore'),
+        content: generateRootGitignore(),
+      },
+      // Docs placeholders
+      {
+        path: path.join(projectDir, 'docs', 'PLAN.md'),
+        content: `# ${projectName} - Development Plan\n\nGenerated by Popeye CLI.\n`,
+      },
+      {
+        path: path.join(projectDir, 'docs', 'WORKFLOW_LOG.md'),
+        content: `# ${projectName} - Workflow Log\n\nGenerated by Popeye CLI.\n`,
+      },
+      // Packages placeholder
+      {
+        path: path.join(projectDir, 'packages', 'contracts', '.gitkeep'),
+        content: '',
+      },
+    ];
+
+    // Write root files
+    for (const file of rootFiles) {
+      await writeFile(file.path, file.content);
+      filesCreated.push(file.path);
+    }
+
+    // Generate frontend (React + Vite + Tailwind)
+    const frontendDir = path.join(projectDir, 'apps', 'frontend');
+    const frontendFiles: Array<{ path: string; content: string }> = [
+      // Config files
+      {
+        path: path.join(frontendDir, 'package.json'),
+        content: generateFrontendPackageJson(projectName),
+      },
+      {
+        path: path.join(frontendDir, 'tsconfig.json'),
+        content: generateFrontendTsconfig(),
+      },
+      {
+        path: path.join(frontendDir, 'tsconfig.node.json'),
+        content: generateFrontendTsconfigNode(),
+      },
+      {
+        path: path.join(frontendDir, 'vite.config.ts'),
+        content: generateViteConfigReact(),
+      },
+      {
+        path: path.join(frontendDir, 'vitest.config.ts'),
+        content: generateFrontendVitestConfig(),
+      },
+      {
+        path: path.join(frontendDir, 'tailwind.config.ts'),
+        content: generateTailwindConfig(),
+      },
+      {
+        path: path.join(frontendDir, 'postcss.config.js'),
+        content: generatePostcssConfig(),
+      },
+      // Entry files
+      {
+        path: path.join(frontendDir, 'index.html'),
+        content: generateIndexHtml(projectName),
+      },
+      {
+        path: path.join(frontendDir, 'src', 'main.tsx'),
+        content: generateMainTsx(),
+      },
+      {
+        path: path.join(frontendDir, 'src', 'App.tsx'),
+        content: generateAppTsx(projectName),
+      },
+      {
+        path: path.join(frontendDir, 'src', 'index.css'),
+        content: generateMainCss(),
+      },
+      {
+        path: path.join(frontendDir, 'src', 'vite-env.d.ts'),
+        content: '/// <reference types="vite/client" />\n',
+      },
+      // Test files
+      {
+        path: path.join(frontendDir, 'tests', 'setup.ts'),
+        content: generateVitestSetup(),
+      },
+      {
+        path: path.join(frontendDir, 'tests', 'App.test.tsx'),
+        content: generateFrontendTest(projectName),
+      },
+      // Docker
+      {
+        path: path.join(frontendDir, 'Dockerfile'),
+        content: generateFrontendDockerfile(),
+      },
+      {
+        path: path.join(frontendDir, 'nginx.conf'),
+        content: generateNginxConfig(),
+      },
+      // Documentation
+      {
+        path: path.join(frontendDir, 'README.md'),
+        content: generateFrontendReadme(projectName),
+      },
+      // Environment
+      {
+        path: path.join(frontendDir, '.env.example'),
+        content: 'VITE_API_URL=http://localhost:8000\n',
+      },
+      {
+        path: path.join(frontendDir, '.gitignore'),
+        content: 'node_modules/\ndist/\n.env\n.env.local\ncoverage/\n',
+      },
+    ];
+
+    // Write frontend files
+    for (const file of frontendFiles) {
+      await writeFile(file.path, file.content);
+      filesCreated.push(file.path);
+    }
+
+    // Generate backend (FastAPI)
+    const backendDir = path.join(projectDir, 'apps', 'backend');
+    const backendFiles: Array<{ path: string; content: string }> = [
+      // Config files
+      {
+        path: path.join(backendDir, 'pyproject.toml'),
+        content: generatePyprojectToml(projectName, packageName),
+      },
+      {
+        path: path.join(backendDir, 'requirements.txt'),
+        content: generateFastAPIRequirements(),
+      },
+      // Source files
+      {
+        path: path.join(backendDir, 'src', '__init__.py'),
+        content: '# Source root\n',
+      },
+      {
+        path: path.join(backendDir, 'src', packageName, '__init__.py'),
+        content: `"""${projectName} backend package."""\n\n__version__ = "1.0.0"\n`,
+      },
+      {
+        path: path.join(backendDir, 'src', packageName, 'main.py'),
+        content: generateFastAPIMain(projectName),
+      },
+      // Test files
+      {
+        path: path.join(backendDir, 'tests', '__init__.py'),
+        content: '# Tests package\n',
+      },
+      {
+        path: path.join(backendDir, 'tests', 'conftest.py'),
+        content: generateConftest(),
+      },
+      {
+        path: path.join(backendDir, 'tests', 'test_main.py'),
+        content: generateBackendTest(projectName, packageName),
+      },
+      // Docker
+      {
+        path: path.join(backendDir, 'Dockerfile'),
+        content: generateBackendDockerfile(projectName),
+      },
+      // Documentation
+      {
+        path: path.join(backendDir, 'README.md'),
+        content: generateBackendReadme(projectName),
+      },
+      // Environment
+      {
+        path: path.join(backendDir, '.env.example'),
+        content: 'DEBUG=true\nDATABASE_URL=sqlite:///./data/app.db\n',
+      },
+      {
+        path: path.join(backendDir, '.gitignore'),
+        content: '__pycache__/\n*.py[cod]\nvenv/\n.venv/\n.env\n.coverage\nhtmlcov/\n.pytest_cache/\ndata/\n',
+      },
+      // Makefile
+      {
+        path: path.join(backendDir, 'Makefile'),
+        content: generateBackendMakefile(packageName),
+      },
+    ];
+
+    // Write backend files
+    for (const file of backendFiles) {
+      await writeFile(file.path, file.content);
+      filesCreated.push(file.path);
+    }
+
+    return {
+      success: true,
+      projectDir,
+      filesCreated,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      projectDir,
+      filesCreated,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}
+
+/**
+ * Generate pyproject.toml for FastAPI backend
+ */
+function generatePyprojectToml(projectName: string, _packageName: string): string {
+  return `[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "${projectName}-backend"
+version = "1.0.0"
+description = "Backend API for ${projectName}"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+dependencies = [
+    "fastapi>=0.109.0",
+    "uvicorn[standard]>=0.27.0",
+    "pydantic>=2.5.0",
+    "pydantic-settings>=2.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-asyncio>=0.23.0",
+    "httpx>=0.26.0",
+    "ruff>=0.1.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+`;
+}
+
+/**
+ * Generate conftest.py for backend tests
+ */
+function generateConftest(): string {
+  return `"""
+Test configuration and fixtures.
+"""
+
+import pytest
+from httpx import AsyncClient
+from httpx import ASGITransport
+
+
+@pytest.fixture
+def anyio_backend():
+    """Use asyncio backend for pytest-anyio."""
+    return "asyncio"
+
+
+@pytest.fixture
+async def client():
+    """Create async test client."""
+    from src.backend.main import app
+
+    transport = ASGITransport(app=app)
+    async with AsyncClient(transport=transport, base_url="http://test") as client:
+        yield client
+`;
+}
+
+/**
+ * Generate test file for backend
+ */
+function generateBackendTest(projectName: string, _packageName: string): string {
+  return `"""
+Tests for ${projectName} backend API.
+"""
+
+import pytest
+from httpx import AsyncClient
+
+
+@pytest.mark.anyio
+async def test_health_check(client: AsyncClient):
+    """Test health check endpoint."""
+    response = await client.get("/health")
+    assert response.status_code == 200
+    data = response.json()
+    assert data["status"] == "healthy"
+
+
+@pytest.mark.anyio
+async def test_root(client: AsyncClient):
+    """Test root endpoint."""
+    response = await client.get("/")
+    assert response.status_code == 200
+    data = response.json()
+    assert "message" in data
+    assert "docs" in data
+`;
+}
+
+/**
+ * Generate Makefile for backend
+ */
+function generateBackendMakefile(packageName: string): string {
+  return `.PHONY: dev test lint format clean install
+
+install:
+\tpip install -e ".[dev]"
+
+dev:
+\tuvicorn src.${packageName}.main:app --reload --port 8000
+
+test:
+\tpytest -v
+
+test-cov:
+\tpytest --cov=src/${packageName} --cov-report=html
+
+lint:
+\truff check src/ tests/
+
+format:
+\truff format src/ tests/
+
+clean:
+\trm -rf __pycache__ .pytest_cache .coverage htmlcov .ruff_cache
+\tfind . -type d -name "__pycache__" -exec rm -rf {} +
+`;
+}
+
+/**
+ * Get the list of files that would be generated for a fullstack project
+ *
+ * @param projectName - Project name
+ * @returns List of relative file paths
+ */
+export function getFullstackProjectFiles(projectName: string): string[] {
+  const packageName = toPythonPackageName(projectName);
+
+  return [
+    // Root
+    '.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',
+    'packages/contracts/.gitkeep',
+    // Frontend
+    'apps/frontend/package.json',
+    'apps/frontend/tsconfig.json',
+    'apps/frontend/tsconfig.node.json',
+    'apps/frontend/vite.config.ts',
+    'apps/frontend/vitest.config.ts',
+    'apps/frontend/tailwind.config.ts',
+    'apps/frontend/postcss.config.js',
+    'apps/frontend/index.html',
+    'apps/frontend/src/main.tsx',
+    'apps/frontend/src/App.tsx',
+    'apps/frontend/src/index.css',
+    'apps/frontend/src/vite-env.d.ts',
+    'apps/frontend/tests/setup.ts',
+    'apps/frontend/tests/App.test.tsx',
+    'apps/frontend/Dockerfile',
+    'apps/frontend/nginx.conf',
+    'apps/frontend/README.md',
+    'apps/frontend/.env.example',
+    'apps/frontend/.gitignore',
+    // Backend
+    'apps/backend/pyproject.toml',
+    'apps/backend/requirements.txt',
+    'apps/backend/src/__init__.py',
+    `apps/backend/src/${packageName}/__init__.py`,
+    `apps/backend/src/${packageName}/main.py`,
+    'apps/backend/tests/__init__.py',
+    'apps/backend/tests/conftest.py',
+    'apps/backend/tests/test_main.py',
+    'apps/backend/Dockerfile',
+    'apps/backend/README.md',
+    'apps/backend/.env.example',
+    'apps/backend/.gitignore',
+    'apps/backend/Makefile',
+  ];
+}
+
+/**
+ * Validate a fullstack project structure
+ *
+ * @param projectDir - Project directory
+ * @returns Validation result
+ */
+export async function validateFullstackProject(projectDir: string): Promise<{
+  valid: boolean;
+  missingFiles: string[];
+}> {
+  const missingFiles: string[] = [];
+
+  const requiredPaths = [
+    'apps/frontend/package.json',
+    'apps/frontend/src',
+    'apps/backend/pyproject.toml',
+    'apps/backend/src',
+    '.popeye/workspace.json',
+    'docker-compose.yml',
+    'README.md',
+  ];
+
+  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,
+  };
+}

package/src/generators/index.ts

@@ -1,6 +1,6 @@
 /**
  * Project generators module
- * Provides unified API for generating Python and TypeScript projects
+ * Provides unified API for generating Python, TypeScript, and Fullstack projects
  */
 
 import type { ProjectSpec, OutputLanguage } from '../types/project.js';
@@ -17,6 +17,11 @@ import {
   addTypeScriptModule,
   getTypeScriptProjectFiles,
 } from './typescript.js';
+import {
+  generateFullstackProject,
+  validateFullstackProject,
+  getFullstackProjectFiles,
+} from './fullstack.js';
 
 // Re-export (explicitly to avoid name conflicts)
 export {
@@ -25,6 +30,7 @@ export {
   addPythonModule,
   getPythonProjectFiles,
   type GenerationResult,
+  type PythonGeneratorOptions,
 } from './python.js';
 export {
   generateTypeScriptProject,
@@ -33,7 +39,13 @@ export {
   getTypeScriptProjectFiles,
   addDependency,
   updateScripts,
+  type TypeScriptGeneratorOptions,
 } from './typescript.js';
+export {
+  generateFullstackProject,
+  validateFullstackProject,
+  getFullstackProjectFiles,
+} from './fullstack.js';
 export * from './templates/index.js';
 
 /**
@@ -52,6 +64,8 @@ export async function generateProject(
       return generatePythonProject(spec, outputDir);
     case 'typescript':
       return generateTypeScriptProject(spec, outputDir);
+    case 'fullstack':
+      return generateFullstackProject(spec, outputDir);
     default:
       return {
         success: false,
@@ -81,6 +95,8 @@ export async function validateProject(
       return validatePythonProject(projectDir);
     case 'typescript':
       return validateTypeScriptProject(projectDir);
+    case 'fullstack':
+      return validateFullstackProject(projectDir);
     default:
       return {
         valid: false,
@@ -125,6 +141,8 @@ export function getProjectFiles(projectName: string, language: OutputLanguage):
       return getPythonProjectFiles(projectName);
     case 'typescript':
       return getTypeScriptProjectFiles(projectName);
+    case 'fullstack':
+      return getFullstackProjectFiles(projectName);
     default:
       return [];
   }
@@ -142,6 +160,8 @@ export function getTestCommand(language: OutputLanguage): string {
       return 'python -m pytest tests/ -v';
     case 'typescript':
       return 'npm test';
+    case 'fullstack':
+      return 'cd apps/backend && pytest && cd ../frontend && npm test';
     default:
       return 'echo "No test command configured"';
   }
@@ -159,6 +179,8 @@ export function getBuildCommand(language: OutputLanguage): string {
       return 'python -m pip install -e .';
     case 'typescript':
       return 'npm run build';
+    case 'fullstack':
+      return 'cd apps/backend && pip install -e . && cd ../frontend && npm run build';
     default:
       return 'echo "No build command configured"';
   }
@@ -176,6 +198,8 @@ export function getLintCommand(language: OutputLanguage): string {
       return 'ruff check src/ tests/';
     case 'typescript':
       return 'npm run lint';
+    case 'fullstack':
+      return 'cd apps/backend && ruff check . && cd ../frontend && npm run lint';
     default:
       return 'echo "No lint command configured"';
   }