@lexq/cli 0.1.46 → 0.1.48

package/dist/index.js

@@ -48,6 +48,18 @@ function getConfigPath() {
   return CONFIG_FILE;
 }
 
+// src/lib/lossless-json.ts
+import {
+  LosslessNumber,
+  isSafeNumber,
+  parse as losslessParse,
+  stringify as losslessStringify
+} from "lossless-json";
+var survivesDoubleRoundTrip = (literal) => isSafeNumber(literal);
+var parseNumber = (value) => survivesDoubleRoundTrip(value) ? parseFloat(value) : new LosslessNumber(value);
+var parseJson = (text) => losslessParse(text, void 0, parseNumber);
+var stringifyJson = (value, space) => losslessStringify(value, void 0, space);
+
 // src/lib/api-client.ts
 var ApiError = class extends Error {
   constructor(statusCode, errorCode, message) {
@@ -82,7 +94,7 @@ async function doFetch(method, path, options) {
     console.log(`  Content-Type: application/json`);
     if (options.body) {
       console.log("Body:");
-      console.log(`  ${JSON.stringify(options.body, null, 2)}`);
+      console.log(`  ${stringifyJson(options.body, 2) ?? ""}`);
     }
     console.log("\n(Use without --dry-run to execute)");
     process.exit(0);
@@ -92,7 +104,7 @@ async function doFetch(method, path, options) {
   const response = await fetch(url.toString(), {
     method,
     headers,
-    body: options.body ? JSON.stringify(options.body) : void 0
+    body: options.body ? stringifyJson(options.body) : void 0
   });
   if (options.verbose) {
     console.error(`\u2190 ${response.status} ${response.statusText} (${Date.now() - startTime}ms)`);
@@ -121,7 +133,7 @@ async function apiRequestWithMeta(method, path, options = {}) {
   if (response.status === 204 || contentType === "") {
     return { data: void 0, meta: null };
   }
-  const json = await response.json();
+  const json = parseJson(await response.text());
   assertOk(response, json);
   return { data: json.data, meta: json.meta ?? null };
 }
@@ -129,7 +141,7 @@ async function apiRequestWithMeta(method, path, options = {}) {
 // src/lib/output.ts
 import Table from "cli-table3";
 function printJson(data) {
-  console.log(JSON.stringify(data, null, 2));
+  console.log(stringifyJson(data, 2));
 }
 function printTable(headers, rows, options) {
   const table = new Table({
@@ -976,7 +988,7 @@ ${data.length} total`);
   ).action(async (opts) => {
     try {
       const globalOpts = program.opts();
-      const body = JSON.parse(opts.json);
+      const body = parseJson(opts.json);
       const { data, meta } = await apiRequestWithMeta(
         "POST",
         `policy-groups/${opts.groupId}/versions/${opts.versionId}/rules`,
@@ -1012,7 +1024,7 @@ ${data.length} total`);
   ).action(async (opts) => {
     try {
       const globalOpts = program.opts();
-      const body = JSON.parse(opts.json);
+      const body = parseJson(opts.json);
       const { data, meta } = await apiRequestWithMeta(
         "PUT",
         `policy-groups/${opts.groupId}/versions/${opts.versionId}/rules/${opts.id}`,
@@ -1938,7 +1950,7 @@ function registerAnalyticsCommands(program) {
           ])
         );
         console.log("\nExample request:");
-        console.log(JSON.stringify(data.exampleRequest, null, 2));
+        console.log(stringifyJson(data.exampleRequest, 2));
       } else {
         printJson(data);
       }
@@ -2043,10 +2055,10 @@ function registerAnalyticsCommands(program) {
             `
 \u2500\u2500 Metric: ${data.metricSummary.targetVariable} (${data.metricSummary.aggregationType}) \u2500\u2500`
           );
-          console.log(`Baseline:   ${data.metricSummary.baselineValue.toLocaleString()}`);
-          console.log(`Simulated:  ${data.metricSummary.simulatedValue.toLocaleString()}`);
+          console.log(`Baseline:   ${String(data.metricSummary.baselineValue)}`);
+          console.log(`Simulated:  ${String(data.metricSummary.simulatedValue)}`);
           console.log(
-            `Delta:      ${data.metricSummary.delta > 0 ? "+" : ""}${data.metricSummary.delta.toLocaleString()}`
+            `Delta:      ${signPrefix(data.metricSummary.delta)}${String(data.metricSummary.delta)}`
           );
           console.log(
             `Change:     ${data.metricSummary.deltaPercentage > 0 ? "+" : ""}${data.metricSummary.deltaPercentage.toFixed(1)}%`
@@ -2063,7 +2075,7 @@ function registerAnalyticsCommands(program) {
             `Rate \u0394:     ${diff.matchedRateDelta > 0 ? "+" : ""}${diff.matchedRateDelta.toFixed(1)}%`
           );
           console.log(
-            `Metric \u0394:   ${diff.metricValueDelta > 0 ? "+" : ""}${diff.metricValueDelta.toLocaleString()}`
+            `Metric \u0394:   ${signPrefix(diff.metricValueDelta)}${String(diff.metricValueDelta)}`
           );
         }
         if (data.ruleStats?.length) {
@@ -2071,11 +2083,10 @@ function registerAnalyticsCommands(program) {
           printTable(
             ["Rule", "Matched", "Metric"],
             data.ruleStats.map((r) => [
-              r.ruleName,
+              r.ruleName.length > 30 ? r.ruleName.substring(0, 30) + "\u2026" : r.ruleName,
               r.matchedCount.toLocaleString(),
-              r.metricValue.toLocaleString()
-            ]),
-            { truncate: 30 }
+              String(r.metricValue)
+            ])
           );
         }
       } else {
@@ -2186,7 +2197,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
         }
       );
       if (opts.output) {
-        const text = typeof response === "string" ? response : JSON.stringify(response, null, 2);
+        const text = typeof response === "string" ? response : stringifyJson(response, 2) ?? "";
         writeFileSync2(opts.output, text, "utf-8");
         console.log(`\u2713 Exported to ${opts.output}`);
       } else {
@@ -2306,13 +2317,19 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
     }
   });
 }
+function signPrefix(value) {
+  const text = String(value);
+  if (text.startsWith("-")) return "";
+  const significand = text.split(/[eE]/)[0] ?? "";
+  return /[1-9]/.test(significand) ? "+" : "";
+}
 function resolveBody(opts) {
   if (opts.file) {
     const raw = readFileSync2(opts.file, "utf-8");
-    return JSON.parse(raw);
+    return parseJson(raw);
   }
   if (opts.json) {
-    return JSON.parse(opts.json);
+    return parseJson(opts.json);
   }
   return {};
 }
@@ -3200,8 +3217,8 @@ function createCallApiFromConfig() {
           headers: { "X-API-KEY": config.apiKey },
           body: formData
         });
-        const data2 = await response.json();
-        return { content: [{ type: "text", text: JSON.stringify(data2, null, 2) }] };
+        const data2 = parseJson(await response.text());
+        return { content: [{ type: "text", text: stringifyJson(data2, 2) ?? "" }] };
       }
       const clientOpts = {
         apiKey: config.apiKey,
@@ -3213,7 +3230,7 @@ function createCallApiFromConfig() {
         params: opts?.params
       });
       const content = [
-        { type: "text", text: JSON.stringify(data, null, 2) }
+        { type: "text", text: stringifyJson(data, 2) ?? "" }
       ];
       const warning = formatUnregisteredFactWarning(meta);
       if (warning) content.push({ type: "text", text: warning });
@@ -3577,7 +3594,7 @@ function registerRuleTools(server, callApi) {
           subsequent actions and subsequent winning rules still run. Enforcement is the caller's
           responsibility; the decision surfaces as the is_blocked fact.
 
-        RoundingOption (optional, MUTATE_FACT only): { scale: integer (0..16), 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..34), 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).
       `,
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
@@ -3588,7 +3605,7 @@ function registerRuleTools(server, callApi) {
       }
     },
     async ({ groupId, versionId, rule }) => {
-      const body = JSON.parse(rule);
+      const body = parseJson(rule);
       return callApi("POST", `policy-groups/${groupId}/versions/${versionId}/rules`, { body });
     }
   );
@@ -3607,7 +3624,7 @@ function registerRuleTools(server, callApi) {
       }
     },
     async ({ groupId, versionId, ruleId, rule }) => {
-      const body = JSON.parse(rule);
+      const body = parseJson(rule);
       return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
         body
       });
@@ -3953,7 +3970,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ versionId, facts, includeDebugInfo }) => {
-      const parsedFacts = JSON.parse(facts);
+      const parsedFacts = parseJson(facts);
       return callApi("POST", `analytics/dry-run/versions/${versionId}`, {
         body: { facts: parsedFacts, includeDebugInfo }
       });
@@ -3977,7 +3994,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ versionIdA, versionIdB, facts }) => {
-      const parsedFacts = JSON.parse(facts);
+      const parsedFacts = parseJson(facts);
       return callApi("POST", "analytics/dry-run/compare", {
         body: { versionIdA, versionIdB, facts: parsedFacts }
       });
@@ -4032,7 +4049,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ body }) => {
-      const parsed = JSON.parse(body);
+      const parsed = parseJson(body);
       return callApi("POST", "analytics/simulations", { body: parsed });
     }
   );
@@ -4122,12 +4139,12 @@ function registerAnalyticsTools(server, callApi) {
       });
       if (!result.isError) {
         try {
-          const uploaded = JSON.parse(result.content[0]?.text ?? "{}");
+          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" + JSON.stringify({ dataset }, null, 2)
+              text: "Ready-to-use dataset block for lexq_simulation_start:\n" + stringifyJson({ dataset }, 2)
             });
           }
         } catch {

package/dist/mcp/register.d.ts

@@ -1,4 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { LosslessNumber } from 'lossless-json';
+export { LosslessNumber } from 'lossless-json';
 
 interface McpToolResult {
     [key: string]: unknown;
@@ -41,6 +43,19 @@ declare class ApiError extends Error {
     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;
+/**
+ * Serializes to JSON, writing preserved numbers back as plain number literals.
+ *
+ * Use this rather than `JSON.stringify` anywhere a value may have come from {@link parseJson}.
+ * The native one turns a preserved number into an object, which breaks both the wire format and
+ * `lexq ... --json | jq`.
+ */
+declare const stringifyJson: (value: unknown, space?: number | string) => string | undefined;
+/** Type guard for a preserved number. Check this before any generic object branch. */
+declare const isLosslessNumber: (value: unknown) => value is LosslessNumber;
+
 /**
  * Registers all MCP tools on the given server.
  *
@@ -49,4 +64,4 @@ declare class ApiError extends Error {
  */
 declare function registerAllTools(server: McpServer, callApi: CallApi): void;
 
-export { ApiError, type CallApi, type McpToolResult, formatUnregisteredFactWarning, paginationParams, registerAllTools };
+export { ApiError, type CallApi, type McpToolResult, formatUnregisteredFactWarning, isLosslessNumber, paginationParams, parseJson, registerAllTools, stringifyJson };

package/dist/mcp/register.js

@@ -172,6 +172,19 @@ import { join } from "path";
 var CONFIG_DIR = join(homedir(), ".lexq");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 
+// src/lib/lossless-json.ts
+import {
+  LosslessNumber,
+  isSafeNumber,
+  parse as losslessParse,
+  stringify as losslessStringify
+} from "lossless-json";
+var survivesDoubleRoundTrip = (literal) => isSafeNumber(literal);
+var parseNumber = (value) => survivesDoubleRoundTrip(value) ? parseFloat(value) : new LosslessNumber(value);
+var parseJson = (text) => losslessParse(text, void 0, parseNumber);
+var stringifyJson = (value, space) => losslessStringify(value, void 0, space);
+var isLosslessNumber = (value) => value instanceof LosslessNumber;
+
 // src/lib/api-client.ts
 var ApiError = class extends Error {
   constructor(statusCode, errorCode, message) {
@@ -388,7 +401,7 @@ function registerRuleTools(server, callApi) {
           subsequent actions and subsequent winning rules still run. Enforcement is the caller's
           responsibility; the decision surfaces as the is_blocked fact.
 
-        RoundingOption (optional, MUTATE_FACT only): { scale: integer (0..16), 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..34), 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).
       `,
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
@@ -399,7 +412,7 @@ function registerRuleTools(server, callApi) {
       }
     },
     async ({ groupId, versionId, rule }) => {
-      const body = JSON.parse(rule);
+      const body = parseJson(rule);
       return callApi("POST", `policy-groups/${groupId}/versions/${versionId}/rules`, { body });
     }
   );
@@ -418,7 +431,7 @@ function registerRuleTools(server, callApi) {
       }
     },
     async ({ groupId, versionId, ruleId, rule }) => {
-      const body = JSON.parse(rule);
+      const body = parseJson(rule);
       return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
         body
       });
@@ -764,7 +777,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ versionId, facts, includeDebugInfo }) => {
-      const parsedFacts = JSON.parse(facts);
+      const parsedFacts = parseJson(facts);
       return callApi("POST", `analytics/dry-run/versions/${versionId}`, {
         body: { facts: parsedFacts, includeDebugInfo }
       });
@@ -788,7 +801,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ versionIdA, versionIdB, facts }) => {
-      const parsedFacts = JSON.parse(facts);
+      const parsedFacts = parseJson(facts);
       return callApi("POST", "analytics/dry-run/compare", {
         body: { versionIdA, versionIdB, facts: parsedFacts }
       });
@@ -843,7 +856,7 @@ function registerAnalyticsTools(server, callApi) {
       }
     },
     async ({ body }) => {
-      const parsed = JSON.parse(body);
+      const parsed = parseJson(body);
       return callApi("POST", "analytics/simulations", { body: parsed });
     }
   );
@@ -933,12 +946,12 @@ function registerAnalyticsTools(server, callApi) {
       });
       if (!result.isError) {
         try {
-          const uploaded = JSON.parse(result.content[0]?.text ?? "{}");
+          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" + JSON.stringify({ dataset }, null, 2)
+              text: "Ready-to-use dataset block for lexq_simulation_start:\n" + stringifyJson({ dataset }, 2)
             });
           }
         } catch {
@@ -1383,7 +1396,11 @@ function registerAllTools(server, callApi) {
 }
 export {
   ApiError,
+  LosslessNumber,
   formatUnregisteredFactWarning,
+  isLosslessNumber,
   paginationParams,
-  registerAllTools
+  parseJson,
+  registerAllTools,
+  stringifyJson
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexq/cli",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "LexQ CLI — manage policies, simulate rules, and deploy from the terminal. Built for humans and AI agents.",
   "type": "module",
   "bin": {
@@ -30,6 +30,7 @@
     "enums": "node scripts/gen-enums.mjs",
     "enums:check": "node scripts/gen-enums.mjs --check",
     "start": "node dist/index.js",
+    "test:decimals": "pnpm build && node tests/exact-decimals.mjs",
     "prepublishOnly": "pnpm build",
     "knip": "knip",
     "format": "prettier --write \"src/**/*.ts\"",
@@ -61,6 +62,7 @@
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "dedent": "^1.7.2",
+    "lossless-json": "4.3.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {

package/skills/lexq-rules/SKILL.md

@@ -193,7 +193,7 @@ Each rule can have multiple actions. Actions fire sequentially.
 | `method`    | always   | `PERCENTAGE` \| `AMOUNT` — dictates the unit of `operand`                     |
 | `operand`   | always   | The arithmetic operand. Percent when PERCENTAGE, absolute amount when AMOUNT. |
 | `refVar`    | optional | Base for percentage calculation. Omit to use `targetVar` itself.              |
-| `rounding`  | optional | `{ scale: 0..16, mode?: HALF_UP \| ... }`. Omit for lossless full precision.  |
+| `rounding`  | optional | `{ scale: 0..34, mode?: HALF_UP \| ... }`. Omit for lossless full precision.  |
 
 **operator × method matrix**