@lexq/cli 0.1.6 → 0.1.8

package/AGENTS.md

@@ -46,7 +46,7 @@ Detailed documentation lives in the `skills/` directory. **Read the relevant ski
 6. **Copy full UUIDs from output.** Never guess or truncate IDs.
 7. **Handle errors gracefully.** Check the error code and follow the action table in `lexq-shared/SKILL.md`.
 
-## Complete Command Inventory (61 commands)
+## Complete Command Inventory (63 commands)
 
 ```
 lexq auth login|logout|whoami
@@ -59,6 +59,7 @@ lexq facts list|create|update|delete
 lexq deploy publish|live|rollback|undeploy|history|detail|overview
 lexq analytics dry-run|dry-run-compare|requirements
 lexq analytics simulation start|status|list|cancel|export
+lexq analytics dataset upload|template
 lexq history list|get|stats
 lexq integrations list|get|save|delete|config-spec
 lexq logs list|get|action|bulk-action

package/README.md

@@ -74,6 +74,7 @@ lexq facts           list | create | update | delete
 lexq deploy          publish | live | rollback | undeploy | history | detail | overview
 lexq analytics       dry-run | dry-run-compare | requirements
 lexq analytics simulation  start | status | list | cancel | export
+lexq analytics dataset     upload | template
 lexq history         list | get | stats
 lexq integrations    list | get | save | delete | config-spec
 lexq logs            list | get | action | bulk-action
@@ -156,7 +157,7 @@ Run LexQ CLI as an MCP (Model Context Protocol) server for seamless AI agent int
 lexq serve --mcp
 ```
 
-This starts a stdio MCP server exposing 53 tools — the full LexQ API — to any MCP-compatible client.
+This starts a stdio MCP server exposing 55 tools — the full LexQ API — to any MCP-compatible client.
 
 ### Claude Desktop
 

package/dist/index.js

@@ -1200,7 +1200,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
 }
 
 // src/commands/analytics.ts
-import { readFileSync as readFileSync2 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import "commander";
 function registerAnalyticsCommands(program) {
   const analytics = program.command("analytics").description("Dry run, simulation, and requirements");
@@ -1464,7 +1464,6 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
         }
       );
       if (opts.output) {
-        const { writeFileSync: writeFileSync2 } = await import("fs");
         const text = typeof response === "string" ? response : JSON.stringify(response, null, 2);
         writeFileSync2(opts.output, text, "utf-8");
         console.log(`\u2713 Exported to ${opts.output}`);
@@ -1476,6 +1475,83 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       process.exit(1);
     }
   });
+  const dataset = analytics.command("dataset").description("Upload datasets and download templates");
+  dataset.command("upload").description("Upload a CSV or JSON file as a simulation dataset").requiredOption("--file <path>", "Path to CSV or JSON file").action(async (opts) => {
+    try {
+      const globalOpts = program.opts();
+      const config = loadConfig();
+      const baseUrl = globalOpts.baseUrl ?? config.baseUrl;
+      const apiKey = globalOpts.apiKey ?? config.apiKey;
+      if (!apiKey) {
+        throw new Error('Not authenticated. Run "lexq auth login" first.');
+      }
+      const filePath = opts.file;
+      const fileBuffer = readFileSync2(filePath);
+      const fileName = filePath.split("/").pop() ?? "dataset";
+      const ext = fileName.split(".").pop()?.toLowerCase();
+      let contentType = "application/octet-stream";
+      if (ext === "csv") contentType = "text/csv";
+      else if (ext === "json") contentType = "application/json";
+      const blob = new Blob([fileBuffer], { type: contentType });
+      const formData = new FormData();
+      formData.append("file", blob, fileName);
+      const url = new URL("analytics/datasets/upload", baseUrl.endsWith("/") ? baseUrl : baseUrl + "/");
+      if (globalOpts.verbose) {
+        console.error(`\u2192 POST ${url.toString()}`);
+        console.error(`  File: ${filePath} (${fileBuffer.length} bytes)`);
+      }
+      const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: { "X-API-KEY": apiKey },
+        body: formData
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Upload failed (${response.status}): ${errorText}`);
+      }
+      const envelope = await response.json();
+      const result = envelope.data;
+      console.log(`\u2713 Dataset uploaded: ${result.path}`);
+      console.log(`  File: ${result.filename} (${result.size} bytes)`);
+      printJson(result);
+    } catch (error) {
+      printError(error);
+      process.exit(1);
+    }
+  });
+  dataset.command("template").description("Download a dataset template based on version requirements").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Policy version ID").option("--format <fmt>", "Template format: csv or json", "csv").option("--output <path>", "Output file path").action(async (opts) => {
+    try {
+      const globalOpts = program.opts();
+      const config = loadConfig();
+      const baseUrl = globalOpts.baseUrl ?? config.baseUrl;
+      const apiKey = globalOpts.apiKey ?? config.apiKey;
+      if (!apiKey) {
+        throw new Error('Not authenticated. Run "lexq auth login" first.');
+      }
+      const fmt = opts.format === "json" ? "json" : "csv";
+      const url = new URL(
+        `analytics/groups/${opts.groupId}/versions/${opts.versionId}/dataset-template`,
+        baseUrl.endsWith("/") ? baseUrl : baseUrl + "/"
+      );
+      url.searchParams.set("format", fmt);
+      const response = await fetch(url.toString(), {
+        headers: { "X-API-KEY": apiKey, Accept: "*/*" }
+      });
+      if (!response.ok) {
+        throw new Error(`Template download failed (${response.status})`);
+      }
+      const text = await response.text();
+      if (opts.output) {
+        writeFileSync2(opts.output, text, "utf-8");
+        console.log(`\u2713 Template saved to ${opts.output}`);
+      } else {
+        console.log(text);
+      }
+    } catch (error) {
+      printError(error);
+      process.exit(1);
+    }
+  });
 }
 function resolveBody(opts) {
   if (opts.file) {
@@ -1885,32 +1961,52 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/mcp/tools/_shared.ts
-function getMcpClientOptions() {
-  const config = loadConfig();
-  return {
-    apiKey: config.apiKey,
-    baseUrl: config.baseUrl
+function createCallApiFromConfig() {
+  return async (method, path, opts) => {
+    try {
+      const config = loadConfig();
+      if (opts?.upload) {
+        const url = new URL(path, config.baseUrl.endsWith("/") ? config.baseUrl : config.baseUrl + "/");
+        if (opts.params) {
+          for (const [key, value] of Object.entries(opts.params)) {
+            if (value !== void 0) url.searchParams.set(key, value);
+          }
+        }
+        if (!config.apiKey) {
+          throw new Error('Not authenticated. Run "lexq auth login" first.');
+        }
+        const blob = new Blob([opts.upload.content], { type: "text/plain" });
+        const formData = new FormData();
+        formData.append(opts.upload.fieldName, blob, opts.upload.filename);
+        const response = await fetch(url.toString(), {
+          method,
+          headers: { "X-API-KEY": config.apiKey },
+          body: formData
+        });
+        const data2 = await response.json();
+        return { content: [{ type: "text", text: JSON.stringify(data2, null, 2) }] };
+      }
+      const clientOpts = {
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl
+      };
+      const data = await apiRequest(method, path, {
+        ...clientOpts,
+        body: opts?.body,
+        params: opts?.params
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+        isError: true
+      };
+    }
   };
 }
-async function callApi(method, path, opts) {
-  try {
-    const clientOpts = getMcpClientOptions();
-    const data = await apiRequest(method, path, {
-      ...clientOpts,
-      body: opts?.body,
-      params: opts?.params
-    });
-    return {
-      content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
-    };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return {
-      content: [{ type: "text", text: JSON.stringify({ error: message }) }],
-      isError: true
-    };
-  }
-}
 function paginationParams(page, size) {
   const params = {};
   if (page !== void 0) params.page = String(page);
@@ -1919,7 +2015,7 @@ function paginationParams(page, size) {
 }
 
 // src/mcp/tools/status.ts
-function registerStatusTools(server) {
+function registerStatusTools(server, callApi) {
   server.registerTool(
     "lexq_whoami",
     {
@@ -1933,7 +2029,7 @@ function registerStatusTools(server) {
 
 // src/mcp/tools/groups.ts
 import { z } from "zod";
-function registerGroupTools(server) {
+function registerGroupTools(server, callApi) {
   server.registerTool(
     "lexq_groups_list",
     {
@@ -2068,7 +2164,7 @@ function registerGroupTools(server) {
 
 // src/mcp/tools/versions.ts
 import { z as z2 } from "zod";
-function registerVersionTools(server) {
+function registerVersionTools(server, callApi) {
   server.registerTool(
     "lexq_versions_list",
     {
@@ -2160,7 +2256,7 @@ function registerVersionTools(server) {
 
 // src/mcp/tools/rules.ts
 import { z as z3 } from "zod";
-function registerRuleTools(server) {
+function registerRuleTools(server, callApi) {
   server.registerTool(
     "lexq_rules_list",
     {
@@ -2312,7 +2408,7 @@ Types: DISCOUNT, POINT, COUPON_ISSUE, BLOCK, NOTIFICATION, WEBHOOK, SET_FACT, AD
 
 // src/mcp/tools/facts.ts
 import { z as z4 } from "zod";
-function registerFactTools(server) {
+function registerFactTools(server, callApi) {
   server.registerTool(
     "lexq_facts_list",
     {
@@ -2374,7 +2470,7 @@ function registerFactTools(server) {
 
 // src/mcp/tools/deploy.ts
 import { z as z5 } from "zod";
-function registerDeployTools(server) {
+function registerDeployTools(server, callApi) {
   server.registerTool(
     "lexq_deploy_publish",
     {
@@ -2478,7 +2574,7 @@ function registerDeployTools(server) {
 
 // src/mcp/tools/analytics.ts
 import { z as z6 } from "zod";
-function registerAnalyticsTools(server) {
+function registerAnalyticsTools(server, callApi) {
   server.registerTool(
     "lexq_dry_run",
     {
@@ -2613,11 +2709,52 @@ Example body:
       params: { format }
     })
   );
+  server.registerTool(
+    "lexq_dataset_upload",
+    {
+      title: "Upload Dataset",
+      description: `Upload inline CSV or JSON content as a simulation dataset.
+The content is uploaded to S3 and a path is returned.
+Use this path in simulation start with dataset type UPLOADED.
+
+CSV example:
+user_id,payment_amount
+user_001,150000
+user_002,50000
+
+JSON example:
+[{"user_id":"user_001","payment_amount":150000}, {"user_id":"user_002","payment_amount":50000}]`,
+      inputSchema: {
+        content: z6.string().describe("CSV or JSON content as string"),
+        filename: z6.string().default("dataset.csv").describe("Filename with extension (.csv or .json)")
+      }
+    },
+    async ({ content, filename }) => callApi("POST", "analytics/datasets/upload", {
+      upload: { content, filename, fieldName: "file" }
+    })
+  );
+  server.registerTool(
+    "lexq_dataset_template",
+    {
+      title: "Download Dataset Template",
+      description: "Generate a sample CSV or JSON template based on the required facts of a version. Use this to understand the expected data format before uploading a dataset.",
+      inputSchema: {
+        groupId: z6.string().uuid().describe("Policy group ID"),
+        versionId: z6.string().uuid().describe("Version ID"),
+        format: z6.enum(["csv", "json"]).default("csv").describe("Template format")
+      }
+    },
+    async ({ groupId, versionId, format }) => callApi(
+      "GET",
+      `analytics/groups/${groupId}/versions/${versionId}/dataset-template`,
+      { params: { format } }
+    )
+  );
 }
 
 // src/mcp/tools/history.ts
 import { z as z7 } from "zod";
-function registerHistoryTools(server) {
+function registerHistoryTools(server, callApi) {
   server.registerTool(
     "lexq_history_list",
     {
@@ -2679,7 +2816,7 @@ function registerHistoryTools(server) {
 
 // src/mcp/tools/integrations.ts
 import { z as z8 } from "zod";
-function registerIntegrationTools(server) {
+function registerIntegrationTools(server, callApi) {
   server.registerTool(
     "lexq_integrations_list",
     {
@@ -2752,7 +2889,7 @@ function registerIntegrationTools(server) {
 
 // src/mcp/tools/logs.ts
 import { z as z9 } from "zod";
-function registerLogTools(server) {
+function registerLogTools(server, callApi) {
   server.registerTool(
     "lexq_logs_list",
     {
@@ -2821,6 +2958,20 @@ function registerLogTools(server) {
   );
 }
 
+// src/mcp/register.ts
+function registerAllTools(server, callApi) {
+  registerStatusTools(server, callApi);
+  registerGroupTools(server, callApi);
+  registerVersionTools(server, callApi);
+  registerRuleTools(server, callApi);
+  registerFactTools(server, callApi);
+  registerDeployTools(server, callApi);
+  registerAnalyticsTools(server, callApi);
+  registerHistoryTools(server, callApi);
+  registerIntegrationTools(server, callApi);
+  registerLogTools(server, callApi);
+}
+
 // src/mcp/server.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 function getVersion() {
@@ -2838,16 +2989,8 @@ async function startMcpServer() {
     name: "lexq",
     version: getVersion()
   });
-  registerStatusTools(server);
-  registerGroupTools(server);
-  registerVersionTools(server);
-  registerRuleTools(server);
-  registerFactTools(server);
-  registerDeployTools(server);
-  registerAnalyticsTools(server);
-  registerHistoryTools(server);
-  registerIntegrationTools(server);
-  registerLogTools(server);
+  const callApi = createCallApiFromConfig();
+  registerAllTools(server, callApi);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }