@lexq/cli 2.0.0 → 2.1.1

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

@@ -31,9 +31,27 @@ function registerStatusTools(server, callApi) {
 import { z as z2 } from "zod";
 
 // src/types/enums.ts
+var PolicyGroupStatus = ["ACTIVE", "DISABLED", "ARCHIVED"];
+var LogicalOperator = ["AND", "OR"];
+var MutateOperator = ["ASSIGN", "ADD", "SUB", "MUL", "DIV"];
+var CalculationMethod = ["PERCENTAGE", "AMOUNT"];
+var RoundingPolicy = [
+  "UP",
+  "DOWN",
+  "CEILING",
+  "FLOOR",
+  "HALF_UP",
+  "HALF_DOWN",
+  "HALF_EVEN"
+];
 var ValueType = ["STRING", "NUMBER", "BOOLEAN", "LIST_STRING", "LIST_NUMBER"];
 var ConflictResolutionMode = ["NONE", "EXCLUSIVE", "MAX_N"];
 var ConflictResolutionStrategy = ["HIGHEST_PRIORITY"];
+var DeploymentType = ["DEPLOY", "ROLLBACK", "UNDEPLOY"];
+var ApiExecutionStatus = ["SUCCESS", "NO_MATCH", "ERROR", "TIMEOUT"];
+var ProfileCacheState = ["HIT", "MISS"];
+var SimulationStatus = ["PENDING", "RUNNING", "COMPLETED", "FAILED", "CANCELED"];
+var SimulationMetricType = ["COUNT", "SUM", "AVG"];
 var ExportFormat = ["CSV", "JSON"];
 var FailureStatus = ["PENDING", "RESOLVED", "IGNORED"];
 var FailureAction = ["IGNORE", "RESOLVE"];
@@ -47,9 +65,12 @@ var PlatformEventType = [
   "DEPLOY_SCHEDULE_CANCELED"
 ];
 var WebhookPayloadFormat = ["GENERIC", "SLACK"];
+var DeploymentScheduleStatus = ["PENDING", "EXECUTED", "CANCELED", "FAILED"];
 
 // src/types/constants.ts
 var MAX_ROUNDING_SCALE = 34;
+var MIN_TRAFFIC_RATE = 1;
+var MAX_TRAFFIC_RATE = 99;
 var REPLAY_WINDOW_MAX_RECORDS = 5e4;
 var DEFAULT_SIMULATION_RECORDS = 1e3;
 var MAX_SIMULATION_RECORDS = 1e5;
@@ -66,6 +87,10 @@ var MAX_RULES_PER_VERSION = 100;
 var MAX_CONDITIONS_PER_RULE = 25;
 var MAX_CONDITION_DEPTH = 10;
 var MAX_SNAPSHOT_BYTES = 131072;
+var STATS_DEFAULT_WINDOW_DAYS = 30;
+var STATS_MAX_WINDOW_DAYS = 31;
+var FAILURE_LOG_LOOKBACK_DAYS = 7;
+var PURGE_AFTER_DAYS = 30;
 
 // src/mcp/tools/groups.ts
 function registerGroupTools(server, callApi) {
@@ -132,7 +157,7 @@ function registerGroupTools(server, callApi) {
         groupId: z2.string().uuid().describe("Policy group ID"),
         name: z2.string().optional().describe("New name"),
         description: z2.string().optional().describe("New description"),
-        status: z2.enum(["ACTIVE", "DISABLED"]).optional().describe(
+        status: z2.enum(PolicyGroupStatus).extract(["ACTIVE", "DISABLED"]).optional().describe(
           "DISABLED stops production execution of this group: execution calls return 403 (P-009), and a composite call that includes the group is rejected in full. The deployed version and any A/B test are kept, and dry run, Impact Simulation, and Decision Replay keep working, so a fix can be verified before setting ACTIVE again. To go back to the previous version, use lexq_deploy_rollback. To take the version out of production, use lexq_deploy_undeploy."
         ),
         activationGroup: z2.string().optional().describe(
@@ -152,7 +177,7 @@ function registerGroupTools(server, callApi) {
     {
       title: "Delete Policy Group",
       annotations: { readOnlyHint: false, destructiveHint: true },
-      description: "Delete (archive) a policy group. A deployed group cannot be deleted (P-020); undeploy it first with lexq_deploy_undeploy, which also ends a running A/B test. This cannot be undone. The group no longer appears in lexq_groups_list and its name can be reused right away. Calls that change it (settings, versions, rules, starting an A/B test, publish, deploy, rollback, scheduling a deployment) return 409 P-059. If it was ever executed, deployed, or replayed, it is kept for audit; otherwise it is permanently deleted after 30 days.",
+      description: `Delete (archive) a policy group. A deployed group cannot be deleted (P-020); undeploy it first with lexq_deploy_undeploy, which also ends a running A/B test. This cannot be undone. The group no longer appears in lexq_groups_list and its name can be reused right away. Calls that change it (settings, versions, rules, starting an A/B test, publish, deploy, rollback, scheduling a deployment) return 409 P-059. If it was ever executed, deployed, or replayed, it is kept for audit; otherwise it is permanently deleted after ${PURGE_AFTER_DAYS} days.`,
       inputSchema: z2.object({
         groupId: z2.string().uuid().describe("Policy group ID")
       })
@@ -186,7 +211,9 @@ function registerGroupTools(server, callApi) {
       inputSchema: z2.object({
         groupId: z2.string().uuid().describe("Policy group ID"),
         testVersionId: z2.string().uuid().describe("Challenger version ID. Must be a published version of this group"),
-        trafficRate: z2.number().int().min(1).max(99).describe("Traffic percentage routed to challenger (1-99)")
+        trafficRate: z2.number().int().min(MIN_TRAFFIC_RATE).max(MAX_TRAFFIC_RATE).describe(
+          `Traffic percentage routed to challenger (${MIN_TRAFFIC_RATE}-${MAX_TRAFFIC_RATE})`
+        )
       })
     },
     async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test`, { body })
@@ -211,7 +238,9 @@ function registerGroupTools(server, callApi) {
       description: "Adjust traffic rate of a running A/B test.",
       inputSchema: z2.object({
         groupId: z2.string().uuid().describe("Policy group ID"),
-        trafficRate: z2.number().int().min(1).max(99).describe("New traffic percentage for challenger (1-99)")
+        trafficRate: z2.number().int().min(MIN_TRAFFIC_RATE).max(MAX_TRAFFIC_RATE).describe(
+          `New traffic percentage for challenger (${MIN_TRAFFIC_RATE}-${MAX_TRAFFIC_RATE})`
+        )
       })
     },
     async ({ groupId, ...body }) => callApi("PATCH", `policy-groups/${groupId}/ab-test/traffic-rate`, { body })
@@ -324,9 +353,6 @@ var END_DAY = `End date, ${ORG_DAY}. Inclusive: the whole day counts.`;
 var WINDOW_START_DAY = `Window start date, ${ORG_DAY}. Inclusive.`;
 var WINDOW_END_DAY = `Window end date, ${ORG_DAY}. Inclusive: the whole day counts.`;
 var INSTANT = "ISO-8601 instant with Z or an offset, e.g. 2026-10-01T00:00:00Z or 2026-10-01T09:00:00+09:00. A bare date or a time without an offset is rejected.";
-var STATS_DEFAULT_WINDOW_DAYS = 30;
-var STATS_MAX_WINDOW_DAYS = 31;
-var FAILURE_LOG_LOOKBACK_DAYS = 7;
 
 // src/mcp/tools/versions.ts
 function registerVersionTools(server, callApi) {
@@ -427,6 +453,7 @@ function registerVersionTools(server, callApi) {
 // src/mcp/tools/rules.ts
 import { z as z4 } from "zod";
 import dedent from "dedent";
+var oneOf = (values) => values.map((v) => `"${v}"`).join("|");
 function registerRuleTools(server, callApi) {
   server.registerTool(
     "lexq_rules_list",
@@ -476,8 +503,8 @@ function registerRuleTools(server, callApi) {
         After saving, lexq_facts_unregistered lists any keys this version references but has not
         defined (non-blocking, version-wide) — use it to decide what to register.
 
-        Condition: { type: "SINGLE", field, operator, value, valueType } or { type: "GROUP", operator: "AND"|"OR", children: [...] }
-        Value types: STRING, NUMBER, BOOLEAN, LIST_STRING, LIST_NUMBER
+        Condition: { type: "SINGLE", field, operator, value, valueType } or { type: "GROUP", operator: ${oneOf(LogicalOperator)}, children: [...] }
+        Value types: ${ValueType.join(", ")}
         Limits: a condition tree may hold at most ${MAX_CONDITIONS_PER_RULE} conditions (SINGLE nodes; GROUP nodes do not count)
         and nest at most ${MAX_CONDITION_DEPTH} levels below the root. A version holds at most ${MAX_RULES_PER_VERSION} rules.
 
@@ -500,7 +527,7 @@ function registerRuleTools(server, callApi) {
         Actions: [{ type, parameters }]
 
         Action parameter schemas:
-        - MUTATE_FACT: { targetVar: string, operator: "ASSIGN"|"ADD"|"SUB"|"MUL"|"DIV", method: "PERCENTAGE"|"AMOUNT", operand: number, refVar?: string, rounding?: RoundingOption }
+        - MUTATE_FACT: { targetVar: string, operator: ${oneOf(MutateOperator)}, method: ${oneOf(CalculationMethod)}, operand: number, refVar?: string, rounding?: RoundingOption }
           targetVar is the fact this action reads and writes. It must be a registered fact
           (ACT-032 otherwise), and the request must send it (P-015 otherwise). Its value must be
           a number when the action runs.
@@ -539,7 +566,7 @@ function registerRuleTools(server, callApi) {
         writes, send that value as an input fact in a second request. If a rule should run
         whenever another one does, put its actions in that rule instead.
 
-        RoundingOption (optional, MUTATE_FACT only): { scale: integer (0..${MAX_ROUNDING_SCALE}), mode?: "HALF_UP"|"HALF_DOWN"|"HALF_EVEN"|"FLOOR"|"CEILING"|"DOWN"|"UP" } mode defaults to HALF_UP. When omitted, calculator output is preserved at full precision (lossless).
+        RoundingOption (optional, MUTATE_FACT only): { scale: integer (0..${MAX_ROUNDING_SCALE}), mode?: ${oneOf(RoundingPolicy)} } mode defaults to HALF_UP. When omitted, calculator output is preserved at full precision (lossless).
       `,
       inputSchema: z4.object({
         groupId: z4.string().uuid().describe("Policy group ID"),
@@ -674,7 +701,7 @@ function registerFactTools(server, callApi) {
     {
       title: "Create Fact Definition",
       annotations: { readOnlyHint: false, destructiveHint: false },
-      description: "Register a new input variable. Key starts with a letter, then letters, numbers, and underscores (e.g. paymentAmount). Casing is not enforced. Types: STRING, NUMBER, BOOLEAN, LIST_STRING, LIST_NUMBER.",
+      description: `Register a new input variable. Key starts with a letter, then letters, numbers, and underscores (e.g. paymentAmount). Casing is not enforced. Types: ${VALUE_TYPES.join(", ")}.`,
       inputSchema: z5.object({
         key: z5.string().regex(FACT_KEY_PATTERN).describe("Variable key. Any casing; must start with a letter."),
         name: z5.string().describe("Display name"),
@@ -880,7 +907,7 @@ function registerDeployTools(server, callApi) {
     {
       title: "List Scheduled Deployments",
       annotations: { readOnlyHint: true },
-      description: "List scheduled deployments across all groups (all statuses: PENDING, EXECUTED, CANCELED, FAILED), newest first.",
+      description: `List scheduled deployments across all groups (all statuses: ${DeploymentScheduleStatus.join(", ")}), newest first.`,
       inputSchema: z6.object({
         page: z6.number().int().min(0).default(0).describe("Page number"),
         size: z6.number().int().min(1).max(100).default(20).describe("Page size")
@@ -898,7 +925,7 @@ function registerDeployTools(server, callApi) {
         page: z6.number().int().min(0).default(0).describe("Page number"),
         size: z6.number().int().min(1).max(100).default(20).describe("Page size"),
         groupId: z6.string().uuid().optional().describe("Filter by group ID"),
-        types: z6.string().optional().describe("Filter by deployment types (comma-separated: DEPLOY,ROLLBACK,UNDEPLOY)"),
+        types: z6.string().optional().describe(`Filter by deployment types (comma-separated: ${DeploymentType.join(",")})`),
         startDate: z6.string().optional().describe(START_DAY),
         endDate: z6.string().optional().describe(END_DAY)
       })
@@ -966,6 +993,13 @@ function registerDeployTools(server, callApi) {
 // src/mcp/tools/analytics.ts
 import { z as z7 } from "zod";
 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",
@@ -1054,7 +1088,7 @@ function registerAnalyticsTools(server, callApi) {
         options.baselinePolicyVersionId: uuid (optional, for baseline comparison)
         options.includeRuleStats: boolean
         options.metricConfig: optional — omit for plain execution count. To aggregate a fact, pass
-          { "targetVariable": "<fact>", "aggregationType": "COUNT" | "SUM" | "AVG" }
+          { "targetVariable": "<fact>", "aggregationType": ${SimulationMetricType.map((t) => `"${t}"`).join(" | ")} }
 
         Example (uploaded dataset):
         {
@@ -1100,7 +1134,7 @@ function registerAnalyticsTools(server, callApi) {
       inputSchema: z7.object({
         page: z7.number().int().min(0).default(0).describe("Page number"),
         size: z7.number().int().min(1).max(100).default(20).describe("Page size"),
-        status: z7.enum(["PENDING", "RUNNING", "COMPLETED", "FAILED", "CANCELED"]).optional().describe("Filter by status"),
+        status: z7.enum(SimulationStatus).optional().describe("Filter by status"),
         from: z7.string().optional().describe(START_DAY),
         to: z7.string().optional().describe(END_DAY)
       })
@@ -1152,6 +1186,10 @@ function registerAnalyticsTools(server, callApi) {
         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
@@ -1171,13 +1209,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 {
         }
       }
@@ -1204,6 +1237,15 @@ function registerAnalyticsTools(server, callApi) {
 
 // src/mcp/tools/profile.ts
 import { z as z8 } from "zod";
+
+// src/lib/percentiles.ts
+var PERCENTILE_MIN_N = {
+  p50: TAIL_MIN_OBS * 2,
+  p95: TAIL_MIN_OBS * 20,
+  p99: TAIL_MIN_OBS * 100
+};
+
+// src/mcp/tools/profile.ts
 var RELATIVE_THRESHOLD = `flagged = p50 \u2265 ${SLOW_MULTIPLIER}\xD7 median of per-rule p50s within the group; absolute thresholds are intentionally not supported.`;
 function profileParams(opts) {
   const params = {};
@@ -1219,7 +1261,7 @@ function registerProfileTools(server, callApi) {
     {
       title: "Group Latency Profile",
       annotations: { readOnlyHint: true },
-      description: "Per-rule latency profile of a policy group over a time window: group TOTAL distribution split by cache state (HIT = compiled ruleset cache hit, MISS = deep-load + compile), a per-rule CONDITION/ACTION percentile table, and slow-rule flags. " + RELATIVE_THRESHOLD + ` Every percentile is accompanied by its sample count n; a percentile is withheld (null) unless n\xD7(1\u2212q) \u2265 ${TAIL_MIN_OBS} (p50 needs n \u2265 6, p95 n \u2265 60, p99 n \u2265 300 \u2014 display gate, separate from the n \u2265 ${MIN_SAMPLES} judgment gate). Baselines report INSUFFICIENT_COHORT when fewer than ${MIN_COHORT_SIZE} rules qualify. Rule detail comes from a deterministic ${PROFILE_SAMPLE_PERMILLE / 10}% sample of calls; TOTAL is recorded for every call. Defaults: last ${PROFILE_DEFAULT_WINDOW_HOURS}h, live version, cacheState HIT.`,
+      description: "Per-rule latency profile of a policy group over a time window: group TOTAL distribution split by cache state (HIT = compiled ruleset cache hit, MISS = deep-load + compile), a per-rule CONDITION/ACTION percentile table, and slow-rule flags. " + RELATIVE_THRESHOLD + ` Every percentile is accompanied by its sample count n; a percentile is withheld (null) unless n\xD7(1\u2212q) \u2265 ${TAIL_MIN_OBS} (p50 needs n \u2265 ${PERCENTILE_MIN_N.p50}, p95 n \u2265 ${PERCENTILE_MIN_N.p95}, p99 n \u2265 ${PERCENTILE_MIN_N.p99} \u2014 display gate, separate from the n \u2265 ${MIN_SAMPLES} judgment gate). Baselines report INSUFFICIENT_COHORT when fewer than ${MIN_COHORT_SIZE} rules qualify. Rule detail comes from a deterministic ${PROFILE_SAMPLE_PERMILLE / 10}% sample of calls; TOTAL is recorded for every call. Defaults: last ${PROFILE_DEFAULT_WINDOW_HOURS}h, live version, cacheState HIT.`,
       inputSchema: z8.object({
         groupId: z8.string().uuid().describe("Policy group ID"),
         versionId: z8.string().uuid().optional().describe("Version to inspect (default: live version)"),
@@ -1227,7 +1269,7 @@ function registerProfileTools(server, callApi) {
           `Window start, ISO-8601 instant (e.g. 2026-07-01T00:00:00Z). Default: ${PROFILE_DEFAULT_WINDOW_HOURS}h ago`
         ),
         to: z8.string().optional().describe("Window end, ISO-8601 instant. Default: now"),
-        cacheState: z8.enum(["HIT", "MISS"]).optional().describe("Cache dimension for the rule table and judgment (default: HIT)")
+        cacheState: z8.enum(ProfileCacheState).optional().describe("Cache dimension for the rule table and judgment (default: HIT)")
       })
     },
     async ({ groupId, versionId, from, to, cacheState }) => callApi("GET", `policy-groups/${groupId}/profile`, {
@@ -1239,7 +1281,7 @@ function registerProfileTools(server, callApi) {
     {
       title: "Rule Latency Detail",
       annotations: { readOnlyHint: true },
-      description: `Single-rule latency detail: merged phase \xD7 cacheState distributions plus a per-window time series (${LATENCY_WINDOW_MILLIS / 1e3}s windows). Missing windows are genuine gaps \u2014 never interpolated. Series points carry each window's own values; percentiles in merged distributions are withheld (null) unless n\xD7(1\u2212q) \u2265 ${TAIL_MIN_OBS} (p50 n \u2265 6, p95 n \u2265 60, p99 n \u2265 300). ` + RELATIVE_THRESHOLD,
+      description: `Single-rule latency detail: merged phase \xD7 cacheState distributions plus a per-window time series (${LATENCY_WINDOW_MILLIS / 1e3}s windows). Missing windows are genuine gaps \u2014 never interpolated. Series points carry each window's own values; percentiles in merged distributions are withheld (null) unless n\xD7(1\u2212q) \u2265 ${TAIL_MIN_OBS} (p50 n \u2265 ${PERCENTILE_MIN_N.p50}, p95 n \u2265 ${PERCENTILE_MIN_N.p95}, p99 n \u2265 ${PERCENTILE_MIN_N.p99}). ` + RELATIVE_THRESHOLD,
       inputSchema: z8.object({
         groupId: z8.string().uuid().describe("Policy group ID"),
         ruleId: z8.string().uuid().describe("Rule ID (from lexq_profile_overview)"),
@@ -1356,7 +1398,7 @@ function registerHistoryTools(server, callApi) {
         traceId: z10.string().optional().describe("Filter by trace ID"),
         groupId: z10.string().uuid().optional().describe("Filter by policy group"),
         versionId: z10.string().uuid().optional().describe("Filter by version"),
-        status: z10.enum(["SUCCESS", "NO_MATCH", "ERROR", "TIMEOUT"]).optional().describe("Filter by execution status"),
+        status: z10.enum(ApiExecutionStatus).optional().describe("Filter by execution status"),
         startDate: z10.string().optional().describe(START_DAY),
         endDate: z10.string().optional().describe(END_DAY)
       })
@@ -1451,6 +1493,17 @@ function registerProvenanceTools(server, callApi) {
 
 // src/mcp/tools/logs.ts
 import { z as z12 } from "zod";
+
+// src/lib/enum-notes.ts
+function withNotes(notes) {
+  return Object.entries(notes).map(([value, note]) => note ? `${value} (${note})` : value);
+}
+
+// src/mcp/tools/logs.ts
+var ACTION_NOTES = {
+  RESOLVE: "mark as manually fixed",
+  IGNORE: "skip intentionally"
+};
 function registerLogTools(server, callApi) {
   server.registerTool(
     "lexq_logs_list",
@@ -1495,7 +1548,7 @@ function registerLogTools(server, callApi) {
     {
       title: "Process Failure Log",
       annotations: { readOnlyHint: false, destructiveHint: false },
-      description: "Process a single failure log: RESOLVE (mark as manually fixed) or IGNORE (skip intentionally).",
+      description: `Process a single failure log: ${withNotes(ACTION_NOTES).join(" or ")}.`,
       inputSchema: z12.object({
         logId: z12.string().uuid().describe("Failure log ID"),
         action: z12.enum(FailureAction).describe("Action to take")
@@ -1524,6 +1577,10 @@ function registerLogTools(server, callApi) {
 
 // src/mcp/tools/webhook-subscriptions.ts
 import { z as z13 } from "zod";
+var FORMAT_NOTES = {
+  GENERIC: "full JSON",
+  SLACK: '{"text": "..."}'
+};
 function registerWebhookSubscriptionTools(server, callApi) {
   server.registerTool(
     "lexq_webhook_subscriptions_list",
@@ -1558,7 +1615,7 @@ function registerWebhookSubscriptionTools(server, callApi) {
     {
       title: "Save Webhook Subscription",
       annotations: { readOnlyHint: false, destructiveHint: true },
-      description: `Create or update a webhook subscription. Omit id to create, provide id to update. Events: ${PlatformEventType.join(", ")}. Formats: GENERIC (full JSON), SLACK ({"text": "..."}).`,
+      description: `Create or update a webhook subscription. Omit id to create, provide id to update. Events: ${PlatformEventType.join(", ")}. Formats: ${withNotes(FORMAT_NOTES).join(", ")}.`,
       inputSchema: z13.object({
         id: z13.string().uuid().optional().describe("Subscription ID (omit to create, provide to update)"),
         name: z13.string().min(1).describe("Subscription name (unique per tenant)"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexq/cli",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "mcpName": "io.lexq/lexq",
   "description": "The Decision Operations Platform for engineering teams",
   "type": "module",
@@ -45,6 +45,7 @@
     "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\"",
@@ -76,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-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