@creator-notes/cnotes 0.73.0 → 0.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creator-notes/cnotes",
-  "version": "0.73.0",
+  "version": "0.75.0",
   "description": "CLI for CreatorNotes — create notes, build canvases, search knowledge from the terminal",
   "type": "module",
   "bin": {

package/skills/cnotes/SKILL.md

@@ -309,7 +309,12 @@ cnotes canvas get <canvasId>
 # to {id, kind, displayId, label, positionX, positionY, width, height} — plus
 # `contentBounds` (the bounding box of everything). Use allNodes/contentBounds to
 # reason about occupancy in one read instead of unioning the per-kind arrays.
-# (You rarely need this for placement — `cnotes canvas place` already avoids overlaps.)
+# Portals live in canvasLinkNodes, NOT nodes: checking only `nodes` is how a card
+# got dropped exactly on a portal. (You rarely need this for placement —
+# `cnotes canvas place` already avoids overlaps.)
+# See the whole layout before touching x/y: every item's box by kind, the pairs
+# that overlap, and with --near a free spot next to an anchor.
+cnotes canvas status <canvasId> [--near <displayId|nodeId|x,y>] [--size 280x130]
 
 # Read a canvas as STRUCTURE, not just content — one round-trip to think across it.
 # Returns the notes as concatenated markdown in display order (top-to-bottom, then
@@ -352,7 +357,10 @@ cnotes canvas unarchive <canvasId>
 
 # Add nodes to canvas — see "Canvas Elements — When to Use What" before choosing.
 # Default to NOTES for content; text/list/section are presentation furniture.
-cnotes canvas add-node <canvasId> --note <noteId> [--x <n>] [--y <n>]   # (despite the name, add-node adds NOTE nodes only)
+# PUT CARDS ON A CANVAS WITH `canvas place` (below): it packs them overlap-free and
+# --placement auto finds the space. add-node is LOW-LEVEL: raw x/y, no collision
+# check (it warns after the fact). Only use it with a spot from `canvas status --near`.
+cnotes canvas add-node <canvasId> --note <noteId> [--x <n>] [--y <n>]   # low-level; NOTE nodes only
 # text = free-form rich text placed on the canvas (wire type: richtext). Markdown —
 # headings, emphasis, images. Optional background tint (--color); DEFAULT IS NO BACKGROUND.
 # A HEADING IS JUST `--content '# Q1 Goals'` with no tint — there is no separate heading
@@ -405,6 +413,12 @@ cnotes canvas add-section <canvasId> --name "<title>" [--x <n>] [--y <n>] [--wid
 # breaks every [[SECTION-51]] mention pointing at the old one.
 cnotes canvas update-section <canvasId> --section SECTION-51 --height 1800
 cnotes canvas update-section <canvasId> --section SECTION-51 --name "Open Questions" [--x <n>] [--y <n>] [--width <n>] [--color "<hex>"] [--clear-color]
+# Edit a Text card's words IN PLACE (same node id, edges and mentions survive).
+# Card ids: the `id` on kind:richtext elements in `cnotes canvas read <canvasId> --json`.
+# --find must match exactly once; never delete + re-add a card to change its copy.
+cnotes canvas update-text <canvasId> --node <nodeId> --find "picks none" --replace "picks none (10 Oct 2026)"
+cnotes canvas update-text <canvasId> --node <nodeId> --append "Answered on 10 Oct 2026."
+cnotes canvas update-text <canvasId> --node <nodeId> --content-file ./banner.md [--size large] [--color "<hex>"]
 
 # Place items using a declarative layout (NO x/y math — server packs them)
 # This is the PREFERRED way to add multiple items. See "Canvas Layout" below.
@@ -421,6 +435,9 @@ cnotes canvas arrange <canvasId> --section SECTION-90 \
 cnotes canvas bulk-add <canvasId> --notes '[{"noteId":"NOTE-1","x":100,"y":100},{"noteId":"NOTE-2","x":400,"y":100}]'
 
 # Move / remove nodes (--type for non-note nodes, e.g. --type section)
+# move-node is LOW-LEVEL: raw x/y, no collision check (it warns when the node lands
+# on something). To tidy or reorganize, use `canvas arrange`; to pick a spot by
+# hand, get one from `canvas status <canvasId> --near <ref>` first.
 # NOTE: `text` in these type lists is the LEGACY heading kind (old canvases only). It can no
 # longer be CREATED, but existing ones stay movable and deletable — that is why it is still
 # accepted here. Today's Text element is `richtext`.