@vurb/core 3.8.2 → 3.8.3

package/dist/cli/constants.d.ts

@@ -10,7 +10,7 @@ export declare const ansi: {
 };
 export declare const VURB_VERSION: string;
 /** Default API endpoint — Vinkius Cloud production */
-export declare const VINKIUS_CLOUD_URL = "https://cloud.vinkius.com";
+export declare const VINKIUS_CLOUD_URL = "https://deploy.vinkius.com";
 export declare const VALID_TRANSPORTS: readonly ["stdio", "sse"];
 export declare const VALID_VECTORS: readonly ["vanilla", "prisma", "n8n", "openapi", "oauth"];
 export declare const VALID_TARGETS: readonly ["vinkius", "vercel", "cloudflare"];

package/dist/cli/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AASA,qCAAqC;AACrC,eAAO,MAAM,IAAI;uBACD,MAAM,KAAG,MAAM;wBACf,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;uBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;;CAErB,CAAC;AAMX,eAAO,MAAM,YAAY,EAAE,MAGvB,CAAC;AAEL,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAI7D,eAAO,MAAM,gBAAgB,2BAA4B,CAAC;AAC1D,eAAO,MAAM,aAAa,2DAA4D,CAAC;AACvF,eAAO,MAAM,aAAa,8CAA+C,CAAC;AAI1E,qCAAqC;AACrC,eAAO,MAAM,IAAI,QAsET,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AASA,qCAAqC;AACrC,eAAO,MAAM,IAAI;uBACD,MAAM,KAAG,MAAM;wBACf,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;uBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;;CAErB,CAAC;AAMX,eAAO,MAAM,YAAY,EAAE,MAGvB,CAAC;AAEL,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,+BAA+B,CAAC;AAI9D,eAAO,MAAM,gBAAgB,2BAA4B,CAAC;AAC1D,eAAO,MAAM,aAAa,2DAA4D,CAAC;AACvF,eAAO,MAAM,aAAa,8CAA+C,CAAC;AAI1E,qCAAqC;AACrC,eAAO,MAAM,IAAI,QAsET,CAAC"}

package/dist/cli/constants.js

@@ -27,82 +27,82 @@ export const VURB_VERSION = (() => {
     }
 })();
 /** Default API endpoint — Vinkius Cloud production */
-export const VINKIUS_CLOUD_URL = 'https://cloud.vinkius.com';
+export const VINKIUS_CLOUD_URL = 'https://deploy.vinkius.com';
 // ─── Validation Constants ────────────────────────────────────────
 export const VALID_TRANSPORTS = ['stdio', 'sse'];
 export const VALID_VECTORS = ['vanilla', 'prisma', 'n8n', 'openapi', 'oauth'];
 export const VALID_TARGETS = ['vinkius', 'vercel', 'cloudflare'];
 // ─── Help Text ───────────────────────────────────────────────────
 /** @internal exported for testing */
-export const HELP = `
-vurb — Vurb CLI
-
-USAGE
-  vurb create <name>                Scaffold a new Vurb server
-  vurb dev --server <entry>         Start HMR dev server with auto-reload
-  vurb lock                         Generate or update ${LOCKFILE_NAME}
-  vurb lock --check                 Verify lockfile is up to date (CI gate)
-  vurb deploy                       Bundle, compress & deploy to Edge
-  vurb remote                       Show current remote configuration
-  vurb token                        Show current token status
-  vurb inspect                      Launch the real-time TUI dashboard
-  vurb insp --demo                  Launch TUI with built-in simulator
-
-CREATE OPTIONS
-  --transport <stdio|sse>  Transport layer (default: stdio)
-  --vector <type>          Ingestion vector: vanilla, prisma, n8n, openapi, oauth
-  --target <platform>      Deploy target: vinkius (default), vercel, cloudflare
-  --testing                Include test suite (default: true)
-  --no-testing             Skip test suite
-  --yes, -y                Skip prompts, use defaults
-
-DEV OPTIONS
-  --server, -s <path>      Path to server entrypoint (default: auto-detect)
-  --dir, -d <path>         Directory to watch for changes (default: auto-detect from server)
-
-DEPLOY OPTIONS
-  --server, -s <path>      Path to server entrypoint (default: auto-detect)
-  --token <token>          Override VURB_DEPLOY_TOKEN (connection token)
-  --allow-insecure         Suppress HTTP plaintext warning
-
-REMOTE OPTIONS
-  vurb remote <url>          Override API endpoint (default: Vinkius Cloud)
-  vurb remote --server-id <id>  Set target server UUID
-  --token <token>            Save deploy token to .vurbrc
-
-TOKEN OPTIONS
-  vurb token <token>         Save deploy token to .vurbrc
-  vurb token                 Show current token status (masked)
-  vurb token --clear         Remove token from .vurbrc
-
-INSPECTOR OPTIONS
-  --demo, -d               Launch with built-in simulator (no server needed)
-  --out, -o <mode>         Output: tui (default), stderr (headless ECS/K8s)
-  --pid, -p <pid>          Connect to a specific server PID
-  --path <path>            Custom IPC socket/pipe path
-
-LOCK OPTIONS
-  --server, -s <path>      Path to server entrypoint
-  --name, -n <name>        Server name for lockfile header
-  --cwd <dir>              Project root directory
-
-GLOBAL
-  --help, -h               Show this help message
-
-EXAMPLES
-  vurb create my-server
-  vurb create my-server -y
-  vurb create my-server --vector prisma --transport sse
-  vurb dev --server ./src/server.ts
-  vurb dev --server ./src/server.ts --dir ./src/tools
-  vurb lock --server ./src/server.ts
-  vurb deploy
-  vurb remote --server-id abc-123-def
-  vurb remote --server-id abc-123-def --token vk_live_xxx
-  vurb remote http://localhost:8080 --server-id abc-123-def
-  vurb token vk_live_9hfaJlIPOv5xZh
-  vurb token --clear
-  vurb inspect --demo
-  vurb insp --pid 12345
+export const HELP = `
+vurb — Vurb CLI
+
+USAGE
+  vurb create <name>                Scaffold a new Vurb server
+  vurb dev --server <entry>         Start HMR dev server with auto-reload
+  vurb lock                         Generate or update ${LOCKFILE_NAME}
+  vurb lock --check                 Verify lockfile is up to date (CI gate)
+  vurb deploy                       Bundle, compress & deploy to Edge
+  vurb remote                       Show current remote configuration
+  vurb token                        Show current token status
+  vurb inspect                      Launch the real-time TUI dashboard
+  vurb insp --demo                  Launch TUI with built-in simulator
+
+CREATE OPTIONS
+  --transport <stdio|sse>  Transport layer (default: stdio)
+  --vector <type>          Ingestion vector: vanilla, prisma, n8n, openapi, oauth
+  --target <platform>      Deploy target: vinkius (default), vercel, cloudflare
+  --testing                Include test suite (default: true)
+  --no-testing             Skip test suite
+  --yes, -y                Skip prompts, use defaults
+
+DEV OPTIONS
+  --server, -s <path>      Path to server entrypoint (default: auto-detect)
+  --dir, -d <path>         Directory to watch for changes (default: auto-detect from server)
+
+DEPLOY OPTIONS
+  --server, -s <path>      Path to server entrypoint (default: auto-detect)
+  --token <token>          Override VURB_DEPLOY_TOKEN (connection token)
+  --allow-insecure         Suppress HTTP plaintext warning
+
+REMOTE OPTIONS
+  vurb remote <url>          Override API endpoint (default: Vinkius Cloud)
+  vurb remote --server-id <id>  Set target server UUID
+  --token <token>            Save deploy token to .vurbrc
+
+TOKEN OPTIONS
+  vurb token <token>         Save deploy token to .vurbrc
+  vurb token                 Show current token status (masked)
+  vurb token --clear         Remove token from .vurbrc
+
+INSPECTOR OPTIONS
+  --demo, -d               Launch with built-in simulator (no server needed)
+  --out, -o <mode>         Output: tui (default), stderr (headless ECS/K8s)
+  --pid, -p <pid>          Connect to a specific server PID
+  --path <path>            Custom IPC socket/pipe path
+
+LOCK OPTIONS
+  --server, -s <path>      Path to server entrypoint
+  --name, -n <name>        Server name for lockfile header
+  --cwd <dir>              Project root directory
+
+GLOBAL
+  --help, -h               Show this help message
+
+EXAMPLES
+  vurb create my-server
+  vurb create my-server -y
+  vurb create my-server --vector prisma --transport sse
+  vurb dev --server ./src/server.ts
+  vurb dev --server ./src/server.ts --dir ./src/tools
+  vurb lock --server ./src/server.ts
+  vurb deploy
+  vurb remote --server-id abc-123-def
+  vurb remote --server-id abc-123-def --token vk_live_xxx
+  vurb remote http://localhost:8080 --server-id abc-123-def
+  vurb token vk_live_9hfaJlIPOv5xZh
+  vurb token --clear
+  vurb inspect --demo
+  vurb insp --pid 12345
 `.trim();
 //# sourceMappingURL=constants.js.map

package/dist/cli/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAG,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,MAAM,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAE,SAAS;CACV,CAAC;AAEX,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAW,CAAC,GAAG,EAAE;IACtC,IAAI,CAAC;QAAC,OAAQ,QAAQ,CAAC,oBAAoB,CAAyB,CAAC,OAAO,CAAC;IAAC,CAAC;IAC/E,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC;IAAC,CAAC;AAC7B,CAAC,CAAC,EAAE,CAAC;AAEL,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE7D,oEAAoE;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAE1E,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;yDAMqC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgErE,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAG,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,MAAM,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAE,SAAS;CACV,CAAC;AAEX,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAW,CAAC,GAAG,EAAE;IACtC,IAAI,CAAC;QAAC,OAAQ,QAAQ,CAAC,oBAAoB,CAAyB,CAAC,OAAO,CAAC;IAAC,CAAC;IAC/E,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC;IAAC,CAAC;AAC7B,CAAC,CAAC,EAAE,CAAC;AAEL,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAA4B,CAAC;AAE9D,oEAAoE;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAE1E,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;yDAMqC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgErE,CAAC,IAAI,EAAE,CAAC"}

package/dist/cli/templates/cloudflare.js

@@ -82,263 +82,263 @@ export function cloudflareTsconfig() {
 }
 /** Generate `wrangler.toml` */
 export function cloudflareWranglerToml(config) {
-    return `name = "${config.name}"
-main = "src/worker.ts"
-compatibility_date = "2024-12-01"
-compatibility_flags = ["nodejs_compat"]
-
-# ── Bindings ────────────────────────────────────────
-# Uncomment to enable Cloudflare services:
-
-# [vars]
-# MY_SECRET = "value"
-
-# [[d1_databases]]
-# binding = "DB"
-# database_name = "${config.name}-db"
-# database_id = "<your-database-id>"
-
-# [[kv_namespaces]]
-# binding = "KV"
-# id = "<your-kv-namespace-id>"
-
-# [[r2_buckets]]
-# binding = "BUCKET"
-# bucket_name = "${config.name}-bucket"
+    return `name = "${config.name}"
+main = "src/worker.ts"
+compatibility_date = "2024-12-01"
+compatibility_flags = ["nodejs_compat"]
+
+# ── Bindings ────────────────────────────────────────
+# Uncomment to enable Cloudflare services:
+
+# [vars]
+# MY_SECRET = "value"
+
+# [[d1_databases]]
+# binding = "DB"
+# database_name = "${config.name}-db"
+# database_id = "<your-database-id>"
+
+# [[kv_namespaces]]
+# binding = "KV"
+# id = "<your-kv-namespace-id>"
+
+# [[r2_buckets]]
+# binding = "BUCKET"
+# bucket_name = "${config.name}-bucket"
 `;
 }
 /** Generate `src/worker.ts` — The Worker entry point */
 export function cloudflareWorkerTs(config) {
-    return `/**
- * Cloudflare Worker — MCP Server
- *
- * Exposes your Vurb tools as a stateless MCP endpoint.
- * Connect any MCP client to: POST https://your-worker.workers.dev/
- */
-import { cloudflareWorkersAdapter } from '@vurb/cloudflare';
-import { registry } from './registry.js';
-import { createContext } from './context.js';
-
-export interface Env {
-    // Add your Cloudflare bindings here:
-    // DB: D1Database;
-    // KV: KVNamespace;
-    // BUCKET: R2Bucket;
-}
-
-export default cloudflareWorkersAdapter<Env, ReturnType<typeof createContext>>({
-    registry,
-    serverName: '${config.name}',
-    contextFactory: async (req, env) => createContext(),
-});
+    return `/**
+ * Cloudflare Worker — MCP Server
+ *
+ * Exposes your Vurb tools as a stateless MCP endpoint.
+ * Connect any MCP client to: POST https://your-worker.workers.dev/
+ */
+import { cloudflareWorkersAdapter } from '@vurb/cloudflare';
+import { registry } from './registry.js';
+import { createContext } from './context.js';
+
+export interface Env {
+    // Add your Cloudflare bindings here:
+    // DB: D1Database;
+    // KV: KVNamespace;
+    // BUCKET: R2Bucket;
+}
+
+export default cloudflareWorkersAdapter<Env, ReturnType<typeof createContext>>({
+    registry,
+    serverName: '${config.name}',
+    contextFactory: async (req, env) => createContext(),
+});
 `;
 }
 /** Generate `src/registry.ts` — Tool registry (cold-start) */
 export function cloudflareRegistryTs() {
-    return `/**
- * Tool Registry — Cold Start Initialization
- *
- * Registered tools are compiled once during cold start.
- * Warm requests only instantiate McpServer + Transport.
- */
-import { f } from './vurb.js';
-import healthTool from './tools/system/health.js';
-import echoTool from './tools/system/echo.js';
-
-export const registry = f.registry();
-registry.register(healthTool);
-registry.register(echoTool);
+    return `/**
+ * Tool Registry — Cold Start Initialization
+ *
+ * Registered tools are compiled once during cold start.
+ * Warm requests only instantiate McpServer + Transport.
+ */
+import { f } from './vurb.js';
+import healthTool from './tools/system/health.js';
+import echoTool from './tools/system/echo.js';
+
+export const registry = f.registry();
+registry.register(healthTool);
+registry.register(echoTool);
 `;
 }
 /** Generate `src/vurb.ts` — initVurb instance */
 export function cloudflareVurbTs() {
-    return `/**
- * Vurb Instance — Context Initialization
- *
- * Define your context type ONCE. Every f.query(), f.mutation(),
- * and f.presenter() call inherits AppContext.
- */
-import { initVurb } from '@vurb/core';
-import type { AppContext } from './context.js';
-
-export const f = initVurb<AppContext>();
+    return `/**
+ * Vurb Instance — Context Initialization
+ *
+ * Define your context type ONCE. Every f.query(), f.mutation(),
+ * and f.presenter() call inherits AppContext.
+ */
+import { initVurb } from '@vurb/core';
+import type { AppContext } from './context.js';
+
+export const f = initVurb<AppContext>();
 `;
 }
 /** Generate `src/context.ts` — Application context */
 export function cloudflareContextTs() {
-    return `/**
- * Application Context — Shared State for Every Tool Handler
- *
- * Every f.query() / f.mutation() handler receives (input, ctx)
- * where ctx is this AppContext.
- */
-
-export interface AppContext {
-    /** Current user role for RBAC checks */
-    role: 'ADMIN' | 'USER' | 'GUEST';
-
-    /** Tenant identifier (multi-tenancy) */
-    tenantId: string;
-}
-
-/**
- * Create the application context for each tool invocation.
- *
- * In production, hydrate from Cloudflare env bindings,
- * request headers, or secrets.
- */
-export function createContext(): AppContext {
-    return {
-        role: 'ADMIN',
-        tenantId: 'default',
-    };
-}
+    return `/**
+ * Application Context — Shared State for Every Tool Handler
+ *
+ * Every f.query() / f.mutation() handler receives (input, ctx)
+ * where ctx is this AppContext.
+ */
+
+export interface AppContext {
+    /** Current user role for RBAC checks */
+    role: 'ADMIN' | 'USER' | 'GUEST';
+
+    /** Tenant identifier (multi-tenancy) */
+    tenantId: string;
+}
+
+/**
+ * Create the application context for each tool invocation.
+ *
+ * In production, hydrate from Cloudflare env bindings,
+ * request headers, or secrets.
+ */
+export function createContext(): AppContext {
+    return {
+        role: 'ADMIN',
+        tenantId: 'default',
+    };
+}
 `;
 }
 /** Generate `.env.example` for Cloudflare */
 export function cloudflareEnvExample(config) {
-    let env = `# ── Vurb + Cloudflare Workers Environment ─────
-# Secrets are managed via wrangler:
-#   wrangler secret put MY_SECRET
-
-NODE_ENV=development
+    let env = `# ── Vurb + Cloudflare Workers Environment ─────
+# Secrets are managed via wrangler:
+#   wrangler secret put MY_SECRET
+
+NODE_ENV=development
 `;
     if (config.vector === 'prisma') {
-        env += `
-# Database (Prisma — Hyperdrive or external)
-DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
+        env += `
+# Database (Prisma — Hyperdrive or external)
+DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
 `;
     }
     return env;
 }
 /** Generate `.gitignore` for Cloudflare Workers */
 export function cloudflareGitignore() {
-    return `node_modules/
-dist/
-.wrangler/
-*.tsbuildinfo
-.env
-.dev.vars
-coverage/
+    return `node_modules/
+dist/
+.wrangler/
+*.tsbuildinfo
+.env
+.dev.vars
+coverage/
 `;
 }
 /** Generate `README.md` for Cloudflare project */
 export function cloudflareReadme(config) {
-    return `# ${config.name}
-
-MCP Server built with [Vurb](https://vurb.vinkius.com/) — deployed to Cloudflare Workers.
-
-## Quick Start
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-The MCP endpoint is available at \`POST http://localhost:8787/\`.
-
-## Deploy to Cloudflare
-
-\`\`\`bash
-npm run deploy
-\`\`\`
-
-Or directly:
-
-\`\`\`bash
-npx wrangler deploy
-\`\`\`
-
-## Client Configuration
-
-### Cursor / VS Code
-
-\`\`\`json
-{
-    "mcpServers": {
-        "${config.name}": {
-            "url": "https://${config.name}.your-subdomain.workers.dev/"
-        }
-    }
-}
-\`\`\`
-
-### Claude Desktop
-
-Add to your \`claude_desktop_config.json\`:
-
-\`\`\`json
-{
-    "mcpServers": {
-        "${config.name}": {
-            "url": "https://${config.name}.your-subdomain.workers.dev/"
-        }
-    }
-}
-\`\`\`
-
-## Project Structure
-
-\`\`\`
-src/
-├── worker.ts          # Worker entry → cloudflareWorkersAdapter()
-├── vurb.ts            # initVurb<AppContext>()
-├── context.ts         # AppContext type + factory
-├── registry.ts        # Tool registry (cold-start)
-└── tools/
-    └── system/
-        ├── health.ts  # Health check
-        └── echo.ts    # Echo tool
-wrangler.toml          # Cloudflare configuration
-\`\`\`
-
-## Cloudflare Bindings
-
-Uncomment bindings in \`wrangler.toml\` and update \`Env\` in \`worker.ts\`:
-
-\`\`\`typescript
-// worker.ts
-export interface Env {
-    DB: D1Database;
-    KV: KVNamespace;
-}
-
-export default cloudflareWorkersAdapter<Env, MyContext>({
-    registry,
-    contextFactory: async (req, env) => ({
-        db: env.DB,
-        tenantId: req.headers.get('x-tenant-id') || 'public',
-    }),
-});
-\`\`\`
-
-## Adding New Tools
-
-1. Create a tool in \`src/tools/\`:
-
-\`\`\`typescript
-import { f } from '../../vurb.js';
-
-export default f.query('my_tool')
-    .describe('What this tool does')
-    .withString('query', 'Search query')
-    .handle(async (input, ctx) => {
-        return { result: input.query };
-    });
-\`\`\`
-
-2. Register it in \`src/registry.ts\`:
-
-\`\`\`typescript
-import myTool from './tools/my-domain/my-tool.js';
-registry.register(myTool);
-\`\`\`
-
-## Documentation
-
-- [Vurb Docs](https://vurb.vinkius.com/)
-- [Cloudflare Adapter](https://vurb.vinkius.com/cloudflare-adapter)
-- [Presenter — Egress Firewall](https://vurb.vinkius.com/presenter)
+    return `# ${config.name}
+
+MCP Server built with [Vurb](https://vurb.vinkius.com/) — deployed to Cloudflare Workers.
+
+## Quick Start
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+The MCP endpoint is available at \`POST http://localhost:8787/\`.
+
+## Deploy to Cloudflare
+
+\`\`\`bash
+npm run deploy
+\`\`\`
+
+Or directly:
+
+\`\`\`bash
+npx wrangler deploy
+\`\`\`
+
+## Client Configuration
+
+### Cursor / VS Code
+
+\`\`\`json
+{
+    "mcpServers": {
+        "${config.name}": {
+            "url": "https://${config.name}.your-subdomain.workers.dev/"
+        }
+    }
+}
+\`\`\`
+
+### Claude Desktop
+
+Add to your \`claude_desktop_config.json\`:
+
+\`\`\`json
+{
+    "mcpServers": {
+        "${config.name}": {
+            "url": "https://${config.name}.your-subdomain.workers.dev/"
+        }
+    }
+}
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+src/
+├── worker.ts          # Worker entry → cloudflareWorkersAdapter()
+├── vurb.ts            # initVurb<AppContext>()
+├── context.ts         # AppContext type + factory
+├── registry.ts        # Tool registry (cold-start)
+└── tools/
+    └── system/
+        ├── health.ts  # Health check
+        └── echo.ts    # Echo tool
+wrangler.toml          # Cloudflare configuration
+\`\`\`
+
+## Cloudflare Bindings
+
+Uncomment bindings in \`wrangler.toml\` and update \`Env\` in \`worker.ts\`:
+
+\`\`\`typescript
+// worker.ts
+export interface Env {
+    DB: D1Database;
+    KV: KVNamespace;
+}
+
+export default cloudflareWorkersAdapter<Env, MyContext>({
+    registry,
+    contextFactory: async (req, env) => ({
+        db: env.DB,
+        tenantId: req.headers.get('x-tenant-id') || 'public',
+    }),
+});
+\`\`\`
+
+## Adding New Tools
+
+1. Create a tool in \`src/tools/\`:
+
+\`\`\`typescript
+import { f } from '../../vurb.js';
+
+export default f.query('my_tool')
+    .describe('What this tool does')
+    .withString('query', 'Search query')
+    .handle(async (input, ctx) => {
+        return { result: input.query };
+    });
+\`\`\`
+
+2. Register it in \`src/registry.ts\`:
+
+\`\`\`typescript
+import myTool from './tools/my-domain/my-tool.js';
+registry.register(myTool);
+\`\`\`
+
+## Documentation
+
+- [Vurb Docs](https://vurb.vinkius.com/)
+- [Cloudflare Adapter](https://vurb.vinkius.com/cloudflare-adapter)
+- [Presenter — Egress Firewall](https://vurb.vinkius.com/presenter)
 `;
 }
 //# sourceMappingURL=cloudflare.js.map