feat: Enhance frontmcp cli commands (#118)

* feat: Enhance 'create' command with interactive prompts and Docker support

* feat: Add end-to-end testing script and Verdaccio configuration for CLI

* refactor: Simplify argument parsing tests and enhance chdir mock implementation

* feat: Enhance type safety by defining PackageJson interface and improving error handling

* feat: Preserve user scripts in 'create' command and streamline script merging

Author: frontegg-david

docs/draft/docs/deployment/local-dev-server.mdx

@@ -29,6 +29,10 @@ Creates a folder and scaffolds everything for you.
 
 </CodeGroup>
 
+<Info>
+The `create` command is interactive by default. Use `--yes` for non-interactive mode with defaults (Docker target, Redis via Docker Compose, GitHub Actions enabled).
+</Info>
+
 ### Option B — Existing project
 
 Install and initialize in your current repo:
@@ -59,6 +63,31 @@ After `create` or `init`, your `package.json` will include:
 - `frontmcp inspector` — launches **@modelcontextprotocol/inspector** with zero setup
 - `frontmcp doctor` — verifies Node/npm versions and project configuration
 
+### Docker scripts (Docker target only)
+
+If you created your project with the Docker target (`--target node`), you'll also have:
+
+```json
+{
+  "scripts": {
+    "docker:up": "docker compose -f ci/docker-compose.yml up",
+    "docker:down": "docker compose -f ci/docker-compose.yml down",
+    "docker:build": "docker compose -f ci/docker-compose.yml build"
+  }
+}
+```
+
+```bash
+# Start the full stack (app + Redis if configured)
+npm run docker:up
+
+# Stop containers
+npm run docker:down
+
+# Rebuild the Docker image
+npm run docker:build
+```
+
 ---
 
 ## Recommended tsconfig

docs/draft/docs/deployment/redis-setup.mdx

@@ -18,19 +18,22 @@ FrontMCP uses Redis for caching, session storage, and distributed state manageme
 
 ### Option 1: Docker Compose (Recommended)
 
-Projects created with `frontmcp create` include a `docker-compose.yml`:
+Projects created with `frontmcp create --target node` include Docker files in the `ci/` folder:
 
 ```bash
 # Start Redis
-docker compose up redis -d
+docker compose -f ci/docker-compose.yml up redis -d
 
 # Verify Redis is running
-docker compose exec redis redis-cli ping
+docker compose -f ci/docker-compose.yml exec redis redis-cli ping
+
+# Start the full stack (app + Redis)
+docker compose -f ci/docker-compose.yml up
 ```
 
 <Tip>
 When running inside Docker, use `redis` (the service name) as `REDIS_HOST`, not `localhost`.
-Projects created with `frontmcp create` include a `.env.docker` file with Docker-specific values.
+Projects created with `frontmcp create` include a `ci/.env.docker` file with Docker-specific values.
 </Tip>
 
 ### Option 2: Local Installation

docs/draft/docs/deployment/serverless.mdx

@@ -11,11 +11,28 @@ Deploy your FrontMCP server to serverless platforms like Vercel, AWS Lambda, and
 | Platform | Status | Module Format | Config File |
 |----------|--------|---------------|-------------|
 | Vercel | Stable | ESM | `vercel.json` |
-| AWS Lambda | Stable | ESM | User-managed |
+| AWS Lambda | Stable | ESM | `ci/template.yaml` (SAM) |
 | Cloudflare Workers | Experimental | CommonJS | `wrangler.toml` |
 
 ## Quick Start
 
+<Tip>
+**New project?** Use `frontmcp create` with the `--target` flag to scaffold a serverless-ready project:
+
+```bash
+# Vercel project
+npx frontmcp create my-app --target vercel
+
+# AWS Lambda project (generates SAM template)
+npx frontmcp create my-app --target lambda
+
+# Cloudflare Workers project
+npx frontmcp create my-app --target cloudflare
+```
+
+This generates the platform config files (`vercel.json`, `ci/template.yaml`, or `wrangler.toml`) automatically.
+</Tip>
+
 <Tabs>
   <Tab title="Vercel">
     ```bash
@@ -118,6 +135,13 @@ npm install @codegenie/serverless-express
 
 ### Setup
 
+<Tip>
+Projects created with `frontmcp create --target lambda` include a SAM template at `ci/template.yaml` and a deploy script:
+```bash
+npm run deploy  # Runs: cd ci && sam build && sam deploy
+```
+</Tip>
+
 1. Build your project:
    ```bash
    frontmcp build --adapter lambda
@@ -201,6 +225,13 @@ with streaming, certain middleware, and some response methods.
 For production Cloudflare deployments, consider using [Hono](https://hono.dev/) or native Workers APIs.
 </Warning>
 
+<Tip>
+Projects created with `frontmcp create --target cloudflare` include a `wrangler.toml` and a deploy script:
+```bash
+npm run deploy  # Runs: wrangler deploy
+```
+</Tip>
+
 ### Limitations
 
 - Basic request/response handling only

docs/draft/docs/getting-started/installation.mdx

@@ -17,7 +17,7 @@ icon: arrow-down-to-line
 
 ## Option A — Create a new project
 
-Use the built-in project generator. It **requires** a project name and will create a new folder under your current directory.
+Use the built-in project generator. It will create a new folder under your current directory.
 
 <CodeGroup>
     ```bash universal
@@ -34,11 +34,55 @@ Use the built-in project generator. It **requires** a project name and will crea
 
 </CodeGroup>
 
+The `create` command is **interactive** by default:
+
+```
+? Project name: my-app
+? Deployment target:
+  > Node.js (Docker)
+    Vercel (Serverless)
+    AWS Lambda
+    Cloudflare Workers
+? Redis setup: (Docker target only)
+  > Docker Compose
+    Existing Redis
+    None
+? Enable GitHub Actions CI/CD? (Y/n)
+```
+
+Use `--yes` (or `-y`) to skip prompts and use defaults.
+
+### CLI Flags
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--yes, -y` | Use defaults (non-interactive) | - |
+| `--target <type>` | Deployment: `node`, `vercel`, `lambda`, `cloudflare` | `node` |
+| `--redis <setup>` | Redis: `docker`, `existing`, `none` | `docker` |
+| `--cicd / --no-cicd` | Enable GitHub Actions | `--cicd` |
+
+**Examples:**
+```bash
+# Interactive mode (default)
+npx frontmcp create my-app
+
+# Non-interactive with defaults
+npx frontmcp create my-app --yes
+
+# Vercel target with CI/CD
+npx frontmcp create my-app --target vercel
+
+# Docker without Redis
+npx frontmcp create my-app --target node --redis none --no-cicd
+```
+
 This will:
 
 - scaffold a FrontMCP project in `./my-app`
 - configure `tsconfig.json` for decorators and modern ESM
 - generate a `package.json` with helpful scripts
+- create deployment configuration for your target (Dockerfile, vercel.json, etc.)
+- generate GitHub Actions workflows (if enabled)
 - install required dev dependencies (e.g. TypeScript, tsx, zod, reflect-metadata)
 
 ---

docs/draft/docs/getting-started/quickstart.mdx

@@ -43,12 +43,23 @@ yarn dev
 
 </CodeGroup>
 
+<Info>
+The `create` command is **interactive** by default. It will ask you about:
+- **Deployment target**: Node.js (Docker), Vercel, AWS Lambda, or Cloudflare Workers
+- **Redis setup**: Docker Compose, existing Redis, or none (Docker target only)
+- **GitHub Actions**: Enable CI/CD workflows
+
+Use `--yes` (or `-y`) to skip prompts and use defaults.
+</Info>
+
 The CLI creates a complete project structure with:
 
 - ✅ TypeScript configured
 - ✅ Sample server, app, and tool
 - ✅ Development scripts ready
 - ✅ Hot-reload enabled
+- ✅ Deployment configuration for your target platform
+- ✅ GitHub Actions CI/CD (optional)
 
 <Check>Your server is now running at `http://localhost:3000`!</Check>
 
@@ -89,16 +100,68 @@ The `init` command:
 
 After creating your project, you'll have:
 
-```
-my-mcp-server/
-├── src/
-│   ├── main.ts          # Server entry point
-│   ├── hello.app.ts     # App definition
-│   └── tools/
-│       └── greet.tool.ts # Sample tool
-├── package.json
-└── tsconfig.json
-```
+<Tabs>
+  <Tab title="Docker (default)">
+    ```
+    my-mcp-server/
+    ├── ci/
+    │   ├── Dockerfile
+    │   ├── docker-compose.yml
+    │   └── .env.docker
+    ├── .github/workflows/    # If CI/CD enabled
+    │   ├── ci.yml
+    │   ├── e2e.yml
+    │   └── deploy.yml
+    ├── src/
+    │   ├── main.ts
+    │   ├── hello.app.ts
+    │   └── tools/
+    │       └── greet.tool.ts
+    ├── package.json
+    └── tsconfig.json
+    ```
+  </Tab>
+  <Tab title="Vercel">
+    ```
+    my-mcp-server/
+    ├── vercel.json
+    ├── src/
+    │   ├── main.ts
+    │   ├── hello.app.ts
+    │   └── tools/
+    │       └── greet.tool.ts
+    ├── package.json
+    └── tsconfig.json
+    ```
+  </Tab>
+  <Tab title="Lambda">
+    ```
+    my-mcp-server/
+    ├── ci/
+    │   └── template.yaml    # AWS SAM template
+    ├── src/
+    │   ├── main.ts
+    │   ├── hello.app.ts
+    │   └── tools/
+    │       └── greet.tool.ts
+    ├── package.json
+    └── tsconfig.json
+    ```
+  </Tab>
+  <Tab title="Cloudflare">
+    ```
+    my-mcp-server/
+    ├── wrangler.toml
+    ├── src/
+    │   ├── main.ts
+    │   ├── hello.app.ts
+    │   └── tools/
+    │       └── greet.tool.ts
+    ├── package.json
+    └── tsconfig.json
+    ```
+  </Tab>
+</Tabs>
 
 ### Server Configuration
 
@@ -298,13 +361,23 @@ npm run doctor
 
 | Command                      | Description                      |
 | ---------------------------- | -------------------------------- |
-| `npx frontmcp create <name>` | Create a new FrontMCP project    |
+| `npx frontmcp create <name>` | Create a new FrontMCP project (interactive) |
+| `npx frontmcp create <name> --yes` | Create with defaults (non-interactive) |
 | `npx frontmcp init`          | Add FrontMCP to existing project |
 | `npm run dev`                | Start with hot-reload            |
 | `npm run build`              | Compile to production            |
 | `npm run inspect`            | Open MCP Inspector               |
 | `npm run doctor`             | Verify setup                     |
 
+### Create Command Flags
+
+| Flag | Description |
+| ---- | ----------- |
+| `--yes, -y` | Use defaults (non-interactive mode) |
+| `--target <type>` | Deployment target: `node`, `vercel`, `lambda`, `cloudflare` |
+| `--redis <setup>` | Redis setup: `docker`, `existing`, `none` |
+| `--cicd / --no-cicd` | Enable/disable GitHub Actions CI/CD |
+
 ---
 
 ## Troubleshooting