@vurb/core 3.2.0

package/dist/cli/templates/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Templates — Barrel Export
+ *
+ * Re-exports all template generators from their focused modules.
+ * @module
+ */
+export { packageJson, tsconfig, gitignore, envExample } from './config.js';
+export { vurbTs, contextTs, serverTs } from './core.js';
+export { healthToolTs, echoToolTs } from './tools.js';
+export { systemPresenterTs } from './presenter.js';
+export { greetPromptTs } from './prompt.js';
+export { authMiddlewareTs } from './middleware.js';
+export { vitestConfig, testSetupTs, systemTestTs } from './testing.js';
+export { readme } from './readme.js';
+export { cursorMcpJson } from './cursor.js';
+export { prismaSchema, dbUsersToolTs, n8nConnectorTs, openapiYaml, openapiSetupMd, oauthSetupTs, oauthMiddlewareTs } from './vectors/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/templates/index.js

@@ -0,0 +1,27 @@
+/**
+ * Templates — Barrel Export
+ *
+ * Re-exports all template generators from their focused modules.
+ * @module
+ */
+// Config (package.json, tsconfig, etc.)
+export { packageJson, tsconfig, gitignore, envExample } from './config.js';
+// Core source (vurb.ts, context.ts, server.ts)
+export { vurbTs, contextTs, serverTs } from './core.js';
+// Tools
+export { healthToolTs, echoToolTs } from './tools.js';
+// Presenter
+export { systemPresenterTs } from './presenter.js';
+// Prompt
+export { greetPromptTs } from './prompt.js';
+// Middleware
+export { authMiddlewareTs } from './middleware.js';
+// Testing
+export { vitestConfig, testSetupTs, systemTestTs } from './testing.js';
+// README
+export { readme } from './readme.js';
+// Cursor integration
+export { cursorMcpJson } from './cursor.js';
+// Vector-specific
+export { prismaSchema, dbUsersToolTs, n8nConnectorTs, openapiYaml, openapiSetupMd, oauthSetupTs, oauthMiddlewareTs } from './vectors/index.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wCAAwC;AACxC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3E,+CAA+C;AAC/C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAExD,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvE,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/templates/middleware.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Middleware Template — RBAC guard example (Fluent API)
+ * @module
+ */
+/** Generate `src/middleware/auth.ts` — RBAC middleware */
+export declare function authMiddlewareTs(): string;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/cli/templates/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,wBAAgB,gBAAgB,IAAI,MAAM,CA2BzC"}

package/dist/cli/templates/middleware.js

@@ -0,0 +1,34 @@
+/**
+ * Middleware Template — RBAC guard example (Fluent API)
+ * @module
+ */
+/** Generate `src/middleware/auth.ts` — RBAC middleware */
+export function authMiddlewareTs() {
+    return `/**
+ * Auth Middleware — RBAC Guard (Fluent API)
+ *
+ * Demonstrates f.middleware() — tRPC-style context derivation.
+ * Rejects GUEST requests with a structured error.
+ *
+ * Usage in tools:
+ *   f.query('users.list')
+ *     .use(withAuth)
+ *     .handle(async (input, ctx) => {
+ *       // ctx now has ctx.role guaranteed non-GUEST
+ *     });
+ *
+ * In production, replace with JWT validation,
+ * API key checks, or OAuth token verification.
+ */
+import { f } from '../vurb.js';
+import { error } from 'vurb';
+
+export const withAuth = f.middleware(async (ctx) => {
+    if (ctx.role === 'GUEST') {
+        throw error('Access denied. Authentication required.');
+    }
+    return { verified: true as const };
+});
+`;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/cli/templates/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/cli/templates/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;CAyBV,CAAC;AACF,CAAC"}

package/dist/cli/templates/presenter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Presenter Template — MVA View Layer (Egress Firewall)
+ * @module
+ */
+/** Generate `src/presenters/SystemPresenter.ts` */
+export declare function systemPresenterTs(): string;
+//# sourceMappingURL=presenter.d.ts.map

package/dist/cli/templates/presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/presenter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,wBAAgB,iBAAiB,IAAI,MAAM,CAuC1C"}

package/dist/cli/templates/presenter.js

@@ -0,0 +1,46 @@
+/**
+ * Presenter Template — MVA View Layer (Egress Firewall)
+ * @module
+ */
+/** Generate `src/presenters/SystemPresenter.ts` */
+export function systemPresenterTs() {
+    return [
+        '/**',
+        ' * System Presenter — MVA View Layer (Egress Firewall)',
+        ' *',
+        ' * Defines how the Agent perceives system health data.',
+        ' * The Zod schema acts as a field whitelist — undeclared',
+        ' * fields are physically stripped in RAM before they',
+        ' * reach the LLM context window.',
+        ' *',
+        ' * Features demonstrated:',
+        ' * - definePresenter() with Zod schema',
+        ' * - .describe() auto-rules (JIT — travel with data, not in global prompt)',
+        ' * - ui.markdown() server-rendered UI blocks',
+        ' * - suggestActions() for HATEOAS-style affordances',
+        ' */',
+        "import { definePresenter, ui } from 'vurb';",
+        "import { z } from 'zod';",
+        '',
+        'export const SystemPresenter = definePresenter({',
+        "    name: 'SystemHealth',",
+        '    schema: z.object({',
+        "        status: z.string().describe('Server operational status'),",
+        "        uptime: z.number().describe('Uptime in seconds since process start'),",
+        "        version: z.string().describe('Server version string'),",
+        "        timestamp: z.string().describe('ISO 8601 timestamp of this check'),",
+        '    }),',
+        '    // autoRules: true (default) — .describe() annotations become system rules',
+        '    ui: (data) => [',
+        '        ui.markdown(',
+        '            `\uD83D\uDFE2 **${data.status}** | \u23F1 ${Math.floor(data.uptime)}s | v${data.version}`',
+        '        ),',
+        '    ],',
+        "    suggestActions: (data) => data.status !== 'healthy'",
+        "        ? [{ tool: 'system.health', reason: 'Re-check after issue resolution' }]",
+        '        : [],',
+        '});',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=presenter.js.map

package/dist/cli/templates/presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.js","sourceRoot":"","sources":["../../../src/cli/templates/presenter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,UAAU,iBAAiB;IAC7B,OAAO;QACH,KAAK;QACL,wDAAwD;QACxD,IAAI;QACJ,wDAAwD;QACxD,0DAA0D;QAC1D,sDAAsD;QACtD,kCAAkC;QAClC,IAAI;QACJ,2BAA2B;QAC3B,wCAAwC;QACxC,4EAA4E;QAC5E,8CAA8C;QAC9C,qDAAqD;QACrD,KAAK;QACL,6CAA6C;QAC7C,0BAA0B;QAC1B,EAAE;QACF,kDAAkD;QAClD,2BAA2B;QAC3B,wBAAwB;QACxB,mEAAmE;QACnE,+EAA+E;QAC/E,gEAAgE;QAChE,6EAA6E;QAC7E,SAAS;QACT,gFAAgF;QAChF,qBAAqB;QACrB,sBAAsB;QACtB,uGAAuG;QACvG,YAAY;QACZ,QAAQ;QACR,yDAAyD;QACzD,kFAAkF;QAClF,eAAe;QACf,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/templates/prompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompt Template — MCP Prompt Engine example
+ * @module
+ */
+/** Generate `src/prompts/greet.ts` — Prompt Engine example */
+export declare function greetPromptTs(): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/cli/templates/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,MAAM,CAmCtC"}

package/dist/cli/templates/prompt.js

@@ -0,0 +1,42 @@
+/**
+ * Prompt Template — MCP Prompt Engine example
+ * @module
+ */
+/** Generate `src/prompts/greet.ts` — Prompt Engine example */
+export function greetPromptTs() {
+    return [
+        '/**',
+        ' * Greet Prompt — Prompt Engine Example',
+        ' *',
+        ' * Demonstrates:',
+        ' * - f.prompt() with automatic context typing',
+        ' * - JSON descriptors for args (no Zod needed)',
+        ' * - PromptMessage.system() + PromptMessage.user()',
+        ' * - MCP prompts/list + prompts/get',
+        ' */',
+        "import { f } from '../vurb.js';",
+        "import { PromptMessage } from 'vurb';",
+        '',
+        "export const GreetPrompt = f.prompt('greet', {",
+        "    description: 'Generate a personalized greeting for a user',",
+        '    args: {',
+        "        name: { type: 'string', description: 'Name of the person to greet' },",
+        '        style: {',
+        "            enum: ['formal', 'casual', 'pirate'] as const,",
+        "            description: 'Greeting style',",
+        '        },',
+        '    } as const,',
+        '    handler: async (_ctx, { name, style }) => ({',
+        '        messages: [',
+        '            PromptMessage.system(',
+        '                `You are a friendly assistant. Greet the user in a ${style} style. ` +',
+        '                `Be creative and enthusiastic.`',
+        '            ),',
+        '            PromptMessage.user(`Please greet ${name}.`),',
+        '        ],',
+        '    }),',
+        '});',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/templates/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/cli/templates/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,UAAU,aAAa;IACzB,OAAO;QACH,KAAK;QACL,yCAAyC;QACzC,IAAI;QACJ,kBAAkB;QAClB,+CAA+C;QAC/C,gDAAgD;QAChD,oDAAoD;QACpD,qCAAqC;QACrC,KAAK;QACL,iCAAiC;QACjC,uCAAuC;QACvC,EAAE;QACF,gDAAgD;QAChD,iEAAiE;QACjE,aAAa;QACb,+EAA+E;QAC/E,kBAAkB;QAClB,4DAA4D;QAC5D,4CAA4C;QAC5C,YAAY;QACZ,iBAAiB;QACjB,kDAAkD;QAClD,qBAAqB;QACrB,mCAAmC;QACnC,wFAAwF;QACxF,iDAAiD;QACjD,gBAAgB;QAChB,0DAA0D;QAC1D,YAAY;QACZ,SAAS;QACT,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/cli/templates/readme.d.ts

@@ -0,0 +1,8 @@
+/**
+ * README Template — Quick-start guide with client config snippets
+ * @module
+ */
+import type { ProjectConfig } from '../types.js';
+/** Generate `README.md` with Claude/Cursor config snippets */
+export declare function readme(config: ProjectConfig): string;
+//# sourceMappingURL=readme.d.ts.map

package/dist/cli/templates/readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/readme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,8DAA8D;AAC9D,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA4FpD"}

package/dist/cli/templates/readme.js

@@ -0,0 +1,173 @@
+/** Generate `README.md` with Claude/Cursor config snippets */
+export function readme(config) {
+    const clientEntry = config.transport === 'sse'
+        ? { url: 'http://localhost:3001/mcp' }
+        : { command: 'npx', args: ['tsx', 'src/server.ts'] };
+    const clientConfig = JSON.stringify({
+        mcpServers: {
+            [config.name]: clientEntry,
+        },
+    }, null, 2);
+    const sseNote = config.transport === 'sse'
+        ? `\n> **Note:** Streamable HTTP transport requires the server to be running first. Run \\\`npm start\\\` before connecting.`
+        : '';
+    return `# ${config.name}
+
+MCP Server built with [Vurb](https://vurb.vinkius.com/) — the MVA framework for the Model Context Protocol.
+
+## Quick Start
+
+\`\`\`bash
+npm install
+vurb dev
+\`\`\`
+${config.testing ? `
+## Testing
+
+\`\`\`bash
+npm test
+\`\`\`
+` : ''}
+## Project Structure
+
+\`\`\`
+src/
+├── vurb.ts          # initVurb<AppContext>() — context center
+├── context.ts         # AppContext type + factory
+├── server.ts          # Bootstrap with autoDiscover
+├── tools/             # Drop a file → it's a tool (autoDiscover)
+│   └── system/
+│       ├── health.ts  # Health check with Presenter
+│       └── echo.ts    # Echo for connectivity testing
+├── presenters/        # MVA View Layer (Egress Firewall)
+│   └── SystemPresenter.ts
+├── prompts/           # MCP Prompt Engine
+│   └── greet.ts
+└── middleware/        # RBAC guards
+    └── auth.ts
+\`\`\`
+
+## Client Configuration
+
+### Cursor Editor
+
+> **Already configured!** The \`.cursor/mcp.json\` file was generated automatically.
+> Just open this folder in Cursor and the server connects instantly.
+${sseNote}
+
+### Claude Desktop
+
+Add to your \`claude_desktop_config.json\`:
+
+\`\`\`json
+${clientConfig}
+\`\`\`
+${vectorReadmeSection(config)}
+## Adding New Tools
+
+Create a new file in \`src/tools/\`. It's automatically discovered:
+
+\`\`\`typescript
+// src/tools/my-domain/my-tool.ts
+import { f } from '../../vurb.js';
+
+export default f.query('my_domain.my_tool')
+    .describe('What this tool does')
+    .withString('query', 'Search query')
+    .handle(async (input, ctx) => {
+        return { result: input.query };
+    });
+\`\`\`
+
+No registration needed. The \`autoDiscover()\` system picks it up automatically.
+
+## Documentation
+
+- [Vurb Docs](https://vurb.vinkius.com/)
+- [Presenter — Egress Firewall](https://vurb.vinkius.com/presenter)
+- [DX Guide — initVurb()](https://vurb.vinkius.com/dx-guide)
+- [Testing](https://vurb.vinkius.com/testing)
+`;
+}
+/** Vector-specific README section */
+function vectorReadmeSection(config) {
+    switch (config.vector) {
+        case 'prisma':
+            return `
+## Database Setup (Prisma)
+
+1. Configure your database URL in \`.env\`:
+   \`\`\`
+   DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
+   \`\`\`
+
+2. Edit \`prisma/schema.prisma\` to define your models
+
+3. Generate the Prisma client and Vurb tools:
+   \`\`\`bash
+   npm run db:generate
+   \`\`\`
+
+4. Push the schema to your database:
+   \`\`\`bash
+   npm run db:push
+   \`\`\`
+
+Use \`/// @vurb.hide\` on sensitive fields to strip them from the Egress Firewall.
+`;
+        case 'n8n':
+            return `
+## n8n Workflow Setup
+
+1. Configure your n8n instance in \`.env\`:
+   \`\`\`
+   N8N_BASE_URL=http://localhost:5678
+   N8N_API_KEY=your-api-key
+   \`\`\`
+
+2. The connector in \`src/n8n.ts\` auto-discovers webhook workflows
+   and registers them as MCP tools.
+`;
+        case 'openapi':
+            return `
+## OpenAPI Generator Setup
+
+1. Replace \`openapi.yaml\` with your actual OpenAPI 3.x spec
+
+2. Generate the MCP server from the spec:
+   \`\`\`bash
+   npx @vurb/openapi-gen ./openapi.yaml --outDir ./src/generated
+   \`\`\`
+
+3. Import and register the generated tools in \`src/server.ts\`
+`;
+        case 'oauth':
+            return `
+## OAuth Device Flow Setup
+
+1. Configure your OAuth provider in \`.env\`:
+   \`\`\`
+   OAUTH_CLIENT_ID=your-client-id
+   OAUTH_AUTH_ENDPOINT=https://api.example.com/oauth/device/code
+   OAUTH_TOKEN_ENDPOINT=https://api.example.com/oauth/device/token
+   \`\`\`
+
+2. The auth tool in \`src/auth.ts\` is pre-configured with login, complete, status, and logout actions.
+
+3. Protect any tool with the \`withAuth\` middleware from \`src/middleware/auth.ts\`:
+   \`\`\`ts
+   import { withAuth } from '../middleware/auth.js';
+
+   export default f.query('protected.action')
+       .describe('A protected query')
+       .use(withAuth)
+       .handle(async (input, ctx) => {
+           // ctx is authenticated
+       });
+   \`\`\`
+`;
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=readme.js.map

package/dist/cli/templates/readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../../src/cli/templates/readme.ts"],"names":[],"mappings":"AAMA,8DAA8D;AAC9D,MAAM,UAAU,MAAM,CAAC,MAAqB;IACxC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK;QAC1C,CAAC,CAAC,EAAE,GAAG,EAAE,2BAA2B,EAAE;QACtC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;IAEzD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,UAAU,EAAE;YACR,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW;SAC7B;KACJ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEZ,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK;QACtC,CAAC,CAAC,2HAA2H;QAC7H,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,KAAK,MAAM,CAAC,IAAI;;;;;;;;;;EAUzB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;CAMlB,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BJ,OAAO;;;;;;;EAOP,YAAY;;EAEZ,mBAAmB,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyB5B,CAAC;AACF,CAAC;AAED,qCAAqC;AACrC,SAAS,mBAAmB,CAAC,MAAqB;IAC9C,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,QAAQ;YACT,OAAO;;;;;;;;;;;;;;;;;;;;;CAqBlB,CAAC;QACM,KAAK,KAAK;YACN,OAAO;;;;;;;;;;;CAWlB,CAAC;QACM,KAAK,SAAS;YACV,OAAO;;;;;;;;;;;CAWlB,CAAC;QACM,KAAK,OAAO;YACR,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBlB,CAAC;QACM;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC"}

package/dist/cli/templates/testing.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Testing Templates — Test setup and example tests
+ * @module
+ */
+/** Generate `vitest.config.ts` */
+export declare function vitestConfig(): string;
+/** Generate `tests/setup.ts` — Test infrastructure */
+export declare function testSetupTs(): string;
+/** Generate `tests/system.test.ts` — Egress Firewall + RBAC tests */
+export declare function systemTestTs(): string;
+//# sourceMappingURL=testing.d.ts.map

package/dist/cli/templates/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kCAAkC;AAClC,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED,sDAAsD;AACtD,wBAAgB,WAAW,IAAI,MAAM,CAyBpC;AAED,qEAAqE;AACrE,wBAAgB,YAAY,IAAI,MAAM,CAwDrC"}

package/dist/cli/templates/testing.js

@@ -0,0 +1,101 @@
+/**
+ * Testing Templates — Test setup and example tests
+ * @module
+ */
+/** Generate `vitest.config.ts` */
+export function vitestConfig() {
+    return `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        include: ['tests/**/*.test.ts'],
+    },
+});
+`;
+}
+/** Generate `tests/setup.ts` — Test infrastructure */
+export function testSetupTs() {
+    return `/**
+ * Test Setup — In-Memory MVA Emulator
+ *
+ * Creates a VurbTester that runs the full pipeline
+ * (Zod → Middleware → Handler → Egress Firewall)
+ * without any network transport.
+ *
+ * 2ms per test. $0.00 in tokens. Zero servers.
+ */
+import { fileURLToPath } from 'node:url';
+import { createVurbTester } from '@vurb/testing';
+import { autoDiscover } from 'vurb';
+import { f } from '../src/vurb.js';
+
+const registry = f.registry();
+await autoDiscover(registry, fileURLToPath(new URL('../src/tools', import.meta.url)));
+
+export const tester = createVurbTester(registry, {
+    contextFactory: () => ({
+        role: 'ADMIN' as const,
+        tenantId: 'test-tenant',
+    }),
+});
+`;
+}
+/** Generate `tests/system.test.ts` — Egress Firewall + RBAC tests */
+export function systemTestTs() {
+    return `/**
+ * System Tools — Egress Firewall & RBAC Tests
+ *
+ * Proves that:
+ * 1. The Presenter strips undeclared fields (SOC2 CC6.1)
+ * 2. RBAC middleware blocks GUEST access (SOC2 CC6.3)
+ * 3. System rules from .describe() are injected
+ */
+import { describe, it, expect } from 'vitest';
+import { tester } from './setup.js';
+
+describe('System Tools', () => {
+    describe('Egress Firewall', () => {
+        it('should return validated health data through the Presenter', async () => {
+            const result = await tester.callAction('system', 'health');
+
+            expect(result.isError).toBe(false);
+            expect(result.data).toHaveProperty('status');
+            expect(result.data).toHaveProperty('uptime');
+            expect(result.data).toHaveProperty('version');
+            expect(result.data).toHaveProperty('timestamp');
+        });
+
+        it('should strip undeclared fields (tenant must NOT leak)', async () => {
+            const result = await tester.callAction('system', 'health');
+
+            expect(result.isError).toBe(false);
+            // The handler returns 'tenant' but the Presenter schema
+            // does not declare it → stripped by Egress Firewall
+            expect(result.data).not.toHaveProperty('tenant');
+        });
+
+        it('should include JIT system rules from .describe()', async () => {
+            const result = await tester.callAction('system', 'health');
+
+            expect(result.systemRules.length).toBeGreaterThan(0);
+            expect(result.systemRules.some(
+                (r: string) => r.includes('uptime') || r.includes('Uptime')
+            )).toBe(true);
+        });
+    });
+
+    describe('Echo Tool', () => {
+        it('should echo the message back', async () => {
+            const result = await tester.callAction('system', 'echo', {
+                message: 'hello vurb',
+            });
+
+            expect(result.isError).toBe(false);
+            expect(result.data).toHaveProperty('echo', 'hello vurb');
+            expect(result.data).toHaveProperty('receivedAt');
+        });
+    });
+});
+`;
+}
+//# sourceMappingURL=testing.js.map

package/dist/cli/templates/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/cli/templates/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kCAAkC;AAClC,MAAM,UAAU,YAAY;IACxB,OAAO;;;;;;;CAOV,CAAC;AACF,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,WAAW;IACvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBV,CAAC;AACF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,YAAY;IACxB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDV,CAAC;AACF,CAAC"}

package/dist/cli/templates/tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool Templates — Example tools for the scaffolded project
+ *
+ * All tools use the Fluent API — `f.query()`, `f.mutation()` — with
+ * semantic verbs, `.withString()` / `.withNumber()` typed parameters,
+ * `.returns()` Presenter binding, and `.handle()` terminal step.
+ * @module
+ */
+/** Generate `src/tools/system/health.ts` — Health check with Presenter */
+export declare function healthToolTs(): string;
+/** Generate `src/tools/system/echo.ts` — Simple echo tool */
+export declare function echoToolTs(): string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/cli/templates/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,MAAM,CA6BrC;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,IAAI,MAAM,CAqBnC"}

package/dist/cli/templates/tools.js

@@ -0,0 +1,63 @@
+/**
+ * Tool Templates — Example tools for the scaffolded project
+ *
+ * All tools use the Fluent API — `f.query()`, `f.mutation()` — with
+ * semantic verbs, `.withString()` / `.withNumber()` typed parameters,
+ * `.returns()` Presenter binding, and `.handle()` terminal step.
+ * @module
+ */
+/** Generate `src/tools/system/health.ts` — Health check with Presenter */
+export function healthToolTs() {
+    return `/**
+ * System Health Tool — Full MVA Pipeline (Fluent API)
+ *
+ * Demonstrates:
+ * - f.query() — read-only semantic verb (auto-sets readOnlyHint)
+ * - .describe() — LLM-facing description
+ * - .returns() — Presenter (Egress Firewall + system rules + UI)
+ * - .handle(input, ctx) — fully typed handler
+ * - export default for autoDiscover()
+ */
+import { f } from '../../vurb.js';
+import { SystemPresenter } from '../../presenters/SystemPresenter.js';
+
+export default f.query('system.health')
+    .describe('Real-time server health status')
+    .returns(SystemPresenter)
+    .handle(async (_input, ctx) => {
+        // Return raw data — the Presenter validates, strips
+        // undeclared fields, injects rules, and renders UI.
+        return {
+            status: 'healthy',
+            uptime: process.uptime(),
+            version: '0.1.0',
+            timestamp: new Date().toISOString(),
+            tenant: ctx.tenantId,
+        };
+    });
+`;
+}
+/** Generate `src/tools/system/echo.ts` — Simple echo tool */
+export function echoToolTs() {
+    return `/**
+ * Echo Tool — Connectivity Testing (Fluent API)
+ *
+ * Demonstrates:
+ * - f.query() with .withString() typed parameter
+ * - .handle(input, ctx) — input.message is typed as string
+ * - Implicit success() wrapping — return raw data, framework wraps it
+ */
+import { f } from '../../vurb.js';
+
+export default f.query('system.echo')
+    .describe('Echo a message back (connectivity test)')
+    .withString('message', 'Message to echo back')
+    .handle(async (input) => {
+        return {
+            echo: input['message'],
+            receivedAt: new Date().toISOString(),
+        };
+    });
+`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/cli/templates/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/cli/templates/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IACxB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BV,CAAC;AACF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,UAAU;IACtB,OAAO;;;;;;;;;;;;;;;;;;;CAmBV,CAAC;AACF,CAAC"}

package/dist/cli/templates/vectors/database.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Database Vector — Prisma schema + DB tool templates
+ * @module
+ */
+/** Generate `prisma/schema.prisma` */
+export declare function prismaSchema(): string;
+/** Generate `src/tools/db/users.ts` */
+export declare function dbUsersToolTs(): string;
+//# sourceMappingURL=database.d.ts.map

package/dist/cli/templates/vectors/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/vectors/database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,wBAAgB,YAAY,IAAI,MAAM,CAgDrC;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,MAAM,CAyBtC"}