stitchkit 0.122.1 → 0.123.0

package/llms/{upgrading-0.106.0-0.122.0.txt → upgrading-0.106.0-0.123.0.txt}

@@ -1,14 +1,61 @@
-# Upgrading 0.106.0 → 0.122.0 — stitchkit docs slice
+# Upgrading 0.106.0 → 0.123.0 — stitchkit docs slice
 
 > Generated from the `docs/` tree by `bun run gen:llms`. The index of all slices is
 > `llms.txt` in this package.
 
-Contains: Guide: Upgrading, 0.106.0 → 0.122.0  (docs/guide/upgrading.md)
+Contains: Guide: Upgrading, 0.106.0 → 0.123.0  (docs/guide/upgrading.md)
 
 ==============================================================================
-# Guide: Upgrading, 0.106.0 → 0.122.0  (docs/guide/upgrading.md)
+# Guide: Upgrading, 0.106.0 → 0.123.0  (docs/guide/upgrading.md)
 ==============================================================================
 
+## Released migration: 0.123.0
+
+### unknown-operation
+
+**Who must act:** HTTP callers and `onError` code maps that read `NOT_FOUND` to mean "no such
+route", callers of `createCliInvoker`, `--wait` and `createToolInvoker` that read `NOT_FOUND` for
+an unknown command or tool name, and contract-client callers that branch on the router's
+`METHOD_NOT_ALLOWED`.
+
+A call no surface can route is answered `UNKNOWN_OPERATION`; `NOT_FOUND` is left to handlers.
+
+- The server answers an unmatched route `404 UNKNOWN_OPERATION` with `details: { method, path }`.
+- A contract client reports both routing refusals of its own call — that `404` and the router's
+  `405` — as `UNKNOWN_OPERATION` with `details.operation`. A `405` thrown by a handler is
+  unchanged.
+- `createCliInvoker().invoke`, an unknown `--wait` target and `createToolInvoker` answer
+  `UNKNOWN_OPERATION` for a name they do not have. The CLI exit code for it is `4`, as it was for
+  `NOT_FOUND`.
+
+```ts
+// before
+if (error.code === 'NOT_FOUND') showMissingPage()
+
+// after
+if (error.code === 'UNKNOWN_OPERATION') showMissingPage()   // no such route, command or tool
+if (error.code === 'NOT_FOUND') showMissingRecord()         // the handler's own answer
+```
+
+A `createErrorHook` `codeMap` that spells `NOT_FOUND` for clients adds
+`UNKNOWN_OPERATION: 'not_found'` to keep the previous wire code.
+
+### cli-schema-option
+
+**Who must act:** applications whose CLI exposes a command with an input field named `schema`.
+
+`--schema` is a framework option that prints a command's JSON Schema, so a command field of that
+name can no longer receive a value. A contract command declaring it fails at startup; a
+runtime-catalogue command becomes unavailable with the reason in help. Rename the field.
+
+```ts
+// before
+input: z.object({ schema: z.string() })     // app export --schema public
+
+// after
+input: z.object({ schemaName: z.string() }) // app export --schema-name public
+```
+
 ## Released migration: 0.122.0
 
 ### read-view-refusal

package/llms/upgrading.txt

@@ -11,7 +11,7 @@ Contains: Guide: Upgrading, general  (docs/guide/upgrading.md)
 
 Load this slice, then every range slice between your installed version and the target:
 
-- 0.106.0 → 0.122.0: `llms/upgrading-0.106.0-0.122.0.txt`
+- 0.106.0 → 0.123.0: `llms/upgrading-0.106.0-0.123.0.txt`
 - 0.96.0 → 0.105.0: `llms/upgrading-0.96.0-0.105.0.txt`
 - 0.69.0 → 0.95.0: `llms/upgrading-0.69.0-0.95.0.txt`
 - 0.55.0 → 0.68.0: `llms/upgrading-0.55.0-0.68.0.txt`