popeye-cli 1.2.0 → 1.3.0

package/src/generators/all.ts

@@ -0,0 +1,897 @@
+/**
+ * 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 type { ProjectSpec, WorkspaceConfig } from '../types/project.js';
+import type { GenerationResult } from './python.js';
+import { generateFullstackProject } from './fullstack.js';
+import { generateWebsiteProject } from './website.js';
+
+/**
+ * Options for all project generation
+ */
+export interface AllGeneratorOptions {
+  skipWebsite?: boolean;
+  skipSharedPackages?: boolean;
+  includeExamples?: boolean;
+}
+
+/**
+ * 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 workspace.json for "all" projects
+ */
+function generateAllWorkspaceJson(projectName: string): string {
+  const packageName = toPythonPackageName(projectName);
+
+  const config: WorkspaceConfig = {
+    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: string): string {
+  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: string): string {
+  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: string, idea: string): string {
+  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: string): {
+  files: Array<{ path: string; content: string }>;
+} {
+  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: string): {
+  files: Array<{ path: string; content: string }>;
+} {
+  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: ProjectSpec,
+  outputDir: string
+): Promise<GenerationResult> {
+  const projectName = spec.name || 'my-project';
+  const projectDir = path.join(outputDir, projectName);
+  const filesCreated: string[] = [];
+
+  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: Array<{ path: string; content: string }> = [
+      // 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: string): string[] {
+  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: string): Promise<{
+  valid: boolean;
+  missingFiles: string[];
+}> {
+  const missingFiles: string[] = [];
+
+  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,
+  };
+}