@brutalist/mcp 1.8.1 → 1.9.1

package/README.md

@@ -210,6 +210,8 @@ Features:
 | `roast_security` | Attack vectors, authentication, authorization |
 | `roast_product` | UX, adoption barriers, user needs |
 | `roast_infrastructure` | Reliability, scaling, operational overhead |
+| `roast_design` | Perceptual craft, typography, affordances (Playwright for live UIs) |
+| `roast_legal` | Authority, application, adversary, procedure, interpretation, risk |
 
 ### Utilities
 
@@ -244,6 +246,36 @@ Different agents have different strengths:
 - **Security**: Codex, Claude, Gemini
 - **Research**: Claude, Gemini, Codex
 
+### Verification-Heavy Domains
+
+`legal`, `research`, and `security` ship with a mandatory verification protocol. Before citing any external authority (case, statute, study, CVE, advisory), agents must invoke their native web tools, lift a verbatim quote from the source, and tag the citation with one of:
+
+- `[VERIFIED: <url> | "<verbatim quote supporting the attribution>"]`
+- `[SUPPLIED: <location> | "<verbatim quote from supplied materials>"]`
+- `[UNVERIFIED: <reason>]` — verification failed; no quote
+
+Untagged citations are a protocol violation. The "state doctrine without a cite" fallback is conditional on a failed web lookup, not a parallel option. Consumers of the critique can spot-check citations by fetching the URL and grepping for the quoted string.
+
+### Gemini Frontier Model Rotation
+
+For Gemini, the server pins `gemini-3.1-pro-preview` as the default to prevent the CLI's Auto router from downselecting to `gemini-2.5-flash-lite` under verification load. The orchestrator automatically rotates through the frontier chain when the current tier is unavailable:
+
+1. `gemini-3.1-pro-preview` (newest frontier, preview-tier access)
+2. `gemini-3-pro-preview` (previous frontier, preview-tier access)
+3. `gemini-2.5-pro` (stable last-gen frontier, universally available)
+
+**Rotation fires on both capacity and access failures.** Users without preview-tier access (most accounts) will see the chain naturally fall through to `gemini-2.5-pro` on the first call — which is still a frontier-class model, far better than the Auto router's `gemini-2.5-flash-lite` downselect. Users *with* preview access get the newest model when capacity is available, with graceful fallback when it isn't.
+
+Rotatable failure patterns:
+- Capacity: `429`, `"No capacity available"`, `quota`, `rate limit`, `too many requests`
+- Access: `ModelNotFoundError`, `"Requested entity was not found"`, `403`, `permission denied`
+
+Rotation aborts immediately on unrelated failures (auth, subprocess crash, prompt rejection) — a different model won't fix those.
+
+Overrides:
+- Per-call: `roast(..., models={gemini: "gemini-2.5-flash"})` — caller chooses, no rotation.
+- Per-environment: `BRUTALIST_GEMINI_MODEL=gemini-2.5-pro` — operator chooses, no rotation. Set this to `gemini-2.5-pro` to skip the preview-tier probe cost if you know your account lacks access.
+
 ## Why Multiple Perspectives
 
 Each CLI agent brings a different approach to analysis:

package/dist/brutalist-server.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { MetricsRegistry } from './metrics/index.js';
 import { BrutalistServerConfig } from './types/brutalist.js';
 /**
  * BrutalistServer - Composition root for the Brutalist MCP Server
@@ -8,15 +9,38 @@ import { BrutalistServerConfig } from './types/brutalist.js';
  * - ResponseFormatter: Handles all response formatting and pagination
  * - HttpTransport: Manages HTTP server and CORS
  * - ToolHandler: Handles roast tool execution, caching, and conversation continuation
+ * - DebateOrchestrator: Debate orchestration with 3-tier escalation (src/debate/)
  */
 export declare class BrutalistServer {
     server: McpServer;
     config: BrutalistServerConfig;
-    private cliOrchestrator;
+    private _cliOrchestrator;
     private responseCache;
     private formatter;
     private toolHandler;
+    private debateOrchestrator;
     private httpTransport?;
+    /**
+     * Observability: a single MetricsRegistry per BrutalistServer instance
+     * (not a module-level singleton — two BrutalistServers produce two
+     * independent registries, which keeps tests deterministic). Shared
+     * with DebateOrchestrator and CLIAgentOrchestrator; consumed by the
+     * streaming fan-out at handleStreamingEvent.
+     */
+    protected readonly metrics: MetricsRegistry;
+    /**
+     * Per-subsystem scoped loggers bound at construction time. The module
+     * label is fixed at construction; sub-call sites narrow the operation
+     * label via `.forOperation(...)`. Bindings:
+     *   - cliLog       → module='cli-orchestrator', operation='spawn'
+     *   - streamingLog → module='streaming',        operation='dispatch'
+     * The debate scoped log is constructed inline at the DebateOrchestrator
+     * call site below (module='debate', operation='orchestrate').
+     */
+    private readonly cliLog;
+    private readonly streamingLog;
+    private get cliOrchestrator();
+    private set cliOrchestrator(value);
     private activeSessions;
     private readonly MAX_SESSIONS;
     private readonly SESSION_TTL_MS;
@@ -62,18 +86,16 @@ export declare class BrutalistServer {
      */
     private handleUnifiedRoast;
     /**
-     * Handle debate tool execution with constitutional position anchoring.
-     * Uses 2 randomly selected agents (or user-specified) with explicit PRO/CON positions.
+     * Thin delegation to DebateOrchestrator.handleDebateToolExecution().
+     * Preserved as a method on BrutalistServer so that existing tests using
+     * `(server as any).handleDebateToolExecution(...)` continue to work.
      */
     private handleDebateToolExecution;
     /**
-     * Execute CLI debate with constitutional position anchoring.
-     * 2 agents, explicit PRO/CON positions, context compression between rounds.
+     * Thin delegation to DebateOrchestrator.executeCLIDebate().
+     * Preserved as a method on BrutalistServer so that existing tests using
+     * `(server as any).executeCLIDebate(...)` continue to work.
      */
     private executeCLIDebate;
-    /**
-     * Synthesize debate results into formatted output
-     */
-    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;AAQpE,OAAO,EACL,qBAAqB,EAKtB,MAAM,sBAAsB,CAAC;AAmB9B;;;;;;;;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;IAcvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrC;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAgE1B;IAEF;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAwC1B;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoO5B;;OAEG;YACW,kBAAkB;IAuEhC;;;OAGG;YACW,yBAAyB;IA8MvC;;;OAGG;YACW,gBAAgB;IA2d9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAuHzB"}
+{"version":3,"file":"brutalist-server.d.ts","sourceRoot":"","sources":["../src/brutalist-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAiB9B;;;;;;;;;GASG;AACH,qBAAa,eAAe;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;IAKrC,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,aAAa,CAAgB;IAGrC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,aAAa,CAAC,CAAgB;IAEtC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAA2B;IAEtE;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,KAAK,eAAe,GAE1B;IACD,OAAO,KAAK,eAAe,QAK1B;IAGD,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;IAsFxC,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;IAcvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrC;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAgF1B;IAEF;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAyC1B;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwO5B;;OAEG;YACW,kBAAkB;IA2EhC;;;;OAIG;YACW,yBAAyB;IAIvC;;;;OAIG;YACW,gBAAgB;CAG/B"}