@withgauge/cli 0.12.0 → 0.13.0

package/README.md

@@ -35,7 +35,6 @@ never drifts from the commands it describes.
 
 Run `gauge --help` (or `gauge <command> --help`) for the full command set:
 evals, preference, models, personas, skills, mcp, repos, runs, optimizations,
-experiments,
 batches, brands, tags, actions, dashboards, members, org, provider keys,
 billing, usage, stats, query, and more.
 
@@ -215,6 +214,24 @@ Edit a skill with `--edit-skill <versionId> --skill-dir <path>`: the directory
 holds the complete bundle, `SKILL.md` included. `trials template --kind <kind>`
 prints a skeleton for the `--file` form.
 
+A chat-guided round, such as a CLI change, goes through preview and save. Save
+replaces the pending drafts, so it can fix a draft that is wrong:
+
+```sh
+gauge optimizations authoring cl_1 > context.json   # revision, CLI targets, invocations
+gauge optimizations invocation cl_1 inv_1           # one recorded baseline invocation
+gauge optimizations cli-change cl_1 --file change.json > bundle.json
+# round.json: {"revision": "...", "trials": [{"trial": {"title": "...",
+#   "lever": "CLI", "intervention": {"kind": "CLI_INTERVENTION", "after": <bundle.json>}}}]}
+gauge optimizations round preview cl_1 --file round.json   # prints previewDigest
+gauge optimizations round save cl_1 --file round.json --digest <previewDigest>
+gauge optimizations trials remove cl_1 R1.2 --yes    # drop one draft
+gauge optimizations launch cl_1 --yes
+```
+
+A `completeOutput` literal matcher is an exact, case-sensitive match. Copy it
+from the recorded command output.
+
 Every detail carries `nextAction` — `START`, `WAIT`, `AUTHOR_TRIAL`,
 `LAUNCH_ROUND`, `ADOPT`, `RESUME`, or `NONE`. Read it (`get -o json`) instead of
 inferring whose turn it is from round and trial statuses. `watch` exits `4` when