@rulecad/cad 0.2.0 → 0.2.1

package/AGENTS.md

@@ -62,7 +62,8 @@ variable says which rule it comes from. Follow these steps; they're what makes a
 
 ## Talking to the person
 - Give links as one labelled line (`npx cad link <project>/<object> --md`), never a raw URL. If it says
-  "(not a release)", say so.
+  "(not a release)", say so. If it says the link is too long for chat, don't paste it: tell the person, and offer
+  short links (a secret Gist), which upload the model, so ask first.
 - Say what the checks found, with numbers. Ask before anything that leaves the computer: releases with `--push`,
   ordering boards, publishing.
 - Designs are code: only run designs you or the person trust. Links and rule files are data and never run.

package/README.md

@@ -69,9 +69,13 @@ fragment, which never reaches the web host, so the public page can open private
 which version it holds (`keyboard/keycap@0.1.0`, or `+changes` if it isn't a release). The page is to become `@rulecad/viewer`;
 `scripts/publish-view.sh "message"` publishes it (only that folder) to the public repo.
 
-- **Short links** (`--short`, and the default for `--md`): the link's data goes in a secret GitHub Gist (unlisted,
-  but anyone with the link can open it) and the link carries only its ID: `…/#s=<id>`. The page fetches it from
-  GitHub's API. The same model reuses its Gist (`.cache/links.json`).
+- **Short links** (`--short`, and the default for `--md`, once `"shorten": "gist"` is in `cad.config.json`'s
+  `targets`): the link's data goes in a secret GitHub Gist (unlisted, but anyone with the link can open it) and the
+  link carries only its ID: `…/#s=<id>`. The page fetches it from GitHub's API. The same model reuses its Gist
+  (`.cache/links.json`). `npm create rulecad` asks which you want. Without it, links carry the model, and `cad link`
+  says when one is too long for chat or email (over 8,000 characters).
+- **Boards** travel light: the board drawn from both sides (the page makes the front and back views from its layers)
+  and the schematic, with coordinates rounded to what a screen can show.
 - **Parts panel:** the page lists parts by kind (keycap ×9), opening to each copy (key-1-1). Each row shows or hides
   its parts and sets their style (solid, wireframe, x-ray, faint); the view has a mode, an explode slider, and
   switches for supports and references. Click a part in the model to select its copy and see its size.

package/bin/cad.mjs

@@ -330,8 +330,11 @@ async function shorten(l) {
 
 // --md: one line of labelled Markdown links, the form agents paste into chat (CLAUDE.md, "Replies with links").
 // Short (a Gist) unless --long; plain output is long (nothing uploaded) unless --short.
+const TOO_LONG = 8000; // characters: past this, chat apps and email cut a link short or refuse it
 async function printLinks(l) {
   if ((opt('md') && !opt('long')) || opt('short')) l = await shorten(l);
+  if (!l.short && l.view.length > TOO_LONG) console.error(`this link is ${(l.view.length / 1024).toFixed(0)} KB, too long for chat or email. ${hasTarget('shorten')
+    ? 'Leave out --long for a short one.' : 'For short links, add "shorten": "gist" to "targets" in cad.config.json: each model you share is then stored in a secret GitHub Gist (needs the gh command, signed in).'}`);
   // One link: the page picks which parts go in a download (all of them, one key, only the case)
   if (opt('md')) return console.log(`**${[l.title, l.version].filter(Boolean).join(' ')}**${l.src.includes('+') ? ' (not a release)' : ''}: [View and download](${l.view})`);
   console.log(`${l.src}, ${l.short ? 'short links (data in a secret Gist)' : `${(l.size / 1024).toFixed(1)} KB links`}${l.src.includes('+') ? ' (not a release: the link shows it)' : ''}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulecad/cad",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The cad command: JSCAD designs from traceable rules, checked for printing and fit, versioned by what fits, shared as links and exported as Bambu 3MF.",
   "type": "module",
   "bin": {