@tuned-tensor/cli 0.13.0-beta.1 → 0.13.0

package/README.md

@@ -8,19 +8,57 @@
 
 ## Cloud sunset
 
-This release unregisters the hosted API commands (`tt auth`, `tt push`,
-`tt balance`, `tt topup`, `tt cloud`, and the rest of the managed tree). The
-modules remain in the repository so they can be restored later. `tt local …`
-is kept as a hidden alias; new scripts should call `tt run`, `tt doctor`,
-`tt runs list`, and so on directly.
+This release unregisters the hosted API commands (`tt auth`, `tt publish`,
+`tt push`, `tt balance`, `tt topup`, `tt cloud`, and the rest of the managed
+tree). The modules remain in the repository so they can be restored later.
+`tt local …` is kept as a hidden alias; new scripts should call `tt run`,
+`tt doctor`, `tt runs list`, and so on directly.
+
+## Migrating from 0.11
+
+`0.13` is the local-only CLI. If you are coming from `0.11.0`:
+
+- Call `tt run`, `tt doctor`, and `tt serve` at the root. `tt local …` still
+  works as a hidden alias.
+- Hosted account commands (`tt auth`, `tt publish`, `tt push`, and the rest)
+  are unregistered.
+- `Qwen/Qwen3.5-2B` is pinned to Hugging Face snapshot
+  `15852e8c16360a2fea060d615a32b45270f8a8fc`. Prefetch, train, eval, and serve
+  reject any other revision.
+- `tt serve active` fails unless an adapter is activated. Activation requires
+  a `generalRegression` suite in `local-runner.json`.
+- `tt info` reports `status: local`.
 
 ## Install
 
+On Linux or macOS:
+
 ```bash
-npm install -g @tuned-tensor/cli
+curl -fsSL https://tunedtensor.com/install.sh | sh
 tt --version
 ```
 
+The installer bootstraps Node.js 22.19+ if needed, installs
+`@tuned-tensor/cli` with npm `--ignore-scripts`, and falls back to
+`~/.local` when the global npm prefix is not writable. Inspect it first
+with `curl -fsSL https://tunedtensor.com/install.sh | less`. Pin a
+dist-tag or version on `sh`, not `curl`:
+
+```bash
+curl -fsSL https://tunedtensor.com/install.sh | TT_VERSION=beta sh
+curl -fsSL https://tunedtensor.com/install.sh | TT_VERSION=0.13.0 sh
+```
+
+Or install the package directly:
+
+```bash
+npm install -g --ignore-scripts @tuned-tensor/cli
+tt --version
+```
+
+Uninstall with `npm uninstall -g @tuned-tensor/cli` (add
+`--prefix ~/.local` if the curl installer used that prefix).
+
 Node.js 22.19.0 or newer is required. Local training additionally needs
 [`uv`](https://docs.astral.sh/uv/) and a supported NVIDIA CUDA host; the locked
 Python runner ships with the npm package and is prepared on first use.
@@ -67,7 +105,7 @@ If a newer stable release is available it recommends
 checks are ignored.
 
 ```text
-tt v0.13.0-beta.1
+tt v0.13.0
 agent anthropic/claude-sonnet-4-5 · workflow model base
 ctrl+c stop/clear · ctrl+d exit · /help commands · tab complete
 
@@ -173,7 +211,8 @@ tt models verify local-<run-id>
 tt models serve local-<run-id> --config local-runner.json
 ```
 
-Local currently certifies text SFT with `Qwen/Qwen3.5-2B`,
+Local currently certifies text SFT with `Qwen/Qwen3.5-2B` (pinned to snapshot
+`15852e8c16360a2fea060d615a32b45270f8a8fc`),
 `nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16`, and
 `meta-models/Muse-Glimmer-30B`, using LoRA/PEFT and CUDA. The 30B/3B-active
 Nemotron path is intended for DGX Spark-class unified memory, uses activation
@@ -184,7 +223,9 @@ vision tower frozen and unused. Evaluation and serving may use CPU. Training
 artifacts, datasets, and model weights remain on the execution host.
 
 Activation is optional and requires the run to pass a configured
-`generalRegression` gate. Once activated, use
+`generalRegression` gate. Without that suite, `tt models activate` fails
+closed. `tt serve active` also fails closed if nothing is activated — it does
+not silently serve the protected base model. Once activated, use
 `tt serve active --config local-runner.json`.
 
 `tt serve base` does not automatically inject the adjacent project spec.