@hasna/skills 0.1.27 → 0.1.29

package/skills/scaffold-project/src/index.ts

@@ -5,1000 +5,17 @@
  * Generates complete project boilerplates from plain English descriptions
  */
 
-import { parseArgs } from "util";
-import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { spawnSync } from "child_process";
-import { join } from "path";
-
-// ============================================================================
-// Security: Allowlist for Package Managers
-// ============================================================================
-
-const ALLOWED_PACKAGE_MANAGERS = ['npm', 'yarn', 'pnpm', 'bun'] as const;
-
-function validatePackageManager(pm: string): asserts pm is PackageManager {
-  if (!ALLOWED_PACKAGE_MANAGERS.includes(pm as PackageManager)) {
-    throw new Error(
-      `Invalid package manager: "${pm}". Must be one of: ${ALLOWED_PACKAGE_MANAGERS.join(', ')}`
-    );
-  }
-}
-
-// ============================================================================
-// Types & Interfaces
-// ============================================================================
-
-type Template =
-  | 'next' | 'react' | 'vue' | 'svelte' | 'astro' | 'remix'
-  | 'express' | 'fastapi' | 'hono' | 'elysia' | 'nestjs'
-  | 't3' | 'nextjs-supabase' | 'remix-prisma'
-  | 'rest-api' | 'graphql' | 'trpc'
-  | 'cli' | 'chrome-extension' | 'electron' | 'react-native' | 'tauri' | 'monorepo';
-
-type Database = 'prisma' | 'drizzle' | 'supabase' | 'none';
-type Auth = 'nextauth' | 'clerk' | 'lucia' | 'supabase' | 'none';
-type Testing = 'vitest' | 'playwright' | 'both' | 'none';
-type State = 'zustand' | 'jotai' | 'redux' | 'none';
-type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';
-
-interface ScaffoldOptions {
-  description?: string;
-  template?: Template;
-  name?: string;
-  output?: string;
-  typescript: boolean;
-  tailwind: boolean;
-  shadcn: boolean;
-  database: Database;
-  auth: Auth;
-  testing: Testing;
-  state: State;
-  git: boolean;
-  install: boolean;
-  pm: PackageManager;
-  dryRun: boolean;
-  verbose: boolean;
-}
-
-interface ProjectConfig {
-  name: string;
-  template: Template;
-  outputDir: string;
-  dependencies: string[];
-  devDependencies: string[];
-  scripts: Record<string, string>;
-  files: Array<{ path: string; content: string }>;
-  features: string[];
-}
-
-// ============================================================================
-// Template Definitions
-// ============================================================================
-
-const TEMPLATES: Record<Template, {
-  name: string;
-  description: string;
-  category: string;
-  defaultDeps: string[];
-  defaultDevDeps: string[];
-}> = {
-  next: {
-    name: 'Next.js 15',
-    description: 'Next.js 15 App Router with React, TypeScript, and Tailwind',
-    category: 'frontend',
-    defaultDeps: ['next', 'react', 'react-dom'],
-    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
-  },
-  react: {
-    name: 'React + Vite',
-    description: 'Vite + React + TypeScript',
-    category: 'frontend',
-    defaultDeps: ['react', 'react-dom'],
-    defaultDevDeps: ['@types/react', '@types/react-dom', '@vitejs/plugin-react', 'typescript', 'vite'],
-  },
-  vue: {
-    name: 'Vue 3 + Vite',
-    description: 'Vite + Vue 3 + TypeScript',
-    category: 'frontend',
-    defaultDeps: ['vue'],
-    defaultDevDeps: ['@vitejs/plugin-vue', 'typescript', 'vite', 'vue-tsc'],
-  },
-  svelte: {
-    name: 'SvelteKit',
-    description: 'SvelteKit + TypeScript',
-    category: 'frontend',
-    defaultDeps: ['svelte'],
-    defaultDevDeps: ['@sveltejs/adapter-auto', '@sveltejs/kit', 'typescript', 'vite'],
-  },
-  astro: {
-    name: 'Astro',
-    description: 'Astro + TypeScript',
-    category: 'frontend',
-    defaultDeps: ['astro'],
-    defaultDevDeps: ['@astrojs/tailwind', 'typescript'],
-  },
-  remix: {
-    name: 'Remix',
-    description: 'Remix + TypeScript',
-    category: 'frontend',
-    defaultDeps: ['@remix-run/node', '@remix-run/react', '@remix-run/serve', 'react', 'react-dom'],
-    defaultDevDeps: ['@remix-run/dev', '@types/react', '@types/react-dom', 'typescript'],
-  },
-  express: {
-    name: 'Express.js',
-    description: 'Express + TypeScript',
-    category: 'backend',
-    defaultDeps: ['express', 'cors', 'dotenv'],
-    defaultDevDeps: ['@types/express', '@types/cors', '@types/node', 'typescript', 'tsx'],
-  },
-  fastapi: {
-    name: 'FastAPI',
-    description: 'FastAPI + Python',
-    category: 'backend',
-    defaultDeps: ['fastapi', 'uvicorn', 'pydantic'],
-    defaultDevDeps: ['black', 'pytest'],
-  },
-  hono: {
-    name: 'Hono',
-    description: 'Hono + TypeScript (edge-ready)',
-    category: 'backend',
-    defaultDeps: ['hono'],
-    defaultDevDeps: ['@types/node', 'typescript'],
-  },
-  elysia: {
-    name: 'Elysia',
-    description: 'Elysia + Bun + TypeScript',
-    category: 'backend',
-    defaultDeps: ['elysia'],
-    defaultDevDeps: ['bun-types'],
-  },
-  nestjs: {
-    name: 'NestJS',
-    description: 'NestJS + TypeScript',
-    category: 'backend',
-    defaultDeps: ['@nestjs/common', '@nestjs/core', '@nestjs/platform-express', 'reflect-metadata', 'rxjs'],
-    defaultDevDeps: ['@nestjs/cli', '@types/node', 'typescript'],
-  },
-  t3: {
-    name: 'T3 Stack',
-    description: 'Next.js + tRPC + Prisma + NextAuth',
-    category: 'fullstack',
-    defaultDeps: ['next', 'react', 'react-dom', '@trpc/client', '@trpc/server', '@trpc/react-query', '@tanstack/react-query', 'zod'],
-    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
-  },
-  'nextjs-supabase': {
-    name: 'Next.js + Supabase',
-    description: 'Next.js + Supabase',
-    category: 'fullstack',
-    defaultDeps: ['next', 'react', 'react-dom', '@supabase/supabase-js'],
-    defaultDevDeps: ['@types/node', '@types/react', '@types/react-dom', 'typescript'],
-  },
-  'remix-prisma': {
-    name: 'Remix + Prisma',
-    description: 'Remix + Prisma ORM',
-    category: 'fullstack',
-    defaultDeps: ['@remix-run/node', '@remix-run/react', '@remix-run/serve', 'react', 'react-dom', '@prisma/client'],
-    defaultDevDeps: ['@remix-run/dev', '@types/react', '@types/react-dom', 'typescript', 'prisma'],
-  },
-  'rest-api': {
-    name: 'REST API',
-    description: 'REST API boilerplate',
-    category: 'api',
-    defaultDeps: ['express', 'cors', 'dotenv'],
-    defaultDevDeps: ['@types/express', '@types/cors', '@types/node', 'typescript', 'tsx'],
-  },
-  graphql: {
-    name: 'GraphQL API',
-    description: 'GraphQL API (Apollo Server)',
-    category: 'api',
-    defaultDeps: ['@apollo/server', 'graphql'],
-    defaultDevDeps: ['@types/node', 'typescript'],
-  },
-  trpc: {
-    name: 'tRPC API',
-    description: 'tRPC API',
-    category: 'api',
-    defaultDeps: ['@trpc/server', 'zod'],
-    defaultDevDeps: ['@types/node', 'typescript'],
-  },
-  cli: {
-    name: 'CLI Tool',
-    description: 'CLI tool with Commander.js or Bun',
-    category: 'other',
-    defaultDeps: ['commander'],
-    defaultDevDeps: ['@types/node', 'typescript'],
-  },
-  'chrome-extension': {
-    name: 'Chrome Extension',
-    description: 'Chrome extension boilerplate',
-    category: 'other',
-    defaultDeps: [],
-    defaultDevDeps: ['@types/chrome', 'typescript'],
-  },
-  electron: {
-    name: 'Electron',
-    description: 'Electron desktop app',
-    category: 'other',
-    defaultDeps: ['electron'],
-    defaultDevDeps: ['@types/node', 'typescript'],
-  },
-  'react-native': {
-    name: 'React Native',
-    description: 'React Native mobile app',
-    category: 'other',
-    defaultDeps: ['react', 'react-native'],
-    defaultDevDeps: ['@types/react', 'typescript'],
-  },
-  tauri: {
-    name: 'Tauri',
-    description: 'Tauri desktop app',
-    category: 'other',
-    defaultDeps: ['@tauri-apps/api'],
-    defaultDevDeps: ['@tauri-apps/cli', 'typescript'],
-  },
-  monorepo: {
-    name: 'Turborepo Monorepo',
-    description: 'Turborepo monorepo',
-    category: 'other',
-    defaultDeps: [],
-    defaultDevDeps: ['turbo'],
-  },
-};
-
-// ============================================================================
-// AI Template Detection
-// ============================================================================
-
-async function detectTemplate(description: string, verbose: boolean): Promise<{ template: Template; features: string[] }> {
-  const apiKey = process.env.OPENAI_API_KEY || process.env.ANTHROPIC_API_KEY;
-
-  if (!apiKey) {
-    console.error('❌ No API key found for AI detection.');
-    console.error('Set OPENAI_API_KEY or ANTHROPIC_API_KEY, or use --template to specify manually.');
-    process.exit(1);
-  }
-
-  if (verbose) {
-    console.log('🤖 Analyzing description with AI...');
-  }
-
-  const prompt = `Analyze this project description and select the BEST matching template from the list below.
-
-Project Description: "${description}"
-
-Available Templates:
-${Object.entries(TEMPLATES).map(([key, val]) => `- ${key}: ${val.description}`).join('\n')}
-
-Also suggest which of these features to include:
-- database: prisma, drizzle, supabase, none
-- auth: nextauth, clerk, lucia, supabase, none
-- testing: vitest, playwright, both, none
-- state: zustand, jotai, redux, none
-- shadcn: true, false
-- tailwind: true, false
-
-Respond ONLY with valid JSON in this format:
-{
-  "template": "template-name",
-  "features": {
-    "database": "prisma or drizzle or supabase or none",
-    "auth": "nextauth or clerk or lucia or supabase or none",
-    "testing": "vitest or playwright or both or none",
-    "state": "zustand or jotai or redux or none",
-    "shadcn": true or false,
-    "tailwind": true or false
-  },
-  "reasoning": "Brief explanation of why this template was chosen"
-}`;
-
-  try {
-    let response: any;
-
-    if (process.env.OPENAI_API_KEY) {
-      // Use OpenAI
-      const res = await fetch('https://api.openai.com/v1/chat/completions', {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${process.env.OPENAI_API_KEY}`,
-        },
-        body: JSON.stringify({
-          model: 'gpt-4o-mini',
-          messages: [
-            { role: 'system', content: 'You are a helpful assistant that selects appropriate project templates.' },
-            { role: 'user', content: prompt }
-          ],
-          temperature: 0.3,
-        }),
-      });
-
-      if (!res.ok) {
-        throw new Error(`OpenAI API error: ${res.statusText}`);
-      }
-
-      const data = await res.json();
-      response = JSON.parse(data.choices[0].message.content);
-    } else {
-      // Use Anthropic
-      const res = await fetch('https://api.anthropic.com/v1/messages', {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'x-api-key': process.env.ANTHROPIC_API_KEY!,
-          'anthropic-version': '2023-06-01',
-        },
-        body: JSON.stringify({
-          model: 'claude-3-5-sonnet-20241022',
-          max_tokens: 1024,
-          messages: [
-            { role: 'user', content: prompt }
-          ],
-        }),
-      });
-
-      if (!res.ok) {
-        throw new Error(`Anthropic API error: ${res.statusText}`);
-      }
-
-      const data = await res.json();
-      response = JSON.parse(data.content[0].text);
-    }
-
-    if (verbose) {
-      console.log(`✅ Selected template: ${response.template}`);
-      console.log(`💡 Reasoning: ${response.reasoning}`);
-    }
-
-    // Convert features object to array of strings
-    const featuresArray: string[] = [];
-    if (response.features.database && response.features.database !== 'none') {
-      featuresArray.push(`database:${response.features.database}`);
-    }
-    if (response.features.auth && response.features.auth !== 'none') {
-      featuresArray.push(`auth:${response.features.auth}`);
-    }
-    if (response.features.testing && response.features.testing !== 'none') {
-      featuresArray.push(`testing:${response.features.testing}`);
-    }
-    if (response.features.state && response.features.state !== 'none') {
-      featuresArray.push(`state:${response.features.state}`);
-    }
-    if (response.features.shadcn) {
-      featuresArray.push('shadcn');
-    }
-    if (response.features.tailwind) {
-      featuresArray.push('tailwind');
-    }
-
-    return {
-      template: response.template,
-      features: featuresArray,
-    };
-  } catch (error) {
-    console.error('❌ AI detection failed:', error);
-    console.error('Please specify --template manually.');
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// Project Generation
-// ============================================================================
-
-function generateProjectConfig(options: ScaffoldOptions): ProjectConfig {
-  const template = TEMPLATES[options.template!];
-  const name = options.name || 'my-app';
-  const outputDir = options.output || join(process.cwd(), name);
-
-  const config: ProjectConfig = {
-    name,
-    template: options.template!,
-    outputDir,
-    dependencies: [...template.defaultDeps],
-    devDependencies: [...template.defaultDevDeps],
-    scripts: {},
-    files: [],
-    features: [],
-  };
-
-  // Add TypeScript
-  if (options.typescript) {
-    config.features.push('typescript');
-  }
-
-  // Add Tailwind CSS
-  if (options.tailwind) {
-    config.dependencies.push('tailwindcss', 'autoprefixer', 'postcss');
-    config.features.push('tailwind');
-  }
-
-  // Add shadcn/ui
-  if (options.shadcn) {
-    config.dependencies.push('class-variance-authority', 'clsx', 'tailwind-merge');
-    config.devDependencies.push('tailwindcss-animate');
-    config.features.push('shadcn');
-  }
-
-  // Add database
-  if (options.database !== 'none') {
-    config.features.push(`database:${options.database}`);
-
-    if (options.database === 'prisma') {
-      config.dependencies.push('@prisma/client');
-      config.devDependencies.push('prisma');
-    } else if (options.database === 'drizzle') {
-      config.dependencies.push('drizzle-orm', 'postgres');
-      config.devDependencies.push('drizzle-kit');
-    } else if (options.database === 'supabase') {
-      config.dependencies.push('@supabase/supabase-js');
-    }
-  }
-
-  // Add authentication
-  if (options.auth !== 'none') {
-    config.features.push(`auth:${options.auth}`);
-
-    if (options.auth === 'nextauth') {
-      config.dependencies.push('next-auth');
-    } else if (options.auth === 'clerk') {
-      config.dependencies.push('@clerk/nextjs');
-    } else if (options.auth === 'lucia') {
-      config.dependencies.push('lucia');
-    }
-  }
-
-  // Add testing
-  if (options.testing !== 'none') {
-    config.features.push(`testing:${options.testing}`);
-
-    if (options.testing === 'vitest' || options.testing === 'both') {
-      config.devDependencies.push('vitest', '@vitest/ui');
-    }
-    if (options.testing === 'playwright' || options.testing === 'both') {
-      config.devDependencies.push('@playwright/test');
-    }
-  }
-
-  // Add state management
-  if (options.state !== 'none') {
-    config.features.push(`state:${options.state}`);
-
-    if (options.state === 'zustand') {
-      config.dependencies.push('zustand');
-    } else if (options.state === 'jotai') {
-      config.dependencies.push('jotai');
-    } else if (options.state === 'redux') {
-      config.dependencies.push('@reduxjs/toolkit', 'react-redux');
-    }
-  }
-
-  // Add ESLint and Prettier
-  config.devDependencies.push('eslint', 'prettier');
-
-  return config;
-}
-
-function generateFiles(config: ProjectConfig, options: ScaffoldOptions): void {
-  const { outputDir, name, template } = config;
-
-  // Create output directory
-  if (!existsSync(outputDir)) {
-    mkdirSync(outputDir, { recursive: true });
-  }
-
-  // Generate package.json
-  const packageJson = {
-    name,
-    version: '0.1.0',
-    private: true,
-    scripts: generateScripts(template, options),
-    dependencies: config.dependencies.reduce((acc, dep) => {
-      acc[dep] = 'latest';
-      return acc;
-    }, {} as Record<string, string>),
-    devDependencies: config.devDependencies.reduce((acc, dep) => {
-      acc[dep] = 'latest';
-      return acc;
-    }, {} as Record<string, string>),
-  };
-
-  writeFileSync(
-    join(outputDir, 'package.json'),
-    JSON.stringify(packageJson, null, 2)
-  );
-
-  // Generate tsconfig.json
-  if (options.typescript) {
-    const tsConfig = generateTsConfig(template);
-    writeFileSync(
-      join(outputDir, 'tsconfig.json'),
-      JSON.stringify(tsConfig, null, 2)
-    );
-  }
-
-  // Generate .gitignore
-  const gitignore = generateGitignore(template);
-  writeFileSync(join(outputDir, '.gitignore'), gitignore);
-
-  // Generate .env.example
-  const envExample = generateEnvExample(options);
-  writeFileSync(join(outputDir, '.env.example'), envExample);
-
-  // Generate README.md
-  const readme = generateReadme(config, options);
-  writeFileSync(join(outputDir, 'README.md'), readme);
-
-  // Generate template-specific files
-  generateTemplateFiles(config, options);
-
-  console.log(`\n✅ Project scaffolded successfully!`);
-  console.log(`📁 Location: ${outputDir}`);
-  console.log(`\nNext steps:`);
-  console.log(`  cd ${name}`);
-  if (!options.install) {
-    console.log(`  ${options.pm} install`);
-  }
-  console.log(`  ${options.pm} ${options.pm === 'npm' ? 'run ' : ''}dev`);
-}
-
-function generateScripts(template: Template, options: ScaffoldOptions): Record<string, string> {
-  const scripts: Record<string, string> = {
-    dev: 'next dev',
-    build: 'next build',
-    start: 'next start',
-    lint: 'eslint .',
-    format: 'prettier --write .',
-  };
-
-  // Template-specific scripts
-  if (template === 'next') {
-    scripts.dev = 'next dev';
-    scripts.build = 'next build';
-    scripts.start = 'next start';
-  } else if (template === 'react') {
-    scripts.dev = 'vite';
-    scripts.build = 'vite build';
-    scripts.preview = 'vite preview';
-  } else if (template === 'express' || template === 'rest-api') {
-    scripts.dev = 'tsx watch src/index.ts';
-    scripts.build = 'tsc';
-    scripts.start = 'node dist/index.js';
-  }
-
-  // Database scripts
-  if (options.database === 'prisma') {
-    scripts['db:generate'] = 'prisma generate';
-    scripts['db:push'] = 'prisma db push';
-    scripts['db:migrate'] = 'prisma migrate dev';
-    scripts['db:studio'] = 'prisma studio';
-  } else if (options.database === 'drizzle') {
-    scripts['db:generate'] = 'drizzle-kit generate';
-    scripts['db:migrate'] = 'drizzle-kit migrate';
-    scripts['db:studio'] = 'drizzle-kit studio';
-  }
-
-  // Testing scripts
-  if (options.testing === 'vitest' || options.testing === 'both') {
-    scripts.test = 'vitest';
-    scripts['test:ui'] = 'vitest --ui';
-  }
-  if (options.testing === 'playwright' || options.testing === 'both') {
-    scripts['test:e2e'] = 'playwright test';
-  }
-
-  return scripts;
-}
-
-function generateTsConfig(template: Template): any {
-  return {
-    compilerOptions: {
-      target: 'ES2020',
-      lib: ['ES2020', 'DOM', 'DOM.Iterable'],
-      module: 'ESNext',
-      skipLibCheck: true,
-      moduleResolution: 'bundler',
-      allowImportingTsExtensions: true,
-      resolveJsonModule: true,
-      isolatedModules: true,
-      noEmit: true,
-      jsx: template.includes('react') || template === 'next' ? 'preserve' : undefined,
-      strict: true,
-      noUnusedLocals: true,
-      noUnusedParameters: true,
-      noFallthroughCasesInSwitch: true,
-      baseUrl: '.',
-      paths: {
-        '@/*': ['./src/*'],
-      },
-    },
-    include: ['src'],
-    exclude: ['node_modules'],
-  };
-}
-
-function generateGitignore(template: Template): string {
-  return `# Dependencies
-node_modules
-.pnp
-.pnp.js
-
-# Testing
-coverage
-.nyc_output
-
-# Next.js
-.next
-out
-
-# Production
-build
-dist
-
-# Misc
-.DS_Store
-*.pem
-
-# Debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Local env files
-.env
-.env*.local
-
-# Vercel
-.vercel
-
-# TypeScript
-*.tsbuildinfo
-next-env.d.ts
-
-# IDE
-.vscode
-.idea
-*.swp
-*.swo
-*~
-`;
-}
-
-function generateEnvExample(options: ScaffoldOptions): string {
-  let env = '# Environment Variables\n\n';
-
-  if (options.database === 'prisma' || options.database === 'drizzle') {
-    env += '# Database\n';
-    env += 'DATABASE_URL="postgresql://user:password@localhost:5432/dbname"\n\n';
-  }
-
-  if (options.database === 'supabase' || options.auth === 'supabase') {
-    env += '# Supabase\n';
-    env += 'NEXT_PUBLIC_SUPABASE_URL="your-supabase-url"\n';
-    env += 'NEXT_PUBLIC_SUPABASE_ANON_KEY="your-supabase-anon-key"\n\n';
-  }
-
-  if (options.auth === 'nextauth') {
-    env += '# NextAuth\n';
-    env += 'NEXTAUTH_URL="http://localhost:3000"\n';
-    env += 'NEXTAUTH_SECRET="your-secret-here"\n\n';
-  }
-
-  if (options.auth === 'clerk') {
-    env += '# Clerk\n';
-    env += 'NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="your-publishable-key"\n';
-    env += 'CLERK_SECRET_KEY="your-secret-key"\n\n';
-  }
-
-  return env;
-}
-
-function generateReadme(config: ProjectConfig, options: ScaffoldOptions): string {
-  const { name, template } = config;
-  const templateInfo = TEMPLATES[template];
-
-  return `# ${name}
-
-${templateInfo.description}
-
-## Tech Stack
-
-- **Framework**: ${templateInfo.name}
-${options.typescript ? '- **Language**: TypeScript\n' : ''}${options.tailwind ? '- **Styling**: Tailwind CSS\n' : ''}${options.shadcn ? '- **UI**: shadcn/ui\n' : ''}${options.database !== 'none' ? `- **Database**: ${options.database}\n` : ''}${options.auth !== 'none' ? `- **Auth**: ${options.auth}\n` : ''}${options.testing !== 'none' ? `- **Testing**: ${options.testing}\n` : ''}${options.state !== 'none' ? `- **State**: ${options.state}\n` : ''}
-## Prerequisites
-
-- Node.js 18+ (or Bun)
-- ${options.database === 'prisma' || options.database === 'drizzle' ? 'PostgreSQL database' : ''}
-
-## Getting Started
-
-1. Install dependencies:
-
-\`\`\`bash
-${options.pm} install
-\`\`\`
-
-2. Copy environment variables:
-
-\`\`\`bash
-cp .env.example .env
-\`\`\`
-
-3. Fill in the environment variables in \`.env\`
-
-${options.database === 'prisma' ? `4. Setup database:
-
-\`\`\`bash
-${options.pm} db:generate
-${options.pm} db:push
-\`\`\`
-
-` : ''}${options.database === 'drizzle' ? `4. Setup database:
-
-\`\`\`bash
-${options.pm} db:generate
-${options.pm} db:migrate
-\`\`\`
-
-` : ''}5. Run the development server:
-
-\`\`\`bash
-${options.pm} ${options.pm === 'npm' ? 'run ' : ''}dev
-\`\`\`
-
-## Available Scripts
-
-- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}dev\` - Start development server
-- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}build\` - Build for production
-- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}start\` - Start production server
-- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}lint\` - Run ESLint
-- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}format\` - Format code with Prettier
-${options.testing !== 'none' ? `- \`${options.pm} ${options.pm === 'npm' ? 'run ' : ''}test\` - Run tests\n` : ''}
-## Project Structure
-
-\`\`\`
-${name}/
-├── src/
-│   ├── app/          # Application routes
-│   ├── components/   # React components
-│   ├── lib/          # Utility functions
-│   └── types/        # TypeScript types
-├── public/           # Static assets
-├── .env.example      # Environment variables template
-├── package.json
-└── README.md
-\`\`\`
-
-## Learn More
-
-- [${templateInfo.name} Documentation](https://nextjs.org/docs)
-${options.tailwind ? '- [Tailwind CSS](https://tailwindcss.com/docs)\n' : ''}${options.shadcn ? '- [shadcn/ui](https://ui.shadcn.com)\n' : ''}${options.database === 'prisma' ? '- [Prisma](https://www.prisma.io/docs)\n' : ''}${options.database === 'drizzle' ? '- [Drizzle](https://orm.drizzle.team)\n' : ''}
-## Deployment
-
-Deploy your application on [Vercel](https://vercel.com) or [Railway](https://railway.app).
-
----
-
-Generated with [scaffold-project](https://skills.md/skills/scaffold-project)
-`;
-}
-
-function generateTemplateFiles(config: ProjectConfig, options: ScaffoldOptions): void {
-  const { outputDir, template } = config;
-  const srcDir = join(outputDir, 'src');
-
-  // Create src directory
-  if (!existsSync(srcDir)) {
-    mkdirSync(srcDir, { recursive: true });
-  }
-
-  // Generate template-specific files
-  if (template === 'next') {
-    generateNextJsFiles(srcDir, options);
-  } else if (template === 'react') {
-    generateReactFiles(srcDir, options);
-  } else if (template === 'express' || template === 'rest-api') {
-    generateExpressFiles(srcDir, options);
-  } else if (template === 'cli') {
-    generateCliFiles(srcDir, options);
-  }
-  // Add more template generators as needed
-}
-
-function generateNextJsFiles(srcDir: string, options: ScaffoldOptions): void {
-  const appDir = join(srcDir, 'app');
-  mkdirSync(appDir, { recursive: true });
-
-  // layout.tsx
-  writeFileSync(
-    join(appDir, 'layout.tsx'),
-    `import type { Metadata } from 'next'
-import './globals.css'
-
-export const metadata: Metadata = {
-  title: 'My App',
-  description: 'Generated by scaffold-project',
-}
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode
-}) {
-  return (
-    <html lang="en">
-      <body>{children}</body>
-    </html>
-  )
-}
-`
-  );
-
-  // page.tsx
-  writeFileSync(
-    join(appDir, 'page.tsx'),
-    `export default function Home() {
-  return (
-    <main className="flex min-h-screen flex-col items-center justify-center p-24">
-      <h1 className="text-4xl font-bold">Welcome to Your App</h1>
-      <p className="mt-4 text-lg">Start building something amazing!</p>
-    </main>
-  )
-}
-`
-  );
-
-  // globals.css
-  writeFileSync(
-    join(appDir, 'globals.css'),
-    `@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-:root {
-  --foreground-rgb: 0, 0, 0;
-  --background-start-rgb: 214, 219, 220;
-  --background-end-rgb: 255, 255, 255;
-}
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    --foreground-rgb: 255, 255, 255;
-    --background-start-rgb: 0, 0, 0;
-    --background-end-rgb: 0, 0, 0;
-  }
-}
-
-body {
-  color: rgb(var(--foreground-rgb));
-  background: linear-gradient(
-      to bottom,
-      transparent,
-      rgb(var(--background-end-rgb))
-    )
-    rgb(var(--background-start-rgb));
-}
-`
-  );
-
-  // lib/utils.ts
-  const libDir = join(srcDir, 'lib');
-  mkdirSync(libDir, { recursive: true });
-  writeFileSync(
-    join(libDir, 'utils.ts'),
-    `import { type ClassValue, clsx } from 'clsx'
-import { twMerge } from 'tailwind-merge'
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs))
-}
-`
-  );
-}
-
-function generateReactFiles(srcDir: string, options: ScaffoldOptions): void {
-  // main.tsx
-  writeFileSync(
-    join(srcDir, 'main.tsx'),
-    `import React from 'react'
-import ReactDOM from 'react-dom/client'
-import App from './App'
-import './index.css'
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>,
-)
-`
-  );
-
-  // App.tsx
-  writeFileSync(
-    join(srcDir, 'App.tsx'),
-    `function App() {
-  return (
-    <div className="min-h-screen flex items-center justify-center">
-      <div className="text-center">
-        <h1 className="text-4xl font-bold mb-4">Welcome to Your App</h1>
-        <p className="text-lg">Start building something amazing!</p>
-      </div>
-    </div>
-  )
-}
-
-export default App
-`
-  );
-
-  // index.css
-  writeFileSync(
-    join(srcDir, 'index.css'),
-    `@tailwind base;
-@tailwind components;
-@tailwind utilities;
-`
-  );
-}
-
-function generateExpressFiles(srcDir: string, options: ScaffoldOptions): void {
-  // index.ts
-  writeFileSync(
-    join(srcDir, 'index.ts'),
-    `import express from 'express'
-import cors from 'cors'
-import dotenv from 'dotenv'
-
-dotenv.config()
-
-const app = express()
-const port = process.env.PORT || 3000
-
-app.use(cors())
-app.use(express.json())
-
-app.get('/', (req, res) => {
-  res.json({ message: 'API is running' })
-})
-
-app.get('/health', (req, res) => {
-  res.json({ status: 'ok' })
-})
-
-app.listen(port, () => {
-  console.log(\`Server running on http://localhost:\${port}\`)
-})
-`
-  );
-}
-
-function generateCliFiles(srcDir: string, options: ScaffoldOptions): void {
-  // index.ts
-  writeFileSync(
-    join(srcDir, 'index.ts'),
-    `#!/usr/bin/env node
-import { Command } from 'commander'
-
-const program = new Command()
-
-program
-  .name('my-cli')
-  .description('CLI tool generated by scaffold-project')
-  .version('1.0.0')
-
-program
-  .command('hello')
-  .description('Say hello')
-  .argument('<name>', 'Name to greet')
-  .action((name) => {
-    console.log(\`Hello, \${name}!\`)
-  })
+import { existsSync } from "fs";
+import { parseArgs } from "util";
 
-program.parse()
-`
-  );
-}
+import { detectTemplate } from "./ai-detect";
+import { generateFiles } from "./file-generators";
+import { generateProjectConfig } from "./project-config";
+import { TEMPLATES } from "./templates";
+import { validatePackageManager } from "./types";
+import type { Auth, Database, PackageManager, ScaffoldOptions, State, Template, Testing } from "./types";
 
-// ============================================================================
 // Main CLI Logic
 // ============================================================================