stitchkit 0.103.2 → 0.103.3

package/CHANGELOG.md

@@ -15,6 +15,14 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.103.3] — 2026-10-01
+
+### Fixed
+
+- CLI help displays schema numeric bounds, string lengths and array item counts for
+  contract, runtime and native commands, and application options. Alternative schemas
+  keep their bounds in separate branches; argument validation is unchanged.
+
 ## [0.103.2] — 2026-10-01
 
 ### Fixed

package/dist/entrypoints/cli.js

@@ -18,7 +18,7 @@ import {
   renderCliView2,
   pollUntilDone2,
   createCli2
-} from "../index-1br6gwhf.js";
+} from "../index-ahtnte39.js";
 import {
   AppError2
 } from "../index-n53mswt3.js";

package/dist/entrypoints/tools.js

@@ -77,7 +77,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-1br6gwhf.js";
+} from "../index-ahtnte39.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2

package/dist/{index-1br6gwhf.js → index-ahtnte39.js}

@@ -1811,6 +1811,46 @@ function typeLabel(schema) {
     return schema.type;
   return "value";
 }
+function constraintLabel(schema) {
+  const limits = [];
+  const bounds = [
+    ["minimum", ">="],
+    ["exclusiveMinimum", ">"],
+    ["maximum", "<="],
+    ["exclusiveMaximum", "<"],
+    ["minLength", "length >="],
+    ["maxLength", "length <="],
+    ["minItems", "items >="],
+    ["maxItems", "items <="]
+  ];
+  for (const [keyword, label] of bounds) {
+    const bound = schema[keyword];
+    if (typeof bound === "number")
+      limits.push(`${label}${bound}`);
+  }
+  const compositions = [
+    ["anyOf", "any of", " | "],
+    ["oneOf", "one of", " | "],
+    ["allOf", "all of", " & "]
+  ];
+  for (const [keyword, label, separator] of compositions) {
+    const members = schema[keyword];
+    if (!Array.isArray(members))
+      continue;
+    const branches = members.map((member) => {
+      const constraints = isRecord(member) ? constraintLabel(member) : "";
+      const type = isRecord(member) ? typeLabel(member) : member === false ? "no value" : "any value";
+      return { constraints, text: `${type}${constraints}` };
+    });
+    if (branches.every((branch) => branch.constraints === ""))
+      continue;
+    limits.push(`${label}: ${branches.map((branch) => branch.text).join(separator)}`);
+  }
+  return limits.length === 0 ? "" : ` [${limits.join(", ")}]`;
+}
+function fieldTypeLabel(schema) {
+  return `<${typeLabel(schema)}>${constraintLabel(schema)}`;
+}
 function padRight(text, width) {
   return text.length >= width ? text : text + " ".repeat(width - text.length);
 }
@@ -1824,7 +1864,7 @@ function summarize(desc) {
 function applicationOptionLines(fields) {
   if (fields.length === 0)
     return [];
-  const labels = new Map(fields.map((field) => [field.name, `--${field.name} <${typeLabel(field.schema)}>`]));
+  const labels = new Map(fields.map((field) => [field.name, `--${field.name} ${fieldTypeLabel(field.schema)}`]));
   const width = Math.max(...fields.map((field) => labels.get(field.name)?.length ?? 0));
   return [
     "",
@@ -1904,7 +1944,7 @@ function renderCommandHelp(name, command, descriptor, applicationOptions = []) {
       const req = f.required ? " (required)" : "";
       const desc = f.description ? ` — ${f.description}` : "";
       const label = labels.get(f.name) ?? `--${f.name}`;
-      lines.push(`  ${padRight(label, width)}  <${typeLabel(f.schema)}>${req}${desc}`);
+      lines.push(`  ${padRight(label, width)}  ${fieldTypeLabel(f.schema)}${req}${desc}`);
     }
     const flag = [...kinds].find(([, info]) => info.kind === "boolean")?.[0];
     if (flag !== undefined) {

package/dist/tools/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AA6DvD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC7C,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CASrC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAqCT;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,EAClC,kBAAkB,GAAE,SAAS,eAAe,EAAO,GAClD,MAAM,CA6DR"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/tools/cli/help.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAEvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AA2GvD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC7C,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CASrC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAqCT;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,sBAAsB,EAClC,kBAAkB,GAAE,SAAS,eAAe,EAAO,GAClD,MAAM,CA6DR"}

package/llms/cli.txt

@@ -428,6 +428,19 @@ the argv parser. For example, a required `action` and optional `profile` render
 Declared aliases render beside their canonical options, for example
 `-n, --lines`.
 
+The argument table and `Application options:` show bounds from their JSON Schema,
+for example `<integer> [>=1, <=50]`, `<string> [length >=1, length <=12]`, and
+`<value…> [items >=2, items <=4]`. Numeric `>` and `<` are exclusive, while `>=`
+and `<=` include the endpoint; a zero limit is displayed too. Unbounded fields
+keep just their type and description. Bounds on an array's items are not bounds
+on the array itself.
+
+Composed schemas retain their meaning: `any of:` and `one of:` separate
+alternative branches with `|`, while `all of:` joins constraints with `&`.
+For example, a nullable bounded string renders
+`<value> [any of: string [length >=1] | null]`. These labels describe the input;
+the same contract schema still validates the call.
+
 ## `--wait` — background-friendly generation
 
 `--wait` polls an async result until it is done. It is generic — the core knows

package/llms-full.txt

@@ -8791,6 +8791,19 @@ the argv parser. For example, a required `action` and optional `profile` render
 Declared aliases render beside their canonical options, for example
 `-n, --lines`.
 
+The argument table and `Application options:` show bounds from their JSON Schema,
+for example `<integer> [>=1, <=50]`, `<string> [length >=1, length <=12]`, and
+`<value…> [items >=2, items <=4]`. Numeric `>` and `<` are exclusive, while `>=`
+and `<=` include the endpoint; a zero limit is displayed too. Unbounded fields
+keep just their type and description. Bounds on an array's items are not bounds
+on the array itself.
+
+Composed schemas retain their meaning: `any of:` and `one of:` separate
+alternative branches with `|`, while `all of:` joins constraints with `&`.
+For example, a nullable bounded string renders
+`<value> [any of: string [length >=1] | null]`. These labels describe the input;
+the same contract schema still validates the call.
+
 ## `--wait` — background-friendly generation
 
 `--wait` polls an async result until it is done. It is generic — the core knows

package/llms.txt

@@ -17,7 +17,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/tools/contract**: [llms/tools-contract.txt](llms/tools-contract.txt) 0.2 KB
 - **stitchkit/tools/invoker**: [llms/tools-invoker.txt](llms/tools-invoker.txt) 0.2 KB
 - **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.1 KB
-- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 42.8 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 43.6 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
 - **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
 - **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB
 - **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 9.3 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.103.2",
+  "version": "0.103.3",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",