What changed, release by release

Unreleased on main, not yet on npm

Changed

• README rewritten for the npm page (EDS-047): absolute links (relative ones break on npmjs.com), a docs / changelog / e2e links row, a "What it does" list, a wider package description and keywords.
• Figma REST specs are embedded as compact JSON (part of EDS-020), as scraped specs already were - fewer prompt tokens, same data.
• eds block test screenshots just the block (EDS-021). Baselines used to be full-page shots of a 900 px tall viewport, so a short block carried hundreds of pixels of white and a height change inside them went unnoticed. Existing baselines need one eds block test --update; a run against an old baseline says so instead of reporting a size change.
• block from-design now fetches the design once into a cached snapshot, then generates from it (fetch → cache → generate). The CLI resolves the design via the cheapest adapter - local SVG/PNG export, a cached snapshot (tmp/eds-cli/design-cache/), the Figma REST API (with a token), or a single Figma MCP call the agent caches - so retries and refine passes never re-fetch. Replaces the old flow where the agent made several MCP calls mid-generation. New src/lib/figma/rest.ts and design-source.ts.
• MCP usage cut to one call per block. The prompt now uses only get_design_context (dropped get_variable_defs; get_screenshot is opt-in via --screenshot) - the Figma Dev Mode MCP server meters tool calls per plan (20/month on Starter or with a View/Collab seat; 200-600/day with Dev/Full on paid plans). Set a Figma token to fetch via REST instead, on its own budget.
• Block generation defaults to the fastest model (Haiku), overridable with model in config - block codegen is structured, bounded work.
• eds block preview no longer auto-launches. After from-design you get a menu to refine the block or open the preview on demand; --no-serve became --serve (opt-in, non-interactive runs only).
• Shorter interactive-menu labels (details moved to each choice's description).
• Smaller published package (~206 kB → ~73 kB packed; 808 kB → ~220 kB unpacked). The build no longer ships a source map (it was ~60% of the package; re-enable ad hoc with tsup --sourcemap) and now minifies the single bundled binary (dist/bin/eds.js 265 kB → ~170 kB).

Fixed

• eds init --yes no longer prompts for the authoring model (EDS-061). It detects it from the fstab.yaml mountpoint (AEM author → Universal Editor, content.da.live → DA, Google Drive, SharePoint) or a crosswalk paths.json, and stops with exit 1 and a --authoring hint when it can't tell. Interactively the detected model is preselected.
• eds init --yes no longer prompts for the project name (EDS-058). Without --name it now takes the folder name (or package.json's, unless that is still the boilerplate's own), so it runs in CI and without a terminal.
• eds sandbox new --ue used a crosswalk boilerplate that doesn't exist (EDS-056): adobe/aem-boilerplate-xwalk is now adobe-rnd/aem-boilerplate-xwalk, where the Universal Editor boilerplate actually lives.
• Figma limits described correctly (EDS-040). Code comments, README, docs and site said REST had a "far larger quota on every plan". Its Tier 1 endpoints are 20 calls/month on Starter or with a View/Collab seat, and 10-20/min with Dev/Full on paid plans. The README now has the REST and MCP limits table, with links to Figma's pages.
• A Figma REST rate limit no longer spends your MCP budget (EDS-039). A 429 used to fall back to Figma MCP silently. Now a short Retry-After (≤ 60 s) is waited out and retried once; a plan cap stops with when it resets, the plan tier, and the options (--mcp, a PNG/SVG export). --design reports the same.
• Content Fragment blocks are generated as Content Fragment blocks (EDS-019). With --source cf / mixed, Claude Code now defaults to sonnet (a model in config still wins) and the prompt makes the CF field plus an async, fetching decorate() a hard requirement. On the fast default model both sources produced plain document blocks.
• Migrated checkboxes no longer default to ticked (EDS-032). The default now comes from checked, not from value (which is the value a ticked box submits), for Touch UI and Classic UI dialogs.
• Cursor and Codex get a large prompt through its file (EDS-017). They take the prompt as one command-line argument; past 96 KB (a scraped page of ~30 sections) it's replaced by a short instruction to read the saved prompt file, so the spawn can't hit Linux's 128 KB per-argument limit (E2BIG).
• Block preview blank-screen cases. The harness now (a) reduces a full-HTML _<name>.preview.html mock to its <body> contents, (b) reveals the body past the EDS body.appear visibility gate (which scripts.js would normally flip), and (c) loads the block script via a defensive dynamic import() so a bad import (e.g. a missing scripts/*.js) shows the authored markup instead of a blank frame. The prompt now requires a bare preview fragment and self-contained block JS.
• eds block preview header|footer now warns that these are page chrome and can't render standalone (they fetch the nav/footer fragment and need the full page runtime).
• Removed the dangling main/types fields that pointed at a never-built dist/index.js (a bare import "aem-eds-kit" would have failed) - the package is a CLI, exposed via its bin.

Added

• eds new [dir]: clone the latest EDS boilerplate locally (EDS-055). DA, Universal Editor (crosswalk) or Commerce, or any repo / git URL; no GitHub auth. Fresh git history by default, or --keep-history with an upstream remote; --ref, --remote, --install; then eds init, with UE preselected for crosswalk. Also first in the interactive menu.
• Local models: Ollama and oMLX (EDS-051). --agent ollama | omlx | local runs from-design on a local model (Ollama's native API with num_ctx; oMLX or any OpenAI-compatible server). The CLI embeds the design (scraped / REST spec, SVG text) or attaches a PNG/JPG for a vision model, asks for every file in a === FILE: … === format and writes them itself, only inside blocks/<name>/. Model from --model, local.model or a coder model on the server; context from local.contextTokens (default 32768, raised to fit). Used automatically when no CLI agent is installed. New --model flag.
• Changelog page on the site (EDS-048): site/changelog.html is generated from this file by scripts/site-changelog.mjs in the Pages workflow, with EDS-NNN references linked to their issues. It's in the nav on every page, the docs sidebar, the footers and the sitemap.
• The interactive menu stays open (EDS-042). eds with no command now returns to the menu after each action (or its failure). Arrows move, Enter runs, Esc goes back to the menu from any prompt and quits from the menu itself (or pick *Exit*); Ctrl+C quits anywhere. A preview opened from the menu stops on Esc / Enter and returns. Commands run with arguments still run once and exit.
• Figma REST calls are paced per minute (EDS-041). All eds runs in a project share a call log (tmp/eds-cli/figma-rest-calls.json) and wait for a free slot, so generating many blocks at once doesn't trip Tier 1's per-minute limit. figma.restPerMinute in config, default 10 (Professional; 15 Organization, 20 Enterprise). Twelve parallel runs: ten fetch at once, the last two at ~61 s, no 429.
• eds migrate component reads Classic UI dialogs (EDS-018). A component with only a dialog.xml (AEM 6.5) is mapped from its ExtJS xtypes - text, textarea, richtext (incl. the foundation rte.* include), pathfield, numberfield, selection (checkbox / select / radio, static options or datasource → text), smartimage, multifield (plain multi-value, or ACS multifieldpanel → container), tabpanel and cqinclude. Tested on the 22 Classic UI dialogs of ACS Commons 3.14: 21 migrate, 63 valid fields.
• eds block preview with no name → a live gallery of every content block, each in its own width-honest iframe. Routes are computed per request, so a block generated while the gallery is open appears on the next reload (header/footer are skipped - page chrome can't render standalone). New buildGallery + a dynamic request handler on the preview server.
• block from-design accepts a local SVG/PNG export (eds block from-design ./hero.svg) - reads the design straight from disk, no network and no MCP.
• Figma REST path via a Personal Access Token (FIGMA_TOKEN env or figma.token config, scope file_content:read) - a quota separate from the MCP tool-call limit. New flags --mcp (force MCP) and --refresh (ignore the cache).
• block from-design records the design's frame widths in the block's .eds-meta.json (breakpoints), so eds block preview is width-honest at the real design widths, not a fixed device set. The agent writes the widths it reads from the design (prompt instruction), --widths 390,768,1440 overrides, and 375/768/1280 remains the fallback. New src/lib/figma/breakpoints.ts (parseWidths / normalizeBreakpoints), extended edsMetaSchema.
• eds init writes a local-dev .env + xwalk.json by default. .env carries the aem up config (AEM_OPEN=/, AEM_PORT=3007, AEM_PAGES_URL prefilled from the git remote); it's never overwritten and always gitignored. xwalk.json (Universal Editor multi-field enabled) is written for UE projects. Opt out with --no-env / --no-xwalk. Standalone eds scaffold env and eds scaffold xwalk (re)generate either on demand.
• eds ue check / eds ue open - light Universal Editor helpers. No Docker, no local AEM SDK, no local UE Service. ue check is an offline readiness report (UE config files present + which blocks have a model, so you know which are editable). ue open [path] builds and opens the hosted Universal Editor deep link for your cloud author, deriving the preview host (main--<repo>--<owner>.aem.page) from the git remote; --org, --ref, --url, --no-open to tweak.
• Sandbox never overwrites an existing repo. eds sandbox new now checks whether <owner>/<name> already exists and refuses up front with a clear message (in addition to the GitHub template API, which never clobbers). Guards both the API and gh paths.
• Secure GitHub sandboxes guide (site): least-privilege setup - a fine-grained token scoped to a single repo, or a dedicated sandbox org via --org - plus the minimal permissions, token storage, and the overwrite/teardown safety notes. Linked from the docs and README; added to the sitemap.

v0.4.19 2026-10-08

Added

• eds sandbox login / logout - GitHub auth without gh. The sandbox now authorizes GitHub itself: the OAuth Device Flow (browser authorize) when an OAuth app is configured (EDS_GITHUB_CLIENT_ID), or a Personal Access Token otherwise; GITHUB_TOKEN/GH_TOKEN and an authenticated gh are also accepted (fallback). Repos are created/listed/deleted via the GitHub REST API. The token is stored owner-only (mode 0600) in ~/.eds/github.json. login guides you to a least-privilege fine-grained token (ideally scoped to a dedicated sandbox org via --org), so nothing outside your sandboxes is exposed. The CLI only ever lists sandboxes (by the eds-sandbox topic) and targets named repos.

v0.4.18 2026-10-08

Added

• eds sandbox - spin up and tear down disposable EDS sandbox repos on GitHub (via the gh CLI). sandbox new <name> creates a repo from a boilerplate (Document Authoring or Universal Editor / crosswalk), tags it eds-sandbox, and a guided wizard walks you through visibility, opening the AEM Code Sync install page, and running eds init. sandbox list shows your sandboxes with their preview URLs; sandbox rm <name> deletes one (with confirmation). From an empty folder to a live EDS environment - and gone again - in seconds. Needs the globally installed CLI and an authenticated gh.

Added

• eds template new composes blocks in order. The wizard adds blocks one by one (repeats allowed) so you control the exact sequence and count, instead of an unordered checkbox.
• Universal Editor initial content. For the UE model, template new now writes templates/<name>.json - the page's initial content as an ordered list of components with default field values read from each block's model (_<block>.json), plus registers the blocks so authors can add them. The EDS analog of an AEM editable template's initial content.

Changed

• eds template new is now authoring-aware. It detects the model from fstab.yaml / project markers (or --authoring da|gdrive|sharepoint|ue) and routes the generated page: DA push (existing), an importable doc for Google Docs / SharePoint, and for Universal Editor it registers the seeded blocks in component-filters.json (so authors can add them) and points to the AEM editable template. Completes the per-model template paths shown as an infographic on the docs page.

Added

• eds template new <name> - generate EDS page initial content (the EDS analog of an AEM template): a document of sections + chosen blocks + a metadata block. Writes templates/<name>.html locally and, with --push, pushes it to DA (da.live) via the source API (org/site from .edsrc.json or flags; DA_TOKEN for protected projects). --path, --title, --description, --blocks, --area. Also in the menu. (UE/crosswalk templates come next.)
• Docs: a "From zero to a published page" step-by-step command path.

v0.4.14 2026-10-08

Added

• eds schema block <name> (JSON-LD) - inject a schema.org structured-data builder into a block's decorate(). Types: Article, FAQPage, BreadcrumbList, Product, Organization, LocalBusiness, Event, VideoObject, Recipe, HowTo. Idempotent, reads the block content via a root alias, appends a <script type="application/ld+json"> to the head. --type, interactive picker.
• eds scaffold helpers - write scripts/utils.js, picking the helpers you want in an interactive checkbox (dependencies pulled in automatically) or by name: toCamelCase, getPagePath / getLanguageRootPath, getSiteArea (top-level area, e.g. blog), getEnvironment, getContentTopic, isUEEdit / isUEPreview / isUE, getMetadata. Also in the eds scaffold picker.

v0.4.13 2026-10-08

Added

• Model partials & helpers - a library of reusable Universal Editor field groups (heading, image, link, cta, cta-group, classes, eyebrow, richtext, embed, teaser, card) built from typed field builders (correct valueType per component), plus eds model add <block> [partials...] to compose them into a block's _<block>.json (added by name, never duplicated). The from-design / migrate prompt now lists the catalog so the agent reuses the standard groups instead of inventing fields. Also in the menu.

Added

• Framer as a design source for block from-design (alongside Figma, Google Stitch, Canva and Sketch) - the agent reads the project through its Framer MCP connection. Also added a copy-paste AI-agent setup prompt to the landing + README (checks Node 20+, installs the CLI, verifies).

Changed

• Landing version pill shows v0.4 (minor) instead of chasing every patch.

Added

• eds track block <name> - instrument a block's decorate() with dataLayer tracking on demand: delegated block_click (links/buttons, label from data-track or text) and form_submit, pushed via trackEvent from scripts/analytics.js. Adds the import and injects at the top of decorate, idempotent, keeps the real parameter name. --no-click / --no-submit. Also offered right after block from-design and migrate component, and in the menu.

v0.4.10 2026-10-08

Changed

• eds integrate gtm now emits a proper module instead of the inline IIFE: scripts/analytics.js (exports trackEvent / loadGTM, initialises the dataLayer, reads the id from gtm-id metadata with a configured fallback, idempotent, Date.now(), no dead <noscript> iframe) and scripts/page-meta.js (default-exported pageMetaPush). delayed.js imports both and pushes page metadata before GTM initialises. Fixes the "dataLayer is undefined" crash of the old snippet.

Added

• eds migrate component now pulls the component's clientlib CSS off disk into the block's CSS (auto-detected, or --clientlib <dir>): honours css.txt ordering + #base=, concatenates the .css, and flags any LESS/SCSS that needs a build. A starting point to review and scope under .<block> (the faithful, rendered-CSS path comes in a later phase).

v0.4.8 2026-10-07

Added

• eds migrate component <dir> - start migrating a classic AEM component to EDS. Phase 1 (deterministic, no agent/network): parses the Touch UI dialog (_cq_dialog/.content.xml) and maps its Granite/Coral fields onto the 17 Universal Editor field types - selects keep their options, multifields become repeatable containers, tabs are preserved - then writes blocks/<name>/ with a UE model, a decorator stub, and a scoped CSS file to fill from the clientlib or rendered page. Also in the eds menu.

v0.4.7 2026-10-07

Changed

• Consistent "no EDS project markers found" message across every command.

v0.4.6 2026-10-07

Added

• eds init - adapt a freshly cloned EDS boilerplate to your authoring model in one interactive wizard: pick Universal Editor (crosswalk), DA (da.live), Google Drive or SharePoint; set the project name (package.json + boilerplate placeholders); generate fstab.yaml only when the model needs it; scaffold the crosswalk config + paths.json for UE; optionally add the CI workflow; then walk the external steps (code-sync, content share, Sidekick) as a clickable checklist. Also in the eds menu. Flags: --name, --authoring, --mountpoint, --org, --site, --no-ci, --yes.

v0.4.5 2026-10-07

Fixed

• Project-root detection no longer requires fstab.yaml. Universal Editor / crosswalk and Document Authoring projects often don't have one, which made every command (and the generated CI) fail with "Not inside an EDS project". A root is now any ancestor with fstab.yaml, head.html, scripts/scripts.js, scripts/aem.js, component-definition.json, paths.json or helix-query.yaml.
• eds doctor treats a missing fstab.yaml as a warning, not a hard failure, so scaffold ci's doctor step doesn't break CI for fstab-less projects.

v0.4.4 2026-10-07

Added

• eds scaffold ci - generate a GitHub Actions workflow (.github/workflows/eds.yml) that runs the project's own lint/build (if present) plus the eds audits (doctor, audit loading, audit security) as a PR gatekeeper. Also offered in the interactive eds scaffold picker. Deterministic, no agent.

v0.4.3 2026-10-06

Changed

• CLI: a blinking accent caret now trails the animated logo line at the interactive entry points, matching the landing terminal.

Fixed

• Landing hero headline no longer wraps "Design frame in." onto three lines (tightened the clamp + tracking so each clause stays on one line).

v0.4.2 2026-10-06

Fixed

• README banner now uses an absolute raw.githubusercontent.com URL so it renders everywhere - npmjs rewrites relative links, but the GitHub Packages page does not, so the relative path showed a broken image there.

Changed

• CI: the GitHub Packages publish step tolerates an already-published version (409) instead of failing the whole workflow on re-runs.
• Added a dependency-free .githooks/pre-commit that auto-bumps the patch version whenever src/ changes are committed (wired via core.hooksPath).

v0.4.1 2026-10-06

Changed

• Animated the five accent dots at interactive entry points (eds menu and block from-design): a highlight bounces across them, then settles. Static fallback when piped or with --no-color.
• Removed the maker credit from the brand lockup and dropped "× Figma" from the default logo tagline (it reads as design-agnostic now).

Fixed

• Docs page links (logo / Home / nav) pointed at / and 404'd on the project Pages path - now relative to index.html.

v0.4.0 2026-10-06

Design-agnostic generation, a full interactive configurator, and the first version actually installable from npm (0.3.0 was unpublished before it shipped).

Added

• eds block from-design [url] - generate a block from Figma, Google Stitch, Canva or Sketch. The wizard's first step picks the design source; Figma keeps its pixel-perfect MCP path (get_design_context / get_variable_defs / get_screenshot), other providers pass a design reference read through their own MCP.
• Interactive configurator everywhere - eds with no command opens a menu, and from-design, scaffold, integrate and the Admin API are step-by-step wizards when run without arguments.
• eds scaffold ue / eds scaffold blocks - deterministic (no agent) Universal Editor components + a field-reference block covering all 17 field types and a multifield, plus standard Block Collection blocks.
• eds integrate - add GTM / GA4 / chat / consent to scripts/delayed.js (delayed phase, facade pattern for chat widgets).
• Live, colour-coded agent log with per-phase timings and a spinner; the live preview auto-starts after generating (and live-reloads if one is already running).

Changed

• Renamed block from-figma → block from-design (the figma-named command is gone). Not-yet-authored content uses lightweight placeholders instead of bundling design assets, so the block is visible before Universal Editor takes over.
• The brand logo prints once per run (no repeat when entering a command from the menu); CLI logo + dots use the landing accent #ff5a36.

v0.3.0 2026-10-05

First public release, published to npm as aem-eds-kit (the command stays eds). Delivers the full pipeline in one shot: Figma → pixel-perfect block → Universal Editor authoring interface.

Added

• eds block from-figma <url> - translate a Figma frame/component into an EDS block. Builds a prompt (project tokens + EDS conventions), runs it through your AI agent (Claude Code / Cursor / Codex) which reads the design via Figma MCP (get_design_context, get_variable_defs, get_screenshot), generates pixel-perfect JS + CSS, and self-verifies against the screenshot. Post-generation verification of the produced files.
• Universal Editor model by default - block create and block from-figma generate the UE model (_<name>.json, xwalk definitions/models/filters) so blocks are authorable in UE immediately. Figma text/image/link layers and component variants are mapped to UE fields (variants → select → CSS modifier). Opt out with --no-ue-model.
• eds block preview <name> - live, breakpoint-switchable preview served in the browser (dependency-free in-memory server). Width-honest <iframe> switcher (375 / 768 / 1280 / Full) reads breakpoints and the Figma link from the block's .eds-meta.json. --port, --widths, --no-open.
• eds block create <name> - scaffold a block (JS + CSS + UE model).
• eds block list - list blocks with file/UE/Figma status (--json).
• eds figma setup - configure Figma MCP for your AI agent.
• eds doctor - project audit (fstab, head.html, per-block JS, UE model, console.log, Figma-sync freshness, config). --json.
• eds audit loading - three-phase loading / LCP-budget audit. --json.
• eds audit security - npm audit (dependency vulnerabilities) + static exploit scan (XSS, eval, dynamic innerHTML, secrets, AWS/private keys, bearer tokens, mixed content, target="_blank" tabnabbing, postMessage('*'), inline handlers). Severity-grouped, --json, non-zero exit on critical/high.
• eds preview / eds publish <paths...> - preview/publish pages via the AEM Admin API.
• Branded CLI UX: gradient ANSI "EDS" wordmark (shown on help and command entry points), Adobe Spectrum palette, aligned status tables and summary boxes. Global flags --verbose, --quiet, --json, --no-color.
• Conventions baked into generation: blocks are full-width (full-bleed) and mobile-first by default; content capped for readability.

Notes

• The CLI is a dev tool - it ships nothing to your site bundle (0 bytes, no LCP impact). Published tarball ~74 kB.

v0.2.0 internal

Branded UX layer, shared presentation module, security audit, responsive preview harness, gradient ANSI logo. Not published (superseded by 0.3.0).

v0.1.0 internal

Initial CLI scaffold: block create, block from-figma, block list, figma setup, doctor, preview, publish. Not published.