@cychien/ezdesign 0.8.1 → 0.9.2

package/dist/vite.mjs

@@ -10,11 +10,17 @@ var APP_NAME = "ezdesign";
 var ENV_PREFIX = APP_NAME.toUpperCase();
 var DATA_DIR = process.env[`${ENV_PREFIX}_DATA_DIR`] ?? join(homedir(), `.${APP_NAME}`);
 var SESSIONS_DIR = join(DATA_DIR, "sessions");
+var LEGACY_SESSIONS_DIR = join(DATA_DIR, "sessions-legacy");
 var REGISTRY_FILE = join(DATA_DIR, "daemon.json");
 var DAEMON_LOG = join(DATA_DIR, "daemon.log");
+var ACP_NPM_PREFIX = join(DATA_DIR, "acp");
 var VERSIONS_DIR = join(DATA_DIR, "versions");
 var UPDATE_CHECK_FILE = join(DATA_DIR, "update-check.json");
+var LIBRARY_HOME_ENV = `${ENV_PREFIX}_LIBRARY_HOME`;
 var NO_UPDATE_CHECK_ENV = `${ENV_PREFIX}_NO_UPDATE_CHECK`;
+var DESIGN_HARNESS_ENV = `${ENV_PREFIX}_DESIGN_HARNESS`;
+var API_URL_ENV = `${ENV_PREFIX}_API_URL`;
+var NO_IDLE_STOP_ENV = `${ENV_PREFIX}_NO_IDLE_STOP`;
 var CONTROL_PORT_ENV = `${ENV_PREFIX}_CONTROL_PORT`;
 var MAX_ATTACHMENT_BYTES = 8 * 1024 * 1024;
 var ATTACHMENT_GRACE_MS = 24 * 60 * 6e4;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cychien/ezdesign",
-  "version": "0.8.1",
+  "version": "0.9.2",
   "description": "Annotate your live dev app in the browser; feedback flows to your local coding agent, which edits the source. Review, iterate, repeat.",
   "type": "module",
   "author": "Justin Chien",
@@ -32,9 +32,10 @@
     "dev": "node scripts/dev.mjs",
     "dev:agent": "node scripts/dev-agent.mjs",
     "dev:cli": "node scripts/dev-cli.mjs",
+    "brand": "node scripts/brand-wordmark.mjs && node --import tsx scripts/brand-assets.mjs",
     "check": "npm run build && npm run typecheck && npm test",
-    "typecheck": "tsc --noEmit && tsc -p fixtures/playground --noEmit",
-    "test": "node --import tsx --test \"test/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit && tsc -p src/extension --noEmit && tsc -p fixtures/playground --noEmit",
+    "test": "node scripts/test.mjs",
     "version": "node scripts/sync-skill-version.mjs && git add skills/ezdesign/SKILL.md",
     "prepublishOnly": "npm run check"
   },
@@ -42,7 +43,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.13"
   },
   "keywords": [
     "agent",
@@ -57,7 +58,7 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.4.0",
     "@babel/parser": "^7.26.0",
-    "@hugeicons/core-free-icons": "^4.2.3",
+    "@hugeicons/core-free-icons": "^4.3.5",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "express": "^5.1.0",
     "http-proxy-middleware": "^3.0.3",
@@ -66,12 +67,14 @@
     "zod": "^4.5.4"
   },
   "devDependencies": {
+    "@fontsource/geist-sans": "5.3.0",
     "@types/express": "^5.0.0",
     "@types/node": "^22.10.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.5",
     "@vitejs/plugin-react": "^4.7.0",
     "esbuild": "^0.25.0",
+    "opentype.js": "1.3.4",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "tsx": "^4.23.11",

package/skills/ezdesign/SKILL.md

@@ -1,78 +1,35 @@
 ---
 name: ezdesign
-description: A design harness for a web project (增強設計), and the way into an ezdesign review session. Five steps - product, stack, design, components, make - that build UI which belongs to the product and its visual system rather than to a template. Use the harness only when the user explicitly asks for 增強設計 or the design harness, never for an ordinary UI request; use the review part when the user asks to review or annotate a running page.
+description: Open an ezdesign review session on a running web page. The user annotates the page in the browser, and each batch reaches the coding agent with exact source locations. Use when the user invokes /ezdesign, or asks to review, annotate or give visual feedback on a running page, or to explore designs on a canvas.
 metadata:
-  version: 0.8.1
+  version: 0.9.2
 ---
 
 # ezdesign
 
-A design harness for a web project. It runs in Claude Code, Codex, Gemini CLI or any agent that
-can read this file, and it needs no ezdesign session, daemon or UI: the project is the evidence,
-the browser tool is whatever the agent has, and the two files at the project root are the
-configuration. When an ezdesign review session *is* open, its daemon points each turn at the step's
-file directly and this file is not on the path.
-
-## The harness
-
-| Step | File | Runs when | Produces |
-| --- | --- | --- | --- |
-| 1 product | [reference/product.md](reference/product.md) | no `PRODUCT.md` | `PRODUCT.md` |
-| 2 stack | [reference/stack.md](reference/stack.md) | `.ezdesign/config.json` is missing, stale, or names no browser tool | `.ezdesign/config.json`: the stack, the design system and component library in use, the browser tool |
-| 3 design | [reference/design.md](reference/design.md) | no `DESIGN.md` | `DESIGN.md`: the visual language in broad strokes, a direction rather than a spec, no components |
-| 4 components | [reference/components.md](reference/components.md) | `.ezdesign/config.json` records no `components.primitives` | `DESIGN.md`'s language made concrete in the design system, and the component set written in the project's own library |
-| 5 make | [reference/make.md](reference/make.md) | a request to change or build UI, or an explore round asking for variants | the change, or the variants |
-
-Steps 1 to 4 configure the project; 5 is the work, and it ends by having an independent reviewer
-judge what it made ([reference/critique.md](reference/critique.md)) and letting `PRODUCT.md`,
-`DESIGN.md` and this user's taste, `.ezdesign/taste.md` - which the work is built to and judged by -
-learn from the request. Each
-step reads what the ones before it produced, and a step never rewrites another step's file. A step
-whose file is not there yet says so in one line and is skipped.
-
-## When the harness applies
-
-Only in a turn that explicitly turns it on, never by default. Inside an ezdesign review session,
-that is a prompt saying `增強設計 (the design harness) is on for this turn.` Outside a session, it
-is a request in which the user asks for 增強設計 or the design harness by name.
-
-Any other turn is handled as if this skill had never been read, even later in a conversation where
-the harness was on: no harness steps, no designing by `PRODUCT.md` or `DESIGN.md`, no review by
-its rules, and no edits to `PRODUCT.md`, `DESIGN.md` or `.ezdesign/config.json` unless the request
-asks for one.
-
-When it applies, talk to the user in the language they write in and in their words - 增強設計,
-設計規範, 靈感 - never the harness's own: harness, step or file names, precedent, inspire, or the
-review and its scores, which are the agent's business and not theirs.
-
-- **Both files exist: in the harness.** Read `PRODUCT.md` and `DESIGN.md` before any visual change.
-  Keep to `PRODUCT.md`; take `DESIGN.md` as a direction to start from, not a rule to obey. An
-  ordinary change edits code only; the two
-  files change only as step 5 says. Run step 5 for the request. When `.ezdesign/config.json` is
-  missing or stale, run step 2 first; when it records no `components.primitives`, run step 4
-  first.
-- **Either is missing: ask before anything else**, because the harness cannot run without it. Ask
-  the user, word for word, naming only the file that is missing when one exists:
-
-  > 啟用增強設計：增強設計會建立 PRODUCT.md 與 DESIGN.md，是否繼續？
-
-  with two options in this order: 「繼續」 and 「取消」. Use your question tool if you have
-  one; otherwise ask in your reply and end the turn.
-  - **Yes:** walk steps 1 to 4 in order, starting at the first one whose output is missing, then
-    do the work through step 5.
-  - **No:** the harness cannot be used. Do the work as you would without this skill.
-
-## Opening an ezdesign review
-
-When the user wants to annotate a running page in the browser and have the feedback come back as
-exact source locations, open a review session: [reference/start.md](reference/start.md). This is
-the one part of the skill that needs ezdesign installed.
+Open a review: [reference/start.md](reference/start.md). A bare `/ezdesign`, with nothing after
+it, is that request: open a review on the project's running dev server.
 
 ## Inside a review session
 
 The daemon has done the routing: its prompt says whether the turn is a feedback batch or an
-explore round, and names the file to read. Do not route again. A batch adds what a bare request
-cannot: the page's `url`, the annotated `items` with their `anchor` (source `file:line`, selector,
-viewport), `references`, and `attachments`. An explore adds one element's capture - its markup,
-computed styles, slot and the page's tokens - and takes each variant back through a tool, editing
-no file. The making step says where each of those is used.
+explore round, and what to do with it. Do not route again. A batch carries the page's `url`, the
+annotated `items` with their `anchor` (source `file:line`, selector, viewport), `references`, and
+`attachments`. An explore adds one element's capture - its markup, computed styles, slot and the
+page's tokens - and takes each variant back through a tool, editing no file.
+
+## Canvases
+
+An ACP review session also gives you the `ezdesign-canvas` tools. Each turn's prompt says which tab
+the user sent the batch from and which canvases exist.
+
+- When the user wants to explore directions, compare options or see a design before it is built,
+  put each one in a frame on a canvas: one `add_frame` per design, as soon as each is ready, on the
+  canvas the turn's prompt names. Call `create_canvas` only when no canvas is open or the user asks
+  for a new one. Leave `position` out; frames are placed for you.
+- A frame is a complete HTML document with its own `<head>` and styles, at a real viewport width
+  (390 phone, 768 tablet, 1280 desktop). Nothing is shared between frames.
+- An item whose `anchor.frame` is set was made inside a frame: `anchor.source` is a line of that
+  frame's file under `.ezdesign/canvases/`. Change a frame with `update_frame` (pass the
+  `expectedHash` you last read) or by editing its file.
+- Never edit `canvas.json` or `layout.json` by hand. Where a frame sits and its size are the user's.

package/skills/ezdesign/reference/start.md

@@ -28,7 +28,9 @@ the user did not provide an ACP command, ask them which ACP agent to use.
 
 ## Workflow
 
-1. Make sure the dev server is running. Never start a second instance when one is already up.
+1. Make sure the dev server is running. Never start a second instance when one is already up. If
+   the user only wants to explore designs on a canvas, there may be no dev server: run the command
+   below without the url and the review opens on the project's canvases.
 2. From the project root, run:
 
    ```sh