@north-light/cli 0.3.463 → 0.3.464

package/dist/builtin-memory/crouter-plugin/deploying.md

@@ -55,6 +55,18 @@ const node = createNodeHandler(handler, { bodyLimit: 65536 });
 
 A definition with `version: N`, or a list of definitions with one per supported major, is served per major. Each major N is mounted under `<mount>/v<N>/`, and its archive at `GET <mount>/v<N>/` declares `/v<N>` routes. `GET <mount>/versions` answers `{latest, supported}`. An unversioned single definition keeps the unversioned paths above. With `baseUrl`, pass the endpoint without any `/v<N>` segment.
 
+### What needs a new major
+
+`compareManifests(previous, next)` returns every change to a leaf that can break a caller written against the previous archive; the directory runs it against each major's stored archive. A leaf is breaking when it:
+
+- is removed or renamed, or changes its tool group;
+- removes a parameter, changes its type, makes it required, or adds a required one; removes an enum choice from a flag; or changes the environment variable it defaults from; or moves an existing positional;
+- gains paging where it returned everything: a limit flag whose constraint states a default page size ("default N"), or a cursor input together with a `next_cursor`-style output. The answer keeps its shape, so callers that do not page silently get a partial list. A changed stated page size is breaking too. A new `--cursor`, `--limit` with no stated default, or `next_cursor` output alone is additive, and so is a declared `default`, which crtr applies while parsing and does not send;
+- changes how the request is built: method, route (apart from the `/v<N>` segment), body root, constant body fields, a parameter's placement or wire name, or streaming;
+- removes an output field, changes its type, makes it optional, drops an enum value, or adds a `file` output.
+
+A new optional flag, a new leaf, a new optional output field and changed prose are additive.
+
 ## Archive response
 
 The install response is an uncompressed tar with `Content-Type: application/x-tar`. Do not configure a proxy, CDN, or framework middleware to gzip or otherwise compress it. Crtr rejects compressed archive bytes. The handler sends an ETag and supports conditional `If-None-Match` requests automatically.

package/docs/plugin/deploying.md

@@ -53,6 +53,18 @@ const node = createNodeHandler(handler, { bodyLimit: 65536 });
 
 A definition with `version: N`, or a list of definitions with one per supported major, is served per major. Each major N is mounted under `<mount>/v<N>/`, and its archive at `GET <mount>/v<N>/` declares `/v<N>` routes. `GET <mount>/versions` answers `{latest, supported}`. An unversioned single definition keeps the unversioned paths above. With `baseUrl`, pass the endpoint without any `/v<N>` segment.
 
+### What needs a new major
+
+`compareManifests(previous, next)` returns every change to a leaf that can break a caller written against the previous archive; the directory runs it against each major's stored archive. A leaf is breaking when it:
+
+- is removed or renamed, or changes its tool group;
+- removes a parameter, changes its type, makes it required, or adds a required one; removes an enum choice from a flag; or changes the environment variable it defaults from; or moves an existing positional;
+- gains paging where it returned everything: a limit flag whose constraint states a default page size ("default N"), or a cursor input together with a `next_cursor`-style output. The answer keeps its shape, so callers that do not page silently get a partial list. A changed stated page size is breaking too. A new `--cursor`, `--limit` with no stated default, or `next_cursor` output alone is additive, and so is a declared `default`, which crtr applies while parsing and does not send;
+- changes how the request is built: method, route (apart from the `/v<N>` segment), body root, constant body fields, a parameter's placement or wire name, or streaming;
+- removes an output field, changes its type, makes it optional, drops an enum value, or adds a `file` output.
+
+A new optional flag, a new leaf, a new optional output field and changed prose are additive.
+
 ## Archive response
 
 The install response is an uncompressed tar with `Content-Type: application/x-tar`. Do not configure a proxy, CDN, or framework middleware to gzip or otherwise compress it. Crtr rejects compressed archive bytes. The handler sends an ETag and supports conditional `If-None-Match` requests automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/cli",
-  "version": "0.3.463",
+  "version": "0.3.464",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -137,7 +137,7 @@
   },
   "license": "UNLICENSED",
   "dependencies": {
-    "@north-light/identity": "0.3.463",
+    "@north-light/identity": "0.3.464",
     "@earendil-works/pi-agent-core": "1.1.0",
     "@earendil-works/pi-ai": "1.1.0",
     "@earendil-works/pi-coding-agent": "1.1.0",

package/packages/crouter-identity/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/identity",
-  "version": "0.3.463",
+  "version": "0.3.464",
   "description": "Northlight access-token verification and scope rules",
   "type": "module",
   "main": "./dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/cli",
-  "version": "0.3.463",
+  "version": "0.3.464",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/cli",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "hasInstallScript": true,
       "license": "UNLICENSED",
       "workspaces": [
@@ -18,7 +18,7 @@
         "@earendil-works/pi-ai": "1.1.0",
         "@earendil-works/pi-coding-agent": "1.1.0",
         "@earendil-works/pi-tui": "1.1.0",
-        "@north-light/identity": "0.3.463",
+        "@north-light/identity": "0.3.464",
         "cron-parser": "^5.6.0",
         "esbuild": "^0.27.7",
         "jose": "^6.2.12",
@@ -12095,17 +12095,17 @@
     },
     "packages/crouter-api": {
       "name": "@north-light/api",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "license": "UNLICENSED"
     },
     "packages/crouter-env-docker": {
       "name": "@north-light/env-docker",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "license": "UNLICENSED"
     },
     "packages/crouter-identity": {
       "name": "@north-light/identity",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "license": "UNLICENSED",
       "dependencies": {
         "jose": "^6.2.1"
@@ -12113,20 +12113,20 @@
     },
     "packages/crouter-plugin": {
       "name": "@north-light/plugin",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "license": "UNLICENSED",
       "dependencies": {
-        "@north-light/api": "0.3.463",
-        "@north-light/identity": "0.3.463"
+        "@north-light/api": "0.3.464",
+        "@north-light/identity": "0.3.464"
       }
     },
     "packages/crouter-sdk": {
       "name": "@north-light/sdk",
-      "version": "0.3.463",
+      "version": "0.3.464",
       "license": "UNLICENSED",
       "dependencies": {
-        "@north-light/api": "0.3.463",
-        "@north-light/identity": "0.3.463",
+        "@north-light/api": "0.3.464",
+        "@north-light/identity": "0.3.464",
         "jose": "^6.2.1"
       },
       "bin": {