docs: surface the turn-on/turn-off lifecycle and list fleet write verbs (v0.31.1) (#67)

The on/off lifecycle was real but under-documented. `lobes serve`/`stop` and
`lobes fleet up`/`down` bring the single-model and fleet lanes up and down, but:

- The Mutation-safety *prose* in `lobes learn` and CLAUDE.md listed only
  `switch`, `serve`, `stop`, `init`, `tunnel` — omitting `fleet up`/`fleet down`,
  which are equally dry-run-by-default write verbs (the `--json` payload already
  listed them, and a test pins that). Aligned the prose to match.
- CLAUDE.md described the lifecycle only implicitly (verb names in a tree). Added
  an explicit "Lifecycle (turn on / off)" note mapping serve/stop and fleet
  up/down to compose up/down, including the `stop` = `compose down` (removes
  containers, not a pause) caveat.

Docs/wording only — no behavior change. Tests and lint green.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: OriNachum

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.31.1] - 2026-06-27
+
+### Changed
+
+- Mutation-safety prose in `lobes learn` and CLAUDE.md now lists the `fleet up` / `fleet down` write verbs (was only in the `--json` payload).
+- CLAUDE.md documents the turn-on/turn-off lifecycle explicitly (`serve`/`stop` and `fleet up`/`down`) instead of leaving it implicit in the verb names.
+
 ## [0.31.0] - 2026-06-26
 
 ### Added

CLAUDE.md

@@ -88,10 +88,18 @@ lobes/                 # Python package (pip install lobes-cli)
         └── logs.py tunnel.py whoami.py learn.py explain.py overview.py doctor.py cli.py
 ```
 
-**Mutation safety:** write verbs (`switch`, `serve`, `stop`, `init`, `tunnel`) default to
-**dry-run**; require `--apply` to commit. Agents call CLIs in loops, so
-safe-by-default is mandatory. The read-only verbs (`status`, `assess`,
-`benchmark`, `logs`, `overview`, `whoami`, `explain`, `doctor`) never change the world.
+**Lifecycle (turn on / off):** `lobes serve` (alias `start`) brings the
+single-model server **up** (`docker compose up -d`, then waits for `/health`);
+`lobes stop` takes it **down** (`docker compose down` — it *removes* the
+containers, not a pause). The fleet lane mirrors this: `lobes fleet up`
+(`up -d --build`) / `lobes fleet down`. `lobes switch <model>` is a down+up with a
+model swap. `lobes status` / `lobes fleet status` observe without mutating.
+
+**Mutation safety:** write verbs (`switch`, `serve`, `stop`, `init`, `fleet up`,
+`fleet down`, `tunnel`) default to **dry-run**; require `--apply` to commit. Agents
+call CLIs in loops, so safe-by-default is mandatory. The read-only verbs (`status`,
+`assess`, `benchmark`, `logs`, `overview`, `whoami`, `explain`, `doctor`) never
+change the world.
 
 ## Build / test / publish
 

lobes/cli/_commands/learn.py

@@ -50,9 +50,9 @@
 Mutation safety
 ---------------
 Write verbs default to DRY RUN and require --apply to commit: `switch`, `serve`,
-`stop`, `init`, `tunnel`. Agents call CLIs in loops, so safe-by-default is mandatory. The
-read-only verbs (`status`, `assess`, `benchmark`, `overview`, `whoami`,
-`explain`, `doctor`) never change the world.
+`stop`, `init`, `fleet up`, `fleet down`, `tunnel`. Agents call CLIs in loops, so
+safe-by-default is mandatory. The read-only verbs (`status`, `assess`, `benchmark`,
+`overview`, `whoami`, `explain`, `doctor`) never change the world.
 
 Models: supported vs. warm
 --------------------------

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lobes-cli"
-version = "0.31.0"
+version = "0.31.1"
 description = "lobes — run, assess, and switch the local vLLM model."
 readme = "README.md"
 license = "Apache-2.0"