@loopops/mcp-server 3.33.0 → 3.35.0

package/dist/tools/account-master.js

@@ -158,7 +158,7 @@ export function registerAccountMasterTools(server, allowed) {
                 .min(1)
                 .max(64)
                 .regex(/^[a-z0-9_]+$/)
-                .describe("Attribute name in snake_case (e.g. 'hq_state', 'industry_naics', 'employee_count'). Must match the `attribute_name` used in resolution rules."),
+                .describe("Attribute name in snake_case (e.g. 'billing_state', 'industry_naics', 'employee_count'). Must match the `attribute_name` used in resolution rules."),
             value: z
                 .string()
                 .min(1)
@@ -218,7 +218,7 @@ export function registerAccountMasterTools(server, allowed) {
                 .min(1)
                 .max(64)
                 .regex(/^[a-z0-9_]+$/)
-                .describe("Attribute name (e.g. 'hq_state'). Must match a prior manual override row."),
+                .describe("Attribute name (e.g. 'billing_state'). Must match a prior manual override row."),
             reason: z
                 .string()
                 .min(3)

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

@@ -472,9 +472,23 @@ export function registerDeployTools(server, allowed) {
             preserveCurrentOwnershipOverride: z.boolean().optional().describe("Override config/deploy/account_placement.yaml's preserve_current_ownership policy."),
             accountIds: z.array(z.string().uuid()).optional().describe("Optional restriction; only model these accounts."),
             scenarioId: z.string().optional().describe("Override active scenario."),
+            async: z.boolean().optional().describe("Run the placement model as a Modal background job (bypasses Vercel's 5-min function ceiling). Returns immediately with a job_id; poll status via propose_account_assignments_status. Recommended for cycles with >500 accounts. Default: false."),
             branch: z.string().optional(),
         }, safeTool(async (input) => trpcMutation("mcp.proposeAccountAssignments", input)));
     }
+    if (allowed.has("propose_account_assignments_status")) {
+        server.tool("propose_account_assignments_status", [
+            "Read the status of an async account-placement job kicked off by",
+            "`propose_account_assignments async:true`. Returns the job's current",
+            "status (queued / running / complete / failed), how many proposals",
+            "have been written so far, when it started/completed, and the",
+            "Modal call id for cross-referencing in the Modal UI. Once the",
+            "status is `complete`, run `review_account_assignments` to see the",
+            "proposals.",
+        ].join(" "), {
+            jobId: z.string().uuid().describe("placement_job.id returned by `propose_account_assignments async:true`."),
+        }, safeTool(async (input) => trpcQuery("mcp.proposeAccountAssignmentsStatus", input)));
+    }
     if (allowed.has("review_account_assignments")) {
         server.tool("review_account_assignments", [
             "List Phase 3 account placement proposals for a cycle. Subtree-",
@@ -582,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.33.0",
+  "version": "3.35.0",
   "description": "Loop Operations MCP Server — AI skills for RevOps",
   "license": "UNLICENSED",
   "type": "module",