@loopops/mcp-server 2.4.0 → 2.5.0

package/dist/tools/config.js

@@ -152,7 +152,7 @@ export function registerConfigTools(server, allowed) {
         }, safeTool(async ({ scenarioId, dryRun, branch }) => trpcMutation("mcp.promoteScenario", { scenarioId, dryRun, branch })));
     }
     if (allowed.has("gap_analysis")) {
-        server.tool("gap_analysis", "Use a Claude agent to find the smallest change set that closes a scenario's capacity gap on the target measure. The agent iterates simulate_capacity calls (mutating roster + target_productivity in memory, calling the existing /capacity endpoint) up to a budget cap, then submits a structured proposal. Writes the converged proposal as a draft scenario at `config/plan/scenarios/proposed-gap-{measure}-{ts}.yaml` (override with `writeFile: false`). Use `compare_scenarios` to verify the proposal, then `promote_scenario` to make it active.", {
+        server.tool("gap_analysis", "Use a Claude agent to find the smallest change set that closes a scenario's capacity gap on the target measure. The agent iterates simulate_capacity calls (mutating roster + target_productivity in memory, calling the existing /capacity endpoint) up to a budget cap, then submits a structured proposal. Output is exploratory by default — pass `writeFile: true` to materialize the proposal as a draft scenario at `config/plan/scenarios/proposed-gap-{measure}-{ts}.yaml`, then use `compare_scenarios` to verify and `promote_scenario` to make it active.", {
             scenarioId: z
                 .string()
                 .describe("Scenario whose capacity gap to close (e.g. 'stretch'). Must exist in config/plan/scenarios/ and be complete."),
@@ -184,8 +184,8 @@ export function registerConfigTools(server, allowed) {
                 .describe("Max simulate_capacity calls before the agent must submit. Default: 5. Hard cap: 20."),
             writeFile: z
                 .boolean()
-                .default(true)
-                .describe("When true (default), commit the proposal as a draft scenario. Pass false to inspect inline only."),
+                .default(false)
+                .describe("When true, commit the proposal as a draft scenario for compare_scenarios + promote_scenario. Default: false (exploratory). Pass true to materialize."),
             branch: z
                 .string()
                 .optional()
@@ -258,7 +258,7 @@ export function registerConfigTools(server, allowed) {
         })));
     }
     if (allowed.has("opportunity_search")) {
-        server.tool("opportunity_search", "Use a Claude agent to find the deployment of a fixed budget that maximizes capacity gain on a target measure. Sibling to gap_analysis with opposite objective: where gap_analysis closes a gap to zero, opportunity_search maximizes upside under a budget constraint. Same tool surface (simulate_capacity + submit_final_proposal). Writes the agent's best deployment as a draft scenario at `config/plan/scenarios/proposed-opportunity-{measure}-{ts}.yaml` (override with `writeFile: false`). Use `compare_scenarios` to verify, then `promote_scenario` to make it active.", {
+        server.tool("opportunity_search", "Use a Claude agent to find the deployment of a fixed budget that maximizes capacity gain on a target measure. Sibling to gap_analysis with opposite objective: where gap_analysis closes a gap to zero, opportunity_search maximizes upside under a budget constraint. Same tool surface (simulate_capacity + submit_final_proposal). Output is exploratory by default — pass `writeFile: true` to materialize the deployment as a draft scenario at `config/plan/scenarios/proposed-opportunity-{measure}-{ts}.yaml`, then use `compare_scenarios` to verify and `promote_scenario` to make it active.", {
             scenarioId: z
                 .string()
                 .describe("Source scenario id (e.g. 'base'). Must exist and be complete."),
@@ -290,8 +290,8 @@ export function registerConfigTools(server, allowed) {
                 .describe("Max simulate_capacity calls before the agent must submit. Default: 5. Hard cap: 20."),
             writeFile: z
                 .boolean()
-                .default(true)
-                .describe("When true (default), commit the deployment as a draft scenario. Pass false to inspect inline only."),
+                .default(false)
+                .describe("When true, commit the deployment as a draft scenario for compare_scenarios + promote_scenario. Default: false (exploratory). Pass true to materialize."),
             branch: z
                 .string()
                 .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loopops/mcp-server",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Loop Operations MCP Server — AI skills for RevOps",
   "license": "UNLICENSED",
   "type": "module",