@loopops/mcp-server 3.34.0 → 3.38.0

package/dist/tools/config.js

@@ -136,8 +136,60 @@ export function registerConfigTools(server, allowed) {
             branch,
         })));
     }
+    if (allowed.has("create_scenario")) {
+        server.tool("create_scenario", [
+            "Ops only. Clone a base scenario into a new directory.",
+            "Web-callable equivalent of scripts/scenario-create.mjs — no",
+            "local clone or DATABASE_URL required. Reads every file in the",
+            "base scenario directory, regenerates scenario.yaml with the new",
+            "id + cloned_from, rewrites scenario_id rows in targets.yaml,",
+            "copies the rest verbatim (roster, target_productivity, plus any",
+            "optional canonical-input overrides the base carries), and writes",
+            "everything in ONE atomic GitHub commit. Default dryRun:true",
+            "shows the planned file list. After commit, edit the new scenario",
+            "via update_config (or your editor) and run promote_scenario",
+            "when ready.",
+        ].join(" "), {
+            id: z
+                .string()
+                .min(1)
+                .describe("New scenario id (slug: lowercase letters/digits/underscores/hyphens, max 64 chars). Becomes the directory name under config/design/scenarios/. Must not already exist."),
+            baseScenarioId: z
+                .string()
+                .min(1)
+                .describe("Existing scenario to clone from (e.g. 'base'). Must resolve cleanly."),
+            description: z
+                .string()
+                .optional()
+                .describe("Manifest description for the new scenario. Defaults to 'Cloned from <base> on <date>'."),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe("Default true. Pass false to commit. Dry-run lists the files that would be written."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to read base from AND write the new scenario to. Default: main."),
+        }, safeTool(async (input) => trpcMutation("mcp.createScenario", input)));
+    }
     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 +197,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

@@ -594,19 +594,50 @@ export function registerDeployTools(server, allowed) {
                 .describe("Why you're rolling back — required, min 20 chars. Captured in every per-proposal audit row."),
         }, safeTool(async (input) => trpcMutation("mcp.rollbackAccountCommit", input)));
     }
+    if (allowed.has("open_cycle")) {
+        server.tool("open_cycle", [
+            "Ops only. Open a new planning_cycle row bound to a Design",
+            "scenario. Refuses by default if another open cycle exists for",
+            "the org (most propose_* tools assume exactly one open cycle —",
+            "two parallel cycles silently produce ambiguous defaults). Pass",
+            "allowMultipleOpen:true to open a parallel sandbox. Validates",
+            "the target scenario resolves cleanly (same check as",
+            "promote_scenario) — never binds a cycle to a broken scenario.",
+            "scenarioId defaults to capacity_config.active_scenario when",
+            "omitted. Writes an audit row of action='open' on the",
+            "deploy.planning_cycle resource. Pairs with close_cycle +",
+            "commit_cycle to make the cycle lifecycle fully MCP-callable.",
+        ].join(" "), {
+            name: z
+                .string()
+                .min(1)
+                .describe("Human label for the cycle (e.g. 'FY27 H1 territory plan'). Shown in /control/cycles and every propose response."),
+            scenarioId: z
+                .string()
+                .optional()
+                .describe("Scenario to bind the cycle to. Defaults to capacity_config.active_scenario."),
+            allowMultipleOpen: z
+                .boolean()
+                .optional()
+                .describe("Default false → refuses if another open cycle exists. Pass true to open a parallel cycle anyway."),
+            branch: z
+                .string()
+                .optional()
+                .describe("Git branch to validate the scenario from. Default: main."),
+        }, safeTool(async (input) => trpcMutation("mcp.openCycle", input)));
+    }
     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.38.0",
   "description": "Loop Operations MCP Server — AI skills for RevOps",
   "license": "UNLICENSED",
   "type": "module",