@jelou/cli 1.4.0 → 1.5.1

package/README.md

@@ -292,23 +292,29 @@ jelou functions deploy --no-confirm --json | jq '.data.url'
   not a TTY)
 - `--json` outputs `{ "ok": true, "data": ... }` to stdout
 
-### Composite mode (`JELOU_CLI_MODE=agent`)
+### Composite mode (`--agent`)
 
-For AI coding agents and automation that want one switch instead of three,
-`JELOU_CLI_MODE=agent` flips a coherent set of "machine consumer" defaults.
-Explicit env vars always override the composite — set `NO_COLOR=0` (or
-`JELOU_NO_INPUT=0` etc.) to opt back in to a single dimension while keeping the
-rest of the agent profile.
+For AI coding agents and automation that want one switch instead of three, the
+`--agent` flag flips a coherent set of "machine consumer" defaults. It implies
+`--json --no-input --compact` and sets `NO_COLOR=1`, `JELOU_NO_INPUT=1`,
+`JELOU_NO_SPINNERS=1` for downstream child processes. Explicit per-component env
+vars override the composite — set `NO_COLOR=0` to opt back in to a single
+dimension while keeping the rest of the agent profile.
 
-| Env var             | When `JELOU_CLI_MODE=agent` | When unset    |
-| ------------------- | --------------------------- | ------------- |
-| `JELOU_NO_INPUT`    | implies `1`                 | default unset |
-| `NO_COLOR`          | implies `1`                 | default unset |
-| `JELOU_NO_SPINNERS` | implies `1`                 | default unset |
+| Env var             | When `--agent` is set | When unset    |
+| ------------------- | --------------------- | ------------- |
+| `JELOU_NO_INPUT`    | implies `1`           | default unset |
+| `NO_COLOR`          | implies `1`           | default unset |
+| `JELOU_NO_SPINNERS` | implies `1`           | default unset |
 
 Composite mode is **output behavior only** — it never bypasses safety nets.
 `.jelou/incoming/` preservation, `UNRESOLVED_INCOMING` push refusal, validation,
-and dirty-state checks always run regardless of the mode flag.
+and dirty-state checks always run regardless of the mode flag. See
+`docs/best-practices/mode-flags-vs-safety.md` for the full policy.
+
+> **Note:** Earlier versions accepted a `JELOU_CLI_MODE=agent` env var as an
+> alternate entry point. That surface was removed; use the `--agent` flag (or
+> `alias jelou='jelou --agent'` in your shell) for the same effect.
 
 See the [full CI reference](../../docs/cli.md#ci--non-interactive-mode) for
 per-command flags and GitHub Actions examples.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jelou/cli",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Jelou CLI — manage functions, brains, channels, and more",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -17,11 +17,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@jelou/cli-darwin-arm64": "1.4.0",
-    "@jelou/cli-darwin-x64": "1.4.0",
-    "@jelou/cli-linux-x64": "1.4.0",
-    "@jelou/cli-linux-arm64": "1.4.0",
-    "@jelou/cli-win32-x64": "1.4.0"
+    "@jelou/cli-darwin-arm64": "1.5.1",
+    "@jelou/cli-darwin-x64": "1.5.1",
+    "@jelou/cli-linux-x64": "1.5.1",
+    "@jelou/cli-linux-arm64": "1.5.1",
+    "@jelou/cli-win32-x64": "1.5.1"
   },
   "keywords": [
     "jelou",