aem-eds-kit 0.4.58 → 0.4.60

package/CHANGELOG.md

@@ -29,6 +29,11 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   Version links point at npm; the GitHub release links never existed.
 
 ### Fixed
+- **`eds draft preview|accept|refine --version` printed the CLI version**
+  (EDS-089) instead of picking a draft version: the program's own `--version`
+  flag won. The version is now an argument (`eds draft preview hero 2`,
+  `eds draft accept hero 1 --branch feature/hero`) and `refine` takes
+  `--from <n>`.
 - **The site has a menu on phones** (EDS-079). Below 720px the nav links were
   hidden with nothing to bring them back; a menu button (with `aria-expanded`,
   closing on Esc, a link tap or widening the window) now opens them as a
@@ -55,6 +60,13 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   where the Universal Editor boilerplate actually lives.
 
 ### Added
+- **`--json` event stream** (EDS-087) for `block from-design` and the `draft`
+  commands: one JSON object per line on stdout (`v`, `type`), the usual output
+  on stderr, ending with a `result`. Events: `start`, `log`, `agent` (each tool
+  call), `agent-result` (duration and cost), `draft`, `drafts`, `preview`,
+  `accepted`, `discarded`, `prompt`, `result`. With `--json` nothing prompts,
+  no browser opens, and an agent's own stdout goes to stderr. This is the
+  interface aem-eds-studio uses.
 - **Drafts: review rounds before a block reaches the repository** (EDS-085).
   `block from-design --draft` keeps the result as a version under
   `tmp/eds-cli/drafts/<name>/` and leaves `blocks/` untouched; `eds draft

package/README.md

@@ -469,7 +469,32 @@ eds draft list                                              # drafts and their v
 eds draft discard hero                                      # drop it; blocks/ untouched
 ```
 
-`accept --commit` (or `--branch <name>`, created if missing) commits only `blocks/<name>/`, with the review rounds in the message (`v1: first version`, `v2: "bigger headline, orange buttons"`). `refine` reuses the agent and model that made the draft unless you pass `--agent` / `--model`; `preview` and `accept` take `--version <n>`.
+`accept --commit` (or `--branch <name>`, created if missing) commits only `blocks/<name>/`, with the review rounds in the message (`v1: first version`, `v2: "bigger headline, orange buttons"`). `preview` and `accept` take a version (`eds draft preview hero 2`, `eds draft accept hero 1 --branch feature/hero`; default: the latest). `refine` starts from the latest version, or `--from <n>`, and reuses the agent and model that made the draft unless you pass `--agent` / `--model`.
+
+**For tools: `--json`.** `block from-design` and the `draft` commands take the global `--json` flag and print **one JSON event per line on stdout** (the usual output stays on stderr). It never prompts, so pass the design, the name and `--draft`. Every event has `v` (the schema version, currently `1`) and `type`, and the stream ends with one `result`. [aem-eds-studio](https://github.com/piotrgodycki/aem-eds-studio) reads it.
+
+```bash
+eds --json block from-design "<design link>" --name hero --draft
+```
+```jsonl
+{"v":1,"type":"start","command":"block from-design","cli":"0.4.59"}
+{"v":1,"type":"agent","tool":"Write","label":"✎ blocks/hero/hero.css","durationMs":18}
+{"v":1,"type":"agent-result","durationMs":152455,"costUsd":0.031}
+{"v":1,"type":"draft","name":"hero","version":1,"ok":true,"dir":"tmp/eds-cli/drafts/hero/v1","files":["hero.css","hero.js"]}
+{"v":1,"type":"result","ok":true,"exitCode":0}
+```
+
+| Event | When |
+|---|---|
+| `start` | first line: the command and the CLI version |
+| `log` | every message the command prints (`level`: debug, info, success, warn, error), as plain text |
+| `agent` / `agent-result` | each tool call the agent made, then its duration and cost (Claude Code) |
+| `draft` | a version was stored: `name`, `version`, `ok` (checks passed), `dir`, `files`, `feedback` |
+| `drafts` | `draft list`: every draft with its versions |
+| `preview` | `draft preview`: the server is up at `url` (no browser is opened) |
+| `accepted` / `discarded` | `draft accept` (with `commit`, `branch`) / `draft discard` |
+| `prompt` | `--dry-run`: where the prompt was saved |
+| `result` | last line: `ok` and `exitCode` |
 
 ### `eds block list`
 
@@ -750,7 +775,7 @@ Priority: CLI flags → env vars → `.edsrc.json` (project) → `~/.eds/config.
 |---|---|
 | `--verbose` | Debug-level output |
 | `--quiet` | Errors only |
-| `--json` | Machine-readable JSON output (`doctor`, `audit loading`, `audit security`, `block list`) |
+| `--json` | Machine-readable output: one JSON document (`doctor`, `audit loading`, `audit security`, `block list`), or JSON-lines events (`block from-design`, `draft`; see [`eds draft`](#eds-draft)) |
 | `--no-color` | Disable colors (also respects `NO_COLOR` env) |
 
 ## Development