@lexq/cli 0.1.53 → 0.1.54

package/AGENTS.md

@@ -129,8 +129,9 @@ Place this file in the project root. The IDE will auto-discover it.
 
 ### Claude Code
 
-Reads this file via the root `CLAUDE.md` pointer. No separate context file — this document and `skills/` are the whole
-guide.
+Reads this file through the root `CLAUDE.md`, which is a one-line import rather than a copy. There is no
+Claude-specific document to keep in sync. The CLI guide is this file plus `skills/`; `CONTEXT.md` covers platform
+architecture separately and ships alongside.
 
 ### Gemini CLI
 

package/dist/index.js

@@ -2359,6 +2359,7 @@ import "commander";
 import dedent9 from "dedent";
 
 // src/types/enums.ts
+var ValueType = ["STRING", "NUMBER", "BOOLEAN", "LIST_STRING", "LIST_NUMBER"];
 var ConflictResolutionMode = ["NONE", "EXCLUSIVE", "MAX_N"];
 var ConflictResolutionStrategy = ["HIGHEST_PRIORITY"];
 var ProfileCacheState = ["HIT", "MISS"];
@@ -3722,6 +3723,7 @@ import { z as z4 } from "zod";
 var FACT_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]*$/;
 
 // src/mcp/tools/facts.ts
+var VALUE_TYPES = ValueType;
 function registerFactTools(server, callApi) {
   server.registerTool(
     "lexq_facts_list",
@@ -3748,7 +3750,7 @@ function registerFactTools(server, callApi) {
       inputSchema: {
         key: z4.string().regex(FACT_KEY_PATTERN).describe("Variable key. Any casing; must start with a letter."),
         name: z4.string().describe("Display name"),
-        type: z4.enum(["STRING", "NUMBER", "BOOLEAN", "LIST_STRING", "LIST_NUMBER"]).describe("Value type"),
+        type: z4.enum(VALUE_TYPES).describe("Value type"),
         description: z4.string().optional().describe("Description"),
         isRequired: z4.boolean().default(false).describe("Whether this fact is required for rule evaluation"),
         isPii: z4.boolean().default(false).describe(
@@ -3762,11 +3764,14 @@ function registerFactTools(server, callApi) {
     "lexq_facts_update",
     {
       title: "Update Fact Definition",
-      description: "Update a fact definition. Key and type cannot be changed. Only provided fields are updated. System facts only allow name, description, and PII changes.",
+      description: "Update a fact definition. The key is immutable. The type can change only while no rule references the fact; if any does, the call fails with FD-007 and reports the count. Only the fields you send are changed. System facts accept name, description, and PII only.",
       inputSchema: {
         factId: z4.string().uuid().describe("Fact definition ID"),
         name: z4.string().optional().describe("Display name"),
         description: z4.string().optional().describe("Description"),
+        type: z4.enum(VALUE_TYPES).optional().describe(
+          "Value type. Omit to leave it unchanged. Changing it fails with FD-007 while any rule references the fact."
+        ),
         isRequired: z4.boolean().optional().describe("Required flag"),
         isPii: z4.boolean().optional().describe("PII flag \u2014 enables/disables masking (changeable even on system facts)")
       }
@@ -3777,7 +3782,7 @@ function registerFactTools(server, callApi) {
     "lexq_facts_delete",
     {
       title: "Delete Fact Definition",
-      description: "Delete a fact definition. System facts cannot be deleted.",
+      description: "Delete a fact definition. System facts cannot be deleted. Neither can a fact that any rule references: that call fails with FD-006 and reports the count. Remove the references first.",
       inputSchema: {
         factId: z4.string().uuid().describe("Fact definition ID")
       }

package/dist/mcp/register.js

@@ -15,6 +15,7 @@ function registerStatusTools(server, callApi) {
 import { z } from "zod";
 
 // src/types/enums.ts
+var ValueType = ["STRING", "NUMBER", "BOOLEAN", "LIST_STRING", "LIST_NUMBER"];
 var ConflictResolutionMode = ["NONE", "EXCLUSIVE", "MAX_N"];
 var ConflictResolutionStrategy = ["HIGHEST_PRIORITY"];
 var FailureStatus = ["PENDING", "RESOLVED", "IGNORED"];
@@ -514,6 +515,7 @@ import { z as z4 } from "zod";
 var FACT_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]*$/;
 
 // src/mcp/tools/facts.ts
+var VALUE_TYPES = ValueType;
 function registerFactTools(server, callApi) {
   server.registerTool(
     "lexq_facts_list",
@@ -540,7 +542,7 @@ function registerFactTools(server, callApi) {
       inputSchema: {
         key: z4.string().regex(FACT_KEY_PATTERN).describe("Variable key. Any casing; must start with a letter."),
         name: z4.string().describe("Display name"),
-        type: z4.enum(["STRING", "NUMBER", "BOOLEAN", "LIST_STRING", "LIST_NUMBER"]).describe("Value type"),
+        type: z4.enum(VALUE_TYPES).describe("Value type"),
         description: z4.string().optional().describe("Description"),
         isRequired: z4.boolean().default(false).describe("Whether this fact is required for rule evaluation"),
         isPii: z4.boolean().default(false).describe(
@@ -554,11 +556,14 @@ function registerFactTools(server, callApi) {
     "lexq_facts_update",
     {
       title: "Update Fact Definition",
-      description: "Update a fact definition. Key and type cannot be changed. Only provided fields are updated. System facts only allow name, description, and PII changes.",
+      description: "Update a fact definition. The key is immutable. The type can change only while no rule references the fact; if any does, the call fails with FD-007 and reports the count. Only the fields you send are changed. System facts accept name, description, and PII only.",
       inputSchema: {
         factId: z4.string().uuid().describe("Fact definition ID"),
         name: z4.string().optional().describe("Display name"),
         description: z4.string().optional().describe("Description"),
+        type: z4.enum(VALUE_TYPES).optional().describe(
+          "Value type. Omit to leave it unchanged. Changing it fails with FD-007 while any rule references the fact."
+        ),
         isRequired: z4.boolean().optional().describe("Required flag"),
         isPii: z4.boolean().optional().describe("PII flag \u2014 enables/disables masking (changeable even on system facts)")
       }
@@ -569,7 +574,7 @@ function registerFactTools(server, callApi) {
     "lexq_facts_delete",
     {
       title: "Delete Fact Definition",
-      description: "Delete a fact definition. System facts cannot be deleted.",
+      description: "Delete a fact definition. System facts cannot be deleted. Neither can a fact that any rule references: that call fails with FD-006 and reports the count. Remove the references first.",
       inputSchema: {
         factId: z4.string().uuid().describe("Fact definition ID")
       }

package/package.json

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

package/skills/lexq-shared/SKILL.md

@@ -141,7 +141,7 @@ Prefixes you will encounter through the CLI:
 | `A-`   | Auth                  | Invalid or missing API key                     |
 | `P-`   | Policy group/version  | Not found, wrong lifecycle state, already live |
 | `ACT-` | Action parameters     | Missing or invalid action parameter            |
-| `FD-`  | Fact definitions      | Duplicate key, system fact immutable           |
+| `FD-`  | Fact definitions      | Duplicate key, system fact immutable, fact still referenced by rules |
 | `AN-`  | Analytics             | Dry-run or simulation failure                  |
 | `FL-`  | Failure logs          | Log not found                                  |
 | `WH-`  | Webhook subscriptions | Invalid URL, delivery failure                  |