@brutalist/mcp 0.9.3 → 1.0.0

package/README.md

@@ -215,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

package/dist/brutalist-server.d.ts

@@ -47,19 +47,28 @@ export declare class BrutalistServer {
     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)
+     * Register special tools (debate, roster, unified roast)
      */
     private registerSpecialTools;
     /**
-     * Handle debate tool execution with caching, pagination, and conversation continuation
-     * Delegated mostly to ToolHandler but kept here for CLI debate-specific logic
+     * 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 (kept in server for debate-specific logic)
+     * Execute CLI debate with constitutional position anchoring.
+     * 2 agents, explicit PRO/CON positions, context compression between rounds.
      */
     private executeCLIDebate;
     /**

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;AAOpE,OAAO,EACL,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAc9B;;;;;;;;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;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuG5B;;;OAGG;YACW,yBAAyB;IAmLvC;;OAEG;YACW,gBAAgB;IA0J9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA8FzB"}
+{"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"}