npm - @lexq/cli - Versions diffs - 0.1.40 → 0.1.41 - Mend

@lexq/cli 0.1.40 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/AGENTS.md +34 -32
package/CONTEXT.md +41 -47
package/README.md +8 -6
package/dist/index.js +119 -385
package/dist/mcp/register.js +86 -166
package/package.json +1 -1
package/skills/lexq-execution/SKILL.md +120 -65
package/skills/lexq-groups/SKILL.md +78 -38
package/skills/lexq-recipes/SKILL.md +97 -193
package/skills/lexq-rules/SKILL.md +105 -35
package/skills/lexq-shared/SKILL.md +48 -28
package/skills/lexq-simulation/SKILL.md +33 -33

package/dist/index.js CHANGED Viewed

@@ -389,7 +389,7 @@ ${data.length} total`);
           description         string    Description (optional, max 255 chars)
           activationGroup     string    Execution Group — conflict-resolution cluster key (optional)
           activationMode      string    NONE | EXCLUSIVE | MAX_N  [default: NONE]
-          activationStrategy  string    FIRST_MATCH | HIGHEST_PRIORITY | MAX_BENEFIT  [default: FIRST_MATCH]
+          activationStrategy  string    HIGHEST_PRIORITY  [default, and currently the only value]
           executionLimit      number    Max rules to fire in MAX_N mode (optional)
           status              string    ACTIVE | DISABLED  [default: ACTIVE]
@@ -929,7 +929,7 @@ ${data.length} total`);
                 "valueType": "STRING"
               },
               "actions": [
-                { "type": "MUTATE_FACT", "parameters": { "refVar": "payment_amount", "operator": "SUB", "method": "PERCENTAGE", "rate": 20 } }
+                { "type": "MUTATE_FACT", "parameters": { "targetVar": "payment_amount", "operator": "SUB", "method": "PERCENTAGE", "operand": 20 } }
               ]
             }'
@@ -956,14 +956,19 @@ ${data.length} total`);
           IN is the mirror of HAS_*: scalar fact, list value.
         Action Types:
-          MUTATE_FACT, INCREMENT_FACT, EMIT_EVENT, BLOCK, EMIT_NOTIFICATION, EMIT_WEBHOOK, SET_FACT, ADD_TAG
+          MUTATE_FACT   { targetVar, operator, method, operand, refVar?, rounding? }
+          SET_FACT      { targetVar, value }
+          BLOCK         { reason }
+          refVar is the percentage base and is optional — omit to use targetVar itself.
+          It is only valid in PERCENTAGE × {ASSIGN, ADD, SUB}.
         Value Types: STRING, NUMBER, BOOLEAN, LIST_STRING, LIST_NUMBER
         Mutex (optional — rule-level conflict resolution):
           mutexGroup       string    Logical grouping key (e.g., "best-discount")
           mutexMode        string    NONE | EXCLUSIVE | MAX_N  [default: NONE]
-          mutexStrategy    string    FIRST_MATCH | HIGHEST_PRIORITY | MAX_BENEFIT
+          mutexStrategy    string    HIGHEST_PRIORITY (currently the only value)
           mutexLimit       number    Max rules to fire in MAX_N mode (required when MAX_N)
         priority is auto-assigned (appended last). Use 'lexq rules reorder' to change order.
@@ -1000,7 +1005,7 @@ ${data.length} total`);
           $ lexq rules update --group-id <gid> --version-id <vid> --id <rid> --json '{
               "name": "VIP 25% Discount",
               "actions": [
-                { "type": "MUTATE_FACT", "parameters": { "refVar": "payment_amount", "operator": "SUB", "method": "PERCENTAGE", "rate": 25 } }
+                { "type": "MUTATE_FACT", "parameters": { "targetVar": "payment_amount", "operator": "SUB", "method": "PERCENTAGE", "operand": 25 } }
               ]
             }'
       `
@@ -1826,18 +1831,17 @@ function registerAnalyticsCommands(program) {
         Workflow: facts check → dry-run → publish → simulation → deploy
       `
   );
-  analytics.command("dry-run").description("Execute a single dry run against a version").requiredOption("--version-id <versionId>", "Policy version ID").option("--json <body>", "Request body as JSON string").option("--file <path>", "Read request body from a JSON file").option("--debug", "Include debug traces", false).option("--mock", "Mock external calls", false).addHelpText(
+  analytics.command("dry-run").description("Execute a single dry run against a version").requiredOption("--version-id <versionId>", "Policy version ID").option("--json <body>", "Request body as JSON string").option("--file <path>", "Read request body from a JSON file").option("--debug", "Include debug traces", false).addHelpText(
     "after",
     dedent8`
         Examples:
-          $ lexq analytics dry-run --version-id <vid> --debug --mock \\
+          $ lexq analytics dry-run --version-id <vid> --debug \\
               --json '{"facts": {"payment_amount": 150000, "customer_tier": "VIP"}}'
           $ lexq analytics dry-run --version-id <vid> --file test-input.json
         The request body must include a "facts" object. Use --debug for execution traces
-        and --mock to skip external service calls (webhooks, coupons, etc.).
       `
   ).action(async (opts) => {
     try {
@@ -1847,7 +1851,6 @@ function registerAnalyticsCommands(program) {
         throw new Error('Request body must include "facts". Use --json or --file.');
       }
       body.includeDebugInfo = opts.debug;
-      body.mockExternalCalls = opts.mock;
       const data = await apiRequest(
         "POST",
         `analytics/dry-run/versions/${opts.versionId}`,
@@ -1957,7 +1960,7 @@ function registerAnalyticsCommands(program) {
           cancel    Cancel a running simulation
           export    Export results as CSV or JSON
-        Simulations always mock external calls. Use --format table for summary view.
+        Use --format table for summary view.
       `
   );
   sim.command("start").description("Start a new batch simulation").requiredOption("--json <body>", "Simulation request body as JSON").option("--file <path>", "Read request body from a JSON file").addHelpText(
@@ -2319,27 +2322,12 @@ import "commander";
 import dedent9 from "dedent";
 // src/types/enums.ts
+var ConflictResolutionMode = ["NONE", "EXCLUSIVE", "MAX_N"];
+var ConflictResolutionStrategy = ["HIGHEST_PRIORITY"];
 var ProfileCacheState = ["HIT", "MISS"];
 var FailureStatus = ["PENDING", "RESOLVED", "IGNORED"];
-var FailureAction = ["RETRY", "IGNORE", "RESOLVE"];
-var TaskCategory = ["INTEGRATION", "INTERNAL"];
-var TaskType = [
-  // Integration
-  "COUPON_ISSUE",
-  "COUPON_CANCEL",
-  "POINT_EARN",
-  "POINT_USE",
-  "POINT_REFUND",
-  "NOTIFICATION_SEND",
-  "CRM_SYNC_USER",
-  "CRM_ADD_TAG",
-  "WEBHOOK_EXECUTE",
-  // Internal
-  "IMAGE_PROCESSING",
-  "DAILY_SETTLEMENT",
-  "PLATFORM_WEBHOOK",
-  "SCHEDULED_DEPLOYMENT"
-];
+var FailureAction = ["IGNORE", "RESOLVE"];
+var TaskType = ["PLATFORM_WEBHOOK", "SCHEDULED_DEPLOYMENT"];
 var PlatformEventType = [
   "VERSION_PUBLISHED",
   "DEPLOYED",
@@ -2819,216 +2807,32 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
   });
 }
-// src/commands/integrations.ts
-import "commander";
-import dedent13 from "dedent";
-function registerIntegrationCommands(program) {
-  const integrations = program.command("integrations").description("Manage external integrations").addHelpText(
-    "after",
-    dedent13`
-        Integrations connect rule actions to external services (webhooks, coupons,
-        points, notifications, CRM, messengers).
-        Commands:
-          list         List all integrations
-          get          Get integration detail
-          save         Create or update an integration
-          delete       Delete an integration
-          config-spec  Show required configuration fields per type
-        Types: COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK
-      `
-  );
-  integrations.command("list").description("List integrations").option(
-    "--type <type>",
-    "Filter by type (COUPON, POINT, NOTIFICATION, CRM, MESSENGER, WEBHOOK)"
-  ).option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").action(async (opts) => {
-    try {
-      const globalOpts = program.opts();
-      const format = globalOpts.format ?? "json";
-      const params = { page: opts.page, size: opts.size };
-      if (opts.type) params.type = opts.type;
-      const data = await apiRequest("GET", "integrations", {
-        apiKey: globalOpts.apiKey,
-        baseUrl: globalOpts.baseUrl,
-        dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose,
-        params
-      });
-      if (format === "table") {
-        printTable(
-          ["ID", "Name", "Type", "URL", "Active"],
-          data.content.map((i) => [
-            i.id.substring(0, 8),
-            i.name,
-            i.type,
-            i.baseUrl,
-            i.isActive ? "\u2713" : "\u2717"
-          ]),
-          { truncate: 28 }
-        );
-        console.log(`
-${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
-      } else {
-        printJson(data);
-      }
-    } catch (error) {
-      printError(error);
-      process.exit(1);
-    }
-  });
-  integrations.command("get").description("Get integration detail").requiredOption("--id <integrationId>", "Integration ID").action(async (opts) => {
-    try {
-      const globalOpts = program.opts();
-      const data = await apiRequest("GET", `integrations/${opts.id}`, {
-        apiKey: globalOpts.apiKey,
-        baseUrl: globalOpts.baseUrl,
-        dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose
-      });
-      printJson(data);
-    } catch (error) {
-      printError(error);
-      process.exit(1);
-    }
-  });
-  integrations.command("save").description("Create or update an integration").requiredOption("--json <body>", "Request body as JSON string").addHelpText(
-    "after",
-    dedent13`
-        Examples:
-          # Create
-          $ lexq integrations save --json '{
-              "type": "WEBHOOK",
-              "name": "Order Processing",
-              "baseUrl": "https://api.example.com/webhooks/orders",
-              "isActive": true
-            }'
-          # Update (provide id)
-          $ lexq integrations save --json '{
-              "id": "<existing-id>",
-              "type": "WEBHOOK",
-              "name": "Order Processing (v2)",
-              "baseUrl": "https://api.example.com/v2/webhooks/orders",
-              "isActive": true
-            }'
-        Fields:
-          id                 string    Provide to update, omit to create
-          type               string    COUPON | POINT | NOTIFICATION | CRM | MESSENGER | WEBHOOK (required)
-          name               string    Integration name (required, unique per tenant)
-          baseUrl            string    Base URL of the external service (required)
-          credential         string    API key or token (optional, write-only)
-          additionalConfig   object    Extra config key-value pairs (optional)
-          isActive           boolean   Enable/disable  [default: true]
-        Use "lexq integrations config-spec" to see required fields per type.
-      `
-  ).action(async (opts) => {
-    try {
-      const globalOpts = program.opts();
-      const body = JSON.parse(opts.json);
-      const data = await apiRequest("POST", "integrations", {
-        apiKey: globalOpts.apiKey,
-        baseUrl: globalOpts.baseUrl,
-        dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose,
-        body
-      });
-      printJson(data);
-    } catch (error) {
-      printError(error);
-      process.exit(1);
-    }
-  });
-  integrations.command("delete").description("Delete an integration").requiredOption("--id <integrationId>", "Integration ID").option("--force", "Skip confirmation prompt").addHelpText(
-    "after",
-    dedent13`
-        Rules referencing this integration will fail at execution time.
-        Use --force to skip confirmation.
-      `
-  ).action(async (opts) => {
-    try {
-      const globalOpts = program.opts();
-      if (!opts.force) {
-        const { createInterface: createInterface2 } = await import("readline/promises");
-        const rl = createInterface2({ input: process.stdin, output: process.stdout });
-        const answer = await rl.question(`Delete integration ${opts.id}? [y/N] `);
-        rl.close();
-        if (answer.toLowerCase() !== "y") {
-          console.log("Canceled.");
-          return;
-        }
-      }
-      await apiRequest("DELETE", `integrations/${opts.id}`, {
-        apiKey: globalOpts.apiKey,
-        baseUrl: globalOpts.baseUrl,
-        dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose
-      });
-      console.log(`\u2713 Integration ${opts.id} deleted.`);
-    } catch (error) {
-      printError(error);
-      process.exit(1);
-    }
-  });
-  integrations.command("config-spec").description("Get integration configuration field specs").addHelpText(
-    "after",
-    dedent13`
-        Shows required and optional configuration fields for each integration type.
-        Example:
-          $ lexq integrations config-spec
-      `
-  ).action(async () => {
-    try {
-      const globalOpts = program.opts();
-      const data = await apiRequest("GET", "integrations/config-spec", {
-        apiKey: globalOpts.apiKey,
-        baseUrl: globalOpts.baseUrl,
-        dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose
-      });
-      printJson(data);
-    } catch (error) {
-      printError(error);
-      process.exit(1);
-    }
-  });
-}
 // src/commands/logs.ts
 import "commander";
-import dedent14 from "dedent";
+import dedent13 from "dedent";
 function registerLogCommands(program) {
   const logs = program.command("logs").description("Failure logs").addHelpText(
     "after",
-    dedent14`
+    dedent13`
-        System failure logs (DLQ) for background tasks — webhook calls, coupon issuance,
-        point operations, notifications, and platform event webhooks.
+        System failure logs (DLQ) for background tasks — platform event webhooks and scheduled deployments.
         Commands:
           list         List failure logs with filters
-          get          Get failure log detail (includes payload for retry)
-          action       Process a single log (RETRY, IGNORE, RESOLVE)
+          get          Get failure log detail (includes the original payload)
+          action       Process a single log (IGNORE, RESOLVE)
           bulk-action  Process multiple logs at once
         Statuses: PENDING (needs attention), RESOLVED, IGNORED
-        Categories: INTEGRATION (external), INTERNAL (system)
       `
   );
-  logs.command("list").description("List failure logs").option("--category <category>", "Filter by category (INTEGRATION, INTERNAL)").option("--task-type <taskType>", `Filter by task type (${TaskType.join(", ")})`).option("--status <status>", "Filter by status (PENDING, RESOLVED, IGNORED)").option("--keyword <keyword>", "Search keyword").option("--start-date <date>", "Start date (yyyy-MM-dd)").option("--end-date <date>", "End date (yyyy-MM-dd)").option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").addHelpText(
+  logs.command("list").description("List failure logs").option("--task-type <taskType>", `Filter by task type (${TaskType.join(", ")})`).option("--status <status>", "Filter by status (PENDING, RESOLVED, IGNORED)").option("--keyword <keyword>", "Search keyword").option("--start-date <date>", "Start date (yyyy-MM-dd)").option("--end-date <date>", "End date (yyyy-MM-dd)").option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").addHelpText(
     "after",
-    dedent14`
+    dedent13`
         Examples:
           $ lexq logs list --status PENDING --format table
-          $ lexq logs list --task-type PLATFORM_WEBHOOK --category INTERNAL
+          $ lexq logs list --task-type PLATFORM_WEBHOOK
           $ lexq logs list --keyword "timeout" --start-date 2026-04-01
       `
   ).action(async (opts) => {
@@ -3036,7 +2840,6 @@ function registerLogCommands(program) {
       const globalOpts = program.opts();
       const format = globalOpts.format ?? "json";
       const params = { page: opts.page, size: opts.size };
-      if (opts.category) params.category = opts.category;
       if (opts.taskType) params.taskType = opts.taskType;
       if (opts.status) params.status = opts.status;
       if (opts.keyword) params.searchKeyword = opts.keyword;
@@ -3051,13 +2854,11 @@ function registerLogCommands(program) {
       });
       if (format === "table") {
         printTable(
-          ["ID", "Category", "Task", "Status", "Retries", "Error", "Created"],
+          ["ID", "Task", "Status", "Error", "Created"],
           data.content.map((l) => [
             l.id.substring(0, 8),
-            l.category,
             l.taskType,
             l.status,
-            String(l.retryCount),
             l.errorMessage?.substring(0, 24) ?? "\u2013",
             l.createdAt.substring(0, 16)
           ]),
@@ -3075,10 +2876,10 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
   });
   logs.command("get").description("Get failure log detail").requiredOption("--id <logId>", "Log ID").addHelpText(
     "after",
-    dedent14`
+    dedent13`
         Includes the full payload that was used for the failed operation.
-        Use this to inspect what went wrong before deciding to RETRY or RESOLVE.
+        Use this to inspect what went wrong before deciding to IGNORE or RESOLVE.
       `
   ).action(async (opts) => {
     try {
@@ -3095,17 +2896,16 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       process.exit(1);
     }
   });
-  logs.command("action").description("Process a failure log action (RETRY, IGNORE, RESOLVE)").requiredOption("--id <logId>", "Log ID").requiredOption("--action <action>", "Action: RETRY, IGNORE, or RESOLVE").addHelpText(
+  logs.command("action").description("Process a failure log action (IGNORE, RESOLVE)").requiredOption("--id <logId>", "Log ID").requiredOption("--action <action>", "Action: IGNORE or RESOLVE").addHelpText(
     "after",
-    dedent14`
+    dedent13`
         Actions:
-          RETRY    Re-execute the failed operation with the original payload
           IGNORE   Mark as intentionally skipped (won't appear in PENDING)
           RESOLVE  Mark as manually resolved (e.g., fixed via external system)
         Example:
-          $ lexq logs action --id <logId> --action RETRY
+          $ lexq logs action --id <logId> --action RESOLVE
       `
   ).action(async (opts) => {
     try {
@@ -3127,9 +2927,9 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       process.exit(1);
     }
   });
-  logs.command("bulk-action").description("Bulk process failure logs").requiredOption("--ids <logIds>", "Comma-separated log IDs").requiredOption("--action <action>", "Action: RETRY, IGNORE, or RESOLVE").addHelpText(
+  logs.command("bulk-action").description("Bulk process failure logs").requiredOption("--ids <logIds>", "Comma-separated log IDs").requiredOption("--action <action>", "Action: IGNORE or RESOLVE").addHelpText(
     "after",
-    dedent14`
+    dedent13`
         Processes each log individually. Failures are skipped with a warning.
@@ -3157,11 +2957,11 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
 // src/commands/webhook-subscriptions.ts
 import "commander";
-import dedent15 from "dedent";
+import dedent14 from "dedent";
 function registerWebhookSubscriptionCommands(program) {
   const webhooks = program.command("webhook-subscriptions").description("Manage platform event webhook subscriptions").addHelpText(
     "after",
-    dedent15`
+    dedent14`
         Receive notifications when deployment lifecycle events occur
         (publish, deploy, rollback, undeploy).
@@ -3235,7 +3035,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
   });
   webhooks.command("save").description("Create or update a webhook subscription").requiredOption("--json <body>", "Request body as JSON string").addHelpText(
     "after",
-    dedent15`
+    dedent14`
         Examples:
           # Create (Slack format)
@@ -3290,7 +3090,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
   });
   webhooks.command("delete").description("Delete a webhook subscription").requiredOption("--id <subscriptionId>", "Subscription ID").option("--force", "Skip confirmation prompt").addHelpText(
     "after",
-    dedent15`
+    dedent14`
         Use --force to skip the confirmation prompt.
@@ -3324,7 +3124,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
   });
   webhooks.command("test").description("Send a test event to verify webhook connectivity").requiredOption("--id <subscriptionId>", "Subscription ID").addHelpText(
     "after",
-    dedent15`
+    dedent14`
         Sends a test event to the webhook URL and reports the HTTP status code.
         Does not record failures in the failure log.
@@ -3360,7 +3160,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
 // src/commands/serve.ts
 import "commander";
-import dedent18 from "dedent";
+import dedent17 from "dedent";
 // src/mcp/server.ts
 import { readFileSync as readFileSync3 } from "fs";
@@ -3494,8 +3294,8 @@ function registerGroupTools(server, callApi) {
       inputSchema: {
         name: z.string().describe("Group name (unique among non-ARCHIVED)"),
         description: z.string().optional().describe("Group description"),
-        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"),
+        activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(ConflictResolutionStrategy).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")
       }
@@ -3523,8 +3323,8 @@ function registerGroupTools(server, callApi) {
         description: z.string().optional().describe("New description"),
         status: z.enum(["ACTIVE", "DISABLED"]).optional().describe("Status (DISABLED = emergency stop)"),
         activationGroup: z.string().optional().describe("Activation group (Execution Group) cluster key"),
-        activationMode: z.enum(["NONE", "EXCLUSIVE", "MAX_N"]).optional().describe("Conflict resolution mode"),
-        activationStrategy: z.enum(["FIRST_MATCH", "HIGHEST_PRIORITY", "MAX_BENEFIT"]).optional().describe("Strategy"),
+        activationMode: z.enum(ConflictResolutionMode).optional().describe("Conflict resolution mode"),
+        activationStrategy: z.enum(ConflictResolutionStrategy).optional().describe("Strategy"),
         executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
       }
     },
@@ -3687,7 +3487,7 @@ function registerVersionTools(server, callApi) {
 // src/mcp/tools/rules.ts
 import { z as z3 } from "zod";
-import dedent16 from "dedent";
+import dedent15 from "dedent";
 function registerRuleTools(server, callApi) {
   server.registerTool(
     "lexq_rules_list",
@@ -3718,7 +3518,7 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_create",
     {
       title: "Create Rule",
-      description: dedent16`
+      description: dedent15`
         Create a rule in a DRAFT version. Requires name, condition tree, and actions array. priority is auto-assigned (appended last); use lexq_rules_reorder to change order.
         Before creating rules with new fact keys, call lexq_facts_list to check existing facts.
@@ -3751,20 +3551,33 @@ function registerRuleTools(server, callApi) {
         Actions: [{ type, parameters }]
         Action parameter schemas:
-        - MUTATE_FACT: { refVar: string, operator: "ASSIGN"|"ADD"|"SUB"|"MUL"|"DIV", method: "PERCENTAGE"|"AMOUNT", rate?: number (when PERCENTAGE), value?: number (when AMOUNT), rounding?: RoundingOption } Constraints: DIV + PERCENTAGE is invalid (use MUL with rate/100 inverse). DIV + AMOUNT requires value !== 0.
-        - INCREMENT_FACT: { targetVar: string, method: "PERCENTAGE"|"AMOUNT", refVar?: string (required when PERCENTAGE), rate?: number (when PERCENTAGE), value?: number (when AMOUNT), rounding?: RoundingOption } targetVar (accumulation target) must exist at execution; refVar (PERCENTAGE source) must exist when method is PERCENTAGE. Each is supplied as an input fact or written by a prior action in this rule — a missing required fact throws (no 0 default). Note: external system call (e.g. point system sync) is NOT a primitive responsibility. Compose [INCREMENT_FACT, EMIT_EVENT] chain instead.
-        - EMIT_EVENT: { integrationId: uuid, eventPayload: object (Map<string,unknown>, ≥1 entry) } eventPayload is passed through to the integration provider as-is. Domain-specific keys (couponId, ticketId, etc.) are routed by the provider, not validated by the engine.
-        - BLOCK: { reason: string }
-        - EMIT_NOTIFICATION: { integrationId: uuid, targetVar: string, notificationPayload: object (Map<string,unknown>, ≥1 entry) } targetVar identifies the recipient fact (e.g. phone_number / email / device_token) and is REQUIRED — the named fact must be present in the request or the action throws. (Contrast with ADD_TAG, where targetVar is an optional write target that is created if absent.)
-        - EMIT_WEBHOOK: { url: string, method: "POST", payloadTemplate?: object } payloadTemplate is optional. Without it, all facts are sent as-is. With it, the object is sent as the HTTP body with {{variables}} replaced at execution time. Variables: {{fact.xxx}}, {{output.xxx}}, {{timestamp}}, {{ruleName}}, {{groupName}}, {{versionNo}}, {{xxx}} (shorthand).
-          Platform examples:
-            Slack: { "text": "Rule {{ruleName}} fired — {{fact.customer_tier}}" }
-            Discord: { "content": "Rule {{ruleName}} fired — {{fact.customer_tier}}" }
-            Generic: { "event": "rule_matched", "rule": "{{ruleName}}", "amount": "{{output.payment_amount}}" }
-        - SET_FACT: { key: string, value: string|number|boolean }
-        - ADD_TAG: { tag: string, targetVar?: string (defaults to "user_tags") } Appends tag to a LIST_STRING fact, creating it if absent. Adding an existing tag is a no-op (idempotent). Read tags back with HAS_ANY / HAS_ALL / HAS_NONE.
-        RoundingOption (optional, MUTATE_FACT / INCREMENT_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).
+        - MUTATE_FACT: { targetVar: string, operator: "ASSIGN"|"ADD"|"SUB"|"MUL"|"DIV", method: "PERCENTAGE"|"AMOUNT", operand: number, refVar?: string, rounding?: RoundingOption }
+          targetVar is the fact this action reads and writes. It must exist in facts at execution
+          time as a number — supplied as an input fact or written by a prior action in this rule.
+          A missing required fact throws (no 0 default).
+          operand is the arithmetic operand; the unit is dictated by method (percent when
+          PERCENTAGE, absolute amount when AMOUNT). Ranges are not constrained — negative values
+          and >100 percentages are valid (refunds, surcharges).
+          refVar is the base for percentage calculation and is OPTIONAL — omit it to use targetVar
+          itself. It is only meaningful in PERCENTAGE × {ASSIGN, ADD, SUB}; specifying it in any
+          other cell is an error. Use it when the base differs from the target, e.g.
+          "points += order_total × 5%" → { targetVar: "points", refVar: "order_total",
+          operator: "ADD", method: "PERCENTAGE", operand: 5 }.
+          operator × method matrix:
+            ASSIGN  targetVar = operand              | targetVar = refVar × operand/100
+            ADD     targetVar += operand             | targetVar += refVar × operand/100
+            SUB     targetVar -= operand             | targetVar -= refVar × operand/100
+            MUL     targetVar *= operand             | targetVar *= (operand/100 + 1)
+            DIV     targetVar /= operand             | invalid
+          Constraints: DIV + PERCENTAGE is invalid (use MUL with the inverse). DIV + AMOUNT
+          requires operand !== 0.
+        - SET_FACT: { targetVar: string, value: string|number|boolean } Creates the fact if absent
+          — this is the only action that does. MUTATE_FACT requires the target to already exist.
+        - BLOCK: { reason: string } Records a rejection decision. It does NOT halt rule execution —
+          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).
       `,
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
@@ -3927,7 +3740,7 @@ function registerFactTools(server, callApi) {
     "lexq_facts_action_metadata",
     {
       title: "Get Action Runtime Fact Metadata",
-      description: "Retrieve runtime fact requirements per Action type. For each Action, shows which input facts must be present in the execution payload (e.g. MUTATE_FACT requires its refVar fact; INCREMENT_FACT always requires targetVar, plus refVar when method is PERCENTAGE). A required fact absent at runtime throws \u2014 the engine never defaults to 0. Facts are supplied as input or written by a prior action in the same rule; Actions never create a fact from nothing. Static data, safe to cache in-session.",
+      description: "Retrieve runtime fact requirements per Action type. For each Action, shows which input facts must be present in the execution payload \u2014 e.g. MUTATE_FACT always requires its targetVar fact, plus refVar when one is specified. The factRequired flag describes the FACT, not the parameter: refVar is an optional parameter, but if you specify it the named fact must exist. A required fact absent at runtime throws \u2014 the engine never defaults to 0. Facts are supplied as input or written by a prior action in the same rule; only SET_FACT creates a fact from nothing. Static data, safe to cache in-session.",
       inputSchema: {}
     },
     async () => callApi("GET", "schema/action-metadata")
@@ -4115,13 +3928,13 @@ function registerDeployTools(server, callApi) {
 // src/mcp/tools/analytics.ts
 import { z as z6 } from "zod";
-import dedent17 from "dedent";
+import dedent16 from "dedent";
 function registerAnalyticsTools(server, callApi) {
   server.registerTool(
     "lexq_dry_run",
     {
       title: "Dry Run",
-      description: dedent17`
+      description: dedent16`
         Execute a single dry run against a version. Tests how rules evaluate given input facts without side effects.
         Returns:
@@ -4136,14 +3949,13 @@ function registerAnalyticsTools(server, callApi) {
       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}'),
-        includeDebugInfo: z6.boolean().default(true).describe("Include execution and decision traces"),
-        mockExternalCalls: z6.boolean().default(true).describe("Mock external integration calls")
+        includeDebugInfo: z6.boolean().default(true).describe("Include execution and decision traces")
       }
     },
-    async ({ versionId, facts, includeDebugInfo, mockExternalCalls }) => {
+    async ({ versionId, facts, includeDebugInfo }) => {
       const parsedFacts = JSON.parse(facts);
       return callApi("POST", `analytics/dry-run/versions/${versionId}`, {
-        body: { facts: parsedFacts, includeDebugInfo, mockExternalCalls }
+        body: { facts: parsedFacts, includeDebugInfo }
       });
     }
   );
@@ -4151,7 +3963,7 @@ function registerAnalyticsTools(server, callApi) {
     "lexq_dry_run_compare",
     {
       title: "Dry Run Compare",
-      description: dedent17`
+      description: dedent16`
         Compare dry run results between two versions using the same input facts. Useful for validating changes.
         Returns:
@@ -4187,7 +3999,7 @@ function registerAnalyticsTools(server, callApi) {
     "lexq_simulation_start",
     {
       title: "Start Simulation",
-      description: dedent17`
+      description: dedent16`
         Start an Impact Simulation against historical, uploaded, or inline data.
         dataset.type and dataset.source are BOTH required, and must be paired:
@@ -4285,7 +4097,7 @@ function registerAnalyticsTools(server, callApi) {
     "lexq_dataset_upload",
     {
       title: "Upload Dataset",
-      description: dedent17`
+      description: dedent16`
         Upload inline CSV or JSON content as a simulation dataset.
         The content is uploaded to S3 and a path is returned in the "path" field.
@@ -4557,102 +4369,26 @@ function registerProvenanceTools(server, callApi) {
   );
 }
-// src/mcp/tools/integrations.ts
-import { z as z11 } from "zod";
-function registerIntegrationTools(server, callApi) {
-  server.registerTool(
-    "lexq_integrations_list",
-    {
-      title: "List Integrations",
-      description: "List all external integrations (webhooks, CRM, notification, etc.).",
-      inputSchema: {
-        page: z11.number().int().min(0).default(0).describe("Page number"),
-        size: z11.number().int().min(1).max(100).default(20).describe("Page size"),
-        type: z11.enum(["COUPON", "POINT", "NOTIFICATION", "CRM", "MESSENGER", "WEBHOOK"]).optional().describe("Filter by integration type")
-      }
-    },
-    async ({ page, size, type }) => {
-      const params = paginationParams(page, size);
-      if (type) params.type = type;
-      return callApi("GET", "integrations", { params });
-    }
-  );
-  server.registerTool(
-    "lexq_integrations_get",
-    {
-      title: "Get Integration",
-      description: "Get integration detail by ID.",
-      inputSchema: {
-        integrationId: z11.string().uuid().describe("Integration ID")
-      }
-    },
-    async ({ integrationId }) => callApi("GET", `integrations/${integrationId}`)
-  );
-  server.registerTool(
-    "lexq_integrations_save",
-    {
-      title: "Save Integration",
-      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: z11.string().uuid().optional().describe("Integration ID (omit to create, provide to update)"),
-        type: z11.enum(["COUPON", "POINT", "NOTIFICATION", "CRM", "MESSENGER", "WEBHOOK"]).describe("Integration type"),
-        name: z11.string().describe("Integration name"),
-        baseUrl: z11.string().describe("Base URL of the external service"),
-        credential: z11.string().optional().describe("API key or token for the service"),
-        additionalConfig: z11.string().optional().describe("JSON string of additional config key-value pairs"),
-        isActive: z11.boolean().default(true).describe("Whether the integration is active")
-      }
-    },
-    async ({ additionalConfig, ...rest }) => {
-      const body = { ...rest };
-      if (additionalConfig) body.additionalConfig = JSON.parse(additionalConfig);
-      return callApi("POST", "integrations", { body });
-    }
-  );
-  server.registerTool(
-    "lexq_integrations_delete",
-    {
-      title: "Delete Integration",
-      description: "Delete an integration by ID.",
-      inputSchema: {
-        integrationId: z11.string().uuid().describe("Integration ID")
-      }
-    },
-    async ({ integrationId }) => callApi("DELETE", `integrations/${integrationId}`)
-  );
-  server.registerTool(
-    "lexq_integrations_config_spec",
-    {
-      title: "Integration Config Spec",
-      description: "Show available integration types and their required configuration fields.",
-      inputSchema: {}
-    },
-    async () => callApi("GET", "integrations/config-spec")
-  );
-}
 // src/mcp/tools/logs.ts
-import { z as z12 } from "zod";
+import { z as z11 } from "zod";
 function registerLogTools(server, callApi) {
   server.registerTool(
     "lexq_logs_list",
     {
       title: "List Failure Logs",
-      description: "List system failure logs from background tasks (webhook calls, coupon issuance, etc.).",
+      description: "List system failure logs from background tasks (platform event webhooks, scheduled deployments).",
       inputSchema: {
-        page: z12.number().int().min(0).default(0).describe("Page number"),
-        size: z12.number().int().min(1).max(100).default(20).describe("Page size"),
-        category: z12.enum(TaskCategory).optional().describe("Task category"),
-        taskType: z12.enum(TaskType).optional().describe("Task type"),
-        status: z12.enum(FailureStatus).optional().describe("Log status"),
-        keyword: z12.string().optional().describe("Search in refId, refSubId, errorMessage"),
-        startDate: z12.string().optional().describe("Start date (yyyy-MM-dd)"),
-        endDate: z12.string().optional().describe("End date (yyyy-MM-dd)")
+        page: z11.number().int().min(0).default(0).describe("Page number"),
+        size: z11.number().int().min(1).max(100).default(20).describe("Page size"),
+        taskType: z11.enum(TaskType).optional().describe("Task type"),
+        status: z11.enum(FailureStatus).optional().describe("Log status"),
+        keyword: z11.string().optional().describe("Search in refId, refSubId, errorMessage"),
+        startDate: z11.string().optional().describe("Start date (yyyy-MM-dd)"),
+        endDate: z11.string().optional().describe("End date (yyyy-MM-dd)")
       }
     },
-    async ({ page, size, category, taskType, status, keyword, startDate, endDate }) => {
+    async ({ page, size, taskType, status, keyword, startDate, endDate }) => {
       const params = paginationParams(page, size);
-      if (category) params.category = category;
       if (taskType) params.taskType = taskType;
       if (status) params.status = status;
       if (keyword) params.keyword = keyword;
@@ -4667,7 +4403,7 @@ function registerLogTools(server, callApi) {
       title: "Get Failure Log",
       description: "Get failure log detail by ID.",
       inputSchema: {
-        logId: z12.string().uuid().describe("Failure log ID")
+        logId: z11.string().uuid().describe("Failure log ID")
       }
     },
     async ({ logId }) => callApi("GET", `failure-logs/${logId}`)
@@ -4676,10 +4412,10 @@ function registerLogTools(server, callApi) {
     "lexq_logs_action",
     {
       title: "Process Failure Log",
-      description: "Process a single failure log: RETRY (re-execute with original payload), RESOLVE (mark as manually fixed), or IGNORE (skip intentionally).",
+      description: "Process a single failure log: RESOLVE (mark as manually fixed) or IGNORE (skip intentionally).",
       inputSchema: {
-        logId: z12.string().uuid().describe("Failure log ID"),
-        action: z12.enum(FailureAction).describe("Action to take")
+        logId: z11.string().uuid().describe("Failure log ID"),
+        action: z11.enum(FailureAction).describe("Action to take")
       }
     },
     async ({ logId, action }) => callApi("POST", `failure-logs/${logId}/actions`, {
@@ -4692,8 +4428,8 @@ function registerLogTools(server, callApi) {
       title: "Bulk Process Failure Logs",
       description: "Process multiple failure logs at once. Provide an array of log IDs and the action.",
       inputSchema: {
-        logIds: z12.array(z12.string().uuid()).describe("Array of failure log IDs"),
-        action: z12.enum(FailureAction).describe("Action to apply to all logs")
+        logIds: z11.array(z11.string().uuid()).describe("Array of failure log IDs"),
+        action: z11.enum(FailureAction).describe("Action to apply to all logs")
       }
     },
     async ({ logIds, action }) => callApi("POST", "failure-logs/bulk-actions", {
@@ -4703,7 +4439,7 @@ function registerLogTools(server, callApi) {
 }
 // src/mcp/tools/webhook-subscriptions.ts
-import { z as z13 } from "zod";
+import { z as z12 } from "zod";
 function registerWebhookSubscriptionTools(server, callApi) {
   server.registerTool(
     "lexq_webhook_subscriptions_list",
@@ -4711,8 +4447,8 @@ function registerWebhookSubscriptionTools(server, callApi) {
       title: "List Webhook Subscriptions",
       description: "List platform event webhook subscriptions. These receive deployment lifecycle notifications (publish, deploy, rollback, undeploy).",
       inputSchema: {
-        page: z13.number().int().min(0).default(0).describe("Page number"),
-        size: z13.number().int().min(1).max(100).default(20).describe("Page size")
+        page: z12.number().int().min(0).default(0).describe("Page number"),
+        size: z12.number().int().min(1).max(100).default(20).describe("Page size")
       }
     },
     async ({ page, size }) => {
@@ -4726,7 +4462,7 @@ function registerWebhookSubscriptionTools(server, callApi) {
       title: "Get Webhook Subscription",
       description: "Get webhook subscription detail by ID.",
       inputSchema: {
-        id: z13.string().uuid().describe("Webhook subscription ID")
+        id: z12.string().uuid().describe("Webhook subscription ID")
       }
     },
     async ({ id }) => callApi("GET", `webhook-subscriptions/${id}`)
@@ -4737,13 +4473,13 @@ function registerWebhookSubscriptionTools(server, callApi) {
       title: "Save Webhook Subscription",
       description: 'Create or update a webhook subscription. Omit id to create, provide id to update. Events: VERSION_PUBLISHED, DEPLOYED, ROLLED_BACK, UNDEPLOYED. Formats: GENERIC (full JSON), SLACK ({"text": "..."}).',
       inputSchema: {
-        id: z13.string().uuid().optional().describe("Subscription ID (omit to create, provide to update)"),
-        name: z13.string().min(1).describe("Subscription name (unique per tenant)"),
-        webhookUrl: z13.string().url().describe("Webhook endpoint URL"),
-        subscribedEvents: z13.array(z13.enum(PlatformEventType)).min(1).describe("Events to subscribe to"),
-        payloadFormat: z13.enum(WebhookPayloadFormat).optional().default("GENERIC").describe("Payload format"),
-        secret: z13.string().optional().describe("HMAC-SHA256 signing secret"),
-        isActive: z13.boolean().optional().default(true).describe("Whether the subscription is active")
+        id: z12.string().uuid().optional().describe("Subscription ID (omit to create, provide to update)"),
+        name: z12.string().min(1).describe("Subscription name (unique per tenant)"),
+        webhookUrl: z12.string().url().describe("Webhook endpoint URL"),
+        subscribedEvents: z12.array(z12.enum(PlatformEventType)).min(1).describe("Events to subscribe to"),
+        payloadFormat: z12.enum(WebhookPayloadFormat).optional().default("GENERIC").describe("Payload format"),
+        secret: z12.string().optional().describe("HMAC-SHA256 signing secret"),
+        isActive: z12.boolean().optional().default(true).describe("Whether the subscription is active")
       }
     },
     async ({ ...body }) => callApi("POST", "webhook-subscriptions", { body })
@@ -4754,7 +4490,7 @@ function registerWebhookSubscriptionTools(server, callApi) {
       title: "Delete Webhook Subscription",
       description: "Delete a webhook subscription by ID.",
       inputSchema: {
-        id: z13.string().uuid().describe("Webhook subscription ID")
+        id: z12.string().uuid().describe("Webhook subscription ID")
       }
     },
     async ({ id }) => callApi("DELETE", `webhook-subscriptions/${id}`)
@@ -4765,7 +4501,7 @@ function registerWebhookSubscriptionTools(server, callApi) {
       title: "Test Webhook Subscription",
       description: "Send a test event to verify webhook connectivity. Returns the HTTP status code and success/failure message.",
       inputSchema: {
-        id: z13.string().uuid().describe("Webhook subscription ID")
+        id: z12.string().uuid().describe("Webhook subscription ID")
       }
     },
     async ({ id }) => callApi("POST", `webhook-subscriptions/${id}/test`)
@@ -4773,7 +4509,7 @@ function registerWebhookSubscriptionTools(server, callApi) {
 }
 // src/mcp/tools/domain-templates.ts
-import { z as z14 } from "zod";
+import { z as z13 } from "zod";
 function registerDomainTemplateTools(server, callApi) {
   server.registerTool(
     "lexq_domain_templates_list",
@@ -4790,7 +4526,7 @@ function registerDomainTemplateTools(server, callApi) {
       title: "Preview Domain Template",
       description: "Preview exactly what a domain template will provision before applying it: the fact definitions it registers, the sample rules it creates, and an apply plan. This is a read-only dry run \u2014 nothing is created. Only ACTIVE templates can be previewed.",
       inputSchema: {
-        template: z14.string().describe(
+        template: z13.string().describe(
           "Domain template key (e.g. ECOMMERCE). Use lexq_domain_templates_list to see available keys \u2014 currently only ECOMMERCE is ACTIVE."
         )
       }
@@ -4803,8 +4539,8 @@ function registerDomainTemplateTools(server, callApi) {
       title: "Apply Domain Template",
       description: "Apply a domain template to the current tenant. Creates the template's fact definitions and a new policy group pre-populated with its sample rules as a DRAFT version. Existing facts are skipped \u2014 apply is additive and never overwrites existing schema. Run lexq_domain_templates_preview first to review what will be created. Only ACTIVE templates can be applied.",
       inputSchema: {
-        template: z14.string().describe("Domain template key to apply (e.g. ECOMMERCE)."),
-        customName: z14.string().optional().describe(
+        template: z13.string().describe("Domain template key to apply (e.g. ECOMMERCE)."),
+        customName: z13.string().optional().describe(
           "Optional custom name for the policy group that gets created. If omitted, the template's default name is used."
         )
       }
@@ -4830,7 +4566,6 @@ function registerAllTools(server, callApi) {
   registerReplayTools(server, callApi);
   registerHistoryTools(server, callApi);
   registerProvenanceTools(server, callApi);
-  registerIntegrationTools(server, callApi);
   registerLogTools(server, callApi);
   registerDomainTemplateTools(server, callApi);
   registerWebhookSubscriptionTools(server, callApi);
@@ -4861,7 +4596,7 @@ async function startMcpServer() {
 function registerServeCommand(program) {
   program.command("serve").description("Start LexQ as a server for AI agent integrations").option("--mcp", "Start as MCP (Model Context Protocol) server over stdio").addHelpText(
     "after",
-    dedent18`
+    dedent17`
         Example:
           $ lexq serve --mcp
@@ -4892,11 +4627,11 @@ function registerServeCommand(program) {
 // src/commands/domain-templates.ts
 import "commander";
-import dedent19 from "dedent";
+import dedent18 from "dedent";
 function registerDomainTemplateCommands(program) {
   const templates = program.command("domain-templates").description("Browse and apply domain templates").addHelpText(
     "after",
-    dedent19`
+    dedent18`
         A domain template is an industry-specific starter pack of fact
         definitions and sample rules. Applying one provisions a ready-to-use
@@ -4944,7 +4679,7 @@ function registerDomainTemplateCommands(program) {
   });
   templates.command("preview").description("Preview what a domain template provisions").requiredOption("--template <key>", "Domain template key (e.g. ECOMMERCE)").addHelpText(
     "after",
-    dedent19`
+    dedent18`
         Read-only dry run — shows the fact definitions and sample rules the
         template will create. Nothing is provisioned.
@@ -4973,7 +4708,7 @@ function registerDomainTemplateCommands(program) {
   });
   templates.command("apply").description("Apply a domain template to the current tenant").requiredOption("--template <key>", "Domain template key (e.g. ECOMMERCE)").option("--name <n>", "Custom name for the policy group that gets created").option("--force", "Skip confirmation prompt").addHelpText(
     "after",
-    dedent19`
+    dedent18`
         Creates the template's fact definitions and a new DRAFT policy group
         populated with its sample rules. Existing facts are skipped — apply is
@@ -5052,7 +4787,6 @@ function createCli() {
   registerHistoryCommands(program);
   registerReplayCommands(program);
   registerProvenanceCommands(program);
-  registerIntegrationCommands(program);
   registerLogCommands(program);
   registerWebhookSubscriptionCommands(program);
   registerServeCommand(program);