@lexq/cli 0.1.29 → 0.1.31

package/dist/index.js

@@ -300,13 +300,14 @@ function registerGroupCommands(program) {
           get         Get group detail by ID
           create      Create a new group
           update      Update group settings
+          reorder     Change group priorities (drag & drag equivalent)
           delete      Archive a group
           ab-test     Manage A/B tests (start, stop, adjust)
 
         Statuses: ACTIVE, DISABLED (emergency stop), ARCHIVED (soft delete)
       `
   );
-  groups.command("list").description("List all policy groups").option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").action(async (opts) => {
+  groups.command("list").description("List all policy groups").action(async () => {
     try {
       const globalOpts = program.opts();
       const format = globalOpts.format ?? "json";
@@ -314,13 +315,12 @@ function registerGroupCommands(program) {
         apiKey: globalOpts.apiKey,
         baseUrl: globalOpts.baseUrl,
         dryRun: globalOpts.dryRun,
-        verbose: globalOpts.verbose,
-        params: { page: opts.page, size: opts.size }
+        verbose: globalOpts.verbose
       });
       if (format === "table") {
         printTable(
           ["ID", "Name", "Status", "Priority", "Version", "Updated"],
-          data.content.map((g) => [
+          data.map((g) => [
             g.id,
             g.name,
             g.status,
@@ -331,7 +331,7 @@ function registerGroupCommands(program) {
           { truncate: 24 }
         );
         console.log(`
-${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
+${data.length} total`);
       } else {
         printJson(data);
       }
@@ -362,19 +362,20 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
         Example:
           $ lexq groups create --json '{
               "name": "Payment Policy",
-              "description": "Rules for payment processing",
-              "priority": 0
+              "description": "Rules for payment processing"
             }'
 
         Fields:
           name                string    Group name (required, unique per tenant)
           description         string    Description (optional, max 255 chars)
-          priority            number    Execution priority — lower runs first (required, min 0)
-          activationGroup     string    Cross-group conflict resolution key (optional)
+          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]
           executionLimit      number    Max rules to fire in MAX_N mode (optional)
           status              string    ACTIVE | DISABLED  [default: ACTIVE]
+        
+        priority is auto-assigned (appended last, tenant-wide). Use 'lexq groups reorder' to change order.
+        Groups sharing an activationGroup must share the same activationMode / activationStrategy / executionLimit.
       `
   ).action(async (opts) => {
     try {
@@ -398,9 +399,9 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
     dedent3`
 
         Example:
-          $ lexq groups update --id <groupId> --json '{"description": "Updated", "priority": 1}'
+          $ lexq groups update --id <groupId> --json '{"description": "Updated", "status": "DISABLED"}'
 
-        All fields are optional — only provided fields are updated.
+        All fields are optional — only provided fields are updated. priority is not settable here — use 'lexq groups reorder'.
       `
   ).action(async (opts) => {
     try {
@@ -450,6 +451,41 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       process.exit(1);
     }
   });
+  groups.command("reorder").description("Reorder policy groups by priority (drag & drop equivalent)").requiredOption("--group-ids <ids>", "Comma-separated group IDs in desired order").addHelpText(
+    "after",
+    dedent3`
+
+        Assigns priority 1, 2, 3, ... to groups in the order given (tenant-wide, 1...N continuous).
+        activationGroup (Execution Group) is NOT affected — reorder only changes priority.
+
+        Example:
+          $ lexq groups reorder --group-ids "id3,id1,id2"
+
+          Result: id3 → priority 1, id1 → priority 2, id2 → priority 3
+      `
+  ).action(async (opts) => {
+    try {
+      const globalOpts = program.opts();
+      const groupIds = opts.groupIds.split(",").map((id) => id.trim());
+      const body = {
+        groups: groupIds.map((groupId, index) => ({
+          groupId,
+          priority: index + 1
+        }))
+      };
+      await apiRequest("PATCH", "policy-groups/reorder", {
+        apiKey: globalOpts.apiKey,
+        baseUrl: globalOpts.baseUrl,
+        dryRun: globalOpts.dryRun,
+        verbose: globalOpts.verbose,
+        body
+      });
+      console.log(`\u2713 ${groupIds.length} groups reordered.`);
+    } catch (error) {
+      printError(error);
+      process.exit(1);
+    }
+  });
   const abTest = groups.command("ab-test").description("A/B test management").addHelpText(
     "after",
     dedent3`
@@ -803,7 +839,7 @@ function registerRuleCommands(program) {
         Only DRAFT versions allow rule modifications.
       `
   );
-  rules.command("list").description("List rules for a policy version").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Policy version ID").option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").action(async (opts) => {
+  rules.command("list").description("List rules for a policy version").requiredOption("--group-id <groupId>", "Policy group ID").requiredOption("--version-id <versionId>", "Policy version ID").action(async (opts) => {
     try {
       const globalOpts = program.opts();
       const format = globalOpts.format ?? "json";
@@ -814,14 +850,13 @@ function registerRuleCommands(program) {
           apiKey: globalOpts.apiKey,
           baseUrl: globalOpts.baseUrl,
           dryRun: globalOpts.dryRun,
-          verbose: globalOpts.verbose,
-          params: { page: opts.page, size: opts.size }
+          verbose: globalOpts.verbose
         }
       );
       if (format === "table") {
         printTable(
           ["ID", "Name", "Priority", "Conditions", "Actions", "Enabled"],
-          data.content.map((r) => [
+          data.map((r) => [
             r.id,
             r.name,
             String(r.priority),
@@ -832,7 +867,7 @@ function registerRuleCommands(program) {
           { truncate: 24 }
         );
         console.log(`
-${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
+${data.length} total`);
       } else {
         printJson(data);
       }
@@ -867,7 +902,6 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
         Example:
           $ lexq rules create --group-id <gid> --version-id <vid> --json '{
               "name": "VIP 20% Discount",
-              "priority": 0,
               "condition": {
                 "type": "SINGLE",
                 "field": "customer_tier",
@@ -891,8 +925,11 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
 
         Mutex (optional — rule-level conflict resolution):
           mutexGroup       string    Logical grouping key (e.g., "best-discount")
-          mutexMode        string    NONE | EXCLUSIVE  [default: NONE]
+          mutexMode        string    NONE | EXCLUSIVE | MAX_N  [default: NONE]
           mutexStrategy    string    FIRST_MATCH | HIGHEST_PRIORITY | MAX_BENEFIT
+          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.
       `
   ).action(async (opts) => {
     try {
@@ -983,12 +1020,12 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
     "after",
     dedent5`
 
-        Assigns priority 0, 1, 2, ... to rules in the order given.
+        Assigns priority 1, 2, 3, ... to rules in the order given (1-based, 1...N continuous).
 
         Example:
           $ lexq rules reorder --group-id <gid> --version-id <vid> --rule-ids "id3,id1,id2"
 
-          Result: id3 → priority 0, id1 → priority 1, id2 → priority 2
+          Result: id3 → priority 1, id1 → priority 2, id2 → priority 3
       `
   ).action(async (opts) => {
     try {
@@ -997,7 +1034,7 @@ ${data.totalElements} total \xB7 page ${data.pageNo + 1}/${data.totalPages}`);
       const body = {
         rules: ruleIds.map((ruleId, index) => ({
           ruleId,
-          priority: index
+          priority: index + 1
         }))
       };
       await apiRequest(
@@ -1067,7 +1104,7 @@ function registerFactCommands(program) {
           delete           Remove a fact definition
           action-metadata  Show action runtime fact metadata
 
-        System facts (payment_amount, user_id, etc.) are auto-created and immutable.
+        System facts (user_id, user_tags) are auto-created.
       `
   );
   facts.command("list").description("List fact definitions").option("--keyword <keyword>", "Filter by keyword").option("--page <number>", "Page number", "0").option("--size <number>", "Page size", "20").action(async (opts) => {
@@ -2868,16 +2905,10 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_list",
     {
       title: "List Policy Groups",
-      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")
-      }
+      description: "List all policy groups (tenant-wide, priority ASC).",
+      inputSchema: {}
     },
-    async ({ page, size }) => {
-      const params = paginationParams(page, size);
-      return callApi("GET", "policy-groups", { params });
-    }
+    async () => callApi("GET", "policy-groups")
   );
   server.registerTool(
     "lexq_groups_get",
@@ -2894,10 +2925,9 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_create",
     {
       title: "Create Policy Group",
-      description: "Create a new policy group. Requires name and priority. Optionally set conflict resolution, activation group, and description.",
+      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Groups sharing an activationGroup must share the same activationMode / activationStrategy / executionLimit.",
       inputSchema: {
         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"),
         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"),
@@ -2907,8 +2937,7 @@ function registerGroupTools(server, callApi) {
     },
     async (args) => {
       const body = {
-        name: args.name,
-        priority: args.priority
+        name: args.name
       };
       if (args.description !== void 0) body.description = args.description;
       if (args.activationMode !== void 0) body.activationMode = args.activationMode;
@@ -2926,9 +2955,9 @@ function registerGroupTools(server, callApi) {
       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)"),
+        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"),
         executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
@@ -2947,6 +2976,23 @@ function registerGroupTools(server, callApi) {
     },
     async ({ groupId }) => callApi("DELETE", `policy-groups/${groupId}`)
   );
+  server.registerTool(
+    "lexq_groups_reorder",
+    {
+      title: "Reorder Policy Groups",
+      description: "Reorder policy groups by priority. Priority is tenant-wide and flat (1...N continuous); array index 0 = priority 1 (highest precedence). activationGroup is not affected \u2014 this only changes priority.",
+      inputSchema: {
+        groupIds: z.array(z.string().uuid()).describe("Group IDs in desired priority order (index 0 = priority 1)")
+      }
+    },
+    async ({ groupIds }) => {
+      const groups = groupIds.map((groupId, index) => ({
+        groupId,
+        priority: index + 1
+      }));
+      return callApi("PATCH", "policy-groups/reorder", { body: { groups } });
+    }
+  );
   server.registerTool(
     "lexq_ab_test_start",
     {
@@ -3082,17 +3128,13 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_list",
     {
       title: "List Rules",
-      description: "List all rules in a version. Returns summary with conditionSummary and actionSummary.",
+      description: "List all rules in a version (priority ASC). Returns summary with conditionSummary and actionSummary.",
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
-        versionId: z3.string().uuid().describe("Version ID"),
-        page: z3.number().int().min(0).default(0).describe("Page number"),
-        size: z3.number().int().min(1).max(100).default(20).describe("Page size")
+        versionId: z3.string().uuid().describe("Version ID")
       }
     },
-    async ({ groupId, versionId, page, size }) => callApi("GET", `policy-groups/${groupId}/versions/${versionId}/rules`, {
-      params: paginationParams(page, size)
-    })
+    async ({ groupId, versionId }) => callApi("GET", `policy-groups/${groupId}/versions/${versionId}/rules`)
   );
   server.registerTool(
     "lexq_rules_get",
@@ -3112,7 +3154,7 @@ function registerRuleTools(server, callApi) {
     {
       title: "Create Rule",
       description: dedent13`
-        Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array.
+        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.
         If a required key is missing, ask the user to confirm the type, isRequired, and description
@@ -3127,7 +3169,7 @@ function registerRuleTools(server, callApi) {
 
         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 } Note: external system call (e.g. point system sync) is NOT a primitive responsibility. Compose [INCREMENT_FACT, EMIT_EVENT] chain instead.
+        - 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). notificationPayload (channel, templateId, body, variables, etc.) is passed through to the provider.
@@ -3145,7 +3187,7 @@ function registerRuleTools(server, callApi) {
         groupId: z3.string().uuid().describe("Policy group ID"),
         versionId: z3.string().uuid().describe("Version ID"),
         rule: z3.string().describe(
-          "JSON string of CreateRuleRequest: { name, priority, condition, actions, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
+          "JSON string of CreateRuleRequest: { name, condition, actions, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
         )
       }
     },
@@ -3164,7 +3206,7 @@ function registerRuleTools(server, callApi) {
         versionId: z3.string().uuid().describe("Version ID"),
         ruleId: z3.string().uuid().describe("Rule ID"),
         rule: z3.string().describe(
-          "JSON string of UpdateRuleRequest: { name?, priority?, condition?, actions?, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
+          "JSON string of UpdateRuleRequest: { name?, condition?, actions?, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
         )
       }
     },
@@ -3199,7 +3241,7 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_reorder",
     {
       title: "Reorder Rules",
-      description: "Reorder rules by specifying rule IDs and their new priorities. Array index 0 = highest priority.",
+      description: "Reorder rules by specifying rule IDs in desired order. Priorities are assigned 1...N (1-based, continuous); array index 0 = priority 1 (highest precedence).",
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
         versionId: z3.string().uuid().describe("Version ID"),
@@ -3209,7 +3251,7 @@ function registerRuleTools(server, callApi) {
     async ({ groupId, versionId, ruleIds }) => {
       const rules = ruleIds.map((ruleId, index) => ({
         ruleId,
-        priority: index
+        priority: index + 1
       }));
       return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
         body: { rules }
@@ -3298,7 +3340,7 @@ function registerFactTools(server, callApi) {
     "lexq_facts_action_metadata",
     {
       title: "Get Action Runtime Fact Metadata",
-      description: "Retrieve runtime Facts metadata for each Action type. Shows which Facts are required as input, produced as output, or consumed at runtime by each Action (MUTATE_FACT, INCREMENT_FACT, EMIT_EVENT, BLOCK, EMIT_NOTIFICATION, EMIT_WEBHOOK, SET_FACT, ADD_TAG). Use this BEFORE designing rules to understand which Action mutates which fact (e.g., MUTATE_FACT mutates the refVar fact and auto-generates {fact_name}__delta in generatedVariables). Data is static and changes only on engine deployment \u2014 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 (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.",
       inputSchema: {}
     },
     async () => callApi("GET", "schema/action-metadata")

package/dist/mcp/register.js

@@ -13,38 +13,15 @@ function registerStatusTools(server, callApi) {
 
 // src/mcp/tools/groups.ts
 import { z } from "zod";
-
-// src/lib/config.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-var CONFIG_DIR = join(homedir(), ".lexq");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
-
-// src/mcp/tools/_shared.ts
-function paginationParams(page, size) {
-  const params = {};
-  if (page !== void 0) params.page = String(page);
-  if (size !== void 0) params.size = String(size);
-  return params;
-}
-
-// src/mcp/tools/groups.ts
 function registerGroupTools(server, callApi) {
   server.registerTool(
     "lexq_groups_list",
     {
       title: "List Policy Groups",
-      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")
-      }
+      description: "List all policy groups (tenant-wide, priority ASC).",
+      inputSchema: {}
     },
-    async ({ page, size }) => {
-      const params = paginationParams(page, size);
-      return callApi("GET", "policy-groups", { params });
-    }
+    async () => callApi("GET", "policy-groups")
   );
   server.registerTool(
     "lexq_groups_get",
@@ -61,10 +38,9 @@ function registerGroupTools(server, callApi) {
     "lexq_groups_create",
     {
       title: "Create Policy Group",
-      description: "Create a new policy group. Requires name and priority. Optionally set conflict resolution, activation group, and description.",
+      description: "Create a new policy group. Requires name. Priority is auto-assigned (appended last, tenant-wide); use lexq_groups_reorder to change order. Optionally set conflict resolution, activation group, and description. Groups sharing an activationGroup must share the same activationMode / activationStrategy / executionLimit.",
       inputSchema: {
         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"),
         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"),
@@ -74,8 +50,7 @@ function registerGroupTools(server, callApi) {
     },
     async (args) => {
       const body = {
-        name: args.name,
-        priority: args.priority
+        name: args.name
       };
       if (args.description !== void 0) body.description = args.description;
       if (args.activationMode !== void 0) body.activationMode = args.activationMode;
@@ -93,9 +68,9 @@ function registerGroupTools(server, callApi) {
       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)"),
+        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"),
         executionLimit: z.number().int().min(1).optional().describe("Max rule executions")
@@ -114,6 +89,23 @@ function registerGroupTools(server, callApi) {
     },
     async ({ groupId }) => callApi("DELETE", `policy-groups/${groupId}`)
   );
+  server.registerTool(
+    "lexq_groups_reorder",
+    {
+      title: "Reorder Policy Groups",
+      description: "Reorder policy groups by priority. Priority is tenant-wide and flat (1...N continuous); array index 0 = priority 1 (highest precedence). activationGroup is not affected \u2014 this only changes priority.",
+      inputSchema: {
+        groupIds: z.array(z.string().uuid()).describe("Group IDs in desired priority order (index 0 = priority 1)")
+      }
+    },
+    async ({ groupIds }) => {
+      const groups = groupIds.map((groupId, index) => ({
+        groupId,
+        priority: index + 1
+      }));
+      return callApi("PATCH", "policy-groups/reorder", { body: { groups } });
+    }
+  );
   server.registerTool(
     "lexq_ab_test_start",
     {
@@ -154,6 +146,23 @@ function registerGroupTools(server, callApi) {
 
 // src/mcp/tools/versions.ts
 import { z as z2 } from "zod";
+
+// src/lib/config.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_DIR = join(homedir(), ".lexq");
+var CONFIG_FILE = join(CONFIG_DIR, "config.json");
+
+// src/mcp/tools/_shared.ts
+function paginationParams(page, size) {
+  const params = {};
+  if (page !== void 0) params.page = String(page);
+  if (size !== void 0) params.size = String(size);
+  return params;
+}
+
+// src/mcp/tools/versions.ts
 function registerVersionTools(server, callApi) {
   server.registerTool(
     "lexq_versions_list",
@@ -249,17 +258,13 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_list",
     {
       title: "List Rules",
-      description: "List all rules in a version. Returns summary with conditionSummary and actionSummary.",
+      description: "List all rules in a version (priority ASC). Returns summary with conditionSummary and actionSummary.",
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
-        versionId: z3.string().uuid().describe("Version ID"),
-        page: z3.number().int().min(0).default(0).describe("Page number"),
-        size: z3.number().int().min(1).max(100).default(20).describe("Page size")
+        versionId: z3.string().uuid().describe("Version ID")
       }
     },
-    async ({ groupId, versionId, page, size }) => callApi("GET", `policy-groups/${groupId}/versions/${versionId}/rules`, {
-      params: paginationParams(page, size)
-    })
+    async ({ groupId, versionId }) => callApi("GET", `policy-groups/${groupId}/versions/${versionId}/rules`)
   );
   server.registerTool(
     "lexq_rules_get",
@@ -279,7 +284,7 @@ function registerRuleTools(server, callApi) {
     {
       title: "Create Rule",
       description: dedent`
-        Create a rule in a DRAFT version. Requires name, priority, condition tree, and actions array.
+        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.
         If a required key is missing, ask the user to confirm the type, isRequired, and description
@@ -294,7 +299,7 @@ function registerRuleTools(server, callApi) {
 
         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 } Note: external system call (e.g. point system sync) is NOT a primitive responsibility. Compose [INCREMENT_FACT, EMIT_EVENT] chain instead.
+        - 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). notificationPayload (channel, templateId, body, variables, etc.) is passed through to the provider.
@@ -312,7 +317,7 @@ function registerRuleTools(server, callApi) {
         groupId: z3.string().uuid().describe("Policy group ID"),
         versionId: z3.string().uuid().describe("Version ID"),
         rule: z3.string().describe(
-          "JSON string of CreateRuleRequest: { name, priority, condition, actions, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
+          "JSON string of CreateRuleRequest: { name, condition, actions, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
         )
       }
     },
@@ -331,7 +336,7 @@ function registerRuleTools(server, callApi) {
         versionId: z3.string().uuid().describe("Version ID"),
         ruleId: z3.string().uuid().describe("Rule ID"),
         rule: z3.string().describe(
-          "JSON string of UpdateRuleRequest: { name?, priority?, condition?, actions?, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
+          "JSON string of UpdateRuleRequest: { name?, condition?, actions?, mutexGroup?, mutexMode?, mutexStrategy?, mutexLimit?, isEnabled? }"
         )
       }
     },
@@ -366,7 +371,7 @@ function registerRuleTools(server, callApi) {
     "lexq_rules_reorder",
     {
       title: "Reorder Rules",
-      description: "Reorder rules by specifying rule IDs and their new priorities. Array index 0 = highest priority.",
+      description: "Reorder rules by specifying rule IDs in desired order. Priorities are assigned 1...N (1-based, continuous); array index 0 = priority 1 (highest precedence).",
       inputSchema: {
         groupId: z3.string().uuid().describe("Policy group ID"),
         versionId: z3.string().uuid().describe("Version ID"),
@@ -376,7 +381,7 @@ function registerRuleTools(server, callApi) {
     async ({ groupId, versionId, ruleIds }) => {
       const rules = ruleIds.map((ruleId, index) => ({
         ruleId,
-        priority: index
+        priority: index + 1
       }));
       return callApi("PATCH", `policy-groups/${groupId}/versions/${versionId}/rules/reorder`, {
         body: { rules }
@@ -465,7 +470,7 @@ function registerFactTools(server, callApi) {
     "lexq_facts_action_metadata",
     {
       title: "Get Action Runtime Fact Metadata",
-      description: "Retrieve runtime Facts metadata for each Action type. Shows which Facts are required as input, produced as output, or consumed at runtime by each Action (MUTATE_FACT, INCREMENT_FACT, EMIT_EVENT, BLOCK, EMIT_NOTIFICATION, EMIT_WEBHOOK, SET_FACT, ADD_TAG). Use this BEFORE designing rules to understand which Action mutates which fact (e.g., MUTATE_FACT mutates the refVar fact and auto-generates {fact_name}__delta in generatedVariables). Data is static and changes only on engine deployment \u2014 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 (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.",
       inputSchema: {}
     },
     async () => callApi("GET", "schema/action-metadata")

package/package.json

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