@nuvio/cli 0.5.4 → 0.5.5

package/README.md

@@ -1,17 +1,17 @@
 # @nuvio/cli
 
-One-command onboarding for Nuvio in Vite + React + Tailwind projects.
+One-command onboarding for nuvio in Vite + React + Tailwind projects.
 
 ```bash
 pnpm dlx @nuvio/cli init
 pnpm dev
 ```
 
-See [Nuvio docs](https://github.com/ehah/Nuvio/blob/main/docs/nuvioUser.md).
+See [nuvio docs](https://github.com/ehah/Nuvio/blob/main/docs/nuvioUser.md).
 
 ## Telemetry
 
-Nuvio collects anonymous usage metrics to improve onboarding and reliability. No source code, file contents, file paths, project names, emails, or personal data are sent.
+nuvio collects anonymous usage metrics to improve onboarding and reliability. No source code, file contents, file paths, project names, emails, or personal data are sent.
 
 Disable anytime with:
 

package/dist/cli-entry.js

@@ -13,15 +13,15 @@ import { join } from "path";
 // src/messages.ts
 var MSG = {
   noPackageJson: "Run this from your app folder (the one with package.json).",
-  noVite: "Nuvio works with React + Vite projects. I couldn't find a Vite config here.",
-  noReact: "Nuvio needs React. Add react to this project first.",
-  noViteDep: "Nuvio needs Vite. Add vite to this project first.",
-  strictTailwind: "Nuvio expects Tailwind CSS for class edits. Install tailwindcss or pass --skip-tailwind-check.",
-  monorepoRoot: "This looks like the Nuvio monorepo. Run init in your app folder, not the tooling repo.",
+  noVite: "nuvio works with React + Vite projects. I couldn't find a Vite config here.",
+  noReact: "nuvio needs React. Add react to this project first.",
+  noViteDep: "nuvio needs Vite. Add vite to this project first.",
+  strictTailwind: "nuvio expects Tailwind CSS for class edits. Install tailwindcss or pass --skip-tailwind-check.",
+  monorepoRoot: "This looks like the nuvio monorepo. Run init in your app folder, not the tooling repo.",
   cliPackage: "Cannot init inside @nuvio/cli package.",
-  partialHelp: "Nuvio set up what it could safely. Finish the steps in nuvio/SETUP_TODO.md, then run your dev server.",
-  noHeading: 'Nuvio is wired, but I could not find a heading to mark editable. Add data-nuvio-id="page.title" to one visible element (see nuvio/START_HERE.md).',
-  telemetryNotice: `Nuvio collects anonymous usage metrics to improve onboarding and reliability.
+  partialHelp: "nuvio set up what it could safely. Finish the steps in nuvio/SETUP_TODO.md, then run your dev server.",
+  noHeading: 'nuvio is wired, but I could not find a heading to mark editable. Add data-nuvio-id="page.title" to one visible element (see nuvio/START_HERE.md).',
+  telemetryNotice: `nuvio collects anonymous usage metrics to improve onboarding and reliability.
 No source code, file contents, file paths, project names, emails, or personal data are sent.
 
 Disable anytime with:
@@ -722,8 +722,11 @@ var FORBIDDEN_PROP_KEYS = /* @__PURE__ */ new Set([
   "message",
   "stack"
 ]);
+var SHUTDOWN_TIMEOUT_MS = 3e3;
 var client = null;
 var sessionAnonymousId = null;
+var shutdownDone = false;
+var signalHandlersRegistered = false;
 function telemetryDebug(message, detail) {
   if (process.env.NUVIO_TELEMETRY_DEBUG !== "1") return;
   if (detail !== void 0) {
@@ -796,6 +799,23 @@ function sanitizeProps(props) {
   }
   return Object.keys(out).length > 0 ? out : void 0;
 }
+function resolveCliInvokedCommand(help, command) {
+  if (help) return "help";
+  if (!command) return "none";
+  if (command === "init") return "init";
+  return "unknown";
+}
+function buildCliInvokedProps(command, pmOverride) {
+  const props = {
+    nuvio_version: NUVIO_VERSION,
+    os: process.platform,
+    arch: os.arch(),
+    node: process.version,
+    command
+  };
+  if (pmOverride) props.package_manager = pmOverride;
+  return props;
+}
 function buildCliTelemetryProps(pm, project) {
   const props = {
     nuvio_version: NUVIO_VERSION,
@@ -821,6 +841,9 @@ function preflightErrorCode(message) {
   }
   return "preflight_unknown";
 }
+function captureCliInvoked(command, pmOverride) {
+  captureCliEvent("nuvio_cli_invoked", buildCliInvokedProps(command, pmOverride));
+}
 function captureCliEvent(event, props) {
   try {
     if (!isTelemetryEnabled()) {
@@ -843,18 +866,46 @@ function captureCliEvent(event, props) {
     telemetryDebug(`capture failed for ${event}`, error);
   }
 }
+async function flushAndShutdownClient() {
+  if (!client) return;
+  const active = client;
+  client = null;
+  await Promise.race([
+    (async () => {
+      await active.flush();
+      await active.shutdown();
+    })(),
+    new Promise((_, reject) => {
+      setTimeout(
+        () => reject(new Error("telemetry shutdown timed out")),
+        SHUTDOWN_TIMEOUT_MS
+      );
+    })
+  ]);
+}
 async function shutdownTelemetry() {
+  if (shutdownDone) return;
+  shutdownDone = true;
   try {
-    if (client) {
-      await client.flush();
-      await client.shutdown();
-      client = null;
-      telemetryDebug("flush + shutdown complete");
-    }
+    await flushAndShutdownClient();
+    telemetryDebug("flush + shutdown complete");
   } catch (error) {
     telemetryDebug("shutdown failed", error);
   }
 }
+function registerTelemetrySignalHandlers() {
+  if (signalHandlersRegistered) return;
+  signalHandlersRegistered = true;
+  const onSignal = (signal) => {
+    void (async () => {
+      await shutdownTelemetry();
+      const code2 = signal === "SIGINT" ? 130 : 143;
+      process.exit(code2);
+    })();
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+}
 
 // src/init.ts
 function isAutoYes(opts) {
@@ -889,14 +940,14 @@ function computeTier(installOk, viteOk, appOk, starterOk) {
 function printSuccess(plan, checks) {
   if (checks.install) {
     console.log(
-      `\u2705 Nuvio packages targeted (@nuvio/vite-plugin@${NUVIO_VERSION}, @nuvio/overlay@${NUVIO_VERSION})`
+      `\u2705 nuvio packages targeted (@nuvio/vite-plugin@${NUVIO_VERSION}, @nuvio/overlay@${NUVIO_VERSION})`
     );
   }
   if (checks.vite) console.log("\u2705 Vite plugin added");
   else if (plan.failedSteps.some((s) => s.includes("vite"))) {
     console.log("\u26A0 Vite plugin \u2014 see nuvio/SETUP_TODO.md");
   }
-  if (checks.app) console.log("\u2705 Nuvio editor mounted");
+  if (checks.app) console.log("\u2705 nuvio editor mounted");
   else console.log("\u26A0 App shell \u2014 see nuvio/SETUP_TODO.md");
   if (checks.starter) {
     console.log(
@@ -917,7 +968,7 @@ Next:
 ${MSG.partialHelp}`);
   } else if (plan.tier === "partial") {
     console.log(
-      "\nNuvio helped you as far as it safely could. See warnings above."
+      "\nnuvio helped you as far as it safely could. See warnings above."
     );
   }
   console.log(`
@@ -1017,7 +1068,7 @@ async function runInit(opts) {
         return 1;
       }
     } else {
-      console.log("\u2705 Nuvio packages already installed");
+      console.log("\u2705 nuvio packages already installed");
     }
   } else {
     console.log("(skipped install \u2014 --no-install)");
@@ -1103,7 +1154,7 @@ async function runInit(opts) {
 
 // src/cli.ts
 function printHelp() {
-  console.log(`nuvio \u2014 Nuvio CLI
+  console.log(`nuvio \u2014 CLI for React + Vite
 
 Usage:
   nuvio init [options]
@@ -1159,21 +1210,23 @@ function parseArgs(argv) {
   return { command, opts, help };
 }
 async function runCli(argv) {
+  registerTelemetrySignalHandlers();
   const { command, opts, help } = parseArgs(argv);
-  if (help) {
-    printHelp();
-    return 0;
-  }
-  if (!command) {
-    printHelp();
-    return 1;
-  }
-  if (command !== "init") {
-    console.error(`Unknown command: ${command}`);
-    printHelp();
-    return 1;
-  }
+  captureCliInvoked(resolveCliInvokedCommand(help, command), opts.pm);
   try {
+    if (help) {
+      printHelp();
+      return 0;
+    }
+    if (!command) {
+      printHelp();
+      return 1;
+    }
+    if (command !== "init") {
+      console.error(`Unknown command: ${command}`);
+      printHelp();
+      return 1;
+    }
     return await runInit(opts);
   } catch (e) {
     const pm = detectPackageManager(opts.cwd, opts.pm);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuvio/cli",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Nuvio CLI: one-command Vite + React onboarding (nuvio init).",
   "license": "MIT",
   "repository": {

package/templates/AGENT.md.tpl

@@ -1,9 +1,9 @@
 <!-- nuvio-cli-template: 1 -->
-# Nuvio agent instructions
+# nuvio agent instructions
 
-This project uses [Nuvio](https://www.npmjs.com/org/nuvio) (dev-only visual editor).
+This project uses [nuvio](https://www.npmjs.com/org/nuvio) (dev-only visual editor).
 
-When the user asks to make UI editable or wire Nuvio:
+When the user asks to make UI editable or wire nuvio:
 
 1. Do **not** change unrelated files.
 2. Add **string literal** `data-nuvio-id="region.name"` on JSX elements they should click in the browser.

package/templates/README.pointer.md.tpl

@@ -1,5 +1,5 @@
 <!-- nuvio-cli-template: 1 -->
-# Nuvio
+# nuvio
 
 **Start here:** [START_HERE.md](./START_HERE.md)
 

package/templates/SETUP_TODO.md.tpl

@@ -1,5 +1,5 @@
 <!-- nuvio-cli-template: 1 -->
-# Nuvio setup — manual steps
+# nuvio setup — manual steps
 
 @nuvio/cli could not safely patch: {{FAILED_STEPS}}
 

package/templates/START_HERE.md.tpl

@@ -1,5 +1,5 @@
 <!-- nuvio-cli-template: 1 -->
-# Start here — Nuvio in this project
+# Start here — nuvio in this project
 
 Installed with @nuvio/cli@{{NUVIO_VERSION}}.
 
@@ -7,7 +7,7 @@ Installed with @nuvio/cli@{{NUVIO_VERSION}}.
 
 **Then:**
 1. Open the localhost URL from the terminal
-2. Turn **Edit** on (Nuvio chip)
+2. Turn **Edit** on (nuvio chip)
 3. Click the starter element (usually the page title — id `page.title`)
 4. **Preview Changes** → **Apply to Code**