stitchkit 0.113.2 → 0.113.3

package/llms-full.txt

@@ -10012,9 +10012,11 @@ const doctor = defineCliCommand({
 it the canonical JSON output is unchanged. `exitCode` classifies a successfully
 validated result and must return an integer in `0..255`; failed `ToolResult`
 envelopes and the application-wide `exitCodes` mapping remain authoritative for
-failures. A throwing callback, invalid status or non-string presenter becomes a
-normalized `INTERNAL_SERVER_ERROR`, never partial success output. Void native
-commands cannot declare either callback.
+failures. A throwing or invalid exit-status callback becomes a normalized
+`INTERNAL_SERVER_ERROR`. A throwing or non-string `present` preserves the validated
+result on stdout and reports `CLI_PRESENTATION_FAILED` separately, as described
+under [Aggregate views](#aggregate-views). Void native commands cannot declare
+either callback.
 
 `--version`, a selected native command and its command help run before
 `resolveAuth`, services, context or runtime-tool factories. Top-level help is
@@ -10229,6 +10231,7 @@ newline-terminated JSON record on its respective stream; progress and CLI usage
 diagnostics remain ordinary stderr text. This keeps stdout pipeable and
 `2>/dev/null` clean. The process exit code carries the error class (`0` ok,
 `VALIDATION_ERROR → 1`, `UNAUTHORIZED → 2`, `FORBIDDEN → 3`, `NOT_FOUND → 4`,
+`CLI_PRESENTATION_FAILED → 8`,
 …) — override per app with `exitCodes`.
 
 ### A narrower question than "all of them"
@@ -10450,7 +10453,7 @@ would answer a question nobody asked.
 
 Three rules worth knowing before you rely on them:
 
-- **A field the result does not carry is an argument error.** A group of zero
+- **A field the result does not carry is a presentation error.** A group of zero
   over a misspelled field is indistinguishable from a true empty answer, and the
   caller reads it as data. The message names the fields that *are* there.
 - **An aggregate needs a collection** — the result itself when it is an array,
@@ -10464,6 +10467,17 @@ Three rules worth knowing before you rely on them:
 A failed call still reports its own error and exit code. An aggregate over an
 error is not an answer to the question that was asked.
 
+If the command succeeds but its requested view cannot be built, the CLI writes
+the complete original result to stdout, using the normal JSON format (`--json`
+still selects compact output). It writes a separate structured
+`CLI_PRESENTATION_FAILED` diagnostic to stderr and exits with `8`, configurable
+through `exitCodes`. Its `details.operationSucceeded: true` and `retryable: false`
+distinguish a presentation refusal from a failed operation; `details.cause`
+preserves the safe reason. Recover the answer from stdout instead of repeating
+the mutation. Domain retry hints are not appended to this diagnostic. CLI
+argument errors detected before execution still exit with `2`
+and have no successful result to preserve.
+
 ## Named profiles
 
 A CLI that talks to a deployed server needs an address and a credential per
@@ -13097,7 +13111,7 @@ core never models them (ADR 0002). But stitchkit itself emits a set of its own:
 `FILE_INSPECTION_REJECTED`, `FILE_TOO_LARGE`, `FILE_EXISTS`,
 `REALTIME_CONTRACT_VIOLATION`, `APPLICATION_NOT_ACCEPTING`, `NOT_IMPLEMENTED`,
 `WAIT_TIMEOUT`,
-`WAIT_FAILED`, `CLI_COMMAND_UNAVAILABLE`, `DOWNLOAD_NOT_FOUND`, `VIEW_HTTP_ERROR`,
+`WAIT_FAILED`, `CLI_COMMAND_UNAVAILABLE`, `CLI_PRESENTATION_FAILED`, `DOWNLOAD_NOT_FOUND`, `VIEW_HTTP_ERROR`,
 `CONNECTION_TIMEOUT`, `CONNECTION_RESPONSE_TOO_LARGE`,
 `CONNECTION_REQUEST_FAILED`, `UPSTREAM_TOOL_ERROR`,
 `OPERATION_NOT_SUCCEEDED`, `STREAM_ITEM_INVALID`, `STREAM_FRAME_TOO_LARGE`,

package/llms.txt

@@ -18,7 +18,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.9 KB
-- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 47.0 KB → [llms/cli.2.txt](llms/cli.2.txt) 22.5 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 33.9 KB → [llms/cli.2.txt](llms/cli.2.txt) 36.4 KB
 - **stitchkit/cli/publish**: [llms/cli-publish.txt](llms/cli-publish.txt) 1.5 KB
 - **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
 - **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.113.2",
+  "version": "0.113.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",