@lexq/cli 0.1.7 → 0.1.9

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) {
@@ -1889,6 +1965,27 @@ 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
@@ -2612,6 +2709,47 @@ 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