@lexq/cli 1.1.7 → 2.1.0

package/dist/mcp/register.d.ts

@@ -2,6 +2,12 @@ import { Implementation, McpServer } from '@modelcontextprotocol/server';
 import { LosslessNumber } from 'lossless-json';
 export { LosslessNumber } from 'lossless-json';
 
+declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string | null;
+    constructor(statusCode: number, errorCode: string | null, message: string);
+}
+
 interface McpToolResult {
     [key: string]: unknown;
     content: Array<{
@@ -61,12 +67,6 @@ declare function formatUnregisteredFactWarning(meta: unknown): string | null;
  */
 declare function formatValueDomainMismatchWarning(meta: unknown): string | null;
 
-declare class ApiError extends Error {
-    readonly statusCode: number;
-    readonly errorCode: string | null;
-    constructor(statusCode: number, errorCode: string | null, message: string);
-}
-
 /** Parses JSON text without rounding numbers that a double cannot hold. */
 declare const parseJson: (text: string) => unknown;
 /**

package/dist/mcp/register.js

@@ -84,7 +84,7 @@ function registerGroupTools(server, callApi) {
     {
       title: "Get Policy Group",
       annotations: { readOnlyHint: true },
-      description: "Get a single policy group by ID.",
+      description: "Get a single policy group by ID. Its currentVersionId and currentDeploymentId are what lexq_deploy_rollback expects, and previousVersionName is the version a rollback restores.",
       inputSchema: z2.object({
         groupId: z2.string().uuid().describe("Policy group ID")
       })
@@ -778,6 +778,7 @@ function registerFactTools(server, callApi) {
 }
 
 // src/mcp/tools/deploy.ts
+import dedent2 from "dedent";
 import { z as z6 } from "zod";
 function registerDeployTools(server, callApi) {
   server.registerTool(
@@ -815,14 +816,20 @@ function registerDeployTools(server, callApi) {
     {
       title: "Rollback Deployment",
       annotations: { readOnlyHint: false, destructiveHint: true },
-      description: "Rollback to the previous deployed version. Only available if there is a previous version that is still ACTIVE and whose effective end has not passed (P-058).",
+      description: dedent2`
+        Roll the group back to the version that was live before the current one. Call lexq_groups_get first: currentVersionName is live now, previousVersionName is what a rollback restores, and a rollback is rejected while canRollback is false. A rollback needs a previous version that is still ACTIVE and whose effective end has not passed (P-058).
+
+        Pass the currentVersionId and currentDeploymentId from that call as expectedCurrentVersionId and expectedCurrentDeploymentId. If anyone deployed, rolled back or undeployed in between, the rollback is rejected with 409 and nothing changes: P-062 if another version or no version is live, P-063 if the same version is live but from a newer deployment. Read the group again and check with the user before retrying.
+      `,
       inputSchema: z6.object({
         groupId: z6.string().uuid().describe("Policy group ID"),
+        expectedCurrentVersionId: z6.string().uuid().describe("currentVersionId from your last read of the group"),
+        expectedCurrentDeploymentId: z6.string().uuid().describe("currentDeploymentId from your last read of the group"),
         memo: z6.string().min(1).describe("Rollback reason (required)")
       })
     },
-    async ({ groupId, memo }) => callApi("POST", `policy-groups/${groupId}/rollback`, {
-      body: { memo }
+    async ({ groupId, expectedCurrentVersionId, expectedCurrentDeploymentId, memo }) => callApi("POST", `policy-groups/${groupId}/rollback`, {
+      body: { memo, expectedCurrentVersionId, expectedCurrentDeploymentId }
     })
   );
   server.registerTool(
@@ -922,7 +929,7 @@ function registerDeployTools(server, callApi) {
     {
       title: "Deployment Overview",
       annotations: { readOnlyHint: true },
-      description: "Show current deployment status of all groups \u2014 which version is live, last deployment type, and deployer.",
+      description: "Show current deployment status of all groups \u2014 which version is live, last deployment type, and deployer. Each group also carries currentDeploymentId, previousVersionName (the version a rollback restores) and canRollback, as in lexq_groups_get.",
       inputSchema: z6.object({})
     },
     async () => callApi("GET", "deployments/overview")
@@ -958,14 +965,21 @@ function registerDeployTools(server, callApi) {
 
 // src/mcp/tools/analytics.ts
 import { z as z7 } from "zod";
-import dedent2 from "dedent";
+import dedent3 from "dedent";
+function datasetBlock(path) {
+  const dataset = { type: "UPLOADED", source: "S3_BUCKET", path };
+  return {
+    type: "text",
+    text: "Ready-to-use dataset block for lexq_simulation_start:\n" + stringifyJson({ dataset }, 2)
+  };
+}
 function registerAnalyticsTools(server, callApi) {
   server.registerTool(
     "lexq_dry_run",
     {
       title: "Dry Run",
       annotations: { readOnlyHint: true },
-      description: dedent2`
+      description: dedent3`
         Execute a single dry run against a version. Tests how rules evaluate given input facts without side effects.
         
         Returns:
@@ -995,7 +1009,7 @@ function registerAnalyticsTools(server, callApi) {
     {
       title: "Dry Run Compare",
       annotations: { readOnlyHint: true },
-      description: dedent2`
+      description: dedent3`
         Compare dry run results between two versions using the same input facts. Useful for validating changes.
         
         Returns:
@@ -1033,7 +1047,7 @@ function registerAnalyticsTools(server, callApi) {
     {
       title: "Start Simulation",
       annotations: { readOnlyHint: false, destructiveHint: false },
-      description: dedent2`
+      description: dedent3`
         Start an Impact Simulation against historical, uploaded, or inline data.
 
         dataset.type and dataset.source are BOTH required, and must be paired:
@@ -1138,13 +1152,17 @@ function registerAnalyticsTools(server, callApi) {
     {
       title: "Upload Dataset",
       annotations: { readOnlyHint: false, destructiveHint: false },
-      description: dedent2`
+      description: dedent3`
         Upload inline CSV or JSON content as a simulation dataset.
         The content is uploaded to S3 and a path is returned in the "path" field.
 
         To use the returned path in lexq_simulation_start, set:
           dataset: { "type": "UPLOADED", "source": "S3_BUCKET", "path": "<returned path>" }
 
+        The content travels inside the tool call, so this suits small datasets, and the hosted server at
+        mcp.lexq.io limits the size of a request. For a larger file, use lexq_dataset_upload_file on the
+        local server (lexq serve --mcp), or upload it with the CLI or the console and pass the returned path.
+
         CSV example:
         userId,paymentAmount
         user_001,150000
@@ -1164,13 +1182,8 @@ function registerAnalyticsTools(server, callApi) {
       if (!result.isError) {
         try {
           const uploaded = parseJson(result.content[0]?.text ?? "{}");
-          if (uploaded.path) {
-            const dataset = { type: "UPLOADED", source: "S3_BUCKET", path: uploaded.path };
-            result.content.push({
-              type: "text",
-              text: "Ready-to-use dataset block for lexq_simulation_start:\n" + stringifyJson({ dataset }, 2)
-            });
-          }
+          const path = uploaded.data?.path ?? uploaded.path;
+          if (typeof path === "string" && path) result.content.push(datasetBlock(path));
         } catch {
         }
       }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@lexq/cli",
-  "version": "1.1.7",
+  "version": "2.1.0",
   "mcpName": "io.lexq/lexq",
-  "description": "LexQ CLI — manage policies, simulate rules, and deploy from the terminal. Built for humans and AI agents.",
+  "description": "The Decision Operations Platform for engineering teams",
   "type": "module",
   "bin": {
     "lexq": "./dist/index.js"
@@ -44,6 +44,8 @@
     "test:command-options": "node tests/command-options.mjs",
     "test:value-domain": "pnpm build && node tests/value-domain.mjs",
     "test:fact-update": "pnpm build && node tests/fact-update.mjs",
+    "test:rollback": "pnpm build && node tests/rollback.mjs",
+    "test:dataset-upload": "pnpm build && node tests/dataset-upload.mjs",
     "prepublishOnly": "pnpm build",
     "knip": "knip",
     "format": "prettier --write \"src/**/*.ts\"",
@@ -57,7 +59,11 @@
     "ai-agent",
     "agent-skills",
     "simulation",
-    "business-rules"
+    "business-rules",
+    "developer-tools",
+    "decision-management",
+    "mcp",
+    "mcp-server"
   ],
   "author": "LexQ, LLC",
   "license": "Apache-2.0",
@@ -71,16 +77,16 @@
   },
   "packageManager": "pnpm@10.28.0",
   "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.3.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "dedent": "^1.7.2",
     "lossless-json": "4.3.1",
-    "zod": "^4.5.4"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@eslint/js": "^9.20.0",
-    "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/client": "^2.3.1",
     "@types/node": "^22.12.0",
     "eslint": "^10.2.0",
     "knip": "^6.29.0",

package/skills/lexq-recipes/SKILL.md

@@ -352,17 +352,24 @@ lexq rules create --group-id <gid> --version-id <vid> --json '{
 **Goal:** Something went wrong in production — revert to the previous version.
 
 ```bash
-# 1. Check current state
-lexq deploy overview
+# 1. Read the group: currentVersionName is live now, previousVersionName is what a
+#    rollback restores, and a rollback is rejected while canRollback is false
+lexq groups get --id <gid>
 
-# 2. Rollback
-lexq deploy rollback --group-id <gid> --memo "Reverting due to increased error rate"
+# 2. Roll back with the IDs from step 1
+lexq deploy rollback --group-id <gid> --memo "Reverting due to increased error rate" \
+  --expected-current-version-id <currentVersionId> \
+  --expected-current-deployment-id <currentDeploymentId>
 
 # 3. Verify
 lexq deploy overview
 lexq history stats
 ```
 
+If anyone deployed, rolled back or undeployed after step 1, step 2 is rejected with `409` and
+nothing changes: `P-062` if another version or no version is live, `P-063` if the same version is
+live but from a newer deployment. Start again from step 1.
+
 ---
 
 ## Recipe 7: Monitoring + Failure Triage

package/skills/lexq-simulation/SKILL.md

@@ -280,6 +280,11 @@ lexq analytics simulation start --json '{
 **CSV format:** Header row with fact keys, data rows with values. Types auto-detected.
 **JSON format:** Array of objects `[{"key": "value"}, ...]`
 
+Dataset files can be up to 10 MB. Over MCP, the local server (`lexq serve --mcp`) has
+`lexq_dataset_upload_file`, which takes the absolute path of a `.csv` or `.json` file and reads it from
+disk. The hosted server has only `lexq_dataset_upload`, which takes the content inline and suits small
+datasets. For a larger file there, upload it with the command above and pass the returned `path`.
+
 ### Check Status (Poll)
 
 ```bash