@lexq/cli 0.1.57 → 0.1.59

package/dist/index.js

@@ -2129,7 +2129,8 @@ function registerAnalyticsCommands(program) {
     "after",
     dedent8`
 
-        Shows progress, match rate, metric comparison (if baseline set), and per-rule stats.
+        Shows progress, match rate, metric comparison and its change distribution (if a
+        baseline is set), and per-rule stats.
 
         Example:
           $ lexq analytics simulation status --id <simId> --format table
@@ -2172,6 +2173,21 @@ function registerAnalyticsCommands(program) {
           console.log(
             `Change:     ${data.metricSummary.deltaPercentage > 0 ? "+" : ""}${data.metricSummary.deltaPercentage.toFixed(1)}%`
           );
+          const dist = data.metricSummary.distribution;
+          if (dist) {
+            console.log(`
+\u2500\u2500 Distribution \u2500\u2500`);
+            console.log(`Changed:    ${dist.changedRecords}`);
+            console.log(`Increased:  ${dist.increasedRecords}`);
+            console.log(`Decreased:  ${dist.decreasedRecords}`);
+            console.log(
+              `Largest +:  ${dist.largestIncrease === null ? "\u2013" : `${signPrefix(dist.largestIncrease)}${String(dist.largestIncrease)}`}`
+            );
+            console.log(
+              `Largest -:  ${dist.largestDecrease === null ? "\u2013" : String(dist.largestDecrease)}`
+            );
+            console.log(`Measured:   ${dist.measuredRecords}`);
+          }
         }
         if (data.policyImpact?.comparison) {
           const diff = data.policyImpact.comparison.difference;
@@ -3425,14 +3441,18 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_create",
     {
       title: "Create Policy Group",
-      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Groups sharing an activationGroup must share the same activationMode / activationStrategy / executionLimit.",
+      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Policy groups that share an activationGroup form a cluster and must share the same activationMode / activationStrategy / executionLimit; executionLimit is how many of those groups run, not how many rules.",
       inputSchema: {
         name: z.string().describe("Group name (unique among non-ARCHIVED)"),
         description: z.string().optional().describe("Group description"),
         activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
-        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
-        executionLimit: z.number().int().min(1).optional().describe("Max rule executions (required when mode is MAX_N)"),
-        activationGroup: z.string().optional().describe("Activation group name")
+        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Ranking used to pick the winning groups when mode is EXCLUSIVE or MAX_N"),
+        executionLimit: z.number().int().min(1).optional().describe(
+          "How many policy groups sharing this activationGroup may run (required when mode is MAX_N). Counts groups, not rules: every rule of a winning group runs."
+        ),
+        activationGroup: z.string().optional().describe(
+          "Activation group (Execution Group) cluster key. Policy groups sharing this key compete, and group priority picks the winners."
+        )
       }
     },
     async (args) => {
@@ -3457,10 +3477,14 @@ function registerGroupTools(server, callApi) {
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
         status: z.enum(["ACTIVE", "DISABLED"]).optional().describe("Status (DISABLED = emergency stop)"),
-        activationGroup: z.string().optional().describe("Activation group (Execution Group) cluster key"),
+        activationGroup: z.string().optional().describe(
+          "Activation group (Execution Group) cluster key. Policy groups sharing this key compete, and group priority picks the winners."
+        ),
         activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
-        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Strategy"),
-        executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
+        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Ranking used to pick the winning groups"),
+        executionLimit: z.number().int().min(1).optional().describe(
+          "How many policy groups sharing this activationGroup may run. Counts groups, not rules."
+        )
       }
     },
     async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })

package/dist/mcp/register.js

@@ -58,14 +58,18 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_create",
     {
       title: "Create Policy Group",
-      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Groups sharing an activationGroup must share the same activationMode / activationStrategy / executionLimit.",
+      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Policy groups that share an activationGroup form a cluster and must share the same activationMode / activationStrategy / executionLimit; executionLimit is how many of those groups run, not how many rules.",
       inputSchema: {
         name: z.string().describe("Group name (unique among non-ARCHIVED)"),
         description: z.string().optional().describe("Group description"),
         activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
-        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
-        executionLimit: z.number().int().min(1).optional().describe("Max rule executions (required when mode is MAX_N)"),
-        activationGroup: z.string().optional().describe("Activation group name")
+        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Ranking used to pick the winning groups when mode is EXCLUSIVE or MAX_N"),
+        executionLimit: z.number().int().min(1).optional().describe(
+          "How many policy groups sharing this activationGroup may run (required when mode is MAX_N). Counts groups, not rules: every rule of a winning group runs."
+        ),
+        activationGroup: z.string().optional().describe(
+          "Activation group (Execution Group) cluster key. Policy groups sharing this key compete, and group priority picks the winners."
+        )
       }
     },
     async (args) => {
@@ -90,10 +94,14 @@ function registerGroupTools(server, callApi) {
         name: z.string().optional().describe("New name"),
         description: z.string().optional().describe("New description"),
         status: z.enum(["ACTIVE", "DISABLED"]).optional().describe("Status (DISABLED = emergency stop)"),
-        activationGroup: z.string().optional().describe("Activation group (Execution Group) cluster key"),
+        activationGroup: z.string().optional().describe(
+          "Activation group (Execution Group) cluster key. Policy groups sharing this key compete, and group priority picks the winners."
+        ),
         activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
-        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Strategy"),
-        executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
+        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Ranking used to pick the winning groups"),
+        executionLimit: z.number().int().min(1).optional().describe(
+          "How many policy groups sharing this activationGroup may run. Counts groups, not rules."
+        )
       }
     },
     async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexq/cli",
-  "version": "0.1.57",
+  "version": "0.1.59",
   "description": "LexQ CLI — manage policies, simulate rules, and deploy from the terminal. Built for humans and AI agents.",
   "type": "module",
   "bin": {

package/skills/lexq-simulation/SKILL.md

@@ -328,7 +328,15 @@ lexq analytics simulation export --id <simulationId> --as csv --output results.c
     "baselineValue": 5000000,
     "simulatedValue": 4500000,
     "delta": -500000,
-    "deltaPercentage": -10.0
+    "deltaPercentage": -10.0,
+    "distribution": {
+      "changedRecords": 8700,
+      "increasedRecords": 400,
+      "decreasedRecords": 8300,
+      "largestIncrease": 1500,
+      "largestDecrease": -2000,
+      "measuredRecords": 8300
+    }
   },
   "policyImpact": {
     "policyVersionId": "...",