@creator-notes/cnotes 0.35.1 → 0.40.0

package/skills/cnotes/SKILL.md

@@ -264,6 +264,16 @@ cnotes canvas add-node <canvasId> --note <noteId> [--x <n>] [--y <n>]   # (despi
 cnotes canvas add-text <canvasId> --content "<markdown>" [--size small|medium|large] [--color "<hex>"] [--x <n>] [--y <n>]  # inline (short only)
 cnotes canvas add-text <canvasId> --content-file <path.md> [--size small|medium|large] [--color "<hex>"] [--x <n>] [--y <n>]
 cnotes canvas add-richtext ...   # DEPRECATED alias of add-text (identical flags). Use add-text.
+# THE BOX IS DERIVED, NOT CHOSEN. You pick x/y; the server picks the size. WIDTH is the
+# --size preset: small 560px, medium 1120px, large 1680px. HEIGHT follows the content, and
+# there is no in-place content update: replacing a text element = remove-node + add-text,
+# and the new card is exactly as tall as its new content. So both halves bite — columns
+# pitched for a small card while the items are medium overlap by 460px each, and longer
+# copy at the same x/y runs over whatever sits below. The write still succeeds either way.
+# When it happens the response carries layoutWarning naming the run-over nodes (CLI also
+# prints it to stderr): reflow what's below (bulk-move / arrange), or hand the whole block
+# to `canvas place` and let the solver pack it, then re-check with canvas get. Never treat
+# "write succeeded" as "layout is fine" after a size bump or a content change.
 # A list item is a COLLECTION OF NOTES, not a text block. --description is a one-line FRAME;
 # the content is the member notes you pass to --notes. If you have N distinct things
 # (questions, risks, options), create N notes first — pick the right type, e.g. a Question
@@ -870,6 +880,8 @@ The schema is strict: an unknown or typo'd key anywhere in the doc (e.g. `gapp`,
 
 Leaf enums (exact values): richtext `size` = `small` | `medium` | `large`, `colorHex` = a saturated hex (omit for no background); list `viewMode` = `list` | `grid`, list `size` = `sm` | `md` | `lg` | `xl`.
 
+A richtext `size` is not a hint — it IS the width the card paints: `small` 560px, `medium` 1120px, `large` 1680px, with the height following the content. `place` measures that box for you, which is the whole reason to prefer it over hand-picked coordinates: pitch a row of columns for `small` and then send `medium` items and every card runs 460px into its neighbour.
+
 #### Section container (frame WITH content — preferred)
 
 Beyond the fixed-size leaf above, `section` is also a CONTAINER: wrap any