frontmcp 0.5.1 → 0.6.0

package/src/commands/create.js

@@ -3,12 +3,45 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCreate = runCreate;
 const tslib_1 = require("tslib");
 const path = tslib_1.__importStar(require("path"));
+const readline = tslib_1.__importStar(require("readline"));
 const fs_1 = require("fs");
 const colors_1 = require("../colors");
 const fs_2 = require("../utils/fs");
 const tsconfig_1 = require("../tsconfig");
 const version_1 = require("../version");
 const fs_3 = require("../utils/fs");
+function createPrompt() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return {
+        ask: (question) => new Promise((resolve) => rl.question(question, (ans) => resolve(ans.trim()))),
+        select: async (question, options, defaultIndex = 0) => {
+            console.log(question);
+            options.forEach((opt, i) => {
+                const marker = i === defaultIndex ? (0, colors_1.c)('green', '●') : (0, colors_1.c)('gray', '○');
+                console.log(`  ${marker} ${(0, colors_1.c)('cyan', `${i + 1})`)} ${opt.label}`);
+            });
+            const answer = await new Promise((resolve) => rl.question(`${(0, colors_1.c)('gray', `Select [1-${options.length}]:`)} `, resolve));
+            const idx = parseInt(answer.trim(), 10) - 1;
+            if (!isNaN(idx) && idx >= 0 && idx < options.length)
+                return options[idx].value;
+            return options[defaultIndex].value;
+        },
+        confirm: async (question, defaultValue = true) => {
+            const hint = defaultValue ? '[Y/n]' : '[y/N]';
+            const answer = await new Promise((resolve) => rl.question(`${question} ${(0, colors_1.c)('gray', hint)} `, resolve));
+            if (!answer.trim())
+                return defaultValue;
+            return answer.trim().toLowerCase().startsWith('y');
+        },
+        close: () => rl.close(),
+    };
+}
+function isInteractive() {
+    return process.stdin.isTTY === true;
+}
 function sanitizeForFolder(name) {
     const seg = name.startsWith('@') && name.includes('/') ? name.split('/')[1] : name;
     return (seg
@@ -32,87 +65,6 @@ function pkgNameFromCwd(cwd) {
         .replace(/[^a-zA-Z0-9._-]/g, '-')
         .toLowerCase() || 'frontmcp-app');
 }
-async function upsertPackageJson(cwd, nameOverride, selfVersion) {
-    const pkgPath = path.join(cwd, 'package.json');
-    const existing = await (0, fs_3.readJSON)(pkgPath);
-    const frontmcpLibRange = `~${selfVersion}`;
-    const base = {
-        name: nameOverride ?? pkgNameFromCwd(cwd),
-        version: '0.1.0',
-        private: true,
-        type: 'commonjs',
-        main: 'src/main.ts',
-        scripts: {
-            dev: 'frontmcp dev',
-            build: 'frontmcp build',
-            inspect: 'frontmcp inspector',
-            doctor: 'frontmcp doctor',
-            'test:e2e': 'jest --config jest.e2e.config.ts --runInBand',
-        },
-        engines: {
-            node: '>=22',
-            npm: '>=10',
-        },
-        dependencies: {
-            '@frontmcp/sdk': frontmcpLibRange,
-            '@frontmcp/plugins': frontmcpLibRange,
-            '@frontmcp/adapters': frontmcpLibRange,
-            zod: '^4.0.0',
-            'reflect-metadata': '^0.2.2',
-        },
-        devDependencies: {
-            frontmcp: selfVersion,
-            '@frontmcp/testing': frontmcpLibRange,
-            '@swc/core': '^1.11.29',
-            '@swc/jest': '^0.2.37',
-            jest: '^29.7.0',
-            tsx: '^4.20.6',
-            '@types/node': '^24.0.0',
-            typescript: '^5.5.3',
-        },
-    };
-    if (!existing) {
-        await (0, fs_2.writeJSON)(pkgPath, base);
-        console.log((0, colors_1.c)('green', '✅ Created package.json (synced @frontmcp libs to CLI version + exact frontmcp)'));
-        return;
-    }
-    const merged = { ...base, ...existing };
-    merged.name = existing.name || base.name;
-    merged.main = existing.main || base.main;
-    merged.type = existing.type || base.type;
-    merged.scripts = {
-        ...base.scripts,
-        ...(existing.scripts || {}),
-        dev: existing.scripts?.dev ?? base.scripts.dev,
-        build: existing.scripts?.build ?? base.scripts.build,
-        inspect: existing.scripts?.inspect ?? base.scripts.inspect,
-        doctor: existing.scripts?.doctor ?? base.scripts.doctor,
-        'test:e2e': existing.scripts?.['test:e2e'] ?? base.scripts['test:e2e'],
-    };
-    merged.engines = {
-        ...(existing.engines || {}),
-        node: existing.engines?.node || base.engines.node,
-        npm: existing.engines?.npm || base.engines.npm,
-    };
-    merged.dependencies = {
-        ...(existing.dependencies || {}),
-        ...base.dependencies,
-        '@frontmcp/sdk': frontmcpLibRange,
-        '@frontmcp/plugins': frontmcpLibRange,
-        '@frontmcp/adapters': frontmcpLibRange,
-        zod: '^4.0.0',
-        'reflect-metadata': '^0.2.2',
-    };
-    merged.devDependencies = {
-        ...(existing.devDependencies || {}),
-        ...base.devDependencies,
-        frontmcp: selfVersion,
-        tsx: '^4.20.6',
-        typescript: '^5.5.3',
-    };
-    await (0, fs_2.writeJSON)(pkgPath, merged);
-    console.log((0, colors_1.c)('green', '✅ Updated package.json (synced @frontmcp libs + frontmcp to current CLI version)'));
-}
 async function scaffoldFileIfMissing(baseDir, p, content) {
     if (await (0, fs_2.fileExists)(p)) {
         console.log((0, colors_1.c)('gray', `skip: ${path.relative(baseDir, p)} already exists`));
@@ -187,6 +139,44 @@ test.describe('Server E2E', () => {
   });
 });
 `;
+const TEMPLATE_GITIGNORE = `
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+*.tsbuildinfo
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# FrontMCP development keys (contains private keys - never commit!)
+.frontmcp/
+
+# Coverage
+coverage/
+
+# Test output
+test-output/
+`;
 const TEMPLATE_JEST_E2E_CONFIG = `
 /* eslint-disable */
 export default {
@@ -226,15 +216,955 @@ export default {
   transformIgnorePatterns: ['node_modules/(?!(jose)/)'],
 };
 `;
-async function runCreate(projectArg) {
-    if (!projectArg) {
-        console.error((0, colors_1.c)('red', 'Error: project name is required.\n'));
-        console.log(`Usage: ${(0, colors_1.c)('bold', 'npx frontmcp create <project-name>')}`);
-        process.exit(1);
+const TEMPLATE_DOCKER_COMPOSE = `
+version: '3.8'
+
+services:
+  redis:
+    image: redis:7-alpine
+    ports:
+      - '6379:6379'
+    volumes:
+      - redis-data:/data
+    command: redis-server --appendonly yes
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 3
+
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - '\${PORT:-3000}:3000'
+    environment:
+      - NODE_ENV=\${NODE_ENV:-development}
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+    depends_on:
+      redis:
+        condition: service_healthy
+    volumes:
+      - ./src:/app/src
+    command: npm run dev
+
+volumes:
+  redis-data:
+`;
+const TEMPLATE_DOCKERFILE = `
+# Build stage
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# Install all dependencies (including devDependencies for build)
+COPY package*.json ./
+RUN npm ci
+
+# Copy source and build
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:22-alpine AS runner
+
+WORKDIR /app
+ENV NODE_ENV=production
+
+# Install production dependencies only
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# Copy built artifacts from builder
+COPY --from=builder /app/dist ./dist
+
+EXPOSE 3000
+
+CMD ["node", "dist/main.js"]
+`;
+const TEMPLATE_ENV_EXAMPLE = `
+# Application
+PORT=3000
+NODE_ENV=development
+
+# Redis (recommended for development, required for production)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+# SECURITY: Set a strong password in production
+REDIS_PASSWORD=
+REDIS_DB=0
+
+# Optional: Redis TLS (enable for production)
+REDIS_TLS=false
+`;
+const TEMPLATE_ENV_DOCKER = `
+# Docker-specific environment
+# Copy this to .env when running with docker compose
+
+# Application
+PORT=3000
+NODE_ENV=development
+
+# Redis - use 'redis' (service name) as host inside Docker network
+REDIS_HOST=redis
+REDIS_PORT=6379
+# SECURITY: Set a strong password in production
+REDIS_PASSWORD=
+REDIS_DB=0
+REDIS_TLS=false
+`;
+const TEMPLATE_README = `
+# FrontMCP Server
+
+A TypeScript MCP server built with [FrontMCP](https://github.com/agentfront/frontmcp).
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Run MCP Inspector
+npm run inspect
+\`\`\`
+
+## Development with Docker
+
+### Prerequisites
+- Docker & Docker Compose installed
+
+### Quick Start
+
+\`\`\`bash
+# Start Redis and app in development mode
+docker compose up
+
+# Start only Redis (for local development)
+docker compose up redis -d
+
+# Stop all services
+docker compose down
+\`\`\`
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| \`PORT\` | 3000 | Application port |
+| \`NODE_ENV\` | development | Environment mode |
+| \`REDIS_HOST\` | localhost | Redis host (use \`redis\` in Docker) |
+| \`REDIS_PORT\` | 6379 | Redis port |
+
+## Redis Configuration
+
+### Development
+Redis is **recommended** for development to enable caching and session persistence.
+Use the included \`docker-compose.yml\` to run Redis locally:
+
+\`\`\`bash
+docker compose up redis -d
+\`\`\`
+
+### Production
+Redis is **required** in production for:
+- Session storage (multi-instance deployments)
+- Caching (performance optimization)
+- Rate limiting (if enabled)
+
+See the [Redis Setup Guide](https://docs.agentfront.dev/docs/deployment/redis-setup) for production configuration.
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| \`npm run dev\` | Start development server with hot reload |
+| \`npm run build\` | Build for production |
+| \`npm run inspect\` | Launch MCP Inspector |
+| \`npm run doctor\` | Check project configuration |
+| \`npm run test\` | Run unit tests |
+| \`npm run test:e2e\` | Run E2E tests |
+
+## Project Structure
+
+\`\`\`
+├── .env.example       # Environment variables template
+├── .gitignore         # Git ignore rules
+├── docker-compose.yml # Docker services config
+├── Dockerfile         # Container build config
+├── e2e/               # E2E tests
+├── jest.e2e.config.ts # Jest E2E configuration
+├── package.json       # Dependencies and scripts
+├── src/
+│   ├── main.ts        # Server entry point
+│   ├── calc.app.ts    # Example app
+│   └── tools/
+│       └── add.tool.ts # Example tool
+└── tsconfig.json      # TypeScript config
+\`\`\`
+
+## Learn More
+
+- [FrontMCP Documentation](https://docs.agentfront.dev)
+- [MCP Specification](https://modelcontextprotocol.io)
+`;
+// =============================================================================
+// Deployment Target Templates
+// =============================================================================
+// Docker templates (moved to ci/ folder)
+const TEMPLATE_DOCKERFILE_CI = `
+# Build stage
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# Install all dependencies (including devDependencies for build)
+COPY package*.json ./
+RUN npm ci
+
+# Copy source and build
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:22-alpine AS runner
+
+WORKDIR /app
+ENV NODE_ENV=production
+
+# Install production dependencies only
+COPY package*.json ./
+RUN npm ci --omit=dev
+
+# Copy built artifacts from builder
+COPY --from=builder /app/dist ./dist
+
+EXPOSE 3000
+
+CMD ["node", "dist/main.js"]
+`;
+const TEMPLATE_DOCKER_COMPOSE_WITH_REDIS = `
+version: '3.8'
+
+services:
+  redis:
+    image: redis:7-alpine
+    ports:
+      - '6379:6379'
+    volumes:
+      - redis-data:/data
+    command: redis-server --appendonly yes
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 3
+
+  app:
+    build:
+      context: .
+      dockerfile: ci/Dockerfile
+    ports:
+      - '\${PORT:-3000}:3000'
+    environment:
+      - NODE_ENV=\${NODE_ENV:-development}
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+    depends_on:
+      redis:
+        condition: service_healthy
+    volumes:
+      - ./src:/app/src
+    command: npm run dev
+
+volumes:
+  redis-data:
+`;
+const TEMPLATE_DOCKER_COMPOSE_NO_REDIS = `
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: .
+      dockerfile: ci/Dockerfile
+    ports:
+      - '\${PORT:-3000}:3000'
+    environment:
+      - NODE_ENV=\${NODE_ENV:-development}
+    volumes:
+      - ./src:/app/src
+    command: npm run dev
+`;
+const TEMPLATE_ENV_DOCKER_CI = `
+# Docker-specific environment
+# Use with: docker compose -f ci/docker-compose.yml --env-file ci/.env.docker up
+
+# Application
+PORT=3000
+NODE_ENV=development
+
+# Redis - use 'redis' (service name) as host inside Docker network
+REDIS_HOST=redis
+REDIS_PORT=6379
+# SECURITY: Set a strong password in production
+REDIS_PASSWORD=
+REDIS_DB=0
+REDIS_TLS=false
+`;
+// Vercel template
+const TEMPLATE_VERCEL_JSON = (projectName) => JSON.stringify({
+    $schema: 'https://openapi.vercel.sh/vercel.json',
+    name: projectName,
+    version: 2,
+    builds: [
+        {
+            src: 'dist/main.js',
+            use: '@vercel/node',
+        },
+    ],
+    routes: [
+        {
+            src: '/(.*)',
+            dest: '/dist/main.js',
+        },
+    ],
+    env: {
+        NODE_ENV: 'production',
+    },
+}, null, 2);
+// AWS Lambda SAM template
+const TEMPLATE_SAM_YAML = (projectName) => `
+AWSTemplateFormatVersion: '2010-09-09'
+Transform: AWS::Serverless-2016-10-31
+Description: ${projectName} - FrontMCP Lambda Function
+
+Globals:
+  Function:
+    Timeout: 30
+    Runtime: nodejs22.x
+    MemorySize: 256
+
+Resources:
+  FrontMCPFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      CodeUri: ../dist/
+      Handler: main.handler
+      Events:
+        ApiEvent:
+          Type: HttpApi
+          Properties:
+            Path: /{proxy+}
+            Method: ANY
+
+Outputs:
+  ApiEndpoint:
+    Description: API Gateway endpoint URL
+    Value: !Sub "https://\${ServerlessHttpApi}.execute-api.\${AWS::Region}.amazonaws.com"
+`;
+// Cloudflare Workers template
+const TEMPLATE_WRANGLER_TOML = (projectName) => `
+name = "${projectName}"
+main = "dist/main.js"
+compatibility_date = "2024-01-01"
+
+[vars]
+NODE_ENV = "production"
+
+# Uncomment to enable KV namespace for caching
+# [[kv_namespaces]]
+# binding = "CACHE"
+# id = "your-kv-namespace-id"
+`;
+// =============================================================================
+// GitHub Actions Templates
+// =============================================================================
+const TEMPLATE_GH_CI = `
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Run tests
+        run: npm test
+`;
+const TEMPLATE_GH_E2E = `
+name: E2E Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run E2E tests
+        run: npm run test:e2e
+`;
+const TEMPLATE_GH_DEPLOY_DOCKER = `
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: \${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: \${{ env.REGISTRY }}
+          username: \${{ github.actor }}
+          password: \${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: \${{ env.REGISTRY }}/\${{ env.IMAGE_NAME }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./ci/Dockerfile
+          push: true
+          tags: \${{ steps.meta.outputs.tags }}
+          labels: \${{ steps.meta.outputs.labels }}
+`;
+const TEMPLATE_GH_DEPLOY_VERCEL = `
+name: Deploy to Vercel
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Deploy to Vercel
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: \${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: \${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: \${{ secrets.VERCEL_PROJECT_ID }}
+          vercel-args: '--prod'
+`;
+const TEMPLATE_GH_DEPLOY_LAMBDA = `
+name: Deploy to AWS Lambda
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Configure AWS credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          aws-access-key-id: \${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: \${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: \${{ secrets.AWS_REGION }}
+
+      - name: Setup SAM
+        uses: aws-actions/setup-sam@v2
+
+      - name: Deploy with SAM
+        run: |
+          cd ci
+          sam build
+          sam deploy --no-confirm-changeset --no-fail-on-empty-changeset
+`;
+const TEMPLATE_GH_DEPLOY_CLOUDFLARE = `
+name: Deploy to Cloudflare Workers
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Deploy to Cloudflare
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+`;
+// =============================================================================
+// Dynamic README Templates
+// =============================================================================
+function generateReadme(options) {
+    const { projectName, deploymentTarget, redisSetup, enableGitHubActions } = options;
+    let readme = `# ${projectName}
+
+A TypeScript MCP server built with [FrontMCP](https://github.com/agentfront/frontmcp).
+`;
+    // Add CI badge if GitHub Actions enabled
+    if (enableGitHubActions) {
+        readme += `
+![CI](https://github.com/YOUR_USERNAME/${projectName}/actions/workflows/ci.yml/badge.svg)
+`;
+    }
+    readme += `
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Run MCP Inspector
+npm run inspect
+\`\`\`
+`;
+    // Deployment-specific sections
+    if (deploymentTarget === 'node') {
+        readme += `
+## Docker Development
+
+\`\`\`bash
+# Start all services${redisSetup === 'docker' ? ' (includes Redis)' : ''}
+npm run docker:up
+
+# Stop all services
+npm run docker:down
+
+# Rebuild Docker image
+npm run docker:build
+\`\`\`
+`;
+        if (redisSetup === 'docker') {
+            readme += `
+### Redis
+
+Redis is included in the Docker Compose setup. For local development without Docker:
+
+\`\`\`bash
+# Start only Redis
+docker compose -f ci/docker-compose.yml up redis -d
+\`\`\`
+`;
+        }
+        readme += `
+## Production Deployment
+
+Build and push the Docker image:
+
+\`\`\`bash
+docker build -f ci/Dockerfile -t ${projectName}:latest .
+docker push your-registry/${projectName}:latest
+\`\`\`
+`;
+    }
+    if (deploymentTarget === 'vercel') {
+        readme += `
+## Deploy to Vercel
+
+\`\`\`bash
+# Build for production
+npm run build
+
+# Deploy using Vercel CLI
+npx vercel --prod
+\`\`\`
+
+Or connect your repository to Vercel for automatic deployments.
+`;
+    }
+    if (deploymentTarget === 'lambda') {
+        readme += `
+## Deploy to AWS Lambda
+
+\`\`\`bash
+# Build the project
+npm run build
+
+# Deploy using AWS SAM
+npm run deploy
+\`\`\`
+
+### Prerequisites
+
+- AWS CLI configured with appropriate credentials
+- AWS SAM CLI installed (\`brew install aws-sam-cli\` or \`pip install aws-sam-cli\`)
+`;
+    }
+    if (deploymentTarget === 'cloudflare') {
+        readme += `
+## Deploy to Cloudflare Workers
+
+\`\`\`bash
+# Build the project
+npm run build
+
+# Deploy using Wrangler
+npm run deploy
+\`\`\`
+
+### Prerequisites
+
+- Wrangler CLI installed (\`npm install -g wrangler\`)
+- Cloudflare account configured (\`wrangler login\`)
+`;
+    }
+    // Environment variables section
+    readme += `
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| \`PORT\` | 3000 | Application port |
+| \`NODE_ENV\` | development | Environment mode |
+`;
+    if (deploymentTarget === 'node' && redisSetup !== 'none') {
+        readme += `| \`REDIS_HOST\` | localhost | Redis host (use \`redis\` in Docker) |
+| \`REDIS_PORT\` | 6379 | Redis port |
+| \`REDIS_PASSWORD\` | - | Redis password (set in production) |
+`;
+    }
+    // GitHub Actions section
+    if (enableGitHubActions) {
+        readme += `
+## CI/CD
+
+This project includes GitHub Actions workflows:
+
+- **ci.yml**: Runs on every push/PR - type checking and tests
+- **e2e.yml**: Runs E2E tests
+- **deploy.yml**: Deploys to ${deploymentTarget === 'node'
+            ? 'GitHub Container Registry'
+            : deploymentTarget === 'vercel'
+                ? 'Vercel'
+                : deploymentTarget === 'lambda'
+                    ? 'AWS Lambda'
+                    : 'Cloudflare Workers'}
+
+### Required Secrets
+`;
+        if (deploymentTarget === 'vercel') {
+            readme += `
+- \`VERCEL_TOKEN\`: Vercel API token
+- \`VERCEL_ORG_ID\`: Vercel organization ID
+- \`VERCEL_PROJECT_ID\`: Vercel project ID
+`;
+        }
+        else if (deploymentTarget === 'lambda') {
+            readme += `
+- \`AWS_ACCESS_KEY_ID\`: AWS access key
+- \`AWS_SECRET_ACCESS_KEY\`: AWS secret key
+- \`AWS_REGION\`: AWS region (e.g., us-east-1)
+`;
+        }
+        else if (deploymentTarget === 'cloudflare') {
+            readme += `
+- \`CLOUDFLARE_API_TOKEN\`: Cloudflare API token with Workers permissions
+`;
+        }
+        else {
+            readme += `
+No additional secrets required - uses \`GITHUB_TOKEN\` for GHCR.
+`;
+        }
+    }
+    readme += `
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| \`npm run dev\` | Start development server with hot reload |
+| \`npm run build\` | Build for production |
+| \`npm run inspect\` | Launch MCP Inspector |
+| \`npm run doctor\` | Check project configuration |
+| \`npm run test\` | Run unit tests |
+| \`npm run test:e2e\` | Run E2E tests |
+`;
+    if (deploymentTarget === 'node') {
+        readme += `| \`npm run docker:up\` | Start Docker services |
+| \`npm run docker:down\` | Stop Docker services |
+| \`npm run docker:build\` | Rebuild Docker image |
+`;
+    }
+    if (deploymentTarget === 'lambda' || deploymentTarget === 'cloudflare') {
+        readme += `| \`npm run deploy\` | Deploy to ${deploymentTarget === 'lambda' ? 'AWS Lambda' : 'Cloudflare Workers'} |
+`;
+    }
+    readme += `
+## Project Structure
+
+\`\`\`
+`;
+    // Dynamic project structure based on options
+    readme += `├── .env.example       # Environment variables template
+├── .gitignore         # Git ignore rules
+`;
+    if (deploymentTarget === 'node') {
+        readme += `├── ci/
+│   ├── Dockerfile         # Container build config
+│   ├── docker-compose.yml # Docker services config
+│   └── .env.docker        # Docker-specific env vars
+`;
+    }
+    if (deploymentTarget === 'vercel') {
+        readme += `├── vercel.json        # Vercel deployment config
+`;
+    }
+    if (deploymentTarget === 'lambda') {
+        readme += `├── ci/
+│   └── template.yaml      # AWS SAM template
+`;
+    }
+    if (deploymentTarget === 'cloudflare') {
+        readme += `├── wrangler.toml      # Cloudflare Workers config
+`;
+    }
+    if (enableGitHubActions) {
+        readme += `├── .github/workflows/
+│   ├── ci.yml             # CI workflow
+│   ├── e2e.yml            # E2E test workflow
+│   └── deploy.yml         # Deployment workflow
+`;
+    }
+    readme += `├── e2e/               # E2E tests
+├── jest.e2e.config.ts # Jest E2E configuration
+├── package.json       # Dependencies and scripts
+├── src/
+│   ├── main.ts        # Server entry point
+│   ├── calc.app.ts    # Example app
+│   └── tools/
+│       └── add.tool.ts # Example tool
+└── tsconfig.json      # TypeScript config
+\`\`\`
+
+## Learn More
+
+- [FrontMCP Documentation](https://docs.agentfront.dev)
+- [MCP Specification](https://modelcontextprotocol.io)
+`;
+    return readme;
+}
+// =============================================================================
+// Scaffolding Functions
+// =============================================================================
+function getDefaults(projectArg) {
+    return {
+        projectName: projectArg || 'frontmcp-app',
+        deploymentTarget: 'node',
+        redisSetup: 'docker',
+        enableGitHubActions: true,
+    };
+}
+async function collectOptions(prompt, projectArg, flags) {
+    // Project name
+    let projectName = projectArg;
+    if (!projectName) {
+        projectName = await prompt.ask(`${(0, colors_1.c)('cyan', '?')} Project name: `);
+        if (!projectName) {
+            throw new Error('Project name is required');
+        }
+    }
+    else {
+        console.log(`${(0, colors_1.c)('cyan', '?')} Project name: ${(0, colors_1.c)('bold', projectName)}`);
     }
-    const folder = sanitizeForFolder(projectArg);
-    const pkgName = sanitizeForNpm(projectArg);
+    // Deployment target
+    const deploymentTarget = flags?.target ||
+        (await prompt.select(`\n${(0, colors_1.c)('cyan', '?')} Select deployment target:`, [
+            { label: 'Node.js (Docker) - Recommended for production', value: 'node' },
+            { label: 'Vercel (Serverless)', value: 'vercel' },
+            { label: 'AWS Lambda', value: 'lambda' },
+            { label: 'Cloudflare Workers', value: 'cloudflare' },
+        ]));
+    // Redis setup (only for Node.js/Docker)
+    let redisSetup = 'none';
+    if (deploymentTarget === 'node') {
+        redisSetup =
+            flags?.redis ||
+                (await prompt.select(`\n${(0, colors_1.c)('cyan', '?')} Redis setup:`, [
+                    { label: 'Docker Compose (recommended for development)', value: 'docker' },
+                    { label: 'Existing Redis (I have my own Redis)', value: 'existing' },
+                    { label: 'None (skip Redis)', value: 'none' },
+                ]));
+    }
+    // GitHub Actions
+    const enableGitHubActions = flags?.cicd ?? (await prompt.confirm(`\n${(0, colors_1.c)('cyan', '?')} Set up GitHub Actions CI/CD?`, true));
+    return {
+        projectName,
+        deploymentTarget,
+        redisSetup,
+        enableGitHubActions,
+    };
+}
+async function scaffoldDeploymentFiles(targetDir, options) {
+    const { deploymentTarget, redisSetup, projectName } = options;
+    switch (deploymentTarget) {
+        case 'node': {
+            const ciDir = path.join(targetDir, 'ci');
+            await (0, fs_2.ensureDir)(ciDir);
+            await scaffoldFileIfMissing(targetDir, path.join(ciDir, 'Dockerfile'), TEMPLATE_DOCKERFILE_CI);
+            const dockerCompose = redisSetup === 'docker' ? TEMPLATE_DOCKER_COMPOSE_WITH_REDIS : TEMPLATE_DOCKER_COMPOSE_NO_REDIS;
+            await scaffoldFileIfMissing(targetDir, path.join(ciDir, 'docker-compose.yml'), dockerCompose);
+            await scaffoldFileIfMissing(targetDir, path.join(ciDir, '.env.docker'), TEMPLATE_ENV_DOCKER_CI);
+            break;
+        }
+        case 'vercel':
+            await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'vercel.json'), TEMPLATE_VERCEL_JSON(sanitizeForFolder(projectName)));
+            break;
+        case 'lambda': {
+            const ciDir = path.join(targetDir, 'ci');
+            await (0, fs_2.ensureDir)(ciDir);
+            await scaffoldFileIfMissing(targetDir, path.join(ciDir, 'template.yaml'), TEMPLATE_SAM_YAML(projectName));
+            break;
+        }
+        case 'cloudflare':
+            await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'wrangler.toml'), TEMPLATE_WRANGLER_TOML(sanitizeForFolder(projectName)));
+            break;
+    }
+    // Always create .env.example at root
+    const envExample = deploymentTarget === 'node' && redisSetup !== 'none' ? TEMPLATE_ENV_EXAMPLE : TEMPLATE_ENV_EXAMPLE_BASIC;
+    await scaffoldFileIfMissing(targetDir, path.join(targetDir, '.env.example'), envExample);
+}
+// Basic .env.example without Redis
+const TEMPLATE_ENV_EXAMPLE_BASIC = `
+# Application
+PORT=3000
+NODE_ENV=development
+`;
+async function scaffoldGitHubActions(targetDir, deploymentTarget) {
+    const workflowDir = path.join(targetDir, '.github', 'workflows');
+    await (0, fs_2.ensureDir)(workflowDir);
+    // Always create CI and E2E workflows
+    await scaffoldFileIfMissing(targetDir, path.join(workflowDir, 'ci.yml'), TEMPLATE_GH_CI);
+    await scaffoldFileIfMissing(targetDir, path.join(workflowDir, 'e2e.yml'), TEMPLATE_GH_E2E);
+    // Create deployment workflow based on target
+    const deployTemplate = getDeployWorkflowTemplate(deploymentTarget);
+    await scaffoldFileIfMissing(targetDir, path.join(workflowDir, 'deploy.yml'), deployTemplate);
+}
+function getDeployWorkflowTemplate(target) {
+    switch (target) {
+        case 'node':
+            return TEMPLATE_GH_DEPLOY_DOCKER;
+        case 'vercel':
+            return TEMPLATE_GH_DEPLOY_VERCEL;
+        case 'lambda':
+            return TEMPLATE_GH_DEPLOY_LAMBDA;
+        case 'cloudflare':
+            return TEMPLATE_GH_DEPLOY_CLOUDFLARE;
+    }
+}
+async function scaffoldProject(options) {
+    const { projectName, deploymentTarget, redisSetup, enableGitHubActions } = options;
+    const folder = sanitizeForFolder(projectName);
+    const pkgName = sanitizeForNpm(projectName);
     const targetDir = path.resolve(process.cwd(), folder);
+    // Validate directory
     try {
         const stat = await fs_1.promises.stat(targetDir);
         if (!stat.isDirectory()) {
@@ -249,24 +1179,47 @@ async function runCreate(projectArg) {
         }
     }
     catch (e) {
-        if (e?.code === 'ENOENT') {
+        if (e && typeof e === 'object' && 'code' in e && e.code === 'ENOENT') {
             await (0, fs_2.ensureDir)(targetDir);
         }
         else {
             throw e;
         }
     }
-    console.log(`${(0, colors_1.c)('cyan', '[create]')} Creating project in ${(0, colors_1.c)('bold', './' + path.relative(process.cwd(), targetDir))}`);
+    console.log(`\n${(0, colors_1.c)('cyan', '[create]')} Creating project in ${(0, colors_1.c)('bold', './' + folder)}`);
+    console.log((0, colors_1.c)('gray', `  Deployment: ${deploymentTarget}`));
+    if (deploymentTarget === 'node') {
+        console.log((0, colors_1.c)('gray', `  Redis: ${redisSetup}`));
+    }
+    console.log((0, colors_1.c)('gray', `  GitHub Actions: ${enableGitHubActions ? 'Yes' : 'No'}`));
+    console.log('');
     process.chdir(targetDir);
+    // Initialize tsconfig
     await (0, tsconfig_1.runInit)(targetDir);
+    // Create package.json with deployment-specific scripts
     const selfVersion = (0, version_1.getSelfVersion)();
-    await upsertPackageJson(targetDir, pkgName, selfVersion);
+    await upsertPackageJsonWithTarget(targetDir, pkgName, selfVersion, deploymentTarget);
+    // Scaffold base files
     await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'src', 'main.ts'), TEMPLATE_MAIN_TS);
     await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'src', 'calc.app.ts'), TEMPLATE_CALC_APP_TS);
     await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'src', 'tools', 'add.tool.ts'), TEMPLATE_ADD_TOOL_TS);
     // E2E scaffolding
     await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'e2e', 'server.e2e.test.ts'), TEMPLATE_E2E_TEST_TS);
     await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'jest.e2e.config.ts'), TEMPLATE_JEST_E2E_CONFIG);
+    // Git configuration
+    await scaffoldFileIfMissing(targetDir, path.join(targetDir, '.gitignore'), TEMPLATE_GITIGNORE);
+    // Deployment-specific files
+    await scaffoldDeploymentFiles(targetDir, options);
+    // GitHub Actions
+    if (enableGitHubActions) {
+        await scaffoldGitHubActions(targetDir, deploymentTarget);
+    }
+    // Dynamic README
+    await scaffoldFileIfMissing(targetDir, path.join(targetDir, 'README.md'), generateReadme(options));
+    // Print next steps
+    printNextSteps(folder, deploymentTarget, redisSetup, enableGitHubActions);
+}
+function printNextSteps(folder, deploymentTarget, redisSetup, enableGitHubActions) {
     console.log('\nNext steps:');
     console.log(`  1) cd ${folder}`);
     console.log('  2) npm install');
@@ -274,5 +1227,160 @@ async function runCreate(projectArg) {
     console.log('  4) npm run inspect  ', (0, colors_1.c)('gray', '# launch MCP Inspector'));
     console.log('  5) npm run build    ', (0, colors_1.c)('gray', '# compile with tsc via frontmcp build'));
     console.log('  6) npm run test:e2e ', (0, colors_1.c)('gray', '# run E2E tests'));
+    if (deploymentTarget === 'node') {
+        console.log('');
+        console.log((0, colors_1.c)('cyan', 'Docker:'));
+        console.log('  npm run docker:up   ', (0, colors_1.c)('gray', `# start${redisSetup === 'docker' ? ' Redis +' : ''} app in Docker`));
+        console.log('  npm run docker:down ', (0, colors_1.c)('gray', '# stop Docker services'));
+    }
+    if (deploymentTarget === 'vercel') {
+        console.log('');
+        console.log((0, colors_1.c)('cyan', 'Deploy to Vercel:'));
+        console.log('  npx vercel          ', (0, colors_1.c)('gray', '# deploy to Vercel'));
+    }
+    if (deploymentTarget === 'lambda') {
+        console.log('');
+        console.log((0, colors_1.c)('cyan', 'Deploy to AWS Lambda:'));
+        console.log('  npm run deploy      ', (0, colors_1.c)('gray', '# deploy with SAM'));
+    }
+    if (deploymentTarget === 'cloudflare') {
+        console.log('');
+        console.log((0, colors_1.c)('cyan', 'Deploy to Cloudflare:'));
+        console.log('  npm run deploy      ', (0, colors_1.c)('gray', '# deploy with Wrangler'));
+    }
+    if (enableGitHubActions) {
+        console.log('');
+        console.log((0, colors_1.c)('cyan', 'GitHub Actions:'));
+        console.log('  .github/workflows/  ', (0, colors_1.c)('gray', '# CI, E2E, and deploy workflows ready'));
+    }
+}
+// =============================================================================
+// Package.json with Target-Specific Scripts
+// =============================================================================
+async function upsertPackageJsonWithTarget(cwd, nameOverride, selfVersion, deploymentTarget) {
+    const pkgPath = path.join(cwd, 'package.json');
+    const existing = await (0, fs_3.readJSON)(pkgPath);
+    const frontmcpLibRange = `~${selfVersion}`;
+    const baseScripts = {
+        dev: 'frontmcp dev',
+        build: 'frontmcp build',
+        inspect: 'frontmcp inspector',
+        doctor: 'frontmcp doctor',
+        test: 'frontmcp test',
+        'test:e2e': 'jest --config jest.e2e.config.ts --runInBand',
+    };
+    // Add target-specific scripts
+    if (deploymentTarget === 'node') {
+        baseScripts['docker:up'] = 'docker compose -f ci/docker-compose.yml up';
+        baseScripts['docker:down'] = 'docker compose -f ci/docker-compose.yml down';
+        baseScripts['docker:build'] = 'docker compose -f ci/docker-compose.yml build';
+    }
+    if (deploymentTarget === 'lambda') {
+        baseScripts['deploy'] = 'cd ci && sam build && sam deploy';
+    }
+    if (deploymentTarget === 'cloudflare') {
+        baseScripts['deploy'] = 'wrangler deploy';
+    }
+    const base = {
+        name: nameOverride ?? pkgNameFromCwd(cwd),
+        version: '0.1.0',
+        private: true,
+        type: 'commonjs',
+        main: 'src/main.ts',
+        scripts: baseScripts,
+        engines: {
+            node: '>=22',
+            npm: '>=10',
+        },
+        dependencies: {
+            '@frontmcp/sdk': frontmcpLibRange,
+            '@frontmcp/plugins': frontmcpLibRange,
+            '@frontmcp/adapters': frontmcpLibRange,
+            zod: '^4.0.0',
+            'reflect-metadata': '^0.2.2',
+        },
+        devDependencies: {
+            frontmcp: selfVersion,
+            '@frontmcp/testing': frontmcpLibRange,
+            '@swc/core': '^1.11.29',
+            '@swc/jest': '^0.2.37',
+            jest: '^29.7.0',
+            '@types/jest': '^29.5.14',
+            tsx: '^4.20.6',
+            '@types/node': '^24.0.0',
+            typescript: '^5.5.3',
+        },
+    };
+    if (!existing) {
+        await (0, fs_2.writeJSON)(pkgPath, base);
+        console.log((0, colors_1.c)('green', '✅ Created package.json (synced @frontmcp libs to CLI version + exact frontmcp)'));
+        return;
+    }
+    const merged = { ...base, ...existing };
+    merged.name = existing.name || base.name;
+    merged.main = existing.main || base.main;
+    merged.type = existing.type || base.type;
+    // Preserve user scripts, add base scripts only if missing
+    merged.scripts = {
+        ...baseScripts,
+        ...(existing.scripts || {}),
+    };
+    merged.engines = {
+        ...(existing.engines || {}),
+        node: existing.engines?.node || base.engines.node,
+        npm: existing.engines?.npm || base.engines.npm,
+    };
+    merged.dependencies = {
+        ...(existing.dependencies || {}),
+        ...base.dependencies,
+    };
+    merged.devDependencies = {
+        ...(existing.devDependencies || {}),
+        ...base.devDependencies,
+    };
+    await (0, fs_2.writeJSON)(pkgPath, merged);
+    console.log((0, colors_1.c)('green', '✅ Updated package.json (synced @frontmcp libs + frontmcp to current CLI version)'));
+}
+// =============================================================================
+// Main Entry Point
+// =============================================================================
+async function runCreate(projectArg, flags) {
+    // Non-interactive mode: use --yes flag or non-TTY environment
+    if (flags?.yes || !isInteractive()) {
+        const options = getDefaults(projectArg);
+        // Override defaults with any provided flags
+        if (flags?.target)
+            options.deploymentTarget = flags.target;
+        if (flags?.redis)
+            options.redisSetup = flags.redis;
+        if (flags?.cicd !== undefined)
+            options.enableGitHubActions = flags.cicd;
+        if (projectArg)
+            options.projectName = projectArg;
+        if (!options.projectName) {
+            console.error((0, colors_1.c)('red', 'Error: project name is required in non-interactive mode.\n'));
+            console.log(`Usage: ${(0, colors_1.c)('bold', 'npx frontmcp create <project-name> --yes')}`);
+            process.exit(1);
+        }
+        await scaffoldProject(options);
+        return;
+    }
+    // Interactive mode
+    console.log(`\n${(0, colors_1.c)('bold', 'Create a new FrontMCP project')}\n`);
+    const prompt = createPrompt();
+    try {
+        const options = await collectOptions(prompt, projectArg, flags);
+        await scaffoldProject(options);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message === 'Project name is required') {
+            console.error((0, colors_1.c)('red', '\nError: Project name is required.'));
+            process.exit(1);
+        }
+        throw err;
+    }
+    finally {
+        prompt.close();
+    }
 }
 //# sourceMappingURL=create.js.map