@lexq/cli 0.1.14 → 0.1.15

package/dist/index.js

@@ -910,7 +910,7 @@ function buildUpdateBody2(opts) {
 import "commander";
 function registerDeployCommands(program) {
   const deploy = program.command("deploy").description("Deployment lifecycle and history");
-  deploy.command("publish").description("Publish a DRAFT version (DRAFT \u2192 ACTIVE)").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Version ID to publish").option("--memo <memo>", "Deployment memo").action(async (opts) => {
+  deploy.command("publish").description("Publish a DRAFT version (DRAFT \u2192 ACTIVE)").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Version ID to publish").requiredOption("--memo <memo>", "Publish Deployment memo").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       await apiRequest(
@@ -921,7 +921,7 @@ function registerDeployCommands(program) {
           baseUrl: globalOpts.baseUrl,
           dryRun: globalOpts.dryRun,
           verbose: globalOpts.verbose,
-          body: { memo: opts.memo ?? "" }
+          body: { memo: opts.memo }
         }
       );
       console.log(`\u2713 Version ${opts.versionId} published.`);
@@ -930,7 +930,7 @@ function registerDeployCommands(program) {
       process.exit(1);
     }
   });
-  deploy.command("live").description("Deploy an ACTIVE version to live traffic").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Version ID to deploy").option("--memo <memo>", "Deployment memo").action(async (opts) => {
+  deploy.command("live").description("Deploy an ACTIVE version to live traffic").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Version ID to deploy").requiredOption("--memo <memo>", "Live Deployment memo").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       await apiRequest("POST", `policy-groups/${opts.groupId}/deploy`, {
@@ -938,7 +938,7 @@ function registerDeployCommands(program) {
         baseUrl: globalOpts.baseUrl,
         dryRun: globalOpts.dryRun,
         verbose: globalOpts.verbose,
-        body: { versionId: opts.versionId, memo: opts.memo ?? "" }
+        body: { versionId: opts.versionId, memo: opts.memo }
       });
       console.log(`\u2713 Version ${opts.versionId} deployed to live.`);
     } catch (error) {
@@ -946,7 +946,7 @@ function registerDeployCommands(program) {
       process.exit(1);
     }
   });
-  deploy.command("rollback").description("Rollback to the previous deployed version").requiredOption("--group-id <groupId>", "Policy group ID").option("--memo <memo>", "Rollback reason").option("--force", "Skip confirmation prompt").action(async (opts) => {
+  deploy.command("rollback").description("Rollback to the previous deployed version").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--memo <memo>", "Rollback reason").option("--force", "Skip confirmation prompt").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       if (!opts.force) {
@@ -964,7 +964,7 @@ function registerDeployCommands(program) {
         baseUrl: globalOpts.baseUrl,
         dryRun: globalOpts.dryRun,
         verbose: globalOpts.verbose,
-        body: { memo: opts.memo ?? "" }
+        body: { memo: opts.memo }
       });
       console.log(`\u2713 Group ${opts.groupId} rolled back.`);
     } catch (error) {
@@ -972,7 +972,7 @@ function registerDeployCommands(program) {
       process.exit(1);
     }
   });
-  deploy.command("undeploy").description("Remove the live version from a group").requiredOption("--group-id <groupId>", "Policy group ID").option("--memo <memo>", "Undeploy reason").option("--force", "Skip confirmation prompt").action(async (opts) => {
+  deploy.command("undeploy").description("Remove the live version from a group").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--memo <memo>", "Undeploy reason").option("--force", "Skip confirmation prompt").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       if (!opts.force) {
@@ -990,7 +990,7 @@ function registerDeployCommands(program) {
         baseUrl: globalOpts.baseUrl,
         dryRun: globalOpts.dryRun,
         verbose: globalOpts.verbose,
-        body: { memo: opts.memo ?? "" }
+        body: { memo: opts.memo }
       });
       console.log(`\u2713 Group ${opts.groupId} undeployed.`);
     } catch (error) {
@@ -1553,7 +1553,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       process.exit(1);
     }
   });
-  history.command("get").description("Get execution detail").requiredOption("--id <executionId>", "Execution history ID").action(async (opts) => {
+  history.command("get").description("Get execution detail").requiredOption("--id <traceId>", "Trace ID").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       const data = await apiRequest(
@@ -1973,10 +1973,10 @@ function registerGroupTools(server, callApi) {
         name: z.string().describe("Group name (unique among non-ARCHIVED)"),
         priority: z.number().int().min(0).describe("Execution priority (lower = higher)"),
         description: z.string().optional().describe("Group description"),
-        conflictResolutionMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
-        conflictResolutionStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
-        maxSelections: z.number().int().min(1).optional().describe("Max selections (required when mode is MAX_N)"),
-        activationGroupId: z.string().uuid().optional().describe("Activation group ID")
+        activationMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
+        executionLimit: z.number().int().min(1).optional().describe("Max rule executions (required when mode is MAX_N)"),
+        activationGroup: z.string().optional().describe("Activation group name")
       }
     },
     async (args) => {
@@ -1985,12 +1985,10 @@ function registerGroupTools(server, callApi) {
         priority: args.priority
       };
       if (args.description !== void 0) body.description = args.description;
-      if (args.conflictResolutionMode !== void 0)
-        body.conflictResolutionMode = args.conflictResolutionMode;
-      if (args.conflictResolutionStrategy !== void 0)
-        body.conflictResolutionStrategy = args.conflictResolutionStrategy;
-      if (args.maxSelections !== void 0) body.maxSelections = args.maxSelections;
-      if (args.activationGroupId !== void 0) body.activationGroupId = args.activationGroupId;
+      if (args.activationMode !== void 0) body.activationMode = args.activationMode;
+      if (args.activationStrategy !== void 0) body.activationStrategy = args.activationStrategy;
+      if (args.executionLimit !== void 0) body.executionLimit = args.executionLimit;
+      if (args.activationGroup !== void 0) body.activationGroup = args.activationGroup;
       return callApi("POST", "policy-groups", { body });
     }
   );
@@ -1998,16 +1996,16 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_update",
     {
       title: "Update Policy Group",
-      description: "Update an existing policy group. Only provided fields are updated.",
+      description: "Update a policy group. This is a full replacement \u2014 omitted optional fields will be set to null on the server.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
         name: z.string().optional().describe("New name"),
         priority: z.number().int().min(0).optional().describe("New priority"),
         description: z.string().optional().describe("New description"),
         status: z.enum(["ACTIVE", "DISABLED"]).optional().describe("Status (DISABLED = emergency stop)"),
-        conflictResolutionMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
-        conflictResolutionStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy"),
-        maxSelections: z.number().int().min(1).optional().describe("Max selections")
+        activationMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy"),
+        executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
       }
     },
     async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })
@@ -2186,17 +2184,21 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_create",
     {
       title: "Create Rule",
-      description: `Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array. 
+      description: `Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array.
+
+      Note: Rules can reference fact keys that are not yet registered in Fact Definitions. The engine allows this for flexibility. However, registering facts via lexq_facts_create is recommended \u2014 it enables type validation, the Console UI autocomplete, and the dry-run requirements analyzer.
+
       Condition: { type: "SINGLE", field, operator, value, valueType } or { type: "GROUP", operator: "AND"|"OR", children: [...] }
-      Operators: EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, CONTAINS, IN, NOT_IN 
+      Operators: EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, CONTAINS, IN, NOT_IN
       Value types: STRING, NUMBER, BOOLEAN, LIST_STRING, LIST_NUMBER
-      
+
       Actions: [{ type, parameters }]
-      
+
       Action parameter schemas:
       - DISCOUNT: { refVar: string, method: "PERCENTAGE"|"AMOUNT", rate?: number (when PERCENTAGE), value?: number (when AMOUNT) }
       - POINT: { refVar: string, targetVar: string, method: "PERCENTAGE"|"AMOUNT", rate?: number (when PERCENTAGE), value?: number (when AMOUNT), integrationId: uuid }
-      - COUPON_ISSUE: { couponId: string, integrationId: uuid }- BLOCK: { reason: string }
+      - COUPON_ISSUE: { couponId: string, integrationId: uuid }
+      - BLOCK: { reason: string }
       - NOTIFICATION: { channel: "SMS"|"EMAIL"|"PUSH"|"KAKAO", targetVar: string, templateId: string, integrationId: uuid }
       - WEBHOOK: { url: string, method: "POST" }
       - SET_FACT: { key: string, value: string|number|boolean }
@@ -2367,7 +2369,7 @@ function registerDeployTools(server, callApi) {
       inputSchema: {
         groupId: z5.string().uuid().describe("Policy group ID"),
         versionId: z5.string().uuid().describe("Version ID to publish"),
-        memo: z5.string().default("").describe("Deployment memo")
+        memo: z5.string().min(1).describe("Publish Deployment memo (required)")
       }
     },
     async ({ groupId, versionId, memo }) => callApi("POST", `policy-groups/${groupId}/versions/${versionId}/publish`, { body: { memo } })
@@ -2380,7 +2382,7 @@ function registerDeployTools(server, callApi) {
       inputSchema: {
         groupId: z5.string().uuid().describe("Policy group ID"),
         versionId: z5.string().uuid().describe("Version ID to deploy"),
-        memo: z5.string().default("").describe("Deployment memo")
+        memo: z5.string().min(1).describe("Live Deployment memo (required)")
       }
     },
     async ({ groupId, versionId, memo }) => callApi("POST", `policy-groups/${groupId}/deploy`, {
@@ -2464,10 +2466,8 @@ function registerAnalyticsTools(server, callApi) {
     {
       title: "Dry Run",
       description: `Execute a single dry run against a version. Tests how rules evaluate given input facts without side effects.
-
-Example input: { "facts": { "payment_amount": 100000, "customer_tier": "VIP" } }
-
-Always dry-run before publishing to validate rule behavior.`,
+      Example input: { "facts": { "payment_amount": 100000, "customer_tier": "VIP" } }
+      Always dry-run before publishing to validate rule behavior.`,
       inputSchema: {
         versionId: z6.string().uuid().describe("Policy version ID to test against"),
         facts: z6.string().describe('JSON string of facts object, e.g. {"payment_amount":100000}'),
@@ -2516,14 +2516,21 @@ Always dry-run before publishing to validate rule behavior.`,
     "lexq_simulation_start",
     {
       title: "Start Simulation",
-      description: `Start a batch simulation against historical execution data.
-
-Example body:
-{
-  "policyVersionId": "<uuid>",
-  "dataset": { "type": "HISTORICAL", "source": "EXECUTION_LOGS", "from": "2025-01-01", "to": "2025-01-31" },
-  "options": { "baselinePolicyVersionId": "<uuid>", "includeRuleStats": true, "maxRecords": 10000 }
-}`,
+      description: `Start a batch simulation against historical or uploaded data.
+      
+      dataset.type: "HISTORICAL" or "UPLOADED"
+      dataset.source (when HISTORICAL): "EXECUTION_LOGS"
+      dataset.from / dataset.to: date range (yyyy-MM-dd, when HISTORICAL)
+      options.maxRecords: number (max 100000, default 10000)
+      options.baselinePolicyVersionId: uuid (optional, for comparison)
+      options.includeRuleStats: boolean
+      
+      Example body:
+      {
+        "policyVersionId": "<uuid>",
+        "dataset": { "type": "HISTORICAL", "source": "EXECUTION_LOGS", "from": "2025-01-01", "to": "2025-01-31" },
+        "options": { "baselinePolicyVersionId": "<uuid>", "includeRuleStats": true, "maxRecords": 10000 }
+      }`,
       inputSchema: {
         body: z6.string().describe("JSON string of SimulationRequest")
       }
@@ -2595,16 +2602,15 @@ Example body:
     {
       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}]`,
+      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)")
@@ -2667,10 +2673,10 @@ function registerHistoryTools(server, callApi) {
       title: "Get Execution Detail",
       description: "Get full execution detail including request facts, result traces, and decision traces.",
       inputSchema: {
-        executionId: z7.string().uuid().describe("Execution history ID")
+        traceId: z7.string().describe("Trace ID from execution history")
       }
     },
-    async ({ executionId }) => callApi("GET", `execution/history/${executionId}`)
+    async ({ traceId }) => callApi("GET", `execution/history/${traceId}`)
   );
   server.registerTool(
     "lexq_history_stats",
@@ -2728,19 +2734,20 @@ function registerIntegrationTools(server, callApi) {
     "lexq_integrations_save",
     {
       title: "Save Integration",
-      description: "Create or update an integration. Types: COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK.",
+      description: "Create or update an integration. Provide id to update an existing one; omit id to create new. Types: COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK.",
       inputSchema: {
+        id: z8.string().uuid().optional().describe("Integration ID (omit to create, provide to update)"),
         type: z8.enum(["COUPON", "POINT", "NOTIFICATION", "CRM", "MESSENGER", "WEBHOOK"]).describe("Integration type"),
         name: z8.string().describe("Integration name"),
         baseUrl: z8.string().describe("Base URL of the external service"),
-        apiKey: z8.string().optional().describe("API key or token for the service"),
-        isActive: z8.boolean().default(true).describe("Whether the integration is active"),
-        config: z8.string().optional().describe("JSON string of additional config key-value pairs")
+        credential: z8.string().optional().describe("API key or token for the service"),
+        additionalConfig: z8.string().optional().describe("JSON string of additional config key-value pairs"),
+        isActive: z8.boolean().default(true).describe("Whether the integration is active")
       }
     },
-    async ({ config, ...rest }) => {
+    async ({ additionalConfig, ...rest }) => {
       const body = { ...rest };
-      if (config) body.config = JSON.parse(config);
+      if (additionalConfig) body.additionalConfig = JSON.parse(additionalConfig);
       return callApi("POST", "integrations", { body });
     }
   );

package/dist/mcp/register.js

@@ -66,10 +66,10 @@ function registerGroupTools(server, callApi) {
         name: z.string().describe("Group name (unique among non-ARCHIVED)"),
         priority: z.number().int().min(0).describe("Execution priority (lower = higher)"),
         description: z.string().optional().describe("Group description"),
-        conflictResolutionMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
-        conflictResolutionStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
-        maxSelections: z.number().int().min(1).optional().describe("Max selections (required when mode is MAX_N)"),
-        activationGroupId: z.string().uuid().optional().describe("Activation group ID")
+        activationMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy when mode is EXCLUSIVE or MAX_N"),
+        executionLimit: z.number().int().min(1).optional().describe("Max rule executions (required when mode is MAX_N)"),
+        activationGroup: z.string().optional().describe("Activation group name")
       }
     },
     async (args) => {
@@ -78,12 +78,10 @@ function registerGroupTools(server, callApi) {
         priority: args.priority
       };
       if (args.description !== void 0) body.description = args.description;
-      if (args.conflictResolutionMode !== void 0)
-        body.conflictResolutionMode = args.conflictResolutionMode;
-      if (args.conflictResolutionStrategy !== void 0)
-        body.conflictResolutionStrategy = args.conflictResolutionStrategy;
-      if (args.maxSelections !== void 0) body.maxSelections = args.maxSelections;
-      if (args.activationGroupId !== void 0) body.activationGroupId = args.activationGroupId;
+      if (args.activationMode !== void 0) body.activationMode = args.activationMode;
+      if (args.activationStrategy !== void 0) body.activationStrategy = args.activationStrategy;
+      if (args.executionLimit !== void 0) body.executionLimit = args.executionLimit;
+      if (args.activationGroup !== void 0) body.activationGroup = args.activationGroup;
       return callApi("POST", "policy-groups", { body });
     }
   );
@@ -91,16 +89,16 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_update",
     {
       title: "Update Policy Group",
-      description: "Update an existing policy group. Only provided fields are updated.",
+      description: "Update a policy group. This is a full replacement \u2014 omitted optional fields will be set to null on the server.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
         name: z.string().optional().describe("New name"),
         priority: z.number().int().min(0).optional().describe("New priority"),
         description: z.string().optional().describe("New description"),
         status: z.enum(["ACTIVE", "DISABLED"]).optional().describe("Status (DISABLED = emergency stop)"),
-        conflictResolutionMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
-        conflictResolutionStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy"),
-        maxSelections: z.number().int().min(1).optional().describe("Max selections")
+        activationMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy"),
+        executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
       }
     },
     async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })
@@ -279,17 +277,21 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_create",
     {
       title: "Create Rule",
-      description: `Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array. 
+      description: `Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array.
+
+      Note: Rules can reference fact keys that are not yet registered in Fact Definitions. The engine allows this for flexibility. However, registering facts via lexq_facts_create is recommended \u2014 it enables type validation, the Console UI autocomplete, and the dry-run requirements analyzer.
+
       Condition: { type: "SINGLE", field, operator, value, valueType } or { type: "GROUP", operator: "AND"|"OR", children: [...] }
-      Operators: EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, CONTAINS, IN, NOT_IN 
+      Operators: EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, CONTAINS, IN, NOT_IN
       Value types: STRING, NUMBER, BOOLEAN, LIST_STRING, LIST_NUMBER
-      
+
       Actions: [{ type, parameters }]
-      
+
       Action parameter schemas:
       - DISCOUNT: { refVar: string, method: "PERCENTAGE"|"AMOUNT", rate?: number (when PERCENTAGE), value?: number (when AMOUNT) }
       - POINT: { refVar: string, targetVar: string, method: "PERCENTAGE"|"AMOUNT", rate?: number (when PERCENTAGE), value?: number (when AMOUNT), integrationId: uuid }
-      - COUPON_ISSUE: { couponId: string, integrationId: uuid }- BLOCK: { reason: string }
+      - COUPON_ISSUE: { couponId: string, integrationId: uuid }
+      - BLOCK: { reason: string }
       - NOTIFICATION: { channel: "SMS"|"EMAIL"|"PUSH"|"KAKAO", targetVar: string, templateId: string, integrationId: uuid }
       - WEBHOOK: { url: string, method: "POST" }
       - SET_FACT: { key: string, value: string|number|boolean }
@@ -460,7 +462,7 @@ function registerDeployTools(server, callApi) {
       inputSchema: {
         groupId: z5.string().uuid().describe("Policy group ID"),
         versionId: z5.string().uuid().describe("Version ID to publish"),
-        memo: z5.string().default("").describe("Deployment memo")
+        memo: z5.string().min(1).describe("Publish Deployment memo (required)")
       }
     },
     async ({ groupId, versionId, memo }) => callApi("POST", `policy-groups/${groupId}/versions/${versionId}/publish`, { body: { memo } })
@@ -473,7 +475,7 @@ function registerDeployTools(server, callApi) {
       inputSchema: {
         groupId: z5.string().uuid().describe("Policy group ID"),
         versionId: z5.string().uuid().describe("Version ID to deploy"),
-        memo: z5.string().default("").describe("Deployment memo")
+        memo: z5.string().min(1).describe("Live Deployment memo (required)")
       }
     },
     async ({ groupId, versionId, memo }) => callApi("POST", `policy-groups/${groupId}/deploy`, {
@@ -557,10 +559,8 @@ function registerAnalyticsTools(server, callApi) {
     {
       title: "Dry Run",
       description: `Execute a single dry run against a version. Tests how rules evaluate given input facts without side effects.
-
-Example input: { "facts": { "payment_amount": 100000, "customer_tier": "VIP" } }
-
-Always dry-run before publishing to validate rule behavior.`,
+      Example input: { "facts": { "payment_amount": 100000, "customer_tier": "VIP" } }
+      Always dry-run before publishing to validate rule behavior.`,
       inputSchema: {
         versionId: z6.string().uuid().describe("Policy version ID to test against"),
         facts: z6.string().describe('JSON string of facts object, e.g. {"payment_amount":100000}'),
@@ -609,14 +609,21 @@ Always dry-run before publishing to validate rule behavior.`,
     "lexq_simulation_start",
     {
       title: "Start Simulation",
-      description: `Start a batch simulation against historical execution data.
-
-Example body:
-{
-  "policyVersionId": "<uuid>",
-  "dataset": { "type": "HISTORICAL", "source": "EXECUTION_LOGS", "from": "2025-01-01", "to": "2025-01-31" },
-  "options": { "baselinePolicyVersionId": "<uuid>", "includeRuleStats": true, "maxRecords": 10000 }
-}`,
+      description: `Start a batch simulation against historical or uploaded data.
+      
+      dataset.type: "HISTORICAL" or "UPLOADED"
+      dataset.source (when HISTORICAL): "EXECUTION_LOGS"
+      dataset.from / dataset.to: date range (yyyy-MM-dd, when HISTORICAL)
+      options.maxRecords: number (max 100000, default 10000)
+      options.baselinePolicyVersionId: uuid (optional, for comparison)
+      options.includeRuleStats: boolean
+      
+      Example body:
+      {
+        "policyVersionId": "<uuid>",
+        "dataset": { "type": "HISTORICAL", "source": "EXECUTION_LOGS", "from": "2025-01-01", "to": "2025-01-31" },
+        "options": { "baselinePolicyVersionId": "<uuid>", "includeRuleStats": true, "maxRecords": 10000 }
+      }`,
       inputSchema: {
         body: z6.string().describe("JSON string of SimulationRequest")
       }
@@ -688,16 +695,15 @@ Example body:
     {
       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}]`,
+      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)")
@@ -760,10 +766,10 @@ function registerHistoryTools(server, callApi) {
       title: "Get Execution Detail",
       description: "Get full execution detail including request facts, result traces, and decision traces.",
       inputSchema: {
-        executionId: z7.string().uuid().describe("Execution history ID")
+        traceId: z7.string().describe("Trace ID from execution history")
       }
     },
-    async ({ executionId }) => callApi("GET", `execution/history/${executionId}`)
+    async ({ traceId }) => callApi("GET", `execution/history/${traceId}`)
   );
   server.registerTool(
     "lexq_history_stats",
@@ -821,19 +827,20 @@ function registerIntegrationTools(server, callApi) {
     "lexq_integrations_save",
     {
       title: "Save Integration",
-      description: "Create or update an integration. Types: COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK.",
+      description: "Create or update an integration. Provide id to update an existing one; omit id to create new. Types: COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK.",
       inputSchema: {
+        id: z8.string().uuid().optional().describe("Integration ID (omit to create, provide to update)"),
         type: z8.enum(["COUPON", "POINT", "NOTIFICATION", "CRM", "MESSENGER", "WEBHOOK"]).describe("Integration type"),
         name: z8.string().describe("Integration name"),
         baseUrl: z8.string().describe("Base URL of the external service"),
-        apiKey: z8.string().optional().describe("API key or token for the service"),
-        isActive: z8.boolean().default(true).describe("Whether the integration is active"),
-        config: z8.string().optional().describe("JSON string of additional config key-value pairs")
+        credential: z8.string().optional().describe("API key or token for the service"),
+        additionalConfig: z8.string().optional().describe("JSON string of additional config key-value pairs"),
+        isActive: z8.boolean().default(true).describe("Whether the integration is active")
       }
     },
-    async ({ config, ...rest }) => {
+    async ({ additionalConfig, ...rest }) => {
       const body = { ...rest };
-      if (config) body.config = JSON.parse(config);
+      if (additionalConfig) body.additionalConfig = JSON.parse(additionalConfig);
       return callApi("POST", "integrations", { body });
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexq/cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "LexQ CLI — manage policies, simulate rules, and deploy from the terminal. Built for humans and AI agents.",
   "type": "module",
   "bin": {