libretto 0.6.25 → 0.6.26

package/README.md

@@ -95,7 +95,7 @@ All Libretto state lives in a `.libretto/` directory at your project root. See t
 
 ## Telemetry
 
-Libretto records anonymous CLI telemetry to help understand CLI usage and help us prioritize improvements. Each resolved command can send only an install id, timestamp, command event name such as `libretto run`, and an error boolean. Libretto does not send command arguments, URLs, project paths, auth state, API keys, error messages or details, or user identity.
+Libretto records anonymous CLI telemetry to help understand CLI usage and help us prioritize improvements. Each resolved command can send only an install id, timestamp, command event name such as `libretto run`, error boolean, package version, and build channel (`node_modules`, `source`, or `unknown`). Libretto does not send command arguments, URLs, project paths, auth state, API keys, error messages or details, or user identity.
 
 The install id is stored in the telemetry file at `~/.libretto/telemetry.json`. The implementation lives in [`src/cli/core/telemetry.ts`](src/cli/core/telemetry.ts).
 

package/README.template.md

@@ -93,7 +93,7 @@ All Libretto state lives in a `.libretto/` directory at your project root. See t
 
 ## Telemetry
 
-Libretto records anonymous CLI telemetry to help understand CLI usage and help us prioritize improvements. Each resolved command can send only an install id, timestamp, command event name such as `libretto run`, and an error boolean. Libretto does not send command arguments, URLs, project paths, auth state, API keys, error messages or details, or user identity.
+Libretto records anonymous CLI telemetry to help understand CLI usage and help us prioritize improvements. Each resolved command can send only an install id, timestamp, command event name such as `libretto run`, error boolean, package version, and build channel (`node_modules`, `source`, or `unknown`). Libretto does not send command arguments, URLs, project paths, auth state, API keys, error messages or details, or user identity.
 
 The install id is stored in the telemetry file at `~/.libretto/telemetry.json`. The implementation lives in [`{{LIBRETTO_PATH_PREFIX}}src/cli/core/telemetry.ts`]({{LIBRETTO_PATH_PREFIX}}src/cli/core/telemetry.ts).
 

package/dist/cli/core/telemetry.js

@@ -1,11 +1,38 @@
 import { randomUUID } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
 import { promises as fs } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { resolveHostedApiUrl } from "./auth-fetch.js";
 const TELEMETRY_FILE_NAME = "telemetry.json";
 const TELEMETRY_ENDPOINT_PATH = "/v1/telemetry/recordCliEvent";
 const TELEMETRY_TIMEOUT_MS = 250;
+function packageRoot() {
+  return join(dirname(fileURLToPath(import.meta.url)), "../../..");
+}
+function readPackageVersion() {
+  try {
+    const parsed = JSON.parse(
+      readFileSync(join(packageRoot(), "package.json"), "utf8")
+    );
+    return typeof parsed.version === "string" ? parsed.version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function resolveBuildChannel() {
+  const root = packageRoot();
+  const workspaceRoot = join(root, "../..");
+  if (basename(dirname(root)) === "packages" && existsSync(join(workspaceRoot, "pnpm-workspace.yaml"))) {
+    return "source";
+  }
+  const pathSegments = root.split(/[\\/]+/);
+  if (pathSegments.includes("node_modules")) return "node_modules";
+  return "unknown";
+}
+const packageVersion = readPackageVersion();
+const buildChannel = resolveBuildChannel();
 function telemetryDir() {
   return join(homedir(), ".libretto");
 }
@@ -39,7 +66,7 @@ function writeTelemetryNotice() {
   if (!process.stderr.isTTY) return;
   process.stderr.write(
     [
-      "Libretto collects anonymous CLI telemetry: install id, timestamp, command event, and error status only.",
+      "Libretto collects anonymous CLI telemetry: install id, timestamp, command event, error status, package version, and build channel only.",
       "Set LIBRETTO_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 to disable it, or set enabled:false in ~/.libretto/telemetry.json."
     ].join(" ") + "\n"
   );
@@ -59,7 +86,9 @@ async function recordCliTelemetryEvent(command, error) {
     installId,
     timestamp: (/* @__PURE__ */ new Date()).toISOString(),
     event: `libretto ${command.path.join(" ")}`,
-    error
+    error,
+    packageVersion,
+    buildChannel
   });
 }
 async function sendWithTimeout(payload) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.6.25",
+  "version": "0.6.26",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "homepage": "https://libretto.sh",

package/skills/libretto/SKILL.md

@@ -4,7 +4,7 @@ description: "Browser automation CLI for building, maintaining, and running brow
 license: MIT
 metadata:
   author: saffron-health
-  version: "0.6.25"
+  version: "0.6.26"
 ---
 
 ## How Libretto Works

package/skills/libretto-readonly/SKILL.md

@@ -4,7 +4,7 @@ description: "Read-only Libretto workflow for diagnosing live browser state with
 license: MIT
 metadata:
   author: saffron-health
-  version: "0.6.25"
+  version: "0.6.26"
 ---
 
 ## How Libretto Read-Only Works

package/src/cli/core/telemetry.ts

@@ -1,7 +1,9 @@
 import { randomUUID } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
 import { promises as fs } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import type { SimpleCLICommandMeta, SimpleCLIMiddleware } from "affordance";
 import { resolveHostedApiUrl } from "./auth-fetch.js";
 
@@ -9,6 +11,8 @@ const TELEMETRY_FILE_NAME = "telemetry.json";
 const TELEMETRY_ENDPOINT_PATH = "/v1/telemetry/recordCliEvent";
 const TELEMETRY_TIMEOUT_MS = 250;
 
+type BuildChannel = "node_modules" | "source" | "unknown";
+
 type StoredTelemetryState = {
   installId?: string;
   enabled?: boolean;
@@ -19,8 +23,48 @@ type CliTelemetryPayload = {
   timestamp: string;
   event: string;
   error: boolean;
+  packageVersion: string;
+  buildChannel: BuildChannel;
+};
+
+type PackageJson = {
+  version?: unknown;
 };
 
+function packageRoot(): string {
+  return join(dirname(fileURLToPath(import.meta.url)), "../../..");
+}
+
+function readPackageVersion(): string {
+  try {
+    const parsed = JSON.parse(
+      readFileSync(join(packageRoot(), "package.json"), "utf8"),
+    ) as PackageJson;
+    return typeof parsed.version === "string" ? parsed.version : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function resolveBuildChannel(): BuildChannel {
+  const root = packageRoot();
+  const workspaceRoot = join(root, "../..");
+  if (
+    basename(dirname(root)) === "packages" &&
+    existsSync(join(workspaceRoot, "pnpm-workspace.yaml"))
+  ) {
+    return "source";
+  }
+
+  const pathSegments = root.split(/[\\/]+/);
+  if (pathSegments.includes("node_modules")) return "node_modules";
+
+  return "unknown";
+}
+
+const packageVersion = readPackageVersion();
+const buildChannel = resolveBuildChannel();
+
 function telemetryDir(): string {
   return join(homedir(), ".libretto");
 }
@@ -65,7 +109,7 @@ function writeTelemetryNotice(): void {
   if (!process.stderr.isTTY) return;
   process.stderr.write(
     [
-      "Libretto collects anonymous CLI telemetry: install id, timestamp, command event, and error status only.",
+      "Libretto collects anonymous CLI telemetry: install id, timestamp, command event, error status, package version, and build channel only.",
       "Set LIBRETTO_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 to disable it, or set enabled:false in ~/.libretto/telemetry.json.",
     ].join(" ") + "\n",
   );
@@ -92,6 +136,8 @@ async function recordCliTelemetryEvent(
     timestamp: new Date().toISOString(),
     event: `libretto ${command.path.join(" ")}`,
     error,
+    packageVersion,
+    buildChannel,
   });
 }