@mintlify/cli 4.0.1791 → 4.0.1793

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1791",
+  "version": "4.0.1793",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,13 +45,13 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.1337",
-    "@mintlify/link-rot": "3.0.1577",
+    "@mintlify/common": "1.0.1338",
+    "@mintlify/link-rot": "3.0.1578",
     "@mintlify/models": "0.0.385",
-    "@mintlify/og": "0.0.136",
-    "@mintlify/prebuild": "1.0.1510",
-    "@mintlify/previewing": "4.0.1595",
-    "@mintlify/validation": "0.1.957",
+    "@mintlify/og": "0.0.137",
+    "@mintlify/prebuild": "1.0.1511",
+    "@mintlify/previewing": "4.0.1596",
+    "@mintlify/validation": "0.1.958",
     "adm-zip": "0.6.0",
     "chalk": "5.2.0",
     "color": "4.2.3",
@@ -87,7 +87,7 @@
     "keytar": "7.9.0"
   },
   "devDependencies": {
-    "@mintlify/editor": "0.0.614",
+    "@mintlify/editor": "0.0.615",
     "@mintlify/ts-config": "2.0.2",
     "@tsconfig/recommended": "1.0.2",
     "@types/detect-port": "1.3.2",
@@ -106,5 +106,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "b91e346a8923794306b538b9110464e7cf1fdfa6"
+  "gitHead": "8f1f0d58c5d3d495c9d3fc54dae1d661d4453c80"
 }

package/src/cli.tsx

@@ -55,7 +55,7 @@ import { buildOverlayRegistryForCheck, checkOpenApiFile } from './openApiCheck.j
 import { scoreHandler } from './score/index.js';
 import { signup } from './signup.js';
 import { status, getCliSubdomains } from './status.js';
-import { trackTelemetryPreferenceChange } from './telemetry/track.js';
+import { trackEvent, trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
 import { splitList, validateHandler } from './validate/command.js';
 import { RULES } from './validate/rules/index.js';
@@ -999,6 +999,11 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             }),
         async (argv) => {
           const agent = argv.agent ?? (argv.claude ? 'claude' : undefined);
+          void trackEvent('cli.migrate.executed', {
+            from: argv.from,
+            topic: argv.topic,
+            agent,
+          });
           if (agent) {
             try {
               return await terminate(await migrateWithAgent(agent, argv.from));

package/src/deploy.ts

@@ -87,6 +87,12 @@ export async function prepareAgentDeployment(
       saved = null;
       continue;
     }
+    void trackEvent('cli.deploy.provisioned', {
+      registration_id: credentials.registrationId,
+      deployment_id: site.deploymentId,
+      subdomain: site.subdomain,
+      created: site.created,
+    });
     await setAgentSiteMetadata(metadataKey, {
       registrationId: credentials.registrationId,
       subdomain: site.subdomain,

package/src/telemetry/sessionId.ts

@@ -0,0 +1,40 @@
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+
+import { CONFIG_DIR } from '../constants.js';
+
+const SESSION_FILE = path.join(CONFIG_DIR, 'telemetry-session.json');
+const SESSION_IDLE_MS = 30 * 60 * 1000;
+
+let current: string | undefined;
+
+function uuidv7(now: number): string {
+  const bytes = crypto.randomBytes(16);
+  bytes.writeUIntBE(now, 0, 6);
+  bytes[6] = (bytes[6]! & 0x0f) | 0x70;
+  bytes[8] = (bytes[8]! & 0x3f) | 0x80;
+  const hex = bytes.toString('hex');
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+
+function readSession(): { id: string; lastSeenAt: number } | null {
+  try {
+    const { id, lastSeenAt } = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'));
+    return typeof id === 'string' && typeof lastSeenAt === 'number' ? { id, lastSeenAt } : null;
+  } catch {
+    return null;
+  }
+}
+
+export function getSessionId(now = Date.now()): string {
+  if (!current) {
+    const saved = readSession();
+    current = saved && now - saved.lastSeenAt < SESSION_IDLE_MS ? saved.id : uuidv7(now);
+  }
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(SESSION_FILE, JSON.stringify({ id: current, lastSeenAt: now }));
+  } catch {}
+  return current;
+}

package/src/telemetry/track.ts

@@ -8,6 +8,7 @@ import { getAccessToken, getUserEmail, storeUserEmail } from '../keyring.js';
 import { fetchCliStatus } from '../status.js';
 import { deferShutdownUntil, getPostHogClient } from './client.js';
 import { getDistinctId, isFirstRun } from './distinctId.js';
+import { getSessionId } from './sessionId.js';
 
 export interface TrackCommandOptions {
   command: string;
@@ -26,6 +27,7 @@ function getEnvironmentProperties(): Record<string, unknown> {
     is_ci: isCI(),
     is_tty: Boolean(process.stdin.isTTY),
     is_first_run: isFirstRun(),
+    $session_id: getSessionId(),
   };
 }
 
@@ -68,6 +70,11 @@ async function getIdentity(): Promise<{ loggedIn: boolean; email: string | null
   }
 }
 
+async function getIdentityProperties(): Promise<Record<string, unknown>> {
+  const { loggedIn, email } = await getIdentity();
+  return { is_logged_in: loggedIn, ...(email ? { email, $set: { email } } : {}) };
+}
+
 export async function trackCommand({
   command,
   cliVersion,
@@ -77,14 +84,12 @@ export async function trackCommand({
 
   const work = (async () => {
     try {
-      const { loggedIn, email } = await getIdentity();
       await captureWithTimeout('cli.command.executed', {
         command,
         cli_version: cliVersion,
         ...getEnvironmentProperties(),
-        is_logged_in: loggedIn,
+        ...(await getIdentityProperties()),
         subdomain,
-        ...(email ? { email, $set: { email } } : {}),
       });
     } catch {}
   })();
@@ -95,14 +100,20 @@ export async function trackCommand({
 
 async function trackLoginEvent(event: string, extra?: Record<string, unknown>): Promise<void> {
   if (!isTelemetryEnabled()) return;
-  try {
-    const { cli: cliVersion } = getVersions();
-    await captureWithTimeout(event, {
-      ...extra,
-      cli_version: cliVersion,
-      ...getEnvironmentProperties(),
-    });
-  } catch {}
+
+  const work = (async () => {
+    try {
+      const { cli: cliVersion } = getVersions();
+      await captureWithTimeout(event, {
+        ...extra,
+        cli_version: cliVersion,
+        ...getEnvironmentProperties(),
+        ...(await getIdentityProperties()),
+      });
+    } catch {}
+  })();
+  deferShutdownUntil(work);
+  await work;
 }
 
 export async function trackLoginAttempt(): Promise<void> {
@@ -130,6 +141,7 @@ export async function trackEvent(
         ...properties,
         cli_version: cliVersion,
         ...getEnvironmentProperties(),
+        ...(await getIdentityProperties()),
       });
     } catch {}
   })();