@wirecat/cli-base 0.75.0 → 0.75.1

package/CHANGELOG.md

@@ -8,6 +8,16 @@ Versions before 0.8.0 are in the [git tags](https://github.com/WireCatLabs/cli-b
 Every entry says what changed as a caller sees it, why, and what to watch for — the rules are
 [`docs/dev/CONVENTIONS.md`](docs/dev/CONVENTIONS.md#the-changelog).
 
+## 0.75.1 — 02.11.2026
+
+### Fixed
+
+- **A list's help and MCP `query` description no longer offer `word*` or ranges that none of its fields takes.**
+  `fieldsHelp`'s `Syntax:` line on a `backend: "sql"` list now lists the phrase, `word*` and `[a TO b] · > >= < <=`
+  forms only when one of its shown fields takes them, as a native list's line already did; `AND OR NOT` and `( )`
+  stay. A list of whole values only (enum, bool) said it took both, and refused them. `queryDescription` drops
+  `[a TO b], > <` the same way. A list whose fields take every form prints the same line as before.
+
 ## 0.75.0 — 02.11.2026
 
 ### Fixed

package/dist/query/help.js

@@ -2,18 +2,14 @@ export const QUERY_SYNTAX = 'field:value · "a phrase" · word* · AND OR NOT ·
 const shownOf = (registry) => registry.backend === "native" ? registry.fields.filter((field) => field.native) : registry.fields;
 const leftOut = (fields) => fields.filter((field) => field.negatable).map((field) => field.name);
 const has = (fields, operator) => fields.some((field) => field.operators.includes(operator));
-// A provider takes only field:value joined by AND, so a native list advertises no OR and no grouping.
-const syntaxOf = (shown, backend) => {
-    if (backend !== "native")
-        return QUERY_SYNTAX;
-    return [
-        "field:value",
-        ...(has(shown, "phrase") ? ['"a phrase"'] : []),
-        ...(has(shown, "wildcard") ? ["word*"] : []),
-        "terms joined by AND",
-        ...(has(shown, "range") ? ["[a TO b] · > >= < <="] : []),
-    ].join(" · ");
-};
+// Each form is offered only when a shown field takes it, and a provider takes no OR and no grouping.
+const syntaxOf = (shown, backend) => [
+    "field:value",
+    ...(has(shown, "phrase") ? ['"a phrase"'] : []),
+    ...(has(shown, "wildcard") ? ["word*"] : []),
+    ...(backend === "native" ? ["terms joined by AND"] : ["AND OR NOT", "( )"]),
+    ...(has(shown, "range") ? ["[a TO b] · > >= < <="] : []),
+].join(" · ");
 const kindOf = (field) => field.values ? `${field.type}: ${field.values.join("|")}` : `${field.type}: ${field.operators.join(", ")}`;
 /** The Fields section of a list's help: one line per field it filters by, its defaults, the syntax and the guide. */
 export const fieldsHelp = (registry, guide) => {
@@ -47,7 +43,7 @@ export const queryDescription = (registry) => {
         ? `field:value terms joined by AND that narrow the list${negatable.length > 0
             ? `; -field:value or NOT field:value leaves out what matches, for ${negatable.join(", ")} only`
             : ""}`
-        : "field:value terms that narrow the list (Lucene: AND OR NOT, -field:value, [a TO b], > <)";
+        : `field:value terms that narrow the list (Lucene: AND OR NOT, -field:value${has(shown, "range") ? ", [a TO b], > <" : ""})`;
     const fields = shown.map((field) => (field.values ? `${field.name} (${field.values.join("|")})` : field.name));
     const defaults = registry.defaults?.length ? `; unless named: ${registry.defaults.join(" ")}` : "";
     return `${terms}; fields: ${fields.join(", ")}; e.g. ${shown[0]?.example ?? ""}${defaults}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-base",
-  "version": "0.75.0",
+  "version": "0.75.1",
   "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",