@skillsmith/cli 0.7.1 → 0.7.3

package/dist/src/templates/mcp-server.template.js

@@ -1,430 +0,0 @@
-/**
- * SMI-1433: MCP Server Template
- *
- * Templates for scaffolding TypeScript MCP servers with stdio transport.
- * Generated servers are npx-ready and follow @modelcontextprotocol/sdk patterns.
- *
- * @example Basic Usage
- * ```typescript
- * import { renderMcpServerTemplates } from './mcp-server.template.js'
- *
- * const files = renderMcpServerTemplates({
- *   name: 'my-mcp-server',
- *   description: 'Does cool things',
- *   author: 'developer',
- *   tools: []
- * })
- *
- * // files is a Map<string, string> of file paths to content
- * // Keys: package.json, tsconfig.json, src/index.ts, src/server.ts,
- * //       src/tools/index.ts, src/tools/example.ts, README.md, .gitignore
- * ```
- *
- * @example With Custom Tools
- * ```typescript
- * const files = renderMcpServerTemplates({
- *   name: 'slack-mcp',
- *   description: 'Slack integration MCP server',
- *   author: 'team',
- *   tools: [
- *     {
- *       name: 'send_message',
- *       description: 'Send a Slack message',
- *       parameters: [
- *         { name: 'channel', type: 'string', description: 'Channel ID', required: true },
- *         { name: 'text', type: 'string', description: 'Message text', required: true }
- *       ]
- *     }
- *   ]
- * })
- * ```
- *
- * @module mcp-server-template
- */
-import { VERSIONS } from './mcp-template-types.js';
-// Import handlers
-import { generateToolDefinition, generateToolCase, generateToolImport, generateToolImplementation, generateToolDocs, } from './mcp-template-handlers.js';
-// ============================================================================
-// Template Constants
-// ============================================================================
-/**
- * package.json template for MCP server
- */
-export const PACKAGE_JSON_TEMPLATE = `{
-  "name": "{{name}}",
-  "version": "0.1.0",
-  "description": "{{description}}",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "{{name}}": "./dist/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx src/index.ts",
-    "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "claude",
-    "ai"
-  ],
-  "author": "{{author}}",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "${VERSIONS.MCP_SDK}"
-  },
-  "devDependencies": {
-    "@types/node": "${VERSIONS.TYPES_NODE}",
-    "tsx": "${VERSIONS.TSX}",
-    "typescript": "${VERSIONS.TYPESCRIPT}"
-  },
-  "engines": {
-    "node": "${VERSIONS.NODE_ENGINE}"
-  }
-}
-`;
-/**
- * tsconfig.json template for MCP server
- */
-export const TSCONFIG_JSON_TEMPLATE = `{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
-`;
-/**
- * Main entry point (src/index.ts) template
- */
-export const INDEX_TS_TEMPLATE = `#!/usr/bin/env node
-/**
- * {{name}} - MCP Server
- *
- * {{description}}
- */
-
-import { createServer, createTransport } from './server.js'
-
-async function main(): Promise<void> {
-  const server = createServer()
-  const transport = createTransport()
-  await server.connect(transport)
-}
-
-main().catch((error) => {
-  console.error('Server error:', error)
-  process.exit(1)
-})
-`;
-/**
- * Server setup (src/server.ts) template
- */
-export const SERVER_TS_TEMPLATE = `/**
- * MCP Server Configuration
- *
- * Sets up the MCP server with tool handlers.
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js'
-
-import { tools, handleToolCall } from './tools/index.js'
-
-/**
- * Create and configure the MCP server
- */
-export function createServer(): Server {
-  const server = new Server(
-    {
-      name: '{{name}}',
-      version: '0.1.0',
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    }
-  )
-
-  // Register tool listing handler
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools }
-  })
-
-  // Register tool execution handler
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params
-
-    try {
-      const result = await handleToolCall(name, args || {})
-      return {
-        content: [
-          {
-            type: 'text',
-            text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
-          },
-        ],
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : 'Unknown error'
-      return {
-        content: [{ type: 'text', text: \`Error: \${message}\` }],
-        isError: true,
-      }
-    }
-  })
-
-  return server
-}
-
-/**
- * Create a stdio transport for the server
- */
-export function createTransport(): StdioServerTransport {
-  return new StdioServerTransport()
-}
-`;
-/**
- * Tools index (src/tools/index.ts) template
- */
-export const TOOLS_INDEX_TS_TEMPLATE = `/**
- * Tool Definitions and Handlers
- *
- * Register your MCP tools here.
- */
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js'
-{{toolImports}}
-
-/**
- * Tool definitions exposed by this MCP server
- */
-export const tools: Tool[] = [
-{{toolDefinitions}}
-]
-
-/**
- * Route tool calls to appropriate handlers
- */
-export async function handleToolCall(
-  name: string,
-  args: Record<string, unknown>
-): Promise<unknown> {
-  switch (name) {
-{{toolCases}}
-    default:
-      throw new Error(\`Unknown tool: \${name}\`)
-  }
-}
-`;
-/**
- * Example tool implementation template
- */
-export const EXAMPLE_TOOL_TS_TEMPLATE = `/**
- * Example Tool Implementation
- *
- * This is a sample tool to demonstrate the pattern.
- * Replace with your actual tool logic.
- */
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js'
-
-export const exampleToolDefinition: Tool = {
-  name: 'example',
-  description: 'An example tool that echoes input',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      message: {
-        type: 'string',
-        description: 'Message to echo back',
-      },
-    },
-    required: ['message'],
-  },
-}
-
-export interface ExampleToolArgs {
-  message: string
-}
-
-export async function handleExampleTool(args: ExampleToolArgs): Promise<string> {
-  return \`Echo: \${args.message}\`
-}
-`;
-/**
- * README.md template for MCP server
- */
-export const MCP_README_TEMPLATE = `# {{name}}
-
-{{description}}
-
-## Installation
-
-\`\`\`bash
-npm install -g {{name}}
-\`\`\`
-
-Or use directly with npx:
-
-\`\`\`bash
-npx {{name}}
-\`\`\`
-
-## Configuration
-
-This server is MCP-compatible — pick the snippet that matches your agent.
-SMI-4580: snippets are sourced from \`@skillsmith/cli/templates/mcp-server.template.snippets\`
-so docs and scaffolded READMEs can't drift.
-
-{{clientSnippets}}
-
-## Available Tools
-
-{{toolDocs}}
-
-## Development
-
-\`\`\`bash
-# Install dependencies
-npm install
-
-# Run in development mode
-npm run dev
-
-# Build for production
-npm run build
-
-# Run production build
-npm start
-\`\`\`
-
-## License
-
-MIT
-`;
-/**
- * .gitignore template for MCP server
- */
-export const MCP_GITIGNORE_TEMPLATE = `# Dependencies
-node_modules/
-
-# Build output
-dist/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Logs
-*.log
-npm-debug.log*
-
-# Test coverage
-coverage/
-`;
-// SMI-4580: per-client config snippet matrix
-import { renderAllSnippetsAsMarkdown } from './mcp-server.template.snippets.js';
-// ============================================================================
-// Main Render Function
-// ============================================================================
-/**
- * Render MCP server templates
- */
-export function renderMcpServerTemplates(data) {
-    const files = new Map();
-    // Use example tool if no tools specified
-    const toolsToUse = data.tools.length > 0
-        ? data.tools
-        : [
-            {
-                name: 'example',
-                description: 'An example tool that echoes input',
-                parameters: [
-                    {
-                        name: 'message',
-                        type: 'string',
-                        description: 'Message to echo back',
-                        required: true,
-                    },
-                ],
-            },
-        ];
-    // Generate tool-specific code
-    const toolImports = toolsToUse.map(generateToolImport).join('\n');
-    const toolDefinitions = toolsToUse.map((t) => generateToolDefinition(t)).join('\n');
-    const toolCases = toolsToUse.map(generateToolCase).join('\n');
-    const toolDocs = generateToolDocs(data.tools);
-    // package.json
-    files.set('package.json', PACKAGE_JSON_TEMPLATE.replace(/\{\{name\}\}/g, data.name)
-        .replace(/\{\{description\}\}/g, data.description)
-        .replace(/\{\{author\}\}/g, data.author));
-    // tsconfig.json
-    files.set('tsconfig.json', TSCONFIG_JSON_TEMPLATE);
-    // src/index.ts
-    files.set('src/index.ts', INDEX_TS_TEMPLATE.replace(/\{\{name\}\}/g, data.name).replace(/\{\{description\}\}/g, data.description));
-    // src/server.ts
-    files.set('src/server.ts', SERVER_TS_TEMPLATE.replace(/\{\{name\}\}/g, data.name));
-    // src/tools/index.ts
-    files.set('src/tools/index.ts', TOOLS_INDEX_TS_TEMPLATE.replace(/\{\{toolImports\}\}/g, toolImports)
-        .replace(/\{\{toolDefinitions\}\}/g, toolDefinitions)
-        .replace(/\{\{toolCases\}\}/g, toolCases));
-    // Generate tool implementation files
-    if (data.tools.length > 0) {
-        // Generate stub implementations for custom tools
-        for (const tool of data.tools) {
-            files.set(`src/tools/${tool.name}.ts`, generateToolImplementation(tool));
-        }
-        // Include example.ts as reference
-        files.set('src/tools/example.ts', EXAMPLE_TOOL_TS_TEMPLATE);
-    }
-    else {
-        // No custom tools - just use example tool (already imported in index.ts)
-        files.set('src/tools/example.ts', EXAMPLE_TOOL_TS_TEMPLATE);
-    }
-    // README.md
-    // SMI-4580: interpolate per-client snippets so the scaffolded README
-    // covers every supported agent (Claude Code, Cursor, Copilot,
-    // Windsurf, Codex, cross-agent) — same source as the website docs.
-    const clientSnippets = renderAllSnippetsAsMarkdown(data.name);
-    files.set('README.md', MCP_README_TEMPLATE.replace(/\{\{name\}\}/g, data.name)
-        .replace(/\{\{description\}\}/g, data.description)
-        .replace(/\{\{toolDocs\}\}/g, toolDocs)
-        .replace(/\{\{clientSnippets\}\}/g, clientSnippets));
-    // .gitignore
-    files.set('.gitignore', MCP_GITIGNORE_TEMPLATE);
-    return files;
-}
-//# sourceMappingURL=mcp-server.template.js.map

package/dist/src/templates/mcp-server.template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.template.js","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.ts"],"names":[],"mappings":"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"}

package/dist/src/templates/mcp-server.template.snippets.d.ts

@@ -1,51 +0,0 @@
-/**
- * SMI-4580: Per-client MCP config snippets.
- *
- * Single source of truth for the install-time configuration block each
- * agent expects. Same source feeds:
- *   - the scaffolded mcp-server README (via mcp-server.template.ts)
- *   - the website docs (`getting-started.astro`, `quickstart.astro`)
- *   - the root README + packages/mcp-server/README.md
- *
- * Four of five clients accept the same `mcpServers` JSON shape.
- * Codex needs TOML (separate `[mcp_servers.<name>]` table).
- *
- * @module @skillsmith/cli/templates/mcp-server.template.snippets
- */
-import type { ClientId } from '@skillsmith/core/install';
-export type SnippetClientId = ClientId | 'codex';
-export interface ClientSnippet {
-    /** Display label for the per-client tab/section header */
-    label: string;
-    /** Path to the config file the user edits */
-    configPath: string;
-    /** File format hint for the syntax highlighter */
-    format: 'json' | 'toml';
-    /** Snippet body — interpolated with `{{name}}` for the package name */
-    body: string;
-    /** Notes shown beneath the snippet */
-    notes?: string;
-}
-/**
- * Per-client snippet matrix. `name` placeholder is interpolated when the
- * snippet is rendered; pass `'@skillsmith/mcp-server'` for the published
- * package, or any other server name when scaffolding via the template.
- */
-export declare const CLIENT_SNIPPETS: Record<SnippetClientId, ClientSnippet>;
-/**
- * Render a single client snippet with the package name interpolated.
- */
-export declare function renderSnippet(client: SnippetClientId, packageName: string): string;
-/**
- * Render every snippet as a markdown section sequence — labelled with
- * `<details>` + `<summary>` so the docs surface stays compact when no
- * dedicated tabs component is available. Used by both the website
- * markdown surfaces and the scaffolded mcp-server README.
- */
-export declare function renderAllSnippetsAsMarkdown(packageName: string): string;
-/**
- * Snippet IDs in display order. Use when a docs surface needs to
- * render snippets without a `<details>` accordion (e.g. printable PDF).
- */
-export declare const SNIPPET_DISPLAY_ORDER: ReadonlyArray<SnippetClientId>;
-//# sourceMappingURL=mcp-server.template.snippets.d.ts.map

package/dist/src/templates/mcp-server.template.snippets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.template.snippets.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAsGlE,CAAA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiBvE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,eAAe,CAO/D,CAAA"}

package/dist/src/templates/mcp-server.template.snippets.js

@@ -1,162 +0,0 @@
-/**
- * SMI-4580: Per-client MCP config snippets.
- *
- * Single source of truth for the install-time configuration block each
- * agent expects. Same source feeds:
- *   - the scaffolded mcp-server README (via mcp-server.template.ts)
- *   - the website docs (`getting-started.astro`, `quickstart.astro`)
- *   - the root README + packages/mcp-server/README.md
- *
- * Four of five clients accept the same `mcpServers` JSON shape.
- * Codex needs TOML (separate `[mcp_servers.<name>]` table).
- *
- * @module @skillsmith/cli/templates/mcp-server.template.snippets
- */
-/**
- * Per-client snippet matrix. `name` placeholder is interpolated when the
- * snippet is rendered; pass `'@skillsmith/mcp-server'` for the published
- * package, or any other server name when scaffolding via the template.
- */
-export const CLIENT_SNIPPETS = {
-    'claude-code': {
-        label: 'Claude Code',
-        configPath: '~/.claude/settings.json',
-        format: 'json',
-        body: `{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"],
-      "env": {
-        "SKILLSMITH_API_KEY": "sk_live_..."
-      }
-    }
-  }
-}`,
-        notes: 'Restart Claude Code after editing settings.json.',
-    },
-    cursor: {
-        label: 'Cursor',
-        configPath: '~/.cursor/mcp.json',
-        format: 'json',
-        body: `{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"],
-      "env": {
-        "SKILLSMITH_API_KEY": "sk_live_..."
-      }
-    }
-  }
-}`,
-        notes: 'Cursor 2.4+ required. Reload the window after saving.',
-    },
-    copilot: {
-        label: 'GitHub Copilot (VS Code)',
-        configPath: '.vscode/mcp.json (workspace)',
-        format: 'json',
-        body: `{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"],
-      "env": {
-        "SKILLSMITH_API_KEY": "sk_live_..."
-      }
-    }
-  }
-}`,
-        notes: 'VS Code 1.108+ required. Workspace-scoped config (commit to repo if team-shared, or use user settings.json instead).',
-    },
-    windsurf: {
-        label: 'Windsurf',
-        configPath: '~/.codeium/windsurf/mcp_config.json',
-        format: 'json',
-        body: `{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"],
-      "env": {
-        "SKILLSMITH_API_KEY": "\${env:SKILLSMITH_API_KEY}"
-      }
-    }
-  }
-}`,
-        notes: 'Supports `${env:VAR}` interpolation; export SKILLSMITH_API_KEY in your shell instead of inlining the secret.',
-    },
-    agents: {
-        label: 'Cross-agent (open standard)',
-        configPath: '~/.agents/mcp.json',
-        format: 'json',
-        body: `{
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": ["-y", "{{name}}"],
-      "env": {
-        "SKILLSMITH_API_KEY": "sk_live_..."
-      }
-    }
-  }
-}`,
-        notes: 'Read by any agent honouring the cross-agent skill convention. Codex CLI users prefer the Codex-native TOML snippet below.',
-    },
-    codex: {
-        label: 'Codex CLI',
-        configPath: '~/.codex/config.toml',
-        format: 'toml',
-        body: `[mcp_servers.{{name}}]
-command = "npx"
-args = ["-y", "{{name}}"]
-
-[mcp_servers.{{name}}.env]
-SKILLSMITH_API_KEY = "sk_live_..."`,
-        notes: 'Codex uses TOML, not JSON. Skill discovery still reads ~/.agents/skills (set --client agents when installing via Skillsmith CLI).',
-    },
-};
-/**
- * Render a single client snippet with the package name interpolated.
- */
-export function renderSnippet(client, packageName) {
-    const snippet = CLIENT_SNIPPETS[client];
-    return snippet.body.replace(/\{\{name\}\}/g, packageName);
-}
-/**
- * Render every snippet as a markdown section sequence — labelled with
- * `<details>` + `<summary>` so the docs surface stays compact when no
- * dedicated tabs component is available. Used by both the website
- * markdown surfaces and the scaffolded mcp-server README.
- */
-export function renderAllSnippetsAsMarkdown(packageName) {
-    const sections = Object.keys(CLIENT_SNIPPETS).map((id) => {
-        const snippet = CLIENT_SNIPPETS[id];
-        const body = renderSnippet(id, packageName);
-        const notes = snippet.notes ? `\n\n${snippet.notes}` : '';
-        return [
-            `<details>`,
-            `<summary><strong>${snippet.label}</strong> — \`${snippet.configPath}\`</summary>`,
-            ``,
-            `\`\`\`${snippet.format}`,
-            body,
-            `\`\`\`${notes}`,
-            ``,
-            `</details>`,
-        ].join('\n');
-    });
-    return sections.join('\n\n');
-}
-/**
- * Snippet IDs in display order. Use when a docs surface needs to
- * render snippets without a `<details>` accordion (e.g. printable PDF).
- */
-export const SNIPPET_DISPLAY_ORDER = Object.freeze([
-    'claude-code',
-    'cursor',
-    'copilot',
-    'windsurf',
-    'codex',
-    'agents',
-]);
-//# sourceMappingURL=mcp-server.template.snippets.js.map

package/dist/src/templates/mcp-server.template.snippets.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-server.template.snippets.js","sourceRoot":"","sources":["../../../src/templates/mcp-server.template.snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,aAAa,EAAE;QACb,KAAK,EAAE,aAAa;QACpB,UAAU,EAAE,yBAAyB;QACrC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EAAE,kDAAkD;KAC1D;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,oBAAoB;QAChC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EAAE,uDAAuD;KAC/D;IACD,OAAO,EAAE;QACP,KAAK,EAAE,0BAA0B;QACjC,UAAU,EAAE,8BAA8B;QAC1C,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,sHAAsH;KACzH;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,qCAAqC;QACjD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,8GAA8G;KACjH;IACD,MAAM,EAAE;QACN,KAAK,EAAE,6BAA6B;QACpC,UAAU,EAAE,oBAAoB;QAChC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;;;;;;EAUR;QACE,KAAK,EACH,2HAA2H;KAC9H;IACD,KAAK,EAAE;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,sBAAsB;QAClC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;;;;;mCAKyB;QAC/B,KAAK,EACH,mIAAmI;KACtI;CACF,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAuB,EAAE,WAAmB;IACxE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,MAAM,QAAQ,GAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAuB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9E,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,CAAC,CAAA;QACnC,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACzD,OAAO;YACL,WAAW;YACX,oBAAoB,OAAO,CAAC,KAAK,iBAAiB,OAAO,CAAC,UAAU,cAAc;YAClF,EAAE;YACF,SAAS,OAAO,CAAC,MAAM,EAAE;YACzB,IAAI;YACJ,SAAS,KAAK,EAAE;YAChB,EAAE;YACF,YAAY;SACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAmC,MAAM,CAAC,MAAM,CAAC;IACjF,aAAa;IACb,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,QAAQ;CACT,CAAC,CAAA"}

package/dist/src/templates/mcp-template-handlers.d.ts

@@ -1,33 +0,0 @@
-/**
- * SMI-1433: MCP Server Template Handlers
- *
- * Code generation helpers for MCP server scaffolding.
- *
- * @module mcp-template-handlers
- */
-import type { McpToolDefinition } from './mcp-template-types.js';
-/**
- * Escape single quotes in strings for safe template interpolation
- */
-export declare function escapeQuotes(str: string): string;
-/**
- * Generate tool definition code for a single tool
- */
-export declare function generateToolDefinition(tool: McpToolDefinition, indent?: string): string;
-/**
- * Generate tool handler case for switch statement
- */
-export declare function generateToolCase(tool: McpToolDefinition): string;
-/**
- * Generate tool import statement
- */
-export declare function generateToolImport(tool: McpToolDefinition): string;
-/**
- * Generate a stub implementation file for a custom tool
- */
-export declare function generateToolImplementation(tool: McpToolDefinition): string;
-/**
- * Generate tool documentation for README
- */
-export declare function generateToolDocs(tools: McpToolDefinition[]): string;
-//# sourceMappingURL=mcp-template-handlers.d.ts.map

package/dist/src/templates/mcp-template-handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-template-handlers.d.ts","sourceRoot":"","sources":["../../../src/templates/mcp-template-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CA4B7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAKhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAmC1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAWnE"}