@brutalist/mcp 0.8.1 → 1.0.0

package/README.md

@@ -41,6 +41,27 @@ Choose your IDE:
 claude mcp add brutalist --scope user -- npx -y @brutalist/mcp@latest
 ```
 
+**Codex:**
+```bash
+# Install globally once to avoid npx startup chatter
+npm i -g @brutalist/mcp
+# Add MCP using the installed binary (clean stdio)
+codex mcp add brutalist -- brutalist-mcp
+```
+
+**Configuring `tool_timeout_sec` for Codex:**
+The `tool_timeout_sec` parameter (defaulting to 60 seconds) for your Brutalist MCP server needs to be configured directly in your Codex configuration file at `~/.codex/config.toml`. It cannot be passed via the `codex mcp add` command directly.
+
+To set a custom timeout (e.g., 5 minutes or 300 seconds), add or modify the `[mcp_servers.brutalist]` section in `~/.codex/config.toml` as follows:
+
+```toml
+[mcp_servers.brutalist]
+command = "brutalist-mcp" # Ensure this matches your installation command
+args = [] # Depending on your setup, this might be empty or contain arguments
+tool_timeout_sec = 300 # Set your desired timeout in seconds
+```
+
+
 **Cursor:**
 Add to `~/.cursor/mcp.json`:
 ```json
@@ -194,22 +215,28 @@ Features:
 
 | Tool | Purpose |
 |------|---------|
+| `roast` | **Unified tool** - use `domain` parameter to select analysis type |
+| `brutalist_discover` | Find the best tool for your intent using natural language |
 | `roast_cli_debate` | Multi-agent discussion from different perspectives |
 | `cli_agent_roster` | Show available CLI agents on your system |
 
+> **Tip:** Use the unified `roast` tool with a domain parameter for a leaner schema, or use `brutalist_discover` to find the right tool based on your intent.
+
+See [docs/pagination.md](docs/pagination.md) for detailed pagination documentation.
+
 ## Advanced Usage
 
 ### Choose Specific CLI Agents
 
 ```bash
-# Use a specific agent
-roast_codebase(targetPath="/src", preferredCLI="claude")
+# Use specific agents (subset selection)
+roast(domain="codebase", target="/src", clis=["claude", "gemini"])
 
-# System automatically selects best agent for task
-roast_security "/auth/module"  # Typically uses Codex
+# Use a single agent
+roast(domain="codebase", target="/src", clis=["claude"])
 
-# Multi-agent analysis (default)
-roast_idea "..."  # All available agents provide perspectives
+# Multi-agent analysis (default - all available)
+roast(domain="idea", target="...")  # All available agents provide perspectives
 ```
 
 ### Agent Strengths
@@ -232,4 +259,4 @@ Getting multiple viewpoints helps identify issues that a single perspective migh
 ---
 
 **License:** MIT
-**Issues:** https://github.com/ejmockler/brutalist-mcp/issues
+**Issues:** https://github.com/ejmockler/brutalist-mcp/issues

package/dist/brutalist-server.d.ts

@@ -1,40 +1,79 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BrutalistServerConfig } from './types/brutalist.js';
+/**
+ * BrutalistServer - Composition root for the Brutalist MCP Server
+ *
+ * This class has been refactored to follow the Single Responsibility Principle.
+ * Responsibilities are now delegated to specialized modules:
+ * - ResponseFormatter: Handles all response formatting and pagination
+ * - HttpTransport: Manages HTTP server and CORS
+ * - ToolHandler: Handles roast tool execution, caching, and conversation continuation
+ */
 export declare class BrutalistServer {
     server: McpServer;
     config: BrutalistServerConfig;
     private cliOrchestrator;
-    private httpTransport?;
     private responseCache;
-    private actualPort?;
-    private httpServer?;
-    private shutdownHandler?;
+    private formatter;
+    private toolHandler;
+    private httpTransport?;
     private activeSessions;
+    private readonly MAX_SESSIONS;
+    private readonly SESSION_TTL_MS;
+    private sessionCleanupTimer?;
     constructor(config?: BrutalistServerConfig);
-    private handleStreamingEvent;
-    private handleProgressUpdate;
     start(): Promise<void>;
     private startStdioServer;
     private startHttpServer;
     getActualPort(): number | undefined;
     stop(): Promise<void>;
+    /**
+     * Clean up stale sessions that exceed TTL
+     */
+    private cleanupStaleSessions;
+    /**
+     * Ensure session capacity doesn't exceed MAX_SESSIONS
+     * Evicts oldest sessions when capacity is reached
+     */
+    ensureSessionCapacity(): void;
     cleanup(): void;
+    /**
+     * Handle streaming events from CLI agents
+     */
+    private handleStreamingEvent;
+    /**
+     * Handle progress updates from CLI agents
+     */
+    private handleProgressUpdate;
+    /**
+     * Register all MCP tools
+     *
+     * TOOL REDUCTION STRATEGY: Only expose 4 gateway tools instead of 15.
+     * The unified `roast` tool with domain parameter replaces all 11 roast_* tools.
+     * This reduces cognitive load for AI agents while maintaining full functionality.
+     */
     private registerTools;
+    /**
+     * Register special tools (debate, roster, unified roast)
+     */
     private registerSpecialTools;
     /**
-     * Unified handler for all roast tools - DRY principle
+     * Handle unified roast tool - routes to appropriate domain handler
+     */
+    private handleUnifiedRoast;
+    /**
+     * Handle debate tool execution with constitutional position anchoring.
+     * Uses 2 randomly selected agents (or user-specified) with explicit PRO/CON positions.
+     */
+    private handleDebateToolExecution;
+    /**
+     * Execute CLI debate with constitutional position anchoring.
+     * 2 agents, explicit PRO/CON positions, context compression between rounds.
      */
-    private handleRoastTool;
     private executeCLIDebate;
-    private synthesizeDebate;
-    private executeBrutalistAnalysis;
     /**
-     * Extract full content from analysis result for caching
+     * Synthesize debate results into formatted output
      */
-    private extractFullContent;
-    private formatToolResponse;
-    private formatPaginatedResponse;
-    private formatErrorResponse;
-    private handleToolExecution;
+    private synthesizeDebate;
 }
 //# sourceMappingURL=brutalist-server.d.ts.map

package/dist/brutalist-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brutalist-server.d.ts","sourceRoot":"","sources":["../src/brutalist-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE,OAAO,EACL,qBAAqB,EAKtB,MAAM,sBAAsB,CAAC;AAc9B,qBAAa,eAAe;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IACrC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAM;IACzB,OAAO,CAAC,eAAe,CAAC,CAAa;IAErC,OAAO,CAAC,cAAc,CAIjB;gBAEO,MAAM,GAAE,qBAA0B;IA0C9C,OAAO,CAAC,oBAAoB,CAkE1B;IAEF,OAAO,CAAC,oBAAoB,CAsC1B;IAEI,KAAK;YAeG,gBAAgB;YAMhB,eAAe;IAmItB,aAAa,IAAI,MAAM,GAAG,SAAS;IAK7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,OAAO,IAAI,IAAI;IAOtB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,oBAAoB;IAoG5B;;OAEG;YACW,eAAe;YAsOf,gBAAgB;IAkK9B,OAAO,CAAC,gBAAgB;YA0FV,wBAAwB;IA0FtC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B,OAAO,CAAC,kBAAkB;IA6F1B,OAAO,CAAC,uBAAuB;IAuH/B,OAAO,CAAC,mBAAmB;YA8Bb,mBAAmB;CAUlC"}
+{"version":3,"file":"brutalist-server.d.ts","sourceRoot":"","sources":["../src/brutalist-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,EACL,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAgB9B;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAGrC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAAgB;IAGrC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IAGtC,OAAO,CAAC,cAAc,CAIjB;IAGL,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAEjC,MAAM,GAAE,qBAA0B;IA2DxC,KAAK;YAeG,gBAAgB;YAMhB,eAAe;IActB,aAAa,IAAI,MAAM,GAAG,SAAS;IAK7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;OAGG;IACI,qBAAqB,IAAI,IAAI;IAc7B,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAgE1B;IAEF;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAsC1B;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+M5B;;OAEG;YACW,kBAAkB;IAiEhC;;;OAGG;YACW,yBAAyB;IA2LvC;;;OAGG;YACW,gBAAgB;IAwN9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA8FzB"}