@identikey/coding-mcp 2.0.5 → 2.1.0

package/README.md

@@ -1,157 +1,162 @@
+# @identikey/coding-mcp
 
+MCP server with expert AI personas for architecture reviews, code advice, and research. Runs as a tool server in Cursor, Windsurf, or any MCP-compatible client.
 
-## How Users Run It
-folks can use it in their MCP config like:
+## Quick Start
 
-**Cursor Settings → MCP → Add Server:**
-- **Command**: `npx`
-- **Args**: `-y`, `@identikey/coding-mcp`
+Add to your MCP config (e.g., `.cursor/mcp.json`):
 
-Or in `.cursor/mcp.json`:
 ```json
 {
   "mcpServers": {
     "coding-mcp": {
       "command": "npx",
-      "args": ["-y", "@identikey/coding-mcp"]
+      "args": ["-y", "@identikey/coding-mcp"],
+      "env": {
+        "XAI_API_KEY": "your-xai-key",
+        "OPENAI_API_KEY": "your-openai-key"
+      }
     }
   }
 }
 ```
 
-The server spawns as a child process, Cursor talks JSON-RPC over stdin/stdout, and all your tool logs go to stderr where they belong. Clean af.
+Or via Cursor Settings → MCP → Add Server.
 
-# 🤖 Cursor Tools MCP Server
+### Environment Variables
 
-An MCP (Model Context Protocol) server providing powerful tools with expert personas for intelligent assistance:
+| Variable         | Required | Description                                          |
+| ---------------- | -------- | ---------------------------------------------------- |
+| `XAI_API_KEY`    | Yes\*    | xAI/Grok API key ([get one](https://console.x.ai))   |
+| `OPENAI_API_KEY` | Yes\*    | OpenAI API key (for GPT-5 reasoning)                 |
+| `AI_PROVIDER`    | No       | Default provider: `xai` or `openai` (default: `xai`) |
+| `XAI_MODEL`      | No       | xAI model override (default: `grok-4.1`)             |
+| `OPENAI_MODEL`   | No       | OpenAI model override (default: `gpt-5.2`)           |
 
-## Core Tools
-- **Ask**: Natural language queries automatically routed to the best expert
-- **Discover**: Explore available expert personas and their specialties
-- **Persona**: Direct access to specific expert personas
-- **Screenshot**: Capture screenshots from URLs
-- **Architect**: Comprehensive architectural code reviews
-- **Code Review**: Git diff analysis and improvement suggestions
+\*At least one API key required. The server auto-selects providers based on task type—xAI for quick advice, OpenAI for deep reasoning.
 
-## ✨ Features
+### Using bunx
 
-### 🎨 Code Architect
-
-Call advanced reasoning LLMs to generate plans and instructions for coding agents.
-
-### 📸 Screenshot Buddy
-
-Take UI design screenshots and use them with the composer agent.
-
-### 🔍 Code Review
+```json
+{
+  "mcpServers": {
+    "coding-mcp": {
+      "command": "bunx",
+      "args": ["@identikey/coding-mcp"],
+      "env": {
+        "XAI_API_KEY": "your-xai-key"
+      }
+    }
+  }
+}
+```
 
-Use git diffs to trigger code reviews.
+## Tools
 
-### 🎭 Persona System
+### `ask`
 
-Transform AI responses with distinct personalities:
-- **Charles**: Distinguished British architect with dry wit
-- **Ada**: Pragmatic performance engineer, metrics-focused
+Natural language queries auto-routed to the best expert persona. Just ask—it figures out who should answer.
 
-### 📊 Code Advice
+```
+"How should I structure this React app?"  → routes to Iris (frontend)
+"Is this auth implementation secure?"     → routes to Sentinel (security)
+"Review this API design"                  → routes to Atlas (backend)
+```
 
-Get focused guidance on specific coding problems.
+### `architect`
 
-### 🔬 Researcher
+Deep architectural review with reasoning. Pass code + task description, get structured analysis.
 
-Deep-dive analysis for complex technical questions.
+### `code-review`
 
-## 🚀 Getting Started
+Git diff analysis. Point it at a repo, get review of changes vs main branch.
 
-### 1. Environment Setup
+### `code-advice`
 
-First, you'll need to set up your environment variables. Create a file at `src/env/keys.ts`:
+Quick, focused guidance on specific problems. Lower latency than full architect review.
 
-```typescript
-export const OPENAI_API_KEY = "your_key_here";
-// Add any other keys you need
-```
+### `researcher`
 
-> ⚠️ **Security Note**: Storing API keys directly in source code is not recommended for production environments. This is only for local development and learning purposes. You can set the env var inline in the Cursor MCP interface as well.
+Multi-source research with citations. Searches across Google, arXiv, GitHub, StackExchange, etc.
 
-### 2. Installation
+### `persona`
 
-```bash
-npm install
-# or
-yarn install
-```
+Direct access to a specific expert. Skip auto-routing when you know who you want.
 
-### 3. Build the Server
+### `discover`
 
-```bash
-npm run build
-```
+List available personas and their specialties.
 
-### 4. Adding to Cursor
+### `screenshot`
 
-This project is designed to be used as an MCP server in Cursor. Here's how to set it up:
+Capture screenshots from URLs for UI review.
 
-1. Open Cursor
-2. Go to `Cursor Settings > Features > MCP`
-3. Click `+ Add New MCP Server`
-4. Fill out the form:
-   - **Name**: AI Development Assistant
-   - **Type**: stdio
-   - **Command**: `node /path/to/your/project/dist/index.js`
+## Personas
 
-> 📘 **Pro Tip**: You might need to use the full path to your project's built index.js file.
+| Persona      | Focus                    | Style                                              |
+| ------------ | ------------------------ | -------------------------------------------------- |
+| **Charles**  | Pragmatic architecture   | Anti-enterprise, ships fast, calls out YAGNI       |
+| **Sterling** | Enterprise systems       | Zero-downtime, compliance, multi-team coordination |
+| **Ada**      | Algorithms & performance | Big-O, profiling, optimization                     |
+| **Atlas**    | Backend & APIs           | Contract-first, database design, caching           |
+| **Hermes**   | DevOps & SRE             | CI/CD, observability, Kubernetes                   |
+| **Sentinel** | Security                 | Threat modeling, auth, compliance                  |
+| **Iris**     | Frontend & UX            | Accessibility, design systems, React/Vue           |
+| **Xavier**   | MVP development          | KISS, ship it, avoid yak shaving                   |
 
-After adding the server, you should see your tools listed under "Available Tools". If not, try clicking the refresh button in the top right corner of the MCP server section.
+## Development
 
-For more details about MCP setup, check out the [Cursor MCP Documentation](https://docs.cursor.com/advanced/model-context-protocol).
+```bash
+# Install deps
+bun install
 
-## 🛠️ Using the Tools
+# Build
+bun run build
 
-Once configured, you can use these tools directly in Cursor's Composer. The AI will automatically suggest using relevant tools, or you can explicitly request them by name or description.
+# Test
+bun test
 
-For example, try typing in Composer:
+# Run locally (for testing)
+bun run start
+```
 
-- "Review this code for best practices"
-- "Help me architect a new feature"
-- "Analyze this UI screenshot"
+### Local MCP Config
 
-The agent will ask for your approval before making any tool calls.
+For development, point to your local build:
 
-> 📘 **Pro Tip**: You can update your .cursorrules file with instructions on how to use the tools for certain scenarios, and the agent will use the tools automatically.
+```json
+{
+  "mcpServers": {
+    "coding-mcp-dev": {
+      "command": "node",
+      "args": ["/path/to/coding-mcp/build/index.js"],
+      "env": {
+        "XAI_API_KEY": "your-key"
+      }
+    }
+  }
+}
+```
 
-## 📁 Project Structure
+### Project Structure
 
 ```
 src/
-├── tools/
-│   ├── architect.ts    # Code structure generator
-│   ├── screenshot.ts   # Screenshot analysis tool
-│   └── codeReview.ts   # Code review tool
-├── env/
-│   └── keys.ts         # Environment configuration (add your API keys here!)
-└── index.ts           # Main entry point
+├── index.ts              # MCP server entry
+├── common/
+│   ├── apiClient.ts      # Unified AI provider client
+│   ├── providerConfig.ts # Env vars, provider selection
+│   └── ...
+├── personas/
+│   ├── charles/          # Each persona has its own module
+│   ├── sterling/
+│   └── ...
+└── tools/
+    ├── ask.ts            # Smart routing
+    ├── architect.ts      # Deep review
+    └── ...
 ```
 
-## 🤝 Contributing
-
-Contributions welcome! Please feel free to submit a Pull Request.
-
-## 📝 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🐛 Issues & Support
-
-Found a bug or need help? Open an issue with:
-
-1. What you were trying to do
-2. What happened instead
-3. Steps to reproduce
-4. Your environment details
-
----
-
-I'll be honest though, this is a tutorial demo, and not a production-ready tool so I likely won't be fixing issues. But feel free to fork it and make it your own!
+## License
 
-Made with ❤️ by developers, for developers
+MIT

package/build/common/apiClient.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generic AI provider API client utilities
+ * Unified AI provider client using Vercel AI SDK
  */
 import { type AIProvider, type ReasoningEffort } from "./providerConfig.js";
 export interface AICallConfig {

package/build/common/apiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/common/apiClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAoDD,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1E"}
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../../src/common/apiClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,UAAU,CAAC;CACtB;AAiBD,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B1E"}

package/build/common/apiClient.js

@@ -1,68 +1,50 @@
 /**
- * Generic AI provider API client utilities
+ * Unified AI provider client using Vercel AI SDK
  */
-import OpenAI from "openai";
+import { createOpenAI } from "@ai-sdk/openai";
 import { xai } from "@ai-sdk/xai";
 import { generateText } from "ai";
-import { OPENAI_API_KEY, validateProvider } from "./providerConfig.js";
+import { OPENAI_API_KEY, validateProvider, } from "./providerConfig.js";
 import { formatTokenInfo } from "./tokenFormatter.js";
 import { buildUserPrompt } from "./promptBuilder.js";
-async function callXaiProvider(config) {
+// Model defaults with env overrides
+const XAI_MODEL = process.env.XAI_MODEL || "grok-4.1";
+const OPENAI_MODEL = process.env.OPENAI_MODEL || "gpt-5.2";
+// Provider clients
+const openai = createOpenAI({ apiKey: OPENAI_API_KEY });
+const providers = {
+    xai: {
+        model: () => xai(XAI_MODEL),
+        mapOptions: (effort) => ({
+            xai: { reasoningEffort: effort },
+        }),
+    },
+    openai: {
+        model: () => openai(OPENAI_MODEL),
+        mapOptions: (effort) => ({
+            openai: { reasoningEffort: effort },
+        }),
+    },
+};
+export async function callAIProvider(config) {
+    validateProvider(config.provider);
+    const provider = providers[config.provider];
+    if (!provider) {
+        throw new Error(`Unsupported provider: ${config.provider}`);
+    }
     const userPrompt = buildUserPrompt({
         task: config.task,
         code: config.code,
         analysisType: config.analysisType,
     });
     const result = await generateText({
-        model: xai("grok-4"),
+        model: provider.model(),
         messages: [
             { role: "system", content: config.systemPrompt },
             { role: "user", content: userPrompt },
         ],
-        // Note: xAI doesn't support reasoningEffort parameter
+        providerOptions: provider.mapOptions(config.reasoningEffort),
     });
-    const tokenInfo = formatTokenInfo("xai", result.usage, config.reasoningEffort);
+    const tokenInfo = formatTokenInfo(config.provider, result.usage, config.reasoningEffort);
     return result.text + tokenInfo;
 }
-async function callOpenAIProvider(config) {
-    const openai = new OpenAI({
-        apiKey: OPENAI_API_KEY,
-    });
-    const userPrompt = buildUserPrompt({
-        task: config.task,
-        code: config.code,
-        analysisType: config.analysisType,
-    });
-    const response = await openai.chat.completions.create({
-        model: "gpt-5",
-        messages: [
-            { role: "system", content: config.systemPrompt },
-            { role: "user", content: userPrompt },
-        ],
-        reasoning_effort: config.reasoningEffort, // GPT-5 supports this
-    });
-    const assistantMessage = response.choices?.[0]?.message?.content ?? "No response from model.";
-    const usage = {
-        totalTokens: response.usage?.total_tokens,
-        reasoning_tokens: response.usage?.reasoning_tokens,
-    };
-    const tokenInfo = formatTokenInfo("openai", usage, config.reasoningEffort);
-    return assistantMessage + tokenInfo;
-}
-export async function callAIProvider(config) {
-    validateProvider(config.provider);
-    if (config.provider === "xai") {
-        // xAI doesn't support reasoning_effort, so create config without it
-        const xaiConfig = {
-            ...config,
-            reasoningEffort: undefined // Remove for xAI
-        };
-        return callXaiProvider(xaiConfig);
-    }
-    else if (config.provider === "openai") {
-        return callOpenAIProvider(config);
-    }
-    else {
-        throw new Error(`Unsupported provider: ${config.provider}`);
-    }
-}

package/build/core/CommandDispatcher.d.ts

@@ -3,9 +3,9 @@
  * Routes MCP requests to appropriate tool commands with structured error handling
  */
 import { CallToolRequest } from "@modelcontextprotocol/sdk/types.js";
-import { MCPToolResponse } from './ToolCommand.js';
-import { ToolRegistry } from './ToolRegistry.js';
-import { type EventBus } from '../infra/eventBus.js';
+import { MCPToolResponse } from "./ToolCommand.js";
+import { ToolRegistry } from "./ToolRegistry.js";
+import { type EventBus } from "../infra/eventBus.js";
 export interface DispatcherConfig {
     /** Default execution timeout in milliseconds */
     defaultTimeout?: number;

package/build/core/CommandDispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandDispatcher.d.ts","sourceRoot":"","sources":["../../src/core/CommandDispatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EASL,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,gBAAgB,CAA8D;IACtF,OAAO,CAAC,gBAAgB,CAAK;gBAG3B,QAAQ,EAAE,YAAY,EACtB,gBAAgB,CAAC,EAAE,QAAQ,EAC3B,MAAM,GAAE,gBAAqB;IAW/B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAiFlE;;OAEG;YACW,kBAAkB;IAiEhC;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAInF;;OAEG;IACH,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB;IAWD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB;CAGpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,gBAAgB,GACxB,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAGxD"}
+{"version":3,"file":"CommandDispatcher.d.ts","sourceRoot":"","sources":["../../src/core/CommandDispatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EASL,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,gBAAgB,CAGpB;IACJ,OAAO,CAAC,gBAAgB,CAAK;gBAG3B,QAAQ,EAAE,YAAY,EACtB,gBAAgB,CAAC,EAAE,QAAQ,EAC3B,MAAM,GAAE,gBAAqB;IAW/B;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAwFlE;;OAEG;YACW,kBAAkB;IAwEhC;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,mBAAmB,IAAI,WAAW,CAChC,MAAM,EACN;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CACxC;IAID;;OAEG;IACH,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB;IAWD;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,gBAAgB,GACxB,iBAAiB;CAGrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,gBAAgB,GACxB,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAGxD"}

package/build/core/CommandDispatcher.js

@@ -2,9 +2,9 @@
  * Command Dispatcher - Replaces the monolithic switch statement
  * Routes MCP requests to appropriate tool commands with structured error handling
  */
-import { ToolNotFoundError, ToolValidationError, ToolExecutionError, ToolTimeoutError, ToolError } from './ToolCommand.js';
-import { eventBus } from '../infra/eventBus.js';
-import { ZodError } from 'zod';
+import { ToolNotFoundError, ToolValidationError, ToolExecutionError, ToolTimeoutError, ToolError, } from "./ToolCommand.js";
+import { eventBus } from "../infra/eventBus.js";
+import { ZodError } from "zod";
 export class CommandDispatcher {
     registry;
     eventBus;
@@ -17,7 +17,7 @@ export class CommandDispatcher {
         this.config = {
             defaultTimeout: config.defaultTimeout || 30000, // 30 seconds
             enableTracing: config.enableTracing ?? true,
-            maxConcurrentExecutions: config.maxConcurrentExecutions || 10
+            maxConcurrentExecutions: config.maxConcurrentExecutions || 10,
         };
     }
     /**
@@ -30,7 +30,7 @@ export class CommandDispatcher {
         try {
             // Check concurrent execution limit
             if (this.activeExecutions.size >= this.config.maxConcurrentExecutions) {
-                throw new ToolError(`Maximum concurrent executions (${this.config.maxConcurrentExecutions}) reached`, 'RESOURCE_ERROR', toolName);
+                throw new ToolError(`Maximum concurrent executions (${this.config.maxConcurrentExecutions}) reached`, "RESOURCE_ERROR", toolName);
             }
             // Get the tool command
             const tool = this.registry.get(toolName);
@@ -40,10 +40,10 @@ export class CommandDispatcher {
             // Track active execution
             this.activeExecutions.set(requestId, { toolName, startTime });
             // Emit execution start event
-            this.eventBus.emit('tool:execute:start', {
+            this.eventBus.emit("tool:execute:start", {
                 name: toolName,
                 requestId,
-                args
+                args,
             });
             // Execute the tool with timeout
             const result = await this.executeWithTimeout(tool, args, requestId, startTime);
@@ -51,18 +51,19 @@ export class CommandDispatcher {
             this.activeExecutions.delete(requestId);
             // Emit execution end event
             const executionTime = Date.now() - startTime;
-            this.eventBus.emit('tool:execute:end', {
+            this.eventBus.emit("tool:execute:end", {
                 name: toolName,
                 requestId,
                 success: result.success,
-                executionTime
+                executionTime,
             });
             // Return MCP-compatible response
             if (result.success && result.result) {
                 return this.formatMCPResponse(result.result);
             }
             else {
-                throw result.error || new ToolExecutionError(toolName, 'Unknown execution error');
+                throw (result.error ||
+                    new ToolExecutionError(toolName, "Unknown execution error"));
             }
         }
         catch (error) {
@@ -71,18 +72,18 @@ export class CommandDispatcher {
             // Convert to ToolError if not already
             const toolError = this.normalizeError(error, toolName);
             // Emit error event
-            this.eventBus.emit('tool:error', {
+            this.eventBus.emit("tool:error", {
                 name: toolName,
                 error: toolError,
-                requestId
+                requestId,
             });
             // Emit execution end event with failure
             const executionTime = Date.now() - startTime;
-            this.eventBus.emit('tool:execute:end', {
+            this.eventBus.emit("tool:execute:end", {
                 name: toolName,
                 requestId,
                 success: false,
-                executionTime
+                executionTime,
             });
             // Return error response in MCP format
             return this.formatErrorResponse(toolError);
@@ -100,19 +101,22 @@ export class CommandDispatcher {
             }
             catch (error) {
                 if (error instanceof ZodError) {
-                    throw new ToolValidationError(tool.name, `Invalid arguments: ${error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`, error);
+                    throw new ToolValidationError(tool.name, `Invalid arguments: ${error.issues
+                        .map((e) => `${e.path.join(".")}: ${e.message}`)
+                        .join(", ")}`, error);
                 }
-                throw new ToolValidationError(tool.name, 'Failed to validate arguments', error);
+                throw new ToolValidationError(tool.name, "Failed to validate arguments", error);
             }
             // Create execution context
             const context = {
                 eventBus: this.eventBus,
                 requestId,
                 startTime,
-                config: tool.metadata?.constraints
+                config: tool.metadata?.constraints,
             };
             // Determine timeout (tool-specific or default)
-            const timeout = tool.metadata?.constraints?.maxExecutionTime || this.config.defaultTimeout;
+            const timeout = tool.metadata?.constraints?.maxExecutionTime ||
+                this.config.defaultTimeout;
             // Execute with timeout
             const result = await this.withTimeout(tool.execute(validatedArgs, context), timeout, tool.name);
             return {
@@ -122,8 +126,8 @@ export class CommandDispatcher {
                 metadata: {
                     toolName: tool.name,
                     version: tool.version,
-                    requestId
-                }
+                    requestId,
+                },
             };
         }
         catch (error) {
@@ -134,8 +138,8 @@ export class CommandDispatcher {
                 metadata: {
                     toolName: tool.name,
                     version: tool.version,
-                    requestId
-                }
+                    requestId,
+                },
             };
         }
     }
@@ -172,10 +176,14 @@ export class CommandDispatcher {
         }
         // Convert to MCP format
         return {
-            content: [{
+            content: [
+                {
                     type: "text",
-                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
-                }]
+                    text: typeof result === "string"
+                        ? result
+                        : JSON.stringify(result, null, 2),
+                },
+            ],
         };
     }
     /**
@@ -183,22 +191,24 @@ export class CommandDispatcher {
      */
     formatErrorResponse(error) {
         const errorMessage = this.config.enableTracing
-            ? `${error.message}\n\nError Code: ${error.code}\nTool: ${error.toolName || 'unknown'}`
+            ? `${error.message}\n\nError Code: ${error.code}\nTool: ${error.toolName || "unknown"}`
             : error.message;
         return {
-            content: [{
+            content: [
+                {
                     type: "text",
-                    text: `Error: ${errorMessage}`
-                }]
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
         };
     }
     /**
      * Check if result is already in MCP response format
      */
     isMCPResponse(result) {
-        return (typeof result === 'object' &&
+        return (typeof result === "object" &&
             result !== null &&
-            'content' in result &&
+            "content" in result &&
             Array.isArray(result.content));
     }
     /**
@@ -223,7 +233,7 @@ export class CommandDispatcher {
             activeExecutions: this.activeExecutions.size,
             totalExecutions: this.executionCounter,
             averageExecutionTime: 0, // Would need history tracking
-            errorRate: 0 // Would need error tracking
+            errorRate: 0, // Would need error tracking
         };
     }
     /**

package/build/index.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import "./personas/charles/index.js";
+import "./personas/sterling/index.js";
 import "./personas/ada/index.js";
 import "./personas/xavier/index.js";
 import "./personas/atlas/index.js";

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiEA,OAAO,6BAA6B,CAAC;AACrC,OAAO,yBAAyB,CAAC;AACjC,OAAO,4BAA4B,CAAC;AACpC,OAAO,2BAA2B,CAAC;AACnC,OAAO,4BAA4B,CAAC;AACpC,OAAO,8BAA8B,CAAC;AACtC,OAAO,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiEA,OAAO,6BAA6B,CAAC;AACrC,OAAO,8BAA8B,CAAC;AACtC,OAAO,yBAAyB,CAAC;AACjC,OAAO,4BAA4B,CAAC;AACpC,OAAO,2BAA2B,CAAC;AACnC,OAAO,4BAA4B,CAAC;AACpC,OAAO,8BAA8B,CAAC;AACtC,OAAO,0BAA0B,CAAC"}

package/build/index.js

@@ -12,6 +12,7 @@ import { askToolName, askToolDescription, AskToolSchema, runAskTool, } from "./t
 import { discoverToolName, discoverToolDescription, DiscoverToolSchema, runDiscoverTool, } from "./tools/discover.js";
 // Import personas to auto-register
 import "./personas/charles/index.js";
+import "./personas/sterling/index.js";
 import "./personas/ada/index.js";
 import "./personas/xavier/index.js";
 import "./personas/atlas/index.js";
@@ -32,7 +33,7 @@ import "./personas/iris/index.js";
 // 1. Create an MCP server instance
 const server = new Server({
     name: "cursor-tools",
-    version: "2.0.5",
+    version: "2.1.0",
 }, {
     capabilities: {
         tools: {},
@@ -258,6 +259,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             enum: [
                                 "architecture",
+                                "enterprise",
                                 "algorithms",
                                 "security",
                                 "frontend",

package/build/personas/charles/index.d.ts

@@ -2,7 +2,7 @@
  * Charles - A thoughtful, witty British architect with high reasoning capabilities
  * Personality layer over GPT-5-class models
  */
-import { BasePersona, PersonaContext } from '../types.js';
+import { BasePersona, PersonaContext } from "../types.js";
 export declare class CharlesPersona extends BasePersona {
     constructor();
     enhanceSystemPrompt(basePrompt: string, context: PersonaContext): string;

package/build/personas/charles/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/personas/charles/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AA8CzE,qBAAa,cAAe,SAAQ,WAAW;;IAU7C,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAqDxE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAwBtE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAwBlE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAe/D,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,uBAAuB;IAuB/B,OAAO,CAAC,sBAAsB;CAU/B;AAID,QAAA,MAAM,OAAO,gBAAuB,CAAC;AAGrC,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/personas/charles/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAyDzE,qBAAa,cAAe,SAAQ,WAAW;;IAU7C,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IA8ExE,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IA2BtE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAwBlE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAe/D,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,uBAAuB;IA2B/B,OAAO,CAAC,sBAAsB;CAW/B;AAID,QAAA,MAAM,OAAO,gBAAuB,CAAC;AAGrC,eAAe,OAAO,CAAC"}