@lexq/cli 0.1.13 → 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(
@@ -1942,18 +1942,14 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_list",
     {
       title: "List Policy Groups",
-      description: "List all policy groups. Supports pagination and optional status/keyword filters.",
+      description: "List all policy groups with pagination.",
       inputSchema: {
         page: z.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-        size: z.number().int().min(1).max(100).default(20).describe("Page size"),
-        status: z.enum(["ACTIVE", "DISABLED", "ARCHIVED"]).optional().describe("Filter by status"),
-        keyword: z.string().optional().describe("Search keyword")
+        size: z.number().int().min(1).max(100).default(20).describe("Page size")
       }
     },
-    async ({ page, size, status, keyword }) => {
+    async ({ page, size }) => {
       const params = paginationParams(page, size);
-      if (status) params.status = status;
-      if (keyword) params.keyword = keyword;
       return callApi("GET", "policy-groups", { params });
     }
   );
@@ -1977,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) => {
@@ -1989,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 });
     }
   );
@@ -2002,19 +1996,19 @@ 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("PATCH", `policy-groups/${groupId}`, { body })
+    async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })
   );
   server.registerTool(
     "lexq_groups_delete",
@@ -2031,41 +2025,37 @@ function registerGroupTools(server, callApi) {
     "lexq_ab_test_start",
     {
       title: "Start A/B Test",
-      description: "Start an A/B test on a policy group. Requires a challenger version ID and traffic split percentages.",
+      description: "Start an A/B test on a policy group. Requires a challenger version ID and traffic rate.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
-        challengerVersionId: z.string().uuid().describe("Challenger version ID"),
-        controlWeight: z.number().int().min(1).max(99).describe("Control traffic weight (%)"),
-        challengerWeight: z.number().int().min(1).max(99).describe("Challenger traffic weight (%)"),
-        identityKey: z.string().optional().describe("Fact key for sticky assignment (e.g. customer_id)")
+        testVersionId: z.string().uuid().describe("Challenger version ID to test"),
+        trafficRate: z.number().int().min(1).max(99).describe("Traffic percentage routed to challenger (1-99)")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/start`, { body })
+    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test`, { body })
   );
   server.registerTool(
     "lexq_ab_test_stop",
     {
       title: "Stop A/B Test",
-      description: "Stop a running A/B test. Specify which version to keep.",
+      description: "Stop a running A/B test. All traffic is restored to the control (current) version.",
       inputSchema: {
-        groupId: z.string().uuid().describe("Policy group ID"),
-        winnerVersionId: z.string().uuid().describe("Version ID to keep as live")
+        groupId: z.string().uuid().describe("Policy group ID")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/stop`, { body })
+    async ({ groupId }) => callApi("DELETE", `policy-groups/${groupId}/ab-test`)
   );
   server.registerTool(
     "lexq_ab_test_adjust",
     {
       title: "Adjust A/B Test",
-      description: "Adjust traffic weights of a running A/B test.",
+      description: "Adjust traffic rate of a running A/B test.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
-        controlWeight: z.number().int().min(1).max(99).describe("New control weight (%)"),
-        challengerWeight: z.number().int().min(1).max(99).describe("New challenger weight (%)")
+        trafficRate: z.number().int().min(1).max(99).describe("New traffic percentage for challenger (1-99)")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/adjust`, { body })
+    async ({ groupId, ...body }) => callApi("PATCH", `policy-groups/${groupId}/ab-test/traffic-rate`, { body })
   );
 }
 
@@ -2126,7 +2116,7 @@ function registerVersionTools(server, callApi) {
         effectiveTo: z2.string().optional().describe("New effective end date")
       }
     },
-    async ({ groupId, versionId, ...body }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}`, { body })
+    async ({ groupId, versionId, ...body }) => callApi("PUT", `policy-groups/${groupId}/versions/${versionId}`, { body })
   );
   server.registerTool(
     "lexq_versions_delete",
@@ -2147,15 +2137,12 @@ function registerVersionTools(server, callApi) {
       description: "Clone an existing version to create a new DRAFT. Useful when the source version is already published.",
       inputSchema: {
         groupId: z2.string().uuid().describe("Policy group ID"),
-        versionId: z2.string().uuid().describe("Source version ID to clone"),
-        commitMessage: z2.string().optional().describe("Commit message for the cloned version")
+        versionId: z2.string().uuid().describe("Source version ID to clone")
       }
     },
-    async ({ groupId, versionId, commitMessage }) => {
-      const body = {};
-      if (commitMessage !== void 0) body.commitMessage = commitMessage;
+    async ({ groupId, versionId }) => {
       return callApi("POST", `policy-groups/${groupId}/versions/${versionId}/clone`, {
-        body
+        body: {}
       });
     }
   );
@@ -2197,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 }
+      - 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 }
@@ -2241,7 +2232,7 @@ function registerRuleTools(server, callApi) {
     },
     async ({ groupId, versionId, ruleId, rule }) => {
       const body = JSON.parse(rule);
-      return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
+      return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
         body
       });
     }
@@ -2282,7 +2273,7 @@ function registerRuleTools(server, callApi) {
         ruleId,
         priority: index
       }));
-      return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
+      return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
         body: { rules }
       });
     }
@@ -2299,7 +2290,7 @@ function registerRuleTools(server, callApi) {
         isEnabled: z3.boolean().describe("true to enable, false to disable")
       }
     },
-    async ({ groupId, versionId, ruleId, isEnabled }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}/toggle`, {
+    async ({ groupId, versionId, ruleId, isEnabled }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}/enabled`, {
       body: { isEnabled }
     })
   );
@@ -2352,7 +2343,7 @@ function registerFactTools(server, callApi) {
         isRequired: z4.boolean().describe("Required flag")
       }
     },
-    async ({ factId, ...body }) => callApi("PATCH", `schema/facts/${factId}`, { body })
+    async ({ factId, ...body }) => callApi("PUT", `schema/facts/${factId}`, { body })
   );
   server.registerTool(
     "lexq_facts_delete",
@@ -2378,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 } })
@@ -2391,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`, {
@@ -2475,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}'),
@@ -2527,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")
       }
@@ -2606,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)")
@@ -2678,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",
@@ -2739,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

@@ -35,18 +35,14 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_list",
     {
       title: "List Policy Groups",
-      description: "List all policy groups. Supports pagination and optional status/keyword filters.",
+      description: "List all policy groups with pagination.",
       inputSchema: {
         page: z.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-        size: z.number().int().min(1).max(100).default(20).describe("Page size"),
-        status: z.enum(["ACTIVE", "DISABLED", "ARCHIVED"]).optional().describe("Filter by status"),
-        keyword: z.string().optional().describe("Search keyword")
+        size: z.number().int().min(1).max(100).default(20).describe("Page size")
       }
     },
-    async ({ page, size, status, keyword }) => {
+    async ({ page, size }) => {
       const params = paginationParams(page, size);
-      if (status) params.status = status;
-      if (keyword) params.keyword = keyword;
       return callApi("GET", "policy-groups", { params });
     }
   );
@@ -70,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) => {
@@ -82,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 });
     }
   );
@@ -95,19 +89,19 @@ 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("PATCH", `policy-groups/${groupId}`, { body })
+    async ({ groupId, ...body }) => callApi("PUT", `policy-groups/${groupId}`, { body })
   );
   server.registerTool(
     "lexq_groups_delete",
@@ -124,41 +118,37 @@ function registerGroupTools(server, callApi) {
     "lexq_ab_test_start",
     {
       title: "Start A/B Test",
-      description: "Start an A/B test on a policy group. Requires a challenger version ID and traffic split percentages.",
+      description: "Start an A/B test on a policy group. Requires a challenger version ID and traffic rate.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
-        challengerVersionId: z.string().uuid().describe("Challenger version ID"),
-        controlWeight: z.number().int().min(1).max(99).describe("Control traffic weight (%)"),
-        challengerWeight: z.number().int().min(1).max(99).describe("Challenger traffic weight (%)"),
-        identityKey: z.string().optional().describe("Fact key for sticky assignment (e.g. customer_id)")
+        testVersionId: z.string().uuid().describe("Challenger version ID to test"),
+        trafficRate: z.number().int().min(1).max(99).describe("Traffic percentage routed to challenger (1-99)")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/start`, { body })
+    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test`, { body })
   );
   server.registerTool(
     "lexq_ab_test_stop",
     {
       title: "Stop A/B Test",
-      description: "Stop a running A/B test. Specify which version to keep.",
+      description: "Stop a running A/B test. All traffic is restored to the control (current) version.",
       inputSchema: {
-        groupId: z.string().uuid().describe("Policy group ID"),
-        winnerVersionId: z.string().uuid().describe("Version ID to keep as live")
+        groupId: z.string().uuid().describe("Policy group ID")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/stop`, { body })
+    async ({ groupId }) => callApi("DELETE", `policy-groups/${groupId}/ab-test`)
   );
   server.registerTool(
     "lexq_ab_test_adjust",
     {
       title: "Adjust A/B Test",
-      description: "Adjust traffic weights of a running A/B test.",
+      description: "Adjust traffic rate of a running A/B test.",
       inputSchema: {
         groupId: z.string().uuid().describe("Policy group ID"),
-        controlWeight: z.number().int().min(1).max(99).describe("New control weight (%)"),
-        challengerWeight: z.number().int().min(1).max(99).describe("New challenger weight (%)")
+        trafficRate: z.number().int().min(1).max(99).describe("New traffic percentage for challenger (1-99)")
       }
     },
-    async ({ groupId, ...body }) => callApi("POST", `policy-groups/${groupId}/ab-test/adjust`, { body })
+    async ({ groupId, ...body }) => callApi("PATCH", `policy-groups/${groupId}/ab-test/traffic-rate`, { body })
   );
 }
 
@@ -219,7 +209,7 @@ function registerVersionTools(server, callApi) {
         effectiveTo: z2.string().optional().describe("New effective end date")
       }
     },
-    async ({ groupId, versionId, ...body }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}`, { body })
+    async ({ groupId, versionId, ...body }) => callApi("PUT", `policy-groups/${groupId}/versions/${versionId}`, { body })
   );
   server.registerTool(
     "lexq_versions_delete",
@@ -240,15 +230,12 @@ function registerVersionTools(server, callApi) {
       description: "Clone an existing version to create a new DRAFT. Useful when the source version is already published.",
       inputSchema: {
         groupId: z2.string().uuid().describe("Policy group ID"),
-        versionId: z2.string().uuid().describe("Source version ID to clone"),
-        commitMessage: z2.string().optional().describe("Commit message for the cloned version")
+        versionId: z2.string().uuid().describe("Source version ID to clone")
       }
     },
-    async ({ groupId, versionId, commitMessage }) => {
-      const body = {};
-      if (commitMessage !== void 0) body.commitMessage = commitMessage;
+    async ({ groupId, versionId }) => {
       return callApi("POST", `policy-groups/${groupId}/versions/${versionId}/clone`, {
-        body
+        body: {}
       });
     }
   );
@@ -290,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 }
+      - 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 }
@@ -334,7 +325,7 @@ function registerRuleTools(server, callApi) {
     },
     async ({ groupId, versionId, ruleId, rule }) => {
       const body = JSON.parse(rule);
-      return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
+      return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}`, {
         body
       });
     }
@@ -375,7 +366,7 @@ function registerRuleTools(server, callApi) {
         ruleId,
         priority: index
       }));
-      return callApi("PUT", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
+      return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
         body: { rules }
       });
     }
@@ -392,7 +383,7 @@ function registerRuleTools(server, callApi) {
         isEnabled: z3.boolean().describe("true to enable, false to disable")
       }
     },
-    async ({ groupId, versionId, ruleId, isEnabled }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}/toggle`, {
+    async ({ groupId, versionId, ruleId, isEnabled }) => callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/${ruleId}/enabled`, {
       body: { isEnabled }
     })
   );
@@ -445,7 +436,7 @@ function registerFactTools(server, callApi) {
         isRequired: z4.boolean().describe("Required flag")
       }
     },
-    async ({ factId, ...body }) => callApi("PATCH", `schema/facts/${factId}`, { body })
+    async ({ factId, ...body }) => callApi("PUT", `schema/facts/${factId}`, { body })
   );
   server.registerTool(
     "lexq_facts_delete",
@@ -471,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 } })
@@ -484,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`, {
@@ -568,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}'),
@@ -620,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")
       }
@@ -699,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)")
@@ -771,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",
@@ -832,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.13",
+  "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": {