@frontmcp/nx 0.0.1

package/generators/resource/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../../src/generators/resource/resource.ts"],"names":[],"mappings":";;AAKA,8CAgBC;AArBD,uCAA2F;AAC3F,+BAA4B;AAE5B,2EAA6E;AAEtE,KAAK,UAAU,iBAAiB,CACrC,IAAU,EACV,MAA+B;IAE/B,MAAM,OAAO,GAAG,IAAA,gDAAyB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;IAE5C,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/D,GAAG,OAAO;QACV,UAAU;QACV,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,iBAAiB,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { ResourceGeneratorSchema } from './schema.js';\nimport { normalizePrimitiveOptions } from '../../utils/normalize-options.js';\n\nexport async function resourceGenerator(\n  tree: Tree,\n  schema: ResourceGeneratorSchema,\n): Promise<GeneratorCallback | void> {\n  const options = normalizePrimitiveOptions(tree, schema, 'resources');\n  const isTemplate = schema.template ?? false;\n\n  generateFiles(tree, join(__dirname, 'files'), options.directory, {\n    ...options,\n    isTemplate,\n    tmpl: '',\n  });\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default resourceGenerator;\n"]}

package/generators/resource/schema.d.ts

@@ -0,0 +1,7 @@
+export interface ResourceGeneratorSchema {
+    name: string;
+    project: string;
+    template?: boolean;
+    directory?: string;
+    skipFormat?: boolean;
+}

package/generators/resource/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/generators/resource/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/resource/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface ResourceGeneratorSchema {\n  name: string;\n  project: string;\n  template?: boolean;\n  directory?: string;\n  skipFormat?: boolean;\n}\n"]}

package/generators/resource/schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FrontMcpResource",
+  "title": "FrontMCP Resource Generator",
+  "description": "Generate a @Resource or @ResourceTemplate class",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the resource",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like for the resource?",
+      "x-priority": "important"
+    },
+    "project": {
+      "type": "string",
+      "description": "The project to add the resource to",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "template": {
+      "type": "boolean",
+      "description": "Generate a @ResourceTemplate with URI template params",
+      "default": false
+    },
+    "directory": {
+      "type": "string",
+      "description": "Subdirectory within src/resources/"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["name", "project"]
+}

package/generators/server/files/cloudflare/wrangler.toml__tmpl__

@@ -0,0 +1,6 @@
+name = "<%= projectName %>"
+main = "dist/main.js"
+compatibility_date = "2024-01-01"
+
+[vars]
+NODE_ENV = "production"

package/generators/server/files/common/project.json__tmpl__

@@ -0,0 +1,25 @@
+{
+  "name": "<%= projectName %>",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "<%= projectRoot %>/src",
+  "projectType": "application",
+  "tags": [<%- parsedTags.map(t => `"${t}"`).join(', ') %>],
+  "targets": {
+    "build": {
+      "executor": "@frontmcp/nx:build",
+      "outputs": ["{projectRoot}/dist"],
+      "options": {
+        "entry": "{projectRoot}/src/main.ts",
+        "outputPath": "{projectRoot}/dist",
+        "adapter": "<%= deploymentTarget %>"
+      }
+    },
+    "deploy": {
+      "executor": "@frontmcp/nx:deploy",
+      "dependsOn": ["build"],
+      "options": {
+        "target": "<%= deploymentTarget %>"
+      }
+    }
+  }
+}

package/generators/server/files/common/src/main.ts__tmpl__

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { FrontMcp } from '@frontmcp/sdk';
+<% appNames.forEach(function(appName) { %>import { <%= names(appName).className %>App } from '../../apps/<%= names(appName).fileName %>/<%= names(appName).fileName %>.app';
+<% }); %>
+@FrontMcp({
+  info: { name: '<%= className %> Server', version: '0.1.0' },
+  apps: [<%- appNames.map(a => names(a).className + 'App').join(', ') %>],
+})
+export default class Server {}

package/generators/server/files/common/tsconfig.json__tmpl__

@@ -0,0 +1,14 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    { "path": "./tsconfig.lib.json" }
+  ]
+}

package/generators/server/files/common/tsconfig.lib.json__tmpl__

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"]
+}

package/generators/server/files/lambda/template.yaml__tmpl__

@@ -0,0 +1,27 @@
+AWSTemplateFormatVersion: '2010-09-09'
+Transform: AWS::Serverless-2016-10-31
+Description: '<%= className %> FrontMCP Server'
+
+Globals:
+  Function:
+    Timeout: 30
+    Runtime: nodejs22.x
+    MemorySize: 256
+
+Resources:
+  McpFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      CodeUri: dist/
+      Handler: main.handler
+      Events:
+        Api:
+          Type: HttpApi
+          Properties:
+            Path: /{proxy+}
+            Method: ANY
+
+Outputs:
+  ApiUrl:
+    Description: 'API Gateway URL'
+    Value: !Sub 'https://${ServerlessHttpApi}.execute-api.${AWS::Region}.amazonaws.com'

package/generators/server/files/node/Dockerfile__tmpl__

@@ -0,0 +1,17 @@
+FROM node:24-slim AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --ignore-scripts
+COPY . .
+RUN npx nx build <%= projectName %>
+
+FROM node:24-slim AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+RUN addgroup --system appgroup && adduser --system --ingroup appgroup appuser
+COPY --from=builder /app/<%= projectRoot %>/dist ./dist
+COPY --from=builder /app/package.json /app/package-lock.json* ./
+RUN npm ci --omit=dev --ignore-scripts
+USER appuser
+EXPOSE 3000
+CMD ["node", "dist/main.js"]

package/generators/server/files/node/__dot__dockerignore__tmpl__

@@ -0,0 +1,8 @@
+node_modules
+dist
+.nx
+tmp
+coverage
+.git
+.env
+.env.*

package/generators/server/files/node/docker-compose.yml__tmpl__

@@ -0,0 +1,28 @@
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: ../..
+      dockerfile: <%= projectRoot %>/Dockerfile
+    ports:
+      - '3000:3000'
+    environment:
+      - NODE_ENV=production
+<% if (redis === 'docker') { %>
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+    depends_on:
+      redis:
+        condition: service_healthy
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - '6379:6379'
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 3
+<% } %>

package/generators/server/files/vercel/vercel.json__tmpl__

@@ -0,0 +1,15 @@
+{
+  "version": 2,
+  "builds": [
+    {
+      "src": "<%= projectRoot %>/dist/main.js",
+      "use": "@vercel/node"
+    }
+  ],
+  "routes": [
+    {
+      "src": "/(.*)",
+      "dest": "<%= projectRoot %>/dist/main.js"
+    }
+  ]
+}

package/generators/server/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { normalizeOptions } from './normalize-options.js';
+export type { NormalizedServerOptions } from './normalize-options.js';

package/generators/server/lib/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = void 0;
+var normalize_options_js_1 = require("./normalize-options.js");
+Object.defineProperty(exports, "normalizeOptions", { enumerable: true, get: function () { return normalize_options_js_1.normalizeOptions; } });
+//# sourceMappingURL=index.js.map

package/generators/server/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/generators/server/lib/index.ts"],"names":[],"mappings":";;;AAAA,+DAA0D;AAAjD,wHAAA,gBAAgB,OAAA","sourcesContent":["export { normalizeOptions } from './normalize-options.js';\nexport type { NormalizedServerOptions } from './normalize-options.js';\n"]}

package/generators/server/lib/normalize-options.d.ts

@@ -0,0 +1,14 @@
+import type { ServerGeneratorSchema } from '../schema.js';
+export interface NormalizedServerOptions {
+    name: string;
+    projectName: string;
+    projectRoot: string;
+    className: string;
+    fileName: string;
+    deploymentTarget: 'node' | 'vercel' | 'lambda' | 'cloudflare';
+    appNames: string[];
+    redis: 'docker' | 'existing' | 'none';
+    parsedTags: string[];
+    skipFormat: boolean;
+}
+export declare function normalizeOptions(schema: ServerGeneratorSchema): NormalizedServerOptions;

package/generators/server/lib/normalize-options.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = normalizeOptions;
+const devkit_1 = require("@nx/devkit");
+function normalizeOptions(schema) {
+    const { className, fileName } = (0, devkit_1.names)(schema.name);
+    const projectRoot = schema.directory ?? (0, devkit_1.joinPathFragments)('servers', fileName);
+    const parsedTags = schema.tags
+        ? schema.tags.split(',').map((t) => t.trim())
+        : ['scope:servers'];
+    const appNames = schema.apps.split(',').map((a) => a.trim()).filter(Boolean);
+    return {
+        name: schema.name,
+        projectName: `server-${fileName}`,
+        projectRoot,
+        className,
+        fileName,
+        deploymentTarget: schema.deploymentTarget ?? 'node',
+        appNames,
+        redis: schema.redis ?? 'none',
+        parsedTags,
+        skipFormat: schema.skipFormat ?? false,
+    };
+}
+//# sourceMappingURL=normalize-options.js.map

package/generators/server/lib/normalize-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../../../../src/generators/server/lib/normalize-options.ts"],"names":[],"mappings":";;AAgBA,4CAqBC;AArCD,uCAAsD;AAgBtD,SAAgB,gBAAgB,CAAC,MAA6B;IAC5D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,0BAAiB,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI;QAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7E,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,UAAU,QAAQ,EAAE;QACjC,WAAW;QACX,SAAS;QACT,QAAQ;QACR,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,MAAM;QACnD,QAAQ;QACR,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM;QAC7B,UAAU;QACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import { names, joinPathFragments } from '@nx/devkit';\nimport type { ServerGeneratorSchema } from '../schema.js';\n\nexport interface NormalizedServerOptions {\n  name: string;\n  projectName: string;\n  projectRoot: string;\n  className: string;\n  fileName: string;\n  deploymentTarget: 'node' | 'vercel' | 'lambda' | 'cloudflare';\n  appNames: string[];\n  redis: 'docker' | 'existing' | 'none';\n  parsedTags: string[];\n  skipFormat: boolean;\n}\n\nexport function normalizeOptions(schema: ServerGeneratorSchema): NormalizedServerOptions {\n  const { className, fileName } = names(schema.name);\n  const projectRoot = schema.directory ?? joinPathFragments('servers', fileName);\n  const parsedTags = schema.tags\n    ? schema.tags.split(',').map((t) => t.trim())\n    : ['scope:servers'];\n\n  const appNames = schema.apps.split(',').map((a) => a.trim()).filter(Boolean);\n\n  return {\n    name: schema.name,\n    projectName: `server-${fileName}`,\n    projectRoot,\n    className,\n    fileName,\n    deploymentTarget: schema.deploymentTarget ?? 'node',\n    appNames,\n    redis: schema.redis ?? 'none',\n    parsedTags,\n    skipFormat: schema.skipFormat ?? false,\n  };\n}\n"]}

package/generators/server/schema.d.ts

@@ -0,0 +1,9 @@
+export interface ServerGeneratorSchema {
+    name: string;
+    directory?: string;
+    deploymentTarget?: 'node' | 'vercel' | 'lambda' | 'cloudflare';
+    apps: string;
+    redis?: 'docker' | 'existing' | 'none';
+    tags?: string;
+    skipFormat?: boolean;
+}

package/generators/server/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/generators/server/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/server/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface ServerGeneratorSchema {\n  name: string;\n  directory?: string;\n  deploymentTarget?: 'node' | 'vercel' | 'lambda' | 'cloudflare';\n  apps: string;\n  redis?: 'docker' | 'existing' | 'none';\n  tags?: string;\n  skipFormat?: boolean;\n}\n"]}

package/generators/server/schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FrontMcpServer",
+  "title": "FrontMCP Server Generator",
+  "description": "Generate a deployment shell",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the server deployment shell",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like for the server?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "The directory of the server (default: servers/<name>)",
+      "x-priority": "important"
+    },
+    "deploymentTarget": {
+      "type": "string",
+      "description": "The deployment target platform",
+      "enum": ["node", "vercel", "lambda", "cloudflare"],
+      "default": "node",
+      "x-prompt": {
+        "message": "Which deployment target?",
+        "type": "list",
+        "items": [
+          { "value": "node", "label": "Node.js (Docker)" },
+          { "value": "vercel", "label": "Vercel" },
+          { "value": "lambda", "label": "AWS Lambda (SAM)" },
+          { "value": "cloudflare", "label": "Cloudflare Workers" }
+        ]
+      },
+      "x-priority": "important"
+    },
+    "apps": {
+      "type": "string",
+      "description": "Comma-separated app names to compose in this server",
+      "x-prompt": "Which apps should this server compose? (comma-separated)",
+      "x-priority": "important"
+    },
+    "redis": {
+      "type": "string",
+      "description": "Redis setup option (node target only)",
+      "enum": ["docker", "existing", "none"],
+      "default": "none"
+    },
+    "tags": {
+      "type": "string",
+      "description": "Comma-separated tags",
+      "x-priority": "internal"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "description": "Skip formatting files",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["name", "apps"]
+}

package/generators/server/server.d.ts

@@ -0,0 +1,4 @@
+import { type Tree, type GeneratorCallback } from '@nx/devkit';
+import type { ServerGeneratorSchema } from './schema.js';
+export declare function serverGenerator(tree: Tree, schema: ServerGeneratorSchema): Promise<GeneratorCallback | void>;
+export default serverGenerator;

package/generators/server/server.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serverGenerator = serverGenerator;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+const index_js_1 = require("./lib/index.js");
+async function serverGenerator(tree, schema) {
+    return serverGeneratorInternal(tree, schema);
+}
+async function serverGeneratorInternal(tree, schema) {
+    const options = (0, index_js_1.normalizeOptions)(schema);
+    const templateVars = {
+        ...options,
+        names: devkit_1.names,
+        tmpl: '',
+        dot: '.',
+    };
+    // Generate common files (main.ts, project.json, tsconfig)
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files', 'common'), options.projectRoot, templateVars);
+    // Generate target-specific files
+    const targetDir = (0, path_1.join)(__dirname, 'files', options.deploymentTarget);
+    (0, devkit_1.generateFiles)(tree, targetDir, options.projectRoot, templateVars);
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}
+exports.default = serverGenerator;
+//# sourceMappingURL=server.js.map

package/generators/server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/generators/server/server.ts"],"names":[],"mappings":";;AAKA,0CAEC;AAPD,uCAA6G;AAC7G,+BAA4B;AAE5B,6CAAkD;AAE3C,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,MAA6B;IAC7E,OAAO,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,IAAU,EAAE,MAA6B;IAC9E,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,YAAY,GAAG;QACnB,GAAG,OAAO;QACV,KAAK,EAAE,cAAO;QACd,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,GAAG;KACT,CAAC;IAEF,0DAA0D;IAC1D,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE3F,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrE,IAAA,sBAAa,EAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAElE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,eAAe,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, names as nxNames, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { ServerGeneratorSchema } from './schema.js';\nimport { normalizeOptions } from './lib/index.js';\n\nexport async function serverGenerator(tree: Tree, schema: ServerGeneratorSchema): Promise<GeneratorCallback | void> {\n  return serverGeneratorInternal(tree, schema);\n}\n\nasync function serverGeneratorInternal(tree: Tree, schema: ServerGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizeOptions(schema);\n\n  const templateVars = {\n    ...options,\n    names: nxNames,\n    tmpl: '',\n    dot: '.',\n  };\n\n  // Generate common files (main.ts, project.json, tsconfig)\n  generateFiles(tree, join(__dirname, 'files', 'common'), options.projectRoot, templateVars);\n\n  // Generate target-specific files\n  const targetDir = join(__dirname, 'files', options.deploymentTarget);\n  generateFiles(tree, targetDir, options.projectRoot, templateVars);\n\n  if (!options.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default serverGenerator;\n"]}

package/generators/skill/files/__fileName__.skill.ts__tmpl__

@@ -0,0 +1,16 @@
+import { Skill, SkillContext } from '@frontmcp/sdk';
+
+@Skill({
+  name: '<%= name %>',
+  description: 'TODO: describe what this skill does',<% if (toolRefs.length > 0) { %>
+  tools: [<%- toolRefs.map(t => `'${t}'`).join(', ') %>],<% } %>
+})
+export default class <%= className %>Skill extends SkillContext {
+  async loadInstructions(): Promise<string> {
+    return 'TODO: define skill instructions';
+  }
+
+  async build(): Promise<void> {
+    // TODO: implement skill build logic
+  }
+}

package/generators/skill/schema.d.ts

@@ -0,0 +1,7 @@
+export interface SkillGeneratorSchema {
+    name: string;
+    project: string;
+    tools?: string;
+    directory?: string;
+    skipFormat?: boolean;
+}

package/generators/skill/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/generators/skill/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/skill/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface SkillGeneratorSchema {\n  name: string;\n  project: string;\n  tools?: string;\n  directory?: string;\n  skipFormat?: boolean;\n}\n"]}

package/generators/skill/schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FrontMcpSkill",
+  "title": "FrontMCP Skill Generator",
+  "description": "Generate a @Skill class",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the skill",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like for the skill?",
+      "x-priority": "important"
+    },
+    "project": {
+      "type": "string",
+      "description": "The project to add the skill to",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "tools": {
+      "type": "string",
+      "description": "Comma-separated tool names to reference"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Subdirectory within src/skills/"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["name", "project"]
+}

package/generators/skill/skill.d.ts

@@ -0,0 +1,4 @@
+import { type Tree, type GeneratorCallback } from '@nx/devkit';
+import type { SkillGeneratorSchema } from './schema.js';
+export declare function skillGenerator(tree: Tree, schema: SkillGeneratorSchema): Promise<GeneratorCallback | void>;
+export default skillGenerator;

package/generators/skill/skill.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillGenerator = skillGenerator;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+const normalize_options_js_1 = require("../../utils/normalize-options.js");
+async function skillGenerator(tree, schema) {
+    const options = (0, normalize_options_js_1.normalizePrimitiveOptions)(tree, schema, 'skills');
+    const toolRefs = schema.tools
+        ? schema.tools
+            .split(',')
+            .map((t) => t.trim())
+            .filter(Boolean)
+        : [];
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), options.directory, {
+        ...options,
+        toolRefs,
+        tmpl: '',
+    });
+    if (!schema.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}
+exports.default = skillGenerator;
+//# sourceMappingURL=skill.js.map

package/generators/skill/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/generators/skill/skill.ts"],"names":[],"mappings":";;AAKA,wCAkBC;AAvBD,uCAA2F;AAC3F,+BAA4B;AAE5B,2EAA6E;AAEtE,KAAK,UAAU,cAAc,CAAC,IAAU,EAAE,MAA4B;IAC3E,MAAM,OAAO,GAAG,IAAA,gDAAyB,EAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK;QAC3B,CAAC,CAAC,MAAM,CAAC,KAAK;aACT,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;IAEP,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/D,GAAG,OAAO;QACV,QAAQ;QACR,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,cAAc,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { SkillGeneratorSchema } from './schema.js';\nimport { normalizePrimitiveOptions } from '../../utils/normalize-options.js';\n\nexport async function skillGenerator(tree: Tree, schema: SkillGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizePrimitiveOptions(tree, schema, 'skills');\n  const toolRefs = schema.tools\n    ? schema.tools\n        .split(',')\n        .map((t) => t.trim())\n        .filter(Boolean)\n    : [];\n\n  generateFiles(tree, join(__dirname, 'files'), options.directory, {\n    ...options,\n    toolRefs,\n    tmpl: '',\n  });\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default skillGenerator;\n"]}

package/generators/tool/files/__fileName__.tool.ts__tmpl__

@@ -0,0 +1,19 @@
+import { Tool, ToolContext } from '@frontmcp/sdk';
+import { z } from 'zod';
+
+@Tool({
+  name: '<%= name %>',
+  description: 'TODO: describe what this tool does',
+  inputSchema: {
+    value: z.string().describe('TODO: replace with actual input'),
+  },
+  outputSchema: {
+    result: z.string().describe('TODO: replace with actual output'),
+  },
+})
+export default class <%= className %>Tool extends ToolContext {
+  async execute(input: unknown) {
+    // TODO: implement
+    return {};
+  }
+}

package/generators/tool/schema.d.ts

@@ -0,0 +1,6 @@
+export interface ToolGeneratorSchema {
+    name: string;
+    project: string;
+    directory?: string;
+    skipFormat?: boolean;
+}

package/generators/tool/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/generators/tool/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/generators/tool/schema.ts"],"names":[],"mappings":"","sourcesContent":["export interface ToolGeneratorSchema {\n  name: string;\n  project: string;\n  directory?: string;\n  skipFormat?: boolean;\n}\n"]}

package/generators/tool/schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FrontMcpTool",
+  "title": "FrontMCP Tool Generator",
+  "description": "Generate a @Tool class",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the tool",
+      "$default": { "$source": "argv", "index": 0 },
+      "x-prompt": "What name would you like for the tool?",
+      "x-priority": "important"
+    },
+    "project": {
+      "type": "string",
+      "description": "The project to add the tool to",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Subdirectory within src/tools/"
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["name", "project"]
+}

package/generators/tool/tool.d.ts

@@ -0,0 +1,4 @@
+import { type Tree, type GeneratorCallback } from '@nx/devkit';
+import type { ToolGeneratorSchema } from './schema.js';
+export declare function toolGenerator(tree: Tree, schema: ToolGeneratorSchema): Promise<GeneratorCallback | void>;
+export default toolGenerator;

package/generators/tool/tool.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolGenerator = toolGenerator;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+const normalize_options_js_1 = require("../../utils/normalize-options.js");
+async function toolGenerator(tree, schema) {
+    const options = (0, normalize_options_js_1.normalizePrimitiveOptions)(tree, schema, 'tools');
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), options.directory, {
+        ...options,
+        tmpl: '',
+    });
+    if (!schema.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}
+exports.default = toolGenerator;
+//# sourceMappingURL=tool.js.map

package/generators/tool/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../src/generators/tool/tool.ts"],"names":[],"mappings":";;AAKA,sCAWC;AAhBD,uCAA2F;AAC3F,+BAA4B;AAE5B,2EAA6E;AAEtE,KAAK,UAAU,aAAa,CAAC,IAAU,EAAE,MAA2B;IACzE,MAAM,OAAO,GAAG,IAAA,gDAAyB,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjE,IAAA,sBAAa,EAAC,IAAI,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE;QAC/D,GAAG,OAAO;QACV,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,kBAAe,aAAa,CAAC","sourcesContent":["import { type Tree, formatFiles, generateFiles, type GeneratorCallback } from '@nx/devkit';\nimport { join } from 'path';\nimport type { ToolGeneratorSchema } from './schema.js';\nimport { normalizePrimitiveOptions } from '../../utils/normalize-options.js';\n\nexport async function toolGenerator(tree: Tree, schema: ToolGeneratorSchema): Promise<GeneratorCallback | void> {\n  const options = normalizePrimitiveOptions(tree, schema, 'tools');\n\n  generateFiles(tree, join(__dirname, 'files'), options.directory, {\n    ...options,\n    tmpl: '',\n  });\n\n  if (!schema.skipFormat) {\n    await formatFiles(tree);\n  }\n}\n\nexport default toolGenerator;\n"]}