@hasna/skills 0.1.59 → 0.1.61

package/skills/scaffold-project/src/ai-detect.ts

@@ -1,136 +0,0 @@
-import { TEMPLATES } from "./templates";
-import type { Template } from "./types";
-
-export 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);
-  }
-}
-
-// ============================================================================

package/skills/scaffold-project/src/file-generators.ts

@@ -1,292 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
-
-import {
-  generateEnvExample,
-  generateGitignore,
-  generateReadme,
-  generateScripts,
-  generateTsConfig,
-} from "./project-config";
-import type { ProjectConfig, ScaffoldOptions } from "./types";
-
-export 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 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}!\`)
-  })
-
-program.parse()
-`
-  );
-}
-
-// ============================================================================

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

@@ -1,240 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * Scaffold Project Skill
- * Generates complete project boilerplates from plain English descriptions
- */
-
-import { spawnSync } from "child_process";
-import { existsSync } from "fs";
-import { parseArgs } from "util";
-
-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
-// ============================================================================
-
-async function main() {
-  const { values, positionals } = parseArgs({
-    args: process.argv.slice(2),
-    options: {
-      description: { type: 'string' },
-      template: { type: 'string' },
-      name: { type: 'string' },
-      output: { type: 'string' },
-      typescript: { type: 'boolean', default: true },
-      tailwind: { type: 'boolean', default: true },
-      shadcn: { type: 'boolean', default: false },
-      database: { type: 'string', default: 'none' },
-      auth: { type: 'string', default: 'none' },
-      testing: { type: 'string', default: 'none' },
-      state: { type: 'string', default: 'none' },
-      git: { type: 'boolean', default: true },
-      install: { type: 'boolean', default: false },
-      pm: { type: 'string', default: 'bun' },
-      'dry-run': { type: 'boolean', default: false },
-      verbose: { type: 'boolean', default: false },
-      help: { type: 'boolean', default: false },
-    },
-    allowPositionals: true,
-  });
-
-  if (values.help) {
-    console.log(`
-Scaffold Project - Generate project boilerplates from descriptions
-
-Usage:
-  scaffold-project [description] [options]
-  scaffold-project --template <template> --name <name> [options]
-
-Options:
-  --description <text>     Project description (or use positional arg)
-  --template <type>        Template to use (next, react, express, etc.)
-  --name <name>            Project name
-  --output <path>          Output directory
-  --typescript             Use TypeScript (default: true)
-  --tailwind              Include Tailwind CSS (default: true)
-  --shadcn                Include shadcn/ui
-  --database <type>       Database: prisma, drizzle, supabase, none
-  --auth <type>           Auth: nextauth, clerk, lucia, supabase, none
-  --testing <type>        Testing: vitest, playwright, both, none
-  --state <type>          State: zustand, jotai, redux, none
-  --git                   Initialize git repo (default: true)
-  --install               Run package install (default: false)
-  --pm <manager>          Package manager: npm, yarn, pnpm, bun
-  --dry-run               Show what would be created
-  --verbose               Show detailed output
-  --help                  Show this help
-
-Examples:
-  scaffold-project "A SaaS dashboard with user auth"
-  scaffold-project --template next --name my-app --shadcn
-  scaffold-project --template express --database prisma --testing vitest
-`);
-    process.exit(0);
-  }
-
-  // Get description from positional args or --description
-  const description = values.description || positionals.join(' ');
-
-  // Determine template
-  let template: Template | undefined = values.template as Template;
-  let aiFeatures: string[] = [];
-
-  if (!template && description) {
-    const detected = await detectTemplate(description, !!values.verbose);
-    template = detected.template;
-    aiFeatures = detected.features;
-  } else if (!template) {
-    console.error('❌ Error: Must provide either a description or --template');
-    console.error('Run with --help for usage information');
-    process.exit(1);
-  }
-
-  // Validate package manager early (before building options)
-  const pmValue = values.pm || 'bun';
-  try {
-    validatePackageManager(pmValue);
-  } catch (error: any) {
-    console.error(`❌ ${error.message}`);
-    process.exit(1);
-  }
-
-  // Build options
-  const options: ScaffoldOptions = {
-    description,
-    template,
-    name: values.name,
-    output: values.output,
-    typescript: values.typescript ?? true,
-    tailwind: values.tailwind ?? true,
-    shadcn: values.shadcn ?? false,
-    database: (values.database as Database) || 'none',
-    auth: (values.auth as Auth) || 'none',
-    testing: (values.testing as Testing) || 'none',
-    state: (values.state as State) || 'none',
-    git: values.git ?? true,
-    install: values.install ?? false,
-    pm: pmValue as PackageManager,
-    dryRun: values['dry-run'] ?? false,
-    verbose: values.verbose ?? false,
-  };
-
-  // Apply AI-detected features if not explicitly set
-  for (const feature of aiFeatures) {
-    if (feature.startsWith('database:') && options.database === 'none') {
-      options.database = feature.split(':')[1] as Database;
-    } else if (feature.startsWith('auth:') && options.auth === 'none') {
-      options.auth = feature.split(':')[1] as Auth;
-    } else if (feature.startsWith('testing:') && options.testing === 'none') {
-      options.testing = feature.split(':')[1] as Testing;
-    } else if (feature.startsWith('state:') && options.state === 'none') {
-      options.state = feature.split(':')[1] as State;
-    } else if (feature === 'shadcn') {
-      options.shadcn = true;
-    } else if (feature === 'tailwind') {
-      options.tailwind = true;
-    }
-  }
-
-  if (options.verbose) {
-    console.log('\n📋 Project Configuration:');
-    console.log(`  Template: ${options.template}`);
-    console.log(`  Name: ${options.name || 'auto-generated'}`);
-    console.log(`  TypeScript: ${options.typescript}`);
-    console.log(`  Tailwind: ${options.tailwind}`);
-    console.log(`  shadcn: ${options.shadcn}`);
-    console.log(`  Database: ${options.database}`);
-    console.log(`  Auth: ${options.auth}`);
-    console.log(`  Testing: ${options.testing}`);
-    console.log(`  State: ${options.state}`);
-    console.log('');
-  }
-
-  // Generate project config
-  const config = generateProjectConfig(options);
-
-  if (options.dryRun) {
-    console.log('\n🏗️  Dry Run - Would create:');
-    console.log(`\n📁 ${config.outputDir}/`);
-    console.log(`  ├── package.json`);
-    console.log(`  ├── tsconfig.json`);
-    console.log(`  ├── .gitignore`);
-    console.log(`  ├── .env.example`);
-    console.log(`  ├── README.md`);
-    console.log(`  └── src/`);
-    console.log(`\n📦 Dependencies (${config.dependencies.length}):`);
-    config.dependencies.forEach(dep => console.log(`  - ${dep}`));
-    console.log(`\n🔧 Dev Dependencies (${config.devDependencies.length}):`);
-    config.devDependencies.forEach(dep => console.log(`  - ${dep}`));
-    console.log(`\n✨ Features: ${config.features.join(', ')}`);
-    return;
-  }
-
-  // Check if output directory exists
-  if (existsSync(config.outputDir)) {
-    console.error(`❌ Error: Directory ${config.outputDir} already exists`);
-    console.error('Choose a different name or output directory');
-    process.exit(1);
-  }
-
-  console.log(`\n🚀 Scaffolding ${TEMPLATES[template].name} project...`);
-
-  // Generate files
-  generateFiles(config, options);
-
-  // Initialize git (using spawnSync with array args to prevent command injection)
-  if (options.git) {
-    try {
-      const result = spawnSync('git', ['init'], { cwd: config.outputDir, stdio: 'ignore' });
-      if (result.status === 0) {
-        console.log('✅ Git repository initialized');
-      } else {
-        console.warn('⚠️  Failed to initialize git repository');
-      }
-    } catch (error) {
-      console.warn('⚠️  Failed to initialize git repository');
-    }
-  }
-
-  // Install dependencies (using spawnSync with array args to prevent command injection)
-  if (options.install) {
-    // Validate package manager before use
-    try {
-      validatePackageManager(options.pm);
-    } catch (error: any) {
-      console.error(`❌ ${error.message}`);
-      process.exit(1);
-    }
-
-    console.log(`\n📦 Installing dependencies with ${options.pm}...`);
-    try {
-      const result = spawnSync(options.pm, ['install'], {
-        cwd: config.outputDir,
-        stdio: 'inherit'
-      });
-      if (result.status === 0) {
-        console.log('✅ Dependencies installed');
-      } else {
-        console.error('❌ Failed to install dependencies');
-        console.error('Run installation manually after setup');
-      }
-    } catch (error) {
-      console.error('❌ Failed to install dependencies');
-      console.error('Run installation manually after setup');
-    }
-  }
-
-  console.log('\n✨ Done! Your project is ready.');
-}
-
-// Run the CLI
-main().catch((error) => {
-  console.error('❌ Error:', error.message);
-  process.exit(1);
-});