@loopops/mcp-server 3.34.0 → 3.35.0

package/dist/tools/config.js

@@ -137,7 +137,23 @@ export function registerConfigTools(server, allowed) {
         })));
     }
     if (allowed.has("promote_scenario")) {
-        server.tool("promote_scenario", "Promote a scenario to active by editing `active_scenario` in config/design/capacity_config.yaml. Fails hard if the scenario doesn't resolve (missing or dangling components) — won't promote a broken plan. Dry-run by default — returns the diff; pass dryRun:false to commit the change.", {
+        server.tool("promote_scenario", [
+            "Promote a scenario to active by editing `active_scenario` in",
+            "config/design/capacity_config.yaml. Fails hard if the scenario",
+            "doesn't resolve (missing or dangling components) — won't promote",
+            "a broken plan. Dry-run by default — returns the diff; pass",
+            "dryRun:false to commit.",
+            "Open-cycle conflict: when the org has an open planning cycle",
+            "bound to a different scenario, promote refuses by default — the",
+            "cycle's scenarioId needs to move with the active scenario or",
+            "commit_cycle promotes the wrong scenario at cutover. Re-run with",
+            "rebindOpenCycle:true to apply the rebind atomically — the open",
+            "cycle's scenarioId moves, every non-superseded proposal across",
+            "all three phases is superseded (re-run propose after rebind),",
+            "and the planning scope snapshot is cleared (re-run",
+            "snapshot_planning_scope). A cycle-level audit row of",
+            "action='rebind_scenario' captures the impact counts.",
+        ].join(" "), {
             scenarioId: z
                 .string()
                 .describe("Scenario id to promote (e.g. 'stretch'). Must exist in config/design/scenarios/ and be complete."),
@@ -145,11 +161,20 @@ export function registerConfigTools(server, allowed) {
                 .boolean()
                 .default(true)
                 .describe("When true (default), return the diff without writing. Pass dryRun:false to commit."),
+            rebindOpenCycle: z
+                .boolean()
+                .default(false)
+                .describe("Required acknowledgement when an open cycle is bound to a different scenario. Default false → refuse with structured impact counts. Pass true to apply the rebind: update planning_cycle.scenarioId, supersede every non-superseded user / quota / account proposal in the cycle, delete planning_cycle_account_scope rows, then flip active_scenario in capacity_config.yaml. Atomic; audited as action='rebind_scenario'."),
             branch: z
                 .string()
                 .optional()
                 .describe("Git branch to read from and write back to. Default: main. Writing to main = live promotion."),
-        }, safeTool(async ({ scenarioId, dryRun, branch }) => trpcMutation("mcp.promoteScenario", { scenarioId, dryRun, branch })));
+        }, safeTool(async ({ scenarioId, dryRun, rebindOpenCycle, branch }) => trpcMutation("mcp.promoteScenario", {
+            scenarioId,
+            dryRun,
+            rebindOpenCycle,
+            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. Output is exploratory by default — pass `writeFile: true` to materialize the proposal as a draft scenario at `config/design/scenarios/proposed-gap-{measure}-{ts}.yaml`, then use `compare_scenarios` to verify and `promote_scenario` to make it active.", {

package/dist/tools/deploy.js

@@ -596,17 +596,16 @@ export function registerDeployTools(server, allowed) {
     }
     if (allowed.has("commit_cycle")) {
         server.tool("commit_cycle", [
-            "Ops only. Phase 4.3 atomic cutover for directory-shape",
-            "scenarios. Reads all approved rows across user / quota /",
-            "account placement tables, promotes scenario inputs (territories,",
-            "hierarchy, composition, account_placement) to canonical",
-            "config/deploy/, writes assignments.yaml + quotas.yaml outputs,",
-            "updates account.territory_slug for committed account placements,",
+            "Ops only. Atomic cutover for a planning cycle. Reads all",
+            "approved rows across user / quota / account placement tables,",
+            "promotes scenario inputs (territories, hierarchy, composition,",
+            "account_placement) to canonical config/deploy/, writes",
+            "assignments.yaml + quotas.yaml outputs, propagates",
+            "rep_input_override rows to the scenario roster, updates",
+            "account.territory_slug for committed account placements,",
             "transitions all rows to 'committed', closes the cycle. ONE",
             "GitHub commit + ONE DB transaction — either everything lands",
-            "or nothing does. Force two-step (default dryRun:true). Refuses",
-            "on legacy single-file scenarios; per-phase commits still work",
-            "for those.",
+            "or nothing does. Force two-step (default dryRun:true).",
         ].join(" "), {
             planningCycleId: z.string().uuid().optional().describe("Planning cycle. Defaults to the org's currently-open cycle."),
             dryRun: z.boolean().optional().describe("Default true. Pass false to perform the atomic commit."),

package/package.json

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