@calo-design/cli 0.4.4 → 0.4.6

package/bin/cli.js

@@ -589,16 +589,35 @@ async function cmdUpdate() {
   // Re-pin when the runtime is fully present OR merely scaffolded (package.json on disk),
   // so a half-installed runtime self-heals via plain `update` instead of being stranded.
   const scaffolded = fs.existsSync(path.join(runtimeDir(), "package.json"));
+  // Snapshot the pinned @calo commit SHAs BEFORE re-pinning, so we can tell whether this update
+  // actually moved anything. The design system is git-HEAD-tracked (pinned by commit, not by an
+  // npm version bump — its package.json version can sit unchanged across many real commits), so
+  // the SHA is the true "did anything change" signal.
+  const before = installedCaloShas(runtimeDir()) || {};
+  let repinned = false;
   if (runtimeExists() || scaffolded || has("--build")) {
     await ensureRuntime({ force: true });
     ok("shared runtime re-pinned — every linked prototype now uses the latest Calo stack");
+    repinned = true;
   } else {
     log(c.dim("  No shared runtime yet — run `calo-design init` in a prototype folder to create one."));
   }
-  // Report the refresh to the design-ops feed, tagged with the DS version we floated to.
+  // Only record an update event when the pinned code ACTUALLY changed (or we can't tell / it's a
+  // first install). A no-op re-pin — clicking Update when nothing new shipped — writes nothing,
+  // so the feed stops filling with identical "updated the design system to 0.2.0" rows.
+  const after = installedCaloShas(runtimeDir()) || {};
+  const changed = !Object.keys(before).length || JSON.stringify(before) !== JSON.stringify(after);
+  if (repinned && !changed) {
+    log(c.dim("  Already up to date — nothing new to record in the feed."));
+    return;
+  }
+  // Tag the feed entry with the DS version we floated to (read fresh from disk, not require()'s
+  // cache). Bump @calo/design-system's version on real releases (`npm run release` there) to make
+  // this number meaningful — the SHA gate above already guarantees it only logs on real change.
   let dsVersion = "";
   try {
-    dsVersion = require(path.join(runtimeDir(), "node_modules", "@calo", "design-system", "package.json")).version || "";
+    const pj = JSON.parse(fs.readFileSync(path.join(runtimeDir(), "node_modules", "@calo", "design-system", "package.json"), "utf8"));
+    dsVersion = pj.version || "";
   } catch { /* runtime not present — report without a version */ }
   await reportEvent("update", dsVersion);
 }
@@ -640,6 +659,28 @@ async function cmdFeed() {
   for (const e of data.events) log(`${c.dim(e.ts)}  ${e.email}  ${c.b(e.action)}  ${e.target || ""}`);
 }
 
+// Per-prototype analytics (Design Kitchen reads this via `--json`). Same session reuse as
+// the feed; the broker holds the Clarity token and does the caching — this is a dumb pipe.
+async function cmdInsights() {
+  const session = await ensureSession();
+  let res;
+  try {
+    res = await fetch(`${BROKER}/v1/clarity/insights`, {
+      headers: { authorization: `Bearer ${session}` },
+      signal: AbortSignal.timeout(20000),
+    });
+  } catch (e) {
+    throw new Error(`can't reach the Calo broker at ${BROKER} (${e.message})`);
+  }
+  const text = await res.text();
+  if (!res.ok) throw new Error(`insights failed (${res.status}): ${text.slice(0, 200)}`);
+  if (has("--json")) { process.stdout.write("\n" + text + "\n"); return; }
+  const data = JSON.parse(text);
+  const protos = Object.values(data.prototypes || {});
+  log(`${data.totals?.sessions ?? 0} sessions across ${protos.length} prototype(s) · last ${data.windowDays} days`);
+  for (const p of protos) log(`  ${c.b(p.slug || p.host)}  ${p.sessions} sessions · ${p.activeSeconds}s active`);
+}
+
 // Serve the component gallery (the @calo/design-system showroom) locally, rendered LIVE from
 // the shared runtime — so `calo-design update` keeps it current (no rebuild/redeploy). Design
 // Kitchen auto-starts this; it also works standalone in a terminal. Runs Metro in the
@@ -706,6 +747,7 @@ function help() {
     else if (cmd === "push") await cmdPush(args.slice(1));
     else if (cmd === "share") await cmdShare(args.slice(1));
     else if (cmd === "feed") await cmdFeed();
+    else if (cmd === "insights") await cmdInsights();
     else if (cmd === "whoami") await cmdWhoami();
     else if (cmd === "gallery") await cmdGallery();
     else help();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calo-design/cli",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "One-line setup for Calo design tooling: logs in with your Calo email and installs the calo-design skill + design-system packages. No GitHub account needed.",
   "bin": {
     "calo-design": "bin/cli.js"