@skillsmith/cli 0.2.2 → 0.2.4

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

@@ -0,0 +1,529 @@
+/**
+ * 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
+ */
+/**
+ * Dependency version constants for easier maintenance
+ */
+const VERSIONS = {
+    MCP_SDK: '^1.0.0',
+    TYPES_NODE: '^20.0.0',
+    TSX: '^4.0.0',
+    TYPESCRIPT: '^5.0.0',
+    NODE_ENGINE: '>=18.0.0',
+};
+/**
+ * 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
+
+Add to your Claude configuration (\`~/.claude/settings.json\`):
+
+\`\`\`json
+{
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": ["-y", "{{name}}"]
+    }
+  }
+}
+\`\`\`
+
+## 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/
+`;
+/**
+ * Escape single quotes in strings for safe template interpolation
+ */
+function escapeQuotes(str) {
+    return str.replace(/'/g, "\\'");
+}
+/**
+ * Generate tool definition code for a single tool
+ */
+function generateToolDefinition(tool, indent = '  ') {
+    const properties = [];
+    const required = [];
+    for (const param of tool.parameters || []) {
+        properties.push(`${indent}      ${param.name}: {
+${indent}        type: '${param.type}',
+${indent}        description: '${escapeQuotes(param.description)}',
+${indent}      },`);
+        if (param.required) {
+            required.push(`'${param.name}'`);
+        }
+    }
+    const propertiesStr = properties.length > 0 ? properties.join('\n') : '';
+    const requiredStr = required.length > 0 ? `\n${indent}    required: [${required.join(', ')}],` : '';
+    return `${indent}{
+${indent}  name: '${escapeQuotes(tool.name)}',
+${indent}  description: '${escapeQuotes(tool.description)}',
+${indent}  inputSchema: {
+${indent}    type: 'object',
+${indent}    properties: {
+${propertiesStr}
+${indent}    },${requiredStr}
+${indent}  },
+${indent}},`;
+}
+/**
+ * Generate tool handler case for switch statement
+ */
+function generateToolCase(tool) {
+    const handlerName = `handle${tool.name.charAt(0).toUpperCase()}${tool.name.slice(1).replace(/-/g, '')}Tool`;
+    const argsType = `${tool.name.charAt(0).toUpperCase()}${tool.name.slice(1).replace(/-/g, '')}ToolArgs`;
+    return `    case '${tool.name}':
+      return ${handlerName}(args as unknown as ${argsType})`;
+}
+/**
+ * Generate tool import statement
+ */
+function generateToolImport(tool) {
+    const baseName = tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/-/g, '');
+    return `import { handle${baseName}Tool, type ${baseName}ToolArgs } from './${tool.name}.js'`;
+}
+/**
+ * Generate a stub implementation file for a custom tool
+ */
+function generateToolImplementation(tool) {
+    const baseName = tool.name.charAt(0).toUpperCase() + tool.name.slice(1).replace(/-/g, '');
+    const params = tool.parameters || [];
+    // Generate TypeScript interface properties
+    const interfaceProps = params
+        .map((p) => {
+        const tsType = p.type === 'array' ? 'unknown[]' : p.type === 'object' ? 'Record<string, unknown>' : p.type;
+        return `  ${p.name}${p.required ? '' : '?'}: ${tsType}`;
+    })
+        .join('\n');
+    // Generate implementation placeholder
+    const returnPlaceholder = params.length > 0
+        ? `\`${tool.name} called with: \${JSON.stringify({ ${params.map((p) => `${p.name}: args.${p.name}`).join(', ')} })}\``
+        : `'${tool.name} called'`;
+    return `/**
+ * ${baseName} Tool Implementation
+ *
+ * ${escapeQuotes(tool.description)}
+ * TODO: Implement your tool logic here.
+ */
+
+export interface ${baseName}ToolArgs {
+${interfaceProps || '  // No parameters'}
+}
+
+export async function handle${baseName}Tool(args: ${baseName}ToolArgs): Promise<string> {
+  // TODO: Implement ${tool.name} logic
+  return ${returnPlaceholder}
+}
+`;
+}
+/**
+ * Generate tool documentation for README
+ */
+function generateToolDocs(tools) {
+    if (tools.length === 0) {
+        return '- `example` - An example tool that echoes input';
+    }
+    return tools
+        .map((tool) => {
+        const params = tool.parameters?.map((p) => `\`${p.name}\``).join(', ') || 'none';
+        return `- \`${tool.name}\` - ${tool.description}\n  - Parameters: ${params}`;
+    })
+        .join('\n');
+}
+/**
+ * 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
+    files.set('README.md', MCP_README_TEMPLATE.replace(/\{\{name\}\}/g, data.name)
+        .replace(/\{\{description\}\}/g, data.description)
+        .replace(/\{\{toolDocs\}\}/g, toolDocs));
+    // .gitignore
+    files.set('.gitignore', MCP_GITIGNORE_TEMPLATE);
+    return files;
+}
+//# sourceMappingURL=mcp-server.template.js.map

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

@@ -0,0 +1 @@
+{"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/subagent.md.template.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SMI-1389: Subagent Definition Template
+ *
+ * Templates for generating companion specialist agents that enable
+ * parallel skill execution with 37-97% token savings.
+ */
+export interface SubagentTemplateData {
+    skillName: string;
+    description: string;
+    triggerPhrases: string[];
+    tools: string[];
+    model: 'sonnet' | 'opus' | 'haiku';
+}
+/**
+ * Main subagent definition template
+ * Generates ~/.claude/agents/[skill-name]-specialist.md
+ */
+export declare const SUBAGENT_MD_TEMPLATE = "---\nname: {{skillName}}-specialist\ndescription: {{description}} Use when {{triggerPhrases}}.\nskills: {{skillName}}\ntools: {{tools}}\nmodel: {{model}}\n---\n\n## Operating Protocol\n\n1. Execute the {{skillName}} skill for the delegated task\n2. Process all intermediate results internally\n3. Return ONLY a structured summary to the orchestrator\n\n## Output Format\n\n- **Task:** [what was requested]\n- **Actions:** [what you did]\n- **Results:** [key outcomes, max 3-5 bullet points]\n- **Artifacts:** [file paths or outputs created]\n\nKeep response under 500 tokens unless explicitly requested otherwise.\n\n## Tool Usage Guidelines\n\n{{toolGuidelines}}\n\n## Error Handling\n\nIf the task cannot be completed:\n- Report specific blocking issue\n- Suggest alternative approaches\n- Do not retry indefinitely\n";
+/**
+ * CLAUDE.md integration snippet template
+ * Users can copy this to their project's CLAUDE.md
+ */
+export declare const CLAUDE_MD_SNIPPET_TEMPLATE = "\n### Subagent Delegation: {{skillName}}\n\nWhen tasks match {{skillName}} triggers, delegate to the {{skillName}}-specialist\nsubagent instead of executing directly. This provides context isolation and\n~37-97% token savings.\n\n**Trigger Patterns:**\n{{triggerPatterns}}\n\n**Delegation Example:**\n```\nTask(\"{{skillName}}-specialist\", \"{{exampleTask}}\", \"{{skillName}}-specialist\")\n```\n";
+/**
+ * Render the subagent definition template
+ *
+ * @param data - Template data including skill name, description, tools, etc.
+ * @returns Rendered subagent markdown content
+ */
+export declare function renderSubagentTemplate(data: SubagentTemplateData): string;
+/**
+ * Render the CLAUDE.md integration snippet
+ *
+ * @param data - Template data
+ * @returns Rendered CLAUDE.md snippet
+ */
+export declare function renderClaudeMdSnippet(data: SubagentTemplateData): string;
+//# sourceMappingURL=subagent.md.template.d.ts.map

package/dist/src/templates/subagent.md.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.md.template.d.ts","sourceRoot":"","sources":["../../../src/templates/subagent.md.template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,wzBAiChC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,mZActC,CAAA;AAoCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAazE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAYxE"}