create-velox-app 0.6.51 → 0.6.54

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # create-velox-app
 
+## 0.6.54
+
+### Patch Changes
+
+- feat(cli): add velox mcp init command for Claude Desktop setup
+
+## 0.6.53
+
+### Patch Changes
+
+- feat(cli): add duplicate file detection to resource generator
+
+## 0.6.52
+
+### Patch Changes
+
+- feat(mcp): smart CLI resolution with fallbacks
+
 ## 0.6.51
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-velox-app",
-  "version": "0.6.51",
+  "version": "0.6.54",
   "description": "Project scaffolder for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",

package/src/templates/source/root/CLAUDE.auth.md

@@ -416,3 +416,69 @@ velox procedures list --json
 4. Run migrations: `velox migrate run --dev`
 5. Seed data: `velox db seed --fresh`
 6. Test endpoints with Thunder Client or curl
+
+## AI-Powered Development with MCP
+
+VeloxTS includes a **Model Context Protocol (MCP) server** that gives AI assistants like Claude direct access to your project structure. This enables intelligent code assistance with full awareness of your procedures, schemas, routes, and error codes.
+
+### What You Get
+
+- **Resources**: Real-time project introspection (procedures, routes, schemas, errors)
+- **Tools**: Code generation and database migration commands
+- **Prompts**: Best practice templates for common VeloxTS tasks
+
+### Setup for Claude Code (CLI)
+
+The MCP server auto-discovers VeloxTS projects:
+
+```bash
+# Start the MCP server
+npx velox-mcp
+
+# Or with debug logging
+npx velox-mcp --debug
+```
+
+### Setup for Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "veloxts": {
+      "command": "npx",
+      "args": ["@veloxts/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after adding the configuration.
+
+### What Claude Can Do With MCP
+
+| Capability | Description |
+|------------|-------------|
+| Generate Code | Create procedures, schemas, models, resources, tests |
+| Run Migrations | Check status, run, rollback, fresh, reset |
+| Access Context | List procedures, routes, schemas, error codes |
+
+### Example Prompts
+
+1. **"Generate a complete CRUD resource for BlogPost with pagination"**
+2. **"Show me all my API procedures and their REST endpoints"**
+3. **"Run pending database migrations and show the status"**
+
+### Available MCP Resources
+
+| Resource | Description |
+|----------|-------------|
+| `velox://procedures` | All procedures with types and REST mappings |
+| `velox://routes` | Complete REST route table |
+| `velox://schemas` | Zod validation schemas |
+| `velox://errors` | Error catalog with fix suggestions |
+| `velox://project` | Project metadata and file paths |

package/src/templates/source/root/CLAUDE.default.md

@@ -317,3 +317,69 @@ velox procedures list --json
 4. Run migrations: `velox migrate run --dev`
 5. Seed data: `velox db seed --fresh`
 6. Test endpoints with Thunder Client or curl
+
+## AI-Powered Development with MCP
+
+VeloxTS includes a **Model Context Protocol (MCP) server** that gives AI assistants like Claude direct access to your project structure. This enables intelligent code assistance with full awareness of your procedures, schemas, routes, and error codes.
+
+### What You Get
+
+- **Resources**: Real-time project introspection (procedures, routes, schemas, errors)
+- **Tools**: Code generation and database migration commands
+- **Prompts**: Best practice templates for common VeloxTS tasks
+
+### Setup for Claude Code (CLI)
+
+The MCP server auto-discovers VeloxTS projects:
+
+```bash
+# Start the MCP server
+npx velox-mcp
+
+# Or with debug logging
+npx velox-mcp --debug
+```
+
+### Setup for Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "veloxts": {
+      "command": "npx",
+      "args": ["@veloxts/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after adding the configuration.
+
+### What Claude Can Do With MCP
+
+| Capability | Description |
+|------------|-------------|
+| Generate Code | Create procedures, schemas, models, resources, tests |
+| Run Migrations | Check status, run, rollback, fresh, reset |
+| Access Context | List procedures, routes, schemas, error codes |
+
+### Example Prompts
+
+1. **"Generate a complete CRUD resource for BlogPost with pagination"**
+2. **"Show me all my API procedures and their REST endpoints"**
+3. **"Run pending database migrations and show the status"**
+
+### Available MCP Resources
+
+| Resource | Description |
+|----------|-------------|
+| `velox://procedures` | All procedures with types and REST mappings |
+| `velox://routes` | Complete REST route table |
+| `velox://schemas` | Zod validation schemas |
+| `velox://errors` | Error catalog with fix suggestions |
+| `velox://project` | Project metadata and file paths |

package/src/templates/source/rsc/CLAUDE.md

@@ -156,3 +156,59 @@ __RUN_CMD__ start       # Start production server
 - `POST /api/users` - Create user
 - `PUT /api/users/:id` - Update user
 - `DELETE /api/users/:id` - Delete user
+
+## AI-Powered Development with MCP
+
+VeloxTS includes a **Model Context Protocol (MCP) server** that gives AI assistants like Claude direct access to your project structure. This enables intelligent code assistance with full awareness of your procedures, schemas, routes, and error codes.
+
+### What You Get
+
+- **Resources**: Real-time project introspection (procedures, routes, schemas, errors)
+- **Tools**: Code generation and database migration commands
+- **Prompts**: Best practice templates for common VeloxTS tasks
+
+### Setup for Claude Code (CLI)
+
+The MCP server auto-discovers VeloxTS projects:
+
+```bash
+# Start the MCP server
+npx velox-mcp
+
+# Or with debug logging
+npx velox-mcp --debug
+```
+
+### Setup for Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "veloxts": {
+      "command": "npx",
+      "args": ["@veloxts/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after adding the configuration.
+
+### What Claude Can Do With MCP
+
+| Capability | Description |
+|------------|-------------|
+| Generate Code | Create procedures, schemas, models, resources, tests |
+| Run Migrations | Check status, run, rollback, fresh, reset |
+| Access Context | List procedures, routes, schemas, error codes |
+
+### Example Prompts
+
+1. **"Generate a complete CRUD resource for BlogPost with pagination"**
+2. **"Show me all my API procedures and their REST endpoints"**
+3. **"Run pending database migrations and show the status"**

package/src/templates/source/rsc-auth/CLAUDE.md

@@ -228,3 +228,59 @@ JWT_REFRESH_SECRET="..."
 - `POST /api/users` - Create user
 - `PUT /api/users/:id` - Update user
 - `DELETE /api/users/:id` - Delete user
+
+## AI-Powered Development with MCP
+
+VeloxTS includes a **Model Context Protocol (MCP) server** that gives AI assistants like Claude direct access to your project structure. This enables intelligent code assistance with full awareness of your procedures, schemas, routes, and error codes.
+
+### What You Get
+
+- **Resources**: Real-time project introspection (procedures, routes, schemas, errors)
+- **Tools**: Code generation and database migration commands
+- **Prompts**: Best practice templates for common VeloxTS tasks
+
+### Setup for Claude Code (CLI)
+
+The MCP server auto-discovers VeloxTS projects:
+
+```bash
+# Start the MCP server
+npx velox-mcp
+
+# Or with debug logging
+npx velox-mcp --debug
+```
+
+### Setup for Claude Desktop
+
+Add this to your Claude Desktop configuration file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "veloxts": {
+      "command": "npx",
+      "args": ["@veloxts/mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after adding the configuration.
+
+### What Claude Can Do With MCP
+
+| Capability | Description |
+|------------|-------------|
+| Generate Code | Create procedures, schemas, models, resources, tests |
+| Run Migrations | Check status, run, rollback, fresh, reset |
+| Access Context | List procedures, routes, schemas, error codes |
+
+### Example Prompts
+
+1. **"Generate a complete CRUD resource for BlogPost with pagination"**
+2. **"Show me all my API procedures and their REST endpoints"**
+3. **"Run pending database migrations and show the status"**