@leanmcp/cli 0.5.5 → 0.5.7

package/README.md

@@ -1,3 +1,5 @@
+# @leanmcp/cli
+
 <p align="center">
   <img
     src="https://raw.githubusercontent.com/LeanMCP/leanmcp-sdk/refs/heads/main/assets/logo.png"
@@ -6,11 +8,6 @@
   />
 </p>
 
-<p align="center">
-  <strong>@leanmcp/cli</strong><br/>
-  Command-line tool for creating, developing, and deploying LeanMCP projects.
-</p>
-
 <p align="center">
   <a href="https://www.npmjs.com/package/@leanmcp/cli">
     <img src="https://img.shields.io/npm/v/@leanmcp/cli" alt="npm version" />
@@ -22,7 +19,7 @@
     <img src="https://img.shields.io/badge/Docs-leanmcp-0A66C2?" />
   </a>
   <a href="https://discord.com/invite/DsRcA3GwPy">
-    <img src="https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white" />
+    <img src="https://dcbadge.limes.pink/api/server/DsRcA3GwPy?style=flat" alt="Discord" />
   </a>
   <a href="https://x.com/LeanMcp">
     <img src="https://img.shields.io/badge/@LeanMCP-f5f5f5?logo=x&logoColor=000000" />
@@ -33,6 +30,58 @@
   <a href="https://deepwiki.com/LeanMCP/leanmcp-sdk"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
+```json
+{
+  "package": "@leanmcp/cli",
+  "purpose": "Command-line interface for scaffolding LeanMCP projects",
+  "useCases": [
+    "Project scaffolding",
+    "Local development with hot-reload",
+    "Cloud deployment",
+    "Project management"
+  ],
+  "dependencies": ["@inquirer/prompts", "commander", "chalk", "vite", "archiver", "fs-extra"],
+  "bin": {
+    "leanmcp": "bin/leanmcp.js"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}
+```
+
+## Overview
+
+- **What it is**: Command-line interface for scaffolding LeanMCP projects with hot-reload development and cloud deployment
+- **Purpose**: Streamlines the entire MCP server development workflow from project creation to production deployment
+- **Key benefits**:
+  - Quick project scaffolding with production-ready templates
+  - Hot-reload development server with UI component building
+  - One-command cloud deployment to LeanMCP platform
+  - Interactive setup with guided prompts
+  - Project management and monitoring tools
+
+## When to Use It
+
+**Use `@leanmcp/cli` when:**
+
+- Starting any new MCP server project (highly recommended)
+- Need local development with hot-reload and UI building
+- Want to deploy to LeanMCP Cloud with custom subdomains
+- Managing multiple MCP projects
+- Need guided setup for dependencies and configuration
+
+**You probably do NOT need this if:**
+
+- Using custom build systems or deployment pipelines
+- Only working with existing projects without scaffolding needs
+- Building MCP clients (not servers)
+- Working in environments where global CLI tools aren't allowed
+
 ## Features
 
 - **Quick Scaffolding** — Create production-ready MCP servers in seconds
@@ -53,7 +102,14 @@ Or run without installing:
 npx @leanmcp/cli create my-mcp-server
 ```
 
-## Commands Overview
+**Requirements:**
+
+- Node.js >= 18.0.0
+- npm >= 9.0.0
+
+## Usage / Examples
+
+### Commands Overview
 
 ```bash
 # Local development
@@ -270,7 +326,60 @@ leanmcp projects delete <project-id> --force  # Skip confirmation
 
 ---
 
-## NPM Scripts
+## API Reference
+
+### Command Reference
+
+| Command                | Description                              | Usage                          |
+| ---------------------- | ---------------------------------------- | ------------------------------ |
+| `create <name>`        | Create new MCP server project            | `leanmcp create my-server`     |
+| `add <service>`        | Add service to existing project          | `leanmcp add weather`          |
+| `dev`                  | Start development server with hot-reload | `leanmcp dev`                  |
+| `build`                | Build for production                     | `leanmcp build`                |
+| `start`                | Start production server                  | `leanmcp start`                |
+| `login`                | Authenticate with LeanMCP Cloud          | `leanmcp login`                |
+| `logout`               | Remove API key                           | `leanmcp logout`               |
+| `whoami`               | Show login status                        | `leanmcp whoami`               |
+| `deploy [folder]`      | Deploy to LeanMCP Cloud                  | `leanmcp deploy .`             |
+| `projects list`        | List cloud projects                      | `leanmcp projects list`        |
+| `projects get <id>`    | Get project details                      | `leanmcp projects get <id>`    |
+| `projects delete <id>` | Delete project                           | `leanmcp projects delete <id>` |
+| `env list [folder]`    | List environment variables               | `leanmcp env list`             |
+| `env set <keyValue>`   | Set environment variable                 | `leanmcp env set KEY=VALUE`    |
+| `env get <key>`        | Get environment variable value           | `leanmcp env get KEY`          |
+| `env remove <key>`     | Remove environment variable              | `leanmcp env remove KEY`       |
+| `env pull [folder]`    | Download env vars to local file          | `leanmcp env pull`             |
+| `env push [folder]`    | Upload env vars from local file          | `leanmcp env push`             |
+
+---
+
+## Integration with Other LeanMCP Packages
+
+**@leanmcp/cli** works seamlessly with all LeanMCP packages:
+
+- **[@leanmcp/core](https://www.npmjs.com/package/@leanmcp/core)** — Generated projects use `@leanmcp/core` as the foundation
+- **[@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth)** — CLI can scaffold projects with authentication setup
+- **[@leanmcp/ui](https://www.npmjs.com/package/@leanmcp/ui)** — `leanmcp dev` automatically builds UI components with hot-reload
+- **[@leanmcp/elicitation](https://www.npmjs.com/package/@leanmcp/elicitation)** — Generated services include elicitation examples
+- **[@leanmcp/env-injection](https://www.npmjs.com/package/@leanmcp/env-injection)** — Deploy command handles user secrets configuration
+
+**Generated project structure:**
+
+```
+my-mcp-server/
+├── main.ts              # Entry point with HTTP server
+├── package.json         # Dependencies and scripts
+├── tsconfig.json        # TypeScript configuration
+└── mcp/                 # Services directory (auto-discovered)
+    └── example/
+        └── index.ts     # Example service with @Tool, @Prompt, @Resource
+```
+
+---
+
+## Best Practices / Troubleshooting
+
+### NPM Scripts
 
 Generated projects include:
 
@@ -357,12 +466,12 @@ Choose a different subdomain when prompted.
 - [@leanmcp/auth](https://www.npmjs.com/package/@leanmcp/auth) — Authentication decorators
 - [@leanmcp/ui](https://www.npmjs.com/package/@leanmcp/ui) — MCP App UI components
 
-## Links
-
-- [GitHub Repository](https://github.com/LeanMCP/leanmcp-sdk)
-- [NPM Package](https://www.npmjs.com/package/@leanmcp/cli)
-- [LeanMCP Dashboard](https://ship.leanmcp.com)
+---
 
-## License
+## Links
 
-MIT
+- **Documentation**: [https://docs.leanmcp.com/sdk/cli](https://docs.leanmcp.com/sdk/cli)
+- **GitHub**: [https://github.com/LeanMCP/leanmcp-sdk/tree/main/packages/cli](https://github.com/LeanMCP/leanmcp-sdk/tree/main/packages/cli)
+- **npm**: [https://www.npmjs.com/package/@leanmcp/cli](https://www.npmjs.com/package/@leanmcp/cli)
+- **LeanMCP Dashboard**: [https://ship.leanmcp.com](https://ship.leanmcp.com)
+- **License**: MIT

package/dist/index.js

@@ -3,9 +3,9 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 
 // src/index.ts
 import { Command } from "commander";
-import fs11 from "fs-extra";
-import path11 from "path";
-import ora8 from "ora";
+import fs12 from "fs-extra";
+import path12 from "path";
+import ora9 from "ora";
 import { createRequire } from "module";
 import { confirm as confirm4 } from "@inquirer/prompts";
 import { spawn as spawn4 } from "child_process";
@@ -1786,6 +1786,42 @@ async function debugFetch(url, options = {}) {
   return response;
 }
 __name(debugFetch, "debugFetch");
+async function fetchWithRetry(fetchFn, options = {}) {
+  const maxRetries = options.maxRetries ?? 15;
+  const initialDelay = options.initialDelay ?? 1e3;
+  const maxDelay = options.maxDelay ?? 1e4;
+  const operation = options.operation ?? "Fetch";
+  const spinner = options.spinner;
+  const retryOnHttpErrors = options.retryOnHttpErrors ?? false;
+  let lastError = null;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      const response = await fetchFn();
+      if (retryOnHttpErrors && !response.ok && response.status >= 500) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      return response;
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt < maxRetries) {
+        const delay = Math.min(initialDelay * Math.pow(2, attempt), maxDelay);
+        const message = `${operation} failed. Retrying... (${attempt + 1}/${maxRetries})`;
+        if (spinner) {
+          spinner.text = message;
+        } else {
+          process.stdout.write("\r" + chalk.yellow(message));
+        }
+        debug3(`Retry ${attempt + 1}/${maxRetries}: ${lastError.message}, waiting ${delay}ms`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+  }
+  if (!spinner) {
+    process.stdout.write("\x1B[2K\r");
+  }
+  throw new Error(`${operation} failed after ${maxRetries + 1} attempts (1 initial + ${maxRetries} retries): ${lastError?.message || "Unknown error"}`);
+}
+__name(fetchWithRetry, "fetchWithRetry");
 var API_ENDPOINTS = {
   // Projects
   projects: "/api/projects",
@@ -1872,10 +1908,14 @@ async function waitForBuild(apiUrl, apiKey, buildId, spinner) {
   const maxAttempts = 60;
   let attempts = 0;
   while (attempts < maxAttempts) {
-    const response = await debugFetch(`${apiUrl}${API_ENDPOINTS.getBuild}/${buildId}`, {
+    const response = await fetchWithRetry(() => debugFetch(`${apiUrl}${API_ENDPOINTS.getBuild}/${buildId}`, {
       headers: {
         Authorization: `Bearer ${apiKey}`
       }
+    }), {
+      operation: "Build status check",
+      spinner,
+      maxRetries: 3
     });
     if (!response.ok) {
       throw new Error(`Failed to get build status: ${response.statusText}`);
@@ -1901,10 +1941,14 @@ async function waitForDeployment(apiUrl, apiKey, deploymentId, spinner) {
   const maxAttempts = 60;
   let attempts = 0;
   while (attempts < maxAttempts) {
-    const response = await debugFetch(`${apiUrl}${API_ENDPOINTS.getDeployment}/${deploymentId}`, {
+    const response = await fetchWithRetry(() => debugFetch(`${apiUrl}${API_ENDPOINTS.getDeployment}/${deploymentId}`, {
       headers: {
         Authorization: `Bearer ${apiKey}`
       }
+    }), {
+      operation: "Deployment status check",
+      spinner,
+      maxRetries: 3
     });
     if (!response.ok) {
       throw new Error(`Failed to get deployment status: ${response.statusText}`);
@@ -2360,8 +2404,257 @@ ${error instanceof Error ? error.message : String(error)}`);
 }
 __name(deployCommand, "deployCommand");
 
-// src/commands/projects.ts
+// src/commands/feedback.ts
 import ora6 from "ora";
+import fs10 from "fs-extra";
+import path10 from "path";
+import os4 from "os";
+var DEBUG_MODE4 = false;
+function debug4(message, ...args) {
+  if (DEBUG_MODE4) {
+    console.log(chalk.gray(`[DEBUG] ${message}`), ...args);
+  }
+}
+__name(debug4, "debug");
+async function readFileAsBase64(filePath) {
+  try {
+    const absolutePath = path10.resolve(filePath);
+    const stats = await fs10.stat(absolutePath);
+    if (!stats.isFile()) {
+      throw new Error(`${filePath} is not a file`);
+    }
+    const content = await fs10.readFile(absolutePath, "base64");
+    const ext = path10.extname(absolutePath).toLowerCase();
+    let mimeType = "application/octet-stream";
+    switch (ext) {
+      case ".txt":
+      case ".log":
+        mimeType = "text/plain";
+        break;
+      case ".json":
+        mimeType = "application/json";
+        break;
+      case ".js":
+        mimeType = "application/javascript";
+        break;
+      case ".ts":
+        mimeType = "application/typescript";
+        break;
+      case ".md":
+        mimeType = "text/markdown";
+        break;
+    }
+    return {
+      content,
+      size: stats.size,
+      type: mimeType
+    };
+  } catch (error) {
+    throw new Error(`Failed to read file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+__name(readFileAsBase64, "readFileAsBase64");
+async function collectLogFiles() {
+  const attachments = [];
+  const logLocations = [
+    path10.join(os4.homedir(), ".leanmcp", "logs"),
+    path10.join(process.cwd(), "logs"),
+    path10.join(process.cwd(), ".leanmcp", "logs")
+  ];
+  for (const logDir of logLocations) {
+    try {
+      if (await fs10.pathExists(logDir)) {
+        const files = await fs10.readdir(logDir);
+        for (const file of files) {
+          const filePath = path10.join(logDir, file);
+          try {
+            const fileData = await readFileAsBase64(filePath);
+            attachments.push({
+              name: file,
+              ...fileData
+            });
+          } catch (error) {
+            debug4(`Failed to read log file ${filePath}: ${error}`);
+          }
+        }
+      }
+    } catch (error) {
+      debug4(`Failed to scan log directory ${logDir}: ${error}`);
+    }
+  }
+  const npmDebugLog = path10.join(os4.homedir(), ".npm", "_logs");
+  try {
+    if (await fs10.pathExists(npmDebugLog)) {
+      const logFiles = await fs10.readdir(npmDebugLog);
+      const latestLog = logFiles.filter((file) => file.endsWith(".log")).sort().pop();
+      if (latestLog) {
+        const filePath = path10.join(npmDebugLog, latestLog);
+        try {
+          const fileData = await readFileAsBase64(filePath);
+          attachments.push({
+            name: `npm-${latestLog}`,
+            ...fileData
+          });
+        } catch (error) {
+          debug4(`Failed to read npm debug log: ${error}`);
+        }
+      }
+    }
+  } catch (error) {
+    debug4(`Failed to collect npm debug logs: ${error}`);
+  }
+  return attachments;
+}
+__name(collectLogFiles, "collectLogFiles");
+async function sendFeedbackToApi(message, attachments = [], isAnonymous = false) {
+  const apiUrl = await getApiUrl();
+  const endpoint = isAnonymous ? "/feedback/anonymous" : "/feedback";
+  const url = `${apiUrl}${endpoint}`;
+  debug4("API URL:", apiUrl);
+  debug4("Endpoint:", endpoint);
+  debug4("Message length:", message.length);
+  debug4("Attachments count:", attachments.length);
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (!isAnonymous) {
+    const apiKey = await getApiKey();
+    if (!apiKey) {
+      throw new Error("Not authenticated. Please run `leanmcp login` first.");
+    }
+    headers["Authorization"] = `Bearer ${apiKey}`;
+  }
+  const payload = {
+    message,
+    attachments: attachments.map((att) => ({
+      name: att.name,
+      content: att.content,
+      size: att.size,
+      type: att.type
+    }))
+  };
+  debug4("Sending feedback request...");
+  const response = await fetch(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(payload)
+  });
+  debug4("Response status:", response.status);
+  debug4("Response ok:", response.ok);
+  if (!response.ok) {
+    const errorText = await response.text();
+    debug4("Error response:", errorText);
+    if (response.status === 401) {
+      throw new Error("Authentication failed. Please run `leanmcp login` to re-authenticate.");
+    } else if (response.status === 413) {
+      throw new Error("Attachments too large. Please try again without log files.");
+    } else {
+      throw new Error(`Failed to send feedback: ${response.status} ${response.statusText}`);
+    }
+  }
+  return await response.json();
+}
+__name(sendFeedbackToApi, "sendFeedbackToApi");
+async function sendFeedbackCommand(message, options) {
+  logger.info("\nLeanMCP Feedback\n");
+  const isAnonymous = options.anon || false;
+  const includeLogs = options.includeLogs || false;
+  debug4("Feedback options:", {
+    isAnonymous,
+    includeLogs
+  });
+  let feedbackMessage = message;
+  if (!feedbackMessage && !process.stdin.isTTY) {
+    debug4("Reading feedback message from stdin...");
+    feedbackMessage = await new Promise((resolve) => {
+      let data = "";
+      process.stdin.on("data", (chunk) => {
+        data += chunk;
+      });
+      process.stdin.on("end", () => {
+        resolve(data.trim());
+      });
+    });
+  }
+  if (!feedbackMessage || feedbackMessage.trim().length === 0) {
+    logger.error("Feedback message cannot be empty.");
+    logger.info("Usage examples:");
+    logger.info('  leanmcp send-feedback "Your message"');
+    logger.gray("  leanmcp send-feedback << EOF");
+    logger.gray("    multi-line");
+    logger.gray("    message");
+    logger.gray("  EOF");
+    logger.info('  leanmcp send-feedback --anon "Anonymous feedback"');
+    logger.info('  leanmcp send-feedback "Issue with deploy" --include-logs');
+    process.exit(1);
+  }
+  if (feedbackMessage.length > 5e3) {
+    logger.error("Feedback message is too long (max 5000 characters).");
+    process.exit(1);
+  }
+  if (!isAnonymous) {
+    const apiKey = await getApiKey();
+    if (!apiKey) {
+      logger.error("need to login");
+      logger.info("Please run `leanmcp login` to authenticate, or use `--anon` for anonymous feedback.");
+      process.exit(1);
+    }
+  }
+  let attachments = [];
+  if (includeLogs) {
+    const spinner2 = ora6("Collecting log files...").start();
+    try {
+      attachments = await collectLogFiles();
+      spinner2.succeed(`Collected ${attachments.length} log file(s)`);
+      if (attachments.length > 0) {
+        logger.log("Log files:", chalk.gray);
+        attachments.forEach((att) => {
+          logger.log(`  - ${att.name} (${(att.size / 1024).toFixed(1)} KB)`, chalk.gray);
+        });
+        logger.log("");
+      } else {
+        logger.log("No log files found.", chalk.gray);
+        logger.log("");
+      }
+    } catch (error) {
+      spinner2.fail("Failed to collect log files");
+      debug4("Log collection error:", error);
+      logger.warn("Continuing without log files...");
+    }
+  }
+  const spinner = ora6("Sending feedback...").start();
+  try {
+    const result = await sendFeedbackToApi(feedbackMessage, attachments, isAnonymous);
+    spinner.succeed("Feedback sent successfully!");
+    logger.success("\nThank you for your feedback!");
+    logger.log(`Feedback ID: ${result.id}`, chalk.gray);
+    if (isAnonymous) {
+      logger.log("Type: Anonymous", chalk.gray);
+    } else {
+      logger.log("Type: Authenticated", chalk.gray);
+    }
+    if (attachments.length > 0) {
+      logger.log(`Attachments: ${attachments.length}`, chalk.gray);
+    }
+    logger.log("\nWe appreciate your input and will review it soon.", chalk.cyan);
+  } catch (error) {
+    spinner.fail("Failed to send feedback");
+    if (error instanceof Error) {
+      logger.error(`
+${error.message}`);
+    } else {
+      logger.error("\nAn unknown error occurred.");
+    }
+    if (DEBUG_MODE4) {
+      debug4("Full error:", error);
+    }
+    process.exit(1);
+  }
+}
+__name(sendFeedbackCommand, "sendFeedbackCommand");
+
+// src/commands/projects.ts
+import ora7 from "ora";
 var API_ENDPOINT = "/api/projects";
 async function projectsListCommand() {
   const apiKey = await getApiKey();
@@ -2370,7 +2663,7 @@ async function projectsListCommand() {
     logger.gray("Run `leanmcp login` first to authenticate.\n");
     process.exit(1);
   }
-  const spinner = ora6("Fetching projects...").start();
+  const spinner = ora7("Fetching projects...").start();
   try {
     const apiUrl = await getApiUrl();
     const response = await fetch(`${apiUrl}${API_ENDPOINT}`, {
@@ -2415,7 +2708,7 @@ async function projectsGetCommand(projectId) {
     logger.gray("Run `leanmcp login` first to authenticate.\n");
     process.exit(1);
   }
-  const spinner = ora6("Fetching project...").start();
+  const spinner = ora7("Fetching project...").start();
   try {
     const apiUrl = await getApiUrl();
     const response = await fetch(`${apiUrl}${API_ENDPOINT}/${projectId}`, {
@@ -2470,7 +2763,7 @@ async function projectsDeleteCommand(projectId, options = {}) {
       return;
     }
   }
-  const spinner = ora6("Deleting project...").start();
+  const spinner = ora7("Deleting project...").start();
   try {
     const apiUrl = await getApiUrl();
     const response = await fetch(`${apiUrl}${API_ENDPOINT}/${projectId}`, {
@@ -2497,50 +2790,50 @@ ${error instanceof Error ? error.message : String(error)}`);
 __name(projectsDeleteCommand, "projectsDeleteCommand");
 
 // src/commands/env.ts
-import ora7 from "ora";
-import path10 from "path";
-import fs10 from "fs-extra";
+import ora8 from "ora";
+import path11 from "path";
+import fs11 from "fs-extra";
 import { confirm as confirm3 } from "@inquirer/prompts";
-var DEBUG_MODE4 = false;
+var DEBUG_MODE5 = false;
 function setEnvDebugMode(enabled) {
-  DEBUG_MODE4 = enabled;
+  DEBUG_MODE5 = enabled;
 }
 __name(setEnvDebugMode, "setEnvDebugMode");
-function debug4(message, ...args) {
-  if (DEBUG_MODE4) {
+function debug5(message, ...args) {
+  if (DEBUG_MODE5) {
     console.log(chalk.gray(`[DEBUG] ${message}`), ...args);
   }
 }
-__name(debug4, "debug");
+__name(debug5, "debug");
 async function debugFetch2(url, options = {}) {
-  debug4(`HTTP ${options.method || "GET"} ${url}`);
+  debug5(`HTTP ${options.method || "GET"} ${url}`);
   if (options.body && typeof options.body === "string") {
     try {
       const body = JSON.parse(options.body);
-      debug4("Request body:", JSON.stringify(body, null, 2));
+      debug5("Request body:", JSON.stringify(body, null, 2));
     } catch {
-      debug4("Request body:", options.body);
+      debug5("Request body:", options.body);
     }
   }
   const startTime = Date.now();
   const response = await fetch(url, options);
   const duration = Date.now() - startTime;
-  debug4(`Response: ${response.status} ${response.statusText} (${duration}ms)`);
+  debug5(`Response: ${response.status} ${response.statusText} (${duration}ms)`);
   return response;
 }
 __name(debugFetch2, "debugFetch");
 var LEANMCP_CONFIG_DIR2 = ".leanmcp";
 var LEANMCP_CONFIG_FILE2 = "config.json";
 async function readLeanMCPConfig2(projectPath) {
-  const configPath = path10.join(projectPath, LEANMCP_CONFIG_DIR2, LEANMCP_CONFIG_FILE2);
+  const configPath = path11.join(projectPath, LEANMCP_CONFIG_DIR2, LEANMCP_CONFIG_FILE2);
   try {
-    if (await fs10.pathExists(configPath)) {
-      const config = await fs10.readJSON(configPath);
-      debug4("Found existing .leanmcp config:", config);
+    if (await fs11.pathExists(configPath)) {
+      const config = await fs11.readJSON(configPath);
+      debug5("Found existing .leanmcp config:", config);
       return config;
     }
   } catch (e) {
-    debug4("Could not read .leanmcp config:", e);
+    debug5("Could not read .leanmcp config:", e);
   }
   return null;
 }
@@ -2553,7 +2846,7 @@ async function getDeploymentContext(folderPath) {
     return null;
   }
   const apiUrl = await getApiUrl();
-  const absolutePath = path10.resolve(process.cwd(), folderPath);
+  const absolutePath = path11.resolve(process.cwd(), folderPath);
   const config = await readLeanMCPConfig2(absolutePath);
   if (!config) {
     logger.error("No deployment found.");
@@ -2580,7 +2873,7 @@ async function envListCommand(folderPath, options = {}) {
     process.exit(1);
   }
   const { apiKey, apiUrl, config } = context;
-  const spinner = ora7("Fetching environment variables...").start();
+  const spinner = ora8("Fetching environment variables...").start();
   try {
     const reveal = options.reveal ? "?reveal=true" : "";
     const response = await debugFetch2(`${apiUrl}/api/lambda-deploy/${config.deploymentId}/env${reveal}`, {
@@ -2621,7 +2914,7 @@ async function envSetCommand(keyValue, folderPath, options = {}) {
   const { apiKey, apiUrl, config } = context;
   let variables = {};
   if (options.file) {
-    const spinner2 = ora7(`Loading from ${options.file}...`).start();
+    const spinner2 = ora8(`Loading from ${options.file}...`).start();
     try {
       variables = await loadEnvFile(options.file);
       spinner2.succeed(`Loaded ${Object.keys(variables).length} variable(s) from ${options.file}`);
@@ -2662,7 +2955,7 @@ ${error instanceof Error ? error.message : String(error)}`);
     logger.warn("No variables to set.\n");
     return;
   }
-  const spinner = ora7("Updating environment variables...").start();
+  const spinner = ora8("Updating environment variables...").start();
   try {
     const response = await debugFetch2(`${apiUrl}/api/lambda-deploy/${config.deploymentId}/env`, {
       method: "PUT",
@@ -2747,7 +3040,7 @@ async function envRemoveCommand(key, folderPath, options = {}) {
       return;
     }
   }
-  const spinner = ora7(`Removing ${key}...`).start();
+  const spinner = ora8(`Removing ${key}...`).start();
   try {
     const response = await debugFetch2(`${apiUrl}/api/lambda-deploy/${config.deploymentId}/env/${key}`, {
       method: "DELETE",
@@ -2776,7 +3069,7 @@ async function envPullCommand(folderPath, options = {}) {
   }
   const { apiKey, apiUrl, config } = context;
   const outputFile = options.file || ".env.remote";
-  const spinner = ora7("Fetching environment variables...").start();
+  const spinner = ora8("Fetching environment variables...").start();
   try {
     const response = await debugFetch2(`${apiUrl}/api/lambda-deploy/${config.deploymentId}/env?reveal=true`, {
       headers: {
@@ -2815,7 +3108,7 @@ async function envPushCommand(folderPath, options = {}) {
   }
   const { apiKey, apiUrl, config } = context;
   const inputFile = options.file || ".env";
-  const loadSpinner = ora7(`Loading from ${inputFile}...`).start();
+  const loadSpinner = ora8(`Loading from ${inputFile}...`).start();
   let variables;
   try {
     variables = await loadEnvFile(inputFile);
@@ -2842,7 +3135,7 @@ ${error instanceof Error ? error.message : String(error)}`);
       return;
     }
   }
-  const pushSpinner = ora7("Pushing environment variables...").start();
+  const pushSpinner = ora8("Pushing environment variables...").start();
   try {
     const response = await debugFetch2(`${apiUrl}/api/lambda-deploy/${config.deploymentId}/env`, {
       method: "PUT",
@@ -3178,12 +3471,16 @@ vite.config.ts.timestamp-*
 var getExampleServiceTemplate = /* @__PURE__ */ __name((projectName) => `import { Tool, Resource, Prompt, SchemaConstraint, Optional } from "@leanmcp/core";
 
     /**
-     * Example service demonstrating LeanMCP SDK decorators
+     * ${projectName} - Production-ready MCP server example
      * 
-     * This is a simple example to get you started. Add your own tools, resources, and prompts here!
+     * This example demonstrates LeanMCP's core features:
+     * - Schema validation with decorators
+     * - Type-safe tool definitions
+     * - Resource and prompt capabilities
+     * - Production-ready structure
      */
 
-    // Input schema with validation decorators
+    // Input schemas with validation decorators
     class CalculateInput {
       @SchemaConstraint({ description: "First number" })
       a!: number;
@@ -3208,13 +3505,13 @@ var getExampleServiceTemplate = /* @__PURE__ */ __name((projectName) => `import
       message!: string;
     }
 
-    export class ExampleService {
+    export class ${projectName}Service {
+      // CALCULATION TOOL - Shows schema validation
       @Tool({
         description: "Perform arithmetic operations with automatic schema validation",
         inputClass: CalculateInput
       })
       async calculate(input: CalculateInput) {
-        // Ensure numerical operations by explicitly converting to numbers
         const a = Number(input.a);
         const b = Number(input.b);
         let result: number;
@@ -3243,14 +3540,17 @@ var getExampleServiceTemplate = /* @__PURE__ */ __name((projectName) => `import
             text: JSON.stringify({
               operation: input.operation || "add",
               operands: { a: input.a, b: input.b },
-              result
+              result,
+              timestamp: new Date().toISOString(),
+              server: "${projectName}"
             }, null, 2)
           }]
         };
       }
 
+      // ECHO TOOL - Shows basic functionality
       @Tool({
-        description: "Echo a message back",
+        description: "Echo a message back with timestamp",
         inputClass: EchoInput
       })
       async echo(input: EchoInput) {
@@ -3259,13 +3559,15 @@ var getExampleServiceTemplate = /* @__PURE__ */ __name((projectName) => `import
             type: "text" as const,
             text: JSON.stringify({
               echoed: input.message,
-              timestamp: new Date().toISOString()
+              timestamp: new Date().toISOString(),
+              server: "${projectName}"
             }, null, 2)
           }]
         };
       }
 
-      @Resource({ description: "Get server information" })
+      // SERVER INFO RESOURCE - Shows resource capabilities
+      @Resource({ description: "Get server information and health status" })
       async serverInfo() {
         return {
           contents: [{
@@ -3274,25 +3576,45 @@ var getExampleServiceTemplate = /* @__PURE__ */ __name((projectName) => `import
             text: JSON.stringify({
               name: "${projectName}",
               version: "1.0.0",
-              uptime: process.uptime()
+              status: "healthy",
+              uptime: Math.floor(process.uptime()),
+              memory: {
+                used: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
+                total: Math.round(process.memoryUsage().heapTotal / 1024 / 1024)
+              },
+              features: [
+                "Schema validation with decorators",
+                "Type-safe tool definitions", 
+                "Resource endpoints",
+                "Prompt templates"
+              ],
+              timestamp: new Date().toISOString()
             }, null, 2)
           }]
         };
       }
 
-      @Prompt({ description: "Generate a greeting prompt" })
-      async greeting(args: { name?: string }) {
+      // WELCOME PROMPT - Shows prompt capabilities
+      @Prompt({ description: "Generate a welcome prompt for the server" })
+      async welcome(args: { name?: string }) {
         return {
           messages: [{
             role: "user" as const,
             content: {
               type: "text" as const,
-              text: \`Hello \${args.name || 'there'}! Welcome to ${projectName}.\`
-        }
-      }]
-    };
-  }
-}
+              text: \`Welcome \${args.name || 'there'} to ${projectName}! 
+
+Your MCP server is running with these tools:
+- calculate: Perform arithmetic operations
+- echo: Echo messages back
+- serverInfo: Get server status and information
+
+Try calling these tools to see LeanMCP in action!\`
+            }
+          }]
+        };
+      }
+    }
 `, "getExampleServiceTemplate");
 
 // src/templates/main_ts_v1.ts
@@ -3302,6 +3624,14 @@ import { createHTTPServer } from "@leanmcp/core";
 // Load environment variables
 dotenv.config();
 
+console.log("Starting ${projectName} MCP Server...");
+console.log("Features included:");
+console.log("   Schema validation with decorators");
+console.log("   Resource endpoints");
+console.log("   Prompt templates");
+console.log("   Type-safe tool definitions");
+console.log("");
+
 // Services are automatically discovered from ./mcp directory
 await createHTTPServer({
   name: "${projectName}",
@@ -3309,10 +3639,27 @@ await createHTTPServer({
   port: 3001,
   cors: true,
   logging: true${dashboardLine}
-  // stateless: false,  // Enable stateful mode (uses DynamoDB on Lambda for session persistence)
 });
 
-console.log("\\n${projectName} MCP Server");
+console.log("\\n${projectName} MCP Server is running!");
+console.log("\\nTry these commands to test your server:");
+console.log("");
+console.log("# Test calculation tool (schema validation)");
+console.log('curl -X POST http://localhost:3001/mcp \\\\');
+console.log('  -H "Content-Type: application/json" \\\\');
+console.log('  -d '{"method": "tools/call", "params": {"name": "calculate", "arguments": {"a": 10, "b": 5, "operation": "add"}}}'');
+console.log("");
+console.log("# Test echo tool");
+console.log('curl -X POST http://localhost:3001/mcp \\\\');
+console.log('  -H "Content-Type: application/json" \\\\');
+console.log('  -d '{"method": "tools/call", "params": {"name": "echo", "arguments": {"message": "Hello LeanMCP!"}}}'');
+console.log("");
+console.log("# Get server information (resource)");
+console.log('curl -X POST http://localhost:3001/mcp \\\\');
+console.log('  -H "Content-Type: application/json" \\\\');
+console.log('  -d '{"method": "resources/read", "params": {"uri": "server://info"}}'');
+console.log("");
+console.log("Ready to customize - add your own tools, resources, and prompts!");
 `, "getMainTsTemplate");
 
 // src/templates/service_index_v1.ts
@@ -3635,30 +3982,30 @@ program.command("create <projectName>").description("Create a new LeanMCP projec
     projectName,
     ...options
   });
-  const spinner = ora8(`Creating project ${projectName}...`).start();
-  const targetDir = path11.join(process.cwd(), projectName);
-  if (fs11.existsSync(targetDir)) {
+  const spinner = ora9(`Creating project ${projectName}...`).start();
+  const targetDir = path12.join(process.cwd(), projectName);
+  if (fs12.existsSync(targetDir)) {
     spinner.fail(`Folder ${projectName} already exists.`);
     process.exit(1);
   }
-  await fs11.mkdirp(targetDir);
+  await fs12.mkdirp(targetDir);
   const isPython = options.python === true;
   if (isPython) {
     const requirements = getPythonRequirementsTemplate();
-    await fs11.writeFile(path11.join(targetDir, "requirements.txt"), requirements);
+    await fs12.writeFile(path12.join(targetDir, "requirements.txt"), requirements);
     const mainPy = getPythonMainTemplate(projectName);
-    await fs11.writeFile(path11.join(targetDir, "main.py"), mainPy);
-    await fs11.writeFile(path11.join(targetDir, ".gitignore"), pythonGitignoreTemplate);
+    await fs12.writeFile(path12.join(targetDir, "main.py"), mainPy);
+    await fs12.writeFile(path12.join(targetDir, ".gitignore"), pythonGitignoreTemplate);
     const env = `# Server Configuration
 PORT=3001
 
 # Add your environment variables here
 `;
-    await fs11.writeFile(path11.join(targetDir, ".env"), env);
+    await fs12.writeFile(path12.join(targetDir, ".env"), env);
     const readme = getPythonReadmeTemplate(projectName);
-    await fs11.writeFile(path11.join(targetDir, "README.md"), readme);
+    await fs12.writeFile(path12.join(targetDir, "README.md"), readme);
   } else {
-    await fs11.mkdirp(path11.join(targetDir, "mcp", "example"));
+    await fs12.mkdirp(path12.join(targetDir, "mcp", "example"));
     const pkg2 = {
       name: projectName,
       version: "1.0.0",
@@ -3694,7 +4041,7 @@ PORT=3001
         typescript: "^5.6.3"
       }
     };
-    await fs11.writeJSON(path11.join(targetDir, "package.json"), pkg2, {
+    await fs12.writeJSON(path12.join(targetDir, "package.json"), pkg2, {
       spaces: 2
     });
     const tsconfig = {
@@ -3717,15 +4064,15 @@ PORT=3001
         "dist"
       ]
     };
-    await fs11.writeJSON(path11.join(targetDir, "tsconfig.json"), tsconfig, {
+    await fs12.writeJSON(path12.join(targetDir, "tsconfig.json"), tsconfig, {
       spaces: 2
     });
     const dashboardLine = options.dashboard === false ? `
   dashboard: false,  // Dashboard disabled via --no-dashboard` : "";
     const mainTs = getMainTsTemplate(projectName, dashboardLine);
-    await fs11.writeFile(path11.join(targetDir, "main.ts"), mainTs);
+    await fs12.writeFile(path12.join(targetDir, "main.ts"), mainTs);
     const exampleServiceTs = getExampleServiceTemplate(projectName);
-    await fs11.writeFile(path11.join(targetDir, "mcp", "example", "index.ts"), exampleServiceTs);
+    await fs12.writeFile(path12.join(targetDir, "mcp", "example", "index.ts"), exampleServiceTs);
     const gitignore = gitignoreTemplate;
     const env = `# Server Configuration
 PORT=3001
@@ -3733,10 +4080,10 @@ NODE_ENV=development
 
 # Add your environment variables here
 `;
-    await fs11.writeFile(path11.join(targetDir, ".gitignore"), gitignore);
-    await fs11.writeFile(path11.join(targetDir, ".env"), env);
+    await fs12.writeFile(path12.join(targetDir, ".gitignore"), gitignore);
+    await fs12.writeFile(path12.join(targetDir, ".env"), env);
     const readme = getReadmeTemplate(projectName);
-    await fs11.writeFile(path11.join(targetDir, "README.md"), readme);
+    await fs12.writeFile(path12.join(targetDir, "README.md"), readme);
   }
   spinner.succeed(`Project ${projectName} created!`);
   logger.log("\nSuccess! Your MCP server is ready.\n", chalk.green);
@@ -3783,7 +4130,7 @@ NODE_ENV=development
     default: true
   });
   if (shouldInstall) {
-    const installSpinner = ora8("Installing dependencies...").start();
+    const installSpinner = ora9("Installing dependencies...").start();
     try {
       await new Promise((resolve, reject) => {
         const npmInstall = spawn4("npm", [
@@ -3856,24 +4203,33 @@ NODE_ENV=development
     logger.log("To deploy to LeanMCP cloud:", chalk.cyan);
     logger.log(`  cd ${projectName}`, chalk.gray);
     logger.log(`  leanmcp deploy .`, chalk.gray);
+    logger.log("\nSend us feedback:", chalk.cyan);
+    logger.log('  leanmcp send-feedback "Great tool!"\n', chalk.gray);
   }
 });
+program.command("send-feedback [message]").description("Send feedback to the LeanMCP team").option("--anon", "Send feedback anonymously").option("--include-logs", "Include local log files with feedback").action(async (message, options) => {
+  trackCommand("send-feedback", {
+    hasMessage: !!message,
+    ...options
+  });
+  await sendFeedbackCommand(message, options);
+});
 program.command("add <serviceName>").description("Add a new MCP service to your project").action(async (serviceName) => {
   const cwd = process.cwd();
-  const mcpDir = path11.join(cwd, "mcp");
-  if (!fs11.existsSync(path11.join(cwd, "main.ts"))) {
+  const mcpDir = path12.join(cwd, "mcp");
+  if (!fs12.existsSync(path12.join(cwd, "main.ts"))) {
     logger.log("ERROR: Not a LeanMCP project (main.ts missing).", chalk.red);
     process.exit(1);
   }
-  const serviceDir = path11.join(mcpDir, serviceName);
-  const serviceFile = path11.join(serviceDir, "index.ts");
-  if (fs11.existsSync(serviceDir)) {
+  const serviceDir = path12.join(mcpDir, serviceName);
+  const serviceFile = path12.join(serviceDir, "index.ts");
+  if (fs12.existsSync(serviceDir)) {
     logger.log(`ERROR: Service ${serviceName} already exists.`, chalk.red);
     process.exit(1);
   }
-  await fs11.mkdirp(serviceDir);
+  await fs12.mkdirp(serviceDir);
   const indexTs = getServiceIndexTemplate(serviceName, capitalize(serviceName));
-  await fs11.writeFile(serviceFile, indexTs);
+  await fs12.writeFile(serviceFile, indexTs);
   logger.log(`\\nCreated new service: ${chalk.bold(serviceName)}`, chalk.green);
   logger.log(`   File: mcp/${serviceName}/index.ts`, chalk.gray);
   logger.log(`   Tool: greet`, chalk.gray);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanmcp/cli",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "Command-line interface for scaffolding LeanMCP projects",
   "bin": {
     "leanmcp": "bin/leanmcp.js"