extension 3.8.16 → 3.9.0-canary.231.7b387a7

package/dist/cli-lib/project-profile.d.ts

@@ -0,0 +1,17 @@
+import type { ManifestSummary } from './manifest-summary';
+export type PackageManagerName = 'pnpm' | 'yarn' | 'npm' | 'bun' | 'unknown';
+export type FrameworkPrimary = 'react' | 'preact' | 'vue' | 'svelte' | 'solid' | 'angular' | 'unknown';
+export type PermissionBucket = '0' | '1_3' | '4_10' | '11_plus';
+export type ManifestSurface = 'background_only' | 'content_scripts' | 'action_popup' | 'devtools' | 'multi_surface' | 'other' | 'unknown';
+export type ProjectProfile = {
+    package_manager: PackageManagerName;
+    framework_primary: FrameworkPrimary;
+    has_typescript: boolean;
+    is_monorepo: boolean;
+    has_next_dependency: boolean;
+    has_turbo_dependency: boolean;
+    manifest_surface: ManifestSurface;
+    permissions_bucket: PermissionBucket;
+    host_permissions_bucket: PermissionBucket;
+};
+export declare function collectProjectProfile(projectRoot: string, summary?: ManifestSummary | null): ProjectProfile | null;

package/dist/cli-lib/telemetry-cli.d.ts

@@ -1,2 +1,5 @@
 import { Telemetry } from './telemetry';
+type KnownCommand = 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall' | 'cleanup' | 'unknown';
 export declare const telemetry: Telemetry;
+export declare function detectInvokedCommand(argv: string[]): KnownCommand;
+export {};

package/dist/cli-lib/workflow-profile.d.ts

@@ -0,0 +1,35 @@
+import type { FrameworkPrimary, PackageManagerName } from './project-profile';
+export type WorkflowCohort = 'local_only' | 'shipping' | 'automation_heavy';
+type WorkflowProjectShape = {
+    packageManager?: PackageManagerName;
+    frameworkPrimary?: FrameworkPrimary;
+    hasNextDependency?: boolean;
+    hasTurboDependency?: boolean;
+};
+type WorkflowContext = {
+    command: 'create' | 'dev' | 'start' | 'preview' | 'build' | 'install' | 'uninstall';
+    isMultiBrowser?: boolean;
+    isRemoteInput?: boolean;
+    isWaitMode?: boolean;
+    isNoBrowserMode?: boolean;
+    usesMachineReadableOutput?: boolean;
+    sourceInspectionRequested?: boolean;
+    companionExtensionsProvided?: boolean;
+    artifactKind?: 'directory' | 'zip' | 'source_zip' | 'zip_and_source';
+    whereMode?: boolean;
+} & WorkflowProjectShape;
+type WorkflowReason = 'production_command' | 'multi_browser' | 'artifact_output' | 'companion_extensions' | 'headless_sync' | 'machine_readable_output' | 'source_inspection' | 'where_mode';
+export type WorkflowProfile = {
+    workflow_cohort: WorkflowCohort;
+    has_shipping_intent: boolean;
+    has_automation_intent: boolean;
+    shipping_signal_count: number;
+    automation_signal_count: number;
+    primary_workflow_signal: WorkflowReason | 'none';
+    package_manager?: PackageManagerName;
+    framework_primary?: FrameworkPrimary;
+    has_next_dependency?: boolean;
+    has_turbo_dependency?: boolean;
+};
+export declare function collectWorkflowProfile(context: WorkflowContext): WorkflowProfile;
+export {};

package/dist/cli.cjs

@@ -111,6 +111,7 @@ Usage: extension [command] [options]
 
 Notes
 - All high-level commands offer their own \`--help\` with usage and flag lists.
+- Telemetry is anonymous and privacy-safe by default; see ${code('TELEMETRY.md')} for the full contract.
 
 Example
 - ${code('extension create --help')} outputs information about the "create" command.
@@ -625,8 +626,8 @@ Cross-Browser Compatibility
     const DEFAULT_FLUSH_AT = Number(process.env.EXTENSION_TELEMETRY_FLUSH_AT || 10);
     const DEFAULT_FLUSH_INTERVAL = Number(process.env.EXTENSION_TELEMETRY_FLUSH_INTERVAL || 2000);
     const DEFAULT_TIMEOUT_MS = Number(process.env.EXTENSION_TELEMETRY_TIMEOUT_MS || 200);
-    const DEFAULT_POSTHOG_KEY = 'phc_Np5x3Jg3h2V7kTFtNch2uz6QBaWDycQpIidzX5PetaN';
-    const DEFAULT_POSTHOG_HOST = 'https://us.i.posthog.com';
+    const DEFAULT_POSTHOG_KEY = process.env.POSTHOG_KEY || 'phc_Np5x3Jg3h2V7kTFtNch2uz6QBaWDycQpIidzX5PetaN';
+    const DEFAULT_POSTHOG_HOST = process.env.POSTHOG_HOST || 'https://us.i.posthog.com';
     class Telemetry {
         track(event, props = {}) {
             if (this.disabled || !this.storage) return;
@@ -708,7 +709,7 @@ Cross-Browser Compatibility
                 arch: process.arch,
                 node: process.versions.node,
                 is_ci: isCI(),
-                schema_version: 1
+                schema_version: 2
             };
             this.apiKey = init.apiKey || DEFAULT_POSTHOG_KEY;
             this.host = init.host || DEFAULT_POSTHOG_HOST;
@@ -756,6 +757,110 @@ Cross-Browser Compatibility
             has_action_popup: hasActionPopup
         };
     }
+    function safeReadJson(filePath) {
+        try {
+            if (!external_node_fs_default().existsSync(filePath)) return null;
+            return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf8'));
+        } catch  {
+            return null;
+        }
+    }
+    function findNearestPackageJson(startPath) {
+        let current = external_node_path_default().resolve(startPath);
+        for(let i = 0; i < 6; i += 1){
+            const candidate = external_node_path_default().join(current, 'package.json');
+            if (external_node_fs_default().existsSync(candidate)) return candidate;
+            const parent = external_node_path_default().dirname(current);
+            if (parent === current) break;
+            current = parent;
+        }
+        return null;
+    }
+    function getDependencies(pkg) {
+        return {
+            ...pkg.dependencies || {},
+            ...pkg.devDependencies || {},
+            ...pkg.peerDependencies || {}
+        };
+    }
+    function hasDependency(pkg, dependencyId) {
+        const deps = getDependencies(pkg);
+        return Boolean(deps[dependencyId]);
+    }
+    function detectPackageManager(projectRoot, pkg) {
+        const declared = String(pkg.packageManager || '').trim().toLowerCase();
+        if (declared.startsWith('pnpm@')) return 'pnpm';
+        if (declared.startsWith('yarn@')) return 'yarn';
+        if (declared.startsWith('npm@')) return 'npm';
+        if (declared.startsWith('bun@')) return 'bun';
+        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'pnpm-lock.yaml'))) return 'pnpm';
+        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'yarn.lock'))) return 'yarn';
+        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'package-lock.json'))) return 'npm';
+        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'bun.lockb'))) return 'bun';
+        if (external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'bun.lock'))) return 'bun';
+        const userAgent = String(process.env.npm_config_user_agent || '').toLowerCase();
+        if (userAgent.includes('pnpm')) return 'pnpm';
+        if (userAgent.includes('yarn')) return 'yarn';
+        if (userAgent.includes('bun')) return 'bun';
+        if (userAgent.includes('npm')) return 'npm';
+        return 'unknown';
+    }
+    function detectFrameworkPrimary(pkg) {
+        if (hasDependency(pkg, 'preact')) return 'preact';
+        if (hasDependency(pkg, 'react')) return 'react';
+        if (hasDependency(pkg, 'vue')) return 'vue';
+        if (hasDependency(pkg, 'svelte')) return 'svelte';
+        if (hasDependency(pkg, 'solid-js')) return 'solid';
+        if (hasDependency(pkg, '@angular/core')) return 'angular';
+        return 'unknown';
+    }
+    function detectMonorepo(projectRoot, pkg) {
+        return Boolean(pkg.workspaces || external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'pnpm-workspace.yaml')) || external_node_fs_default().existsSync(external_node_path_default().join(projectRoot, 'turbo.json')));
+    }
+    function toPermissionBucket(count) {
+        if (count <= 0) return '0';
+        if (count <= 3) return '1_3';
+        if (count <= 10) return '4_10';
+        return '11_plus';
+    }
+    function toManifestSurface(summary) {
+        if (!summary) return 'unknown';
+        const surfaces = [
+            summary.has_action_popup,
+            summary.has_devtools_page,
+            summary.content_scripts_count > 0,
+            'none' !== summary.background_type
+        ].filter(Boolean).length;
+        if (surfaces > 1) return 'multi_surface';
+        if (summary.has_action_popup) return 'action_popup';
+        if (summary.has_devtools_page) return 'devtools';
+        if (summary.content_scripts_count > 0) return "content_scripts";
+        if ('none' !== summary.background_type) return 'background_only';
+        return 'other';
+    }
+    function collectProjectProfile(projectRoot, summary) {
+        const packageJsonPath = findNearestPackageJson(projectRoot);
+        const pkg = (packageJsonPath ? safeReadJson(packageJsonPath) : null) || {
+            dependencies: {},
+            devDependencies: {},
+            peerDependencies: {}
+        };
+        const resolvedRoot = packageJsonPath ? external_node_path_default().dirname(packageJsonPath) : projectRoot;
+        const hasPackageSignals = Boolean(packageJsonPath);
+        const hasManifestSignals = Boolean(summary);
+        if (!hasPackageSignals && !hasManifestSignals) return null;
+        return {
+            package_manager: detectPackageManager(resolvedRoot, pkg),
+            framework_primary: detectFrameworkPrimary(pkg),
+            has_typescript: hasDependency(pkg, "typescript") || external_node_fs_default().existsSync(external_node_path_default().join(resolvedRoot, 'tsconfig.json')),
+            is_monorepo: detectMonorepo(resolvedRoot, pkg),
+            has_next_dependency: hasDependency(pkg, 'next'),
+            has_turbo_dependency: hasDependency(pkg, 'turbo') || external_node_fs_default().existsSync(external_node_path_default().join(resolvedRoot, 'turbo.json')),
+            manifest_surface: toManifestSurface(summary),
+            permissions_bucket: toPermissionBucket(summary?.permissions_count || 0),
+            host_permissions_bucket: toPermissionBucket(summary?.host_permissions_count || 0)
+        };
+    }
     function isTelemetryDisabledFromArgs(argv) {
         return argv.includes('--no-telemetry');
     }
@@ -787,28 +892,37 @@ Cross-Browser Compatibility
         version: getCliPackageJson().version,
         disabled: telemetryDisabled
     });
-    if (!telemetryDisabled) {
-        const startedAt = Date.now();
-        let shutdownTracked = false;
+    function detectInvokedCommand(argv) {
         const known = new Set([
             'create',
             'dev',
             'start',
             'preview',
             'build',
-            'cleanup'
+            'install',
+            'uninstall',
+            'cleanup',
+            'unknown'
         ]);
-        const invoked = process.argv.slice(2).find((a)=>known.has(a)) || 'unknown';
+        return argv.slice(2).find((a)=>known.has(a)) || 'unknown';
+    }
+    if (!telemetryDisabled) {
+        const startedAt = Date.now();
+        let shutdownTracked = false;
+        const invoked = detectInvokedCommand(process.argv);
         telemetry_cli_telemetry.track('cli_boot', {
             command_guess: invoked
         });
         const manifestPath = findManifestJson(process.cwd());
-        if (manifestPath) {
+        let manifestSummary = null;
+        if (manifestPath) try {
             const raw = external_fs_default().readFileSync(manifestPath, 'utf8');
             const json = JSON.parse(raw);
-            const summary = summarizeManifest(json);
-            telemetry_cli_telemetry.track('manifest_summary', summary);
-        }
+            manifestSummary = summarizeManifest(json);
+            telemetry_cli_telemetry.track('manifest_summary', manifestSummary);
+        } catch  {}
+        const projectProfile = collectProjectProfile(process.cwd(), manifestSummary);
+        if (projectProfile) telemetry_cli_telemetry.track('project_profile', projectProfile);
         process.on('beforeExit', async function() {
             if (shutdownTracked) return;
             shutdownTracked = true;
@@ -833,6 +947,37 @@ Cross-Browser Compatibility
         });
     }
     const external_module_namespaceObject = require("module");
+    function primaryReason(automationReasons, shippingReasons) {
+        if (automationReasons.length > 0) return automationReasons[0];
+        if (shippingReasons.length > 0) return shippingReasons[0];
+        return 'none';
+    }
+    function collectWorkflowProfile(context) {
+        const shippingReasons = [];
+        const automationReasons = [];
+        if ('build' === context.command || 'start' === context.command || 'preview' === context.command) shippingReasons.push('production_command');
+        if (context.isMultiBrowser) shippingReasons.push('multi_browser');
+        if ('zip' === context.artifactKind || 'source_zip' === context.artifactKind || 'zip_and_source' === context.artifactKind) shippingReasons.push('artifact_output');
+        if (context.companionExtensionsProvided) shippingReasons.push('companion_extensions');
+        if (context.isWaitMode || context.isNoBrowserMode) automationReasons.push('headless_sync');
+        if (context.usesMachineReadableOutput) automationReasons.push('machine_readable_output');
+        if (context.sourceInspectionRequested) automationReasons.push('source_inspection');
+        if (context.whereMode) automationReasons.push('where_mode');
+        const hasAutomationIntent = automationReasons.length > 0;
+        const hasShippingIntent = shippingReasons.length > 0;
+        return {
+            workflow_cohort: hasAutomationIntent ? 'automation_heavy' : hasShippingIntent ? 'shipping' : 'local_only',
+            has_shipping_intent: hasShippingIntent,
+            has_automation_intent: hasAutomationIntent,
+            shipping_signal_count: shippingReasons.length,
+            automation_signal_count: automationReasons.length,
+            primary_workflow_signal: primaryReason(automationReasons, shippingReasons),
+            package_manager: context.packageManager,
+            framework_primary: context.frameworkPrimary,
+            has_next_dependency: context.hasNextDependency,
+            has_turbo_dependency: context.hasTurboDependency
+        };
+    }
     require("node:url");
     function parseOptionalBoolean(value) {
         if (void 0 === value) return true;
@@ -871,10 +1016,22 @@ Cross-Browser Compatibility
     function registerCreateCommand(program, telemetry) {
         program.command('create').arguments('<project-name|project-path>').usage('create <project-name|project-path> [options]').description(commandDescriptions.create).option('-t, --template <template-name>', 'specify a template for the created project').option('--install [boolean]', 'whether or not to install the dependencies after creating the project (enabled by default)', parseOptionalBoolean, true).action(async function(pathOrRemoteUrl, { template, install }) {
             const startedAt = Date.now();
+            const templateValue = String(template || 'default');
+            const isRemoteTemplate = /^https?:/i.test(templateValue);
+            const workflowProfile = collectWorkflowProfile({
+                command: 'create',
+                isRemoteInput: isRemoteTemplate
+            });
+            telemetry.track('workflow_profile', {
+                command: 'create',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'create',
-                template: template || 'default',
-                install: Boolean(install)
+                template: templateValue,
+                template_source: isRemoteTemplate ? 'remote' : 'built_in',
+                install: Boolean(install),
+                ...workflowProfile
             });
             try {
                 if (!process.env.EXTENSION_CREATE_DEVELOP_ROOT) try {
@@ -896,14 +1053,16 @@ Cross-Browser Compatibility
                     command: 'create',
                     duration_ms: Date.now() - startedAt,
                     success: true,
-                    exit_code: 0
+                    exit_code: 0,
+                    ...workflowProfile
                 });
             } catch (err) {
                 telemetry.track('cli_command_finish', {
                     command: 'create',
                     duration_ms: Date.now() - startedAt,
                     success: false,
-                    exit_code: 1
+                    exit_code: 1,
+                    ...workflowProfile
                 });
                 throw err;
             }
@@ -958,18 +1117,23 @@ Cross-Browser Compatibility
             if (external_node_fs_namespaceObject.existsSync(readyPath)) try {
                 const payload = JSON.parse(external_node_fs_namespaceObject.readFileSync(readyPath, 'utf8'));
                 const isLive = isProcessLikelyAlive(payload.pid);
+                const isFresh = isFreshContractPayload(payload, options.timeoutMs);
                 if (payload.command !== options.command) {
                     await new Promise((resolve)=>setTimeout(resolve, 250));
                     continue;
                 }
                 if (!isLive) {
-                    if ('start' !== options.command || !isFreshContractPayload(payload, options.timeoutMs)) {
+                    if ('start' !== options.command || !isFresh) {
                         await new Promise((resolve)=>setTimeout(resolve, 250));
                         continue;
                     }
                 }
                 if ('ready' === payload.status) return payload;
                 if ('error' === payload.status) {
+                    if (!isLive && 'start' !== options.command) {
+                        await new Promise((resolve)=>setTimeout(resolve, 250));
+                        continue;
+                    }
                     const detail = payload.message || payload.errors?.[0] || 'unknown error';
                     throw new Error(String(detail));
                 }
@@ -1121,15 +1285,43 @@ Cross-Browser Compatibility
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
             const cmdStart = Date.now();
+            const list = vendors(browser);
+            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
+            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
+            const workflowProfile = collectWorkflowProfile({
+                command: 'dev',
+                isMultiBrowser: list.length > 1,
+                isRemoteInput: isRemoteInput,
+                isWaitMode: Boolean(devOptions.wait),
+                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
+                usesMachineReadableOutput: 'json' === devOptions.waitFormat || 'json' === devOptions.logFormat || 'ndjson' === devOptions.logFormat || 'json' === devOptions.sourceFormat || 'ndjson' === devOptions.sourceFormat,
+                sourceInspectionRequested: Boolean(devOptions.source || devOptions.watchSource),
+                companionExtensionsProvided: Boolean(devOptions.extensions),
+                packageManager: projectProfile?.package_manager,
+                frameworkPrimary: projectProfile?.framework_primary,
+                hasNextDependency: projectProfile?.has_next_dependency,
+                hasTurboDependency: projectProfile?.has_turbo_dependency
+            });
+            telemetry.track('workflow_profile', {
+                command: 'dev',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'dev',
-                vendors: vendors(browser),
+                vendors: list,
+                browser_count: list.length,
+                is_multi_browser: list.length > 1,
+                is_remote_input: isRemoteInput,
+                is_wait_mode: Boolean(devOptions.wait),
+                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
                 polyfill_used: devOptions.polyfill?.toString() !== 'false',
+                source_inspection_requested: Boolean(devOptions.source || devOptions.watchSource),
+                companion_extensions_provided: Boolean(devOptions.extensions),
                 log_level: devOptions.logLevel || 'off',
                 log_format: devOptions.logFormat || 'pretty',
-                custom_binary_used: Boolean(devOptions.chromiumBinary || devOptions.geckoBinary)
+                custom_binary_used: Boolean(devOptions.chromiumBinary || devOptions.geckoBinary),
+                ...workflowProfile
             });
-            const list = vendors(browser);
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -1152,7 +1344,8 @@ Cross-Browser Compatibility
                     command: 'dev',
                     duration_ms: Date.now() - cmdStart,
                     success: true,
-                    exit_code: 0
+                    exit_code: 0,
+                    ...workflowProfile
                 });
                 return;
             }
@@ -1231,7 +1424,8 @@ Cross-Browser Compatibility
                 command: 'dev',
                 duration_ms: Date.now() - cmdStart,
                 success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0
+                exit_code: process.exitCode ?? 0,
+                ...workflowProfile
             });
         });
     }
@@ -1248,12 +1442,38 @@ Cross-Browser Compatibility
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
             const cmdStart = Date.now();
+            const list = vendors(browser);
+            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
+            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
+            const workflowProfile = collectWorkflowProfile({
+                command: 'start',
+                isMultiBrowser: list.length > 1,
+                isRemoteInput: isRemoteInput,
+                isWaitMode: Boolean(startOptions.wait),
+                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
+                usesMachineReadableOutput: 'json' === startOptions.waitFormat || 'json' === startOptions.logFormat || 'ndjson' === startOptions.logFormat,
+                companionExtensionsProvided: Boolean(startOptions.extensions),
+                packageManager: projectProfile?.package_manager,
+                frameworkPrimary: projectProfile?.framework_primary,
+                hasNextDependency: projectProfile?.has_next_dependency,
+                hasTurboDependency: projectProfile?.has_turbo_dependency
+            });
+            telemetry.track('workflow_profile', {
+                command: 'start',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'start',
-                vendors: vendors(browser),
-                polyfill_used: startOptions.polyfill?.toString() !== 'false'
+                vendors: list,
+                browser_count: list.length,
+                is_multi_browser: list.length > 1,
+                is_remote_input: isRemoteInput,
+                is_wait_mode: Boolean(startOptions.wait),
+                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
+                companion_extensions_provided: Boolean(startOptions.extensions),
+                polyfill_used: startOptions.polyfill?.toString() !== 'false',
+                ...workflowProfile
             });
-            const list = vendors(browser);
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -1276,7 +1496,8 @@ Cross-Browser Compatibility
                     command: 'start',
                     duration_ms: Date.now() - cmdStart,
                     success: true,
-                    exit_code: 0
+                    exit_code: 0,
+                    ...workflowProfile
                 });
                 return;
             }
@@ -1351,7 +1572,8 @@ Cross-Browser Compatibility
                 command: 'start',
                 duration_ms: Date.now() - cmdStart,
                 success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0
+                exit_code: process.exitCode ?? 0,
+                ...workflowProfile
             });
         });
     }
@@ -1368,11 +1590,35 @@ Cross-Browser Compatibility
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
             const cmdStart = Date.now();
+            const list = vendors(browser);
+            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
+            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
+            const workflowProfile = collectWorkflowProfile({
+                command: 'preview',
+                isMultiBrowser: list.length > 1,
+                isRemoteInput: isRemoteInput,
+                isNoBrowserMode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
+                usesMachineReadableOutput: 'json' === previewOptions.logFormat || 'ndjson' === previewOptions.logFormat,
+                companionExtensionsProvided: Boolean(previewOptions.extensions),
+                packageManager: projectProfile?.package_manager,
+                frameworkPrimary: projectProfile?.framework_primary,
+                hasNextDependency: projectProfile?.has_next_dependency,
+                hasTurboDependency: projectProfile?.has_turbo_dependency
+            });
+            telemetry.track('workflow_profile', {
+                command: 'preview',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'preview',
-                vendors: vendors(browser)
+                vendors: list,
+                browser_count: list.length,
+                is_multi_browser: list.length > 1,
+                is_remote_input: isRemoteInput,
+                is_no_browser_mode: '1' === process.env.EXTENSION_CLI_NO_BROWSER,
+                companion_extensions_provided: Boolean(previewOptions.extensions),
+                ...workflowProfile
             });
-            const list = vendors(browser);
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -1450,7 +1696,8 @@ Cross-Browser Compatibility
                 command: 'preview',
                 duration_ms: Date.now() - cmdStart,
                 success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0
+                exit_code: process.exitCode ?? 0,
+                ...workflowProfile
             });
         });
     }
@@ -1461,14 +1708,37 @@ Cross-Browser Compatibility
                 if (!process.env.EXTENSION_VERBOSE) process.env.EXTENSION_VERBOSE = '1';
             }
             const cmdStart = Date.now();
+            const list = vendors(browser);
+            const isRemoteInput = 'string' == typeof pathOrRemoteUrl && /^https?:/i.test(pathOrRemoteUrl);
+            const artifactKind = buildOptions.zipSource ? buildOptions.zip ? 'zip_and_source' : 'source_zip' : buildOptions.zip ? 'zip' : 'directory';
+            const projectProfile = collectProjectProfile(!isRemoteInput && pathOrRemoteUrl ? pathOrRemoteUrl : process.cwd());
+            const workflowProfile = collectWorkflowProfile({
+                command: 'build',
+                isMultiBrowser: list.length > 1,
+                isRemoteInput: isRemoteInput,
+                companionExtensionsProvided: Boolean(buildOptions.extensions),
+                artifactKind,
+                packageManager: projectProfile?.package_manager,
+                frameworkPrimary: projectProfile?.framework_primary,
+                hasNextDependency: projectProfile?.has_next_dependency,
+                hasTurboDependency: projectProfile?.has_turbo_dependency
+            });
+            telemetry.track('workflow_profile', {
+                command: 'build',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'build',
-                vendors: vendors(browser),
+                vendors: list,
+                browser_count: list.length,
+                is_multi_browser: list.length > 1,
+                is_remote_input: isRemoteInput,
                 polyfill_used: buildOptions.polyfill || false,
                 zip: buildOptions.zip || false,
-                zip_source: buildOptions.zipSource || false
+                zip_source: buildOptions.zipSource || false,
+                artifact_kind: artifactKind,
+                ...workflowProfile
             });
-            const list = vendors(browser);
             validateVendorsOrExit(list, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
@@ -1490,7 +1760,12 @@ Cross-Browser Compatibility
                     extensions: parseExtensionsList(buildOptions.extensions)
                 });
                 telemetry.track('cli_build_summary', {
-                    ...buildSummary
+                    ...buildSummary,
+                    browser_count: list.length,
+                    is_multi_browser: list.length > 1,
+                    is_remote_input: isRemoteInput,
+                    artifact_kind: artifactKind,
+                    ...workflowProfile
                 });
                 telemetry.track('cli_vendor_finish', {
                     command: 'build',
@@ -1502,7 +1777,8 @@ Cross-Browser Compatibility
                 command: 'build',
                 duration_ms: Date.now() - cmdStart,
                 success: 0 === process.exitCode || null == process.exitCode,
-                exit_code: process.exitCode ?? 0
+                exit_code: process.exitCode ?? 0,
+                ...workflowProfile
             });
         });
     }
@@ -1541,13 +1817,25 @@ Cross-Browser Compatibility
             const startedAt = Date.now();
             const selectedBrowser = options.browser || browserArg || 'chromium';
             const browserList = vendors(selectedBrowser);
+            const workflowProfile = collectWorkflowProfile({
+                command: 'install',
+                isMultiBrowser: browserList.length > 1,
+                whereMode: Boolean(options.where)
+            });
             validateVendorsOrExit(browserList, (invalid, supported)=>{
                 console.error(unsupportedBrowserFlag(invalid, supported));
             });
+            telemetry.track('workflow_profile', {
+                command: 'install',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'install',
                 vendors: browserList,
-                where: Boolean(options.where)
+                browser_count: browserList.length,
+                is_multi_browser: browserList.length > 1,
+                where: Boolean(options.where),
+                ...workflowProfile
             });
             try {
                 if (options.where) {
@@ -1564,14 +1852,16 @@ Cross-Browser Compatibility
                     command: 'install',
                     duration_ms: Date.now() - startedAt,
                     success: true,
-                    exit_code: 0
+                    exit_code: 0,
+                    ...workflowProfile
                 });
             } catch (err) {
                 telemetry.track('cli_command_finish', {
                     command: 'install',
                     duration_ms: Date.now() - startedAt,
                     success: false,
-                    exit_code: 1
+                    exit_code: 1,
+                    ...workflowProfile
                 });
                 throw err;
             }
@@ -1579,11 +1869,20 @@ Cross-Browser Compatibility
         program.command('uninstall').usage('uninstall <browser-name> | uninstall --all | uninstall --where').description(commandDescriptions.uninstall).option('--browser <browser-name>', 'browser to uninstall').option('--all', 'remove all managed browser binaries').option('--where', 'print the resolved managed browser cache root').argument('[browser-name]').action(async function(browserArg, { browser, all, where }) {
             const startedAt = Date.now();
             const target = browserArg || browser;
+            const workflowProfile = collectWorkflowProfile({
+                command: 'uninstall',
+                whereMode: Boolean(where)
+            });
+            telemetry.track('workflow_profile', {
+                command: 'uninstall',
+                ...workflowProfile
+            });
             telemetry.track('cli_command_start', {
                 command: 'uninstall',
                 browser: target,
                 all: Boolean(all),
-                where: Boolean(where)
+                where: Boolean(where),
+                ...workflowProfile
             });
             try {
                 if (where) {
@@ -1612,14 +1911,16 @@ Cross-Browser Compatibility
                     command: 'uninstall',
                     duration_ms: Date.now() - startedAt,
                     success: true,
-                    exit_code: 0
+                    exit_code: 0,
+                    ...workflowProfile
                 });
             } catch (err) {
                 telemetry.track('cli_command_finish', {
                     command: 'uninstall',
                     duration_ms: Date.now() - startedAt,
                     success: false,
-                    exit_code: 1
+                    exit_code: 1,
+                    ...workflowProfile
                 });
                 throw err;
             }

package/package.json

@@ -33,7 +33,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "3.8.16",
+  "version": "3.9.0-canary.231.7b387a7",
   "description": "Create cross-browser extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -90,9 +90,9 @@
     "@types/chrome": "^0.1.33",
     "@types/node": "^25.2.0",
     "@types/webextension-polyfill": "0.12.4",
-    "extension-create": "3.8.16",
-    "extension-develop": "3.8.16",
-    "extension-install": "3.8.16",
+    "extension-create": "3.9.0-canary.231.7b387a7",
+    "extension-develop": "3.9.0-canary.231.7b387a7",
+    "extension-install": "3.9.0-canary.231.7b387a7",
     "commander": "^14.0.3",
     "pintor": "0.3.0",
     "semver": "^7.7.3",