@zvada/cr8 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,16 +10,32 @@
10
10
 
11
11
  A warning makes the design unhealthy (`healthy: false`; the CLI exits 2); a notice is listed and does not. Fix existing nodes directly and run doctor again.
12
12
 
13
+ Doctor checks measured line boxes when the local renderer is available, including labels in unclipped frames. Read `textMeasurement`: `unavailable` means fixed-text overflow was estimated. Adaptive agent work refuses unavailable measurement. Inspect the pixels even with complete measurements: typography, hierarchy and visual balance still require judgment.
14
+
13
15
  ## Looking
14
16
 
15
17
  Diagnostics and full-resolution inspection alone are insufficient. Perform the visual acceptance gate the loaded playbook and style name, in the human canvas or on the export: a hero at 50 percent, a link preview at 400 px wide, an app icon at 32 px and in one colour, an App Store strip reduced to its first three frames. When a same-size local reference exists, `cr8 verify --reference <path> --root FRAME_ID` makes the canonical renderer and the diagnostics one reproducible gate.
16
18
 
17
19
  `open_canvas` (CLI `cr8 open`) answers the canvas URL for the person. When `agent-browser` is how you look at it yourself, pass `--session <name>` on every call so a shared browser never shows another agent's page; the canvas opens fitted to everything, so a single artboard reads as a thumbnail there, and the export is the real-scale check.
18
20
 
21
+ For layout readback, use `canvas_tree` with `rootId` (CLI `tree --root ID`). `resolved.localGeometry` is the actual box relative to its parent, and `resolved.worldGeometry` locates it on the canvas. The top-level geometry fields are stored inputs and may differ under flow layout.
22
+
23
+ ## Copy and resize
24
+
25
+ Before calling product UI reusable or responsive, test a duplicate with a longer realistic heading and action label, then at the narrowest intended width. Look for lost words, crowded controls, broken spacing, and a primary action pushed out of view. Fix the original and repeat only the cases affected by that fix. A single good-looking screenshot does not prove the design survives ordinary edits.
26
+
27
+ Use auto-height text and hug containers where the design should adapt. Duplicate the artboard, lengthen a heading and action label, then narrow the outer frame. Text should wrap, the button should retain its label, and the content column should grow without overlap. Inspect the first preview after each acknowledged edit and check its resolved dimensions. Keep deliberately fixed marketing compositions fixed; the resilience check applies where adaptation is intended.
28
+
19
29
  ## Export
20
30
 
21
31
  `canvas_export` (CLI `cr8 export --root FRAME_ID [--out PATH] [--scale 1|2]`) renders one root artboard with the canonical renderer, the same one the Export button and `verify` use, to a PNG under the project's `exports/` (or the path given), and is how a finished frame is handed over. Export the exact artboard that was accepted, open the file, and look at it at the size it will be seen. `--scale 2` doubles the pixels; a 512 px tile exported at scale 2 is the 1024 px icon.
22
32
 
33
+ Over MCP, `canvas_export` answers with the picture attached: look at it after every finished section, not once at the end, and fix what you see before composing the next. Over the CLI, read the exported file.
34
+
23
35
  ## Review boards
24
36
 
25
37
  A flow's `workflow_place_output` with `all: true` (CLI `workflow-place ID --all`) puts every output of the flow's last run on one review artboard, named after the flow, side by side at equal height, to the right of everything; the answer carries the board's geometry and each output's layer and file. Judge there, then place the chosen output on your own artboard. Delete the review board when it has served, or leave it clear of your work.
38
+
39
+ ## Verify against a reference
40
+
41
+ `verify --reference IMAGE --root ID` renders the artboard and compares it with the reference at the same size. Read `inkMismatchedFraction` before the whole-viewport number: a screen is mostly background, so one percent of all pixels can be a fifth of the text. `regions` names the cells that differ most; the difference image at `diffPath` shows every differing pixel in red over the dimmed render. Look at it before deciding what to fix, and fix the largest region first.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: cr8-flows
3
3
  description: Build, run and reuse CR8 Flows, node graphs over image, vector and video models, through its MCP or CLI surfaces. Use when a task needs several generations in sequence or in parallel, a repeatable recipe a person can rerun and edit, a video or vector step, or a chain such as draft, edit, upscale; and when a person asks for variations, a campaign kit, or a pipeline rather than one picture.
4
- allowed-tools: Bash(cr8:*), Bash(npx @zvada/cr8@0.1.0:*)
4
+ allowed-tools: Bash(cr8:*), Bash(npx @zvada/cr8@0.2.0:*)
5
5
  ---
6
6
 
7
7
  # CR8 Flows