@arbol-ai/cli 1.20261018.212151 → 1.20261018.213455

package/README.md

@@ -12,7 +12,16 @@ npm install --global @arbol-ai/cli
 arbol --version
 ```
 
-It needs Node.js 26 or newer, whose `fetch` and `Temporal` the SDK uses.
+It needs Node.js 26 or newer, whose `fetch` and `Temporal` the SDK uses. On macOS and Linux,
+[cli.getarbol.com](https://cli.getarbol.com) does the same in one line:
+
+```sh
+curl -fsSL https://cli.getarbol.com/install.sh | sh
+```
+
+[`install.sh`](site/public/install.sh) checks for Node.js 26 and runs
+`npm install --global @arbol-ai/cli`, or prints that command when npm is missing. Run it again to
+update; `ARBOL_VERSION=<version>` installs a given release.
 
 ## Profiles
 
@@ -145,6 +154,28 @@ bun run verify      # typecheck, tests and dist/
 `openapi.json` is downloaded at generation time and not committed, and `src/generated/generation.json`
 records which release, Forge commit and plugin wrote each file.
 
+## Releases
+
+A release of the API flows through three repositories, each started by the one before it:
+
+1. **project-arbol-gateway** publishes the OpenAPI at `https://api.getarbol.com/openapi.json` and sends
+   `openapi-release` to project-arbol-sdk-js.
+2. **project-arbol-sdk-js** regenerates `@arbol-ai/sdk` from it, publishes it to npm and sends
+   `sdk-release` (`{ "version": "<release>" }`) here.
+3. **Here**, [Generate](.github/workflows/generate.yml) pins `@arbol-ai/sdk` to exactly that release,
+   regenerates `src/generated/` from the live OpenAPI and, when anything changed and `bun run verify`
+   passes, commits `Release <release>` to main and runs [Publish](.github/workflows/publish.yml) on that
+   commit. When nothing changed, nothing is committed or published.
+
+Generate also runs every 6 hours and by hand, pinning the SDK release the OpenAPI names once it is on
+npm. Its push uses an installation token of the organization's GitHub App (Arbol Bot: the variable
+`ARBOL_BOT_APP_ID` and the secret `ARBOL_BOT_PRIVATE_KEY`), so the commit runs Verify like any other.
+Publish can also run by hand, for a change to the CLI alone; npm receives the package with the
+organization's `NPM_TOKEN` and a provenance statement.
+
+[cli.getarbol.com](https://cli.getarbol.com) is the Worker in [`site/`](site/wrangler.jsonc): static
+files and no code. Cloudflare Workers Builds deploys it on every push to main that changes `site/`.
+
 ## License
 
 [Apache License 2.0](LICENSE)

package/dist/index.js

@@ -64685,7 +64685,7 @@ var generation_default = {
     version: "0.1.0"
   },
   plugins: {
-    cli: "39007ea178b892e91916a2afa22883ba71b8f0a9c12b8a0db7f27d9fa128890d"
+    cli: "fcabf27a9d57a656f3e312e71160b76975ce3585173b8ae507cbabd236ba1cab"
   },
   outputs: [
     {
@@ -65045,7 +65045,7 @@ ${name}`);
 }
 
 // src/index.ts
-var VERSION = "1.20261018.212151";
+var VERSION = "1.20261018.213455";
 var RELEASE = generation_default.release;
 var SERVICES = [...new Set(Object.keys(commands).map((name) => name.split(" ")[0]))].toSorted();
 var HELP = `Arbol CLI ${VERSION} (Arbol API ${RELEASE}): the Arbol platform from your terminal.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbol-ai/cli",
-  "version": "1.20261018.212151",
+  "version": "1.20261018.213455",
   "description": "The Arbol CLI: the Arbol API from your terminal, with commands generated by Cloudflare Forge from the public OpenAPI.",
   "keywords": [
     "arbol",